Compartilhar via


Função ExcludeClipRect (wingdi.h)

A função ExcludeClipRect cria uma nova região de recorte que consiste na região de recorte existente menos o retângulo especificado.

Sintaxe

int ExcludeClipRect(
  [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.

Valor retornado

O valor retornado especifica a complexidade da nova região de recorte; 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
Nenhuma região foi criada.

Comentários

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

Requisitos

   
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

Intersectcliprect