平台 SDK: Windows GDI

SetBitmapDimensionEx

SetBitmapDimensionEx函数将优选的维度分配给位图。 这些尺寸可以由应用程序使用; 然而,它们不被系统使用。

BOOL SetBitmapDimensionEx(
  HBITMAP hBitmap,  // 位图句柄
  int nWidth,       // 位图宽度以.01-mm为单位  
  int nHeight,      // 位图高度以.01-mm为单位
  LPSIZE lpSize     // 原始尺寸
);

参数

  • hBitmap

  • [in] 位图句柄。 位图不能是DIB部分位图。

  • nWidth

  • [in] 指定位图的宽度(以0.1毫米为单位)。

  • nHeight

  • [in] 指定位图的高度(以0.1毫米为单位)。

  • lpSize

  • [out] 指向SIZE结构以接收位图的先前维度。 该指针可以为NULL。

返回值

如果函数成功,返回值不为零。

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

Windows NT/2000/XP: 要获取扩展错误信息,请调用GetLastError

备注


应用程序可以通过调用GetBitmapDimensionEx函数通过SetBitmapDimensionEx函数检索分配给位图的维度。

由hBitmap标识的位图不能是DIB部分,它是由CreateDIBSection函数创建的位图。 如果位图是DIB部分,则SetBitmapDimensionEx函数将失败。

要求

   Windows NT/2000/XP:包含在Windows NT 3.1及更高版本中。

   Windows 95/98/Me:包含在Windows 95及更高版本中。

   头文件:声明于Wingdi.h; 包含于Windows.h。

   库:使用Gdi32.lib。