chPref (Preferred Number of Children)

This variable indicates the number of children that the current node prefers to have. This determines what the next action of the ‘Add Shape’ button should be in the user interface.

[Example: Consider the following example of chPref being used in DiagramML:

<varLst>

   <chMax val="3" />

   <chPref val="1" />

   <dir val="norm" />

   <animLvl val="lvl" />

   <resizeHandles val="rel" />

</varLst>

In this example, chPref is set to a single node and the user interface will disable after a single node has been inserted. end example]

Parent Elements

presLayoutVars (§5.9.5.4); varLst (§5.9.2.31)

 

Attributes	Description
val (Preferred Number of CHildren Value)	This attribute indicates the number of children that the current node prefers to have. This determines what the next action of the ‘Add Shape’ button should be. A value of -1 indicates an infinite number of children. Default value is -1.   The possible values for this attribute are defined by the ST_NodeCount simple type (§5.9.7.43).

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

<complexType name="CT_ChildPref">

   <attribute name="val" type="ST_NodeCount" default="-1" use="optional"/>

</complexType>