Функция SetLayeredWindowAttributes


Функция SetLayeredWindowAttributes устанавливает светопроницаемость и прозрачность окраски клавиши многослойного окна.

Синтаксис

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

Параметры

hwnd

[in] Дескриптор многослойного окна. Многослойное окно создается, при помощи определения флажка WS_EX_LAYERED при создании окна функцией CreateWindowEx или, при помощи установки флажка WS_EX_LAYERED через посредство функции SetWindowLong после того, как окно было создано.

crKey

[in] Указатель на значение COLORREF, которое устанавливает прозрачность окраски клавиши, которая будет использована при создании многослойного окна. Все пиксели, рисуемые окном в этом цвете, должны быть прозрачными. Чтобы создать COLORREF, используйте макрокоманду RGB.

bAlpha

[in] Alpha-значение используется для описания непрозрачность многослойного окна. Подобен члену SourceConstantAlpha структуры BLENDFUNCTION. Когда bAlpha - 0, окно полностью прозрачно. Когда bAlpha - 255, окно непрозрачно.

dwFlags

[in] Устанавливает предпринимаемое действие. Этот параметр может быть одно или несколько нижеследующих значений

Значение

Предназначение

LWA_COLORKEY

Использовать параметр crKey как цвет прозрачности.

LWA_ALPHA

Используйте bAlpha, чтобы выяснить непрозрачность многослойного окна.

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

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

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

Замечания

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

Для получения дополнительной информации, см. статью Использование многослойных окон.

Смотри также

Краткий обзор Окна, Использование многослойных окон, AlphaBlend, CreateWindowEx, SetWindowLong, TransparentBlt, UpdateLayeredWindow, COLORREF, RGB

Размещение и совместимость SetLayeredWindowAttributes

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да

Windows Me

Да

Windows 98

Да

Windows 95

Нет

Используемая библиотека

User32.lib

Заголовочный файл

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки
Перевод 11.01.2003 18:49 ©Copyright V. Sokovikov
Hosted by uCoz