ControlDesigner Clase

Definición

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

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

type ControlDesigner = class
    inherit HtmlControlDesigner

Public Class ControlDesigner
Inherits HtmlControlDesigner

Herencia

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

Derivado

System.Web.DynamicData.Design.DynamicDataManagerDesigner

System.Web.UI.Design.ContainerControlDesigner

System.Web.UI.Design.DataSourceDesigner

System.Web.UI.Design.ExtenderControlDesigner

System.Web.UI.Design.HierarchicalDataSourceDesigner

Más…

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear una clase de diseñador simple que deriva de la ControlDesigner clase . Este diseñador de controles admite una clase personalizada TextControl y proporciona un comando para cambiar el tamaño de texto de un control en tiempo de diseño. El diseñador de controles está asociado al control especificando el diseñador de controles en una DesignerAttribute declaración de objeto en la TextControl clase . La clave para conservar los cambios de propiedad desde el diseñador de controles al marcado HTML se encuentra en el ToggleTextSize método de la clase personalizada ActionList .

Para probar el ejemplo, agregue una referencia al ensamblado System.Design.dll y compile el código.

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

namespace ASPNet.Design.Samples.CS
{
    // Simple text Web control renders a text string.
    // This control is associated with the TextSizeWebControlDesigner.
    [DesignerAttribute(typeof(TextSizeWebControlDesigner)),
    ToolboxData("<{0}:TextControl runat=\"server\"></{0}:TextControl>")]
    public class TextControl : Label
    {
        private bool _largeText = true;

        // Constructor
        public TextControl()
        {
            Text = "Test Phrase";
            SetSize();
        }

        // Determines whether the text is large or small
        [Bindable(true), Category("Appearance"), DefaultValue("true")]
        public bool LargeText
        {
            get { return _largeText; }
            set
            {
                _largeText = value;
                SetSize();
            }
        }

        // Applies the LargeText property to the control
        private void SetSize()
        {
            if (LargeText)
                this.Font.Size = FontUnit.XLarge;
            else
                this.Font.Size = FontUnit.Small;
        }
    }

    // This control designer offers DesignerActionList commands
    // that can alter the design time html of the associated control.
    public class TextSizeWebControlDesigner : ControlDesigner
    {
        private DesignerActionListCollection _actionLists = null;

        // Do not allow direct resizing of the control
        public override bool AllowResize
        {
            get { return false; }
        }

        // Return a custom ActionList collection
        public override DesignerActionListCollection ActionLists
        {
            get
            {
                if (_actionLists == null)
                {
                    _actionLists = new DesignerActionListCollection();
                    _actionLists.AddRange(base.ActionLists);

                    // Add a custom DesignerActionList
                    _actionLists.Add(new ActionList(this));
                }
                return _actionLists;
            }
        }

        public class ActionList : DesignerActionList
        {
            private TextSizeWebControlDesigner _parent;
            private DesignerActionItemCollection _items;

            // Constructor
            public ActionList(TextSizeWebControlDesigner parent)
                : base(parent.Component)
            {
                _parent = parent;
            }

            // Create the ActionItem collection and add one command
            public override DesignerActionItemCollection GetSortedActionItems()
            {
                if (_items == null)
                {
                    _items = new DesignerActionItemCollection();
                    _items.Add(new DesignerActionMethodItem(this, "ToggleLargeText", "Toggle Text Size", true));
                }
                return _items;
            }

            // ActionList command to change the text size
            private void ToggleLargeText()
            {
                // Get a reference to the parent designer's associated control
                TextControl ctl = (TextControl)_parent.Component;

                // Get a reference to the control's LargeText property
                PropertyDescriptor propDesc = TypeDescriptor.GetProperties(ctl)["LargeText"];

                // Get the current value of the property
                bool v = (bool)propDesc.GetValue(ctl);

                // Toggle the property value
                propDesc.SetValue(ctl, !v);
            }
        }
    }
}

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

Namespace ASPNet.Design.Samples.VB

    ' Simple text Web control renders a text string.
    ' This control is associated with the TextSizeWebControlDesigner.
    <DesignerAttribute(GetType(TextSizeWebControlDesigner)), _
        ToolboxData("<{0}:TextControl runat='server'></{0}:TextControl>")> _
    Public Class TextControl
        Inherits Label

        Private _largeText As Boolean = True

        ' Constructor
        Public Sub New()
            Text = "Test Phrase"
            SetSize()
        End Sub

        ' Determines whether the text is large or small
        <Bindable(True), Category("Appearance"), DefaultValue(True)> _
        Public Property LargeText() As Boolean
            Get
                Return _largeText
            End Get
            Set(ByVal value As Boolean)
                _largeText = value
                SetSize()
            End Set
        End Property

        ' Applies the LargeText property to the control
        Private Sub SetSize()
            If LargeText Then
                Me.Font.Size = FontUnit.XLarge
            Else
                Me.Font.Size = FontUnit.Small
            End If
        End Sub
    End Class


    ' This control designer offers DesignerActionList commands
    ' that can alter the design time html of the associated control.
    Public Class TextSizeWebControlDesigner
        Inherits ControlDesigner

        Private _actionLists As DesignerActionListCollection

        ' Do not allow direct resizing of the control
        Public Overrides ReadOnly Property AllowResize() As Boolean
            Get
                Return False
            End Get
        End Property

        ' Return a custom ActionList collection
        Public Overrides ReadOnly Property ActionLists() As System.ComponentModel.Design.DesignerActionListCollection
            Get
                If IsNothing(_actionLists) Then
                    _actionLists = New DesignerActionListCollection()
                    _actionLists.AddRange(MyBase.ActionLists)

                    ' Add a custom DesignerActionList
                    _actionLists.Add(New ActionList(Me))
                End If

                Return _actionLists
            End Get
        End Property

        ' Create a custom class of DesignerActionList
        Public Class ActionList
            Inherits DesignerActionList
            Private _parent As TextSizeWebControlDesigner
            Private _items As DesignerActionItemCollection

            ' Constructor
            Public Sub New(ByRef parent As TextSizeWebControlDesigner)
                MyBase.New(parent.Component)
                _parent = parent
            End Sub

            ' Create the ActionItem collection and add one command
            Public Overrides Function GetSortedActionItems() As DesignerActionItemCollection
                If IsNothing(_items) Then
                    _items = New DesignerActionItemCollection()
                    _items.Add(New DesignerActionMethodItem(Me, "ToggleLargeText", "Toggle Text Size", True))
                End If

                Return _items
            End Function

            ' ActionList command to change the text size
            Private Sub ToggleLargeText()
                ' Get a reference to the parent designer's associated control
                Dim ctl As TextControl = CType(_parent.Component, TextControl)

                ' Get a reference to the control's LargeText property
                Dim propDesc As PropertyDescriptor = TypeDescriptor.GetProperties(ctl)("LargeText")

                ' Get the current value of the property
                Dim v As Boolean = CType(propDesc.GetValue(ctl), Boolean)
                ' Toggle the property value
                propDesc.SetValue(ctl, (Not v))
            End Sub
        End Class
    End Class
End Namespace

<%@ Page Language="C#" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="ASPNet.Design.Samples.CS" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    
    <aspSample:TextControl ID="TextControl1" runat="server">
    </aspSample:TextControl>

    
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="ASPNet.Design.Samples.VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    
        <aspSample:TextControl ID="TextControl1" runat="server">
        </aspSample:TextControl>
    
    </div>
    </form>
</body>
</html>

Comentarios

La ControlDesigner clase proporciona una clase de diseñador de controles base que se puede heredar y ampliar para proporcionar compatibilidad en tiempo de diseño para un control de servidor web en un host de diseño, como Visual Studio 2005.

El modelo de objetos para trabajar con la representación en tiempo de diseño se mejora en versiones anteriores, con las siguientes clases base nuevas para proporcionar acceso al modelo de objetos simplificado:

• ControlDesigner, que no es nuevo, pero se ha mejorado considerablemente.

• ContainerControlDesigner.

• CompositeControlDesigner.

Formato automático

Puede crear una variedad de formatos automáticos y predefinidos que pueden simplificar el proceso de los desarrolladores de páginas que aplican cambios complejos de estilo a controles de servidor web personalizados. Por ejemplo, el TableDesigner control , que deriva de la ControlDesigner clase , proporciona muchos formatos automáticos de los que elegir. Para implementar y proporcionar formato automático en los controles personalizados, use las siguientes características:

• Propiedad AutoFormats

• El método OnAutoFormatApplied .

• La clase DesignerAutoFormat.

• La clase DesignerAutoFormatStyle.

Listas de acciones (etiquetas inteligentes)

Las listas de acciones son menús de tareas importantes o ampliamente usadas que un desarrollador de páginas que usa un control puede realizar en una interfaz de usuario (UI) en tiempo de diseño, como Visual Studio 2005. Por ejemplo, la vista en tiempo de diseño del control podría proporcionar un menú de tareas disponibles. Esto incluye una tarea para dar formato al control automáticamente. Para obtener información sobre las listas de acciones, comience con las siguientes características:

• Propiedad ActionLists

• La clase DesignerActionList.

• El método GetSortedActionItems .

• La clase DesignerActionListCollection.

• La clase DesignerActionMethodItem.

• La clase DesignerActionPropertyItem.

Controlar regiones de Designer

Las regiones son áreas editables en la vista en tiempo de diseño de un control de servidor web. Esta característica ofrece la edición similar a WYSIWYG del contenido de la plantilla, los controles internos y las propiedades en tiempo de diseño. Puede hacer que el diseñador de controles cree controles en regiones o puede usar el Cuadro de herramientas para arrastrar y colocar controles en regiones. Las regiones se administran con las siguientes características:

• El método OnClick .

• La clase DesignerRegion.

• La clase EditableDesignerRegion.

• El método GetEditableDesignerRegionContent .

• El método SetEditableDesignerRegionContent .

Plantillas

El modelo para crear una interfaz de usuario para la edición en tiempo de diseño de controles con plantilla, como el GridView control, se ha mejorado considerablemente a partir de versiones anteriores. Puede crear controles personalizados complejos que incluyan plantillas para varias partes del control y el diseñador de controles personalizados puede ayudar a los desarrolladores de páginas que modifican plantillas con las siguientes características:

• Propiedad TemplateGroups

• Propiedad InTemplateMode

• La clase TemplateGroup.

representación de Design-Time

La ControlDesigner clase tiene los métodos siguientes para admitir la representación en tiempo de diseño del control de servidor web. La mayoría de estos métodos son los mismos que en versiones anteriores:

• El método GetDesignTimeHtml .

• El método GetEmptyDesignTimeHtml .

• El método GetErrorDesignTimeHtml .

• El método UpdateDesignTimeHtml .

• El método CreatePlaceHolderDesignTimeHtml .

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

• TemplateGroup
• DesignerAutoFormat
• DesignerActionList
• DesignerRegion
• ContainerControlDesigner
• CompositeControlDesigner
• Introducción a los diseñadores de controles de ASP.NET
• Arquitectura en tiempo de diseño
• Designer de control de ejemplo con listas de acciones y servicios