[Table of Contents] [docx version]

WordprocessingML Reference Material - Table of Contents

fitText (Manual Run Width)

This element specifies that the contents of this run shall not be automatically displayed based on the width of its contents, rather its contents shall be resized to fit the width specified by the val attribute. This expansion/contraction shall be performed by equally increasing/decreasing the size of each character in this run's contents when displayed.

If this element is omitted, then the contents of this run shall be displayed based on the size of its contents.

[Example: Consider a document with a run which shall be displayed in exactly one-half inch of space, regardless of its contents. This constraint would be specified using the following WordprocessingML:

<w:r>

<w:rPr>

<w:fitText w:id="50" w:val="720" />

</w:rPr>

<w:t>This text shall be displayed in one-half of an inch.</w:t>

</w:r>

The resulting run contents shall be displayed in exactly 720 twentieths of a point (one half of an inch) when displayed in a document. end example]

Parent Elements

rPr2.7.8.1); rPr2.3.1.29); rPr2.5.2.26); rPr2.3.2.25); rPr2.3.2.26); rPr2.7.4.4); rPr2.3.1.30); rPr2.9.26); rPr2.5.2.27); rPr2.7.5.2)

 

Attributes

Description

id (Fit Text Run ID)

Specifies a unique ID which shall be used to link multiple contiguous runs containing fitText elements to each other to ensure that their contents are correctly merged into the specified width in the document.

 

This means that multiple runs which are broken apart due to differences in formatting can be identified as belonging to the same grouping in terms of fitText properties, although they are multiple runs of text in the WordprocessingML.

 

If the runs are not contiguous, then the id attribute is ignored, and the runs are not linked.

 

If this attribute is omitted, then this run has no id and shall not be linked with any other run in the parent paragraph.

 

[Example: Consider the following three runs in a document, which should be fit into exactly one inch at display time:

 

<w:r>

<w:rPr>

   <w:fitText w:id="99" w:val="1440" />

  </w:rPr>

  <w:t>fit this into</w:t>

</w:r>

<w:r>

<w:rPr>

   <w:b/>

   <w:fitText w:id="99" w:val="1440" />

   </w:rPr>

  <w:t>one</w:t>

</w:r>

<w:r>

<w:rPr>

   <w:fitText w:id="99" w:val="1440" />

   </w:rPr>

  <w:t>inch</w:t>

</w:r>

 

Although there are three runs of content, all three regions shall be combined into a single fit text region (e.g. they all fit into one inch, rather than one inch each) based on the identical value used in the id attribute for all three runs. end example]

 

The possible values for this attribute are defined by the ST_DecimalNumber simple type2.18.16).

val (Value)

This attribute specifies the exact width of space which this run shall be fit into when displayed in the document.

 

[Example: Consider a document with a run which shall be displayed in exactly one-half inch of space, regardless of its contents. This constraint would be specified using the following WordprocessingML:

 

<w:r>

<w:rPr>

<w:fitText w:id="50" w:val="720" />

</w:rPr>

<w:t>This text shall be displayed in one-half of an inch.</w:t>

</w:r>

 

The resulting run contents shall be displayed in exactly 720 twentieths of a point (one half of an inch) when displayed in a document. end example]

 

The possible values for this attribute are defined by the ST_TwipsMeasure simple type2.18.105).

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

<complexType name="CT_FitText">

   <attribute name="val" type="ST_TwipsMeasure" use="required"/>

   <attribute name="id" type="ST_DecimalNumber" use="optional"/>

</complexType>