[Table of Contents] [docx version]

VML Reference Material - VML

callout (Callout)

This element specifies the automatic behavior and layout parameters of callout shapes. Callout shapes are standard VML shapes that behave as callouts, providing an additional callout object which can be used to point at another location:

[Example: Consider the following VML shape:

 

If this shape is made a callout shape by adding the callout element to its shape definition, then the shape will have a callout object, for example:

 

end example]

Parent Elements

arc6.1.2.1); background2.2.1); curve6.1.2.3); group6.1.2.7); hdrShapeDefaults2.15.1.50); image6.1.2.10); line6.1.2.12); object2.3.3.19); oval6.1.2.13); pict2.3.3.21); pict2.9.23); polyline6.1.2.15); rect6.1.2.16); roundrect6.1.2.17); shape6.1.2.19); shapedefaults6.2.2.27); shapeDefaults2.15.1.79); shapetype6.1.2.20)

 

Attributes

Description

accentbar (Callout accent bar toggle)

Specifies whether an accent bar will be used with the callout. Default is false.

 

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

angle (Callout angle)

Specifies the angle that the callout makes with respect to the bounding box of the shape. Default is no value.

 

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

distance (Callout drop distance)

Specifies the drop distance of a callout. The drop distance of a callout is measured from the edge of the shape where the pointer line starts and continues the absolute length of the distance value. If specified with no units, EMUs are assumed. Default is no value.

 

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

drop (Callout drop position)

Specifies where the drop of a callout will be placed.

 

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

dropauto (Callout automatic drop toggle)

Specifies whether the callout has an automatic drop.

 

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

ext (VML Extension Handling Behavior)

 

Namespace: urn:schemas-microsoft-com:vml

Specifies an optional value that indicates how applications that implement VML should interpret extensions not defined as part of the original specification of core VML.

 

[Rationale: This part of the original VML specification is included to assist applications that leverage existing VML support in implementing the Office Open XML Format. end rationale]

 

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

gap (Callout gap)

Specifies the distance of the callout line from the bounding rectangle of the callout. Default value is one-twelfth of an inch, in EMUs (76200).

 

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

length (Callout length)

Specifies the length of the first part of a multi-segmented callout line. If specified with no units, EMUs are assumed. Default is 0.

 

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

lengthspecified (Callout length toggle)

Specifies whether the length attribute will be used for the callout. Default is false. If true, the length attribute is used. If false, a best fit is used.

 

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

minusx (Callout flip x)

Specifies whether the callout flips to the other side of the drop tip along the x-axis when moved or resized. Default is false.

 

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

minusy (Callout flip y)

Specifies whether the callout flips to the other side of the drop tip along the y-axis when moved or resized. Default is false.

 

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

on (Callout toggle)

Specifies whether a shape is a callout. Default is false.

 

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

textborder (Callout text border toggle)

Specifies whether a callout has a text border. Default is true.

 

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

type (Callout type)

Specifies the type of callout. Default is rectangle. Allowed values are:

 

rectangle

roundedrectangle

oval

cloud

 

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

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

<complexType name="CT_Callout">

   <attributeGroup ref="v:AG_Ext"/>

   <attribute name="on" type="ST_TrueFalse" use="optional"/>

   <attribute name="type" type="xsd:string" use="optional"/>

   <attribute name="gap" type="xsd:string" use="optional"/>

   <attribute name="angle" type="ST_Angle" use="optional"/>

   <attribute name="dropauto" type="ST_TrueFalse" use="optional"/>

   <attribute name="drop" type="ST_CalloutDrop" use="optional"/>

   <attribute name="distance" type="xsd:string" use="optional"/>

   <attribute name="lengthspecified" type="ST_TrueFalse" default="f" use="optional"/>

   <attribute name="length" type="xsd:string" use="optional"/>

   <attribute name="accentbar" type="ST_TrueFalse" use="optional"/>

   <attribute name="textborder" type="ST_TrueFalse" use="optional"/>

   <attribute name="minusx" type="ST_TrueFalse" use="optional"/>

   <attribute name="minusy" type="ST_TrueFalse" use="optional"/>

</complexType>