Функция CheckMenuItem

Функция CheckMenuItem устанавливает атрибут "галочки" заданного пункта меню в выбранное или не выбранное состояние.

Синтаксис

DWORD CheckMenuItem( 
    HMENU hmenu,
    UINT uIDCheckItem,
    UINT uCheck
);

Параметр

hmenu

[in] Дескриптор интересующего нас меню.

uIDCheckItem

[in] Определяет пункт меню, атрибут "галочки" которого должен быть установлен, как определено параметром uCheck.

uCheck

[in] Определяет флажки, которые управляют интерпретацией параметра uIDCheckItem и состоянием атрибута "галочки " пункта меню. Этот параметр может быть комбинацией или MF_BYCOMMAND, или MF_BYPOSITION и MF_CHECKED или MF_UNCHECKED.

 

Значение

Предназначение

MF_BYCOMMAND

Указывает, что параметр uIDCheckItem дает идентификатор пункта меню. Флажок MF_BYCOMMAND является значением по умолчанию, если не установлены, ни флажок MF_BYCOMMAND, ни флажок MF_BYPOSITION. 

MF_BYPOSITION

Указывает, что параметр uIDCheckItem дает отсчитываемую от нуля относительную позицию пункта меню. 

MF_CHECKED

Устанавливает атрибут "галочки" в выбранное состояние. 

MF_UNCHECKED

Устанавливает атрибут "галочки" в не выбранное состояние. 

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

Возвращаемое значение определяет предшествующее состояние пункта меню (или MF_CHECKED или MF_UNCHECKED). Если пункт меню не существует, возвращаемое значение равно - (минус) 1.

Замечания

Обратите внимание! на то, что функция CheckMenuItem была заменена функцией SetMenuItemInfo. Однако Вы все еще можете использовать CheckMenuItem, если не нуждаетесь в какой-либо из дополнительных возможностей функции SetMenuItemInfo. 

Пункт в строке меню не может иметь "галочку".

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

Пример

Пример смотри в статье Моделирование окошек меток в меню.

Смотри также

Краткий обзор МенюEnableMenuItemGetMenuItemID, SetMenuItemBitmaps, SetMenuItemInfo

 

Размещение и совместимость CheckMenuItem

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