CopyImage

Funksjonen CopyImage oppretter eit nytt biletvindauge (ikonet, markøren eller punktgrafikk) og kopierer attributtene for det angitte bildet til den nye. Hvis det er nødvendig, strekker funksjonen biter å passe den ønskede størrelsen til det nye bildet.

Håndtak-CopyImage) HÅNDTERE  hImage, / / håndtere til bildet du vil kopiereUINTuType, / / type av bildet for å kopiereIntcxDesired, / / ønsket bredden på nytt bileteIntcyDesired, / / ønsket høyde av nye bildeUINTfuFlags / / kopi flagg);
 

Parametere

hinst

Håndtere til en forekomst av modulen som inneholder bildet som skal kopieres.

uType

Angir hvilken type bilde som skal kopieres. Denne parameteren kan være en av følgende verdier:

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

cxDesired

Angir den ønskede bredden, i piksler, på bildet.

cyDesired

Angir ønskede høyden på bildet i piksler.

fuFlags

Angir en kombinasjon av følgende verdier:

Verdi	Betydning
LR_COPYDELETEORG	Hvis du sletter det opprinnelige bildet etter oppretter kopien.
LR_COPYRETURNORG	Lager en nøyaktig kopi av bildet, ignorerer parameterne cxDesired og cyDesired.
LR_MONOCHROME	Oppretter et nytt svart/hvitt-bilde.
LR_COPYFROMRESOURCE	Prøver å laste en ikonet eller markøren ressurs fra den opprinnelige ressursfilen i stedet for å kopiere gjeldende bilde. Dette er nyttig for å opprette en kopi med forskjellige størrelser når ressursfilen inneholder flere størrelser av ressursen. Uten dette flagget strekker CopyImage opprinnelige bildet til den nye størrelsen. Hvis dette flagget er angitt, bruker CopyImage størrelsen i ressursfilen nærmest ønsket størrelse. Dette vil lykkes bare hvis hImage ble lastet inn av LoadIcon eller LoadCursor, eller av LoadImage med LR_SHARED-flagg.

Returverdier

Hvis funksjonen lykkes, er returverdien referanse til det nye biletet.

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

Merknader

Når du er ferdig med å bruke til ressursen, kan du frigi tilknyttede minnet av en av funksjonene i følgende tabell.

Systemet sletter automatisk ressursen når prosessen avsluttes, men kaller den relevante funksjonen sparer du minne, og reduserer størrelsen på prosessens arbeidssett.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.5 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Som ikke støttes.
Topptekst:Deklarert i winuser.h.
Importere biblioteket:Bruk user32.lib.

Se også

Oversikt over ressurser, ressurs funksjoner, LoadImage

Index