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

要擷取信息的專案。 如果此參數為零，函式會擷取功能表本身的相關信息。 如果此參數為 1，函式會擷取功能表上第一個專案的相關信息，依此類故。

[in, out] pmbi

類型： PMENUBARINFO

接收資訊的 MENUBARINFO 結構的指標。 請注意，您必須先將 cbSize 成員設定為 sizeof(MENUBARINFO) ，才能呼叫此函式。

傳回值

類型： BOOL

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 winuser.h (包括 Windows.h)
程式庫 User32.lib
Dll User32.dll
API 集合 ext-ms-win-ntuser-misc-l1-5-0 (於 Windows 10 10.0.10240 版)

另請參閱

概念

GetMenu

GetSystemMenu

MENUBARINFO

功能表

參考