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

Функция SetMenuItemBitmaps связывает определяемый точечный рисунок (значок) с пунктом меню. В любом случае пункт меню является или с установленной или со снятой отметкой "галочкой", Windows показывает на экране соответствующий значок рядом с пунктом меню.

Синтаксис

BOOL SetMenuItemBitmaps
(
	HMENU hMenu,			// дескриптор меню
	UINT uPosition,			// пункт меню, который принимает значки
	UINT uFlags,			// флажки пункта меню
	HBITMAP hBitmapUnchecked,		// дескриптор значка снятия метки
	HBITMAP hBitmapChecked		// дескриптор значка установки метки
);

Параметры
hMenu
Идентифицирует меню, содержащее пункт, который принимает новые значки меток.
uPosition
Определяет пункт меню, который будет изменен, как обусловлено параметром uFlags.
uFlags
Определяет, как интерпретируется параметр uPosition. Параметр uFlags должен быть одним из следующих значений:

• MF_BYCOMMAND - Указывает, что uPosition дает идентификатор пункта меню. Если ни флажок MF_BYCOMMAND ни флажок MF_BYPOSITION не установлен, MF_BYCOMMAND - флажок заданный по умолчанию.
• MF_BYPOSITION - Указывает, что uPosition дает отсчитываемую от нуля относительную позицию пункта меню.

hBitmapUnchecked
Идентифицирует отображаемый точечный рисунок (значок), когда пункт меню не отмечен "галочкой".
hBitmapChecked
Идентифицирует отображаемый точечный рисунок (значок), когда пункт меню отмечен "галочкой".

Возвращаемые значения
Если функция завершается успешно, величина возвращаемого значения - не ноль.
Если функция не выполняет задачу, величина возвращаемого значения - ноль. Чтобы получать расширенные данные об ошибках, вызовите GetLastError.

Замечания
Если или параметр hBitmapUnchecked, или параметр hBitmapChecked имеют значение ПУСТО (NULL), Windows на экране ничего не показывает рядом с пунктом меню для обозначения соответствующего состояния метки. Если оба параметра имеют значение ПУСТО (NULL), Windows по умолчанию показывает на экране заданный значок галочки, когда пункт отмечен "галочкой" и удаляет метку, когда пункт не отмечен "галочкой".
Когда меню разрушается, эти значки не разрушаются; это является заботой приложения, чтобы уничтожить их.
Windows NT: функция GetMenuCheckMarkDimensions извлекает размеры заданной по умолчанию галочки, использованной для пунктов меню. Эти значения используются, чтобы установить соответствующий размер для точечных рисунков, предоставленных этой функцией.
Windows 95: Функция GetMenuCheckMarkDimensions устаревшая. Используйте GetSystemMetrics со значениями CXMENUCHECK и CYMENUCHECK, чтобы извлечь размеры значка.

Смотри также
GetMenu, GetMenuCheckMarkDimensions

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

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