loadCursorA 函数 (winuser.h)

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

注意 此函数已被 LoadImage 函数取代。
 

语法

HCURSOR LoadCursorA(
  [in, optional] HINSTANCE hInstance,
  [in]           LPCSTR    lpCursorName
);

参数

[in, optional] hInstance

类型: HINSTANCE

模块实例的句柄,该模块的可执行文件包含要加载的游标。

[in] lpCursorName

类型: LPCTSTR

要加载的游标资源的名称。 或者,此参数可以由低序单词中的资源标识符和高阶单词中的零组成。 MAKEINTRESOURCE 宏还可用于创建此值。 若要使用某个预定义游标,应用程序必须将 hInstance 参数设置为 NULL ,并将 lpCursorName 参数设置为以下值之一。

Value 含义
IDC_APPSTARTING
MAKEINTRESOURCE (32650)
标准箭头和小型小时镜
IDC_ARROW
MAKEINTRESOURCE (32512)
标准箭头
IDC_CROSS
MAKEINTRESOURCE (32515)
十字线
IDC_HAND
MAKEINTRESOURCE (32649)
Hand
IDC_HELP
MAKEINTRESOURCE (32651)
箭头和问号
IDC_IBEAM
MAKEINTRESOURCE (32513)
I-beam
IDC_ICON
MAKEINTRESOURCE (32641)
标记为版本 4.0 或更高版本的应用程序已过时。
IDC_NO
MAKEINTRESOURCE (32648)
斜杠圆
IDC_SIZE
MAKEINTRESOURCE (32640)
标记为版本 4.0 或更高版本的应用程序已过时。 使用 IDC_SIZEALL
IDC_SIZEALL
MAKEINTRESOURCE (32646)
指向北部、南部、东部和西部的四尖箭头
IDC_SIZENESW
MAKEINTRESOURCE (32643)
指向东北和西南的双尖箭头
IDC_SIZENS
MAKEINTRESOURCE (32645)
指向南北的双尖箭头
IDC_SIZENWSE
MAKEINTRESOURCE (32642)
指向西北和东南部的双尖箭头
IDC_SIZEWE
MAKEINTRESOURCE (32644)
指向西部和东部的双尖箭头
IDC_UPARROW
MAKEINTRESOURCE (32516)
垂直箭头
IDC_WAIT
MAKEINTRESOURCE (32514)
沙 漏

返回值

类型: 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

参考

SetCursor

SetCursorPos

ShowCursor