SetMenuItemBitmaps函数将指定的位图与菜单项相关联。无论菜单项是选中还是取消选中,Windows将在菜单项旁边显示相应的位图。
BOOL SetMenuItemBitmaps(
HMENU 【HMENU】, | //菜单的句柄 |
UINT 【uPositionbs】, | //菜单项接收新的位图 |
UINT 【uFlags】, | //菜单项标志 |
HBITMAP 【hBitmapUnchecked】, | //处理未检查的位图 |
HBITMAP 【hBitmapChecked】 | //检查位图的句柄 |
); |
参数
【HMENU】
标识包含要接收新的复选标记位图的项目的菜单。
【uPositionbs】
指定要更改的菜单项,由【uFlags】参数确定。
【uFlags】
指定如何解释【uPositionbs】参数。【uFlags】参数必须是以下值之一:
值 | 含义 |
MF_BYCOMMAND | 表示【uPositionbs】给出菜单项的标识符。如果既不指定MF_BYCOMMAND也不指定MF_BYPOSITION,MF_BYCOMMAND是默认标志。 |
MF_BYPOSITION | 表示【uPositionbs】给出菜单项的基于零的相对位置。 |
【hBitmapUnchecked】
标识未选中菜单项时显示的位图。
【hBitmapChecked】
标识检查菜单项时显示的位图。
返回值
如果函数成功,返回值不为零。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
备注
如果【hBitmapUnchecked】或【hBitmapChecked】参数为NULL,Windows将在对应检查状态的菜单项旁边显示任何内容。如果两个参数均为NULL,Windows将在检查项目时显示默认的复选标记位图,并在不检查该项目时删除位图。
菜单被破坏时,这些位图不会被破坏;应用程序可以消除它们。
Windows NT: GetMenuCheckMarkDimensions功能检索用于菜单项的默认复选标记的尺寸。这些值用于确定此函数提供的位图的适当大小。
Windows 95: GetMenuCheckMarkDimensions已过时。使用GetsystemMetrics与CXMENUCHECK和CYMENUCHECK值来检索位图维度。
也可以看看