70
CITIZEN UWP POS Print SDK - Programming Manual
2.4.
Notes
Notes of this SDK are as follows.
2.4.1. Function to detect the completion of printing
In this SDK, after the printing output, the SDK waits for the printing completion reply from a printer and
judge the success / failure of the method.
The function to detect the completion of printing is processed in the following cases.
(1)
At the time of completion of transaction processing (TransactionPrintAsync method)
(2)
At the time of completion of page mode (PageModePrintAsync method)
(3)
At the time of data output of the methods except during the buffering process in transaction or page
mode
The function to detect the completion of printing need a few time to wait for the response from the printer.
If you want to print multiple methods continuously, transaction processing (TransactionPrintAsync
method) can makes printing smooth.
Timeout to the end of printing is decided by its contents automatically.
Some print data makes timeout error, every time. In such case, use
SetPrintCompletionTimeout method
modify timeout by its printing time.
2.4.2. Log function
This SDK supports the log function which records the methods and properties. When setting the log
function, please place configuration file "CSJPOSLib.cfg" of the next format in the LocalFolder.
<Example of CSJPOSLib.cfg>
[LogSetting]
... Section name (Fixed)
LogMode=1
... Specifies the log mode.
LogPath=Log
... Specifies the relative path from the LocalFolder to store the log files.
LogMaxSize=10
... Specifies the maximum size of log file in MB.
Setting items
- Log mode
Specifies the mode for recording the log.
0: No Record
1: Recording of access history
2: Error only record
- Store folder
Specifies a folder which log files will be stored. It must be described as relative path from the local
folder. When this setting is not specified, log files will be stored into the local folder.
- Log size
Specifies maximum size of a log file in MB. If 0 is specified, log data will be written without limit.