Compartilhar via

Função DwmGetColorizationColor (dwmapi.h)

  • Artigo

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