Compartir a través de


Función SystemParametersInfoA (winuser.h)

Importante

Cierta información se relaciona con un producto de versión preliminar que puede modificarse sustancialmente antes de su lanzamiento comercial. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Recupera o establece el valor de uno de los parámetros de todo el sistema. Esta función también puede actualizar el perfil de usuario al establecer un parámetro.

Sintaxis

BOOL SystemParametersInfoA(
  [in]      UINT  uiAction,
  [in]      UINT  uiParam,
  [in, out] PVOID pvParam,
  [in]      UINT  fWinIni
);

Parámetros

[in] uiAction

Tipo: UINT

Parámetro para todo el sistema que se va a recuperar o establecer. Los valores posibles se organizan en las tablas siguientes de parámetros relacionados:

  • Parámetros de accesibilidad
  • Parámetros de escritorio
  • Parámetros de icono
  • Parámetros de entrada
  • Parámetros de menú
  • Parámetros de energía
  • Parámetros del protector de pantalla
  • Parámetros de tiempo de espera
  • Parámetros de efecto de la interfaz de usuario
  • Parámetros de ventana

A continuación se muestran los parámetros de accesibilidad.

Parámetro de accesibilidad Significado
SPI_GETACCESSTIMEOUT
0x003C
Recupera información sobre el período de tiempo de espera asociado a las características de accesibilidad. El parámetro pvParam debe apuntar a una estructura ACCESSTIMEOUT que recibe la información. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(ACCESSTIMEOUT).
SPI_GETAUDIODESCRIPTION
0x0074
Determina si las descripciones de audio están habilitadas o deshabilitadas. El parámetro pvParam es un puntero a una estructura AUDIODESCRIPTION . Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(AUDIODESCRIPTION).

Aunque es posible que los usuarios que tienen discapacidades visuales escuchen el audio en el contenido de vídeo, hay una gran cantidad de acción en el vídeo que no tiene el audio correspondiente. Una descripción de audio específica de lo que sucede en un vídeo ayuda a estos usuarios a comprender mejor el contenido. Esta marca le permite determinar si se han habilitado las descripciones de audio y en qué idioma.

Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_GETCLIENTAREAANIMATION
0x1042
Determina si las animaciones están habilitadas o deshabilitadas. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si las animaciones están habilitadas o FALSE en caso contrario.

Las características de visualización, como parpadear, parpadear, parpadear y mover contenido pueden causar convulsiones en los usuarios con epilepsia foto-sensible. Esta marca permite determinar si estas animaciones se han deshabilitado en el área de cliente.

Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_GETDISABLEOVERLAPPEDCONTENT
0x1040
Determina si el contenido superpuesto está habilitado o deshabilitado. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si está habilitado o FALSE de lo contrario.

Las características de visualización, como imágenes de fondo, fondos con textura, marcas de agua en documentos, combinación alfa y transparencia pueden reducir el contraste entre el primer plano y el fondo, lo que dificulta a los usuarios con visión baja ver objetos en la pantalla. Esta marca le permite determinar si dicho contenido superpuesto se ha deshabilitado.

Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_GETFILTERKEYS
0x0032
Recupera información sobre la característica de accesibilidad FilterKeys. El parámetro pvParam debe apuntar a una estructura FILTERKEYS que recibe la información. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(FILTERKEYS).
SPI_GETFOCUSBORDERHEIGHT
0x2010
Recupera el alto, en píxeles, de los bordes superior e inferior del rectángulo de foco dibujado con DrawFocusRect. El parámetro pvParam debe apuntar a un valor UINT .

Windows 2000: Este parámetro no se admite.

SPI_GETFOCUSBORDERWIDTH
0x200E
Recupera el ancho, en píxeles, de los bordes izquierdo y derecho del rectángulo de foco dibujado con DrawFocusRect. El parámetro pvParam debe apuntar a un UINT.

Windows 2000: Este parámetro no se admite.

SPI_GETHIGHCONTRAST
0x0042
Recupera información sobre la característica de accesibilidad HighContrast. El parámetro pvParam debe apuntar a una estructura HIGHCONTRAST que recibe la información. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(HIGHCONTRAST).

Para obtener una discusión general, vea Comentarios.

SPI_GETLOGICALDPIOVERRIDE
0x009E
Recupera un valor que determina si Windows 8 muestra las aplicaciones mediante el nivel de escalado predeterminado para el hardware o va a la siguiente meseta superior. Este valor se basa en la configuración actual "Hacer todo en la pantalla más grande", que se encuentra en la sección Facilidad de acceso dela configuración del EQUIPO: 1 está activado, 0 está desactivado.

Las aplicaciones pueden proporcionar recursos de texto e imagen para cada una de varias mesetas de escalado: 100 %, 140 % y 180 %. Proporcionar recursos independientes optimizados para una escala determinada evita la distorsión debido al cambio de tamaño. Windows 8 determina la meseta de escala adecuada en función de varios factores, incluido el tamaño de pantalla y la densidad de píxeles. Cuando se selecciona "Hacer todo en la pantalla más grande" (SPI_GETLOGICALDPIOVERRIDE devuelve un valor de 1), Windows usa recursos de la siguiente meseta superior. Por ejemplo, en el caso del hardware que Windows determina debe usar una escala de SCALE_100_PERCENT, esta invalidación hace que Windows use el valor de escala de SCALE_140_PERCENT , suponiendo que no infringe otras restricciones.

Nota No debe usar este valor. Puede modificarse o no estar disponible en versiones posteriores de Windows. En su lugar, use la función GetScaleFactorForDevice o la clase DisplayProperties para recuperar el factor de escalado preferido. Las aplicaciones de escritorio deben usar ppp lógicos de escritorio en lugar de factor de escala. Ppp lógico de escritorio se puede recuperar a través de la función GetDeviceCaps .
 
SPI_GETMESSAGEDURATION
0x2016
Recupera la hora en que se deben mostrar los elementos emergentes de notificación, en segundos. El parámetro pvParam debe apuntar a un ULONG que reciba la duración del mensaje.

Es posible que los usuarios con discapacidades visuales o condiciones cognitivas, como el TDAH y la dislexia, necesiten más tiempo para leer el texto en los mensajes de notificación. Esta marca le permite recuperar la duración del mensaje.

Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_GETMOUSECLICKLOCK
0x101E
Recupera el estado de la característica ClickLock del mouse. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si está habilitado o FALSE de lo contrario. Para obtener más información, vea Información general sobre la entrada del mouse.

Windows 2000: Este parámetro no se admite.

SPI_GETMOUSECLICKLOCKTIME
0x2008
Recupera el retraso de tiempo antes de que se bloquee el botón primario del mouse. El parámetro pvParam debe apuntar a DWORD que recibe el retraso de tiempo, en milisegundos. Esto solo está habilitado si SPI_SETMOUSECLICKLOCK está establecido en TRUE. Para obtener más información, vea Información general sobre la entrada del mouse.

Windows 2000: Este parámetro no se admite.

SPI_GETMOUSEKEYS
0x0036
Recupera información sobre la característica de accesibilidad MouseKeys. El parámetro pvParam debe apuntar a una estructura MOUSEKEYS que recibe la información. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(MOUSEKEYS).
SPI_GETMOUSESONAR
0x101C
Recupera el estado de la característica Sonar del mouse. El parámetro pvParam debe apuntar a una variable BOOL que reciba TRUE si está habilitado o FALSE en caso contrario. Para obtener más información, vea Información general sobre la entrada del mouse.

Windows 2000: Este parámetro no se admite.

SPI_GETMOUSEVANISH
0x1020
Recupera el estado de la característica Desvanecimiento del mouse. El parámetro pvParam debe apuntar a una variable BOOL que reciba TRUE si está habilitado o FALSE en caso contrario. Para obtener más información, vea Información general sobre la entrada del mouse.

Windows 2000: Este parámetro no se admite.

SPI_GETSCREENREADER
0x0046
Determina si se está ejecutando una utilidad de revisor de pantalla. Una utilidad de revisor de pantalla dirige información textual a un dispositivo de salida, como un sintetizador de voz o una pantalla de Braille. Cuando se establece esta marca, una aplicación debe proporcionar información textual en situaciones en las que, de lo contrario, presentaría la información gráficamente.

El parámetro pvParam es un puntero a una variable BOOL que recibe TRUE si se está ejecutando una utilidad de revisor de pantalla o FALSE en caso contrario.

Nota Narrador, el lector de pantalla que se incluye con Windows, no establece las marcas SPI_SETSCREENREADER ni SPI_GETSCREENREADER .
 
SPI_GETSERIALKEYS
0x003E
Este parámetro no se admite.

Windows Server 2003 y Windows XP/2000: El usuario debe controlar esta configuración a través del Panel de control.

SPI_GETSHOWSOUNDS
0x0038
Determina si la marca de accesibilidad Mostrar sonidos está activada o desactivada. Si está activado, el usuario requiere que una aplicación presente información visualmente en situaciones en las que, de lo contrario, presentaría la información únicamente en forma audible. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si la característica está activada o FALSE si está desactivada.

El uso de este valor equivale a llamar a GetSystemMetrics con SM_SHOWSOUNDS. Esa es la llamada recomendada.

SPI_GETSOUNDSENTRY
0x0040
Recupera información sobre la característica de accesibilidad SoundSentry. El parámetro pvParam debe apuntar a una estructura SOUNDSENTRY que recibe la información. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(SOUNDSENTRY).
SPI_GETSTICKYKEYS
0x003A
Recupera información sobre la característica de accesibilidad StickyKeys. El parámetro pvParam debe apuntar a una estructura STICKYKEYS que recibe la información. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(STICKYKEYS).
SPI_GETTOGGLEKEYS
0x0034
Recupera información sobre la característica de accesibilidad ToggleKeys. El parámetro pvParam debe apuntar a una estructura TOGGLEKEYS que recibe la información. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(TOGGLEKEYS).
SPI_SETACCESSTIMEOUT
0x003D
Establece el período de tiempo de espera asociado a las características de accesibilidad. El parámetro pvParam debe apuntar a una estructura ACCESSTIMEOUT que contenga los nuevos parámetros. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(ACCESSTIMEOUT).
SPI_SETAUDIODESCRIPTION
0x0075
Activa o desactiva la característica de descripciones de audio. El parámetro pvParam es un puntero a una estructura AUDIODESCRIPTION .

Aunque es posible que los usuarios con discapacidades visuales escuchen el audio en el contenido de vídeo, hay una gran cantidad de acciones en el vídeo que no tiene el audio correspondiente. Una descripción de audio específica de lo que sucede en un vídeo ayuda a estos usuarios a comprender mejor el contenido. Esta marca le permite habilitar o deshabilitar descripciones de audio en los idiomas en los que se proporcionan.

Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_SETCLIENTAREAANIMATION
0x1043
Activa o desactiva las animaciones de área de cliente. El parámetro pvParam es una variable BOOL . Establezca pvParam en TRUE para habilitar animaciones y otros efectos transitorios en el área de cliente, o FALSE para deshabilitarlas.

Las características de visualización, como parpadear, parpadear, parpadear y mover contenido pueden causar convulsiones en los usuarios con epilepsia foto-sensible. Esta marca te permite habilitar o deshabilitar todas estas animaciones.

Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_SETDISABLEOVERLAPPEDCONTENT
0x1041
Activa o desactiva el contenido superpuesto (como imágenes de fondo y marcas de agua). El parámetro pvParam es una variable BOOL . Establezca pvParam en TRUE para deshabilitar el contenido superpuesto o FALSE para habilitar el contenido superpuesto.

Las características de visualización, como imágenes de fondo, fondos con textura, marcas de agua en documentos, combinación alfa y transparencia pueden reducir el contraste entre el primer plano y el fondo, lo que dificulta a los usuarios con visión baja ver objetos en la pantalla. Esta marca le permite habilitar o deshabilitar todo este contenido superpuesto.

Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_SETFILTERKEYS
0x0033
Establece los parámetros de la característica de accesibilidad FilterKeys. El parámetro pvParam debe apuntar a una estructura FILTERKEYS que contenga los nuevos parámetros. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(FILTERKEYS).
SPI_SETFOCUSBORDERHEIGHT
0x2011
Establece el alto de los bordes superior e inferior del rectángulo de foco dibujado con DrawFocusRect en el valor del parámetro pvParam .

Windows 2000: Este parámetro no se admite.

SPI_SETFOCUSBORDERWIDTH
0x200F
Establece el alto de los bordes izquierdo y derecho del rectángulo de foco dibujado con DrawFocusRect en el valor del parámetro pvParam .

Windows 2000: Este parámetro no se admite.

SPI_SETHIGHCONTRAST
0x0043
Establece los parámetros de la característica de accesibilidad HighContrast. El parámetro pvParam debe apuntar a una estructura HIGHCONTRAST que contenga los nuevos parámetros. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(HIGHCONTRAST).
SPI_SETLOGICALDPIOVERRIDE
0x009F
No debe usarse.
SPI_SETMESSAGEDURATION
0x2017
Establece la hora en que se deben mostrar los elementos emergentes de notificación, en segundos. El parámetro pvParam especifica la duración del mensaje.

Es posible que los usuarios con discapacidades visuales o condiciones cognitivas, como el TDAH y la dislexia, necesiten más tiempo para leer el texto en los mensajes de notificación. Esta marca le permite establecer la duración del mensaje.

Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_SETMOUSECLICKLOCK
0x101F
Activa o desactiva la característica de accesibilidad ClickLock del mouse. Esta característica bloquea temporalmente el botón primario del mouse cuando se hace clic en ese botón y se mantiene inactivo durante el tiempo especificado por SPI_SETMOUSECLICKLOCKTIME. El parámetro pvParam especifica TRUE para activado o FALSE para off. El valor predeterminado es off. Para obtener más información, vea Comentarios y AboutMouse Input.

Windows 2000: Este parámetro no se admite.

SPI_SETMOUSECLICKLOCKTIME
0x2009
Ajusta el retraso de tiempo antes de que se bloquee el botón primario del mouse. El parámetro uiParam debe establecerse en 0. El parámetro pvParam apunta a un DWORD que especifica el retraso de tiempo en milisegundos. Por ejemplo, especifique 1000 para un retraso de 1 segundo. El valor predeterminado es 1200. Para obtener más información, vea Información general sobre la entrada del mouse.

Windows 2000: Este parámetro no se admite.

SPI_SETMOUSEKEYS
0x0037
Establece los parámetros de la característica de accesibilidad MouseKeys. El parámetro pvParam debe apuntar a una estructura MOUSEKEYS que contenga los nuevos parámetros. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(MOUSEKEYS).
SPI_SETMOUSESONAR
0x101D
Activa o desactiva la característica de accesibilidad de Sonar. Esta característica muestra brevemente varios círculos concéntricos alrededor del puntero del mouse cuando el usuario presiona y suelta la tecla CTRL. El parámetro pvParam especifica TRUE para on y FALSE para off. El valor predeterminado es off. Para obtener más información, vea Información general sobre la entrada del mouse.

Windows 2000: Este parámetro no se admite.

SPI_SETMOUSEVANISH
0x1021
Activa o desactiva la característica Desvanecimiento. Esta característica oculta el puntero del mouse cuando el usuario escribe; el puntero vuelve a aparecer cuando el usuario mueve el mouse. El parámetro pvParam especifica TRUE para on y FALSE para off. El valor predeterminado es off. Para obtener más información, vea Información general sobre la entrada del mouse.

Windows 2000: Este parámetro no se admite.

SPI_SETSCREENREADER
0x0047
Determina si se está ejecutando una utilidad de revisión de pantalla. El parámetro uiParam especifica TRUE para activado o FALSE para off.
Nota Narrador, el lector de pantalla que se incluye con Windows, no establece las marcas SPI_SETSCREENREADER ni SPI_GETSCREENREADER .
 
SPI_SETSERIALKEYS
0x003F
Este parámetro no se admite.

Windows Server 2003 y Windows XP/2000: El usuario debe controlar esta configuración a través del Panel de control.

SPI_SETSHOWSOUNDS
0x0039
Activa o desactiva la característica de accesibilidad ShowSounds. El parámetro uiParam especifica TRUE para activado o FALSE para off.
SPI_SETSOUNDSENTRY
0x0041
Establece los parámetros de la característica de accesibilidad SoundSentry . El parámetro pvParam debe apuntar a una estructura SOUNDSENTRY que contenga los nuevos parámetros. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(SOUNDSENTRY).
SPI_SETSTICKYKEYS
0x003B
Establece los parámetros de la característica de accesibilidad StickyKeys. El parámetro pvParam debe apuntar a una estructura STICKYKEYS que contenga los nuevos parámetros. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(STICKYKEYS).
SPI_SETTOGGLEKEYS
0x0035
Establece los parámetros de la característica de accesibilidad ToggleKeys. El parámetro pvParam debe apuntar a una estructura TOGGLEKEYS que contenga los nuevos parámetros. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(TOGGLEKEYS).
 

A continuación se muestran los parámetros de escritorio.

Parámetro de escritorio Significado
SPI_GETCLEARTYPE
0x1048
Determina si ClearType está habilitado. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si ClearType está habilitado o FALSE en caso contrario.

ClearType es una tecnología de software que mejora la legibilidad del texto en monitores de pantalla de cristal líquido (LCD).

Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_GETDESKWALLPAPER
0x0073
Recupera la ruta de acceso completa del archivo de mapa de bits para el fondo de pantalla de escritorio. El parámetro pvParam debe apuntar a un búfer para recibir la cadena de ruta de acceso terminada en null. Establezca el parámetro uiParam en el tamaño, en caracteres, del búfer pvParam . La cadena devuelta no superará MAX_PATH caracteres. Si no hay ningún fondo de pantalla de escritorio, la cadena devuelta está vacía.
SPI_GETDROPSHADOW
0x1024
Determina si el efecto de sombra de colocación está habilitado. El parámetro pvParam debe apuntar a una variable BOOL que devuelva TRUE si está habilitado o FALSE si está deshabilitado.

Windows 2000: Este parámetro no se admite.

SPI_GETFLATMENU
0x1022
Determina si los menús nativos del usuario tienen apariencia de menú plano. El parámetro pvParam debe apuntar a una variable BOOL que devuelva TRUE si se establece la apariencia del menú plano o FALSE en caso contrario.

Windows 2000: Este parámetro no se admite.

SPI_GETFONTSMOOTHING
0x004A
Determina si la característica de suavizado de fuentes está habilitada. Esta característica usa suavizado de suavizado de fuentes para hacer que las curvas de fuente aparezcan más suaves pintando píxeles en diferentes niveles de gris.

El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si la característica está habilitada o FALSE si no lo está.

SPI_GETFONTSMOOTHINGCONTRAST
0x200C
Recupera un valor de contraste que se usa en suavizado ClearType . El parámetro pvParam debe apuntar a un UINT que reciba la información. Los valores de contraste válidos van de 1000 a 2200. El valor predeterminado es 1400.

Windows 2000: Este parámetro no se admite.

SPI_GETFONTSMOOTHINGORIENTATION
0x2012
Recupera la orientación de suavizado de fuente. El parámetro pvParam debe apuntar a un UINT que reciba la información. Los valores posibles son FE_FONTSMOOTHINGORIENTATIONBGR (azul-verde-rojo) y FE_FONTSMOOTHINGORIENTATIONRGB (rojo-verde-azul).

Windows XP/2000: Este parámetro no se admite hasta Windows XP con SP2.

SPI_GETFONTSMOOTHINGTYPE
0x200A
Recupera el tipo de suavizado de fuente. El parámetro pvParam debe apuntar a un UINT que reciba la información. Los valores posibles son FE_FONTSMOOTHINGSTANDARD y FE_FONTSMOOTHINGCLEARTYPE.

Windows 2000: Este parámetro no se admite.

SPI_GETWORKAREA
0x0030
Recupera el tamaño del área de trabajo en el monitor de visualización principal. El área de trabajo es la parte de la pantalla no oculta por la barra de tareas del sistema o por las barras de herramientas de escritorio de la aplicación. El parámetro pvParam debe apuntar a una estructura RECT que recibe las coordenadas del área de trabajo, expresadas en tamaño de píxel físico. Cualquier modo de virtualización de PPP del autor de la llamada no tiene ningún efecto en esta salida.

Para obtener el área de trabajo de un monitor distinto del monitor de visualización principal, llame a la función GetMonitorInfo .

SPI_SETCLEARTYPE
0x1049
Activa o desactiva ClearType. El parámetro pvParam es una variable BOOL . Establezca pvParam en TRUE para habilitar ClearType o FALSE para deshabilitarlo.

ClearType es una tecnología de software que mejora la legibilidad del texto en monitores LCD.

Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_SETCURSORS
0x0057
Vuelve a cargar los cursores del sistema. Establezca el parámetro uiParam en cero y el parámetro pvParam en NULL.
SPI_SETDESKPATTERN
0x0015
Establece el patrón de escritorio actual haciendo que Windows lea el valor Pattern= del archivo WIN.INI.
SPI_SETDESKWALLPAPER
0x0014
Nota Cuando se usa la marca de SPI_SETDESKWALLPAPER , SystemParametersInfo devuelve TRUE a menos que haya un error (como cuando el archivo especificado no existe).
 
SPI_SETDROPSHADOW
0x1025
Habilita o deshabilita el efecto de sombra de colocación. Establezca pvParam en TRUE para habilitar el efecto de sombra de colocación o FALSE para deshabilitarlo. También debe tener CS_DROPSHADOW en el estilo de clase de ventana.

Windows 2000: Este parámetro no se admite.

SPI_SETFLATMENU
0x1023
Habilita o deshabilita la apariencia del menú plano para los menús nativos del usuario. Establezca pvParam en TRUE para habilitar la apariencia del menú plano o FALSE para deshabilitarlo.

Cuando está habilitada, la barra de menús usa COLOR_MENUBAR para el fondo de la barra de menús, COLOR_MENU para el fondo emergente del menú, COLOR_MENUHILIGHT para el relleno de la selección de menú actual y COLOR_HILIGHT para el esquema de la selección de menú actual. Si está deshabilitado, los menús se dibujan con las mismas métricas y colores que en Windows 2000.

Windows 2000: Este parámetro no se admite.

SPI_SETFONTSMOOTHING
0x004B
Habilita o deshabilita la característica de suavizado de fuentes, que usa suavizado de fuente para hacer que las curvas de fuente aparezcan más suaves pintando píxeles en diferentes niveles de gris.

Para habilitar la característica, establezca el parámetro uiParam en TRUE. Para deshabilitar la característica, establezca uiParam en FALSE.

SPI_SETFONTSMOOTHINGCONTRAST
0x200D
Establece el valor de contraste usado en suavizado ClearType . El parámetro pvParam es el valor de contraste. Los valores de contraste válidos van de 1000 a 2200. El valor predeterminado es 1400.

SPI_SETFONTSMOOTHINGTYPE también debe establecerse en FE_FONTSMOOTHINGCLEARTYPE.

Windows 2000: Este parámetro no se admite.

SPI_SETFONTSMOOTHINGORIENTATION
0x2013
Establece la orientación de suavizado de fuente. El parámetro pvParam es FE_FONTSMOOTHINGORIENTATIONBGR (azul-verde-rojo) o FE_FONTSMOOTHINGORIENTATIONRGB (rojo-verde-azul).

Windows XP/2000: Este parámetro no se admite hasta Windows XP con SP2.

SPI_SETFONTSMOOTHINGTYPE
0x200B
Establece el tipo de suavizado de fuente. El parámetro pvParam es FE_FONTSMOOTHINGSTANDARD, si se usa el suavizado de alias estándar o FE_FONTSMOOTHINGCLEARTYPE, si se usa ClearType . El valor predeterminado es FE_FONTSMOOTHINGSTANDARD.

SPI_SETFONTSMOOTHING también se debe establecer.

Windows 2000: Este parámetro no se admite.

SPI_SETWORKAREA
0x002F
Establece el tamaño del área de trabajo. El área de trabajo es la parte de la pantalla no oculta por la barra de tareas del sistema o por las barras de herramientas de escritorio de la aplicación. El parámetro pvParam es un puntero a una estructura RECT que especifica el nuevo rectángulo de área de trabajo, expresado en coordenadas de pantalla virtual. En un sistema con varios monitores de visualización, la función establece el área de trabajo del monitor que contiene el rectángulo especificado.
 

A continuación se muestran los parámetros de icono.

Parámetro icon Significado
SPI_GETICONMETRICS
0x002D
Recupera las métricas asociadas a los iconos. El parámetro pvParam debe apuntar a una estructura ICONMETRICS que recibe la información. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(ICONMETRICS).
SPI_GETICONTITLELOGFONT
0x001F
Recupera la información de fuente lógica de la fuente de título del icono actual. El parámetro uiParam especifica el tamaño de una estructura LOGFONT y el parámetro pvParam debe apuntar a la estructura LOGFONT que se va a rellenar.
SPI_GETICONTITLEWRAP
0x0019
Determina si el ajuste de título de icono está habilitado. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si está habilitado o FALSE de lo contrario.
SPI_ICONHORIZONTALSPACING
0x000D
Establece o recupera el ancho, en píxeles, de una celda de icono. El sistema usa este rectángulo para organizar los iconos en la vista de iconos grandes.

Para establecer este valor, establezca uiParam en el nuevo valor y establezca pvParam en NULL. No se puede establecer este valor en menor que SM_CXICON.

Para recuperar este valor, pvParam debe apuntar a un entero que recibe el valor actual.

SPI_ICONVERTICALSPACING
0x0018
Establece o recupera el alto, en píxeles, de una celda de icono.

Para establecer este valor, establezca uiParam en el nuevo valor y establezca pvParam en NULL. No se puede establecer este valor en menor que SM_CYICON.

Para recuperar este valor, pvParam debe apuntar a un entero que recibe el valor actual.

SPI_SETICONMETRICS
0x002E
Establece las métricas asociadas a los iconos. El parámetro pvParam debe apuntar a una estructura ICONMETRICS que contenga los nuevos parámetros. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(ICONMETRICS).
SPI_SETICONS
0x0058
Vuelve a cargar los iconos del sistema. Establezca el parámetro uiParam en cero y el parámetro pvParam en NULL.
SPI_SETICONTITLELOGFONT
0x0022
Establece la fuente que se usa para los títulos del icono. El parámetro uiParam especifica el tamaño de una estructura LOGFONT y el parámetro pvParam debe apuntar a una estructura LOGFONT .
SPI_SETICONTITLEWRAP
0x001A
Activa o desactiva el ajuste del título del icono. El parámetro uiParam especifica TRUE para activado o FALSE para off.
 

A continuación se muestran los parámetros de entrada. Incluyen parámetros relacionados con el teclado, el mouse, el panel táctil, el lápiz, el idioma de entrada y el beeper de advertencia.

Parámetro de entrada Significado
SPI_GETBEEP
0x0001
Determina si el beeper de advertencia está activado.

El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si el beeper está activado o FALSE si está desactivado.

SPI_GETBLOCKSENDINPUTRESETS
0x1026
Recupera un BOOL que indica si una aplicación puede restablecer el temporizador del protector de pantalla llamando a la función SendInput para simular la entrada del teclado o del mouse. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si se bloqueará la entrada simulada o FALSE de lo contrario.
SPI_GETCONTACTVISUALIZATION
0x2018
Recupera la configuración actual de visualización de contactos. El parámetro pvParam debe apuntar a una variable ULONG que reciba la configuración. Para obtener más información, consulte Visualización de contactos.
SPI_GETDEFAULTINPUTLANG
0x0059
Recupera el identificador de configuración regional de entrada del idioma de entrada predeterminado del sistema. El parámetro pvParam debe apuntar a una variable HKL que recibe este valor. Para obtener más información, vea Idiomas, configuraciones regionales y diseños de teclado.
SPI_GETGESTUREVISUALIZATION
0x201A
Recupera la configuración de visualización de gestos actual. El parámetro pvParam debe apuntar a una variable ULONG que reciba la configuración. Para obtener más información, vea Visualización de gestos.
SPI_GETKEYBOARDCUES
0x100a
Determina si las teclas de acceso del menú siempre están subrayadas. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si las teclas de acceso del menú siempre están subrayadas y FALSE si solo se subrayan cuando el teclado activa el menú.
SPI_GETKEYBOARDDELAY
0x0016
Recupera la configuración de retraso de repetición del teclado, que es un valor del intervalo de 0 (aproximadamente 250 ms de retraso) a 3 (aproximadamente 1 segundo de retraso). El retraso real asociado a cada valor puede variar en función del hardware. El parámetro pvParam debe apuntar a una variable de entero que recibe la configuración.
SPI_GETKEYBOARDPREF
0x0044
Determina si el usuario se basa en el teclado en lugar del mouse y quiere que las aplicaciones muestren interfaces de teclado que, de lo contrario, se ocultarían. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si el usuario se basa en el teclado; o FALSE en caso contrario.
SPI_GETKEYBOARDSPEED
0x000A
Recupera la configuración de velocidad de repetición del teclado, que es un valor en el intervalo de 0 (aproximadamente 2,5 repeticiones por segundo) a 31 (aproximadamente 30 repeticiones por segundo). Las tasas de repetición reales dependen del hardware y pueden variar de una escala lineal hasta un 20 %. El parámetro pvParam debe apuntar a una variable DWORD que reciba la configuración.
SPI_GETMOUSE
0x0003
Recupera los dos valores de umbral del mouse y la aceleración del mouse. El parámetro pvParam debe apuntar a una matriz de tres enteros que recibe estos valores. Consulte mouse_event para obtener más información.
SPI_GETMOUSEHOVERHEIGHT
0x0064
Recupera el alto, en píxeles, del rectángulo dentro del cual el puntero del mouse tiene que permanecer para TrackMouseEvent para generar un mensaje de WM_MOUSEHOVER . El parámetro pvParam debe apuntar a una variable UINT que recibe el alto.
SPI_GETMOUSEHOVERTIME
0x0066
Recupera la hora, en milisegundos, que el puntero del mouse tiene que permanecer en el rectángulo de desplazamiento para TrackMouseEvent para generar un mensaje WM_MOUSEHOVER . El parámetro pvParam debe apuntar a una variable UINT que recibe la hora.
SPI_GETMOUSEHOVERWIDTH
0x0062
Recupera el ancho, en píxeles, del rectángulo en el que el puntero del mouse tiene que permanecer para TrackMouseEvent para generar un mensaje de WM_MOUSEHOVER . El parámetro pvParam debe apuntar a una variable UINT que recibe el ancho.
SPI_GETMOUSESPEED
0x0070
Recupera la velocidad actual del mouse. La velocidad del mouse determina cuánto se moverá el puntero en función de la distancia a la que se mueve el mouse. El parámetro pvParam debe apuntar a un entero que recibe un valor que oscila entre 1 (más lento) y 20 (más rápido). Un valor de 10 es el valor predeterminado. Un usuario final puede establecer el valor mediante la aplicación del panel de control del mouse o una aplicación mediante SPI_SETMOUSESPEED.
SPI_GETMOUSETRAILS
0x005E
Determina si la característica Seguimientos del mouse está habilitada. Esta característica mejora la visibilidad de los movimientos del cursor del mouse mostrando brevemente un rastro de cursores y borrarlos rápidamente.

El parámetro pvParam debe apuntar a una variable entera que recibe un valor. si el valor es cero o 1, la característica está deshabilitada. Si el valor es mayor que 1, la característica está habilitada y el valor indica el número de cursores dibujados en la pista. No se usa el parámetro uiParam .

Windows 2000: Este parámetro no se admite.

SPI_GETMOUSEWHEELROUTING
0x201C
Recupera la configuración de enrutamiento para la entrada de rueda del mouse. La configuración de enrutamiento determina si la entrada de la rueda del mouse se envía a la aplicación con foco (primer plano) o la aplicación bajo el cursor del mouse.

El parámetro pvParam debe apuntar a una variable DWORD que reciba la opción de enrutamiento. No se usa el parámetro uiParam .

Si el valor es cero (MOUSEWHEEL_ROUTING_FOCUS), la entrada de la rueda del mouse se entrega a la aplicación con foco. Si el valor es 1 (MOUSEWHEEL_ROUTING_HYBRID), la entrada de la rueda del mouse se entrega a la aplicación con foco (aplicaciones de escritorio) o la aplicación bajo el puntero del mouse (aplicaciones de la Tienda Windows).

A partir de Windows 10: Si el valor es 2 (MOUSEWHEEL_ROUTING_MOUSE_POS), la entrada de la rueda del mouse se entrega a la aplicación bajo el puntero del mouse. Este es el nuevo valor predeterminado y MOUSEWHEEL_ROUTING_HYBRID ya no está disponible en Configuración.

SPI_GETPENVISUALIZATION
0x201E
Recupera la configuración actual de visualización de gestos de lápiz. El parámetro pvParam debe apuntar a una variable ULONG que reciba la configuración. Para obtener más información, consulte Visualización del lápiz.
SPI_GETSNAPTODEFBUTTON
0x005F
Determina si la característica de botón de ajuste a predeterminado está habilitada. Si está habilitado, el cursor del mouse se mueve automáticamente al botón predeterminado, como Aceptar o Aplicar, de un cuadro de diálogo. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si la característica está activada o FALSE si está desactivada.
SPI_GETSYSTEMLANGUAGEBAR
0x1050
A partir de Windows 8: Determina si la barra de idioma del sistema está habilitada o deshabilitada. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si la barra de idioma está habilitada o FALSE en caso contrario.
SPI_GETTHREADLOCALINPUTSETTINGS
0x104E
A partir de Windows 8: Determina si la configuración de entrada activa tiene ámbito Local (por subproceso, TRUE) o Global (sesión, FALSE). El parámetro pvParam debe apuntar a una variable BOOL .
SPI_GETTOUCHPADPARAMETERS
0x00AE
A partir de Windows 11, versión 24H2: Recupera detalles sobre el Panel táctil de precisión, incluida la configuración del usuario y la información del sistema relacionadas con el panel táctil.

El parámetro pvParam debe apuntar a una estructura TOUCHPAD_PARAMETERS .

El parámetro uiParam debe especificar el tamaño de la estructura.

El valor del campo versionNumber de la estructura TOUCHPAD_PARAMETERS debe establecerse en el valor adecuado para la versión de la estructura que se va a usar.

SPI_GETWHEELSCROLLCHARS
0x006C
Recupera el número de caracteres que se van a desplazar cuando se mueve la rueda horizontal del mouse. El parámetro pvParam debe apuntar a una variable UINT que recibe el número de líneas. El valor predeterminado es 3.
SPI_GETWHEELSCROLLLINES
0x0068
Recupera el número de líneas que se desplazarán cuando se mueve la rueda vertical del mouse. El parámetro pvParam debe apuntar a una variable UINT que recibe el número de líneas. El valor predeterminado es 3.
SPI_SETBEEP
0x0002
Activa o desactiva el beeper de advertencia. El parámetro uiParam especifica TRUE para activado o FALSE para off.
SPI_SETBLOCKSENDINPUTRESETS
0x1027
Determina si una aplicación puede restablecer el temporizador del protector de pantalla llamando a la función SendInput para simular la entrada de teclado o mouse. El parámetro uiParam especifica TRUE si la entrada simulada no desactivará el protector de pantalla o FALSE si la entrada simulada desactivará el protector de pantalla.
SPI_SETCONTACTVISUALIZATION
0x2019
Establece la configuración actual de visualización de contactos. El parámetro pvParam debe apuntar a una variable ULONG que identifique la configuración. Para obtener más información, consulte Visualización de contactos.
Nota Si las visualizaciones de contactos están deshabilitadas, no se pueden habilitar las visualizaciones de gestos.
 
SPI_SETDEFAULTINPUTLANG
0x005A
Establece el idioma de entrada predeterminado para el shell del sistema y las aplicaciones. El idioma especificado debe mostrarse con el juego de caracteres del sistema actual. El parámetro pvParam debe apuntar a una variable HKL que contenga el identificador de configuración regional de entrada para el idioma predeterminado. Para obtener más información, vea Idiomas, configuraciones regionales y diseños de teclado.
SPI_SETDOUBLECLICKTIME
0x0020
Establece la hora de doble clic del mouse en el valor del parámetro uiParam . Si el valor uiParam es mayor que 5000 milisegundos, el sistema establece el tiempo de doble clic en 5000 milisegundos.

El tiempo de doble clic es el número máximo de milisegundos que pueden producirse entre el primer y el segundo clic de un doble clic. También puede llamar a la función SetDoubleClickTime para establecer la hora de doble clic. Para obtener la hora actual de doble clic, llame a la función GetDoubleClickTime .

SPI_SETDOUBLECLKHEIGHT
0x001E
Establece el alto del rectángulo de doble clic en el valor del parámetro uiParam .

El rectángulo de doble clic es el rectángulo en el que el segundo clic de un doble clic debe caer para que se registre como un doble clic.

Para recuperar el alto del rectángulo de doble clic, llame a GetSystemMetrics con la marca SM_CYDOUBLECLK .

SPI_SETDOUBLECLKWIDTH
0x001D
Establece el ancho del rectángulo de doble clic en el valor del parámetro uiParam .

El rectángulo de doble clic es el rectángulo en el que el segundo clic de un doble clic debe caer para que se registre como un doble clic.

Para recuperar el ancho del rectángulo de doble clic, llame a GetSystemMetrics con la marca SM_CXDOUBLECLK .

SPI_SETGESTUREVISUALIZATION
0x201B
Establece la configuración de visualización de gestos actual. El parámetro pvParam debe apuntar a una variable ULONG que identifique la configuración. Para obtener más información, vea Visualización de gestos.
Nota Si las visualizaciones de contactos están deshabilitadas, no se pueden habilitar las visualizaciones de gestos.
 
SPI_SETKEYBOARDCUES
0x100B
Establece la inserción de letras clave de acceso de menú. El parámetro pvParam es una variable BOOL . Establezca pvParam en TRUE para subrayado siempre las teclas de acceso del menú o FALSE para subrayador las teclas de acceso del menú solo cuando el menú esté activado desde el teclado.
SPI_SETKEYBOARDDELAY
0x0017
Establece la configuración de retraso de repetición del teclado. El parámetro uiParam debe especificar 0, 1, 2 o 3, donde cero establece el retraso más corto aproximadamente 250 ms) y 3 establece el retraso más largo (aproximadamente 1 segundo). El retraso real asociado a cada valor puede variar en función del hardware.
SPI_SETKEYBOARDPREF
0x0045
Establece la preferencia del teclado. El parámetro uiParam especifica TRUE si el usuario se basa en el teclado en lugar del mouse y quiere que las aplicaciones muestren interfaces de teclado que, de lo contrario, estarían ocultas; uiParam es FALSE en caso contrario.
SPI_SETKEYBOARDSPEED
0x000B
Establece la configuración de velocidad de repetición del teclado. El parámetro uiParam debe especificar un valor en el intervalo de 0 (aproximadamente 2,5 repeticiones por segundo) a 31 (aproximadamente 30 repeticiones por segundo). Las tasas de repetición reales dependen del hardware y pueden variar de una escala lineal hasta un 20 %. Si uiParam es mayor que 31, el parámetro se establece en 31.
SPI_SETLANGTOGGLE
0x005B
Establece el conjunto de teclas activas para cambiar entre idiomas de entrada. No se usan los parámetros uiParam y pvParam . El valor establece las teclas de método abreviado en las hojas de propiedades del teclado leyendo de nuevo el Registro. El registro debe establecerse antes de usar esta marca. la ruta de acceso del Registro es HKEY_CURRENT_USER\Diseño de teclado\Alternar

. Los valores válidos son "1" = ALT+MAYÚS, "2" = CTRL+MAYÚS y "3" = none.
SPI_SETMOUSE
0x0004
Establece los dos valores de umbral del mouse y la aceleración del mouse. El parámetro pvParam debe apuntar a una matriz de tres enteros que especifica estos valores. Consulte mouse_event para obtener más información.
SPI_SETMOUSEBUTTONSWAP
0x0021
Intercambia o restaura el significado de los botones del mouse izquierdo y derecho. El parámetro uiParam especifica TRUE para intercambiar los significados de los botones o FALSE para restaurar sus significados originales.

Para recuperar la configuración actual, llame a GetSystemMetrics con la marca SM_SWAPBUTTON .

SPI_SETMOUSEHOVERHEIGHT
0x0065
Establece el alto, en píxeles, del rectángulo en el que el puntero del mouse debe permanecer para que TrackMouseEvent genere un mensaje de WM_MOUSEHOVER . Establezca el parámetro uiParam en el nuevo alto.
SPI_SETMOUSEHOVERTIME
0x0067
Establece la hora, en milisegundos, que el puntero del mouse tiene que permanecer en el rectángulo de desplazamiento para TrackMouseEvent para generar un mensaje de WM_MOUSEHOVER . Esto solo se usa si pasa HOVER_DEFAULT en el parámetro dwHoverTime de la llamada a TrackMouseEvent. Establezca el parámetro uiParam en la nueva hora.

La hora especificada debe estar entre USER_TIMER_MAXIMUM y USER_TIMER_MINIMUM. Si uiParam es menor que USER_TIMER_MINIMUM, la función usará USER_TIMER_MINIMUM. Si uiParam es mayor que USER_TIMER_MAXIMUM, la función se USER_TIMER_MAXIMUM.

Windows Server 2003 y Windows XP: El sistema operativo no aplica el uso de USER_TIMER_MAXIMUM y USER_TIMER_MINIMUM hasta Windows Server 2003 con SP1 y Windows XP con SP2.

SPI_SETMOUSEHOVERWIDTH
0x0063
Establece el ancho, en píxeles, del rectángulo en el que el puntero del mouse debe permanecer para que TrackMouseEvent genere un mensaje WM_MOUSEHOVER . Establezca el parámetro uiParam en el nuevo ancho.
SPI_SETMOUSESPEED
0x0071
Establece la velocidad actual del mouse. El parámetro pvParam es un entero entre 1 (más lento) y 20 (más rápido). Un valor de 10 es el valor predeterminado. Este valor se establece normalmente mediante la aplicación del panel de control del mouse.
SPI_SETMOUSETRAILS
0x005D
Habilita o deshabilita la característica Pistas del mouse, que mejora la visibilidad de los movimientos del cursor del mouse mostrando brevemente un rastro de cursores y borrarlos rápidamente.

Para deshabilitar la característica, establezca el parámetro uiParam en cero o 1. Para habilitar la característica, establezca uiParam en un valor mayor que 1 para indicar el número de cursores dibujados en el trazado.

Windows 2000: Este parámetro no se admite.

SPI_SETMOUSEWHEELROUTING
0x201D
Establece la configuración de enrutamiento para la entrada de rueda del mouse. La configuración de enrutamiento determina si la entrada de la rueda del mouse se envía a la aplicación con foco (primer plano) o la aplicación bajo el cursor del mouse.

El parámetro pvParam debe apuntar a una variable DWORD que reciba la opción de enrutamiento. Establezca el parámetro uiParam en cero.

Si el valor es cero (MOUSEWHEEL_ROUTING_FOCUS), la entrada de la rueda del mouse se entrega a la aplicación con foco. Si el valor es 1 (MOUSEWHEEL_ROUTING_HYBRID), la entrada de la rueda del mouse se entrega a la aplicación con foco (aplicaciones de escritorio) o la aplicación bajo el puntero del mouse (aplicaciones de la Tienda Windows).

A partir de Windows 10: Si el valor es 2 (MOUSEWHEEL_ROUTING_MOUSE_POS), la entrada de la rueda del mouse se entrega a la aplicación bajo el puntero del mouse. Este es el nuevo valor predeterminado y MOUSEWHEEL_ROUTING_HYBRID ya no está disponible en Configuración.

SPI_SETPENVISUALIZATION
0x201F
Establece la configuración actual de visualización de gestos de lápiz. El parámetro pvParam debe apuntar a una variable ULONG que identifique la configuración. Para obtener más información, consulte Visualización del lápiz.
SPI_SETSNAPTODEFBUTTON
0x0060
Habilita o deshabilita la característica de botón de ajuste a predeterminado. Si está habilitado, el cursor del mouse se mueve automáticamente al botón predeterminado, como Aceptar o Aplicar, de un cuadro de diálogo. Establezca el parámetro uiParam en TRUE para habilitar la característica o FALSE para deshabilitarla. Las aplicaciones deben usar la función ShowWindow al mostrar un cuadro de diálogo para que el administrador de diálogos pueda colocar el cursor del mouse.
SPI_SETSYSTEMLANGUAGEBAR
0x1051
A partir de Windows 8: Activa o desactiva la característica de barra de idioma heredada. El parámetro pvParam es un puntero a una variable BOOL . Establezca pvParam en TRUE para habilitar la barra de idioma heredada o FALSE para deshabilitarla. La marca se admite en Windows 8, donde la barra de idioma heredada se reemplaza por el conmutador de entrada y, por tanto, se desactiva de forma predeterminada. La activación de la barra de idioma heredada se proporciona por motivos de compatibilidad y no tiene ningún efecto en el conmutador de entrada.
SPI_SETTHREADLOCALINPUTSETTINGS
0x104F
A partir de Windows 8: Determina si la configuración de entrada activa tiene ámbito Local (por subproceso, TRUE) o Global (sesión, FALSE). El parámetro pvParam debe ser una variable BOOL , que se convierte mediante PVOID.
SPI_SETTOUCHPADPARAMETERS
0x00AF
A partir de Windows 11, versión 24H2: Establece detalles sobre el Panel táctil de precisión, incluida la configuración del usuario y la información del sistema relacionadas con el panel táctil.

El parámetro pvParam debe apuntar a una estructura TOUCHPAD_PARAMETERS .

El parámetro uiParam debe especificar el tamaño de la estructura.

El valor del campo versionNumber de la estructura TOUCHPAD_PARAMETERS debe establecerse en el valor adecuado para la versión de la estructura que se va a usar.

SPI_SETWHEELSCROLLCHARS
0x006D
Establece el número de caracteres que se desplazarán cuando se mueve la rueda del mouse horizontal. El número de caracteres se establece desde el parámetro uiParam .
SPI_SETWHEELSCROLLLINES
0x0069
Establece el número de líneas que se desplazarán cuando se mueve la rueda vertical del mouse. El número de líneas se establece desde el parámetro uiParam .

El número de líneas es el número sugerido de líneas que se desplazarán cuando se enrolla la rueda del mouse sin usar teclas modificadoras. Si el número es 0, no debe producirse ningún desplazamiento. Si el número de líneas que se desplazarán es mayor que el número de líneas visibles y, en particular, si es WHEEL_PAGESCROLL (#defined como UINT_MAX), la operación de desplazamiento debe interpretarse como hacer clic una vez en las regiones de la página hacia abajo o hacia arriba de la barra de desplazamiento.

 

A continuación se muestran los parámetros de menú.

Parámetro de menú Significado
SPI_GETMENUDROPALIGNMENT
0x001B
Determina si los menús emergentes están alineados a la izquierda o alineados a la derecha, en relación con el elemento de barra de menús correspondiente. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si está alineado a la derecha o FALSE en caso contrario.
SPI_GETMENUFADE
0x1012
Determina si la animación de atenuación del menú está habilitada. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE cuando la animación de atenuación está habilitada y FALSE cuando está disponible. Si la animación de atenuación está deshabilitada, los menús usan animación de diapositivas. Esta marca se omite a menos que la animación de menú esté habilitada, lo que puede hacer con la marca SPI_SETMENUANIMATION . Para obtener más información, vea AnimateWindow.
SPI_GETMENUSHOWDELAY
0x006A
Recupera el tiempo, en milisegundos, que el sistema espera antes de mostrar un menú contextual cuando el cursor del mouse está sobre un elemento de submenú. El parámetro pvParam debe apuntar a una variable DWORD que recibe el tiempo del retraso.
SPI_SETMENUDROPALIGNMENT
0x001C
Establece el valor de alineación de los menús emergentes. El parámetro uiParam especifica TRUE para la alineación derecha o FALSE para la alineación izquierda.
SPI_SETMENUFADE
0x1013
Habilita o deshabilita la animación de atenuación del menú. Establezca pvParam en TRUE para habilitar el efecto de atenuación del menú o FALSE para deshabilitarlo. Si la animación de atenuación está deshabilitada, los menús usan animación de diapositivas. el efecto de atenuación del menú sólo es posible si el sistema tiene una profundidad de color de más de 256 colores. Esta marca se omite a menos que también se establezca SPI_MENUANIMATION. Para obtener más información, vea AnimateWindow.
SPI_SETMENUSHOWDELAY
0x006B
Establece uiParam en el tiempo, en milisegundos, que el sistema espera antes de mostrar un menú contextual cuando el cursor del mouse está sobre un elemento de submenú.
 

A continuación se muestran los parámetros de energía.

A partir de Windows Server 2008 y Windows Vista, no se admiten estos parámetros de energía. En su lugar, para determinar el estado de energía de visualización actual, una aplicación debe registrarse para GUID_MONITOR_POWER_STATE notificaciones. Para determinar el tiempo de espera de apagado de la pantalla actual, una aplicación debe registrarse para recibir notificaciones de cambios en la configuración de energía GUID_VIDEO_POWERDOWN_TIMEOUT . Para obtener más información, consulte Registro de eventos de Power.

Windows Server 2003 y Windows XP/2000: Para determinar el estado de energía de visualización actual, use los parámetros de energía siguientes.

Parámetro de energía Significado
SPI_GETLOWPOWERACTIVE
0x0053
Este parámetro no se admite.

Windows Server 2003 y Windows XP/2000: Determina si la fase de bajo consumo del guardado de pantalla está habilitada. El parámetro pvParam debe apuntar a una variable BOOL que reciba TRUE si está habilitada o FALSE si está deshabilitada. Esta marca solo se admite para aplicaciones de 32 bits.

SPI_GETLOWPOWERTIMEOUT
0x004F
Este parámetro no se admite.

Windows Server 2003 y Windows XP/2000: Recupera el valor de tiempo de espera de la fase de bajo consumo de ahorro de pantalla. El parámetro pvParam debe apuntar a una variable de entero que recibe el valor. Esta marca solo se admite para aplicaciones de 32 bits.

SPI_GETPOWEROFFACTIVE
0x0054
Este parámetro no se admite. Cuando se habilita la fase de apagado del guardado de pantalla, la configuración de energía GUID_VIDEO_POWERDOWN_TIMEOUT es mayor que cero.

Windows Server 2003 y Windows XP/2000: Determina si la fase de apagado del guardado de pantalla está habilitada. El parámetro pvParam debe apuntar a una variable BOOL que reciba TRUE si está habilitada o FALSE si está deshabilitada. Esta marca solo se admite para aplicaciones de 32 bits.

SPI_GETPOWEROFFTIMEOUT
0x0050
Este parámetro no se admite. En su lugar, compruebe la configuración de energía de GUID_VIDEO_POWERDOWN_TIMEOUT .

Windows Server 2003 y Windows XP/2000: Recupera el valor de tiempo de espera de la fase de apagado del guardado de pantalla. El parámetro pvParam debe apuntar a una variable de entero que recibe el valor. Esta marca solo se admite para aplicaciones de 32 bits.

SPI_SETLOWPOWERACTIVE
0x0055
Este parámetro no se admite.

Windows Server 2003 y Windows XP/2000: Activa o desactiva la fase de bajo consumo del guardado de pantalla. Establezca uiParam en 1 para activar o cero para desactivar. El parámetro pvParam debe ser NULL. Esta marca solo se admite para aplicaciones de 32 bits.

SPI_SETLOWPOWERTIMEOUT
0x0051
Este parámetro no se admite.

Windows Server 2003 y Windows XP/2000: Establece el valor de tiempo de espera, en segundos, para la fase de bajo consumo de pantalla. El parámetro uiParam especifica el nuevo valor. El parámetro pvParam debe ser NULL. Esta marca solo se admite para aplicaciones de 32 bits.

SPI_SETPOWEROFFACTIVE
0x0056
Este parámetro no se admite. En su lugar, establezca la configuración de energía GUID_VIDEO_POWERDOWN_TIMEOUT .

Windows Server 2003 y Windows XP/2000: Activa o desactiva la fase de apagado del guardado de pantalla. Establezca uiParam en 1 para activar o cero para desactivar. El parámetro pvParam debe ser NULL. Esta marca solo se admite para aplicaciones de 32 bits.

SPI_SETPOWEROFFTIMEOUT
0x0052
Este parámetro no se admite. En su lugar, establezca el valor de energía GUID_VIDEO_POWERDOWN_TIMEOUT en un valor de tiempo de espera.

Windows Server 2003 y Windows XP/2000: Establece el valor de tiempo de espera, en segundos, para la fase de apagado del guardado de pantalla. El parámetro uiParam especifica el nuevo valor. El parámetro pvParam debe ser NULL. Esta marca solo se admite para aplicaciones de 32 bits.

 

A continuación se muestran los parámetros del protector de pantalla.

Parámetro del protector de pantalla Significado
SPI_GETSCREENSAVEACTIVE
0x0010
Determina si el guardado de pantalla está habilitado. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si el guardado de pantalla está habilitado o FALSE en caso contrario.

Windows 7, Windows Server 2008 R2 y Windows 2000: La función devuelve TRUE incluso cuando el guardado de pantalla no está habilitado.

SPI_GETSCREENSAVERRUNNING
0x0072
Determina si un protector de pantalla se está ejecutando actualmente en la estación de ventana del proceso de llamada. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si un protector de pantalla se está ejecutando actualmente o FALSE en caso contrario. Tenga en cuenta que solo la estación de ventana interactiva, WinSta0, puede tener un protector de pantalla en ejecución.
SPI_GETSCREENSAVESECURE
0x0076
Determina si el protector de pantalla requiere una contraseña para mostrar el escritorio de Windows. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si el protector de pantalla requiere una contraseña o FALSE en caso contrario. Se omite el parámetro uiParam .

Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_GETSCREENSAVETIMEOUT
0x000E
Recupera el valor de tiempo de espera del protector de pantalla, en segundos. El parámetro pvParam debe apuntar a una variable de entero que recibe el valor.
SPI_SETSCREENSAVEACTIVE
0x0011
Establece el estado del protector de pantalla. El parámetro uiParam especifica TRUE para activar el guardado de pantalla o FALSE para desactivarlo.

Si la máquina ha entrado en el modo de ahorro de energía o el estado de bloqueo del sistema, se produce una excepción de ERROR_OPERATION_IN_PROGRESS.

SPI_SETSCREENSAVESECURE
0x0077
Establece si el protector de pantalla requiere que el usuario escriba una contraseña para mostrar el escritorio de Windows. El parámetro uiParam es una variable BOOL . Se omite el parámetro pvParam . Establezca uiParam en TRUE para requerir una contraseña o FALSE para no requerir una contraseña.

Si la máquina ha entrado en el modo de ahorro de energía o el estado de bloqueo del sistema, se produce una excepción de ERROR_OPERATION_IN_PROGRESS.

Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_SETSCREENSAVETIMEOUT
0x000F
Establece el valor de tiempo de espera del protector de pantalla en el valor del parámetro uiParam . Este valor es la cantidad de tiempo, en segundos, que el sistema debe estar inactivo antes de que se active el protector de pantalla.

Si la máquina ha entrado en el modo de ahorro de energía o el estado de bloqueo del sistema, se produce una excepción de ERROR_OPERATION_IN_PROGRESS.

 

A continuación se muestran los parámetros de tiempo de espera para aplicaciones y servicios.

Parámetro de tiempo de espera Significado
SPI_GETHUNGAPPTIMEOUT
0x0078
Recupera el número de milisegundos que un subproceso puede ir sin enviar un mensaje antes de que el sistema lo considere no responde. El parámetro pvParam debe apuntar a una variable de entero que recibe el valor.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_GETWAITTOKILLTIMEOUT
0x007A
Recupera el número de milisegundos que el sistema espera antes de finalizar una aplicación que no responde a una solicitud de apagado. El parámetro pvParam debe apuntar a una variable de entero que recibe el valor.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_GETWAITTOKILLSERVICETIMEOUT
0x007C
Recupera el número de milisegundos que el administrador de control de servicio espera antes de finalizar un servicio que no responde a una solicitud de apagado. El parámetro pvParam debe apuntar a una variable de entero que recibe el valor.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_SETHUNGAPPTIMEOUT
0x0079
Establece el tiempo de espera de la aplicación bloqueada en el valor del parámetro uiParam . Este valor es el número de milisegundos que un subproceso puede ir sin enviar un mensaje antes de que el sistema lo considere no responde.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_SETWAITTOKILLTIMEOUT
0x007B
Establece el tiempo de espera de la solicitud de apagado de la aplicación en el valor del parámetro uiParam . Este valor es el número de milisegundos que el sistema espera antes de finalizar una aplicación que no responde a una solicitud de apagado.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_SETWAITTOKILLSERVICETIMEOUT
0x007D
Establece el tiempo de espera de la solicitud de apagado del servicio en el valor del parámetro uiParam . Este valor es el número de milisegundos que el sistema espera antes de finalizar un servicio que no responde a una solicitud de apagado.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

 

A continuación se muestran los efectos de la interfaz de usuario. El valor SPI_SETUIEFFECTS se usa para habilitar o deshabilitar todos los efectos de la interfaz de usuario a la vez. Esta tabla contiene la lista completa de valores de efecto de interfaz de usuario.

Parámetro de efectos de la interfaz de usuario Significado
SPI_GETCOMBOBOXANIMATION
0x1004
Determina si el efecto de apertura de diapositivas para cuadros combinados está habilitado. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE para habilitado o FALSE para deshabilitado.
SPI_GETCURSORSHADOW
0x101A
Determina si el cursor tiene una sombra alrededor de él. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si la sombra está habilitada, FALSE si está deshabilitada. Este efecto solo aparece si el sistema tiene una profundidad de color de más de 256 colores.
SPI_GETGRADIENTCAPTIONS
0x1008
Determina si el efecto degradado de las barras de título de la ventana está habilitado. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE para habilitado o FALSE para deshabilitado. Para obtener más información sobre el efecto de degradado, vea la función GetSysColor .
SPI_GETHOTTRACKING
0x100E
Determina si el seguimiento activo de elementos de la interfaz de usuario, como los nombres de menú en las barras de menú, está habilitado. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE para habilitado o FALSE para deshabilitado.

El seguimiento activo significa que cuando el cursor se mueve sobre un elemento, está resaltado pero no seleccionado. Puede consultar este valor para decidir si se debe usar el seguimiento activo en la interfaz de usuario de la aplicación.

SPI_GETLISTBOXSMOOTHSCROLLING
0x1006
Determina si el efecto de desplazamiento suave para los cuadros de lista está habilitado. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE para habilitado o FALSE para deshabilitado.
SPI_GETMENUANIMATION
0x1002
Determina si la característica de animación de menú está habilitada. Este modificador maestro debe estar activado para habilitar los efectos de animación de menú. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si la animación está habilitada y FALSE si está deshabilitada.

Si la animación está habilitada, SPI_GETMENUFADE indica si los menús usan atenuación o animación de diapositivas.

SPI_GETMENUUNDERLINES
0x100a
Igual que SPI_GETKEYBOARDCUES.
SPI_GETSELECTIONFADE
0x1014
Determina si el efecto de atenuación de selección está habilitado. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si está habilitado o FALSE si está deshabilitado.

El efecto de atenuación de selección hace que el elemento de menú seleccionado por el usuario permanezca en la pantalla brevemente mientras se apaga después de descartar el menú.

SPI_GETTOOLTIPANIMATION
0x1016
Determina si la animación de información sobre herramientas está habilitada. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si está habilitado o FALSE si está deshabilitado. Si la animación de información sobre herramientas está habilitada, SPI_GETTOOLTIPFADE indica si la información sobre herramientas usa atenuación o animación de diapositiva.
SPI_GETTOOLTIPFADE
0x1018
Si SPI_SETTOOLTIPANIMATION está habilitado, SPI_GETTOOLTIPFADE indica si la animación de información sobre herramientas usa un efecto de atenuación o un efecto de diapositiva. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE para la animación de atenuación o FALSE para la animación de diapositivas. Para obtener más información sobre los efectos de deslizar y atenuar, vea AnimateWindow.
SPI_GETUIEFFECTS
0x103E
Determina si los efectos de la interfaz de usuario están habilitados o deshabilitados. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si todos los efectos de la interfaz de usuario están habilitados o FALSE si están deshabilitados.
SPI_SETCOMBOBOXANIMATION
0x1005
Habilita o deshabilita el efecto de apertura de diapositivas para cuadros combinados. Establezca el parámetro pvParam en TRUE para habilitar el efecto de degradado o FALSE para deshabilitarlo.
SPI_SETCURSORSHADOW
0x101B
Habilita o deshabilita una sombra alrededor del cursor. El parámetro pvParam es una variable BOOL . Establezca pvParam en TRUE para habilitar la sombra o FALSE para deshabilitar la sombra. Este efecto solo aparece si el sistema tiene una profundidad de color de más de 256 colores.
SPI_SETGRADIENTCAPTIONS
0x1009
Habilita o deshabilita el efecto de degradado para las barras de título de ventana. Establezca el parámetro pvParam en TRUE para habilitarlo o FALSE para deshabilitarlo. El efecto degradado solo es posible si el sistema tiene una profundidad de color de más de 256 colores. Para obtener más información sobre el efecto de degradado, vea la función GetSysColor .
SPI_SETHOTTRACKING
0x100F
Habilita o deshabilita el seguimiento activo de elementos de la interfaz de usuario, como los nombres de menú en las barras de menú. Establezca el parámetro pvParam en TRUE para habilitarlo o FALSE para deshabilitarlo.

El seguimiento activo significa que cuando el cursor se mueve sobre un elemento, está resaltado pero no seleccionado.

SPI_SETLISTBOXSMOOTHSCROLLING
0x1007
Habilita o deshabilita el efecto de desplazamiento suave para los cuadros de lista. Establezca el parámetro pvParam en TRUE para habilitar el efecto de desplazamiento suave o FALSE para deshabilitarlo.
SPI_SETMENUANIMATION
0x1003
Habilita o deshabilita la animación de menú. Este modificador maestro debe estar activado para que se produzca cualquier animación de menú. El parámetro pvParam es una variable BOOL ; establezca pvParam en TRUE para habilitar la animación y FALSE para deshabilitar la animación.

Si la animación está habilitada, SPI_GETMENUFADE indica si los menús usan atenuación o animación de diapositivas.

SPI_SETMENUUNDERLINES
0x100B
Igual que SPI_SETKEYBOARDCUES.
SPI_SETSELECTIONFADE
0x1015
Establezca pvParam en TRUE para habilitar el efecto de atenuación de selección o FALSE para deshabilitarlo.

El efecto de atenuación de selección hace que el elemento de menú seleccionado por el usuario permanezca en la pantalla brevemente mientras se apaga después de descartar el menú. El efecto de atenuación de selección solo es posible si el sistema tiene una profundidad de color de más de 256 colores.

SPI_SETTOOLTIPANIMATION
0x1017
Establezca pvParam en TRUE para habilitar la animación de información sobre herramientas o FALSE para deshabilitarla. Si está habilitado, puede usar SPI_SETTOOLTIPFADE para especificar la animación de atenuación o diapositiva.
SPI_SETTOOLTIPFADE
0x1019
Si la marca SPI_SETTOOLTIPANIMATION está habilitada, use SPI_SETTOOLTIPFADE para indicar si la animación de información sobre herramientas usa un efecto de atenuación o un efecto de diapositiva. Establezca pvParam en TRUE para la animación de atenuación o FALSE para la animación de diapositivas. El efecto de atenuación de información sobre herramientas solo es posible si el sistema tiene una profundidad de color de más de 256 colores. Para obtener más información sobre los efectos de deslizar y atenuar, vea la función AnimateWindow .
SPI_SETUIEFFECTS
0x103F
Habilita o deshabilita los efectos de la interfaz de usuario. Establezca el parámetro pvParam en TRUE para habilitar todos los efectos de la interfaz de usuario o FALSE para deshabilitar todos los efectos de la interfaz de usuario.
 

A continuación se muestran los parámetros de la ventana.

Parámetro de ventana Significado
SPI_GETACTIVEWINDOWTRACKING
0x1000
Determina si el seguimiento de ventanas activa (activando la ventana en la que está activado el mouse) está activado o desactivado. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE para activado o FALSE para desactivado.
SPI_GETACTIVEWNDTRKZORDER
0x100C
Determina si las ventanas activadas a través del seguimiento de ventanas activas se incorporarán a la parte superior. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE para activado o FALSE para desactivado.
SPI_GETACTIVEWNDTRKTIMEOUT
0x2002
Recupera el retraso de seguimiento de ventana activo, en milisegundos. El parámetro pvParam debe apuntar a una variable DWORD que reciba la hora.
SPI_GETANIMATION
0x0048
Recupera los efectos de animación asociados a las acciones del usuario. El parámetro pvParam debe apuntar a una estructura ANIMATIONINFO que recibe la información. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(ANIMATIONINFO).
SPI_GETBORDER
0x0005
Recupera el factor multiplicador de borde que determina el ancho del borde de tamaño de una ventana. El parámetro pvParam debe apuntar a una variable entera que recibe este valor.
SPI_GETCARETWIDTH
0x2006
Recupera el ancho del símbolo de intercalación en los controles de edición, en píxeles. El parámetro pvParam debe apuntar a una variable DWORD que recibe este valor.
SPI_GETDOCKMOVING
0x0090
Determina si una ventana está acoplada cuando se mueve a los bordes superior, izquierdo o derecho de un monitor o matriz de monitor. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si está habilitado o FALSE de lo contrario.

Use SPI_GETWINARRANGING para determinar si este comportamiento está habilitado.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_GETDRAGFROMMAXIMIZE
0x008C
Determina si se restaura una ventana maximizada cuando se arrastra su barra de títulos. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si está habilitado o FALSE de lo contrario.

Use SPI_GETWINARRANGING para determinar si este comportamiento está habilitado.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_GETDRAGFULLWINDOWS
0x0026
Determina si el arrastre de ventanas completas está habilitado. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si está habilitado o FALSE de lo contrario.
SPI_GETFOREGROUNDFLASHCOUNT
0x2004
Recupera el número de veces que SetForegroundWindow parpadeará el botón de la barra de tareas al rechazar una solicitud de conmutador en primer plano. El parámetro pvParam debe apuntar a una variable DWORD que recibe el valor.
SPI_GETFOREGROUNDLOCKTIMEOUT
0x2000
Recupera la cantidad de tiempo que sigue a la entrada del usuario, en milisegundos, durante el cual el sistema no permitirá a las aplicaciones forzarse en primer plano. El parámetro pvParam debe apuntar a una variable DWORD que reciba la hora.
SPI_GETMINIMIZEDMETRICS
0x002B
Recupera las métricas asociadas a las ventanas minimizadas. El parámetro pvParam debe apuntar a una estructura MINIMIZEDMETRICS que reciba la información. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(MINIMIZEDMETRICS).
SPI_GETMOUSEDOCKTHRESHOLD
0x007E
Recupera el umbral en píxeles donde se desencadena el comportamiento de acoplamiento mediante un mouse para arrastrar una ventana al borde de un monitor o una matriz de monitores. El umbral predeterminado es 1. El parámetro pvParam debe apuntar a una variable DWORD que recibe el valor.

Use SPI_GETWINARRANGING para determinar si este comportamiento está habilitado.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_GETMOUSEDRAGOUTTHRESHOLD
0x0084
Recupera el umbral en píxeles donde se desencadena el comportamiento de desadocificación mediante un mouse para arrastrar una ventana desde el borde de un monitor o una matriz de monitor hacia el centro. El umbral predeterminado es 20.

Use SPI_GETWINARRANGING para determinar si este comportamiento está habilitado.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_GETMOUSESIDEMOVETHRESHOLD
0x0088
Recupera el umbral en píxeles de la parte superior de un monitor o una matriz de monitores donde se restaura una ventana maximizada verticalmente cuando se arrastra con el mouse. El umbral predeterminado es 50.

Use SPI_GETWINARRANGING para determinar si este comportamiento está habilitado.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_GETNONCLIENTMETRICS
0x0029
Recupera las métricas asociadas al área no cliente de las ventanas no minimizadas. El parámetro pvParam debe apuntar a una estructura NONCLIENTMETRICS que recibe la información. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(NONCLIENTMETRICS).

Windows Server 2003 y Windows XP/2000: Vea Comentarios para NONCLIENTMETRICS.

SPI_GETPENDOCKTHRESHOLD
0x0080
Recupera el umbral en píxeles donde se desencadena el comportamiento de acoplamiento mediante un lápiz para arrastrar una ventana al borde de un monitor o una matriz de monitores. El valor predeterminado es 30.

Use SPI_GETWINARRANGING para determinar si este comportamiento está habilitado.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_GETPENDRAGOUTTHRESHOLD
0x0086
Recupera el umbral en píxeles donde se desencadena el comportamiento de desadocificación mediante un lápiz para arrastrar una ventana desde el borde de un monitor o una matriz de supervisión hacia su centro. El umbral predeterminado es 30.

Use SPI_GETWINARRANGING para determinar si este comportamiento está habilitado.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_GETPENSIDEMOVETHRESHOLD
0x008A
Recupera el umbral en píxeles de la parte superior de una matriz de monitor o monitor donde se restaura una ventana maximizada verticalmente cuando se arrastra con el mouse. El umbral predeterminado es 50.

Use SPI_GETWINARRANGING para determinar si este comportamiento está habilitado.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_GETSHOWIMEUI
0x006E
Determina si la ventana de estado de IME está visible (por usuario). El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si la ventana de estado está visible o FALSE si no lo está.
SPI_GETSNAPSIZING
0x008E
Determina si una ventana se maximiza verticalmente cuando se ajusta el tamaño a la parte superior o inferior de un monitor o matriz de monitor. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si está habilitado o FALSE de lo contrario.

Use SPI_GETWINARRANGING para determinar si este comportamiento está habilitado.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_GETWINARRANGING
0x0082
Determina si la disposición de la ventana está habilitada. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si está habilitado o FALSE de lo contrario.

La disposición de las ventanas reduce el número de interacciones táctiles, lápiz o mouse necesarias para mover y ajustar el tamaño de las ventanas de nivel superior simplificando el comportamiento predeterminado de una ventana cuando se arrastra o se ajusta el tamaño.

Los parámetros siguientes recuperan la configuración de organización de ventanas individuales:

SPI_GETDOCKMOVING
SPI_GETMOUSEDOCKTHRESHOLD
SPI_GETMOUSEDRAGOUTTHRESHOLD
SPI_GETMOUSESIDEMOVETHRESHOLD
SPI_GETPENDOCKTHRESHOLD
SPI_GETPENDRAGOUTTHRESHOLD
SPI_GETPENSIDEMOVETHRESHOLD
SPI_GETSNAPSIZING
Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.
SPI_SETACTIVEWINDOWTRACKING
0x1001
Establece el seguimiento de ventanas activas (activando la ventana en la que está activado el mouse) ya sea activado o desactivado. Establezca pvParam en TRUE para activado o FALSE para desactivado.
SPI_SETACTIVEWNDTRKZORDER
0x100D
Determina si las ventanas activadas a través del seguimiento de ventanas activas se deben llevar a la parte superior. Establezca pvParam en TRUE para activado o FALSE para desactivado.
SPI_SETACTIVEWNDTRKTIMEOUT
0x2003
Establece el retraso de seguimiento de ventanas activo. Establezca pvParam en el número de milisegundos que se retrasarán antes de activar la ventana bajo el puntero del mouse.
SPI_SETANIMATION
0x0049
Establece los efectos de animación asociados a las acciones del usuario. El parámetro pvParam debe apuntar a una estructura ANIMATIONINFO que contenga los nuevos parámetros. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(ANIMATIONINFO).
SPI_SETBORDER
0x0006
Establece el factor multiplicador de borde que determina el ancho del borde de tamaño de una ventana. El parámetro uiParam especifica el nuevo valor.
SPI_SETCARETWIDTH
0x2007
Establece el ancho del símbolo de intercalación en los controles de edición. Establezca pvParam en el ancho deseado, en píxeles. El valor predeterminado y mínimo es 1.
SPI_SETDOCKMOVING
0x0091
Establece si una ventana se acopla cuando se mueve a los destinos de acoplamiento superior, izquierdo o derecho en una matriz de monitor o monitor. Establezca pvParam en TRUE para activado o FALSE para desactivado.

SPI_GETWINARRANGING debe ser TRUE para habilitar este comportamiento.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_SETDRAGFROMMAXIMIZE
0x008D
Establece si se restaura una ventana maximizada cuando se arrastra su barra de títulos. Establezca pvParam en TRUE para activado o FALSE para desactivado.

SPI_GETWINARRANGING debe ser TRUE para habilitar este comportamiento.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_SETDRAGFULLWINDOWS
0x0025
Establece el arrastre de ventanas completas activadas o desactivadas. El parámetro uiParam especifica TRUE para activado o FALSE para off.
SPI_SETDRAGHEIGHT
0x004D
Establece el alto, en píxeles, del rectángulo utilizado para detectar el inicio de una operación de arrastre. Establezca uiParam en el nuevo valor. Para recuperar el alto de arrastre, llame a GetSystemMetrics con la marca SM_CYDRAG .
SPI_SETDRAGWIDTH
0x004C
Establece el ancho, en píxeles, del rectángulo utilizado para detectar el inicio de una operación de arrastre. Establezca uiParam en el nuevo valor. Para recuperar el ancho de arrastre, llame a GetSystemMetrics con la marca SM_CXDRAG .
SPI_SETFOREGROUNDFLASHCOUNT
0x2005
Establece el número de veces que SetForegroundWindow parpadeará el botón de la barra de tareas al rechazar una solicitud de conmutador en primer plano. Establezca pvParam en el número de veces que se va a parpadear.
SPI_SETFOREGROUNDLOCKTIMEOUT
0x2001
Establece la cantidad de tiempo que sigue a la entrada del usuario, en milisegundos, durante el cual el sistema no permite a las aplicaciones forzarse en primer plano. Establezca pvParam en el nuevo valor de tiempo de espera.

El subproceso que realiza la llamada debe ser capaz de cambiar la ventana de primer plano; de lo contrario, se produce un error en la llamada.

SPI_SETMINIMIZEDMETRICS
0x002C
Establece las métricas asociadas a las ventanas minimizadas. El parámetro pvParam debe apuntar a una estructura MINIMIZEDMETRICS que contenga los nuevos parámetros. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(MINIMIZEDMETRICS).
SPI_SETMOUSEDOCKTHRESHOLD
0x007F
Establece el umbral en píxeles donde se desencadena el comportamiento de acoplamiento mediante un mouse para arrastrar una ventana al borde de un monitor o matriz de supervisión. El umbral predeterminado es 1. El parámetro pvParam debe apuntar a una variable DWORD que contenga el nuevo valor.

SPI_GETWINARRANGING debe ser TRUE para habilitar este comportamiento.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_SETMOUSEDRAGOUTTHRESHOLD
0x0085
Establece el umbral en píxeles en los que se desencadena el comportamiento de desadoctorado mediante un mouse para arrastrar una ventana desde el borde de un monitor o una matriz de supervisión hasta su centro. El umbral predeterminado es 20. El parámetro pvParam debe apuntar a una variable DWORD que contenga el nuevo valor.

SPI_GETWINARRANGING debe ser TRUE para habilitar este comportamiento.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_SETMOUSESIDEMOVETHRESHOLD
0x0089
Establece el umbral en píxeles desde la parte superior del monitor donde se restaura una ventana maximizada verticalmente cuando se arrastra con el mouse. El umbral predeterminado es 50. El parámetro pvParam debe apuntar a una variable DWORD que contenga el nuevo valor.

SPI_GETWINARRANGING debe ser TRUE para habilitar este comportamiento.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_SETNONCLIENTMETRICS
0x002A
Establece las métricas asociadas al área no cliente de ventanas no minimizadas. El parámetro pvParam debe apuntar a una estructura NONCLIENTMETRICS que contenga los nuevos parámetros. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(NONCLIENTMETRICS). Además, el miembro lfHeight de la estructura LOGFONT debe ser un valor negativo.
SPI_SETPENDOCKTHRESHOLD
0x0081
Establece el umbral en píxeles donde se desencadena el comportamiento de acoplamiento mediante un lápiz para arrastrar una ventana al borde de una matriz de monitores o monitores. El umbral predeterminado es 30. El parámetro pvParam debe apuntar a una variable DWORD que contenga el nuevo valor.

SPI_GETWINARRANGING debe ser TRUE para habilitar este comportamiento.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_SETPENDRAGOUTTHRESHOLD
0x0087
Establece el umbral en píxeles donde se desencadena el comportamiento de desadoctorado mediante un lápiz para arrastrar una ventana desde el borde de un monitor o una matriz de supervisión hasta su centro. El umbral predeterminado es 30. El parámetro pvParam debe apuntar a una variable DWORD que contenga el nuevo valor.

SPI_GETWINARRANGING debe ser TRUE para habilitar este comportamiento.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_SETPENSIDEMOVETHRESHOLD
0x008B
Establece el umbral en píxeles desde la parte superior del monitor donde se restaura una ventana maximizada verticalmente cuando se arrastra con un lápiz. El umbral predeterminado es 50. El parámetro pvParam debe apuntar a una variable DWORD que contenga el nuevo valor.

SPI_GETWINARRANGING debe ser TRUE para habilitar este comportamiento.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_SETSHOWIMEUI
0x006F
Establece si la ventana de estado de IME está visible o no por usuario. El parámetro uiParam especifica TRUE para activado o FALSE para off.
SPI_SETSNAPSIZING
0x008F
Establece si una ventana está maximizada verticalmente cuando se ajusta al tamaño de la parte superior o inferior del monitor. Establezca pvParam en TRUE para activado o FALSE para desactivado.

SPI_GETWINARRANGING debe ser TRUE para habilitar este comportamiento.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

SPI_SETWINARRANGING
0x0083
Establece si la disposición de ventanas está habilitada. Establezca pvParam en TRUE para activado o FALSE para desactivado.

La disposición de ventanas reduce el número de interacciones de mouse, lápiz o entrada táctil necesarias para mover y ajustar el tamaño de las ventanas de nivel superior al simplificar el comportamiento predeterminado de una ventana cuando se arrastra o se ajusta el tamaño.

Los parámetros siguientes establecen la configuración de organización de ventanas individuales:

SPI_SETDOCKMOVING
SPI_SETMOUSEDOCKTHRESHOLD
SPI_SETMOUSEDRAGOUTTHRESHOLD
SPI_SETMOUSESIDEMOVETHRESHOLD
SPI_SETPENDOCKTHRESHOLD
SPI_SETPENDRAGOUTTHRESHOLD
SPI_SETPENSIDEMOVETHRESHOLD
SPI_SETSNAPSIZING
Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP/2000: Este parámetro no se admite.

[in] uiParam

Tipo: UINT

Parámetro cuyo uso y formato dependen del parámetro del sistema que se consulta o se establece. Para obtener más información sobre los parámetros de todo el sistema, consulte el parámetro uiAction . Si no se indica lo contrario, debe especificar cero para este parámetro.

[in, out] pvParam

Tipo: PVOID

Parámetro cuyo uso y formato dependen del parámetro del sistema que se consulta o se establece. Para obtener más información sobre los parámetros de todo el sistema, consulte el parámetro uiAction . Si no se indica lo contrario, debe especificar NULL para este parámetro. Para obtener información sobre el tipo de datos PVOID , vea Tipos de datos de Windows.

[in] fWinIni

Tipo: UINT

Si se establece un parámetro del sistema, especifica si se va a actualizar el perfil de usuario y, si es así, si el mensaje de WM_SETTINGCHANGE se va a difundir a todas las ventanas de nivel superior para notificarles el cambio.

Este parámetro puede ser cero si no desea actualizar el perfil de usuario o difundir el mensaje de WM_SETTINGCHANGE , o bien puede ser uno o varios de los valores siguientes.

Valor Significado
SPIF_UPDATEINIFILE
Escribe la nueva configuración de parámetro para todo el sistema en el perfil de usuario.
SPIF_SENDCHANGE
Difunde el mensaje de WM_SETTINGCHANGE después de actualizar el perfil de usuario.
SPIF_SENDWININICHANGE
Igual que SPIF_SENDCHANGE.

Valor devuelto

Tipo: BOOL

Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Esta función está pensada para su uso con aplicaciones que permiten al usuario personalizar el entorno.

Un nombre de diseño de teclado debe derivarse del valor hexadecimal del identificador de idioma correspondiente al diseño. Por ejemplo, inglés de EE. UU. tiene un identificador de idioma de 0x0409, por lo que el diseño principal inglés de EE. UU. se denomina "00000409". Las variantes del diseño inglés de Ee. UU., como el diseño Dvorak, se denominan "00010409", "00020409", etc. Para obtener una lista de los identificadores de idioma principal y los identificadores de sublanguaje que componen un identificador de idioma, consulte la macro MAKELANGID .

Hay una diferencia entre la combinación de colores de contraste alto y el modo de contraste alto. La combinación de colores de contraste alto cambia los colores del sistema a los colores que tienen contraste obvio; cambia a esta combinación de colores mediante las opciones de visualización del panel de control. El modo de contraste alto, que usa SPI_GETHIGHCONTRAST y SPI_SETHIGHCONTRAST, aconseja a las aplicaciones que modifiquen su apariencia para los usuarios con discapacidades visuales. Implica aspectos como la advertencia audible para los usuarios y la combinación de colores personalizada (mediante las opciones de accesibilidad del panel de control). Para obtener más información, vea HIGHCONTRAST. Para obtener más información sobre las características generales de accesibilidad, consulte Accesibilidad.

Durante el tiempo que se mantiene presionado el botón principal para activar la característica Mouse ClickLock, el usuario puede mover el mouse. Una vez bloqueado el botón principal, al liberar el botón principal no se produce un mensaje de WM_LBUTTONUP . Por lo tanto, aparecerá una aplicación en la que el botón principal sigue estando inactivo. Cualquier mensaje de botón posterior libera el botón principal, enviando un mensaje de WM_LBUTTONUP a la aplicación, por lo que el botón se puede desbloquear mediante programación o a través del usuario haciendo clic en cualquier botón.

Esta API no es compatible con PPP y no debe usarse si el subproceso que realiza la llamada es compatible con PPP por monitor. Para obtener la versión compatible con PPP de esta API, consulte SystemParametersInfoForDPI. Para obtener más información sobre el reconocimiento de PPP, consulte la documentación de Valores altos de PPP de Windows.

Ejemplos

En el ejemplo siguiente se usa SystemParametersInfo para duplicar la velocidad del mouse.


#include <windows.h>
#include <stdio.h>
#pragma comment(lib, "user32.lib")    

void main()  
{     
    BOOL fResult;
    int aMouseInfo[3];    // Array for mouse information
    
    // Get the current mouse speed.         
    fResult = SystemParametersInfo(SPI_GETMOUSE,   // Get mouse information
                                   0,              // Not used
                                   &aMouseInfo,    // Holds mouse information
                                   0);             // Not used           
                                   
    // Double it.         
    if( fResult )     
    {
        aMouseInfo[2] = 2 * aMouseInfo[2];
        
        // Change the mouse speed to the new value.
        SystemParametersInfo(SPI_SETMOUSE,      // Set mouse information
                             0,                 // Not used
                             aMouseInfo,        // Mouse information
                             SPIF_SENDCHANGE);  // Update Win.ini
    }  
}

Nota

El encabezado winuser.h define SystemParametersInfo 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]
Plataforma de destino Windows
Encabezado winuser.h (incluir Windows.h)
Library User32.lib
Archivo DLL User32.dll
Conjunto de API ext-ms-win-ntuser-sysparams-ext-l1-1-0 (introducido en Windows 8)

Consulte también

ACCESSTIMEOUT

ANIMATIONINFO

AUDIODESCRIPCIÓN

FILTERKEYS

HIGHCONTRAST

ICONMETRICS

LOGFONT

MAKELANGID

MINIMICDMETRICS

MOUSEKEYS

NONCLIENTMETRICS

RECT

SERIALKEYS

SOUNDSENTRY

STICKYKEYS

SystemParametersInfoForDPI

TOGGLEKEYS

WM_SETTINGCHANGE

Tipos de datos de Windows