Partager via


Document.Controls, propriété

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

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

Syntaxe

'Déclaration
ReadOnly Property Controls As ControlCollection
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

Voir aussi

Référence

Document Interface

Microsoft.Office.Tools.Word, espace de noms

Autres ressources

Contrôles sur des documents Office

Ajout de contrôles à des documents Office au moment de l'exécution