getRegionData 函数 (wingdi.h)

GetRegionData 函数使用描述区域的数据填充指定的缓冲区。 此数据包括构成区域的矩形的尺寸。

语法

DWORD GetRegionData(
  [in]  HRGN      hrgn,
  [in]  DWORD     nCount,
  [out] LPRGNDATA lpRgnData
);

参数

[in] hrgn

区域的句柄。

[in] nCount

lpRgnData 缓冲区的大小(以字节为单位)。

[out] lpRgnData

指向接收信息的 RGNDATA 结构的指针。 该区域的维度以逻辑单元为单位。 如果此参数为 NULL,则返回值包含区域数据所需的字节数。

返回值

如果函数成功且 nCount 指定了足够数量的字节,则返回值等于实际使用的字节数 (小于或等于 nCount) 。

如果 lpRgnDataNULL,则返回值是所需的字节数。

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

如果失败是由于 hrgn 无效,则 GetLastError 将返回 ERROR_INVALID_HANDLE。 否则, GetLastError 返回 ERROR_INVALID_PARAMETER

如果 nCount 太小,则函数将失败。

注解

GetRegionData 函数与 ExtCreateRegion 函数一起使用。

要求

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

另请参阅

CreatePolyPolygonRgn

CreatePolygonRgn

CreateRectRgn

CreateRectRgnIndirect

CreateRoundRectRgn

ExtCreateRegion

RGNDATA

区域函数

区域概述