[Table of Contents] [docx version]

WordprocessingML Reference Material - Table of Contents

readModeInkLockDown (Freeze Document Layout)

This element specifies the exact set of page and text sizing parameters which shall be used to display the contents of a WordprocessingML document. [Rationale: This setting is typically used for documents that have been annotated using ink. This setting freezes the document's presentation such that the ink annotations shall exist at the same position of the WordprocessingML document irrespective of the monitor on which the WordprocessingML document is rendered. end rationale]

This element shall only affect the display of WordprocessingML documents as follows:

When the actualPage attribute is specified with a value of true, the given WordprocessingML document's pages shall be rendered as they would normally be displayed. The resulting pages may have their magnification setting changed as desired. All other attributes shall be ignored.

When the actualPage attribute is specified with a value of false, the given WordprocessingML document's pages shall be rendered as virtual pages when loaded by a conforming hosting application irrespective of the given WordprocessingML document's view2.15.1.93). Virtual pages are pages with no correlation with the printed layout of a given WordprocessingML document that have been scaled by a conforming hosting application to improve the readability of a given WordprocessingML document when it is displayed. Specifically, the w and h attributes specify the width and height of the virtual pages, and the fontSz attribute specifies the scaling to be applied to text within the given WordprocessingML document.

[Example: Consider a WordprocessingML document that shall be displayed using virtual pages when its contents are displayed. This state is specified using the following WordprocessingML in the document settings:

<w:readModeInkLockDown w:w="692" w:h="986" w:fontSz="95" w:actualPg="0"/>

The readModeInkLockDown element has w and h attribute values which specify the width and height of the virtual pages to be used to render the given WordprocessingML document. Finally, the fontSz attribute specifies the scaling to be applied to text within the given WordprocessingML document. end example]

Parent Elements

settings2.15.1.78)

 

Attributes

Description

actualPg (Use Actual Pages, Not Virtual Pages)

Specifies if applications shall render this WordprocessingML document with actual pages, not virtual pages. Actual pages are pages rendered as they will be printed.

 

A value of true specifies that the given WordprocessingML document's pages will be rendered as they are printed, and the w, h, and fontSz attributes shall be ignored. A value of false specifies that the given WordprocessingML document's pages shall be rendered as virtual pages using the other attributes on this element.

 

[Example: Consider a WordprocessingML document that shall be displayed using virtual pages. This state is specified using the following WordprocessingML in the document settings:

 

<w:readModeInkLockDown w:w="692" w:h="986" w:fontSz="95" w:actualPg="0" />

 

The actualPage attribute is equal to 0 specifying that the given WordprocessingML document shall be rendered by conforming hosting applications using virtual pages. end example]

 

The possible values for this attribute are defined by the ST_OnOff simple type2.18.67).

fontSz (Font Size Scaling)

Specifies the percentage that text in a given WordprocessingML document shall be scaled by before it is displayed on a virtual page. The attribute's value stores the percentage specified as an integer who units correspond to the percentage that text runs shall be scaled to [Example: 200 means a scale to 200% end example].

 

This attribute shall only be used if the actualPage attribute equals off, 0, or false.

 

[Example: Consider a WordprocessingML document that shall be displayed using virtual pages. This state is specified using the following WordprocessingML in the document settings:

 

<w:readModeInkLockDown w:w="692" w:h="986" w:fontSz="95" w:actualPg="0" />

 

The fontSz attribute is equal to 95 specifying that the text in the WordprocessingML document shall be displayed at 95% of its normal size when it is displayed on a virtual page. end example]

 

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

h (Virtual Page Height)

Specifies the height of the virtual pages which shall be used in this document. This value is specified in pixels.

 

This attribute shall only be used if the actualPage attribute equals off, 0, or false.

 

[Example: Consider a WordprocessingML document that shall be displayed using virtual pages. This state is specified using the following WordprocessingML in the document settings:

 

<w:readModeInkLockDown w:w="692" w:h="986" w:fontSz="95" w:actualPg="0" />

 

The h attribute is equal to 986 specifying that virtual pages in this document shall be 986 pixels high. end example]

 

The possible values for this attribute are defined by the ST_PixelsMeasure simple type2.18.74).

w (Virtual Page Width)

Specifies the width of the virtual pages which shall be used in this document. This value is specified in pixels.

 

This attribute shall only be used if the actualPage attribute equals off, 0, or false.

 

[Example: Consider a WordprocessingML document that shall be displayed using virtual pages. This state is specified using the following WordprocessingML in the document settings:

 

<w:readModeInkLockDown w:w="692" w:h="986" w:fontSz="95" w:actualPg="0" />

 

The w attribute is equal to 692 specifying that virtual pages in this document shall be 692 pixels wide. end example]

 

The possible values for this attribute are defined by the ST_PixelsMeasure simple type2.18.74).

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

<complexType name="CT_ReadingModeInkLockDown">

   <attribute name="actualPg" type="ST_OnOff" use="required"/>

   <attribute name="w" type="ST_PixelsMeasure" use="required"/>

   <attribute name="h" type="ST_PixelsMeasure" use="required"/>

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

</complexType>