Método DocumentBase.SelectContentControlsByTitle

Artigo
05/21/2013

Retorna todos os controles de conteúdo no documento que têm o título especificado.

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

Sintaxe

'Declaração
Public Function SelectContentControlsByTitle ( _
    title As String _
) As ContentControls

public ContentControls SelectContentControlsByTitle(
    string title
)

Parâmetros

title
Tipo: System.String
O título do conteúdo para retornar.

Valor de retorno

Tipo: Microsoft.Office.Interop.Word.ContentControls
Uma coleção de ContentControls que contém controles que têm o título especificado.

Exemplos

O exemplo de código a seguir adiciona dois parágrafos para o documento e adicionar um controle para cada novo parágrafo: RichTextContentControl, e ComboBoxContentControl.O exemplo define as propriedades de marca e de título de cada controle.Em seguida, o código chama o método de SelectContentControlsByTitle para obter a coleção de controles de conteúdo de nativo cujo título é igual ao título do cliente.Altera o texto do espaço reservado de cada controle na coleção retornada, que contém somente nesse caso ComboBoxContentControl.Para usar este exemplo, ele execução da classe de ThisDocument em um projeto de um documento nível.

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

DocumentBase Classe

Namespace Microsoft.Office.Tools.Word

Compartilhar via