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


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

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

Синтаксис

HMENU LoadMenuA(
  [in, optional] HINSTANCE hInstance,
  [in]           LPCSTR    lpMenuName
);

Параметры

[in, optional] hInstance

Тип: HINSTANCE

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

[in] lpMenuName

Тип: LPCTSTR

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

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

Тип: HMENU

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

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

Комментарии

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

Примеры

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

Примечание

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

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header 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

Меню

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