LoadImage

La funzione LoadImage carica un'icona, il cursore o la bitmap.

( HANDLE LoadImage HINSTANCE  hinst, / / handle dell'istanza contenente l'immagineLPCTSTRlpszName, / / nome o identificatore dell'immagineUINTuType, / / tipo di immagineintcxDesired, / / larghezza desiderata intcyDesired, / / altezza desiderataUINTfuLoad / / carica il flag);
 

Parametri

hinst
Gestire a un'istanza del modulo contenente l'immagine da caricare. Per caricare un'immagine OEM, impostare questo parametro su zero.
lpszName
Gestire l'immagine da caricare.

Se il parametro hinst diverso da NULL e il parametro fuLoad non include LR_LOADFROMFILE, lpszName un puntatore a una stringa null-terminated che contiene il nome della risorsa immagine nel modulo hinst.

Se hinst NULL e non viene specificato LR_LOADFROMFILE, la parola significativi di questo parametro deve essere l'identificatore dell'immagine da caricare OEM. Gli identificatori di immagine OEM sono definiti in WINUSER.H e hanno i seguenti prefissi:
Prefisso Significato
OBM_ OEM bitmap
OIC_ Icone OEM
OCR_ Cursori OEM

Se il parametro fuLoad include il valore LR_LOADFROMFILE, lpszName il nome del file contenente l'immagine.

uType
Specifica il tipo di immagine da caricare. Questo parametro pu essere uno dei seguenti valori:
Valore Significato
IMAGE_BITMAP Carica una bitmap.
IMAGE_CURSOR Carica un cursore.
IMAGE_ICON Carica un'icona.

cxDesired
Specifica la larghezza in pixel, di cursore o l'icona. Se questo parametro pari a zero e il parametro fuLoad LR_DEFAULTSIZE, la funzione utilizza il valore di metrico di sistema SM_CXICON o SM_CXCURSOR per impostare la larghezza. Se questo parametro zero e LR_DEFAULTSIZE non viene utilizzata, la funzione utilizza la larghezza effettiva delle risorse.
cyDesired
Specifica l'altezza, in pixel, di cursore o l'icona. Se questo parametro pari a zero e il parametro fuLoad LR_DEFAULTSIZE, la funzione utilizza il valore di metrico di sistema SM_CYICON o SM_CYCURSOR per impostare l'altezza. Se questo parametro zero e LR_DEFAULTSIZE non viene utilizzata, la funzione utilizza l'altezza effettiva delle risorse.
fuLoad
Specifica una combinazione dei seguenti valori:
Valore Significato
LR_DEFAULTCOLOR Il flag predefinito; non fa nulla. Tutto ci vuol dire che "non LR_MONOCHROME".
LR_CREATEDIBSECTION Quando il parametro uType specifica IMAGE_BITMAP, provoca la funzione restituire una bitmap di sezione DIB, piuttosto che una bitmap compatibile. Questo flag utile per il caricamento di un'immagine bitmap senza mapping ai colori del dispositivo di visualizzazione.
LR_DEFAULTSIZE Utilizza la larghezza o l'altezza specificata dai valori sistema metrico per i cursori o icone, se i valori di cxDesired o cyDesired sono impostati su zero. Se questo flag non specificato e cxDesired e cyDesired sono impostati a zero, la funzione utilizza la dimensione effettiva delle risorse. Se la risorsa contiene immagini multiple, la funzione utilizza la dimensione della prima immagine.
LR_LOADFROMFILE Carica l'immagine dal file specificato dal parametro lpszName . Se questo flag non specificato, lpszName il nome della risorsa.
LR_LOADMAP3DCOLORS Cerca la tabella dei colori dell'immagine e sostituisce i seguenti tonalit di grigio con il colore corrispondente 3D:

Colore Sostituito con
DK Gray,
RGB(128,128,128)
COLOR_3DSHADOW
Gray,
RGB(192,192,192)
COLOR_3DFACE
Lt Gray,
RGB(223,223,223)
COLOR_3DLIGHT

LR_LOADTRANSPARENT Recupera il valore del colore del primo pixel nell'immagine e sostituisce la voce corrispondente nella tabella di colore con colore della finestra predefinita (COLOR_WINDOW). Tutti i pixel dell'immagine che utilizzano tale voce di diventano il colore della finestra predefinito. Questo valore si applica solo alle immagini che hanno le tabelle di colore corrispondente.

Se fuLoad include valori la LR_LOADTRANSPARENT e la LR_LOADMAP3DCOLORS, la LRLOADTRANSPARENT ha la precedenza. Tuttavia, la voce della tabella colore viene sostituita con COLOR_3DFACE anzich COLOR_WINDOW.

LR_MONOCHROME Carica l'immagine in bianco e nero.
LR_SHARED Se l'immagine viene caricata pi volte, condivide l'handle di immagine. Se LR_SHARED non impostata, una seconda chiamata a LoadImage per la stessa risorsa sar nuovamente il caricamento dell'immagine e restituire un handle differente.

Non utilizzare LR_SHARED per le immagini che hanno dimensioni non standard, che possono cambiare dopo il caricamento, o che vengono caricati da un file.

Windows 95 e Windows 98: La funzione trova la prima immagine con il nome di risorsa richiesta nella cache, indipendentemente dalle dimensioni richieste.

LR_VGACOLOR Utilizza veri colori VGA.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito l'handle dell'immagine appena caricata.

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

Osservazioni

Quando si terminato di utilizzare la bitmap, cursore o sull'icona, si pu rilasciare la memoria associata chiamando una delle funzioni nella tabella seguente.

Risorsa Funzione di rilascio
Bitmap DeleteObject
Cursore DestroyCursor
Icona DestroyIcon

Il sistema elimina automaticamente queste risorse quando termina il processo che li ha creati, tuttavia, chiamando la funzione appropriata conserva la memoria e riduce le dimensioni del set di lavoro del processo.

Windows CE: I parametri cxDesired e cyDesired devono essere zero per IMAGE_BITMAP.

Windows CE non supporta stretching e restringimento delle icone.

Il parametro fuLoad deve essere zero (= = LR_DEFAULTCOLOR).

Se si prendono di mira una piattaforma che non supporta cursori del mouse, possibile specificare i valori SM_CXCURSOR e SM_CYCURSOR nei parametri cxDesired e cyDesired e IMAGE_CURSOR non specificato per il parametro uType.

Se si prendono di mira una piattaforma che supporta cursori del mouse, possibile specificare SM_CXCURSOR e SM_CYCURSOR in cxDesired e i parametri cyDesired e IMAGE_CURSOR nel parametro uType.

Descrizione

nbsp;Windows &NT: richiede una versione 4.0 o successive.
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.
Unicode:Implementato come versioni Unicode e ANSI su Windows NT.

Vedi anche

Panoramica delle risorse, le funzioni delle risorse, CopyImage, GetSystemMetrics, LoadBitmap, LoadCursor, LoadIcon

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

Index