ControlDesigner Classe

Definizione

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

Ereditarietà

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

Derivato

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

Altro…

Esempio

Nell'esempio di codice seguente viene illustrato come creare una classe di progettazione semplice che deriva dalla ControlDesigner classe . Questa finestra di progettazione controlli supporta una classe personalizzata TextControl e fornisce un comando per modificare le dimensioni del testo di un controllo in fase di progettazione. La finestra di progettazione controlli è associata al controllo specificando la finestra di progettazione controlli in una DesignerAttribute dichiarazione di oggetto nella TextControl classe . La chiave per rendere persistenti le modifiche delle proprietà dalla finestra di progettazione controlli al markup HTML si trova nel ToggleTextSize metodo della classe personalizzata ActionList .

Per provare l'esempio, aggiungere un riferimento all'assembly System.Design.dll e compilare il codice.

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>

Commenti

La ControlDesigner classe fornisce una classe di progettazione controlli di base che può essere ereditata e estesa per fornire supporto in fase di progettazione per un controllo server Web in un host di progettazione, ad esempio Visual Studio 2005.

Il modello a oggetti per l'utilizzo del rendering in fase di progettazione è migliorato rispetto alle versioni precedenti, con le nuove classi di base seguenti per fornire l'accesso al modello a oggetti semplificato:

• ControlDesigner, che non è nuovo, ma è stato notevolmente migliorato.

• ContainerControlDesigner.

• CompositeControlDesigner.

Formattazione automatica

È possibile creare un'ampia gamma di formati automatici e predefiniti che consentono di semplificare il processo degli sviluppatori di pagine che applicano modifiche di stile complesse ai controlli server Web personalizzati. Ad esempio, il TableDesigner controllo , che deriva dalla ControlDesigner classe , fornisce molti formati automatici da cui scegliere. Per implementare e fornire la formattazione automatica nei controlli personalizzati, usare le funzionalità seguenti:

• La proprietà AutoFormats.

• Metodo OnAutoFormatApplied .

• Classe DesignerAutoFormat.

• Classe DesignerAutoFormatStyle.

Elenchi di azioni (smart tag)

Gli elenchi di azioni sono menu di attività importanti o ampiamente usate da uno sviluppatore di pagine che usa un controllo in un'interfaccia utente in fase di progettazione, ad esempio Visual Studio 2005. Ad esempio, la visualizzazione in fase di progettazione del controllo potrebbe fornire un menu di attività disponibili. Include un'attività per formattare automaticamente il controllo. Per informazioni sugli elenchi di azioni, iniziare con le funzionalità seguenti:

• La proprietà ActionLists.

• Classe DesignerActionList.

• Metodo GetSortedActionItems .

• Classe DesignerActionListCollection.

• Classe DesignerActionMethodItem.

• Classe DesignerActionPropertyItem.

Aree di Progettazione controlli

Le aree sono aree modificabili nella visualizzazione in fase di progettazione di un controllo server Web. Questa funzionalità offre la modifica simile a WYSIWYG del contenuto del modello, dei controlli interni e delle proprietà in fase di progettazione. È possibile creare controlli nella finestra di progettazione controlli in aree oppure usare la casella degli strumenti per trascinare i controlli nelle aree. Le aree vengono gestite con le funzionalità seguenti:

• Metodo OnClick .

• Classe DesignerRegion.

• Classe EditableDesignerRegion.

• Metodo GetEditableDesignerRegionContent .

• Metodo SetEditableDesignerRegionContent .

Modelli

Il modello per la creazione di un'interfaccia utente per la modifica in fase di progettazione di controlli basati su modelli, ad esempio il GridView controllo, è stato notevolmente migliorato rispetto alle versioni precedenti. È possibile creare controlli personalizzati complessi che includono modelli per varie parti del controllo e la finestra di progettazione controlli personalizzata può aiutare gli sviluppatori di pagine che modificano i modelli con le funzionalità seguenti:

• La proprietà TemplateGroups.

• La proprietà InTemplateMode.

• Classe TemplateGroup.

rendering Design-Time

La ControlDesigner classe include i metodi seguenti per supportare il rendering in fase di progettazione del controllo server Web. La maggior parte di questi metodi è identica a quella delle versioni precedenti:

• Metodo GetDesignTimeHtml .

• Metodo GetEmptyDesignTimeHtml .

• Metodo GetErrorDesignTimeHtml .

• Metodo UpdateDesignTimeHtml .

• Metodo CreatePlaceHolderDesignTimeHtml .

Costruttori

Proprietà

Metodi

Implementazioni dell'interfaccia esplicita

Si applica a

Vedi anche

• TemplateGroup
• DesignerAutoFormat
• DesignerActionList
• DesignerRegion
• ContainerControlDesigner
• CompositeControlDesigner
• Introduzione alle finestre di progettazione dei controlli di ASP.NET
• Architettura della fase di progettazione
• Progettazione controlli di esempio con elenchi di azioni e servizi