DesignSurface Класс

Определение

Пространство имен:: System.ComponentModel.Design

Сборка:: System.Design.dll

Сборка:: System.Windows.Forms.Design.dll

Сборки:: System.Design.dll, System.Windows.Forms.Design.dll

Исходный код:: DesignSurface.cs

Исходный код:: DesignSurface.cs

Исходный код:: DesignSurface.cs

Исходный код:: DesignSurface.cs

Исходный код:: DesignSurface.cs

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет пользовательский интерфейс для разработки компонентов.

public ref class DesignSurface : IDisposable, IServiceProvider

public class DesignSurface : IDisposable, IServiceProvider

[System.Security.SecurityCritical]
public class DesignSurface : IDisposable, IServiceProvider

type DesignSurface = class
    interface IDisposable
    interface IServiceProvider

[<System.Security.SecurityCritical>]
type DesignSurface = class
    interface IDisposable
    interface IServiceProvider

Public Class DesignSurface
Implements IDisposable, IServiceProvider

Наследование: Object
DesignSurface

Атрибуты: SecurityCriticalAttribute

Реализации: IDisposable IServiceProvider

Класс DesignSurface реализует то, что пользователь воспринимает как конструктор. DesignSurface — это пользовательский интерфейс, который пользователь управляет изменениями функций времени разработки. DesignSurface предоставляет полностью автономную область конструктора.

Класс DesignSurface может использоваться в качестве автономного конструктора или может быть связан с DesignSurfaceManager классом, чтобы обеспечить общую реализацию для приложения, на котором размещены несколько DesignSurface объектов.

Класс DesignSurface можно использовать самостоятельно или пользователь может наследить новый класс от него и расширить поведение.

Класс DesignSurface предоставляет несколько служб времени разработки автоматически. Класс DesignSurface добавляет все службы в конструктор. Большинство этих служб можно переопределить, заменив их в защищенном ServiceContainer свойстве. Чтобы заменить службу, переопределите конструктор, вызов базы и внесите изменения через защищенное ServiceContainer свойство. Все службы, добавляемые в контейнер службы, и которые реализуются IDisposable , удаляются при удалении области конструктора. Набор замененных служб по умолчанию, предоставляемых DesignSurface классом, показан в следующей таблице.

Услуга	Описание
IExtenderProviderService	Позволяет объектам, не входящим в коллекцию компонентов контейнера, предоставлять собственные поставщики расширителя.
IExtenderListService	TypeDescriptor Используется для получения списка поставщиков расширений. С помощью этой службы поставщики расширений могут жить за пределами контейнера.
ITypeDescriptorFilterService	Предоставляет перехватчики метаданных конструктора. Это основной интерфейс для фильтрации метаданных.
ISelectionService	Предоставляет способ выбора компонентов в конструкторе.
IReferenceService	Предоставляет способ получения имени для объектов, даже если эти объекты не размещаются.
DesignSurface	Предлагает саму область разработки в качестве службы.
DesignerOptionService	Предоставляет базовый класс для получения и задания значений параметров для конструктора.

В следующей таблице показаны неизменяемые службы, предоставляемые по умолчанию.

Услуга	Описание
IComponentChangeService	Вызывает события по мере внесения изменений в компоненты.
IDesignerHost	Управляет доступом к типам, службам и транзакциям. Основной интерфейс для конструкторов.
IContainer	Владеет набором компонентов, разработанных. Каждый конструктор имеет собственные IContainer компоненты.
IServiceContainer	Является производным от IServiceProvider и предоставляет способ добавления и удаления служб из конструктора.

Помимо этих служб, DesignSurface класс также предоставляет одну службу, доступную через сайт компонента. Эта служба уникальна для каждого компонента. В следующей таблице показаны службы, которые не могут быть заменены.

Услуга	Описание
IDictionaryService	Универсальный словарь пар "ключ-значение", который можно использовать для хранения произвольных данных о компоненте.
INestedContainer	Контейнер, позволяющий компоненту добавлять дополнительные дочерние компоненты в конструктор. Эти компоненты будут частью области конструктора, но не будут участвовать в сериализации. Это полезно, если вы хотите создать элемент управления, способный предоставлять область самого себя в конструкторе, но вы не хотите, чтобы регион участвовал в сериализации.

Услуга

Описание

IDictionaryService

Универсальный словарь пар "ключ-значение", который можно использовать для хранения произвольных данных о компоненте.

INestedContainer

Контейнер, позволяющий компоненту добавлять дополнительные дочерние компоненты в конструктор. Эти компоненты будут частью области конструктора, но не будут участвовать в сериализации. Это полезно, если вы хотите создать элемент управления, способный предоставлять область самого себя в конструкторе, но вы не хотите, чтобы регион участвовал в сериализации.

Кроме того ISite, сайт также реализует следующие интерфейсы.

Предостережение

Проверьте наличие этих интерфейсов, а не используйте неизбирательный приведение, так как другие реализации сайта не могут реализовать их.

Услуга	Описание
IServiceContainer	Предоставляет способ добраться до контейнера служб, относящихся к сайту. Например, IDictionaryService это служба для конкретного сайта. С помощью этой службы можно добавить дополнительные службы, относящиеся к сайту.

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

Имя	Описание
DesignSurface()	Инициализирует новый экземпляр класса DesignSurface.
DesignSurface(IServiceProvider, Type)	Инициализирует новый экземпляр класса DesignSurface.
DesignSurface(IServiceProvider)	Инициализирует новый экземпляр класса DesignSurface.
DesignSurface(Type)	Инициализирует новый экземпляр класса DesignSurface.

Свойства

Имя	Описание
ComponentContainer	Возвращает реализацию IContainer в области конструктора.
DtelLoading	Возвращает значение, указывающее, загружается ли список ошибок во время разработки .
IsLoaded	Возвращает значение, указывающее, загружается ли область конструктора в данный момент.
LoadErrors	Возвращает коллекцию ошибок загрузки или коллекции void.
ServiceContainer	Возвращает контейнер службы.
View	Возвращает представление для корневого конструктора.

Методы

Имя	Описание
BeginLoad(DesignerLoader)	Начинает процесс загрузки с заданного загрузчика конструктора.
BeginLoad(Type)	Начинает процесс загрузки.
CreateComponent(Type)	Устаревшие.. Создает экземпляр компонента.
CreateDesigner(IComponent, Boolean)	Создает конструктор при добавлении компонента в контейнер.
CreateInstance(Type)	Создает экземпляр заданного типа.
CreateNestedContainer(IComponent, String)	Создает контейнер, подходящий для вложенных элементов управления или компонентов.
CreateNestedContainer(IComponent)	Создает контейнер, подходящий для вложенных элементов управления или компонентов.
Dispose()	Освобождает ресурсы, используемые параметром DesignSurface.
Dispose(Boolean)	Освобождает ресурсы, используемые параметром DesignSurface.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
Flush()	Сериализует изменения в области конструктора.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetService(Type)	Возвращает службу из контейнера службы.
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
OnLoaded(LoadedEventArgs)	Вызывает событие Loaded.
OnLoading(EventArgs)	Вызывает событие Loading.
OnUnloaded(EventArgs)	Вызывает событие Unloaded.
OnUnloading(EventArgs)	Вызывает событие Unloading.
OnViewActivate(EventArgs)	Вызывает событие ViewActivated.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

События

Имя	Описание
Disposed	Происходит при удалении поверхности конструктора.
Flushed	Происходит при вызове Flush() метода DesignSurface.
Loaded	Происходит при завершении загрузки конструктора.
Loading	Происходит при загрузке конструктора.
Unloaded	Происходит, когда конструктор завершил выгрузку.
Unloading	Происходит при выгрузке конструктора.
ViewActivated	Происходит при вызове Activate()IDesignerHostметода.

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

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

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через