Condividi tramite

IAgentNotifySinkEx::ActiveClientChange

  • Articolo

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

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

Notifica a un'applicazione client se il client attivo non è più il client attivo di un carattere.

  • Nessun valore restituito.

dwCharID

Identificatore del carattere per il quale è stato modificato lo stato del client attivo.

lStatus

Modifica dello stato attivo del client, che può essere una combinazione di uno dei valori seguenti:

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).

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 .

Quando il client attivo di un carattere cambia, questo evento passa di nuovo l'ID del carattere e True se l'applicazione è diventata il client attivo del carattere o False se non è più il client attivo del carattere.

Un'applicazione client può ricevere questo evento quando l'utente seleziona la voce di un'altra applicazione client nel menu a comparsa del carattere o tramite comando vocale, l'applicazione client cambia lo stato attivo o un'altra applicazione client chiude la connessione a Microsoft Agent. Agent invia questo evento solo alle applicazioni client interessate direttamente da quelli che diventano il client attivo o arrestano l'esecuzione del client attivo.

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

Vedi anche

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