SetBitmapDimensionEx 函数 (wingdi.h)

SetBitmapDimensionEx 函数将首选维度分配给位图。 应用程序可以使用这些维度:但是,系统不使用它们。

语法

BOOL SetBitmapDimensionEx(
  [in]  HBITMAP hbm,
  [in]  int     w,
  [in]  int     h,
  [out] LPSIZE  lpsz
);

参数

[in] hbm

位图的句柄。 位图不能是 DIB 节位图。

[in] w

位图的宽度(以 0.1 毫米为单位)。

[in] h

位图的高度(以 0.1 毫米为单位)。

[out] lpsz

指向 SIZE 结构的指针,用于接收位图的先前维度。 此指针可以为 NULL

返回值

如果该函数成功,则返回值为非零值。

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

注解

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

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

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 wingdi.h (包括 Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

另请参阅

位图函数

位图概述

CreateDIBSection

GetBitmapDimensionEx

SIZE