DrawIcon-Funktion (winuser.h)

Artikel
02/01/2024

Zeichnet ein Symbol oder einen Cursor in den angegebenen Gerätekontext.

Verwenden Sie die DrawIconEx-Funktion , um zusätzliche Zeichnungsoptionen anzugeben.

Syntax

BOOL DrawIcon(
  [in] HDC   hDC,
  [in] int   X,
  [in] int   Y,
  [in] HICON hIcon
);

Parameter

[in] hDC

Typ: HDC

Ein Handle für den Gerätekontext, in den das Symbol oder der Cursor gezeichnet wird.

[in] X

Typ: int

Die logische x-Koordinate der oberen linken Ecke des Symbols.

[in] Y

Typ: int

Die logische y-Koordinate der oberen linken Ecke des Symbols.

[in] hIcon

Typ: HICON

Ein Handle für das zu zeichnende Symbol.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

DrawIcon platziert die obere linke Ecke des Symbols an der durch die Parameter X und Y angegebenen Position. Der Standort unterliegt dem aktuellen Zuordnungsmodus des Gerätekontexts.

DrawIcon zeichnet das Symbol oder den Cursor mit der Breite und Höhe, die durch die Systemmetrikwerte für Symbole angegeben sind; weitere Informationen finden Sie unter GetSystemMetrics.

Die DrawIcon-Funktion ruft DrawIconEx auf, die als Flags übergeben DI_NORMAL|DI_DEFAULTSIZE wird.

Beispiele

Ein Beispiel finden Sie unter Anzeigen eines Symbols.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-gui-l1-3-1 (eingeführt in Windows 10, Version 10.0.14393)