<listEntry> (Drop-Down List Entry)

This element specifies the presence of a single drop-down list entry within the parent drop-down list form field in the document. The order of appearance of the series of <listEntry> elements in the WordprocessingML markup shall dictate the order of the entries in the drop-down list when it is displayed.

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

The three <listEntry> elements each specify one drop-down list entry for the parent drop-down list form field. In this case, these properties specify that the drop-down list shall contain three entries of One, Two, and Three in that order when displayed. ]

Parent Elements

<ddList> (§2.16.9)

Attributes

Description

<val> (String Value)

Specifies that its contents will contain a string.

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

<w:pPr>
  <w:pStyle w:val="heading1" /> 
</w:pPr>

The value of the @val attribute is the ID of the associated paragraph style's styleId.

However, consider the following fragment:

<w:sdtPr>
  <w:alias w:val="SDT Title Example" />
  ...
</w:sdtPr>

In this case, the decimal number in the @val attribute is the caption of the parent structured document tag. In each case, the value is interpreted in the context of the parent element. ]

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

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

<complexType name="CT_String">
	<attribute name="val" type="ST_String" use="required"/>
</complexType>