21.4.6.5 chPref

This variable indicates the number of children that the current node prefers to have. [Note: For example, this could be used to guide how many shapes to add by default to a diagram at various levels in the hierarchy. end note]

[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 associated user interface may disable insertion of further nodes after a single node has been inserted. end example]

Attributes

val (Preferred Number of CHildren Value)

This attribute indicates the number of children that the current node prefers to have. 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 (21.4.7.44).

[Note: The W3C XML Schema definition of this element’s content model (CT_ChildPref) is located in A.5.3. end note]