ContentControl Interfaz

Definición

Espacio de nombres:

Microsoft.Office.Interop.Word

Ensamblado:

Microsoft.Office.Interop.Word.dll

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 ContentControls colección.

public interface class ContentControl

[System.Runtime.InteropServices.Guid("EE95AFE3-3026-4172-B078-0E79DAB5CC3D")]
public interface ContentControl

type ContentControl = interface

Public Interface ContentControl

Atributos

GuidAttribute

Comentarios

Use el Add(WdContentControlType, Object) método de la ContentControls colección para crear un control de contenido. Use el Type parámetro del método Add para especificar el tipo de control de contenido que se va a crear.

Use la Type propiedad 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.

Use el SetPlaceholderText(BuildingBlock, Range, String) método para cambiar el texto del marcador de posición de la cadena predeterminada a algo más adecuado para el control. Use la Title propiedad 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.

	BuildingBlockCategory Propiedad	Controles de contenido de BuildingBlock Gallery (wdContentControlBuildingBlockGallery)
	BuildingBlockType Propiedad	Controles de contenido de BuildingBlock Gallery (wdContentControlBuildingBlockGallery)
	DateDisplayFormat Propiedad	Controles de contenido de fecha (wdContentControlDate)
	DateDisplayLocale Propiedad	Controles de contenido de fecha (wdContentControlDate)
	DateStorageFormat Propiedad	Controles de contenido de fecha (wdContentControlDate)
	DropdownListEntries Propiedad	Cuadro combinado y controles de contenido de lista desplegable (wdContentControlComboBox y wdContentControlDropdownList)
	MultiLine Propiedad	Controles de contenido de texto sin formato (wdContentControlText)
	Ungroup() Método	Controles de contenido de grupo (wdContentControlGroup)

Propiedades

AllowInsertDeleteSection	Obtiene o establece si los usuarios pueden agregar o quitar secciones del control de contenido de sección repetición especificado mediante la interfaz de usuario.
Appearance	Devuelve o establece la apariencia del control de contenido. Lectura y escritura WdContentControlAppearance
Application	Devuelve un _Application objeto que representa la aplicación microsoft Word.
BuildingBlockCategory	Devuelve o establece la categoría de un control de contenido de bloque de creación. Lectura y escritura.
BuildingBlockType	Devuelve o establece el tipo de bloque de creación de un control de contenido de bloque de creación. Lectura y escritura.
Checked	Obtiene o establece el estado actual (activado o desactivado) de una casilla.
Color	Devuelve o establece el color del control de contenido. Lectura y escritura WdColor.
Creator	Devuelve un entero de 32 bits que indica la aplicación en la que se creó el complemento. Solo lectura.
DateCalendarType	Devuelve o establece el tipo de calendario de un control de contenido de calendario. Lectura y escritura.
DateDisplayFormat	Devuelve o establece el formato en el que se muestran las fechas. Lectura y escritura.
DateDisplayLocale	Devuelve un formato de idioma para la fecha mostrada en un control de contenido de fecha. Lectura y escritura.
DateStorageFormat	Devuelve o establece el formato de almacenamiento y recuperación de fechas en las que un control de contenido de fecha está enlazado al almacén de datos XML del documento activo. Lectura y escritura.
DefaultTextStyle	Devuelve o establece el nombre del estilo de carácter que se va a usar para dar formato al texto en un control de contenido de texto. Lectura y escritura.
DropdownListEntries	Devuelve los elementos de un control de contenido de lista desplegable o en un control de contenido de cuadro combinado. Solo lectura.
ID	Devuelve la identificación de un control de contenido. Solo lectura.
Level	Devuelve el nivel del control de contenido: si el control de contenido rodea texto, párrafos, celdas de tabla o filas de tabla; o si está alineado. De solo WdContentControlLevellectura.
LockContentControl	Devuelve o establece un valor Boolean que indica si el usuario puede eliminar un control de contenido del documento activo. Lectura y escritura.
LockContents	Devuelve o establece un valor Boolean que indica si el usuario puede editar el contenido de un control de contenido. Lectura y escritura.
MultiLine	Devuelve un valor Boolean que indica si un control de contenido de texto permite varias líneas de texto. Lectura y escritura.
Parent	Devuelve un objeto que representa el objeto primario del objeto especificado ContentControl .
ParentContentControl	Devuelve el control de contenido primario de un control de contenido anidado dentro de un control de texto enriquecido o un control de grupo. Solo lectura.
PlaceholderText	Devuelve un BuildingBlock objeto que representa el texto del marcador de posición de un control de contenido. Solo lectura.
Range	Devuelve un Range objeto que representa el contenido del control de contenido del documento activo. Solo lectura.
RepeatingSectionItems	Devuelve la colección de elementos de sección repetición en el control de contenido de sección repetición especificado. Solo lectura.
RepeatingSectionItemTitle	Devuelve o establece el nombre de los elementos de sección repetición usados en el menú contextual asociado al control de contenido de sección repetición especificado. Lectura/escritura.
ShowingPlaceholderText	Devuelve un valor Boolean que indica si se muestra el texto de marcador de posición para el control de contenido. Solo lectura.
Tag	Devuelve o establece un valor para identificar un control de contenido. Lectura/escritura.
Temporary	Devuelve o establece un valor Boolean que representa si se va a quitar un control de contenido del documento activo cuando el usuario edita el contenido del control. Lectura y escritura.
Title	Devuelve o establece el título de un control de contenido. Lectura y escritura.
Type	Devuelve o establece el tipo de un control de contenido. Lectura y escritura.
XMLMapping	Devuelve la asignación de un control de contenido a los datos XML del almacén de datos de un documento. Solo lectura.

Métodos

Copy()	Copia el control de contenido del documento activo en el Portapapeles.
Cut()	Quita el control de contenido del documento activo y lo mueve al Portapapeles.
Delete(Boolean)	Elimina el control de contenido especificado y el contenido de dicho control.
SetCheckedSymbol(Int32, String)	Establece el símbolo utilizado para representar el estado activado del control de contenido de una casilla de verificación.
SetPlaceholderText(BuildingBlock, Range, String)	Establece el texto de marcador de posición que se mostrará en el control de contenido hasta que el usuario escriba su propio texto.
SetUncheckedSymbol(Int32, String)	Establece el símbolo usado para representar el estado desactivado del control de contenido de una casilla de verificación.
Ungroup()	Este método devuelve un control de contenido de grupo de un documento de modo que sus controles de contenido secundarios ya no estén anidados y se pueden modificar libremente.