[Table of Contents] [docx version]

VML Reference Material - VML

r (Rule)

This element specifies a rule entry in a rules element rule set that describes how a certain shape or set of shapes behaves during editing.

[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

rules6.2.2.26)

 

Child Elements

Subclause

proxy (Shape Reference)

§6.2.2.20

 

Attributes

Description

how (Alignment Rule Type)

Specifies the type of alignment for an alignment rule. Default is no value. Allowed values are:

 

top

middle

bottom

left

center

right

 

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

id (Rule ID)

Specifies an identifier for the rule. Default is no value.

 

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

idref (Rule Shape Reference)

Specifies a reference to a shape in the current document that is the primary shape in the rule. For example, for a connector rule, the connector.

 

Default is no value. A shape name is used as the reference mechanism; this is not a relationship ID.

 

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

type (Rule Type)

Specifies the type of the rule. Default is no value. Allowed values are:

 

arc

callout

connector

align

 

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

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

<complexType name="CT_R">

   <sequence>

   <element name="proxy" type="CT_Proxy" minOccurs="0" maxOccurs="unbounded"/>

   </sequence>

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

   <attribute name="type" type="ST_RType" use="optional"/>

   <attribute name="how" type="ST_How" use="optional"/>

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

</complexType>