* (Multiply)

Multiplies one value by another.

Syntax

[expression1]*expression2

The asterisk (*) multiplies the expression on the left by the expression on the right.

Parameters

expression1a number or expression that evaluates to a number
expression2a number or expression that evaluates to a number

Comments

Arithmetic operators indicate the sign of a number or perform arithmetic operations (addition, subtraction, multiplication, division, exponentiation).

See Also

About Arithmetic Expressions

Rules of Precedence for Arithmetic Operators

$atan

Calculates the arctangent of a number.

Syntax

$atan(number)

Parameters

numbera number, or an expression that evaluates to a number

Return Value

Number, with the same number of decimal places as number.

Comments

Use $atan to calculate the arctangent (in radians) of a number. The value returned by this function has the same number of decimal places as number.

Example

let vAngle[1] = $atan(0.500)

The preceding command sets the first element of array variable vAngle to 0.464.

See Also

$acos

$atan2

$tan

$tanh

About Functional Expressions

$CursorRow

The location of focus in a window when an event occurs.

Syntax

$cursorrow

Return Value

A number which is the row location for focus of the current window at the time of an event. Can be reset by an application program.

Description

The number of the character row where focus was located within the current window at the time of an event . If focus is on an entry field, $CursorRow gives the position of the text cursor.

Example

To output the row and column position of focus in window wMain when an event occurs:

window open wMain
form open Form1
form display input
output $cursorrow $cursorcol

See Also

$CursorCol

$CursorScreenCol

$CursorScreenRow

CURSOR

FORM INPUT

System Variables

DDEConnect

DDEConnect

Sets up the access to the remote application.

Syntax

DDEConnect ( out tErrCode,
             out tServ,
             in dde_app,
             in dde_topic)

Parameters

tErrCode

A returned error code. It must be a longint.

tServ

The returned connection handle. It also must be a longint.

dde_app

A string containing the application name.

dde_topic

A string containing the topic name.

Comments

The procedure is supplied with the application name and topic name (usually the document name). DDEConnect assigns a connect handle to the “tServ” variable to be used in subsequent commands. DDEConnect is compiled.

The filename is ddeconn.pgm.

Example

For example, given that DDE_Err and hServ are of type longint:

DDEConnect (DDE_Err, hServ, ‘excel’, ‘sheet1’)

starts a conversation with Microsoft EXCEL. The topic of the conversation is the spreadsheet ‘sheet1’. In this case, EXCEL must be started and ‘sheet1’ opened beforehand.

$fileprint

Prints a text or bitmap file.

Syntax

$fileprint(filename[,filetype])

Parameters

filenamea character string or an expression that evaluates to a character string
filetypea number that determines if the file is a text file (0) or a bitmap file (1)

Return Value

The $fileprint function returns “1” ($True) if no errors were detected before the print job was submitted. Otherwise, it returns “0” ($False).

Comments

Bitmap printing is available only in the Windows environment.

PRINT

Prints the contents of a window or application document.

Syntax

PRINT name

Parameters

name

The name of a window (GUI environments only) or application document.

Comments

If name identifies a window, the window must be open and activated. The visible portion of the window is sent to the current output destination as a bitmap. Bitmap output can be produced in a GUI environment only.

If name identifies an application document, the application document is sent to the current output destination as a text file.

 

See Also

$getproperty

$printersetup

$screenprint

$setproperty

FORM REPORT

SET OUTPUT

/ (Divide)

Divides one value by another.

Syntax

[expression1]/expression2

The oblique (or slash, /) is the division operator. It divides the expression on the left by the expression on the right.

Parameters

expression1a number or expression that evaluates to a number
expression2a number or expression that evaluates to a number

Comments

Arithmetic operators indicate the sign of a number or perform arithmetic operations (addition, subtraction, multiplication, division, exponentiation).

See Also

About Arithmetic Expressions

Rules of Precedence for Arithmetic Operators

$ZGroupID

The application user’s Zim group identifier.

Syntax

$zgroupid

Return Value

The group identifier of the user specified in the last successfully executed LOGIN command. Cannot be reset by an application program.

Description

Upon successful execution of a LOGIN command, $ZGroupID is set to the specified user’s group identifier.

Although you can change the value of this variable, you cannot change the effect of the LOGIN command. The current user continues to be treated according to the GroupID and UserID associated with the UserName given in the last LOGIN command.

When you call up any Zim system (full, Runtime, etc.), the software automatically attempts to log you in as a user called ZIM.

See Also

$GroupID

$UserID

$ZUserID

$CursorCol

The location of focus in a window when an event occurs.

Syntax

$cursorcol

Return Value

A number which is the column location for focus of the current window at the time of an event. Can be reset by an application program.

Description

The number of the character column where focus was located within the current window at the time of an event. If focus is on an entry field, $CursorCol gives the position of the text cursor.

Example

To output the row and column position of focus in the current window when an event occurs:

window open wMain
form open Form1
form display input
output $cursorrow $cursorcol

See Also

$CursorRow

$CursorScreenCol

$CursorScreenRow

CURSOR

FORM INPUT

MENU INPUT

System Variables

pt_BRPortuguese