Método Graphics::IntersectClip(constRectF&) (gdiplusgraphics.h)

Artigo
02/27/2024

O método Graphics::IntersectClip atualiza a região de recorte deste objeto Graphics para a parte do retângulo especificado que se cruza com a região de recorte atual deste objeto Graphics .

Sintaxe

Status IntersectClip(
  const RectF & rect
);

Parâmetros

rect

Referência a um retângulo usado para atualizar a região de recorte.

Retornar valor

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

Exemplos

O exemplo a seguir define uma região de recorte e atualiza a região de recorte. Em seguida, ele desenha retângulos para demonstrar a região de recorte eficaz.

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