LoadImage

Funkcia LoadImage načíta ikonu, kurzor alebo bitovej mapy.

RUKOVÄŤ LoadImage ( HINSTANCE  hinst; / / popisovač inštancie obsahujúci obrazLPCTSTRlpszName; / / názov alebo identifikátor obrazuUINTuType; / / typ obrazuintcxDesired; / / požadovanú šírku intcyDesired; / / požadovanú výškuUINTfuLoad / / načítať vlajky);
 

Parametre

hinst

Rukoväť na inštanciu modul, ktorý obsahuje obrázok má byť naložený. Ak chcete načítať obrázok OEM, nastaviť tento parameter na nulu.

lpszName

Rukoväť na obrázok nahrať.

Ak hinst parameter je NENULOVÝCH a fuLoad parameter neobsahuje LR_LOADFROMFILE, lpszName je smerník na zakončený reťazec, ktorý obsahuje názov prostriedku obraz v hinst module.

Ak hinst hodnotu NULL a LR_LOADFROMFILE nie je zadaný, nízka-order slovo tento parameter musí byť identifikátor obrázok OEM sa načítať. Identifikátory obrázok OEM sú definované v WINUSER.H a majú nasledujúce predčíslia:

Predpona	Význam
OBM_	Bitové mapy OEM
OIC_	OEM ikony
OCR_	OEM kurzory

Ak fuLoad parameter obsahuje hodnotu LR_LOADFROMFILE, lpszName je názov súboru, ktorý obsahuje obrázok.

uType

Určuje typ obrázka, ktorý sa zaťaží. Tento parameter môže byť jedna z nasledovných hodnôt:

Hodnota	Význam
IMAGE_BITMAP	Načíta bitová mapa.
IMAGE_CURSOR	Načíta kurzor.
IMAGE_ICON	Načíta ikona.

cxDesired

Určuje šírku v pixeloch, ikonu alebo kurzor. Ak tento parameter je nula a fuLoad parameter je LR_DEFAULTSIZE, táto funkcia používa hodnota metrický systém SM_CXICON alebo SM_CXCURSOR nastaviť šírku. Ak tento parameter je nula a LR_DEFAULTSIZE sa nepoužíva, táto funkcia používa skutočný zdroj šírka.

cyDesired

Určuje výšku v pixeloch, ikonu alebo kurzor. Ak tento parameter je nula a fuLoad parameter je LR_DEFAULTSIZE, táto funkcia používa hodnota metrický systém SM_CYICON alebo SM_CYCURSOR stanoviť výšku. Ak tento parameter je nula a LR_DEFAULTSIZE sa nepoužíva, táto funkcia používa výšku skutočných zdrojov.

fuLoad

Určuje kombináciu nasledujúcich hodnôt:

Hodnota	Význam
LR_DEFAULTCOLOR	Predvoleného príznaku; nestane sa nič. Jediné, čo to znamená je "nie LR_MONOCHROME".
LR_CREATEDIBSECTION	UType parameter určuje IMAGE_BITMAP spôsobí funkcia vrátiť bitová mapa DIB časti skôr než zlučiteľnú bitovej mapy. Tento príznak je užitočné pre načítanie bitová mapa bez mapovanie farby zobrazovacie zariadenie.
LR_DEFAULTSIZE	Používa šírky alebo výšky stanovenej hodnoty systému metrických kurzory alebo ikony, cxDesired alebo cyDesired hodnoty sa nastavia na nulu. Ak cxDesired a cyDesired sa nastavia na nulu, tento príznak nie je zadaný, funkcia používa skutočný zdroj veľkosť. Ak zdroj obsahuje viac obrázkov, funkcia používa veľkosť prvý obrázok.
LR_LOADFROMFILE	Načíta obrázok zo súboru zadaného parametra lpszName . Ak nie je určená táto vlajka, lpszName je názov zdroja.
LR_LOADMAP3DCOLORS	Vyhľadá tabuľke farieb obrázka a nahrádza nasledujúcich odtiene sivej farbou zodpovedajúce 3D:

	Farba	Nahradiť
	TM. sivá RGB(128,128,128)	COLOR_3DSHADOW
	Gray, RGB(192,192,192)	COLOR_3DFACE
	Svetlosivá, RGB(223,223,223)	COLOR_3DLIGHT

LR_LOADTRANSPARENT	Načíta farbu hodnotu prvého pixelov v obraze a nahradí zodpovedajúcu položku v tabuľke farieb predvolenú farbu okna (COLOR_WINDOW). VÜetk2ch pixelov na obrázku, ktoré používajú tento zápis stane predvolenú farbu okna. Táto hodnota platí iba na obrázky, ktoré majú zodpovedajúce farby tabuľky. Ak fuLoad obsahuje hodnoty LR_LOADTRANSPARENT a LR_LOADMAP3DCOLORS, LRLOADTRANSPARENT má vyššiu prioritu. Avšak položka farba nahrádza s COLOR_3DFACE, ako COLOR_WINDOW.
LR_MONOCHROME	Načíta obraz v čiernej a bielej.
LR_SHARED	Akcie obrázok rukoväť Ak obrázok je načítaný viackrát. Ak LR_SHARED nie je nastavený, druhé volanie LoadImage pre ten istý zdroj načítajte obrázok znova a vrátia rôzne rukoväť. Nepoužívajte LR_SHARED pre obrázky, ktoré majú neštandardný veľkosti, ktorá sa môže meniť po naložení, alebo že sú načítané zo súboru. Systém Windows 95 a Windows 98: Funkcia nájde prvý obraz s názvom požadovanému prostriedku v cache, bez ohľadu na veľkosť požadovaných.
LR_VGACOLOR	Používa pravda farieb VGA.

Note:

Ak funkciu podarí, vrátená hodnota je rukoväť novo načítať obrázok.

Ak funkcia zlyhá, vrátená hodnota je NULL. Získajte rozšírené informácie o chybách, volajte na číslo GetLastError.

Poznámky

Až budete hotoví, pomocou bitovej mape, kurzora alebo ikonu, môžete uvoľniť jej pridružené pamäte pomocou volania z funkcie v nasledujúcej tabuľke.

Systém automaticky odstráni tieto zdroje, keď ukončí proces, ktorý ich vytvoril, však volá funkciu vhodné šetrí pamäť a zmenšuje veľkosť pracovnej súpravy procesu.

Windows CE: Parametre cxDesired a cyDesired musia byť nula pre IMAGE_BITMAP.

Windows CE nepodporuje strečink a zmenšenie ikon.

FuLoad parameter musí byť nula (== LR_DEFAULTCOLOR).

Ak sú zamerané na platformu, ktorá nepodporuje kurzorov myši, hodnoty SM_CXCURSOR a SM_CYCURSOR nie je možné zadať parametre cxDesired a cyDesired a IMAGE_CURSOR nie je možné zadať pre uType parameter.

Ak sú zamerané na platforme, ktorá podporuje kurzorov myši, môžete zadať SM_CXCURSOR a SM_CYCURSOR v cxDesired a parametrami cyDesired a IMAGE_CURSOR v uType parameter.

Stručné informácie

nbsp; Systém Windows &NT: vyžaduje verziu 4.0 alebo novšiu.
Windows:Vyžaduje systém Windows 95 alebo novším.
Windows CE:Vyžaduje verziu 1.0 alebo novšiu verziu.
Hlavičky:Deklarovaný v súbore winuser.h.
Importovať knižnica:Použiť user32.lib.
Unicode:Implementovaný ako Unicode, ANSI verzia v systéme Windows NT.

Pozri tiež

Zdroje prehľad, Resource funkcie, CopyImage, GetSystemMetrics LoadBitmap, LoadCursor, LoadIcon

Index