共用方式為

ImmGetImeMenuItemsA 函式 （immdev.h）

  • 發行項

擷取在指定輸入內容的 IME 功能表中註冊的功能表項。

語法

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

參數

[in] unnamedParam1

指定功能表項的輸入內容句柄。

[in] unnamedParam2

指定功能表資訊選項的旗標。 定義下列值。

價值 意義
IGIMIF_RIGHTMENU
 擷取操作功能表的功能表項，按下滑鼠右鍵即可取得。

[in] unnamedParam3

要擷取的功能表類型。 此參數可以有下列一或多個值。

價值 意義
IGIMII_CMODE
 擷取控制轉換模式的功能表項。
IGIMII_SMODE
 擷取控制句子模式的功能表項。
IGIMII_CONFIGURE
 擷取與 IME 組態相關的功能表項。
IGIMII_TOOLS
 擷取與 IME 工具相關的功能表項。
IGIMII_HELP
 擷取控制 IME 說明的功能表項。
IGIMII_OTHER
 擷取控制其他 IME 函式的功能表項。
IGIMII_INPUTTOOLS
 擷取控制輸入工具相關功能表項的功能表項，提供輸入字元的延伸方式。

[out, optional] lpImeParentMenu

IMEMENUITEMINFO 的指標 結構，函式會擷取父功能表資訊。 若要擷取此父功能表子功能表專案的相關信息，應用程式 會將 fType 成員設定為MFT_SUBMENU。 如果函式只擷取最上層功能表項，此參數 會包含 null。

[out, optional] lpImeMenu

IMEMENUITEMINFO 陣列的指標 結構，函式會擷取功能表項的相關信息。 如果函式擷取已註冊功能表項的數目，此參數會包含 NULL。

[in] dwSize

要接收 IMEMENUITEMINFO 結構的緩衝區大小。

傳回值

會傳回復制到 lpImeMenu的功能表項數目。 如果 lpImeMenu 指定 NULL，則函式會傳回指定輸入內容中已註冊的功能表項數目。

言論

注意

immdev.h 標頭會根據 UNICODE 預處理器常數的定義，將 ImmGetImeMenuItems 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]，已安裝東亞語言支援。
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 immdev.h （include Immdev.h， Windows.h）
連結庫 Imm32.lib
DLL Imm32.dll

另請參閱

IMEMENUITEMINFO

Input Method Manager

Input Method Manager 函式