2.1.1818 Part 4 Section 19.2.2.2, callout (Callout)

For additional notes that apply to this portion of the standard, please see the notes for pict, §14.2.2.2(a); pict, §14.5.1(a); hdrShapeDefaults, §14.7.2.1(a); shapeDefaults, §14.7.2.2(a); background, §17.2.1(a); group, §19.1.2.7(a).

a.   The standard does not imply a relationship between the callout element and the spt attribute.

In Office, this element specifies the automatic behavior and layout parameters of callout shapes. In Office, objects that have this attribute shall be made of one to three segments plus the shape itself. The number of segments is defined by the type attribute. See additional restrictions defined in the type attribute description. Shapes with callouts shall define values for the spt attribute of the shape element ("[ISO/IEC-29500-4] §19.1.2.19; shape (Shape Definition)") or shapetype element ("[ISO/IEC-29500-4] §19.1.2.20; shapetype (Shape Template)") as follows:

Attribute value		Value of type attribute
accentbar	textborder	oneSegment	twoSegment	threeSegment	rightAngle
False	False	spt="41"	spt="42"	spt="43"	spt="178"
True	False	spt="44"	spt="45"	spt="46"	spt="179"
False	True	spt="47"	spt="48"	spt="49"	spt="180"
True	True	spt="50"	spt="51"	spt="52"	spt="181"

b.   The standard indicates how the type attribute is used.

For Office, the type attribute specifies the design of the callout extension.  The allowed values are:

• rightAngle

• oneSegment

• twoSegment (default value)

• threeSegment

Callout shapes that contain the callout element work only if the first sub-path in the shape’s path is used to model the callout extension. This sub-path shall contain references to N formulas that reference N adjust values, where N = 2M + 2, and M is the number of segments in the callout.

[Example: The callout has two values for every vertex in the extension’s segments – one for the x coordinate and one for the y coordinate. If the value of the type attribute is rightAngle, there are two segments. end example]

Office also requires one handle for every segment vertex. The number of handles should be at least N/2.

See also the path element ("[ISO/IEC-29500-4] §19.1.2.14; path (Shape Path)") and the handles element ("[ISO/IEC-29500-4] §19.1.2.9; handles (Set of Handles)").

c.   The standard indicates how the accentbar attribute is used.

Office requires that the accent bar be a line sub-path, added after the first callout segment (see the type attribute). The segment is defined in the shape’s path.

[Example: Consider the following shape that consists of a single segment callout and a vertical accent bar.

The following snippet is one possible way to describe the shape’s path:

 <v:shape ... coordsize="21600,21600" o:spt="44" adj="-8280,24300,-1800,4050" path="m@0@1l@2@3nfem@2,l@2,21600nfem,l21600,r,21600l,21600nsxe" ... >
 </v:shape>

The first subpath, m@0@1l@2@3nfe, describes the callout segment and the second, m@2,l@2,21600nfe, describes the accent bar. The third subpath describes the rectangle. end example]

See also the path element ("[ISO/IEC-29500-4] §19.1.2.14; path (Shape Path)").

d.   The standard indicates how the angle attribute is used.

Office applies the angle attribute value only to the first segment of the callout extension and enforces this only during user interaction at runtime when the user interacts with the application UI.

e.   The standard indicates how the drop attribute is used.

Office only enforces the drop attribute during user interaction at runtime.

f.   The standard indicates how the dropauto attribute is used.

The dropauto attribute is only supported by Word and only when the value of the drop attribute is user and the value of the type attribute is not rightAngle.

g.   The standard does not define a default value for the drop attribute.

Office uses a default value of user for the drop attribute.

h.   The standard indicates how the gap attribute is used.

In Office, the gap attribute is only enforced at runtime when the user interacts with the application UI.

i.   The standard indicates how the textborder attribute is used.

In Office, the textborder attribute reflects the type of stroke used for the textbox. If it is set to false, the shape’s path shall also contain ns (no stroke). For more information, see the v attribute of the path element.

j.   The standard indicates how the distance attribute is used.

Office only enforces the distance attribute during user interaction at runtime.

k.   The standard indicates how the length attribute is used.

Office only enforces the length attribute during user interaction at runtime.

l.   The standard does not restrict the number of instances of this element.

Office allows at most only one instance of the callout element in each place where it can be used.

m.   The standard does not define a default value for the dropauto attribute.

Office uses a default value of false for the dropauto attribute.