GdipTranslateClipI()

Resultat.i = GdipTranslateClipI(*graphics, dx.l, dy.l)

*graphics

[in] Pointeur sur un objet Graphics existant.

dx.l

[in] Nombre entier qui spécifie la valeur de translation horizontale (axe x).

dy.l

[in] Nombre entier qui spécifie la valeur de translation verticale (axe y).

Cette fonction permet d'appliquer une translation à la zone de découpe (clipping region) du graphique en fonction des valeurs dx et dy.
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.

Exemple :
Dessine deux fenêtres. La première (fenêtre supérieure) n'aura pas la fonction GdipTranslateClipI() appliquée, la seconde oui.
Pour chaque fenêtre, on applique les opérations suivantes qui sont identiques :
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 etle camembert défini par le GraphicsPath .

- Pour la fenêtre supérieure, 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).

- Pour la fenêtre inférieure, on applique une translation en x de 50 et y de 30, puis 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). La figure sera décalée en x et y ce qui est visible par rapport à la figure de la fenêtre supérieure.

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.