Estructura HIGHCONTRASTW (winuser.h)

Contiene información sobre la característica de accesibilidad de contraste alto. Esta característica establece el esquema de apariencia de la interfaz de usuario para obtener la máxima visibilidad de un usuario con discapacidad visual y aconseja a las aplicaciones que cumplan este esquema de apariencia.

Sintaxis

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

Miembros

cbSize

Tipo: UINT

Especifica el tamaño, en bytes, de esta estructura.

dwFlags

Tipo: DWORD

Especifica una combinación de los valores siguientes:

Valor	Significado
HCF_HIGHCONTRASTON 0x00000001	La característica de contraste alto está activada.
HCF_AVAILABLE 0x00000002	La característica de contraste alto está disponible.
HCF_HOTKEYACTIVE 0x00000004	El usuario puede activar y desactivar la característica de contraste alto presionando simultáneamente las teclas ALT izquierda, MAYÚS izquierda e IMPRIMIR PANTALLA.
HCF_CONFIRMHOTKEY 0x00000008	Aparece un cuadro de diálogo de confirmación cuando se activa la característica de contraste alto mediante la tecla de acceso rápido.
HCF_HOTKEYSOUND 0x00000010	Se reproduce una sirena cuando el usuario activa o desactiva la característica de contraste alto mediante la tecla de acceso rápido.
HCF_INDICATOR 0x00000020	Se muestra un indicador visual cuando la característica de contraste alto está activada. Este valor no se usa actualmente y se omite.
HCF_HOTKEYAVAILABLE 0x00000040	La tecla de acceso rápido asociada a la característica de contraste alto se puede habilitar. Una aplicación puede recuperar este valor, pero no puede establecerlo.
HCF_OPTION_NOTHEMECHANGE 0x00001000	Pasar HIGHCONTRASTSTRUCTURE en llamadas a SystemParametersInfoW puede provocar efectos de cambio de tema aunque el tema no se cambie. Por ejemplo, el mensaje WM_THEMECHANGED se envía a Windows aunque el único cambio sea HCF_HOTKEYSOUND. Para evitar esto, incluya la marca HCF_OPTION_NOTHEMECHANGE en la llamada a SystemParametersInfo. Nota La marca HCF_OPTION_NOTHEMECHANGE no debe usarse al alternar el modo de contraste alto (HCF_HIGHCONTRASTON).
HCF_OPTION_NOTHEMECHANGE 0x00001000	Pasar HIGHCONTRASTSTRUCTURE en llamadas a SystemParametersInfoW puede provocar efectos de cambio de tema aunque el tema no se cambie. Por ejemplo, el mensaje WM_THEMECHANGED se envía a Windows aunque el único cambio sea HCF_HOTKEYSOUND. Para evitar esto, incluya la marca HCF_OPTION_NOTHEMECHANGE en la llamada a SystemParametersInfo. Nota La marca HCF_OPTION_NOTHEMECHANGE no debe usarse al alternar el modo de contraste alto (HCF_HIGHCONTRASTON).

lpszDefaultScheme

Tipo: LPTSTR

Apunta a una cadena que contiene el nombre de la combinación de colores que se establecerá en la combinación predeterminada. El sistema asigna este búfer, liberándolo con LocalFree.

Comentarios

Una aplicación usa esta estructura al llamar a lafunción SystemParametersInfoW con el valor SPI_GETHIGHCONTRAST o SPI_SETHIGHCONTRAST . Al usar SPI_GETHIGHCONTRAST, una aplicación debe especificar el miembro cbSize de la estructura HIGHCONTRAST ; La función SystemParametersInfo rellena los miembros restantes. Una aplicación debe especificar todos los miembros de estructura al usar el valor de SPI_SETHIGHCONTRAST .

Nota

El encabezado winuser.h define HIGHCONTRAST como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	winuser.h (incluir Windows.h)

Consulte también

Función SystemParametersInfoW, estructura HIGHCONTRASTA, Estructuras de accesibilidad, SystemParametersInfo