LoadCursorA 函数（winuser.h）

项目
11/20/2024

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

注意

此函数已被 LoadImage 函数取代（设置了 LR_DEFAULTSIZE 和 LR_SHARED 标志）。

语法

HCURSOR LoadCursorA(
  [in, optional] HINSTANCE hInstance,
  [in]           LPCSTR    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 [仅限桌面应用]
目标平台	窗户
标头	winuser.h （包括 Windows.h）
库	User32.lib
DLL	User32.dll