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
The error severity level generated by the last command executed.
Syntax
$errlevel
Value
A number (0 to 4.) Can be reset by an application program.
Description
The error severity level of the most recently executed command.
| Value | Meaning |
| 0 | No error. |
| 1 | Information message. |
| 2 | Warning. |
| 3 | User error. |
| 4 | System error. |
See Also
$ErrCode
$LastErrLevel
$MaxErrLevel
System Variables
Indicates the Zim:X product currently being used.
Syntax
$zimproduct
Return Value
A number according to the description below. Cannot be reset by an application program.
Description
| Value | Product |
| 2 | ZimPrompt |
| 9 | ZimServer |
| 12 | ZimQTC |
See Also
$ZimOS
$ZimVersion
The error severity level generated by the last command that returned an error severity level.
Syntax
$lasterrlevel
Value
A number (1 to 4). Can be reset by an application program.
Description
The error severity level of the most recently executed command that returned an error severity level other than 0 (success).
| Value | Meaning |
| 1 | Information message |
| 2 | Warning |
| 3 | User error |
| 4 | System error |
See Also
$ErrCode
$ErrLevel
$LastErrMessage
$MaxErrLevel
System Variables
Indicates the character set used by the application database.
Syntax
$dbcharset
Return Value
2 for ANSI or 3 for UTF-8, depending on the character set specified when the database was initialized. Cannot be reset by an application program.
Description
When you initialize a new application database, the database (ZIMBOOT) administrative utility requires you to specify the character set to be used. Once the database has been initialized, the character set cannot be changed.
During an application session, the $DBCharSet system variable contains the name of the character set used by the current application database.
Example
ANSI is a Zim constant with a value of 2, so you could use the following:
if $DBCharSet = ANSI
...
endif
See Also
SET DOCUMENT FORMAT
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
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.
| Value | Meaning |
| -1 | “Backward” direction. The focus was moving backward (with respect to the current TABORDER) when an event occurred. |
| 0 | No 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
The number of records found by the last FIND command.
Syntax
$setcount
Return Value
A number. Can be reset by an application program.
Description
The number of records in the result set produced by the most recent FIND command.
Example
find Students where GradePt = 4.00
Produces a set of Students whose GradePt is 4.00. If the set contains three students whose grade point average is 4.00, then $SetCount would be set to 3.
See Also
$lastmember
$MemberCount
System Variables
Syntax
$ProgramFileName
Return Value
Character string (varalpha). Cannot be reset by an application program.
Comments
Contains the file system name of the disk file that contains the currently executing program. AREAS.ZIM or DIRS.ZIM entries that apply to the file are expanded, as are the special prefix characters (i.e. #,),^,~,”).
See Also
$filepath
The size of the terminal screen in character columns.
Syntax
$screenwidth
Value
A number. Cannot be reset by an application program.
Description
$ScreenWidth gives the width of the terminal screen in character columns.
In graphic environments, the number of columns depends on the font and point size used in the application window (BACKSCREEN).
See Also
$ScreenHeight
System Variables
ThisWindow
English 
Portuguese