Document.Controls, propriété

Article
08/10/2011

Obtient la collection de contrôles managés contenus sur le document.

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

Syntaxe

'Déclaration
ReadOnly Property Controls As ControlCollection
    Get

ControlCollection Controls { get; }

Valeur de propriété

Type : Microsoft.Office.Tools.Word.ControlCollection
ControlCollection qui contient tous les contrôles managés sur le document.

Notes

Un document dans une solution Office peut contenir des contrôles Windows Forms et des contrôles hôtes. Pour plus d'informations, consultez Contrôles sur des documents Office.

Pour gérer les contrôles sur un document au moment de l'exécution, utilisez les méthodes et propriétés de l'objet ControlCollection retournées par la propriété Controls. Pour plus d'informations, consultez Ajout de contrôles à des documents Office au moment de l'exécution.

Exemples

L'exemple de code suivant ajoute du texte au premier paragraphe et crée un contrôle Bookmark qui englobe le paragraphe. Le code affiche ensuite un message qui indique le nombre total de contrôles dans le document. Cet exemple est pour un complément d'application.

Private Sub DocumentControls()
    Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
    vstoDoc.Paragraphs(1).Range.InsertParagraphAfter()
    vstoDoc.Paragraphs(1).Range.Text = "This is some sample text."
    vstoDoc.Controls.AddBookmark(vstoDoc.Paragraphs(1).Range, "Bookmark1")
    System.Windows.Forms.MessageBox.Show("Total number of controls: " & _
                                         vstoDoc.Controls.Count.ToString())
End Sub

private void DocumentControls()
{
    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    vstoDoc.Paragraphs[1].Range.InsertParagraphAfter();
    vstoDoc.Paragraphs[1].Range.Text = "This is some sample text.";
    vstoDoc.Controls.AddBookmark(vstoDoc.Paragraphs[1].Range, "Bookmark1");
    System.Windows.Forms.MessageBox.Show("Total number of controls: " +
        vstoDoc.Controls.Count.ToString());
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.