SetROP2-Funktion (wingdi.h)

Artikel
08/27/2023

Die SetROP2-Funktion legt den aktuellen Vordergrundmischungsmodus fest. GDI verwendet den Vordergrundmischungsmodus, um Stifte und Innenbereiche gefüllter Objekte mit den Farben zu kombinieren, die sich bereits auf dem Bildschirm befinden. Der Vordergrundmischungsmodus definiert, wie Farben aus dem Pinsel oder Stift und die Farben im vorhandenen Bild kombiniert werden sollen.

Syntax

int SetROP2(
  [in] HDC hdc,
  [in] int rop2
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] rop2

Der Mischmodus. Dieser Parameter kann einen der folgenden Werte annehmen.

Mischmodus	Bedeutung
R2_BLACK	Pixel ist immer 0.
R2_COPYPEN	Pixel ist die Stiftfarbe.
R2_MASKNOTPEN	Pixel ist eine Kombination der Farben, die sowohl für den Bildschirm als auch für die Inverse des Stifts gemeinsam sind.
R2_MASKPEN	Pixel ist eine Kombination der Farben, die sowohl dem Stift als auch dem Bildschirm gemeinsam sind.
R2_MASKPENNOT	Pixel ist eine Kombination der Farben, die sowohl dem Stift als auch dem Umgekehrten des Bildschirms gemeinsam sind.
R2_MERGENOTPEN	Pixel ist eine Kombination aus der Bildschirmfarbe und der Umgekehrtkeit der Stiftfarbe.
R2_MERGEPEN	Pixel ist eine Kombination aus der Stiftfarbe und der Bildschirmfarbe.
R2_MERGEPENNOT	Pixel ist eine Kombination aus der Stiftfarbe und der Umgekehrtkeit der Bildschirmfarbe.
R2_NOP	Pixel bleibt unverändert.
R2_NOT	Pixel ist die Umgekehrte der Bildschirmfarbe.
R2_NOTCOPYPEN	Pixel ist die Inverse der Stiftfarbe.
R2_NOTMASKPEN	Pixel ist die Inverse der R2_MASKPEN Farbe.
R2_NOTMERGEPEN	Pixel ist die Inverse der R2_MERGEPEN Farbe.
R2_NOTXORPEN	Pixel ist die Inverse der R2_XORPEN Farbe.
R2_WHITE	Pixel ist immer 1.
R2_XORPEN	Pixel ist eine Kombination der Farben im Stift und auf dem Bildschirm, aber nicht in beiden.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt der Rückgabewert den vorherigen Mischmodus an.

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

Hinweise

Mischmodi definieren, wie GDI Quell- und Zielfarben beim Zeichnen mit dem aktuellen Stift kombiniert. Die Mischmodi sind binäre Rastervorgangscodes, die alle möglichen booleschen Funktionen von zwei Variablen darstellen, wobei die binären Vorgänge AND, OR und XOR (exklusives OR) und der unäre Vorgang NOT verwendet werden. Der Mixmodus gilt nur für Rastergeräte. sie ist für Vektorgeräte nicht verfügbar.

Beispiele

Ein Beispiel finden Sie unter Verwenden von Rechtecks.

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	wingdi.h (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll

Weitere Informationen

GetROP2

Mal- und Zeichenfunktionen

Übersicht über Das Malen und Zeichnen

Freigeben über