Función PtInRect (winuser.h)

Artículo
08/27/2023

La función PtInRect determina si el punto especificado se encuentra dentro del rectángulo especificado. Un punto está dentro de un rectángulo si se encuentra en el lado izquierdo o superior o está dentro de los cuatro lados. Un punto del lado derecho o inferior se considera fuera del rectángulo.

Sintaxis

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

Parámetros

[in] lprc

Puntero a una estructura RECT que contiene el rectángulo especificado.

[in] pt

Estructura POINT que contiene el punto especificado.

Valor devuelto

Si el punto especificado se encuentra dentro del rectángulo, el valor devuelto es distinto de cero.

Si el punto especificado no está dentro del rectángulo, el valor devuelto es cero.

Comentarios

El rectángulo debe normalizarse antes de llamar a PtInRect . Es decir, lprc.right debe ser mayor que lprc.left y lprc.bottom debe ser mayor que lprc.top. Si el rectángulo no está normalizado, nunca se considera un punto dentro del rectángulo.

Dado que las aplicaciones pueden usar rectángulos para diferentes propósitos, las funciones de rectángulo no usan una unidad de medida explícita. En su lugar, todas las coordenadas y dimensiones del rectángulo se proporcionan en valores lógicos con signo. El modo de asignación y la función en la que se usa el rectángulo determinan las unidades de medida.

Ejemplos

Para obtener un ejemplo, consulte Uso de rectángulos.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll