|
Optional Settings
FILENAME.CFG
This file is optional. It's usually created by your application with the file to print, but you can also create it with NotePad. This is a simple ascii file, without .ini format
Without this file, or some rows in it, PRINTFIL will use default values.
The FILENAME is the same as the file which Printfil is currently printing, including path. The extension must be .CFG.
For example, if in PRINTFIL.INI FileName=C:\Spool\file*.txt, and Printfil is currently printing file0001.txt, then this file must be named C:\Spool\file0001.cfg
It can have 13 rows:
1) PRINT NAME
This is a description that will be displayed on the title of the preview window (if it exists) and in the list of pending spooler processes.
The default value is "Preview" (in your local language)
2) NUMBER OF ROWS | CUTROWS
If present, this setting overrides the Rows setting in the Printfil.ini file.
Optionally you can set a second parameter, separated by a "pipe" ("|" , ascii 124) to override also the CutRows setting in the Printfil.ini file
For example, if your source app. is printing to 16" sheets (96 lines), where the first 12" (72 lines) are containing an Invoice and the remaining 4" (24 lines) are used for a separate band, you can set this row in the CFG file as:
72 | 24
to obtain only the Invoices printed on A4 sheets, without having to modify the source application.
3) NUMBER OF COLUMNS
If present, this setting overrides the Columns setting in the Printfil.ini file.
If you insert 0 (zero) in this row, PRINTFIL will use the maximum value found in the first page to print, independently by the value stored in the Printfil.ini file
4) BACKGROUND FILE
This is the name of a graphics background file to be included on every page of the print job.
If the file is .BMP, you can also add some parameters to control its dimensions and position on the pages. See Chapter 6.
5) NUMBER OF COPIES
This is the number of copies of the document PRINTFIL will print.
If it’s not specified, the default value is 1.
If the Choose=.T. in PRINTFIL.INI (or in the 8th row in this file, see below), the number of copies PRINTFIL will print is the number specified in the printer setup dialog.
6) PAGE MARGINS
This row can contains the margin settings and the U.M. used (Unit of Measure - Centimeters or Inches), separated by commas, as follows:
U.M., Top, Left, Bottom, Right
If the row is present this margins will be applyed to the current print-job only.
If the entire row is not present, PRINTFIL will use the default margins (set on PRINTFIL.INI)
If only some values are not specified, PRINTFIL assume them to be 0 (zero). For example: CM,1,0,2,0 and CM,1,,2 are equals.
Please note that is not a good idea to set some margins to zero, because normally all the printers need a minimum margin on each sheet's side to take it (hardware).
7) PRINTER
This is the name of the Windows printer to use to send this print-job only.
This works only if Printfil is configured to not ask the user for the desired printer ( Choose=.F. - in PRINTFIL.INI or 8th line in this file )
If the row is not present, or it contains an invalid name, PRINTFIL will use the default printer set on PRINTFIL.INI
8) CHOOSE PRINTER
If present, this setting overrides the Choose setting in the Printfil.ini file. See above.
9) PREVIEW
If present, this setting overrides the Preview setting in the Printfil.ini file. See above.
10) NUMBER OF CHARS TO AUTOMATICALLY SET THE ORIENTATION IN LANDSCAPE
If present, this setting overrides the AutoLand setting in the Printfil.ini file. See above.
If you want a single print job to be surely Portrait you can set this value to 9999. If you want it surely Landscape you can set this row to 1. Setting it to 150 means that if the job is 150 columns wide, it will be Portrait, while if it's wider, it will be automatically Landscape oriented.
11) RAW
If present, this setting overrides the RAW setting in the Printfil.ini file. See above.
It's usually used in combination with the row 7 to send complex jobs to dedicated printers or to print very fast to dot-matrix printers.
12) E-MAIL
If present, this raw is used to send the print job via e-mail in PDF format. Please see Chapter 10.
It can contains 4 values, separated by "pipes" ("|" , ascii 124)
Show | e-mail | Subject | Body
- Show = .T. (true) or .F. (false) - Whether to show the e-mail message to the user before being sent. If it's .T. and the user don't click the Send button, the message will be closed without being sent.
- e-mail = Destination address. If not provided, Show is always assumed as .T. , so that the end user can insert it before sending the e-mail.
- Subject = Mail subject.
- Body = Mail body. It can be a simple text or a file name (with optional path) containing the text. If a file name is specified, and the file exists, then it's content will be used as mail body.
Either the subject or the Body will be converted in Ansi / Oem format, depending by the AnsiConv setting in Printfil.ini
Please note that even though setting this row simply as .F. is sufficient to tell Printfil the PDF file should be sent by e-mail, if you want to send it without user intervention, you have at least to specify it as .F.|user@domain.com , otherwise the e-mail message will be shown on screen.
Even thought now this raw is used only when Printfil is set to print to its own virtual printer, don't insert it if you don't want to send the job via e-mail because in future Printfil versions it may be used in other cases also.
EXAMPLES
- T. - After the job will be printed as a PDF file, an e-mail message will be automatically shown to the user. The user can complete the message and send it or not.
- F.|user@domain.com - After the job will be printed as a PDF file, it will be automatically sent to user@domain.com without user intervention
- F.|user@domain.com|My Subject|My Body - After the job will be printed as a PDF file, it will be automatically sent to user@domain.com without user intervention, with subject "My Subject" and body "My Body"
- T.|user@domain.com|My Subject|C:\Path\MyBodyText.txt - After the job will be printed as a PDF file, it will be shown to the user, who has then to choose whether to send it or not. The message is already filled with the destination address user@domain.com, subject "My Subject" and the content of the C:\Path\MyBodyText.txt file as body.
13) PDF FILE NAME | OPEN
If you are creating a PDF file without user intervention through the "Printfil" virtual printer (Please see Chapter 9), you can insert the destination file name in this row, with an optional path and extension.
If the PDF is created succesfully, you can also choose to automatically open it by using the standard PDF reader (for example Acrobat Reader)
- If you don't specify a path, the PDF file will be created in the current directory
- If you don't specify an extension, .PDF will be added to the specified file name
- If you'll specify an extension different than .PDF, it will be changed to .PDF
- If you don't specify nothing, the PDF file will be named as the corresponding TXT file, with .PDF extension
For example: If the spool file name is c:\spool\printfil.txt , then the corresponding PDF file will be created as c:\spool\printfil.pdf
After the file name you can optionally insert a parameter (.T. or .F.), separated by a "pipe" ("|" , ascii 124), to open the newly created PDF file by using the standard PDF reader.
EXAMPLES
- c:\spool\MyFile - The PDF file will be named c:\spool\MyFile.pdf, independently by the name of the ascii spool file.
- c:\spool\MyFile.pdf|.F. - Same as above.
- c:\spool\MyFile.pdf|.T. - After creating the c:\spool\MyFile.pdf file, it will be automatically opened by using the standard PDF reader.
- |.T. - The PDF file will be named as the corresponding TXT file, with PDF extension. After creating the PDF file, it will be automatically opened by using the standard PDF reader.
|
