Struttura HIGHCONTRASTA (winuser.h)

Contiene informazioni sulla funzionalità di accessibilità a contrasto elevato. Questa funzionalità imposta lo schema di aspetto dell'interfaccia utente per la massima visibilità per un utente con problemi visivi e consiglia alle applicazioni di rispettare questo schema di aspetto.

Sintassi

typedef struct tagHIGHCONTRASTA {
  UINT  cbSize;
  DWORD dwFlags;
  LPSTR lpszDefaultScheme;
} HIGHCONTRASTA, *LPHIGHCONTRASTA;

Members

cbSize

Tipo: UINT

Specifica le dimensioni, in byte, di questa struttura.

dwFlags

Tipo: DWORD

Specifica una combinazione dei valori seguenti:

Valore	Significato
HCF_HIGHCONTRASTON 0x00000001	La funzionalità a contrasto elevato è attiva.
HCF_AVAILABLE 0x00000002	La funzionalità a contrasto elevato è disponibile.
HCF_HOTKEYACTIVE 0x00000004	L'utente può attivare e disattivare la funzionalità a contrasto elevato premendo contemporaneamente i tasti ALT sinistro, MAIUSC a sinistra e PRINT SCREEN.
HCF_CONFIRMHOTKEY 0x00000008	Viene visualizzata una finestra di dialogo di conferma quando la funzionalità a contrasto elevato viene attivata usando il tasto di scelta rapida.
HCF_HOTKEYSOUND 0x00000010	Una sirena viene riprodotta quando l'utente attiva o disattiva la caratteristica a contrasto elevato usando il tasto di scelta rapida.
HCF_INDICATOR 0x00000020	Viene visualizzato un indicatore visivo quando la funzionalità a contrasto elevato è attiva. Questo valore non viene attualmente usato e viene ignorato.
HCF_HOTKEYAVAILABLE 0x00000040	È possibile abilitare la chiave di scelta rapida associata alla funzionalità a contrasto elevato. Un'applicazione può recuperare questo valore, ma non può impostarla.
HCF_OPTION_NOTHEMECHANGE 0x00001000	Il passaggio di HIGHCONTRASTSTRUCTURE nelle chiamate a SystemParametersInfoA può causare effetti di modifica dei temi anche se il tema non viene modificato. Ad esempio, il messaggio WM_THEMECHANGED viene inviato a Windows anche se l'unica modifica è HCF_HOTKEYSOUND. Per evitare questo problema, includere il flag di HCF_OPTION_NOTHEMECHANGE nella chiamata a SystemParametersInfo. Nota Il flag HCF_OPTION_NOTHEMECHANGE non deve essere usato quando si attiva la modalità a contrasto elevato (HCF_HIGHCONTRASTON).

lpszDefaultScheme

Tipo: LPTSTR

Punta a una stringa contenente il nome della combinazione di colori che verrà impostata sullo schema predefinito.

Commenti

Un'applicazione usa questa struttura quando si chiama lafunzione SystemParametersInfoA con il valore SPI_GETHIGHCONTRAST o SPI_SETHIGHCONTRAST . Quando si usa SPI_GETHIGHCONTRAST, un'applicazione deve specificare il membro cbSize della struttura HIGHCONTRAST ; la funzione SystemParametersInfo riempie i membri rimanenti. Un'applicazione deve specificare tutti i membri della struttura quando si usa il valore SPI_SETHIGHCONTRAST .

Nota

L'intestazione winuser.h definisce HIGHCONTRAST come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	winuser.h (include Windows.h)

Vedi anche

Funzione SystemParametersInfoA, struttura HIGHCONTRASTW, Strutture di accessibilità, SystemParametersInfo