Função SelectClipPath (wingdi.h)

A função SelectClipPath seleciona o caminho atual como uma região de recorte para um contexto de dispositivo, combinando a nova região com qualquer região de recorte existente usando o modo especificado.

Sintaxe

BOOL SelectClipPath(
  [in] HDC hdc,
  [in] int mode
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo do caminho.

[in] mode

A maneira de usar o caminho. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
RGN_AND	A nova região de recorte inclui a interseção (áreas sobrepostas) da área de recorte atual e o caminho atual.
RGN_COPY	A nova área de recorte é o caminho atual.
RGN_DIFF	A nova região de recorte inclui as áreas da região de recorte atual com as do caminho atual excluídas.
RGN_OR	A nova área de recorte inclui a união (áreas combinadas) a área de recorte atual e o caminho atual.
RGN_XOR	A nova região de recorte inclui a união da região de recorte atual e o caminho atual, mas sem as áreas sobrepostas.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

O contexto do dispositivo identificado pelo parâmetro hdc deve conter um caminho fechado.

Exemplos

Para obter um exemplo, consulte Usando Recorte.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	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	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll