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.

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