DrawIconEx

La funzione DrawIconEx disegna il cursore o un'icona nell'area client della finestra del contesto di periferica specificato, eseguendo le operazioni raster specificato e stretching o comprimere l'icona o cursore come specificato.

 (BOOL DrawIconEx HDC  hdc, / / handle di contesto di perifericaintxLeft, / / la coordinata x dell'angolo superiore sinistrointyTop, / / la coordinata y dell'angolo superiore sinistroHICONhIcon, / / handle all'icona per disegnare intcxWidth, / / larghezza dell'icona intcyWidth, / / altezza dell'iconaUINTistepIfAniCur, / / indice di frame nell'animato cursoreHBRUSHhbrFlickerFreeDraw, / / handle al pennello di sfondo UINTdiFlags / / icona-disegno flags);
 

Parametri

hdc
Handle per il contesto di periferica per una finestra.
xLeft
Specifica la logica coordinata x dell'angolo superiore sinistro del cursore o icona.
yTop
Specifica la logica coordinata y dell'angolo superiore sinistro del cursore o icona.
hIcon
Gestire a icona o cursore da trarre. Questo parametro può identificare un cursore animato. La risorsa icona o cursore deve sono stati precedentemente caricata utilizzando la funzione LoadImage.
cxWidth
Specifica la larghezza logica dell'icona o cursore. Se questo parametro è pari a zero e il parametro diFlags è DI_DEFAULTSIZE, la funzione utilizza il valore di metrico di sistema SM_CXICON o SM_CXCURSOR per impostare la larghezza. Se questo parametro è zero e DI_DEFAULTSIZE non viene utilizzata, la funzione utilizza la larghezza effettiva delle risorse.
cyWidth
Specifica l'altezza logico dell'icona o cursore. Se questo parametro è pari a zero e il parametro diFlags è DI_DEFAULTSIZE, la funzione utilizza il valore di metrico di sistema SM_CYICON o SM_CYCURSOR per impostare la larghezza. Se questo parametro è zero e DI_DEFAULTSIZE non viene utilizzata, la funzione utilizza l'altezza effettiva delle risorse.
istepIfAniCur
Specifica l'indice del telaio per disegnare, se hIcon identifica un cursore animato. Questo parametro viene ignorato se hIcon non identifica un cursore animato.
hbrFlickerFreeDraw
Handle per un pennello che il sistema utilizza per il disegno di sfarfallio. Se hbrFlickerFreeDraw è un handle di pennello validi, il sistema crea un'oggetto bitmap fuori campo con il pennello specificato per il colore di sfondo, disegna l'icona o il cursore in bitmap e quindi copia bitmap nel contesto di periferica identificato da hdc. Se hbrFlickerFreeDraw è NULL, il sistema disegna l'icona o il cursore direttamente nel contesto di periferica.
diFlags
Specifica i flag di disegno. Questo parametro può essere uno dei seguenti valori:
Valore Significato
DI_COMPAT Disegna l'icona o cursore usando l'immagine predefinita del sistema, piuttosto che l'immagine specificata dall'utente.
DI_DEFAULTSIZE Disegna l'icona o cursore tramite la larghezza e l'altezza specificate dai valori sistema metrico per i cursori o icone, se i parametri cxWidth e cyWidth vengono impostati su zero. Se questo flag non è specificato e cxWidth e cyWidth sono impostati a zero, la funzione utilizza la dimensione effettiva delle risorse.
DI_IMAGE Disegna l'icona o cursore usando l'immagine.
DI_MASK Disegna l'icona o cursore tramite la maschera.
DI_NORMAL Combinazione di DI_IMAGE e DI_MASK.

Valori restituiti

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

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

La funzione DrawIconEx pone l'angolo superiore sinistro dell'icona nel percorso specificato dai parametri xLeft e yTop . La posizione è soggetto a modalità corrente mappatura del contesto di periferica.

Windows CE: Le seguenti impostazioni del parametro devono essere utilizzate

Windows CE non supporta:

Il parametro hIcon non è possibile identificare un cursore animato.

Descrizione

nbsp; Windows &NT: richiede una versione 3.5 o successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.

Vedi anche

Panoramica di icone, funzioni di icona, CopyImage, DrawIcon, LoadImage

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index