WinSetSysValue - Parameters

hwndDeskTop (HWND) - input

Desktop-window handle.

HWND_DESKTOP

Set the system values for the desktop-window handle
Other
Set the system values for the specified desktop-window handle.

iSysValue (LONG) - input

System-value identity.

This must be one of the following SV_* constants that is marked with an asterisk (*).

Note: Not all system values can be set; those that can be set are marked with an asterisk (*). All of the SV_* constants can be queried using the WinQuerySysValue.

SV_ALARM

(*) TRUE if the alarm sound generated by WinAlarm is enabled; FALSE if the alarm sound is disabled.
SV_ALTMNEMONIC
(*) TRUE if the mnemonic is made up of KATAKANA characters; FALSE if the mnemonic is made up of ROMAN characters.
SV_ANIMATION
(*) TRUE when animation is set on. FALSE when animation is set off.
SV_BEGINDRAG
(*) Mouse begin drag (low word=mouse message id (WM_*), high word=keyboard control code (KC_*)).
SV_BEGINDRAGKB
(*) Keyboard begin drag (low word=virtual key code (VK_*), high word=keyboard control code (KC_*)).
SV_BEGINSELECT
(*) Mouse begin swipe select (low word=mouse message id (WM_*), high word=keyboard control code (KC_*)).
SV_BEGINSELECTKB
(*) Keyboard begin swipe select (low word=virtual key code (VK_*), high word=keyboard control code (KC_*)).
SV_CICONTEXTLINES
(*) Maximum number of lines that the icon text may occupy for a minimized window.
SV_CONTEXTHELP
(*) Mouse control for pop-up menu (low word=mouse message id (WM_*), high word=keyboard control code (KC_*)).
SV_CONTEXTHELPKB
(*) Keyboard control for pop-up menu (low word=virtual key code (VK_*), high word=keyboard control code (KC_*)).
SV_CONTEXTMENU
(*) Mouse request pop-up menu (low word=mouse message id (WM_*), high word=keyboard control code (KC_*)).
SV_CONTEXTMENUKB
(*) Keyboard request pop-up menu (low word=virtual key code (VK_*), high word=keyboard control code (KC_*)).
SV_CMOUSEBUTTONS
The number of buttons on the pointing device (zero if no pointing device is installed).
SV_CTIMERS
Count of available timers.
SV_CURSORLEVEL
The cursor hide level.
SV_CURSORRATE
(*) Cursor blink rate, in milliseconds.
SV_CXBORDER
Width of the nominal-width border.
SV_CXBYTEALIGN
Horizontal count of pels for alignment.
SV_CXDBLCLK
(*) Width of the pointing device double-click sensitive area. The default is the system-font character width.
SV_CXDLGFRAME
Width of the dialog-frame border.
SV_CXFULLSCREEN
Width of the client area when the window is full screen.
SV_CXHSCROLLARROW
Width of the horizontal scroll-bar arrow bit maps.
SV_CXHSLIDER
Width of the horizontal scroll-bar thumb.
SV_CXICON
Icon width.
SV_CXICONTEXTWIDTH
(*) Maximum number of characters per line allowed in the icon text for a minimized window.
SV_CXMINMAXBUTTON
Width of the minimize/maximize buttons.
SV_CXMOTIONSTART
(*) The number of pels that a pointing device must be moved in the horizontal direction, while the button is depressed, before a WM_BUTTONxMOTIONSTR message is sent.
SV_CXPOINTER
Pointer width.
SV_CXSCREEN
Width of the screen.
SV_CXSIZEBORDER
(*) Width of the sizing border.
SV_CXVSCROLL
Width of the vertical scroll-bar.
SV_CYBORDER
Height of the nominal-width border.
SV_CYBYTEALIGN
Vertical count of pels for alignment.
SV_CYDBLCLK
(*) Height of the pointing device double-click sensitive area. The default is half the height of the system font character height.
SV_CYDLGFRAME
Height of the dialog-frame border.
SV_CYFULLSCREEN
Height of the client area when the window is full screen (excluding menu height).
SV_CYHSCROLL
Height of the horizontal scroll-bar.
SV_CYICON
Icon height.
SV_CYMENU
Height of the single-line menu height.
SV_CYMINMAXBUTTON
Height of the minimize/maximize buttons.
SV_CYMOTIONSTART
(*) The number of pels that a pointing device must be moved in the vertical direction, while the button is depressed, before a WM_BUTTONxMOTIONSTR message is sent.
SV_CYPOINTER
Pointer height.
SV_CYSCREEN
Height of the screen.
SV_CYSIZEBORDER
(*) Height of the sizing border.
SV_CYTITLEBAR
Height of the caption.
SV_CYVSCROLLARROW
Height of the vertical scroll-bar arrow bit maps.
SV_CYVSLIDER
Height of the vertical scroll-bar thumb.
SV_DBLCLKTIME
(*) Pointing device double-click time, in milliseconds.
SV_DEBUG
FALSE indicates this is not a debug system.
SV_ENDDRAG
(*) Mouse end drag (low word=mouse message id (WM_*), high word=keyboard control code (KC_*)).
SV_ENDDRAGKB
(*) Keyboard end drag (low word=virtual key code (VK_*), high word=keyboard control code (KC_*)).
SV_ENDSELECT
(*) Mouse select or end swipe select (low word=mouse message id (WM_*), high word=keyboard control code (KC_*)).
SV_ENDSELECTKB
(*) Keybaord select or end swipe select (low word=virtual key code (VK_*), high word=keyboard control code (KC_*)).
SV_ERRORDURATION
(*) Duration for error alarms generated by WinAlarm.
SV_ERRORFREQ
(*) Frequency for error alarms generated by WinAlarm.
SV_EXTRAKEYBEEP
( * )WhenTRUE ,thepressofakeythatdoesnotexistontheEnhancedkeyboardcausesthesystemtogenerateabeep .
SV _ FIRSTSCROLLRATE
( * )Thedelay( inmilliseconds )beforeautoscrollingstarts ,whenusingascrollbar .
SV _ INSERTMODE
( * )TRUEifthesystemisininsertmode( foreditandmulti - lineeditcontrols ) ;FALSEifinovertypemode .

This system value is toggled by the system when the insert key is toggled, regardless of which window has the focus at the time.

SV_KBDALTERED
(*) Hardware ID of the newly attached keyboard.

Note: The OS/2 National Language Support is only loaded once per system IPL. The OS/2 NLS translation is based partially on the type of keyboard device attached to the system. There are two main keyboard device types: PC AT styled and Enhanced styled. Hot Plugging between these two types of devices may result in typing anomalies due to a mismatch in the NLS device tables loaded and that of the attached device. It is strongly recommended that keyboard hot plugging be limited to the device type that the system was IPL'd with. In addition, OS/2 support will default to the 101/102 key Enhanced keyboard if no keyboard or a NetServer Mode password was in use during system IPL. (See Category 4, IOCtls 77h and 7Ah for more information on keyboard devices and types.)

SV_LOCKSTARTINPUT
(*) TRUE when the type ahead function is enabled; FALSE when the type ahead function is disabled.
SV_MENUROLLDOWNDELAY
(*) The delay in milliseconds before displaying a pull down referred to from a submenu item, when the button is already down as the pointer moves onto the submenu item.
SV_MENUROLLUPDELAY
(*) The delay in milliseconds before hiding a pull down referred to from a submenu item, when the button is already down as the pointer moves off the submenu item.
SV_MONOICONS
(*) When TRUE preference is given to black and white icons when selecting which icon resource definition to use on the screen. Black and white icons may have more clarity than color icons on LCD and Plasma display screens.
SV_MOUSEPRESENT
When TRUE a mouse pointing device is attached to the system.
SV_NOTEDURATION
(*) Duration for note alarms generated by WinAlarm.
SV_NOTEFREQ
(*) Frequency for note alarms generated by WinAlarm.
SV_OPEN
(*) Mouse open (low word=mouse message id (WM_*), high word=keyboard control code (KC_*)).
SV_OPENKB
(*) Keyboard open (low word=virtual key code (VK_*), high word=keyboard control code (KC_*)).
SV_POINTERLEVEL
Pointer hide level. If the pointer level is zero, the pointer is visible. If it is greater than zero, the pointer is not visible. The WinShowPointer call is invoked to increment and decrement the SV_POINTERLEVEL, but its value cannot become negative.
SV_PRINTSCREEN
(*) TRUE when the Print Screen function is enabled; FALSE when the Print Screen function is disabled.
SV_SCROLLRATE
(*) The delay (in milliseconds) between scroll operations, when using a scroll bar.
SV_SETLIGHTS
(*) When TRUE, the appropriate light is set when the keyboard state table is set.
SV_SINGLESELECT
(*) Mouse select (low word=mouse message id (WM_*), high word=keyboard control code (KC_*)).
SV_TASKLISTMOUSEACCESS
(*) Determines whether the task list is displayed when mouse buttons 1 and 2 are pressed simultaneously, or when mouse button 2 is pressed by itself, or for no mouse gesture.
SV_TEXTEDIT
(*) Mouse begin direct name edit (low word=mouse message id (WM_*), high word=keyboard control code (KC_*)).
SV_TEXTEDITKB
(*) Keyboard begin direct name edit (low word=virtual key code (VK_*), high word=keyboard control code (KC_*)).
SV_TRACKRECTLEVEL
The hide level of the tracking rectangle (zero if visible, greater than zero if not).
SV_SWAPBUTTON
(*) TRUE if pointing device buttons are swapped. Normally, the pointing device buttons are set for right-handed use. Setting this value changes them for left-handed use.

If TRUE, WM_LBUTTON* messages are returned when the user presses the right button, and WM_RBUTTON* messages are returned when the left button is pressed. Modifying this value affects the entire system. Applications should not normally read or set this value; users update this value by means of the user interface shell to suit their requirements.

SV_WARNINGDURATION
(*) Duration for warning alarms generated by WinAlarm.
SV_WARNINGFREQ
(*) Frequency for warning alarms generated by WinAlarm.

lValue (LONG) - input

System value.

Dimensions are in pels and times are in milliseconds.

rc (BOOL) - returns

Value-set indicator.

TRUE

System value set.
FALSE
Error occurred.

---

[Back: WinSetSysValue Return Value - rc]
[Next: WinSetSysValue - Errors]