GetMenuDefaultItem 関数 (winuser.h)

  • [アーティクル]

指定したメニューの既定のメニュー項目を決定します。

構文

UINT GetMenuDefaultItem(
  [in] HMENU hMenu,
  [in] UINT  fByPos,
  [in] UINT  gmdiFlags
);

パラメーター

[in] hMenu

種類: HMENU

既定のメニュー項目を取得するメニューへのハンドル。

[in] fByPos

型: UINT

メニュー項目の識別子またはその位置を取得するかどうかを示します。 このパラメーターが FALSE の場合、識別子が返されます。 それ以外の場合は、位置が返されます。

[in] gmdiFlags

型: UINT

関数がメニュー項目を検索する方法を示します。 このパラメーターには、次の値の 0 個以上を指定できます。

値 意味
GMDI_GOINTOPOPUPS
0x0002L
 既定の項目がサブメニューを開く項目の場合、関数は対応するサブメニューで再帰的に検索します。 サブメニューに既定の項目がない場合、戻り値はサブメニューを開く項目を識別します。 既定では、サブメニューを開く項目であるかどうかに関係なく、関数は指定したメニューの最初の既定の項目を返します。
GMDI_USEDISABLED
0x0001L
 関数は、無効になっている場合でも、既定の項目を返します。 既定では、この関数は無効または灰色の項目をスキップします。

戻り値

型: UINT

関数が成功した場合、戻り値はメニュー項目の識別子または位置です。

関数が失敗した場合、戻り値は -1 です。 詳細なエラー情報を得るには、GetLastError を呼び出します。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winuser.h (Windows.h を含む)
Library User32.lib
[DLL] User32.dll
API セット ext-ms-win-ntuser-menu-l1-1-0 (Windows 8で導入)

関連項目

概念

メニュー

リファレンス

SetMenuDefaultItem