IAgentNotifySinkEx::ActiveClientChange
[Microsoft Agent ist ab Version Windows 7 veraltet und in nachfolgenden Versionen von Windows.]
HRESULT ActiveClientChange(
...long dwCharID, // character ID
long lStatus // active state flag
);
Benachrichtigt eine Clientanwendung, wenn ihr aktiver Client nicht mehr der aktive Client eines Zeichens ist.
- Kein Rückgabewert.
-
dwCharID
-
Bezeichner des Zeichens, für das sich der Aktive Clientstatus geändert hat.
-
lStatus
-
Änderung des aktiven Zustands des Clients. Dies kann eine Kombination aus einem der folgenden Werte sein:
Wert BESCHREIBUNG const unsigned short ACTIVATE _ NOTACTIVE = 0; Ihr Client ist nicht der aktive Client des Zeichens. const unsigned short ACTIVATE ACTIVE = _ 1; Ihr Client ist der aktive Client des Zeichens. const unsigned short ACTIVATE _ INPUTACTIVE = 2; Ihr Client ist eingabeaktiv (aktiver Client des obersten Zeichens).
Wenn mehrere Clientanwendungen dasselbe Zeichen verwenden, empfängt der aktive Client des Zeichens Mauseingaben (z. B. Klick- oder Ziehereignisse des Microsoft Agent-Steuerelements). Wenn mehrere Zeichen angezeigt werden, empfängt der aktive Client des obersten Zeichens (auch als eingabeaktiver Client bezeichnet) IAgentNotifySink::Command-Ereignisse.
Wenn sich der aktive Client eines Zeichens ändert, übergibt dieses Ereignis die ID dieses Zeichens und True zurück, wenn Ihre Anwendung zum aktiven Client des Zeichens geworden ist, oder False, wenn sie nicht mehr der aktive Client des Zeichens ist.
Eine Clientanwendung kann dieses Ereignis empfangen, wenn der Benutzer den Eintrag einer anderen Clientanwendung im Popupmenü eines Zeichens oder per Sprachbefehl auswählt, die Clientanwendung ihren aktiven Status ändert oder eine andere Clientanwendung ihre Verbindung mit Microsoft Agent beendet. Der -Agent sendet dieses Ereignis nur an die Clientanwendungen, die direkt betroffen sind– die, die entweder zum aktiven Client werden oder nicht mehr der aktive Client sind.
Sie können die Activate-Methode verwenden, um zu bestimmen, ob Ihre Anwendung der aktive Client des Zeichens ist, oder um Ihre Anwendung zum eingabeaktiven Client zu machen (wodurch auch das Zeichen ganz oben steht).
Weitere Informationen
IAgentCharacter::Activate, IAgentCharacterEx::GetActive, IAgentNotifySink::ActivateInputState