DocumentBase.SelectContentControlsByTitle-Methode

Artikel
08/10/2011

Gibt alle Inhaltssteuerelemente im Dokument zurück, die über den angegebenen Titel verfügen.

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 Function SelectContentControlsByTitle ( _
    title As String _
) As ContentControls

public ContentControls SelectContentControlsByTitle(
    string title
)

Parameter

title
Typ: System.String
Der Titel der zurückzugebenden Inhaltssteuerelemente.

Rückgabewert

Typ: Microsoft.Office.Interop.Word.ContentControls
Eine ContentControls-Auflistung, die die Inhaltssteuerelemente mit dem angegebenen Titel beinhalten.

Beispiele

Im folgenden Codebeispiel werden dem Dokument zwei Absätze hinzugefügt. Anschließend wird jedem neuen Absatz ein Steuerelement hinzugefügt: ein RichTextContentControl und ein ComboBoxContentControl. Im Beispiel werden die Tag- und Titeleigenschaften für jedes Steuerelement festgelegt. Anschließend wird die SelectContentControlsByTitle-Methode aufgerufen, um die Auflistung systemeigener Inhaltssteuerelemente anzuzeigen, deren Titel gleich "Customer Title" ist. Dann wird der Platzhaltertext jedes Steuerelements in der zurückgegebenen Auflistung, die in diesem Fall nur ComboBoxContentControl enthält, geändert. Wenn Sie dieses Beispiel verwenden möchten, führen Sie es von der ThisDocument-Klasse in einem Projekt auf Dokumentebene aus.

Private Sub ContentControlsTitle()
    Dim par1 As Word.Paragraph = Me.Paragraphs.Add()
    Dim richTextControl As Microsoft.Office.Tools.Word.RichTextContentControl _
        = Me.Controls.AddRichTextContentControl(par1.Range, "richTextControl")
    richTextControl.Tag = "Customer"
    richTextControl.Title = "Customer Name"

    Dim par2 As Word.Paragraph = Me.Paragraphs.Add()
    Dim comboBoxControl As Microsoft.Office.Tools.Word.ComboBoxContentControl _
        = Me.Controls.AddComboBoxContentControl(par2.Range, "comboBoxControl")
    comboBoxControl.Tag = "Customer"
    comboBoxControl.Title = "Customer Title"

    Dim myControls As Word.ContentControls = _
        Me.SelectContentControlsByTitle("Customer Title")
    For Each ctrl As Word.ContentControl In myControls
        ctrl.SetPlaceholderText(Text:="Select a title.")
    Next
End Sub

private void ContentControlsTitle()
{                        
    Word.Paragraph par1 = this.Paragraphs.Add(ref missing);
    Microsoft.Office.Tools.Word.RichTextContentControl richTextControl = 
        this.Controls.AddRichTextContentControl(par1.Range, 
        "richTextControl");
    richTextControl.Tag = "Customer";
    richTextControl.Title = "Customer Name";

    Word.Paragraph par2 = this.Paragraphs.Add(ref missing);
    Microsoft.Office.Tools.Word.ComboBoxContentControl comboBoxControl = 
        this.Controls.AddComboBoxContentControl(par2.Range, 
        "comboBoxControl");
    comboBoxControl.Tag = "Customer";
    comboBoxControl.Title = "Customer Title";

    Word.ContentControls myControls = 
        this.SelectContentControlsByTitle("Customer Title");
    foreach (Word.ContentControl ctrl in myControls)
    {                                
        ctrl.SetPlaceholderText(null, null, "Select a 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.

Siehe auch

Referenz

DocumentBase Klasse

Microsoft.Office.Tools.Word-Namespace

Freigeben über