ContentControl (Clase) (2007 System)

Artículo
09/04/2008

Actualización: noviembre 2007

Representa un control de contenido de un documento.

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

Sintaxis

<PermissionSetAttribute(SecurityAction.Demand, Name := "FullTrust")> _
Public NotInheritable Class ContentControl _
    Inherits ContentControlBase _
    Implements ISupportInitializeControl, ISupportInitialize

Dim instance As ContentControl

[PermissionSetAttribute(SecurityAction.Demand, Name = "FullTrust")]
public sealed class ContentControl : ContentControlBase, 
    ISupportInitializeControl, ISupportInitialize

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. Otras clases de control de contenido de Visual Studio Tools para Office no se pueden utilizar de este modo. Por ejemplo, un objeto RichTextContentControl sólo 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.

Jerarquía de herencia

System.Object
  Microsoft.VisualStudio.Tools.Office.RemoteComponent
    Microsoft.VisualStudio.Tools.Office.RemoteBindableComponent
      Microsoft.Office.Tools.Word.ContentControlBase
        Microsoft.Office.Tools.Word.ContentControl

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.