Функция CreateIconIndirect (winuser.h)

Статья
03/09/2024

Создает значок или курсор из структуры ICONINFO .

Синтаксис

HICON CreateIconIndirect(
  [in] PICONINFO piconinfo
);

Параметры

[in] piconinfo

Тип: PICONINFO

Указатель на структуру ICONINFO , используемую функцией для создания значка или курсора.

Возвращаемое значение

Тип: HICON

Если функция выполняется успешно, возвращаемое значение представляет собой дескриптор созданного значка или курсора.

Если функция завершается сбоем, возвращается значение NULL. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Система копирует растровые изображения в структуре ICONINFO перед созданием значка или курсора. Так как система может временно выбирать растровые изображения в контексте устройства, элементы hbmMask и hbmColor структуры ICONINFO не должны быть выбраны в контексте устройства. Приложение должно продолжать управлять исходными растровыми изображениями и удалять их, когда они больше не нужны.

Завершив использование значка, удалите его с помощью функции DestroyIcon .

Примеры

Пример см. в разделе Создание курсора.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-gui-l1-3-0 (представлен в Windows 10 версии 10.0.10240)