Input parameter | Meaning |
SPI_GETBEEP
| Determines whether the warning beeper is on.
The pvParam parameter must point to a BOOL variable that receives TRUE if the beeper is on, or FALSE if it is off.
|
SPI_GETBLOCKSENDINPUTRESETS
| Retrieves a BOOL indicating whether an application can reset the screensaver's timer by calling the SendInputfunction to simulate keyboard or mouse input. The pvParamparameter must point to a BOOL variable that receives TRUE if the simulated input will be blocked, or FALSE otherwise.
|
SPI_GETDEFAULTINPUTLANG
| Retrieves the input locale identifier for the system default input language. The pvParam parameter must point to anHKL variable that receives this value. For more information, see Languages, Locales, and Keyboard Layouts.
|
SPI_GETKEYBOARDCUES
| Determines whether menu access keys are always underlined. The pvParam parameter must point to a BOOLvariable that receives TRUE if menu access keys are always underlined, and FALSE if they are underlined only when the menu is activated by the keyboard.
|
SPI_GETKEYBOARDDELAY
| Retrieves the keyboard repeat-delay setting, which is a value in the range from 0 (approximately 250 ms delay) through 3 (approximately 1 second delay). The actual delay associated with each value may vary depending on the hardware. The pvParam parameter must point to an integer variable that receives the setting.
|
SPI_GETKEYBOARDPREF
| Determines whether the user relies on the keyboard instead of the mouse, and wants applications to display keyboard interfaces that would otherwise be hidden. The pvParamparameter must point to a BOOL variable that receives TRUE if the user relies on the keyboard; or FALSE otherwise.
|
SPI_GETKEYBOARDSPEED
| Retrieves the keyboard repeat-speed setting, which is a value in the range from 0 (approximately 2.5 repetitions per second) through 31 (approximately 30 repetitions per second). The actual repeat rates are hardware-dependent and may vary from a linear scale by as much as 20%. ThepvParam parameter must point to a DWORD variable that receives the setting.
|
SPI_GETMOUSE
| Retrieves the two mouse threshold values and the mouse acceleration. The pvParam parameter must point to an array of three integers that receives these values. Seemouse_event for further information.
|
SPI_GETMOUSEHOVERHEIGHT
| Retrieves the height, in pixels, of the rectangle within which the mouse pointer has to stay for TrackMouseEvent to generate a WM_MOUSEHOVER message. The pvParamparameter must point to a UINT variable that receives the height.
|
SPI_GETMOUSEHOVERTIME
| Retrieves the time, in milliseconds, that the mouse pointer has to stay in the hover rectangle for TrackMouseEvent to generate a WM_MOUSEHOVER message. The pvParamparameter must point to a UINT variable that receives the time.
|
SPI_GETMOUSEHOVERWIDTH
| Retrieves the width, in pixels, of the rectangle within which the mouse pointer has to stay for TrackMouseEvent to generate a WM_MOUSEHOVER message. The pvParamparameter must point to a UINT variable that receives the width.
|
SPI_GETMOUSESPEED
| Retrieves the current mouse speed. The mouse speed determines how far the pointer will move based on the distance the mouse moves. The pvParam parameter must point to an integer that receives a value which ranges between 1 (slowest) and 20 (fastest). A value of 10 is the default. The value can be set by an end-user using the mouse control panel application or by an application using SPI_SETMOUSESPEED.
|
SPI_GETMOUSETRAILS
| Determines whether the Mouse Trails feature is enabled. This feature improves the visibility of mouse cursor movements by briefly showing a trail of cursors and quickly erasing them.
The pvParam parameter must point to an integer variable that receives a value. If the value is zero or 1, the feature is disabled. If the value is greater than 1, the feature is enabled and the value indicates the number of cursors drawn in the trail. The uiParam parameter is not used.
Windows 2000: This value is not supported until Windows XP. |
SPI_GETSNAPTODEFBUTTON
| Determines whether the snap-to-default-button feature is enabled. If enabled, the mouse cursor automatically moves to the default button, such as OK or Apply, of a dialog box. The pvParam parameter must point to a BOOL variable that receives TRUE if the feature is on, or FALSE if it is off.
|
SPI_GETWHEELSCROLLCHARS
| Retrieves the number of characters to scroll when the horizontal mouse wheel is moved. The pvParam parameter must point to a UINT variable that receives the number of lines. The default value is 3.
|
SPI_GETWHEELSCROLLLINES
| Retrieves the number of lines to scroll when the vertical mouse wheel is moved. The pvParam parameter must point to a UINT variable that receives the number of lines. The default value is 3.
|
SPI_SETBEEP
| Turns the warning beeper on or off. The uiParam parameter specifies TRUE for on, or FALSE for off.
|
SPI_SETBLOCKSENDINPUTRESETS
| Determines whether an application can reset the screensaver's timer by calling the SendInput function to simulate keyboard or mouse input. The uiParam parameter specifies TRUE if the screensaver will not be deactivated by simulated input, or FALSE if the screensaver will be deactivated by simulated input.
|
SPI_SETDEFAULTINPUTLANG
| Sets the default input language for the system shell and applications. The specified language must be displayable using the current system character set. The pvParamparameter must point to an HKL variable that contains the input locale identifier for the default language. For more information, see Languages, Locales, and Keyboard Layouts.
|
SPI_SETDOUBLECLICKTIME
| Sets the double-click time for the mouse to the value of theuiParam parameter. The double-click time is the maximum number of milliseconds that can occur between the first and second clicks of a double-click. You can also call theSetDoubleClickTime function to set the double-click time. To get the current double-click time, call theGetDoubleClickTime function.
|
SPI_SETDOUBLECLKHEIGHT
| Sets the height of the double-click rectangle to the value of the uiParam parameter.
The double-click rectangle is the rectangle within which the second click of a double-click must fall for it to be registered as a double-click.
To retrieve the height of the double-click rectangle, callGetSystemMetrics with the SM_CYDOUBLECLK flag.
|
SPI_SETDOUBLECLKWIDTH
| Sets the width of the double-click rectangle to the value of the uiParam parameter.
The double-click rectangle is the rectangle within which the second click of a double-click must fall for it to be registered as a double-click.
To retrieve the width of the double-click rectangle, callGetSystemMetrics with the SM_CXDOUBLECLK flag.
|
SPI_SETKEYBOARDCUES
| Sets the underlining of menu access key letters. ThepvParam parameter is a BOOL variable. Set pvParam to TRUE to always underline menu access keys, or FALSE to underline menu access keys only when the menu is activated from the keyboard.
|
SPI_SETKEYBOARDDELAY
| Sets the keyboard repeat-delay setting. The uiParamparameter must specify 0, 1, 2, or 3, where zero sets the shortest delay (approximately 250 ms) and 3 sets the longest delay (approximately 1 second). The actual delay associated with each value may vary depending on the hardware.
|
SPI_SETKEYBOARDPREF
| Sets the keyboard preference. The uiParam parameter specifies TRUE if the user relies on the keyboard instead of the mouse, and wants applications to display keyboard interfaces that would otherwise be hidden; uiParam is FALSE otherwise.
|
SPI_SETKEYBOARDSPEED
| Sets the keyboard repeat-speed setting. The uiParamparameter must specify a value in the range from 0 (approximately 2.5 repetitions per second) through 31 (approximately 30 repetitions per second). The actual repeat rates are hardware-dependent and may vary from a linear scale by as much as 20%. If uiParam is greater than 31, the parameter is set to 31.
|
SPI_SETLANGTOGGLE
| Sets the hot key set for switching between input languages. The uiParam and pvParam parameters are not used. The value sets the shortcut keys in the keyboard property sheets by reading the registry again. The registry must be set before this flag is used. the path in the registry is \HKEY_CURRENT_USER\keyboard layout\toggle. Valid values are "1" = ALT+SHIFT, "2" = CTRL+SHIFT, and "3" = none.
|
SPI_SETMOUSE
| Sets the two mouse threshold values and the mouse acceleration. The pvParam parameter must point to an array of three integers that specifies these values. Seemouse_event for further information.
|
SPI_SETMOUSEBUTTONSWAP
| Swaps or restores the meaning of the left and right mouse buttons. The uiParam parameter specifies TRUE to swap the meanings of the buttons, or FALSE to restore their original meanings.
To retrieve the current setting, call GetSystemMetrics with the SM_SWAPBUTTON flag.
|
SPI_SETMOUSEHOVERHEIGHT
| Sets the height, in pixels, of the rectangle within which the mouse pointer has to stay for TrackMouseEvent to generate a WM_MOUSEHOVER message. Set the uiParamparameter to the new height.
|
SPI_SETMOUSEHOVERTIME
| Sets the time, in milliseconds, that the mouse pointer has to stay in the hover rectangle for TrackMouseEvent to generate a WM_MOUSEHOVER message. This is used only if you pass HOVER_DEFAULT in the dwHoverTime parameter in the call to TrackMouseEvent. Set the uiParamparameter to the new time.
The time specified should be between USER_TIMER_MAXIMUM and USER_TIMER_MINIMUM. IfuiParam is less than USER_TIMER_MINIMUM, the function will use USER_TIMER_MINIMUM. If uiParam is greater than USER_TIMER_MAXIMUM, the function will be USER_TIMER_MAXIMUM.
Windows Server 2003 and Windows XP: The operating system does not enforce the use of USER_TIMER_MAXIMUM and USER_TIMER_MINIMUM until Windows Server 2003 SP1 and Windows XP SP2.
|
SPI_SETMOUSEHOVERWIDTH
| Sets the width, in pixels, of the rectangle within which the mouse pointer has to stay for TrackMouseEvent to generate a WM_MOUSEHOVER message. Set the uiParamparameter to the new width.
|
SPI_SETMOUSESPEED
| Sets the current mouse speed. The pvParam parameter is an integer between 1 (slowest) and 20 (fastest). A value of 10 is the default. This value is typically set using the mouse control panel application.
|
SPI_SETMOUSETRAILS
| Enables or disables the Mouse Trails feature, which improves the visibility of mouse cursor movements by briefly showing a trail of cursors and quickly erasing them.
To disable the feature, set the uiParam parameter to zero or 1. To enable the feature, set uiParam to a value greater than 1 to indicate the number of cursors drawn in the trail.
Windows 2000: This value is not supported until Windows XP. |
SPI_SETSNAPTODEFBUTTON
| Enables or disables the snap-to-default-button feature. If enabled, the mouse cursor automatically moves to the default button, such as OK or Apply, of a dialog box. Set the uiParam parameter to TRUE to enable the feature, or FALSE to disable it. Applications should use theShowWindow function when displaying a dialog box so the dialog manager can position the mouse cursor.
|
SPI_SETWHEELSCROLLCHARS
| Sets the number of characters to scroll when the horizontal mouse wheel is moved. The number of characters is set from the uiParam parameter.
|
SPI_SETWHEELSCROLLLINES
| Sets the number of lines to scroll when the vertical mouse wheel is moved. The number of lines is set from theuiParam parameter.
The number of lines is the suggested number of lines to scroll when the mouse wheel is rolled without using modifier keys. If the number is 0, then no scrolling should occur. If the number of lines to scroll is greater than the number of lines viewable, and in particular if it is WHEEL_PAGESCROLL (#defined as UINT_MAX), the scroll operation should be interpreted as clicking once in the page down or page up regions of the scroll bar.
|