DropDownItemCollection

Une collection de chaînes qui représentent tous les éléments d’un champ de formulaire déroulant.

Pour en savoir plus, visitez leTravailler avec les champs article de documentation.

public class DropDownItemCollection : IEnumerable<string>

Propriétés

NomLa description
Count { get; }Obtient le nombre d’éléments contenus dans la collection.
Item { get; set; }Obtient ou définit l’élément à l’index spécifié.

Méthodes

NomLa description
Add(string)Ajoute une chaîne à la fin de la collection.
Clear()Supprime tous les éléments de la collection.
Contains(string)Détermine si la collection contient la valeur spécifiée.
GetEnumerator()Renvoie un objet énumérateur qui peut être utilisé pour parcourir tous les éléments de la collection.
IndexOf(string)Renvoie l’index de base zéro de la valeur spécifiée dans la collection.
Insert(int, string)Insère une chaîne dans la collection à l’index spécifié.
Remove(string)Supprime la valeur spécifiée de la collection.
RemoveAt(int)Supprime une valeur à l’index spécifié.

Exemples

Montre comment insérer un champ de zone de liste déroulante et modifier les éléments de sa collection d’éléments.

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

// Insérez une zone de liste déroulante, puis vérifiez sa collection d'éléments déroulants.
// Dans Microsoft Word, l'utilisateur cliquera sur la zone de liste déroulante,
// puis choisissez l'un des éléments de texte de la collection à afficher.
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"));

// Il existe deux manières d'ajouter un nouvel élément à une collection existante d'éléments de liste déroulante.
// 1 - Ajouter un élément à la fin de la collection :
dropDownItems.Add("Four");

// 2 - Insérer un élément avant un autre élément à un index spécifié :
dropDownItems.Insert(3, "Three and a half");

Assert.AreEqual(5, dropDownItems.Count);

// Itérer sur la collection et imprimer chaque élément.
using (IEnumerator<string> dropDownCollectionEnumerator = dropDownItems.GetEnumerator())
    while (dropDownCollectionEnumerator.MoveNext())
        Console.WriteLine(dropDownCollectionEnumerator.Current);

// Il existe deux manières de supprimer des éléments d'une collection d'éléments déroulants.
// 1 - Supprime un élément dont le contenu est égal à la chaîne passée :
dropDownItems.Remove("Four");

// 2 - Supprimer un élément à un index :
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");

// Vider toute la collection d'éléments déroulants.
dropDownItems.Clear();

Voir également

ComparisonExpression Class Field Class