ControlDesigner 类

定义

提供基控件设计器类,用于扩展 Web 服务器控件的设计模式行为。Provides a base control designer class for extending the design-mode behavior of a Web server control.

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
继承
派生

示例

下面的代码示例演示如何创建一个派生自 ControlDesigner 类的简单设计器类。The following code example demonstrates how to create a simple designer class that derives from the ControlDesigner class. 此控件设计器支持自定义 TextControl 类,并提供在设计时更改控件的文本大小的命令。This control designer supports a custom TextControl class and provides a command to change the text size of a control at design time. 控件设计器通过在 TextControl 类的 DesignerAttribute 对象声明中指定控件设计器,与控件相关联。The control designer is associated with the control by specifying the control designer in a DesignerAttribute object declaration on the TextControl class. 在自定义 ActionList 类的 ToggleTextSize 方法中,可以找到将控件设计器中的属性更改保存到 HTML 标记的键。The key to persisting property changes from the control designer to the HTML markup is found in the ToggleTextSize method of the custom ActionList class.

若要尝试该示例,请添加对 System.web 程序集的引用并编译代码。To try the example, add a reference to the System.Design.dll assembly and compile the code.

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 类提供一个基控件设计器类,该类可以从继承并进行扩展,以在设计宿主中为 Web 服务器控件提供设计时支持,如 Visual Studio 2005Visual Studio 2005The ControlDesigner class provides a base control designer class that can be inherited from and extended to provide design-time support for a Web server control in a design host, such as Visual Studio 2005Visual Studio 2005.

与早期版本相比,用于处理设计时呈现的对象模型通过以下新基类来提供对简化对象模型的访问权限:The object model for working with design-time rendering is improved over earlier versions, with the following new base classes to provide access to the simplified object model:

自动格式设置Automatic Formatting

您可以创建各种自动和预定义的格式,这可以简化将复杂样式更改应用于自定义 Web 服务器控件的页面开发人员的过程。You can create a variety of automatic and pre-defined formats that can simplify the process of page developers who are applying complex style changes to custom Web server controls. 例如,从 ControlDesigner 类派生的 TableDesigner 控件提供了许多自动格式,可从中进行选择。For example, the TableDesigner control, which derives from the ControlDesigner class, provides many automatic formats from which to choose. 若要在自定义控件中实现和提供自动格式设置,请使用以下功能:To implement and provide automatic formatting in your custom controls, use the following features:

操作列表(智能标记)Action Lists (Smart Tags)

操作列表是使用控件的页面开发人员在设计时用户界面(UI)中可以执行的重要或广泛使用的任务的菜单,如 Visual Studio 2005Visual Studio 2005Action lists are menus of important or widely used tasks that a page developer who uses a control can perform in a design-time user interface (UI), such as Visual Studio 2005Visual Studio 2005. 例如,控件的设计时视图可以提供可用任务的菜单。For example, the design-time view of your control could provide a menu of available tasks. 这包括自动设置控件格式的任务。This includes a task to format the control automatically. 若要了解操作列表,请从以下功能开始:To learn about action lists, start with the following features:

控件设计器区域Control Designer Regions

区域是 Web 服务器控件的设计时视图中的可编辑区域。Regions are editable areas in the design-time view of a Web server control. 此功能可在设计时提供类似于所见即所得的模板内容、内部控件和属性的编辑。This feature offers WYSIWYG-like editing of the template content, inner controls, and properties at design time. 您可以让控件设计器在区域中创建控件,也可以使用工具箱将控件拖放到区域中。You can have the control designer create controls in regions or you can use the Toolbox to drag and drop controls into regions. 通过以下功能管理区域:Regions are managed with the following features:

模板Templates

用于创建用于设计时编辑模板化控件(如 GridView 控件)的 UI 的模型已从早期版本大大改进。The model for creating a UI for design-time editing of templated controls, such as the GridView control, has been greatly improved from earlier versions. 您可以创建包含控件各个部分的模板的复杂自定义控件,您的自定义控件设计器可以帮助正在用以下功能修改模板的开发人员:You can create complex custom controls that include templates for various parts of the control, and your custom control designer can help page developers who are modifying templates with the following features:

设计时呈现Design-Time Rendering

ControlDesigner 类具有以下方法,可支持 Web 服务器控件的设计时呈现。The ControlDesigner class has the following methods to support design-time rendering of the Web server control. 其中的大多数方法与早期版本中的方法相同:Most of these methods are the same as in earlier versions:

构造函数

ControlDesigner()

初始化 ControlDesigner 类的新实例。Initializes a new instance of the ControlDesigner class.

属性

ActionLists

获取控件设计器的操作列表集合。Gets the action list collection for the control designer.

AllowResize

获取一个值,该值指示是否可以在设计时环境中调整控件的大小。Gets a value indicating whether the control can be resized in the design-time environment.

AssociatedComponents

获取与设计器所管理的组件关联的组件集合。Gets the collection of components associated with the component managed by the designer.

(继承自 ComponentDesigner)
AutoFormats

获取将在设计时在关联控件的“自动套用格式”对话框中显示的预定义自动格式设置方案的集合。Gets the collection of predefined automatic formatting schemes to display in the Auto Format dialog box for the associated control at design time.

Behavior

获取或设置与设计器关联的 DHTML 行为。Gets or sets the DHTML behavior that is associated with the designer.

(继承自 HtmlControlDesigner)
Component

获取此设计器正在设计的组件。Gets the component this designer is designing.

(继承自 ComponentDesigner)
DataBindings

获取当前控件的数据绑定集合。Gets the data bindings collection for the current control.

(继承自 HtmlControlDesigner)
DataBindingsEnabled

获取一个值,该值指示包含关联控件的区域是否支持数据绑定。Gets a value indicating whether data binding is supported by the containing region for the associated control.

DesignerState

获取用于在设计时保持关联控件数据的对象。Gets an object that is used to persist data for the associated control at design time.

DesignTimeElement

获取一个设计时对象,该对象表示与设计图面上的 HtmlControlDesigner 对象关联的控件。Gets the design-time object representing the control that is associated with the HtmlControlDesigner object on the design surface.

(继承自 HtmlControlDesigner)
DesignTimeElementView

获取控件设计器的视图控件对象。Gets the view-control object for the control designer.

DesignTimeHtmlRequiresLoadComplete

获取一个值,该值指示是否必须在设计宿主完成加载之后才能调用 GetDesignTimeHtml 方法。Gets a value indicating whether the design host must finish loading before the GetDesignTimeHtml method can be called.

Expressions

获取当前控件在设计时的表达式绑定。Gets the expression bindings for the current control at design time.

(继承自 HtmlControlDesigner)
HidePropertiesInTemplateMode

获取一个值,该值指示当控件处于模板模式时,关联控件的属性是否被隐藏。Gets a value indicating whether the properties of the associated control are hidden when the control is in template mode.

ID

获取或设置控件的 ID 字符串。Gets or sets the ID string for the control.

InheritanceAttribute

获取一个特性,该特性指示关联组件的继承类型。Gets an attribute that indicates the type of inheritance of the associated component.

(继承自 ComponentDesigner)
Inherited

获取一个值,该值指示是否继承此组件。Gets a value indicating whether this component is inherited.

(继承自 ComponentDesigner)
InTemplateMode

获取一个值,该值指示控件在设计宿主中是否处于模板查看模式或模板编辑模式之一。Gets a value indicating whether the control is in either template viewing or editing mode in the design host. InTemplateMode 属性为只读。The InTemplateMode property is read-only.

IsDirty

获取或设置一个值,该值指示 Web 服务器控件是否已被标记为已更改。Gets or sets a value indicating whether the Web server control has been marked as changed.

ParentComponent

获取此设计器的父组件。Gets the parent component for this designer.

(继承自 ComponentDesigner)
ReadOnly

获取或设置一个值,该值指示控件的属性在设计时是否为只读。Gets or sets a value indicating whether the properties of the control are read-only at design time.

RootDesigner

获取包含关联控件的 Web 窗体页的控件设计器。Gets the control designer for the Web Forms page that contains the associated control.

ShadowProperties

获取重写用户设置的属性值的集合。Gets a collection of property values that override user settings.

(继承自 ComponentDesigner)
ShouldCodeSerialize

获取或设置一个值,该值指示在序列化期间是否应为当前设计文档在代码隐藏文件中创建控件的字段声明。Gets or sets a value indicating whether to create a field declaration for the control in the code-behind file for the current design document during serialization.

(继承自 HtmlControlDesigner)
Tag

获取表示关联控件的 HTML 标记元素的对象。Gets an object representing the HTML markup element for the associated control.

TemplateGroups

获取一个模板组集合,其中每个模板组包含一个或多个模板定义。Gets a collection of template groups, each containing one or more template definitions.

UsePreviewControl

获取一个值,该值指示控件设计器是否使用临时预览控件来生成设计时 HTML 标记。Gets a value indicating whether the control designer uses a temporary preview control to generate the design-time HTML markup.

Verbs

获取与设计器相关联的组件所支持的设计时谓词。Gets the design-time verbs supported by the component that is associated with the designer.

(继承自 ComponentDesigner)
ViewControl

获取或设置可用于预览设计时 HTML 标记的 Web 服务器控件。Gets or sets a Web server control that can be used for previewing the design-time HTML markup.

ViewControlCreated

获取或设置一个值,该值指示是否已创建 View 控件以在设计图面上显示。Gets or sets a value indicating whether a View control has been created for display on the design surface.

Visible

获取指示该控件在设计时是否可见的值。Gets a value that indicates whether the control is visible at design time.

方法

CreateErrorDesignTimeHtml(String)

创建在设计时显示指定错误消息的 HTML 标记。Creates HTML markup to display a specified error message at design time.

CreateErrorDesignTimeHtml(String, Exception)

创建在设计时显示指定异常错误消息的 HTML 标记。Creates the HTML markup to display a specified exception error message at design time.

CreatePlaceHolderDesignTimeHtml()

提供一个简单的矩形占位符表示形式,该表示形式显示该控件的类型和 ID。Provides a simple rectangular placeholder representation that displays the type and ID of the control.

CreatePlaceHolderDesignTimeHtml(String)

提供一个简单的矩形占位符表示形式,该表示形式显示该控件的类型和 ID 以及指定的附加说明或信息。Provides a simple rectangular placeholder representation that displays the type and ID of the control, and also additional specified instructions or information.

CreateViewControl()

返回要在设计图面上查看或呈现的关联控件的副本。Returns a copy of the associated control for viewing or rendering on the design surface.

Dispose()

释放 ComponentDesigner 使用的所有资源。Releases all resources used by the ComponentDesigner.

(继承自 ComponentDesigner)
Dispose(Boolean)

释放由 HtmlControlDesigner 对象占用的非托管资源,还可以选择释放托管资源。Releases the unmanaged resources that are used by the HtmlControlDesigner object and optionally releases the managed resources.

(继承自 HtmlControlDesigner)
DoDefaultAction()

在源代码文件中为组件的默认事件创建方法签名,并将用户的光标定位到该位置。Creates a method signature in the source code file for the default event on the component and navigates the user's cursor to that location.

(继承自 ComponentDesigner)
Equals(Object)

确定指定的对象是否等于当前对象。Determines whether the specified object is equal to the current object.

(继承自 Object)
GetBounds()

检索矩形的坐标,该矩形表示设计图面上显示的控件的边界。Retrieves the coordinates of the rectangle representing the boundaries for the control as displayed on the design surface.

GetDesignTimeHtml()

检索用于在设计时表示控件的 HTML 标记。Retrieves the HTML markup that is used to represent the control at design time.

GetDesignTimeHtml(DesignerRegionCollection)

检索用当前控件设计器区域显示控件并填充集合的 HTML 标记。Retrieves the HTML markup to display the control and populates the collection with the current control designer regions.

GetDesignTimeResourceProviderFactory(IServiceProvider)

根据站点配置文件中的全球化设置返回相应的资源提供程序工厂。Returns an appropriate resource provider factory, depending on the globalization settings in the configuration file for the site.

GetEditableDesignerRegionContent(EditableDesignerRegion)

返回关联控件设计时视图中可编辑区域的内容。Returns the content for an editable region of the design-time view of the associated control.

GetEmptyDesignTimeHtml()

检索表示在设计时将不具有可视表示形式的运行时 Web 服务器控件的 HTML 标记。Retrieves the HTML markup to represent a Web server control at design time that will have no visual representation at run time.

GetErrorDesignTimeHtml(Exception)

检索提供有关指定异常的信息的 HTML 标记。Retrieves the HTML markup that provides information about the specified exception.

GetHashCode()

用作默认哈希函数。Serves as the default hash function.

(继承自 Object)
GetPersistenceContent()

在设计时检索该控件的持久内部 HTML 标记。Retrieves the persistable inner HTML markup of the control at design time.

GetPersistInnerHtml()

检索控件的持久性内部 HTML 标记。Retrieves the persistable inner HTML markup of the control.

GetService(Type)

尝试从设计器组件的设计模式站点检索指定类型的服务。Attempts to retrieve the specified type of service from the design mode site of the designer's component.

(继承自 ComponentDesigner)
GetType()

获取当前实例的 TypeGets the Type of the current instance.

(继承自 Object)
GetViewRendering()

检索一个对象,该对象包含关联控件的内容和区域的设计时标记。Retrieves an object that contains the design-time markup for the content and regions of the associated control.

GetViewRendering(Control)

检索一个对象,该对象包含指定控件的内容和区域的设计时标记。Retrieves an object that contains the design-time markup for the content and regions of the specified control.

GetViewRendering(ControlDesigner)

检索一个对象,该对象包含指定控件设计器关联控件的内容和区域的设计时标记。Retrieves an object that contains the design-time markup for the content and regions of the associated control for the specified control designer.

Initialize(IComponent)

初始化控件设计器并加载指定的组件。Initializes the control designer and loads the specified component.

InitializeExistingComponent(IDictionary)

重新初始化现有组件。Reinitializes an existing component.

(继承自 ComponentDesigner)
InitializeNewComponent(IDictionary)

初始化新创建的组件。Initializes a newly created component.

(继承自 ComponentDesigner)
InitializeNonDefault()

对已初始化为非默认设置的导入组件的设置进行初始化。Initializes the settings for an imported component that is already initialized to settings other than the defaults.

(继承自 ComponentDesigner)
Invalidate()

使显示在设计图面上的控件的整个区域无效,并向控件设计器发送重新绘制控件的信号。Invalidates the whole area of the control that is displayed on the design surface and signals the control designer to redraw the control.

Invalidate(Rectangle)

使显示在设计图面上的控件的指定区域无效,并向控件设计器发送重新绘制控件的信号。Invalidates the specified area of the control that is displayed on the design surface and signals the control designer to redraw the control.

InvokeGetInheritanceAttribute(ComponentDesigner)

获取指定 InheritanceAttributeComponentDesignerGets the InheritanceAttribute of the specified ComponentDesigner.

(继承自 ComponentDesigner)
InvokeTransactedChange(IComponent, TransactedChangeCallback, Object, String)

使用指定参数将一系列更改包装到事务中,这些指定参数可以通过设计宿主的撤消功能作为一个单元进行回滚。Wraps a series of changes into a transaction, using the specified parameters that can be rolled back as a unit with the undo functionality of the design host.

InvokeTransactedChange(IComponent, TransactedChangeCallback, Object, String, MemberDescriptor)

使用指定参数将一系列更改包装到事务中,这些指定参数可以通过设计宿主的撤消功能作为一个单元进行回滚。Wraps a series of changes into a transaction, using the specified parameters that can be rolled back as a unit with the undo functionality of the design host.

InvokeTransactedChange(IServiceProvider, IComponent, TransactedChangeCallback, Object, String, MemberDescriptor)

使用指定参数将一系列更改包装到事务中,这些指定参数可以通过设计宿主的撤消功能作为一个单元进行回滚。Wraps a series of changes into a transaction, using the specified parameters that can be rolled back as a unit with the undo functionality of the design host.

IsPropertyBound(String)

检索一个值,该值指示关联控件上的指定属性是否是数据绑定的。Retrieves a value indicating whether the specified property on the associated control is data-bound.

Localize(IDesignTimeResourceWriter)

使用提供的资源编写器将关联控件的可本地化属性保持到设计宿主中的某个资源。Uses the provided resource writer to persist the localizable properties of the associated control to a resource in the design host.

MemberwiseClone()

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(继承自 Object)
OnAutoFormatApplied(DesignerAutoFormat)

对关联控件应用预定义的自动格式设置方案后调用。Called when a predefined, automatic formatting scheme has been applied to the associated control.

OnBehaviorAttached()

将控件设计器附加到 Behavior 对象时调用。Called when the control designer is attached to a Behavior object.

OnBehaviorDetaching()

当某个行为与该元素取消关联时被调用。Called when a behavior disassociates from the element.

(继承自 HtmlControlDesigner)
OnBindingsCollectionChanged(String)

在数据绑定集合发生更改时调用。Called when the data-binding collection changes.

OnClick(DesignerRegionMouseEventArgs)

当用户在设计时单击关联控件时由设计宿主调用。Called by the design host when the user clicks the associated control at design time.

OnComponentChanged(Object, ComponentChangedEventArgs)

在关联控件发生更改时调用。Called when the associated control changes.

OnComponentChanging(Object, ComponentChangingEventArgs)

表示将处理关联控件的 ComponentChanging 事件的方法。Represents the method that will handle the ComponentChanging event for the associated control.

OnControlResize()

关联的 Web 服务器控件的大小在设计宿主中发生设计时调整后被调用。Called when the associated Web server control has been resized in the design host at design time.

OnPaint(PaintEventArgs)

当控件设计器在设计图面上绘制关联控件,且 CustomPaint 的值为 true 时调用。Called when the control designer draws the associated control on the design surface, if the CustomPaint value is true.

OnSetComponentDefaults()

设置组件的默认属性。Sets the default properties for the component.

(继承自 ComponentDesigner)
OnSetParent()

提供一种在将关联控件附加到父控件时执行附加处理的方式。Provides a way to perform additional processing when the associated control is attached to a parent control.

(继承自 HtmlControlDesigner)
PostFilterAttributes(IDictionary)

允许设计器从通过 TypeDescriptor 公开的特性集中更改或移除项。Allows a designer to change or remove items from the set of attributes that it exposes through a TypeDescriptor.

(继承自 ComponentDesigner)
PostFilterEvents(IDictionary)

允许设计器从通过 TypeDescriptor 公开的事件集中更改或移除项。Allows a designer to change or remove items from the set of events that it exposes through a TypeDescriptor.

(继承自 ComponentDesigner)
PostFilterProperties(IDictionary)

允许设计器从通过 TypeDescriptor 公开的属性集中更改或移除项。Allows a designer to change or remove items from the set of properties that it exposes through a TypeDescriptor.

(继承自 ComponentDesigner)
PreFilterAttributes(IDictionary)

允许设计器在通过 TypeDescriptor 公开的特性集中添加项。Allows a designer to add to the set of attributes that it exposes through a TypeDescriptor.

(继承自 ComponentDesigner)
PreFilterEvents(IDictionary)

设置在设计时为用于组件的 TypeDescriptor 对象公开的事件列表。Sets the list of events that are exposed at design-time for the TypeDescriptor object for the component.

(继承自 HtmlControlDesigner)
PreFilterProperties(IDictionary)

在设计时向设计宿主中的“属性”网格添加属性或从中移除属性,或提供可能与关联控件上的属性相对应的新设计时属性。Adds properties to or removes properties from the Properties grid in a design host at design time or provides new design-time properties that might correspond to properties on the associated control.

RaiseComponentChanged(MemberDescriptor, Object, Object)

通知 IComponentChangeService 此组件已被更改。Notifies the IComponentChangeService that this component has been changed.

(继承自 ComponentDesigner)
RaiseComponentChanging(MemberDescriptor)

通知 IComponentChangeService 此组件即将被更改。Notifies the IComponentChangeService that this component is about to be changed.

(继承自 ComponentDesigner)
RaiseResizeEvent()

引发 OnControlResize() 事件。Raises the OnControlResize() event.

RegisterClone(Object, Object)

注册克隆控件中的内部数据。Registers internal data in a cloned control.

SetEditableDesignerRegionContent(EditableDesignerRegion, String)

指定设计时控件可编辑区域的内容。Specifies the content for an editable region of the control at design time.

SetRegionContent(EditableDesignerRegion, String)

指定控件设计时视图中可编辑区域的内容。Specifies the content for an editable region in the design-time view of the control.

SetViewFlags(ViewFlags, Boolean)

将指定的按位 ViewFlags 枚举分配给指定的标志值。Assigns the specified bitwise ViewFlags enumeration to the specified flag value.

ToString()

返回一个表示当前对象的 string。Returns a string that represents the current object.

(继承自 Object)
UpdateDesignTimeHtml()

通过调用 GetDesignTimeHtml 方法刷新关联 Web 服务器控件的设计时 HTML 标记。Refreshes the design-time HTML markup for the associated Web server control by calling the GetDesignTimeHtml method.

显式接口实现

IDesignerFilter.PostFilterAttributes(IDictionary)

有关此成员的说明,请参见 PostFilterAttributes(IDictionary) 方法。For a description of this member, see the PostFilterAttributes(IDictionary) method.

(继承自 ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)

有关此成员的说明,请参见 PostFilterEvents(IDictionary) 方法。For a description of this member, see the PostFilterEvents(IDictionary) method.

(继承自 ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)

有关此成员的说明,请参见 PostFilterProperties(IDictionary) 方法。For a description of this member, see the PostFilterProperties(IDictionary) method.

(继承自 ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)

有关此成员的说明,请参见 PreFilterAttributes(IDictionary) 方法。For a description of this member, see the PreFilterAttributes(IDictionary) method.

(继承自 ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)

有关此成员的说明,请参见 PreFilterEvents(IDictionary) 方法。For a description of this member, see the PreFilterEvents(IDictionary) method.

(继承自 ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)

有关此成员的说明,请参见 PreFilterProperties(IDictionary) 方法。For a description of this member, see the PreFilterProperties(IDictionary) method.

(继承自 ComponentDesigner)
ITreeDesigner.Children

有关此成员的说明,请参见 Children 属性。For a description of this member, see the Children property.

(继承自 ComponentDesigner)
ITreeDesigner.Parent

有关此成员的说明,请参见 Parent 属性。For a description of this member, see the Parent property.

(继承自 ComponentDesigner)

适用于

另请参阅