The Form Object

Main Characteristics of Form Objects

Tool Box Icon	Appearance on Form

A form acts as a container for the form fields objects it owns;
Form objects do not have any visual attributes other than implicit dimensions.
The visual appearance of a form is the result of the visual attributes of the form fields owned by each of the forms owned by the display;
The dimensions of a form are considered to be the internal dimensions (i.e. the client area) of the window.
The Property Tab is not available for display objects.
The Zim language includes an extensive suite of commands for dynamically modifying both the visual and behavioral characteristics the form fields owned by forms.
The UI Designer supports the creation of associations among windows, menus and displays so that they can be viewed and/or edited as a group.

Identification

Attribute Name	Default Value	Description
Field Type	-	The type of this form field or of this user interface object. (Read-only).
Form Name	ZimForm####	A string that identifies this form object within the Zim application; Provided by the developer when renaming an existing form object or creating a new one; Must always conform to the Zim Object Naming Rules and satisfy the Zim Object Uniqueness Conditions.
Form Tag	""	A string that may be used to identify this form object within the Zim application and in Callback Events; May be changed by the developer and need not be unique; If left blank, the Zim IDE will assign the value of Form Name to Form Tag.
Directory	ZIM	The directory that owns this form object; May be modified by the developer through the drop-down list.

Appearance

Attribute Name	Default Value	Description
Position	-	The position (in pixels) of this form in relation to the top-left corner of its parent display object.
X	-	The horizontal position of this form.
Y	-	The vertical location of this form.
Size	-	The size of this form in pixels.
Width	-	The width of this form.
Height	-	The height of this form.

Properties

Attribute Name	Default Value	Description
Repeats Across	1	The number of repeated instances of a form object across its parent display object.
Repeats Down	1	The number of repeated instances of this form object down its parent display object.
Z-Order	>=1	The relative depth of this form in relation to other forms within the same parent display.