win32gui.SystemParametersInfo
SystemParametersInfo(Action, Param, WinIni)
Queries or sets system-wide parameters. This function can also update the user profile while setting a parameter.
Parameters
| Action | Input/return type |
| SPI_GETDESKWALLPAPER | Returns the path to the bmp used as wallpaper |
| SPI_SETDESKWALLPAPER | Param should be a string specifying a .bmp file |
| SPI_GETDROPSHADOW | Returns a boolean |
| SPI_GETFLATMENU | Returns a boolean |
| SPI_GETFONTSMOOTHING | Returns a boolean |
| SPI_GETICONTITLEWRAP | Returns a boolean |
| SPI_GETSNAPTODEFBUTTON | Returns a boolean |
| SPI_GETBEEP | Returns a boolean |
| SPI_GETBLOCKSENDINPUTRESETS | Returns a boolean |
| SPI_GETMENUUNDERLINES | Returns a boolean |
| SPI_GETKEYBOARDCUES | Returns a boolean |
| SPI_GETKEYBOARDPREF | Returns a boolean |
| SPI_GETSCREENSAVEACTIVE | Returns a boolean |
| SPI_GETSCREENSAVERRUNNING | Returns a boolean |
| SPI_GETMENUDROPALIGNMENT | Returns a boolean (True indicates left aligned, False right aligned) |
| SPI_GETMENUFADE | Returns a boolean |
| SPI_GETLOWPOWERACTIVE | Returns a boolean |
| SPI_GETPOWEROFFACTIVE | Returns a boolean |
| SPI_GETCOMBOBOXANIMATION | Returns a boolean |
| SPI_GETCURSORSHADOW | Returns a boolean |
| SPI_GETGRADIENTCAPTIONS | Returns a boolean |
| SPI_GETHOTTRACKING | Returns a boolean |
| SPI_GETLISTBOXSMOOTHSCROLLING | Returns a boolean |
| SPI_GETMENUANIMATION | Returns a boolean |
| SPI_GETSELECTIONFADE | Returns a boolean |
| SPI_GETTOOLTIPANIMATION | Returns a boolean |
| SPI_GETTOOLTIPFADE | Returns a boolean (TRUE=fade, False=slide) |
| SPI_GETUIEFFECTS | Returns a boolean |
| SPI_GETACTIVEWINDOWTRACKING | Returns a boolean |
| SPI_GETACTIVEWNDTRKZORDER | Returns a boolean |
| SPI_GETDRAGFULLWINDOWS | Returns a boolean |
| SPI_GETSHOWIMEUI | Returns a boolean |
| SPI_GETMOUSECLICKLOCK | Returns a boolean |
| SPI_GETMOUSESONAR | Returns a boolean |
| SPI_GETMOUSEVANISH | Returns a boolean |
| SPI_GETSCREENREADER | Returns a boolean |
| SPI_GETSHOWSOUNDS | Returns a boolean |
| SPI_SETDROPSHADOW | Param must be a boolean |
| SPI_SETDROPSHADOW | Param must be a boolean |
| SPI_SETMENUUNDERLINES | Param must be a boolean |
| SPI_SETKEYBOARDCUES | Param must be a boolean |
| SPI_SETMENUFADE | Param must be a boolean |
| SPI_SETCOMBOBOXANIMATION | Param must be a boolean |
| SPI_SETCURSORSHADOW | Param must be a boolean |
| SPI_SETGRADIENTCAPTIONS | Param must be a boolean |
| SPI_SETHOTTRACKING | Param must be a boolean |
| SPI_SETLISTBOXSMOOTHSCROLLING | Param must be a boolean |
| SPI_SETMENUANIMATION | Param must be a boolean |
| SPI_SETSELECTIONFADE | Param must be a boolean |
| SPI_SETTOOLTIPANIMATION | Param must be a boolean |
| SPI_SETTOOLTIPFADE | Param must be a boolean |
| SPI_SETUIEFFECTS | Param must be a boolean |
| SPI_SETACTIVEWINDOWTRACKING | Param must be a boolean |
| SPI_SETACTIVEWNDTRKZORDER | Param must be a boolean |
| SPI_SETMOUSESONAR | Param must be a boolean |
| SPI_SETMOUSEVANISH | Param must be a boolean |
| SPI_SETMOUSECLICKLOCK | Param must be a boolean |
| SPI_SETFONTSMOOTHING | Param should specify a boolean |
| SPI_SETICONTITLEWRAP | Param should specify a boolean |
| SPI_SETSNAPTODEFBUTTON | Param is a boolean |
| SPI_SETBEEP | Param is a boolean |
| SPI_SETBLOCKSENDINPUTRESETS | Param is a boolean |
| SPI_SETKEYBOARDPREF | Param is a boolean |
| SPI_SETMOUSEBUTTONSWAP | Param is a boolean |
| SPI_SETSCREENSAVEACTIVE | Param is a boolean |
| SPI_SETMENUDROPALIGNMENT | Param is a boolean (True=left aligned, False=right aligned) |
| SPI_SETLOWPOWERACTIVE | Param is a boolean |
| SPI_SETPOWEROFFACTIVE | Param is a boolean |
| SPI_SETDRAGFULLWINDOWS | Param is a boolean |
| SPI_SETSHOWIMEUI | Param is a boolean |
| SPI_SETSCREENREADER | Param is a boolean |
| SPI_SETSHOWSOUNDS | Param is a boolean |
| SPI_SETMOUSETRAILS | Param should be an int specifying the nbr of cursors in the trail (0 or 1 means disabled) |
| SPI_SETWHEELSCROLLLINES | Param is an int specifying nbr of lines |
| SPI_SETKEYBOARDDELAY | Param is an int in the range 0 - 3 |
| SPI_SETKEYBOARDSPEED | Param is an int in the range 0 - 31 |
| SPI_SETDOUBLECLICKTIME | Param is an int (in milliseconds), Use win32gui::GetDoubleClickTime to retrieve the value. |
| SPI_SETDOUBLECLKWIDTH | Param is an int. Use win32api.GetSystemMetrics(SM_CXDOUBLECLK) to retrieve the value. |
| SPI_SETDOUBLECLKHEIGHT | Param is an int, Use win32api.GetSystemMetrics(SM_CYDOUBLECLK) to retrieve the value. |
| SPI_SETMOUSEHOVERHEIGHT | Param is an int |
| SPI_SETMOUSEHOVERWIDTH | Param is an int |
| SPI_SETMOUSEHOVERTIME | Param is an int |
| SPI_SETSCREENSAVETIMEOUT | Param is an int specifying the timeout in seconds |
| SPI_SETMENUSHOWDELAY | Param is an int specifying the shortcut menu delay in milliseconds |
| SPI_SETLOWPOWERTIMEOUT | Param is an int (in seconds) |
| SPI_SETPOWEROFFTIMEOUT | Param is an int (in seconds) |
| SPI_SETDRAGHEIGHT | Param is an int. Use win32api.GetSystemMetrics(SM_CYDRAG) to retrieve the value. |
| SPI_SETDRAGWIDTH | Param is an int. Use win32api.GetSystemMetrics(SM_CXDRAG) to retrieve the value. |
| SPI_SETBORDER | Param is an int |
| SPI_GETFONTSMOOTHINGCONTRAST | Returns an int |
| SPI_GETFONTSMOOTHINGTYPE | Returns an int |
| SPI_GETMOUSETRAILS | Returns an int specifying the nbr of cursor images in the trail, 0 or 1 indicates disabled |
| SPI_GETWHEELSCROLLLINES | Returns the nbr of lines to scroll for the mouse wheel |
| SPI_GETKEYBOARDDELAY | Returns an int |
| SPI_GETKEYBOARDSPEED | Returns an int |
| SPI_GETMOUSESPEED | Returns an int |
| SPI_GETMOUSEHOVERHEIGHT | Returns an int |
| SPI_GETMOUSEHOVERWIDTH | Returns an int |
| SPI_GETMOUSEHOVERTIME | Returns an int |
| SPI_GETSCREENSAVETIMEOUT | Returns an int (idle time in seconds) |
| SPI_GETMENUSHOWDELAY | Returns an int (shortcut delay in milliseconds) |
| SPI_GETLOWPOWERTIMEOUT | Returns an int (in seconds) |
| SPI_GETPOWEROFFTIMEOUT | Returns an int (in seconds) |
| SPI_GETACTIVEWNDTRKTIMEOUT | Returns an int (milliseconds) |
| SPI_GETBORDER | Returns an int |
| SPI_GETCARETWIDTH | Returns an int |
| SPI_GETFOREGROUNDFLASHCOUNT | Returns an int |
| SPI_GETFOREGROUNDLOCKTIMEOUT | Returns an int |
| SPI_GETFOCUSBORDERHEIGHT | Returns an int |
| SPI_GETFOCUSBORDERWIDTH | Returns an int |
| SPI_GETMOUSECLICKLOCKTIME | Returns an int (in milliseconds) |
| SPI_SETFONTSMOOTHINGCONTRAST | Param should be an int in the range 1000 to 2200 |
| SPI_SETFONTSMOOTHINGTYPE | Param should be one of the FE_FONTSMOOTHING* constants |
| SPI_SETMOUSESPEED | Param should be an int in the range 1 - 20 |
| SPI_SETACTIVEWNDTRKTIMEOUT | Param is an int (in milliseconds) |
| SPI_SETCARETWIDTH | Param is an int (in pixels) |
| SPI_SETFOREGROUNDFLASHCOUNT | Param is an int |
| SPI_SETFOREGROUNDLOCKTIMEOUT | Param is an int (in milliseconds) |
| SPI_SETFOCUSBORDERHEIGHT | Returns an int |
| SPI_SETFOCUSBORDERWIDTH | Returns an int |
| SPI_SETMOUSECLICKLOCKTIME | Param is an int (in milliseconds) |
| SPI_GETICONTITLELOGFONT | Returns a PyLOGFONT, |
| SPI_SETICONTITLELOGFONT | Param must be a PyLOGFONT, |
| SPI_SETLANGTOGGLE | Param is ignored. Sets the language toggle hotkey from registry key HKCU\\keyboard layout\\toggle |
| SPI_SETICONS | Reloads the system icons. Param is not used |
| SPI_GETMOUSE | Returns a tuple of 3 ints containing the x and y mouse thresholds and the acceleration factor. |
| SPI_SETMOUSE | Param should be a sequence of 3 ints |
| SPI_GETDEFAULTINPUTLANG | Returns an int (locale id for default language) |
| SPI_SETDEFAULTINPUTLANG | Param is an int containing a locale id |
| SPI_GETANIMATION | Returns an int |
| SPI_SETANIMATION | Param is an int |
| SPI_ICONHORIZONTALSPACING | Functions as both a get and set operation. If Param is None, functions as a get operation, otherwise Param is an int to be set as the new value |
| SPI_ICONVERTICALSPACING | Functions as both a get and set operation. If Param is None, functions as a get operation, otherwise Param is an int to be set as the new value |
| SPI_GETNONCLIENTMETRICS | Param must be None. The result is a dict. |
| SPI_SETNONCLIENTMETRICS | Param is a dict in the form of a NONCLIENTMETRICS struct, as returned by SPI_GETNONCLIENTMETRICS operation |
| SPI_GETMINIMIZEDMETRICS | Returns a dict representing a MINIMIZEDMETRICS struct. Param is not used. |
| SPI_SETMINIMIZEDMETRICS | Param should be a MINIMIZEDMETRICS dict as returned by SPI_GETMINIMIZEDMETRICS action |
| SPI_SETDESKPATTERN | Unsupported (obsolete) |
| SPI_GETFASTTASKSWITCH | Unsupported (obsolete) |
| SPI_SETFASTTASKSWITCH | Unsupported (obsolete) |
| SPI_SETSCREENSAVERRUNNING | Unsupported (documented as internal use only) |
| SPI_SCREENSAVERRUNNING | Same as SPI_SETSCREENSAVERRUNNING |
| SPI_SETPENWINDOWS | Unsupported (only relevant for win95) |
| SPI_GETWINDOWSEXTENSION | Unsupported (only relevant for win95) |
| SPI_GETGRIDGRANULARITY | Unsupported (obsolete) |
| SPI_SETGRIDGRANULARITY | Unsupported (obsolete) |
| SPI_LANGDRIVER | Unsupported (use is not documented) |
| SPI_GETFONTSMOOTHINGORIENTATION | Unsupported (use is not documented) |
| SPI_SETFONTSMOOTHINGORIENTATION | Unsupported (use is not documented) |
| SPI_SETHANDHELD | Unsupported (use is not documented) |
| SPI_GETICONMETRICS | Not implemented yet |
| SPI_SETICONMETRICS | Not implemented yet |
| SPI_GETWORKAREA | Not implemented yet |
| SPI_SETWORKAREA | Not implemented yet |
| SPI_GETSERIALKEYS | Not implemented yet |
| SPI_SETSERIALKEYS | Not implemented yet |
| SPI_SETMOUSEKEYS | Not implemented yet |
| SPI_GETMOUSEKEYS | Not implemented yet |
| SPI_GETHIGHCONTRAST | Not implemented yet |
| SPI_SETHIGHCONTRAST | Not implemented yet |
| SPI_GETSOUNDSENTRY | Not implemented yet |
| SPI_SETSOUNDSENTRY | Not implemented yet |
| SPI_GETSTICKYKEYS | Not implemented yet |
| SPI_SETSTICKYKEYS | Not implemented yet |
| SPI_GETTOGGLEKEYS | Not implemented yet |
| SPI_SETTOGGLEKEYS | Not implemented yet |
| SPI_GETACCESSTIMEOUT | Not implemented yet |
| SPI_SETACCESSTIMEOUT | Not implemented yet |
| SPI_GETFILTERKEYS | Not implemented yet |
| SPI_SETFILTERKEYS | Not implemented yet |
Comments
Param and WinIni are not used with any of the SPI_GET operationsBoolean parameters can be any object that can be evaluated as True or False
Return Value
SPI_SET functions all return None on success. Types returned by SPI_GET functions are dependent on the operation