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).


One of the following:


g_retaincontext is set to true (1).

Any other value

g_retaincontext is set to false (0).


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.