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 des champs article documentaire.

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ère une zone de liste déroulante, puis vérifie sa collection d'éléments déroulants.
// Dans Microsoft Word, l'utilisateur cliquera sur la combo,
// 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ère un élément avant un autre élément à un index spécifié :
dropDownItems.Insert(3, "Three and a half");

Assert.AreEqual(5, dropDownItems.Count);

// Parcourez la collection et imprimez 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 - Supprime 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");

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

Voir également

ComparisonExpression Class Field Class