WINDOW SIZE

Resizes, maximizes, minimizes, or restores an open window.

Syntax

WINDOW SIZE [window] size-option

Parameters

windowThe name of an open window. Can be
a window object name, or
(expr), where expr is a character string, or an expression that evaluates to a character string, that is to be used at run time as a window object name. The parentheses must be entered.
size-optionSize-option can be
TO height width
Sizes the window to specific dimensions, where height and width are numbers, or expressions evaluating to numbers, that express the new height and width of the window in pixels, respectively.
MAXIMIZE
Sizes a clipped window so that it fills the client area of its parent window, or a pop-up window so that it fills the entire screen.
MINIMIZE
Turns a clipped window into an icon near the bottom left-hand corner of its parent window, or turns a pop-up window into an icon near the bottom left-hand corner of the screen.
RESTORE
Restores the client area of a maximized or minimized window to its previous dimensions.

Comments

The WINDOW SIZE command establishes new dimensions for an open window (client area).

See Also

ThisWindow

WINDOW OPEN

WINDOW SCROLL

MENU SET

Modifies the individual attributes of particular menus or menu items.

Syntax

MENU SET («option») «object»

Parameters

option

Can be
 [UN]AVAILABLE, [NOT] CHECKED, [IN]VISIBLE,
LABEL, [NOT] SUPPRESS, RESET
The above options affect only the indicated attribute; all other attributes are left unchanged.

object

Object can be
menu
The name of the open menu in the current window.
menuitem
The name of a particular menu item within the open menu.
([exp1 ],[exp2 ],[exp3 ])
Positive integers or expressions that evaluate to positive integers, that identify a particular menu or menu item. Exp1 identifies the menu number; exp2, the item number. (Exp3 is reserved for future use.) Exp1, exp2, and exp3 must be positive integers or expressions that evaluate to positive integers. At least one of exp1 or exp2 must be specified.

Example

To set the attributes of individual menus or menu items, enter

menu set (checked) mTerm.Color

menu set (unavailable) mTerm.ColorType

menu set (suppress) (1,,)

 

See Also

FORM SET

MENU CLOSE

MENU DISPLAY

MENU INPUT

MENU OPEN

ThisMenu

WINDOW SET

WINDOW CLOSE

Closes an open window.

Syntax

WINDOW CLOSE [window]

Parameters

window

Window can be
name
The name of an open window. The software looks up name in the currently accessed directories in the usual way. A compiled command using name contains the unambiguous name of the window (including a reference to an application directory) that was found at compile time.
(expr )
A character string, or an expression that evaluates to a character string, that is to be used at run time as a window object name. The parentheses must be entered.
A compiled command using (expr) can refer to many windows, at the risk of encountering an ambiguous window name (i.e., no directory specified when versions of the window are available in two or more directories).
If neither name nor (expr) is specified, the current window is assumed.

Comments

The WINDOW CLOSE command closes the specified window (and any form, display, or menu that is currently open in the window). If the window being closed is active, it is deactivated (removed from the screen) before being closed.

If the window being closed is the current window, the window that last was current becomes current once again.

If the window being closed is the parent of other open windows, the child windows are also closed.

 

See Also

$iswinopen

WINDOW CLEAR

WINDOW DEACTIVATE

WINDOW OPEN

WINDOW SET CURSOR

Sets the location of the text cursor in the current window. Determines whether the cursor can move outside unprotected fields in the current window.

Syntax

WINDOW SET CURSOR option

Parameters

option

Option can be
row col
Where row and col are integers or expressions that evaluate to integers.
Row identifies the character row in which the text cursor is to be positioned; col identifies the character column in which the text cursor is to be positioned. Valid values are 1 through the maximum number of rows or columns within the current window’s logical dimensions. Complex expressions must be enclosed in parentheses.
PROTECTED
Specifies that the text cursor must always be associated with an object in the window.
UNPROTECTED
Specifies that the text cursor can move anywhere within the window’s presentation space. Applies to Zim Version 4 windows only.

Comments

To position the focus on an object in a window based on its location, you can use WINDOW SET CURSOR row col. The common means of placing the focus is FORM SET FOCUS where the object is identified explicitly.

 

See Also

$CursorCol

$CursorRow

$CursorScreenCol

$CursorScreenRow

CURSOR

ThisWindow

WINDOW SET CURRENT

MENU CLEAR

Resets menu item values to their defaults.

Syntax

MENU CLEAR object

Parameters

object

Can be
menu
The name of a currently open menu, all of whose items are to be cleared.
menuitem
The name of a particular menu item to be cleared.
([exp1 ],[exp2 ],[exp3 ])
Positive integers or expressions that evaluate to positive integers, that identify a particular menu or menu item. Exp1 identifies the menu number; exp2, the item number. (Exp3 is reserved for future use.) Exp1, exp2, and exp3 must be positive integers or expressions that evaluate to positive integers. At least one of exp1 or exp2 must be specified.

Comments

MENU CLEAR resets each of the specified items within the open menu in the current window to their default values, as specified when the objects were defined in the Object Dictionary. The menu or menu items do not change in appearance until redisplayed using a MENU DISPLAY command.

If an item in the menu is currently in an invalid state owing to application user input, the MENU CLEAR command that applies to that item clears the invalid state.

Note that when a menu is opened (by a MENU OPEN command), all menu items are set to their default values.

Example

To reset all items in Menu1 to their default values, enter

menu clear Menu1

 

See Also

FORM CLEAR

MENU DEFINE

ThisMenu

MENU OPEN

Opens a menu in the current window.

Syntax

MENU OPEN object [NOCLEAR]

Parameters

object

Object can be
name
The name of the menu to be opened.
(expr )
A character string, or an expression that evaluates to a character string, to be used at run time as the name of the menu. Using expr enables one MENU OPEN command to specify different menus, at the risk of encountering an ambiguous name. MENU OPEN (expr) cannot be used to open menus defined in a foreign directory.

NOCLEAR

Specifies that the values currently assigned to the menu items are to be retained. (If NOCLEAR is not specified, each field is set to its default value when the menu is opened.)

Comments

Each open window that is not clipped can have a menu. The menu remains open as the current menu in its window until a MENU OPEN, MENU CLOSE, or WINDOW CLOSE command is executed for the window.

MENU OPEN does not display the menu or request input from the user; it initializes the menu for use. The menu is displayed using the MENU DISPLAY command and input is requested using the MENU INPUT or FORM INPUT command (if a form is open in the window).

Pre-defined menu attributes can be changed dynamically using the MENU SET (Attributes) command.

 

See Also

ThisMenu

FORM CLEAR

Resets form field values to their defaults.

Syntax

FORM CLEAR object

Parameters

object

 

Can be:

Form
The name of a currently open form or display, all of whose fields are to be reset. Specify a particular instance of a form in brackets beside the object’s name.
formfield
The name of a particular field that is to be reset in a currently open form or display. Specify a particular instance of a form field in brackets beside the form field’s name.
([exp1 ],[exp2 ],[exp3 ])
Positive integers or expressions that evaluate to positive integers, that identify a particular form or form field to be cleared. Exp1 identifies the form number; exp2, the field number; exp3, the instance of the form or form field in the display. At a minimum, either exp1 or exp2 must be specified.

 

Example

add Customers from fCustomer
form clear fCustomer

Resets the values of all form fields in the fCustomer form to their default values after saving their current contents in an EntitySet called Customers.

form clear fMyForm[5]
form clear (2,,5)
The preceding two commands both reset the values of all form fields in the fifth instance of form number 2, called fMyForm.
form clear fMyForm.LastName

Resets all instances of a certain form field in a form.

SeeAlso

DISPLAY DEFINE

FORM OPEN

MENU CLEAR

THISFORM

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.

pt_BRPortuguese