GdipEnumerateMetafileSrcRectDestRect()
Syntaxe
|
Resultat.i = GdipEnumerateMetafileSrcRectDestRect(*graphics, *metafile, @destRect.RectF, @srcRect.RectF, srcUnit.i, @callback(), *callbackData, *imageAttributes)
Paramètres |
*graphics[in] Pointeur sur un objet Graphics.
*metafile[in] Pointeur sur un objet metafile existant
destRect.RectF[in] Coordonnées d'un rectangle (nombres flottants) ou le métafichier sera affiché (ou certains enregistrements) avec la fonction GdipPlayMetafileRecord().
srcRect.RectF[in] Coordonnées d'un rectangle (nombres flottants) qui spécifie la zone du métafichier qui sera affichée (ou certains de ses enregistrements) avec la fonction GdipPlayMetafileRecord().
srcUnit.i[in] Elément de l'énumération Unit qui indique l'unité de mesure du rectangle source.
@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).
destRect.RectF défini le rectangle ou les éléments du métafichier seront affichés par la fonction GdipPlayMetafileRecord() dans la callback (si besoin). L'image est redimensionnée de manière à tenir à l'intérieur du rectangle.
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 ainsi qu'une mise à l'échelle.
Les points sont exprimés en nombre flottants, c'est ce qui différencie cette fonction de la fonction GdipEnumerateMetafileSrcRectDestRectI() dont les coordonnées sont exprimés en nombres entiers (long), idem pour le paramètre srcRect.RectF.
srcRect.RectF défini un rectangle qui spécifie la zone du métafichier qui sera affichée (ou certains de ses enregistrements) avec la fonction GdipPlayMetafileRecord() aux coordonnées définies par le paramètre destRect.RectF pour le graphique défini par le paramètre *graphics.
*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 une zone rectangulaire initiale de 50x50 pixels sur l'image de gauche (métafichier) redimensionnable avec la molette de la souris par pas de 10 pixels et de l'afficher à droite. Comme la surface de droite ne varie pas et que la zone d'origine varie, on a un effet de zoom. 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