Getting started with UI Toolkit

Before you begin

If you are a new user of UI Toolkit, it may be helpful to do the following:

.COLUMN

.END

.ENTRY

.FIELD

.INPUT

.SELECT

.WINDOW

U_START

U_FINISH

M_LDCOL

M_PROCESS

I_LDINP

I_INPUT

U_OPEN

U_CLOSE

Developing an application

The initial steps you should take to develop applications using UI Toolkit for traditional Synergy are as follows.

1. Define your windows and menu columns in a window script file. See Script for more information about writing script files. We suggest you use Composer to create this script interactively. See the Designing Your User Interface chapter of Getting Started with Synergy/DE for information on using Composer.
2. Compile the script files with Proto or Script to build the windows and columns and to store them in a window library. (You can also compile the script files from within Composer.)
3. Test and view the windows and columns with Proto.
4. Write a Synergy program that calls the UI Toolkit routines. You will need to include the file WND:tools.def in your program (with the Synergy DBL .INCLUDE statement). Read Requirements and considerations for Synergy programs before writing your program.
5. Compile the source code. (See Creating and running traditional Synergy applications.)
6. Link your program with WND:tklib.elb (TKLIB_SH.EXE on OpenVMS). See Linking object modules for information on commands for linking.

On Windows, you can link against tklib_qcheck.elb, a version of the UI Toolkit library that’s built with more thorough bounds checking (the ‑qcheck compiler option). All code linked against this version of the Toolkit library must be compiled with ‑qcheck. See Bounds checking and Compiler options.

On OpenVMS, you must replace SYNRTL.OPT with SYS$SHARE:SYNTKLIB.OPT to link your program. (Using SYS$SHARE:SYNTKLIB.OPT will link in the Toolkit shared image.) Additionally, you must use TKLIB_SH.EXE to link into the Toolkit libraries instead of tklib.elb.

7. Run your application. It will use the windows and menu columns stored in the window library.

1. Creating a Toolkit application with traditional Synergy.