Graphics ::IntersectClip(constRectF&) , méthode (gdiplusgraphics.h)

Article
02/27/2024

La méthode Graphics ::IntersectClip met à jour la zone de découpage de cet objet Graphics vers la partie du rectangle spécifié qui croise la zone de découpage actuelle de cet objet Graphics .

Syntaxe

Status IntersectClip(
  const RectF & rect
);

Paramètres

rect

Référence à un rectangle utilisé pour mettre à jour la région de découpage.

Valeur retournée

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Notes

Exemples

L’exemple suivant définit une région de découpage et met à jour la région de découpage. Il dessine ensuite des rectangles pour illustrer la zone de découpage effective.

VOID Example_IntersectClip2(HDC hdc)
{
   Graphics graphics(hdc);

   // Set the clipping region.
   RectF clipRect(0.5f, 0.5f, 200.5f, 200.5f);
   graphics.SetClip(clipRect);

   // Update the clipping region to the portion of the rectangle that
   // intersects with the current clipping region.
   RectF intersectRect(100.5f, 100.5f, 200.5f, 200.5f);
   graphics.IntersectClip(intersectRect);

   // Fill a rectangle to demonstrate the effective clipping region.
   graphics.FillRectangle(&SolidBrush(Color(255, 0, 0, 255)), 0, 0, 500, 500);

   // Reset the clipping region to infinite.
   graphics.ResetClip();

   // Draw clipRect and intersectRect.
   graphics.DrawRectangle(&Pen(Color(255, 0, 0, 0)), clipRect);
   graphics.DrawRectangle(&Pen(Color(255, 255, 0, 0)), intersectRect);
}