Estrutura HIGHCONTRASTW (winuser.h)

Contém informações sobre o recurso de acessibilidade de alto contraste. Esse recurso define o esquema de aparência da interface do usuário para visibilidade máxima para um usuário com deficiência visual e aconselha os aplicativos a cumprir esse esquema de aparência.

Sintaxe

typedef struct tagHIGHCONTRASTW {
  UINT   cbSize;
  DWORD  dwFlags;
  LPWSTR lpszDefaultScheme;
} HIGHCONTRASTW, *LPHIGHCONTRASTW;

Membros

cbSize

Tipo: UINT

Especifica o tamanho, em bytes, dessa estrutura.

dwFlags

Tipo: DWORD

Especifica uma combinação dos seguintes valores:

Valor	Significado
HCF_HIGHCONTRASTON 0x00000001	O recurso de alto contraste está ativado.
HCF_AVAILABLE 0x00000002	O recurso de alto contraste está disponível.
HCF_HOTKEYACTIVE 0x00000004	O usuário pode ativar e desativar o recurso de alto contraste pressionando simultaneamente as teclas ALT esquerda, SHIFT esquerda e PRINT SCREEN.
HCF_CONFIRMHOTKEY 0x00000008	Uma caixa de diálogo de confirmação é exibida quando o recurso de alto contraste é ativado usando a tecla de acesso.
HCF_HOTKEYSOUND 0x00000010	Uma sirene é reproduzida quando o usuário ativa ou desativa o recurso de alto contraste usando a tecla de acesso.
HCF_INDICATOR 0x00000020	Um indicador visual é exibido quando o recurso de alto contraste está ativado. Esse valor não é usado no momento e é ignorado.
HCF_HOTKEYAVAILABLE 0x00000040	A tecla de acesso associada ao recurso de alto contraste pode ser habilitada. Um aplicativo pode recuperar esse valor, mas não pode defini-lo.
HCF_OPTION_NOTHEMECHANGE 0x00001000	Passar HIGHCONTRASTSTRUCTURE em chamadas para SystemParametersInfoW pode causar efeitos de alteração de tema mesmo que o tema não esteja sendo alterado. Por exemplo, a mensagem WM_THEMECHANGED é enviada ao Windows mesmo que a única alteração seja HCF_HOTKEYSOUND. Para evitar isso, inclua o sinalizador HCF_OPTION_NOTHEMECHANGE na chamada para SystemParametersInfo. Observação O sinalizador HCF_OPTION_NOTHEMECHANGE não deve ser usado ao alternar o modo de alto contraste (HCF_HIGHCONTRASTON).
HCF_OPTION_NOTHEMECHANGE 0x00001000	Passar HIGHCONTRASTSTRUCTURE em chamadas para SystemParametersInfoW pode causar efeitos de alteração de tema mesmo que o tema não esteja sendo alterado. Por exemplo, a mensagem WM_THEMECHANGED é enviada ao Windows mesmo que a única alteração seja HCF_HOTKEYSOUND. Para evitar isso, inclua o sinalizador HCF_OPTION_NOTHEMECHANGE na chamada para SystemParametersInfo. Observação O sinalizador HCF_OPTION_NOTHEMECHANGE não deve ser usado ao alternar o modo de alto contraste (HCF_HIGHCONTRASTON).

lpszDefaultScheme

Tipo: LPTSTR

Aponta para uma cadeia de caracteres que contém o nome do esquema de cores que será definido como o esquema padrão. O sistema aloca esse buffer, libere-o com LocalFree.

Comentários

Um aplicativo usa essa estrutura ao chamar afunção SystemParametersInfoW com o valor SPI_GETHIGHCONTRAST ou SPI_SETHIGHCONTRAST . Ao usar SPI_GETHIGHCONTRAST, um aplicativo deve especificar o membro cbSize da estrutura HIGHCONTRAST ; a função SystemParametersInfo preenche os membros restantes. Um aplicativo deve especificar todos os membros da estrutura ao usar o valor SPI_SETHIGHCONTRAST .

Observação

O cabeçalho winuser.h define HIGHCONTRAST como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
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]
Cabeçalho	winuser.h (inclua Windows.h)

Confira também

Função SystemParametersInfoW, estrutura HIGHCONTRASTA, Estruturas de Acessibilidade, SystemParametersInfo