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

Статья
02/01/2024

Рисует значок или курсор в указанный контекст устройства.

Чтобы указать дополнительные параметры рисования, используйте функцию DrawIconEx .

Синтаксис

BOOL DrawIcon(
  [in] HDC   hDC,
  [in] int   X,
  [in] int   Y,
  [in] HICON hIcon
);

Параметры

[in] hDC

Тип: HDC

Дескриптор контекста устройства, в который будет нарисован значок или курсор.

[in] X

Тип: int

Логическая координата X левого верхнего угла значка.

[in] Y

Тип: int

Логическая координата Y левого верхнего угла значка.

[in] hIcon

Тип: HICON

Дескриптор нарисованного значка.

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

Тип: BOOL

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

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

DrawIcon помещает левый верхний угол значка в расположение, указанное параметрами X и Y . Расположение зависит от текущего режима сопоставления контекста устройства.

DrawIcon рисует значок или курсор, используя ширину и высоту, заданные значениями системных метрик для значков; Дополнительные сведения см. в разделе GetSystemMetrics.

Функция DrawIcon вызывает DrawIconEx , передавая в DI_NORMAL|DI_DEFAULTSIZE качестве флагов.

Примеры

Пример см. в разделе Отображение значка.

Требования


Минимальная версия клиента	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-1 (представлен в Windows 10 версии 10.0.14393)