DocumentBase.ContentControls (Propiedad)

Artículo
08/10/2011

Obtiene la colección de todos los controles de contenido que están en el documento.

Espacio de nombres: Microsoft.Office.Tools.Word
Ensamblado: Microsoft.Office.Tools.Word.v4.0.Utilities (en Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Sintaxis

'Declaración
Public ReadOnly Property ContentControls As ContentControls
    Get

public ContentControls ContentControls { get; }

Valor de propiedad

Tipo: Microsoft.Office.Interop.Word.ContentControls
Colección ContentControls con todos los controles de contenido del documento.

Comentarios

Esta propiedad devuelve la colección de controles de contenido nativos del documento (es decir, los objetos Microsoft.Office.Interop.Word.ContentControl del documento).

Para tener acceso a los controles de contenido extendido en el documento, use la propiedad Controls.

Para obtener más información sobre los controles de contenido extendido, vea Controles de contenido.

Ejemplos

En el ejemplo de código siguiente se agrega un control de texto sin formato al primer párrafo y se establece el título de control. A continuación, se recorren en iteración todos los controles de contenido del documento y se muestra un cuadro de mensaje con el tipo y título de cada control de contenido. Para usar este ejemplo, ejecútelo desde la clase ThisDocument en un proyecto de nivel 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);
    }
}

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.