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.

Ressurs Release-funksjonen
Punktgrafikk SlettObjekt
Markøren DestroyCursor
Ikonet DestroyIcon

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