Структура UPDATELAYEREDWINDOWINFO (winuser.h)

Статья
03/15/2023

Используется UpdateLayeredWindowIndirect для предоставления сведений о положении, размере, форме, содержимом и полупрозрачном окне.

Синтаксис

typedef struct tagUPDATELAYEREDWINDOWINFO {
  DWORD               cbSize;
  HDC                 hdcDst;
  const POINT         *pptDst;
  const SIZE          *psize;
  HDC                 hdcSrc;
  const POINT         *pptSrc;
  COLORREF            crKey;
  const BLENDFUNCTION *pblend;
  DWORD               dwFlags;
  const RECT          *prcDirty;
} UPDATELAYEREDWINDOWINFO, *PUPDATELAYEREDWINDOWINFO;

Члены

cbSize

Тип: DWORD

Размер данной структуры (в байтах).

hdcDst

Тип: HDC

Дескриптор контроллера домена для экрана. Этот дескриптор получается путем указания значения NULL в этом элементе при вызове Метода UpdateLayeredWindowIndirect. Дескриптор используется для сопоставления цветов палитры при обновлении содержимого окна. Если hdcDst имеет значение NULL, используется палитра по умолчанию.

Если hdcSrc имеет значение NULL, то hdcDst должен иметь значение NULL.

pptDst

Тип: const POINT*

Новое положение экрана многоуровневого окна. Если новая позиция не изменилась по сравнению с текущей позицией, pptDst может иметь значение NULL.

psize

Тип: const SIZE*

Новый размер многоуровневого окна. Если размер окна не изменится, этот параметр может иметь значение NULL. Если hdcSrc имеет значение NULL, psize должен иметь значение NULL.

hdcSrc

Тип: HDC

Дескриптор контроллера домена для поверхности, определяющей многоуровневое окно. Этот дескриптор можно получить, вызвав функцию CreateCompatibleDC . Если форма и визуальный контекст окна не изменяются, hdcSrc может иметь значение NULL.

pptSrc

Тип: const POINT*

Расположение слоя в контексте устройства. Если hdcSrc имеет значение NULL, pptSrc должен иметь значение NULL.

crKey

Тип: COLORREF

Клавиша цвета, используемая при составлении многоуровневого окна. Чтобы создать colorREF, используйте макрос RGB .

pblend

Тип: const BLENDFUNCTION*

Значение прозрачности, используемое при составлении многоуровневого окна.

dwFlags

Тип: DWORD

Этот параметр может принимать одно из указанных ниже значений.

Значение	Значение
ULW_ALPHA 0x00000002	Используйте pblend в качестве функции blend. Если режим отображения не превышает 256 цветов, эффект этого значения будет таким же, как и при ULW_OPAQUE.
ULW_COLORKEY 0x00000001	Используйте crKey в качестве цвета прозрачности.
ULW_OPAQUE 0x00000004	Нарисуйте непрозрачное многослойное окно.
ULW_EX_NORESIZE 0x00000008	Принудительная ошибка функции UpdateLayeredWindowIndirect , если текущий размер окна не соответствует размеру, указанному в psize.

Если hdcSrc имеет значение NULL, dwFlags должно быть равно нулю.

prcDirty

Тип: const RECT*

Область для обновления. Этот параметр может принимать значение NULL. Если значение не равно NULL, из исходного контроллера домена обновляется только область в этом прямоугольнике.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Верхняя часть	winuser.h (включая Windows.h)

См. также раздел

Основные понятия

Справочные материалы

UpdateLayeredWindow

Характеристики окон