Função SetSysColors (winuser.h)
Define as cores dos elementos de exibição especificados. Os elementos de exibição são as várias partes de uma janela e a exibição que aparecem na tela de exibição do sistema.
Sintaxe
BOOL SetSysColors(
[in] int cElements,
[in] const INT *lpaElements,
[in] const COLORREF *lpaRgbValues
);
Parâmetros
[in] cElements
Tipo: int
O número de elementos de exibição na matriz lpaElements .
[in] lpaElements
Tipo: const INT*
Uma matriz de inteiros que especifica os elementos de exibição a serem alterados. Para obter uma lista de elementos de exibição, consulte GetSysColor.
[in] lpaRgbValues
Tipo: const COLORREF*
Uma matriz de valores COLORREF que contêm os novos valores de cor vermelho, verde, azul (RGB) para os elementos de exibição na matriz apontada pelo parâmetro lpaElements .
Para gerar um COLORREF, use a macro RGB .
Valor retornado
Tipo: BOOL
Se a função for bem-sucedida, o valor retornado será um valor diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
A função SetSysColors envia uma mensagem WM_SYSCOLORCHANGE para todas as janelas para informá-las sobre a alteração de cor. Ele também direciona o sistema para repintar as partes afetadas de todas as janelas visíveis no momento.
É melhor respeitar as configurações de cor especificadas pelo usuário. Se você estiver escrevendo um aplicativo para permitir que o usuário altere as cores, será apropriado usar essa função. No entanto, essa função afeta apenas a sessão atual. As novas cores não são salvas quando o sistema é encerrado.
Exemplos
O exemplo a seguir demonstra o uso das funções GetSysColor e SetSysColors . Primeiro, o exemplo usa GetSysColor para recuperar as cores da tela de fundo da janela e as legenda ativas e exibe os valores vermelho, verde, azul (RGB) na notação hexadecimal. Em seguida, o exemplo usa SetSysColors para alterar a cor da tela de fundo da janela para cinza claro e as barras de título ativas para roxo escuro. Após um atraso de 10 segundos, o exemplo restaura as cores anteriores desses elementos usando SetSysColors.
#include <windows.h>
#include <stdio.h>
#pragma comment(lib, "user32.lib")
void main()
{
int aElements[2] = {COLOR_WINDOW, COLOR_ACTIVECAPTION};
DWORD aOldColors[2];
DWORD aNewColors[2];
// Get the current color of the window background.
aOldColors[0] = GetSysColor(aElements[0]);
printf("Current window color: {0x%x, 0x%x, 0x%x}\n",
GetRValue(aOldColors[0]),
GetGValue(aOldColors[0]),
GetBValue(aOldColors[0]));
// Get the current color of the active caption.
aOldColors[1] = GetSysColor(aElements[1]);
printf("Current active caption color: {0x%x, 0x%x, 0x%x}\n",
GetRValue(aOldColors[1]),
GetGValue(aOldColors[1]),
GetBValue(aOldColors[1]));
// Define new colors for the elements
aNewColors[0] = RGB(0x80, 0x80, 0x80); // light gray
aNewColors[1] = RGB(0x80, 0x00, 0x80); // dark purple
printf("\nNew window color: {0x%x, 0x%x, 0x%x}\n",
GetRValue(aNewColors[0]),
GetGValue(aNewColors[0]),
GetBValue(aNewColors[0]));
printf("New active caption color: {0x%x, 0x%x, 0x%x}\n",
GetRValue(aNewColors[1]),
GetGValue(aNewColors[1]),
GetBValue(aNewColors[1]));
// Set the elements defined in aElements to the colors defined
// in aNewColors
SetSysColors(2, aElements, aNewColors);
printf("\nWindow background and active border have been changed.\n");
printf("Reverting to previous colors in 10 seconds...\n");
Sleep(10000);
// Restore the elements to their original colors
SetSysColors(2, aElements, aOldColors);
}
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winuser.h (inclua Windows.h) |
| Biblioteca | User32.lib |
| DLL | User32.dll |