Important Notice
The pages on this site contain documentation for very old MS-DOS software,
purely for historical purposes.
If you're looking for up-to-date documentation, particularly for programming,
you should not rely on the information found here, as it will be woefully
out of date.
WinSetSysValue (1.2)
◄Function Group► ◄Changes► ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
#define INCL_WINSYS
BOOL WinSetSysValue(hwndDesktop, iSysValue, lValue)
HWND hwndDesktop; /* handle of desktop window */
SHORT iSysValue; /* system value to change */
LONG lValue; /* new system value */
The WinSetSysValue function sets the system value.
Parameter Description
────────────────────────────────────────────────────────────────────────────
hwndDesktop Identifies the desktop window. This parameter can be
HWND_DESKTOP or the desktop window handle.
iSysValue Specifies the system value to set. The following system values
may be set:
Value Meaning
───────────────────────────────────────────────────────────────
SV_SWAPBUTTON Specifies whether the mouse buttons are
swapped. A value of TRUE means the
mouse buttons are swapped.
SV_CXDBLCLK Specifies the horizontal spacing for a
mouse double-click. When the horizontal
distance between two mouse clicks is
less than this value, the horizontal
spacing requirement is met for two
mouse clicks to qualify as a
double-click.
SV_CYDBLCLK Specifies the vertical spacing for a
mouse double-click. When the vertical
distance between two mouse clicks is
less than this value, the vertical
spacing requirement is met for two
mouse clicks to qualify as a
double-click.
SV_DBLCLKTIME Specifies the mouse double-click time,
in milliseconds. When the time between
two mouse clicks is less than this
value, the temporal requirement is met
for two mouse clicks to qualify as a
double-click.
SV_CXSIZEBORDER Specifies the number of pels along the
x axis in a window-sizing border.
SV_CYSIZEBORDER Specifies the number of pels along the
y axis in a window-sizing border.
SV_ALARM Specifies whether a call to the
WinAlarm function generates a sound. A
value of TRUE means sound is
generated.
SV_CURSORRATE Specifies the rate at which the cursor
blinks, in milliseconds. The blink rate
is the time that the cursor remains
visible or invisible. Twice this value
is the time the cursor takes to cycle
from visibility to invisibility and
back.
SV_FIRSTSCROLLRATE Specifies the delay (in milliseconds)
between clicking and holding down the
mouse button (when the mouse pointer is
on a scroll arrow or scroll bar) and
the beginning of scroll-bar auto-repeat
activity.
SV_SCROLLRATE Specifies the delay (in milliseconds)
between scroll-bar auto-repeat events.
SV_ERRORFREQ Specifies the frequency (in hertz) of a
WinAlarm function WA_ERROR sound.
SV_NOTEFREQ Specifies the frequency (in hertz) of a
WinAlarm function WA_NOTE sound.
SV_WARNINGFREQ Specifies the frequency (in hertz) of a
WinAlarm function WA_WARNING sound.
SV_ERRORDURATION Specifies the duration (in
milliseconds) of a WinAlarm function
WA_ERROR sound.
SV_NOTEDURATION Specifies the duration (in
milliseconds) of a WinAlarm function
WA_NOTE sound.
SV_WARNINGDURATION Specifies the duration (in
milliseconds) of a WinAlarm function
WA_WARNING sound.
SV_EXTRAKEYBEEP Specifies whether beep is turned on for
extended keys (keys not on an IBM PS/2
or compatible keyboard).
SV_SETLIGHTS Specifies whether the system controls
the keyboard indicator lights.
SV_INSERTMODE Specifies whether insert mode is on or
off for entry-field controls.
SV_MENUROLLDOWNDELAY Specifies the delay (in milliseconds)
for the menu to roll down.
SV_MENUROLLUPDELAY Specifies the delay (in milliseconds)
for the menu to roll up.
SV_ALTMNEMONIC Specifies whether the Alt key is
allowed as a mnemonic.
SV_TASKLISTMOUSEACCESS Specifies whether the Task List can be
accessed by the right mouse button.
For a complete list of the system values, see the
◄System values► topic.
lValue Specifies the value to set the system value to. Durations are
in milliseconds. Frequencies are in hertz; valid values are
0x0025 through 0x7FFF.
Return Value
The return value is TRUE if the system value is successfully set. Otherwise,
it is FALSE, indicating that an error occurred.
See Also
WinQuerySysValue
♦