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) 。
如果 lpRgnData 为 NULL,则返回值是所需的字节数。
如果函数失败,则返回值为零。
如果失败是由于 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 |