Funktionreferenz


_WinAPI_DrawIconEx

Beschreibung anzeigen in

Zeichnet ein Icon oder Cursor in den angegebenen Gerätekontext

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

Parameter

$hDC Handle zu dem Gerätekontext in welchen das Icon oder der Cursor gezeichnet werden soll
$iX X Koordinate der oberen linken Ecke des Icons
$iY Y Koordinate der oberen linken Ecke des Icons
$hIcon Handle des zu zeichnenden Icons/Cursors
$iWidth [optional] Legt die logische Breite des Icons/Cursors fest.
Ist dieser Parameter Null und der $iFlags Parameter ist 5 ("default size"), benutzt die Funktion die Werte für $SM_CXICON oder $SM_CXCURSOR der Systemkoordinaten um die Breite zu festzusetzen.
Ist dieser Wert Null und "default size" ist nicht in $iFlags gesetzt, wird die tatsächliche Breite der Ressource angenommen.
$iHeight [optional] Legt die logische Höhe des Icons/Cursors fest.
Ist dieser Parameter Null und der $iFlags Parameter ist 5 ("default size"), benutzt die Funktion die Werte für $SM_CYICON oder $SM_CYCURSOR des Koordinatensystems um die Breite zu festzusetzen.
Ist dieser Wert Null und "default size" ist nicht in $iFlags gesetzt, wird die tatsächliche Breite der Ressource angenommen.
$iStep [optional] Legt den Index fest, der zu zeichnen ist, falls $hIcon einen animierten Cursor identifiziert.
Dieser Parameter wird ignoriert, sollte $hIcon keinen animierten Cursor identifizieren.
$hBrush [optional] Handle zu einem Füllmuster (Brush), welcher für Flickerfreies zeichnen vom System genutzt werden soll.
Ist $hBrush ein gültiges Handle zu einem Füllmuster, wird vom System eine "Offscreen" Bitmap mit dem angegebenen Füllmuster als Hintergrund erzeugt, das/der Icon/Cursor in die Bitmap gezeichnet, die dann in den von hDC identifizierten Gerätekontext eingesetzt. Falls $hBrush NULL (0) ist, wird das Icon, bzw. der Cursor direkt in den Gerätekontext gezeichnet.
$iFlags [optional] Legt die Flags zum Zeichnen fest. Dieser Parameter kann einer der folgenden Werte sein:
1 - Zeichnet das Icon oder den Cursor unter Verwendung der Maske
2 - Zeichnet das Icon oder den Cursor unter Verwendung des Bildes
3 - Zeichnet das Icon oder den Cursor unter Verwendung der Maske und des Bildes
4 - Zeichnet das Icon oder den Cursor unter Verwendung des Systemstandard-Bildes anstelle des benutzerdefinierten Bildes
5 - Zeichnet das Icon oder den Cursor unter Verwendung mit der Breite/Höhe der Werte der Systemkoordinaten für Icons/Cursor, falls die Parameter $iWidth und $iHeight mit Null angegeben werden.
Wird dieses Flag nicht festgelegt und $iWidth und $iHeight sind auf Null gesetzt, wird die tatsächliche Größe der Ressource angenommen.
6 - Zeichnet das Icon als ein ungespiegeltes Icon (Windows XP)

Rückgabewert

Erfolg: True
Fehler: False. Es ist _WinAPI_GetLastError() aufzurufen um erweiterte Fehlerinformationen zu erhalten..

Verwandte Funktionen

_WinAPI_DrawIcon

Siehe auch

Suche nach DrawIconEx in der MSDN Bibliothek.

Beispiel

#include <Constants.au3>
#include <WinAPI.au3>

$hGui = GUICreate("_WinAPI_Icon", 450, 120)
GUISetState()
$hDC = _WinAPI_GetDC($hGui)

$hInstance = _WinAPI_GetModuleHandle("shell32.dll")
$hIcon1 = _WinAPI_LoadImage($hInstance, 1, $IMAGE_ICON, 0, 0, $LR_DEFAULTSIZE)
$hIcon2 = _WinAPI_LoadImage($hInstance, 2, $IMAGE_ICON, 0, 0, $LR_DEFAULTSIZE)
$hIcon3 = _WinAPI_CopyIcon($hIcon2)
;$hIcon4 = _WinAPI_PrivateExtractIcon("shell32.dll", 4, 96, 96) ; ab der nächsten Beta
$hIcon5 = _WinAPI_LoadShell32Icon(5)

_WinAPI_DrawIcon($hDC, 10, 10, $hIcon1)
_WinAPI_DrawIconEx($hDC, 70, 10, $hIcon2, 100, 50)
_WinAPI_DrawIcon($hDC, 200, 10, $hIcon3)
;_WinAPI_DrawIconEx($hDC, 300, 10, $hIcon4, 96, 96)
_WinAPI_DrawIcon($hDC, 400, 10, $hIcon5)

While GUIGetMsg() <> -3
    Sleep(10)
WEnd

_WinAPI_DestroyIcon($hIcon1)
_WinAPI_DestroyIcon($hIcon2)
_WinAPI_DestroyIcon($hIcon3)
;_WinAPI_DestroyIcon($hIcon4)
_WinAPI_DestroyIcon($hIcon5)
_WinAPI_ReleaseDC($hGui, $hDC)