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.

Risorsa Funzione di rilascio
Bitmap DeleteObject
Cursore DestroyCursor
Icona DestroyIcon

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