LoadImage()的使用

时间:2023-03-08 15:51:06

系统中的定义是:

WINUSERAPI
HANDLE
WINAPI
LoadImageA(
    HINSTANCE,
    LPCSTR,
    UINT,
    int,
    int,
    UINT);
WINUSERAPI
HANDLE
WINAPI
LoadImageW(
    HINSTANCE,
    LPCWSTR,
    UINT,
    int,
    int,
    UINT);
#ifdef UNICODE
#define LoadImage  LoadImageW
#else
#define LoadImage  LoadImageA
#endif // !UNICODE

參数分别表示:

HINSTANCE---------包括所须要图片的实例的句柄。
    LPCSTR--------------图片所在路径及文件名称。
    UINT-------------------图片类型。
    int-----------------------图片宽度。
    int-----------------------图片高度。
    UINT-------------------load flags(备注:到如今还没有搞懂)

样例:

HBITMAP hbitmap;
hbitmap=(HBITMAP)LoadImage(AfxGetInstanceHandle(),"图片/aa.bmp",IMAGE_BITMAP, 0, 0, LR_LOADFROMFILE|LR_CREATEDIBSECTION);

应用别人的文章,文章是介绍该API函数在VB中的使用,VC中也能够借鉴:

【函数】
 LoadImage

【操作系统】
 Win9x:Y
 WinNT:Y

【声明】
 Function ulong LoadImage(ulong hInst,ref string lpsz,ulong un1,ulong n1,ulong n2,ulong un2) LIBRARY "user32.dll" ALIAS FOR "LoadImageA"

【说明】
 
  加载一个位图、图标或指针
    函数功能:该函数装载目标,光标,或位图。

函数原型:HANDLE LoadImage(NINSTANCE hinst,LPCTSTR lpszName,UINT uType,int cxDesired,int CyDesired,UINT fuLoad);

參数:

hinst:处理包括被装载图像模块的特例。若要装载OEM图像,则设此參数值为O。

lpszName:处理图像装载。假设參数hinst为非空,并且參数fuLoad不包含LR_LOADFROMFILE的值时,那么參数lpszName是一个指向保留在hinst模块中装载的图像资源名称,并以NULL为结束符的字符串。

假设參数hinst为空,而且LR_LOADFROMFILE被指定,那么这个參数低位字一定是被装载的OEM图像标识的。OEM图像标识符是在WINUSER.H头文件里定义的,以下列举出前缀的含义:

OBM_ OEM:位图;OIC_OEM图标;OCR_OEM:光标。

假设參数fuLoad包括LR_LOADFROMFILE值,那么參数lpszName是包括有图像的文件名称。

uType:指定被装载图像类型。此參数能够为下列值,其含义例如以下:

IMAGE_BITMAP:装载位图;IMAGE_CURSOR:装载光标;IMAGE_ICON:装载图标。

cxDesired:指定图标或光标的宽度,以像素为单位。假设此參数为零而且參数fuLoad值为LR_DEFAULTSIZE,那么函数使用SM_CXICON或SM_CXCURSOR系统公制值设定宽度;假设此參数为零而且值LR_DEFAULTSIZE没有被使用,那么函数使用眼下的资源宽度。

cyDesired:指定图标或光标的高度,以像素为单位。假设此參数为零而且參数fuLoad值为LR_DEFAULTSIZE,那么函数使用SM_CXICON或SM_CXCURSOR系统公制值设定高度;假设此參数为零而且值LR_DEFAULTSIZE没有被使用,那么函数使用眼下的资源高度。

fuLoad:依据以下复合值列表指定函数值,值含义例如以下:

LR_DEFAULTCOLOR:缺省标志;它不作不论什么事情。它的含义是“无LR_MONOCHROME”。

LR_CREATEDIBSECTION:当參数uType指定为IMAGE_BITMAP时,使得函数返回一个DIB部分位图,而不是一个兼容的位图。这个标志在装载一个位图,而不是映射它的颜色到显示设备时很实用。

LRDIFAULTSIZE:若 cxDesired或cyDesired未被设为零,使用系统指定的公制值标识光标或图标的宽和高。假设这个參数不被设置且cxDesired或cyDesired被设为零,函数使用实际资源尺寸。假设资源包括多个图像,则使用第一个图像的大小。

LR_LOADFROMFILE:根据參数lpszName的值装载图像。若标记未被给定,lpszName的值为资源名称。

LW_LOADMAP3DCOLORS:查找图像的颜色表而且按以下对应的3D颜色表的灰度进行替换。

颜色替代:Dk Gray RGB(128,128,128)COLOR_3DSHADOW;Gray RGB(192,192,192)COLOR_3DFACELt Gray RGB(223,223,223) COLOR_3DLIGHT LR_LOADTRANSPARENT;找到图像中的一个像素颜色值而且依据颜色表中系统的缺省颜色值替代其对应接口的值。图像中全部使用这样的接口的像素的颜色都变为系统的缺省窗口颜色。此至仅用来申请对应的颜色表。

若fuLoad包含LR_LOADTRANSPARENT和LR_LOADMAP3DCOLORS两个值,则LRLOADTRANSPARENT优先。可是,颜色表接口由COLOR_3DFACE替代,而不是COLOR_WINDOW。

LR_MONOCHROME:装载黑白图。

LR_SHARED:若图像将被多次装载则共享。假设LR_SHARED未被设置,则再向同一个资源第二次调用这个图像是就会再装载以便这个图像且返回不同的句柄。

不要对不同标准尺寸的图像使用LR_SHARED,装载后可能会有改变,或是从文件里被装载。

Windows 95和Windows 98:函数依据缓存中被请求的资源名发现的第一个图像,无论被请求的大小。LR_VGACOLOR:使用VGA真彩色。

返回值:假设函数执行成功,返回值是相关资源的数据的句柄。假设函数执行失败,返回值为NULL。若想获得很多其它的错误信息,请调用GetLastError函数。

注意:当使用完资源后,必须通过调用函数以释放加速器表、位图、光标、图标以及菜单所占的内存资源;加速器表:DesteoyAcceleratorTable;位图:DeleteObject;光标:DestroyCursor;图标:Destroylcon;菜单:DestroyMenu

当过程创建终止时,系统将自己主动删除这些资源。可是调用相关函数也能够保留内存降低过程的工作设置所占空间。

Windows CE:对IMAGE_BITMAP来说,參数cxDesred和cyDesred p必须为零。Windows CE不支持图表跳跃或闪烁。

參数fuLoad必须为(=LR_DEFAULTCOLOR)。

假设的目标平台不支持鼠标光标,能够指定在參数cxDesred和cyDsired的SM_CXCURSOR和SM_CYCURSOR的值,但不能指定參数uType中IMAGE_CURSOR的值。

假设目标平台支持鼠标光标,能够指定在參数cxDesired和cyDesred的SM_CXCURSOR和SM_CYCURSOR的值,也能指定參数uType中IMAGE_CURSOR的值。

速查:Windows NT 3.1、Windows 95、Windows CE 1.0以上,头文件:minuser.h:库文件;user32.lib;Unicode:在Windows NT上实现为Unicode和ANSI两种版本号。

【返回值】

Long,运行成功则返回对象的一个句柄;零表示失败

【其他】

【參数列表】
  hInst ----------  Long,要从当中加载图象的DLL或应用程序模块或实例句柄。零表示装载一幅固有图象

lpsz -----------  String,欲加载图象的名字。如指定了hInst,就用这个參数指定资源或资源的标志符(标志符是一个长整数)。如hInst为空,并且已指定了LR_LOADFROMFILE,那么这个參数代表文件名称(位图、图标或指针文件)。假设是个Long型值,这个參数就代表固有位图、图标或指针的编号

un1 ------------  Long,下述常数之中的一个,指定了欲加载的图象类型:IMAGE_BITMAP,
  IMAGE_CURSOR, IMAGE_ICON

n1,n2 ----------  Long,要求的图象宽度和高度。图象会依据情况自己主动伸缩。如设为零,表示用图象的默认大小

un2 ------------  Long,下述常数的随意组合,它们都在api32.txt文件里得到了定义:
  LR_DEFAULTCOLOR
  以常规方式加载图象
  LR_LOADREALSIZE
  不正确图象进行缩放处理。忽略n1和n2的设置
  LR_CREATEDIBSECTION
  假设指定了IMAGE_BITMAP,就返回DIBSection的句柄,而不是位图的句柄
  LR_DEFAULTSIZE
  假设n1和n2为零,就使用由系统定义的图象默认大小,而不是图象本身定义的大小
  LR_LOADFROMFILE
  如hInst为零,lpsz就代表要加载适当类型的一个文件的名字,仅适用于Win95
  LR_LOADMAP3DCOLORS
  将图象中的深灰、灰、以及浅灰像素都替换成COLOR_3DSHADOW,COLOR_3DFACE以及COLOR_3DLIGHT的当前设置
  LR_LOADTRANSPARENT
  与图象中第一个像素相符的全部像素都由系统替换
  LR_MONOCHROME
  将图象转换成单色
  LR_SHARED
  将图象作为一个共享资源加载。在NT 4.0中装载固有资源时要用到这个设置