CopyImage

Funcția CopyImage creează o imagine nouă (pictograma, cursorul sau bitmap) și copiază atributele imaginea specificate pentru unul nou. Dacă este necesar, funcția se întinde de biți pentru a se potrivi la dimensiunea dorită de noua imagine.

( CopyImage MÂNER MÂNER  hImage, / / manipula imagini pentru a copiaUINTuType, / / tipul de imagine pentru a copiaintcxDesired, / / dorit lățime de imagine nouăintcyDesired, / / înălțime de noua imagine de doritUINTfuFlags / / copia steaguri);
 

Parametrii

hinst
Mâner de instanta modulului care conține imaginea de copiat.
uType
Specifică tipul de imagine pentru a fi copiate. Acest parametru poate fi una dintre următoarele valori:
Valoarea Sensul
IMAGE_BITMAP Copiază un bitmap.
IMAGE_CURSOR Copiază un cursor.
IMAGE_ICON Copiază o pictogramă.

cxDesired
Specifică lățimea dorită, în pixeli, a imaginii.
cyDesired
Specifică înălțimea dorită, în pixeli, a imaginii.
fuFlags
Specifică o combinație de următoarele valori:
Valoarea Sensul
LR_COPYDELETEORG Șterge imaginea originală după crearea copie.
LR_COPYRETURNORG Creează o copie exactă a imaginii, ignorând parametrii cxDesired și cyDesired.
LR_MONOCHROME Creează o nouă imagine monocrom.
LR_COPYFROMRESOURCE Încearcă să reîncărcați o resursă pictograma sau cursorul la fișierul original de resurse, mai degrabă decât pur și simplu copiați imaginea curentă. Acest lucru este util pentru a crea o copie de dimensiuni diferite atunci când fișierul resursă conține mai multe dimensiuni de resurse. Fără acest flag, CopyImage se întinde imaginea originală la dimensiunea nou. Dacă acest flag este setat, CopyImage utilizează dimensiunea în fișierul de resurse de cel mai apropiat de dimensiunea dorită.

Acest lucru va reuși doar dacă hImage a fost încărcat de LoadIcon sau LoadCursor, sau LoadImage cu LR_SHARED de pavilion.


Valorile întroarse

Dacă funcția reușește, valoarea returnată este ghidajul la imaginea nou create.

Dacă funcția nu reușește, valoarea returnată este NULL. Pentru a obține extins informa?ii eroare, apel GetLastError.

Observații

Când ați terminat de utilizarea de resurse, aveți posibilitatea să lansați memorie asociate de una din funcțiile de asteptare în tabelul următor.

Resurse Funcția de presă
Bitmap ȘtergereObiect
Cursorul DestroyCursor
Pictogramă DestroyIcon

Sistemul șterge automat resursa atunci când se termină procesul, cu toate acestea, apel funcția corespunzătoare economisește memorie și Micșorează dimensiunea lui procesul set de lucru.

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.5 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Neacceptat.
Antet:A declarat în winuser.h.
Import Biblioteca:Utilizarea user32.lib.

A se vedea, de asemenea

Ansamblu de resurse, resurse funcții, LoadImage

Index