TableGridChange class

Office 2013 and later

Revision Information for Table Grid Column Definitions. When the object is serialized out as xml, its qualified name is w:tblGridChange.

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

public class TableGridChange : OpenXmlCompositeElement

[ISO/IEC 29500-1 1st Edition]

tblGridChange (Revision Information for Table Grid Column Definitions)

This element specifies the details about a single revision to a table's grid column definitions within a WordprocessingML document.

This element stores this revision as follows:

  • The child element of this element contains the definition of the table grid which was applied to the parent table before this revision

[Example: Consider a two column table in a WordprocessingML document which has the width of its first column significantly reduced, and this change in the table grid is tracked as a revision. This revision would be specified using the following WordprocessingML markup:

  <w:gridCol w:w="1548" />
  <w:gridCol w:w="8028" />
  <w:tblGridChange w:id="1">
      <w:gridCol w:w="4788" />
      <w:gridCol w:w="4788" />

The tblGridChange element specifies that there was a revision to the table grid, and the previous table grid had both columns with a width of 4788 twentieths of a point, vs. their current widths of 1548 and 8028 twentieths of a point respectively. end example]

Parent Elements

tblGrid (§17.4.49)

Child Elements


tblGrid (Previous Table Grid)




id (Annotation Identifier)

Specifies a unique identifier for an annotation within a WordprocessingML document. The restrictions on the id attribute, if any, are defined by the parent XML element.

If this attribute is omitted, then the document is non-conformant.

[Example: Consider an annotation represented using the following WordprocessingML fragment:

<… w:id="1" … >

The id attribute specifies that the ID of the current annotation is 1. This value is used to uniquely identify this annotation within the document content. end example]

The possible values for this attribute are defined by the ST_DecimalNumber simple type (§17.18.10).

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

© ISO/IEC29500: 2008.

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