MeadCo.ScriptX.Print.PDF
MeadCo.ScriptX.Print.PDF
A static class providing printing of PDF files.
- Description:
MeadCo.ScriptX.Print.PDF
A static class providing printing of PDF files.
Requires:
- meadco-core.js
- meadco-scriptxprint.js
The purpose of these libraries is to assist those with a body of client javascript code targetting use of the ScriptX Add-On for Internet Explorer. These libraries assist with continuing with a large part of the code intact when transitioning to using ScriptX.Services instead/as well.
Includes processing of calls to the print api that return "printing to file" including collecting the file output.
- Source:
Methods
(static) connect(serverUrl, licenseGuid)
Specify the server to use and the subscription/license id.
- Description:
Specify the server to use and the subscription/license id.
Attempt to connect to the defined ScriptX.Services server and obtain device settings for the default device as well as the list of available printers.
This call is not required if client side code doesnt need to know about available printers but can assume. It also is not required if MeadCo.ScriptX.Print.HTML.connectAsync has been called.
This call is synchronous and therefore not recommended. Use connectAsync()
- Source:
Parameters:
Name | Type | Description |
---|---|---|
serverUrl |
string | the 'root' url to the server (the api path will be added by the library) |
licenseGuid |
string | the license/subscription identifier |
(static) connectAsync(serverUrl, licenseGuid, resolve, reject)
Specify the server to use and the subscription/license id.
- Description:
Specify the server to use and the subscription/license id.
Attempt to connect to the defined ScriptX.Services server and obtain device settings for the default device as well as the list of available printers.
This call is not required if client side code doesnt need to know about available printers but can assume. It also is not required if MeadCo.ScriptX.Print.HTML.connectAsync has been called.
- Source:
Parameters:
Name | Type | Description |
---|---|---|
serverUrl |
string | the 'root' url to the server (the api path will be added by the library) |
licenseGuid |
string | the license/subscription identifier |
resolve |
function | function to call on success |
reject |
function | function to call on failure |
(static) connectLite(serverUrl, licenseGuid)
Specify the server and the subscription/license id to use on AJAX calls.
- Description:
Specify the server and the subscription/license id to use on AJAX calls. No call is made in this function
- Source:
Parameters:
Name | Type | Description |
---|---|---|
serverUrl |
string | the 'root' url to the server (the api path will be added by the library) |
licenseGuid |
string | the license/subscription identifier |
(static) print(sUrl, fnCallOnDone, fnCallback, data) → {boolean}
Print the document obtained by downloading the given url, use the current settings to control the rendering.
- Description:
Print the document obtained by downloading the given url, use the current settings to control the rendering.
- Source:
Parameters:
Name | Type | Description |
---|---|---|
sUrl |
string | the fully qualified url to the PDF document to be printed. |
fnCallOnDone |
function | function to call when printing complete (and output returned), arg is null on no error, else error message. |
fnCallback |
function | function to call when job status is updated |
data |
any | object to give pass to fnCallback |
Returns:
- true if a print was started (otherwise an error will be thrown)
- Type
- boolean
(static) resetSettings()
Reset the soft settings to use when printing PDF content to default.
- Description:
Reset the soft settings to use when printing PDF content to default.
- Source:
Type Definitions
BooleanOption
Enum to describe a boolean value or use the default
.- Description:
Enum to describe a boolean value or use the default
- Source:
Properties:
Name | Type | Description |
---|---|---|
DEFAULT |
number | 0 use the default at the print server |
TRUE |
number | 1 |
FALSE |
number | 2 |
Enum to describe a boolean value or use the default
Type:
- number
PageOrientation
Enum to describe the orientation of the paper
.- Description:
Enum to describe the orientation of the paper
- Source:
Properties:
Name | Type | Description |
---|---|---|
DEFAULT |
number | 0 use the default at the print server |
LANDSCAPE |
number | 1 |
PORTRAIT |
number | 2 |
Enum to describe the orientation of the paper
Type:
- number
PdfPageScaling
Enum to describe the page scaling to perfor,
.- Description:
Enum to describe the page scaling to perfor,
- Source:
Properties:
Name | Type | Description |
---|---|---|
UNDEFINED |
number | Not specified (ShrinkToFit is used instead) |
NONE |
number | No scaling |
FITTOPAPER |
number | Scale up to fit to paper if document is smaller than the paper |
SHRINKLARGEPAGES |
number | Only scale to fit oversized pages |
Enum to describe the page scaling to perfor,
Type:
- number
PdfPrintQuality
Enum to describle the print quality of images
.- Description:
Enum to describle the print quality of images
- Source:
Properties:
Name | Type | Description |
---|---|---|
NORMAL |
number | Normal quality |
HIGH |
number | High quality |
LOSSLESS |
number | Highest quality |
Enum to describle the print quality of images
Type:
- number
Settings
The soft settings to use when printing PDF content - options controlling the rendering of the content.
- Description:
The soft settings to use when printing PDF content - options controlling the rendering of the content. (Device settings such as papersize, printer are described with MeadCo.ScriptX.Print.deviceSettings)
- Source:
Properties:
Name | Type | Description |
---|---|---|
jobDescription |
string | Optional description for the print which will be used as the jobname in the printer queue |
pageRange |
string | The rage of pages to print. Empty means all, or from-to or comma delimited sets of from-to |
shrinkToFit |
BooleanOption | Shrink the PDF page to fit the paper, optional true by default |
pageScaling |
PdfPageScaling | If given then shrinkToFit is ignored and this scaling is used. |
autoRotateCenter |
BooleanOption | Indicates whether pages should be rotated to fit on the paper and centered. If this parameter is not given then it will be set to true if shrinkToFit is true or pageScaling is FITTOPAPER. |
orientation |
PageOrientation | Required oritentation on the printed paper |
monochrome |
boolean | Specifies if monochrome printing should be used. This option is known not to work with some HP printers due to issues in HP print drivers. |
normalise |
boolean | Indicates whether or not the pages should be processed to ensure drawing operations are at the expected positions. This option may assist if documents do not print as required. |
The soft settings to use when printing PDF content - options controlling the rendering of the content. (Device settings such as papersize, printer are described with MeadCo.ScriptX.Print.deviceSettings)