This property sets the file name and path of the file where the printer settings are saved. These printer settings are used by the ImageKit.
Property Value
The file name (full path)
Explanation
The PrintFileName property sets the file name and path of the file used by the SaveDevModeHandle or SavePrinterInfo method to save the printer settings. (Please set the full path plus file name into this property to avoid malfunction). These printer settings are used by the ImageKit.
As an extension to the PrintFileName property, it's possible to print without changing the settings that have been already set in the printer information file by adding the print number of copies, the printer orientation, and the paper size (in that order) in the back of the file name before executing the PrintCreateDC method. The delimiter for the settings is a semicolon (;). Note: These settings (the the print number of copies, the printer orientation, and the paper size) can be omitted.
the printer orientation: ( ) The explanation contained in the parentheses has the same meaning as the constants used by WindowsAPI.
| Value | Explanation |
|---|---|
| 1 | Vertical (DMORIENT_PORTRAIT) |
| 2 | Horizontal (DMORIENT_LANDSCAPE) |
the paper size: ( ) The explanation contained in the parentheses has the same meaning as the constants used by WindowsAPI.
| Value | Explanation |
|---|---|
| 8 | A3(DMPAPER_A3) |
| 9 | A4(DMPAPER_A4) |
| 12 | B4(DMPAPER_B4) |
| 13 | B5(DMPAPER_B5) |
Enter a zero (0) into the settings that you do not want to change.
Example (Delphi)
If the file where printer information is to be saved is called "IkPrint.Ik":
1. For normal use of the PrintFileName property
printcontrolname.PrintFileName := 'C:\Test\IkPrint.Ik';
2. To use the extending functionality of the PrintFileName property to change the printer settings to
A. Number of copies = 3, Orientation = Horizontal (Landscape), Paper size = B5
printcontrolname.PrintFileName := 'C:\Test\IkPrint.Ik;3;2;13';
B. To print with the number of copies and paper size that has already been set in the printer information file but to change the Orientation setting to Horizontal
printcontrolname.PrintFileName := 'C:\Test\IkPrint.Ik;0;2;0';
Setting this value
This value can be set at runtime.
Retrieving this value
This value can be retrieved at runtime.