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"/>