Método Graphics::SetClip(HRGN,CombineMode) (gdiplusgraphics.h)
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 |