CopyImage

La funzione CopyImage crea una nuova immagine (icona, cursore o bitmap) e copia gli attributi dell'immagine specificata a quello nuovo. Se necessario, la funzione si estende i bit per adattarsi alle dimensioni desiderata della nuova immagine.

( HANDLE CopyImage GESTIRE  hImage, / / handle all'immagine per copiareUINTuType, / / tipo di immagine da copiareintcxDesired, / / larghezza della nuova immagine desiderataintcyDesired, / / altezza della nuova immagine desiderataUINTfuFlags / / copia bandiere);
 

Parametri

hinst

Gestire a un'istanza del modulo contenente l'immagine da copiare.

uType

Specifica il tipo di immagine da copiare. Questo parametro può essere uno dei seguenti valori:

Valore	Significato
IMAGE_BITMAP	Copia di una bitmap.
IMAGE_CURSOR	Copia di un cursore.
IMAGE_ICON	Un'icona di copia.

cxDesired

Specifica la larghezza desiderata, in pixel, dell'immagine.

cyDesired

Specifica l'altezza desiderata, in pixel, dell'immagine.

fuFlags

Specifica una combinazione dei seguenti valori:

Valore	Significato
LR_COPYDELETEORG	Elimina l'immagine originale dopo aver creato la copia.
LR_COPYRETURNORG	Crea una copia esatta dell'immagine, ignorando i parametri cxDesired e cyDesired.
LR_MONOCHROME	Crea una nuova immagine monocromatica.
LR_COPYFROMRESOURCE	Prova a ricaricare una risorsa icona o il cursore dal file risorsa originale, anziché semplicemente copiando l'immagine attuale. Questo è utile per creare una copia di dimensioni diverse, quando il file di risorse contiene molteplici dimensioni della risorsa. Senza questa bandiera, CopyImage si estende l'immagine originale alla nuova dimensione. Se questo flag è impostato, CopyImage utilizza la dimensione nel file di risorse più vicino alla dimensione desiderata. Questo avrà successo solo se hImage è stato caricato da LoadIcon o LoadCursor, o LoadImage con il flag LR_SHARED.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito è l'handle per l'immagine appena creata.

Se la funzione ha esito negativo, il valore restituito è NULL. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

Quando si è terminato di utilizzare la risorsa, si può rilasciare la memoria associata chiamando una delle funzioni nella tabella seguente.

Il sistema elimina automaticamente la risorsa quando termina il processo, tuttavia, chiamando la funzione appropriata conserva la memoria e riduce le dimensioni del set di lavoro del processo.

Descrizione

nbsp; Windows &NT: richiede una versione 3.5 o successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Non supportato.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.

Vedi anche

Panoramica delle risorse, le funzioni di risorsa, LoadImage

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index