RETAIN_CONTEXT_CHANGE_ON_SIGNAL
Set initial value of g_retaincontext
WTSupported in traditional Synergy on Windows
|
|
USupported on UNIX
|
VSupported on OpenVMS
|
The RETAIN_CONTEXT_CHANGE_ON_SIGNAL environment variable is used by UI Toolkit’s U_START routine to determine the initial value of g_retaincontext (a global defined in tkctl.def).
Value
One of the following:
g_retaincontext is set to true (1).
g_retaincontext is set to false (0).
Discussion
RETAIN_CONTEXT_CHANGE_ON_SIGNAL sets the initial value of g_retaincontext, which determines how context is handled when a menu entry is signaled from a method during I_INPUT processing and a user action (such as a mouse click, Enter, tab, shift+tab, etc.) moves input context to a subsequent field or button. Prior to UI Toolkit 8.3, if a menu entry was signaled in this situation, Toolkit would incorrectly apply the menu entry processing to the subsequent field or button rather than to the field whose method called %M_SIGNAL. This was corrected in Toolkit 8.3. By default, context now remains on the field whose method signaled the menu entry, which matches Toolkit behavior on UNIX and OpenVMS. You can, however, restore the previous behavior. If g_retaincontext is set to true, Toolkit emulates Windows behavior for Toolkit versions prior to 8.3 (it moves input context to the subsequent field or button). If g_retaincontext is set to false (the default), context remains on the field whose method signaled the menu entry.
For more information, see tkctl.def.
If RETAIN_CONTEXT_CHANGE_ON_SIGNAL is not defined, g_retaincontext is set to false (0).
Setting location
The environment or the [synergy], [dbr], or [myprog] section of synergy.ini (where myprog is any .dbr file).
Used by
UI Toolkit
Examples
set RETAIN_CONTEXT_CHANGE_ON_SIGNAL=1