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 de

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

dwFlags

Tipo: DWORD de

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 y PANTALLA DE IMPRESIÓN.
HCF_CONFIRMHOTKEY 0x00000008	Aparece un cuadro de diálogo de confirmación cuando se activa la característica de contraste alto mediante la tecla activa.
HCF_HOTKEYSOUND 0x00000010	Se reproduce una sirena cuando el usuario activa o desactiva la característica de contraste alto mediante la tecla activa.
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 activa 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 incluso si el tema no se está cambiando. 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 No se debe usar la marca HCF_OPTION_NOTHEMECHANGE 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 incluso si el tema no se está cambiando. 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 No se debe usar la marca HCF_OPTION_NOTHEMECHANGE al alternar el modo de contraste alto (HCF_HIGHCONTRASTON).

lpszDefaultScheme

Tipo: LPTSTR de

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 y lo libera con LocalFree.

Observaciones

Una aplicación usa esta estructura al llamar al función SystemParametersInfoW con el valor de SPI_GETHIGHCONTRAST o SPI_SETHIGHCONTRAST. Al usar SPI_GETHIGHCONTRAST, una aplicación debe especificar el miembro cbSize de la estructura HIGHCONTRAST de ; La función SystemParametersInfo rellena los miembros restantes. Una aplicación debe especificar todos los miembros de estructura al usar el valor 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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
encabezado de	winuser.h (incluya Windows.h)

Consulte también

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