FillRect-Funktion (winuser.h)

Artikel
08/27/2023

Die FillRect-Funktion füllt ein Rechteck mithilfe des angegebenen Pinsels aus. Diese Funktion umfasst den linken und oberen Rahmen, schließt jedoch den rechten und unteren Rahmen des Rechtecks aus.

Syntax

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

Parameter

[in] hDC

Ein Handle für den Gerätekontext.

[in] lprc

Ein Zeiger auf eine RECT-Struktur , die die logischen Koordinaten des zu füllenden Rechtecks enthält.

[in] hbr

Ein Ziehpunkt für den Pinsel, der zum Füllen des Rechtecks 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 kann entweder ein Handle für einen logischen Pinsel oder ein Farbwert sein. Wenn Sie ein Handle für einen logischen Pinsel angeben, rufen Sie eine der folgenden Funktionen auf, um das Handle abzurufen: CreateHatchBrush, CreatePatternBrush oder CreateSolidBrush. Darüber hinaus können Sie mithilfe der GetStockObject-Funktion ein Handle für einen der Stockpinsel abrufen. Wenn Sie einen Farbwert für den hbr-Parameter angeben, muss es sich um eine der Standardsystemfarben (der Wert 1 muss der ausgewählten Farbe hinzugefügt werden). Beispiel:


FillRect(hdc, &rect, (HBRUSH) (COLOR_WINDOW+1));

Eine Liste aller Standardsystemfarben finden Sie unter GetSysColor.

Beim Füllen des angegebenen Rechtecks enthält FillRect nicht die rechte und untere Seite des Rechtecks. GDI füllt ein Rechteck bis zur rechten Spalte und untersten Zeile aus, unabhängig vom aktuellen Zuordnungsmodus.

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
APIs	ext-ms-win-ntuser-gui-l1-1-0 (eingeführt in Windows 8)