[Table of Contents] [docx version]
VML Reference Material - VML
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 |
r (§6.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>