Struktur IMESTRUCT (ime.h)

Digunakan oleh SendIMEMessageEx untuk menentukan subfungsi yang akan dijalankan dalam pesan Editor Metode Input (IME) dan parameternya. Struktur ini juga digunakan untuk menerima nilai pengembalian dari subfungsi tersebut.

Sintaks

typedef struct tagIMESTRUCT {
  UINT   fnc;
  WPARAM wParam;
  UINT   wCount;
  UINT   dchSource;
  UINT   dchDest;
  LPARAM lParam1;
  LPARAM lParam2;
  LPARAM lParam3;
} IMESTRUCT, *PIMESTRUCT, *NPIMESTRUCT, *LPIMESTRUCT;

Anggota

fnc

Sebuah subfungsi. Salah satu nilai berikut.

IME_ENTERWORDREGISTERMODE

Digunakan untuk mendaftarkan kata-kata. Kata-kata terdaftar sebagai aplikasi mengirimkan kata dan pembacaannya. Anggota struktur ditafsirkan sebagai berikut:

Nilai yang dikembalikan menunjukkan hasil pendaftaran kata. TRUE jika pendaftaran telah diproses secara normal; jika tidak, FALSE.

Jika informasi seperti bagian dari ucapan diperlukan, kotak dialog harus ditampilkan untuk meminta input kepada pengguna. NULL dapat ditentukan dalam anggota lParam1 dan lParam2; dalam hal ini, tidak ada yang harus ditampilkan di bidang entri terkait dalam kotak dialog.

IME_GETCONVERSIONMODE

Memperoleh mode konversi IME saat ini. Subprogram ini tidak menggunakan parameter.

Ini sama dengan IME_GET_MODE.

Mengembalikan mode konversi IME saat ini sebagai kombinasi IME_MODE_ALPHANUMERIC ke IME_MODE_NOCODEINPUT. Mode konversi adalah sebagai berikut:

IME_GET_MODE

Sama seperti IME_GETCONVERSIONMODE.

IME_MOVECONVERTWINDOW

Sama seperti IME_SETCONVERSIONWINDOW.

IME_SETCONVERSIONFONTEX

Font yang akan digunakan untuk menampilkan string yang tidak ditentukan yang muncul di jendela konversi. Anggota struktur ditafsirkan sebagai berikut:

Subfungsi ini tidak memiliki nilai pengembalian.

Font yang ditentukan oleh IME_SETCONVERSIONFONTEX hanya dapat digunakan untuk menampilkan string yang tidak ditentukan.

Untuk menampilkan string yang tidak ditentukan pada posisi default, gunakan font sistem. Jika posisi tampilan tidak lagi menjadi posisi default, aktifkan font yang ditentukan sebelumnya.

Memori global yang berisi struktur LOGFONT dirilis oleh aplikasi.

Jika IME yang saat ini menampilkan jendela konversi menerima perintah IME_SETCONVERSIONFONTEX , dan sebagai hasil dari perintah yang memproses jendela konversi telah berubah, IME harus mengirim pesan WM_IME_REPORT:IR_CHANGECONVERT. Pesan ini tidak boleh dikirim jika font yang ditentukan oleh IME_SETCONVERSIONFONTEX sama dengan yang digunakan oleh IME.

IME_SETCONVERSIONMODE

Mengatur mode konversi IME. Anggota wParam menentukan satu atau beberapa nilai berikut:

Nilai yang dikembalikan menunjukkan apakah mode konversi yang diberikan telah berhasil disiapkan. Ini mengembalikan status mode konversi yang sebelumnya berlaku jika mode konversi baru telah disiapkan; jika tidak, NULL.

IME_SETCONVERSIONWINDOW

Ukuran dan posisi persegi panjang pembatas untuk IME, dan posisi awal jendela konversi. IME menampilkan string yang tidak ditentukan pada posisi yang ditentukan oleh subfungsi ini.

Anggota wParam menentukan salah satu nilai berikut:

Nilai yang dikembalikan menunjukkan apakah perintah telah dijalankan. TRUE jika eksekusi perintah berhasil; jika tidak, FALSE.

Jika string yang tidak ditentukan tampaknya meluapkan persegi panjang pembatas, IME harus mengeluarkan pesan laporan WM_IME_REPORT:IR_FULLCONVERT ke aplikasi sebelum menampilkan string tersebut. Jika aplikasi tidak menangani pesan ini, pemrosesan berikutnya untuk tampilan tidak diformulasikan dalam spesifikasi ini, tetapi diserahkan ke IME. Misalnya, string yang tidak ditentukan mungkin digulir dalam persegi panjang pembatas atau dapat dipindahkan sementara ke posisi default.

Jika pesan IME_SETCONVERSIONWINDOW dipanggil saat IME memegang string yang tidak ditentukan, IME harus mengeluarkan pesan WM_IME_REPORT:IR_CLOSECONVERT; jika string cocok di jendela yang diberikan sebagai parameter, IME harus mengeluarkan pesan WM_IME_REPORT:IR_OPENCONVERT. Hanya dengan begitu jendela konversi harus digambar. Jika string tidak pas di jendela, IME harus mengeluarkan pesan WM_IME_REPORT:IR_FULLCONVERT.

Posisi persegi panjang pembatas dapat ditentukan di luar area layar fisik. Jika seluruh persegi panjang pembatas berada di luar layar fisik, string yang tidak ditentukan tidak boleh ditampilkan. Jika bagian dari persegi panjang pembatas berada di luar layar fisik, IME akan mengklip persegi panjang pembatas sehingga tidak ada bagian dari string yang tidak ditentukan yang meluap di layar, dan juga menyesuaikan posisi mulai tampilan.

Disarankan untuk tidak mengatur jumlah maksimum baris, atau karakter maksimum yang ditampilkan di, jendela konversi.

Jika jendela konversi tumpang tindih dengan jendela sistem, jendela konversi harus terlihat. Misalnya, jendela konversi dapat diberikan prioritas utama untuk tampilan atau jendela sistem dapat dipindahkan ke tempat lain.

IME harus mengirim pesan IR_CHANGECONVERT jika jendela konversi telah berubah dalam ukuran, konten tampilan, atau warna tampilan. Namun, jika string yang tidak ditentukan tidak cocok di jendela tertentu, IME harus mengirim pesan IR_FULLCONVERT daripada IR_CHANGECONVERT.

Ketika IME telah bergeser dari mode MCW_WINDOW atau MCW_SCREEN ke MCW_DEFAULT, IME harus mengirim pesan IR_CLOSECONVERT jika string yang tidak ditentukan ada.

Ketika IME telah bergeser dari mode MCW_WINDOW atau MCW_SCREEN ke MCW_HIDDEN, IME harus mengirim pesan IR_CLOSECONVERT jika ada string yang tidak ditentukan.

Ketika IME telah bergeser dari mode MCW_HIDDEN ke MCW_DEFAULT, MCW_SCREEN, atau MCW_WINDOW, IME harus mengirimkan pesan IR_UNDETERMINE dengan string yang tidak ditentukan = 0 dan string yang ditentukan = 0.

IME_SETLEVEL

Subfungsi khusus Korea yang menetapkan tingkat IME pada aplikasi saat ini. Anggota wParam menerima salah satu nilai tingkat berikut.

IME_SETOPEN

Menetapkan status fitur konversi kana-ke-kanji dari IME.

Anggota wParam diatur ke nonzero untuk membuka IME dan nol untuk menutup IME

Nilai yang dikembalikan menunjukkan status sebelumnya dari fitur konversi kana-ke-kanji. Mengembalikan TRUE jika terbuka; jika tidak, FALSE.

String yang tidak ditentukan tidak boleh ditentukan jika fitur konversi kana-ke-kanji telah ditutup oleh IME_SETOPEN.

Ketika fitur konversi kana-ke-kanji ditutup oleh IME_SETOPEN, IME harus mengirim pesan IR_CLOSECONVERT jika IME dalam mode MCW_WINDOW atau MCW-SCREEN dan jika jendela konversi terbuka. Namun, IME tidak perlu mengeluarkan IR_CLOSECONVERT jika berada dalam mode MCW_HIDDEN dan jika string yang tidak ditentukan ada.

IME_SET_MODEK

Versi IME_SETCONVERSIONMODE khusus Korea.

wParam

Penggunaan tergantung pada subfungsi yang ditentukan dalam fnc.

wCount

Penggunaan tergantung pada subfungsi yang ditentukan dalam fnc.

dchSource

Penggunaan tergantung pada subfungsi yang ditentukan dalam fnc.

dchDest

Penggunaan tergantung pada subfungsi yang ditentukan dalam fnc.

lParam1

Penggunaan tergantung pada subfungsi yang ditentukan dalam fnc.

lParam2

Penggunaan tergantung pada subfungsi yang ditentukan dalam fnc.

lParam3

Penggunaan tergantung pada subfungsi yang ditentukan dalam fnc.

Persyaratan

Lihat juga

Clipboard

Konseptual

Referensi

SetClipboardData