DesignerActionService Classe

Definição

Espaço de Nomes:
System.ComponentModel.Design
Assemblagem:
System.Design.dll

Estabelece um serviço de design time que gere 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
Implementações
IDisposable

Observações

A DesignerActionService classe é responsável por gerir a coleção de DesignerActionItem objetos para cada instância de um componente que existe num formulário no momento do design. Esta classe permite um modelo direto de criação de itens e destina-se principalmente a ser utilizada por desenvolvedores de ferramentas em tempo de design, embora também possa ser usada por desenvolvedores de componentes e controlo personalizados.

Os desenvolvedores de ferramentas em tempo de design terão de determinar a lista de itens a apresentar para um componente e determinar quando essa lista muda. Podem também criar complementos que operam em conjunto com objetos do painel de etiquetas inteligentes.

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

Note

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

DesignerActionService fornece uma interface direta para aceder e manipular os itens de cada componente, incluindo os seguintes métodos e eventos:

  • O Contains método determina se o DesignerActionService está atualmente a gerir um determinado componente.

  • O GetComponentActions método suporta a 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. Em contraste, o Remove método remove uma ou todas as listas de itens associadas a um componente.

    Note

    O Add método representa o modelo de push direto de associar itens do painel a um componente. Em contraste, o modelo pull baseia-se em sobrepor a ActionLists propriedade da classe designer para esse componente. O ambiente de design é responsável por adicionar estes itens à corrente DesignerActionService quando um componente é criado na superfície de design.

    Importante

    Os Addmétodos , Remove, Contains, e Clear apenas consideram ou afetam itens do modelo push.

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

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

Se um designer de componentes não especificar explicitamente um DesignerActionList (ou seja, não contiver uma propriedade sobreposta ActionLists ), então será criada uma lista a partir dos verbos designers existentes. Estes verbos são especificados pela Verbs propriedade. Neste caso, é usada uma classe de lista de verbos interna para conter a coleção de entradas do painel de itens verbais.

Se quiseres DesignerActionMethodItem que seja usado tanto como entrada de painel como entrada de atalho em tempo de design, podes definir o includeAsDesignerVerb parâmetro no construtor do item.

Use o DesignerActionUIService para controlar o ecrã do seu designer ActionLists.

Construtores

Name Description
DesignerActionService(IServiceProvider)

Inicializa uma nova instância da DesignerActionService classe.

Métodos

Name Description
Add(IComponent, DesignerActionList)

Adiciona a DesignerActionList à coleção atual de smart tags geridas.
Add(IComponent, DesignerActionListCollection)

Adiciona a DesignerActionListCollection à coleção atual de smart tags geridas.
Clear()

Liberta todos os componentes da gestão e limpa todas as listas de smart tags do modelo push.
Contains(IComponent)

Determina se o serviço atual de etiquetas inteligentes gere as listas de ações para o componente especificado.
Dispose()

Liberta todos os recursos usados pela DesignerActionService turma.
Dispose(Boolean)

Liberta os recursos não geridos usados pelo DesignerActionService e opcionalmente liberta os recursos geridos.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetComponentActions(IComponent, ComponentActionsType)

Devolve a coleção de listas de itens com etiquetas inteligentes do tipo especificado associado a um componente.
GetComponentActions(IComponent)

Devolve a coleção de listas de itens com etiquetas inteligentes associadas a um componente.
GetComponentDesignerActions(IComponent, DesignerActionListCollection)

Recupera as etiquetas inteligentes do modelo pull associadas a um componente.
GetComponentServiceActions(IComponent, DesignerActionListCollection)

Recupera as smart tags do modelo push associadas a um componente.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
Remove(DesignerActionList)

Remove a lista de etiquetas inteligentes especificada de todos os componentes geridos pelo serviço atual.
Remove(IComponent, DesignerActionList)

Remove a lista de smart tags especificada do componente especificado.
Remove(IComponent)

Remove todas as listas de smart tags associadas ao componente especificado.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

evento

Name Description
DesignerActionListsChanged

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

Aplica-se a

Ver também