LoadImage

De functie LoadImage ladingen een pictogram, cursor of bitmap.

HANDLE LoadImage) HINSTANCE  hinst, / / handvat van de instantie die de afbeelding bevat.LPCTSTRlpszName, / / naam of id van afbeeldingUINTuType, / / type van beeldintcxDesired, / / gewenste breedte intcyDesired, / / gewenste hoogteUINTfuLoad / / vlaggen laden);
 

Parameters

hinst
Omgaan met een exemplaar van de module waarin de afbeelding moet worden geladen. Voor het laden van een OEM-afbeelding, moet u deze parameter instellen op nul.
lpszName
Ingang naar de afbeelding te laden.

Als de parameter hinst niet-NULL is en de fuLoad -parameter geen LR_LOADFROMFILE bevat, is lpszName een aanwijzer naar een op null eindigende tekenreeks die de naam van de bron van de afbeelding in de module hinst bevat.

Als hinst NULL is en LR_LOADFROMFILE niet is opgegeven, de lage-orde woord van deze parameter moet de id van de OEM-afbeelding te laden. De afbeelding van OEM-id's worden gedefinieerd in WINUSER.H en hebben de volgende prefixen:
Voorvoegsel Betekenis
OBM_ OEM bitmaps
OIC_ OEM pictogrammen
OCR_ OEM cursors

Als de parameter fuLoad de waarde LR_LOADFROMFILE bevat, is lpszName de naam van het bestand waarin de afbeelding.

uType
Hiermee geeft u het type afbeelding moet worden geladen. Deze parameter kan een van de volgende waarden worden:
Waarde Betekenis
IMAGE_BITMAP Een bitmap geladen.
IMAGE_CURSOR Ladingen een cursor.
IMAGE_ICON Ladingen een pictogram.

cxDesired
De breedte, in pixels, van het pictogram of de cursor. Als deze parameter nul is en de parameter fuLoad LR_DEFAULTSIZE is, gebruikt de functie de SM_CXICON of SM_CXCURSOR systeem metrische waarde de breedte wilt instellen. Als deze parameter nul is en LR_DEFAULTSIZE niet wordt gebruikt, gebruikt de functie de werkelijke resource-breedte.
cyDesired
Hiermee geeft u de hoogte, in pixels, van het pictogram of de cursor. Als deze parameter nul is en de parameter fuLoad LR_DEFAULTSIZE is, gebruikt de functie de SM_CYICON of SM_CYCURSOR systeem metrische waarde om de hoogte te stellen. Als deze parameter nul is en LR_DEFAULTSIZE niet wordt gebruikt, gebruikt de functie de werkelijke resource hoogte.
fuLoad
Hiermee geeft u een combinatie van de volgende waarden:
Waarde Betekenis
LR_DEFAULTCOLOR De standaardmarkering; het doet niets. Alles wat het betekent is "niet LR_MONOCHROME".
LR_CREATEDIBSECTION Wanneer de parameter uType IMAGE_BITMAP geeft, veroorzaakt de functie voor het retourneren van een DIB sectie bitmap in plaats van een compatibele bitmap. Deze vlag is handig voor het laden van een bitmap zonder het toe te wijzen aan de kleuren van het beeldscherm.
LR_DEFAULTSIZE De breedte of hoogte van de opgegeven systeem metrische waarden voor cursors of pictogrammen, wordt gebruikt als de cxDesired of cyDesired waarden zijn ingesteld op nul. Als deze vlag niet is opgegeven en cxDesired en cyDesired zijn ingesteld op nul, gebruikt de functie de werkelijke resource grootte. Als de resource meerdere afbeeldingen bevat, gebruikt de functie de grootte van de eerste afbeelding.
LR_LOADFROMFILE Ladingen van de afbeelding uit het bestand dat is opgegeven door de parameter lpszName . Als deze vlag niet is opgegeven, is lpszName de naam van de resource.
LR_LOADMAP3DCOLORS Doorzoekt de kleurentabel voor de afbeelding en de volgende grijstinten vervangt door de bijbehorende 3D-kleur:

Kleur Vervangen door
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 De kleurwaarde van de eerste pixel in de afbeelding opgehaald en de overeenkomstige vermelding in de kleurentabel vervangt door de standaard vensterkleur (COLOR_WINDOW). Alle pixels in de afbeelding die gebruikmaken van die vermelding worden de standaard vensterkleur. Deze waarde geldt alleen voor afbeeldingen die overeenkomstige kleurentabellen een.

Als fuLoad zowel de LR_LOADTRANSPARENT als LR_LOADMAP3DCOLORS waarden bevat, voorrang LRLOADTRANSPARENT. Echter, de lijstingang kleur wordt vervangen met COLOR_3DFACE in plaats van COLOR_WINDOW.

LR_MONOCHROME Ladingen van de afbeelding in zwart-wit.
LR_SHARED Deelt de greep van de afbeelding als de afbeelding meerdere keren wordt geladen. Als LR_SHARED niet is ingesteld, zal een tweede oproep te LoadImage voor dezelfde resource de afbeelding opnieuw laden en retourneren een verschillende handvat.

Gebruik geen LR_SHARED voor afbeeldingen die niet-standaard maten een, dat na het laden kan veranderen, of die zijn geladen uit een bestand.

Windows 95 en Windows 98: De functie vindt de eerste afbeelding met de naam van de aangevraagde bron in de cache, ongeacht de grootte opgevraagd.

LR_VGACOLOR Gebruikt ware VGA kleuren.

Retourwaarden

Als de functie slaagt, is de geretourneerde waarde de greep van de nieuw geladen afbeelding.

Als de functie mislukt, is de retourwaarde NULL. Te krijgen uitgebreide foutinformatie, Bel GetLastError.

Opmerkingen

Wanneer u gereed met de bitmap, cursor of pictogram bent, kunt u de bijbehorende geheugen vrijgeven door te bellen naar een van de functies in de volgende tabel.

Resource Release-functie
Bitmap ObjectVerwijderen (DeleteObject)
Cursor DestroyCursor
Pictogram DestroyIcon

Het systeem automatisch verwijdert deze bronnen wanneer eindigt het proces waardoor ze zijn gemaakt, echter de juiste functie bespaart geheugen en vermindert de grootte van de werkset van het proces.

Windows CE: De cxDesired en cyDesired parameters moet nul voor IMAGE_BITMAP.

Windows CE ondersteunt geen stretching en krimpen van pictogrammen.

De parameter fuLoad moet nul (== LR_DEFAULTCOLOR).

Als u zich richt op een platform dat biedt geen ondersteuning voor muiscursors, u niet de SM_CXCURSOR en SM_CYCURSOR waarden opgeven in de cxDesired en cyDesired parameters, en u geen IMAGE_CURSOR opgeven voor de parameter uType.

Als u zich richt op een platform dat muiscursors ondersteunt, kunt u SM_CXCURSOR en SM_CYCURSOR in de cxDesired en cyDesired parameters en IMAGE_CURSOR in de parameter uType.

Syntaxisinfo

nbsp;áWindows &NT: versie 4.0 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Versie 1.0 of hoger vereist.
Header:Verklaard in winuser.h.
Bibliotheek importeren:User32.lib gebruiken.
Unicode:Ge´mplementeerd als Unicode en ANSI-versies van Windows NT.

Zie ook

Bronnen overzicht, Resource functioneert, CopyImage, GetSystemMetrics, LoadBitmap, LoadCursor, LoadIcon

Index