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

Artigo
08/24/2023

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