函数功能:该函数将指定的位图与一个菜单项相联系。无论该菜单项是否被选取,系统都将适当的位图显示在菜单项旁边。
1 2 |
BOOL SetMenultemBitmaPs(HMENU hMenu,UINT uPosition,UINT uFlags, HBITMAP hBitmapUnchecked,HBITMAP hBitmspChecked); |
参数:
hMenu:其菜单项将接受新选取标记位图的菜单的句柄。
uPosition:指定将被修改的菜单项。其含义由参数uFlags决定。
UFlags:指定参数uPosition将如何解释。此参数必须是下列值之一:
MF_BYCOMMAND:表示参数uPosition给出菜单项的标识符。如果MF_BYCOMMAND和MF_POSITION都没被指定,则MF_BYCOMMAND是缺省标志。
MF_BYPOSITION:表示参数uPosition给出菜单项相对于零的位置。
hBitmapUnchecked:当菜单项没被选取时显示的位图的句柄。
hBitmapChecked:当菜单项被选取时显示的位图的句柄。
返回值:如果函数调用成功,返回非零值;如果函数调用失败,返回值是零。若想获得更多的错误信息,请调用GetLastError函数。
备注:如果参数hBitmapUnchecked或hBitmapChecked的值为NULL,系统将不为相应选取状态显示任何位图到菜单项旁边。如果两参数值均为NULL,系统在菜单项被选取时显示缺省的选取标志位图,菜单项未被选取时删除位图。当菜单项被销毁时,位图并没被销毁,需要应用程序来将其销毁。
已选取或未选取的位图应当是单色的。系统将用布尔AND运算符组合位图和菜单。这样,位图中白色部分变成透明的,而黑色部分成为菜单项的颜色。如果使用彩色位图,结果会不符合需要。以CXMENUCHECK和CYMENUCHECK来使用函数GetSystemMetrics将取得位图的尺寸。
速查:Windows NT:3.1及以上版本:Windows:95及以上版本;Windows CE:不支持;头文件:winuser.h;输入库:user32.lib。