Função SelectClipPath (wingdi.h)

  • Artigo

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

Confira também

Beginpath

Funções de recorte

Visão geral do recorte

EndPath