DesignerActionService Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Устанавливает службу времени разработки DesignerActionItem , которая управляет коллекцией объектов для компонентов.
public ref class DesignerActionService : IDisposablepublic class DesignerActionService : IDisposabletype DesignerActionService = class
interface IDisposablePublic Class DesignerActionService
Implements IDisposable- Наследование
-
DesignerActionService
- Производный
- Реализации
Комментарии
Класс DesignerActionService отвечает за управление коллекцией DesignerActionItem объектов для каждого экземпляра компонента, существующего в форме во время разработки. Этот класс включает прямую модель создания элементов и в основном предназначен для использования разработчиками инструментов во время разработки, хотя она также может использоваться разработчиками компонентов и пользовательских элементов управления.
Разработчикам средств разработки потребуется определить список элементов, отображаемых для компонента, и определить, когда этот список изменяется. Они также могут создавать надстройки, которые работают в сочетании с объектами панели смарт-тегов.
Разработчикам расширенных компонентов может потребоваться динамически управлять элементами, связанными с компонентом, таким образом заменяя или дополняя стандартную модель извлечения. Например, команды панели можно изменять в зависимости от контекста их использования и состояния времени разработки компонента.
Замечание
На DesignerActionService самом деле это служба вождения как за моделями push- и вытягивания; однако в последнем случае она работает неявно.
DesignerActionService предоставляет простой интерфейс для доступа к элементам и управления ими для каждого компонента, включая следующие методы и события:
Метод Contains определяет, управляет ли текущий DesignerActionService компонент определенным компонентом.
Метод GetComponentActions поддерживает перечисление списков элементов.
Метод Add позволяет добавлять или DesignerActionListCollection в DesignerActionList набор существующих элементов для экземпляра компонента. Напротив, метод удаляет один или все списки элементов, Remove связанные с компонентом.
Замечание
Метод Add представляет прямую модель принудительной отправки элементов панели с компонентом. Напротив, модель извлечения зависит от переопределения ActionLists свойства класса конструктора для этого компонента. Среда разработки отвечает за добавление этих элементов в текущий момент DesignerActionService при создании компонента на поверхности конструктора.
Событие DesignerActionListsChanged указывает, когда коллекция элементов изменяется для компонента.
Так как часто рекомендуется использовать некоторые элементы одной панели в контекстном меню компонента во время разработки и ее панели, большая степень взаимодействия существует между DesignerActionItem объектами и командами конструктора.
Если конструктор компонентов явно не указывает ( DesignerActionList то есть не содержит переопределенное ActionLists свойство), то список будет создан из существующих команд конструктора. Эти команды задаются свойством Verbs . В этом случае класс списка внутренних команд используется для хранения коллекции записей панели элементов команды.
Если вы хотите DesignerActionMethodItem использовать как запись панели, так и запись контекстного меню во время разработки, можно задать includeAsDesignerVerb параметр в конструкторе элемента.
Используйте для DesignerActionUIService управления отображением конструктора ActionLists.
Конструкторы
| Имя | Описание |
|---|---|
| DesignerActionService(IServiceProvider) |
Инициализирует новый экземпляр класса DesignerActionService. |
Методы
| Имя | Описание |
|---|---|
| Add(IComponent, DesignerActionList) |
Добавляет в текущую DesignerActionList коллекцию управляемых смарт-тегов. |
| Add(IComponent, DesignerActionListCollection) |
Добавляет в текущую DesignerActionListCollection коллекцию управляемых смарт-тегов. |
| Clear() |
Освобождает все компоненты из управления и очищает все списки смарт-тегов модели push-модели. |
| Contains(IComponent) |
Определяет, управляет ли текущая служба смарт-тегов списками действий для указанного компонента. |
| Dispose() |
Освобождает все ресурсы, используемые классом DesignerActionService . |
| Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые DesignerActionService и при необходимости освобождает управляемые ресурсы. |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetComponentActions(IComponent, ComponentActionsType) |
Возвращает коллекцию списков элементов смарт-тегов указанного типа, связанного с компонентом. |
| GetComponentActions(IComponent, ComponentActionsType) |
Возвращает коллекцию списков элементов действия конструктора указанного типа, связанного с компонентом. |
| GetComponentActions(IComponent) |
Возвращает коллекцию списков элементов смарт-тегов, связанных с компонентом. |
| GetComponentDesignerActions(IComponent, DesignerActionListCollection) |
Извлекает смарт-теги модели извлечения, связанные с компонентом. |
| GetComponentServiceActions(IComponent, DesignerActionListCollection) |
Извлекает смарт-теги смарт-модели push-модели, связанные с компонентом. |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| Remove(DesignerActionList) |
Удаляет указанный список смарт-тегов из всех компонентов, управляемых текущей службой. |
| Remove(IComponent, DesignerActionList) |
Удаляет указанный список смарт-тегов из указанного компонента. |
| Remove(IComponent) |
Удаляет все списки смарт-тегов, связанные с указанным компонентом. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
События
| Имя | Описание |
|---|---|
| DesignerActionListsChanged |
Происходит при DesignerActionList удалении или добавлении любого компонента. |
