DesignerRegion Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет для связанного элемента управления область содержимого внутри разметки времени разработки.
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) |
Методы расширения
GetKeyedService<T>(IServiceProvider, Object) |
Возвращает службу типа |
GetKeyedServices(IServiceProvider, Type, Object) |
Возвращает перечисление служб типа |
GetKeyedServices<T>(IServiceProvider, Object) |
Возвращает перечисление служб типа |
GetRequiredKeyedService(IServiceProvider, Type, Object) |
Возвращает службу типа |
GetRequiredKeyedService<T>(IServiceProvider, Object) |
Возвращает службу типа |
CreateAsyncScope(IServiceProvider) |
Создает интерфейс AsyncServiceScope, который может использоваться для разрешения служб с ограниченной областью. |
CreateScope(IServiceProvider) |
Создает интерфейс IServiceScope, который может использоваться для разрешения служб с ограниченной областью. |
GetRequiredService(IServiceProvider, Type) |
Возвращает службу типа |
GetRequiredService<T>(IServiceProvider) |
Возвращает службу типа |
GetService<T>(IServiceProvider) |
Возвращает службу типа |
GetServices(IServiceProvider, Type) |
Возвращает перечисление служб типа |
GetServices<T>(IServiceProvider) |
Возвращает перечисление служб типа |
GetFakeLogCollector(IServiceProvider) |
Возвращает объект , который собирает записи журнала, отправляемые в поддельные средства ведения журнала. |
GetFakeRedactionCollector(IServiceProvider) |
Возвращает поддельный экземпляр сборщика редактора из контейнера внедрения зависимостей. |