DesignerActionService Класс

Определение

Пространство имен:

System.ComponentModel.Design

Сборка:

System.Windows.Forms.Design.dll

Устанавливает службу времени разработки, которая управляет коллекцией объектов DesignerActionItem для компонентов.

public ref class DesignerActionService : IDisposable

public class DesignerActionService : IDisposable

type DesignerActionService = class
    interface IDisposable

Public Class DesignerActionService
Implements IDisposable

Наследование

Object

DesignerActionService

Производный

System.Web.UI.Design.WebFormsDesignerActionService

Комментарии

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

Разработчикам средств времени разработки необходимо определить список элементов, отображаемых для компонента, и определить, когда этот список изменится. Они также могут создавать надстройки, работающие в сочетании с объектами панели смарт-тегов.

Продвинутым разработчикам компонентов может потребоваться динамически управлять элементами, связанными с компонентом, тем самым заменяя или дополняя стандартную модель извлечения. Например, команды панели можно изменять в зависимости от контекста их использования и состояния компонента во время разработки.

Примечание

На DesignerActionService самом деле является службой управления, стоящая за моделями push и pull, однако в последнем случае она работает неявно.

DesignerActionService предоставляет простой интерфейс для доступа к элементам для каждого компонента и управления ими, включая следующие методы и события:

• Метод Contains определяет, управляет ли в DesignerActionService данный момент определенным компонентом.

• Метод GetComponentActions поддерживает перечисление списков элементов.

• Метод Add позволяет добавлять DesignerActionList или DesignerActionListCollection в набор существующих элементов для экземпляра компонента. Напротив, Remove метод удаляет один или все списки элементов, связанные с компонентом.

  Примечание

  Метод Add представляет модель прямой отправки для связывания элементов панели с компонентом. В отличие от этого, модель извлечения полагается на переопределение ActionLists свойства класса конструктора для этого компонента. Среда разработки отвечает за добавление этих элементов в текущую DesignerActionService среду при создании компонента в области конструктора.

  Важно!

  Методы Add, Remove, Containsи Clear учитывают или влияют только на элементы модели push-уведомлений.

• Событие DesignerActionListsChanged указывает, когда коллекция элементов изменяется для компонента.

Так как часто желательно использовать одни и те же элементы панели как в контекстном меню компонента во время разработки, так и в его панели, между DesignerActionItem объектами и командами конструктора существует большая степень взаимодействия.

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

Если вы хотите DesignerActionMethodItem использовать как запись панели, так и как запись контекстного меню времени разработки, можно задать includeAsDesignerVerb параметр в конструкторе элемента.

Используйте для DesignerActionUIService управления отображением конструктора ActionLists.

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

DesignerActionService(IServiceProvider)

Инициализирует новый экземпляр класса DesignerActionService.

Методы

Add(IComponent, DesignerActionList)	Добавляет список DesignerActionList в текущую коллекцию управляемых смарт-тегов.
Add(IComponent, DesignerActionListCollection)	Добавляет список DesignerActionListCollection в текущую коллекцию управляемых смарт-тегов.
Clear()	Освобождает все компоненты от управления и очищает все списки смарт-тегов модели внедрения.
Contains(IComponent)	Определяет, управляет ли текущая служба смарт-тегов списками действий для указанного компонента.
Dispose()	Освобождает все ресурсы, используемые классом DesignerActionService.
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые объектом DesignerActionService, а при необходимости освобождает также управляемые ресурсы.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetComponentActions(IComponent)	Возвращает коллекцию списков элементов смарт-тегов, сопоставленных компоненту.
GetComponentActions(IComponent, ComponentActionsType)	Возвращает коллекцию списков элементов действия конструктора указанного типа, связанных с компонентом.
GetComponentDesignerActions(IComponent, DesignerActionListCollection)	Извлекает смарт-теги модели извлечения, сопоставленные компоненту.
GetComponentServiceActions(IComponent, DesignerActionListCollection)	Извлекает смарт-теги модели внедрения, сопоставленные компоненту.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
Remove(DesignerActionList)	Удаляет заданный список смарт-тегов из всех компонентов, управляемых текущей службой.
Remove(IComponent)	Удаляет все списки смарт-тегов, сопоставленных заданному компоненту.
Remove(IComponent, DesignerActionList)	Удаляет заданный смарт-тег из указанного компонента.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

События

DesignerActionListsChanged

Происходит при удалении списка DesignerActionList или его добавлении для любого компонента.

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

• DesignerActionListCollection
• ComponentDesigner
• DesignerActionItem
• DesignerActionUIService
• Команды конструктора и объектная модель DesignerAction для Windows Forms