Метод Graphics::IntersectClip(constRectF&) (gdiplusgraphics.h)

Статья
02/26/2024

Метод Graphics::IntersectClip обновляет область обрезки этого объекта Graphics до той части указанного прямоугольника, которая пересекается с текущей областью обрезки этого объекта Graphics .

Синтаксис

Status IntersectClip(
  const RectF & rect
);

Параметры

rect

Ссылка на прямоугольник, используемый для обновления области обрезки.

Возвращаемое значение

В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .

Если метод завершается ошибкой, он возвращает один из других элементов перечисления Status .

Remarks

Примеры

В следующем примере задается регион обрезки и обновляется область отсечения. Затем он рисует прямоугольники для демонстрации эффективной области обрезки.

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