[Table of Contents] [docx version]

Error! No text of specified style in document.

rule (Rule)

This element allows for a rule to be specified which changes the value of an existing constraint.

[Example: Consider the following example of a rule in a DrawingML diagram:

<ruleLst>

   <rule type="primFontSz" val="2" />

</ruleLst>

In this example a rule is being defined that will shrink the primary font size down to a lower limit of 2pt font when the text no longer fits correctly in the layout node. end example]

Parent Elements

ruleLst5.9.2.25)

 

Child Elements

Subclause

extLst (Extension List)

§5.9.2.13

 

Attributes

Description

fact (Factor)

Factor used in a reference constraint or a rule in order to modify a referenced value by the factor defined.

 

[Example: Consider the following example of fact in use in a DrawingML diagram:

 

<constr type="w" for="ch" forName="transition1" refType="w" refFor="ch" refForName="node1" op="equ" fact="0.1"/>

 

In this example, the width for transition1 is being defined as one-tenth the width of node1. end example]

 

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

for (For)

Specifies the axis of layout nodes to apply a constraint or rule to.

 

[Example: Consider the following example of for in use in a DrawingML diagram:

 

<constr type="w" for="ch" forName="transition1" refType="w" refFor="ch" refForName="node1" op="equ" fact="0.1"/>

 

In this example, the for attribute is specifying that node1 is a child node to the current layout node. end example]

 

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

forName (For Name)

Specifies the name of the layout node to apply a constraint or rule to.

 

[Example: Consider the following example of forName in use in a DrawingML diagram:

 

<constr type="w" for="ch" forName="transition1" refType="w" refFor="ch" refForName="node1" op="equ" fact="0.1"/>

 

In this example, forName is specifying the layout node named transition1 for its reference. end example]

 

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

max (Max Value)

Sets the maximum value for a constraint so rules can no longer increase the constraint beyond that value.

 

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

ptType (Data Point Type)

Specifies the type of data point to select.

 

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

type (Constraint Type)

Specifies the constraint to apply to this layout node.

 

[Example: Consider the following example of type in use in a DrawingML diagram:

 

<constr type="w" for="ch" forName="transition1" refType="w" refFor="ch" refForName="node1" op="equ" fact="0.1"/>

 

In this example, type is specifying the width attribute of transition1. end example]

 

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

val (Value)

Specifies an absolute value instead of reference another constraint.

 

[Example: Consider the following example of forName in use in a DrawingML diagram:

 

<constr type="w" for="ch" forName="transition1" val="10"/>

 

In this example, val is specifying the absolute value of the width of transition1. end example]

 

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

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

<complexType name="CT_NumericRule">

   <sequence>

   <element name="extLst" type="a:CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>

   </sequence>

   <attributeGroup ref="AG_ConstraintAttributes"/>

   <attribute name="val" type="xsd:double" use="optional" default="NaN"/>

   <attribute name="fact" type="xsd:double" use="optional" default="NaN"/>

   <attribute name="max" type="xsd:double" use="optional" default="NaN"/>

</complexType>