Функция 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) |
См. также раздел
Основные понятия
Справочные материалы