Metodo IUIAutomation6::RemoveActiveTextPositionChangedEventHandler (uiautomationclient.h)

Articolo
08/26/2023

Rimuove un gestore eventi modificato in una posizione di testo attiva.

Importante

I client di Microsoft Automazione interfaccia utente devono usare i metodi di interfaccia IUIAutomationEventHandlerGroup per registrare i listener di eventi anziché i singoli metodi di registrazione degli eventi definiti qui e nei vari spazi dei nomi dell'interfaccia IUIAutomation.

Sintassi

HRESULT RemoveActiveTextPositionChangedEventHandler(
  [in] IUIAutomationElement                               *element,
  [in] IUIAutomationActiveTextPositionChangedEventHandler *handler
);

Parametri

[in] element

Puntatore all'elemento Automazione interfaccia utente associato al gestore eventi.

[in] handler

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

Valore restituito

Questo metodo non restituisce valori.

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 i client Automazione interfaccia utente nella parte superiore della pagina.

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

È possibile che un evento venga recapitato a un gestore eventi dopo che il gestore è stato annullato, se l'evento viene ricevuto contemporaneamente con la richiesta di annullare la sottoscrizione dell'evento. La procedura consigliata consiste nel seguire lo standard COM (Component Object Model) ed evitare di eliminare definitivamente l'oggetto gestore eventi fino a quando il conteggio dei riferimenti non ha raggiunto zero. L'eliminazione di un gestore eventi immediatamente dopo l'annullamento della sottoscrizione per gli eventi può causare una violazione di accesso se un evento viene recapitato in ritardo.

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

Interfaccia IUIAutomation6::AddActiveTextPositionChangedEventHandler, IUIAutomation6

Condividi tramite