Funzione TransparentBlt (wingdi.h)

Articolo
03/04/2024

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