ComboBoxContentControl Interface

Référence

Définition

Espace de noms:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente une zone de liste modifiable d’un document.

public interface class ComboBoxContentControl : IDisposable, Microsoft::Office::Tools::Word::ContentControlBase, System::ComponentModel::IComponent, System::ComponentModel::ISupportInitialize, System::Windows::Forms::IBindableComponent

[System.Runtime.InteropServices.Guid("fff2d316-e224-4cd9-a10c-3edf95689a6d")]
public interface ComboBoxContentControl : IDisposable, Microsoft.Office.Tools.Word.ContentControlBase, System.ComponentModel.IComponent, System.ComponentModel.ISupportInitialize, System.Windows.Forms.IBindableComponent

[<System.Runtime.InteropServices.Guid("fff2d316-e224-4cd9-a10c-3edf95689a6d")>]
type ComboBoxContentControl = interface
    interface ContentControlBase
    interface IBindableComponent
    interface IComponent
    interface IDisposable
    interface ISupportInitialize

Public Interface ComboBoxContentControl
Implements ContentControlBase, IBindableComponent, IComponent, IDisposable, ISupportInitialize

Attributs: GuidAttribute

Implémente: ContentControlBase IComponent ISupportInitialize IDisposable IBindableComponent

Exemples

L’exemple de code suivant ajoute un nouveau ComboBoxContentControl au début du document. Les utilisateurs peuvent sélectionner un nom de couleur affiché par le contrôle ou taper le nom d’une nouvelle couleur.

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

private Microsoft.Office.Tools.Word.ComboBoxContentControl comboBoxControl1;

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

    comboBoxControl1 = this.Controls.AddComboBoxContentControl("comboBoxControl1");
    comboBoxControl1.DropDownListEntries.Add("Red", "Red", 0);
    comboBoxControl1.DropDownListEntries.Add("Green", "Green", 1);
    comboBoxControl1.DropDownListEntries.Add("Blue", "Blue", 2);
    comboBoxControl1.PlaceholderText = "Choose a color, or enter your own";
}

Dim comboBoxControl1 As Microsoft.Office.Tools.Word.ComboBoxContentControl

Private Sub AddComboBoxControlAtSelection()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.Select()
    comboBoxControl1 = Me.Controls.AddComboBoxContentControl("comboBoxControl1")
    With comboBoxControl1
        .DropDownListEntries.Add("Red", "Red", 0)
        .DropDownListEntries.Add("Green", "Green", 1)
        .DropDownListEntries.Add("Blue", "Blue", 2)
        .PlaceholderText = "Choose a color, or enter your own"
    End With
End Sub

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

private Microsoft.Office.Tools.Word.ComboBoxContentControl comboBoxControl1;

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

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

    comboBoxControl1 = vstoDoc.Controls.AddComboBoxContentControl(
        "comboBoxControl1");
    comboBoxControl1.DropDownListEntries.Add("Red", "Red", 0);
    comboBoxControl1.DropDownListEntries.Add("Green", "Green", 1);
    comboBoxControl1.DropDownListEntries.Add("Blue", "Blue", 2);
    comboBoxControl1.PlaceholderText = "Choose a color, or enter your own";            
}

Dim comboBoxControl1 As Microsoft.Office.Tools.Word.ComboBoxContentControl

Private Sub AddComboBoxControlAtSelection()
    If Me.Application.ActiveDocument Is Nothing Then
        Return
    End If

    Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
    vstoDoc.Paragraphs(1).Range.InsertParagraphBefore()
    vstoDoc.Paragraphs(1).Range.Select()
    comboBoxControl1 = vstoDoc.Controls.AddComboBoxContentControl("comboBoxControl1")
    With comboBoxControl1
        .DropDownListEntries.Add("Red", "Red", 0)
        .DropDownListEntries.Add("Green", "Green", 1)
        .DropDownListEntries.Add("Blue", "Blue", 2)
        .PlaceholderText = "Choose a color, or enter your own"
    End With
End Sub

Remarques

ComboBoxContentControl Une zone de liste modifiable affiche une liste d'éléments que les utilisateurs peuvent sélectionner. Les utilisateurs peuvent également taper leur propre texte dans un ComboBoxContentControl.

Pour afficher une liste déroulante d’éléments dans une zone de texte que les utilisateurs ne peuvent pas modifier, utilisez un DropDownListContentControl.

Pour accéder à la liste des éléments d’un ComboBoxContentControl, utilisez la DropDownListEntries propriété .

Notes

Cette interface est implémentée par Visual Studio Tools pour Office Runtime. Elle n'est pas destinée à être implémentée dans votre code. Pour plus d'informations, consultez Visual Studio Tools for Office Runtime Overview.

Contrôles de contenu

Le ComboBoxContentControl est l’un des huit types de contrôles de contenu que vous pouvez utiliser pour concevoir des documents et des modèles dans Microsoft Office Word. Les contrôles de contenu ont une interface utilisateur (IU) qui a une entrée contrôlée comme 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 Content Controls.

Utilisation

Cette documentation décrit la version de ce type utilisée dans les projets Office qui ciblent le .NET Framework 4 ou ultérieur. Dans les projets qui ciblent .NET Framework 3.5, ce type peut contenir d'autres membres, et les exemples de code qui y figurent sont susceptibles de ne pas fonctionner. Pour obtenir de la documentation sur ce type dans les projets ciblant .NET Framework 3.5, consultez la section de référence suivante dans la documentation Visual Studio 2008 : http://go.microsoft.com/fwlink/?LinkId=160658.

Propriétés

Application	Obtient une Application qui représente l'instance actuelle de Microsoft Office Word.
Container	Représente une zone de liste modifiable d’un document. (Hérité de ContentControlBase)
ContainerComponent	Représente une zone de liste modifiable d’un document. (Hérité de ContentControlBase)
Creator	Obtient un entier 32 bits qui indique l'application dans laquelle le ComboBoxContentControl a été créé.
DefaultDataSourceUpdateMode	Obtient ou définit la valeur DataSourceUpdateMode par défaut de ContentControlBase. (Hérité de ContentControlBase)
DefaultTextStyle	Obtient le nom du style de caractère utilisé pour mettre en forme le texte dans ComboBoxContentControl.
DropDownListEntries	Obtient la collection des éléments affichés par le ComboBoxContentControl.
ID	Obtient un nombre unique qui identifie le contrôle de contenu. (Hérité de ContentControlBase)
InnerObject	Obtient l’objet ContentControl sous-jacent pour le ContentControlBase. (Hérité de ContentControlBase)
LockContentControl	Obtient ou définit une valeur qui indique si le ComboBoxContentControl peut être supprimé du document.
LockContents	Obtient ou définit une valeur qui indique si le contenu du ComboBoxContentControl peut être modifié.
MultiLine	Obtient ou définit une valeur qui spécifie si le ComboBoxContentControl peut contenir des sauts de ligne.
Parent	Obtient le parent du ComboBoxContentControl.
ParentContentControl	Obtient le contrôle de contenu parent d'un ComboBoxContentControl imbriqué dans un autre contrôle de contenu.
PlaceholderText	Obtient ou définit le texte affiché dans le ComboBoxContentControl jusqu'à ce que le texte soit modifié par une action utilisateur ou une autre opération.
Range	Obtient une Range qui représente le contenu du ComboBoxContentControl.
ShowingPlaceholderText	Obtient une valeur qui indique si le ComboBoxContentControl affiche actuellement le texte de l'espace réservé.
Tag	Obtient ou définit une chaîne à associer au ComboBoxContentControl.
Temporary	Obtient ou définit une valeur qui spécifie si le ComboBoxContentControl est supprimé automatiquement du document lorsque le contrôle est modifié.
Text	Obtient ou définit le texte dans le ComboBoxContentControl.
Title	Obtient ou définit le titre de la ComboBoxContentControl.
XMLMapping	Obtient un XMLMapping qui représente la liaison entre le ComboBoxContentControl et un élément d’une partie XML personnalisée.

Méthodes

Copy()	Copie le ComboBoxContentControl du document vers le Presse-papiers.
Cut()	Supprime le ComboBoxContentControl du document et l'ajoute au Presse-papiers.
Delete(Boolean)	Supprime un contrôle de contenu créé dynamiquement dans le document et le supprime de la ControlCollection contenue dans le document. (Hérité de ContentControlBase)
SetPlaceholderText(BuildingBlock, Range, String)	Affiche le texte qui se trouve dans un T :Microsoft.Office.Interop. Word. BuildingBlock, ou Rangeune chaîne en tant que texte d’espace réservé dans le ComboBoxContentControl.

Événements

Added	Se produit après l'ajout du contrôle de contenu au document. (Hérité de ContentControlBase)
BindingContextChanged	Se produit lorsque la valeur de la propriété BindingContext de ContentControlBase est modifiée. (Hérité de ContentControlBase)
ContentUpdating	Se produit juste avant que Microsoft Office Word mette à jour le texte dans le contrôle de contenu, si ce dernier est lié à une partie XML personnalisée. (Hérité de ContentControlBase)
Deleting	Se produit juste avant que le contrôle de contenu soit supprimé du document. (Hérité de ContentControlBase)
Entering	Se produit lorsque l'utilisateur clique dans le contrôle de contenu ou lorsque le curseur est amené par programme dans le contrôle de contenu. (Hérité de ContentControlBase)
Exiting	Se produit lorsque l'utilisateur clique en dehors du contrôle de contenu, ou lorsque le curseur quitte le contrôle de contenu par programme. (Hérité de ContentControlBase)
StoreUpdating	Se produit juste avant que Microsoft Office Word ne mette à jour les données dans une partie XML personnalisée liée au contrôle de contenu (autrement dit, après que le texte du contrôle de contenu a été modifié). (Hérité de ContentControlBase)
Validated	Se produit lorsque le contrôle de contenu a été validé. (Hérité de ContentControlBase)
Validating	Se produit lorsque le contenu du contrôle est validé. (Hérité de ContentControlBase)

S’applique à

Partager via