immGetImeMenuItemsA 函式 (imm.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
 擷取與輸入法組態相關的功能表項目。
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，函式會傳回指定輸入內容中已註冊功能表項目的數目。

備註

注意

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

需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]，已安裝東亞語言支援。
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 imm.h (包括 Immdev.h、Windows.h)
程式庫 Imm32.lib
Dll Imm32.dll

另請參閱

IMEMENUITEMINFO

輸入方法管理員

輸入方法管理員函式