PatBlt-Funktion (wingdi.h)

Artikel
08/27/2023

Die PatBlt-Funktion zeichnet das angegebene Rechteck mithilfe des Pinsels, der derzeit im angegebenen Gerätekontext ausgewählt ist. Die Pinselfarbe und die Oberflächenfarbe oder -farben werden mithilfe des angegebenen Rastervorgangs kombiniert.

Syntax

BOOL PatBlt(
  [in] HDC   hdc,
  [in] int   x,
  [in] int   y,
  [in] int   w,
  [in] int   h,
  [in] DWORD rop
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] x

Die x-Koordinate in logischen Einheiten der oberen linken Ecke des zu füllenden Rechtecks.

[in] y

Die y-Koordinate in logischen Einheiten der oberen linken Ecke des zu füllenden Rechtecks.

[in] w

Die Breite des Rechtecks in logischen Einheiten.

[in] h

Die Höhe des Rechtecks in logischen Einheiten.

[in] rop

Der Rastervorgangscode. Dieser Code kann einer der folgenden Werte sein.

Wert	Bedeutung
PATCOPY	Kopiert das angegebene Muster in die Zielbitbitbit.
PATINVERT	Kombiniert die Farben des angegebenen Musters mit den Farben des Zielrechtecks mithilfe des booleschen XOR-Operators.
DSTINVERT	Invertiert das Zielrechteck.
SCHWÄRZE	Füllt das Zielrechteck mithilfe der Farbe aus, die dem Index 0 in der physischen Palette zugeordnet ist. (Bei der physikalischen Standardpalette ist dies die Farbe Schwarz.)
WEIßE	Füllt das Zielrechteck mit der Farbe aus, die Index 1 in der physischen Palette zugeordnet ist. (Bei der physikalischen Standardpalette ist dies die Farbe Weiß.)

Rückgabewert

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

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

Hinweise

Die Werte des dwRop-Parameters für diese Funktion sind eine begrenzte Teilmenge der vollständigen 256 ternären Rastervorgangscodes. Insbesondere kann kein Vorgangscode verwendet werden, der auf ein Quellrechteck verweist.

Nicht alle Geräte unterstützen die PatBlt-Funktion . Weitere Informationen finden Sie in der Beschreibung der RC_BITBLT-Funktion in der GetDeviceCaps-Funktion .

Beispiele

Ein Beispiel finden Sie unter "Beispiel für Menu-Item Bitmaps" unter Verwenden von Menüs.

Anforderungen


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

Pinselfunktionen

Übersicht über Pinsel

GetDeviceCaps

Share via