Partilhar via


Evento HelpComplete

[O Microsoft Agent foi preterido a partir do Windows 7 e pode não estar disponível em versões subsequentes do Windows.]

Descrição

Indica que o modo de Ajuda sensível ao contexto foi encerrado.

Sintaxe

Subagente.(ByValCharacterID**, ByVal** Name**, ByVal** Cause**)**

Peça Descrição
CharacterID Retorna a ID do caractere clicado como uma cadeia de caracteres.
Nome Retorna um valor de cadeia de caracteres que identifica o nome (ID) do comando.
causa Retorna um valor que indica o que causou a conclusão do modo de Ajuda. 1 O usuário selecionou um comando fornecido pelo seu aplicativo.
2 O usuário selecionou o Comandos objeto de outro cliente.
3 O usuário selecionou o comando Abrir comandos de voz.
4 O usuário selecionou o comando Fechar comandos de voz.
5 O usuário selecionou o comando Show CharacterName.
6 O usuário selecionou o comando Hide CharacterName.
7 O usuário selecionou (clicou) o caractere.

Comentários

Normalmente, o modo Ajuda é concluído quando o usuário clica ou arrasta o caractere ou seleciona um comando no menu pop-up do caractere. Clicar em outro caractere ou em outro lugar na tela não cancela o modo de Ajuda. O cliente que define o modo de Ajuda para o caractere pode cancelar o modo de Ajuda definindo HelpModeOn como False. (Isso não aciona o evento HelpComplete.)

Quando o usuário seleciona um comando no menu pop-up do caractere no modo de Ajuda, o servidor remove o menu, chama Ajuda com o HelpContextID especificado do comando e envia esse evento. O sensível ao contexto (também conhecido como What's This?) A janela Ajuda é exibida no local do ponteiro. Se o usuário selecionar o comando por entrada de voz, a janela Ajuda será exibida sobre o caractere. Se o personagem estiver fora da tela, a janela será exibida na tela mais próxima da posição atual do personagem.

Se o servidor retornar Name como uma cadeia de caracteres vazia (""), isso indica que o usuário selecionou um comando fornecido pelo servidor.

Esse evento é enviado somente para o aplicativo cliente que coloca o caractere no modo de Ajuda.

Ver também

propriedade HelpModeOnpropriedade HelpContextID