17.15.1.87 summaryLength

This element specifies the size for automatic document summaries performed on the content of a WordprocessingML document. An automatic document summary is a subset of text contained in a document deemed by the hosting application to summarize the content of the WordprocessingML document. The val attribute of this element specifies the size of an automatic document summary to be performed on a given WordprocessingML document as a percentage of the total size of the given WordprocessingML document. Performing an automatic document summary is a runtime operation outside the scope of ISO/IEC 29500.

If this element is omitted, then applications can summarize this document to any desired size.

[Example: Consider a WordprocessingML document whose automatic document summary is to be ten percent of the size of the given WordprocessingML document. This requirement would be specified using the following WordprocessingML in the document settings part:

<w:summaryLength w:val="10%" />

The summaryLength element’s val attribute is equal to 10% specifying that any automatic document summary is to be ten percent of the size of the document. end example]

Attributes

val (Value in Percent)

Specifies a measurement in whole percentage points, with a trailing percent sign (U+0025).

[Example: Consider the following WordprocessingML fragment:

    <… w:val="50.125%" />

This value specifies a value of fifty and one-eighth percent. end example]

The possible values for this attribute are defined by the ST_DecimalNumberOrPercent simple type (17.18.11).

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