Compartilhar via

IAgentCharacterEx::GetActive

  • Artigo

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

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

Recupera se o 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 unsigned short ACTIVATE_NOTACTIVE = 0;
 Seu cliente não é o cliente ativo do caractere.
const unsigned short ACTIVATE_ACTIVE = 1;
 Seu cliente é o cliente ativo do caractere.
const unsigned short ACTIVATE_INPUTACTIVE = 2;
 Seu cliente é ativo de entrada (cliente ativo do caractere superior).

Essa configuração permite saber se você é o cliente ativo do caractere ou se o caractere é o ativo de entrada. 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 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 mais alto).

Confira também

IAgentCharacter::Activate, IAgentNotifySinkEx::ActiveClientChange