Compartir a través de

IAgentCharacterEx::GetActive

  • Artículo

[Microsoft Agent está en desuso a partir de Windows 7 y puede no estar disponible en versiones posteriores de Windows].

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

Recupera si la aplicación cliente es el cliente activo del personaje y si el personaje está en un nivel superior.

  • Devuelve S_OK para indicar que la operación se ha realizado correctamente.

psState

Dirección de una variable que recibe uno de los siguientes valores para la creación de estado:

Valor Descripción
const unsigned short ACTIVATE_NOTACTIVE = 0;
 El cliente no es el cliente activo del personaje.
const unsigned short ACTIVATE_ACTIVE = 1;
 El cliente es el cliente activo del personaje.
const unsigned short ACTIVATE_INPUTACTIVE = 2;
 El cliente es de entrada activo (cliente activo del personaje en el nivel superior).

Este ajuste le permite saber si es el cliente activo del personaje o si el personaje es el personaje activo de entrada. Cuando varias aplicaciones cliente comparten el mismo personaje, el cliente activo del personaje detecta la entrada del ratón (por ejemplo, el control de Microsoft Agent hace clic o arrastra eventos). Del mismo modo, cuando aparecen varios personajes, el cliente activo del personaje está en el nivel superior (también conocido como cliente de entrada activo) recibe eventos IAgentNotifySink::Command.

Use el método Activate para establecer si la aplicación es el cliente activo del personaje o para que la aplicación sea el cliente de entrada activo (lo que también hace que el personaje esté en un nivel superior).

Consulte también

IAgentCharacter::Activate, IAgentNotifySinkEx::ActiveClientChange