GdipGetMetafileHeaderFromWmf()



Syntaxe
Resultat.i = GdipGetMetafileHeaderFromWmf(hWmf.i, @WmfPlaceableFileHeader, @header.MetafileHeader)

Paramètres

hWmf.i

[in] Handle de la fenêtre du métafichier.

wmfPlaceableFileHeader.WmfPlaceableFileHeader

[in] Variable de type WmfPlaceableFileHeader qui spécifie un preheader précédant l'en-tête de métafichier. Les métafichiers positionnables (Placeable metafile) sont des fichiers WMF qui contiennent un preheader précédant l'en-tête de métafichier. Le preheader contient des informations complémentaires pour l'en-tête du métafichier. Ce paramètre ne doit pas être nul mais doit comporter l'ensemble des éléments du préheader placeable, y compris la checksum.

header.MetafileHeader

[out] Variable de type MetafileHeader qui recevra les données du header définissant les attributs du métafichier.

Description

Cette fonction permet de retrouver les valeurs du header définissant les attributs du métafichier au format WMF à partir d'un Handle de fenêtre d'un métafichier.

La structure MetafileHeader utilisée par le paramètre header.MetafileHeader définie les éléments retrouvés par la fonction.
La structure WmfPlaceableFileHeader doit comporter les éléments du préheader, y compris la checksum. L'élément WmfPlaceableFileHeader\Hmf.w doit être nul ainsi que l'élément WmfPlaceableFileHeader\Reserved.l. Pour le calcul de la checksum, reportez-vous à l'exemple.
L'exemple ouvre une boite de dialogue permettant de sélectionner le fichier wmf de son choix. Le métafichier est affiché en réduisant la taille si une des dimensions est supérieure à 200 pixels (la proportionnalité est gardée). La fonction GdipGetHemfFromMetafile() utilisée verrouille le métafichier, c'est pour cela qu'une copie de l'image est faite pour utiliser cette fonction. Les principaux éléments du header sont affichés dans une ListIconGadget.
Pour charger le métafichier, utilisez la fonction GdipCreateMetafileFromWmfFile() car l'utilisation de la fonction GdipCreateMetafileFromFile() fera échouer la fonction GdipGetMetafileHeaderFromWmf().

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