Enabling High Contrast
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/9/2008
O alto-opção contraste indica se um aplicativo deve usar um alto contraste entre as cores usadas para elementos visuais primeiro plano e segundo plano.
O usuário pode controle a configuração de alto-opção contraste usando o Exibição Guia das Acessibilidade Aplicativo do Painel de controle ou outro aplicativo para personalizar o ambiente. Aplicativos usam os sinalizadores SPI_GETHIGHCONTRAST e SPI_SETHIGHCONTRAST com o SystemParametersInfo função get e definir o alto-opção contraste.
Quando um aplicativo é inicializado e quando ele processa mensagens WM_SYSCOLORCHANGE, o aplicativo deve determinar o estado de alto-opção contraste. Para fazer essa determinação, o aplicativo deve chamar SystemParametersInfo Com o uiAction parâmetro definido como sinalizador SPI_GETHIGHCONTRAST e o uiParam parâmetro definido para o tamanho das HIGHCONTRAST estrutura para obter um HIGHCONTRAST estrutura. Se o valor da dwFlags membro das HIGHCONTRAST estrutura inclui o sinalizador HCF_HIGHCONTRASTON e o alto - opção contraste está habilitado. Quando o alto-opção contraste é habilitado, um aplicativo deve executar o seguinte tarefas para garantir visibilidade máxima de interface de usuário para usuários com visão baixa:
- Mapear todas as cores para um único par de cores primeiro plano e segundo plano. Use o GetSysColor função para determinar o apropriado cores primeiro plano e segundo plano, usando a uma combinação de COLOR_WINDOWTEXT e COLOR_WINDOW ou uma combinação de COLOR_BTNTEXT e COLOR_BTNFACE. O GetSysColor função retorna as cores que o usuário selecionou através de Acessibilidade Painel de controle.
- Omita as imagens de bitmap que você exibir no segundo plano atrás do texto. Essas imagens visualmente distraem um usuário que precisa alto contraste.
- Desenhar imagens que você faria normalmente desenhar em múltiplo cores usando apenas as cores primeiro plano e segundo plano selecionadas para texto.
Um aplicativo pode ativar o alto-opção contraste por chamado SystemParametersInfo Com uiAction Definir como SPI_SETHIGHCONTRAST, uiParam Definido para o tamanho das HIGHCONTRAST estrutura e o pvParam parâmetro definido como um ponteiro para um HIGHCONTRAST estrutura que contém o alto-contraste parâmetros que você desejar usar. Você deve definir o sinalizador HCF_HIGHCONTRASTON in a dwFlags membro das ACCESSTIMEOUT estrutura que você transmitir para SystemParametersInfo.
O seguinte exemplo de código mostra como habilitar o contraste de alta - opção contraste e definir o esquema de cores para alta - branco.
HIGHCONTRAST hcf;
BOOL bSuccess;
// Fill in the members of the HIGHCONTRAST structure.
hcf.cbSize = sizeof(HIGHCONTRAST);
hcf.dwFlags = (HCF_AVAILABLE | HCF_HIGHCONTRASTON);
hcf.lpszDefaultScheme = TEXT("High Contrast White");
// Call SystemParametersInfo with the SPI_SETHIGHCONTRAST flag.
bSuccess = SystemParametersInfo(SPI_SETHIGHCONTRAST, sizeof(HIGHCONTRAST),
(LPVOID) &hcf, 0);