GdipGetHemfFromMetafile()



Syntaxe
Resultat.i = GdipGetHemfFromMetafile(*metafile, @hEmf.i)

Paramètres

*metafile

[in] Pointeur sur un objet metafile.

hEmf.i

[out] hEmf recevra le Handle de la fenêtre du métafichier (format EMF) passé en paramètre (paramètre *metafile).

Description

Cette fonction est classé par Micosoft dans les fonctions Graphics mais je l'ai classée dans les métafiles.

Cette fonction permet de retrouver le Handle de la fenêtre du métafichier (format EMF) associée au métafichier passé en paramètre.

Cette fonction positionne le MetaFile dans un état invalide. Le programmeur est responsable de la destruction du Handle en appelant la fonction DeleteEnhMetaFile (API de la Dll gdi32).
Si GdipGetHemfFromMetafile() est utilisé en coordination avec la fonction GDI+ GdipCreateMetafileFromEmf(), l'API DeleteEnhMetaFile doit être utilisée si le paramètre deleteEmf est mis à #False, sinon l'API ne doit pas être utilisée (elle échoue).
Le premier exemple utilise un fichier EMF(existant sur le disque et créé avec le type (EmfType)) #EmfTypeEmfPlusDual et affiche le contenu (2 cercles pleins de couleur différente) et le Handle est supprimé avec l'API DeleteEnhMetaFile (deleteEmf vaut #False).
Le second exemple est celui de la fonction GdipCreateMetafileFromEmf() (c'est presque le même code) mais le Handle du métafichier est automatiquement supprimé lors de la destruction du métafichier (deleteEmf vaut #True).
 

Résultat de la fonction

Si la fonction réussit, elle retourne #Ok qui est une constante de l'énumération status.
Si la fonction échoue, elle retourne une des autres valeurs de l'énumération status.

PB - OS

PureBasic v4.30 bêta 4 (Windows - x86)
Testé avec Windows Vista édition familiale Premium