LoadBitmap
位图资源的函数
LoadBitmap是从模块的可执行文件中加载指定的位图资源的函数。
函数简介
函数功能:该函数从模块的可执行文件中加载指定的位图资源。该函数已经被函数LoadImage替代。
函数原型:HBITMAP LoadBitmap(HINSTANCE hInstance, LPCTSTR lpBitmapName);
参数
hlnstance:指向模块实例的句柄。该模块的可执行文件包含了要加载的位图。
lpBitmapName:指向字符串(以NULL结束)批指针。该字符串包含了要加载的位图资源名称。另外一种方式就是该参数可以由低位字是资源标识符、高位字为0位形式组成。可以使用宏MAKEINTRESOURCE来创建这个参数值。
返回值:如果函数执行成功,则返回值是指向指定位图的句柄。如果函数执行失败,那么返回值是NULL。
Windows NT:若想获取更多错误信息,请调用GetLastError
备注:如果由参数lpBitmapName指向的位图不存在,或者没有足够的内存来加载该位图,则函数失败。应用程序可以使用函数LoadBitmap来访问Win32 API使用的,预定义的位图。若要这么做,应用程序必须将hlnstance参数设为NULL,并且lpBitmapName参数应取下列值:
OBM_BTNCORNERS OBM_OLD_RESTORE; OBM_BTSIZE OBM_OLD_RGARROW;
OBM_CHECK OBM_OLD_UPARROW; OBM_OLD_RESTORE; OBM_OLD_ZOOM;
OBM_CLOSE OBM_REDUCE; OBM_COMBO OBM_REDUCED; OBM_DNARROW
OBM_RESTORE; OBM_LFARROWD OBM_RGARROW1; OBM_LFARROW1
OBM_SIZE; OBM_MNARROW OBM_UPARROW; OBM_OLD_CLOSE OBM_UPARROWD;
OBM_OLD_DNARROW OBM_PARROW1; OBM_OLD_LFARROW OBM_ZOOM;
OBM_OLD_REDUCE OBM_ZOOMD
以OBM_OLD开头的位图名表示是比3.0 更早的16位版Windows系统使用的位图。
对于使用任何OBM_常量的应用程序而言,在加入WINDOWS.H头文件之前必须定义常量OEMRESOURCE。
应用程序必须调用DeleteObject函数来删除LoadBitmap函数返回的每一个位图句柄。
对于Windows CE:当使用LoadBitmap函数时位图进行初始化时,该位图是只读的。当把位图选入到设备环境中时,无法更改设备环境(例如,加入文字),因为这样需要往位图写入的权利。
Windows CE不支持参数lpBitmapName中的OBM_*(以OBM_开始的所有值)。
Windows CE 1.0只支持2位灰阶的调色板,所以只可以使用1位来表示每个像素(单色。BMP)或2位来表示每个像素(2bp)的位图。
参考资料
最新修订时间:2021-11-22 19:50
目录
概述
函数简介
参数
参考资料