GdipEnumerateMetafileDestPointsI()
|
Syntaxe
|
Resultat.i = GdipEnumerateMetafileDestPointsI(*graphics, *metafile, @destPoints.Point, count.l, @callback(), *callbackData, *imageAttributes)
|
Paramètres |
*graphics[in] Pointeur sur un objet Graphics.
*metafile[in] Pointeur sur un objet metafile existant.
dstpoints.Point[in] Tableau de 3 structures Point (nombres entiers) qui définissent le parallélogramme ou sera dessiné le métafichier (ou certains enregistrements) avec la fonction GdipPlayMetafileRecord().
count.l[in] Nombre d'éléments du tableau dstpoints.Point. Ce paramètre doit toujours être égal à 3.
@callback()[in] Adresse d'une procédure Callback permettant l'énumération du métafichier. Le prototype de cette Callback est défini dans le fichier Gdiplustypes.h.
*callbackData[in] Pointeur sur un bloc de données qui sera passé à la Callback. Si ce paramètre n'est pas utilisé, il doit être mis à 0.
*imageAttributes[in] Pointeur sur un objet ImageAttributes qui spécifie les attributs de l'image. Ce paramètre peut être mis à 0 s'il n'est pas utilisé.
|
Description |
Cette fonction est classé par Micosoft dans les fonctions Graphics mais je l'ai classée dans les métafiles.
Cette fonction permet d'énumérer les enregistrements du métafichier identifié par le paramètre *metafile et associé à un graphique (paramètre *graphics).
destPoint.Point défini le parallélogramme ou les éléments du métafichier seront affichés par la fonction GdipPlayMetafileRecord() dans la callback (si besoin).
Le parallélogramme est défini par 3 points : l'angle supérieur gauche, l'angle supérieur droit et l'angle inférieur gauche. Le quatrième point est extrapolé à partir des trois premiers points pour former un parallélogramme. Le métafichier dessiné est ajusté et incliné de manière à tenir à l'intérieur du parallélogramme.
Le paramètre count doit toujours être égal à trois.
L'origine du graphique est toujours à x= 0 et y = 0. Ce paramètre permet d'introduire un décalage de l'origine en x/y.
Les points sont exprimés en nombre entiers (long), c'est ce qui différencie cette fonction de la fonction GdipEnumerateMetafileDestPoints() dont les points sont exprimés en nombres flottants.
*callbackData permet de passer un bloc de données à la callback, ces données pourront être utilisées dans la callback. Ce paramètre permet de passer par exemple l'identifiant du métafichier.
Les paramètres de la callback sont définis comme ceci :
recordType : WMF, EMF, EMF+
flags : (toujours 0 pour les enregistrements WMF/EMF)
dataSize : taille des données de l'enregistrement (en octets) ou 0 si pas de données.
data : Pointeur de données sur les données de l'enregistrement, ou #NULL si pas de données.
callbackData : Pointeur sur le bloc de données, s'il existe.
La callback peut ensuite appeler la fonction GdipPlayMetafileRecord() pour afficher les enregistrements (partiellement ou complètement) qui viennent juste d'être énumérés. Si cette fonction retourne #False, l'énumération se termine, sinon elle continue.
*imageAttributes peut être créé à partir d'une fonction comme GdipCreateimageAttributes() ou GdipCloneImageAttributes() pour obtenir un objet ImageAttributes. Les attributs d'image pourront ensuite être modifiés par une des commandes ImageAttributes.
L'exemple permet de choisir un métafichier et de l'afficher complètement aux coordonnées du parallélogramme (paramètre destPoints.Point). Le parallélogramme est un losange, l'image est ajustée et inclinée de manière à tenir à l'intérieur. Certains métafichiers sont plus grands que la fenêtre, dans ce cas l'image est tronquée par la fenêtre.
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 GdipEnumerateMetafileDestPointI().
|
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