clipCursor 函数 (winuser.h)

将光标限制在屏幕上的矩形区域。 如果后续光标位置 (SetCursorPos 函数设置,或者鼠标) 位于矩形外部,则系统会自动调整该位置,使光标保持在矩形区域内。

语法

BOOL ClipCursor(
  [in, optional] const RECT *lpRect
);

参数

[in, optional] lpRect

类型: const RECT*

指向 结构的指针,该结构包含限制矩形的左上角和右下角的屏幕坐标。 如果此参数为 NULL,则光标可以自由地在屏幕上的任何位置移动。

返回值

类型: BOOL

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

如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。

注解

游标是共享资源。 如果应用程序限制游标,则必须使用 ClipCursor 释放游标,然后才能将控制权让给另一个应用程序。

调用进程必须具有对窗口工作站 WINSTA_WRITEATTRIBUTES 访问权限。

示例

有关示例,请参阅 限制游标

要求

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

请参阅

概念性

光标

GetClipCursor

GetCursorPos

其他资源

矩形

引用

SetCursorPos