Compartir a través de

Estructura HIGHCONTRASTA (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 tagHIGHCONTRASTA {
  UINT  cbSize;
  DWORD dwFlags;
  LPSTR lpszDefaultScheme;
} HIGHCONTRASTA, *LPHIGHCONTRASTA;

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 SystemParametersInfoA puede provocar efectos de cambio de tema incluso si el tema no se cambia. 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.

Observaciones

Una aplicación usa esta estructura al llamar a la función SystemParametersInfoA de 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 SystemParametersInfoA, estructura HIGHCONTRASTW, Estructuras de accesibilidad, SystemParametersInfo

  • Last updated on