Freigeben über


PatBlt-Funktion (wingdi.h)

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