Compartilhar via


DesignerActionService Classe

Definição

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

public ref class DesignerActionService : IDisposable
public class DesignerActionService : IDisposable
type DesignerActionService = class
    interface IDisposable
Public Class DesignerActionService
Implements IDisposable
Herança
DesignerActionService
Derivado
Implementações

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 usado 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 de 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 é 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 está gerenciando um componente específico no momento.

  • 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 da associação de itens de painel a um componente. Por outro lado, o modelo de pull depende da substituição da ActionLists propriedade da classe de designer para esse componente. O ambiente de design é responsável por adicionar esses itens ao atual DesignerActionService quando um componente é criado na superfície de design.

    Importante

    Os Addmétodos , Remove, Containse Clear consideram ou afetam apenas os itens do 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 especificar 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, poderá definir o includeAsDesignerVerb parâmetro no construtor do item.

Use o DesignerActionUIService para controlar a exibição do designer.ActionLists

Construtores

DesignerActionService(IServiceProvider)

Inicializa uma nova instância da classe DesignerActionService.

Métodos

Add(IComponent, DesignerActionList)

Adiciona um DesignerActionList à coleção atual de marcações inteligentes gerenciadas.

Add(IComponent, DesignerActionListCollection)

Adiciona um DesignerActionListCollection à coleção atual de marcações inteligentes gerenciadas.

Clear()

Libera todos os componentes de gerenciamento e limpa todas as listas de marcação inteligente do modelo de push.

Contains(IComponent)

Determina se o serviço de marcação inteligente atual gerencia as listas de ação para o componente especificado.

Dispose()

Libera todos os recursos usados pela classe DesignerActionService.

Dispose(Boolean)

Libera os recursos não gerenciados usados pelo DesignerActionService e opcionalmente libera os recursos gerenciados.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetComponentActions(IComponent)

Retorna a coleção de listas de itens de marcações inteligentes associadas a um componente.

GetComponentActions(IComponent, ComponentActionsType)

Retorna a coleção de listas de itens de marcações inteligentes do tipo especificado associadas a um componente.

GetComponentActions(IComponent, ComponentActionsType)

Retorna a coleção de listas de itens de ação do designer do tipo especificado associado a um componente.

GetComponentDesignerActions(IComponent, DesignerActionListCollection)

Recupera as marcações inteligentes do modelo de pull associadas ao componente.

GetComponentServiceActions(IComponent, DesignerActionListCollection)

Recupera as marcações inteligentes do modelo de push associadas ao componente.

GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
Remove(DesignerActionList)

Remove a lista de marcações inteligentes de todos os componentes gerenciados pelo serviço atual.

Remove(IComponent)

Remove todas as listas de marcações inteligentes associadas ao componente especificado.

Remove(IComponent, DesignerActionList)

Remove a lista de marcações inteligentes especificada do componente especificado.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Eventos

DesignerActionListsChanged

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

Aplica-se a

Confira também