DocumentBase.SelectContentControlsByTitle – metoda

Článek
05/14/2013

Vrátí všechny ovládací prvky obsahu v dokumentu, který jste zadaným názvem.

Obor názvů: Microsoft.Office.Tools.Word
Sestavení: Microsoft.Office.Tools.Word.v4.0.Utilities (v Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Syntaxe

'Deklarace
Public Function SelectContentControlsByTitle ( _
    title As String _
) As ContentControls

public ContentControls SelectContentControlsByTitle(
    string title
)

Parametry

title
Typ: System.String
Název ovládací prvky obsahu pro vrácení.

Vrácená hodnota

Typ: Microsoft.Office.Interop.Word.ContentControls
A ContentControls kolekci, která obsahuje ovládací prvky obsahu, které mají zadaný název.

Příklady

Následující příklad kódu přidá dva odstavce v dokumentu a potom přidá jeden ovládací prvek pro každý nový odstavec: RichTextContentControla ComboBoxContentControl.V příkladu nastaví vlastnosti značky a název každého ovládacího prvku.Dále kód volá SelectContentControlsByTitle metodu pro získání kolekce nativní obsah ovládacích prvků, jehož název odpovídá název zákazníka.Poté upraví zástupný text každého ovládacího prvku ve vrácené kolekci, která v tomto případě obsahuje pouze ComboBoxContentControl.Chcete-li použít tento příklad, spusťte jej z ThisDocument třídy v projektu na úrovni dokumentu.

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.");                
    }
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

DocumentBase Třída

Microsoft.Office.Tools.Word – obor názvů

Sdílet prostřednictvím