TransparentBlt-Funktion (wingdi.h)

Artikel
03/13/2024

Die TransparentBlt-Funktion führt eine Bitblockübertragung der Farbdaten durch, die einem Pixelrechteck aus dem angegebenen Quellgerätekontext in einen Zielgerätekontext entsprechen.

Syntax

BOOL TransparentBlt(
  [in] HDC  hdcDest,
  [in] int  xoriginDest,
  [in] int  yoriginDest,
  [in] int  wDest,
  [in] int  hDest,
  [in] HDC  hdcSrc,
  [in] int  xoriginSrc,
  [in] int  yoriginSrc,
  [in] int  wSrc,
  [in] int  hSrc,
  [in] UINT crTransparent
);

Parameter

[in] hdcDest

Ein Handle für den Zielgerätekontext.

[in] xoriginDest

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

[in] yoriginDest

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

[in] wDest

Die Breite des Zielrechtecks in logischen Einheiten.

[in] hDest

Die Höhe des Zielrechtecks in logischen Einheiten.

[in] hdcSrc

Ein Handle für den Quellgerätekontext.

[in] xoriginSrc

Die x-Koordinate in logischen Einheiten des Quellrechtecks.

[in] yoriginSrc

Die y-Koordinate in logischen Einheiten des Quellrechtecks.

[in] wSrc

Die Breite des Quellrechtecks in logischen Einheiten.

[in] hSrc

Die Höhe des Quellrechtecks in logischen Einheiten.

[in] crTransparent

Die RGB-Farbe in der Quell-Bitmap, die als transparent behandelt werden soll.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE.

Hinweise

Die TransparentBlt-Funktion funktioniert mit kompatiblen Bitmaps (DDBs).

Die TransparentBlt-Funktion unterstützt alle Formate von Quell-Bitmaps. Für 32 Bit-Bitmaps wird jedoch nur der Alphawert kopiert. Verwenden Sie AlphaBlend , um Bitmaps mit 32 Bit pro Pixel mit Transparenz anzugeben.

Wenn die Quell- und Zielrechtecke nicht die gleiche Größe aufweisen, wird die Quellbitte so gestreckt, dass sie dem Zielrechteck entspricht. Wenn die SetStretchBltMode-Funktion verwendet wird, werden die iStretchMode-Modi von BLACKONWHITE und WHITEONBLACK für die TransparentBlt-Funktion in COLORONCOLOR konvertiert.

Der Zielgerätekontext gibt den Transformationstyp für die Zielkoordinaten an. Der Quellgerätekontext gibt den Transformationstyp für die Quellkoordinaten an.

TransparentBlt Spiegel keine Bitmap, wenn entweder die Breite oder Höhe der Quelle oder des Ziels negativ ist.

Wenn sie in einem System mit mehreren Monitoren verwendet werden, 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 Speicher-Bitmap 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 (einschließlich Windows.h)
Bibliothek	Msimg32.lib
DLL	Msimg32.dll