Fungsi ImmSetCompositionStringA (imm.h)

Artikel
08/24/2023

Mengatur karakter, atribut, dan klausa komposisi dan string baca.

Sintaks

BOOL ImmSetCompositionStringA(
                 HIMC   unnamedParam1,
  [in]           DWORD  dwIndex,
  [in, optional] LPVOID lpComp,
  [in]           DWORD  dwCompLen,
  [in, optional] LPVOID lpRead,
  [in]           DWORD  dwReadLen
);

Parameter

unnamedParam1

[in] dwIndex

Jenis informasi yang akan diatur. Parameter ini dapat memiliki salah satu nilai berikut.

Nilai	Makna
SCS_SETSTR	Atur string komposisi, string baca, atau keduanya. Setidaknya salah satu parameter lpComp dan lpRead harus menunjukkan string yang valid. Jika salah satu string terlalu panjang, IME memotongnya.
SCS_CHANGEATTR	Atur atribut untuk string komposisi, string baca, atau keduanya. Setidaknya salah satu parameter lpComp dan lpRead harus menunjukkan array atribut yang valid.
SCS_CHANGECLAUSE	Atur informasi klausa untuk string komposisi, string bacaan, atau keduanya. Setidaknya salah satu parameter lpComp dan lpRead harus menunjuk ke array informasi klausa yang valid.
SCS_SETRECONVERTSTRING	Windows Me/98, Windows 2000, Windows XP: Minta IME untuk mengkonversi kembali string menggunakan struktur RECONVERTSTRING tertentu.
SCS_QUERYRECONVERTSTRING	Windows Me/98, Windows 2000, Windows XP: Minta IME untuk menyesuaikan struktur RECONVERTSTRING . Kemudian aplikasi dapat meneruskan struktur yang disesuaikan ke dalam fungsi ini menggunakan SCS_SETRECONVERTSTRING. IME tidak menghasilkan pesan WM_IME_COMPOSITION apa pun.

[in, optional] lpComp

Penunjuk ke buffer yang berisi informasi yang akan diatur untuk string komposisi, seperti yang ditentukan oleh nilai dwIndex.

[in] dwCompLen

Ukuran, dalam byte, dari buffer informasi untuk string komposisi, bahkan jika SCS_SETSTR ditentukan dan buffer berisi string Unicode.

[in, optional] lpRead

Penunjuk ke buffer yang berisi informasi yang akan diatur untuk string bacaan, seperti yang ditentukan oleh nilai dwIndex. Aplikasi dapat mengatur parameter ini ke NULL.

[in] dwReadLen

Ukuran, dalam byte, dari buffer informasi untuk string bacaan, bahkan jika SCS_SETSTR ditentukan dan buffer berisi string Unicode.

Menampilkan nilai

Mengembalikan nilai bukan nol jika berhasil, atau 0 sebaliknya.

Keterangan

Aplikasi dapat mengatur lpComp, lpRead, atau keduanya. Jika aplikasi tidak menentukan nilai untuk lpComp, aplikasi harus mengatur parameter ini ke NULL dan mengatur dwCompLen ke 0.

Saat aplikasi mengubah atribut, semua karakter dalam klausul harus memiliki atribut yang sama. Karakter yang dikonversi harus memiliki atribut ATTR_CONVERTED atau ATTR_TARGET_CONVERTED. Karakter yang tidak dikonversi harus memiliki atribut ATTR_INPUT atau ATTR_TARGET_NOTCONVERTED.

Ketika aplikasi mengubah informasi klausa, aplikasi hanya dapat mengubah klausul target, hanya memengaruhi satu batas pada satu waktu. Klausa target memiliki atribut ATTR_TARGET_CONVERTED atau ATTR_TARGET_NOTCONVERTED.

Untuk informasi tambahan tentang atribut (nilai ATTR_*), lihat String Komposisi.

Ketika IME menyelesaikan perubahan, IME mengirimkan pesan WM_IME_COMPOSITION ke aplikasi untuk memberi tahunya tentang perubahan.

Windows Me/98, Windows 2000, Windows XP: Nilai SCS_*CONVERTSTRING digunakan untuk rekonversi. Mereka hanya dapat digunakan untuk IME yang memiliki properti SCS_CAP_SETRECONVERTSTRING. Aplikasi menggunakan nilai-nilai ini sebagai berikut:

Panggil ImmSetCompositionString dengan SCS_QUERYRECONVERTSTRING, sehingga IME menyesuaikan struktur RECONVERTSTRING untuk rekonversi.
Panggil ImmSetCompositionString dengan SCS_SETRECONVERTSTRING, sehingga IME menghasilkan string komposisi baru. Setelah ini, lpComp dan lpRead menunjukkan struktur RECONVERTSTRING yang berisi komposisi dan string baca yang diperbarui. Gunakan nilai lpRead hanya ketika IME yang dipilih telah SCS_CAP_MAKEREAD diatur.

Catatan

Header imm.h mendefinisikan ImmSetCompositionString 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


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop],dukungan bahasa Asia Timur terinstal.
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	imm.h (termasuk Immdev.h, Windows.h)
Pustaka	Imm32.lib
DLL	Imm32.dll

Lihat juga

Manajer Metode Input

Fungsi Manajer Metode Input

RECONVERTSTRING

WM_IME_COMPOSITION

Bagikan melalui