Функция DrawIconEx

Функция DrawIconEx рисует значок или курсор в контекст указанного устройства, выполняя указанные растровые операции, и растягивая или сжимая значок или курсор как задано.

Синтаксис

Параметры

hdc

[in] Дескриптор контекста устройства, в котором значок или курсор должны рисоваться.

xLeft

[in] Определяет логическую координату x левого верхнего угла значка или курсора.

yTop

[in] Определяет логическую координату y левого верхнего угла значка или курсора.

hIcon

[in] Дескриптор рисуемого значка или курсора. Этот параметр может идентифицировать анимированный курсор.

cxWidth

[in] Определяет логическую ширину значка или курсора. Если этот параметр - нуль, а параметр diFlags - DI_DEFAULTSIZE, чтобы установить ширину, функция использует системное метрическое значение SM_CXICON или SM_CXCURSOR. Если этот параметр - нуль, а DI_DEFAULTSIZE не используется, функция использует фактическую ширину ресурса.

cyWidth

[in] Определяет логическую высоту значка или курсора. Если этот параметр - нуль, а параметр diFlags - DI_DEFAULTSIZE, чтобы установить ширину, функция использует системное метрическое значение SM_CYICON или SM_CYCURSOR,. Если этот параметр - нуль, а DI_DEFAULTSIZE не используется, функция использует фактическую высоту ресурса.

istepIfAniCur

[in] Определяет индекс рамки для рисования, если hIcon идентифицирует анимированный курсор. Этот параметр игнорируется, если hIcon не идентифицирует анимированный курсор.

hbrFlickerFreeDraw

[in] Дескриптор кисти, которую система использует для немерцающего рисунка. Если hbrFlickerFreeDraw - допустимый дескриптор кисти, система создает закадровый точечный рисунок, используя указанную кисть для цвета фона, рисует значок или курсор в точечный рисунок, а затем копирует точечный рисунок в контекст устройства, идентифицированный hdc. Если hbrFlickerFreeDraw - НУЛЬ (NULL), система рисует значок или курсор непосредственно в контекст устройства.

diFlags

[in] Определяет флажки рисования. Этот параметр может быть одним из ниже перечисленных значений :

Флажок	Действие
DI_COMPAT	Рисует значок или курсор, используя системное изображение по умолчанию, а не изображение определенное пользователем. Дополнительную информацию смотри в статье О курсорах. Windows NT4.0 и позже: Этот флажок игнорируется.
DI_DEFAULTSIZE	Рисует значок или курсор, используя ширину и высоту, определенную системными метрическими значениями для курсоров или значков, если параметры cxWidth и cyWidth установлены в нуль. Если этот флажок не определяется, а cxWidth и cyWidth установлены в нуль, функция использует фактический размер ресурса.
DI_IMAGE	Рисует значок или курсор, используя изображение.
DI_MASK	Рисует значок или курсор, используя маску.
DI_NOMIRROR	Windows XP: Значок рисуется как незеркальный значок. По умолчанию, он рисуется как зеркальный значок, если параметр hdc зеркалируется.
DI_NORMAL	Комбинация DI_IMAGE и DI_MASK.

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

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

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

Замечания

Функция DrawIconEx помещает левый верхний угол значка в место, определенное параметрами xLeft и yTop. Местоположение зависит от текущего режима отображения контекста устройства.

Чтобы продублировать функцию DrawIcon (hDC, X, Y, hIcon), DrawIconEx вызывается следующим образом:

DrawIconEx (hDC, X, Y, hIcon, 0, 0, 0, NULL, DI_NORMAL | DI_COMPAT | DI_DEFAULTSIZE);

Обзор Значки, Функции, используемые значками, CopyImage, DrawIcon, LoadImage