17.4.87 Table Measurement

This common complex type specifies a measurement to be used within a table. These properties contain two pieces of information:

• The type of measurement (percentage-based, absolute, or automatic)
• The value of the measurement

[Example: Consider the following table measurement:

<… w:type="pct" w:w="100%"/>

The type attribute specifies that the measurement is percentage-based, and the w attribute specifies the measurement is 100%. end example]

Attributes

w (Table Width Value)

Specifies the value of the width property being defined by the parent element. This property is used to define various properties of a table, including: cell spacing, preferred widths, and table margins.

If this attribute is omitted, then its value shall be assumed to be 0.

[Example: Consider a table with a bottom margin with a width of 302, as follows:

  <w:bottom w:w="302" w:type="dxa" />

The value in the w attribute must therefore be used to determine the width being specified in the context of the units specified in the type attribute. In this case, the type is twentieths of a point (dxa), so the width is 302 twentieths of a point (.2097 inches). end example]

The possible values for this attribute are defined by the ST_MeasurementOrPercent simple type (17.18.107).

type (Table Width Type)

Specifies the units of the width property being defined by the parent element’s w attribute. This property is used to define various properties of a table, including: cell spacing, preferred width, and table margins.

If this attribute is omitted, then its value shall be assumed to be dxa (twentieths of a point).

[Example: Consider a table with a table cell bottom cell spacing with a type of dxa, as follows:

  <w:bottom … w:type="dxa" />

This type must therefore be used to interpret the width specified in the w attribute as a value in twentieths of a point. end example]

If the value of the type attribute and the actual measurement specified by the w attribute are contradictory, the type specified by the type attribute shall be ignored.

The possible values for this attribute are defined by the ST_TblWidth simple type (17.18.90).

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