PtInRect-Funktion (winuser.h)
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 |