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
- 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.
Voir aussi
Référence
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