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

Artículo
02/26/2024

El método Graphics::IntersectClip actualiza la región de recorte de este objeto Graphics a la parte del rectángulo especificado que interseca con la región de recorte actual de este objeto Graphics .

Sintaxis

Status IntersectClip(
  const RectF & rect
);

Parámetros

rect

Referencia a un rectángulo que se usa para actualizar la región de recorte.

Valor devuelto

Si el método se ejecuta correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Observaciones

Ejemplos

En el ejemplo siguiente se establece una región de recorte y se actualiza la región de recorte. A continuación, dibuja rectángulos para mostrar la región 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);
}