ImmGetImeMenuItemsW 関数 (imm.h)

  • [アーティクル]

指定した入力コンテキストの IME メニューに登録されているメニュー項目を取得します。

構文

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

パラメーター

[in] unnamedParam1

指定したメニュー項目の入力コンテキストを処理します。

[in] unnamedParam2

メニュー情報オプションを指定するフラグ。 次の値が定義されています。

値 意味
IGIMIF_RIGHTMENU
 マウスの右クリックで取得したコンテキスト メニューのメニュー項目を取得します。

[in] unnamedParam3

取得するメニューの種類。 このパラメーターには、次の 1 つ以上の値を指定できます。

値 意味
IGIMII_CMODE
 変換モードを制御するメニュー項目を取得します。
IGIMII_SMODE
 文モードを制御するメニュー項目を取得します。
IGIMII_CONFIGURE
 IME 構成に関連するメニュー項目を取得します。
IGIMII_TOOLS
 IME ツールに関連するメニュー項目を取得します。
IGIMII_HELP
 IME ヘルプを制御するメニュー項目を取得します。
IGIMII_OTHER
 他の IME 関数を制御するメニュー項目を取得します。
IGIMII_INPUTTOOLS
 文字を入力するための拡張方法を提供する IME 入力ツールに関連するメニュー項目を制御するメニュー項目を取得します。

[out, optional] lpImeParentMenu

関数が親メニュー情報を取得する IMEMENUITEMINFO 構造体へのポインター。 この親メニューのサブメニュー項目に関する情報を取得するために、アプリケーションは fType メンバーをMFT_SUBMENUに設定します。 関数がトップレベルのメニュー項目のみを取得する場合、このパラメーターには NULL が 含まれます。

[out, optional] lpImeMenu

関数がメニュー項目に関する情報を取得する IMEMENUITEMINFO 構造体の配列へのポインター。 関数が登録済みのメニュー項目の数を取得する場合、このパラメーターには NULL が含まれます。

[in] dwSize

IMEMENUITEMINFO 構造体を受け取るバッファーのサイズ。

戻り値

lpImeMenu にコピーされたメニュー項目の数を返します。 lpImeMenu が NULL を指定した場合、関数は指定された入力コンテキストに登録されているメニュー項目の数を返します。

注釈

注意

imm.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして ImmGetImeMenuItems を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows XP [デスクトップ アプリのみ]、東アジア言語のサポートがインストールされています。
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー imm.h (Immdev.h、Windows.h を含む)
Library Imm32.lib
[DLL] Imm32.dll

こちらもご覧ください

IMEMENUITEMINFO

入力メソッド マネージャー

入力メソッド マネージャー関数