Функция RemoveMenu

Функция 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, DrawMenuBarGetSubMenu

Размещение и совместимость 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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz