GdipSetClipRectI()

Resultat.i = GdipSetClipRectI(*graphics, x.l, y.l, width.l, height.l, combineMode.i)

*graphics

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

x.l

[in] Coordonnée en x (abscisse) de l'angle supérieur gauche du rectangle.

y.l

[in] Coordonnée en y (ordonnée) de l'angle supérieur gauche du rectangle.

width.l

[in] Largeur du rectangle.

height.l

[in] Hauteur du rectangle.

combineMode.i

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

Cette fonction permet de combiner la zone de découpage du graphique courant avec le rectangle défini par les paramètres x, y, width (largeur) et height (hauteur), 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 une zone de découpage rectangulaire pour le graphique (définie par la fonction GdipSetClipRectI()) : x =50, y = 50, largeur 200 et hauteur 200 pixels.
On combine le graphique avec le rectangle de la fonction GdipSetClipRectI() de coordonnées x = 150.0, y = 150.0, largeur et hauteur de 100.0 pixels, avec le mode de combinaison #CombineModeExclude, c'est à dire que la région rectangulaire de la fonction, est exclue de la zone de découpe du graphique principal
On dessine un rectangle plein en bleu aux coordonnées x = 0, y = 0 largeur 300 et hauteur 300 pixels.
La combinaison ne va pas permettre de dessiner ce rectangle complètement, mais c'est le rectangle de la fonction qui ne sera pas dessiné en bleu, par contre le reste de la zone de découpe du graphique le sera.

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.