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 : boolProtected Overridable ReadOnly Property UsePreviewControl As BooleanValor 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 que se derivan 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 truesiempre . Para indicar que la ViewControl propiedad siempre devuelve una instancia del control, invalide la UsePreviewControl propiedad para devolver falsesiempre . Por ejemplo, la PreviewControlDesigner clase deriva de ControlDesigner y siempre devuelve true para la UsePreviewControl propiedad .