PreviousTableProperties Class

Previous Table Properties.When the object is serialized out as xml, its qualified name is w:tblPr.

Inheritance Hierarchy

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

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

Syntax

'Declaration
<ChildElementInfoAttribute(GetType(TableLayout))> _
<ChildElementInfoAttribute(GetType(TableStyle))> _
<ChildElementInfoAttribute(GetType(TablePositionProperties))> _
<ChildElementInfoAttribute(GetType(TableOverlap))> _
<ChildElementInfoAttribute(GetType(BiDiVisual))> _
<ChildElementInfoAttribute(GetType(TableWidth))> _
<ChildElementInfoAttribute(GetType(TableJustification))> _
<ChildElementInfoAttribute(GetType(TableCellSpacing))> _
<ChildElementInfoAttribute(GetType(TableIndentation))> _
<ChildElementInfoAttribute(GetType(TableBorders))> _
<ChildElementInfoAttribute(GetType(Shading))> _
<ChildElementInfoAttribute(GetType(TableCellMarginDefault))> _
<ChildElementInfoAttribute(GetType(TableLook))> _
<ChildElementInfoAttribute(GetType(TableCaption), FileFormatVersions.Office2010)> _
<ChildElementInfoAttribute(GetType(TableDescription), FileFormatVersions.Office2010)> _
Public Class PreviousTableProperties _
    Inherits OpenXmlCompositeElement
'Usage
Dim instance As PreviousTableProperties
[ChildElementInfoAttribute(typeof(TableLayout))]
[ChildElementInfoAttribute(typeof(TableStyle))]
[ChildElementInfoAttribute(typeof(TablePositionProperties))]
[ChildElementInfoAttribute(typeof(TableOverlap))]
[ChildElementInfoAttribute(typeof(BiDiVisual))]
[ChildElementInfoAttribute(typeof(TableWidth))]
[ChildElementInfoAttribute(typeof(TableJustification))]
[ChildElementInfoAttribute(typeof(TableCellSpacing))]
[ChildElementInfoAttribute(typeof(TableIndentation))]
[ChildElementInfoAttribute(typeof(TableBorders))]
[ChildElementInfoAttribute(typeof(Shading))]
[ChildElementInfoAttribute(typeof(TableCellMarginDefault))]
[ChildElementInfoAttribute(typeof(TableLook))]
[ChildElementInfoAttribute(typeof(TableCaption), FileFormatVersions.Office2010)]
[ChildElementInfoAttribute(typeof(TableDescription), FileFormatVersions.Office2010)]
public class PreviousTableProperties : OpenXmlCompositeElement

Remarks

The following table lists the possible child types:

  • TableStyle <w:tblStyle>

  • TablePositionProperties <w:tblpPr>

  • TableOverlap <w:tblOverlap>

  • BiDiVisual <w:bidiVisual>

  • TableWidth <w:tblW>

  • TableJustification <w:jc>

  • TableCellSpacing <w:tblCellSpacing>

  • TableIndentation <w:tblInd>

  • TableBorders <w:tblBorders>

  • Shading <w:shd>

  • TableLayout <w:tblLayout>

  • TableCellMarginDefault <w:tblCellMar>

  • TableLook <w:tblLook>

  • TableCaption <w:tblCaption>

  • TableDescription <w:tblDescription>

[ISO/IEC 29500-1 1st Edition]

17.4.59 tblPr (Previous Table Properties)

This element specifies a previous set of table properties, the modifications to which shall be attributed to a revision by a particular author and at a particular time. This element contains the table property settings which were previously in place before a specific set of revisions by one author. These properties affect the appearance of all rows and cells within the parent table, but can be overridden by individual table-level exception, row, and cell level properties, as defined by each property.

[Example: Consider the following simple WordprocessingML table:

If the table justification is set to center and the table shading to set to red with revision marking on, as follows:

The revision tracked on this table would be specified as follows in the WordprocessingML:

<w:tblPr>
<w:tblStyle w:val="TableGrid"/>
<w:tblW w:w="0" w:type="auto"/>
<w:jc w:val="center"/>
<w:shd w:val="clear" w:color="auto" w:fill="FF0000"/>
<w:tblLook w:val="04A0"/>
<w:tblPrChange w:id="0" … >
    <w:tblPr>
<w:tblStyle w:val="TableGrid"/>
<w:tblW w:w="0" w:type="auto"/>
<w:tblLook w:val="04A0"/>
</w:tblPr>
</w:tblPrChange>
</w:tblPr>

The tblPr element as a child of tblPrChange contains the previous definition for the table properties, consisting of the properties set before the current tracked revision. end example]

Parent Elements

tblPrChange (§17.13.5.34)

Child Elements

Subclause

bidiVisual (Visually Right to Left Table)

§17.4.1

jc (Table Alignment)

§17.4.29

shd (Table Shading)

§17.4.32

tblBorders (Table Borders)

§17.4.39

tblCaption (Table Caption)

§17.4.41

tblCellMar (Table Cell Margin Defaults)

§17.4.43

tblCellSpacing (Table Cell Spacing Default)

§17.4.46

tblDescription (Table Description)

§17.4.47

tblInd (Table Indent from Leading Margin)

§17.4.51

tblLayout (Table Layout)

§17.4.53

tblLook (Table Style Conditional Formatting Settings)

§17.4.56

tblOverlap (Floating Table Allows Other Tables to Overlap)

§17.4.57

tblpPr (Floating Table Positioning)

§17.4.58

tblStyle (Referenced Table Style)

§17.4.63

tblStyleColBandSize (Number of Columns in Column Band)

§17.7.6.5

tblStyleRowBandSize (Number of Rows in Row Band)

§17.7.6.7

tblW (Preferred Table Width)

§17.4.64

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

[ISO/IEC 29500-1 1st Edition]

17.7.4.3 tblPr (Table Style Conditional Formatting Table Properties)

This element specifies the set of table properties which shall be applied to all regions 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.

If the current conditional formatting type does not consist of one or more full table rows, then table properties which cannot be applied to a single cell or column [Example: Table justification. end example] can be ignored.

[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:tblPr>
<w:tblCellSpacing w:w="29" w:type="dxa"/>
</w:tblPr>
…
</w:tblStylePr>
</w:style>

The tblPr element specified within the tblStylePr element specifies the set of table 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 table property applied is a default table cell spacing value of 0.02 inches via the tblCellSpacing element (§17.4.46). end example]

Parent Elements

tblStylePr (§17.7.6.6)

Child Elements

Subclause

bidiVisual (Visually Right to Left Table)

§17.4.1

jc (Table Alignment)

§17.4.29

shd (Table Shading)

§17.4.32

tblBorders (Table Borders)

§17.4.39

tblCaption (Table Caption)

§17.4.41

tblCellMar (Table Cell Margin Defaults)

§17.4.43

tblCellSpacing (Table Cell Spacing Default)

§17.4.46

tblDescription (Table Description)

§17.4.47

tblInd (Table Indent from Leading Margin)

§17.4.51

tblLayout (Table Layout)

§17.4.53

tblLook (Table Style Conditional Formatting Settings)

§17.4.56

tblOverlap (Floating Table Allows Other Tables to Overlap)

§17.4.57

tblpPr (Floating Table Positioning)

§17.4.58

tblStyle (Referenced Table Style)

§17.4.63

tblStyleColBandSize (Number of Columns in Column Band)

§17.7.6.5

tblStyleRowBandSize (Number of Rows in Row Band)

§17.7.6.7

tblW (Preferred Table Width)

§17.4.64

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

[ISO/IEC 29500-1 1st Edition]

17.7.4.4 tblPr (Style Table Properties)

This element specifies the set of table properties which shall be applied to the table. These properties are not conditional and shall always be applied (although they are applied before all conditional formatting properties).

[Example: Consider a table style defined as follows:

<w:style w:type="table" w:styleId="exampleTableStyle">
<w:tblPr>
<w:tblCellSpacing w:w="15" w:type="dxa"/>
</w:tblPr>
  …
<w:tblStylePr w:type="firstRow">-
<w:tblPr>
<w:tblCellSpacing w:w="29" w:type="dxa"/>
</w:tblPr>
…
</w:tblStylePr>
</w:style>

The tblPr element specified within the style element specifies the set of table properties which must be applied to all parts of the table. In this example, the single table property applied is a default table cell spacing value of 0.01 inches via the tblCellSpacing element (§17.4.46). end example]

Parent Elements

style (§17.7.4.17)

Child Elements

Subclause

bidiVisual (Visually Right to Left Table)

§17.4.1

jc (Table Alignment)

§17.4.29

shd (Table Shading)

§17.4.32

tblBorders (Table Borders)

§17.4.39

tblCaption (Table Caption)

§17.4.41

tblCellMar (Table Cell Margin Defaults)

§17.4.43

tblCellSpacing (Table Cell Spacing Default)

§17.4.46

tblDescription (Table Description)

§17.4.47

tblInd (Table Indent from Leading Margin)

§17.4.51

tblLayout (Table Layout)

§17.4.53

tblLook (Table Style Conditional Formatting Settings)

§17.4.56

tblOverlap (Floating Table Allows Other Tables to Overlap)

§17.4.57

tblpPr (Floating Table Positioning)

§17.4.58

tblStyle (Referenced Table Style)

§17.4.63

tblStyleColBandSize (Number of Columns in Column Band)

§17.7.6.5

tblStyleRowBandSize (Number of Rows in Row Band)

§17.7.6.7

tblW (Preferred Table Width)

§17.4.64

[Note: The W3C XML Schema definition of this element’s content model (CT_TblPrBase) 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

PreviousTableProperties Members

DocumentFormat.OpenXml.Wordprocessing Namespace