Compartilhar via


Evento ActiveClientChange

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

Descrição

Ocorre quando o cliente ativo do caractere muda.

Sintaxe

Sub *agent.*ActiveClientChange (ByVal CharacterID, ByVal Active )

Parte Descrição
CharacterID Retorna a ID do caractere para o qual o evento ocorreu.
Com atividade Um valor booliano que indica se o cliente se tornou ativo ou não. True O aplicativo cliente se tornou o cliente ativo do caractere.
False O aplicativo cliente não é mais o cliente ativo do caractere.

Comentários

Quando vários aplicativos cliente compartilham o mesmo caractere, o cliente ativo do caractere recebe a entrada do mouse (por exemplo, eventos de clique ou arrastar do controle do Microsoft Agent). Da mesma forma, quando vários caracteres são exibidos, o cliente ativo do caractere mais alto (também conhecido como cliente ativo de entrada) recebe eventos Command.

Quando o cliente ativo de um caractere é alterado, esse evento retornará o ID desse caractere e True se o aplicativo tiver se tornado o cliente ativo do caractere ou False se não for mais o cliente ativo do caractere.

Um aplicativo cliente pode receber esse evento quando o usuário seleciona a entrada de um aplicativo cliente no menu pop-up do caractere ou por comando de voz, o aplicativo cliente altera seu status ativo ou quando outro aplicativo cliente sai da conexão com o Agent. O agente envia esse evento somente para os aplicativos cliente que são diretamente afetados; aqueles que se tornam o cliente ativo ou deixam de ser o cliente ativo.

Confira também

Evento ActivateInput, propriedade Active Evento, DeactivateInput, método Activate