<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: 
<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. ]

Parent Elements

<settings> (§2.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.

<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. ]

The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.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.

<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. ]

The possible values for this attribute are defined by the ST_Zoom simple type (§2.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>