词条 | GetObject |
释义 | 函数简介函数功能:该函数得到指定图形对象的信息,根据图形对象,函数把填满的或结构,或表项(用于逻辑调色板)数目放入一个指定的缓冲区。 函数原型:int GetObject(HGDIOBJ hgdiobj, int cbBuffer, LPVOID lpvObject); 参数: hgdiobj:指向感兴趣的图形对象的句柄,它可以是这样的一个句柄:一个逻辑位图、一个刷子、一种字体、一个调色板、笔或通过调用CreateDIBsection函数创建的与设备无关位图。 cbBuffer:指定将要写到缓冲区的信息的字节数目。 lpvObject:指向一个缓冲区的指针,该缓冲区将要检索指定图形对象的信息。 下面列出的是缓冲区为每种图形对象类型可接收的信息和类型,可用hgdiobj来指定,写入*lpvObject: HBITMAP BITMAP。 HBITMAP:如果cbBuffer被设置为sizeof(DIBSECTION)或sizeof(BITMAP),则从对CreatDIBSection函数的DIBSECTION调用中返回。 HPALETTE:逻辑调色板入口数的WORD数目。 HPEN:从对ExtCreatePen函数的LXTLOGPEN调用中返回。 HPENLOGPEN; HBRUSH LOGBRUSH; HFONT LOGFONT 如果lpvObject参数为Null,则函数返回值为指定图形对象需要把信息贮存到缓冲区的字节数目。 返回值:如果函数调用成功,且lpvObject为一个有效指针,则返回值为贮存到缓冲区的字节数目;如果函数调用成功,且lprObject为Null,则返回值为需要容纳的贮存到缓冲区的信息字节数目;如果函数调用失败,则返回值为0。 Windows NT:若想获得更多错误信息,可调用GetLastError函数。 注释:lpvObject参数指向的缓冲区一定要足够大以接收图形对象的信息。 如果hgdiobj标识一个由调用CreateDIBSection创建的位图,且指定的缓冲区足够大,则GetObject函数返回一个DIBSECTION结构。另外,DIBSECTION中的BITMAP结构中的bmBits元素含有一个指向位图位值的指针。 如果hgdiobj标识了一个通过其他途径创建的位图,则GetObject只返回位图的宽、高和颜色格式信息,通过调用GetDIBits或GetBitmapBits函数可以得到位置的位值。 如果hgdiobj标识了一个逻辑调色板,则GetObject检索一个2字节的整数,该整数指定调色板中的项数,函数不检索定义调色板的LOGPALETTE结构,为检索有关调色板项的信息,应用程序可以调用GetPaletteEntries函数。 Windows CE:在Windows CE 1.0中,当用在DIB上中,GetObject总返回一个BITMAP。Windows CE 1.0不支持lpvObject参数的HPALETTE值。此函数在Windows CE 2.0与在Windows桌面上一样。 速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:1.0及以上版本;头文件:wingdi.h;库文件:gdi32.lib;Unicode:在Windows NT上实现为Unicode和ANSI两种版本。 程序示例下面是在应用程序中获取位图文件*.bmp的大小信息的核心代码: HBITMAP hBitmapImag; BITMAP bitmap ; int nWidth, nHeight; hBitmapImag = LoadBitmap (hInstance, TEXT ("D:\\\\photos\\\\Matthew.jpg")) ; GetObject (hBitmapImag, sizeof (BITMAP), &bitmap) ; nWidth = bitmap.bmWidth; nHeight = bitmap.bmHeight; /////////////// // your code /////////////// DeleteObject (hBitmapImag); |
随便看 |
百科全书收录4421916条中文百科知识,基本涵盖了大多数领域的百科知识,是一部内容开放、自由的电子版百科全书。