There are several ways to include lists in your Toolkit application.
- Add a Toolkit list.
- Add Synergy’s ActiveX implementation of a Toolkit list (an ActiveX Toolkit list).
- Add an ActiveX list control of your choosing.
- Add the Synergy-supplied Spread control (an ActiveX control).
List Routines discusses the first two options listed above. For information on the second two options, see Options for ActiveX.
To create a list that’s portable between Unix, OpenVMS, and all supported Windows platforms, use a Toolkit list. For a more Windows-like list, use an ActiveX Toolkit list (see Specifying and determining the list type). ActiveX Toolkit lists wrap some of the functionality of the Spread control, creating ActiveX lists that you can control with Toolkit list routines. These work as ActiveX Toolkit lists on Windows platforms and as standard Toolkit lists on Unix and OpenVMS. The following are some of the additional features available with ActiveX Toolkit lists:
- Grid lines drawn between rows and columns
- Multi-line list entries (available with Toolkit lists on Unix and OpenVMS, but not Windows)
- Resizable columns
- Ability to focus on any cell
- True proportional font support (columns line up when proportional fonts are used)
- Ability to move between columns with Tab and Shift+Tab
- Ability to specify column widths
- Ability to specify alternating row colors
- Ability to specify font and color for all cells or on a per-cell basis
- Access to published properties and methods
See Notes and tips for ActiveX Toolkit lists for more information on ActiveX Toolkit lists.
See Appendix C: Keyboard Navigation for Lists on Windows for information on keyboard navigation in Windows environments (what keys and key combinations do in their default state, which keys are privatized, and which keys can never be used as shortcuts).
List processing differences on Windows
Toolkit uses a Windows list box for list processing. The list box itself is contained in a window that also contains the optional list header and footer and the list title as the window caption (title bar). List boxes take up slightly more screen area on Windows than on Unix or OpenVMS due to the caption frame and slightly larger scroll bars.
The window that contains the list can be resized or moved. The list can have vertical and horizontal scroll bars. You can use the .LISTCLASS NOCELLHBAR and NOCELLVBAR options to suppress scroll bars on Unix and OpenVMS but display them on Windows.
When using Toolkit lists on Windows, field-to-field mouse movement when performing input into a list is not supported.
