Suporte ao menu pop-up
[O Microsoft Agent foi preterido a partir do Windows 7 e pode estar indisponível nas versões subsequentes do Windows.]
O Microsoft Agent inclui um menu pop-up (também conhecido como menu contextual) para cada caractere. O servidor exibe esse menu pop-up automaticamente quando um usuário clica com o botão direito do mouse no caractere. Você pode adicionar comandos para seu aplicativo cliente ao menu definindo uma coleção Commands . Para cada comando na coleção definida, você pode especificar as propriedades Caption e Visible . A Legenda é o texto que aparece no menu quando a propriedade Visible é definida como True. Você também pode usar a propriedade Enabled para exibir o comando no menu como desabilitado e o HelpContextID para dar suporte ao suporte da Ajuda para a propriedade. Defina a chave de acesso para o texto do menu incluindo um e comercial (&) antes do caractere de texto da configuração de texto Legenda .
O servidor adiciona automaticamente aos comandos de menu para abrir a janela Comandos de Voz e ocultar o caractere, bem como as legendas comandos de outros clientes do caractere para permitir que os usuários alternem entre clientes. O servidor adiciona automaticamente um separador ao menu entre suas entradas de menu e aquelas definidas pelo cliente. Os separadores aparecem somente quando há itens no menu a serem separados.
Para remover comandos de um menu, use o método Remove . Observe que as entradas do menu não são alteradas enquanto o menu é exibido. Se você adicionar ou remover comandos ou alterar suas propriedades, o menu exibirá as alterações quando o usuário exibir novamente o menu.
Se você preferir fornecer seus próprios serviços de menu pop-up para um caractere, poderá usar a propriedade AutoPopupMenu para desativar a manipulação do servidor da ação de clique com o botão direito do mouse. Em seguida, você pode usar a notificação de evento Click para criar seu próprio comportamento de tratamento de menu.
Quando o usuário seleciona um comando no menu pop-up de um caractere ou na janela Comandos de Voz, o servidor dispara o evento Command do cliente associado e transmite de volta os parâmetros da entrada usando o objeto UserInput .
O servidor também fornece um menu pop-up para o ícone da barra de tarefas do caractere. Quando o caractere estiver visível, clicar com o botão direito do mouse nesse menu exibirá os mesmos comandos exibidos clicando com o botão direito do mouse no caractere. No entanto, quando o caractere está oculto, somente os comandos fornecidos pelo servidor são incluídos.