Funzione DrawIconEx (winuser.h)
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 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) |
Vedi anche
Informazioni concettuali
Riferimento
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per