Struttura HIGHCONTRASTA (winuser.h)

Articolo
11/20/2024

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 di vista e consiglia alle applicazioni di rispettare questo schema di aspetto.

Sintassi

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

Membri

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à di contrasto elevato è attivata.
HCF_AVAILABLE 0x00000002	La funzionalità di contrasto elevato è disponibile.
HCF_HOTKEYACTIVE 0x00000004	L'utente può attivare e disattivare la funzionalità a contrasto elevato premendo contemporaneamente i tasti ALT sinistro, MAIUSC sinistro e STAMPA SCHERMO.
HCF_CONFIRMHOTKEY 0x00000008	Viene visualizzata una finestra di dialogo di conferma quando la funzionalità a contrasto elevato viene attivata tramite 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	Quando la funzionalità a contrasto elevato è attivata, viene visualizzato un indicatore visivo. Questo valore non è attualmente utilizzato e viene ignorato.
HCF_HOTKEYAVAILABLE 0x00000040	È possibile abilitare il tasto di scelta rapida associato alla funzionalità a contrasto elevato. Un'applicazione può recuperare questo valore, ma non può impostarlo.
HCF_OPTION_NOTHEMECHANGE 0x00001000	Il passaggio di HIGHCONTRASTSTRUCTURE nelle chiamate a SystemParametersInfoA può causare effetti di modifica del tema anche se il tema non viene modificato. Ad esempio, il messaggio WM_THEMECHANGED viene inviato a Windows anche se l'unica modifica consiste nel HCF_HOTKEYSOUND. Per evitare questo problema, includere il flag HCF_OPTION_NOTHEMECHANGE nella chiamata a SystemParametersInfo. Nota Il flag HCF_OPTION_NOTHEMECHANGE non deve essere usato quando si attiva o disattiva la modalità a contrasto elevato (HCF_HIGHCONTRASTON).

lpszDefaultScheme

Tipo: LPTSTR

Punta a una stringa contenente il nome della combinazione di colori che verrà impostata sulla combinazione predefinita.

Osservazioni

Un'applicazione usa questa struttura quando si chiama la funzione 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 utilizza 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
intestazione	winuser.h (include Windows.h)

Vedere anche

funzione SystemParametersInfoA, struttura HIGHCONTRASTW, Accessibility Structures, SystemParametersInfo

Condividi tramite