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 _ BYCOMMAND | Указывает, что значение uIDCheckItem представляет собой идентификатор пункта меню. |
| MF _ BYPOSITION | Указывает, что значение uIDCheckItem представляет собой относительную позицию пункта меню (отсчет позиции начинается с нуля). |
| MF_CHECKED | Устанавливает атрибут выделения пункта меню в состояние "отмечен". |
| MF _ UNCHECKED | Устанавливает атрибут выделения пункта меню в состояние "неотмечен". |
Флаг MF _ BYCOMMAND является флагом по умолчанию, если флаг MF _ BYCOMMAND или MF _ BYPOSITION не установлен.
Возвращаемые значения
Возвращаемое значение идентифицирует предыдущее состояние пункта меню ( либо MF_CHECKED, либо MF_UNCHECKED). Если пункт меню не существует, возвращается 0 xFFFFFFFF .
Комментарии
Пункт в строке меню не может иметь отметку.
Значение параметра uIDCheckItem идентифицирует пункт меню, который либо открывает подменю, либо является командным пунктом меню. Для пункта меню, который открывает подменю, значение параметра uIDCheckItem должно указывать положение пункта. Для командного пункта меню, значение uIDCheckItem может определять как положение, так и идентификатор пункта меню.
См. также
EnableMenuItem , GetMenuCheckMarkDimensions , GetMenuItemID , SetMenuItemBitmaps , SetMenuItemInfo .