[Table of Contents] [docx version]

VML Reference Material - VML

proxy (Shape Reference)

This element specifies an entry in a r element rule that contains a reference to one or more shapes that are participating in the rule.

[Example: The following rule defines a connection between two shapes. The shape with id _s1036 connects shape _s1033 to _s1032:

<o:shapelayout v:ext="edit">

<o:rules v:ext="edit">

<o:r id="V:Rule1" type="connector" idref="#_s1036">

<o:proxy start="" idref="#_s1033" connectloc="0"/>

<o:proxy end="" idref="#_s1032" connectloc="2"/>

</o:r>

</o:rules>

</o:shapelayout>

end example]

Parent Elements

r6.2.2.21)

 

Attributes

Description

connectloc (Connection Location)

Specifies the location on the shape where the connector is attached. The value is an index into the list of connection points defined in the shape - see the connectlocs attribute. Default is 0. Only used in a connector rule.

 

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

end (End Point Connection Flag)

Specifies whether the connector's end point is connected to the shape. Default is false. Only used in a connector rule.

 

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

idref (Proxy Shape Reference)

Specifies a reference to a shape in the current document. Default is no value. A shape name is used as the reference mechanism; this is not a relationship ID.

 

This attribute indicates that the referenced shape is part of this rule. Two or more proxy elements are used for an alignment rule. A connector rule uses one or two, indicating which shapes the connector is attached to.

 

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

start (Start Point Connection Flag)

Specifies whether the connector’s start point is connected to the shape. Default is false. Only used in a connector rule. If both start and end are specified the later one takes precedence.

 

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

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

<complexType name="CT_Proxy">

   <attribute name="start" type="ST_TrueFalseBlank" use="optional" default="false"/>

   <attribute name="end" type="ST_TrueFalseBlank" use="optional" default="false"/>

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

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

</complexType>