<gridCol> (Grid Column Definition)

This element specifies the presence and details about a single grid column within a table grid. A grid column is a logical column in a table used to specify the presence of a shared vertical edge in the table. When table cells are then added to this table, these shared edges (or grid columns, looking at the column between those shared edges) determine how table cells are placed into the table grid.

example:

If the table grid does not match the requirements of one or more rows in the table (i.e. it does not define enough grid columns), then the grid may be redefined as needed when the table is processed.

example:

This table is represented by laying out the cells on a table grid consisting of three table grid columns as follows, each grid column representing a logical vertical column in the table:

The dashed lines represent the virtual vertical continuations of each table grid column, and thus resulting table grid is represented as the following in WordprocessingML:

<w:tblGrid>
  <w:gridCol w:w="5051" />
  <w:gridCol w:w="3008" />
  <w:gridCol w:w="1531" />
</w:tblGrid>

Parent Elements

<tblGrid> (§2.4.44); <tblGrid> (§2.4.45)

Attributes

Description

<w> (Grid Column Width)

Specifies the width of this grid column.

Note:

  • The table layout algorithm (§2.4.49;§2.4.50) applied to the current table row(s)

  • The preferred widths of specific cells which are part of that grid column as the table is displayed (which is an input to the algorithm above)

This value is specified in twentieths of a point.

If this attribute is omitted, then the last saved width of the grid column is assumed to be zero.

example: 
<w:tblGrid>
  <w:gridCol w:w="6888"/>
  <w:gridCol w:w="248"/>
  <w:gridCol w:w="886"/>
  <w:gridCol w:w="1554"/>
</w:tblGrid>

This table grid specifies four grid columns, each of which has an initial size of 6888 twentieths of a point, 248 twentieths of a point, 886 twentieths of a point, and 1554 twentieths of a point respectively. ]

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

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_TblGridCol">
	<attribute name="w" type="ST_TwipsMeasure"/>
</complexType>