На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

DrawIconEx



The DrawIconEx function draws an icon or cursor in the client area of the window of the specified device context, performing the specified raster operations, and stretching or compressing the icon or cursor as specified.

BOOL DrawIconEx(

HDC hdc, // handle to device context
int xLeft, // x-coordinate of upper left corner
int yTop, // y-coordinate of upper left corner
HICON hIcon, // handle to icon to draw
int cxWidth, // width of the icon
int cyWidth, // height of the icon
UINT istepIfAniCur, // index of frame in animated cursor
HBRUSH hbrFlickerFreeDraw, // handle to background brush
UINT diFlags // icon-drawing flags
);


Parameters

hdc

Identifies the device context for a window.

xLeft

Specifies the logical x-coordinate of the upper-left corner of the icon or cursor.

yTop

Specifies the logical y-coordinate of the upper-left corner of the icon or cursor.

hIcon

Identifies the icon or cursor to be drawn. This parameter can identify an animated cursor. The icon or cursor resource must have been previously loaded by using the LoadImage function.

cxWidth

Specifies the logical width of the icon or cursor. If this parameter is zero and the diFlags parameter is DI_DEFAULTSIZE, the function uses the SM_CXICON or SM_CXCURSOR system metric value to set the width. If this parameter is zero and DI_DEFAULTSIZE is not used, the function uses the actual resource width.

cyWidth

Specifies the logical height of the icon or cursor. If this parameter is zero and the diFlags parameter is DI_DEFAULTSIZE, the function uses the SM_CYICON or SM_CYCURSOR system metric value to set the width. If this parameter is zero and DI_DEFAULTSIZE is not used, the function uses the actual resource height.

istepIfAniCur

Specifies the index of the frame to draw, if hIcon identifies an animated cursor. This parameter is ignored if hIcon does not identify an animated cursor.

hbrFlickerFreeDraw

Identifies a brush that the system uses for flicker-free drawing. If hbrBkgnd is a valid brush handle, the system creates an offscreen bitmap using the specified brush for the background color, draws the icon or cursor into the bitmap, and then copies the bitmap into the device context identified by hdc. If hbrBkgnd is NULL, the system draws the icon or cursor directly into the device context.

diFlags

Specifies the drawing flags. This parameter can be one of the following values:

Value Meaning
DI_COMPAT Draws the icon or cursor using the system default image rather than the user-specified image.
DI_DEFAULTSIZE Draws the icon or cursor using the width and height specified by the system metric values for cursors or icons, if the cxWidth and cyWidth parameters are set to zero. If this flag is not specified and cxWidth and cyWidth are set to zero, the function uses the actual resource size.
DI_IMAGE Performs the raster operation specified by ropImage.
DI_MASK Performs the raster operation specified by ropMask.
DI_NORMAL Combination of DI_IMAGE and DI_MASK.


Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The DrawIconEx function places the icon's upper-left corner at the location specified by the xLeft and yTop parameters. The location is subject to the current mapping mode of the device context.

See Also

CopyImage, DrawIcon, LoadImage


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

DrawIconEx



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

BOOL DrawIconEx(

HDC hdc, // РУЧКА в контекст устройства int xLeft, // x-coordinate верхнего левого угла int yTop, // y-coordinate верхнего левого угла HICON hIcon, // ручка на икону, чтобы делать int cxWidth, // шириной иконы int cyWidth, // высота иконы UINT istepIfAniCur, // индекса фрейма в оживленном курсоре HBRUSH hbrFlickerFreeDraw, // ручке в щетку фона UINT diFlags // иконный чертеж флагов
);


Параметры

hdc

Идентифицирует контекст устройства для окна.

xLeft

Определяет логический x-coordinate верхнего левого угла иконы или курсора.

yTop

Определяет логический y-coordinate верхнего левого угла иконы или курсора.

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 - правильная ручка щетки, система создает побитовое отображение offscreen, использовавшее определенную щетку для цвета фона, делает иконой или курсором в побитовое отображение, и тогда копирует побитовое отображение в контекст устройства идентифицированный hdc. Если hbrBkgnd НЕДЕЙСТВИТЕЛЕН, система делает иконой или курсором непосредственно в контекст устройства.

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


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz