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);
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.
| Valore | Significato |
|---|---|
| IMAGE_BITMAP | Carica una bitmap. |
| IMAGE_CURSOR | Carica un cursore. |
| IMAGE_ICON | Carica un'icona. |
| 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. |
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.
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.
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.
Panoramica delle risorse, le funzioni delle risorse, CopyImage, GetSystemMetrics, LoadBitmap, LoadCursor, LoadIcon
Rimedio: Inserire il CD-ROM CD di MSDN Library.