[Table of Contents] [docx version]

WordprocessingML Reference Material - Table of Contents

zoom (Magnification Setting)

This element specifies the magnification level which should be applied to a document when it is displayed by an application. The zoom level is specified with the use of two attributes stored on this element:

val, which stores the type of zoom applied to the document

percent, which stores the zoom percentage to be used when rendering the document

If both attributes are present, then the percent attribute shall be treated as a 'cached' value and only used when the value none is specified for the val attribute.

If this element is omitted, then applications may display the document in any desired magnification setting.

[Example: Consider a WordprocessingML document that is to have its zoom level at seventy one percent when it is displayed. This requirement would be specified using the following WordprocessingML fragment in the document settings:

<w:zoom w:percent="71" />

The zoom element's percent attribute has a value of 71, specifying that the given document shall have its zoom level set to seventy one percent when it is displayed. end example]

Parent Elements

settings2.15.1.78)

 

Attributes

Description

percent (Zoom Percentage)

Specifies the zoom percentage that should be applied when a given WordprocessingML document is rendered by conforming hosting applications. This value is the zoom percentage specified as an integer whose units correspond to the zoom percentage.

 

If this attribute is omitted, then applications may use any desired default percentage for the magnification.

 

If the val attribute instantiated in addition to the percent attribute, then the percent attribute shall be treated as a cached value and only used when the value none is specified for the val attribute. If the value specified exceeds the maximum zoom level available in a conforming hosting application, the conforming hosting application shall display the document using its maximum zoom level. Correspondingly, if the value specified is less than the minimum zoom level available in the conforming hosting application, the conforming hosting application shall display the document using its minimum zoom level.

 

[Example: Consider a WordprocessingML document that is to have its zoom level at fifty percent when rendered by conforming hosting applications. This requirement would be specified using the following WordprocessingML:

 

<w:zoom w:percent="50" />

 

The percent attribute has a value of 50, specifying that the given WordprocessingML document shall to have its zoom level set to fifty percent when it is displayed. end example]

 

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

val (Zoom Type)

Specifies the type of zoom which shall be applied to a given document on open.

 

If this attribute is not present, then the document shall be displayed as though the value had been set to none, and should rely on the value of the percent attribute for the actual zoom percentage.

 

[Example: Consider a WordprocessingML document that should be visible without any horizontal scrolling when it is displayed. This requirement would be specified using the following WordprocessingML:

 

<w:zoom w:val="bestFit" w:percent="90" />

 

The val attribute is equal to the value bestFit specifying that an application shall dynamically calculate the magnification needed such that the given document shall be visible on the horizontal plane of the document with no horizontal scrolling required to see any part of the WordprocessingML document's pages.

 

Since both attributes are present, the percent attribute shall be treated as a 'cached' value and ignored. end example]

 

The possible values for this attribute are defined by the ST_Zoom simple type2.18.116).

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

<complexType name="CT_Zoom">

   <attribute name="val" type="ST_Zoom" use="optional"/>

   <attribute name="percent" type="ST_DecimalNumber" use="required"/>

</complexType>