[Table of Contents] [docx version]

VML Reference Material - VML

ink (Ink)

This element specifies the presence of an ink object. An ink object is a VML object which allows applications to store data for ink annotations in an application-defined format.

[Example:

<v:shape ... >

<o:ink i="AMgFHQSWC+YFASAAaAwAAAAAAMA..." annotation="t"/>

</v:shape>

end example]

Parent Elements

background2.2.1); hdrShapeDefaults2.15.1.50); object2.3.3.19); pict2.3.3.21); pict2.9.23); polyline6.1.2.15); shape6.1.2.19); shapeDefaults2.15.1.79)

 

Attributes

Description

annotation (Annotation Flag)

Specifies whether the ink object was created as an annotation rather than through pen input. Default is false. [Rationale This allows an application to treat annotation ink objects as any other annotation. For example, if annotations are hidden, the application can hide the ink object. An ink object that represents primary user input through a pen can be left visible. end rationale]

 

[Example:

 

<o:ink ... annotation="true">

</o:ink>

 

end example]

 

The possible values for this attribute are defined by the ST_TrueFalse simple type (§6.2.3.23).

i (Ink Data)

Specifies additional ink object information which shall be associated with the parent VML shape. The VML shape specifies the information necessary to render the ink, and this attribute may be used to store additional application-specific data about the VML shape(s) representing ink. This attribute's contents are optional and may be ignored if not recognized.

 

[Example:

 

<o:ink ... i="AMgFHQSWC+YFASAAaAwAAAAAAMA...">

</o:ink>

 

end example]

 

The possible values for this attribute are defined by the XML Schema base64Binary datatype.

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

<complexType name="CT_Ink">

   <sequence/>

   <attribute name="i" type="xsd:base64Binary"/>

   <attribute name="annotation" type="ST_TrueFalse"/>

</complexType>