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

• diFlags deve essere DI_NORMAL, DI_IMAGE o DI_MASK. (DI_COMPAT e DI_DEFAULTSIZE non sono supportati.)
• cxWidth e cyHeight devono essere zero o le dimensioni native dell'icona.
• hbrFlickerFreeDraw deve essere NULL.
• iStepIfAniCur deve essere zero. Icone animate non supportati.

Windows CE non supporta:

• Stretching e compressione.

  Cioè, la risoluzione di icona è fisso per un determinato HICON e nessuna icona ridimensionamento è supportato.

• Modalità di mappatura.
• Usando DrawIconEx per disegnare i cursori.

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