IAgentCharacterEx::GetActive
[Microsoft Agent est déconseillé à partir de Windows 7 et peut ne pas être disponible dans les versions ultérieures de Windows.]
HRESULT GetActive(
short * psState // address of active state setting
);
Récupère les valeur indiquant si votre application cliente est le client actif du caractère et si le caractère est le plus haut.
- Retourne _ la valeur S OK pour indiquer que l’opération a réussi.
-
psState
-
Adresse d’une variable qui reçoit l’une des valeurs suivantes pour le paramètre d’État :
Valeur Description const non signed Short ACTIVATe _ notactive = 0 ; Votre client n’est pas le client actif du caractère. const non signé Short Activate _ active = 1 ; Votre client est le client actif du caractère. const non signed Short Activate _ INPUTACTIVE = 2 ; Votre client est en entrée-actif (client actif du premier caractère).
Ce paramètre vous permet de savoir si vous êtes le client actif du caractère ou si votre caractère est le caractère actif d’entrée. Lorsque plusieurs applications clientes partagent le même caractère, le client actif du caractère reçoit l’entrée de la souris (par exemple, les événements Click ou Drag du contrôle Microsoft Agent). De même, lorsque plusieurs caractères sont affichés, le client actif du caractère le plus haut (également appelé client d’entrée-actif) reçoit des événements IAgentNotifySink :: Command .
Utilisez la méthode Activate pour définir si votre application est le client actif du personnage ou pour faire de votre application le client actif d’entrée (ce qui rend également le premier caractère).
Voir aussi
IAgentCharacter :: Activate, IAgentNotifySinkEx :: ActiveClientChange