Función GdiTransparentBlt (wingdi.h)

Artículo
08/27/2023

La función GdiTransparentBlt realiza una transferencia de bloques de bits de los datos de color correspondientes a un rectángulo de píxeles desde el contexto del dispositivo de origen especificado en un contexto de dispositivo de destino.

Nota Esta función es la misma que TransparentBlt.

Sintaxis

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
);

Parámetros

[in] hdcDest

Controlar el contexto del dispositivo de destino.

[in] xoriginDest

Coordenada x, en unidades lógicas, de la esquina superior izquierda del rectángulo de destino.

[in] yoriginDest

Coordenada y, en unidades lógicas, de la esquina superior izquierda del rectángulo de destino.

[in] wDest

Ancho, en unidades lógicas, del rectángulo de destino.

[in] hDest

Alto, en unidades lógicas, del rectángulo de destino.

[in] hdcSrc

Identificador del contexto del dispositivo de origen.

[in] xoriginSrc

Coordenada x, en unidades lógicas, del rectángulo de origen.

[in] yoriginSrc

Coordenada y, en unidades lógicas, del rectángulo de origen.

[in] wSrc

Ancho, en unidades lógicas, del rectángulo de origen.

[in] hSrc

Alto, en unidades lógicas, del rectángulo de origen.

[in] crTransparent

Color RGB del mapa de bits de origen que se va a tratar como transparente.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es TRUE.

Si se produce un error en la función, el valor devuelto es FALSE.

Comentarios

La función GdiTransparentBlt funciona con mapas de bits compatibles (DDB).

La función GdiTransparentBlt admite todos los formatos de mapas de bits de origen. Sin embargo, para los mapas de bits de 32 bpp, simplemente copia el valor alfa sobre. Use AlphaBlend para especificar mapas de bits por píxel de 32 bits con transparencia.

Si los rectángulos de origen y destino no tienen el mismo tamaño, el mapa de bits de origen se estira para que coincida con el rectángulo de destino. Cuando se usa la función SetStretchBltMode , los modos iStretchMode de BLACKONWHITE y WHITEONBLACK se convierten en COLORONCOLOR para la función GdiTransparentBlt .

El contexto del dispositivo de destino especifica el tipo de transformación para las coordenadas de destino. El contexto del dispositivo de origen especifica el tipo de transformación para las coordenadas de origen.

GdiTransparentBlt no refleja un mapa de bits si el ancho o alto del origen o el destino son negativos.

Cuando se usa en un sistema de supervisión múltiple, hdcSrc y hdcDest deben hacer referencia al mismo dispositivo o se producirá un error en la función. Para transferir datos entre controladores de dominio para distintos dispositivos, convierta el mapa de bits de memoria en un DIB mediante una llamada a GetDIBits. Para mostrar la DIB en el segundo dispositivo, llame a SetDIBits o StretchDIBits.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll