[Table of Contents] [docx version]

WordprocessingML Reference Material - Table of Contents

ST_TblWidth (Table Width Units)

This simple type specifies the possible values for the units of the width property being defined by a specific table width property. These properties are used to define various properties of a table, including: cell spacing, preferred width, and table margins.

[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 shall therefore be used to interpret the width specified in the w attribute as a value in twentieths of a point. end example]

This simple type's contents are a restriction of the XML Schema string datatype.

The following are possible enumeration values for this type:

Enumeration Value

Description

auto (Automatically Determined Width)

Specifies that the value for the measurement of the current table width property in the parent table shall be automatically determined by the table layout algorithm when the table is displayed (this width can be adjusted as appropriate).

 

If this value is inappropriate for the current measurement (i.e. this measurement is not affected by that algorithm), then this type and the associated value may be ignored.

dxa (Width in Twentieths of a Point)

Specifies that the value for the measurement of the current table width property in the parent table shall be interpreted as twentieths of a point (1/1440 of an inch).

nil (No Width)

Specifies that the current width is zero, regardless of any width value specified on the parent element.

pct (Width in Fiftieths of a Percent)

Specifies that the value for the measurement of the current table width property in the parent table shall be interpreted as fiftieths of a percent.

 

[Example: 4975 = 99.5% end example]

 

These percentages shall be calculated relative to the extents specified by the parent XML element.

 

If this value is inappropriate for the current measurement (i.e. this measurement is not part of the width of the table), then this type and the associated value may be ignored.

 

Referenced By

bottom@type (§2.4.2); bottom@type (§2.4.5); left@type (§2.4.25); left@type (§2.4.26); right@type (§2.4.29); right@type (§2.4.31); tblCellSpacing@type (§2.4.41); tblCellSpacing@type (§2.4.42); tblCellSpacing@type (§2.4.43); tblInd@type (§2.4.47); tblInd@type (§2.4.48); tblW@type (§2.4.60); tblW@type (§2.4.61); tcW@type (§2.4.68); top@type (§2.4.72); top@type (§2.4.73); wAfter@type (§2.4.82); wBefore@type (§2.4.83)

The following XML Schema fragment defines the contents of this simple type:

<simpleType name="ST_TblWidth">

   <restriction base="xsd:string">

   <enumeration value="nil"/>

   <enumeration value="pct"/>

   <enumeration value="dxa"/>

   <enumeration value="auto"/>

   </restriction>

</simpleType>