Escolhendo um método de menu de atalho estático ou dinâmico

  • Artigo

Este tópico é organizado da seguinte maneira:

Escolha um método de verbo

É altamente recomendável que você implemente um menu de atalho usando um dos métodos de verbos estáticos.

Métodos de verbos estáticos

Os verbos estáticos são os verbos mais simples de implementar, mas ainda fornecem uma funcionalidade rica. Escolha sempre o método de menu de atalho mais simples que atenda às suas necessidades.

Verbo estático Descrição
CreateProcess com parâmetros de linha de comando Este é o meio mais simples e familiar de implementar um verbo estático. Um processo é chamado por meio de uma chamada para a função CreateProcess com os arquivos selecionados e quaisquer parâmetros opcionais passados como a linha de comando. Isso abre o arquivo ou pasta.
Este método tem as seguintes limitações:
  • O comprimento da linha de comando é limitado a 2000 caracteres, o que limita o número de itens que o verbo pode manipular.
  • Só pode ser usado com itens do sistema de arquivos.
  • Não habilita a reutilização de um processo já em execução.
  • Requer que um executável seja instalado para manipular o verbo.
IDropTarget DropTarget/ Uma ativação verbal baseada em COM significa que suporta ativação in-proc ou out-of-proc. O DropTarget/IDropTarget também oferece suporte à reutilização de um manipulador já em execução quando a interface IDropTarget é implementada por um servidor local. Ele também expressa perfeitamente os itens por meio do objeto de dados empacotado e fornece uma referência à cadeia de site de invocação para que você possa interagir com o invocador por meio do QueryService.
Windows 7 e posterior: IExecuteCommand O método de implementação mais direto. Como esse é um método de chamada baseado em COM (como DropTarget), essa interface oferece suporte à ativação in-proc e out-of-proc. O verbo implementa IExecuteCommand e IObjectWithSelection e, opcionalmente, IInitializeCommand. Os itens são passados diretamente como uma matriz de itens do Shell e mais parâmetros do invocador estão disponíveis para a implementação do verbo, incluindo o ponto de invocação, o estado do teclado e assim por diante.
Windows 7 e posterior:ExplorerCommand/ IExplorerCommand Permite que fontes de dados que fornecem seus comandos de módulo de comando por meio de IExplorerCommandProvider usem esses comandos como verbos em um menu de atalho. Como essa interface oferece suporte apenas à ativação em processo, ela é recomendada para uso por fontes de dados do Shell que precisam compartilhar a implementação entre comandos e menus de atalho.

 

Observação

IExplorerCommand é um híbrido entre um verbo estático e dinâmico. IExplorerCommand foi declarado no Windows Vista, mas sua capacidade de implementar um verbo em um menu de atalho é nova no Windows 7.

 

Para obter mais informações sobre IDropTarget e consultas Shell para atributos de associação de arquivo, consulte Tipos percebidos e registro de aplicativo.

Métodos verbais dinâmicos preferidos

Os seguintes métodos de verbos dinâmicos são preferidos:

Tipo de verbo Descrição
Verbo estático (listado na tabela anterior) + Sintaxe de consulta avançada (AQS) Essa escolha obtém visibilidade verbal dinâmica.
Windows 7 e posterior: IExplorerCommand Essa opção permite uma implementação comum de verbos e comandos do Explorer que são exibidos no módulo de comando no Windows Explorer.
Windows 7 e posterior: IExplorerCommandState + verbo estático Essa escolha também obtém visibilidade verbal dinâmica. É um modelo híbrido onde um manipulador simples em processo é usado para calcular se um determinado verbo estático deve ser exibido. Isso pode ser aplicado a todos os métodos de implementação de verbos estáticos para alcançar um comportamento dinâmico e minimizar a exposição da lógica em processo. IExplorerCommandState tem a vantagem de ser executado em um thread em segundo plano e, assim, evita travamentos da interface do usuário. É consideravelmente mais simples do que IContextMenu.

 

Métodos verbais dinâmicos desencorajados

IContextMenu é o método mais poderoso, mas também o mais complicado de implementar. Ele é baseado em objetos COM em processo que são executados no thread do chamador, que geralmente o Windows Explorer, mas pode ser qualquer aplicativo que hospeda os itens. IContextMenu suporta visibilidade de verbos, ordenação e desenho personalizado. Alguns desses recursos foram adicionados aos recursos de verbo estático, como um ícone a ser associado a um comando e IExplorerCommand para lidar com a visibilidade.

Se você precisar estender o menu de atalho para um tipo de arquivo registrando um verbo dinâmico para o tipo de arquivo, siga as instruções fornecidas em Personalizando um menu de atalho usando verbos dinâmicos.

Estender um menu de atalho

Depois de escolher um método de verbo, você pode estender um menu de atalho para um tipo de arquivo registrando um verbo estático para o tipo de arquivo. Para obter mais informações, consulte Criando manipuladores de menu de contexto.

Suporte para métodos verbais por sistema operacional

O suporte para métodos de invocação de verbo pelo sistema operacional está listado na tabela a seguir.

Método Verb Windows XP Windows Vista Windows 7 e posterior
CreateProcess X X X
DDE X X X
DropTarget X X X
ExecuteCommand X X
ExplorerCommand X
ExplorerCommandState X

 

Melhores Práticas para Manipuladores de Menu de Atalho e Vários Verbos de Seleção

Como Criar Manipuladores do Menu de Atalho

Personalizando um menu de atalho usando verbos dinâmicos

Menus de Atalho (Contexto) e Manipuladores de Menu de Atalho

Referência do Menu de Atalho

Associações de Verbos e Arquivos