Compartilhar via


IAgentCharacterEx::ShowPopupMenu

[O Microsoft Agent foi preterido a partir do Windows 7 e pode estar indisponível nas versões subsequentes do Windows.]

HRESULT ShowPopupMenu(
   short x,  // x-coordinate of pop-up menu
   short y   // y-coordinate of pop-up menu
);

Exibe o menu pop-up do caractere.

  • Retorna S_OK para indicar que a operação foi bem-sucedida.

x

A coordenada x do menu pop-up do caractere em pixels, em relação à origem da tela (canto superior esquerdo).

y

A coordenada y do menu pop-up do caractere em pixels, em relação à origem da tela (canto superior esquerdo).

Quando você define IAgentCharacterEx::SetAutoPopupMenu para False, o servidor não exibe mais automaticamente o menu quando o caractere ou o ícone da barra de tarefas é clicado com o botão direito do mouse. Você pode usar esse método para exibir o menu.

O menu é exibido até que o usuário selecione um comando ou exiba outro menu. Somente um menu pop-up pode ser exibido por vez; portanto, as chamadas para esse método cancelarão (remover) o menu anterior.

Esse método só deve ser chamado quando seu aplicativo cliente for o cliente ativo do caractere; caso contrário, ele falhará.

IAgentCharacterEx::SetAutoPopupMenu