Fungsi UiaRaiseTextEditTextChangedEvent (uiautomationcoreapi.h)

Dipanggil oleh penyedia untuk memberi tahu inti Microsoft UI Automation bahwa kontrol teks telah mengubah teks secara terprogram.

Sintaks

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

Parameter

[in] pProvider

Jenis: IRawElementProviderSimple*

Simpul penyedia tempat perubahan teks terjadi.

[in] textEditChangeType

Jenis: TextEditChangeType

Tipe perubahan edit teks yang terjadi.

[in] pChangedData

Jenis: SAFEARRAY*

Data peristiwa. Harus dapat ditetapkan sebagai VAR jenis VT_BSTR.

Nilai kembali

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Ini adalah fungsi pembantu untuk penyedia yang mengimplementasikan ITextEditProvider dan meningkatkan peristiwa pola yang diperlukan. Ikuti panduan yang diberikan dalam Pola Kontrol TextEdit yang menjelaskan kapan harus menaikkan peristiwa dan payload apa yang harus diteruskan ke Automasi UI.

Jika tidak ada klien yang mendengarkan jenis perubahan tertentu, tidak ada peristiwa yang dinaikkan.

Data peristiwa harus berisi payload yang berbeda untuk setiap jenis perubahan (per TextEditChangeType):

• TextEditChangeType_AutoCorrect: pChangedData harus menjadi string baru yang dikoreksi .
• TextEditChangeType_Composition: pChangedData harus menjadi string yang diperbarui dalam komposisi (hanya bagian yang berubah).
• TextEditChangeType_CompositionFinalized: pChangedData harus berupa string finalisasi dari komposisi yang diselesaikan (ini mungkin kosong jika komposisi dibatalkan atau dihapus).

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8.1 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 R2 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	uiautomationcoreapi.h
Pustaka	Uiautomationcore.lib
DLL	Uiautomationcore.dll

Lihat juga

HandleTextEditTextChangedEvent

ITextEditProvider

IUIAutomation3::AddTextEditTextChangedEventHandler

Pola Kontrol TextEdit