* (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

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

RightClick

The right mouse button can be used to generate a RightClick event when a widget has the “RightClick” transmit property. The RightClick transmit property can be set in the Zim Screen Painter. Widgets that have the RightClick property cause FORM INPUT to terminate when they are clicked by the right mouse button. When the RightClick property causes FORM INPUT to terminate, the event structure’s EventName is set to “RightClick”, the Event.EventType is set to formfield ,and the Event.EventTag is set to the tag of the formfield that was clicked on. A right mouse click does not change the current field, and is detected only if it occurs on a widget in the current graphical window.

RightClick Event Information

The $MouseSubscript, $MouseFieldNum and $MouseFormNum variables now contains information about the field that was right clicked upon.

 

See Also

$RightClickMenu

SET EOFVALUE

Specifies an end-of-file indicator for application documents.

Syntax

SET EOFVALUE character_constant|OFF

Parameters

character_constant

Any valid character constant. If encountered during the read of an application document, the string raises an end-of-file condition.

Comments

The EOFVALUE option is set OFF by default (no character is recognized as an end-of-file).

The EOFVALUE option enables you to specify one or more characters that are to be recognized as an end-of-file indicator when the software reads an application document.

When reading input from the terminal as an application document, the software always recognizes a zero-length line as an end-of-file. The software also recognizes real end-of-file conditions, independent of the setting of EOFVALUE.

Example

set eofvalue “xyz”
add DataCollected from SerDevice
set eofvalue off
% batch complete – do something else

Assume that a device attached to your computer has been defined as an application document called SerDevice. The device is collecting data and sending it to your computer in batches that are terminated with a record containing the characters “xyz”. The above commands read the data without waiting between batches.

pt_BRPortuguese