LoadImage

Funksjonen LoadImage laster et ikon, markøren eller punktgrafikk.

Håndtak-LoadImage) HINSTANCE  hinst, / / håndtaket på forekomsten som inneholder bildetLPCTSTRlpszName, / / navn eller identifikasjon av bildeUINTuType, / / type av bildeIntcxDesired, / / ønsket bredde intcyDesired, / / ønsket høydeUINTfuLoad / / load flagg);
 

Parametere

hinst

Håndtere til en forekomst av modulen som inneholder bildet som skal lastes inn. Laste inn et OEM-bilde, setter du denne parameteren til null.

lpszName

Håndtere til bildet for å laste inn.

Hvis hinst -parameteren er ikke-NULL, og inkluderer ikke fuLoad parameteren LR_LOADFROMFILE, lpszName , er en peker til en null-terminert streng som inneholder navnet på ressursen bildet i hinst -modulen.

Hvis hinst er NULL og LR_LOADFROMFILE ikke er angitt, signifikante ordet av denne parameteren må være en identifikator for OEM-bildet for å laste inn. Identifikatorer for OEM-bildet er definert i WINUSER.H og har følgende prefikser:

Prefikset	Betydning
OBM_	OEM-punktgrafikk
OIC_	OEM-ikoner
OCR_	OEM-markører

Hvis parameteren fuLoad inneholder verdien LR_LOADFROMFILE, er lpszName navnet på filen som inneholder bildet.

uType

Angir hvilken type bilde kan lastes inn. Denne parameteren kan være en av følgende verdier:

Verdi	Betydning
IMAGE_BITMAP	Laster inn punktgrafikk.
IMAGE_CURSOR	Laster en markør.
IMAGE_ICON	Laster et ikon.

cxDesired

Angir bredden i piksler, på ikonet eller markøren. Hvis denne parameteren er null, og parameteren fuLoad er LR_DEFAULTSIZE, bruker funksjonen den SM_CXICON eller SM_CXCURSOR systemet metrisk verdien for å angi bredden. Hvis denne parameteren er null, og LR_DEFAULTSIZE som ikke brukes, bruker funksjonen faktiske ressurs-bredde.

cyDesired

Angir høyden, i piksler, på ikonet eller markøren. Hvis denne parameteren er null, og parameteren fuLoad er LR_DEFAULTSIZE, bruker funksjonen den SM_CYICON eller SM_CYCURSOR systemet metrisk verdien for å angi høyden. Hvis denne parameteren er null, og LR_DEFAULTSIZE som ikke brukes, bruker funksjonen den faktiske ressursen høyden.

fuLoad

Angir en kombinasjon av følgende verdier:

Verdi	Betydning
LR_DEFAULTCOLOR	Standardflagget; Det gjør ingenting. Det betyr bare "ikke LR_MONOCHROME".
LR_CREATEDIBSECTION	Når uType -parameteren angir IMAGE_BITMAP, fører til at funksjonen til å returnere en delen DIB-punktgrafikk i stedet for kompatibel punktgrafikk. Dette flagget er nyttig for å laste inn punktgrafikk uten å tilordne det til fargene visningsenhetens.
LR_DEFAULTSIZE	Bruker bredden eller høyden angis av systemet metrisk verdiene for markører eller ikoner, hvis verdiene for cxDesired eller cyDesired er satt til null. Hvis dette flagget ikke er angitt, og cxDesired og cyDesired er satt til null, bruker funksjonen den faktiske ressursen størrelsen. Hvis ressursen inneholder flere bilder, bruker funksjonen størrelsen på det første bildet.
LR_LOADFROMFILE	Laster inn bildet fra filen som er angitt av parameteren lpszName . Hvis dette flagget ikke er angitt, er lpszName navnet på ressursen.
LR_LOADMAP3DCOLORS	Fargetabell for bildet og erstatter de følgende gråtonene med de tilsvarende 3D-fargen:

	Farge	Erstattet med
	Mørk grå, RGB(128,128,128)	COLOR_3DSHADOW
	Gray, RGB(192,192,192)	COLOR_3DFACE
	Lt Gray, RGB(223,223,223)	COLOR_3DLIGHT

LR_LOADTRANSPARENT	Henter du fargeverdien for første piksel i bildet, og erstatter den tilsvarende oppføringen i fargetabellen med standard Vindusfarge (COLOR_WINDOW). Alle bildepunktene i bildet som bruker av oppføringen bli vinduet standardfargen. Denne verdien gjelder bare for bilder som har tilsvarende fargetabeller. Hvis fuLoad inneholder både LR_LOADTRANSPARENT-og LR_LOADMAP3DCOLORS, forrang LRLOADTRANSPARENT. Tabellelementet farge er imidlertid erstattet med COLOR_3DFACE i stedet for COLOR_WINDOW.
LR_MONOCHROME	Laster inn bildet i svart-hvitt.
LR_SHARED	Deler bildet håndtaket hvis bildet legges inn flere ganger. Hvis LR_SHARED ikke er angitt, vil et andre kall til LoadImage for den samme ressursen laste inn bildet på nytt og gå tilbake en annen håndtaket. Ikke bruk LR_SHARED for bilder som har ikke-standard størrelser, som kan endres etter lasting, eller som er lastet inn fra en fil. Windows 95 og Windows 98: Funksjonen finner det første bildet med det forespurte ressursnavnet i hurtigbufferen, uavhengig av størrelsen forespurt.
LR_VGACOLOR	Bruker ekte VGA-farger.

Returverdier

Hvis funksjonen er vellykket, er returverdien håndtaket av nylig lastet bildet.

Hvis funksjonen mislykkes, er verdien som returneres NULL. Til å vise utvidet feilinformasjon, kan du ringe GetLastError.

Merknader

Når du er ferdig med å bruke punktgrafikk, markøren, eller ikon, kan du frigi tilknyttede minnet av en av funksjonene i følgende tabell.

Systemet sletter automatisk disse ressursene når du avslutter prosessen som opprettet dem, men kaller den relevante funksjonen sparer du minne, og reduserer størrelsen på prosessens arbeidssett.

Windows CE: Parameterne cxDesired og cyDesired må være null for IMAGE_BITMAP.

Windows CE støtter ikke strekker seg og reduksjon av ikoner.

Parameteren fuLoad må være null (== LR_DEFAULTCOLOR).

Hvis du bruker en plattform som ikke støtter musepekere, du kan ikke angi SM_CXCURSOR- og SM_CYCURSOR i parameterne cxDesired og cyDesired , og du kan ikke angi IMAGE_CURSOR for parameteren uType.

Hvis du bruker en plattform som støtter musepekere, kan du angi SM_CXCURSOR og SM_CYCURSOR i cxDesired og cyDesired -parametere og IMAGE_CURSOR i parameteren uType.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 4.0 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Krever versjon 1.0 eller senere.
Topptekst:Deklarert i winuser.h.
Importere biblioteket:Bruk user32.lib.
Unicode:Implementert som Unicode- og ANSI-versjoner på Windows NT.

Se også

Oversikt over ressurser, ressurs fungerer, CopyImage, GetSystemMetrics, LoadBitmap, LoadCursor, LoadIcon

Index