StyleParagraphProperties Class

Table Style Conditional Formatting Paragraph Properties.When the object is serialized out as xml, its qualified name is w:pPr.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlCompositeElement
      DocumentFormat.OpenXml.Wordprocessing.StyleParagraphProperties

Namespace:  DocumentFormat.OpenXml.Wordprocessing
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

Syntax

'Declaration
<ChildElementInfoAttribute(GetType(AdjustRightIndent))> _
<ChildElementInfoAttribute(GetType(Justification))> _
<ChildElementInfoAttribute(GetType(KeepNext))> _
<ChildElementInfoAttribute(GetType(KeepLines))> _
<ChildElementInfoAttribute(GetType(PageBreakBefore))> _
<ChildElementInfoAttribute(GetType(FrameProperties))> _
<ChildElementInfoAttribute(GetType(WidowControl))> _
<ChildElementInfoAttribute(GetType(NumberingProperties))> _
<ChildElementInfoAttribute(GetType(SuppressLineNumbers))> _
<ChildElementInfoAttribute(GetType(ParagraphBorders))> _
<ChildElementInfoAttribute(GetType(Shading))> _
<ChildElementInfoAttribute(GetType(Tabs))> _
<ChildElementInfoAttribute(GetType(SuppressAutoHyphens))> _
<ChildElementInfoAttribute(GetType(Kinsoku))> _
<ChildElementInfoAttribute(GetType(WordWrap))> _
<ChildElementInfoAttribute(GetType(OverflowPunctuation))> _
<ChildElementInfoAttribute(GetType(TopLinePunctuation))> _
<ChildElementInfoAttribute(GetType(AutoSpaceDE))> _
<ChildElementInfoAttribute(GetType(AutoSpaceDN))> _
<ChildElementInfoAttribute(GetType(BiDi))> _
<ChildElementInfoAttribute(GetType(SnapToGrid))> _
<ChildElementInfoAttribute(GetType(SpacingBetweenLines))> _
<ChildElementInfoAttribute(GetType(Indentation))> _
<ChildElementInfoAttribute(GetType(ContextualSpacing))> _
<ChildElementInfoAttribute(GetType(MirrorIndents))> _
<ChildElementInfoAttribute(GetType(SuppressOverlap))> _
<ChildElementInfoAttribute(GetType(TextDirection))> _
<ChildElementInfoAttribute(GetType(TextAlignment))> _
<ChildElementInfoAttribute(GetType(TextBoxTightWrap))> _
<ChildElementInfoAttribute(GetType(OutlineLevel))> _
<ChildElementInfoAttribute(GetType(ParagraphPropertiesChange))> _
Public Class StyleParagraphProperties _
    Inherits OpenXmlCompositeElement
'Usage
Dim instance As StyleParagraphProperties
[ChildElementInfoAttribute(typeof(AdjustRightIndent))]
[ChildElementInfoAttribute(typeof(Justification))]
[ChildElementInfoAttribute(typeof(KeepNext))]
[ChildElementInfoAttribute(typeof(KeepLines))]
[ChildElementInfoAttribute(typeof(PageBreakBefore))]
[ChildElementInfoAttribute(typeof(FrameProperties))]
[ChildElementInfoAttribute(typeof(WidowControl))]
[ChildElementInfoAttribute(typeof(NumberingProperties))]
[ChildElementInfoAttribute(typeof(SuppressLineNumbers))]
[ChildElementInfoAttribute(typeof(ParagraphBorders))]
[ChildElementInfoAttribute(typeof(Shading))]
[ChildElementInfoAttribute(typeof(Tabs))]
[ChildElementInfoAttribute(typeof(SuppressAutoHyphens))]
[ChildElementInfoAttribute(typeof(Kinsoku))]
[ChildElementInfoAttribute(typeof(WordWrap))]
[ChildElementInfoAttribute(typeof(OverflowPunctuation))]
[ChildElementInfoAttribute(typeof(TopLinePunctuation))]
[ChildElementInfoAttribute(typeof(AutoSpaceDE))]
[ChildElementInfoAttribute(typeof(AutoSpaceDN))]
[ChildElementInfoAttribute(typeof(BiDi))]
[ChildElementInfoAttribute(typeof(SnapToGrid))]
[ChildElementInfoAttribute(typeof(SpacingBetweenLines))]
[ChildElementInfoAttribute(typeof(Indentation))]
[ChildElementInfoAttribute(typeof(ContextualSpacing))]
[ChildElementInfoAttribute(typeof(MirrorIndents))]
[ChildElementInfoAttribute(typeof(SuppressOverlap))]
[ChildElementInfoAttribute(typeof(TextDirection))]
[ChildElementInfoAttribute(typeof(TextAlignment))]
[ChildElementInfoAttribute(typeof(TextBoxTightWrap))]
[ChildElementInfoAttribute(typeof(OutlineLevel))]
[ChildElementInfoAttribute(typeof(ParagraphPropertiesChange))]
public class StyleParagraphProperties : OpenXmlCompositeElement

Remarks

The following table lists the possible child types:

  • KeepNext <w:keepNext>

  • KeepLines <w:keepLines>

  • PageBreakBefore <w:pageBreakBefore>

  • FrameProperties <w:framePr>

  • WidowControl <w:widowControl>

  • NumberingProperties <w:numPr>

  • SuppressLineNumbers <w:suppressLineNumbers>

  • ParagraphBorders <w:pBdr>

  • Shading <w:shd>

  • Tabs <w:tabs>

  • SuppressAutoHyphens <w:suppressAutoHyphens>

  • Kinsoku <w:kinsoku>

  • WordWrap <w:wordWrap>

  • OverflowPunctuation <w:overflowPunct>

  • TopLinePunctuation <w:topLinePunct>

  • AutoSpaceDE <w:autoSpaceDE>

  • AutoSpaceDN <w:autoSpaceDN>

  • BiDi <w:bidi>

  • AdjustRightIndent <w:adjustRightInd>

  • SnapToGrid <w:snapToGrid>

  • SpacingBetweenLines <w:spacing>

  • Indentation <w:ind>

  • ContextualSpacing <w:contextualSpacing>

  • MirrorIndents <w:mirrorIndents>

  • SuppressOverlap <w:suppressOverlap>

  • Justification <w:jc>

  • TextDirection <w:textDirection>

  • TextAlignment <w:textAlignment>

  • TextBoxTightWrap <w:textboxTightWrap>

  • OutlineLevel <w:outlineLvl>

  • ParagraphPropertiesChange <w:pPrChange>

[ISO/IEC 29500-1 1st Edition]

17.7.4.1 pPr (Table Style Conditional Formatting Paragraph Properties)

This element specifies the set of paragraph properties which shall be applied to all paragraphs within a table which match the conditional formatting type specified on the parent tblStylePr element. These properties are applied in the order specified via the style hierarchy.

[Example: Consider a table style which contains conditional formatting for its firstRow, defined as follows:

<w:style w:type="table" w:styleId="exampleTableStyle">
…
<w:tblStylePr w:type="firstRow">
<w:pPr>
<w:jc w:val="center"/>
</w:pPr>
…
</w:tblStylePr>
</w:style>

The pPr element specified within the tblStylePr element specifies the set of paragraph properties which must be applied to all parts of the table which meet the criteria specified by the type value of firstRow - all of the header rows of the table. In this example, the single paragraph property applied is an alignment value of center via the jc element (§17.3.1.13). end example]

Parent Elements

tblStylePr (§17.7.6.6)

Child Elements

Subclause

adjustRightInd (Automatically Adjust Right Indent When Using Document Grid)

§17.3.1.1

autoSpaceDE (Automatically Adjust Spacing of Latin and East Asian Text)

§17.3.1.2

autoSpaceDN (Automatically Adjust Spacing of East Asian Text and Numbers)

§17.3.1.3

bidi (Right to Left Paragraph Layout)

§17.3.1.6

cnfStyle (Paragraph Conditional Formatting)

§17.3.1.8

contextualSpacing (Ignore Spacing Above and Below When Using Identical Styles)

§17.3.1.9

divId (Associated HTML div ID)

§17.3.1.10

framePr (Text Frame Properties)

§17.3.1.11

ind (Paragraph Indentation)

§17.3.1.12

jc (Paragraph Alignment)

§17.3.1.13

keepLines (Keep All Lines On One Page)

§17.3.1.14

keepNext (Keep Paragraph With Next Paragraph)

§17.3.1.15

kinsoku (Use East Asian Typography Rules for First and Last Character per Line)

§17.3.1.16

mirrorIndents (Use Left/Right Indents as Inside/Outside Indents)

§17.3.1.18

numPr (Numbering Definition Instance Reference)

§17.3.1.19

outlineLvl (Associated Outline Level)

§17.3.1.20

overflowPunct (Allow Punctuation to Extend Past Text Extents)

§17.3.1.21

pageBreakBefore (Start Paragraph on Next Page)

§17.3.1.23

pBdr (Paragraph Borders)

§17.3.1.24

pPrChange (Revision Information for Paragraph Properties)

§17.13.5.29

pStyle (Referenced Paragraph Style)

§17.3.1.27

shd (Paragraph Shading)

§17.3.1.31

snapToGrid (Use Document Grid Settings for Inter-Line Paragraph Spacing)

§17.3.1.32

spacing (Spacing Between Lines and Above/Below Paragraph)

§17.3.1.33

suppressAutoHyphens (Suppress Hyphenation for Paragraph)

§17.3.1.34

suppressLineNumbers (Suppress Line Numbers for Paragraph)

§17.3.1.35

suppressOverlap (Prevent Text Frames From Overlapping)

§17.3.1.36

tabs (Set of Custom Tab Stops)

§17.3.1.38

textAlignment (Vertical Character Alignment on Line)

§17.3.1.39

textboxTightWrap (Allow Surrounding Paragraphs to Tight Wrap to Text Box Contents)

§17.3.1.40

textDirection (Paragraph Text Flow Direction)

§17.3.1.41

topLinePunct (Compress Punctuation at Start of a Line)

§17.3.1.43

widowControl (Allow First/Last Line to Display on a Separate Page)

§17.3.1.44

wordWrap (Allow Line Breaking At Character Level)

§17.3.1.45

[Note: The W3C XML Schema definition of this element’s content model (CT_PPrGeneral) is located in §A.1. end note]

[ISO/IEC 29500-1 1st Edition]

17.7.6.1 pPr (Style Paragraph Properties)

This element specifies the set of paragraph properties which shall be applied to the paragraph.

[Example: Consider a paragraph style defined as follows:

<w:style w:type="paragraph" w:styleId="TestParaStyle">
<w:pPr>
<w:keepLines/>
</w:pPr>
</w:style>

The pPr element specified within the style element specifies the set of paragraph properties which must be applied to the referencing paragraph. In this example, the single paragraph property applied is the fact that the paragraph must be displayed on a single page via the keepLines element (§17.3.1.14). end example]

Parent Elements

style (§17.7.4.17)

Child Elements

Subclause

adjustRightInd (Automatically Adjust Right Indent When Using Document Grid)

§17.3.1.1

autoSpaceDE (Automatically Adjust Spacing of Latin and East Asian Text)

§17.3.1.2

autoSpaceDN (Automatically Adjust Spacing of East Asian Text and Numbers)

§17.3.1.3

bidi (Right to Left Paragraph Layout)

§17.3.1.6

cnfStyle (Paragraph Conditional Formatting)

§17.3.1.8

contextualSpacing (Ignore Spacing Above and Below When Using Identical Styles)

§17.3.1.9

divId (Associated HTML div ID)

§17.3.1.10

framePr (Text Frame Properties)

§17.3.1.11

ind (Paragraph Indentation)

§17.3.1.12

jc (Paragraph Alignment)

§17.3.1.13

keepLines (Keep All Lines On One Page)

§17.3.1.14

keepNext (Keep Paragraph With Next Paragraph)

§17.3.1.15

kinsoku (Use East Asian Typography Rules for First and Last Character per Line)

§17.3.1.16

mirrorIndents (Use Left/Right Indents as Inside/Outside Indents)

§17.3.1.18

numPr (Numbering Definition Instance Reference)

§17.3.1.19

outlineLvl (Associated Outline Level)

§17.3.1.20

overflowPunct (Allow Punctuation to Extend Past Text Extents)

§17.3.1.21

pageBreakBefore (Start Paragraph on Next Page)

§17.3.1.23

pBdr (Paragraph Borders)

§17.3.1.24

pPrChange (Revision Information for Paragraph Properties)

§17.13.5.29

pStyle (Referenced Paragraph Style)

§17.3.1.27

shd (Paragraph Shading)

§17.3.1.31

snapToGrid (Use Document Grid Settings for Inter-Line Paragraph Spacing)

§17.3.1.32

spacing (Spacing Between Lines and Above/Below Paragraph)

§17.3.1.33

suppressAutoHyphens (Suppress Hyphenation for Paragraph)

§17.3.1.34

suppressLineNumbers (Suppress Line Numbers for Paragraph)

§17.3.1.35

suppressOverlap (Prevent Text Frames From Overlapping)

§17.3.1.36

tabs (Set of Custom Tab Stops)

§17.3.1.38

textAlignment (Vertical Character Alignment on Line)

§17.3.1.39

textboxTightWrap (Allow Surrounding Paragraphs to Tight Wrap to Text Box Contents)

§17.3.1.40

textDirection (Paragraph Text Flow Direction)

§17.3.1.41

topLinePunct (Compress Punctuation at Start of a Line)

§17.3.1.43

widowControl (Allow First/Last Line to Display on a Separate Page)

§17.3.1.44

wordWrap (Allow Line Breaking At Character Level)

§17.3.1.45

[Note: The W3C XML Schema definition of this element’s content model (CT_PPrGeneral) is located in §A.1. end note]

© ISO/IEC29500: 2008.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

StyleParagraphProperties Members

DocumentFormat.OpenXml.Wordprocessing Namespace