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

  • Статья

Назначает новое меню указанному окну.

Синтаксис

BOOL SetMenu(
  [in]           HWND  hWnd,
  [in, optional] HMENU hMenu
);

Параметры

[in] hWnd

Тип: HWND

Дескриптор окна, которому будет назначено меню.

[in, optional] hMenu

Тип: HMENU

Дескриптор нового меню. Если этот параметр имеет значение NULL, текущее меню окна удаляется.

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

Тип: BOOL

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

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

Комментарии

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

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

Требования

Требование Значение
Минимальная версия клиента 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)

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

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

DestroyMenu

GetMenu

Меню

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