Función SystemParametersInfoW (winuser.h)
Importante
Parte de la 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 SystemParametersInfoW(
[in] UINT uiAction,
[in] UINT uiParam,
[in, out] PVOID pvParam,
[in] UINT fWinIni
);
Parámetros
[in] uiAction
Tipo: UINT
Parámetro de 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 |
|---|---|
|
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 reciba la información. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(ACCESSTIMEOUT).
|
|
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 tengan discapacidades visuales escuchen el audio en el contenido de vídeo, hay mucha acción en el vídeo que no tiene el audio correspondiente. 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. |
|
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 sensible a la foto. Esta marca le 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. |
|
Determina si el contenido superpuesto está habilitado o deshabilitado. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si está habilitada o FALSE en caso contrario.
Mostrar características como imágenes de fondo, fondos con textura, marcas de agua en documentos, mezcla 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. |
|
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).
|
|
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. |
|
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. |
|
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. |
|
Recupera un valor que determina si Windows 8 muestra aplicaciones que usan la meseta de escalado predeterminada para el hardware o van 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 capas 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 el nivel de escala adecuado 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. Es posible que se modifique o no esté 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 .
|
|
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. |
|
Recupera el estado de la característica Mouse ClickLock. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si está habilitada o FALSE en caso contrario. Para obtener más información, consulte Introducción a la entrada del mouse.
Windows 2000: Este parámetro no se admite. |
|
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, consulte Introducción a la entrada del mouse.
Windows 2000: Este parámetro no se admite. |
|
Recupera información sobre la característica de accesibilidad MouseKeys. El parámetro pvParam debe apuntar a una estructura MOUSEKEYS que reciba la información. Establezca el miembro cbSize de esta estructura y el parámetro uiParam en sizeof(MOUSEKEYS).
|
|
Recupera el estado de la característica Sonar del mouse. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si está habilitado o FALSE en caso contrario. Para obtener más información, consulte Introducción a la entrada del mouse.
Windows 2000: Este parámetro no se admite. |
|
Recupera el estado de la característica Desvanecimiento del mouse. El parámetro pvParam debe apuntar a una variable BOOL que recibe TRUE si está habilitado o FALSE en caso contrario. Para obtener más información, consulte Introducción a la entrada del mouse.
Windows 2000: Este parámetro no se admite. |
|
Determina si se está ejecutando una utilidad de revisor de pantalla. Una utilidad de revisor de pantalla dirige la 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 .
|
|
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. |
|
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 solo 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. |
|
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).
|
|
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).
|
|
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).
|
|
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).
|
|
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 mucha acción en el vídeo que no tiene el audio correspondiente. 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. |
|
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 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 sensible a la foto. Esta marca le permite habilitar o deshabilitar todas estas animaciones. Windows Server 2003 y Windows XP/2000: Este parámetro no se admite. |
|
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.
Mostrar características como imágenes de fondo, fondos con textura, marcas de agua en documentos, mezcla 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. |
|
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).
|
|
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. |
|
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. |
|
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).
|
|
No debe usarse. |
|
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. |
|
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. |
|
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. |
|
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).
|
|
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. |
|
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. |
|
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 .
|
|
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. |
|
Activa o desactiva la característica de accesibilidad ShowSounds. El parámetro uiParam especifica TRUE para activado o FALSE para off. |
|
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).
|
|
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).
|
|
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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
Determina si los menús de usuario nativos tienen apariencia de menú plano. El parámetro pvParam debe apuntar a una variable BOOL que devuelve TRUE si se establece la apariencia del menú plano o FALSE en caso contrario.
Windows 2000: Este parámetro no se admite. |
|
Determina si la característica de suavizado de fuentes está habilitada. Esta característica usa suavizado de contorno de fuente para 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á. |
|
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. |
|
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. |
|
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. |
|
Recupera el tamaño del área de trabajo en el monitor de presentació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 . |
|
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. |
|
Vuelve a cargar los cursores del sistema. Establezca el parámetro uiParam en cero y el parámetro pvParam en NULL. |
|
Establece el patrón de escritorio actual haciendo que Windows lea el valor Pattern= del archivo WIN.INI. |
|
Nota Cuando se usa la marca SPI_SETDESKWALLPAPER , SystemParametersInfo devuelve TRUE a menos que haya un error (como cuando el archivo especificado no existe).
|
|
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. |
|
Habilita o deshabilita la apariencia del menú plano para los menús de usuario nativos. 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 del menú emergente, 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. |
|
Habilita o deshabilita la característica de suavizado de fuentes, que usa suavizado de fuente para 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 enFALSE. |
|
Establece el valor de contraste utilizado 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. |
|
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. |
|
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 debe establecerse. Windows 2000: Este parámetro no se admite. |
|
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 |
|---|---|
|
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).
|
|
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. |
|
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. |
|
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. |
|
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. |
|
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).
|
|
Vuelve a cargar los iconos del sistema. Establezca el parámetro uiParam en cero y el parámetro pvParam en NULL. |
|
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 . |
|
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 lápiz, el idioma de entrada y el beeper de advertencia.
| Parámetro de entrada | Significado |
|---|---|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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ú. |
|
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. |
|
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. |
|
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. |
|
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. |
|
Recupera el alto, en píxeles, del rectángulo en el que el puntero del mouse debe permanecer para que TrackMouseEvent genere un mensaje WM_MOUSEHOVER . El parámetro pvParam debe apuntar a una variable UINT que recibe el alto. |
|
Recupera el tiempo, en milisegundos, que el puntero del mouse tiene que permanecer en el rectángulo de desplazamiento de TrackMouseEvent para generar un mensaje de WM_MOUSEHOVER . El parámetro pvParam debe apuntar a una variable UINT que reciba la hora. |
|
Recupera el ancho, en píxeles, del rectángulo en el que el puntero del mouse debe permanecer para que TrackMouseEvent genere un mensaje de WM_MOUSEHOVER . El parámetro pvParam debe apuntar a una variable UINT que recibe el ancho. |
|
Recupera la velocidad actual del mouse. La velocidad del mouse determina hasta dónde 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). El valor predeterminado es 10. Un usuario final puede establecer el valor mediante la aplicación del panel de control del mouse o una aplicación mediante SPI_SETMOUSESPEED. |
|
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 de entero 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. |
|
Recupera la configuración de enrutamiento para la entrada del botón rueda. La configuración de enrutamiento determina si la entrada del botón de rueda 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. Si el valor es cero o MOUSEWHEEL_ROUTING_FOCUS, la entrada de la rueda del mouse se entrega a la aplicación con foco. Si el valor es 1 o MOUSEWHEEL_ROUTING_HYBRID (valor predeterminado), la entrada de la rueda del mouse se entrega a la aplicación con foco (aplicaciones de escritorio) o la aplicación bajo el cursor del mouse (aplicaciones de la Tienda Windows). No se usa el parámetro uiParam . |
|
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 de lápiz. |
|
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. |
|
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. |
|
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 . |
|
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. |
|
Recupera el número de caracteres que se desplazarán cuando se mueve la rueda del mouse horizontal. El parámetro pvParam debe apuntar a una variable UINT que recibe el número de líneas. El valor predeterminado es 3. |
|
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. |
|
Activa o desactiva el beeper de advertencia. El parámetro uiParam especifica TRUE para activado o FALSE para off. |
|
Determina 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 uiParam especifica TRUE si la entrada simulada no desactivará el protector de pantalla o FALSE si la entrada simulada desactivará el protector de pantalla. |
|
Establece la configuración de visualización de contactos actual. 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.
|
|
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. |
|
Establece el tiempo 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 . |
|
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 . |
|
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 . |
|
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.
|
|
Establece la esquematización de las letras clave de acceso del menú. El parámetro pvParam es una variable BOOL . Establezca pvParam en TRUE para resaltar siempre las teclas de acceso del menú o FALSE para subrayador las teclas de acceso del menú solo cuando el menú se activa desde el teclado. |
|
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. |
|
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, se ocultarían; uiParam es FALSE en caso contrario. |
|
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. |
|
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. |
|
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. |
|
Intercambia o restaura el significado de los botones izquierdo y derecho del mouse. 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 . |
|
Establece el alto, 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 alto. |
|
Establece la hora, en milisegundos, que el puntero del mouse debe permanecer en el rectángulo de desplazamiento de TrackMouseEvent para generar un mensaje 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. |
|
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. |
|
Establece la velocidad actual del mouse. El parámetro pvParam es un entero entre 1 (más lento) y 20 (más rápido). El valor predeterminado es 10. Este valor se establece normalmente mediante la aplicación del panel de control del mouse. |
|
Habilita o deshabilita la característica Seguimientos del mouse, lo 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 la pista. Windows 2000: Este parámetro no se admite. |
|
Establece la configuración de enrutamiento para la entrada del botón rueda. La configuración de enrutamiento determina si la entrada del botón de rueda 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. Si el valor es cero o MOUSEWHEEL_ROUTING_FOCUS, la entrada de la rueda del mouse se entrega a la aplicación con foco. Si el valor es 1 o MOUSEWHEEL_ROUTING_HYBRID (valor predeterminado), la entrada de la rueda del mouse se entrega a la aplicación con foco (aplicaciones de escritorio) o la aplicación bajo el cursor del mouse (aplicaciones de la Tienda Windows). Establezca el parámetro uiParam en cero. |
|
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 de lápiz. |
|
Habilita o deshabilita la característica de ajuste a botón 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 deshabilitarlo. 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. |
|
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 conmutador de entrada y, por tanto, desactivada 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. |
|
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. |
|
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. |
|
Establece el número de caracteres que se desplazarán cuando se mueve la rueda horizontal del mouse. El número de caracteres se establece desde el parámetro uiParam . |
|
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 van a desplazar 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 se debe interpretar 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 |
|---|---|
|
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. |
|
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 se puede cambiar. 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. |
|
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 la hora del retraso. |
|
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. |
|
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. |
|
Establece uiParam a la hora, 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 actual de energía de visualización, 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 de 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 actual de energía de visualización, use los siguientes parámetros de alimentación.
A continuación se muestran los parámetros del protector de pantalla.
A continuación se muestran los parámetros de tiempo de espera para aplicaciones y servicios.
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 la interfaz de usuario.
| Parámetro efectos de la interfaz de usuario | Significado |
|---|---|
|
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. |
|
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. |
|
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 . |
|
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. |
|
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. |
|
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. |
|
Igual que SPI_GETKEYBOARDCUES. |
|
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ú. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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 . |
|
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. |
|
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. |
|
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. |
|
Igual que SPI_SETKEYBOARDCUES. |
|
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. |
|
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. |
|
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 . |
|
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 |
|---|---|
|
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. |
|
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. |
|
Recupera el retraso de seguimiento de ventana activo, en milisegundos. El parámetro pvParam debe apuntar a una variable DWORD que reciba la hora. |
|
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).
|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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).
|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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á. |
|
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. |
|
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:
|
|
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. |
|
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. |
|
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. |
|
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).
|
|
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. |
|
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. |
|
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. |
|
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. |
|
Establece el arrastre de ventanas completas activadas o desactivadas. El parámetro uiParam especifica TRUE para activado o FALSE para off. |
|
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 . |
|
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 . |
|
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. |
|
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. |
|
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).
|
|
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 monitor. 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. |
|
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. |
|
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. |
|
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.
|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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:
|
[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 |
|---|---|
|
Escribe la nueva configuración de parámetro para todo el sistema en el perfil de usuario. |
|
Difunde el mensaje de WM_SETTINGCHANGE después de actualizar el perfil de usuario. |
|
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, el inglés de EE. UU. tiene un identificador de idioma de 0x0409, por lo que el diseño principal del 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) |