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();

也可以看看