Propriedade DocumentBase.ContentControls

Artigo
05/21/2013

Obtém a coleção de todos os controles de conteúdo no documento.

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 ReadOnly Property ContentControls As ContentControls

public ContentControls ContentControls { get; }

Valor de propriedade

Tipo: Microsoft.Office.Interop.Word.ContentControls
Uma coleção de ContentControls que contém todos os controles de conteúdo no documento.

Comentários

Essa propriedade retorna a coleção de controles de conteúdo de nativo no documento (isto é, Microsoft.Office.Interop.Word.ContentControl objetos no documento).

Para acessar os controles estendidos de conteúdo no documento, use a propriedade de Controls .

Para obter mais informações sobre controles de conteúdo estendidos, consulte Controles de conteúdo.

Exemplos

O exemplo de código a seguir adiciona um controle de texto sem formatação para o primeiro parágrafo e define o título do controle.O código então itera por todos os controles de conteúdo no documento e mostra uma caixa de mensagem que exibe o tipo e o título de cada controle de conteúdo.Para usar este exemplo, ele execução da classe de ThisDocument em um projeto de um documento nível.

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

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.