TableProperties class

Office 2013 and later

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

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

No code example is currently available or this language may not be supported.

[ISO/IEC 29500-1 1st Edition]

tblPr (Table Properties)

This element specifies the set of table-wide properties applied to the current table. 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:

This table defines a one point single border for all border types and is set to 100% of page width - both table-wide properties. The resulting table is represented by the following WordprocessingML:

<w:tbl>
  <w:tblPr>
    <w:tblW w:w="0" w:type="auto"/>
    <w:tblBorders>
      <w:top w:val="single" w:sz="4" w:space="0" w:color="auto"/>
      <w:left w:val="single" w:sz="4" w:space="0" w:color="auto"/>
      <w:bottom w:val="single" w:sz="4" w:space="0" w:color="auto"/>
      <w:right w:val="single" w:sz="4" w:space="0" w:color="auto"/>
      <w:insideH w:val="single" w:sz="4" w:space="0" w:color="auto"/>
      <w:insideV w:val="single" w:sz="4" w:space="0" w:color="auto"/>
    </w:tblBorders>
  </w:tblPr>
  …</w:tbl>

In this example, the tblW element (§17.4.64) defines the total width of the table, which, in this case, is set to a type of auto, which specifies that the table should be automatically sized to fit its contents. The tblBorders element (§17.4.39) specifies each of the table's borders, and specifies a one point border on the top, left, bottom, right and inside horizontal and vertical border. end example]

Parent Elements

tbl (§17.4.38)

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

tblPrChange (Revision Information for Table Properties)

§17.13.5.34

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_TblPr) is located in §A.1. end note]

© ISO/IEC29500: 2008.

The following code example uses the TableProperties class to create a Table and specify its border information.

No code example is currently available or this language may not be supported.

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