CreateCompatibleBitmap - [Daliy APIs]

CreateCompatibleBitmap

 

该函数创建与指定的设备环境相关的设备兼容的位图。

原型

HBITMAP CreateCompatibleBitmap(HDC hdc,  int nWidth,  int nHeight);

参数

hdc: 设备环境句柄。

nWidth, nHeight:指定位图的宽度和高度,单位为像素。

返回值

   如果函数执行成功,那么返回值是位图的句柄;如果函数执行失败,那么返回值为NULL。若想获取更多错误信息,请调用GetLastError。

备注

   由CreateCompatibleBitmap函数创建的位图的颜色格式与由参数hdc标识的设备的颜色格式匹配。该位图可以选入任意一个与原设备兼容的内存设备环境中。

   由于内存设备环境允许彩色和单色两种位图。因此当指定的设备环境是内存设备环境时,由CreateCompatibleBitmap函数返回的位图格式不一定相同。然而为非内存设备环境创建的兼容位图通常拥有相同的颜色格式,并且使用与指定的设备环境一样的色彩调色板。

   如果程序设置 nWidth 或 nHeight 为 0,CreateCompatibleBitmap 返回 1*1像素,单色位图(a 1- by 1-pixel, monochrome bitmap)的句柄。

   如果一个DIB,即由CreateDIBSection创建的位图,被选入由hdc标识的设备环境,CreateCompatibleBitmap 创建一个DIB对象。

   当不使用位图后,调用DeleteObject 删除对象。

下面是MSDN上的例子:

HDC hDC,                // Handle to the display device context
    hDCMem;             // Handle to the memory device context
HBITMAP hBitmap;        // Handle to the new bitmap
int iWidth, iHeight;    // Width and height of the bitmap

// Retrieve the handle to a display device context for the client
// area of the window.
hDC = GetDC (hwnd);

// Create a memory device context compatible with the device.
hDCMem = CreateCompatibleDC (hDC);

// Retrieve the width and height of window display elements.
iWidth  = GetSystemMetrics (SM_CXSCREEN) / 10;
iHeight = GetSystemMetrics (SM_CYSCREEN) / 10;

// Create a bitmap compatible with the device associated with the
// device context.
hBitmap = CreateCompatibleBitmap (hDC, iWidth, iHeight);

// Insert code to use the bitmap.

// Delete the bitmap object and free all resources associated with it.
DeleteObject (hBitmap);

// Delete the memory device context and the display device context.
DeleteDC (hDCMem);
DeleteDC (hDC); 


参考

百度百科:CreateCompatibleBitmap

MSDN: CreateCompatibleBitmap 

 


 

posted on 2010-01-20 09:58 李森 - listen 阅读(...) 评论(...) 编辑 收藏

公告

导航