Funzione DrawIcon (winuser.h)

Articolo
01/27/2024

Disegna un'icona o un cursore nel contesto del dispositivo specificato.

Per specificare opzioni di disegno aggiuntive, usare la funzione DrawIconEx .

Sintassi

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

Parametri

[in] hDC

Tipo: HDC

Handle per il contesto del dispositivo in cui verrà disegnato l'icona o il cursore.

[in] X

Tipo: int

Coordinata x logica dell'angolo superiore sinistro dell'icona.

[in] Y

Tipo: int

Coordinata logica y dell'angolo superiore sinistro dell'icona.

[in] hIcon

Tipo: HICON

Handle per l'icona da disegnare.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

DrawIcon posiziona l'angolo superiore sinistro dell'icona nella posizione specificata dai parametri X e Y . Il percorso è soggetto alla modalità di mapping corrente del contesto del dispositivo.

DrawIcon disegna l'icona o il cursore usando la larghezza e l'altezza specificata dai valori delle metriche di sistema per le icone; per altre informazioni, vedere GetSystemMetrics.

La funzione DrawIcon chiama DrawIconEx passando DI_NORMAL|DI_DEFAULTSIZE come flag.

Esempio

Per un esempio, vedere Visualizzazione di un'icona.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-gui-l1-3-1 (introdotto in Windows 10, versione 10.0.14393)