TableGridChange Class

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

Inheritance Hierarchy


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


<ChildElementInfoAttribute(GetType(PreviousTableGrid))> _
Public Class TableGridChange _
    Inherits OpenXmlCompositeElement
Dim instance As TableGridChange
public class TableGridChange : OpenXmlCompositeElement


The following table lists the possible child types:

  • PreviousTableGrid <w:tblGrid>

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

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


TableGridChange Members

DocumentFormat.OpenXml.Wordprocessing Namespace