DropDownListFormField Class

Drop-Down List Form Field Properties.When the object is serialized out as xml, its qualified name is w:ddList.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlCompositeElement
      DocumentFormat.OpenXml.Wordprocessing.DropDownListFormField

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

Syntax

'Declaration
<ChildElementInfoAttribute(GetType(DropDownListSelection))> _
<ChildElementInfoAttribute(GetType(DefaultDropDownListItemIndex))> _
<ChildElementInfoAttribute(GetType(ListEntryFormField))> _
Public Class DropDownListFormField _
    Inherits OpenXmlCompositeElement
'Usage
Dim instance As DropDownListFormField
[ChildElementInfoAttribute(typeof(DropDownListSelection))]
[ChildElementInfoAttribute(typeof(DefaultDropDownListItemIndex))]
[ChildElementInfoAttribute(typeof(ListEntryFormField))]
public class DropDownListFormField : OpenXmlCompositeElement

Remarks

The following table lists the possible child types:

  • DropDownListSelection <w:result>

  • DefaultDropDownListItemIndex <w:default>

  • ListEntryFormField <w:listEntry>

[ISO/IEC 29500-1 1st Edition]

17.16.4 ddList (Drop-Down List Form Field Properties)

This element specifies a set of properties which shall be associated with the parent FORMDROPDOWN drop-down list form field (§17.16.5.21) within the document.

If the parent form field is not a drop-down list (i.e. its field code does not have a value of FORMDROPDOWN), then these properties can be ignored.

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

<w:ffData>
<w:ddList>
<w:listEntry w:val="One" />
<w:listEntry w:val="Two" />
<w:listEntry w:val="Three" />
</w:ddList>
</w:ffData>

The ddList element specifies that it contains a set of properties for the parent drop-down list form field. In this case, these properties specify that the drop-down list must contain three entries of One, Two, and Three via the listEntry elements (§17.16.25). end example]

Parent Elements

ffData (§17.16.17)

Child Elements

Subclause

default (Default Drop-Down List Item Index)

§17.16.11

listEntry (Drop-Down List Entry)

§17.16.25

result (Drop-Down List Selection)

§17.16.28

[Note: The W3C XML Schema definition of this element’s content model (CT_FFDDList) is located in §A.1. 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

DropDownListFormField Members

DocumentFormat.OpenXml.Wordprocessing Namespace