Funzione TransparentBlt (wingdi.h)
La funzione TransparentBlt esegue un trasferimento a blocchi bit dei dati di colore corrispondenti a un rettangolo di pixel dal contesto del dispositivo di origine specificato in un contesto di dispositivo di destinazione.
Sintassi
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
);
Parametri
[in] hdcDest
Handle al contesto del dispositivo di destinazione.
[in] xoriginDest
Coordinata x, in unità logiche, dell'angolo superiore sinistro del rettangolo di destinazione.
[in] yoriginDest
Coordinata y, in unità logiche, dell'angolo superiore sinistro del rettangolo di destinazione.
[in] wDest
Larghezza, in unità logiche, del rettangolo di destinazione.
[in] hDest
Altezza, in unità logiche, del rettangolo di destinazione.
[in] hdcSrc
Handle nel contesto del dispositivo di origine.
[in] xoriginSrc
Coordinata x, in unità logiche, del rettangolo di origine.
[in] yoriginSrc
Coordinata y, in unità logiche, del rettangolo di origine.
[in] wSrc
Larghezza, in unità logiche, del rettangolo di origine.
[in] hSrc
Altezza, in unità logiche, del rettangolo di origine.
[in] crTransparent
Colore RGB nella bitmap di origine da considerare trasparente.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è TRUE.
Se la funzione ha esito negativo, il valore restituito è FALSE.
Commenti
La funzione TransparentBlt funziona con bitmap compatibili (DDBs).
La funzione TransparentBlt supporta tutti i formati delle bitmap di origine. Tuttavia, per 32 bitmap bpp, copia semplicemente il valore alfa sopra. Usare AlphaBlend per specificare bitmap a 32 bit per pixel con trasparenza.
Se i rettangoli di origine e di destinazione non sono uguali, la bitmap di origine viene estesa per corrispondere al rettangolo di destinazione. Quando viene usata la funzione SetStretchBltMode , le modalità iStretchMode di BLACKONWHITE e WHITEONBLACK vengono convertite in COLORONCOLOR per la funzione TransparentBlt .
Il contesto del dispositivo di destinazione specifica il tipo di trasformazione per le coordinate di destinazione. Il contesto del dispositivo di origine specifica il tipo di trasformazione per le coordinate di origine.
TransparentBlt non esegue il mirroring di una bitmap se la larghezza o l'altezza, dell'origine o della destinazione, è negativa.
Se usato in un sistema di monitoraggio multiplo, hdcSrc e hdcDest devono fare riferimento allo stesso dispositivo o la funzione avrà esito negativo. Per trasferire i dati tra controller di dominio per dispositivi diversi, convertire la bitmap di memoria in un DIB chiamando GetDIBits. Per visualizzare il DIB al secondo dispositivo, chiamare SetDIBits o StretchDIBits.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | wingdi.h (include Windows.h) |
| Libreria | Msimg32.lib |
| DLL | Msimg32.dll |