ContainerControlDesigner Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI.Design

Ensamblado:: System.Design.dll

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í.

Proporciona la funcionalidad de diseñador para los controles que contienen controles secundarios o propiedades que se pueden modificar en tiempo de diseño.

public ref class ContainerControlDesigner : System::Web::UI::Design::ControlDesigner

public class ContainerControlDesigner : System.Web.UI.Design.ControlDesigner

type ContainerControlDesigner = class
    inherit ControlDesigner

Public Class ContainerControlDesigner
Inherits ControlDesigner

Herencia: Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner
ContainerControlDesigner

Derivado: System.Web.UI.Design.WebControls.MultiViewDesigner

System.Web.UI.Design.WebControls.PanelContainerDesigner

System.Web.UI.Design.WebControls.ViewDesigner

Ejemplos

En el ejemplo de código siguiente se muestra cómo derivar una clase de diseñador de la ContainerControlDesigner clase . En el ejemplo se define un control simple derivado de la CompositeControl clase y, a continuación, se define un diseñador asociado, que se deriva de la ContainerControlDesigner clase . La clase de diseñador derivada invalida las FrameCaption propiedades y FrameStyle para personalizar el marco que se encuentra alrededor de la región editable del control en la superficie de diseño.

using System;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.Drawing;
using System.Web.UI;
using System.Web.UI.Design;
using System.Web.UI.Design.WebControls;
using System.Web.UI.WebControls;

namespace ControlDesignerSamples.CS
{

    // Define a simple composite control, derived from the 
    // System.Web.UI.WebControls.CompositeControl class.
    [
        Designer(typeof(SimpleContainerControlDesigner)) , 
        ParseChildren(false)
    ]
    public class SimpleContainerControl : CompositeControl
    {
    }


    // Define the designer for the simple composite control.
    // The designer derives from System.Web.UI.Design.ContainerControlDesigner.
    // The designer defines the style and caption for frame around the 
    // editable region in the design surface.
    public class SimpleContainerControlDesigner : ContainerControlDesigner
    {
        private Style _style = null;

        // Define the caption text for the frame in the design surface.
        public override string FrameCaption
        {
            get
            {
                return "= My simple container control =";
            }
        }

        // Define the style of the frame around the control in the design surface.
        public override Style FrameStyle
        {
            get
            {
                if (_style == null)
                {
                    _style = new Style();
                    _style.Font.Name = "Verdana";
                    _style.Font.Size = new FontUnit("XSmall");
                    _style.BackColor = Color.LavenderBlush;
                    _style.ForeColor = Color.DarkBlue;
                }

                return _style;
            }
        }
    }
}


Imports System.ComponentModel
Imports System.ComponentModel.Design
Imports System.Collections
Imports System.Drawing
Imports System.Web.UI
Imports System.Web.UI.Design
Imports System.Web.UI.Design.WebControls
Imports System.Web.UI.WebControls

Namespace ControlDesignerSamples.VB


    ' Define a simple composite control, derived from the 
    ' System.Web.UI.WebControls.CompositeControl class.

    <Designer(GetType(SimpleContainerControlDesigner)), _
     ParseChildren(False)> _
    Public Class SimpleContainerControl
        Inherits CompositeControl

    End Class


    ' Define the designer for the simple composite control.
    ' The designer derives from System.Web.UI.Design.ContainerControlDesigner.
    ' The designer defines the style and caption for the frame around the 
    ' editable region of the control in the design surface.
    Public Class SimpleContainerControlDesigner
        Inherits ContainerControlDesigner

        Private _style As Style = Nothing

        ' Define the caption text for the frame in the design surface.
        Public Overrides ReadOnly Property FrameCaption() As String
            Get
                Return "- My simple container control -"
            End Get
        End Property


        ' Define the style of the frame around the control in the design surface.
        Public Overrides ReadOnly Property FrameStyle() As Style
            Get
                If _style Is Nothing Then

                    _style = New Style()
                    _style.Font.Name = "Verdana"
                    _style.Font.Size = New FontUnit("XSmall")
                    _style.BackColor = Color.LavenderBlush
                    _style.ForeColor = Color.DarkBlue
                End If

                Return _style
            End Get
        End Property


    End Class

End Namespace

Comentarios

La ContainerControlDesigner clase proporciona una clase de diseñador base para los controles que se pueden modificar en la superficie de diseño. Esto incluye controles que contienen controles secundarios o propiedades internas editables. ContainerControlDesigner proporciona una sola región enmarcada para representar el control y controla automáticamente la representación del control en tiempo de diseño.

Aplique el ParseChildrenAttribute atributo en el control asociado para determinar el comportamiento en tiempo de diseño de ContainerControlDesigner. Aplique la configuración en el control asociado de la ParseChildrenAttribute siguiente manera:

false para indicar que ContainerControlDesigner representa el contenido de la región de diseño editable como controles secundarios.
true para indicar que ContainerControlDesigner representa el contenido de la región de diseño editable como propiedades internas editables del control.

Los desarrolladores de controles pueden derivar y ampliar un diseñador personalizado de uno de varios diseñadores base en función del tipo de control que se está desarrollando, tal como se define en la lista siguiente:

Los controles que permiten agregar controles secundarios a él en tiempo de diseño pueden derivar de la ContainerControlDesigner clase . Por ejemplo, la PanelContainerDesigner clase se deriva de la ContainerControlDesigner clase y representa un Panel control en la superficie de diseño.
Los controles que tienen uno o varios controles secundarios y también pueden tener una región de diseñador editable en la que se pueden agregar controles en tiempo de diseño, pueden derivar de la CompositeControlDesigner clase .
Los controles que requieren procesamiento en tiempo de diseño personalizado pueden derivar de la clase base ControlDesigner .

Nota

La ContainerControlDesigner clase reemplaza a la clase obsoleta ReadWriteControlDesigner .

Use el DesignerAttribute atributo para asociar una clase de diseñador personalizada junto con una implementación de control personalizado. Para obtener información detallada sobre cómo usar diseñadores de controles con controles personalizados, vea Tutorial: Creación de un control básico Designer para un control de servidor web.

Constructores

ContainerControlDesigner()

Inicializa una nueva instancia de la clase ContainerControlDesigner.

Propiedades

ActionLists	Obtiene la colección de listas de acciones para el diseñador de controles. (Heredado de ControlDesigner)
AllowResize	Obtiene un valor que indica si se puede cambiar el tamaño del control en tiempo de diseño.
AssociatedComponents	Obtiene la colección de componentes asociados al componente administrado por el diseñador. (Heredado de ComponentDesigner)
AutoFormats	Obtiene la colección de esquemas de formato automático predefinidos para mostrarla en tiempo de diseño en el cuadro de diálogo Formato automático correspondiente al control asociado. (Heredado de ControlDesigner)
Behavior	Obsoletos. Obtiene o establece el comportamiento DHTML asociado al diseñador. (Heredado de HtmlControlDesigner)
Component	Obtiene el componente que el diseñador está creando. (Heredado de ComponentDesigner)
DataBindings	Obtiene la colección de enlaces de datos del control actual. (Heredado de HtmlControlDesigner)
DataBindingsEnabled	Obtiene un valor que indica si la región contenedora del control asociado permite el enlace a datos. (Heredado de ControlDesigner)
DesignerState	Obtiene un objeto que se utiliza para guardar los datos del control asociado en tiempo de diseño. (Heredado de ControlDesigner)
DesignTimeElement	Obsoletos. Obtiene el objeto en tiempo de diseño que representa el control asociado al objeto HtmlControlDesigner en la superficie de diseño. (Heredado de HtmlControlDesigner)
DesignTimeElementView	Obsoletos. Obtiene el objeto de control de vista para el diseñador de controles. (Heredado de ControlDesigner)
DesignTimeHtmlRequiresLoadComplete	Obsoletos. Obtiene un valor que indica si el host de diseño debe terminar de cargarse antes de que se pueda llamar al método GetDesignTimeHtml. (Heredado de ControlDesigner)
Expressions	Obtiene los enlaces de expresión en tiempo de diseño para el control actual. (Heredado de HtmlControlDesigner)
FrameCaption	Obtiene el título que se mostrará para un control en tiempo de diseño.
FrameStyle	Obtiene el estilo que se aplica al marco del control en tiempo de diseño.
HidePropertiesInTemplateMode	Obtiene un valor que indica si las propiedades del control asociado están ocultas cuando el control está en modo de plantilla. (Heredado de ControlDesigner)
ID	Obtiene o establece la cadena del identificador del control. (Heredado de ControlDesigner)
InheritanceAttribute	Obtiene un atributo que indica el tipo de herencia del componente asociado. (Heredado de ComponentDesigner)
Inherited	Obtiene un valor que indica si este componente es heredado. (Heredado de ComponentDesigner)
InTemplateMode	Obtiene un valor que indica si el control está en el modo de vista o de edición de plantilla en el host de diseño. La propiedad InTemplateMode es de sólo lectura. (Heredado de ControlDesigner)
IsDirty	Obsoletos. Obtiene o establece un valor que indica si el control de servidor Web se ha marcado como modificado. (Heredado de ControlDesigner)
NoWrap	Obtiene un valor que especifica si se ha de utilizar el atributo `nowrap` de HTML en las tablas.
ParentComponent	Obtiene el componente primario de este diseñador. (Heredado de ComponentDesigner)
ReadOnly	Obsoletos. Obtiene o establece un valor que indica si las propiedades del control son de sólo lectura en tiempo de diseño. (Heredado de ControlDesigner)
RootDesigner	Obtiene el diseñador de controles para la página de formularios Web Forms que contiene el control asociado. (Heredado de ControlDesigner)
SetTextualDefaultProperty	Proporciona la funcionalidad de diseñador para los controles que contienen controles secundarios o propiedades que se pueden modificar en tiempo de diseño. (Heredado de ComponentDesigner)
ShadowProperties	Obtiene una colección de valores de propiedad que reemplazan la configuración del usuario. (Heredado de ComponentDesigner)
ShouldCodeSerialize	Obsoletos. Obtiene o establece un valor que indica si se debe crear una declaración de campo para el control en el archivo de código subyacente para el documento de diseño actual durante la serialización. (Heredado de HtmlControlDesigner)
Tag	Obtiene un objeto que representa el elemento de formato HTML del control asociado. (Heredado de ControlDesigner)
TemplateGroups	Obtiene una colección de grupos de plantillas, cada una con una o varias definiciones de plantilla. (Heredado de ControlDesigner)
UsePreviewControl	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. (Heredado de ControlDesigner)
Verbs	Obtiene los verbos en tiempo de diseño que admite el componente asociado al diseñador. (Heredado de ComponentDesigner)
ViewControl	Obtiene o establece un control de servidor Web que se puede utilizar para ofrecer una vista previa del formato HTML en tiempo de diseño. (Heredado de ControlDesigner)
ViewControlCreated	Obtiene o establece un valor que indica si se ha creado un control `View` para la presentación en la superficie de diseño. (Heredado de ControlDesigner)
Visible	Obtiene un valor que indica si el control está visible en tiempo de diseño. (Heredado de ControlDesigner)

Métodos

AddDesignTimeCssAttributes(IDictionary)	Agrega los atributos de estilo del control en tiempo de diseño.
CreateErrorDesignTimeHtml(String)	Crea el formato HTML para mostrar un mensaje de error especificado en tiempo de diseño. (Heredado de ControlDesigner)
CreateErrorDesignTimeHtml(String, Exception)	Crea el formato HTML para mostrar un mensaje de error de excepción especificado en tiempo de diseño. (Heredado de ControlDesigner)
CreatePlaceHolderDesignTimeHtml()	Proporciona una representación sencilla del marcador de posición rectangular que muestra el tipo y el Id. del control. (Heredado de ControlDesigner)
CreatePlaceHolderDesignTimeHtml(String)	Proporciona una representación sencilla del marcador de posición rectangular que muestra el tipo y el Id. del control, así como instrucciones o información adicionales que se hayan especificado. (Heredado de ControlDesigner)
CreateViewControl()	Devuelve una copia del control asociado para verlo o representarlo en la superficie de diseño. (Heredado de ControlDesigner)
Dispose()	Libera todos los recursos que usa ComponentDesigner. (Heredado de ComponentDesigner)
Dispose(Boolean)	Libera los recursos no administrados utilizados por el objeto HtmlControlDesigner y, de forma opcional, libera los recursos administrados. (Heredado de HtmlControlDesigner)
DoDefaultAction()	Crea una firma de método en el archivo de código fuente para el evento predeterminado del componente y hace navegar el cursor del usuario en esa ubicación. (Heredado de ComponentDesigner)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetBounds()	Recupera las coordenadas del rectángulo que representa los límites del control mostrado en la superficie de diseño. (Heredado de ControlDesigner)
GetDesignTimeCssAttributes()	Devuelve los atributos de estilo de la colección en tiempo de diseño.
GetDesignTimeHtml()	Recupera el formato HTML que se usa para representar el control en tiempo de diseño. (Heredado de ControlDesigner)
GetDesignTimeHtml(DesignerRegionCollection)	Devuelve el formato HTML usado para representar el control en tiempo de diseño.
GetEditableDesignerRegionContent(EditableDesignerRegion)	Devuelve el contenido de la región modificable del control en tiempo de diseño.
GetEmptyDesignTimeHtml()	Recupera el formato HTML para presentar un control de servidor web en tiempo de diseño que no tendrá ninguna representación visual en tiempo de ejecución. (Heredado de ControlDesigner)
GetErrorDesignTimeHtml(Exception)	Recupera el formato HTML que proporciona información sobre la excepción especificada. (Heredado de ControlDesigner)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetPersistenceContent()	Devuelve el contenido con persistencia del control en tiempo de diseño.
GetPersistInnerHtml()	Obsoletos. Recupera el formato HTML interno con persistencia del control. (Heredado de ControlDesigner)
GetService(Type)	Intenta recuperar el tipo de servicio especificado del sitio en modo de diseño del componente del diseñador. (Heredado de ComponentDesigner)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetViewRendering()	Recupera un objeto que contiene el formato en tiempo de diseño para el contenido y las regiones del control asociado. (Heredado de ControlDesigner)
Initialize(IComponent)	Inicializa el diseñador de controles y carga el componente especificado. (Heredado de ControlDesigner)
InitializeExistingComponent(IDictionary)	Reinicializa un componente existente. (Heredado de ComponentDesigner)
InitializeNewComponent(IDictionary)	Inicializa un componente recién creado. (Heredado de ComponentDesigner)
InitializeNonDefault()	Obsoletos. Obsoletos. Inicializa la configuración de un componente importado que ya se ha inicializado con una configuración que no es la predeterminada. (Heredado de ComponentDesigner)
Invalidate()	Invalida todo el área del control que se muestra en la superficie de diseño y señala al diseñador de controles que vuelva a dibujar el control. (Heredado de ControlDesigner)
Invalidate(Rectangle)	Invalida el área especificada del control que se muestra en la superficie de diseño y señala al diseñador de controles que vuelva a dibujar el control. (Heredado de ControlDesigner)
InvokeGetInheritanceAttribute(ComponentDesigner)	Obtiene el objeto InheritanceAttribute de la enumeración ComponentDesigner especificada. (Heredado de ComponentDesigner)
IsPropertyBound(String)	Obsoletos. Recupera un valor que indica si la propiedad especificada en el control asociado está enlazada a datos o no. (Heredado de ControlDesigner)
Localize(IDesignTimeResourceWriter)	Utiliza el sistema de escritura de recursos proporcionado para conservar las propiedades adaptables del control asociado en un recurso en el host de diseño. (Heredado de ControlDesigner)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnAutoFormatApplied(DesignerAutoFormat)	Se le llama cuando se ha aplicado un esquema de formato automático predefinido al control asociado. (Heredado de ControlDesigner)
OnBehaviorAttached()	Se llama cuando el diseñador de controles está asociado a un objeto Behavior. (Heredado de ControlDesigner)
OnBehaviorDetaching()	Obsoletos. Se le llama cuando se anula la asociación de un comportamiento al elemento. (Heredado de HtmlControlDesigner)
OnBindingsCollectionChanged(String)	Obsoletos. Se le llama cuando cambia la colección de enlace a datos. (Heredado de ControlDesigner)
OnClick(DesignerRegionMouseEventArgs)	Lo llama el host de diseño cuando el usuario hace clic en el control asociado en tiempo de diseño. (Heredado de ControlDesigner)
OnComponentChanged(Object, ComponentChangedEventArgs)	Se le llama cuando cambia el control asociado. (Heredado de ControlDesigner)
OnComponentChanging(Object, ComponentChangingEventArgs)	Representa el método que controlará el evento ComponentChanging del control asociado. (Heredado de ControlDesigner)
OnControlResize()	Obsoletos. Se le llama cuando el control de servidor Web asociado ha cambiado de tamaño en tiempo de diseño en el host de diseño. (Heredado de ControlDesigner)
OnPaint(PaintEventArgs)	Se le llama cuando el diseñador de controles dibuja el control asociado en la superficie de diseño, si el valor CustomPaint es `true`. (Heredado de ControlDesigner)
OnSetComponentDefaults()	Obsoletos. Obsoletos. Establece las propiedades predeterminadas del componente. (Heredado de ComponentDesigner)
OnSetParent()	Proporciona una manera de realizar el procesamiento adicional cuando el control asociado se asocia a un control primario. (Heredado de HtmlControlDesigner)
PostFilterAttributes(IDictionary)	Permite a un diseñador cambiar o quitar elementos en el conjunto de atributos que expone mediante un TypeDescriptor. (Heredado de ComponentDesigner)
PostFilterEvents(IDictionary)	Permite a un diseñador cambiar o quitar elementos del conjunto de eventos que expone mediante un objeto TypeDescriptor. (Heredado de ComponentDesigner)
PostFilterProperties(IDictionary)	Permite a un diseñador cambiar o quitar elementos del conjunto de propiedades que expone mediante un objeto TypeDescriptor. (Heredado de ComponentDesigner)
PreFilterAttributes(IDictionary)	Permite a un diseñador agregar elementos al conjunto de atributos que expone mediante un objeto TypeDescriptor. (Heredado de ComponentDesigner)
PreFilterEvents(IDictionary)	Establece la lista de eventos que se exponen en tiempo de diseño para el objeto TypeDescriptor para el componente. (Heredado de HtmlControlDesigner)
PreFilterProperties(IDictionary)	Agrega propiedades o quita propiedades de la cuadrícula Propiedades en un host de diseño en tiempo de diseño, o proporciona nuevas propiedades en tiempo de diseño que pueden corresponderse con las propiedades del control asociado. (Heredado de ControlDesigner)
RaiseComponentChanged(MemberDescriptor, Object, Object)	Notifica a IComponentChangeService que este componente se ha cambiado. (Heredado de ComponentDesigner)
RaiseComponentChanging(MemberDescriptor)	Notifica a IComponentChangeService que este componente se va a cambiar. (Heredado de ComponentDesigner)
RaiseResizeEvent()	Obsoletos. Genera el evento OnControlResize(). (Heredado de ControlDesigner)
RegisterClone(Object, Object)	Registra los datos internos en un control clonado. (Heredado de ControlDesigner)
SetEditableDesignerRegionContent(EditableDesignerRegion, String)	Establece el contenido de la región modificable del control en tiempo de diseño.
SetRegionContent(EditableDesignerRegion, String)	Especifica el contenido de una región modificable en la vista en tiempo de diseño del control. (Heredado de ControlDesigner)
SetViewFlags(ViewFlags, Boolean)	Asigna la enumeración ViewFlags bit a bit especificada al valor de marcador especificado. (Heredado de ControlDesigner)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
UpdateDesignTimeHtml()	Actualiza el formato HTML en tiempo de diseño para el control de servidor Web asociado llamando al método GetDesignTimeHtml. (Heredado de ControlDesigner)

Implementaciones de interfaz explícitas

IDesignerFilter.PostFilterAttributes(IDictionary)	Para obtener una descripción de este miembro, vea el método PostFilterAttributes(IDictionary). (Heredado de ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)	Para obtener una descripción de este miembro, vea el método PostFilterEvents(IDictionary). (Heredado de ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)	Para obtener una descripción de este miembro, vea el método PostFilterProperties(IDictionary). (Heredado de ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)	Para obtener una descripción de este miembro, vea el método PreFilterAttributes(IDictionary). (Heredado de ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)	Para obtener una descripción de este miembro, vea el método PreFilterEvents(IDictionary). (Heredado de ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)	Para obtener una descripción de este miembro, vea el método PreFilterProperties(IDictionary). (Heredado de ComponentDesigner)
ITreeDesigner.Children	Para una descripción de este miembro, consulte la propiedad Children. (Heredado de ComponentDesigner)
ITreeDesigner.Parent	Para una descripción de este miembro, consulte la propiedad Parent. (Heredado de ComponentDesigner)

Se aplica a

ContainerControlDesigner Clase

Definición

Ejemplos

Comentarios

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

Comentarios

Recursos adicionales