UDF > WinAPIEx > GDI > BitMaps >


_WinAPI_CopyImage

Crée une nouvelle image (icône, curseur, ou bitmap) et copie les attributs d'une image donnée dans la nouvelle

#include <WinAPIGdi.au3>
_WinAPI_CopyImage ( $hImage [, $iType = 0 [, $iXDesiredPixels = 0 [, $iYDesiredPixels = 0 [, $iFlags = 0]]]] )

Paramètres

$hImage Handle de l'image à copier.
$iType [optionnel] Spécifie le type d'image à copier. Ce paramètre peut prendre l'une des valeurs suivantes:
    $IMAGE_BITMAP (par défaut)
    $IMAGE_CURSOR
    $IMAGE_ICON
$iXDesiredPixels [optionnel] Spécifie la largeur désirée, en pixels, de l'image. Si c'est zéro (par défaut), l'image retournée aura la même largeur que celle d'origine $hImage.
$iYDesiredPixels [optionnel] Spécifie la hauteur désirée, en pixels, de l'image. Si c'est zéro (par défaut), l'image retournée aura la même hauteur que celle d'origine $hImage.
$iFlags [optionnel] Ce paramètre peut être une ou plusieurs des valeurs suivantes.
$LR_DEFAULTCOLOR (par défaut)
$LR_COPYDELETEORG
$LR_COPYFROMRESOURCE
$LR_COPYRETURNORG
$LR_CREATEDIBSECTION
$LR_DEFAULTSIZE
$LR_MONOCHROME

Valeur de retour

Succès: Retourne le handle de l'image nouvellement créé.
Échec: Retourne 0, appelez _WinAPI_GetLastError() pour obtenir des informations sur l'erreur.

Remarque

Lorsque vous avez fini d'utiliser la ressource, vous pouvez libérer sa mémoire associée en appelant la fonction _WinAPI_DeleteObject() respectivement pour les bitmaps, curseurs, ou les icônes.
Le système supprime automatiquement la ressource lorsque son processus se termine, cependant, l'appel de la fonction appropriée économise de la mémoire et diminue la taille de la zone de travail du processus.

Voir aussi

Consultez CopyImage dans la librairie MSDN.