Функция RemoveMenu удаляет пункт меню или отключает подменю от заданного меню. Если пункт меню открывает "выпадающее" меню, или подменю, RemoveMenu не уничтожает меню или его дескриптор, разрешая ему многократно использоваться. Прежде, чем эта функция вызывается, функция GetSubMenu должна извлечь дескриптор "выпадающего" меню или подменю.
Синтаксис
BOOL RemoveMenu( HMENU hMenu, UINT uPosition, UINT uFlags ); |
Параметры
hMenu
[in] Дескриптор меню, которое измениться.uPosition
[in] Определяет пункт меню, который должен быть удален, как обусловлено параметром uFlags.uFlags
[in] Определяет как интерпретировать параметр uPosition. Этим параметром должно быть одно из ниже следующих значений.| Значение | Предназначение |
| MF_BYCOMMAND | Указывает, что uPosition дает идентификатор пункта меню. Если не установлен ни флажок MF_BYCOMMAND, ни флажок MF_BYPOSITION, то флажок MF_BYCOMMAND является заданным по умолчанию. |
| MF_BYPOSITION | Указывает, что uPosition дает отсчитываемую от нуля относительную позицию пункта меню. |
Возвращаемые значения
Если функция завершается успешно, величина возвращаемого значения - не нуль.
Если функция завершается ошибкой, величина возвращаемого значения - нуль. Чтобы получить дополнительные данные об ошибке, вызовите GetLastError.
Замечания
Приложение должно вызывать функцию DrawMenuBar всякий раз, когда изменяется меню, чтобы выявить действительно ли меню находится в отображаемом на экране окне.
Смотри также
Краткий обзор Меню, CreatePopupMenu, DeleteMenu, DrawMenuBar, GetSubMenu|
Размещение и совместимость RemoveMenu |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
User32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Winuser.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |