Difference between revisions of "PRINTFILE()"
Yvonnemilne (Talk | contribs) |
Helengeorge (Talk | contribs) (→Class) |
||
| Line 1: | Line 1: | ||
| − | |||
| − | |||
Revision as of 15:44, 28 October 2009
Purpose
Used to provide client-side printing for Windows Recital Mirage clients
Syntax
PRINTFILE(<expC1>[,<expC2> [ , <expC3> ] ] )
See Also
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
