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

Artículo
08/24/2023

El método Graphics::ExcludeClip actualiza la región de recorte a la parte de sí misma que no interseca el rectángulo especificado.

Sintaxis

Status ExcludeClip(
  const RectF & rect
);

Parámetros

rect

Referencia a un rectángulo que se va a usar 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 usa un rectángulo para actualizar una región de recorte y, a continuación, se dibuja un rectángulo que muestra la región de recorte actualizada.

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