IAgentNotifySinkEx::ActiveClientChange

[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 lo stato del client attivo è stato modificato.

lStatus

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

Valore Descrizione
const unsigned shortACTIVATE_NOTACTIVE = 0;
Il client non è il client attivo del carattere.
const unsigned shortACTIVATE_ACTIVE = 1;
Il client è il client attivo del carattere.
const unsigned shortACTIVATE_INPUTACTIVE = 2;
Il client è attivo dall'input (client attivo del carattere più alto).

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 viene modificato, questo evento restituisce 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 modifica lo stato attivo o un'altra applicazione client interrompe la connessione a Microsoft Agent. Agent invia questo evento solo alle applicazioni client interessate direttamente da quelle che diventano il client attivo o interrompono l'uso 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 dell'input (che rende il carattere in primo piano).

Vedere anche

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