Edit fungsi panggilan balik EDITWORDBREAKPROCA (winuser.h)

Artikel
03/13/2024

Fungsi panggilan balik yang ditentukan aplikasi yang digunakan dengan pesan EM_SETWORDBREAKPROC . Kontrol edit multibaris atau kontrol edit kaya memanggil fungsi EditWordBreakProc untuk memecah baris teks.

Jenis EDITWORDBREAKPROC menentukan penunjuk ke fungsi panggilan balik ini. EditWordBreakProc adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi.

Sintaks

EDITWORDBREAKPROCA Editwordbreakproca;

int Editwordbreakproca(
  [in] LPSTR lpch,
  [in] int ichCurrent,
  [in] int cch,
  [in] int code
)
{...}

Parameter

[in] lpch

Jenis: LPTSTR

Penunjuk ke teks kontrol edit.

[in] ichCurrent

Jenis: int

Indeks ke posisi karakter di buffer teks yang mengidentifikasi titik di mana fungsi harus mulai memeriksa pemisah kata.

[in] cch

Jenis: int

Jumlah TCHAR dalam teks kontrol edit. Untuk teks ANSI, ini adalah jumlah byte; untuk teks Unicode, ini adalah jumlah WCHAR.

[in] code

Jenis: int

Tindakan yang akan diambil oleh fungsi panggilan balik. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
WB_CLASSIFY	Mengambil bendera kelas karakter dan pemisah kata karakter pada posisi yang ditentukan. Nilai ini untuk digunakan dengan kontrol edit yang kaya.
WB_ISDELIMITER	Memeriksa apakah karakter pada posisi yang ditentukan adalah pemisah.
WB_LEFT	Menemukan awal kata di sebelah kiri posisi yang ditentukan.
WB_LEFTBREAK	Menemukan pemisah akhir kata di sebelah kiri posisi yang ditentukan. Nilai ini untuk digunakan dengan kontrol edit yang kaya.
WB_MOVEWORDLEFT	Menemukan awal kata di sebelah kiri posisi yang ditentukan. Nilai ini digunakan selama pemrosesan kunci CTRL+LEFT. Nilai ini untuk digunakan dengan kontrol edit yang kaya.
WB_MOVEWORDRIGHT	Menemukan awal kata di sebelah kanan posisi yang ditentukan. Nilai ini digunakan selama pemrosesan kunci CTRL+RIGHT. Nilai ini untuk digunakan dengan kontrol edit yang kaya.
WB_RIGHT	Menemukan awal kata di sebelah kanan posisi yang ditentukan. Ini berguna dalam kontrol pengeditan yang selaras kanan.
WB_RIGHTBREAK	Menemukan pemisah akhir kata di sebelah kanan posisi yang ditentukan. Ini berguna dalam kontrol pengeditan yang selaras kanan. Nilai ini untuk digunakan dengan kontrol edit yang kaya.

Mengembalikan nilai

Jenis: int

Jika parameter kode menentukan WB_ISDELIMITER, nilai yang dikembalikan bukan nol (TRUE) jika karakter pada posisi yang ditentukan adalah pemisah, atau nol jika tidak. Jika parameter kode menentukan WB_CLASSIFY, nilai yang dikembalikan adalah kelas karakter dan bendera pemisah kata karakter pada posisi yang ditentukan. Jika tidak, nilai yang dikembalikan adalah indeks ke awal kata dalam buffer teks.

Keterangan

Pengembalian pengangkutan diikuti oleh umpan baris harus diperlakukan sebagai satu kata oleh fungsi panggilan balik. Dua pengembalian pengangkutan diikuti oleh umpan baris juga harus diperlakukan sebagai satu kata.

Aplikasi harus menginstal fungsi panggilan balik dengan menentukan alamat fungsi panggilan balik dalam pesan EM_SETWORDBREAKPROC .

Kaya Edit 1.0:Microsoft Rich Edit 1.0 hanya meneruskan kembali karakter ANSI ke EditWordBreakProc. Untuk kontrol pengeditan kaya, Anda dapat secara bergantian menggunakan pesan EM_SETWORDBREAKPROCEX untuk mengganti prosedur pemisah kata yang diperluas default dengan fungsi panggilan balik EditWordBreakProcEx . Fungsi ini menyediakan informasi tambahan tentang teks, seperti kumpulan karakter.

Kaya Edit 2.0 dan yang lebih baru:Microsoft Rich Edit 2.0 dan yang lebih baru hanya meneruskan kembali karakter Unicode ke EditWordBreakProc. Dengan demikian, aplikasi ANSI akan mengonversi string Unicode yang disediakan Rich Edit menggunakan WideCharToMultiByte, lalu menerjemahkan indeks dengan tepat.

Catatan

Header winuser.h mendefinisikan EDITWORDBREAKPROC sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (termasuk Windows.h)