ContainerControlDesigner 類別

定義

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

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

type ContainerControlDesigner = class
    inherit ControlDesigner

Public Class ContainerControlDesigner
Inherits ControlDesigner

繼承

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

ContainerControlDesigner

衍生

System.Web.UI.Design.WebControls.MultiViewDesigner

System.Web.UI.Design.WebControls.PanelContainerDesigner

System.Web.UI.Design.WebControls.ViewDesigner

範例

以下程式碼範例示範如何從 ContainerControlDesigner 該類別推導出設計類別。 範例定義了一個由 CompositeControl 類別衍生的簡單控制項，接著定義了由類別衍生 ContainerControlDesigner 出的相關設計器。 衍生設計類別會 FrameCaption 覆寫 和 FrameStyle 屬性，以自訂設計表面控制項可編輯區域周圍的框架。

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

namespace ControlDesignerSamples.CS
{

    // Define a simple composite control, derived from the 
    // System.Web.UI.WebControls.CompositeControl class.
    [
        Designer(typeof(SimpleContainerControlDesigner)) , 
        ParseChildren(false)
    ]
    public class SimpleContainerControl : CompositeControl
    {
    }


    // Define the designer for the simple composite control.
    // The designer derives from System.Web.UI.Design.ContainerControlDesigner.
    // The designer defines the style and caption for frame around the 
    // editable region in the design surface.
    public class SimpleContainerControlDesigner : ContainerControlDesigner
    {
        private Style _style = null;

        // Define the caption text for the frame in the design surface.
        public override string FrameCaption
        {
            get
            {
                return "= My simple container control =";
            }
        }

        // Define the style of the frame around the control in the design surface.
        public override Style FrameStyle
        {
            get
            {
                if (_style == null)
                {
                    _style = new Style();
                    _style.Font.Name = "Verdana";
                    _style.Font.Size = new FontUnit("XSmall");
                    _style.BackColor = Color.LavenderBlush;
                    _style.ForeColor = Color.DarkBlue;
                }

                return _style;
            }
        }
    }
}

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

Namespace ControlDesignerSamples.VB


    ' Define a simple composite control, derived from the 
    ' System.Web.UI.WebControls.CompositeControl class.

    <Designer(GetType(SimpleContainerControlDesigner)), _
     ParseChildren(False)> _
    Public Class SimpleContainerControl
        Inherits CompositeControl

    End Class


    ' Define the designer for the simple composite control.
    ' The designer derives from System.Web.UI.Design.ContainerControlDesigner.
    ' The designer defines the style and caption for the frame around the 
    ' editable region of the control in the design surface.
    Public Class SimpleContainerControlDesigner
        Inherits ContainerControlDesigner

        Private _style As Style = Nothing

        ' Define the caption text for the frame in the design surface.
        Public Overrides ReadOnly Property FrameCaption() As String
            Get
                Return "- My simple container control -"
            End Get
        End Property


        ' Define the style of the frame around the control in the design surface.
        Public Overrides ReadOnly Property FrameStyle() As Style
            Get
                If _style Is Nothing Then

                    _style = New Style()
                    _style.Font.Name = "Verdana"
                    _style.Font.Size = New FontUnit("XSmall")
                    _style.BackColor = Color.LavenderBlush
                    _style.ForeColor = Color.DarkBlue
                End If

                Return _style
            End Get
        End Property


    End Class

End Namespace

備註

該 ContainerControlDesigner 類別提供一個基礎設計類別，用於可在設計表面上修改的控制項。 這包括包含子控制項或可編輯內部屬性的控制項。 它 ContainerControlDesigner 提供一個單一的框架區域來表示控制項，並在設計時自動處理控制的渲染。

對相關控制項套用屬性 ParseChildrenAttribute ，以判斷 ContainerControlDesigner。 對相關控制項套用 ParseChildrenAttribute 以下設定：

• false 用以表示 代表 ContainerControlDesigner 可編輯設計區域的內容，作為子控制項。

• true 表示 表示可 ContainerControlDesigner 編輯設計區域的內容，作為控制項的可編輯內部屬性。

控制開發者可根據所開發控制類型，從多個基礎設計器中推導並擴展自訂設計器，定義如下清單：

• 允許在設計時加入子控制項的控制項，可以從 ContainerControlDesigner 類別中衍生出來。 例如，類別 PanelContainerDesigner 由 ContainerControlDesigner 類別衍生，代表 Panel 設計曲面上的一個控制項。

• 擁有一個或多個子控制項，且可能有可編輯的設計區域，可在設計時新增控制項，這些控制項可從 CompositeControlDesigner 類別衍生。

• 需要自訂設計時處理的控制項可由基底 ControlDesigner 類別衍生而來。

使用屬性 DesignerAttribute 將自訂設計師類別與自訂控制實作關聯起來。 欲了解如何使用帶有自訂控制項的控制設計器詳細資訊，請參閱 「攻略：建立網頁伺服器控制的基本控制設計器」。

另請參閱

• ControlDesigner
• CompositeControlDesigner
• EditableDesignerRegion
• Panel
• PanelContainerDesigner
• ASP.NET 控制設計師簡介
• 屬性與 Design-Time 支援