Condividi tramite

IAgentCharacterEx::GetActive

  • Articolo

[Microsoft Agent è deprecato a partire da Windows 7 e potrebbe non essere disponibile nelle versioni successive di Windows.]

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

Recupera un valore che indica se l'applicazione client è il client attivo del carattere e se il carattere è superiore.

  • Restituisce S_OK per indicare che l'operazione è stata completata correttamente.

psState

Indirizzo di una variabile che riceve uno dei valori seguenti per l'impostazione dello stato:

valore Descrizione
const unsigned short ACTIVATE_NOTACTIVE = 0;
 Il client non è il client attivo del carattere.
const unsigned short ACTIVATE_ACTIVE = 1;
 Il client è il client attivo del carattere.
const unsigned short ACTIVATE_INPUTACTIVE = 2;
 Il client è attivo dall'input (client attivo del carattere superiore).

Questa impostazione ti consente di sapere se sei il client attivo del carattere o se il carattere è il carattere attivo di input. Quando più applicazioni client condividono lo stesso carattere, il client attivo del carattere riceve l'input del mouse(ad esempio, il controllo Microsoft Agent fa clic o trascina eventi). Analogamente, quando vengono visualizzati più caratteri, il client attivo del carattere superiore (noto anche come client attivo di input) riceve gli eventi IAgentNotifySink::Command .

Usare il metodo Activate per impostare se l'applicazione è il client attivo del carattere o per rendere l'applicazione il client attivo di input (che rende il carattere in primo piano).

Vedi anche

IAgentCharacter::Activate, IAgentNotifySinkEx::ActiveClientChange