com.aspose.words

Class SdtListItem

  • java.lang.Object
    • com.aspose.words.SdtListItem
  • All Implemented Interfaces:
    java.lang.Cloneable
    public class SdtListItem 
    extends java.lang.Object

This element specifies a single list item within a parent SdtType.COMBO_BOX or SdtType.DROP_DOWN_LIST structured document tag.

Example:

Shows how to work with drop down-list structured document tags.
Document doc = new Document();
StructuredDocumentTag tag = new StructuredDocumentTag(doc, SdtType.DROP_DOWN_LIST, MarkupLevel.BLOCK);
doc.getFirstSection().getBody().appendChild(tag);

// A drop-down list structured document tag is a form that allows the user to
// select an option from a list by left-clicking and opening the form in Microsoft Word.
// The "ListItems" property contains all list items, and each list item is an "SdtListItem".
SdtListItemCollection listItems = tag.getListItems();
listItems.add(new SdtListItem("Value 1"));

Assert.assertEquals(listItems.get(0).getDisplayText(), listItems.get(0).getValue());

// Add 3 more list items. Initialize these items using a different constructor to the first item
// to display strings that are different from their values.
listItems.add(new SdtListItem("Item 2", "Value 2"));
listItems.add(new SdtListItem("Item 3", "Value 3"));
listItems.add(new SdtListItem("Item 4", "Value 4"));

Assert.assertEquals(4, listItems.getCount());

// The drop-down list is displaying the first item. Assign a different list item to the "SelectedValue" to display it.
listItems.setSelectedValue(listItems.get(3));

Assert.assertEquals(listItems.getSelectedValue().getValue(), "Value 4");

// Enumerate over the collection and print each element.
Iterator<SdtListItem> enumerator = listItems.iterator();
while (enumerator.hasNext()) {
    SdtListItem sdtListItem = enumerator.next();
    System.out.println(MessageFormat.format("List item: {0}, value: {1}", sdtListItem.getDisplayText(), sdtListItem.getValue()));
}

// Remove the last list item. 
listItems.removeAt(3);

Assert.assertEquals(3, listItems.getCount());

// Since our drop-down control is set to display the removed item by default, give it an item to display which exists.
listItems.setSelectedValue(listItems.get(1));

doc.save(getArtifactsDir() + "StructuredDocumentTag.ListItemCollection.docx");

// Use the "Clear" method to empty the entire drop-down item collection at once.
listItems.clear();

Assert.assertEquals(0, listItems.getCount());

Constructor Summary
SdtListItem(java.lang.StringdisplayText, java.lang.Stringvalue)
Initializes a new instance of this class.
SdtListItem(java.lang.Stringvalue)
Initializes a new instance of this class.
 
Property Getters/Setters Summary
java.lang.StringgetDisplayText()
Gets the text to display in the run content in place of the Value attribute contents for this list item.
java.lang.StringgetValue()
Gets the value of this list item.
 

    • Constructor Detail

      • SdtListItem

        public SdtListItem(java.lang.String displayText, java.lang.String value)
        Initializes a new instance of this class.

        Example:

        Shows how to work with drop down-list structured document tags.
        Document doc = new Document();
        StructuredDocumentTag tag = new StructuredDocumentTag(doc, SdtType.DROP_DOWN_LIST, MarkupLevel.BLOCK);
        doc.getFirstSection().getBody().appendChild(tag);
        
        // A drop-down list structured document tag is a form that allows the user to
        // select an option from a list by left-clicking and opening the form in Microsoft Word.
        // The "ListItems" property contains all list items, and each list item is an "SdtListItem".
        SdtListItemCollection listItems = tag.getListItems();
        listItems.add(new SdtListItem("Value 1"));
        
        Assert.assertEquals(listItems.get(0).getDisplayText(), listItems.get(0).getValue());
        
        // Add 3 more list items. Initialize these items using a different constructor to the first item
        // to display strings that are different from their values.
        listItems.add(new SdtListItem("Item 2", "Value 2"));
        listItems.add(new SdtListItem("Item 3", "Value 3"));
        listItems.add(new SdtListItem("Item 4", "Value 4"));
        
        Assert.assertEquals(4, listItems.getCount());
        
        // The drop-down list is displaying the first item. Assign a different list item to the "SelectedValue" to display it.
        listItems.setSelectedValue(listItems.get(3));
        
        Assert.assertEquals(listItems.getSelectedValue().getValue(), "Value 4");
        
        // Enumerate over the collection and print each element.
        Iterator<SdtListItem> enumerator = listItems.iterator();
        while (enumerator.hasNext()) {
            SdtListItem sdtListItem = enumerator.next();
            System.out.println(MessageFormat.format("List item: {0}, value: {1}", sdtListItem.getDisplayText(), sdtListItem.getValue()));
        }
        
        // Remove the last list item. 
        listItems.removeAt(3);
        
        Assert.assertEquals(3, listItems.getCount());
        
        // Since our drop-down control is set to display the removed item by default, give it an item to display which exists.
        listItems.setSelectedValue(listItems.get(1));
        
        doc.save(getArtifactsDir() + "StructuredDocumentTag.ListItemCollection.docx");
        
        // Use the "Clear" method to empty the entire drop-down item collection at once.
        listItems.clear();
        
        Assert.assertEquals(0, listItems.getCount());
      • SdtListItem

        public SdtListItem(java.lang.String value)
        Initializes a new instance of this class.

        Example:

        Shows how to work with drop down-list structured document tags.
        Document doc = new Document();
        StructuredDocumentTag tag = new StructuredDocumentTag(doc, SdtType.DROP_DOWN_LIST, MarkupLevel.BLOCK);
        doc.getFirstSection().getBody().appendChild(tag);
        
        // A drop-down list structured document tag is a form that allows the user to
        // select an option from a list by left-clicking and opening the form in Microsoft Word.
        // The "ListItems" property contains all list items, and each list item is an "SdtListItem".
        SdtListItemCollection listItems = tag.getListItems();
        listItems.add(new SdtListItem("Value 1"));
        
        Assert.assertEquals(listItems.get(0).getDisplayText(), listItems.get(0).getValue());
        
        // Add 3 more list items. Initialize these items using a different constructor to the first item
        // to display strings that are different from their values.
        listItems.add(new SdtListItem("Item 2", "Value 2"));
        listItems.add(new SdtListItem("Item 3", "Value 3"));
        listItems.add(new SdtListItem("Item 4", "Value 4"));
        
        Assert.assertEquals(4, listItems.getCount());
        
        // The drop-down list is displaying the first item. Assign a different list item to the "SelectedValue" to display it.
        listItems.setSelectedValue(listItems.get(3));
        
        Assert.assertEquals(listItems.getSelectedValue().getValue(), "Value 4");
        
        // Enumerate over the collection and print each element.
        Iterator<SdtListItem> enumerator = listItems.iterator();
        while (enumerator.hasNext()) {
            SdtListItem sdtListItem = enumerator.next();
            System.out.println(MessageFormat.format("List item: {0}, value: {1}", sdtListItem.getDisplayText(), sdtListItem.getValue()));
        }
        
        // Remove the last list item. 
        listItems.removeAt(3);
        
        Assert.assertEquals(3, listItems.getCount());
        
        // Since our drop-down control is set to display the removed item by default, give it an item to display which exists.
        listItems.setSelectedValue(listItems.get(1));
        
        doc.save(getArtifactsDir() + "StructuredDocumentTag.ListItemCollection.docx");
        
        // Use the "Clear" method to empty the entire drop-down item collection at once.
        listItems.clear();
        
        Assert.assertEquals(0, listItems.getCount());
    • Property Getters/Setters Detail

      • getDisplayText

        public java.lang.String getDisplayText()
        
        Gets the text to display in the run content in place of the Value attribute contents for this list item.

        Cannot be null and cannot be an empty string.

        Example:

        Shows how to work with drop down-list structured document tags.
        Document doc = new Document();
        StructuredDocumentTag tag = new StructuredDocumentTag(doc, SdtType.DROP_DOWN_LIST, MarkupLevel.BLOCK);
        doc.getFirstSection().getBody().appendChild(tag);
        
        // A drop-down list structured document tag is a form that allows the user to
        // select an option from a list by left-clicking and opening the form in Microsoft Word.
        // The "ListItems" property contains all list items, and each list item is an "SdtListItem".
        SdtListItemCollection listItems = tag.getListItems();
        listItems.add(new SdtListItem("Value 1"));
        
        Assert.assertEquals(listItems.get(0).getDisplayText(), listItems.get(0).getValue());
        
        // Add 3 more list items. Initialize these items using a different constructor to the first item
        // to display strings that are different from their values.
        listItems.add(new SdtListItem("Item 2", "Value 2"));
        listItems.add(new SdtListItem("Item 3", "Value 3"));
        listItems.add(new SdtListItem("Item 4", "Value 4"));
        
        Assert.assertEquals(4, listItems.getCount());
        
        // The drop-down list is displaying the first item. Assign a different list item to the "SelectedValue" to display it.
        listItems.setSelectedValue(listItems.get(3));
        
        Assert.assertEquals(listItems.getSelectedValue().getValue(), "Value 4");
        
        // Enumerate over the collection and print each element.
        Iterator<SdtListItem> enumerator = listItems.iterator();
        while (enumerator.hasNext()) {
            SdtListItem sdtListItem = enumerator.next();
            System.out.println(MessageFormat.format("List item: {0}, value: {1}", sdtListItem.getDisplayText(), sdtListItem.getValue()));
        }
        
        // Remove the last list item. 
        listItems.removeAt(3);
        
        Assert.assertEquals(3, listItems.getCount());
        
        // Since our drop-down control is set to display the removed item by default, give it an item to display which exists.
        listItems.setSelectedValue(listItems.get(1));
        
        doc.save(getArtifactsDir() + "StructuredDocumentTag.ListItemCollection.docx");
        
        // Use the "Clear" method to empty the entire drop-down item collection at once.
        listItems.clear();
        
        Assert.assertEquals(0, listItems.getCount());
      • getValue

        public java.lang.String getValue()
        
        Gets the value of this list item.

        Cannot be null and cannot be an empty string.

        Example:

        Shows how to work with drop down-list structured document tags.
        Document doc = new Document();
        StructuredDocumentTag tag = new StructuredDocumentTag(doc, SdtType.DROP_DOWN_LIST, MarkupLevel.BLOCK);
        doc.getFirstSection().getBody().appendChild(tag);
        
        // A drop-down list structured document tag is a form that allows the user to
        // select an option from a list by left-clicking and opening the form in Microsoft Word.
        // The "ListItems" property contains all list items, and each list item is an "SdtListItem".
        SdtListItemCollection listItems = tag.getListItems();
        listItems.add(new SdtListItem("Value 1"));
        
        Assert.assertEquals(listItems.get(0).getDisplayText(), listItems.get(0).getValue());
        
        // Add 3 more list items. Initialize these items using a different constructor to the first item
        // to display strings that are different from their values.
        listItems.add(new SdtListItem("Item 2", "Value 2"));
        listItems.add(new SdtListItem("Item 3", "Value 3"));
        listItems.add(new SdtListItem("Item 4", "Value 4"));
        
        Assert.assertEquals(4, listItems.getCount());
        
        // The drop-down list is displaying the first item. Assign a different list item to the "SelectedValue" to display it.
        listItems.setSelectedValue(listItems.get(3));
        
        Assert.assertEquals(listItems.getSelectedValue().getValue(), "Value 4");
        
        // Enumerate over the collection and print each element.
        Iterator<SdtListItem> enumerator = listItems.iterator();
        while (enumerator.hasNext()) {
            SdtListItem sdtListItem = enumerator.next();
            System.out.println(MessageFormat.format("List item: {0}, value: {1}", sdtListItem.getDisplayText(), sdtListItem.getValue()));
        }
        
        // Remove the last list item. 
        listItems.removeAt(3);
        
        Assert.assertEquals(3, listItems.getCount());
        
        // Since our drop-down control is set to display the removed item by default, give it an item to display which exists.
        listItems.setSelectedValue(listItems.get(1));
        
        doc.save(getArtifactsDir() + "StructuredDocumentTag.ListItemCollection.docx");
        
        // Use the "Clear" method to empty the entire drop-down item collection at once.
        listItems.clear();
        
        Assert.assertEquals(0, listItems.getCount());