GdipPlayMetafileRecord()


Syntaxe
Resultat.i = GdipPlayMetafileRecord(*metafile, recordType.i, flags.i, dataSize.i, *Datas.byte)

Paramètres
*metafile

[in] Pointeur sur un objet metafile existant.

recordType.i

[in] Elément de l'énumération EmfPlusRecordType qui spécifie le type d'enrtegistrement du métafichier qui sera lu.

flags.i

[in] Ensemble de drapeaux qui spécifient les attributs de l'enregistrement.

dataSize.i

[in] Nombre entier positif qui indique le nombre d'octets dans les données de l'enregistrement (paramètre Datas).

*Datas

[in] Pointeur sur un tableau d'octets qui contient les données de l'enregistrement.

Description

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

Cette fonction est employée en même temps que les fonctions d'énumération des métafichiers. Ces fonctions d'énumération appellent une procédure Callback pour chaque enregistrement du métafichier spécifié. GdipPlayMetafileRecord() est utilisée dans la callback d'énumération.

Cette fonction permet de lire un enregistrement dans un métafichier et de l'afficher. Il est possible d'afficher partiellement ou complètement les enregistrements du métafichier.
Les paramètres recordType, flags, dataSize, *Datas sont les 4 premiers paramètres de la fonction callback d'énumération et sont donc fournis par le système. Seul le paramètre *metafile est à fournir à la fonction. Une des méthodes courante est d'utiliser le paramètre *callbackData des fonctions d'énumération, ce qui est fait dans l'exemple.
L'exemple est celui de la fonction GdipEnumerateMetafileDestPoints().
L'exemple permet de choisir un métafichier et de l'afficher complètement aux coordonnées du rectangle définies pour la fonction GdipEnumerateMetafileDestPoints(). La callback d'énumération ne sert qu'à afficher le métafichier dans cet exemple. Pour les différents types d'enregistrements possibles, reportez-vous à l'exemple de la fonction GdipEnumerateMetafileDestPoint().

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