IAgentCharacterEx::GetActive

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

HRESULT GetActive(
   short * psState  // address of active state setting
);

Recupera se seu aplicativo cliente é o cliente ativo do caractere e se o caractere é superior.

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

psState

Endereço de uma variável que recebe um dos seguintes valores para a configuração de estado:

Valor	Descrição
const não assinado curtoACTIVATE_NOTACTIVE = 0;	Seu cliente não é o cliente ativo do personagem.
const não assinado curtoACTIVATE_ATIVE = 1;	Seu cliente é o cliente ativo do personagem.
const shortACTIVATE_INPUTACTIVE não assinado = 2;	Seu cliente é input-active (cliente ativo do caractere mais alto).

Essa configuração permite que você saiba se você é o cliente ativo do caractere ou se seu personagem é o caractere ativo de entrada. Quando vários aplicativos cliente compartilham o mesmo caractere, o cliente ativo do caractere recebe a entrada do mouse (por exemplo, o controle do Microsoft Agent clica ou arrasta eventos). 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 IAgentNotifySink::Command.

Use o método Activate para definir se seu aplicativo é o cliente ativo do caractere ou para tornar seu aplicativo o cliente ativo de entrada (o que também torna o caractere no topo).

Ver também

IAgentCharacter::Activate, IAgentNotifySinkEx::ActiveClientChange