Функция GetLayeredWindowAttributes

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

Синтаксис

BOOL GetLayeredWindowAttributes(
    HWND hwnd,
    COLORREF* pcrKey,
    BYTE* pbAlpha,
    DWORD* pdwFlags
);

Параметры

hwnd

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

pcrKey

[out] Указатель на значение COLORREF, которое получает прозрачность окраски клавиши, используемую при создании многослойного окна. Все пиксели, рисуемые этим окном в этом цвете, должны быть прозрачными. Параметр может иметь значение ПУСТО (NULL), если в нем нет нужды.

pbAlpha

[out] Указатель на БАЙТ, который получает используемое Alpha-значение, которое описывает непрозрачность многослойного окна. Он подобен члену SourceConstantAlpha структуры BLENDFUNCTION. Когда переменная, на которую ссылается параметр pbAlpha, равна 0, окно полностью прозрачно. Когда переменная, на которую ссылается pbAlpha, равна 255, окно непрозрачно. Параметр может иметь значение ПУСТО (NULL), если в нем нет нужды.

pdwFlags

[out] Указатель на ДВОЙНОЕ СЛОВО, которое получает флажок распределения по слоям. Он может иметь значение ПУСТО (NULL), если в параметре нет нужды. Флажок распределения по слоям может состоять из одного или нескольких нижеследующих значений.

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

LWA_ALPHA 

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

LWA_COLORKEY 

Параметр pcrKey используется как цвет прозрачности. 

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

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

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

Замечания

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

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

Смотри также

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

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Нет

Windows NT

Нет

Windows Me

Нет

Windows 98

Нет

Windows 95

Нет

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

User32.lib

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

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Да

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

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz