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使用 特性将自定义设计器类与自定义控件实现相关联。 有关如何将控件设计器与自定义控件配合使用的详细信息，请参阅 演练：为 Web 服务器控件创建基本控件设计器。

构造函数

属性

方法

显式接口实现

适用于

另请参阅

• ControlDesigner
• CompositeControlDesigner
• EditableDesignerRegion
• Panel
• PanelContainerDesigner
• ASP.NET 控件设计器简介
• 特性与设计时支持