[Table of Contents] [docx version]

WordprocessingML Reference Material - Table of Contents

relyOnVML (Utilize VML When Saving as Web Page)

This element specifies whether applications may utilize the Vector Markup Language format when saving the content of this WordprocessingML document as a web page, when graphical elements which can leverage this format are present in the document.

If this element is omitted, then a graphic image format should be used either in place of or in concert with the Vector Markup Language output in order to specify the formatting and positioning for objects which are part of the resulting web page.

[Note: This setting is intended for applications to save web pages which can be supported by legacy web browsers which do not support Vector Markup Language when attempting to read and display the resulting web page. end note]

[Example: Consider a WordprocessingML document which contains the following content within the web settings part:

<w:webSettings>
<w:relyOnVML w:val="false" />
</w:webSettings>

The relyOnVML element has a val attribute value of false, which specifies that applications should utilize a graphical image version of all objects which could utilize Vector Markup Language output. This does not preclude the use of the VML output, but does specify that a graphical element shall be included as well. end example]

Parent Elements

webSettings2.15.2.44)

 

Attributes

Description

val (On/Off Value)

Specifies a binary value for the property defined by the parent XML element.

 

A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted.

 

A value of off, 0, or false specifies that the property shall be explicitly turned off.

 

[Example: For example, consider the following on/off property:

 

<w:… w:val="off"/>

 

The val attribute explicitly declares that the property is turned off. end example]

 

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

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

<complexType name="CT_OnOff">

   <attribute name="val" type="ST_OnOff"/>

</complexType>