Propriedade DocumentBase.ContentControls

Artigo
08/01/2011

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
    Get

public ContentControls ContentControls { get; }

Valor de propriedade

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

Comentários

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

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

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 ao primeiro parágrafo e define o título do controle. O código então percorre todos os controles de conteúdo no documento e mostra uma caixa de mensagem exibe o tipo e o título de cada controle de conteúdo. Para usar esse exemplo, executá-lo do ThisDocument a classe em um projeto de nível de documento.

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.