DropDownItemCollection

Набор строк, представляющих все элементы в раскрывающемся поле формы.

public class DropDownItemCollection : IEnumerable<string>

Характеристики

Имя Описание
Count { get; } Получает количество элементов, содержащихся в коллекции.
Item { get; set; } Получает или задает элемент по указанному индексу.

Методы

Имя Описание
Add(string) Добавляет строку в конец коллекции.
Clear() Удаляет все элементы из коллекции.
Contains(string) Определяет, содержит ли коллекция указанное значение.
GetEnumerator() Возвращает объект перечислителя, который можно использовать для перебора всех элементов в коллекции.
IndexOf(string) Возвращает отсчитываемый от нуля индекс указанного значения в коллекции.
Insert(int, string) Вставляет строку в коллекцию по указанному индексу.
Remove(string) Удаляет указанное значение из коллекции.
RemoveAt(int) Удаляет значение по указанному индексу.

Примеры

Показывает, как вставить поле со списком и изменить элементы в его коллекции элементов.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Вставьте поле со списком, а затем проверьте его набор раскрывающихся элементов.
// В Microsoft Word пользователь щелкнет поле со списком,
// а затем выберите один из элементов текста в коллекции для отображения.
string[] items = { "One", "Two", "Three" };
FormField comboBoxField = builder.InsertComboBox("DropDown", items, 0);
DropDownItemCollection dropDownItems = comboBoxField.DropDownItems;

Assert.AreEqual(3, dropDownItems.Count);
Assert.AreEqual("One", dropDownItems[0]);
Assert.AreEqual(1, dropDownItems.IndexOf("Two"));
Assert.IsTrue(dropDownItems.Contains("Three"));

// Есть два способа добавления нового элемента в существующую коллекцию элементов раскрывающегося списка.
// 1 - Добавить элемент в конец коллекции:
dropDownItems.Add("Four");

// 2 - Вставить элемент перед другим элементом по указанному индексу:
dropDownItems.Insert(3, "Three and a half");

Assert.AreEqual(5, dropDownItems.Count);

// Перебираем коллекцию и печатаем каждый элемент.
using (IEnumerator<string> dropDownCollectionEnumerator = dropDownItems.GetEnumerator())
    while (dropDownCollectionEnumerator.MoveNext())
        Console.WriteLine(dropDownCollectionEnumerator.Current);

// Существует два способа удаления элементов из набора раскрывающихся элементов.
// 1 - Удалить элемент с содержимым, равным переданной строке:
dropDownItems.Remove("Four");

// 2 - Удалить элемент по индексу:
dropDownItems.RemoveAt(3);

Assert.AreEqual(3, dropDownItems.Count);
Assert.IsFalse(dropDownItems.Contains("Three and a half"));
Assert.IsFalse(dropDownItems.Contains("Four"));

doc.Save(ArtifactsDir + "FormFields.DropDownItemCollection.html");

// Очистить всю коллекцию раскрывающихся элементов.
dropDownItems.Clear();

Смотрите также