Функция _WinAPI_DrawIconEx

 ↑  ←  Описание функции


_WinAPI_DrawIconEx

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

#include <WinAPI.au3>
_WinAPI_DrawIconEx($hDC, $iX, $iY, $hIcon [, $iWidth = 0 [, $iHeight = 0 [, $iStep = 0 [, $hBrush = 0 [, $iFlags = 3]]]]])

Параметры

$hDC Дескриптор контекста устройства
$iX X-координата левого верхнего угла иконки
$iY Y-координата левого верхнего угла иконки
$hIcon Дескриптор иконки
$iWidth [необязательный] Ширина иконки или курсора. Если этот параметр равен нулю и параметр $iFlags - "размер по умолчанию" (5), то функция использует системные значения метрики $SM_CXICON или $SM_CXCURSOR для установки ширины. Если этот параметр равен нулю и "размер по умолчанию" не используется, то функция использует фактическую ширину ресурсов.
$iHeight [необязательный] Высота иконки или курсора. Если этот параметр равен нулю и параметр $iFlags - "размер по умолчанию" (5), то функция использует системные значения метрики $SM_CYICON или $SM_CYCURSOR для установки высоты. Если этот параметр равен нулю и "размер по умолчанию" не используется, то функция использует фактическую высоту ресурсов.
$iStep [необязательный] Индекс кадра, который будет использоваться, если $hIcon является анимированным курсором. Этот параметр игнорируется, если $hIcon не является анимированным курсором.
$hBrush [необязательный] Handle to a brush that the system uses for flicker-free drawing. If hBrush 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
    hBrush is 0, the system draws the icon or cursor directly into the device context.
$iFlags [необязательный] Флаги рисования. Этот параметр может быть одним из следующих значений:
    1 - Рисует иконку или курсор используя маску
    2 - Рисует иконку или курсор используя изображение
    3 - Рисует иконку или курсор используя маску и изображение
    4 - Рисует иконку или курсор используя системное изображение по умолчанию, а не указанное пользователем изображение
    5 - Рисует иконку или курсор используя ширину и высоту определяемые значениями системной метрики для иконки или курсора, если параметры $iWidth и $iHeight равны нулю. Если этот флаг не указан, и $iWidth и $iHeight равны нулю, то функция использует фактические размеры ресурсов.
    6 - Рисует иконку в зеркальном отражении

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

Успех:Возвращает True
Ошибка:Возвращает False

См. также

_WinAPI_DrawIcon

См. также

Искать DrawIconEx в библиотеке MSDN

Пример

#include <GUIConstantsEx.au3>
#include <WinAPI.au3>

; Создаёт GUI
$hGUI = GUICreate("Использование дескриптора иконки", 400, 300)
GUISetState()

$hIcon = _WinAPI_LoadShell32Icon(4) ; Получает дескриптор иконки
$hDC = _WinAPI_GetWindowDC($hGUI) ; Получает контекст устройства
_WinAPI_DrawIconEx($hDC, 20, 40, $hIcon, 16, 16) ; Рисует иконку в контекст устройства
 ; Освобождает ресурсы
_WinAPI_ReleaseDC($hGUI, $hDC)
_WinAPI_DestroyIcon($hIcon)

; Цикл выполняется, пока окно не будет закрыто
Do
Until GUIGetMsg() = $GUI_EVENT_CLOSE