Método Graphics::SetClip(HRGN,CombineMode) (gdiplusgraphics.h)
O método Graphics::SetClip atualiza a região de recorte desse objeto Graphics para uma região que é a combinação de si mesma e de uma região da GDI (Interface de Dispositivo gráfico) do Windows.
Sintaxe
Status SetClip(
[in] HRGN hRgn,
[in] CombineMode combineMode
);
Parâmetros
[in] hRgn
Tipo: HRGN
Manipule para uma região GDI a ser combinada com a região de recorte deste objeto Graphics . Isso é fornecido para código herdado. Novos aplicativos devem passar um objeto Region como o primeiro parâmetro.
[in] combineMode
Tipo: CombineMode
Opcional. Elemento da enumeração CombineMode que especifica como a região GDI é combinada com a região de recorte deste objeto Graphics . O valor padrão é CombineModeReplace.
Valor retornado
Tipo: Status
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
Esse método pressupõe que a região GDI especificada por hRgn já esteja em unidades de dispositivo, portanto, não transforma as coordenadas da região GDI.
Exemplos
O exemplo a seguir usa uma região GDI para atualizar a região 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 com suporte | Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | gdiplusgraphics.h (inclua Gdiplus.h) |
| Biblioteca | Gdiplus.lib |
| DLL | Gdiplus.dll |