FORM INPUT

Shifts the focus to the open form in the current window and puts the application user in control of the interface.

Syntax

FORM INPUT [PURGE]

Parameters

PURGECauses unprocessed input, received before the FORM INPUT command was executed, to be ignored. Eliminates the possible affects of inadvertent keystrokes or mouse actions before the application user is actually placed in control of the interface.

Comments

The FORM INPUT command ensures that the focus is in an available field of the current form and requests input from the application user. The application user can navigate through the available objects, enter data, interact with objects, and so on. If a scrolling relationship has been established between the form and a set of records, designated scrolling keys can be used to scroll data through the form.
The FORM INPUT command completes when an event occurs that causes a callback to the application program. If, at completion, the field that has focus contains an invalid value, the value in that field is automatically deleted.
A FORM DISPLAY command with the INPUT option or a MENU INPUT command also requests input from the application user.
The completion of FORM INPUT changes the value of the Event, ThisForm, ThisMenu, and ThisWindow system variables.

See Also

$Direction

FORM CLEAR

FORM DISPLAY

FORM OPEN

FORM SCROLL

FORM SET

INPUT

MENU INPUT

SET INPUT TIMEOUT

ThisForm

ThisMenu

ThisWindow

SET LEXTRACE

Controls lexical tracing.

Syntax

SET [LOCAL] LEXTRACE ON|OFF

Parameters

LOCALIndicates that lexical tracing is to be switched ON or OFF only at the “local” level.

Comments

The LEXTRACE option is set OFF by default.

When LEXTRACE is ON, each line of a procedure is displayed on the terminal, one character at a time, as it is parsed. Each line is preceded by the procedure name and document line number. If an error occurs, the resulting error message appears immediately following the character that caused the error.

Comment lines are traced. Carriage returns are inserted into the output when continuation characters (backslashes) are encountered. Statements are shown after macro substitution (if any) is complete.

Each output line starts with the procedure name and the application document line number as shown in the following example:

pCustReport[19] report from Customers

The SET LEXTRACE command has no effect on compiled procedures.

The SET LEXTRACE command is not affected by the SET RESET and SET RESTORE commands.

See Also

SET COMMANDTIMING

SET TRACE

SET TRACEOUTPUT

Create a New Database in ZIM

Using ZimAdmin login to a server and right click on the Databases folder.  Select “Create Database” and follow the instructions.

Once the database has been created, ZimAdmin will add the new database details to the zomdb.zim file.

For older systems use ZIMBOOT. ZIMBOOT Initializes a new ZIM-X database.

Syntax

ZIMBOOT <directory_name> <[ZANTHEZIM | encryption_key]> [-UTF-8]

Parameters

directory_nameThe disk directory where the new Object Dictionary is to be initialized. This directory must exist before ZIMBOOT is executed
encryption_keyA key that the software uses later to encrypt the disk files created as objects are created in the Object Dictionary. You must provide ZANTHEZIM if you DO NOT want the database to be encrypted.
encodingWhether the database will be initialized with the ANSI or UTF-8 encoding. If not provided, the default is ANSI.

Comments

If an Object Dictionary already exists in the specified location, ZIMBOOT asks you to confirm that you want to overwrite the existing database.

The newly created ZIM:X database will only contain the basic content for a ZIM:X application to be built. Prior to any work on this database, the developer must start ZIMQTC on this database and then execute

ZOMEnable

to populate the database with the remaining objects needed for the development of the application.

WINDOW SET INPUT

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

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

FORM RESTORE

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

WINDOW SET INPUT EXPOSE

Controls automatic exposure of active windows on input requests.

Syntax

WINDOW SET INPUT EXPOSE ON|OFF

Comments

The WINDOW SET INPUT EXPOSE command is set ON by default.

When WINDOW SET INPUT EXPOSE is ON, the current window (if active) is always exposed when input is requested (by a FORM INPUT, INPUT, or MENU INPUT command). When WINDOW SET INPUT is set OFF, an input request does not cause an active window to be exposed.

An inactive current window is always automatically activated and exposed when the application user is given control of the interface, regardless of the WINDOW SET INPUT EXPOSE setting.

See Also

ThisWindow

WINDOW ACTIVATE

WINDOW CLEAR

WINDOW CLOSE

WINDOW DEACTIVATE

WINDOW DISPLAY

WINDOW OPEN

WINDOW SCROLL

WINDOW SET

WINDOW SIZE

FORM SET MOUSEPOINTER

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

Syntax

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

Parameters

A string or an expression that evaluates to a string; the string must be a valid cursor file name.
< formname>A formname
< formfieldname>The name of a formfield
< formnum>The form number
< fieldnum>The field number
The subscript

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.

SET SINGLESTEP

Steps through a procedure one command at a time, halting after each command.

Syntax

SET SINGLESTEP ON|OFF

Comments

When SINGLESTEP is switched ON, execution is halted (by the HALT utility) after each command executed. To resume execution after the HALT, press Enter at the HALT prompt (>>).

Compiled application programs are not affected by SET SINGLESTEP.

The SET SINGLESTEP command is not affected by the SET RESET and SET RESTORE commands.

Example

To switch to singlestep, use

> set trace on
> set singlestep on

Now, if you execute an application program, it looks like this:

> DoCusts (“edit”)
procedure DoCusts (in ExMode)
>>output $setcount
35
>>(carriage return)
let dp = $true
>>.
.
.

See Also

SET STOP ERRORS

pt_BRPortuguese