Metodo IUIAutomation::AddFocusChangedEventHandler (uiautomationclient.h)

Articolo
03/13/2024

Registra un metodo che gestisce gli eventi di modifica dello stato attivo.

Nota Prima di implementare un gestore eventi, è necessario avere familiarità con i problemi di threading descritti in Informazioni sui problemi di threading.

Sintassi

HRESULT AddFocusChangedEventHandler(
  [in] IUIAutomationCacheRequest             *cacheRequest,
  [in] IUIAutomationFocusChangedEventHandler *handler
);

Parametri

[in] cacheRequest

Tipo: IUIAutomationCacheRequest*

Puntatore a una richiesta di cache o NULL se non si desidera memorizzare nella cache.

[in] handler

Tipo: IUIAutomationFocusChangedEventHandler*

Puntatore all'oggetto che gestisce l'evento.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Gli eventi di modifica dello stato attivo sono a livello di sistema; non è possibile impostare un ambito più ristretto.

Un client Automazione interfaccia utente non deve usare più thread per aggiungere o rimuovere gestori eventi. Un comportamento imprevisto può determinare se un gestore eventi viene aggiunto o rimosso mentre viene aggiunto o rimosso nello stesso processo client.

Esempio

La funzione di esempio seguente crea un oggetto che implementa IUIAutomationFocusChangedEventHandler e sottoscrive l'evento aggiungendo il gestore.

HRESULT AddFocusHandler(IUIAutomation* pAutomation)
{ 
    // CFocusHandler is a class that implements IUIAutomationFocusChangedEventHandler. 
    CFocusHandler* pFocusHandler = new CFocusHandler();
    if (!pFocusHandler)
    {
        return E_OUTOFMEMORY;
    }
    IUIAutomationFocusChangedEventHandler* pHandler;
    pFocusHandler->QueryInterface(IID_IUIAutomationFocusChangedEventHandler, (void**)&pHandler);
    HRESULT hr = pAutomation->AddFocusChangedEventHandler(NULL, pHandler);
    pFocusHandler->Release();
    return hr;
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista, Windows XP con SP3 e Platform Update per Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008, Windows Server 2003 con SP2 e Platform Update per Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uiautomationclient.h (include UIAutomation.h)