DesignerRegion 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
为关联控件定义设计时标记内的内容区域。
public ref class DesignerRegion : System::Web::UI::Design::DesignerObject
public class DesignerRegion : System.Web.UI.Design.DesignerObject
type DesignerRegion = class
inherit DesignerObject
Public Class DesignerRegion
Inherits DesignerObject
- 继承
- 派生
注解
对象 DesignerRegion 表示由实现生成的 ControlDesigner 设计时标记中的内容区域。 控件开发人员使用自定义 ControlDesigner 实现中的设计器区域为关联的控件在设计时标记中定义单独的区域,并为该区域提供编辑和事件处理。 视觉设计器(如 Visual Studio 2005)可以使用设计器区域在设计图面上显示控件的单独区域,并将该区域的用户事件引发给控件设计器。 设计器区域可以简化控件设计器实现,因为许多基于区域的功能由基本设计器类和可视化设计器提供。
类 DesignerRegion 为设计器区域提供基本功能,例如在设计图面中单击、选择和突出显示区域的功能。 DesignerRegion在控件设计器实现中使用 对象来定义不需要编辑的区域。 在控件设计器实现中使用派生 EditableDesignerRegion 类在设计时定义具有可编辑内容的区域。 在控件设计器实现中使用派生 TemplatedEditableDesignerRegion 类来定义表示控件中模板的可编辑区域。
若要支持派生自 ControlDesigner的类中的区域,请重写 GetDesignTimeHtml 方法,并将一个或多个初始化 DesignerRegion 对象添加到集合中 DesignerRegionCollection 。 (可选)可以通过重写 OnClick 方法来处理设计图面上区域中的鼠标单击。
使用 对象的属性 DesignerRegion 确定视觉对象设计器如何显示区域。 Selectable重写 属性以指示用户可以在设计图面上选择该区域。 Highlight使用 属性在可视化设计器中突出显示设计器区域;例如,可以在用户单击以选择该区域后突出显示该区域。 DisplayName使用 和 Description 属性来存储或检索有关该区域的其他详细信息。 具体而言, Description 当用户将鼠标指针移到设计器区域上时,视觉对象设计器使用 属性来显示工具提示信息。 Designer使用 属性访问包含设计器区域的控件设计器对象的方法和属性。
构造函数
DesignerRegion(ControlDesigner, String) |
用某个控件设计器的指定名称初始化 DesignerRegion 类的新实例。 |
DesignerRegion(ControlDesigner, String, Boolean) |
用某个控件设计器的指定名称初始化 DesignerRegion 类的新实例,还可以选择将该实例设置为设计器中的可选区域。 |
字段
DesignerRegionAttributeName |
为设计器区域定义 HTML 特性名称。 |
属性
Description |
获取或设置设计器区域的说明。 |
Designer |
获取关联的设计器组件。 (继承自 DesignerObject) |
DisplayName |
获取或设置设计器区域的友好显示名称。 |
EnsureSize |
获取或设置一个值,指示设计宿主是否在设计器区域上显式设置区域大小。 |
Highlight |
获取或设置一个值,指示是否在设计图面上突出显示设计器区域。 |
Name |
获取对象的名称。 (继承自 DesignerObject) |
Properties |
获取对象的属性。 (继承自 DesignerObject) |
Selectable |
获取或设置一个值,指示用户是否可以在设计图面上选择该设计器区域。 |
Selected |
获取或设置一个值,指示设计图面上的设计器区域当前是否被选中。 |
UserData |
获取或设置可选用户数据,以关联设计器区域。 |
方法
Equals(Object) |
确定指定对象是否等于当前对象。 (继承自 Object) |
GetBounds() |
检索设计图面上设计器区域的大小。 |
GetHashCode() |
作为默认哈希函数。 (继承自 Object) |
GetService(Type) |
从设计宿主中获取由所提供的类型标识的服务。 (继承自 DesignerObject) |
GetType() |
获取当前实例的 Type。 (继承自 Object) |
MemberwiseClone() |
创建当前 Object 的浅表副本。 (继承自 Object) |
ToString() |
返回表示当前对象的字符串。 (继承自 Object) |
显式接口实现
IServiceProvider.GetService(Type) |
有关此成员的说明,请参见 GetService(Type)。 (继承自 DesignerObject) |