Функция BufferedPaintSetAlpha (uxtheme.h)

Задает для альфа-канала указанное значение в заданном прямоугольнике. Альфа-канал управляет степенью прозрачности, применяемой при смешивание с буфером в контексте целевого устройства (DC).

Синтаксис

HRESULT BufferedPaintSetAlpha(
       HPAINTBUFFER hBufferedPaint,
  [in] const RECT   *prc,
       BYTE         alpha
);

Параметры

hBufferedPaint

Тип: HPAINTBUFFER

Дескриптор буферизованного контекста рисования, полученный с помощью BeginBufferedPaint.

[in] prc

Тип: const RECT*

Указатель на структуру RECT , задающую прямоугольник, в котором устанавливается альфа-канал. Задайте для этого параметра значение NULL , чтобы указать весь буфер.

alpha

Тип: BYTE

Задается альфа-значение. Альфа-значение может варьироваться от нуля (полностью прозрачный) до 255 (полностью непрозрачный).

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

Тип: HRESULT

Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Эта функция задает альфа-значение для каждого пикселя в целевом прямоугольнике. Передача альфа-значения 255 делает пиксели полностью непрозрачными. Макрос BufferedPaintMakeOpaque, определенный в uxtheme.h, задает альфа-значения 255. Обычно он используется для вызова GDI для рисования в буфере памяти, а затем для того, чтобы сделать его непрозрачным, чтобы нарисовать его на стекле.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	uxtheme.h
DLL	UxTheme.dll