Funzione UiaRaiseTextEditTextChangedEvent (uiautomationcoreapi.h)

Articolo
03/03/2024

Chiamato da un provider per notificare a Microsoft Automazione interfaccia utente core che un controllo di testo ha modificato a livello di codice il testo.

Sintassi

HRESULT UiaRaiseTextEditTextChangedEvent(
  [in] IRawElementProviderSimple *pProvider,
  [in] TextEditChangeType        textEditChangeType,
  [in] SAFEARRAY                 *pChangedData
);

Parametri

[in] pProvider

Tipo: IRawElementProviderSimple*

Nodo del provider in cui si è verificata la modifica del testo.

[in] textEditChangeType

Tipo: TextEditChangeType

Tipo di modifica del testo che si è verificato.

[in] pChangedData

Tipo: SAFEARRAY*

Dati dell'evento. Deve essere assegnabile come var di tipo VT_BSTR.

Valore restituito

Tipo: HRESULT

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

Commenti

Si tratta di una funzione helper per i provider che implementano ITextEditProvider e generano gli eventi necessari del modello. Seguire le indicazioni fornite in TextEdit Control Pattern che descrive quando generare gli eventi e il payload che gli eventi devono passare a Automazione interfaccia utente.

Se non sono presenti client in ascolto di un particolare tipo di modifica, non viene generato alcun evento.

I dati dell'evento devono contenere payload diversi per ogni tipo di modifica (per TextEditChangeType):

TextEditChangeType_AutoCorrect: pChangedData deve essere la nuova stringa corretta.
TextEditChangeType_Composition: pChangedData deve essere la stringa aggiornata nella composizione (solo la parte modificata).
TextEditChangeType_CompositionFinalized: pChangedData deve essere la stringa finalizzata della composizione completata (può essere vuota se la composizione è stata annullata o eliminata).

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8.1 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	uiautomationcoreapi.h
Libreria	Uiautomationcore.lib
DLL	Uiautomationcore.dll

Vedi anche

HandleTextEditTextChangedEvent

ITextEditProvider

IUIAutomation3::AddTextEditTextChangedEventHandler

Pattern di controllo TextEdit

Condividi tramite