Estructura HIGHCONTRASTA (winuser.h)

  • Artículo

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

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

dwFlags

Tipo: DWORD

Especifica una combinación de los valores siguientes:

Value 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 SystemParametersInfoA 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.

Observaciones

Una aplicación usa esta estructura al llamar a lafunción SystemParametersInfoA 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

   
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 SystemParametersInfoA, estructura HIGHCONTRASTW, Estructuras de accesibilidad, SystemParametersInfo