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 firstLine and hanging attributes are mutually exclusive, if both are specified, then the firstLine value is ignored. If the firstLineChars attribute is also specified, then this value is ignored. If this attribute is omitted, then its value shall be assumed to be zero (if needed).

[Example: Consider the following WordprocessingML fragment:

<w:pPr>

<w:ind w:left="1440" w:right="720" w:firstLine="1440" />

</w:pPr>

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 left attribute. This gives the first line a two inch indentation from the text margin. end example]

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 firstLineChars and hangingChars attributes are mutually exclusive, if both are specified, then the firstLineChars value is ignored. If the firstLine attribute is also specified, then this value supersedes its other value. If this attribute is omitted, then its value shall be assumed to be zero (if needed).

[Example: Consider the following WordprocessingML fragment:

<w:pPr>

<w:ind w:left="1440" w:right="720" w:firstLineChars="140" />

</w:pPr>

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 left attribute. end example]

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 firstLine and hanging attributes are mutually exclusive, if both are specified, then the firstLine value is ignored. If the hangingChars attribute is also specified, then this value is ignored. If this attribute is omitted, its value shall be assumed to be zero (if needed).

[Example: Consider the following WordprocessingML fragment:

<w:pPr>

<w:ind w:left="1440" w:right="720" w:hanging="720" />

</w:pPr>

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 left attribute. This gives the first line a one-half inch indentation from the text margin. end example]

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 firstLineChars and hangingChars attributes are mutually exclusive, if both are specified, then the firstLine value is ignored. If the hanging attribute is also specified, then its value is superseded by this value. If this attribute is omitted, its value shall be assumed to be zero (if needed).

[Example: Consider the following WordprocessingML fragment:

<w:pPr>

<w:ind w:left="1440" w:right="720" w:hangingChars="100" />

</w:pPr>

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 left attribute. end example]

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 firstLine or hanging attributes. As well, if the leftChars attribute is specified, then this value is ignored.

[Example: Consider the following WordprocessingML fragment:

<w:pPr>

<w:ind w:left="720" w:right="2880" />

</w:pPr>

This set of paragraph indentations specifies that this paragraph's text should be indented 720 twentieths of a point (one half inch) from the left 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_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 firstLine or hanging attributes. As well, if the left attribute is specified, then its value is ignored, and is superseded by this value.

[Example: Consider the following WordprocessingML fragment:

<w:pPr>

<w:ind w:leftChars="250" />

</w:pPr>

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 rightChars attribute is specified, then this value is ignored.

[Example: Consider the following WordprocessingML fragment:

<w:pPr>

<w:ind w:left="720" w:right="-1440" />

</w:pPr>

This set of paragraph indentations specifies that this paragraph's text should be indented 1440 twentieths of a point (one inch) into 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_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 right attribute is specified, then its value is ignored, and is superseded by this value.

[Example: Consider the following WordprocessingML fragment:

<w:pPr>

<w:ind w:rightChars="250" />

</w:pPr>

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).