FrameRect-Funktion (winuser.h)

Artikel
03/04/2024

Die FrameRect-Funktion zeichnet mithilfe des angegebenen Pinsels einen Rahmen um das angegebene Rechteck. Die Breite und Höhe des Rahmens sind immer eine logische Einheit.

Syntax

int FrameRect(
  [in] HDC        hDC,
  [in] const RECT *lprc,
  [in] HBRUSH     hbr
);

Parameter

[in] hDC

Ein Handle für den Gerätekontext, in dem der Rahmen gezeichnet wird.

[in] lprc

Ein Zeiger auf eine RECT-Struktur , die die logischen Koordinaten der oberen linken und unteren rechten Ecke des Rechtecks enthält.

[in] hbr

Ein Ziehpunkt für den Pinsel, der zum Zeichnen des Rahmens verwendet wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Der durch den hbr-Parameter identifizierte Pinsel muss mithilfe der Funktion CreateHatchBrush, CreatePatternBrush oder CreateSolidBrush erstellt oder mithilfe der GetStockObject-Funktion abgerufen worden sein.

Wenn das untere Element der RECT-Struktur kleiner als das obere Element ist oder das rechte Element kleiner als das linke Element ist, zeichnet die Funktion das Rechteck nicht.

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	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-gui-l1-1-1 (eingeführt in Windows 8.1)