GetMenuBarInfo 関数 (winuser.h)

  • [アーティクル]

指定したメニュー バーに関する情報を取得します。

構文

BOOL GetMenuBarInfo(
  [in]      HWND         hwnd,
  [in]      LONG         idObject,
  [in]      LONG         idItem,
  [in, out] PMENUBARINFO pmbi
);

パラメーター

[in] hwnd

型: HWND

情報を取得するウィンドウ (メニュー バー) へのハンドル。

[in] idObject

型: LONG

メニュー オブジェクト。 このパラメーターには、次の値のいずれかを指定できます。

値 意味
OBJID_CLIENT
((LONG)0xFFFFFFFC)
 ウィンドウに関連付けられているポップアップ メニュー。
OBJID_MENU
((LONG)0xFFFFFFFD)
 ウィンドウに関連付けられているメニュー バー ( GetMenu 関数を参照)。
OBJID_SYSMENU
((LONG)0xFFFFFFFF)
 ウィンドウに関連付けられているシステム メニュー ( GetSystemMenu 関数を参照)。

[in] idItem

型: LONG

情報を取得するアイテム。 このパラメーターが 0 の場合、関数はメニュー自体に関する情報を取得します。 このパラメーターが 1 の場合、関数はメニューの最初の項目に関する情報を取得します。

[in, out] pmbi

種類: PMENUBARINFO

情報を受け取る MENUBARINFO 構造体へのポインター。 この関数を呼び出す前に、 cbSize メンバーを に設定する sizeof(MENUBARINFO) 必要があることに注意してください。

戻り値

種類: BOOL

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

要件

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

関連項目

概念

GetMenu

GetSystemMenu

MENUBARINFO

メニュー

参照