CopyImage

De functie CopyImage maakt een nieuwe afbeelding (pictogram, cursor of bitmap) en de kenmerken van de opgegeven afbeelding wordt gekopieerd naar de nieuwe. Indien nodig, de functie strekt zich de bits aan de gewenste grootte van de nieuwe afbeelding.

HANDLE CopyImage) OMGAAN met  hImage, / / verwerken naar de afbeelding om te kopiŽrenUINTuType, / / type van afbeelding om te kopiŽrenintcxDesired, / / gewenste breedte van de nieuwe afbeeldingintcyDesired, / / gewenste hoogte van de nieuwe afbeeldingUINTfuFlags / / kopiŽren van vlaggen);
 

Parameters

hinst
Omgaan met een exemplaar van de module waarin de afbeelding moet worden gekopieerd.
uType
Hiermee geeft u het type afbeelding moet worden gekopieerd. Deze parameter kan een van de volgende waarden worden:
Waarde Betekenis
IMAGE_BITMAP Een bitmap gekopieerd.
IMAGE_CURSOR Een cursor wordt gekopieerd.
IMAGE_ICON Gekopieerd van een pictogram.

cxDesired
Hiermee geeft u de gewenste breedte, in pixels, van de afbeelding.
cyDesired
Hiermee geeft u de gewenste hoogte, in pixels, van de afbeelding.
fuFlags
Hiermee geeft u een combinatie van de volgende waarden:
Waarde Betekenis
LR_COPYDELETEORG Hiermee verwijdert u de oorspronkelijke afbeelding na het maken van het exemplaar.
LR_COPYRETURNORG Hiermee maakt u een exacte kopie van de afbeelding, negeren de parameters cxDesired en cyDesired.
LR_MONOCHROME CreŽert een nieuwe zwart-wit beeld.
LR_COPYFROMRESOURCE Probeert te laden van een pictogram of cursor-bron van het oorspronkelijke bronbestand in plaats van simpelweg kopiŽren van de huidige afbeelding. Dit is handig voor het maken van een kopie van verschillen in de grootte wanneer het bronbestand meerdere maten van de resource bevat. Zonder deze vlag, CopyImage strekt zich uit de oorspronkelijke afbeelding aan de nieuwe grootte. Als deze vlag is ingesteld, gebruikt CopyImage de grootte in het dichtst bij de gewenste grootte bronbestand.

Dit lukt alleen als hImage door LoadIcon of LoadCursor, of door LoadImage was geladen met de vlag LR_SHARED.


Retourwaarden

Als de functie slaagt, is de geretourneerde waarde de ingang naar de zojuist gemaakte afbeelding.

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

Opmerkingen

Wanneer u gereed met de bron 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 de resource automatisch wordt verwijderd wanneer het proces wordt beŽindigd, echter de juiste functie bespaart geheugen en vermindert de grootte van de werkset van het proces.

Syntaxisinfo

nbsp;†Windows &NT: versie 3.5 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Niet-ondersteunde.
Header:Verklaard in winuser.h.
Bibliotheek importeren:User32.lib gebruiken.

Zie ook

Bronnen overzicht, Resource functies, LoadImage

Index