MaskBlt-Funktion (wingdi.h)

Artikel
03/13/2024

Die MaskBlt-Funktion kombiniert die Farbdaten für die Quell- und Ziel-Bitmaps mithilfe des angegebenen Masken- und Rastervorgangs.

Syntax

BOOL MaskBlt(
  [in] HDC     hdcDest,
  [in] int     xDest,
  [in] int     yDest,
  [in] int     width,
  [in] int     height,
  [in] HDC     hdcSrc,
  [in] int     xSrc,
  [in] int     ySrc,
  [in] HBITMAP hbmMask,
  [in] int     xMask,
  [in] int     yMask,
  [in] DWORD   rop
);

Parameter

[in] hdcDest

Ein Handle für den Zielgerätekontext.

[in] xDest

Die x-Koordinate in logischen Einheiten der oberen linken Ecke des Zielrechtecks.

[in] yDest

Die y-Koordinate in logischen Einheiten der oberen linken Ecke des Zielrechtecks.

[in] width

Die Breite des Zielrechtecks und der Quellbitbitte in logischen Einheiten.

[in] height

Die Höhe des Zielrechtecks und der Quellbitbitte in logischen Einheiten.

[in] hdcSrc

Ein Handle für den Gerätekontext, aus dem die Bitmap kopiert werden soll. Er muss null sein, wenn der dwRop-Parameter einen Rastervorgang angibt, der keine Quelle enthält.

[in] xSrc

Die x-Koordinate in logischen Einheiten der oberen linken Ecke der Quellbitbitte.

[in] ySrc

Die y-Koordinate in logischen Einheiten der oberen linken Ecke der Quellbitbitte.

[in] hbmMask

Ein Handle für die bitmap der monochromen Maske in Kombination mit der Farbbittebit im Kontext des Quellgeräts.

[in] xMask

Der horizontale Pixeloffset für die durch den hbmMask-Parameter angegebene Maskenbitbit.

[in] yMask

Der vertikale Pixeloffset für die durch den hbmMask-Parameter angegebene Maskenbitbit.

[in] rop

Die Vordergrund- und Hintergrund-RoPs (Ternary Raster Operation Codes), die die Funktion verwendet, um die Kombination aus Quell- und Zieldaten zu steuern. Der Hintergrund-Rastervorgangscode wird im Byte mit hoher Ordnung des Worts mit hoher Ordnung dieses Werts gespeichert. der Vordergrund-Raster-Vorgangscode wird im Byte mit niedriger Ordnung des Worts mit hoher Ordnung dieses Werts gespeichert. Das Wort mit niedriger Reihenfolge dieses Werts wird ignoriert und sollte 0 (null) sein. Das Makro MAKEROP4 erstellt solche Kombinationen von Vordergrund- und Hintergrund-Rastervorgangscodes.

Eine Erläuterung von Vordergrund und Hintergrund im Kontext dieser Funktion finden Sie im folgenden Abschnitt Hinweise.

Eine Liste der allgemeinen Rastervorgangscodes (RoPs) finden Sie in der BitBlt-Funktion . Beachten Sie, dass der CAPTUREBLT-ROP in der Regel nicht zum Drucken von Gerätekontexten verwendet werden kann.

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 MaskBlt-Funktion verwendet geräteabhängige Bitmaps.

Der Wert 1 in der von hbmMask angegebenen Maske gibt an, dass der von dwRop angegebene Vordergrund-Rastervorgangscode an dieser Stelle angewendet werden soll. Der Wert 0 in der Maske gibt an, dass der von dwRop angegebene Hintergrund-Rastervorgangscode an dieser Stelle angewendet werden soll.

Wenn die Rastervorgänge eine Quelle erfordern, muss das Maskenrechteck das Quellrechteck abdecken. Wenn dies nicht der Fall ist, schlägt die Funktion fehl. Wenn für die Rastervorgänge keine Quelle erforderlich ist, muss das Maskenrechteck das Zielrechteck abdecken. Wenn dies nicht der Fall ist, schlägt die Funktion fehl.

Wenn beim Aufrufen dieser Funktion eine Drehungs- oder Schertransformation für den Kontext des Quellgeräts wirksam ist, tritt ein Fehler auf. Andere Transformationstypen sind jedoch zulässig.

Wenn sich die Farbformate der Quell-, Muster- und Zielbitbits unterscheiden, konvertiert diese Funktion das Muster- oder Quellformat oder beides, um dem Zielformat zu entsprechen.

Wenn es sich bei der Masken-Bitmap nicht um eine monochrome Bitmap handelt, tritt ein Fehler auf.

Wenn eine erweiterte Metadatei aufgezeichnet wird, tritt ein Fehler auf (und die Funktion gibt FALSE zurück), wenn der Kontext des Quellgeräts einen erweiterten Metadatei-Gerätekontext identifiziert.

Nicht alle Geräte unterstützen die MaskBlt-Funktion . Eine Anwendung sollte die GetDeviceCaps-Funktion mit dem nIndex-Parameter als RC_BITBLT aufrufen, um zu bestimmen, ob ein Gerät diese Funktion unterstützt.

Wenn keine Maskenbit bereitgestellt wird, verhält sich diese Funktion mit dem Vordergrund-Rastervorgangscode genau wie BitBlt.

ICM: Beim Auftreten von Blits wird keine Farbverwaltung durchgeführt.

Bei Verwendung in einem System mit mehreren Monitoren müssen sowohl hdcSrc als auch hdcDest auf dasselbe Gerät verweisen, andernfalls schlägt die Funktion fehl. Um Daten zwischen DCs für verschiedene Geräte zu übertragen, konvertieren Sie die Speicherbitbitbits (kompatible Bitmap oder DDB) in einen DIB, indem Sie GetDIBits aufrufen. Um den DIB auf dem zweiten Gerät anzuzeigen, rufen Sie SetDIBits oder StretchDIBits auf.

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