Metodo IUIAutomationEventHandlerGroup::AddActiveTextPositionChangedEventHandler (uiautomationclient.h)

Articolo
2023-06-29

Registra un metodo (in un gruppo di gestori eventi) che gestisce quando cambia la posizione del testo attiva.

Importante I client di Microsoft Automazione interfaccia utente devono usare i metodi del gruppo di gestori per registrare i listener di eventi anziché i singoli metodi di registrazione degli eventi definiti nei vari spazi dei nomi IUIAutomation.

Sintassi

HRESULT AddActiveTextPositionChangedEventHandler(
  [in] TreeScope                                          scope,
  [in] IUIAutomationCacheRequest                          *cacheRequest,
  [in] IUIAutomationActiveTextPositionChangedEventHandler *handler
);

Parametri

[in] scope

Ambito di eventi da gestire; ovvero, se sono sull'elemento stesso, o sui predecessori e discendenti.

[in] cacheRequest

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

[in] handler

Puntatore all'oggetto che gestisce l'evento di modifica della posizione del testo attiva.

Valore restituito

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

Commenti

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

La posizione del testo attiva è indicata da un evento di navigazione all'interno o tra elementi di testo di sola lettura (ad esempio Web browser, documenti PDF) portabili o documenti EPUB usando segnalibri (o identificatori di frammento per fare riferimento a una posizione all'interno di una risorsa). Alcuni esempi:

Passaggio a un segnalibro all'interno della stessa pagina Web
Passaggio a un segnalibro in una pagina Web diversa
Attivazione di un collegamento a una posizione diversa all'interno dello stesso PDF
Attivazione di un collegamento a un percorso diverso all'interno della stessa EPUB

Usare questo gestore eventi per sincronizzare la posizione visiva del segnalibro o della destinazione con la posizione dello stato attivo in un elemento di testo di sola lettura, che può divergere quando si usano segnalibri o identificatori di frammento.

Ad esempio, quando viene richiamato lo stesso ancoraggio di pagina (<a href=”#C4”>Jump to Chapter 4</a> ... <h1><a name="C4">Chapter 4</a></h1>), la posizione dell'oggetto visivo viene aggiornata, ma il client Automazione interfaccia utente rimane nel percorso originale. Ciò comporta azioni come la lettura del testo o lo spostamento dei comandi degli elementi successivi a partire dalla posizione originale, non dalla nuova posizione.

Analogamente, l'attivazione di un nuovo URI di pagina (con un identificatore di frammento: (<a href=”www.blah.com#C4”>Jump to Chapter 4</a>)) carica la nuova pagina e passa al segnalibro specificato, ma lascia il Automazione interfaccia utente client nella parte superiore della pagina.

Per gli elementi di testo modificabili, ad esempio i controlli Edit e Rich Edit , è possibile ascoltare un evento SelectionChanged.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10, versione 1809 [solo app desktop]
Server minimo supportato	Windows Server, versione 1709 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uiautomationclient.h (include UIAutomation.h)

Vedi anche

IUIAutomationEventHandlerGroup

Condividi tramite