Partager via


Fonction SystemParametersInfoW (winuser.h)

Important

Certaines informations se rapportent à un produit de préversion qui peut être considérablement modifié avant sa commercialisation. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Récupère ou définit la valeur d’un des paramètres à l’échelle du système. Cette fonction peut également mettre à jour le profil utilisateur lors de la définition d’un paramètre.

Syntaxe

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

Paramètres

[in] uiAction

Type : UINT

Paramètre à l’échelle du système à récupérer ou à définir. Les valeurs possibles sont organisées dans les tableaux de paramètres associés suivants :

  • Paramètres d’accessibilité
  • Paramètres de bureau
  • Paramètres d’icône
  • Paramètres d'entrée
  • Paramètres de menu
  • Paramètres d’alimentation
  • Paramètres de l’économiseur d’écran
  • Paramètres de délai d’attente
  • Paramètres d’effet d’interface utilisateur
  • Paramètres de fenêtre

Voici les paramètres d’accessibilité.

Paramètre d’accessibilité Signification
SPI_GETACCESSTIMEOUT
0x003C
Récupère des informations sur le délai d’attente associé aux fonctionnalités d’accessibilité. Le paramètre pvParam doit pointer vers une structure ACCESSTIMEOUT qui reçoit les informations. Définissez le membre cbSize de cette structure et le paramètre uiParam sur sizeof(ACCESSTIMEOUT).
SPI_GETAUDIODESCRIPTION
0x0074
Détermine si les descriptions audio sont activées ou désactivées. Le paramètre pvParam est un pointeur vers une structure AUDIODESCRIPTION . Définissez le membre cbSize de cette structure et le paramètre uiParam sur sizeof(AUDIODESCRIPTION).

Bien qu’il soit possible pour les utilisateurs ayant une déficience visuelle d’entendre l’audio dans le contenu vidéo, il y a beaucoup d’action dans la vidéo qui n’a pas l’audio correspondant. Une description audio spécifique de ce qui se passe dans une vidéo permet à ces utilisateurs de mieux comprendre le contenu. Cet indicateur vous permet de déterminer si les descriptions audio ont été activées et dans quelle langue.

Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_GETCLIENTAREAANIMATION
0x1042
Détermine si les animations sont activées ou désactivées. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si les animations sont activées, ou FALSE dans le cas contraire.

Les fonctionnalités d’affichage telles que le clignotement, le clignotement, le scintillement et le déplacement du contenu peuvent provoquer des crises chez les utilisateurs atteints d’épilepsie photo-sensible. Cet indicateur vous permet de déterminer si ces animations ont été désactivées dans la zone cliente.

Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_GETDISABLEOVERLAPPEDCONTENT
0x1040
Détermine si le contenu superposé est activé ou désactivé. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si elle est activée, ou FALSE dans le cas contraire.

Les fonctionnalités d’affichage telles que les images d’arrière-plan, les arrière-plans texturés, les marques d’eau sur les documents, le mélange alpha et la transparence peuvent réduire le contraste entre le premier plan et l’arrière-plan, ce qui rend plus difficile pour les utilisateurs ayant une vision réduite de voir des objets à l’écran. Cet indicateur vous permet de déterminer si ce contenu qui se chevauche a été désactivé.

Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_GETFILTERKEYS
0x0032
Récupère des informations sur la fonctionnalité d’accessibilité FilterKeys. Le paramètre pvParam doit pointer vers une structure FILTERKEYS qui reçoit les informations. Définissez le membre cbSize de cette structure et le paramètre uiParam sur sizeof(FILTERKEYS).
SPI_GETFOCUSBORDERHEIGHT
0x2010
Récupère la hauteur, en pixels, des bords supérieur et inférieur du rectangle de focus dessiné avec DrawFocusRect. Le paramètre pvParam doit pointer vers une valeur UINT .

Windows 2000 : Ce paramètre n’est pas pris en charge.

SPI_GETFOCUSBORDERWIDTH
0x200E
Récupère la largeur, en pixels, des bords gauche et droit du rectangle de focus dessiné avec DrawFocusRect. Le paramètre pvParam doit pointer vers un UINT.

Windows 2000 : Ce paramètre n’est pas pris en charge.

SPI_GETHIGHCONTRAST
0x0042
Récupère des informations sur la fonctionnalité d’accessibilité HighContrast. Le paramètre pvParam doit pointer vers une structure HIGHCONTRAST qui reçoit les informations. Définissez le membre cbSize de cette structure et le paramètre uiParam sur sizeof(HIGHCONTRAST).

Pour une discussion générale, consultez Remarques.

SPI_GETLOGICALDPIOVERRIDE
0x009E
Récupère une valeur qui détermine si Windows 8 affiche des applications à l’aide du plateau de mise à l’échelle par défaut pour le matériel ou passe au plateau supérieur suivant. Cette valeur est basée sur le paramètre actuel « Agrandir tout sur votre écran », qui se trouve dans la section Options d’ergonomie desparamètres du PC : 1 est activé, 0 est désactivé.

Les applications peuvent fournir des ressources de texte et d’image pour chacun des plateaux de mise à l’échelle : 100 %, 140 % et 180 %. Le fait de fournir des ressources distinctes optimisées pour une mise à l’échelle particulière évite les distorsions dues au redimensionnement. Windows 8 détermine le plateau de mise à l’échelle approprié en fonction d’un certain nombre de facteurs, notamment la taille de l’écran et la densité de pixels. Lorsque « Tout agrandir à l’écran » est sélectionné (SPI_GETLOGICALDPIOVERRIDE retourne la valeur 1), Windows utilise les ressources du plateau supérieur suivant. Par exemple, dans le cas d’un matériel qui, selon Windows, doit utiliser une échelle de SCALE_100_PERCENT, ce remplacement amène Windows à utiliser la valeur d’échelle SCALE_140_PERCENT , en supposant qu’elle ne viole pas d’autres contraintes.

Note Vous ne devez pas utiliser cette valeur. Il peut être modifié ou indisponible dans les versions ultérieures de Windows. Utilisez plutôt la fonction GetScaleFactorForDevice ou la classe DisplayProperties pour récupérer le facteur de mise à l’échelle par défaut. Les applications de bureau doivent utiliser la résolution logique du bureau plutôt que le facteur d’échelle. Les ppp logiques du bureau peuvent être récupérés via la fonction GetDeviceCaps .
 
SPI_GETMESSAGEDURATION
0x2016
Récupère la durée pendant laquelle les fenêtres contextuelles de notification doivent être affichées, en secondes. Le paramètre pvParam doit pointer vers un ULONG qui reçoit la durée du message.

Les utilisateurs ayant une déficience visuelle ou des troubles cognitifs tels que le TDAH et la dyslexie peuvent avoir besoin d’un temps plus long pour lire le texte dans les messages de notification. Cet indicateur vous permet de récupérer la durée du message.

Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_GETMOUSECLICKLOCK
0x101E
Récupère l’état de la fonctionnalité ClickLock de la souris. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE s’il est activé, ou FALSE dans le cas contraire. Pour plus d’informations, consultez Vue d’ensemble des entrées de souris.

Windows 2000 : Ce paramètre n’est pas pris en charge.

SPI_GETMOUSECLICKLOCKTIME
0x2008
Récupère le délai avant le verrouillage du bouton principal de la souris. Le paramètre pvParam doit pointer vers DWORD qui reçoit le délai, en millisecondes. Cette option n’est activée que si SPI_SETMOUSECLICKLOCK a la valeur TRUE. Pour plus d’informations, consultez Vue d’ensemble des entrées de souris.

Windows 2000 : Ce paramètre n’est pas pris en charge.

SPI_GETMOUSEKEYS
0x0036
Récupère des informations sur la fonctionnalité d’accessibilité MouseKeys. Le paramètre pvParam doit pointer vers une structure MOUSEKEYS qui reçoit les informations. Définissez le membre cbSize de cette structure et le paramètre uiParam sur sizeof(MOUSEKEYS).
SPI_GETMOUSESONAR
0x101C
Récupère l’état de la fonctionnalité Sonar de souris. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si activé ou FALSE dans le cas contraire. Pour plus d’informations, consultez Vue d’ensemble des entrées de souris.

Windows 2000 : Ce paramètre n’est pas pris en charge.

SPI_GETMOUSEVANISH
0x1020
Récupère l’état de la fonctionnalité De disparition de la souris. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si activé ou FALSE dans le cas contraire. Pour plus d’informations, consultez Vue d’ensemble des entrées de souris.

Windows 2000 : Ce paramètre n’est pas pris en charge.

SPI_GETSCREENREADER
0x0046
Détermine si un utilitaire de réviseur d’écran est en cours d’exécution. Un utilitaire de réviseur d’écran dirige les informations textuelles vers un appareil de sortie, comme un synthétiseur vocal ou un affichage Braille. Lorsque cet indicateur est défini, une application doit fournir des informations textuelles dans les situations où elle présenterait les informations sous forme graphique.

Le paramètre pvParam est un pointeur vers une variable BOOL qui reçoit TRUE si un utilitaire de réviseur d’écran est en cours d’exécution, ou FALSE dans le cas contraire.

Note Le Narrateur, le lecteur d’écran inclus dans Windows, ne définit pas les indicateurs SPI_SETSCREENREADER ou SPI_GETSCREENREADER .
 
SPI_GETSERIALKEYS
0x003E
Ce paramètre n’est pas pris en charge.

Windows Server 2003 et Windows XP/2000 : L’utilisateur doit contrôler ce paramètre via le Panneau de configuration.

SPI_GETSHOWSOUNDS
0x0038
Détermine si l’indicateur d’accessibilité Afficher les sons est activé ou désactivé. S’il est activé, l’utilisateur a besoin d’une application pour présenter des informations visuellement dans des situations où elle ne présenterait les informations que sous forme audible. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si la fonctionnalité est activée ou FALSE si elle est désactivée.

L’utilisation de cette valeur équivaut à appeler GetSystemMetrics avec SM_SHOWSOUNDS. Il s’agit de l’appel recommandé.

SPI_GETSOUNDSENTRY
0x0040
Récupère des informations sur la fonctionnalité d’accessibilité SoundSentry. Le paramètre pvParam doit pointer vers une structure SOUNDSENTRY qui reçoit les informations. Définissez le membre cbSize de cette structure et le paramètre uiParam sur sizeof(SOUNDSENTRY).
SPI_GETSTICKYKEYS
0x003A
Récupère des informations sur la fonctionnalité d’accessibilité StickyKeys. Le paramètre pvParam doit pointer vers une structure STICKYKEYS qui reçoit les informations. Définissez le membre cbSize de cette structure et le paramètre uiParam sur sizeof(STICKYKEYS).
SPI_GETTOGGLEKEYS
0x0034
Récupère des informations sur la fonctionnalité d’accessibilité ToggleKeys. Le paramètre pvParam doit pointer vers une structure TOGGLEKEYS qui reçoit les informations. Définissez le membre cbSize de cette structure et le paramètre uiParam sur sizeof(TOGGLEKEYS).
SPI_SETACCESSTIMEOUT
0x003D
Définit le délai d’attente associé aux fonctionnalités d’accessibilité. Le paramètre pvParam doit pointer vers une structure ACCESSTIMEOUT qui contient les nouveaux paramètres. Définissez le membre cbSize de cette structure et le paramètre uiParam sur sizeof(ACCESSTIMEOUT).
SPI_SETAUDIODESCRIPTION
0x0075
Active ou désactive la fonctionnalité de descriptions audio. Le paramètre pvParam est un pointeur vers une structure AUDIODESCRIPTION .

Bien qu’il soit possible pour les utilisateurs malvoyants d’entendre l’audio dans le contenu vidéo, il y a beaucoup d’actions dans la vidéo qui n’ont pas d’audio correspondant. Une description audio spécifique de ce qui se passe dans une vidéo aide ces utilisateurs à mieux comprendre le contenu. Cet indicateur vous permet d’activer ou de désactiver les descriptions audio dans les langues dans lesquelles elles sont fournies.

Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_SETCLIENTAREAANIMATION
0x1043
Active ou désactive les animations de zone client. Le paramètre pvParam est une variable BOOL . Définissez pvParam sur TRUE pour activer les animations et autres effets temporaires dans la zone cliente, ou FALSE pour les désactiver.

Les fonctionnalités d’affichage telles que le clignotement, le clignotement, le clignotement, le scintillement et le déplacement du contenu peuvent provoquer des crises chez les utilisateurs atteints d’épilepsie photo-sensible. Cet indicateur vous permet d’activer ou de désactiver toutes ces animations.

Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_SETDISABLEOVERLAPPEDCONTENT
0x1041
Active ou désactive le contenu qui se chevauche (tels que les images d’arrière-plan et les filigranes). Le paramètre pvParam est une variable BOOL . Définissez pvParam sur TRUE pour désactiver le contenu qui se chevauche ou FALSE pour activer le contenu qui se chevauche.

Les fonctionnalités d’affichage telles que les images d’arrière-plan, les arrière-plans texturés, les marques d’eau sur les documents, le mélange alpha et la transparence peuvent réduire le contraste entre le premier plan et l’arrière-plan, ce qui rend plus difficile pour les utilisateurs malvoyants de voir des objets à l’écran. Cet indicateur vous permet d’activer ou de désactiver tout ce contenu qui se chevauche.

Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_SETFILTERKEYS
0x0033
Définit les paramètres de la fonctionnalité d’accessibilité FilterKeys. Le paramètre pvParam doit pointer vers une structure FILTERKEYS qui contient les nouveaux paramètres. Définissez le membre cbSize de cette structure et le paramètre uiParam sur sizeof(FILTERKEYS).
SPI_SETFOCUSBORDERHEIGHT
0x2011
Définit la hauteur des bords supérieur et inférieur du rectangle de focus dessiné avec DrawFocusRect sur la valeur du paramètre pvParam .

Windows 2000 : Ce paramètre n’est pas pris en charge.

SPI_SETFOCUSBORDERWIDTH
0x200F
Définit la hauteur des bords gauche et droit du rectangle de focus dessiné avec DrawFocusRect sur la valeur du paramètre pvParam .

Windows 2000 : Ce paramètre n’est pas pris en charge.

SPI_SETHIGHCONTRAST
0x0043
Définit les paramètres de la fonctionnalité d’accessibilité HighContrast. Le paramètre pvParam doit pointer vers une structure HIGHCONTRAST qui contient les nouveaux paramètres. Définissez le membre cbSize de cette structure et le paramètre uiParam sur sizeof(HIGHCONTRAST).
SPI_SETLOGICALDPIOVERRIDE
0x009F
Ne pas utiliser.
SPI_SETMESSAGEDURATION
0x2017
Définit l’heure à laquelle les fenêtres contextuelles de notification doivent être affichées, en secondes. Le paramètre pvParam spécifie la durée du message.

Les utilisateurs ayant une déficience visuelle ou des troubles cognitifs tels que le TDAH et la dyslexie peuvent avoir besoin d’un temps plus long pour lire le texte dans les messages de notification. Cet indicateur vous permet de définir la durée du message.

Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_SETMOUSECLICKLOCK
0x101F
Active ou désactive la fonctionnalité d’accessibilité ClickLock de la souris. Cette fonctionnalité verrouille temporairement le bouton principal de la souris lorsque l’utilisateur clique sur ce bouton et qu’il est maintenu enfoncé pendant la durée spécifiée par SPI_SETMOUSECLICKLOCKTIME. Le paramètre pvParam spécifie TRUE pour on, ou FALSE pour off. La valeur par défaut est off. Pour plus d’informations, consultez Remarques et AboutMouse Input.

Windows 2000 : Ce paramètre n’est pas pris en charge.

SPI_SETMOUSECLICKLOCKTIME
0x2009
Ajuste le délai avant le verrouillage du bouton principal de la souris. Le paramètre uiParam doit être défini sur 0. Le paramètre pvParam pointe vers un DWORD qui spécifie le délai en millisecondes. Par exemple, spécifiez 1 000 pour un délai d'1 seconde. La valeur par défaut est 1200. Pour plus d’informations, consultez Vue d’ensemble des entrées de souris.

Windows 2000 : Ce paramètre n’est pas pris en charge.

SPI_SETMOUSEKEYS
0x0037
Définit les paramètres de la fonctionnalité d’accessibilité MouseKeys. Le paramètre pvParam doit pointer vers une structure MOUSEKEYS qui contient les nouveaux paramètres. Définissez le membre cbSize de cette structure et le paramètre uiParam sur sizeof(MOUSEKEYS).
SPI_SETMOUSESONAR
0x101D
Active ou désactive la fonctionnalité d’accessibilité sonar. Cette fonctionnalité montre brièvement plusieurs cercles concentriques autour du pointeur de la souris lorsque l’utilisateur appuie et relâche la touche CTRL. Le paramètre pvParam spécifie TRUE pour on et FALSE pour off. La valeur par défaut est off. Pour plus d’informations, consultez Vue d’ensemble des entrées de souris.

Windows 2000 : Ce paramètre n’est pas pris en charge.

SPI_SETMOUSEVANISH
0x1021
Active ou désactive la fonctionnalité Vanish. Cette fonctionnalité masque le pointeur de la souris lorsque l’utilisateur tape ; le pointeur réapparaît lorsque l’utilisateur déplace la souris. Le paramètre pvParam spécifie TRUE pour on et FALSE pour off. La valeur par défaut est off. Pour plus d’informations, consultez Vue d’ensemble des entrées de souris.

Windows 2000 : Ce paramètre n’est pas pris en charge.

SPI_SETSCREENREADER
0x0047
Détermine si un utilitaire de révision d’écran est en cours d’exécution. Le paramètre uiParam spécifie TRUE pour on, ou FALSE pour off.
Note Le Narrateur, le lecteur d’écran inclus dans Windows, ne définit pas les indicateurs SPI_SETSCREENREADER ou SPI_GETSCREENREADER .
 
SPI_SETSERIALKEYS
0x003F
Ce paramètre n’est pas pris en charge.

Windows Server 2003 et Windows XP/2000 : L’utilisateur doit contrôler ce paramètre via le Panneau de configuration.

SPI_SETSHOWSOUNDS
0x0039
Active ou désactive la fonctionnalité d’accessibilité ShowSounds. Le paramètre uiParam spécifie TRUE pour on, ou FALSE pour off.
SPI_SETSOUNDSENTRY
0x0041
Définit les paramètres de la fonctionnalité d’accessibilité SoundSentry . Le paramètre pvParam doit pointer vers une structure SOUNDSENTRY qui contient les nouveaux paramètres. Définissez le membre cbSize de cette structure et le paramètre uiParam sur sizeof(SOUNDSENTRY).
SPI_SETSTICKYKEYS
0x003B
Définit les paramètres de la fonctionnalité d’accessibilité StickyKeys. Le paramètre pvParam doit pointer vers une structure STICKYKEYS qui contient les nouveaux paramètres. Définissez le membre cbSize de cette structure et le paramètre uiParam sur sizeof(STICKYKEYS).
SPI_SETTOGGLEKEYS
0x0035
Définit les paramètres de la fonctionnalité d’accessibilité ToggleKeys. Le paramètre pvParam doit pointer vers une structure TOGGLEKEYS qui contient les nouveaux paramètres. Définissez le membre cbSize de cette structure et le paramètre uiParam sur sizeof(TOGGLEKEYS).
 

Voici les paramètres de bureau.

Paramètre Desktop Signification
SPI_GETCLEARTYPE
0x1048
Détermine si ClearType est activé. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si ClearType est activé, ou FALSE dans le cas contraire.

ClearType est une technologie logicielle qui améliore la lisibilité du texte sur les écrans à cristaux liquides (LCD).

Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_GETDESKWALLPAPER
0x0073
Récupère le chemin d’accès complet du fichier bitmap pour le papier peint du bureau. Le paramètre pvParam doit pointer vers une mémoire tampon pour recevoir la chaîne de chemin d’accès terminée par null. Définissez le paramètre uiParam sur la taille, en caractères, de la mémoire tampon pvParam . La chaîne retournée ne dépassera pas MAX_PATH caractères. S’il n’y a pas de papier peint du bureau, la chaîne retournée est vide.
SPI_GETDROPSHADOW
0x1024
Détermine si l’effet d’ombre portée est activé. Le paramètre pvParam doit pointer vers une variable BOOL qui retourne TRUE si elle est activée ou FALSE si elle est désactivée.

Windows 2000 : Ce paramètre n’est pas pris en charge.

SPI_GETFLATMENU
0x1022
Détermine si les menus Utilisateur natifs ont une apparence de menu plat. Le paramètre pvParam doit pointer vers une variable BOOL qui retourne TRUE si l’apparence du menu plat est définie, ou FALSE dans le cas contraire.

Windows 2000 : Ce paramètre n’est pas pris en charge.

SPI_GETFONTSMOOTHING
0x004A
Détermine si la fonctionnalité de lissage des polices est activée. Cette fonctionnalité utilise l’anticrénelage des polices pour rendre les courbes de police plus fluides en peignant des pixels à différents niveaux de gris.

Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si la fonctionnalité est activée, ou FALSE si ce n’est pas le cas.

SPI_GETFONTSMOOTHINGCONTRAST
0x200C
Récupère une valeur de contraste utilisée dans le lissage ClearType . Le paramètre pvParam doit pointer vers un UINT qui reçoit les informations. Les valeurs de contraste valides sont comprises entre 1000 et 2200. La valeur par défaut est 1400.

Windows 2000 : Ce paramètre n’est pas pris en charge.

SPI_GETFONTSMOOTHINGORIENTATION
0x2012
Récupère l’orientation de lissage des polices. Le paramètre pvParam doit pointer vers un UINT qui reçoit les informations. Les valeurs possibles sont FE_FONTSMOOTHINGORIENTATIONBGR (bleu-vert-rouge) et FE_FONTSMOOTHINGORIENTATIONRGB (rouge-vert-bleu).

Windows XP/2000 : Ce paramètre n’est pas pris en charge tant que Windows XP avec SP2.

SPI_GETFONTSMOOTHINGTYPE
0x200A
Récupère le type de lissage de police. Le paramètre pvParam doit pointer vers un UINT qui reçoit les informations. Les valeurs possibles sont FE_FONTSMOOTHINGSTANDARD et FE_FONTSMOOTHINGCLEARTYPE.

Windows 2000 : Ce paramètre n’est pas pris en charge.

SPI_GETWORKAREA
0x0030
Récupère la taille de la zone de travail sur le moniteur d’affichage principal. La zone de travail est la partie de l’écran qui n’est pas masquée par la barre des tâches système ou par les barres d’outils du bureau d’application. Le paramètre pvParam doit pointer vers une structure RECT qui reçoit les coordonnées de la zone de travail, exprimées en taille de pixel physique. Tout mode de virtualisation PPP de l’appelant n’a aucun effet sur cette sortie.

Pour obtenir la zone de travail d’un moniteur autre que le moniteur d’affichage principal, appelez la fonction GetMonitorInfo .

SPI_SETCLEARTYPE
0x1049
Active ou désactive ClearType. Le paramètre pvParam est une variable BOOL . Définissez pvParam sur TRUE pour activer ClearType ou FALSE pour le désactiver.

ClearType est une technologie logicielle qui améliore la lisibilité du texte sur les écrans LCD.

Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_SETCURSORS
0x0057
Recharge les curseurs système. Définissez le paramètre uiParam sur zéro et le paramètre pvParam sur NULL.
SPI_SETDESKPATTERN
0x0015
Définit le modèle de bureau actuel en obligeant Windows à lire le paramètre Pattern= à partir du fichier WIN.INI.
SPI_SETDESKWALLPAPER
0x0014
Note Lorsque l’indicateur SPI_SETDESKWALLPAPER est utilisé, SystemParametersInfo retourne TRUE , sauf en cas d’erreur (par exemple, quand le fichier spécifié n’existe pas).
 
SPI_SETDROPSHADOW
0x1025
Active ou désactive l’effet d’ombre portée. Définissez pvParam sur TRUE pour activer l’effet d’ombre portée ou FALSE pour le désactiver. Vous devez également avoir CS_DROPSHADOW dans le style de classe de fenêtre.

Windows 2000 : Ce paramètre n’est pas pris en charge.

SPI_SETFLATMENU
0x1023
Active ou désactive l’apparence du menu plat pour les menus utilisateur natifs. Définissez pvParam sur TRUE pour activer l’apparence du menu plat ou FALSE pour le désactiver.

Lorsqu’elle est activée, la barre de menus utilise COLOR_MENUBAR pour l’arrière-plan de la barre de menus, COLOR_MENU pour l’arrière-plan de menu contextuel, COLOR_MENUHILIGHT pour le remplissage de la sélection de menu active et COLOR_HILIGHT pour le contour de la sélection de menu active. S’ils sont désactivés, les menus sont dessinés à l’aide des mêmes métriques et couleurs que dans Windows 2000.

Windows 2000 : Ce paramètre n’est pas pris en charge.

SPI_SETFONTSMOOTHING
0x004B
Active ou désactive la fonctionnalité de lissage des polices, qui utilise l’anticrénelage des polices pour rendre les courbes de police plus fluides en peignant des pixels à différents niveaux de gris.

Pour activer la fonctionnalité, définissez le paramètre uiParam sur TRUE. Pour désactiver la fonctionnalité, définissez uiParam sur FALSE.

SPI_SETFONTSMOOTHINGCONTRAST
0x200D
Définit la valeur de contraste utilisée dans le lissage ClearType . Le paramètre pvParam est la valeur de contraste. Les valeurs de contraste valides sont comprises entre 1000 et 2200. La valeur par défaut est 1400.

SPI_SETFONTSMOOTHINGTYPE doit également être défini sur FE_FONTSMOOTHINGCLEARTYPE.

Windows 2000 : Ce paramètre n’est pas pris en charge.

SPI_SETFONTSMOOTHINGORIENTATION
0x2013
Définit l’orientation du lissage des polices. Le paramètre pvParam est FE_FONTSMOOTHINGORIENTATIONBGR (bleu-vert-rouge) ou FE_FONTSMOOTHINGORIENTATIONRGB (rouge-vert-bleu).

Windows XP/2000 : Ce paramètre n’est pas pris en charge tant que Windows XP avec SP2.

SPI_SETFONTSMOOTHINGTYPE
0x200B
Définit le type de lissage de police. Le paramètre pvParam est FE_FONTSMOOTHINGSTANDARD, si l’anticrénelage standard est utilisé, ou FE_FONTSMOOTHINGCLEARTYPE, si ClearType est utilisé. La valeur par défaut est FE_FONTSMOOTHINGSTANDARD.

SPI_SETFONTSMOOTHING doit également être défini.

Windows 2000 : Ce paramètre n’est pas pris en charge.

SPI_SETWORKAREA
0x002F
Définit la taille de la zone de travail. La zone de travail est la partie de l’écran qui n’est pas masquée par la barre des tâches système ou par les barres d’outils du bureau d’application. Le paramètre pvParam est un pointeur vers une structure RECT qui spécifie le nouveau rectangle de zone de travail, exprimé en coordonnées d’écran virtuel. Dans un système avec plusieurs moniteurs d’affichage, la fonction définit la zone de travail du moniteur qui contient le rectangle spécifié.
 

Voici les paramètres d’icône.

Paramètre Icon Signification
SPI_GETICONMETRICS
0x002D
Récupère les métriques associées aux icônes. Le paramètre pvParam doit pointer vers une structure ICONMETRICS qui reçoit les informations. Définissez le membre cbSize de cette structure et le paramètre uiParam sur sizeof(ICONMETRICS).
SPI_GETICONTITLELOGFONT
0x001F
Récupère les informations de police logiques pour la police icône-titre actuelle. Le paramètre uiParam spécifie la taille d’une structure LOGFONT , et le paramètre pvParam doit pointer vers la structure LOGFONT à remplir.
SPI_GETICONTITLEWRAP
0x0019
Détermine si l’habillage des icônes et des titres est activé. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si elle est activée, ou FALSE dans le cas contraire.
SPI_ICONHORIZONTALSPACING
0x000D
Définit ou récupère la largeur, en pixels, d’une cellule d’icône. Le système utilise ce rectangle pour réorganiser les icônes dans une fenêtre plus large.

Pour définir cette valeur, définissez uiParam sur la nouvelle valeur et définissez pvParam sur NULL. Vous ne pouvez pas définir cette valeur sur une valeur inférieure à SM_CXICON.

Pour récupérer cette valeur, pvParam doit pointer vers un entier qui reçoit la valeur actuelle.

SPI_ICONVERTICALSPACING
0x0018
Définit ou récupère la hauteur, en pixels, d’une cellule d’icône.

Pour définir cette valeur, définissez uiParam sur la nouvelle valeur et définissez pvParam sur NULL. Vous ne pouvez pas définir cette valeur sur une valeur inférieure à SM_CYICON.

Pour récupérer cette valeur, pvParam doit pointer vers un entier qui reçoit la valeur actuelle.

SPI_SETICONMETRICS
0x002E
Définit les métriques associées aux icônes. Le paramètre pvParam doit pointer vers une structure ICONMETRICS qui contient les nouveaux paramètres. Définissez le membre cbSize de cette structure et le paramètre uiParam sur sizeof(ICONMETRICS).
SPI_SETICONS
0x0058
Recharge les icônes système. Définissez le paramètre uiParam sur zéro et le paramètre pvParam sur NULL.
SPI_SETICONTITLELOGFONT
0x0022
Définit la police utilisée pour les titres d’icône. Le paramètre uiParam spécifie la taille d’une structure LOGFONT , et le paramètre pvParam doit pointer vers une structure LOGFONT .
SPI_SETICONTITLEWRAP
0x001A
Active ou désactive l’habillage du titre de l’icône. Le paramètre uiParam spécifie TRUE pour on, ou FALSE pour off.
 

Voici les paramètres d’entrée. Ils incluent des paramètres liés au clavier, à la souris, au stylet, à la langue d’entrée et au beeper d’avertissement.

Paramètre d’entrée Signification
SPI_GETBEEP
0x0001
Détermine si le beeper d’avertissement est activé.

Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si le beeper est activé ou FALSE s’il est désactivé.

SPI_GETBLOCKSENDINPUTRESETS
0x1026
Récupère un boOL indiquant si une application peut réinitialiser le minuteur de l’écran de veille en appelant la fonction SendInput pour simuler une entrée au clavier ou à la souris. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si l’entrée simulée est bloquée, ou FALSE dans le cas contraire.
SPI_GETCONTACTVISUALIZATION
0x2018
Récupère le paramètre de visualisation du contact actuel. Le paramètre pvParam doit pointer vers une variable ULONG qui reçoit le paramètre. Pour plus d’informations, consultez Visualisation des contacts.
SPI_GETDEFAULTINPUTLANG
0x0059
Récupère l’identificateur des paramètres régionaux d’entrée pour la langue d’entrée par défaut du système. Le paramètre pvParam doit pointer vers une variable HKL qui reçoit cette valeur. Pour plus d’informations, consultez Langues, paramètres régionaux et dispositions du clavier.
SPI_GETGESTUREVISUALIZATION
0x201A
Récupère le paramètre de visualisation de mouvement actuel. Le paramètre pvParam doit pointer vers une variable ULONG qui reçoit le paramètre. Pour plus d’informations, consultez Visualisation des mouvements.
SPI_GETKEYBOARDCUES
0x100A
Détermine si les touches d’accès de menu sont toujours soulignées. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si les touches d’accès au menu sont toujours soulignées et FALSE si elles sont soulignées uniquement lorsque le menu est activé par le clavier.
SPI_GETKEYBOARDDELAY
0x0016
Récupère le paramètre de délai de répétition du clavier, qui est une valeur comprise entre 0 (délai d’environ 250 ms) et 3 (délai d’environ 1 seconde). Le délai réel associé à chaque valeur peut varier en fonction du matériel. Le paramètre pvParam doit pointer vers une variable entière qui reçoit le paramètre.
SPI_GETKEYBOARDPREF
0x0044
Détermine si l’utilisateur s’appuie sur le clavier plutôt que sur la souris et souhaite que les applications affichent des interfaces clavier qui seraient autrement masquées. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si l’utilisateur s’appuie sur le clavier ; ou FALSE dans le cas contraire.
SPI_GETKEYBOARDSPEED
0x000A
Récupère le paramètre de vitesse de répétition du clavier, qui est une valeur comprise entre 0 (environ 2,5 répétitions par seconde) et 31 (environ 30 répétitions par seconde). Les taux de répétition réels dépendent du matériel et peuvent varier d’une échelle linéaire de 20 %. Le paramètre pvParam doit pointer vers une variable DWORD qui reçoit le paramètre.
SPI_GETMOUSE
0x0003
Récupère les deux valeurs de seuil de la souris et l’accélération de la souris. Le paramètre pvParam doit pointer vers un tableau de trois entiers qui reçoit ces valeurs. Pour plus d’informations, consultez mouse_event .
SPI_GETMOUSEHOVERHEIGHT
0x0064
Récupère la hauteur, en pixels, du rectangle dans lequel le pointeur de la souris doit rester pour que TrackMouseEvent génère un message WM_MOUSEHOVER . Le paramètre pvParam doit pointer vers une variable UINT qui reçoit la hauteur.
SPI_GETMOUSEHOVERTIME
0x0066
Récupère le temps, en millisecondes, que le pointeur de la souris doit rester dans le rectangle de pointage pour Que TrackMouseEvent génère un message WM_MOUSEHOVER . Le paramètre pvParam doit pointer vers une variable UINT qui reçoit l’heure.
SPI_GETMOUSEHOVERWIDTH
0x0062
Récupère la largeur, en pixels, du rectangle dans lequel le pointeur de la souris doit rester pour que TrackMouseEvent génère un message WM_MOUSEHOVER . Le paramètre pvParam doit pointer vers une variable UINT qui reçoit la largeur.
SPI_GETMOUSESPEED
0x0070
Récupère la vitesse actuelle de la souris. La vitesse de la souris détermine la distance à laquelle le pointeur se déplacera en fonction de la distance que la souris déplace. Le paramètre pvParam doit pointer vers un entier qui reçoit une valeur comprise entre 1 (le plus lent) et 20 (le plus rapide). La valeur par défaut est 10. La valeur peut être définie par un utilisateur final à l’aide de l’application du panneau de configuration de la souris ou par une application utilisant SPI_SETMOUSESPEED.
SPI_GETMOUSETRAILS
0x005E
Détermine si la fonctionnalité Traces de souris est activée. Cette fonctionnalité améliore la visibilité des mouvements de curseur de la souris en montrant brièvement une piste de curseurs et en les effançant rapidement.

Le paramètre pvParam doit pointer vers une variable entière qui reçoit une valeur. si la valeur est zéro ou 1, la fonctionnalité est désactivée. Si la valeur est supérieure à 1, la fonctionnalité est activée et la valeur indique le nombre de curseurs dessinés dans la trace. Le paramètre uiParam n’est pas utilisé.

Windows 2000 : Ce paramètre n’est pas pris en charge.

SPI_GETMOUSEWHEELROUTING
0x201C
Récupère le paramètre de routage pour l’entrée du bouton wheel. Le paramètre de routage détermine si l’entrée du bouton de la roulette est envoyée à l’application avec le focus (au premier plan) ou à l’application sous le curseur de la souris.

Le paramètre pvParam doit pointer vers une variable DWORD qui reçoit l’option de routage. Si la valeur est zéro ou MOUSEWHEEL_ROUTING_FOCUS, l’entrée de la roulette de la souris est remise à l’application avec le focus. Si la valeur est 1 ou MOUSEWHEEL_ROUTING_HYBRID (valeur par défaut), l’entrée de la roulette de la souris est remise à l’application avec le focus (applications de bureau) ou à l’application sous le curseur de la souris (applications du Windows Store). Le paramètre uiParam n’est pas utilisé.

SPI_GETPENVISUALIZATION
0x201E
Récupère le paramètre actuel de visualisation du mouvement du stylet. Le paramètre pvParam doit pointer vers une variable ULONG qui reçoit le paramètre. Pour plus d’informations, consultez Visualisation du stylet.
SPI_GETSNAPTODEFBUTTON
0x005F
Détermine si la fonctionnalité snap-to-default-button est activée. Si cette option est activée, le curseur de la souris se déplace automatiquement vers le bouton par défaut, tel que OK ou Appliquer, d’une boîte de dialogue. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si la fonctionnalité est activée ou FALSE si elle est désactivée.
SPI_GETSYSTEMLANGUAGEBAR
0x1050
À compter de Windows 8 : Détermine si la barre de langue système est activée ou désactivée. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si la barre de langue est activée, ou FALSE dans le cas contraire.
SPI_GETTHREADLOCALINPUTSETTINGS
0x104E
À compter de Windows 8 : Détermine si les paramètres d’entrée actifs ont l’étendue Local (par thread, TRUE) ou Global (session, FALSE). Le paramètre pvParam doit pointer vers une variable BOOL .
SPI_GETTOUCHPADPARAMETERS
0x00AE
À compter de Windows 11, version 24H2 : Récupère des détails sur le pavé tactile Precision, y compris les paramètres utilisateur et les informations système relatives au pavé tactile.

Le paramètre pvParam doit pointer vers une structure TOUCHPAD_PARAMETERS .

Le paramètre uiParam doit spécifier la taille de la structure.

La valeur du champ versionNumber dans la structure TOUCHPAD_PARAMETERS doit être définie sur la valeur appropriée pour la version de la structure utilisée.

SPI_GETWHEELSCROLLCHARS
0x006C
Récupère le nombre de caractères à faire défiler lorsque la roulette horizontale de la souris est déplacée. Le paramètre pvParam doit pointer vers une variable UINT qui reçoit le nombre de lignes. La valeur par défaut est 3.
SPI_GETWHEELSCROLLLINES
0x0068
Récupère le nombre de lignes à faire défiler lorsque la roulette verticale de la souris est déplacée. Le paramètre pvParam doit pointer vers une variable UINT qui reçoit le nombre de lignes. La valeur par défaut est 3.
SPI_SETBEEP
0x0002
Active ou désactive le beeper d’avertissement. Le paramètre uiParam spécifie TRUE pour on, ou FALSE pour off.
SPI_SETBLOCKSENDINPUTRESETS
0x1027
Détermine si une application peut réinitialiser le minuteur de l’écran de veille en appelant la fonction SendInput pour simuler une entrée au clavier ou à la souris. Le paramètre uiParam spécifie TRUE si l’écran de veille ne sera pas désactivé par une entrée simulée, ou FALSE si l’écran de veille sera désactivé par une entrée simulée.
SPI_SETCONTACTVISUALIZATION
0x2019
Définit le paramètre de visualisation du contact actuel. Le paramètre pvParam doit pointer vers une variable ULONG qui identifie le paramètre. Pour plus d’informations, consultez Visualisation des contacts.
Note Si les visualisations de contact sont désactivées, les visualisations de mouvement ne peuvent pas être activées.
 
SPI_SETDEFAULTINPUTLANG
0x005A
Définit la langue d’entrée par défaut pour l’interpréteur de commandes système et les applications. La langue spécifiée doit pouvoir être affichée à l’aide du jeu de caractères système actuel. Le paramètre pvParam doit pointer vers une variable HKL qui contient l’identificateur de paramètres régionaux d’entrée pour la langue par défaut. Pour plus d’informations, consultez Langues, paramètres régionaux et dispositions du clavier.
SPI_SETDOUBLECLICKTIME
0x0020
Définit l’heure de double-clic de la souris sur la valeur du paramètre uiParam . Si la valeur uiParam est supérieure à 5 000 millisecondes, le système définit le temps de double-clic sur 5 000 millisecondes.

Le temps de double-clic est le nombre maximal de millisecondes qui peuvent se produire entre le premier et le deuxième clic d’un double-clic. Vous pouvez également appeler la fonction SetDoubleClickTime pour définir l’heure de double-clic. Pour obtenir l’heure de double-clic actuelle, appelez la fonction GetDoubleClickTime .

SPI_SETDOUBLECLKHEIGHT
0x001E
Définit la hauteur du rectangle de double-clic sur la valeur du paramètre uiParam .

Le rectangle de double-clic est le rectangle dans lequel le deuxième clic d’un double-clic doit se trouver pour qu’il soit inscrit en tant que double-clic.

Pour récupérer la hauteur du rectangle de double-clic, appelez GetSystemMetrics avec l’indicateur SM_CYDOUBLECLK .

SPI_SETDOUBLECLKWIDTH
0x001D
Définit la largeur du rectangle double-clic sur la valeur du paramètre uiParam .

Le rectangle double-clic est le rectangle dans lequel le deuxième clic d’un double-clic doit tomber pour qu’il soit inscrit en tant que double-clic.

Pour récupérer la largeur du rectangle double-clic, appelez GetSystemMetrics avec l’indicateur SM_CXDOUBLECLK .

SPI_SETGESTUREVISUALIZATION
0x201B
Définit le paramètre de visualisation des mouvements actuel. Le paramètre pvParam doit pointer vers une variable ULONG qui identifie le paramètre. Pour plus d’informations, consultez Visualisation des mouvements.
Note Si les visualisations de contact sont désactivées, les visualisations de mouvements ne peuvent pas être activées.
 
SPI_SETKEYBOARDCUES
0x100B
Définit le soulignement des lettres clés d’accès au menu. Le paramètre pvParam est une variable BOOL . Définissez pvParam sur TRUE pour souligner toujours les touches d’accès du menu, ou FALSE sur les touches d’accès du menu de soulignement uniquement lorsque le menu est activé à partir du clavier.
SPI_SETKEYBOARDDELAY
0x0017
Définit le paramètre de délai de répétition du clavier. Le paramètre uiParam doit spécifier 0, 1, 2 ou 3, où zéro définit le délai le plus court d’environ 250 ms) et 3 définit le délai le plus long (environ 1 seconde). Le délai réel associé à chaque valeur peut varier en fonction du matériel.
SPI_SETKEYBOARDPREF
0x0045
Définit la préférence de clavier. Le paramètre uiParam spécifie TRUE si l’utilisateur s’appuie sur le clavier plutôt que sur la souris et souhaite que les applications affichent des interfaces clavier qui seraient autrement masquées ; uiParam a la valeur FALSE dans le cas contraire.
SPI_SETKEYBOARDSPEED
0x000B
Définit le paramètre de vitesse de répétition du clavier. Le paramètre uiParam doit spécifier une valeur dans la plage comprise entre 0 (environ 2,5 répétitions par seconde) et 31 (environ 30 répétitions par seconde). Les taux de répétition réels dépendent du matériel et peuvent varier d’une échelle linéaire de 20 %. Si uiParam est supérieur à 31, le paramètre est défini sur 31.
SPI_SETLANGTOGGLE
0x005B
Définit le jeu de touches chaudes pour basculer entre les langues d’entrée. Les paramètres uiParam et pvParam ne sont pas utilisés. La valeur définit les touches de raccourci dans les feuilles de propriétés du clavier en lisant à nouveau le Registre. Le Registre doit être défini avant d’utiliser cet indicateur. le chemin d’accès dans le Registre est HKEY_CURRENT_USER\Disposition du clavier\Bascule

. Les valeurs valides sont « 1 » = ALT+MAJ, « 2 » = Ctrl+Maj et « 3 » = none.
SPI_SETMOUSE
0x0004
Définit les deux valeurs de seuil de la souris et l’accélération de la souris. Le paramètre pvParam doit pointer vers un tableau de trois entiers qui spécifie ces valeurs. Pour plus d’informations , consultez mouse_event .
SPI_SETMOUSEBUTTONSWAP
0x0021
Échange ou restaure la signification des boutons gauche et droit de la souris. Le paramètre uiParam spécifie TRUE pour échanger les significations des boutons, ou FALSE pour restaurer leur signification d’origine.

Pour récupérer le paramètre actuel, appelez GetSystemMetrics avec l’indicateur SM_SWAPBUTTON .

SPI_SETMOUSEHOVERHEIGHT
0x0065
Définit la hauteur, en pixels, du rectangle dans lequel le pointeur de la souris doit rester pour que TrackMouseEvent génère un message WM_MOUSEHOVER . Définissez le paramètre uiParam sur la nouvelle hauteur.
SPI_SETMOUSEHOVERTIME
0x0067
Définit l’heure, en millisecondes, pendant laquelle le pointeur de la souris doit rester dans le rectangle de pointage pour que TrackMouseEvent génère un message WM_MOUSEHOVER . Il est utilisé uniquement si vous passez HOVER_DEFAULT dans le paramètre dwHoverTime dans l’appel à TrackMouseEvent. Définissez le paramètre uiParam sur la nouvelle heure.

L’heure spécifiée doit être comprise entre USER_TIMER_MAXIMUM et USER_TIMER_MINIMUM. Si uiParam est inférieur à USER_TIMER_MINIMUM, la fonction utilise USER_TIMER_MINIMUM. Si uiParam est supérieur à USER_TIMER_MAXIMUM, la fonction est USER_TIMER_MAXIMUM.

Windows Server 2003 et Windows XP : Le système d’exploitation n’applique pas l’utilisation de USER_TIMER_MAXIMUM et de USER_TIMER_MINIMUM tant que Windows Server 2003 avec SP1 et Windows XP avec SP2.

SPI_SETMOUSEHOVERWIDTH
0x0063
Définit la largeur, en pixels, du rectangle dans lequel le pointeur de la souris doit rester pour que TrackMouseEvent génère un message WM_MOUSEHOVER . Définissez le paramètre uiParam sur la nouvelle largeur.
SPI_SETMOUSESPEED
0x0071
Définit la vitesse actuelle de la souris. Le paramètre pvParam est un entier compris entre 1 (le plus lent) et 20 (le plus rapide). La valeur par défaut est 10. Cette valeur est généralement définie à l’aide de l’application du panneau de configuration de la souris.
SPI_SETMOUSETRAILS
0x005D
Active ou désactive la fonctionnalité Traces de souris, qui améliore la visibilité des mouvements du curseur de souris en affichant brièvement une trace de curseurs et en les effançant rapidement.

Pour désactiver la fonctionnalité, définissez le paramètre uiParam sur zéro ou 1. Pour activer la fonctionnalité, définissez uiParam sur une valeur supérieure à 1 pour indiquer le nombre de curseurs dessinés dans la trace.

Windows 2000 : Ce paramètre n’est pas pris en charge.

SPI_SETMOUSEWHEELROUTING
0x201D
Définit le paramètre de routage pour l’entrée du bouton de roue. Le paramètre de routage détermine si l’entrée du bouton de roue est envoyée à l’application avec le focus (au premier plan) ou à l’application sous le curseur de la souris.

Le paramètre pvParam doit pointer vers une variable DWORD qui reçoit l’option de routage. Si la valeur est égale à zéro ou MOUSEWHEEL_ROUTING_FOCUS, l’entrée de roue de la souris est fournie à l’application avec le focus. Si la valeur est 1 ou MOUSEWHEEL_ROUTING_HYBRID (valeur par défaut), l’entrée de la roulette de la souris est remise à l’application avec le focus (applications de bureau) ou à l’application sous le curseur de la souris (applications du Windows Store). Définissez le paramètre uiParam sur zéro.

SPI_SETPENVISUALIZATION
0x201F
Définit le paramètre actuel de visualisation des mouvements de stylet. Le paramètre pvParam doit pointer vers une variable ULONG qui identifie le paramètre. Pour plus d’informations, consultez Visualisation du stylet.
SPI_SETSNAPTODEFBUTTON
0x0060
Active ou désactive la fonctionnalité snap-to-default-button. Si cette option est activée, le curseur de la souris se déplace automatiquement vers le bouton par défaut, tel que OK ou Appliquer, d’une boîte de dialogue. Définissez le paramètre uiParam sur TRUE pour activer la fonctionnalité ou FALSE pour la désactiver. Les applications doivent utiliser la fonction ShowWindow lors de l’affichage d’une boîte de dialogue afin que le gestionnaire de dialogue puisse positionner le curseur de la souris.
SPI_SETSYSTEMLANGUAGEBAR
0x1051
À compter de Windows 8 : Active ou désactive la fonctionnalité de barre de langue héritée. Le paramètre pvParam est un pointeur vers une variable BOOL . Définissez pvParam sur TRUE pour activer la barre de langue héritée ou SUR FALSE pour la désactiver. L’indicateur est pris en charge sur Windows 8 où la barre de langue héritée est remplacée par le sélecteur d’entrée et est donc désactivée par défaut. L’activation de la barre de langue héritée est fournie pour des raisons de compatibilité et n’a aucun effet sur le sélecteur d’entrée.
SPI_SETTHREADLOCALINPUTSETTINGS
0x104F
À compter de Windows 8 : Détermine si les paramètres d’entrée actifs ont l’étendue Local (par thread, TRUE) ou Global (session, FALSE). Le paramètre pvParam doit être une variable BOOL , convertie par PVOID.
SPI_SETTOUCHPADPARAMETERS
0x00AF
À compter de Windows 11, version 24H2 : Définit des détails sur le pavé tactile Precision, y compris les paramètres utilisateur et les informations système relatives au pavé tactile.

Le paramètre pvParam doit pointer vers une structure TOUCHPAD_PARAMETERS .

Le paramètre uiParam doit spécifier la taille de la structure.

La valeur du champ versionNumber dans la structure TOUCHPAD_PARAMETERS doit être définie sur la valeur appropriée pour la version de la structure utilisée.

SPI_SETWHEELSCROLLCHARS
0x006D
Définit le nombre de caractères à faire défiler lorsque la roulette horizontale de la souris est déplacée. Le nombre de caractères est défini à partir du paramètre uiParam .
SPI_SETWHEELSCROLLLINES
0x0069
Définit le nombre de lignes à faire défiler lorsque la roulette verticale de la souris est déplacée. Le nombre de lignes est défini à partir du paramètre uiParam .

Le nombre de lignes est le nombre suggéré de lignes à faire défiler lorsque la roulette de la souris est enroulée sans utiliser de touches de modification. Si le nombre est 0, aucun défilement ne doit se produire. Si le nombre de lignes à faire défiler est supérieur au nombre de lignes visibles, et en particulier s’il s’agit d’WHEEL_PAGESCROLL (#defined comme UINT_MAX), l’opération de défilement doit être interprétée comme un clic dans les régions de la page vers le bas ou vers le haut de la barre de défilement.

 

Voici les paramètres de menu.

Paramètre de menu Signification
SPI_GETMENUDROPALIGNMENT
0x001B
Détermine si les menus contextuels sont alignés à gauche ou à droite, par rapport à l’élément de barre de menus correspondant. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si elle est alignée à droite, ou FALSE dans le cas contraire.
SPI_GETMENUFADE
0x1012
Détermine si l’animation de fondu de menu est activée. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE lorsque l’animation en fondu est activée et FALSE lorsqu’elle est désactivée. Si l’animation en fondu est désactivée, les menus utilisent l’animation de diapositive. Cet indicateur est ignoré, sauf si l’animation de menu est activée, ce que vous pouvez faire à l’aide de l’indicateur SPI_SETMENUANIMATION . Pour plus d’informations, consultez AnimateWindow.
SPI_GETMENUSHOWDELAY
0x006A
Récupère le temps, en millisecondes, que le système attend avant d’afficher un menu contextuel lorsque le curseur de la souris se trouve sur un élément de sous-menu. Le paramètre pvParam doit pointer vers une variable DWORD qui reçoit l’heure du délai.
SPI_SETMENUDROPALIGNMENT
0x001C
Définit la valeur d’alignement des menus contextuels. Le paramètre uiParam spécifie TRUE pour l’alignement à droite, ou FALSE pour l’alignement gauche.
SPI_SETMENUFADE
0x1013
Active ou désactive l’animation de fondu de menu. Définissez pvParam sur TRUE pour activer l’effet de fondu de menu ou FALSE pour le désactiver. Si l’animation en fondu est désactivée, les menus utilisent l’animation de diapositive. l’effet de fondu de menu n’est possible que si le système a une profondeur de couleur de plus de 256 couleurs. Cet indicateur est ignoré, sauf si SPI_MENUANIMATION est également défini. Pour plus d’informations, consultez AnimateWindow.
SPI_SETMENUSHOWDELAY
0x006B
Définit uiParam sur la durée, en millisecondes, pendant laquelle le système attend avant d’afficher un menu contextuel lorsque le curseur de la souris se trouve sur un élément de sous-menu.
 

Voici les paramètres d’alimentation.

À compter de Windows Server 2008 et Windows Vista, ces paramètres d’alimentation ne sont pas pris en charge. Au lieu de cela, pour déterminer l’état d’alimentation d’affichage actuel, une application doit s’inscrire aux notifications GUID_MONITOR_POWER_STATE . Pour déterminer le délai d’arrêt de l’affichage actuel, une application doit s’inscrire pour la notification des modifications apportées au paramètre d’alimentation GUID_VIDEO_POWERDOWN_TIMEOUT . Pour plus d’informations, consultez Inscription aux événements Power.

Windows Server 2003 et Windows XP/2000 : Pour déterminer l’état d’alimentation d’affichage actuel, utilisez les paramètres d’alimentation suivants.

Paramètre Power Signification
SPI_GETLOWPOWERACTIVE
0x0053
Ce paramètre n’est pas pris en charge.

Windows Server 2003 et Windows XP/2000 : Détermine si la phase d’économie d’écran à faible consommation d’énergie est activée. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si elle est activée, ou FALSE si elle est désactivée. Cet indicateur est pris en charge uniquement pour les applications 32 bits.

SPI_GETLOWPOWERTIMEOUT
0x004F
Ce paramètre n’est pas pris en charge.

Windows Server 2003 et Windows XP/2000 : Récupère la valeur de délai d’attente pour la phase de faible consommation d’écran. Le paramètre pvParam doit pointer vers une variable entière qui reçoit la valeur . Cet indicateur est pris en charge uniquement pour les applications 32 bits.

SPI_GETPOWEROFFACTIVE
0x0054
Ce paramètre n’est pas pris en charge. Lorsque la phase de mise hors tension de l’enregistrement d’écran est activée, le paramètre d’alimentation GUID_VIDEO_POWERDOWN_TIMEOUT est supérieur à zéro.

Windows Server 2003 et Windows XP/2000 : Détermine si la phase de mise sous tension de l’enregistrement d’écran est activée. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si elle est activée, ou FALSE si elle est désactivée. Cet indicateur est pris en charge uniquement pour les applications 32 bits.

SPI_GETPOWEROFFTIMEOUT
0x0050
Ce paramètre n’est pas pris en charge. Au lieu de cela, vérifiez le paramètre d’alimentation GUID_VIDEO_POWERDOWN_TIMEOUT .

Windows Server 2003 et Windows XP/2000 : Récupère la valeur de délai d’attente pour la phase de mise hors tension de l’enregistrement d’écran. Le paramètre pvParam doit pointer vers une variable entière qui reçoit la valeur . Cet indicateur est pris en charge uniquement pour les applications 32 bits.

SPI_SETLOWPOWERACTIVE
0x0055
Ce paramètre n’est pas pris en charge.

Windows Server 2003 et Windows XP/2000 : Active ou désactive la phase de faible consommation d’écran. Définissez uiParam sur 1 pour activer ou zéro pour désactiver. Le paramètre pvParam doit être NULL. Cet indicateur est pris en charge uniquement pour les applications 32 bits.

SPI_SETLOWPOWERTIMEOUT
0x0051
Ce paramètre n’est pas pris en charge.

Windows Server 2003 et Windows XP/2000 : Définit la valeur du délai d’attente, en secondes, pour la phase de faible consommation d’écran. Le paramètre uiParam spécifie la nouvelle valeur. Le paramètre pvParam doit être NULL. Cet indicateur est pris en charge uniquement pour les applications 32 bits.

SPI_SETPOWEROFFACTIVE
0x0056
Ce paramètre n’est pas pris en charge. Définissez plutôt le paramètre d’alimentation GUID_VIDEO_POWERDOWN_TIMEOUT .

Windows Server 2003 et Windows XP/2000 : Active ou désactive la phase de mise hors tension de l’enregistrement d’écran. Définissez uiParam sur 1 pour activer ou zéro pour désactiver. Le paramètre pvParam doit être NULL. Cet indicateur est pris en charge uniquement pour les applications 32 bits.

SPI_SETPOWEROFFTIMEOUT
0x0052
Ce paramètre n’est pas pris en charge. Au lieu de cela, définissez le paramètre d’alimentation GUID_VIDEO_POWERDOWN_TIMEOUT sur une valeur de délai d’attente.

Windows Server 2003 et Windows XP/2000 : Définit la valeur du délai d’attente, en secondes, pour la phase de mise hors tension de l’enregistrement d’écran. Le paramètre uiParam spécifie la nouvelle valeur. Le paramètre pvParam doit être NULL. Cet indicateur est pris en charge uniquement pour les applications 32 bits.

 

Voici les paramètres de l’économiseur d’écran.

Paramètre d’économiseur d’écran Signification
SPI_GETSCREENSAVEACTIVE
0x0010
Détermine si l’enregistrement d’écran est activé. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si l’enregistrement d’écran est activé, ou FALSE dans le cas contraire.

Windows 7, Windows Server 2008 R2 et Windows 2000 : La fonction retourne TRUE même lorsque l’enregistrement d’écran n’est pas activé.

SPI_GETSCREENSAVERRUNNING
0x0072
Détermine si un économiseur d’écran est en cours d’exécution sur la station fenêtre du processus appelant. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si un économiseur d’écran est en cours d’exécution, ou FALSE dans le cas contraire. Notez que seul la station de fenêtre interactive, WinSta0, peut avoir un économiseur d’écran en cours d’exécution.
SPI_GETSCREENSAVESECURE
0x0076
Détermine si l’économiseur d’écran nécessite un mot de passe pour afficher le bureau Windows. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si l’économiseur d’écran nécessite un mot de passe, ou FALSE dans le cas contraire. Le paramètre uiParam est ignoré.

Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_GETSCREENSAVETIMEOUT
0x000E
Récupère la valeur du délai d’attente de l’économiseur d’écran, en secondes. Le paramètre pvParam doit pointer vers une variable entière qui reçoit la valeur .
SPI_SETSCREENSAVEACTIVE
0x0011
Définit l’état de l’économiseur d’écran. Le paramètre uiParam spécifie TRUE pour activer l’enregistrement d’écran, ou FALSE pour le désactiver.

Si l’ordinateur est entré en mode d’économie d’énergie ou en état de verrouillage du système, une exception ERROR_OPERATION_IN_PROGRESS se produit.

SPI_SETSCREENSAVESECURE
0x0077
Définit si l’économiseur d’écran exige que l’utilisateur entre un mot de passe pour afficher le bureau Windows. Le paramètre uiParam est une variable BOOL . Le paramètre pvParam est ignoré. Définissez uiParam sur TRUE pour exiger un mot de passe, ou FALSE pour ne pas exiger de mot de passe.

Si l’ordinateur est entré en mode d’économie d’énergie ou en état de verrouillage du système, une exception ERROR_OPERATION_IN_PROGRESS se produit.

Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_SETSCREENSAVETIMEOUT
0x000F
Définit la valeur du délai d’expiration de l’économiseur d’écran sur la valeur du paramètre uiParam . Cette valeur correspond à la durée, en secondes, pendant laquelle le système doit être inactif avant que l’économiseur d’écran ne s’active.

Si l’ordinateur est entré en mode d’économie d’énergie ou en état de verrouillage du système, une exception ERROR_OPERATION_IN_PROGRESS se produit.

 

Voici les paramètres de délai d’attente pour les applications et les services.

Paramètre de délai d’attente Signification
SPI_GETHUNGAPPTIMEOUT
0x0078
Récupère le nombre de millisecondes qu’un thread peut parcourir sans distribuer de message avant que le système ne le considère comme ne répondant pas. Le paramètre pvParam doit pointer vers une variable entière qui reçoit la valeur .

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_GETWAITTOKILLTIMEOUT
0x007A
Récupère le nombre de millisecondes que le système attend avant de mettre fin à une application qui ne répond pas à une demande d’arrêt. Le paramètre pvParam doit pointer vers une variable entière qui reçoit la valeur .

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_GETWAITTOKILLSERVICETIMEOUT
0x007C
Récupère le nombre de millisecondes que le gestionnaire de contrôle de service attend avant de mettre fin à un service qui ne répond pas à une demande d’arrêt. Le paramètre pvParam doit pointer vers une variable entière qui reçoit la valeur .

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_SETHUNGAPPTIMEOUT
0x0079
Définit le délai d’attente de l’application bloquée sur la valeur du paramètre uiParam . Cette valeur est le nombre de millisecondes qu’un thread peut passer sans distribuer de message avant que le système le considère comme ne répondant pas.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_SETWAITTOKILLTIMEOUT
0x007B
Définit le délai d’expiration de la demande d’arrêt de l’application sur la valeur du paramètre uiParam . Cette valeur est le nombre de millisecondes que le système attend avant de mettre fin à une application qui ne répond pas à une demande d’arrêt.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_SETWAITTOKILLSERVICETIMEOUT
0x007D
Définit le délai d’expiration de la demande d’arrêt de service sur la valeur du paramètre uiParam . Cette valeur est le nombre de millisecondes que le système attend avant de mettre fin à un service qui ne répond pas à une demande d’arrêt.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

 

Voici les effets de l’interface utilisateur. La valeur SPI_SETUIEFFECTS est utilisée pour activer ou désactiver tous les effets de l’interface utilisateur à la fois. Ce tableau contient la liste complète des valeurs d’effet d’interface utilisateur.

Paramètre d’effets d’interface utilisateur Signification
SPI_GETCOMBOBOXANIMATION
0x1004
Détermine si l’effet d’ouverture des diapositives pour les zones de liste déroulante est activé. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE pour enabled ou FALSE pour désactivé.
SPI_GETCURSORSHADOW
0x101A
Détermine si le curseur a une ombre autour d’elle. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si l’ombre est activée et FALSE si elle est désactivée. Cet effet n’apparaît que si le système a une profondeur de couleurs de plus de 256 couleurs.
SPI_GETGRADIENTCAPTIONS
0x1008
Détermine si l’effet de dégradé pour les barres de titre de fenêtre est activé. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE pour enabled ou FALSE pour désactivé. Pour plus d’informations sur l’effet de dégradé, consultez la fonction GetSysColor .
SPI_GETHOTTRACKING
0x100E
Détermine si le suivi à chaud des éléments d’interface utilisateur, tels que les noms de menus dans les barres de menus, est activé. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE pour enabled ou FALSE pour désactivé.

Suivi à chaud signifie que lorsque le curseur se déplace sur un élément, il est mis en surbrillance, mais pas sélectionné. Vous pouvez interroger cette valeur pour décider s’il faut utiliser le suivi à chaud dans l’interface utilisateur de votre application.

SPI_GETLISTBOXSMOOTHSCROLLING
0x1006
Détermine si l’effet de défilement lisse pour les zones de liste est activé. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE pour enabled ou FALSE pour désactivé.
SPI_GETMENUANIMATION
0x1002
Détermine si la fonctionnalité d’animation de menu est activée. Ce commutateur maître doit être activé pour activer les effets d’animation de menu. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si l’animation est activée et FALSE si elle est désactivée.

Si l’animation est activée, SPI_GETMENUFADE indique si les menus utilisent l’animation fondue ou l’animation de diapositive.

SPI_GETMENUUNDERLINES
0x100A
Identique à SPI_GETKEYBOARDCUES.
SPI_GETSELECTIONFADE
0x1014
Détermine si l’effet de fondu de sélection est activé. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si activé ou FALSE si désactivé.

L’effet de fondu de sélection fait que l’élément de menu sélectionné par l’utilisateur reste brièvement à l’écran tout en s’effaçant une fois le menu ignoré.

SPI_GETTOOLTIPANIMATION
0x1016
Détermine si l’animation info-bulle est activée. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si activé ou FALSE si désactivé. Si l’animation info-bulle est activée, SPI_GETTOOLTIPFADE indique si les info-bulles utilisent l’animation fondue ou de diapositive.
SPI_GETTOOLTIPFADE
0x1018
Si SPI_SETTOOLTIPANIMATION est activé, SPI_GETTOOLTIPFADE indique si l’animation info-bulle utilise un effet de fondu ou un effet de diapositive. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE pour l’animation de fondu ou FALSE pour l’animation de diapositive. Pour plus d’informations sur les effets de diapositive et de fondu, consultez AnimateWindow.
SPI_GETUIEFFECTS
0x103E
Détermine si les effets de l’interface utilisateur sont activés ou désactivés. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si tous les effets de l’interface utilisateur sont activés, ou FALSE s’ils sont désactivés.
SPI_SETCOMBOBOXANIMATION
0x1005
Active ou désactive l’effet d’ouverture des diapositives pour les zones de liste déroulante. Définissez le paramètre pvParam sur TRUE pour activer l’effet de dégradé ou FALSE pour le désactiver.
SPI_SETCURSORSHADOW
0x101B
Active ou désactive une ombre autour du curseur. Le paramètre pvParam est une variable BOOL . Définissez pvParam sur TRUE pour permettre à l’ombre ou FALSE de désactiver l’ombre. Cet effet n’apparaît que si le système a une profondeur de couleurs de plus de 256 couleurs.
SPI_SETGRADIENTCAPTIONS
0x1009
Active ou désactive l’effet de dégradé pour les barres de titre de fenêtre. Définissez le paramètre pvParam sur TRUE pour l’activer ou FALSE pour le désactiver. L’effet de dégradé n’est possible que si le système a une profondeur de couleurs de plus de 256 couleurs. Pour plus d’informations sur l’effet de dégradé, consultez la fonction GetSysColor .
SPI_SETHOTTRACKING
0x100F
Active ou désactive le suivi à chaud des éléments de l’interface utilisateur, tels que les noms de menus dans les barres de menus. Définissez le paramètre pvParam sur TRUE pour l’activer ou FALSE pour le désactiver.

Le suivi à chaud signifie que lorsque le curseur se déplace sur un élément, il est mis en surbrillance, mais pas sélectionné.

SPI_SETLISTBOXSMOOTHSCROLLING
0x1007
Active ou désactive l’effet de défilement lisse pour les zones de liste. Définissez le paramètre pvParam sur TRUE pour activer l’effet de défilement en douceur, ou FALSE pour le désactiver.
SPI_SETMENUANIMATION
0x1003
Active ou désactive l’animation de menu. Ce commutateur maître doit être activé pour que n’importe quelle animation de menu se produise. Le paramètre pvParam est une variable BOOL ; définissez pvParam sur TRUE pour activer l’animation et FALSE pour désactiver l’animation.

Si l’animation est activée, SPI_GETMENUFADE indique si les menus utilisent l’animation fondue ou l’animation de diapositive.

SPI_SETMENUUNDERLINES
0x100B
Identique à SPI_SETKEYBOARDCUES.
SPI_SETSELECTIONFADE
0x1015
Définissez pvParam sur TRUE pour activer l’effet de fondu de sélection ou FALSE pour le désactiver.

L’effet de fondu de sélection fait que l’élément de menu sélectionné par l’utilisateur reste brièvement à l’écran tout en s’effaçant une fois le menu ignoré. L’effet de fondu de sélection n’est possible que si le système a une profondeur de couleur de plus de 256 couleurs.

SPI_SETTOOLTIPANIMATION
0x1017
Définissez pvParam sur TRUE pour activer l’animation info-bulle ou FALSE pour la désactiver. Si cette option est activée, vous pouvez utiliser SPI_SETTOOLTIPFADE pour spécifier l’animation fondue ou de diapositive.
SPI_SETTOOLTIPFADE
0x1019
Si l’indicateur SPI_SETTOOLTIPANIMATION est activé, utilisez SPI_SETTOOLTIPFADE pour indiquer si l’animation info-bulle utilise un effet de fondu ou un effet de diapositive. Définissez pvParam sur TRUE pour l’animation de fondu ou FALSE pour l’animation de diapositive. L’effet de fondu d’info-bulle n’est possible que si le système a une profondeur de couleur de plus de 256 couleurs. Pour plus d’informations sur les effets de diapositive et de fondu, consultez la fonction AnimateWindow .
SPI_SETUIEFFECTS
0x103F
Active ou désactive les effets de l’interface utilisateur. Définissez le paramètre pvParam sur TRUE pour activer tous les effets d’interface utilisateur ou FALSE pour désactiver tous les effets de l’interface utilisateur.
 

Voici les paramètres de fenêtre.

Paramètre de fenêtre Signification
SPI_GETACTIVEWINDOWTRACKING
0x1000
Détermine si le suivi de fenêtre actif (activation de la fenêtre sur laquelle la souris est activée) est activé ou désactivé. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE pour on ou FALSE pour off.
SPI_GETACTIVEWNDTRKZORDER
0x100C
Détermine si les fenêtres activées via le suivi de fenêtre actif seront mises en haut. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE pour on ou FALSE pour off.
SPI_GETACTIVEWNDTRKTIMEOUT
0x2002
Récupère le délai de suivi de la fenêtre active, en millisecondes. Le paramètre pvParam doit pointer vers une variable DWORD qui reçoit l’heure.
SPI_GETANIMATION
0x0048
Récupère les effets d’animation associés aux actions de l’utilisateur. Le paramètre pvParam doit pointer vers une structure ANIMATIONINFO qui reçoit les informations. Définissez le membre cbSize de cette structure et le paramètre uiParam sur sizeof(ANIMATIONINFO).
SPI_GETBORDER
0x0005
Récupère le facteur multiplicateur de bordure qui détermine la largeur de la bordure de dimensionnement d’une fenêtre. Le paramètre pvParam doit pointer vers une variable entière qui reçoit cette valeur.
SPI_GETCARETWIDTH
0x2006
Récupère la largeur de l’insertion dans les contrôles d’édition, en pixels. Le paramètre pvParam doit pointer vers une variable DWORD qui reçoit cette valeur.
SPI_GETDOCKMOVING
0x0090
Détermine si une fenêtre est ancrée lorsqu’elle est déplacée vers les bords supérieur, gauche ou droit d’un moniteur ou d’un tableau de moniteurs. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si elle est activée, ou FALSE dans le cas contraire.

Utilisez SPI_GETWINARRANGING pour déterminer si ce comportement est activé.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_GETDRAGFROMMAXIMIZE
0x008C
Détermine si une fenêtre agrandie est restaurée lorsque sa barre de légende est déplacée. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si elle est activée, ou FALSE dans le cas contraire.

Utilisez SPI_GETWINARRANGING pour déterminer si ce comportement est activé.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_GETDRAGFULLWINDOWS
0x0026
Détermine si le glissement des fenêtres complètes est activé. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si elle est activée, ou FALSE dans le cas contraire.
SPI_GETFOREGROUNDFLASHCOUNT
0x2004
Récupère le nombre de fois où SetForegroundWindow clignote le bouton de la barre des tâches lors du rejet d’une demande de commutateur au premier plan. Le paramètre pvParam doit pointer vers une variable DWORD qui reçoit la valeur .
SPI_GETFOREGROUNDLOCKTIMEOUT
0x2000
Récupère la durée après l’entrée de l’utilisateur, en millisecondes, pendant laquelle le système n’autorise pas les applications à se forcer au premier plan. Le paramètre pvParam doit pointer vers une variable DWORD qui reçoit l’heure.
SPI_GETMINIMIZEDMETRICS
0x002B
Récupère les métriques associées aux fenêtres réduites. Le paramètre pvParam doit pointer vers une structure MINIMIZEDMETRICS qui reçoit les informations. Définissez le membre cbSize de cette structure et le paramètre uiParam sur sizeof(MINIMIZEDMETRICS).
SPI_GETMOUSEDOCKTHRESHOLD
0x007E
Récupère le seuil en pixels où le comportement d’ancrage est déclenché à l’aide d’une souris pour faire glisser une fenêtre vers le bord d’un moniteur ou d’un tableau de moniteurs. Le seuil par défaut est 1. Le paramètre pvParam doit pointer vers une variable DWORD qui reçoit la valeur .

Utilisez SPI_GETWINARRANGING pour déterminer si ce comportement est activé.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_GETMOUSEDRAGOUTTHRESHOLD
0x0084
Récupère le seuil en pixels où le comportement de désinscricage est déclenché à l’aide d’une souris pour faire glisser une fenêtre du bord d’un moniteur ou d’un tableau de moniteurs vers le centre. Le seuil par défaut est 20.

Utilisez SPI_GETWINARRANGING pour déterminer si ce comportement est activé.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_GETMOUSESIDEMOVETHRESHOLD
0x0088
Récupère le seuil en pixels à partir du haut d’un moniteur ou d’un tableau de moniteurs où une fenêtre agrandie verticalement est restaurée lors d’un déplacement avec la souris. Le seuil par défaut est 50.

Utilisez SPI_GETWINARRANGING pour déterminer si ce comportement est activé.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_GETNONCLIENTMETRICS
0x0029
Récupère les mesures associées à la zone non cliente des fenêtres non réduites. Le paramètre pvParam doit pointer vers une structure NONCLIENTMETRICS qui reçoit les informations. Définissez le membre cbSize de cette structure et le paramètre uiParam sur sizeof(NONCLIENTMETRICS).

Windows Server 2003 et Windows XP/2000 : Consultez les remarques relatives à NONCLIENTMETRICS.

SPI_GETPENDOCKTHRESHOLD
0x0080
Récupère le seuil en pixels où le comportement d’ancrage est déclenché à l’aide d’un stylet pour faire glisser une fenêtre vers le bord d’un moniteur ou d’un tableau de moniteurs. La valeur par défaut est 30.

Utilisez SPI_GETWINARRANGING pour déterminer si ce comportement est activé.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_GETPENDRAGOUTTHRESHOLD
0x0086
Récupère le seuil en pixels où le comportement de désinscricage est déclenché à l’aide d’un stylet pour faire glisser une fenêtre du bord d’un moniteur ou d’un tableau de moniteurs vers son centre. Le seuil par défaut est 30.

Utilisez SPI_GETWINARRANGING pour déterminer si ce comportement est activé.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_GETPENSIDEMOVETHRESHOLD
0x008A
Récupère le seuil en pixels du haut d’un tableau de moniteur ou de moniteur où une fenêtre agrandie verticalement est restaurée en cas de déplacement avec la souris. Le seuil par défaut est 50.

Utilisez SPI_GETWINARRANGING pour déterminer si ce comportement est activé.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_GETSHOWIMEUI
0x006E
Détermine si la fenêtre d’état IME est visible (par utilisateur). Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE si la fenêtre d’état est visible, ou FALSE si ce n’est pas le cas.
SPI_GETSNAPSIZING
0x008E
Détermine si une fenêtre est agrandie verticalement lorsqu’elle est dimensionnée en haut ou en bas d’un tableau de moniteur ou de moniteur. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE s’il est activé, ou FALSE dans le cas contraire.

Utilisez SPI_GETWINARRANGING pour déterminer si ce comportement est activé.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_GETWINARRANGING
0x0082
Détermine si l’arrangement de fenêtre est activé. Le paramètre pvParam doit pointer vers une variable BOOL qui reçoit TRUE s’il est activé, ou FALSE dans le cas contraire.

La disposition des fenêtres réduit le nombre d’interactions de souris, de stylet ou tactiles nécessaires pour déplacer et dimensionner les fenêtres de niveau supérieur en simplifiant le comportement par défaut d’une fenêtre lorsqu’elle est déplacée ou dimensionnée.

Les paramètres suivants récupèrent les paramètres d’arrangement de fenêtre individuels :

SPI_GETDOCKMOVING
SPI_GETMOUSEDOCKTHRESHOLD
SPI_GETMOUSEDRAGOUTTHRESHOLD
SPI_GETMOUSESIDEMOVETHRESHOLD
SPI_GETPENDOCKTHRESHOLD
SPI_GETPENDRAGOUTTHRESHOLD
SPI_GETPENSIDEMOVETHRESHOLD
SPI_GETSNAPSIZING
Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.
SPI_SETACTIVEWINDOWTRACKING
0x1001
Définit le suivi des fenêtres actif (activation de la fenêtre sur laquelle la souris est activée) activé ou désactivé. Définissez pvParam sur TRUE pour on ou FALSE pour désactivé.
SPI_SETACTIVEWNDTRKZORDER
0x100D
Détermine si les fenêtres activées par le biais du suivi de fenêtre actif doivent être mises en haut. Définissez pvParam sur TRUE pour on ou FALSE pour désactivé.
SPI_SETACTIVEWNDTRKTIMEOUT
0x2003
Définit le délai de suivi des fenêtres actif. Définissez pvParam sur le nombre de millisecondes à retarder avant d’activer la fenêtre sous le pointeur de la souris.
SPI_SETANIMATION
0x0049
Définit les effets d’animation associés aux actions utilisateur. Le paramètre pvParam doit pointer vers une structure ANIMATIONINFO qui contient les nouveaux paramètres. Définissez le membre cbSize de cette structure et le paramètre uiParam sur sizeof(ANIMATIONINFO).
SPI_SETBORDER
0x0006
Définit le facteur multiplicateur de bordure qui détermine la largeur de la bordure de dimensionnement d’une fenêtre. Le paramètre uiParam spécifie la nouvelle valeur.
SPI_SETCARETWIDTH
0x2007
Définit la largeur du caret dans les contrôles d’édition. Définissez pvParam sur la largeur souhaitée, en pixels. La valeur par défaut et la valeur minimale sont 1.
SPI_SETDOCKMOVING
0x0091
Définit si une fenêtre est ancrée lorsqu’elle est déplacée vers les cibles d’ancrage supérieure, gauche ou droite sur un tableau de moniteur ou de moniteur. Définissez pvParam sur TRUE pour on ou FALSE pour désactivé.

SPI_GETWINARRANGING doit avoir la valeur TRUE pour activer ce comportement.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_SETDRAGFROMMAXIMIZE
0x008D
Définit si une fenêtre agrandie est restaurée lorsque sa barre de sous-titres est déplacée. Définissez pvParam sur TRUE pour on ou FALSE pour désactivé.

SPI_GETWINARRANGING doit avoir la valeur TRUE pour activer ce comportement.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_SETDRAGFULLWINDOWS
0x0025
Définit le glissement des fenêtres complètes activé ou désactivé. Le paramètre uiParam spécifie TRUE pour on ou FALSE pour off.
SPI_SETDRAGHEIGHT
0x004D
Définit la hauteur, en pixels, du rectangle utilisé pour détecter le début d’une opération de glissement. Définissez uiParam sur la nouvelle valeur. Pour récupérer la hauteur de glissement, appelez GetSystemMetrics avec l’indicateur SM_CYDRAG .
SPI_SETDRAGWIDTH
0x004C
Définit la largeur, en pixels, du rectangle utilisé pour détecter le début d’une opération de glissement. Définissez uiParam sur la nouvelle valeur. Pour récupérer la largeur de glissement, appelez GetSystemMetrics avec l’indicateur SM_CXDRAG .
SPI_SETFOREGROUNDFLASHCOUNT
0x2005
Définit le nombre de fois où SetForegroundWindow clignote le bouton de la barre des tâches lors du rejet d’une demande de commutateur de premier plan. Définissez pvParam sur le nombre de fois à flasher.
SPI_SETFOREGROUNDLOCKTIMEOUT
0x2001
Définit la durée après l’entrée utilisateur, en millisecondes, pendant laquelle le système ne permet pas aux applications de se forcer au premier plan. Définissez pvParam sur la nouvelle valeur de délai d’attente.

Le thread appelant doit être en mesure de modifier la fenêtre de premier plan, sinon l’appel échoue.

SPI_SETMINIMIZEDMETRICS
0x002C
Définit les métriques associées aux fenêtres réduites. Le paramètre pvParam doit pointer vers une structure MINIMIZEDMETRICS qui contient les nouveaux paramètres. Définissez le membre cbSize de cette structure et le paramètre uiParam sur sizeof(MINIMIZEDMETRICS).
SPI_SETMOUSEDOCKTHRESHOLD
0x007F
Définit le seuil en pixels où le comportement d’ancrage est déclenché à l’aide d’une souris pour faire glisser une fenêtre vers le bord d’un moniteur ou d’un tableau d’analyse. Le seuil par défaut est 1. Le paramètre pvParam doit pointer vers une variable DWORD qui contient la nouvelle valeur.

SPI_GETWINARRANGING doit avoir la valeur TRUE pour activer ce comportement.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_SETMOUSEDRAGOUTTHRESHOLD
0x0085
Définit le seuil en pixels où le comportement de désendocrage est déclenché à l’aide d’une souris pour faire glisser une fenêtre du bord d’un moniteur ou d’un tableau de surveillance vers son centre. Le seuil par défaut est 20. Le paramètre pvParam doit pointer vers une variable DWORD qui contient la nouvelle valeur.

SPI_GETWINARRANGING doit avoir la valeur TRUE pour activer ce comportement.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_SETMOUSESIDEMOVETHRESHOLD
0x0089
Définit le seuil en pixels à partir du haut du moniteur, où une fenêtre agrandie verticalement est restaurée en cas de déplacement avec la souris. Le seuil par défaut est 50. Le paramètre pvParam doit pointer vers une variable DWORD qui contient la nouvelle valeur.

SPI_GETWINARRANGING doit avoir la valeur TRUE pour activer ce comportement.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_SETNONCLIENTMETRICS
0x002A
Définit les métriques associées à la zone non client des fenêtres nonminimisées. Le paramètre pvParam doit pointer vers une structure NONCLIENTMETRICS qui contient les nouveaux paramètres. Définissez le membre cbSize de cette structure et le paramètre uiParam sur sizeof(NONCLIENTMETRICS). En outre, le membre lfHeight de la structure LOGFONT doit être une valeur négative.
SPI_SETPENDOCKTHRESHOLD
0x0081
Définit le seuil en pixels où le comportement d’ancrage est déclenché à l’aide d’un stylet pour faire glisser une fenêtre vers le bord d’un moniteur ou d’un tableau d’analyse. Le seuil par défaut est 30. Le paramètre pvParam doit pointer vers une variable DWORD qui contient la nouvelle valeur.

SPI_GETWINARRANGING doit avoir la valeur TRUE pour activer ce comportement.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_SETPENDRAGOUTTHRESHOLD
0x0087
Définit le seuil en pixels où le comportement de désendocrage est déclenché à l’aide d’un stylet pour faire glisser une fenêtre du bord d’un moniteur ou d’un tableau de surveillance vers son centre. Le seuil par défaut est 30. Le paramètre pvParam doit pointer vers une variable DWORD qui contient la nouvelle valeur.

SPI_GETWINARRANGING doit avoir la valeur TRUE pour activer ce comportement.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_SETPENSIDEMOVETHRESHOLD
0x008B
Définit le seuil en pixels à partir du haut du moniteur où une fenêtre agrandie verticalement est restaurée en cas de déplacement avec un stylet. Le seuil par défaut est 50. Le paramètre pvParam doit pointer vers une variable DWORD qui contient la nouvelle valeur.

SPI_GETWINARRANGING doit avoir la valeur TRUE pour activer ce comportement.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_SETSHOWIMEUI
0x006F
Définit si la fenêtre d’état IME est visible ou non par utilisateur. Le paramètre uiParam spécifie TRUE pour on ou FALSE pour off.
SPI_SETSNAPSIZING
0x008F
Définit si une fenêtre est agrandie verticalement lorsqu’elle est dimensionnée en haut ou en bas du moniteur. Définissez pvParam sur TRUE pour on ou FALSE pour désactivé.

SPI_GETWINARRANGING doit avoir la valeur TRUE pour activer ce comportement.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

SPI_SETWINARRANGING
0x0083
Définit si l’organisation de fenêtre est activée. Définissez pvParam sur TRUE pour on ou FALSE pour désactivé.

La disposition des fenêtres réduit le nombre d’interactions de souris, de stylet ou tactiles nécessaires pour déplacer et dimensionner les fenêtres de niveau supérieur en simplifiant le comportement par défaut d’une fenêtre lorsqu’elle est déplacée ou dimensionnée.

Les paramètres suivants définissent des paramètres de disposition de fenêtre individuels :

SPI_SETDOCKMOVING
SPI_SETMOUSEDOCKTHRESHOLD
SPI_SETMOUSEDRAGOUTTHRESHOLD
SPI_SETMOUSESIDEMOVETHRESHOLD
SPI_SETPENDOCKTHRESHOLD
SPI_SETPENDRAGOUTTHRESHOLD
SPI_SETPENSIDEMOVETHRESHOLD
SPI_SETSNAPSIZING
Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP/2000 : Ce paramètre n’est pas pris en charge.

[in] uiParam

Type : UINT

Paramètre dont l’utilisation et le format dépendent du paramètre système interrogé ou défini. Pour plus d’informations sur les paramètres à l’échelle du système, consultez le paramètre uiAction . S’il n’est pas indiqué autrement, vous devez spécifier zéro pour ce paramètre.

[in, out] pvParam

Type : PVOID

Paramètre dont l’utilisation et le format dépendent du paramètre système interrogé ou défini. Pour plus d’informations sur les paramètres à l’échelle du système, consultez le paramètre uiAction . S’il n’est pas indiqué autrement, vous devez spécifier NULL pour ce paramètre. Pour plus d’informations sur le type de données PVOID , consultez Types de données Windows.

[in] fWinIni

Type : UINT

Si un paramètre système est défini, spécifie si le profil utilisateur doit être mis à jour et, si c’est le cas, si le message WM_SETTINGCHANGE doit être diffusé sur toutes les fenêtres de niveau supérieur pour les informer de la modification.

Ce paramètre peut être égal à zéro si vous ne souhaitez pas mettre à jour le profil utilisateur ou diffuser le message WM_SETTINGCHANGE , ou il peut s’agir d’une ou plusieurs des valeurs suivantes.

Valeur Signification
SPIF_UPDATEINIFILE
Écrit le nouveau paramètre à l’échelle du système dans le profil utilisateur.
SPIF_SENDCHANGE
Diffuse le message WM_SETTINGCHANGE après la mise à jour du profil utilisateur.
SPIF_SENDWININICHANGE
Identique à SPIF_SENDCHANGE.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est une valeur différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Cette fonction est destinée à être utilisée avec des applications qui permettent à l’utilisateur de personnaliser l’environnement.

Un nom de disposition de clavier doit être dérivé de la valeur hexadécimale de l’identificateur de langue correspondant à la disposition. Par exemple, l’anglais américain a un identificateur de langue de 0x0409, de sorte que la disposition principale de l’anglais américain est nommée « 00000409 ». Les variantes de la disposition anglaise américaine, telles que la disposition Dvorak, sont nommées « 00010409 », « 00020409 », etc. Pour obtenir la liste des identificateurs de langue principale et des identificateurs de sous-langage qui composent un identificateur de langue, consultez la macro MAKELANGID .

Il existe une différence entre le jeu de couleurs à contraste élevé et le mode contraste élevé. Le jeu de couleurs à contraste élevé modifie les couleurs système en couleurs qui ont un contraste évident ; vous basculez vers ce modèle de couleurs à l’aide des options d’affichage dans le panneau de configuration. Le mode contraste élevé, qui utilise SPI_GETHIGHCONTRAST et SPI_SETHIGHCONTRAST, conseille aux applications de modifier leur apparence pour les utilisateurs malvoyants. Cela implique des éléments tels que des avertissements sonores pour les utilisateurs et un jeu de couleurs personnalisé (à l’aide des options d’accessibilité dans le panneau de configuration). Pour plus d’informations, consultez HIGHCONTRAST. Pour plus d’informations sur les fonctionnalités d’accessibilité générales, consultez Accessibilité.

Pendant la durée pendant laquelle le bouton principal est enfoncé pour activer la fonctionnalité ClickLock de la souris, l’utilisateur peut déplacer la souris. Une fois le bouton principal verrouillé, la libération du bouton principal n’entraîne pas de message WM_LBUTTONUP . Ainsi, il apparaît à une application que le bouton principal est toujours en panne. Tout message de bouton suivant libère le bouton principal, en envoyant un message WM_LBUTTONUP à l’application. Le bouton peut donc être déverrouillé par programmation ou via l’utilisateur en cliquant sur n’importe quel bouton.

Cette API n’est pas compatible ppp et ne doit pas être utilisée si le thread appelant prend en charge la résolution par moniteur. Pour la version prenant en charge les PPP de cette API, consultez SystemParametersInfoForDPI. Pour plus d’informations sur la prise en charge des ppp, consultez la documentation Windows High DPI.

Exemples

L’exemple suivant utilise SystemParametersInfo pour doubler la vitesse de la souris.


#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
    }  
}

Notes

L’en-tête winuser.h définit SystemParametersInfo en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête winuser.h (inclure Windows.h)
Bibliothèque User32.lib
DLL User32.dll
Ensemble d’API ext-ms-win-ntuser-sysparams-ext-l1-1-0 (introduit dans Windows 8)

Voir aussi

ACCESSTIMEOUT

ANIMATIONINFO

AUDIODESCRIPTION

FILTERKEYS

HIGHCONTRAST

ICONMETRICS

LOGFONT

MAKELANGID

MINIMIZEDMETRICS

MOUSEKEYS

NONCLIENTMETRICS

RECT

SERIALKEYS

SONSENTRÉE

STICKYKEYS

SystemParametersInfoForDPI

TOGGLEKEYS

WM_SETTINGCHANGE

Types de données Windows