Exporter (0) Imprimer
Développer tout

DropDownListContentControl, classe (System 2007)

Mise à jour : Juillet 2008

Représente une liste déroulante dans un document.

Espace de noms :  Microsoft.Office.Tools.Word
Assembly :  Microsoft.Office.Tools.Word.v9.0 (dans Microsoft.Office.Tools.Word.v9.0.dll)

[DefaultBindingPropertyAttribute("PlaceholderText")]
[PermissionSetAttribute(SecurityAction.Demand, Name = "FullTrust")]
public sealed class DropDownListContentControl : ContentControlBase, 
	ISupportInitializeControl, ISupportInitialize

Un DropDownListContentControl affiche la liste des éléments que les utilisateurs peuvent sélectionner.

Pour accéder à la liste des éléments dans un DropDownListContentControl, utilisez la propriété DropDownListEntries.

Pour permettre aux utilisateurs de choisir des éléments dans une liste d'éléments ou d'ajouter leur propre texte au contrôle, utilisez un ComboBoxContentControl.

Contrôles de contenu

Le DropDownListContentControl est l'un des huit types de contrôles de contenu que vous pouvez utiliser pour créer des documents et des modèles dans Microsoft Office Word. Les contrôles de contenu ont une interface utilisateur (IU) dont les entrées sont contrôlées comme dans le cas d'un formulaire. Vous pouvez utiliser des contrôles de contenu pour empêcher les utilisateurs de modifier des sections protégées du document ou du modèle et vous pouvez également lier des contrôles de contenu à une source de données. Pour plus d'informations, consultez Contrôles de contenu.

L'exemple de code suivant ajoute un nouveau DropDownListContentControl au début du document. Les utilisateurs peuvent sélectionner le nom d'un jour de la semaine dans le contrôle.

Cette version est destinée à une personnalisation au niveau du document. Pour utiliser ce code, collez-le dans la classe ThisDocument de votre projet, puis appelez la méthode AddDropDownListControlAtSelection à partir de la méthode ThisDocument_Startup.

private Microsoft.Office.Tools.Word.DropDownListContentControl dropDownListControl1;

private void AddDropDownListControlAtSelection()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    this.Paragraphs[1].Range.Select();

    dropDownListControl1 = this.Controls.AddDropDownListContentControl("dropDownListControl1");
    dropDownListControl1.DropDownListEntries.Add("Monday", "Monday", 0);
    dropDownListControl1.DropDownListEntries.Add("Tuesday", "Tuesday", 1);
    dropDownListControl1.DropDownListEntries.Add("Wednesday", "Wednesday", 2);
    dropDownListControl1.PlaceholderText = "Choose a day";
}


Cette version est destinée à un complément d'application. Pour utiliser ce code, collez-le dans la classe ThisAddIn de votre projet, puis appelez la méthode AddDropDownListControlAtSelection à partir de la méthode ThisAddIn_Startup.

private Microsoft.Office.Tools.Word.DropDownListContentControl dropDownListControl1;

private void AddDropDownListControlAtSelection()
{
    if (this.Application.ActiveDocument == null)
        return;

    Document vstoDoc = this.Application.ActiveDocument.GetVstoObject();
    vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
    vstoDoc.Paragraphs[1].Range.Select();

    dropDownListControl1 = vstoDoc.Controls.AddDropDownListContentControl("dropDownListControl1");
    dropDownListControl1.DropDownListEntries.Add("Monday", "Monday", 0);
    dropDownListControl1.DropDownListEntries.Add("Tuesday", "Tuesday", 1);
    dropDownListControl1.DropDownListEntries.Add("Wednesday", "Wednesday", 2);
    dropDownListControl1.PlaceholderText = "Choose a day";
}


Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Date

Historique

Raison

Juillet 2008

Ajout d'une version de l'exemple de code pour un complément d'application.

Modifications de fonctionnalités dans le SP1.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft