PtInRect-Funktion (winuser.h)

Artikel
08/27/2023

Die PtInRect-Funktion bestimmt, ob der angegebene Punkt innerhalb des angegebenen Rechtecks liegt. Ein Punkt befindet sich innerhalb eines Rechtecks, wenn er auf der linken oder oberen Seite liegt oder sich innerhalb aller vier Seiten befindet. Ein Punkt auf der rechten oder unteren Seite wird als außerhalb des Rechtecks betrachtet.

Syntax

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

Parameter

[in] lprc

Ein Zeiger auf eine RECT-Struktur , die das angegebene Rechteck enthält.

[in] pt

Eine POINT-Struktur , die den angegebenen Punkt enthält.

Rückgabewert

Wenn sich der angegebene Punkt innerhalb des Rechtecks befindet, ist der Rückgabewert ungleich null.

Wenn der angegebene Punkt nicht innerhalb des Rechtecks liegt, ist der Rückgabewert null.

Hinweise

Das Rechteck muss normalisiert werden, bevor PtInRect aufgerufen wird. Das heißt, lprc.right muss größer als lprc.left und lprc.bottom muss größer als lprc.top sein. Wenn das Rechteck nicht normalisiert ist, wird nie ein Punkt innerhalb des Rechtecks berücksichtigt.

Da Anwendungen Rechtecke für verschiedene Zwecke verwenden können, verwenden die Rechteckfunktionen keine explizite Maßeinheit. Stattdessen werden alle Rechteckkoordinaten und Dimensionen in signierten logischen Werten angegeben. Der Zuordnungsmodus und die Funktion, in der das Rechteck verwendet wird, bestimmen die Maßeinheiten.

Beispiele

Ein Beispiel finden Sie unter Verwenden von Rechtecks.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll