java.lang.Objectcom.aspose.words.SdtListItem
public class SdtListItem
Example:
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.String displayText, java.lang.String value)
Initializes a new instance of this class. |
SdtListItem(java.lang.String value)
Initializes a new instance of this class. |
Property Getters/Setters Summary | ||
---|---|---|
java.lang.String | getDisplayText() | |
Gets the text to display in the run content in place of the |
||
java.lang.String | getValue() | |
Gets the value of this list item. |
Constructor Detail |
---|
public SdtListItem(java.lang.String displayText, java.lang.String value)
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());
public SdtListItem(java.lang.String value)
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() |
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() |
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());