PanelContainerDesigner 类

定义

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

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

type PanelContainerDesigner = class
    inherit ContainerControlDesigner

Public Class PanelContainerDesigner
Inherits ContainerControlDesigner

继承

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

ContainerControlDesigner

PanelContainerDesigner

示例

下面的代码示例演示如何扩展 PanelContainerDesigner 类，以更改在设计时派生自 控件 Panel 的控件的外观和行为。

该示例从 Panel 控件派生 MyPanelContainer 类。 该示例还从 类派生 MyPanelContainerDesigner 类，PanelContainerDesigner并在 类上MyPanelContainer应用 DesignerAttribute 属性MyPanelContainerDesigner。

将 MyPanelContainerDesigner 替代以下 PanelContainerDesigner 成员：

• 用于 FrameStyle 定义控件的设计时边框样式的属性 MyPanelContainer 。

• 用于 FrameCaption 为 MyPanelContainer 控件提供默认标题（如果未定义）的属性。

• 如果Initialize关联的控件不是 MyPanelContainer 对象，则引发ArgumentException异常的方法。

using System;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.Design.WebControls;
using System.ComponentModel;
using System.Security.Permissions;

namespace Examples.CS.WebControls.Design
{
    // The MyPanelContainer is a copy of the Panel.
    [AspNetHostingPermission(SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [Designer(typeof(Examples.CS.WebControls.Design.MyPanelContainerDesigner))]
    public class MyPanelContainer : Panel
    {
    } // MyPanelContainer

    // Override members of the PanelContainerDesigner.
    public class MyPanelContainerDesigner : PanelContainerDesigner
    {
        // Provide a design-time caption for the panel.
        public override string FrameCaption 
        {
            get
            {
                // If the FrameCaption is empty, use the panel control ID.
                string localCaption = base.FrameCaption;
                if (localCaption == null || localCaption == "")
                    localCaption = ((Panel)Component).ID.ToString();

                return localCaption;
            }
        } // FrameCaption

        // Provide a design-time border style for the panel.
        public override Style FrameStyle
        {
            get
            {
                Style styleOfFrame = base.FrameStyle;

                // If no border style is defined, define one.
                if (styleOfFrame.BorderStyle == BorderStyle.NotSet ||
                    styleOfFrame.BorderStyle == BorderStyle.None)
                    styleOfFrame.BorderStyle = BorderStyle.Outset;

                return styleOfFrame;
            }
        } // FrameStyle

        // Initialize the designer.
        public override void Initialize(IComponent component)
        {
            // Ensure that only a MyPanelContainer can be created 
            // in this designer.
            if (!(component is MyPanelContainer))
                throw new ArgumentException();
            
            base.Initialize(component);
        } // Initialize
    } // MyPanelContainerDesigner
} // Examples.CS.WebControls.Design

Imports System.Web
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls
Imports System.ComponentModel
Imports System.Security.Permissions

Namespace Examples.VB.WebControls.Design

    ' The MyPanelContainer is a copy of the PanelContainer.
    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <Designer(GetType(Examples.VB.WebControls.Design.MyPanelContainerDesigner))> _
    Public Class MyPanelContainer
        Inherits Panel
    End Class

    ' Override members of the PanelContainerDesigner.
    Public Class MyPanelContainerDesigner
        Inherits PanelContainerDesigner

        ' Provide a design-time caption for the panel.
        Public Overrides ReadOnly Property FrameCaption() As String
            Get
                ' If the FrameCaption is empty, use the panel control ID.
                Dim localCaption As String = MyBase.FrameCaption
                If localCaption Is Nothing Or localCaption = "" Then
                    localCaption = CType(Component, Panel).ID.ToString()
                End If

                Return localCaption
            End Get
        End Property ' FrameCaption

        ' Provide a design-time border style for the panel.
        Public Overrides ReadOnly Property FrameStyle() As Style
            Get
                Dim styleOfFrame As Style = MyBase.FrameStyle

                ' If no border style is defined, define one.
                If (styleOfFrame.BorderStyle = BorderStyle.NotSet Or _
                    styleOfFrame.BorderStyle = BorderStyle.None) Then
                    styleOfFrame.BorderStyle = BorderStyle.Outset
                End If

                Return styleOfFrame
            End Get
        End Property ' FrameStyle

        ' Initialize the designer.
        Public Overrides Sub Initialize(ByVal component As IComponent)

            ' Ensure that only a MyPanelContainer can be created   
            ' in this designer. 
            If Not TypeOf component Is MyPanelContainer Then
                Throw New ArgumentException()
            End If

            MyBase.Initialize(component)

        End Sub
    End Class
End Namespace ' Examples.VB.WebControls.Design

注解

控件 Panel 用作其他控件的容器，尤其是在以编程方式生成控件时。

在可视化设计器中，从“源”切换到“设计”视图时，将分析描述关联 Panel 控件的标记源代码，并在设计图面上创建控件的设计时版本。 切换回“源”视图时，设计时控件将保留以标记源代码，并编辑为网页的标记。 类 PanelContainerDesigner 为可视化设计器中的控件提供设计时支持 Panel 。

属性 FrameCaption 获取显示在关联 Panel 控件上的标题。 属性 FrameStyle 获取关联控件的样式。

属性 UsePreviewControl 始终返回 true，指示设计器创建关联的 Panel 的临时副本以生成设计时标记。

方法 Initialize 使设计器准备好查看、编辑和设计关联的 Panel 控件。 方法 AddDesignTimeCssAttributes 将集合元素设置为关联控件的各种样式属性的字符串表示形式。

构造函数

属性

方法

显式接口实现

适用于

另请参阅

• Panel
• ContainerControlDesigner
• ControlDesigner
• HtmlControlDesigner
• ComponentDesigner
• ASP.NET 控件设计器简介
• 演练：为 Web 服务器控件创建基本控件设计器