Categoria: UX/UI Objects

Controls the location where serial input from the terminal keyboard is received and displayed.

Syntax

WINDOW SET INPUT ON|OFF

Comments

The WINDOW SET INPUT command is set OFF by default.

When WINDOW SET INPUT is OFF, all serial input is received displayed in the application window (BACKSCREEN) regardless of which window is current. (The FORM INPUT and MENU INPUT commands operate in full-screen mode, and therefore are not affected by WINDOW SET INPUT.)

When WINDOW SET INPUT is ON, all line-by-line input occurs in the current window.

See Also

INPUT

WINDOW SET OUTPUT

Controls if line-by-line terminal output is displayed in the application window (BACKSCREEN) or the current window.

Syntax

WINDOW SET OUTPUT ON|OFF

Comments

The WINDOW SET OUTPUT command is set OFF by default.

When WINDOW SET OUTPUT is OFF, all serial output to the terminal is displayed in the application window (BACKSCREEN) regardless of which window is current.

When WINDOW SET OUTPUT is ON, all line-by-line output occurs in the current window. When WINDOW SET OUTPUT is ON, WINDOW SET INPUT should also be set ON.

The display of form, menu, and window objects is not affected by WINDOW SET OUTPUT.

See Also

OUTPUT

WINDOW SET INPUT EXPOSE

Makes the “next” saved form or display in the current Zim window the current form or display in the window.

Note: This command is invalid in Zim version 5 and above.

Syntax

FORM RESTORE

Comments

The FORM RESTORE command takes the “top” form or display from the “stack” of forms saved by FORM SAVE in the current window, making it the current form or display in the current window.

Note: The FORM RESTORE command must only be used with forms that are selected in text windows – never forms in graphical windows. Use of this command in Zim for Windows can cause system termination.

See Also

FORM CLEAR

FORM DISPLAY

FORM INPUT

FORM OPEN

FORM REPORT

FORM SAVE

FORM SET

Display a user-defined cursor when the mouse hovers over a graphical formfield widget.

Syntax

FORM SET ( MOUSEPOINTER )|< formname> |
|< formname>.< formfieldname>|
| (< formnum>,< fieldnum>, |

Parameters

Comments

A graphical formfield widget can have a user-defined cursor displayed when the mouse is hovering over it. Unlike predefined mouse cursors, user-defined mouse cursors are displayed even if the field is guarded. User-defined cursors can be assigned statically in the Screen Painter or dynamically using the MOUSEPOINTER attribute in the existing FORM SET command.

Display a user-defined cursor when the mouse hovers over a graphical formfield widget.

Syntax

WINDOW SET (MOUSEPOINTER ) []

Parameters

Comments

Every graphical formfield widget can have a user-defined cursor displayed when the mouse is hovering over it. Unlike predefined mouse cursors, user defined mouse cursors are displayed even if the field is guarded. User-defined cursors can be assigned statically in the Screen Painter or dynamically using the MOUSEPOINTER attribute in the existing WINDOW SET command.

Allows or disables the replaying of stored keystrokes during FORM INPUT.

Syntax

FORM SET INPUT ON|OFF

Comments

The command FORM SET INPUT ON initiates replaying the keystrokes stored in a script file called zfmkeys in the database directory.

The command FORM SET INPUT OFF stops replaying the keystrokes.

For more information, please consult Capturing_and_Replaying_Form_Input.

Allows the recording of keystrokes during FORM INPUT.

Syntax

FORM SET SAVE ON|OFF

Comments

The command FORM SET SAVE ON initiates capturing the keystrokes and storing them in a script called zfmkeys in the database directory.

The command FORM SET SAVE OFF stops capturing the keystrokes.

For more information, please consult Capturing_and_Replaying_Form_Input.

Syntax

MENU SET TOOLBAR ([NOT] SUPPRESS)

Where if is not entered, all toolbars are suppressed or not suppressed.

Introduction to Tab Controls and Tab Pages

A tab control defines an area of the form in which several tab pages of the same size can coexist.

Tab pages within the same tab control are visually represented as a stacked group of frames, since at any time, only a single tab page can have be displayed and the input focus.

As such, the active tab page within the tab control appears on the top of the stack, above all other inactive tab pages.

Tab Controls and the Tab Pages are both container objects. Tab Control can only contain tab pages, but tab pages can contain all other form fields, including other tab controls.

Tab controls and tab pages represent an efficient and practical solution to reuse the same area of a form to present different form controls.

Advantages of Tab Controls and Tab Pages

✓   There are two main advantages of using tab controls and tab pages over previous solutions that combined other form fields:

✓   The operating system directly manages the process of selecting, displaying and hiding tab pages within a tab control. As such, there is no need for writing additional Zim code to implement the functionality of tab controls and tab pages;

✓   The logical hierarchical structure of a tab control object and its children tab pages is maintained visually in the graphical user interface (e.g., all children tab pages will be moved along when a tab control is moved within a form) and in the database structure (e.g,. the tab control appears as a parent node and its children tab pages as children nodes in the Tree View Tab Page).

Adding Tab Controls and Tab Pages to the User Interface

✓   In your current form, add a tab control object from the toolbox tab .

✓   From the toolbox tab, select the tab page object and add at least 1 tab page to the tab control.

✓    To add user interface objects to tab pages, in the painter workspace double click on the tab header for which tab you wish to add user interface objects to.  The tab that has been selected is now the “current” tab page and form fields from the tool box tab can now be added to this  tab page.

✓   From the Database tab, open an existing menu by double clicking on the menu name or

From the main menu (File -> New, or the “New” icon in the menu toolbar), create a new menu object or

Open a form/display with an associated menu.

✓    Add a menu item.

Click on the menu bar where it says “Type Here” and a new menu item will be added immediately at that location.

Note: As long as you see a menu item that still says “Type Here”, that menu item has not yet been added to your menu and will not be saved.  The IDE is showing the available locations where a menu item can currently be added.

✓   Edit menu item properties.

On the right hand side of the painter window, select the properties tab to view/change the available properties for the currently selected menu item, and to see the children of that menu item listed at the bottom of that tab.

To change the location of an item within the menu, drag and drop the menu item to the desired position.