Fungsi ImmGetImeMenuItemsA (imm.h)

Artikel
11/20/2024

Mengambil item menu yang terdaftar di menu IME dari konteks input tertentu.

Sintaksis

DWORD ImmGetImeMenuItemsA(
  [in]            HIMC               unnamedParam1,
  [in]            DWORD              unnamedParam2,
  [in]            DWORD              unnamedParam3,
  [out, optional] LPIMEMENUITEMINFOA lpImeParentMenu,
  [out, optional] LPIMEMENUITEMINFOA lpImeMenu,
  [in]            DWORD              dwSize
);

Parameter

[in] unnamedParam1

Tangani ke konteks input untuk item menu yang ditentukan.

[in] unnamedParam2

Bendera yang menentukan opsi informasi menu. Nilai berikut ditentukan.

Nilai	Arti
IGIMIF_RIGHTMENU	Ambil item menu untuk menu konteks, yang diperoleh dengan klik kanan mouse.

[in] unnamedParam3

Jenis menu yang akan diambil. Parameter ini dapat memiliki satu atau beberapa nilai berikut.

Nilai	Arti
IGIMII_CMODE	Ambil item menu yang mengontrol mode konversi.
IGIMII_SMODE	Ambil item menu yang mengontrol mode kalimat.
IGIMII_CONFIGURE	Ambil item menu yang terkait dengan konfigurasi IME.
IGIMII_TOOLS	Ambil item menu yang terkait dengan alat IME.
IGIMII_HELP	Ambil item menu yang mengontrol Bantuan IME.
IGIMII_OTHER	Ambil item menu yang mengontrol fungsi IME lainnya.
IGIMII_INPUTTOOLS	Ambil item menu yang mengontrol item menu yang terkait dengan alat input IME yang menyediakan cara yang diperluas untuk memasukkan karakter.

[out, optional] lpImeParentMenu

Penunjuk ke struktur IMEMENUITEMINFO di mana fungsi mengambil informasi menu induk. Untuk mengambil informasi tentang item submenu menu induk ini, aplikasi mengatur anggota fType ke MFT_SUBMENU. Parameter ini berisi NULL jika fungsi hanya mengambil item menu tingkat atas.

[out, optional] lpImeMenu

Penunjuk ke array struktur IMEMENUITEMINFO tempat fungsi mengambil informasi tentang item menu. Parameter ini berisi NULL jika fungsi mengambil jumlah item menu terdaftar.

[in] dwSize

Ukuran buffer untuk menerima struktur IMEMENUITEMINFO .

Mengembalikan nilai

Mengembalikan jumlah item menu yang disalin ke lpImeMenu. Jika lpImeMenu menentukan NULL, fungsi mengembalikan jumlah item menu terdaftar dalam konteks input yang ditentukan.

Komentar

Nota

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

IMEMENUITEMINFO

Manajer Metode Input

Fungsi Manajer Metode Input

Bagikan melalui