ContentControlListEntry Interface

Définition

Espace de noms:

Microsoft.Office.Interop.Word

Assembly:

Microsoft.Office.Interop.Word.dll

Un ContentControlListEntry objet représente un élément de liste dans un contrôle de contenu de liste déroulante ou de zone de liste déroulante. Un ContentControlListEntry objet est membre de la ContentControlListEntries collection d’un ContentControl objet .

public interface class ContentControlListEntry

[System.Runtime.InteropServices.Guid("0C6FA8CA-E65F-4FC7-AB8F-20729EECBB14")]
public interface ContentControlListEntry

type ContentControlListEntry = interface

Public Interface ContentControlListEntry

Attributs

GuidAttribute

Remarques

Utilisez la Add(String, String, Int32) méthode de la ContentControlListEntries collection pour créer un ContentControlListEntry objet . Utilisez la Item[Int32] méthode ou DropdownListEntries(Index), où Index est la position ordinale de l’élément de liste de contrôle de contenu, pour accéder à un élément de liste individuel dans la ContentControlListEntries collection.

Remarque : Les entrées de liste doivent avoir des noms d’affichage uniques. La tentative d'ajout d'un élément de liste qui existe déjà génère une erreur d'exécution.

Utilisez les MoveUp() méthodes et MoveDown() pour repositionner des éléments dans une liste déroulante. Utilisez la Select() méthode pour sélectionner par programmation un élément de liste de contrôle de contenu.

Utilisez la Text propriété pour définir le texte d’affichage d’un élément de liste de contrôle de contenu et utilisez la Value propriété pour définir une valeur programmatique que vous pourrez utiliser ultérieurement pour le traitement d’un formulaire. Par exemple, vous pouvez utiliser une liste déroulante de contrôle de contenu pour obtenir une liste des produits. La Text propriété peut contenir le nom du produit, un nom d’affichage qu’un utilisateur peut facilement reconnaître et comprendre. La Value propriété peut contenir le numéro de produit du produit qui correspond à un numéro de produit dans une base de données. Vous pouvez ensuite utiliser le numéro de produit de la Value propriété pour rechercher des informations sur le produit dans une base de données. En outre, la valeur de la Value propriété est celle qui est envoyée aux données XML personnalisées si le contrôle de contenu est mappé à des données XML dans le magasin de données.

Utilisez la Delete() méthode pour supprimer un élément d’une liste déroulante ou d’une zone de liste déroulante de contrôle de contenu.

Propriétés

Application	Renvoie un _Application objet qui représente l’application Microsoft Word.
Creator	Renvoie un entier 32 bits qui indique l'application dans laquelle le complément a été créé. En lecture seule.
Index	Renvoie ou définit la position ordinale d’un élément de liste de contrôle de contenu dans la collection d’éléments de liste. Lecture-écriture.
Parent	Retourne l’objet parent de l’objet spécifié ContentControlListEntry .
Text	Renvoie ou définit le texte d’affichage d’un élément de liste pour un contrôle de contenu de liste déroulante ou de zone de liste déroulante. Lecture-écriture.
Value	Renvoie ou définit la valeur programmatique d’un élément dans un contrôle de contenu de liste déroulante ou de zone de liste déroulante. Lecture-écriture.

Méthodes

Delete()	Supprime l'élément spécifié dans le contrôle de contenu de zone de liste déroulante ou de liste déroulante.
MoveDown()	Déplace un élément dans un contrôle de contenu de liste déroulante ou de zone de liste déroulante d'un élément vers le bas, afin de le placer après l'élément qui le suivait à l'origine.
MoveUp()	Déplace un élément dans un contrôle de contenu de liste déroulante ou de zone de liste déroulante d'un élément vers le haut, afin de le placer devant l'élément qui le précédait à l'origine.
Select()	Sélectionne l’entrée de liste dans un contrôle de contenu de liste déroulante ou de zone de liste déroulante et définit le texte du contrôle de contenu sur la valeur de l’élément.