Freigeben über


TransparentBlt-Funktion (wingdi.h)

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

Weitere Informationen

AlphaBlend

Bitmapfunktionen

Übersicht über Bitmaps

GetDIBits

SetDIBits

SetStretchBltMode

StretchDIBits