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


Функция DwmGetColorizationColor (dwmapi.h)

Извлекает текущий цвет, используемый для композиции стекла Диспетчера окон рабочего стола (DWM). Это значение основано на текущей цветовой схеме и может быть изменено пользователем. Приложения могут прослушивать изменения цвета, обрабатывая уведомление WM_DWMCOLORIZATIONCOLORCHANGED .

Синтаксис

HRESULT DwmGetColorizationColor(
  [out] DWORD *pcrColorization,
  [out] BOOL  *pfOpaqueBlend
);

Параметры

[out] pcrColorization

Указатель на значение, которое при успешном возвращении этой функции получает текущий цвет, используемый для композиции стекла. Формат цвета значения — 0xAARRGGBB.

[out] pfOpaqueBlend

Указатель на значение, которое при успешном возвращении этой функции указывает, является ли цвет непрозрачным смешения. ЗНАЧЕНИЕ TRUE , если цвет является непрозрачным смешения; в противном случае — FALSE.

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

Если эта функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Значение, на которое указывает pcrColorization , имеет формат 0xAARRGGBB. Многие API Microsoft Win32, такие как COLORREF, используют формат 0x00BBGGRR. Будьте внимательны, чтобы убедиться, что используются предполагаемые цвета.

Примеры

В следующем примере кода показан дескриптор уведомления WM_DWMCOLORIZATIONCOLORCHANGED . Если получено уведомление о цветописи, этот код извлекает новое значение цвета.


...
DWORD color = 0;
BOOL opaque = FALSE;
  
HRESULT hr = DwmGetColorizationColor(&color, &opaque);
if (SUCCEEDED(hr))
{
  // Update the application to use the new color.
}
...

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header dwmapi.h
Библиотека Dwmapi.lib
DLL Dwmapi.dll