ControlDesigner 클래스

정의

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

상속

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

파생

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

자세히…

예제

다음 코드 예제에서는 클래스에서 ControlDesigner 파생 되는 간단한 디자이너 클래스를 만드는 방법을 보여 줍니다. 이 컨트롤 디자이너는 사용자 지정 TextControl 클래스를 지원하며 디자인 타임에 컨트롤의 텍스트 크기를 변경하는 명령을 제공합니다. 컨트롤 디자이너는 클래스의 개체 선언에서 컨트롤 디자이너를 DesignerAttribute 지정하여 컨트롤과 TextControl 연결됩니다. 컨트롤 디자이너에서 HTML 태그로 속성 변경 내용을 유지하는 키는 사용자 지정 ActionList 클래스의 메서드에서 ToggleTextSize 찾을 수 있습니다.

예제를 시도하려면 System.Design.dll 어셈블리에 대한 참조를 추가하고 코드를 컴파일합니다.

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>

설명

클래스는 ControlDesigner Visual Studio 2005와 같은 디자인 호스트의 웹 서버 컨트롤에 대한 디자인 타임 지원을 제공하기 위해 상속 및 확장할 수 있는 기본 컨트롤 디자이너 클래스를 제공합니다.

디자인 타임 렌더링을 사용하기 위한 개체 모델이 이전 버전에 비해 개선되었으며, 다음과 같은 새로운 기본 클래스가 간소화된 개체 모델에 대한 액세스를 제공합니다.

• ControlDesigner는 새로운 것은 아니지만 크게 개선되었습니다.

• ContainerControlDesigner.

• CompositeControlDesigner.

자동 형식 지정

사용자 지정 웹 서버 컨트롤에 복잡한 스타일 변경을 적용하는 페이지 개발자의 프로세스를 간소화할 수 있는 다양한 자동 및 미리 정의된 형식을 만들 수 있습니다. 예를 들어 TableDesigner 클래스에서 파생되는 컨트롤은 ControlDesigner 선택할 수 있는 많은 자동 형식을 제공합니다. 사용자 지정 컨트롤에서 자동 서식을 구현하고 제공하려면 다음 기능을 사용합니다.

• AutoFormats 속성

• OnAutoFormatApplied 메서드

• DesignerAutoFormat 클래스입니다.

• DesignerAutoFormatStyle 클래스입니다.

작업 목록(스마트 태그)

작업 목록은 컨트롤을 사용하는 페이지 개발자가 Visual Studio 2005와 같은 디자인 타임 UI(사용자 인터페이스)에서 수행할 수 있는 중요하거나 널리 사용되는 작업의 메뉴입니다. 예를 들어 컨트롤의 디자인 타임 뷰는 사용 가능한 작업의 메뉴를 제공할 수 있습니다. 여기에는 컨트롤의 서식을 자동으로 지정하는 작업이 포함됩니다. 작업 목록에 대해 알아보려면 다음 기능으로 시작합니다.

• ActionLists 속성

• DesignerActionList 클래스입니다.

• GetSortedActionItems 메서드

• DesignerActionListCollection 클래스입니다.

• DesignerActionMethodItem 클래스

• DesignerActionPropertyItem 클래스입니다.

Designer 영역 제어

지역은 웹 서버 컨트롤의 디자인 타임 보기에서 편집 가능한 영역입니다. 이 기능은 디자인 타임에 템플릿 콘텐츠, 내부 컨트롤 및 속성에 대한 WYSIWYG와 유사한 편집 기능을 제공합니다. 컨트롤 디자이너가 지역에 컨트롤을 만들도록 하거나 도구 상자를 사용하여 컨트롤을 영역으로 끌어서 놓을 수 있습니다. 지역은 다음 기능으로 관리됩니다.

• OnClick 메서드

• DesignerRegion 클래스입니다.

• EditableDesignerRegion 클래스입니다.

• GetEditableDesignerRegionContent 메서드

• SetEditableDesignerRegionContent 메서드

템플릿

컨트롤과 같은 템플릿 기반 컨트롤의 디자인 타임 편집을 위한 UI를 GridView 만드는 모델이 이전 버전에서 크게 향상되었습니다. 컨트롤의 다양한 부분에 대한 템플릿을 포함하는 복잡한 사용자 지정 컨트롤을 만들 수 있으며, 사용자 지정 컨트롤 디자이너는 다음 기능을 사용하여 템플릿을 수정하는 페이지 개발자를 도울 수 있습니다.

• TemplateGroups 속성

• InTemplateMode 속성

• TemplateGroup 클래스입니다.

Design-Time 렌더링

ControlDesigner 클래스에는 웹 서버 컨트롤의 디자인 타임 렌더링을 지원하는 다음 메서드가 있습니다. 이러한 메서드의 대부분은 이전 버전과 동일합니다.

• GetDesignTimeHtml 메서드

• GetEmptyDesignTimeHtml 메서드

• GetErrorDesignTimeHtml 메서드

• UpdateDesignTimeHtml 메서드

• CreatePlaceHolderDesignTimeHtml 메서드

생성자

속성

메서드

명시적 인터페이스 구현

적용 대상

추가 정보

• TemplateGroup
• DesignerAutoFormat
• DesignerActionList
• DesignerRegion
• ContainerControlDesigner
• CompositeControlDesigner
• ASP.NET 컨트롤 디자이너 소개
• 디자인 타임 아키텍처
• 작업 목록 및 서비스를 사용하여 샘플 컨트롤 Designer