DesignerRegion Class
TOC
Collapse the table of content
Expand the table of content

DesignerRegion Class

 

Defines a region of content within the design-time markup for the associated control.

Namespace:   System.Web.UI.Design
Assembly:  System.Design (in System.Design.dll)


public class DesignerRegion : DesignerObject

NameDescription
System_CAPS_pubmethodDesignerRegion(ControlDesigner, String)

Initializes a new instance of the DesignerRegion class with the specified name for a control designer.

System_CAPS_pubmethodDesignerRegion(ControlDesigner, String, Boolean)

Initializes a new instance of the DesignerRegion class with the specified name for a control designer, optionally setting the instance as a selectable region in the designer.

NameDescription
System_CAPS_pubpropertyDescription

Gets or sets the description for a designer region.

System_CAPS_pubpropertyDesigner

Gets the associated designer component.(Inherited from DesignerObject.)

System_CAPS_pubpropertyDisplayName

Gets or sets the friendly display name for a designer region.

System_CAPS_pubpropertyEnsureSize

Gets or sets a value indicating whether the region size is to be explicitly set on the designer region by the design host.

System_CAPS_pubpropertyHighlight

Gets or sets a value indicating whether to highlight the designer region on the design surface.

System_CAPS_pubpropertyName

Gets the name of the object.(Inherited from DesignerObject.)

System_CAPS_pubpropertyProperties

Gets the object's properties.(Inherited from DesignerObject.)

System_CAPS_pubpropertySelectable

Gets or sets a value indicating whether the designer region can be selected by the user on the design surface.

System_CAPS_pubpropertySelected

Gets or sets a value indicating whether the designer region is currently selected on the design surface.

System_CAPS_pubpropertyUserData

Gets or sets optional user data to associate with the designer region.

NameDescription
System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetBounds()

Retrieves the size of the designer region on the design surface.

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_protmethodGetService(Type)

Gets a service from the design host, as identified by the provided type.(Inherited from DesignerObject.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

NameDescription
System_CAPS_pubfieldSystem_CAPS_staticDesignerRegionAttributeName

Defines the HTML attribute name for a designer region.

NameDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodIServiceProvider.GetService(Type)

For a description of this member, see IServiceProvider.GetService.(Inherited from DesignerObject.)

The DesignerRegion object represents a region of content within the design-time markup that is generated by a ControlDesigner implementation. A control developer uses designer regions in a custom ControlDesigner implementation to define separate areas within the design-time markup for the associated control and to provide editing and event handling for the area. A visual designer, such as Visual Studio 2005, can use designer regions to display the separate areas of a control on the design surface and to raise user events for the region to the control designer. Designer regions can simplify a control designer implementation because many region-based features are provided by the base designer classes and the visual designer.

The DesignerRegion class provides the base functionality for designer regions, such as the ability to click, select, and highlight a region in the design surface. Use a DesignerRegion object in a control designer implementation to define a region that does not require editing. Use the derived EditableDesignerRegion class in a control designer implementation to define a region with editable content at design time. Use the derived TemplatedEditableDesignerRegion class in a control designer implementation to define an editable region that represents a template in a control.

To support regions within a class that is derived from the ControlDesigner, override the GetDesignTimeHtml method and add one or more initialized DesignerRegion objects to the DesignerRegionCollection collection. Optionally, you can handle mouse clicks in the regions on the design surface by overriding the OnClick method.

Use the properties of a DesignerRegion object to determine how the region is displayed by the visual designer. Override the Selectable property to indicate that the region can be selected by the user on the design surface. Use the Highlight property to highlight the designer region in the visual designer; for example, you can highlight a region after a user has clicked to select it. Use the DisplayName and Description properties to store or retrieve additional details about the region. In particular, the Description property is used by the visual designer to display ToolTip information when the user moves the mouse pointer over the designer region. Use the Designer property to access the methods and properties of the control designer object that contains the designer region.

.NET Framework
Available since 2.0

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show:
© 2016 Microsoft