函数功能：该函数从模块的可执行文件中加载指定的位图资源。该函数已经被函数LoadImage替代。
|
1 |
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）的位图。