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が編集可能なデザイン領域の内容をコントロールの編集可能な内部プロパティとして表していることを示します。

コントロール開発者は、次の一覧で定義されているように、開発されるコントロールの種類に応じて、いくつかの基本デザイナーの 1 つからカスタム デザイナーを派生および拡張できます。

• デザイン時に子コントロールを追加できるようにするコントロールは、 ContainerControlDesigner クラスから派生できます。 たとえば、 PanelContainerDesigner クラスは ContainerControlDesigner クラスから派生し、デザイン サーフェイスの Panel コントロールを表します。

• 1 つ以上の子コントロールを持ち、デザイン時にコントロールを追加できる編集可能なデザイナー領域を持つコントロールは、 CompositeControlDesigner クラスから派生できます。

• カスタムのデザイン時処理を必要とするコントロールは、基本 ControlDesigner クラスから派生できます。

DesignerAttribute属性を使用して、カスタム デザイナー クラスをカスタム コントロールの実装と関連付けます。 カスタム コントロールでコントロール デザイナーを使用する方法の詳細については、「 チュートリアル: Web サーバー コントロールの基本的なコントロール デザイナーを作成する」を参照してください。

こちらもご覧ください

• ControlDesigner
• CompositeControlDesigner
• EditableDesignerRegion
• Panel
• PanelContainerDesigner
• ASP.NET コントロール デザイナーの概要
• 属性と Design-Time サポート