描述
GetRandomRgn功能将指定设备上下文的系统裁剪区域复制到特定区域。
C++ 语法
int GetRandomRgn( __in HDC hdc, __in HRGN hrgn, __in INT iNum ); |
PowerBASIC 语法
FUNCTION GetRandomRgn ( _ BYVAL hdc AS DWORD, _ BYVAL hrgn AS DWORD, _ BYVAL iNum AS LONG _ ) AS LONG |
参数
hdc
[in]处理设备上下文。
hrgn
[in]处理某个地区。在调用函数之前，这将标识一个现有的区域。函数返回后，将标识当前系统区域的副本。由hrgn识别的旧区域被覆盖。
iNum
[in]此参数必须为SYSRGN。
返回值
如果函数成功，返回值为1。如果函数失败，返回值为-1。如果要检索的区域为NULL，返回值为0。如果函数失败或要检索的区域为NULL，则不会初始化hrgn。
备注
使用SYSRGN标志时，请注意，由于窗口移动，系统裁剪区域可能不是最新的。尽管如此，在WM_PAINT处理期间，可以在BeginPaint - EndPaint块内检索和使用系统裁剪区域是安全的。在这种情况下，系统区域是窗口的更新区域和当前可见区域的交点。返回GetRandomRgn之前和EndPaint之前的任何窗口移动将导致新的WM_PAINT消息。SYSRGN标志的任何其他使用可能会导致应用程序中的绘制错误。
Windows NT / 2000 / XP / Vista / Windows 7：返回的区域是屏幕坐标。
Windows 95/98 / Me：返回的区域是窗口坐标。
引用文件 #INCLUDE Once
WinGdi.inc（包括Windows.inc）