DesignerRegion Класс

Определение

Определяет для связанного элемента управления область содержимого внутри разметки времени разработки.Defines a region of content within the design-time markup for the associated control.

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
Производный

Комментарии

DesignerRegionОбъект представляет область содержимого в разметке времени разработки, создаваемой ControlDesigner реализацией.The DesignerRegion object represents a region of content within the design-time markup that is generated by a ControlDesigner implementation. Разработчик элемента управления использует области конструктора в пользовательской ControlDesigner реализации для определения отдельных областей внутри разметки времени разработки для связанного элемента управления, а также для обеспечения редактирования и обработки событий для области.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. Визуальный конструктор, например Visual Studio 2005Visual Studio 2005 , может использовать области конструктора для отображения отдельных областей элемента управления в области конструктора и для вызова пользовательских событий для области в конструкторе элементов управления.A visual designer, such as Visual Studio 2005Visual 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.

DesignerRegionКласс предоставляет базовую функциональность для областей конструктора, например возможность щелкнуть, выбрать и выделить область в области конструктора.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. Используйте DesignerRegion объект в реализации конструктора элементов управления для определения области, которая не требует редактирования.Use a DesignerRegion object in a control designer implementation to define a region that does not require editing. Используйте производный EditableDesignerRegion класс в реализации конструктора элементов управления, чтобы определить область с редактируемым содержимым во время разработки.Use the derived EditableDesignerRegion class in a control designer implementation to define a region with editable content at design time. Используйте производный TemplatedEditableDesignerRegion класс в реализации конструктора элементов управления, чтобы определить изменяемую область, представляющую шаблон в элементе управления.Use the derived TemplatedEditableDesignerRegion class in a control designer implementation to define an editable region that represents a template in a control.

Для поддержки регионов внутри класса, производного от ControlDesigner , переопределите GetDesignTimeHtml метод и добавьте в коллекцию один или несколько инициализированных DesignerRegion объектов DesignerRegionCollection .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. При необходимости можно управлять щелчками мыши в регионах в области конструктора, переопределяя OnClick метод.Optionally, you can handle mouse clicks in the regions on the design surface by overriding the OnClick method.

Используйте свойства DesignerRegion объекта, чтобы определить способ отображения области визуальным конструктором.Use the properties of a DesignerRegion object to determine how the region is displayed by the visual designer. Переопределите Selectable свойство, чтобы указать, что область может быть выбрана пользователем в области конструктора.Override the Selectable property to indicate that the region can be selected by the user on the design surface. Используйте Highlight свойство, чтобы выделить область конструктора в визуальном конструкторе. Например, можно выделить область после нажатия пользователем, чтобы выбрать ее.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. Используйте DisplayName Свойства и Description для хранения или получения дополнительных сведений о регионе.Use the DisplayName and Description properties to store or retrieve additional details about the region. В частности, Description свойство используется визуальным конструктором для отображения сведений о подсказке, когда пользователь наводит указатель мыши на область конструктора.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. Используйте Designer свойство для доступа к методам и свойствам объекта конструктора элементов управления, который содержит область конструктора.Use the Designer property to access the methods and properties of the control designer object that contains the designer region.

Конструкторы

DesignerRegion(ControlDesigner, String)

Инициализирует новый экземпляр класса DesignerRegion, используя заданное имя для конструктора элемента управления.Initializes a new instance of the DesignerRegion class with the specified name for a control designer.

DesignerRegion(ControlDesigner, String, Boolean)

Инициализирует новый экземпляр класса DesignerRegion, используя заданное имя конструктора элемента управления и, при необходимости, определяя экземпляр как выделяемую область в конструкторе.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.

Поля

DesignerRegionAttributeName

Определяет имя HTML-атрибута для области конструктора.Defines the HTML attribute name for a designer region.

Свойства

Description

Получает или задает описание области конструктора.Gets or sets the description for a designer region.

Designer

Возвращает связанный компонент конструктора.Gets the associated designer component.

(Унаследовано от DesignerObject)
DisplayName

Получает или задает для области конструктора понятное отображаемое имя.Gets or sets the friendly display name for a designer region.

EnsureSize

Получает или задает значение, показывающее, должен ли узел разработки явно задавать размер для области конструктора.Gets or sets a value indicating whether the region size is to be explicitly set on the designer region by the design host.

Highlight

Получает или задает значение, показывающее, выделять ли область конструктора в области разработки.Gets or sets a value indicating whether to highlight the designer region on the design surface.

Name

Возвращает имя объекта.Gets the name of the object.

(Унаследовано от DesignerObject)
Properties

Возвращает свойства объекта.Gets the object's properties.

(Унаследовано от DesignerObject)
Selectable

Получает или задает значение, показывающее, может ли пользователь выбирать область конструктора в области разработки.Gets or sets a value indicating whether the designer region can be selected by the user on the design surface.

Selected

Получает или задает значение, показывающее, выбрана ли в данный момент область конструктора в области разработки.Gets or sets a value indicating whether the designer region is currently selected on the design surface.

UserData

Получает или задает необязательные пользовательские данные, связываемые с областью конструктора.Gets or sets optional user data to associate with the designer region.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetBounds()

Возвращает размер области конструктора в области разработки.Retrieves the size of the designer region on the design surface.

GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetService(Type)

Возвращает службу из узла разработки, как определено предоставленным типом.Gets a service from the design host, as identified by the provided type.

(Унаследовано от DesignerObject)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Явные реализации интерфейса

IServiceProvider.GetService(Type)

Описание этого члена см. в разделе GetService(Type).For a description of this member, see GetService(Type).

(Унаследовано от DesignerObject)

Применяется к

См. также раздел