Partager via

IAgentNotifySinkEx::ActiveClientChange

  • Article

[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible dans les versions ultérieures de Windows.]

HRESULT ActiveClientChange(
...long dwCharID,  // character ID
   long lStatus    // active state flag
);

Notifie à une application cliente que son client actif n'est plus le client actif d'un personnage.

  • Aucune valeur renvoyée.

dwCharID

Identifiant du personnage pour lequel l'état du client actif a changé.

lStatus

Changement d'état actif du client, qui peut être une combinaison des valeurs suivantes :

Valeur Description
const unsigned shortACTIVATE_NOTACTIVE = 0;
 Votre client n'est pas le client actif du personnage.
const unsigned shortACTIVATE_ACTIVE = 1;
 Votre client est le client actif du personnage.
const unsigned shortACTIVATE_INPUTACTIVE = 2;
 Votre client est actif à l'entrée (client actif du personnage le plus élevé).

Lorsque plusieurs applications clientes partagent le même personnage, le client actif du personnage reçoit les données de la souris (par exemple, les événements de clic ou de glissement du contrôle Microsoft Agent). De même, lorsque plusieurs caractères sont affichés, le client actif du caractère le plus élevé (également connu sous le nom de client actif en entrée) reçoit les événements IAgentNotifySink::Command.

Lorsque le client actif d'un personnage change, cet événement renvoie l'ID de ce personnage et True si votre application est devenue le client actif du personnage ou False si elle ne l'est plus.

Une application cliente peut recevoir cet événement lorsque l'utilisateur sélectionne l'entrée d'une autre application cliente dans le menu contextuel du personnage ou par commande vocale, lorsque l'application cliente modifie son statut actif ou lorsqu'une autre application cliente met fin à sa connexion à Microsoft Agent. L'agent n'envoie cet événement qu'aux applications clientes directement concernées, c'est-à-dire celles qui deviennent le client actif ou cessent de l'être.

Vous pouvez utiliser la méthode Activate pour déterminer si votre application est le client actif du personnage ou pour faire de votre application le client actif en entrée (ce qui place également le personnage en tête de liste).

Voir aussi

IAgentCharacter::Activate, IAgentCharacterEx::GetActive, IAgentNotifySink::ActivateInputState