Função IntersectClipRect (wingdi.h)

  • Artigo

A função IntersectClipRect cria uma nova região de recorte da interseção da região de recorte atual e do retângulo especificado.

Sintaxe

int IntersectClipRect(
  [in] HDC hdc,
  [in] int left,
  [in] int top,
  [in] int right,
  [in] int bottom
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] left

A coordenada x, em unidades lógicas, do canto superior esquerdo do retângulo.

[in] top

A coordenada y, em unidades lógicas, do canto superior esquerdo do retângulo.

[in] right

A coordenada x, em unidades lógicas, do canto inferior direito do retângulo.

[in] bottom

A coordenada y, em unidades lógicas, do canto inferior direito do retângulo.

Retornar valor

O valor retornado especifica o tipo da nova região de recorte e pode ser um dos valores a seguir.

Código de retorno Descrição
NULLREGION
 A região está vazia.
SIMPLEREGION
 A região é um único retângulo.
COMPLEXREGION
 A região é mais de um retângulo.
ERROR
 Ocorreu um erro. (A região de recorte atual não é afetada.)

Comentários

As bordas inferior e direita do retângulo fornecido são excluídas da região de recorte.

Se uma região de recorte ainda não existir, o sistema poderá aplicar uma região de recorte padrão ao HDC especificado. Em seguida, uma região de recorte é criada a partir da interseção dessa região de recorte padrão e do retângulo especificado nos parâmetros de função.

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

Funções de recorte

Visão geral do recorte

ExcludeClipRect