Document.Controls-Eigenschaft

Artikel
05/07/2013

Ruft die Auflistung von verwalteten Steuerelementen ab, die im Dokument enthalten sind.

Namespace: Microsoft.Office.Tools.Word
Assemblys: Microsoft.Office.Tools.Word.v4.0.Utilities (in Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Syntax

'Declaration
ReadOnly Property Controls As ControlCollection

ControlCollection Controls { get; }

Eigenschaftswert

Typ: Microsoft.Office.Tools.Word.ControlCollection
Ein ControlCollection-Element, das alle verwalteten Steuerelemente im Dokument enthält.

Hinweise

Ein Dokument in einer Office-Projektmappe kann Windows Forms-Steuerelemente und Hoststeuerelemente enthalten.Weitere Informationen finden Sie unter Steuerelemente für Office-Dokumente.

Um die Steuerelemente in einem Dokument zur Laufzeit zu verwalten, verwenden Sie die Methoden und Eigenschaften des ControlCollection-Objekts, das von der Controls-Eigenschaft zurückgegeben wird.Weitere Informationen hierzu finden Sie unter Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit.

Beispiele

Im folgenden Codebeispiel wird dem ersten Absatz Text hinzugefügt, und anschließend wird ein Bookmark-Steuerelement erstellt, das den Absatz enthält.Im Code wird dann ein Meldungsfeld mit der Gesamtzahl der Steuerelemente im Dokument angezeigt.Dieses Beispiel bezieht sich auf ein Add-In auf Anwendungsebene.

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());
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.