Freigeben über


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

Weitere Informationen

EqualRect

IsRectEmpty

PUNKT

RECT

Rechteckfunktionen

Übersicht über Rechtecke