loadCursorW 函数 (winuser.h)

从与应用程序实例关联的可执行 (.exe) 文件加载指定的游标资源。

注意

此函数已被 LoadImage 函数 (取代,) 设置了 LR_DEFAULTSIZELR_SHARED 标志。

语法

HCURSOR LoadCursorW(
  [in, optional] HINSTANCE hInstance,
  [in]           LPCWSTR   lpCursorName
);

参数

[in, optional] hInstance

类型: HINSTANCE

DLL 或包含要加载的游标的可执行 (.exe) 文件的模块句柄。 有关详细信息,请参阅 GetModuleHandle

若要加载预定义的系统游标,请将此参数设置为 NULL

[in] lpCursorName

类型: LPCTSTR

如果 hInstance 为非 NULL则 lpCursorName 按名称或序号指定游标资源。 必须使用 MAKEINTRESOURCE 宏打包此序号。

如果 hInstanceNULL则 lpCursorName 将指定以要加载的预定义系统游标 IDC_前缀 开头的标识符。

返回值

类型: HCURSOR

如果函数成功,则返回值是新加载的游标的句柄。

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

注解

仅当游标资源尚未加载时, LoadCursor 函数才会加载游标资源;否则,它将检索现有资源的句柄。 仅当 lpCursorName 参数是指向游标资源的指针时,此函数才返回有效的游标句柄。 如果 lpCursorName 是指向除游标 ((如图标) )以外的任何类型的资源的指针,则返回值不是 NULL,即使它不是有效的游标句柄。

LoadCursor 函数搜索最适合当前显示设备的游标资源。 光标资源可以是颜色或单色位图。

DPI 虚拟化

此 API 不参与 DPI 虚拟化。 返回的输出不受调用线程的 DPI 影响。

示例

有关示例,请参阅 创建游标

注意

winuser.h 标头将 LoadCursor 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定

要求

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

请参阅

概念性

光标

LoadImage

MAKEINTRESOURCE

IS_INTRESOURCE

引用

SetCursor

SetCursorPos

ShowCursor