FileName

The operating system name of a file or an input/output device. The file or device that the document represents.

Valid Values

Up to 256 alphanumeric and special characters (see "Remarks", below, for details)

Remarks

Files

FileName can refer to a file that already exists, or it may contain the name of a file that the application will create.

A number of special prefix characters are available to denote particular operating system directory locations for files, as described below:

Prefix

Meaning

)

The file is located in the work directory (a "per user" file)

#

The file is located in the directory named in the ZIM= entry in the [ZIM] section of the ZIM.INI file (found in the Windows directory). This directory is normally the directory in which you installed Zim

"

The file is located in the database directory. The database directory is the default location for most Zim files; this special prefix is typically used with foreign directories

^

The file is located in the directory named in the IMAGEPATH= entry in the [ZIM] section of the ZIM.INI file (found in the WIndows directory). The image directory can be specified in the Screen Painter as the location for any supported image file type (e.g., bitmaps, icons, metafiles)

~

The file is located in the directory named in the CLIPPATH= entry in the [ZIM] section of the ZIM.INI file (found in the WIndows directory). The clip directory is used by the Screen Painter to store files involved in Cut, Copy, and Paste operations

 

See Distributing Database Files for more information on how to distribute files in a Zim database.

Devices

FileName can refer to an input/output device connected to your computer.

A number of special keywords are available to refer to standard devices known to the operating system. These keywords can be used in place of specific device names in the FileName field. The keywords and the device each represents are described below:

File Name

Meaning

$console

The terminal from which the application is being run

$stdin$

Standard input device as defined by the operating system

$stdout$

Standard output device as defined by the operating system

$stderr$

Output is directed to the ZimTrace window if the ZIMTRACE utility program is running. The window accumulates, displays, or logs the output to a file. If ZIMTRACE is not running, the output is discarded

$clipboard

Standard clipboard as defined by MS-Windows

 

See Also

Foreign