RectVisible-Funktion (wingdi.h)

Artikel
03/04/2024

Die RectVisible-Funktion bestimmt, ob sich ein Teil des angegebenen Rechtecks innerhalb des Abschneidebereichs eines Gerätekontexts befindet.

Syntax

BOOL RectVisible(
  [in] HDC        hdc,
  [in] const RECT *lprect
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] lprect

Ein Zeiger auf eine RECT-Struktur , die die logischen Koordinaten des angegebenen Rechtecks enthält.

Rückgabewert

Wenn die aktuelle Transformation keine Drehung aufweist und sich das Rechteck innerhalb des Beschneidungsbereichs befindet, ist der Rückgabewert TRUE (1).

Wenn die aktuelle Transformation keine Drehung aufweist und sich das Rechteck nicht innerhalb des Beschneidungsbereichs befindet, ist der Rückgabewert FALSE (0).

Wenn die aktuelle Transformation eine Drehung aufweist und sich das Rechteck innerhalb des Beschneidungsbereichs befindet, ist der Rückgabewert 2.

Wenn die aktuelle Transformation eine Drehung aufweist und das Rechteck nicht innerhalb des Beschneidungsbereichs liegt, ist der Rückgabewert 1.

Alle anderen Rückgabewerte werden als Fehlercodes betrachtet. Wenn der beliebige Parameter ungültig ist, ist der Rückgabewert nicht definiert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll

Weitere Informationen

Beschneidungsfunktionen

Übersicht über das Clipping