DropDownItemCollection

Eine Sammlung von Zeichenfolgen, die alle Elemente in einem Dropdown-Formularfeld darstellen.

Um mehr zu erfahren, besuchen Sie dieArbeiten mit Feldern Dokumentationsartikel.

public class DropDownItemCollection : IEnumerable<string>

Eigenschaften

NameBeschreibung
Count { get; }Ruft die Anzahl der in der Sammlung enthaltenen Elemente ab.
Item { get; set; }Ruft das Element am angegebenen Index ab oder legt es fest.

Methoden

NameBeschreibung
Add(string)Fügt am Ende der Sammlung eine Zeichenfolge hinzu.
Clear()Entfernt alle Elemente aus der Sammlung.
Contains(string)Bestimmt, ob die Sammlung den angegebenen Wert enthält.
GetEnumerator()Gibt ein Enumeratorobjekt zurück, das zum Durchlaufen aller Elemente in der Sammlung verwendet werden kann.
IndexOf(string)Gibt den nullbasierten Index des angegebenen Werts in der Sammlung zurück.
Insert(int, string)Fügt am angegebenen Index einen String in die Sammlung ein.
Remove(string)Entfernt den angegebenen Wert aus der Sammlung.
RemoveAt(int)Entfernt einen Wert am angegebenen Index.

Beispiele

Zeigt, wie man ein Kombinationsfeldfeld einfügt und die Elemente in seiner Elementsammlung bearbeitet.

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

// Ein Kombinationsfeld einfügen und dann seine Sammlung von Dropdown-Elementen überprüfen.
// In Microsoft Word klickt der Benutzer auf das Kombinationsfeld,
// und wählen Sie dann eines der anzuzeigenden Textelemente in der Sammlung aus.
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"));

// Es gibt zwei Möglichkeiten, ein neues Element zu einer vorhandenen Sammlung von Dropdown-Box-Elementen hinzuzufügen.
// 1 – Ein Element an das Ende der Sammlung anhängen:
dropDownItems.Add("Four");

// 2 – Ein Element vor einem anderen Element an einem angegebenen Index einfügen:
dropDownItems.Insert(3, "Three and a half");

Assert.AreEqual(5, dropDownItems.Count);

// Durch die Sammlung iterieren und jedes Element ausgeben.
using (IEnumerator<string> dropDownCollectionEnumerator = dropDownItems.GetEnumerator())
    while (dropDownCollectionEnumerator.MoveNext())
        Console.WriteLine(dropDownCollectionEnumerator.Current);

// Es gibt zwei Möglichkeiten, Elemente aus einer Sammlung von Dropdown-Elementen zu entfernen.
// 1 – Ein Element entfernen, dessen Inhalt der übergebenen Zeichenfolge entspricht:
dropDownItems.Remove("Four");

// 2 – Ein Element an einem Index entfernen:
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");

// Leeren Sie die gesamte Sammlung von Dropdown-Elementen.
dropDownItems.Clear();

Siehe auch