LoadBitmap函数从模块的可执行文件中加载指定的位图资源。
HBITMAP LoadBitmap(
HINSTANCE 【的hInstance】, | //应用程序实例的句柄 |
LPCTSTR 【lpBitmapName】 | //位图资源名称的地址 |
); |
参数
【的hInstance】
标识可执行文件包含要加载的位图的模块的实例。
【lpBitmapName】
指向一个以null结尾的字符串,其中包含要加载的位图资源的名称。或者,该参数可以由低位字中的资源标识符和高阶字中的零组成。MAKEINTRESOURCE宏可用于创建此值。
返回值
如果函数成功,则返回值是指定位图的句柄。
如果函数失败,返回值为NULL。
备注
如果【lpBitmapName】参数指向的位图不存在,或者内存不足,则加载位图,该函数将失败。
应用程序可以使用LoadBitmap函数访问Win32 API使用的预定义位图。为此,应用程序必须将【的hInstance】参数设置为NULL,将【lpBitmapName】参数设置为以下值之一:
OBM_BTNCORNERS | OBM_OLD_RESTORE |
OBM_BTSIZE | OBM_OLD_RGARROW |
OBM_CHECK | OBM_OLD_UPARROW |
OBM_CHECKBOXES | OBM_OLD_ZOOM |
OBM_CLOSE | OBM_REDUCE |
OBM_COMBO | OBM_REDUCED |
OBM_DNARROW | OBM_RESTORE |
OBM_DNARROWD | OBM_RESTORED |
OBM_DNARROWI | OBM_RGARROW |
OBM_LFARROW | OBM_RGARROWD |
OBM_LFARROWD | OBM_RGARROWI |
OBM_LFARROWI | OBM_SIZE |
OBM_MNARROW | OBM_UPARROW |
OBM_OLD_CLOSE | OBM_UPARROWD |
OBM_OLD_DNARROW | OBM_UPARROWI |
OBM_OLD_LFARROW | OBM_ZOOM |
OBM_OLD_REDUCE | OBM_ZOOMD |
以OBM_OLD开头的位图名称表示Windows 3.0以前版本的位图。
对于使用任何OBM_常量的应用程序,必须在包含WINDOWS.H头文件之前定义常量OEMRESOURCE。
应用程序必须调用DeleteObject函数来删除LoadBitmap函数返回的每个位图句柄。
也可以看看
CreateBitmap, DeleteObject, LoadCursor, LoadIcon, MAKEINTRESOURCE