LoadBitmap

【勇芳软件工作室】汉化HomePreviousNext

LoadBitmap函数从模块的可执行文件中加载指定的位图资源。

HBITMAP LoadBitmap(

HINSTANCE 【的hInstance】,//应用程序实例的句柄
LPCTSTR 【lpBitmapName】//位图资源名称的地址
); 

参数

【的hInstance】

标识可执行文件包含要加载的位图的模块的实例。

【lpBitmapName】

指向一个以null结尾的字符串,其中包含要加载的位图资源的名称。或者,该参数可以由低位字中的资源标识符和高阶字中的零组成。MAKEINTRESOURCE宏可用于创建此值。

返回值

如果函数成功,则返回值是指定位图的句柄。

如果函数失败,返回值为NULL。

备注

如果【lpBitmapName】参数指向的位图不存在,或者内存不足,则加载位图,该函数将失败。

应用程序可以使用LoadBitmap函数访问Win32 API使用的预定义位图。为此,应用程序必须将【的hInstance】参数设置为NULL,将【lpBitmapName】参数设置为以下值之一:

OBM_BTNCORNERSOBM_OLD_RESTORE
OBM_BTSIZEOBM_OLD_RGARROW
OBM_CHECKOBM_OLD_UPARROW
OBM_CHECKBOXESOBM_OLD_ZOOM
OBM_CLOSEOBM_REDUCE
OBM_COMBOOBM_REDUCED
OBM_DNARROWOBM_RESTORE
OBM_DNARROWDOBM_RESTORED
OBM_DNARROWIOBM_RGARROW
OBM_LFARROWOBM_RGARROWD
OBM_LFARROWDOBM_RGARROWI
OBM_LFARROWIOBM_SIZE
OBM_MNARROWOBM_UPARROW
OBM_OLD_CLOSEOBM_UPARROWD
OBM_OLD_DNARROWOBM_UPARROWI
OBM_OLD_LFARROWOBM_ZOOM
OBM_OLD_REDUCEOBM_ZOOMD

以OBM_OLD开头的位图名称表示Windows 3.0以前版本的位图。

对于使用任何OBM_常量的应用程序,必须在包含WINDOWS.H头文件之前定义常量OEMRESOURCE。

应用程序必须调用DeleteObject函数来删除LoadBitmap函数返回的每个位图句柄。

也可以看看

CreateBitmap, DeleteObject, LoadCursor, LoadIcon, MAKEINTRESOURCE