Função DwmGetColorizationColor (dwmapi.h)

Recupera a cor atual usada para a composição de vidro do DWM (Gerenciador de Janelas da Área de Trabalho). Esse valor é baseado no esquema de cores atual e pode ser modificado pelo usuário. Os aplicativos podem escutar alterações de cor manipulando a notificação de WM_DWMCOLORIZATIONCOLORCHANGED .

Sintaxe

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

Parâmetros

[out] pcrColorization

Um ponteiro para um valor que, quando essa função retorna com êxito, recebe a cor atual usada para composição de vidro. O formato de cor do valor é 0xAARRGGBB.

[out] pfOpaqueBlend

Um ponteiro para um valor que, quando essa função retorna com êxito, indica se a cor é uma mistura opaca. TRUE se a cor for uma mistura opaca; caso contrário, FALSE.

Valor retornado

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O valor apontado por pcrColorization está em um formato 0xAARRGGBB. Muitas APIs do Microsoft Win32, como COLORREF, usam um formato 0x00BBGGRR. Tenha cuidado para garantir que as cores pretendidas sejam usadas.

Exemplos

O código de exemplo a seguir mostra um identificador de notificação WM_DWMCOLORIZATIONCOLORCHANGED. Se a notificação de colorização for recebida, esse código recuperará o novo valor de cor.

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

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	dwmapi.h
Biblioteca	Dwmapi.lib
DLL	Dwmapi.dll