Método Graphics::SetClip(constGraphicsPath*,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 a região especificada por um caminho gráfico. Se uma figura no caminho não estiver fechada, esse método tratará a figura não revelada como se tivesse sido fechada por uma linha reta que conecta os pontos iniciais e finais da figura.

Sintaxe

Status SetClip(
  [in] const GraphicsPath *path,
  [in] CombineMode        combineMode
);

Parâmetros

[in] path

Tipo: const GraphicsPath*

Ponteiro para um objeto GraphicsPath que especifica a região a ser combinada com a região de recorte deste objeto Graphics .

[in] combineMode

Tipo: CombineMode

Opcional. Elemento da enumeração CombineMode que especifica como a região especificada é combinada com a região de recorte deste objeto Graphics . O valor padrão é CombineModeReplace.

Retornar valor

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 .

Requisitos

Requisito Valor
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

Confira também

Recortando

Recorte com uma região

Combinemode

Métodos GetClipBounds

Elementos gráficos

Gráficos::GetClip

Graphics::IsClipEmpty

Graphics::ResetClip

Graphicspath

Métodos IntersectClip

Métodos TranslateClip