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 |