Método DocumentBase.SelectContentControlsByTitle

Artigo
08/01/2011

Retorna todos os controles de conteúdo do documento que possuem 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 dos controles de conteúdo para retornar.

Valor de retorno

Tipo: Microsoft.Office.Interop.Word.ContentControls
A ContentControls coleção que contém os controles de conteúdo que possuem o título especificado.

Exemplos

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

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

Partilhar via