ContentControl (Interfaz)

Representa un control de contenido de un documento.

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

Sintaxis

'Declaración
<GuidAttribute("ee82979b-2814-48b1-95dd-4bfcc636a7ec")> _
Public Interface ContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize
[GuidAttribute("ee82979b-2814-48b1-95dd-4bfcc636a7ec")]
public interface ContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

El tipo ContentControl expone los siguientes miembros.

Propiedades

  Nombre Descripción
Propiedad pública Application Obtiene un objeto Microsoft.Office.Interop.Word.Application que representa la instancia actual de Microsoft Office Word.
Propiedad pública BindingContext Obtiene o establece la colección de administradores de moneda para IBindableComponent. (Se hereda de IBindableComponent).
Propiedad pública BuildingBlockCategory Obtiene o establece la categoría de los bloques de creación que se muestran en un objeto ContentControl que representa una galería de bloques de creación.
Propiedad pública BuildingBlockType Obtiene o establece el tipo de los bloques de creación que se muestran en un objeto ContentControl que representa una galería de bloques de creación.
Propiedad pública Checked Obtiene o establece un valor que indica si un objeto ContentControl que representa un control de casilla activada está activado o desactivado.Esta propiedad solo se puede usar en los proyectos de Word 2010.
Propiedad pública Container Infraestructura. (Se hereda de ContentControlBase).
Propiedad pública ContainerComponent Infraestructura. (Se hereda de ContentControlBase).
Propiedad pública Creator Obtiene un entero de 32 bits que indica la aplicación en que se creó el control ContentControl.
Propiedad pública DataBindings Obtiene la colección de objetos de enlace de datos para esta interfaz IBindableComponent. (Se hereda de IBindableComponent).
Propiedad pública DateCalendarType Obtiene o establece el tipo de calendario que se muestra en un objeto ContentControl que representa un selector de fecha.
Propiedad pública DateDisplayFormat Obtiene o establece una cadena que especifica el formato de las fechas que se muestran en un objeto ContentControl que representa un selector de fecha.
Propiedad pública DateDisplayLocale Obtiene o establece el formato de idioma de la fecha que se muestra en un objeto ContentControl que representa un selector de fecha.
Propiedad pública DateStorageFormat Obtiene o establece el formato en el que un objeto ContentControl que representa un selector de fecha guarda las fechas en un elemento XML personalizado.
Propiedad pública DefaultDataSourceUpdateMode Obtiene o establece el objeto DataSourceUpdateMode predeterminado de ContentControlBase. (Se hereda de ContentControlBase).
Propiedad pública DefaultTextStyle Obtiene el nombre del estilo de caracteres que se utiliza para dar formato al texto de ContentControl.
Propiedad pública DropDownListEntries Obtiene la colección de elementos que se muestran en un objeto ContentControl que representa una lista desplegable o un cuadro combinado.
Propiedad pública ID Obtiene un número único que identifica el control de contenido. (Se hereda de ContentControlBase).
Propiedad pública InnerObject Obtiene el objeto Microsoft.Office.Interop.Word.ContentControl subyacente de Microsoft.Office.Tools.Word.ContentControlBase. (Se hereda de ContentControlBase).
Propiedad pública LockContentControl Obtiene o establece un valor que especifica si el control ContentControl se puede eliminar del documento.
Propiedad pública LockContents Obtiene o establece un valor que especifica si se puede editar el contenido de ContentControl.
Propiedad pública MultiLine Obtiene o establece un valor que especifica si ContentControl puede contener saltos de línea.
Propiedad pública Parent Obtiene el objeto principal de ContentControl.
Propiedad pública ParentContentControl Obtiene el control de contenido primario de un objeto ContentControl que está anidado en otro control de contenido.
Propiedad pública PlaceholderText Obtiene el texto que se muestra en ContentControl hasta que este texto se modifica mediante una acción del usuario o alguna otra operación.
Propiedad pública Range Obtiene un objeto Range que representa el contenido de ContentControl.
Propiedad pública ShowingPlaceholderText Obtiene un valor que especifica si ContentControl está mostrando actualmente el texto del marcador de posición.
Propiedad pública Site Obtiene o establece la interfaz ISite asociada a la interfaz IComponent. (Se hereda de IComponent).
Propiedad pública Tag Obtiene o establece una cadena que se va a asociar al control ContentControl.
Propiedad pública Temporary Obtiene o establece un valor que especifica si ContentControl se elimina automáticamente del documento cuando se edita el control.
Propiedad pública Title Obtiene o establece el título de ContentControl.
Propiedad pública Type Obtiene o establece un valor que especifica el tipo de control de contenido que ContentControl representa.
Propiedad pública XMLMapping Obtiene un objeto XMLMapping que representa el enlace entre ContentControl y un objeto de un elemento XML personalizado.

Arriba

Métodos

  Nombre Descripción
Método público BeginInit Indica al objeto que está comenzando la inicialización. (Se hereda de ISupportInitialize).
Método público Copy Copia el control ContentControl del documento en el Portapapeles.
Método público Cut Quita el control ContentControl del documento y lo agrega al Portapapeles.
Método público Delete Elimina del documento un control de contenido creado dinámicamente y lo quita de la colección ControlCollection del documento. (Se hereda de ContentControlBase).
Método público Dispose Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. (Se hereda de IDisposable).
Método público EndInit Indica al objeto que se ha completado la inicialización. (Se hereda de ISupportInitialize).
Método público SetCheckedSymbol Establece el símbolo que se usa para representar el estado activado de un objeto ContentControl que representa un control de casilla.Este método solo se puede usar en proyectos de Word 2010.
Método público SetPlaceholderText Muestra el texto de un objeto BuildingBlock, un objeto Range o una cadena como texto del marcador de posición de ContentControl.
Método público SetUncheckedSymbol Establece el símbolo que se usa para representar el estado desactivado de un objeto ContentControl que representa un control de casilla.Este método solo se puede usar en proyectos de Word 2010.
Método público Ungroup Quita el control de contenido de grupo que contiene el objeto ContentControl del documento para que la región deje de estar protegida.

Arriba

Eventos

  Nombre Descripción
Evento público Added Se produce una vez que se ha agregado el control de contenido al documento. (Se hereda de ContentControlBase).
Evento público BindingContextChanged Se produce cuando cambia el valor de la propiedad BindingContext de la clase ContentControlBase. (Se hereda de ContentControlBase).
Evento público ContentUpdating Se produce inmediatamente antes de que Microsoft Office Word actualice el texto del control de contenido, si el control de contenido está enlazado a un elemento XML personalizado. (Se hereda de ContentControlBase).
Evento público Deleting Se produce inmediatamente antes de que se elimine el control de contenido del documento. (Se hereda de ContentControlBase).
Evento público Disposed Representa el método que controla el evento Disposed de un componente. (Se hereda de IComponent).
Evento público Entering Se produce cuando el usuario hace clic en el control de contenido o cuando el cursor se mueve dentro del control de contenido mediante programación. (Se hereda de ContentControlBase).
Evento público Exiting Se produce cuando el usuario hace clic fuera del control de contenido o cuando el cursor se mueve fuera del control de contenido mediante programación. (Se hereda de ContentControlBase).
Evento público StoreUpdating Se produce inmediatamente antes de que Microsoft Office Word actualice los datos de un elemento XML personalizado que está enlazado al control de contenido (es decir, una vez que se ha modificado el texto del control de contenido). (Se hereda de ContentControlBase).
Evento público Validated Se produce cuando el control de contenido se ha validado correctamente. (Se hereda de ContentControlBase).
Evento público Validating Se produce cuando se valida el contenido del control de contenido. (Se hereda de ContentControlBase).

Arriba

Comentarios

Un objeto ContentControl es un control mutable que puede representar a cualquiera de los ocho tipos de controles de contenido que se pueden utilizar en Microsoft Office Word. Por ejemplo, si crea un objeto ContentControl que inicialmente tiene la funcionalidad de un control de texto sin formato, puede cambiarlo en tiempo de ejecución para que se comporte como un cuadro combinado. Otros controles de contenido no se pueden utilizar de esta manera. Por ejemplo, un objeto RichTextContentControl solo puede representar un control de texto enriquecido. Para obtener más información sobre los controles de contenido, vea Controles de contenido.

Para crear un objeto ContentControl, utilice uno de los métodos AddContentControl. No se puede agregar un objeto ContentControl a un documento en tiempo de diseño.

Cuando cree un objeto ContentControl, debe especificar el tipo de control de contenido que desea crear o puede basar el nuevo control en un control de contenido existente. Después de crear un objeto ContentControl, puede cambiar el tipo de control de contenido que representa mediante la propiedad Type.

Algunos miembros de ContentControl producirán una excepción si se utilizan mientras el control está establecido en un tipo de control que no está diseñado para utilizar el miembro. Por ejemplo, la propiedad DateCalendarType producirá una excepción si intenta utilizarla en un objeto ContentControl que no representa un selector de fecha.

Nota

Esta interfaz está implementada por el motor en tiempo de ejecución de Visual Studio Tools para Office. No está prevista su implementación en el código. Para obtener más información, vea Información general sobre el Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office.

Uso

Esta documentación describe la versión de este tipo que se utiliza en los proyectos de Office destinados a .NET Framework 4. En los proyectos destinados a .NET Framework 3.5, este tipo puede tener miembros diferentes y es posible que los ejemplos de código proporcionados para dicho tipo no funcionen. Para informarse sobre este tipo en los proyectos destinados a .NET Framework 3.5, vea la siguiente sección de referencia en la documentación de Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Vea también

Referencia

Microsoft.Office.Tools.Word (Espacio de nombres)

Otros recursos

Controles de contenido

Cómo: Agregar controles de contenido a documentos de Word

Cómo: Proteger elementos de documentos mediante controles de contenido