Estrutura HIGHCONTRASTW (winuser.h)

Artigo
11/20/2024

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, 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 hot.
HCF_HOTKEYSOUND 0x00000010	Uma sirene é reproduzida quando o usuário ativa ou desativa o recurso de alto contraste usando a tecla hot.
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 se o tema não estiver 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. Nota 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 se o tema não estiver 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. Nota 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.

Observações

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

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
cabeçalho	winuser.h (inclua Windows.h)

Consulte também

de função SystemParametersInfoW, de estrutura HIGHCONTRASTA, estruturas de acessibilidade , SystemParametersInfo

Compartilhar via