Objeto ContentControl (Word)

Un control de contenido individual. Los controles de contenido son regiones delimitadas y posiblemente con etiquetas de un documento que funcionan como contenedores para tipos específicos de contenido. Los controles de contenido individuales pueden incluir contenido como fechas, listas o párrafos de texto con formato. El objeto ContentControl es miembro de la colección ContentControls .

Comentarios

Use el método Add de la colección ContentControls para crear un control de contenido. Use the Type parameter of the Add method to specify the type of content control to create. The following example create a new drop-down list content control and adds several items to the list.

Dim objCC As ContentControl 
 
Set objCC = ActiveDocument.ContentControls.Add(Type:=wdContentControlDropdownList) 
 
'List entries 
objCC.DropdownListEntries.Add "Cat" 
objCC.DropdownListEntries.Add "Dog" 
objCC.DropdownListEntries.Add "Horse" 
objCC.DropdownListEntries.Add "Monkey" 
objCC.DropdownListEntries.Add "Snake" 
objCC.DropdownListEntries.Add "Other"

Use la propiedad Type para cambiar el control de contenido a otro tipo de control de contenido. Por ejemplo, quizás desee cambiar de un control de fecha a un control de texto. Sin embargo, no podrá cambiar todos los controles de contenido a otro tipo; Algunos podrían no permitir el cambio de tipo. Además, según el contenido de un control de contenido, tal vez no podrá cambiar el tipo. Por ejemplo, si el control de contenido que desea usar no admite el tipo de contenido que está en el control de contenido existente, no se permitirá intentar cambiar el tipo y se generará un error en tiempo de ejecución.

En el siguiente ejemplo, se inserta un control de contenido de fecha y se establece el valor del control. A continuación, se cambia el control a un control de contenido de texto.

Dim objCC As ContentControl 
 
Set objCC = ActiveDocument.ContentControls.Add(wdContentControlDate) 
 
objCC.Range.Text = "January 1, 2007" 
objCC.Type = wdContentControlText

Use el método SetPlaceholderText para cambiar el texto del marcador de posición de la cadena predeterminada a algo más apropiado para el control. Use la propiedad Title para especificar el texto del título del control. Este se mostrará sobre el control cuando el cursor se coloque dentro del control o el puntero del mouse se sitúe sobre el control.

Dependiendo del tipo de control de contenido que tenga, tal vez no podrá usar todas las propiedades y todos los métodos del objeto ContentControl.

No todas las propiedades del control de contenido se aplican a todos los tipos diferentes de controles de contenido. En la siguiente tabla se enumeran qué propiedades se aplican a qué tipos de controles de contenido.

Propiedad o método	Aplicación
BuildingBlockCategory property	BuildingBlock Gallery content controls (wdContentControlBuildingBlockGallery)
BuildingBlockType property	BuildingBlock Gallery content controls (wdContentControlBuildingBlockGallery)
DateDisplayFormat property	Date content controls (wdContentControlDate)
DateDisplayLocale property	Date content controls (wdContentControlDate)
DateStorageFormat property	Date content controls (wdContentControlDate)
DropdownListEntries property	Combo box and drop-down list content controls (wdContentControlComboBox and wdContentControlDropdownList)
MultiLine property	Plain text content controls (wdContentControlText)
Ungroup method	Group content controls (wdContentControlGroup)

Vea también

Referencia de modelos de objetos de Word

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.