Multiplies one value by another.
Syntax
[expression1]*expression2
The asterisk (*) multiplies the expression on the left by the expression on the right.
Parameters
| expression1 | a number or expression that evaluates to a number |
| expression2 | a 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
The highest error severity level generated during the application session.
Syntax
$maxerrlevel
Value
A number (0 to 4). Can be reset by an application program.
| Value | Meaning |
| 0 | No error. |
| 1 | Information message. |
| 2 | Warning. |
| 3 | User error. |
| 4 | System error. |
Description
The highest error severity level encountered to the current point in the application session.
See Also
$ErrCode
$ErrLevel
$LastErrLevel
$LastErrMessage
System Variables
Calculates the arctangent of a number.
Syntax
$atan(number)
Parameters
| number | a 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
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.
Prints a text or bitmap file.
Syntax
$fileprint(filename[,filetype])
Parameters
| filename | a character string or an expression that evaluates to a character string |
| filetype | a 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.
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
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
| expression1 | a number or expression that evaluates to a number |
| expression2 | a 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
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
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
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.