DocumentBase.Controls-Eigenschaft

Artikel
05/07/2013

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.