Freigeben über


FrameRect-Funktion (winuser.h)

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)

Weitere Informationen

CreateHatchBrush

CreatePatternBrush

CreateSolidBrush

Funktionen für gefüllte Formen

Übersicht über gefüllte Shapes

GetStockObject

RECT