Функция GdiTransparentBlt (wingdi.h)

Статья
08/27/2023

Функция GdiTransparentBlt выполняет битовую передачу данных цвета, соответствующих прямоугольнику пикселей, из указанного контекста исходного устройства в контекст целевого устройства.

Примечание Эта функция аналогична Функции TransparentBlt.

Синтаксис

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

Параметры

[in] hdcDest

Дескриптор контекста целевого устройства.

[in] xoriginDest

Координата X в логических единицах верхнего левого угла прямоугольника назначения.

[in] yoriginDest

Координата Y в логических единицах верхнего левого угла прямоугольника назначения.

[in] wDest

Ширина (в логических единицах) прямоугольника назначения.

[in] hDest

Высота (в логических единицах) прямоугольника назначения.

[in] hdcSrc

Дескриптор контекста исходного устройства.

[in] xoriginSrc

Координата X исходного прямоугольника в логических единицах.

[in] yoriginSrc

Координата Y исходного прямоугольника в логических единицах.

[in] wSrc

Ширина исходного прямоугольника в логических единицах.

[in] hSrc

Высота исходного прямоугольника в логических единицах.

[in] crTransparent

Цвет RGB в исходном растровом рисунке для обработки как прозрачный.

Возвращаемое значение

Если функция выполнена успешно, возвращается значение TRUE.

Если функция завершается сбоем, возвращается значение FALSE.

Функция GdiTransparentBlt поддерживает все форматы исходных растровых изображений. Однако для точечных изображений 32 бит/с он просто копирует альфа-значение. Используйте AlphaBlend , чтобы указать 32 битовые изображения на пиксель с прозрачностью.

Если исходный и целевой прямоугольники имеют разный размер, исходное растровое изображение растягивается в соответствии с прямоугольником назначения. При использовании функции SetStretchBltMode режимы iStretchMode blackONWHITE и WHITEONBLACK преобразуются в COLORONCOLOR для функции GdiTransparentBlt .

Контекст целевого устройства указывает тип преобразования для координат назначения. Контекст исходного устройства указывает тип преобразования для исходных координат.

GdiTransparentBlt не зеркало растровое изображение, если ширина или высота исходного или целевого объекта являются отрицательными.

При использовании в системе с несколькими мониторами hdcSrc и hdcDest должны ссылаться на одно и то же устройство, иначе функция завершится сбоем. Чтобы передать данные между контроллерами домена для разных устройств, преобразуйте растровое изображение памяти в DIB, вызвав Метод GetDIBits. Чтобы отобразить DIB на втором устройстве, вызовите SetDIBits или StretchDIBits.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll