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

也可以看看