Choose Class

Choose Element.When the object is serialized out as xml, its qualified name is dgm:choose.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlCompositeElement
      DocumentFormat.OpenXml.Drawing.Diagrams.Choose

Namespace:  DocumentFormat.OpenXml.Drawing.Diagrams
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

Syntax

'Declaration
<ChildElementInfoAttribute(GetType(DiagramChooseElse))> _
<ChildElementInfoAttribute(GetType(DiagramChooseIf))> _
Public Class Choose _
    Inherits OpenXmlCompositeElement
'Usage
Dim instance As Choose
[ChildElementInfoAttribute(typeof(DiagramChooseElse))]
[ChildElementInfoAttribute(typeof(DiagramChooseIf))]
public class Choose : OpenXmlCompositeElement

Remarks

The following table lists the possible child types:

  • DiagramChooseIf <dgm:if>

  • DiagramChooseElse <dgm:else>

[ISO/IEC 29500-1 1st Edition]

21.4.2.6 choose (Choose Element)

The choose element wraps if/else blocks into a choose block.

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

<choose name="Name1">
<if name="Name2" func="var" arg="dir" op="equ" val="norm">
<alg type="snake">
<param type="grDir" val="tL"/>
<param type="flowDir" val="row"/>
<param type="contDir" val="sameDir"/>
<param type="off" val="ctr"/>
</alg>
</if>
<else name="Name3">
<alg type="snake">
<param type="grDir" val="tR"/>
<param type="flowDir" val="row"/>
<param type="contDir" val="sameDir"/>
<param type="off" val="ctr"/>
</alg>
</else>
</choose>

In this example, a choose element is used to define two different sets of parameters associated with a snake algorithm depending upon the direction in which the user wants the algorithm to flow (RTL or LTR*). end example*]

Parent Elements

else (§21.4.2.12); forEach (§21.4.2.14); if (§21.4.2.15); layoutNode (§21.4.2.19)

Child Elements

Subclause

else (Else)

§21.4.2.12

if (If)

§21.4.2.15

Attributes

Description

name (Name)

A unique name associated with the choose statement.

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

<choose name="Name1">

</choose>

In this example, the choose element is named Name1. end example]

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

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

© ISO/IEC29500: 2008.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

Choose Members

DocumentFormat.OpenXml.Drawing.Diagrams Namespace