DesignerActionService Classe

Definição

Namespace:

System.ComponentModel.Design

Assembly:

System.Windows.Forms.Design.dll

Origem:

DesignerActionService.cs

Estabelece um serviço de tempo de design que gerencia a coleção de DesignerActionItem objetos para componentes.

public ref class DesignerActionService : IDisposable

public class DesignerActionService : IDisposable

type DesignerActionService = class
    interface IDisposable

Public Class DesignerActionService
Implements IDisposable

Herança

Object

DesignerActionService

Derivado

System.Web.UI.Design.WebFormsDesignerActionService

Comentários

A DesignerActionService classe é responsável por gerenciar a coleção de DesignerActionItem objetos para cada instância de um componente que existe em um formulário em tempo de design. Essa classe habilita um modelo de push direto da criação de item e destina-se principalmente ao uso por desenvolvedores de ferramentas de tempo de design, embora também possa ser usada por desenvolvedores de componentes e controles personalizados.

Os desenvolvedores da ferramenta de tempo de design precisarão determinar a lista de itens a serem exibidos para um componente e determinar quando essa lista é alterada. Eles também podem criar suplementos que operam em conjunto com objetos de painel de marcas inteligentes.

Os desenvolvedores de componentes avançados podem precisar controlar dinamicamente os itens associados a um componente, substituindo ou complementando o modelo de pull padrão. Por exemplo, os comandos do painel podem ser alterados dependendo do contexto de seu uso e do estado de tempo de design do componente.

Observação

Na DesignerActionService verdade, é o serviço de condução por trás dos modelos de push e pull; no entanto, no último caso, ele opera implicitamente.

DesignerActionService fornece uma interface simples para acessar e manipular os itens para cada componente, incluindo os seguintes métodos e eventos:

• O Contains método determina se o DesignerActionService atualmente está gerenciando um componente específico.

• O GetComponentActions método dá suporte à enumeração das listas de itens.

• O Add método permite adicionar um DesignerActionList ou DesignerActionListCollection ao conjunto de itens existentes para uma instância de componente. Por outro lado, o Remove método remove uma ou todas as listas de itens associadas a um componente.

  Observação

  O Add método representa o modelo de push direto de associar itens de painel a um componente. Por outro lado, o modelo de pull depende da substituição ActionLists da propriedade da classe de designer para esse componente. O ambiente de design é responsável por adicionar esses itens à corrente DesignerActionService quando um componente é criado na superfície de design.

  Importante

  Os Addmétodos , Removee Containsapenas Clear consideram ou afetam itens de modelo de push.

• O DesignerActionListsChanged evento indica quando a coleção de itens é alterada para um componente.

Como geralmente é desejável usar alguns dos mesmos itens de painel no menu de atalho de tempo de design do componente e em seu painel, existe um grande grau de interoperabilidade entre DesignerActionItem objetos e verbos de designer.

Se um designer de componentes não especifica explicitamente um DesignerActionList (ou seja, ele não contém uma propriedade substituída ActionLists ), uma lista será criada a partir de verbos de designer existentes. Esses verbos são especificados pela Verbs propriedade. Nesse caso, uma classe de lista de verbos interna é usada para conter a coleção de entradas do painel de itens de verbo.

Se você quiser que um DesignerActionMethodItem seja usado como uma entrada de painel e uma entrada de menu de atalho em tempo de design, você poderá definir o includeAsDesignerVerb parâmetro no construtor do item.

Use o DesignerActionUIService para controlar a exibição do ActionListsdesigner.

Construtores

Nome	Description
DesignerActionService(IServiceProvider)	Inicializa uma nova instância da classe DesignerActionService.

Métodos

Nome	Description
Add(IComponent, DesignerActionList)	Adiciona um DesignerActionList à coleção atual de marcas inteligentes gerenciadas.
Add(IComponent, DesignerActionListCollection)	Adiciona um DesignerActionListCollection à coleção atual de marcas inteligentes gerenciadas.
Clear()	Libera todos os componentes do gerenciamento e limpa todas as listas de marcas inteligentes do modelo push.
Contains(IComponent)	Determina se o serviço de marca inteligente atual gerencia as listas de ações para o componente especificado.
Dispose()	Libera todos os recursos usados pela DesignerActionService classe.
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo DesignerActionService e, opcionalmente, libera os recursos gerenciados.
GetComponentActions(IComponent, ComponentActionsType)	Retorna a coleção de listas de itens de ação do designer do tipo especificado associado a um componente.
GetComponentActions(IComponent)	Retorna a coleção de listas de itens de marca inteligente associadas a um componente.
GetComponentDesignerActions(IComponent, DesignerActionListCollection)	Recupera as marcas inteligentes do modelo de pull associadas a um componente.
GetComponentServiceActions(IComponent, DesignerActionListCollection)	Recupera as marcas inteligentes do modelo push associadas a um componente.
Remove(DesignerActionList)	Remove a lista de marcas inteligentes especificada de todos os componentes gerenciados pelo serviço atual.
Remove(IComponent, DesignerActionList)	Remove a lista de marcas inteligentes especificada do componente especificado.
Remove(IComponent)	Remove todas as listas de marcas inteligentes associadas ao componente especificado.

Eventos

Nome	Description
DesignerActionListsChanged	Ocorre quando um DesignerActionList é removido ou adicionado para qualquer componente.

Confira também

• DesignerActionListCollection
• ComponentDesigner
• DesignerActionItem
• DesignerActionUIService
• Comandos do Designer e o modelo de objeto DesignerAction para Windows Forms