DocumentID: ECMA-376/Part4/2.3.1 Title: ECMA-376, Part4: 2.3.1 Paragraphs Extracted-From: ECMA-376 Office Open XML File Formats, 1st Edition / December 2006 Warning: Coverted to HTML format by a script known to have bugs
The most basic unit of block-level content within a WordprocessingML document, paragraphs are stored using the p element (§2.3.1.22). A paragraph defines a distinct division of content with a WordprocessingML document which begins on a new line.
[Example: Consider the paragraph fragment "The quick brown fox jumped ... " which is centered on a paragraph. The justification property is a paragraph level property, and therefore is expressed on the paragraph properties as follows:
<w:p>
<w:pPr>
<w:jc w:val="center"/>
<w:rPr>
<w:i/>
</w:rPr>
</w:pPr>
<w:r>
<w:rPr>
<w:i/>
</w:rPr>
<w:t xml:space="preserve">The quick brown fox jumped ... </w:t>
</w:r>
</w:p>
Notice that each run specifies the character formatting information for its contents, and the paragraph specifies the paragraph level formatting (the center-justification). It is also notable that since leading and trailing whitespace is not normally significant in XML; some runs require a designating specifying that their whitespace is significant via the xml:space element. end example]
A paragraph's properties are specified via the pPr element (§2.3.1.25; §2.3.1.26). [Note: Some examples of paragraph properties are alignment, border, hyphenation override, indentation, line spacing, shading, text direction, and widow/orphan control. end note]
This element specifies whether the right indent shall be automatically adjusted for the given paragraph when a document grid has been defined for the current section using the docGrid element (§2.6.5), modifying of the current right indent used on this paragraph.
[Note: This setting is used in order to ensure that the line breaking for that paragraph is not determined by the width of the final character on the line. end note]
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, its value is assumed to be true.
[Example: Consider a paragraph in which the right indent on the current paragraph should not be automatically determined based on the character pitch set in the document grid. This setting would be specified using the following WordprocessingML:
<w:p>
<w:pPr>
...
<w:adjustRightInd w:val="false" />
</w:pPr>
...
</w:p>
By explicitly setting the val to false, this paragraph will use its specified right indent settings regardless of the presence of the document grid for the parent section. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies whether inter-character spacing shall automatically be adjusted between regions of Latin text and regions of East Asian text in the current paragraph. These regions shall be determined by the Unicode character values of the text content within the paragraph.
[Note: This property is used to ensure that the spacing between regions of Latin text and adjoining East Asian text is sufficient on each side such that the Latin text can be easily read within the East Asian text. end note]
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, its value is assumed to be true.
[Example: Consider a paragraph in which the spacing should not be automatically adjusted based on the presence of Latin and East Asian text. This setting would be specified using the following WordprocessingML:
<w:p>
<w:pPr>
...
<w:autoSpaceDE w:val="false" />
</w:pPr>
...
</w:p>
By explicitly setting the val to false, this paragraph shall not automatically adjust the spacing of adjoining Latin and East Asian text. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies whether inter-character spacing shall automatically be adjusted between regions of numbers and regions of East Asian text in the current paragraph. These regions shall be determined by the Unicode character values of the text content within the paragraph.
[Note: This property is used to ensure that the spacing between regions of numbers and adjoining East Asian text is sufficient on each side such that the numbers can be easily read within the East Asian text. end note]
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, its value is assumed to be true.
[Example: Consider a paragraph in which the spacing should not be automatically adjusted based on the presence of numbers and East Asian text. This setting would be specified using the following WordprocessingML:
<w:p>
<w:pPr>
...
<w:autoSpaceDN w:val="false" />
</w:pPr>
...
</w:p>
By explicitly setting the val to false, this paragraph will not automatically adjust the spacing of adjoining numbers and East Asian text. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies the border which may be displayed on the inside edge of the paragraph when the parent's section settings specify that the section shall be printed using mirrored margins using the mirrorMargins element (§2.15.1.57). [Note: This information is present in the WordprocessingML for the purposes of legacy document format compatibility, and it may be removed and/or ignored as required. end note]
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then no bar border shall be applied to the current paragraph.
[Example: Consider the following paragraph's WordprocessingML definition for its paragraph borders:
<w:p>
<w:pPr>
<w:pBdr>
<w:top w:val="single" w:sz="24" w:space="1" w:color="F2DCDB"
w:themeColor="accent2" w:themeTint="33" />
<w:left w:val="single" w:sz="24" w:space="4" w:color="B97034"
w:themeColor="accent6" w:themeShade="BF" />
<w:bottom w:val="single" w:sz="24" w:space="1" w:color="F2DCDB"
w:themeColor="accent2" w:themeTint="33" />
<w:right w:val="single" w:sz="24" w:space="4" w:color="C3D69B"
w:themeColor="accent3" w:themeTint="99" />
<w:bar w:val="single" w:sz="24" w:space="1" w:color="4F81BD"
w:themeColor="accent1" />
</w:pBdr>
</w:pPr>
<w:r>
<w:t>Sample paragraph.</w:t>
</w:r>
</w:p>
This paragraph has a single line bar border as defined by the bar element. end example]
|
Parent Elements |
|
pBdr (§2.3.1.24) |
|
Attributes |
Description |
|---|---|
|
color (Border Color) |
Specifies the color for this border. This color may either be presented as a hex value (in RRGGBB format), or auto to allow a consumer to automatically determine the border color as appropriate. [Example: Consider a border color with value auto, as follows:
This color therefore may be automatically be modified by a consumer as appropriate, for example, in order to ensure that the border can be distinguished against the page's background color. end example] If the border style (the The possible values for this attribute are defined by the ST_HexColor simple type (§2.18.43). |
|
frame (Create Frame Effect) |
Specifies whether the specified border should be modified to create a frame effect by reversing the border's appearance from the edge nearest the text to the edge furthest from the text. If this attribute is omitted, then the border is not given any frame effect. [Example: Consider a bottom border which shall appear with a frame effect, which is specified in the following WordprocessingML:
This frame's The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
shadow (Border Shadow) |
Specifies whether this border should be modified to create the appearance of a shadow. For the right and bottom borders, this is accomplished by duplicating the border below and right of the normal border location. For the right and top borders, this is accomplished by moving the order down and to the right of its original location. If this attribute is omitted, then the border is not given the shadow effect. [Example: Consider a top border which shall appear with a shadow effect, resulting in the following WordprocessingML:
This frame's The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
space (Border Spacing Measurement) |
Specifies the spacing offset that shall be used to place this border on the parent object. When a document has a page border that is relative to the page edges (using a value of page in the When a document has a page border that is relative to the text extents (using a value of text in the [Example: Consider a document with a set of page borders all specified to appear 24 points from the edge of the page. The resulting WordprocessingML would be as follows:
The The possible values for this attribute are defined by the ST_PointMeasure simple type (§2.18.75). |
|
sz (Border Width) |
Specifies the width of the current border. If the border style ( If the border style ( [Example: Consider a document with a three point wide dashed line border on all sides, resulting in the following WordprocessingML markup:
The border style is specified using the The possible values for this attribute are defined by the ST_EighthPointMeasure simple type (§2.18.27). |
|
themeColor (Border Theme Color) |
Specifies a theme color to be applied to the current border. The specified theme color is a reference to one of the predefined theme colors, located in the document's Theme part,which allows color information to be set centrally in the document. [Example: Consider a set of borders configured to use the accent2 theme color, resulting in the following WordprocessingML markup:
The borders have a The possible values for this attribute are defined by the ST_ThemeColor simple type (§2.18.104). |
|
themeShade (Border Theme Color Shade) |
Specifies the shade value applied to the supplied theme color (if any) for this border instance. If the The [Example: Consider a shade of 40% applied to a border in a document. This shade is calculated as follows: (missing picture formula-2.3.1.4-1) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.1.4-2) [Example: Consider a document with a background using the accent2 theme color, whose RGB value (in RRGGBB hex format) is C0504D. The equivalent HSL color value would be. Applying the shade formula with a shade percentage of 75% to the luminance, we get: (missing picture formula-2.3.1.4-3) Taking the resulting HSL color value of and converting back to RGB, we get 943634. This transformed value can be seen in the resulting background's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
themeTint (Border Theme Color Tint) |
Specifies the tint value applied to the supplied theme color (if any) for this border instance. If the The [Example: Consider a tint of 60% applied to a border in a document. This tint is calculated as follows: (missing picture formula-2.3.1.4-4) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.1.4-5) [Example: Consider a document with a background using the accent2 theme color, whose RGB value (in RRGGBB hex format) is 4F81BD. The equivalent HSL color value would be. Applying the tint formula with a tint percentage of 60% to the luminance, we get: (missing picture formula-2.3.1.4-6) Taking the resulting HSL color value of and converting back to RGB, we get 95B3D7. This transformed value can be seen in the resulting background's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
val (Border Style) |
Specifies the style of border used on this object. This border can either be an art border (a repeated image along the borders - only valid for page borders) or a line border (a line format repeated along the borders) - see the simple type definition for a description of each border style. [Example: Consider a left border resulting in the following WordprocessingML:
This border's The possible values for this attribute are defined by the ST_Border simple type (§2.18.4). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Border">
<attribute name="val" type="ST_Border" use="required"/>
<attribute name="color" type="ST_HexColor" use="optional"/>
<attribute name="themeColor" type="ST_ThemeColor" use="optional"/>
<attribute name="themeTint" type="ST_UcharHexNumber" use="optional"/>
<attribute name="themeShade" type="ST_UcharHexNumber" use="optional"/>
<attribute name="sz" type="ST_EighthPointMeasure" use="optional"/>
<attribute name="space" type="ST_PointMeasure" use="optional"/>
<attribute name="shadow" type="ST_OnOff" use="optional"/>
<attribute name="frame" type="ST_OnOff" use="optional"/>
</complexType>
This element specifies the border which shall be displayed between each paragraph in a set of paragraphs which have the same set of paragraph border settings.
To determine if any two adjoining paragraphs should have a between border or an individual top and bottom border, the set of borders on the two adjoining paragraphs are compared. If the border information on those two paragraphs is identical for all possible paragraphs borders, then the between border is displayed. Otherwise, each paragraph shall use its bottom and top border, respectively. If this border specifies a space attribute, that value is ignored - this border is always located at the bottom of each paragraph with an identical following paragraph, taking into account any space after the line pitch.
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then no between border shall be applied between identical paragraphs.
[Example: Consider the following two paragraphs' WordprocessingML definition:
<w:p>
<w:pPr>
<w:pBdr>
<w:top w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />
<w:left w:val="single" w:sz="24" w:space="4" w:color="B97034" w:themeColor="accent6" w:themeShade="BF" />
<w:bottom w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />
<w:right w:val="single" w:sz="24" w:space="4" w:color="C3D69B" w:themeColor="accent3" w:themeTint="99" />
<w:between w:val="single" w:sz="24" w:space="1" w:color="4F81BD" w:themeColor="accent1" />
</w:pBdr>
</w:pPr>
<w:r>
<w:t>First paragraph.</w:t>
</w:r>
</w:p>
<w:p>
<w:pPr>
<w:pBdr>
<w:top w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />
<w:left w:val="single" w:sz="24" w:space="4" w:color="B97034" w:themeColor="accent6" w:themeShade="BF" />
<w:bottom w:val="single" w:sz="24" w:space="0" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />
<w:right w:val="single" w:sz="24" w:space="4" w:color="C3D69B" w:themeColor="accent3" w:themeTint="99" />
<w:between w:val="single" w:sz="24" w:space="1" w:color="4F81BD" w:themeColor="accent1" />
</w:pBdr>
</w:pPr>
<w:r>
<w:t>Second paragraph.</w:t>
</w:r>
</w:p>
Since the bottom paragraph border is different between the two paragraphs (the bottom space value goes from 1 to 0), these paragraphs do not use the between border, and instead paragraph one uses its bottom border, and paragraph two uses its top border. If those values were identical, then paragraph one would have a between brder below it, and paragraph two would have no top border. end example]
|
Parent Elements |
|
pBdr (§2.3.1.24) |
|
Attributes |
Description |
|---|---|
|
color (Border Color) |
Specifies the color for this border. This color may either be presented as a hex value (in RRGGBB format), or auto to allow a consumer to automatically determine the border color as appropriate. [Example: Consider a border color with value auto, as follows:
This color therefore may be automatically be modified by a consumer as appropriate, for example, in order to ensure that the border can be distinguished against the page's background color. end example] If the border style (the The possible values for this attribute are defined by the ST_HexColor simple type (§2.18.43). |
|
frame (Create Frame Effect) |
Specifies whether the specified border should be modified to create a frame effect by reversing the border's appearance from the edge nearest the text to the edge furthest from the text. If this attribute is omitted, then the border is not given any frame effect. [Example: Consider a bottom border which shall appear with a frame effect, which is specified in the following WordprocessingML:
This frame's The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
shadow (Border Shadow) |
Specifies whether this border should be modified to create the appearance of a shadow. For the right and bottom borders, this is accomplished by duplicating the border below and right of the normal border location. For the right and top borders, this is accomplished by moving the order down and to the right of its original location. If this attribute is omitted, then the border is not given the shadow effect. [Example: Consider a top border which shall appear with a shadow effect, resulting in the following WordprocessingML:
This frame's The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
space (Border Spacing Measurement) |
Specifies the spacing offset that shall be used to place this border on the parent object. When a document has a page border that is relative to the page edges (using a value of page in the When a document has a page border that is relative to the text extents (using a value of text in the [Example: Consider a document with a set of page borders all specified to appear 24 points from the edge of the page. The resulting WordprocessingML would be as follows:
The The possible values for this attribute are defined by the ST_PointMeasure simple type (§2.18.75). |
|
sz (Border Width) |
Specifies the width of the current border. If the border style ( If the border style ( [Example: Consider a document with a three point wide dashed line border on all sides, resulting in the following WordprocessingML markup:
The border style is specified using the The possible values for this attribute are defined by the ST_EighthPointMeasure simple type (§2.18.27). |
|
themeColor (Border Theme Color) |
Specifies a theme color to be applied to the current border. The specified theme color is a reference to one of the predefined theme colors, located in the document's Theme part,which allows color information to be set centrally in the document. [Example: Consider a set of borders configured to use the accent2 theme color, resulting in the following WordprocessingML markup:
The borders have a The possible values for this attribute are defined by the ST_ThemeColor simple type (§2.18.104). |
|
themeShade (Border Theme Color Shade) |
Specifies the shade value applied to the supplied theme color (if any) for this border instance. If the The [Example: Consider a shade of 40% applied to a border in a document. This shade is calculated as follows: (missing picture formula-2.3.1.5-1) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.1.5-2) [Example: Consider a document with a background using the accent2 theme color, whose RGB value (in RRGGBB hex format) is C0504D. The equivalent HSL color value would be. Applying the shade formula with a shade percentage of 75% to the luminance, we get: (missing picture formula-2.3.1.5-3) Taking the resulting HSL color value of and converting back to RGB, we get 943634. This transformed value can be seen in the resulting background's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
themeTint (Border Theme Color Tint) |
Specifies the tint value applied to the supplied theme color (if any) for this border instance. If the The [Example: Consider a tint of 60% applied to a border in a document. This tint is calculated as follows: (missing picture formula-2.3.1.5-4) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.1.5-5) [Example: Consider a document with a background using the accent2 theme color, whose RGB value (in RRGGBB hex format) is 4F81BD. The equivalent HSL color value would be. Applying the tint formula with a tint percentage of 60% to the luminance, we get: (missing picture formula-2.3.1.5-6) Taking the resulting HSL color value of and converting back to RGB, we get 95B3D7. This transformed value can be seen in the resulting background's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
val (Border Style) |
Specifies the style of border used on this object. This border can either be an art border (a repeated image along the borders - only valid for page borders) or a line border (a line format repeated along the borders) - see the simple type definition for a description of each border style. [Example: Consider a left border resulting in the following WordprocessingML:
This border's The possible values for this attribute are defined by the ST_Border simple type (§2.18.4). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Border">
<attribute name="val" type="ST_Border" use="required"/>
<attribute name="color" type="ST_HexColor" use="optional"/>
<attribute name="themeColor" type="ST_ThemeColor" use="optional"/>
<attribute name="themeTint" type="ST_UcharHexNumber" use="optional"/>
<attribute name="themeShade" type="ST_UcharHexNumber" use="optional"/>
<attribute name="sz" type="ST_EighthPointMeasure" use="optional"/>
<attribute name="space" type="ST_PointMeasure" use="optional"/>
<attribute name="shadow" type="ST_OnOff" use="optional"/>
<attribute name="frame" type="ST_OnOff" use="optional"/>
</complexType>
This element specifies that this paragraph shall be presented using a right to left direction. This property only affects the set of paragraph-level properties, and shall not affect the layout of text within the contents of this paragraph.
[Example: Consider a paragraph with the bidi property set as follows:
<w:p>
<w:pPr>
<w:bidi/>
</w:pPr>
...
</w:p>
This paragraph direction is now right to left, which means that all paragraph properties are displayed right to left (e.g. the paragraph marker glyph (if any) is displayed on the right, and indentation for the first line of the paragraph occurs on the right side of the page). end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies the border which shall be displayed below a set of paragraphs which have the same set of paragraph border settings.
To determine if any two adjoining paragraphs shall have an individual top and bottom border or a between border, the set of borders on the two adjoining paragraphs are compared. If the border information on those two paragraphs is identical for all possible paragraphs borders, then the between border is displayed. Otherwise, the final paragraph shall use its bottom border and the following paragraph shall use its top border, respectively. If this border specifies a space attribute, that value determines the space after the bottom of the text (ignoring any space below) which should be left before this border is drawn, specified in points.
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then no between border shall be applied below identical paragraphs.
[Example: Consider the following two paragraphs' WordprocessingML definition:
<w:p>
<w:pPr>
<w:pBdr>
<w:top w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />
<w:left w:val="single" w:sz="24" w:space="4" w:color="B97034" w:themeColor="accent6" w:themeShade="BF" />
<w:bottom w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />
<w:right w:val="single" w:sz="24" w:space="4" w:color="C3D69B" w:themeColor="accent3" w:themeTint="99" />
<w:between w:val="single" w:sz="24" w:space="1" w:color="4F81BD" w:themeColor="accent1" />
</w:pBdr>
</w:pPr>
<w:r>
<w:t>First paragraph.</w:t>
</w:r>
</w:p>
<w:p>
<w:pPr>
<w:pBdr>
<w:top w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />
<w:left w:val="single" w:sz="24" w:space="4" w:color="B97034" w:themeColor="accent6" w:themeShade="BF" />
<w:bottom w:val="single" w:sz="24" w:space="0" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />
<w:right w:val="single" w:sz="24" w:space="4" w:color="C3D69B" w:themeColor="accent3" w:themeTint="99" />
<w:between w:val="single" w:sz="24" w:space="1" w:color="4F81BD" w:themeColor="accent1" />
</w:pBdr>
</w:pPr>
<w:r>
<w:t>Second paragraph.</w:t>
</w:r>
</w:p>
Since the paragraph border is different between the two paragraphs (the bottom space value goes from 1 to 0), paragraph one uses its bottom border, which is located one point below the text in that paragraph. end example]
|
Parent Elements |
|
pBdr (§2.3.1.24) |
|
Attributes |
Description |
|---|---|
|
color (Border Color) |
Specifies the color for this border. This color may either be presented as a hex value (in RRGGBB format), or auto to allow a consumer to automatically determine the border color as appropriate. [Example: Consider a border color with value auto, as follows:
This color therefore may be automatically be modified by a consumer as appropriate, for example, in order to ensure that the border can be distinguished against the page's background color. end example] If the border style (the The possible values for this attribute are defined by the ST_HexColor simple type (§2.18.43). |
|
frame (Create Frame Effect) |
Specifies whether the specified border should be modified to create a frame effect by reversing the border's appearance from the edge nearest the text to the edge furthest from the text. If this attribute is omitted, then the border is not given any frame effect. [Example: Consider a bottom border which shall appear with a frame effect, which is specified in the following WordprocessingML:
This frame's The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
shadow (Border Shadow) |
Specifies whether this border should be modified to create the appearance of a shadow. For the right and bottom borders, this is accomplished by duplicating the border below and right of the normal border location. For the right and top borders, this is accomplished by moving the order down and to the right of its original location. If this attribute is omitted, then the border is not given the shadow effect. [Example: Consider a top border which shall appear with a shadow effect, resulting in the following WordprocessingML:
This frame's The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
space (Border Spacing Measurement) |
Specifies the spacing offset that shall be used to place this border on the parent object. When a document has a page border that is relative to the page edges (using a value of page in the When a document has a page border that is relative to the text extents (using a value of text in the [Example: Consider a document with a set of page borders all specified to appear 24 points from the edge of the page. The resulting WordprocessingML would be as follows:
The The possible values for this attribute are defined by the ST_PointMeasure simple type (§2.18.75). |
|
sz (Border Width) |
Specifies the width of the current border. If the border style ( If the border style ( [Example: Consider a document with a three point wide dashed line border on all sides, resulting in the following WordprocessingML markup:
The border style is specified using the The possible values for this attribute are defined by the ST_EighthPointMeasure simple type (§2.18.27). |
|
themeColor (Border Theme Color) |
Specifies a theme color to be applied to the current border. The specified theme color is a reference to one of the predefined theme colors, located in the document's Theme part,which allows color information to be set centrally in the document. [Example: Consider a set of borders configured to use the accent2 theme color, resulting in the following WordprocessingML markup:
The borders have a The possible values for this attribute are defined by the ST_ThemeColor simple type (§2.18.104). |
|
themeShade (Border Theme Color Shade) |
Specifies the shade value applied to the supplied theme color (if any) for this border instance. If the The [Example: Consider a shade of 40% applied to a border in a document. This shade is calculated as follows: (missing picture formula-2.3.1.7-1) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.1.7-2) [Example: Consider a document with a background using the accent2 theme color, whose RGB value (in RRGGBB hex format) is C0504D. The equivalent HSL color value would be. Applying the shade formula with a shade percentage of 75% to the luminance, we get: (missing picture formula-2.3.1.7-3) Taking the resulting HSL color value of and converting back to RGB, we get 943634. This transformed value can be seen in the resulting background's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
themeTint (Border Theme Color Tint) |
Specifies the tint value applied to the supplied theme color (if any) for this border instance. If the The [Example: Consider a tint of 60% applied to a border in a document. This tint is calculated as follows: (missing picture formula-2.3.1.7-4) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.1.7-5) [Example: Consider a document with a background using the accent2 theme color, whose RGB value (in RRGGBB hex format) is 4F81BD. The equivalent HSL color value would be. Applying the tint formula with a tint percentage of 60% to the luminance, we get: (missing picture formula-2.3.1.7-6) Taking the resulting HSL color value of and converting back to RGB, we get 95B3D7. This transformed value can be seen in the resulting background's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
val (Border Style) |
Specifies the style of border used on this object. This border can either be an art border (a repeated image along the borders - only valid for page borders) or a line border (a line format repeated along the borders) - see the simple type definition for a description of each border style. [Example: Consider a left border resulting in the following WordprocessingML:
This border's The possible values for this attribute are defined by the ST_Border simple type (§2.18.4). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Border">
<attribute name="val" type="ST_Border" use="required"/>
<attribute name="color" type="ST_HexColor" use="optional"/>
<attribute name="themeColor" type="ST_ThemeColor" use="optional"/>
<attribute name="themeTint" type="ST_UcharHexNumber" use="optional"/>
<attribute name="themeShade" type="ST_UcharHexNumber" use="optional"/>
<attribute name="sz" type="ST_EighthPointMeasure" use="optional"/>
<attribute name="space" type="ST_PointMeasure" use="optional"/>
<attribute name="shadow" type="ST_OnOff" use="optional"/>
<attribute name="frame" type="ST_OnOff" use="optional"/>
</complexType>
This element specifies the set of conditional table style formatting properties which have been applied to this paragraph, if this paragraph is contained within a table cell. [Note: This property is an optimization which may be used by consumers to determine if a given property on a paragraph is the result of the table style properties vs. direct formatting on the paragraph itself. end note]
If this property is specified on a paragraph which is not contained within a table cell, then its contents shall be ignored when reading the contents of the document.
[Example: Consider a paragraph in the top right corner of a table with a table style applied. This paragraph would need to specify the following WordprocessingML:
<w:p>
<w:pPr>
<w:cnfStyle w:val="101000000100" />
...
<//w:pPr>
...
</w:p>
This paragraph specifies that it has the conditional properties from the table style for the first column, first row, and the NW corner of the parent table by setting the appropriate bits in the val attribute. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (Conditional Formatting Bit Mask) |
Specifies the set of conditional formatting properties that have been applied to this object. These properties are expressed using a string serialization of a binary bitmask for each of the following properties (reading from the first character position right):
For each of these properties, a value of [Example: Consider a paragraph in the top right corner of a table with a table style applied. This paragraph would need to specify the following WordprocessingML:
This paragraph specifies that it has the conditional properties from the table style for the first column, first row, and the NW corner of the parent table by setting the appropriate bits in the The possible values for this attribute are defined by the ST_Cnf simple type (§2.18.11). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Cnf">
<attribute name="val" type="ST_Cnf" use="required"/>
</complexType>
This element specifies that any space specified before or after this paragraph, specified using the spacing element (§2.3.1.33), should not be applied when the preceding and following paragraphs are of the same paragraph style, affecting the top and bottom spacing respectively. [Example: This value is typically used for paragraphs in lists, in which any space between subsequent list items, even if inherited from another style, is not desirable. end example]
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then spacing is not ignored. If it is present, then the spacing above or below on this paragraph is subtracted from the spacing which would have been present if contextual spacing was off, never going below zero.
[Example: Consider two paragraphs defined as follows:
<w:p>
<w:pPr>
<w:pStyle w:val="TestParagraphStyle" />
<w:spacing w:after="200"/>
<w:contextualSpacing/>
</w:pPr>
...
</w:p>
<w:p>
<w:pPr>
<w:pStyle w:val="TestParagraphStyle" />
<w:spacing w:before="240"/>
</w:pPr>
...
</w:p>
The first paragraph specifies a spacing after of 10 points, and the second paragraph specifies a spacing before of 12 points, therefore according to the rules on the spacing element, the net paragraph spacing should be 12 points. However, since the first paragraph specifies that its spacing should be omitted between paragraphs of the same style, and the two paragraphs use the same TestParagraphStyle, that value is subtracted from the total, therefore the paragraphs are spaced by 2 points. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies that this paragraph should be located within the specified HTML div tag when this document is saved in HTML format. This ID is then used to look up the associated div stored in the divs (§2.15.2.8) element. [Note: This element is used to preserve the fidelity of existing HTML documents when saved in the WordprocessingML format. end note].
If the paragraph does not specify this element, then any div referenced by the previous paragraph is closed, and this paragraph shall not belong to any div when saved as HTML. If this specified id does not exist in the collection of divs the current document, then any div referenced by the previous paragraph is closed, and this paragraph shall not belong to any div when saved as HTML.
[Example: Consider the following WordprocessingML paragraph fragment:
<w:p>
<w:pPr>
<w:divId w:val="1512645511" />
</w:pPr>
</w:p>
This paragraph specifies that it belongs to the HTML div with id 1512645511, stored in the divs element. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (Decimal Number Value) |
Specifies that the contents of this attribute will contain a decimal number. The contents of this decimal number are interpreted based on the context of the parent XML element. [Example: Consider the following numeric WordprocessingML property of type ST_DecimalNumber: <w:... w:val="1512645511" /> The value of the The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_DecimalNumber">
<attribute name="val" type="ST_DecimalNumber" use="required"/>
</complexType>
This element specifies information about the current paragraph with regard to text frames. Text frames are paragraphs of text in a document which are positioned in a separate region or frame in the document, and can be positioned with a specific size and position relative to non-frame paragraphs in the current document.
The first piece of information specified by the framePr element is that the current paragraph is actually part of a text frame in the document. This information is specified simply by the presence of the framePr element in paragraph's properties. If the framePr element is omitted, the paragraph shall not be part of any text frame in the document.
The second piece of information concerns the set of paragraphs which are part of the current text frame in the document. This is determined based on the attributes on the framePr element. If the set of attribute values specified on two adjacent paragraphs is identical, then those two paragraphs shall be considered to be part of the same text frame and rendered within the same frame in the document.
[Example: Consider a document in which the following two paragraphs are located adjacent to one another:
<w:p>
<w:pPr>
<w:framePr w:w="2191" w:h="811" w:hRule="exact" w:hSpace="180" w:wrap="around" w:vAnchor="text" w:hAnchor="page" w:x="1921"/>
</w:pPr>
<w:r>
<w:t>Paragraph One</w:t>
</w:r>
</w:p>
<w:p>
<w:pPr>
<w:framePr w:w="2191" w:h="810" w:hRule="exact" w:hSpace="180" w:wrap="around" w:vAnchor="text" w:hAnchor="page" w:x="1921"/>
</w:pPr>
<w:r>
<w:t>Paragraph Two.</w:t>
</w:r>
</w:p>
These two paragraphs, although each is a part of a text frame due to the presence of the framePr element, are different text frames because of the differing h value - 810 vs. 811. end example]
The positioning of the frame relative to the properties stored on its attribute values shall be calculated relative to the next paragraphs in the document which is itself not part of a text frame.
[Example: Consider a document in which the following three paragraphs are located adjacent to one another:
<w:p>
<w:pPr>
<w:framePr w:w="2191" w:h="811" w:hRule="exact" w:hSpace="180" w:wrap="around" w:vAnchor="text" w:hAnchor="page" w:x="1921"/>
</w:pPr>
<w:r>
<w:t>Paragraph One</w:t>
</w:r>
</w:p>
<w:p>
<w:pPr>
<w:framePr w:w="2191" w:h="811" w:hRule="exact" w:hSpace="180" w:wrap="around" w:vAnchor="text" w:hAnchor="page" w:x="1921"/>
</w:pPr>
<w:r>
<w:t>Paragraph Two.</w:t>
</w:r>
</w:p>
<w:p/>
The first two paragraphs form a single text frame, which is anchored using its attribute values relative to the first non-frame paragraph following it (the third paragraph in the example). end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
anchorLock (Lock Frame Anchor to Paragraph) |
Specifies that the frame shall always remain in the same logical position relative to the non-frame paragraphs which precede and follow it in this document. This means that consumers which modify this document shall ensure that this text frame remains directly above the non-frame paragraph which it is currently above, by adjusting the frame's positioning properties as needed as the paragraph is moved throughout the document rather than moving the frame's logical location within the paragraphs in the document, if that would be more appropriate. If this attribute is omitted, then this frame shall not have a locked anchor position. [Example: Consider the following WordprocessingML paragraph contained in a text frame:
This text frame has a locked anchor using the anchorLock attribute. If the text frame is moved down in the document, the text frame properties must be adjusted to be relative to the parent paragraph's same logical position - the paragraph cannot be relocated in the document, which results in changes to the frame's properties as follows:
The non-frame paragraph was relocated 5320 twentieths of a point below its original location in the document, and the frame's vertical positioning properties were adjusted to ensure its logical location within the paragraph ordering was constant while its visual location was changed. end example] The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
dropCap (Drop Cap Frame) |
Specifies that the current frame contains a drop cap to be located at the beginning of the next non-frame paragraph in the document. Its contents shall be used to specify how that drop cap should be positioned relative to that paragraph. If this attribute is omitted, then this frame shall not be considered a drop cap frame. [Note: Although a drop cap is simply a text frame, this element is used to determine how the cap should be positioned relative to the following non-frame paragraph in relative terms (see possible values), rather than relying on absolute sizing. end note] [Example: Consider the following paragraph containing a text frame which should be positioned as a drop cap:
The The possible values for this attribute are defined by the ST_DropCap simple type (§2.18.24). |
|
h (Frame Height) |
Specifies the frame's height. This height is expressed in twentieths of a point. If this attribute is omitted, then its value shall be assumed to be 0. The meaning of the value of the
[Example: Consider the following paragraph containing a text frame:
The The possible values for this attribute are defined by the ST_TwipsMeasure simple type (§2.18.105). |
|
hAnchor (Frame Horizontal Positioning Base) |
Specifies the base object from which the horizontal positioning in the A text frame may be horizontally positioned relative to:
If this attribute is omitted, then its value shall be assumed to be page. [Example: Consider a text frame which should be positioned one inch to the right of its column in a left-to-right document. This text frame would be specified using the following WordprocessingML:
These frame properties specify that they are relative to the anchor paragraph's column, and that relative to that column, the frame should be 1440 twentieths of a point in the direction of the flow of text (right, in this case). end example] The possible values for this attribute are defined by the ST_HAnchor simple type (§2.18.40). |
|
hRule (Frame Height Type) |
Specifies the meaning of the height specified for this frame. The meaning of the value of the
If this attribute is omitted, then its value shall be assumed to be auto. [Example: Consider the following paragraph containing a text frame:
The The possible values for this attribute are defined by the ST_HeightRule simple type (§2.18.42). |
|
hSpace (Horizontal Frame Padding) |
Specifies the minimum distance which shall be maintained between the current text frame and any non-frame text which has been allowed to flow around this object when the This distance is expressed in twentieths of a point. If the [Example: Consider a text frame which should have a minimum of a one-half inch spacing from any non-frame text on its left and right sides. This constraint would be specified using the following WordprocessingML:
The The possible values for this attribute are defined by the ST_TwipsMeasure simple type (§2.18.105). |
|
lines (Drop Cap Vertical Height in Lines) |
Specifies the number of lines in the non-frame paragraph to which this text frame is anchored which should be used to calculate the drop cap's height. If the current frame is not a drop cap (the parent framePr element does not have the If this attribute is omitted, then its value shall be considered to be 1. [Example: Consider the following paragraph containing a text frame which should be positioned as a drop cap:
Since this frame is being used as a dropped cap, the The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16). |
|
vAnchor (Frame Vertical Positioning Base) |
Specifies the base object from which the horizontal positioning in the A text frame may be horizontally positioned relative to:
If this attribute is omitted, then its value shall be assumed to be page. [Example: Consider a text frame which should be positioned two inches below the page top in a top-to-bottom document. This text frame would be specified using the following WordprocessingML:
These frame properties specify that they are relative to the anchor page, and that relative to that column, the frame should be 2880 twentieths of a point in the direction of the flow of text (down, in this case). end example] The possible values for this attribute are defined by the ST_VAnchor simple type (§2.18.109). |
|
vSpace (Vertical Frame Padding) |
Specifies the minimum distance which shall be maintained between the current text frame and any non-frame text which is above or below this text frame. This distance is expressed in twentieths of a point. If this attribute is omitted, its value shall be assumed to be 0. [Example: Consider a text frame which should have a minimum of a one-half inch spacing from any non-frame text on its top and bottom sides. This constraint would be specified using the following WordprocessingML:
The The possible values for this attribute are defined by the ST_TwipsMeasure simple type (§2.18.105). |
|
w (Frame Width) |
Specifies the exact value for this text frame's width. This value is specified in twentieths of a point. When this attribute is present, the text frame shall be rendered to the exact width specified. If this attribute is omitted, the text frame width shall be automatically determined by the maximum line width of the content within the text frame. [Example: Consider the following WordprocessingML fragment specifying a text frame:
This text frame specifies that its width shall be exactly The possible values for this attribute are defined by the ST_TwipsMeasure simple type (§2.18.105). |
|
wrap (Text Wrapping Around Frame) |
Specifies the type of text wrapping which should be allowed around the contents of this text frame. This attribute determines if non-frame text shall be allowed to flow around the contents of this frame. If this attribute is omitted, its value shall be assumed to be around. [Example: Consider the following WordprocessingML fragment specifying a text frame:
This text frame specifies that when the frame is rendered on the page, any non-text frame paragraphs which would normally flow onto the same lines shall be allowed to do so. end example] The possible values for this attribute are defined by the ST_Wrap simple type (§2.18.113). |
|
x (Absolute Horizontal Position) |
Specifies an absolute horizontal position for the text frame. This absolute position is specified relative to the horizontal anchor specified by the This value is expressed in twentieths of a point. If it is positive, then the text frame is positioned after the anchor object in the direction of horizontal text flow in this document. If it is negative, then the text frame is positioned before the anchor object in the direction of horizontal text flow in this document. If the [Example: Consider the following WordprocessingML fragment specifying a text frame:
This text frame specifies that it should be located exactly 1643 twentieths of a point after the vertical edge of the page (from the The possible values for this attribute are defined by the ST_SignedTwipsMeasure simple type (§2.18.88). |
|
xAlign (Relative Horizontal Position) |
Specifies a relative horizontal position for the text frame. This relative position is specified relative to the horizontal anchor specified by the If omitted, this attribute is not specified and the value of the [Example: Consider the following WordprocessingML fragment specifying a text frame:
This text frame specifies that it has a horizontal placement of exactly 1643 twentieths of a point relative to the page, but that exact placement is overridden by the presence of the The possible values for this attribute are defined by the ST_XAlign simple type (§2.18.114). |
|
y (Absolute Vertical Position) |
Specifies an absolute vertical position for the text frame. This absolute position is specified relative to the vertical anchor specified by the This value is expressed in twentieths of a point. If it is positive, then the text frame is positioned after the anchor object in the direction of vertical text flow in this document. If it is negative, then the text frame is positioned before the anchor object in the direction of vertical text flow in this document. If the [Example: Consider the following WordprocessingML fragment specifying a text frame:
This text frame specifies that it should be located exactly 79 twentieths of a point below the top vertical edge of the anchor's paragraph's text (from the The possible values for this attribute are defined by the ST_SignedTwipsMeasure simple type (§2.18.88). |
|
yAlign (Relative Vertical Position) |
Specifies a relative vertical position for the text frame. This relative position is specified relative to the vertical anchor specified by the If omitted, this attribute is not specified and the value of the [Example: Consider the following WordprocessingML fragment specifying a text frame:
This text frame specifies that it has a vertical placement of exactly 73 twentieths of a point relative to the top margin, but that exact placement is overridden by the presence of the The possible values for this attribute are defined by the ST_YAlign simple type (§2.18.115). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_FramePr">
<attribute name="dropCap" type="ST_DropCap" use="optional"/>
<attribute name="lines" type="ST_DecimalNumber" use="optional"/>
<attribute name="w" type="ST_TwipsMeasure" use="optional"/>
<attribute name="h" type="ST_TwipsMeasure" use="optional"/>
<attribute name="vSpace" type="ST_TwipsMeasure" use="optional"/>
<attribute name="hSpace" type="ST_TwipsMeasure" use="optional"/>
<attribute name="wrap" type="ST_Wrap" use="optional"/>
<attribute name="hAnchor" type="ST_HAnchor" use="optional"/>
<attribute name="vAnchor" type="ST_VAnchor" use="optional"/>
<attribute name="x" type="ST_SignedTwipsMeasure" use="optional"/>
<attribute name="xAlign" type="ST_XAlign" use="optional"/>
<attribute name="y" type="ST_SignedTwipsMeasure" use="optional"/>
<attribute name="yAlign" type="ST_YAlign" use="optional"/>
<attribute name="hRule" type="ST_HeightRule" use="optional"/>
<attribute name="anchorLock" type="ST_OnOff" use="optional"/>
</complexType>
This element specifies the set of indentation properties applied to the current paragraph.
Indentation settings are overriden on an individual basis - if any single attribute on this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If any single attribute on this element is never specified in the style hierarchy, then no indentation of that type is applied to the paragraph.
[Example: Consider a paragraph which should have a one inch indentation from the text margins on both the left and the right sides, except for the first line in each paragraph, which should only be indented one quarter of an inch from the text margin (on the side which begins the flow of text for this paragraph). This set of indentations is specified using the following WordprocessingML:
<w:pPr>
<w:ind w:left="1440" w:right="1440" w:hanging="1080" />
</w:pPr>
This set of indentation properties specifies that a 1440 twentieths of a point indentation should be provided on both the left and the right side of the text margins for this paragraph, and that a 1080 twentieths of a point hanging indent (towards the text margin) should be applied to the text in the first paragraph, giving it a net one-quarter inch indent from the text margin. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
firstLine (Additional First Line Indentation) |
Specifies the additional indentation which shall be applied to the first line of the parent paragraph. This additional indentation is specified relative to the paragraph indentation which is specified for all other lines in the parent paragraph. The [Example: Consider the following WordprocessingML fragment:
This set of indentations specifies that the first line should be indented 1440 twentieths of a point (one inch) from the indentation specified for all remaining paragraphs, which is the 1440 twentieths of a point, as specified by the The possible values for this attribute are defined by the ST_TwipsMeasure simple type (§2.18.105). |
|
firstLineChars (Additional First Line Indentation in Character Units) |
Specifies the additional indentation which shall be applied to the first line of the parent paragraph. This additional indentation is specified relative to the paragraph indentation which is specified for all other lines in the parent paragraph. It is specified in one hundredths of a character unit. The [Example: Consider the following WordprocessingML fragment:
This set of indentations specifies that the first line should be indented 140 hundredths of a character units from the indentation specified for all remaining paragraphs, which is the 1440 twentieths of a point specified by the The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16). |
|
hanging (Indentation Removed from First Line) |
Specifies the indentation which shall be removed from the first line of the parent paragraph, by moving the indentation on the first line back towards the beginning of the direction of text flow. This indentation is specified relative to the paragraph indentation which is specified for all other lines in the parent paragraph. The [Example: Consider the following WordprocessingML fragment:
This set of indentations specifies that the first line should be indented 720 twentieths of a point (one inch) towards the text margin from the indentation specified for all remaining paragraphs, which is the 1440 twentieths of a point specified by the The possible values for this attribute are defined by the ST_TwipsMeasure simple type (§2.18.105). |
|
hangingChars (Indentation Removed From First Line in Character Units) |
Specifies the indentation which shall be removed from the first line of the parent paragraph, by moving the indentation on the first line back towards the beginning of the direction of text flow. This indentation is specified relative to the paragraph indentation which is specified for all other lines in the parent paragraph. It is specified in one hundredths of a character unit. The [Example: Consider the following WordprocessingML fragment:
This set of indentations specifies that the first line should be indented one character unit towards the text margin from the indentation specified for all remaining paragraphs, which is the 1440 twentieths of a point specified by the The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16). |
|
left (Left Indentation) |
Specifies the indentation which shall be placed between the left text margin for this paragraph and the left edge of that paragraph's content in a left to right paragraph, and the right text margin and the right edge of that paragraph's text in a right to left paragraph. If the mirrorIndents property (§2.3.1.18) is specified for this paragraph, then this indent is used for the inside page edge - the right page edge for odd numbered pages and the left page edge for even numbered pages. If this attribute is omitted, its value shall be assumed to be zero. All other values for this element are relative to the text margin, Negative values are defined such that the text is moved past the text margin, positive values move the text inside the text margin. This value may be superseded for the first line only via use of the [Example: Consider the following WordprocessingML fragment:
This set of paragraph indentations specifies that this paragraph's text should be indented The possible values for this attribute are defined by the ST_SignedTwipsMeasure simple type (§2.18.88). |
|
leftChars (Left Indentation in Character Units) |
Specifies the indentation which shall be placed between the left text margin for this paragraph and the left edge of that paragraph's content in a left to right paragraph, and the right text margin and the right edge of that paragraph's text in a right to left paragraph. If the mirrorIndents property (§2.3.1.18) is specified for this paragraph, then this indent is used for the inside page edge - the right page edge for odd numbered pages and the left page edge for even numbered pages. This value is specified in hundredths of a character unit. If this attribute is omitted, its value shall be assumed to be zero. All other values for this element are relative to the text margin, Negative values are defined such that the text is moved past the text margin, positive values move the text inside the text margin. This value may be superseded for the first line only via use of the [Example: Consider the following WordprocessingML fragment:
This set of paragraph indentations specifies that this paragraph's text should be indented two and a half character units from the left text margin in this document. end example] The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16). |
|
right (Right Indentation) |
Specifies the indentation which shall be placed between the right text margin for this paragraph and the right edge of that paragraph's content in a left to right paragraph, and the left text margin and the left edge of that paragraph's text in a right to left paragraph. If the mirrorIndents property (§2.3.1.18) is specified for this paragraph, then this indent is used for the outside page edge - the left page edge for odd numbered pages and the right page edge for even numbered pages. If this attribute is omitted, its value shall be assumed to be zero. All other values for this element are relative to the text margin, Negative values are defined such that the text is moved past the text margin, positive values move the text inside the text margin. As well, if the [Example: Consider the following WordprocessingML fragment:
This set of paragraph indentations specifies that this paragraph's text should be indented The possible values for this attribute are defined by the ST_SignedTwipsMeasure simple type (§2.18.88). |
|
rightChars (Right Indentation in Character Units) |
Specifies the indentation which shall be placed between the right text margin for this paragraph and the right edge of that paragraph's content in a left to right paragraph, and the left text margin and the left edge of that paragraph's text in a right to left paragraph. If the mirrorIndents property (§2.3.1.18) is specified for this paragraph, then this indent is used for the outside page edge - the left page edge for odd numbered pages and the right page edge for even numbered pages. This value is specified in hundredths of a character unit. If this attribute is omitted, its value shall be assumed to be zero. All other values for this element are relative to the right text margin, Negative values are defined such that the text is moved past the text margin, positive values move the text inside the text margin. As well, if the [Example: Consider the following WordprocessingML fragment:
This set of paragraph indentations specifies that this paragraph's text should be indented two and a half character units from the right text margin in this document, assuming this is a left to right paragraph. end example] The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Ind">
<attribute name="left" type="ST_SignedTwipsMeasure" use="optional"/>
<attribute name="leftChars" type="ST_DecimalNumber" use="optional"/>
<attribute name="right" type="ST_SignedTwipsMeasure" use="optional"/>
<attribute name="rightChars" type="ST_DecimalNumber" use="optional"/>
<attribute name="hanging" type="ST_TwipsMeasure" use="optional"/>
<attribute name="hangingChars" type="ST_DecimalNumber" use="optional"/>
<attribute name="firstLine" type="ST_TwipsMeasure" use="optional"/>
<attribute name="firstLineChars" type="ST_DecimalNumber" use="optional"/>
</complexType>
This element specifies the paragraph alignment which shall be applied to text in this paragraph.
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then no alignment is applied to the paragraph.
[Example: Consider a paragraph which should be right justified to the right page side paragraph extents within a document. This constraint is specified in the following WordprocessingML content:
<w:pPr>
<w:jc w:val="right" />
</w:pPr>
The paragraph is now right justified on the page. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (Alignment Type) |
Specifies the justification which should be applied to the parent object within a document. The possible values (see below) for this attribute are always specified relative to the page, and do not change semantic from right-to-left and left-to-right documents. [Example: Consider the following WordprocessingML fragment for a paragraph in a document:
This paragraph is now right justified on the page, regardless of the paragraph or section settings. end example] The possible values for this attribute are defined by the ST_Jc simple type (§2.18.50). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Jc">
<attribute name="val" type="ST_Jc" use="required"/>
</complexType>
This element specifies that when rendering this document in a page view, all lines for this page are maintained on a single page whenever possible.
This means that if the contents of the current paragraph would normally span across two pages due to the placement of the paragraph's text, all lines in this paragraph shall be moved onto the next page to ensure they are displayed together. If this is not possible because all lines in the paragraph would exceed a single page in any case, then lines in this paragraph shall start on a new page, with page breaks as needed afterwards.
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then this property shall not be applied.
[Example: Consider a WordprocessingML document in which a code fragment (such as the schema fragments in this document) are defined such that they should never be broken across a page boundary in order to improve readability. This constraint would be specified using the following paragraph properties in WordprocessingML:
<w:pPr>
<w:keepLines />
...
</w:pPr>
This setting ensures that the schema fragment will be displayed on one page if possible. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies that when rendering this document in a paginated view, the contents of this paragraph are at least partly rendered on the same page as the following paragraph whenever possible.
This means that if the contents of the current paragraph would normally be completely rendered on a different page than the following paragraph (because only one of the two paragraphs would fit on the remaining space on the first page), then both paragraphs shall be rendered on a single page. This property can be chained between multiple paragraphs to ensure that all paragraphs are rendered on a single page without any intervening page boundaries. If this is not possible the entire set of paragraphs that are grouped together using this property would exceed a single page in any case, then the set of "keep with next" paragraphs shall start on a new page, with page breaks as needed afterwards.
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then this property shall not be applied.
[Example: Consider the following document with three paragraphs:
As shown above, the second paragraph and third paragraph are being rendered on two separate pages. However, a producer can specify that the second paragraph should not be displayed without any part of the third by setting the keepNext element as follows:
<w:pPr>
<w:keepNext/>
...
</w:pPr>
This would ensure that the second paragraph is displayed on the same page as the third paragraph:
However, if the first paragraph was also set to keepNext, then this set of grouped paragraphs would exceed a page, therefore the set of paragraphs would be grouped and start on the first page, resulting in the second paragraph reappearing on page one:
Since the paragraphs cannot all be put on one page, they all start on page one and flow as needed. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies whether East Asian typography and line-breaking rules shall be applied to text in this paragraph to determine which characters may begin and end each line. This property only applies to Chinese PRC, Chinese Taiwan, and Japanese text in this paragraph.
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then this property shall be applied to Chinese PRC, Chinese Taiwan, and Japanese text in this paragraph.
If these rules are set on the current paragraph, then the following rules are applied to the all first and last characters in the paragraph except the first and last character in the paragraph. By default, the following settings are used for kinsoku paragraphs:
Chinese (Simplified)
Chinese (Traditional)
Japanese
Korean
If the strictFirstAndLastChars property (§2.15.1.83) is set in the Document Settings part, then the following settings supersede the defaults for Japanese:
If the noLineBreaksBefore property (§2.15.1.59) is set in the Document Settings part, then the characters it specifies cannot begin a line for the specified language. If the noLineBreaksAfter property (§2.15.1.58) is set in the Document Settings part, then the characters it specifies cannot end a line for the specified language. In both cases, those settings shall supersede the defaults specified above.
[Example: Consider a document with a paragraph which should not use the kinsoku line breaking properties. This paragraph would define the following WordprocessingML:
<w:pPr>
<w:kinsoku w:val="off" />
</w:pPr>
This paragraph would now be exempt from any kinsoku line breaking rules, and the characters specified above are allowed to begin and end lines as they normally would. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies the border which shall be displayed on the left side of the page around the specified paragraph.
To determine if any two adjoining paragraphs should have a left border which spans the full line height or not, the left border shall be drawn between the top border or between border at the top (whichever would be rendered for the current paragraph), and the bottom border or between border at the bottom (whichever would be rendered for the current paragraph).
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then no left border shall be applied.
[Example: Consider the following two paragraphs' WordprocessingML definition:
<w:p>
<w:pPr>
<w:pBdr>
<w:top w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />
<w:left w:val="single" w:sz="24" w:space="4" w:color="B97034" w:themeColor="accent6" w:themeShade="BF" />
<w:bottom w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />
<w:right w:val="single" w:sz="24" w:space="4" w:color="C3D69B" w:themeColor="accent3" w:themeTint="99" />
<w:between w:val="single" w:sz="24" w:space="1" w:color="4F81BD" w:themeColor="accent1" />
</w:pBdr>
</w:pPr>
<w:r>
<w:t>First paragraph.</w:t>
</w:r>
</w:p>
<w:p>
<w:pPr>
<w:pBdr>
<w:top w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />
<w:left w:val="single" w:sz="24" w:space="4" w:color="B97034" w:themeColor="accent6" w:themeShade="BF" />
<w:bottom w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />
<w:right w:val="single" w:sz="24" w:space="4" w:color="C3D69B" w:themeColor="accent3" w:themeTint="99" />
<w:between w:val="single" w:sz="24" w:space="1" w:color="4F81BD" w:themeColor="accent1" />
</w:pBdr>
</w:pPr>
<w:r>
<w:t>Second paragraph.</w:t>
</w:r>
</w:p>
Since the paragraph border set is identical between the two paragraphs, the paragraphs are connected by a between border. These paragraphs will therefore draw the left border between the top and between borders for the first paragraph, and the between and bottom borders for the second paragraph. end example]
|
Parent Elements |
|
pBdr (§2.3.1.24) |
|
Attributes |
Description |
|---|---|
|
color (Border Color) |
Specifies the color for this border. This color may either be presented as a hex value (in RRGGBB format), or auto to allow a consumer to automatically determine the border color as appropriate. [Example: Consider a border color with value auto, as follows:
This color therefore may be automatically be modified by a consumer as appropriate, for example, in order to ensure that the border can be distinguished against the page's background color. end example] If the border style (the The possible values for this attribute are defined by the ST_HexColor simple type (§2.18.43). |
|
frame (Create Frame Effect) |
Specifies whether the specified border should be modified to create a frame effect by reversing the border's appearance from the edge nearest the text to the edge furthest from the text. If this attribute is omitted, then the border is not given any frame effect. [Example: Consider a bottom border which shall appear with a frame effect, which is specified in the following WordprocessingML:
This frame's The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
shadow (Border Shadow) |
Specifies whether this border should be modified to create the appearance of a shadow. For the right and bottom borders, this is accomplished by duplicating the border below and right of the normal border location. For the right and top borders, this is accomplished by moving the order down and to the right of its original location. If this attribute is omitted, then the border is not given the shadow effect. [Example: Consider a top border which shall appear with a shadow effect, resulting in the following WordprocessingML:
This frame's The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
space (Border Spacing Measurement) |
Specifies the spacing offset that shall be used to place this border on the parent object. When a document has a page border that is relative to the page edges (using a value of page in the When a document has a page border that is relative to the text extents (using a value of text in the [Example: Consider a document with a set of page borders all specified to appear 24 points from the edge of the page. The resulting WordprocessingML would be as follows:
The The possible values for this attribute are defined by the ST_PointMeasure simple type (§2.18.75). |
|
sz (Border Width) |
Specifies the width of the current border. If the border style ( If the border style ( [Example: Consider a document with a three point wide dashed line border on all sides, resulting in the following WordprocessingML markup:
The border style is specified using the The possible values for this attribute are defined by the ST_EighthPointMeasure simple type (§2.18.27). |
|
themeColor (Border Theme Color) |
Specifies a theme color to be applied to the current border. The specified theme color is a reference to one of the predefined theme colors, located in the document's Theme part,which allows color information to be set centrally in the document. [Example: Consider a set of borders configured to use the accent2 theme color, resulting in the following WordprocessingML markup:
The borders have a The possible values for this attribute are defined by the ST_ThemeColor simple type (§2.18.104). |
|
themeShade (Border Theme Color Shade) |
Specifies the shade value applied to the supplied theme color (if any) for this border instance. If the The [Example: Consider a shade of 40% applied to a border in a document. This shade is calculated as follows: (missing picture formula-2.3.1.17-1) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.1.17-2) [Example: Consider a document with a background using the accent2 theme color, whose RGB value (in RRGGBB hex format) is C0504D. The equivalent HSL color value would be. Applying the shade formula with a shade percentage of 75% to the luminance, we get: (missing picture formula-2.3.1.17-3) Taking the resulting HSL color value of and converting back to RGB, we get 943634. This transformed value can be seen in the resulting background's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
themeTint (Border Theme Color Tint) |
Specifies the tint value applied to the supplied theme color (if any) for this border instance. If the The [Example: Consider a tint of 60% applied to a border in a document. This tint is calculated as follows: (missing picture formula-2.3.1.17-4) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.1.17-5) [Example: Consider a document with a background using the accent2 theme color, whose RGB value (in RRGGBB hex format) is 4F81BD. The equivalent HSL color value would be. Applying the tint formula with a tint percentage of 60% to the luminance, we get: (missing picture formula-2.3.1.17-6) Taking the resulting HSL color value of and converting back to RGB, we get 95B3D7. This transformed value can be seen in the resulting background's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
val (Border Style) |
Specifies the style of border used on this object. This border can either be an art border (a repeated image along the borders - only valid for page borders) or a line border (a line format repeated along the borders) - see the simple type definition for a description of each border style. [Example: Consider a left border resulting in the following WordprocessingML:
This border's The possible values for this attribute are defined by the ST_Border simple type (§2.18.4). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Border">
<attribute name="val" type="ST_Border" use="required"/>
<attribute name="color" type="ST_HexColor" use="optional"/>
<attribute name="themeColor" type="ST_ThemeColor" use="optional"/>
<attribute name="themeTint" type="ST_UcharHexNumber" use="optional"/>
<attribute name="themeShade" type="ST_UcharHexNumber" use="optional"/>
<attribute name="sz" type="ST_EighthPointMeasure" use="optional"/>
<attribute name="space" type="ST_PointMeasure" use="optional"/>
<attribute name="shadow" type="ST_OnOff" use="optional"/>
<attribute name="frame" type="ST_OnOff" use="optional"/>
</complexType>
This element specifies whether the paragraph indents should be interpreted as mirrored indents. When this element is present, the left indent shall become the inside indent and the right indent shall become the outside indent.
If the mirrorIndents property is specified for this paragraph, then the inside page edge is the right page edge for odd numbered pages and the left page edge for even numbered pages. Conversely, the outside page edge is the left page edge for odd numbered pages and the right page edge for even numbered pages.
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then this property shall not be applied.
[Example: Consider a paragraph on the first page of a document which should have a one inch indentation from the text margins on the inside edge when the resulting document is printed and bound. This means that the paragraph will have a one inch right border if it is on an odd numbered page, and a one inch left border if it is on an even numbered page. This set of indentations is specified using the following WordprocessingML:
<w:pPr>
<w:ind w:left="1440" />
<w:mirrorIndents />
</w:pPr>
This set of indentation properties specifies that a 1440 twip indentation should be provided on the left side of the text margins for this paragraph. However, since the mirrorIndents property is set, the left indent is really the inside indent, and if this paragraph is on page one, shall result in a one inch right indent from the text margin. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies that the current paragraph references a numbering definition instance in the current document.
The presence of this element specifies that the paragraph will inherit the properties specified by the numbering definition in the num element (§2.9.16) at the level specified by the level specified in the lvl element (§2.9.7) and shall have an associated number positioned before the beginning of the text flow in this paragraph. When this element appears as part of the paragraph formatting for a paragraph style, then any numbering level defined using the ilvl element shall be ignored, and the pStyle element (§2.9.25) on the associated abstract numbering definition shall be used instead.
[Example: Consider a paragraph in a document which should be associated with level 4 of a numbering definition with ID 0. Associating the paragraph with this numbering definition would be specified using the following WordprocessingML:
<w:pPr>
<w:numPr>
<w:ilvl w:val="4" />
<w:numId w:val="0" />
</w:numPr>
</w:pPr>
The numPr element specifies that this paragraph shall contain numbering information, and its children specify that the numbering definition for that numbering information shall have a numId of 0 and an ilvl of 4 within that numbering definition. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Child Elements |
Subclause |
|---|---|
|
ilvl (Numbering Level Reference) |
|
|
ins (Inserted Numbering Properties) |
|
|
numberingChange (Previous Paragraph Numbering Properties) |
|
|
numId (Numbering Definition Instance Reference) |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_NumPr">
<sequence>
<element name="ilvl" type="CT_DecimalNumber" minOccurs="0"/>
<element name="numId" type="CT_DecimalNumber" minOccurs="0"/>
<element name="numberingChange" type="CT_TrackChangeNumbering" minOccurs="0"/>
<element name="ins" type="CT_TrackChange" minOccurs="0"/>
</sequence>
</complexType>
This element specifies the outline level which shall be associated with the current paragraph in the document. The outline level specifies an integer which defines the level of the associated text. This level shall not affect the appearance of the text in the document, but shall be used to calculate the TOC field (§2.16.5.75) if the appropriate field switches have been set, and may be used by consumers to provide additional application behavior.
The outline level of text in the document (specified using the val attribute) may be from 0 to 9, where 9 specifically indicates that there is no outline level specifically applied to this paragraph. If this element is omitted, then the outline level of the content is assumed to be 9 (no level).
[Example: Consider a paragraph in a document which has outline level 1 applied to it. This paragraph would specify the following WordprocessingML:
<w:pPr>
<w:outlineLvl w:val="0" />
</w:pPr>
This paragraph is now of outline level 1, and if a table of contents field is inserted that utilizes outlines levels, the text in this paragraph will be at level one in the TOC. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (Decimal Number Value) |
Specifies that the contents of this attribute will contain a decimal number. The contents of this decimal number are interpreted based on the context of the parent XML element. [Example: Consider the following numeric WordprocessingML property of type ST_DecimalNumber: <w:... w:val="1512645511" /> The value of the The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_DecimalNumber">
<attribute name="val" type="ST_DecimalNumber" use="required"/>
</complexType>
This element specifies that punctuation characters which appear at the end of text in any line in this paragraph shall be allowed to extend one character past the text extents (indents/margins) as needed in order to ensure that they are not displayed as hanging punctuation. Hanging punctuation is defined as punctuation which appears on a different line than the text which it logically would appear with.
Omitting this element sets its value to true.
[Example: Consider a WordprocessingML document with the following string at the end of a line:
"This is some text in quotation marks"
Typically, if the text extents would normally fall between the letter s and the closing quotation mark, the quotation mark would be allowed to extend past the end of the line by one character even though the punctuation is not part of the word marks (since the omission of overflowPunct is equivalent to setting its val attribute to true).
However, if this behavior should not be applied to this paragraph, a producer can specify this by setting the property in the WordprocessingML:
<w:pPr>
<w:overflowPunct w:val="0" />
</w:pPr>
The line would now break after the letter s, regardless of the fact that the next character is a quotation mark. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies a paragraph of content in the document.
The contents of a paragraph in a WordprocessingML document shall consist of any combination of the following four types of content:
[Example: Consider a basic WordprocessingML document with a single paragraph. This paragraph would be expressed as follows:
<w:document>
<w:body>
<w:p>
<w:r>
<w:t>Text</w:t>
</w:r>
<w:fldSimple w:instr="AUTHOR">
<w:r>
<w:t>Author Name</w:t>
</w:r>
</w:fldSimple>
</w:p>
</w:body>
</w:document>
The p element is the container for all of the content in the paragraph, which in this example includes both a text run and a simple field. end example]
|
Parent Elements |
|
body (§2.2.2); comment (§2.13.4.2); customXml (§2.5.1.6); docPartBody (§2.12.6); endnote (§2.11.2); footnote (§2.11.10); ftr (§2.10.3); hdr (§2.10.4); sdtContent (§2.5.2.32); tc (§2.4.62); txbxContent (§2.17.1.1) |
|
Child Elements |
Subclause |
|---|---|
|
bookmarkEnd (Bookmark End) |
|
|
bookmarkStart (Bookmark Start) |
|
|
commentRangeEnd (Comment Anchor Range End) |
|
|
commentRangeStart (Comment Anchor Range Start) |
|
|
customXml (Inline-Level Custom XML Element) |
|
|
customXmlDelRangeEnd (Custom XML Markup Deletion End) |
|
|
customXmlDelRangeStart (Custom XML Markup Deletion Start) |
|
|
customXmlInsRangeEnd (Custom XML Markup Insertion End) |
|
|
customXmlInsRangeStart (Custom XML Markup Insertion Start) |
|
|
customXmlMoveFromRangeEnd (Custom XML Markup Move Source End) |
|
|
customXmlMoveFromRangeStart (Custom XML Markup Move Source Start) |
|
|
customXmlMoveToRangeEnd (Custom XML Markup Move Destination Location End) |
|
|
customXmlMoveToRangeStart (Custom XML Markup Move Destination Location Start) |
|
|
del (Deleted Run Content) |
|
|
fldSimple (Simple Field) |
|
|
hyperlink (Hyperlink) |
|
|
ins (Inserted Run Content) |
|
|
moveFrom (Move Source Run Content) |
|
|
moveFromRangeEnd (Move Source Location Container - End) |
|
|
moveFromRangeStart (Move Source Location Container - Start) |
|
|
moveTo (Move Destination Run Content) |
|
|
moveToRangeEnd (Move Destination Location Container - End) |
|
|
moveToRangeStart (Move Destination Location Container - Start) |
|
|
oMath (Office Math) |
|
|
oMathPara (Math Paragraph) |
|
|
permEnd (Range Permission End) |
|
|
permStart (Range Permission Start) |
|
|
pPr (Paragraph Properties) |
|
|
proofErr (Proofing Error Anchor) |
|
|
r (Text Run) |
|
|
sdt (Inline-Level Structured Document Tag) |
|
|
smartTag (Inline-Level Smart Tag) |
|
|
subDoc (Anchor for Subdocument Location) |
|
Attributes |
Description |
|---|---|
|
rsidDel (Revision Identifier for Paragraph Deletion) |
Specifies a unique identifier used to track the editing session when the paragraph was deleted from the main document. All A producer may choose to increment the revision save ID value to indicate subsequent editing sessions to indicate the order of the modifications relative to other modifications in this document. The possible values for this attribute are defined by the ST_LongHexNumber simple type (§2.18.57). |
|
rsidP (Revision Identifier for Paragraph Properties) |
This attribute specifies a unique identifier used to track the editing session when the paragraph's properties were last modified in this document. All A producer may choose to increment the revision save ID value to indicate subsequent editing sessions to indicate the order of the modifications relative to other modifications in this document. The possible values for this attribute are defined by the ST_LongHexNumber simple type (§2.18.57). |
|
rsidR (Revision Identifier for Paragraph) |
This attribute specifies a unique identifier used to track the editing session when the paragraph was added to the main document. All A producer may choose to increment the revision save ID value to indicate subsequent editing sessions to indicate the order of the modifications relative to other modifications in this document. The possible values for this attribute are defined by the ST_LongHexNumber simple type (§2.18.57). |
|
rsidRDefault (Default Revision Identifier for Runs) |
This attribute specifies a unique identifier used for all runs in this paragraph which do not explicitly declare an All A producer may choose to increment the revision save ID value to indicate subsequent editing sessions to indicate the order of the modifications relative to other modifications in this document. The possible values for this attribute are defined by the ST_LongHexNumber simple type (§2.18.57). |
|
rsidRPr (Revision Identifier for Paragraph Glyph Formatting) |
This attribute specifies a unique identifier used to track the editing session when the glyph character representing the paragraph mark was last modified in the main document. All A producer may choose to increment the revision save ID value to indicate subsequent editing sessions to indicate the order of the modifications relative to other modifications in this document. The possible values for this attribute are defined by the ST_LongHexNumber simple type (§2.18.57). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_P">
<sequence>
<element name="pPr" type="CT_PPr" minOccurs="0"/>
<group ref="EG_PContent" minOccurs="0" maxOccurs="unbounded"/>
</sequence>
<attribute name="rsidRPr" type="ST_LongHexNumber"/>
<attribute name="rsidR" type="ST_LongHexNumber"/>
<attribute name="rsidDel" type="ST_LongHexNumber"/>
<attribute name="rsidP" type="ST_LongHexNumber"/>
<attribute name="rsidRDefault" type="ST_LongHexNumber"/>
</complexType>
This element specifies that when rendering this document in a paginated view, the contents of this paragraph are rendered on the start of a new page in the document.
This means that if the contents of the current paragraph would normally be rendered on the middle of a page in the host document, then the paragraph shall be rendered on a new page as if the paragraph was preceded by a page break in the WordprocessingML contents of the document. This property supersedes any use of the keepNext property, so that if any paragraph wishes to be on the same page as this paragraph, they will still be separated by a page break.
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then this property shall not be applied.
[Example: Consider the following document with three paragraphs:
As shown above, the second paragraph is rendered at the bottom of page one. However, a producer can specify that the second paragraph should be displayed at the top of a new page by setting the pageBreakBefore element as follows:
<w:pPr>
<w:pageBreakBefore/>
</w:pPr>
This would ensure that the second paragraph is displayed on a new page:
Since the paragraph is specified to start on a new page, it begins page two even though it could have fit on page one. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies the borders for the parent paragraph. Each child element shall specify a specific type of border (left, right, bottom, top, and between).
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then no paragraph borders shall be applied.
[Example: Consider a pairing of paragraphs which have a three point red border around them, and a six point border between them. These paragraphs would each have the following set of paragraph borders:
<w:pBdr>
<w:top w:val="single" w:sz="24" w:space="1" w:color="FF0000" />
<w:left w:val="single" w:sz="24" w:space="4" w:color="FF0000" />
<w:bottom w:val="single" w:sz="24" w:space="1" w:color="FF0000" />
<w:right w:val="single" w:sz="24" w:space="4" w:color="FF0000" />
<w:between w:val="single" w:sz="48" w:space="1" w:color="4D5D2C" />
</w:pBdr>
The resulting paragraphs have identical pBdr values, therefore they would use the top, left, bottom, and right borders around them as a units, and the between border between each other. This matching heuristic is further discussed in the child elements of the pBdr element. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Child Elements |
Subclause |
|---|---|
|
bar (Paragraph Border Between Facing Pages) |
|
|
between (Paragraph Border Between Identical Paragraphs) |
|
|
bottom (Paragraph Border Between Identical Paragraphs) |
|
|
left (Left Paragraph Border) |
|
|
right (Right Paragraph Border) |
|
|
top (Paragraph Border Above Identical Paragraphs) |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_PBdr">
<sequence>
<element name="top" type="CT_Border" minOccurs="0"/>
<element name="left" type="CT_Border" minOccurs="0"/>
<element name="bottom" type="CT_Border" minOccurs="0"/>
<element name="right" type="CT_Border" minOccurs="0"/>
<element name="between" type="CT_Border" minOccurs="0"/>
<element name="bar" type="CT_Border" minOccurs="0"/>
</sequence>
</complexType>
This element specifies a set of paragraph properties which shall be attributed to a revision by a particular author and at a particular time. This element contains the set of properties which have been tracked as a specific set of revisions by one author.
[Example: Consider a paragraph which should have a set of paragraph formatting properties that were added with revision tracking turned on. This set of revised properties is specified in the paragraph properties as follows:
<w:p>
<w:pPr>
<w:pBdr>
<w:bottom w:val="single" w:sz="8" w:space="4" w:color="4F81BD" />
</w:pBdr>
<w:pPrChange w:author="user1" ... >
<w:pPr>
<w:spacing w:after="300" />
<w:contextualSpacing />
</w:pPr>
</w:pPrChange>
</w:pPr>
</w:p>
The pPr element under pPrChange specifies the properties which are applied to the current paragraph with revision tracking turned on - in this case, spacing after the paragraph using the spacing element (§2.3.1.33), and that spacing should be ignored for paragraphs above/below of the same style using the contextualSpacing element (§2.3.1.9). end example]
|
Parent Elements |
|
pPrChange (§2.13.5.31) |
|
Child Elements |
Subclause |
|---|---|
|
adjustRightInd (Automatically Adjust Right Indent When Using Document Grid) |
|
|
autoSpaceDE (Automatically Adjust Spacing of Latin and East Asian Text) |
|
|
autoSpaceDN (Automatically Adjust Spacing of East Asian Text and Numbers) |
|
|
bidi (Right to Left Paragraph Layout) |
|
|
cnfStyle (Paragraph Conditional Formatting) |
|
|
contextualSpacing (Ignore Spacing Above and Below When Using Identical Styles) |
|
|
divId (Associated HTML div ID) |
|
|
framePr (Text Frame Properties) |
|
|
ind (Paragraph Indentation) |
|
|
jc (Paragraph Alignment) |
|
|
keepLines (Keep All Lines On One Page) |
|
|
keepNext (Keep Paragraph With Next Paragraph) |
|
|
kinsoku (Use East Asian Typography Rules for First and Last Character per Line) |
|
|
mirrorIndents (Use Left/Right Indents as Inside/Outside Indents) |
|
|
numPr (Numbering Definition Instance Reference) |
|
|
outlineLvl (Associated Outline Level) |
|
|
overflowPunct (Allow Punctuation to Extent Past Text Extents) |
|
|
pageBreakBefore (Start Paragraph on Next Page) |
|
|
pBdr (Paragraph Borders) |
|
|
pStyle (Referenced Paragraph Style) |
|
|
shd (Paragraph Shading) |
|
|
snapToGrid (Use Document Grid Settings for Inter-Line Paragraph Spacing) |
|
|
spacing (Spacing Between Lines and Above/Below Paragraph) |
|
|
suppressAutoHyphens (Suppress Hyphenation for Paragraph) |
|
|
suppressLineNumbers (Suppress Line Numbers for Paragraph) |
|
|
suppressOverlap (Prevent Text Frames From Overlapping) |
|
|
tabs (Set of Custom Tab Stops) |
|
|
textAlignment (Vertical Character Alignment on Line) |
|
|
textboxTightWrap (Allow Surrounding Paragraphs to Tight Wrap to Text Box Contents) |
|
|
textDirection (Paragraph Text Flow Direction) |
|
|
topLinePunct (Compress Punctuation at Start of a Line) |
|
|
widowControl (Allow First/Last Line to Display on a Separate Page) |
|
|
wordWrap (Allow Line Breaking At Character Level) |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_PPrBase">
<sequence>
<element name="pStyle" type="CT_String" minOccurs="0"/>
<element name="keepNext" type="CT_OnOff" minOccurs="0"/>
<element name="keepLines" type="CT_OnOff" minOccurs="0"/>
<element name="pageBreakBefore" type="CT_OnOff" minOccurs="0"/>
<element name="framePr" type="CT_FramePr" minOccurs="0"/>
<element name="widowControl" type="CT_OnOff" minOccurs="0"/>
<element name="numPr" type="CT_NumPr" minOccurs="0"/>
<element name="suppressLineNumbers" type="CT_OnOff" minOccurs="0"/>
<element name="pBdr" type="CT_PBdr" minOccurs="0"/>
<element name="shd" type="CT_Shd" minOccurs="0"/>
<element name="tabs" type="CT_Tabs" minOccurs="0"/>
<element name="suppressAutoHyphens" type="CT_OnOff" minOccurs="0"/>
<element name="kinsoku" type="CT_OnOff" minOccurs="0"/>
<element name="wordWrap" type="CT_OnOff" minOccurs="0"/>
<element name="overflowPunct" type="CT_OnOff" minOccurs="0"/>
<element name="topLinePunct" type="CT_OnOff" minOccurs="0"/>
<element name="autoSpaceDE" type="CT_OnOff" minOccurs="0"/>
<element name="autoSpaceDN" type="CT_OnOff" minOccurs="0"/>
<element name="bidi" type="CT_OnOff" minOccurs="0"/>
<element name="adjustRightInd" type="CT_OnOff" minOccurs="0"/>
<element name="snapToGrid" type="CT_OnOff" minOccurs="0"/>
<element name="spacing" type="CT_Spacing" minOccurs="0"/>
<element name="ind" type="CT_Ind" minOccurs="0"/>
<element name="contextualSpacing" type="CT_OnOff" minOccurs="0"/>
<element name="mirrorIndents" type="CT_OnOff" minOccurs="0"/>
<element name="suppressOverlap" type="CT_OnOff" minOccurs="0"/>
<element name="jc" type="CT_Jc" minOccurs="0"/>
<element name="textDirection" type="CT_TextDirection" minOccurs="0"/>
<element name="textAlignment" type="CT_TextAlignment" minOccurs="0"/>
<element name="textboxTightWrap" type="CT_TextboxTightWrap" minOccurs="0"/>
<element name="outlineLvl" type="CT_DecimalNumber" minOccurs="0"/>
<element name="divId" type="CT_DecimalNumber" minOccurs="0"/>
<element name="cnfStyle" type="CT_Cnf" minOccurs="0" maxOccurs="1"/>
</sequence>
</complexType>
This element specifies a set of paragraph properties which shall be applied to the contents of the parent paragraph after all style/numbering/table properties have been applied to the text. These properties are defined as direct formatting, since they are directly applied to the paragraph and supersede any formatting from styles.
[Example: Consider a paragraph which should have a set of paragraph formatting properties. This set of properties is specified in the paragraph properties as follows:
<w:p>
<w:pPr>
<w:pBdr>
<w:bottom w:val="single" w:sz="8" w:space="4" w:color="4F81BD" />
</w:pBdr>
<w:spacing w:after="300" />
<w:contextualSpacing />
</w:pPr>
</w:p>
The pPr element specifies the properties which are applied to the current paragraph - in this case, a bottom paragraph border using the bottom element (§2.3.1.7), spacing after the paragraph using the spacing element (§2.3.1.33), and that spacing should be ignored for paragraphs above/below of the same style using the contextualSpacing element (§2.3.1.9). end example]
|
Parent Elements |
|
p (§2.3.1.22) |
|
Child Elements |
Subclause |
|---|---|
|
adjustRightInd (Automatically Adjust Right Indent When Using Document Grid) |
|
|
autoSpaceDE (Automatically Adjust Spacing of Latin and East Asian Text) |
|
|
autoSpaceDN (Automatically Adjust Spacing of East Asian Text and Numbers) |
|
|
bidi (Right to Left Paragraph Layout) |
|
|
cnfStyle (Paragraph Conditional Formatting) |
|
|
contextualSpacing (Ignore Spacing Above and Below When Using Identical Styles) |
|
|
divId (Associated HTML div ID) |
|
|
framePr (Text Frame Properties) |
|
|
ind (Paragraph Indentation) |
|
|
jc (Paragraph Alignment) |
|
|
keepLines (Keep All Lines On One Page) |
|
|
keepNext (Keep Paragraph With Next Paragraph) |
|
|
kinsoku (Use East Asian Typography Rules for First and Last Character per Line) |
|
|
mirrorIndents (Use Left/Right Indents as Inside/Outside Indents) |
|
|
numPr (Numbering Definition Instance Reference) |
|
|
outlineLvl (Associated Outline Level) |
|
|
overflowPunct (Allow Punctuation to Extent Past Text Extents) |
|
|
pageBreakBefore (Start Paragraph on Next Page) |
|
|
pBdr (Paragraph Borders) |
|
|
pPrChange (Revision Information for Paragraph Properties) |
|
|
pStyle (Referenced Paragraph Style) |
|
|
rPr (Run Properties for the Paragraph Mark) |
|
|
sectPr (Section Properties) |
|
|
shd (Paragraph Shading) |
|
|
snapToGrid (Use Document Grid Settings for Inter-Line Paragraph Spacing) |
|
|
spacing (Spacing Between Lines and Above/Below Paragraph) |
|
|
suppressAutoHyphens (Suppress Hyphenation for Paragraph) |
|
|
suppressLineNumbers (Suppress Line Numbers for Paragraph) |
|
|
suppressOverlap (Prevent Text Frames From Overlapping) |
|
|
tabs (Set of Custom Tab Stops) |
|
|
textAlignment (Vertical Character Alignment on Line) |
|
|
textboxTightWrap (Allow Surrounding Paragraphs to Tight Wrap to Text Box Contents) |
|
|
textDirection (Paragraph Text Flow Direction) |
|
|
topLinePunct (Compress Punctuation at Start of a Line) |
|
|
widowControl (Allow First/Last Line to Display on a Separate Page) |
|
|
wordWrap (Allow Line Breaking At Character Level) |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_PPr">
<complexContent>
<extension base="CT_PPrBase">
<sequence>
<element name="rPr" type="CT_ParaRPr" minOccurs="0"/>
<element name="sectPr" type="CT_SectPr" minOccurs="0"/>
<element name="pPrChange" type="CT_PPrChange" minOccurs="0"/>
</sequence>
</extension>
</complexContent>
</complexType>
This element specifies the style ID of the paragraph style which shall be used to format the contents of this paragraph.
This formatting is applied at the following location in the style hierarchy:
This means that all properties specified in the style element (§2.7.3.17) with a styleId which corresponds to the value in this element's val attribute are applied to the paragraph at the appropriate level in the hierarchy.
If this element is omitted, or it references a style which does not exist, then no paragraph style shall be applied to the current paragraph. As well, this property is ignored if the paragraph properties are part of a paragraph style.
[Example: Consider the following WordprocessingML fragment:
<w:pPr>
<w:pStyle w:val="TestParagraphStyle" />
<w:ind w:left="1440" />
</w:pPr>
This paragraph specifies that it will inherit all of the paragraph properties specified by the paragraph style with a styleId of TestParagraphStyle, which will then have any indentation properties overridden with a left indentation of 1440 twentieths of a point, and no indentation for any other value. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (String Value) |
Specifies that its contents will contain a string. The contents of this string are interpreted based on the context of the parent XML element. [Example: Consider the following WordprocessingML fragment:
The value of the However, consider the following fragment:
In this case, the decimal number in the The possible values for this attribute are defined by the ST_String simple type (§2.18.89). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_String">
<attribute name="val" type="ST_String" use="required"/>
</complexType>
This element specifies the border which shall be displayed on the right side of the page around the specified paragraph.
To determine if any two adjoining paragraphs should have a right border which spans the full line height or not, the right border shall be drawn between the top border or between border at the top (whichever would be rendered for the current paragraph), and the bottom border or between border at the bottom (whichever would be rendered for the current paragraph).
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then no right border shall be applied.
[Example: Consider the following two paragraphs' WordprocessingML definition:
<w:p>
<w:pPr>
<w:pBdr>
<w:top w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />
<w:left w:val="single" w:sz="24" w:space="4" w:color="B97034" w:themeColor="accent6" w:themeShade="BF" />
<w:bottom w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />
<w:right w:val="single" w:sz="24" w:space="4" w:color="C3D69B" w:themeColor="accent3" w:themeTint="99" />
<w:between w:val="single" w:sz="24" w:space="1" w:color="4F81BD" w:themeColor="accent1" />
</w:pBdr>
</w:pPr>
<w:r>
<w:t>First paragraph.</w:t>
</w:r>
</w:p>
<w:p>
<w:pPr>
<w:pBdr>
<w:top w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />
<w:left w:val="single" w:sz="24" w:space="4" w:color="B97034" w:themeColor="accent6" w:themeShade="BF" />
<w:bottom w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />
<w:right w:val="single" w:sz="24" w:space="4" w:color="C3D69B" w:themeColor="accent3" w:themeTint="99" />
<w:between w:val="single" w:sz="24" w:space="1" w:color="4F81BD" w:themeColor="accent1" />
</w:pBdr>
</w:pPr>
<w:r>
<w:t>Second paragraph.</w:t>
</w:r>
</w:p>
Since the paragraph border set is identical between the two paragraphs, the paragraphs are connected by a between border. These paragraphs will therefore draw the right border between the top and between borders for the first paragraph, and the between and bottom borders for the second paragraph. end example]
|
Parent Elements |
|
pBdr (§2.3.1.24) |
|
Attributes |
Description |
|---|---|
|
color (Border Color) |
Specifies the color for this border. This color may either be presented as a hex value (in RRGGBB format), or auto to allow a consumer to automatically determine the border color as appropriate. [Example: Consider a border color with value auto, as follows:
This color therefore may be automatically be modified by a consumer as appropriate, for example, in order to ensure that the border can be distinguished against the page's background color. end example] If the border style (the The possible values for this attribute are defined by the ST_HexColor simple type (§2.18.43). |
|
frame (Create Frame Effect) |
Specifies whether the specified border should be modified to create a frame effect by reversing the border's appearance from the edge nearest the text to the edge furthest from the text. If this attribute is omitted, then the border is not given any frame effect. [Example: Consider a bottom border which shall appear with a frame effect, which is specified in the following WordprocessingML:
This frame's The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
shadow (Border Shadow) |
Specifies whether this border should be modified to create the appearance of a shadow. For the right and bottom borders, this is accomplished by duplicating the border below and right of the normal border location. For the right and top borders, this is accomplished by moving the order down and to the right of its original location. If this attribute is omitted, then the border is not given the shadow effect. [Example: Consider a top border which shall appear with a shadow effect, resulting in the following WordprocessingML:
This frame's The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
space (Border Spacing Measurement) |
Specifies the spacing offset that shall be used to place this border on the parent object. When a document has a page border that is relative to the page edges (using a value of page in the When a document has a page border that is relative to the text extents (using a value of text in the [Example: Consider a document with a set of page borders all specified to appear 24 points from the edge of the page. The resulting WordprocessingML would be as follows:
The The possible values for this attribute are defined by the ST_PointMeasure simple type (§2.18.75). |
|
sz (Border Width) |
Specifies the width of the current border. If the border style ( If the border style ( [Example: Consider a document with a three point wide dashed line border on all sides, resulting in the following WordprocessingML markup:
The border style is specified using the The possible values for this attribute are defined by the ST_EighthPointMeasure simple type (§2.18.27). |
|
themeColor (Border Theme Color) |
Specifies a theme color to be applied to the current border. The specified theme color is a reference to one of the predefined theme colors, located in the document's Theme part,which allows color information to be set centrally in the document. [Example: Consider a set of borders configured to use the accent2 theme color, resulting in the following WordprocessingML markup:
The borders have a The possible values for this attribute are defined by the ST_ThemeColor simple type (§2.18.104). |
|
themeShade (Border Theme Color Shade) |
Specifies the shade value applied to the supplied theme color (if any) for this border instance. If the The [Example: Consider a shade of 40% applied to a border in a document. This shade is calculated as follows: (missing picture formula-2.3.1.28-1) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.1.28-2) [Example: Consider a document with a background using the accent2 theme color, whose RGB value (in RRGGBB hex format) is C0504D. The equivalent HSL color value would be. Applying the shade formula with a shade percentage of 75% to the luminance, we get: (missing picture formula-2.3.1.28-3) Taking the resulting HSL color value of and converting back to RGB, we get 943634. This transformed value can be seen in the resulting background's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
themeTint (Border Theme Color Tint) |
Specifies the tint value applied to the supplied theme color (if any) for this border instance. If the The [Example: Consider a tint of 60% applied to a border in a document. This tint is calculated as follows: (missing picture formula-2.3.1.28-4) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.1.28-5) [Example: Consider a document with a background using the accent2 theme color, whose RGB value (in RRGGBB hex format) is 4F81BD. The equivalent HSL color value would be. Applying the tint formula with a tint percentage of 60% to the luminance, we get: (missing picture formula-2.3.1.28-6) Taking the resulting HSL color value of and converting back to RGB, we get 95B3D7. This transformed value can be seen in the resulting background's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
val (Border Style) |
Specifies the style of border used on this object. This border can either be an art border (a repeated image along the borders - only valid for page borders) or a line border (a line format repeated along the borders) - see the simple type definition for a description of each border style. [Example: Consider a left border resulting in the following WordprocessingML:
This border's The possible values for this attribute are defined by the ST_Border simple type (§2.18.4). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Border">
<attribute name="val" type="ST_Border" use="required"/>
<attribute name="color" type="ST_HexColor" use="optional"/>
<attribute name="themeColor" type="ST_ThemeColor" use="optional"/>
<attribute name="themeTint" type="ST_UcharHexNumber" use="optional"/>
<attribute name="themeShade" type="ST_UcharHexNumber" use="optional"/>
<attribute name="sz" type="ST_EighthPointMeasure" use="optional"/>
<attribute name="space" type="ST_PointMeasure" use="optional"/>
<attribute name="shadow" type="ST_OnOff" use="optional"/>
<attribute name="frame" type="ST_OnOff" use="optional"/>
</complexType>
This element specifies the set of run properties applied to the glyph used to represent the physical location of the paragraph mark for this paragraph. This paragraph mark, being a physical character in the document, can be formatted, and therefore must be capable of representing this formatting like any other character in the document.
If this element is not present, the paragraph mark is unformatted, as with any other run of text.
[Example: Consider a run of text displayed as follows, including a display format using the pilcrow sign ¶ for the paragraph mark glyph:
This is some text and the paragraph mark.¶
If we format the display formatting for the paragraph mark by making it red and giving it a 72 point font size, then the WordprocessingML shall reflect this formatting on the paragraph as follows:
<w:pPr>
<w:rPr>
<w:color w:val="FF0000" />
<w:sz w:val="144" />
</w:rPr>
</w:pPr>
The paragraph glyph's formatting is stored in the rPr element under the paragraph properties, since there is no run saved for the paragraph mark itself. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Child Elements |
Subclause |
|---|---|
|
b (Bold) |
|
|
bCs (Complex Script Bold) |
|
|
bdr (Text Border) |
|
|
caps (Display All Characters As Capital Letters) |
|
|
color (Run Content Color) |
|
|
cs (Use Complex Script Formatting on Run) |
|
|
del (Deleted Paragraph) |
|
|
dstrike (Double Strikethrough) |
|
|
eastAsianLayout (East Asian Typography Settings) |
|
|
effect (Animated Text Effect) |
|
|
em (Emphasis Mark) |
|
|
emboss (Embossing) |
|
|
fitText (Manual Run Width) |
|
|
highlight (Text Highlighting) |
|
|
i (Italics) |
|
|
iCs (Complex Script Italics) |
|
|
imprint (Imprinting) |
|
|
ins (Inserted Paragraph) |
|
|
kern (Font Kerning) |
|
|
lang (Languages for Run Content) |
|
|
moveFrom (Move Source Paragraph) |
|
|
moveTo (Move Destination Paragraph) |
|
|
noProof (Do Not Check Spelling or Grammar) |
|
|
oMath (Office Open XML Math) |
|
|
outline (Display Character Outline) |
|
|
position (Vertically Raised or Lowered Text) |
|
|
rFonts (Run Fonts) |
|
|
rPrChange (Revision Information for Run Properties on the Paragraph Mark) |
|
|
rStyle (Referenced Character Style) |
|
|
rtl (Right To Left Text) |
|
|
shadow (Shadow) |
|
|
shd (Run Shading) |
|
|
smallCaps (Small Caps) |
|
|
snapToGrid (Use Document Grid Settings For Inter-Character Spacing) |
|
|
spacing (Character Spacing Adjustment) |
|
|
specVanish (Paragraph Mark Is Always Hidden) |
|
|
strike (Single Strikethrough) |
|
|
sz (Font Size) |
|
|
szCs (Complex Script Font Size) |
|
|
u (Underline) |
|
|
vanish (Hidden Text) |
|
|
vertAlign (Subscript/Superscript Text) |
|
|
w (Expanded/Compressed Text) |
|
|
webHidden (Web Hidden Text) |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_ParaRPr">
<sequence>
<group ref="EG_ParaRPrTrackChanges" minOccurs="0"/>
<group ref="EG_RPrBase" minOccurs="0"/>
<element name="rPrChange" type="CT_ParaRPrChange" minOccurs="0"/>
</sequence>
</complexType>
This element specifies a set of run properties applied to the glyph used to represent the physical location of the paragraph mark for this paragraph which shall be attributed to a revision by a particular author and at a particular time. This element contains the set of properties which have been tracked as a specific set of revisions by one author.
[Example: Consider a run which has a set of run formatting properties that were added with revision tracking turned on. This set of revised properties is specified in the run properties as follows:
<w:p>
<w:pPr>
<w:rPr>
<w:b />
<w:imprint />
<w:lang w:val="en-ca" />
<w:rPrChange w:author="user1">
<w:rPr>
<w:i />
<w:dstrike w:val="false" />
</w:rPr>
</w:rPrChange>
</w:rPr>
</w:pPr>
</w:p>
The rPr element under rPrChange specifies the properties which are applied to the run representing the paragraph mark before the revision tracking was turned on - in this case, italics using the i element (§2.3.2.14), and that any double strikethrough which was applied based on the style hierarchy shall be turned off using the dstrike element (§2.3.2.7). end example]
|
Parent Elements |
|
rPrChange (§2.13.5.33) |
|
Child Elements |
Subclause |
|---|---|
|
b (Bold) |
|
|
bCs (Complex Script Bold) |
|
|
bdr (Text Border) |
|
|
caps (Display All Characters As Capital Letters) |
|
|
color (Run Content Color) |
|
|
cs (Use Complex Script Formatting on Run) |
|
|
del (Deleted Paragraph) |
|
|
dstrike (Double Strikethrough) |
|
|
eastAsianLayout (East Asian Typography Settings) |
|
|
effect (Animated Text Effect) |
|
|
em (Emphasis Mark) |
|
|
emboss (Embossing) |
|
|
fitText (Manual Run Width) |
|
|
highlight (Text Highlighting) |
|
|
i (Italics) |
|
|
iCs (Complex Script Italics) |
|
|
imprint (Imprinting) |
|
|
ins (Inserted Paragraph) |
|
|
kern (Font Kerning) |
|
|
lang (Languages for Run Content) |
|
|
moveFrom (Move Source Paragraph) |
|
|
moveTo (Move Destination Paragraph) |
|
|
noProof (Do Not Check Spelling or Grammar) |
|
|
oMath (Office Open XML Math) |
|
|
outline (Display Character Outline) |
|
|
position (Vertically Raised or Lowered Text) |
|
|
rFonts (Run Fonts) |
|
|
rStyle (Referenced Character Style) |
|
|
rtl (Right To Left Text) |
|
|
shadow (Shadow) |
|
|
shd (Run Shading) |
|
|
smallCaps (Small Caps) |
|
|
snapToGrid (Use Document Grid Settings For Inter-Character Spacing) |
|
|
spacing (Character Spacing Adjustment) |
|
|
specVanish (Paragraph Mark Is Always Hidden) |
|
|
strike (Single Strikethrough) |
|
|
sz (Font Size) |
|
|
szCs (Complex Script Font Size) |
|
|
u (Underline) |
|
|
vanish (Hidden Text) |
|
|
vertAlign (Subscript/Superscript Text) |
|
|
w (Expanded/Compressed Text) |
|
|
webHidden (Web Hidden Text) |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_ParaRPrOriginal">
<sequence>
<group ref="EG_ParaRPrTrackChanges" minOccurs="0"/>
<group ref="EG_RPrBase" minOccurs="0" maxOccurs="unbounded"/>
</sequence>
</complexType>
This element specifies the shading applied to the contents of the paragraph.
This shading consists of three components:
The resulting shading is applied by setting the background color behind the paragraph, then applying the pattern color using the mask supplied by the pattern over that background.
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then no paragraph shading shall be applied.
[Example: Consider a paragraph which shall have a background consisting of a theme color accent3 with a theme color accent6 overlaid using a 20% fill pattern. This requirement is specified using the following WordprocessingML:
<w:pPr>
<w:shd w:val="pct20" w:themeColor="accent6" w:themeFill="accent3" />
</w:pPr>
The resulting paragraph will use the background color accent3 under the foreground pattern color accent6 as specified by the pct20 pattern mask. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
color (Shading Pattern Color) |
Specifies the color used for any foreground pattern specified for this shading using the This color may either be presented as a hex value (in RRGGBB format), or If the shading style (the If this attribute is omitted, then its value shall be assumed to be auto. [Example: Consider a shading of type pct20 with a foreground color value of auto, as follows:
The foreground color for this shading pattern therefore may be automatically be modified by a consumer as appropriate, for example, in order to ensure that the shading color can be distinguished against the page's background color. end example] The possible values for this attribute are defined by the ST_HexColor simple type (§2.18.43). |
|
fill (Shading Background Color) |
Specifies the color used for the background for this shading. This color may either be presented as a hex value (in RRGGBB format), or If this attribute is omitted, then its value shall be assumed to be auto. [Example: Consider a shading using a background color of hex value C3D69B, using the following WordprocessingML:
The background color for this shading therefore will be a color with a hex value of C3D69B. end example] If the shading specifies the use of a theme color via the The possible values for this attribute are defined by the ST_HexColor simple type (§2.18.43). |
|
themeColor (Shading Pattern Theme Color) |
Specifies a theme color which should be applied to any foreground pattern specified for this shading using the The specified theme color is a reference to one of the predefined theme colors, located in the document's themes part, which allows for color information to be set centrally in the document. If this element is omitted, then no theme color is applied, and the [Example: Consider a paragraph which shall have a background consisting of a theme color accent3 with a theme color accent6 overlaid using a 20% fill pattern. This requirement is specified using the following WordprocessingML:
The resulting paragraph will use the foreground pattern color accent6 in the region specified by the pct20 pattern mask. end example] The possible values for this attribute are defined by the ST_ThemeColor simple type (§2.18.104). |
|
themeFill (Shading Background Theme Color) |
Specifies a theme color which should be applied to the background for this shading. The specified theme color is a reference to one of the predefined theme colors, located in the document's themes part, which allows for color information to be set centrally in the document. If this element is omitted, then no theme color is applied, and the [Example: Consider a paragraph which shall have a background consisting of a theme color
The resulting shading will use the background color specified by the The possible values for this attribute are defined by the ST_ThemeColor simple type (§2.18.104). |
|
themeFillShade (Shading Background Theme Color Shade) |
Specifies the shade value applied to the supplied theme color (if any) for this shading color. If the The [Example: Consider a shade of 40% applied to a background shading color in a document. This shade is calculated as follows: (missing picture formula-2.3.1.31-1) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.1.31-2) [Example: Consider a document with a background using the accent2 theme color, whose RGB value (in RRGGBB hex format) is C0504D. The equivalent HSL color value would be. Applying the shade formula with a shade percentage of 75% to the luminance, we get: (missing picture formula-2.3.1.31-3) Taking the resulting HSL color value of and converting back to RGB, we get 943634. This transformed value can be seen in the resulting shading's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
themeFillTint (Shading Background Theme Color Tint) |
Specifies the tint value applied to the supplied theme color (if any) for this shading instance. If the The [Example: Consider a tint of 60% applied to a border in a document. This tint is calculated as follows: (missing picture formula-2.3.1.31-4) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.1.31-5) [Example: Consider a document with a background using the accent2 theme color, whose RGB value (in RRGGBB hex format) is 4F81BD. The equivalent HSL color value would be. Applying the tint formula with a tint percentage of 60% to the luminance, we get: (missing picture formula-2.3.1.31-6) Taking the resulting HSL color value of and converting back to RGB, we get 95B3D7. This transformed value can be seen in the resulting shading's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
themeShade (Shading Pattern Theme Color Shade) |
Specifies the shade value applied to the supplied theme color (if any) for this shading color. If the The [Example: Consider a shade of 40% applied to a background shading color in a document. This shade is calculated as follows: (missing picture formula-2.3.1.31-7) Te resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.1.31-8) [Example: Consider a document with a background using the accent2 theme color, whose RGB value (in RRGGBB hex format) is C0504D. The equivalent HSL color value would be. Applying the shade formula with a shade percentage of 75% to the luminance, we get: (missing picture formula-2.3.1.31-9) Taking the resulting HSL color value of and converting back to RGB, we get 943634. This transformed value can be seen in the resulting background's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
themeTint (Shading Pattern Theme Color Tint) |
Specifies the tint value applied to the supplied theme color (if any) for this shading instance. If the The [Example: Consider a tint of 60% applied to a border in a document. This tint is calculated as follows: (missing picture formula-2.3.1.31-10) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.1.31-11) [Example: Consider a document with a background using the accent2 theme color, whose RGB value (in RRGGBB hex format) is 4F81BD. The equivalent HSL color value would be. Applying the tint formula with a tint percentage of 60% to the luminance, we get: (missing picture formula-2.3.1.31-12) Taking the resulting HSL color value of and converting back to RGB, we get 95B3D7. This transformed value can be seen in the resulting shading's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
val (Shading Pattern) |
Specifies the pattern which shall be used to lay the pattern color over the background color for this paragraph shading. This pattern consists of a mask which is applied over the background shading color to get the locations where the pattern color should be shown. Each of these possible masks are shown in the simple type values referenced below. [Example: Consider a shaded paragraph which uses a 10 percent foreground fill, resulting in the following WordprocessingML:
This shading The possible values for this attribute are defined by the ST_Shd simple type (§2.18.85). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Shd">
<attribute name="val" type="ST_Shd" use="required"/>
<attribute name="color" type="ST_HexColor" use="optional"/>
<attribute name="themeColor" type="ST_ThemeColor" use="optional"/>
<attribute name="themeTint" type="ST_UcharHexNumber" use="optional"/>
<attribute name="themeShade" type="ST_UcharHexNumber" use="optional"/>
<attribute name="fill" type="ST_HexColor" use="optional"/>
<attribute name="themeFill" type="ST_ThemeColor" use="optional"/>
<attribute name="themeFillTint" type="ST_UcharHexNumber" use="optional"/>
<attribute name="themeFillShade" type="ST_UcharHexNumber" use="optional"/>
</complexType>
This element specifies whether the current paragraph should use the document grid lines per page settings defined in the docGrid element (§2.6.5) when laying out the contents in the paragraph. This setting determines whether the additional line pitch specified in the document grid shall be added to each line in this paragraph as specified by the document grid.
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then the paragraph shall use the document grid to lay out text when a document grid is defined for this document.
[Example: Consider two single-spaced paragraphs in a section with a document grid set to allow 15 lines per page. This document grid would effectively specifies that an additional line pitch of 45.6 points shall be added to each line in order to ensure that the resulting page contains only 15 lines of text.
If this property is set on the first paragraph, but turned off on the second paragraph, as follows:
<w:p>
<w:pPr>
<w:snapToGrid w:val="off" />
</w:pPr>
...
</w:p>
<w:p>
...
</w:p>
The resulting document shall have 45.6 points of additional line pitch added to each line in paragraph two, but zero lines of additional line pitch added to each line in paragraph one, since the snapToGrid property is turned off. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies the inter-line and inter-paragraph spacing which shall be applied to the contents of this paragraph when it is displayed by a consumer.
If this element is omitted on a given paragraph, each of its values is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then the paragraph shall have no spacing applied to its lines, or above and below its contents.
[Example: Consider the following WordprocessingML paragraph:
<w:pPr>
<w:spacing w:after="200" w:line="276" w:lineRule="auto" />
</w:pPr>
This paragraph specifies that it shall have at least 200 twentieths of a point after the last line in each paragraph, and that the spacing in each line should be automatically calculated based on a 1.15 times (276 divided by 240) the normal single spacing calculation. end example]
When determining the spacing between any two paragraphs, a consumer shall use the maximum of the inter-line spacing in each paragraph, the spacing after the first paragraph and the spacing before the second paragraph to determine the net spacing between the paragraphs.
[Example: Consider two consecutive single-spaced paragraphs in a document, the first of which specifies spacing below of 12 points, the second of which specifies spacing above of 4 points. These constraints are expressed using the following WordprocessingML:
<w:p>
<w:pPr>
<w:spacing w:after="240" />
</w:pPr>
...
</w:p>
<w:p>
<w:pPr>
<w:spacing w:before="80" />
</w:pPr>
...
</w:p>
The resulting spacing between the first and second paragraph will be 12 points, since that is the largest spacing requested between the two paragraphs. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
after (Spacing Below Paragraph) |
Specifies the spacing that should be added after the last line in this paragraph in the document in absolute units. If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then the paragraph shall have no spacing applied below its contents. If the [Example: Consider the following WordprocessingML paragraph:
This paragraph shall have a minimum spacing below its final lines of 240 twentieths of a point, although the actual spacing may be determined by the inter-line spacing or the spacing above the following paragraph, if either are greater. end example] The possible values for this attribute are defined by the ST_TwipsMeasure simple type (§2.18.105). |
|
afterAutospacing (Automatically Determine Spacing Below Paragraph) |
Specifies whether a consumer shall automatically determine the spacing after this paragraph based on its contents. This automatic spacing shall match the spacing which would be applied to the paragraph in an HTML document where no explicit spacing before/after is specified. If this attribute is specified, then any value in If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then automatic spacing is turned off (not applied). [Example: Consider a paragraph in a document whose spacing below shall automatically be determined by the consumer based on the paragraph's contents. This constraint would be specified by the following WordprocessingML:
The resulting paragraph shall have the spacing below its last line determined automatically by the consumer to match an HTML document as specified. end example] The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
afterLines (Spacing Below Paragraph in Line Units) |
Specifies the spacing that should be added after the last line in this paragraph in the document in line units. The value of this attribute is specified in one hundredths of a line. If the [Example: Consider the following WordprocessingML paragraph:
This paragraph shall have a minimum spacing below its final lines of 3 lines, although the actual spacing may be determined by the inter-line spacing or the spacing above the following paragraph, if either are greater. end example] The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16). |
|
before (Spacing Above Paragraph) |
Specifies the spacing that should be added above the first line in this paragraph in the document in absolute units. If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then the paragraph shall have no spacing applied above its contents. If the [Example: Consider the following WordprocessingML paragraph:
This paragraph shall have a minimum spacing above its first line of 80 twentieths of a point, although the actual spacing may be determined by the inter-line spacing or the spacing below the last line in the preceding paragraph, if either are greater. end example] The possible values for this attribute are defined by the ST_TwipsMeasure simple type (§2.18.105). |
|
beforeAutospacing (Automatically Determine Spacing Above Paragraph) |
Specifies whether a consumer shall automatically determine the spacing before this paragraph based on its contents. This automatic spacing shall match the spacing which would be applied to the paragraph in an HTML document where no explicit spacing before/after is specified. If this attribute is specified, then any value in If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then automatic spacing is turned off (not applied). [Example: Consider a paragraph in a document whose spacing above shall automatically be determined by the consumer based on the paragraph's contents. This constraint would be specified by the following WordprocessingML:
The resulting paragraph shall have the spacing above its first line determined automatically by the consumer to match an HTML document as specified. end example] The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
beforeLines (Spacing Above Paragraph IN Line Units) |
Specifies the spacing that should be added before the first line in this paragraph in the document in line units. The value of this attribute is specified in one hundredths of a line. If the [Example: Consider the following WordprocessingML paragraph:
This paragraph shall have a minimum spacing above its first line of 1 line, although the actual spacing may be determined by the inter-line spacing or the spacing below the preceding paragraph, if either are greater. end example] The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16). |
|
line (Spacing Between Lines in Paragraph) |
This attribute specifies the amount of vertical spacing between lines of text within this paragraph. If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then no line spacing shall be applied to lines within this paragraph. If the value of the
If the value of the [Example: Consider the following WordprocessingML paragraph which should have an inter-line spacing of 1.15 times the line height. This constraint would be specified using the following WordprocessingML:
The The possible values for this attribute are defined by the ST_SignedTwipsMeasure simple type (§2.18.88). |
|
lineRule (Type of Spacing Between Lines) |
Specifies how the spacing between lines is calculated as stored in the If this attribute is omitted, then it shall be assumed to be of a value If the value of this attribute is either If the value of this attribute is [Example: Consider the following WordprocessingML paragraph which should have an inter-line spacing of 1.15 times the line height. This constraint would be specified using the following WordprocessingML:
The The possible values for this attribute are defined by the ST_LineSpacingRule simple type (§2.18.55). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Spacing">
<attribute name="before" type="ST_TwipsMeasure" use="optional"/>
<attribute name="beforeLines" type="ST_DecimalNumber" use="optional"/>
<attribute name="beforeAutospacing" type="ST_OnOff" use="optional"/>
<attribute name="after" type="ST_TwipsMeasure" use="optional"/>
<attribute name="afterLines" type="ST_DecimalNumber" use="optional"/>
<attribute name="afterAutospacing" type="ST_OnOff" use="optional"/>
<attribute name="line" type="ST_SignedTwipsMeasure" use="optional"/>
<attribute name="lineRule" type="ST_LineSpacingRule" use="optional"/>
</complexType>
This element specifies whether any hyphenation shall be performed on this paragraph by the consumer when requested using the autoHyphenation element (§2.15.1.10) in the document's settings. This element specifies whether the current paragraph should be exempted from any hyphenation which is applied by the consumer on this document.
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then the default hyphenation settings for the document, as specified in the autoHyphenation element, shall apply to the contents of this paragraph.
[Example: Consider a document which shall be hyphenated automatically by a consumer, since it has the autoHyphenation element set to true in its document settings. If this paragraph should be exempted from that hyphenation pass, this requirement would be specified using the following WordprocessingML:
<w:pPr>
<w:suppressAutoHyphens />
</w:pPr>
The paragraph would then be exempted from hyphenation by a consumer at display time, regardless of the hyphenation settings for the document. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies whether line numbers shall be calculated for lines in this paragraph by the consumer when line numbering is requested using the lnNumType element (§2.6.8) in the paragraph's parent section settings. This element specifies whether the current paragraph's lines should be exempted from line numbering which is applied by the consumer on this document, not just suppressing the display of the numbering, but removing these lines from the line numbering calculation.
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then the default line number settings for the section, as specified in the lnNumType element shall apply to each line of this paragraph.
[Example: Consider a document with three paragraphs, each of which are displayed on five lines , all contained in a section which has the lnNumType element specified. If the second paragraph should be exempted from that line numbering, this requirement would be specified using the following WordprocessingML:
<w:pPr>
<w:suppressLineNumbers />
</w:pPr>
The paragraph would then be exempted from line by a consumer at display time, which would result in paragraph one using line numbers one through five, the second paragraph having no line numbers, and the third paragraph using line numbers six through ten. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies whether a text frame which intersects another text frame at display time shall be allowed to overlap the contents of the other text frame. If a text frame cannot overlap other text frames, it shall be repositioned when displayed to prevent this overlap as needed.
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then overlap shall be allowed between a text frame which intersects another text frame displayed at the same location.
[Example: Consider a document with two text frames which are allowed to overlap each other. If the second text frame should overlap the contents of another text frame, that constraint would be specified via the following WordprocessingML:
<w:p>
...
</w:p>
<w:p>
<w:pPr>
<w:framePr ... />
<w:suppressOverlap />
</w:pPr>
...
</w:p>
The resulting text frame with the suppressOverlap property specified would never overlap any intersecting text frames. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies a single custom tab stop within a set of custom tab stops applied as part of a set of customized paragraph properties in a document.
[Example: Consider a custom tab stops at 1.5" in a WordprocessingML document. This tab stop would be contained within a tab element defining the tab stop as follows:
<w:tab w:val="left" w:pos="2160" />
The tab element specifies all of the properties for the customized tab stop for the current paragraph property set. end example]
|
Parent Elements |
|
tabs (§2.3.1.38) |
|
Attributes |
Description |
|---|---|
|
leader (Tab Leader Character) |
Specifies the character which shall be used to fill in the space created by a tab which ends at this custom tab stop. This character shall be repeated as required to completely fill the tab spacing generated by the tab character. If this attribute is omitted, then no tab leader character shall be used. [Example: Consider a tab stop which should be preceded by a sequence of underscore characters, as follows: ______________Text at the tab stop This tab stop would have a The possible values for this attribute are defined by the ST_TabTlc simple type (§2.18.92). |
|
pos (Tab Stop Position) |
Specifies the position of the current custom tab stop with respect to the current page margins. Negative values are valid and move the tab stop into the current page margin the specified amount. [Example: Consider a custom tab stops at 1.5" in a WordprocessingML document. This tab stop would be contained within a tab element defining the tab stop as follows:
The pos attribute specifies that this custom tab stop shall be located 2160 points (1.5 inches) inside the starting text margin. end example] The possible values for this attribute are defined by the ST_SignedTwipsMeasure simple type (§2.18.88). |
|
val (Tab Stop Type) |
Specifies the type of custom tab stop, which determines the behavior of the tab stop and the alignment which shall be applied to text entered at the current custom tab stop. The value of clear is unique and specifies that this tab stop shall be removed when the document is next edited by a consumer which supports rendering the document contents. [Example: Consider a custom tab stops at 1.5" in a WordprocessingML document. This tab stop would be contained within a tab element defining the tab stop as follows:
The val attribute specifies that this custom tab stop shall align all text entered at its location to its left. end example] The possible values for this attribute are defined by the ST_TabJc simple type (§2.18.91). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_TabStop">
<attribute name="val" type="ST_TabJc" use="required"/>
<attribute name="leader" type="ST_TabTlc" use="optional"/>
<attribute name="pos" type="ST_SignedTwipsMeasure" use="required"/>
</complexType>
This element specifies a sequence of custom tab stops which shall be used for any tab characters in the current paragraph.
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then no custom tab stops shall be used for this paragraph.
As well, this property is additive - tab stops at each level in the style hierarchy are added to each other to determine the full set of tab stops for the paragraph. A hanging indent specified via the hanging attribute on the ind element (§2.3.1.12) shall also always implicitly create a custom tab stop at its location.
[Example: Consider a paragraph which contains two custom tab stops at 1.5" and 3.5", respectively. These two tab stops would be contained within a tabs element defining the set of tab stops of the paragraph as follows:
<w:pPr>
<w:tabs>
<w:tab w:val="left" w:pos="2160" />
<w:tab w:val="left" w:pos="5040" />
</w:tabs>
</w:pPr>
The tabs element specifies all of the customized tab stops for the current paragraph. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Child Elements |
Subclause |
|---|---|
|
tab (Custom Tab Stop) |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Tabs">
<sequence>
<element name="tab" type="CT_TabStop" minOccurs="1" maxOccurs="unbounded"/>
</sequence>
</complexType>
This element specifies the vertical alignment of all text on each line displayed within a paragraph. If the line height (before any added spacing) is larger than one or more characters on the line, all characters will be aligned to each other as specified by this element.
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then the vertical alignment of all characters on the line shall be automatically determined by the consumer.
[Example: Consider a paragraph of text of different font sizes, as follows:
If the text on this paragraph shall be aligned based on the top point of the maximum character height, that requirement would be specified as follows in the WordprocessingML:
<w:pPr>
<w:textAlignment w:val="top" />
</w:pPr>
The resulting text would be top aligned, as follows:
The characters are all aligned to the maximum character extent on the line. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (Vertical Character Alignment Position) |
Specifies the type of vertical alignment which shall be used to align the characters on each line in the current paragraph. [Example: Consider a paragraph of text of different font sizes which shall be aligned based on the baseline point of each character in each line. This requirement would be specified as follows in the WordprocessingML:
The resulting text would be aligned to the baseline for each character on the line. end example] The possible values for this attribute are defined by the ST_TextAlignment simple type (§2.18.98). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_TextAlignment">
<attribute name="val" type="ST_TextAlignment" use="required"/>
</complexType>
This element specifies whether, for paragraphs in a text box, the surrounding text shall be allowed to overlap with the empty text box boundaries and tight wrap to the extents of the text within the text box.
This element shall only be read for paragraphs which are contained within a text box (have a txbxContent ancestor), ignored otherwise.
If the parent text box does not meet the following three criteria, then this property has no effect:
tightIf this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then paragraphs in a text box have no tight wrapping overrides, and text shall wrap to the extents of the text box.
[Example: Consider a document with a tight wrapped text box which extends two-thirds of the way across the page, as follows:
The surrounding text is tightly wrapped to the extents of the text box. If the consumer shall tight wrap to the extents of the text, that requirement would be specified using the following WordprocessingML:
<w:pPr>
<w:textboxTightWrap w:val="all" />
</w:pPr>
This would result in the following display of the content:
The resulting paragraphs within the textbox use the textboxTightWrap element to specify that text should be tightly wrapped to the paragraph's extents. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (Lines to Tight Wrap to Paragraph Extents) |
Specifies the lines in the parent paragraph which shall allow the text to be tight wrapped to the paragraph (and not the text box) extents when displaying the document. [Example: Consider a paragraph in a text box which meets the criteria specified above which shall allow wrapping to the text extents on its first line only. That requirement would be specified using the following WordprocessingML:
The resulting paragraph would allow text to tightly wrap to the contents of its first line only. All other lines would wrap to the text box's extents. end example] The possible values for this attribute are defined by the ST_TextboxTightWrap simple type (§2.18.99). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_TextboxTightWrap">
<attribute name="val" type="ST_TextboxTightWrap" use="required"/>
</complexType>
This element specifies the direction of the text flow for this paragraph.
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then the paragraph shall inherit the text flow settings from the parent section.
[Example: Consider a document with a paragraph in which text should flow bottom to top vertically, and left to right horizontally. This setting would be specified with the following WordprocessingML:
<w:pPr>
<w:textFlow w:val="btLr" />
</w:pPr>
The textFlow element specifies via the btLr value in the val attribute that the text flow should go bottom to top, and left to right. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (Direction of Text Flow) |
Specifies the direction of the text flow for this object. [Example: Consider a document with a section in which text shall flow bottom to top vertically, and left to right horizontally. This setting requires the following WordprocessingML:
The textDirection element specifies via the btLr value in the The possible values for this attribute are defined by the ST_TextDirection simple type (§2.18.100). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_TextDirection">
<attribute name="val" type="ST_TextDirection" use="required"/>
</complexType>
This element specifies the border which shall be displayed above a set of paragraphs which have the same set of paragraph border settings.
To determine if any two adjoining paragraphs shall have an individual top and bottom border or a between border, the set of borders on the two adjoining paragraphs are compared. If the border information on those two paragraphs is identical for all possible paragraphs borders, then the between border is displayed. Otherwise, the final paragraph shall use its bottom border and the following paragraph shall use its top border, respectively. If this border specifies a space attribute, that value determines the space above the text (ignoring any spacing above) which should be left before this border is drawn, specified in points.
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then no between border shall be applied above identical paragraphs.
[Example: Consider the following two paragraphs' WordprocessingML definition:
<w:p>
<w:pPr>
<w:pBdr>
<w:top w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />
<w:left w:val="single" w:sz="24" w:space="4" w:color="B97034" w:themeColor="accent6" w:themeShade="BF" />
<w:bottom w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />
<w:right w:val="single" w:sz="24" w:space="4" w:color="C3D69B" w:themeColor="accent3" w:themeTint="99" />
<w:between w:val="single" w:sz="24" w:space="1" w:color="4F81BD" w:themeColor="accent1" />
</w:pBdr>
</w:pPr>
<w:r>
<w:t>First paragraph.</w:t>
</w:r>
</w:p>
<w:p>
<w:pPr>
<w:pBdr>
<w:top w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />
<w:left w:val="single" w:sz="24" w:space="4" w:color="B97034" w:themeColor="accent6" w:themeShade="BF" />
<w:bottom w:val="single" w:sz="24" w:space="0" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" />
<w:right w:val="single" w:sz="24" w:space="4" w:color="C3D69B" w:themeColor="accent3" w:themeTint="99" />
<w:between w:val="single" w:sz="24" w:space="1" w:color="4F81BD" w:themeColor="accent1" />
</w:pBdr>
</w:pPr>
<w:r>
<w:t>Second paragraph.</w:t>
</w:r>
</w:p>
Since the paragraph border is different between the two paragraphs (the bottom space value goes from 1 to 0), paragraph two uses its top border, which is located one point above the text in that paragraph. end example]
|
Parent Elements |
|
pBdr (§2.3.1.24) |
|
Attributes |
Description |
|---|---|
|
color (Border Color) |
Specifies the color for this border. This color may either be presented as a hex value (in RRGGBB format), or auto to allow a consumer to automatically determine the border color as appropriate. [Example: Consider a border color with value auto, as follows:
This color therefore may be automatically be modified by a consumer as appropriate, for example, in order to ensure that the border can be distinguished against the page's background color. end example] If the border style (the The possible values for this attribute are defined by the ST_HexColor simple type (§2.18.43). |
|
frame (Create Frame Effect) |
Specifies whether the specified border should be modified to create a frame effect by reversing the border's appearance from the edge nearest the text to the edge furthest from the text. If this attribute is omitted, then the border is not given any frame effect. [Example: Consider a bottom border which shall appear with a frame effect, which is specified in the following WordprocessingML:
This frame's The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
shadow (Border Shadow) |
Specifies whether this border should be modified to create the appearance of a shadow. For the right and bottom borders, this is accomplished by duplicating the border below and right of the normal border location. For the right and top borders, this is accomplished by moving the order down and to the right of its original location. If this attribute is omitted, then the border is not given the shadow effect. [Example: Consider a top border which shall appear with a shadow effect, resulting in the following WordprocessingML:
This frame's The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
space (Border Spacing Measurement) |
Specifies the spacing offset that shall be used to place this border on the parent object. When a document has a page border that is relative to the page edges (using a value of page in the When a document has a page border that is relative to the text extents (using a value of text in the [Example: Consider a document with a set of page borders all specified to appear 24 points from the edge of the page. The resulting WordprocessingML would be as follows:
The The possible values for this attribute are defined by the ST_PointMeasure simple type (§2.18.75). |
|
sz (Border Width) |
Specifies the width of the current border. If the border style ( If the border style ( [Example: Consider a document with a three point wide dashed line border on all sides, resulting in the following WordprocessingML markup:
The border style is specified using the The possible values for this attribute are defined by the ST_EighthPointMeasure simple type (§2.18.27). |
|
themeColor (Border Theme Color) |
Specifies a theme color to be applied to the current border. The specified theme color is a reference to one of the predefined theme colors, located in the document's Theme part,which allows color information to be set centrally in the document. [Example: Consider a set of borders configured to use the accent2 theme color, resulting in the following WordprocessingML markup:
The borders have a The possible values for this attribute are defined by the ST_ThemeColor simple type (§2.18.104). |
|
themeShade (Border Theme Color Shade) |
Specifies the shade value applied to the supplied theme color (if any) for this border instance. If the The [Example: Consider a shade of 40% applied to a border in a document. This shade is calculated as follows: (missing picture formula-2.3.1.42-1) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.1.42-2) [Example: Consider a document with a background using the accent2 theme color, whose RGB value (in RRGGBB hex format) is C0504D. The equivalent HSL color value would be. Applying the shade formula with a shade percentage of 75% to the luminance, we get: (missing picture formula-2.3.1.42-3) Taking the resulting HSL color value of and converting back to RGB, we get 943634. This transformed value can be seen in the resulting background's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
themeTint (Border Theme Color Tint) |
Specifies the tint value applied to the supplied theme color (if any) for this border instance. If the The [Example: Consider a tint of 60% applied to a border in a document. This tint is calculated as follows: (missing picture formula-2.3.1.42-4) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.1.42-5) [Example: Consider a document with a background using the accent2 theme color, whose RGB value (in RRGGBB hex format) is 4F81BD. The equivalent HSL color value would be. Applying the tint formula with a tint percentage of 60% to the luminance, we get: (missing picture formula-2.3.1.42-6) Taking the resulting HSL color value of and converting back to RGB, we get 95B3D7. This transformed value can be seen in the resulting background's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
val (Border Style) |
Specifies the style of border used on this object. This border can either be an art border (a repeated image along the borders - only valid for page borders) or a line border (a line format repeated along the borders) - see the simple type definition for a description of each border style. [Example: Consider a left border resulting in the following WordprocessingML:
This border's The possible values for this attribute are defined by the ST_Border simple type (§2.18.4). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Border">
<attribute name="val" type="ST_Border" use="required"/>
<attribute name="color" type="ST_HexColor" use="optional"/>
<attribute name="themeColor" type="ST_ThemeColor" use="optional"/>
<attribute name="themeTint" type="ST_UcharHexNumber" use="optional"/>
<attribute name="themeShade" type="ST_UcharHexNumber" use="optional"/>
<attribute name="sz" type="ST_EighthPointMeasure" use="optional"/>
<attribute name="space" type="ST_PointMeasure" use="optional"/>
<attribute name="shadow" type="ST_OnOff" use="optional"/>
<attribute name="frame" type="ST_OnOff" use="optional"/>
</complexType>
This element specifies whether punctuation shall be compressed when it appears as the first character in a line, allowing subsequent characters on the line to be move in accordingly.
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then punctuation shall not be compressed in this paragraph, even when it appears at the start of a line.
[Example: Consider a paragraph which should allow punctuation at the start of a line to be compressed, in order to prevent it from taking up unnecessary space. This constraint is specified using the following WordprocessingML:
<w:pPr>
<w:topLinePunct w:val="on" />
</w:pPr>
The topLinePunct element specifies that this compression shall be allowed when displaying this paragraph. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies whether a consumer shall prevent a single line of this paragraph from being displayed on a separate page from the remaining content at display time by moving the line onto the following page.
When displaying a paragraph in a page, it is sometimes the case that the first line of that paragraph would display as the last line on one page, and all subsequent lines would display on the following page. This property ensures that a consumer shall move the single line to the following page as well to prevent having one line on its own page. As well, if a single line appears at the top of a page, a consumer shall move the preceding line onto the following page as well, to prevent a single line from being displayed on a separate page.
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then this paragraph shall prevent a single line from being shown on a separate page whenever it would normally occur.
[Example: Consider a document with a paragraph which shall be shown on four lines at display time. If this paragraph would normally be laid out with its first line at the bottom of one page, and its following lines on the next page, as follows:
This property would ensure that the default behavior for each paragraph prevented this, by moving this line onto the following paragraph as follows:
However, if this default is overridden by specifying the following WordprocessingML:
<w:pPr>
<w:widowControl w:val="off" />
</w:pPr>
The specifying of the widowControl element with value off means that the consumer displaying this document shall not move the first line onto a separate page if it would be separated from all other lines (the first picture above). end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies whether a consumer shall break Latin text which exceeds the text extents of a line by breaking the word across two lines (breaking on the character level) or by moving the word to the following line (breaking on the word level).
If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then this paragraph shall break Latin words at the word level, not the character level when it is displayed.
[Example: Consider a paragraph whose first line ends with the word world, where the text extents for that line would normally fall between the letter o and the letter r. If this element is omitted, a producer would normally move the entire word world to the following line, since the word does not fit within the first line's text extents. However, if this document should allow words to be broken at the character level, that constraint would be specified as follows:
<w:pPr>
<w:wordWrap w:val="off" />
</w:pPr>
The resulting paragraph specifies that wordWrap is turned off, therefore the word "world" would be broken into two lines between the exact two characters (o and r) that match the text extents. end example]
|
Parent Elements |
|
pPr (§2.7.4.2); pPr (§2.9.24); pPr (§2.3.1.25); pPr (§2.7.5.1); pPr (§2.3.1.26); pPr (§2.7.7.2) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>