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);
Valore | Significato |
---|---|
IMAGE_BITMAP | Copia di una bitmap. |
IMAGE_CURSOR | Copia di un cursore. |
IMAGE_ICON | Un'icona di copia. |
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. |
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.
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.
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.
Panoramica delle risorse, le funzioni di risorsa, LoadImage
Rimedio: Inserire il CD-ROM CD di MSDN Library.