DocumentBase.Controls-Eigenschaft

Artikel
01/03/2014

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

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

Syntax

'Declaration
Public ReadOnly Property Controls As ControlCollection

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

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. Wenn Sie dieses Beispiel verwenden möchten, führen Sie es von der ThisDocument-Klasse in einem Projekt auf Dokumentebene aus.

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

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