GdipSetClipPath()



Syntaxe
Resultat.i = GdipSetClipPath(*graphics, *path, combineMode.i)

Paramètres

*graphics

[in] Pointeur sur un objet Graphics ou la modification sera effective.

*path

[in] Pointeur sur un objet GraphicsPath.

combineMode.i

[in] Elément de l'énumération CombineMode qui spécifie la manière dont le GraphicsPath (*path) est combiné avec la zone de découpage du graphique *graphics.

Description

Cette fonction permet de combiner la zone de découpage du graphique courant avec le chemin (GraphicsPath) passée par le paramètre *path, la zone de découpage du graphique courant est mis à jour avec le résultat de cette combinaison.
Si aucune zone de découpe n'est précisée pour le graphique principal, c'est toute la surface du graphique qui est considérée comme zone de découpe.
Le paramètre combineMode défini la manière de combiner les deux zones.
Exemple :
Dessine une fenêtre.
Le graphique principal (qui correspond au paramètre *graphics de la fonction) est créé à partir du Hdc de la fenêtre principale
On crée un GraphicsPath en forme de camembert
On crée une zone de découpage rectangulaire pour le graphique (définie par la fonction GdipSetClipRectI()) : x =50, y = 50, largeur 230 et hauteur 200 pixels.
On combine le graphique avec le GraphicsPath avec le mode de combinaison #CombineModeIntersect, c'est à dire que la région de découpe d'origine du graphique principal est l'intersection entre sa propre zone de découpe et le camembert défini par le GraphicsPath .
On dessine un rectangle plein en bleu aux coordonnées x = 0, y = 0 largeur 350 et hauteur 250 pixels.
La combinaison ne va pas permettre de dessiner ce rectangle complètement, mais c'est le camembert tronqué qui sera dessiné en bleu (intersection).

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