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

Статья
20.11.2024

Загружает указанный ресурс меню из исполняемого файла (.exe), связанного с экземпляром приложения.

Синтаксис

C++

HMENU LoadMenuW(
  [in, optional] HINSTANCE hInstance,
  [in]           LPCWSTR   lpMenuName
);

Параметры

[in, optional] hInstance

Тип: HINSTANCE

Дескриптор модуля, содержащий ресурс меню для загрузки.

[in] lpMenuName

Тип: LPCTSTR

Имя ресурса меню. Кроме того, этот параметр может состоять из идентификатора ресурса в слове с низким порядком и ноль в слове высокого порядка. Чтобы создать это значение, используйте макрос MAKEINTRESOURCE.

Возвращаемое значение

Тип: HMENU

Если функция выполнена успешно, возвращаемое значение является дескриптором ресурса меню.

Если функция завершается ошибкой, возвращаемое значение равно NULL. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

Функция DestroyMenu используется перед закрытием приложения для уничтожения меню и свободного памяти, занятой загруженным меню.

Примеры

Пример см. в разделе Отображение контекстного меню

Примечание

Заголовок winuser.h определяет LoadMenu как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winuser.h (включая Windows.h)
библиотеки	User32.lib
DLL	User32.dll
набор API	ext-ms-win-ntuser-menu-l1-1-3 (представлено в Windows 10 версии 10.0.14393)

См. также

концептуальные

LoadMenuIndirect

MAKEINTRESOURCE

меню

Справочник

Поделиться через