Using UI Toolkit with the .NET Framework

There are three ways you can use UI Toolkit code with the Microsoft .NET Framework:

Using Toolkit code with Synergy .NET (Windows)

UI Toolkit includes the Synergex.SynergyDE.tklib.dll library for building and running Toolkit code as a .NET application. Although this is available on Windows, it is not supported. (It is not available for Mono development, .NET Core, or portable class libraries.) On Windows, most Toolkit routines and Script commands are available, though they result in applications with cell‑based rather than Windows‑like appearance and functionality. For example, the mouse won’t work in most instances. Note the following:

The following is a summary of the process you’ll follow to use Toolkit code with the .NET Framework on Windows. See Debugging Synergy Programs.

1. Create a Synergy project in Visual Studio.
2. Add a reference to Synergex.SynergyDE.tklib.dll in your project. This is installed in a CLR directory under Program Files\Common Files\Synergex.
3. Use supported Synergy DBL and Toolkit routines to create the program. You can also define your Toolkit windows in windows script files and then compile the script files with Proto or Script. (See step 1 through step 3 of Getting started with UI Toolkit.) Script and Proto run only in traditional Synergy, but the libraries they create are compatible with Toolkit applications for .NET.
4. Build your application in Visual Studio. This creates an .exe or a .dll assembly.

Restrictions for global fields

When using Toolkit code with .NET, there are some limitations to the ways you can use global fields defined in tools.def and tkctl.def. The following are not supported:

clear ^i(temp_var)