ControlDesigner Klas

Definitie

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

Overname

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

Afgeleid

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

Meer…

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een eenvoudige ontwerpklasse maakt die is afgeleid van de ControlDesigner klasse. Deze ontwerpfunctie voor besturingselementen ondersteunt een aangepaste TextControl klasse en biedt een opdracht om de tekstgrootte van een besturingselement tijdens het ontwerp te wijzigen. De ontwerpfunctie voor besturingselementen is gekoppeld aan het besturingselement door de ontwerpfunctie voor besturingselementen op te geven in een DesignerAttribute objectdeclaratie op de TextControl klasse. De sleutel voor het behouden van eigenschapswijzigingen van de ontwerpfunctie voor besturingselementen in de HTML-opmaak is te vinden in de ToggleTextSize methode van de aangepaste ActionList klasse.

Als u het voorbeeld wilt proberen, voegt u een verwijzing naar de System.Design.dll assembly toe en compileert u de code.

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>

Opmerkingen

De klasse ControlDesigner biedt een ontwerpklasse voor basisbesturingselementen die kan worden overgenomen van en uitgebreid om ontwerptijdondersteuning te bieden voor een webserverbesturingselement in een ontwerphost, zoals Visual Studio 2005.

Het objectmodel voor het werken met ontwerptijdweergave wordt verbeterd ten opzichte van eerdere versies, met de volgende nieuwe basisklassen om toegang te bieden tot het vereenvoudigde objectmodel:

• ControlDesigner, dat is niet nieuw, maar is aanzienlijk verbeterd.

• ContainerControlDesigner.

• CompositeControlDesigner.

Automatische opmaak

U kunt verschillende automatische en vooraf gedefinieerde indelingen maken die het proces van paginaontwikkelaars die complexe stijlwijzigingen toepassen op aangepaste webserverbesturingselementen vereenvoudigen. Het besturingselement, dat is afgeleid van de TableDesigner klasse, biedt bijvoorbeeld ControlDesigner veel automatische notaties waaruit u kunt kiezen. Gebruik de volgende functies om automatische opmaak in uw aangepaste besturingselementen te implementeren en te bieden:

• De eigenschap AutoFormats.

• De OnAutoFormatApplied methode.

• De DesignerAutoFormat klas.

• De DesignerAutoFormatStyle klas.

Actielijsten (infolabels)

Actielijsten zijn menu's met belangrijke of veelgebruikte taken die een paginaontwikkelaar die een besturingselement gebruikt, kan uitvoeren in een gebruikersinterface (Design Time User Interface), zoals Visual Studio 2005. De ontwerptijdweergave van uw besturingselement kan bijvoorbeeld een menu met beschikbare taken bieden. Dit omvat een taak om het besturingselement automatisch op te maken. Als u meer wilt weten over actielijsten, begint u met de volgende functies:

• De eigenschap ActionLists.

• De DesignerActionList klas.

• De GetSortedActionItems methode.

• De DesignerActionListCollection klas.

• De DesignerActionMethodItem klas.

• De DesignerActionPropertyItem klas.

Ontwerpregio's beheren

Regio's zijn bewerkbare gebieden in de ontwerptijdweergave van een webserverbesturingselement. Deze functie biedt WYSIWYG-achtige bewerking van de sjablooninhoud, binnenste besturingselementen en eigenschappen tijdens het ontwerp. U kunt besturingselementen in regio's laten maken met de ontwerpfunctie voor besturingselementen of u kunt de werkset gebruiken om besturingselementen naar regio's te slepen en neer te zetten. Regio's worden beheerd met de volgende functies:

• De OnClick methode.

• De DesignerRegion klas.

• De EditableDesignerRegion klas.

• De GetEditableDesignerRegionContent methode.

• De SetEditableDesignerRegionContent methode.

Templates

Het model voor het maken van een gebruikersinterface voor ontwerptijdbewerking van sjabloonbesturingselementen, zoals het GridView besturingselement, is aanzienlijk verbeterd ten aanzien van eerdere versies. U kunt complexe aangepaste besturingselementen maken die sjablonen bevatten voor verschillende onderdelen van het besturingselement en uw aangepaste ontwerpfunctie voor besturingselementen kan ontwikkelaars van pagina's helpen die sjablonen wijzigen met de volgende functies:

• De eigenschap TemplateGroups.

• De eigenschap InTemplateMode.

• De TemplateGroup klas.

Design-Time rendering

De ControlDesigner klasse heeft de volgende methoden ter ondersteuning van ontwerptijdweergave van het webserverbesturingselement. De meeste van deze methoden zijn hetzelfde als in eerdere versies:

• De GetDesignTimeHtml methode.

• De GetEmptyDesignTimeHtml methode.

• De GetErrorDesignTimeHtml methode.

• De UpdateDesignTimeHtml methode.

• De CreatePlaceHolderDesignTimeHtml methode.

Zie ook

• TemplateGroup
• DesignerAutoFormat
• DesignerActionList
• DesignerRegion
• ContainerControlDesigner
• CompositeControlDesigner
• Toegang tot ASP.NET Besturingsontwerpers
• Design-Time Architectuur
• Voorbeeld van ontwerpfunctie voor besturingselementen met actielijsten en -services