GdipSetClipRegion()



Syntaxe
Resultat.i = GdipSetClipRegion(*graphics, *region, combineMode.i)

Paramètres

*graphics

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

*region

[in] Pointeur sur un objet Region qui spécifie la zone de découpage qui sera combinée avec celle du graphique *graphics.

combineMode.i

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

Description

Cette fonction permet de combiner la zone de découpage du graphique courant avec la région passée par le paramètre *region, 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é 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 une région rectangulaire (non lié au graphique) : x = 0, y = 0, largeur et hauteur 100 pixels
On crée une zone de découpage rectangulaire pour le graphique (définie par la fonction GdipSetClipRectI()) : x =50, y = 50, largeur 350 et hauteur 200 pixels.
On dessine un rectangle plein en jaune sur cette fenêtre qui matérialise la zone de découpe du graphique.
Ce rectangle est placé en x= 50, y = 20 avec une largeur de 300 et une hauteur de 150 pixels.
On combine le graphique avec la région (GdipSetClipRegion()).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 la zone définie par la région, à savoir x = 50, y =50 avec une largeur et hauteur de 50 pixels.
On dessine un rectangle plein en bleu aux coordonnées x = 0, y = 0 largeur 350 et hauteur 200 pixels.
La combinaison ne va pas permettre de dessiner ce rectangle complètement, mais seul un rectangle de 50 x 50 à x = 50 et y = 50 sera dessiné en bleu.

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