LoadBitmap

LoadBitmap

 

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