setCursor 函数 (winuser.h)

设置光标形状。

语法

HCURSOR SetCursor(
  [in, optional] HCURSOR hCursor
);

参数

[in, optional] hCursor

类型: HCURSOR

光标的句柄。

游标必须由 CreateCursorCreateIconIndirect 函数创建,或者由 LoadCursorLoadImage 函数加载。

如果此参数为 NULL,则光标将从屏幕中删除。

返回值

类型: HCURSOR

返回值是上一个游标的句柄(如果有)。

如果没有上一个游标,则返回值为 NULL

注解

仅当新游标与上一个游标不同时,才设置游标;否则,函数将立即返回。

游标是共享资源。 仅当光标位于其工作区或窗口捕获鼠标输入时,窗口才应设置光标形状。 在没有鼠标的系统中,窗口应在光标离开工作区之前或将控制权放弃到另一个窗口之前还原上一个光标。

如果应用程序必须在处于窗口中时设置游标,请确保指定窗口的类的类游标设置为 NULL。 如果类游标不为 NULL,则每次移动鼠标时,系统都会还原类游标。

如果内部游标显示计数小于零,则不会在屏幕上显示光标。 如果应用程序使用 ShowCursor 函数隐藏游标的次数多于显示游标的次数,则会出现这种情况。

示例

有关示例,请参阅 显示光标

要求

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

请参阅

概念性

光标

创建游标

CreateCursor

CreateIconIndirect

GetCursor

GetSystemMetrics

LoadCursor

LoadImage

引用

SetCursorPos

ShowCursor