Функция GetMenuBarInfo (winuser.h)

Статья
08/27/2023

Извлекает сведения об указанной строке меню.

Синтаксис

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 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-misc-l1-5-0 (представлен в Windows 10 версии 10.0.10240)

См. также раздел

Основные понятия

Справочные материалы