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