Поделиться через

Перечисление 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

ВАЖНЫЙ

Значение DWMWA_NCRENDERING_ENABLED равно 1.

cpp<br>typedef enum DWMWINDOWATTRIBUTE {<br> DWMWA_NCRENDERING_ENABLED = 1,<br> DWMWA_NCRENDERING_POLICY,<br> ...<br>

Используйте 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, если содержимое, отличное от клиента, зеркально отображается справа налево; в противном случае FALSE.
DWMWA_FORCE_ICONIC_REPRESENTATION
Используйте DwmSetWindowAttribute. Заставляет окно отображать знаковый эскиз или представление (статическое растровое изображение), даже если доступно динамическое или моментальный снимок окна. Это значение обычно устанавливается во время создания окна и не изменяется на протяжении всего времени существования окна. Однако для некоторых сценариев может потребоваться изменить значение с течением времени. Параметр 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. Предотвращает увядание окна на стеклянный лист при вызове кика. Параметр pvAttribute указывает на значение типа BOOL. TRUE, чтобы предотвратить увядание окна во время просмотра другого окна или FALSE для нормального поведения.

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

Using with 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, которое вызывает Windows::UI::Composition API может создавать эффекты прозрачности с помощью кисти фона узла (см. раздел 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

См. также