Функция SetLayeredWindowAttributes (winuser.h)

Статья
03/04/2024

Задает ключ цвета прозрачности многослойного окна.

Синтаксис

BOOL SetLayeredWindowAttributes(
  [in] HWND     hwnd,
  [in] COLORREF crKey,
  [in] BYTE     bAlpha,
  [in] DWORD    dwFlags
);

Параметры

[in] hwnd

Тип: HWND

Дескриптор многоуровневого окна. Многоуровневое окно создается путем указания WS_EX_LAYERED при создании окна с помощью функции CreateWindowEx или путем установки WS_EX_LAYERED с помощью SetWindowLong после создания окна.

Windows 8. Стиль WS_EX_LAYERED поддерживается для окон верхнего уровня и дочерних окон. Предыдущие версии Windows поддерживают WS_EX_LAYERED только для окон верхнего уровня.

[in] crKey

Тип: COLORREF

Структура COLORREF , задающая ключ цвета прозрачности, используемый при составлении многоуровневого окна. Все пиксели, окрашенные окном в этом цвете, будут прозрачными. Чтобы создать colorREF, используйте макрос RGB .

[in] bAlpha

Тип: BYTE

Альфа-значение, используемое для описания непрозрачности многоуровневого окна. Аналогично элементу SourceConstantAlpha структуры BLENDFUNCTION . Если значение bAlpha равно 0, окно становится полностью прозрачным. Если значение bAlpha равно 255, окно непрозрачно.

[in] dwFlags

Тип: DWORD

Выполняемое действие. Этот параметр может иметь одно или несколько из следующих значений.

Значение	Значение
LWA_ALPHA 0x00000002	Используйте bAlpha для определения непрозрачности многоуровневого окна.
LWA_COLORKEY 0x00000001	Используйте crKey в качестве цвета прозрачности.

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

Тип: BOOL

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

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Обратите внимание, что после вызова SetLayeredWindowAttributes для многоуровневого окна последующие вызовы UpdateLayeredWindow завершатся ошибкой, пока бит стиля слоев не будет очищен и снова задан.

Дополнительные сведения см. в разделе Использование многоуровневой оси Windows.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-window-l1-1-1 (представлено в Windows 8.1)