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.

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