ControlDesigner Třída

Definice

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

Dědičnost

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

Odvozené

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

Více…

Příklady

Následující příklad kódu ukazuje, jak vytvořit jednoduchou třídu návrháře, která je odvozena z ControlDesigner třídy. Tento návrhář ovládacích prvků podporuje vlastní TextControl třídu a poskytuje příkaz ke změně velikosti textu ovládacího prvku v době návrhu. Návrhář ovládacího prvku je přidružen k ovládacímu prvku zadáním návrháře ovládacího prvku v DesignerAttribute deklaraci objektu ve TextControl třídě. Klíč k zachování změn vlastností z návrháře ovládacího prvku na kód HTML se nachází v ToggleTextSize metodě vlastní ActionList třídy.

Pokud chcete vyzkoušet příklad, přidejte odkaz na sestavení System.Design.dll a zkompilujte kód.

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>

Poznámky

Třída ControlDesigner poskytuje základní třídu návrháře ovládacích prvků, která může být zděděna a rozšířena tak, aby poskytovala podporu návrhu pro ovládací prvek webového serveru v hostiteli návrhu, například Visual Studio 2005.

Objektový model pro práci s vykreslováním v době návrhu je oproti dřívějším verzím vylepšený s následujícími novými základními třídami, které poskytují přístup ke zjednodušenému objektovém modelu:

• ControlDesigner, která není nová, ale byla výrazně vylepšena.

• ContainerControlDesigner.

• CompositeControlDesigner.

Automatické formátování

Můžete vytvořit celou řadu automatických a předdefinovaných formátů, které mohou zjednodušit proces vývojářů stránek, kteří u vlastních ovládacích prvků webového serveru používají komplexní změny stylu. Například TableDesigner ovládací prvek, který je odvozen od ControlDesigner třídy, poskytuje mnoho automatických formátů, ze kterých si vybrat. K implementaci a poskytování automatického formátování ve vlastních ovládacích prvcích použijte následující funkce:

• Vlastnost AutoFormats .

• Metoda OnAutoFormatApplied .

• Třída DesignerAutoFormat .

• Třída DesignerAutoFormatStyle .

Seznamy akcí (inteligentní značky)

Seznamy akcí jsou nabídky důležitých nebo často používaných úloh, které může vývojář stránky, který používá ovládací prvek, provádět v uživatelském rozhraní návrhu, jako je visual Studio 2005. Například zobrazení návrhu ovládacího prvku může poskytnout nabídku dostupných úkolů. To zahrnuje úkol automatického formátování ovládacího prvku. Pokud chcete získat informace o seznamech akcí, začněte s následujícími funkcemi:

• Vlastnost ActionLists .

• Třída DesignerActionList .

• Metoda GetSortedActionItems .

• Třída DesignerActionListCollection .

• Třída DesignerActionMethodItem .

• Třída DesignerActionPropertyItem .

Oblasti návrháře ovládacích prvků

Oblasti jsou upravitelné oblasti v zobrazení návrhu ovládacího prvku webového serveru. Tato funkce nabízí úpravy obsahu šablony, vnitřních ovládacích prvků a vlastností v době návrhu ve formátu WYSIWYG. Návrhář ovládacích prvků můžete nechat vytvářet ovládací prvky v oblastech nebo pomocí sady nástrojů přetahovat ovládací prvky do oblastí. Oblasti se spravují pomocí následujících funkcí:

• Metoda OnClick .

• Třída DesignerRegion .

• Třída EditableDesignerRegion .

• Metoda GetEditableDesignerRegionContent .

• Metoda SetEditableDesignerRegionContent .

Šablony

Model pro vytvoření uživatelského rozhraní pro úpravy ovládacích prvků založených na šablonách, jako GridView je například ovládací prvek, byl výrazně vylepšen oproti dřívějším verzím. Můžete vytvořit složité vlastní ovládací prvky, které obsahují šablony pro různé části ovládacího prvku, a návrhář vlastních ovládacích prvků může vývojářům stránek, kteří upravují šablony, pomoct s následujícími funkcemi:

• Vlastnost TemplateGroups .

• Vlastnost InTemplateMode .

• Třída TemplateGroup .

Vykreslování v době návrhu

Třída ControlDesigner má následující metody pro podporu vykreslování ovládacího prvku webového serveru v době návrhu. Většina těchto metod je stejná jako v předchozích verzích:

• Metoda GetDesignTimeHtml .

• Metoda GetEmptyDesignTimeHtml .

• Metoda GetErrorDesignTimeHtml .

• Metoda UpdateDesignTimeHtml .

• Metoda CreatePlaceHolderDesignTimeHtml .

Konstruktory

Vlastnosti

Metody

Explicitní implementace rozhraní

Platí pro

Viz také

• TemplateGroup
• DesignerAutoFormat
• DesignerActionList
• DesignerRegion
• ContainerControlDesigner
• CompositeControlDesigner
• Úvod do návrhářů ovládacích prvků ASP.NET
• Architektura návrhu
• Ukázkový návrhář ovládacích prvků se seznamy akcí a službami