CreateIconIndirect 函数 (winuser.h)

  • 项目

从 ICONINFO 结构创建图标或光标。

语法

HICON CreateIconIndirect(
  [in] PICONINFO piconinfo
);

参数

[in] piconinfo

类型： PICONINFO

指向函数用于创建图标或游标的 ICONINFO 结构的指针。

返回值

类型： HICON

如果函数成功，则返回值是所创建的图标或游标的句柄。

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

注解

在创建图标或光标之前，系统会复制 ICONINFO 结构中的位图。 由于系统可能暂时选择设备上下文中的位图，因此不应将 ICONINFO 结构的 hbmMask 和 hbmColor 成员选入设备上下文。 应用程序必须继续管理原始位图，并在不再需要时将其删除。

使用完图标后，请使用 DestroyIcon 函数将其销毁。

示例

有关示例，请参阅 创建游标。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll
API 集 Windows 10版本 10.0.10240 中引入的 ext-ms-win-ntuser-gui-l1-3-0 ()

请参阅

概念性

DestroyIcon

ICONINFO

图标