U_GBLWND

Give window global status

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
xcall U_GBLWND(window_id)

Arguments

window_id

The ID of the window to be promoted. (n)

Discussion

U_GBLWND promotes a local window to global status.

A global window is not deleted even when the environment that created it is exited.

If window_id is not local to the current environment, a fatal error occurs. If window_id is already global, this subroutine is ignored.

When promoting an input window to global status, any selection windows associated with the SELECT qualifier of the .FIELD command will also be promoted.

However, if an associated selection window was linked to an input field using the SELWND qualifier of the .FIELD command or the I_FLDSEL subroutine, UI Toolkit cannot guarantee that the associated selection window was created in the current environment. In this situation, you must promote the selection window yourself.

Examples

In the following example, the variable wndid is returned with the allocated channel, and the U_GBLWND subroutine promotes the window whose ID is stored in wndid to global status.

xcall u_ldwnd(wndid, g_utlib, "cusmas")
xcall u_gblwnd(wndid)