$Graphics

The name of a graphics software package.

Syntax

$graphics

Return Value

A character string. Can be reset by an application program.

Description

Set by the application program to the name of a graphics program.

$Graphics can be set to the name of a graphics program of your choosing. The name should include the full disk path. The special file path indicator characters can be used.

The GRAPH command automatically calls up the program named in the $Graphics system variable.

When running ZimTC, the following code will simply copy the “xxx.zzz” to the client side without executing any further actions:

let $graphics = ""
graph "xxx.zzz"

Example

let $graphics = "c:chartappchart.exe"

See Also

$ClipPath

$DBPath

$Editor

$ImagePath

$WorkPath

$ZimPath

About Character Literals

GRAPH

System Variables

$direction

Indicates the direction in which focus was moving when an event occurs.

Syntax

$direction

Return Value

A number (-1, 0, or +1.) Can be reset by an application program.

Description

The direction of travel of focus when an event occurred.

ValueMeaning
-1“Backward” direction. The focus was moving backward (with respect to the current TABORDER) when an event occurred.
0No direction. The focus is not moving.
+1“Forward” direction. The focus was moving forward (with respect to the current TABORDER) when an event occurred.

See Also

FORM INPUT

MENU INPUT

System Variables

WINDOW SET

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

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

+ (Add/Positive)

Indicates a positive value (unary +) or adds two values.

Syntax

[expression1]+expression2

The plus sign (+) adds the expression on the right to the expression on the left.

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

^ (Exponent)

Raises one value to the power of another.

Syntax

expression1 ^ expression2

The circumflex (^) raises the expression on the left to the power of the expression on the right. If the circumflex is not available on your terminal, substitute two asterisks (**).

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

$ (Template line join)

In a template program, indicates that the next line is to be joined to the current line at the output destination.

Syntax

linestart «$
linecontinue »

where

linestartany portion, from the beginning, of an output line
linecontinuethe remaining portion(s) of the same output line

Comments

In a template program, the dollar sign ($) indicates that the next line is to be joined to the current line at the output destination.

Normally, each physical line in a template is sent as a separate line to the current output destination. To cause successive physical lines in a template to be joined into one line in the output, end the appropriate lines in the template with the dollar sign ($).

If a line must end with a dollar sign for some other reason, ask the software to interpret the dollar sign by placing a backslash ( – Escape) preceding the dollar sign.

#(Macro call)

Marks a call to a macro in an application program.

Syntax

#<macroname>

where

macronameThe name of a global or local macro.

Return Value

A macro call returns the current value of the macro or the null string (”).

Comments

This command calls a particular macro in an application program.

A macro is a dynamically declared name that represents a character string. When a macro call is encountered in an application program, the macro call is replaced by the current character value of the macro.

A macro acquires values in one of two ways: implicitly, when the software encounters a call to a previously unknown global macro or unassigned local macro, or explicitly, in a LET or INPUT statement or a call to a local macro.

Programs with macro references cannot be compiled because the macros take the current references at the time of the compilation.

Example

Example of Using # (Macro call) and <> (Macro name delimiters)

let  = "ENT"

Defines the global macro to represent the string ENT. Then the statement

list #s format #Name

is interpreted as

list ENTs format ENTName

_ (Wildcard)

Used with the LIKE operator to construct patterns for matching.

Comments

Used with the LIKE operator in logic expressions, the _ wildcard matches any single character when the pattern on the right is compared to expression.

Example

"_ob%"

Matches any character string whose second and third letters are ob, followed by zero or more characters (i.e., “Robert”, “Bob”, “Cobbler”, etc.).

compute Employees where LastName like "_a%n"

Processes all records whose LastName values are three characters or more, the second character being an a and the last character being an n.

Grade like "100\%"

Shows the per cent sign being used literally in a string. (The first backslash “escapes” the second backslash, which, in turn, “escapes” the per cent sign, turning it into a literal character.)

find Parts where PartDesc like "%\\%"

Finds PARTS whose part description contains a backslash.

FirstName like $concat("S_e%p",SuffixVariable)

Assuming that SuffixVariable is “%”, then the above expression is logically true if FirstName matches the pattern “S_e%p%”.

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.

pt_BRPortuguese