DocumentBase.ContentControls-Eigenschaft

Artikel
08/10/2011

Ruft die Auflistung aller Inhaltssteuerelemente ab, die sich im Dokument befinden.

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 ContentControls As ContentControls
    Get

public ContentControls ContentControls { get; }

Eigenschaftswert

Typ: Microsoft.Office.Interop.Word.ContentControls
Eine ContentControls-Auflistung, die alle Inhaltssteuerelemente im Dokument beinhaltet.

Hinweise

Von dieser Eigenschaft wird die Auflistung systemeigener Inhaltssteuerelemente im Dokument zurückgegeben (d. h. die Microsoft.Office.Interop.Word.ContentControl-Objekte im Dokument).

Verwenden Sie zum Zugreifen auf die erweiterten Inhaltssteuerelemente im Dokument die Controls-Eigenschaft.

Weitere Informationen über erweiterte Inhaltssteuerelemente finden Sie unter Inhaltssteuerelemente.

Beispiele

Im folgenden Codebeispiel wird dem ersten Absatz ein Nur-Text-Steuerelement hinzugefügt, und das Steuerelement wird benannt. Dann werden alle Inhaltssteuerelemente des Dokuments durchlaufen, und es wird ein Meldungsfeld mit dem Typ und Titel jedes Inhaltssteuerelements anzeigt. Wenn Sie dieses Beispiel verwenden möchten, führen Sie es von der ThisDocument-Klasse in einem Projekt auf Dokumentebene aus.

Private Sub IterateContentControls()
    Dim textControl1 As Word.ContentControl = _
        Me.ContentControls.Add( _
            Word.WdContentControlType.wdContentControlText, _
            Me.Paragraphs(1).Range)
    textControl1.Title = "First Name"

    For Each cc As Word.ContentControl In Me.ContentControls
        MessageBox.Show("Content control type: " + cc.Type.ToString() _
                        + ", title: " + cc.Title)
    Next
End Sub

private void IterateContentControls()
{
    object _range = this.Paragraphs[1].Range;
    Word.ContentControl textControl1 = this.ContentControls.Add(
            Word.WdContentControlType.wdContentControlText,
            ref _range);
    textControl1.Title = "First Name";

    foreach (Word.ContentControl cc in this.ContentControls)
    {
        MessageBox.Show("Content control  type: " 
            + cc.Type.ToString() + ", title: " + cc.Title);
    }
}

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