DocumentBase.Controls, propriété

Article
01/06/2014

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

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

Syntaxe

'Déclaration
Public ReadOnly Property Controls As ControlCollection

public 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.

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. Pour utiliser cet exemple, exécutez-le à partir de la classe ThisDocument dans un projet au niveau du document.

Private Sub DocumentControls()
    Me.Paragraphs(1).Range.InsertParagraphAfter()
    Me.Paragraphs(1).Range.Text = "This is some sample text."
    Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")
    MessageBox.Show("Total number of controls: " & Me.Controls.Count.ToString())
End Sub

private void DocumentControls()
{
    this.Paragraphs[1].Range.InsertParagraphAfter();
    this.Paragraphs[1].Range.Text = "This is some sample text.";
    this.Controls.AddBookmark(this.Paragraphs[1].Range, "Bookmark1");
    MessageBox.Show("Total number of controls: " +
        this.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.