DropDownListSelection class

Office 2013 and later

Drop-Down List Selection. When the object is serialized out as xml, its qualified name is w:result.

Namespace:  DocumentFormat.OpenXml.Wordprocessing
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

public class DropDownListSelection : DecimalNumberType

[ISO/IEC 29500-1 1st Edition]

result (Drop-Down List Selection)

This element specifies the zero-based index of the currently selected entry for the parent drop-down list form field.

If this element is omitted, then the current drop-down list form field shall have the selection specified by the value of the default element (§17.16.11). If the attribute value references an index value which does not exist (i.e. a negative number or a number that exceeds the number of items in the drop-down list), then this value can be ignored and the current drop-down list form field shall have the selection specified by the value of the default element.

[Example: Consider the following WordprocessingML fragment for a drop-down list form field:

<w:fldSimple w:instr="FORMDROPDOWN">
  <w:ffData>
    <w:ddList>
      <w:default w:val="1" />
      <w:result w:val="2" />
      <w:listEntry w:val="One" />
      <w:listEntry w:val="Two" />
      <w:listEntry w:val="Three" />
    </w:ddList>
  </w:ffData>
</w:fldSimple>

The result element specifies the index of the currently selected value of the drop-down list form field to be this case, the resulting default value text is Three. end example]

Parent Elements

ddList (§17.16.9)

Attributes

Description

val (Decimal Number Value)

Specifies that the contents of this attribute contains a decimal number.

The contents of this decimal number are interpreted based on the context of the parent XML element.

[Example: Consider the following numeric WordprocessingML property of simple type ST_DecimalNumber:

<… w:val="1512645511" />

The value of the val attribute is a decimal number whose value must be interpreted in the context of the parent element. end example]

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

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

© ISO/IEC29500: 2008.

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