PRINTFILE()

From Recital Documentation Wiki
Revision as of 10:13, 23 March 2009 by Yvonnemilne (Talk | contribs)

Jump to: navigation, search

Class

Printing


Purpose

Used to provide client-side printing for Windows Recital Mirage clients


Syntax

PRINTFILE(<expC1>[,<expC2> [ , <expC3> ] ] )


See Also

SET PRINTER, GETENV()


Description

The PRINTFILE() function is used to provide client-side printing for Windows Recital Mirage clients. When the PRINTFILE() function is called, the Windows Print Dialog will be displayed allowing the user to select a printer before printing the specified file.


Keyword Description
<expC1> The full path name of the file to be printed. The <expC1> can also contain printing options. See below for available options
<expC2> Optional header text to be displayed on each page of the printout.
<expC3> Optional footer text to be displayed on each page of the printout.


Printing options are separated from the file name by a question mark '?' and have an option=value syntax. The second and subsequent options must be preceded by an ampersand '&'. The options can include the following:


Option Description
autoNumber If set to true, the file printout will include line numbers.
bottomMargin Bottom margin in pixels.
font Font definition, e.g. font=Helvetica,plain,10
fontBold If set to true, font will be bold.
fontItalic If set to true, font will be italic.
fontSize Font size.
leftMargin Left margin in pixels.
tabs Number of spaces per tab.
topMargin Top margin in pixels.


Header and footer text is made up of three comma-separated sections. Text preceding the first comma is printed left justified on the page. Text following the first comma (and preceding the second) is printed centered on the page. Text following the second comma is printed right justified on the page. The header and footer text can also contain special options:


Option Description
{DATE} Replaced in the header or footer text with the current system date.
{FILE} Replaced in the header or footer text with the file name.
{PAGE} Replaced in the header or footer text with the current page number.


If "&printfile('%s')" is placed in the Recital Mirage Server DB_PRINT environment variable, then SET PRINTER TO \\SPOOLER will automatically print the spooled file to a client-side printer after displaying the Windows Print Dialog allowing the user to select the printer that they want to print on.

putenv("DB_PRINT","&printfile('%s')")


Example

printFile("c:\Program files\Recital\UAS\Mirage\Mirage_demo\mirage_demo.prg" + ;
"?tabs=4&topMargin=50&autoNumber=true",;
"{FILE},,{DATE}",",-- Page {PAGE} --,")


Products

Recital Mirage Server