Funzione UiaRaiseTextEditTextChangedEvent (uiautomationcoreapi.h)

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