WM_IME_COMPOSITION pesan

Artikel
06/12/2023

Dikirim ke aplikasi ketika IME mengubah status komposisi sebagai akibat dari penekanan tombol. Jendela menerima pesan ini melalui fungsi WindowProc-nya .

LRESULT CALLBACK WindowProc(
  HWND  hwnd,     
  WM_IME_COMPOSITION,   
  WPARAM wParam,
  LPARAM lParam          
);

Parameter

hwnd

Handel ke jendela.

wParam

Karakter DBCS yang mewakili perubahan terbaru pada string komposisi.

lParam

Nilai yang menentukan bagaimana string komposisi atau karakter berubah. Parameter ini bisa menjadi satu atau beberapa nilai berikut. Untuk informasi selengkapnya tentang nilai-nilai ini, lihat Nilai String Komposisi IME.

GCS_COMPATTR
GCS_COMPCLAUSE
GCS_COMPREADSTR
GCS_COMPREADATTR
GCS_COMPREADCLAUSE
GCS_COMPSTR
GCS_CURSORPOS
GCS_DELTASTART
GCS_RESULTCLAUSE
GCS_RESULTREADCLAUSE
GCS_RESULTREADSTR
GCS_RESULTSTR

Parameter lParam juga dapat memiliki satu atau beberapa nilai berikut.

Nilai	Makna
CS_INSERTCHAR	Sisipkan karakter komposisi wParam pada titik penyisipan saat ini. Aplikasi harus menampilkan karakter komposisi jika memproses pesan ini.
CS_NOMOVECARET	Jangan pindahkan posisi tanda sisipan sebagai akibat dari pemrosesan pesan. Misalnya, jika IME menentukan kombinasi CS_INSERTCHAR dan CS_NOMOVECARET, aplikasi harus menyisipkan karakter yang ditentukan pada posisi tanda sisipan saat ini tetapi tidak boleh memindahkan tanda sisipan ke posisi berikutnya. Pesan WM_IME_COMPOSITION berikutnya dengan GCS_RESULTSTR akan menggantikan karakter ini.

Nilai kembali

Pesan ini tidak memiliki nilai pengembalian.

Keterangan

Aplikasi harus memproses pesan ini jika menampilkan karakter komposisi itu sendiri. Jika tidak, pesan akan dikirim ke jendela IME.

Jika aplikasi telah membuat jendela IME, aplikasi harus meneruskan pesan ini ke jendela tersebut. Fungsi DefWindowProc memproses pesan ini dengan meneruskannya ke jendela IME default. Jendela IME memproses pesan ini dengan memperbarui tampilannya berdasarkan bendera perubahan yang ditentukan. Aplikasi dapat memanggil ImmGetCompositionString untuk mengambil status komposisi baru.

Jika tidak ada nilai GCS_ yang diatur, pesan menunjukkan bahwa komposisi saat ini telah dibatalkan dan aplikasi yang menggambar string komposisi harus menghapus string.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Winuser.h (termasuk Windows.h); Imm.h (termasuk Windows.h)

Lihat juga

Manajer Metode Input
Pesan Manajer Metode Input
ImmGetCompositionString

Bagikan melalui