Funcția LoadImage încarcă o pictogramă, cursorul sau bitmap.
( LoadImage MÂNER HINSTANCE hinst, / / mâner instan?ă care con?ine imagineaLPCTSTRlpszName, / / nume sau identificatorul de imagineUINTuType, / / tipul de imagineintcxDesired, / / dorit lățime intcyDesired, / / dorit înălțimeUINTfuLoad / / încărca steaguri);
Dacă parametrul hinst este non-NULL și parametrul fuLoad nu include LR_LOADFROMFILE, lpszName este un indicator spre un șir null-terminated care conține numele resursei imaginea în modul hinst.
În cazul în care hinst este NULL și LR_LOADFROMFILE nu este specificat, cuvântul low-ordinea de acest parametru trebuie să fie identificatorul de OEM imagine pentru a încărca. Identificatori de imagine OEM sunt definite în WINUSER.H și au următoarele prefixes:
| Prefix | Sensul |
|---|---|
| OBM_ | Bitmap-uri OEM |
| OIC_ | OEM icoane |
| OCR_ | OEM cursoare |
Dacă parametrul fuLoad include valoarea LR_LOADFROMFILE, lpszName este numele fișierului care conține imaginea.
| Valoarea | Sensul |
|---|---|
| IMAGE_BITMAP | Încarcă un bitmap. |
| IMAGE_CURSOR | Încarcă un cursor. |
| IMAGE_ICON | Încarcă o pictogramă. |
| Valoarea | Sensul |
|---|---|
| LR_DEFAULTCOLOR | Drapelul implicit; ea nu face nimic. Toate înseamnă este "nu LR_MONOCHROME". |
| LR_CREATEDIBSECTION | Când parametrul uType specifică IMAGE_BITMAP, provoacă funcția pentru a reveni la secțiunea DIB bitmap, mai degrabă decât un bitmap compatibile. Acest flag este util pentru încărcare bitmap fără o cartografiere culorile de dispozitivul de afișare. |
| LR_DEFAULTSIZE | Utilizează lățime sau înălțime specificată de sistemul metric valorile pentru cursoare sau pictograme, dacă valorile cxDesired sau cyDesired sunt setate la zero. Dacă nu este specificat acest steag și cxDesired și cyDesired sunt setate la zero, funcția utilizează dimensiunea reală de resurse. Dacă resursa conține mai multe imagini, funcția utilizează dimensiunea prima imagine. |
| LR_LOADFROMFILE | Încarcă imaginea din fișierul specificat de parametrul lpszName . Dacă nu este specificat acest flag, lpszName este numele resursei. |
| LR_LOADMAP3DCOLORS | Tabelul de culoare pentru imaginea caută și înlocuiește următoarele nuanțe de gri cu culoarea corespunzătoare 3D: |
| Culoare | Înlocuit cu | |
|---|---|---|
| DK gri, RGB(128,128,128) |
COLOR_3DSHADOW | |
| Gri, RGB(192,192,192) |
COLOR_3DFACE | |
| Lt gri, RGB(223,223,223) |
COLOR_3DLIGHT |
| LR_LOADTRANSPARENT | Regăsește valoarea culoare prima pixel din imagine și înlocuiește corespunzătoare intrării în tabelul de culori cu culoarea de fereastra implicită (COLOR_WINDOW). Toți pixelii din imagine care utilizează acea intrare devine culoarea implicită fereastra. Această valoare se aplică numai pentru imaginile care au corespunzătoare tabele de culori. Dacă fuLoad include valorile atât LR_LOADTRANSPARENT și LR_LOADMAP3DCOLORS, LRLOADTRANSPARENT, are prioritate. Cu toate acestea, intrarea tabelului culoare este înlocuit cu COLOR_3DFACE, mai degrabă decât COLOR_WINDOW. |
| LR_MONOCHROME | Încarcă imaginea în alb și negru. |
| LR_SHARED | Parts ghidajul imagine dacă imagine este încărcat de mai multe ori. Dacă LR_SHARED nu este setat, un al doilea apel pentru LoadImage pentru aceeași resursă va încărca imaginea din nou și a reveni un mâner diferite. Nu utilizați LR_SHARED pentru imaginile care au dimensiuni non-standard, care pot fi modificate după încărcare, sau care sunt încărcate dintr-un fișier. Windows 95 și Windows 98: Funcția găsește prima imagine cu numele Resursa solicitată în cache-ul, indiferent de dimensiunea solicitate. |
| LR_VGACOLOR | Utilizează adevărat culori VGA. |
Dacă funcția reușește, valoarea returnată este ghidajul din nou încărcat imagine.
Dacă funcția nu reușește, valoarea returnată este NULL. Pentru a obține extins informa?ii eroare, apel GetLastError.
Când ați terminat folosind bitmap, cursorul sau pictogramă, aveți posibilitatea să lansați memorie asociate de una din funcțiile de asteptare în tabelul următor.
| Resurse | Funcția de presă |
|---|---|
| Bitmap | ȘtergereObiect |
| Cursorul | DestroyCursor |
| Pictogramă | DestroyIcon |
Sistemul șterge automat aceste resurse atunci când se termină procesul care le-a creat, cu toate acestea, apel funcția corespunzătoare economisește memorie și Micșorează dimensiunea lui procesul set de lucru.
Windows CE: Parametrii cxDesired și cyDesired trebuie să fie zero pentru IMAGE_BITMAP.
Windows CE nu acceptă se întinde și scădere de icoane.
Parametrul fuLoad trebuie să fie zero (== LR_DEFAULTCOLOR).
Dacă sunteți de orientare o platformă care nu acceptă cursoare de mouse-ul, nu specificați valorile SM_CXCURSOR și SM_CYCURSOR în parametrii cxDesired și cyDesired , și nu puteți specifica IMAGE_CURSOR pentru parametrul uType.
Dacă sunteți de orientare o platformă care acceptă cursoare de mouse-ul, aveți posibilitatea să specificați SM_CXCURSOR și SM_CYCURSOR cxDesired parametrii cyDesired , ?i IMAGE_CURSOR în parametrul uType.
nbsp; Windows &NT: necesită versiunea 4.0 sau ulterioară.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Necesită versiunea 1.0 sau mai târziu.
Antet:A declarat în winuser.h.
Import Biblioteca:Utilizarea user32.lib.
Unicode:Pus în aplicare ca Unicode și ANSI versiuni Windows NT.
Ansamblu de resurse, resurse funcții, CopyImage, GetSystemMetrics, LoadBitmap, LoadCursor, LoadIcon