Função GetClipBox (wingdi.h)

A função GetClipBox recupera as dimensões do retângulo delimitador mais apertado que pode ser desenhado em torno da área visível atual no dispositivo. A área visível é definida pela região de recorte atual ou caminho de clipe, bem como por qualquer janela sobreposta.

Sintaxe

int GetClipBox(
  [in]  HDC    hdc,
  [out] LPRECT lprect
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[out] lprect

Um ponteiro para uma estrutura RECT que deve receber as dimensões do retângulo, em unidades lógicas.

Retornar valor

Se a função for bem-sucedida, o valor retornado especificará a complexidade da caixa de recorte e poderá 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.
 

GetClipBox retorna coordenadas lógicas com base no contexto de dispositivo fornecido.

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

RECT