<TFT:Form def:Name='TftMainForm'>
Description
The Form control is the highest level in the controls hierarchy. It is used as a container for all other controls in the user interface.
Properties
Below is a list of the properties that can be defined for a Form control. These will adjust the functionality as well as the look and feel of the control:
Load
Type: | A string of any length |
Description:Used to express an entry point in the software DLL used as CodeBehind DLL (see details below regarding CodeBehind). For TFT display terminals the entry point is always “onLoad”.
Name
Type: | A string of any length |
Description:The name of the form. The main form for the TFT display is always named “TftMainForm” to make it possible for the software to find the form and all its sub-controls when the terminal starts. For the main form the name must be defined with the “def:” prefix (def:Name=”TftMainForm”) to make it possible for the software to find and use the form definition when the user interface is created from the ui.xaml file.
Sub-elements
Below is a list of the sub-elements that can be defined within a Form control. The sub-elements are used to add other controls to create a keyboard mapping for physical buttons in the terminal and to add a software DLL reference that is used when connecting actions to buttons, etc.
CodeBehind
The CodeBehind sub-element is used in a form to register a reference to the software DLL for the presentation layer. For terminals with TFT display the CodeBehind DLL is “cdsapplcodebehind.dll”.
Controls
The Controls sub-element contains all sub controls of the form. In the main form the Controls sub-element will contain all other user interface controls that are defined.
Example of an empty Form definition with the name “TftMainForm”. The Load property is set to “onLoad” which always is the entry point in the software DLL for TFT display terminals.
Example:
<TFT:Form def:Name='TftMainForm' Load='onLoad'>
<def:CodeBehind Src=''>
<reference assembly='cdsapplcodebehind.dll'/>
</def:CodeBehind>
<Controls>
- - -
</Controls>
</TFT:Form>