<noWrap> (Don't Wrap Cell Content)

This element specifies how this table cell shall be laid out when the parent table is displayed in a document. This setting only affects the behavior of the cell when the <tblLayout> for this row (§2.4.49; §2.4.50) is set to use the auto algorithm.

This setting shall be interpreted in the context of the <tcW> element (§2.4.68) as follows:

  • If the table cell width has a @type attribute value of fixed, then this element specifies that that this table cell shall never be smaller than that fixed value when other cells on the line are not at their absolute minimum width.

  • If the table cell width has a @type attribute value of pct or auto, then this element specifies that when running the auto fit algorithm, the contents of that this table cell shall be treated as though they have no breaking characters (the contents should be treated as a single contiguous non-breaking string)

If this element is omitted, then cell content shall be allowed to wrap (the cell may be shrunk as needed if it is a fixed preferred width value, and the contents shall be treated as having breaking characters if it is a percentage or automatic width value).

example:

In this table, each cell has a fixed preferred width of 2.38 inches (3427 twentieths of a point), and the <tblLayout> for this row (§2.4.49; §2.4.50) is set to use the auto algorithm. If a long non breaking string is added to the middle row, as follows, the two cells are adjusted to override their preferences and accommodate the string:

sssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssss

However, if the first table cell has the <noWrap> element present as follows:

<w:tcPr>
  <w:noWrap/>
</w:tcPr>

The <noWrap> element specifies that because it is a fixed width cell, that cell shall not be collapsed beyond its original size until all other cells are at their minimum size, so in this example the cell maintains its width:

sssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssss

Parent Elements

<tcPr> (§2.7.5.8); <tcPr> (§2.4.66); <tcPr> (§2.7.5.9); <tcPr> (§2.4.67)

Attributes

Description

<val> (On/Off Value)

Specifies a binary value for the property defined by the parent XML element.

A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted.

A value of off, 0, or false specifies that the property shall be explicitly turned off.

example: 
<w:… w:val="off"/>

The @val attribute explicitly declares that the property is turned off. ]

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

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

<complexType name="CT_OnOff">
	<attribute name="val" type="ST_OnOff"/>
</complexType>