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

Статья
01/10/2024

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

Синтаксис

Status ExcludeClip(
  const RectF & rect
);

Параметры

rect

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

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

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

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

Remarks

Примеры

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

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

   // Create a RectF object, and set the clipping region to its exclusion.
   RectF excludeRect(100.0f, 100.0f, 200.0f, 200.0f);
   graphics.ExcludeClip(excludeRect);

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