Função TransparentBlt (wingdi.h)
A função TransparentBlt executa uma transferência de bloco de bits dos dados de cor correspondentes a um retângulo de pixels do contexto de dispositivo de origem especificado para um contexto de dispositivo de destino.
Sintaxe
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
);
Parâmetros
[in] hdcDest
Um identificador para o contexto do dispositivo de destino.
[in] xoriginDest
A coordenada x, em unidades lógicas, do canto superior esquerdo do retângulo de destino.
[in] yoriginDest
A coordenada y, em unidades lógicas, do canto superior esquerdo do retângulo de destino.
[in] wDest
A largura, em unidades lógicas, do retângulo de destino.
[in] hDest
A altura, em unidades lógicas, do retângulo de destino.
[in] hdcSrc
Um identificador para o contexto do dispositivo de origem.
[in] xoriginSrc
A coordenada x, em unidades lógicas, do retângulo de origem.
[in] yoriginSrc
A coordenada y, em unidades lógicas, do retângulo de origem.
[in] wSrc
A largura, em unidades lógicas, do retângulo de origem.
[in] hSrc
A altura, em unidades lógicas, do retângulo de origem.
[in] crTransparent
A cor RGB no bitmap de origem a ser tratada como transparente.
Retornar valor
Se a função for bem-sucedida, o valor retornado será TRUE.
Se a função falhar, o valor retornado será FALSE.
Comentários
A função TransparentBlt funciona com DDBs (bitmaps compatíveis).
A função TransparentBlt dá suporte a todos os formatos de bitmaps de origem. No entanto, para bitmaps de 32 bpp, ele apenas copia o valor alfa. Use AlphaBlend para especificar bitmaps de 32 bits por pixel com transparência.
Se os retângulos de origem e destino não tiverem o mesmo tamanho, o bitmap de origem será estendido para corresponder ao retângulo de destino. Quando a função SetStretchBltMode é usada, os modos iStretchMode de BLACKONWHITE e WHITEONBLACK são convertidos em COLORONCOLOR para a função TransparentBlt .
O contexto do dispositivo de destino especifica o tipo de transformação para as coordenadas de destino. O contexto do dispositivo de origem especifica o tipo de transformação para as coordenadas de origem.
TransparentBlt não espelho um bitmap se a largura ou altura, de origem ou destino, for negativa.
Quando usado em um sistema de vários monitores, hdcSrc e hdcDest devem se referir ao mesmo dispositivo ou a função falhará. Para transferir dados entre DCs para dispositivos diferentes, converta o bitmap de memória em um DIB chamando GetDIBits. Para exibir o DIB para o segundo dispositivo, chame SetDIBits ou StretchDIBits.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | wingdi.h (inclua Windows.h) |
| Biblioteca | Msimg32.lib |
| DLL | Msimg32.dll |