Função TransparentBlt (wingdi.h)

Artigo
03/08/2023

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