Graphics::IntersectClip(constRectF&)-Methode (gdiplusgraphics.h)

Artikel
02/27/2024

Die Graphics::IntersectClip-Methode aktualisiert den Clippingbereich dieses Graphics-Objekts auf den Teil des angegebenen Rechtecks, der sich mit dem aktuellen Abschneidebereich dieses Graphics-Objekts überschneidet.

Syntax

Status IntersectClip(
  const RectF & rect
);

Parameter

rect

Verweis auf ein Rechteck, das zum Aktualisieren des Ausschneidebereichs verwendet wird.

Rückgabewert

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Bemerkungen

Beispiele

Im folgenden Beispiel wird ein Abschneidebereich festgelegt und der Abschneidebereich aktualisiert. Anschließend werden Rechtecke gezeichnet, um den effektiven Abschneidebereich zu veranschaulichen.

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);
}