Funzione DrawIconEx (winuser.h)

Articolo
03/04/2024

Disegna un'icona o un cursore nel contesto di dispositivo specificato, eseguendo le operazioni raster specificate e estendendo o comprimendo l'icona o il cursore come specificato.

Sintassi

BOOL DrawIconEx(
  [in]           HDC    hdc,
  [in]           int    xLeft,
  [in]           int    yTop,
  [in]           HICON  hIcon,
  [in]           int    cxWidth,
  [in]           int    cyWidth,
  [in]           UINT   istepIfAniCur,
  [in, optional] HBRUSH hbrFlickerFreeDraw,
  [in]           UINT   diFlags
);

Parametri

[in] hdc

Tipo: HDC

Handle per il contesto di dispositivo in cui verrà disegnata l'icona o il cursore.

[in] xLeft

Tipo: int

Coordinata x logica dell'angolo superiore sinistro dell'icona o del cursore.

[in] yTop

Tipo: int

Coordinata logica y dell'angolo superiore sinistro dell'icona o del cursore.

[in] hIcon

Tipo: HICON

Handle per l'icona o il cursore da disegnare. Questo parametro può identificare un cursore animato.

[in] cxWidth

Tipo: int

Larghezza logica dell'icona o del cursore. Se questo parametro è zero e il parametro diFlags è DI_DEFAULTSIZE, la funzione usa il valore della metrica di sistema SM_CXICON per impostare la larghezza. Se questo parametro è zero e non viene usato DI_DEFAULTSIZE , la funzione usa la larghezza effettiva della risorsa.

[in] cyWidth

Tipo: int

Altezza logica dell'icona o del cursore. Se questo parametro è zero e il parametro diFlags è DI_DEFAULTSIZE, la funzione usa il valore della metrica di sistema SM_CYICON per impostare la larghezza. Se questo parametro è zero e non viene usato DI_DEFAULTSIZE , la funzione usa l'altezza effettiva della risorsa.

[in] istepIfAniCur

Tipo: UINT

Indice del frame da disegnare, se hIcon identifica un cursore animato. Questo parametro viene ignorato se hIcon non identifica un cursore animato.

[in, optional] hbrFlickerFreeDraw

Tipo: HBRUSH

Handle di un pennello utilizzato dal sistema per il disegno senza sfarfallio. Se hbrFlickerFreeDraw è un handle di pennello valido, il sistema crea una bitmap offscreen usando il pennello specificato per il colore di sfondo, disegna l'icona o il cursore nella bitmap e quindi copia la bitmap nel contesto di dispositivo identificato da hdc. Se hbrFlickerFreeDraw è NULL, il sistema disegna l'icona o il cursore direttamente nel contesto del dispositivo.

[in] diFlags

Tipo: UINT

Flag di disegno. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
DI_COMPAT 0x0004	Questo flag viene ignorato.
DI_DEFAULTSIZE 0x0008	Disegna l'icona o il cursore usando la larghezza e l'altezza specificati dai valori delle metriche di sistema per le icone, se i parametri cxWidth e cyWidth sono impostati su zero. Se questo flag non è specificato e cxWidth e cyWidth sono impostati su zero, la funzione usa le dimensioni effettive della risorsa.
DI_IMAGE 0x0002	Disegna l'icona o il cursore usando l'immagine. Vedere la sezione Osservazioni.
DI_MASK 0x0001	Disegna l'icona o il cursore utilizzando la maschera. Vedere la sezione Osservazioni.
DI_NOMIRROR 0x0010	Disegna l'icona come icona non ignorata. Per impostazione predefinita, l'icona viene disegnata come icona con mirroring se hdc è con mirroring.
DI_NORMAL 0x0003	Combinazione di DI_IMAGE e DI_MASK. Vedere la sezione Osservazioni.

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

La funzione DrawIconEx posiziona l'angolo superiore sinistro dell'icona nella posizione specificata dai parametri xLeft e yTop . La posizione è soggetta alla modalità di mapping corrente del contesto di dispositivo.

Se viene impostato solo uno dei flag DI_IMAGE e DI_MASK, la bitmap corrispondente viene disegnata con il codice dell'operazione rasterSRCCOPY.

Se vengono impostati entrambi i flag DI_IMAGE e DI_MASK :

Se l'icona o il cursore è un'icona o un cursore a 32 bit, l'immagine viene disegnata con AC_SRC_OVERfunzione blend e la maschera viene ignorata.
Per tutte le altre icone o cursori, la maschera viene disegnata con il codice dell'operazione rasterSRCAND e l'immagine viene disegnata con il codice dell'operazione rasterSRCINVERT

Per duplicare DrawIcon (hDC, X, Y, hIcon), chiamare DrawIconEx come segue:

DrawIconEx (hDC, X, Y, hIcon, 0, 0, 0, NULL, DI_NORMAL | DI_COMPAT | DI_DEFAULTSIZE);

Requisiti

Requisito	Valore
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-1-0 (introdotto in Windows 8)