Função PtInRect (winuser.h)

Artigo
08/27/2023

A função PtInRect determina se o ponto especificado está dentro do retângulo especificado. Um ponto estará dentro de um retângulo se ele estiver no lado esquerdo ou superior ou estiver dentro de todos os quatro lados. Um ponto no lado direito ou inferior é considerado fora do retângulo.

Sintaxe

BOOL PtInRect(
  [in] const RECT *lprc,
  [in] POINT      pt
);

Parâmetros

[in] lprc

Um ponteiro para uma estrutura RECT que contém o retângulo especificado.

[in] pt

Uma estrutura POINT que contém o ponto especificado.

Valor retornado

Se o ponto especificado estiver dentro do retângulo, o valor retornado será diferente de zero.

Se o ponto especificado não estiver dentro do retângulo, o valor retornado será zero.

Comentários

O retângulo deve ser normalizado antes que PtInRect seja chamado. Ou seja, lprc.right deve ser maior que lprc.left e lprc.bottom deve ser maior que lprc.top. Se o retângulo não for normalizado, um ponto nunca será considerado dentro do retângulo.

Como os aplicativos podem usar retângulos para diferentes finalidades, as funções de retângulo não usam uma unidade de medida explícita. Em vez disso, todas as coordenadas e dimensões do retângulo são fornecidas em valores lógicos com sinal. O modo de mapeamento e a função na qual o retângulo é usado determinam as unidades de medida.

Exemplos

Para obter um exemplo, consulte Usando retângulos.

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	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll