Перечисление DWMWINDOWATTRIBUTE (dwmapi.h)

  • Статья

Параметры, используемые функциями DwmGetWindowAttribute и DwmSetWindowAttribute .

Синтаксис

typedef enum DWMWINDOWATTRIBUTE {
  DWMWA_NCRENDERING_ENABLED,
  DWMWA_NCRENDERING_POLICY,
  DWMWA_TRANSITIONS_FORCEDISABLED,
  DWMWA_ALLOW_NCPAINT,
  DWMWA_CAPTION_BUTTON_BOUNDS,
  DWMWA_NONCLIENT_RTL_LAYOUT,
  DWMWA_FORCE_ICONIC_REPRESENTATION,
  DWMWA_FLIP3D_POLICY,
  DWMWA_EXTENDED_FRAME_BOUNDS,
  DWMWA_HAS_ICONIC_BITMAP,
  DWMWA_DISALLOW_PEEK,
  DWMWA_EXCLUDED_FROM_PEEK,
  DWMWA_CLOAK,
  DWMWA_CLOAKED,
  DWMWA_FREEZE_REPRESENTATION,
  DWMWA_PASSIVE_UPDATE_MODE,
  DWMWA_USE_HOSTBACKDROPBRUSH,
  DWMWA_USE_IMMERSIVE_DARK_MODE = 20,
  DWMWA_WINDOW_CORNER_PREFERENCE = 33,
  DWMWA_BORDER_COLOR,
  DWMWA_CAPTION_COLOR,
  DWMWA_TEXT_COLOR,
  DWMWA_VISIBLE_FRAME_BORDER_THICKNESS,
  DWMWA_SYSTEMBACKDROP_TYPE,
  DWMWA_LAST
} ;

Константы

 
DWMWA_NCRENDERING_ENABLED
Используйте с DwmGetWindowAttribute. Определяет, включена ли отрисовка, не связанная с клиентом. Полученное значение имеет тип BOOL. ЗНАЧЕНИЕ TRUE , если включена отрисовка, не связанная с клиентом; в противном случае — FALSE.
DWMWA_NCRENDERING_POLICY
Используйте с DwmSetWindowAttribute. Задает политику отрисовки, не относясь к клиенту. Параметр pvAttribute указывает на значение из перечисления DWMNCRENDERINGPOLICY .
DWMWA_TRANSITIONS_FORCEDISABLED
Используйте с DwmSetWindowAttribute. Включает или принудительно отключает переходы DWM. Параметр pvAttribute указывает на значение типа BOOL. Значение TRUE для отключения переходов или FALSE для включения переходов.
DWMWA_ALLOW_NCPAINT
Используйте с DwmSetWindowAttribute. Позволяет отображать содержимое, отображаемое в не клиентской области, на кадре, нарисованном DWM. Параметр pvAttribute указывает на значение типа BOOL. ЗНАЧЕНИЕ TRUE , чтобы содержимое, отображаемое в не клиентской области, отображалось в кадре; в противном случае — FALSE.
DWMWA_CAPTION_BUTTON_BOUNDS
Используйте с DwmGetWindowAttribute. Извлекает границы области кнопки подпись в пространстве относительно окна. Полученное значение имеет тип RECT. Если окно свернуто или иным образом не отображается пользователю, то значение полученного объекта RECT не определено. Следует проверка, содержит ли полученный RECT границу, с помощью которого можно работать, и если это не так, можно сделать вывод о том, что окно свернуто или не отображается иным образом.
DWMWA_NONCLIENT_RTL_LAYOUT
Используйте с DwmSetWindowAttribute. Указывает, отражается ли не клиентское содержимое справа налево (RTL). Параметр pvAttribute указывает на значение типа BOOL. ЗНАЧЕНИЕ TRUE , если содержимое не является клиентским, зеркальным отображением справа налево (RTL); в противном случае — FALSE.
DWMWA_FORCE_ICONIC_REPRESENTATION
Используйте с DwmSetWindowAttribute. Принудить окно к отображению знакового эскиза или представления с изображением (статическое растровое изображение), даже если доступно динамическое или snapshot представление окна. Это значение обычно устанавливается во время создания окна и не изменяется на протяжении всего времени существования окна. Однако в некоторых сценариях может потребоваться изменение значения с течением времени. Параметр pvAttribute указывает на значение типа BOOL. ЗНАЧЕНИЕ TRUE , чтобы требовать знаковых эскизов или представления с изображением; в противном случае — FALSE.
DWMWA_FLIP3D_POLICY
Используйте с DwmSetWindowAttribute. Задает способ обработки окна Flip3D. Параметр pvAttribute указывает на значение из перечисления DWMFLIP3DWINDOWPOLICY .
DWMWA_EXTENDED_FRAME_BOUNDS
Используйте с DwmGetWindowAttribute. Извлекает прямоугольник с расширенными границами фрейма в пространстве экрана. Полученное значение имеет тип RECT.
DWMWA_HAS_ICONIC_BITMAP
Используйте с DwmSetWindowAttribute. Окно предоставит точечный рисунок для использования DWM в качестве знакового эскиза или представления просмотра (статического растрового изображения) для окна. DWMWA_HAS_ICONIC_BITMAP можно указать с помощью DWMWA_FORCE_ICONIC_REPRESENTATION. DWMWA_HAS_ICONIC_BITMAP обычно устанавливается во время создания окна и не изменяется на протяжении всего времени существования окна. Однако в некоторых сценариях может потребоваться изменение значения с течением времени. Параметр pvAttribute указывает на значение типа BOOL. ЗНАЧЕНИЕ TRUE , чтобы сообщить DWM о том, что окно будет предоставлять знаковый эскиз или представление просмотра; в противном случае — FALSE.

Windows Vista и более ранние версии: Это значение не поддерживается.
DWMWA_DISALLOW_PEEK
Используйте с DwmSetWindowAttribute. Не показывать предварительный просмотр окна. В режиме просмотра отображается полноразмерный предварительный просмотр окна при наведении указателя мыши на эскиз окна на панели задач. Если этот атрибут задан, при наведении указателя мыши на эскиз окна будет закрыт просмотр (на случай, если в другом окне в группе отображается предварительный просмотр). Параметр pvAttribute указывает на значение типа BOOL. Значение TRUE , чтобы запретить функциональность просмотра, или FALSE , чтобы разрешить это.

Windows Vista и более ранние версии: Это значение не поддерживается.
DWMWA_EXCLUDED_FROM_PEEK
Используйте с DwmSetWindowAttribute. Предотвращает выцветание окна в стеклянный лист при вызове peek. Параметр pvAttribute указывает на значение типа BOOL. Значение TRUE , чтобы предотвратить выцветание окна во время просмотра другого окна, или ЗНАЧЕНИЕ FALSE для нормального поведения.

Windows Vista и более ранние версии: Это значение не поддерживается.
DWMWA_CLOAK
Используйте с DwmSetWindowAttribute. Маскирует окно таким образом, чтобы оно не было видно пользователю. Окно по-прежнему состоит из DWM.

Использование с DirectComposition: Флаг DWMWA_CLOAK используется для маскировки многоуровневого дочернего окна при анимации представления содержимого окна с помощью визуального элемента DirectComposition, связанного с многоуровневым дочерним окном. Дополнительные сведения об этом варианте использования см. в статье Анимация растрового изображения многоуровневого дочернего окна.

Windows 7 и более ранние версии: Это значение не поддерживается.
DWMWA_CLOAKED
Используйте с DwmGetWindowAttribute. Если окно маскируется, предоставляет одно из следующих значений, объясняющих причину.

DWM_CLOAKED_APP (значение 0x00000001). Окно было замаксировано приложением-владельцем.

DWM_CLOAKED_SHELL (значение 0x00000002). Окно было замаксировано оболочкой.

DWM_CLOAKED_INHERITED (значение 0x00000004). Значение плаща было унаследовано от окна владельца.

Windows 7 и более ранние версии: Это значение не поддерживается.
DWMWA_FREEZE_REPRESENTATION
Используйте с DwmSetWindowAttribute. Заморозите эскиз окна с его текущими визуальными элементами. Не обновляйте изображение эскиза в режиме реального времени в соответствии с содержимым окна.

Windows 7 и более ранние версии: Это значение не поддерживается.
DWMWA_USE_HOSTBACKDROPBRUSH
Используйте с DwmSetWindowAttribute. Позволяет окну, отличному от UWP, использовать кисти фона узла. Если этот флаг установлен, приложение Win32, которое вызывает API Windows::UI::Composition , может создавать эффекты прозрачности с помощью кисти фона узла (см . раздел Compositor.CreateHostBackdropBrush). Параметр pvAttribute указывает на значение типа BOOL. Значение TRUE , чтобы включить кисти фона узла для окна, или ЗНАЧЕНИЕ FALSE , чтобы отключить его.

Это значение поддерживается начиная с Windows 11 сборки 22000.
DWMWA_USE_IMMERSIVE_DARK_MODE
Используйте с DwmSetWindowAttribute. Позволяет нарисовать рамку окна в темном режиме, если включен параметр системы темного режима. Для обеспечения совместимости все окна по умолчанию в светлом режиме независимо от параметра системы. Параметр pvAttribute указывает на значение типа BOOL. Значение TRUE , чтобы учитывать темный режим для окна, значение FALSE — всегда использовать светлый режим.

Это значение поддерживается начиная с Windows 11 сборки 22000.
DWMWA_WINDOW_CORNER_PREFERENCE
Используйте с DwmSetWindowAttribute. Задает предпочтительный угол скругления для окна. Параметр pvAttribute указывает на значение типа DWM_WINDOW_CORNER_PREFERENCE.

Это значение поддерживается начиная с Windows 11 сборки 22000.
DWMWA_BORDER_COLOR
Используйте с DwmSetWindowAttribute. Задает цвет границы окна. Параметр pvAttribute указывает на значение типа COLORREF. Приложение отвечает за изменение цвета границы в соответствии с изменениями состояния, такими как изменение при активации окна.

Указание DWMWA_COLOR_NONE (значение 0xFFFFFFFE) для цвета приведет к подавлению рисования границы окна. Это позволяет иметь закругляемое окно без границы.

Если указать DWMWA_COLOR_DEFAULT (значение 0xFFFFFFFF) для цвета, окно будет возвращено в исходное поведение системы для цвета границы.

Это значение поддерживается начиная с Windows 11 сборки 22000.
DWMWA_CAPTION_COLOR
Используйте с DwmSetWindowAttribute. Задает цвет подпись. Параметр pvAttribute указывает на значение типа COLORREF.

Если указать DWMWA_COLOR_DEFAULT (значение 0xFFFFFFFF) для цвета, окно вернется к использованию поведения системы по умолчанию для цвета подпись.

Это значение поддерживается начиная с Windows 11 сборки 22000.
DWMWA_TEXT_COLOR
Используйте с DwmSetWindowAttribute. Задает цвет текста подпись. Параметр pvAttribute указывает на значение типа COLORREF.

Если указать DWMWA_COLOR_DEFAULT (значение 0xFFFFFFFF) для цвета, окно вернется к использованию поведения системы по умолчанию для подпись цвета текста.

Это значение поддерживается начиная с Windows 11 сборки 22000.
DWMWA_VISIBLE_FRAME_BORDER_THICKNESS
Используйте с DwmGetWindowAttribute. Извлекает ширину внешней границы, которую DWM будет рисовать вокруг этого окна. Значение может отличаться в зависимости от DPI окна. Параметр pvAttribute указывает на значение типа UINT.

Это значение поддерживается начиная с Windows 11 сборки 22000.
DWMWA_SYSTEMBACKDROP_TYPE
Используйте с DwmGetWindowAttribute или DwmSetWindowAttribute. Извлекает или задает нарисованный системой материал фона окна, в том числе за не клиентской областью. Параметр pvAttribute указывает на значение типа DWM_SYSTEMBACKDROP_TYPE.

Это значение поддерживается начиная с Windows 11 сборки 22621.
DWMWA_LAST
Максимальное распознаваемое значение DWMWINDOWATTRIBUTE , используемое для целей проверки.

Требования

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

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