11.19.1.1 - Функция CheckMenuItem

(УстановитьГалочкуПунктуМеню)

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

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

Синтаксис

DWORD CheckMenuItem(
	HMENU hmenu,		// дескриптор меню
	UINT uIDCheckItem,		// пункт меню, напротив которого 
				// ставится или снимается отметка
	UINT uCheck		// флажки пункта меню
);

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

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

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

Смотри также
EnableMenuItem, GetMenuCheckMarkDimensions, GetMenuItemID, SetMenuItemBitmaps, SetMenuItemInfo

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

Windows NT			Да 
Win95				Да 
Win32s				Да 
Импортируемая библиотека		user32.lib 
Заголовочный файл			winuser.h 
Unicode				Нет 
Замечания по платформе		Не имеется

Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Владимир Соковиков - 08.10.2002