Função GetClipBox (wingdi.h)

Artigo
03/13/2024

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

Compartilhar via