ControlDesigner.UsePreviewControl Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene un valor que indica si el diseñador de control utiliza un control de vista previa temporal para generar el marcado HTML en tiempo de diseño.
protected:
virtual property bool UsePreviewControl { bool get(); };
protected virtual bool UsePreviewControl { get; }
member this.UsePreviewControl : bool
Protected Overridable ReadOnly Property UsePreviewControl As Boolean
Valor de propiedad
true
, si el diseñador de control utiliza una copia temporal del control para la vista previa en tiempo de diseño; en otro caso, false
, si el diseñador de control utiliza la propiedad Component para el control contenido en el diseñador de control.
Comentarios
Si la UsePreviewControl propiedad es true
, la ViewControl propiedad devuelve una copia temporal del control. Los cambios en el control temporal no se conservan en el documento.
Si la UsePreviewControl propiedad es false
, la ViewControl propiedad devuelve una instancia de la Component propiedad para el control . Los cambios realizados en la instancia del control se conservan.
El SupportsPreviewControl valor del SupportsPreviewControlAttribute objeto se usa para establecer el valor de la UsePreviewControl propiedad . Por lo tanto, la SupportsPreviewControl configuración determina el tipo de control devuelto por la ViewControl propiedad en la clase base ControlDesigner . Si no se especifica en SupportsPreviewControlAttribute la declaración del diseñador de controles, el comportamiento del ControlDesigner objeto equivale a especificar la SupportsPreviewControl propiedad como false
.
Notas a los desarrolladores de herederos
Los diseñadores personalizados derivados de la ControlDesigner clase pueden invalidar la UsePreviewControl propiedad y omitir el SupportsPreviewControlAttribute objeto. Por lo general, para indicar que la ViewControl propiedad siempre devuelve una copia temporal del control, invalide la UsePreviewControl propiedad para devolver true
siempre . Para indicar que la ViewControl propiedad siempre devuelve una instancia del control, invalide la UsePreviewControl propiedad para devolver false
siempre . Por ejemplo, la PreviewControlDesigner clase deriva de ControlDesigner y siempre devuelve true
para la UsePreviewControl propiedad .