Funzione GdiTransparentBlt (wingdi.h)

La funzione GdiTransparentBlt esegue un trasferimento di blocchi di 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 GdiTransparentBlt(
  [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 per il 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 per il 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 GdiTransparentBlt funziona con bitmap compatibili (DDB).

La funzione GdiTransparentBlt supporta tutti i formati delle bitmap di origine. Tuttavia, per 32 bitmap bpp, copia solo il valore alfa su. Usare AlphaBlend per specificare bitmap a 32 bit per pixel con trasparenza.

Se i rettangoli di origine e di destinazione non hanno le stesse dimensioni, la bitmap di origine viene estesa in modo che corrisponda al rettangolo di destinazione. Quando viene usata la funzione SetStretchBltMode , le modalità iStretchMode di BLACKONWHITE e WHITEONBLACK vengono convertite in COLORONCOLOR per la funzione GdiTransparentBlt .

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.

GdiTransparentBlt 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 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

Vedi anche

AlphaBlend

Funzioni bitmap

Panoramica delle bitmap

GetDIBits

SetDIBits

SetStretchBltMode

StretchDIBits