Método Graphics::SetClip(HRGN,CombineMode) (gdiplusgraphics.h)

Artículo
08/24/2023

El método Graphics::SetClip actualiza la región de recorte de este objeto Graphics a una región que es la combinación de sí misma y una región de interfaz de dispositivo gráfico (GDI) de Windows.

Sintaxis

Status SetClip(
  [in] HRGN        hRgn,
  [in] CombineMode combineMode
);

Parámetros

[in] hRgn

Tipo: HRGN

Identificador de una región GDI que se va a combinar con la región de recorte de este objeto Graphics . Esto se proporciona para el código heredado. Las nuevas aplicaciones deben pasar un objeto Region como primer parámetro.

[in] combineMode

Tipo: CombineMode

Opcional. Elemento de la enumeración CombineMode que especifica cómo se combina la región GDI con la región de recorte de este objeto Graphics . El valor predeterminado es CombineModeReplace.

Valor devuelto

Tipo: Estado

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 .

Comentarios

Este método supone que la región GDI especificada por hRgn ya está en unidades de dispositivo, por lo que no transforma las coordenadas de la región GDI.

Ejemplos

En el ejemplo siguiente se usa una región GDI para actualizar la región de recorte.

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

   // Create a Region object, and get its handle.
   Region region(Rect(0, 0, 100, 100));
   HRGN hRegion = region.GetHRGN(&graphics);

   // Set the clipping region with hRegion.
   graphics.SetClip(hRegion);

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

Requisitos


Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusgraphics.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll