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 (superior esquerda).

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 como 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) o menu anterior.

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

IAgentCharacterEx::SetAutoPopupMenu