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
);

[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.

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.

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


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