Win32 API. Пиктограммы
Страница 19. Функция DrawIconEx


Функция DrawIconEx

(РисуемПиктограммуРасширенная)

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

Синтаксис

BOOL DrawIconEx
(
HDC hdc,// дескриптор контекста устройства
int xLeft,// x-координата верхнего левого угла
int yTop,// y-координата верхнего левого угла
HICON hIcon,// дескриптор пиктограммы, которую надо рисовать
int cxWidth,// ширина пиктограммы
int cyWidth,// высота пиктограммы
UINT istepIfAniCur,// индекс фрейма в живом указателе
HBRUSH hbrFlickerFreeDraw,// дескриптор кисти фона
UINT diFlags// флажки рисуемой пиктограммы
);

Параметры
hdc
Идентифицирует контекст устройства для окна.
xLeft
Определяет логическую x-координату левого верхнего угла пиктограммы или курсора.
yTop
Определяет логическую y-координату левого верхнего угла пиктограммы или курсора. hIcon
Идентифицирует пиктограмму или курсор, который будет нарисован. Этот параметр может идентифицировать живой указатель. Ресурс пиктограммы или курсора, должны быть предварительно загружены при помощи использования функции LoadImage.
cxWidth
Определяет логическую ширину пиктограммы или курсора. Если этот параметр нулевой, а параметр diFlags - DI_DEFAULTSIZE, функция, чтобы установить ширину, использует метрическое значение SM_CXICON или SM_CXCURSOR системы. Если этот параметр нулевой, а DI_DEFAULTSIZE не использован, функция использует фактическую ширину ресурса.
cyWidth
Определяет логическую высоту пиктограммы или курсора. Если этот параметр нулевой, а diFlags параметр - DI_DEFAULTSIZE, функция, чтобы установить высоту, использует метрическое значение SM_CYICON или SM_CYCURSOR системы. Если этот параметр нулевой, а DI_DEFAULTSIZE не использован, функция использует фактическую высоту из ресурса.
istepIfAniCur
Определяет индекс кадра для рисования, если hIcon идентифицирует живой указатель. Этот параметр игнорируется, если hIcon не идентифицирует живой указатель.
hbrFlickerFreeDraw
Идентифицирует кисть, которую система использует для немерцающего рисунка. Если hbrBkgnd - допустимый дескриптор кисти, система создает вне экрана точечный рисунок, используя заданную кисть для цвета фона, рисует пиктограмму или курсор в виде точечного рисунка, а затем копирует его в контекст устройства, идентифицированный при помощи hdc. Если hbrBkgnd имеет значение ПУСТО (NULL), система рисует пиктограмму или курсор непосредственно в контекст устройства.
diFlags
Определяет флажки рисунка. Этот параметр может быть одним из следующих значений:

  • DI_COMPAT - Рисует пиктограмму или курсор, используя изображение определяемое системой по умолчанию, а не изображение определяемое пользователем.
  • DI_DEFAULTSIZE - Если в параметрах cxWidth и cyWidth установлен нуль, рисует пиктограмму или курсор, используя ширину и высоту определяемую метрическими значениями системы для курсоров или пиктограмм. Если этот флажок не установлен, а в параметры cxWidth и cyWidth установлены в нуль, функция использует фактический размер из ресурса.
  • DI_IMAGE - Выполняет растровую операцию, определяемую элементом ropImage.
  • DI_MASK - Выполняет растровую операцию, определяемую элементом ropMask.
  • DI_NORMAL - Комбинация DI_IMAGE и DI_MASK.

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

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

Смотри также
CopyImage, DrawIcon, LoadImage

Размещение и совместимость DrawIconEx

Windows NTДа 
Win95Да
Win32sДа
Импортируемая библиотекаuser32.lib
Заголовочный файлwinuser.h
УникодНет
Замечания по платформеНе имеется

 
« Предыдущая статья   Следующая статья »