Baca dalam bahasa Inggris

Bagikan melalui

Fungsi ImmSetCompositionStringW (imm.h)

  • Artikel

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

Sintaksis

BOOL ImmSetCompositionStringW(
                 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 Arti
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 klausul yang valid.
SCS_SETRECONVERTSTRING
 Windows Me/98, Windows 2000, Windows XP: Minta IME untuk mengkonversi kembali string menggunakan struktur RECONVERTSTRING yang ditentukan.
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.

Mengembalikan nilai

Mengembalikan nilai bukan nol jika berhasil, atau 0 sebaliknya.

Komentar

Aplikasi dapat mengatur lpComp, lpRead, atau keduanya. Jika aplikasi tidak menentukan nilai untuklpComp , 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 belum 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 tahu perubahan tersebut.

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

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

Catatan

Header imm.h mendefinisikan ImmSetCompositionString sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem 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

Syarat Nilai
klien minimum yang didukung Windows XP [hanya aplikasi desktop],dukungan bahasa Asia Timur terinstal.
server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Platform Target 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