Compartir a través de


Función PtInRect (winuser.h)

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

Consulte también

EqualRect

IsRectEmpty

PUNTO

RECT

Funciones de rectángulo

Información general sobre rectángulos