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

Статья
03/04/2024

Удаляет элемент меню или отсоединяет подменю от указанного меню. Если элемент меню открывает раскрывающееся меню или подменю, 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.

Требования

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