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


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

Удаляет элемент меню или отсоединяет подменю от указанного меню. Если элемент меню открывает раскрывающееся меню или подменю, RemoveMenu не уничтожает меню или его дескриптор, позволяя повторно использовать меню. Перед вызовом этой функции функция GetSubMenu должна получить дескриптор в раскрывающемся меню или подменю.

Синтаксис

BOOL RemoveMenu(
  [in] HMENU hMenu,
  [in] UINT  uPosition,
  [in] UINT  uFlags
);

Параметры

[in] hMenu

Тип: HMENU

Дескриптор меню для изменения.

[in] uPosition

Тип: UINT

Удаляемый пункт меню, определяемый параметром uFlags .

[in] uFlags

Тип: UINT

Указывает, как интерпретируется параметр uPosition . Этот параметр должен иметь одно из следующих значений.

Значение Значение
MF_BYCOMMAND
0x00000000L
Указывает, что uPosition предоставляет идентификатор элемента меню. Если флаг MF_BYCOMMAND и MF_BYPOSITION не указан, флаг MF_BYCOMMAND является флагом по умолчанию.
MF_BYPOSITION
0x00000400L
Указывает, что uPosition задает отсчитываемую от нуля относительную позицию элемента меню.

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

Тип: BOOL

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

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

Комментарии

Приложение должно вызывать функцию DrawMenuBar при каждом изменении меню, независимо от того, находится ли меню в отображаемом окне.

Требования

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

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

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

CreatePopupMenu

DeleteMenu

DrawMenuBar

GetSubMenu

Меню

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