CopyImage

Die CopyImage -Funktion erzeugt ein neues Bild (Symbol, Cursor oder Bitmap) und die Attribute des angegebenen Image in das neue kopiert. Falls erforderlich, erstreckt sich die Funktion der Bits, um die gewünschte Größe des neuen Bildes.

Griff CopyImage) BEHANDELN  hImage, / / handle auf das Bild um zu kopierenUINTuType, / / Typ des Bildes zu kopierenintcxDesired, / / gewünschter Breite des neuen BildesintcyDesired, / / gewünschten Höhe des neuen BildesUINTFuFlags / / Flags kopieren);
 

Parameter

hinst
Behandeln Sie, um eine Instanz des Moduls mit dem Abbild kopiert werden soll.
uType
Gibt den Typ der Bild kopiert werden. Dieser Parameter kann eine der folgenden Werte sein:
Wert Bedeutung
IMAGE_BITMAP Kopiert eine bitmap.
IMAGE_CURSOR Kopiert einen cursor.
IMAGE_ICON Kopiert ein Symbol.

cxDesired
Gibt die gewünschte Breite in Pixel des Bildes.
cyDesired
Gibt die gewünschte Höhe in Pixel des Bildes.
fuFlags
Gibt eine Kombination der folgenden Werte:
Wert Bedeutung
LR_COPYDELETEORG Löscht das Originalbild nach dem Erstellen der Kopie.
LR_COPYRETURNORG Erstellt eine genaue Kopie des Bildes, ignorieren die Parameter CxDesired und cyDesired.
LR_MONOCHROME Erstellt ein neues monochromes Bild.
LR_COPYFROMRESOURCE Versucht, eine Symbol oder Cursor-Ressource von der ursprünglichen Ressource-Datei, anstatt einfach kopiert das aktuelle Bild neu zu laden. Dies ist nützlich für eine unterschiedlich große Kopie erstellen, wenn die Ressourcendatei mehrere Größen der Ressource enthält. Ohne dieses Flag streckt CopyImage das ursprüngliche Bild auf die neue Größe. Wenn dieses Flag festgelegt ist, verwendet CopyImage die Größe in der Ressourcendatei, die gewünschte Größe am nächsten.

Dies wird nur gelingen, wenn hImage mit dem LR_SHARED-Flag von LoadIcon oder LoadCursor, oder vom LoadImage geladen wurde.


Rückgabewerte

Wenn die Funktion erfolgreich ist, ist der Rückgabewert das Handle für das neu erstellte Bild.

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL. Rufen Sie Fehlerinformationen verlängert bekommen, GetLastError.

Bemerkungen

Wenn Sie fertig mit der Ressource sind, können Sie seine zugeordneten Arbeitsspeicher freigeben, indem Sie eine der Funktionen in der folgenden Tabelle.

Ressourcen Funktion freigeben
Bitmap DeleteObject
Cursor DestroyCursor
Symbol DestroyIcon

Das System löscht automatisch die Ressource, wenn der Prozess beendet wird, jedoch die entsprechende Funktion aufgerufen spart Arbeitsspeicher und reduziert die Größe des Workingsets des Prozesses.

QuickInfo

&Nbsp; Windows NT: erfordert Version 3.5 oder höher.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Nicht unterstützt.
Header:In winuser.h deklarierten.
Importieren Bibliothek:Verwenden Sie user32.lib.

Siehe auch

Übersicht über Ressourcen, Ressourcen Funktionen, LoadImage

Index