Home

PDF-XChange Drivers API SDK 2012

Contents

1. Specifies PDF document image compression If this value is True compression methods for different types of images are Graphics ad defined in the subsections for Color Indexed and Mono images Default value True If this property is True textual content of the PDF pages will be compressed Boolean Which reduces the size of the resulting PDF document Text Value Default value True Color Specifies compression for True color images Name Possible values Description Enabled Boolean Value Default value True O Auto ie Ae Specifies compression method to be used for compressing True color images Da ASS MESA Please note when the PDF A specification is used for creating a PDF Sh EES fn IIE file compression methods J 2K and J 2KZIP cannot be used 4 J2K Default value 0 Auto 5S Ne ZP Specifies the image quality when using JPEG compression J PEG and JPEGZIP JPEG lity 1 100 ee paa Higher quality means better image definition and a larger compressed stream so a larger file Default value 75 Copyright 2005 2013 Tracker Software Products Indexed Name Possible values Enabled Boolean Value O Auto Interface IPXCPrinter 24 Description If this property is True Indexed images will be compressed by the method specified by property Method Otherwise they will be stored into PDF without compression Default value True hh CPackButs Method Ze 3 LZW Mono Defines the co
2. This property is only used if the Fit property is False Default value 1000 Boolean Value If this property is True the page is centred on the sheet Otherwise its position is determined by LeftPos and TopPos properties This property is not used when the Fit property is True Default value True Boolean Specifies that the page should be fitted to the sheet Value Default value True When the LayoutType specified is nUP the following properties define how many and in which order pages should be placed on the sheet Name Nup NupOrder Copyright O 2005 2013 Tracker Software Products Possible values O one page per sheet 1 two pages per sheet 2 four pages per sheet 3 six pages per sheet 4 eight pages per sheet 5 nine pages per sheet 6 sixteen pages per sheet O AcrossFromLeft 1 DownFromLeft PAC TOn O EE Ome Load gt Dowie ronkh EO daken Description Defines the number of pages to be placed on one sheet Default value 0 Defines the order in which pages should be placed on the sheet Default value O AcrossFromLeft Interface IPXCPrinter 18 Specifies if a border should be drawn around the pages on the sheet Borders Boolean Value Default value False Booklet When the LayoutType value is Booklet the following properties define the booklet creation parameters Name Possible values Description If the value of this property is Book pages will be grou
3. it will be overwritten si mageFileName Specifies the fully qualified path name to the image file to be used as a watermark The image may be in any of the following supported image formats BMP PNG JNG JPEG JPEG 2000 TIFF J BIG JBIG2 GIF PCX DCX EMF WMF If the image is a multipage image only the first page will be used as a watermark dwTranscolor Specifies the transparent color for the image If this parameter is anything other than 1 each pixel in the sl mageFileName image which has a color specified by the dwTranscolor parameter will be transparent in the PDF file generated dwWidth dwHeight Specifies the dimensions of the watermark The image specified by the slmageFileName parameter will be resized to fit within the specified area and will retain its aspect ratio All other parameters of this method have the same meaning as the corresponding parameters of AddTextWatermark method except of dwFlags parameter which may use two additional flags dwFlags Bit combination integer value which defines how the watermark should be placed and when it should be visible may be a combination of the following flags Bit Value Meaning If specified image will be fit the page parameters dwWidth and 3 250 gwHeight will be ignored 9 512 If specified image will not keep aspect ratio on scaling Return Value The method returns S OK if successful or an error code if it fails Copyright 2005 2013 Tracker Software Prod
4. False PDF XChange Drivers API SDK 2012 41 Interface IPXCPrinter Specifies if italic variant of the font should be used F Tien SAE NEEN LEO SE WEE Default value False Collen colorREF Defines the color of the text Default value 0 black color Defines the text which should be placed into the part Value String Text can contains macros Default value empty string For example to place a red label with the current page number at the right top corner of each page using Verdana Bold font with 12 pt size the following properties should be set C Ll printer Option L HeadersFooters Enabled TRUE 2 printer Option L HeadersFooters Header Right Font L Verdana 3 printer Option L HeadersFooters Header Right FontBold TRUE 4 printer Option L HeadersFooters Header Right FontSize 120 5 printer Option L HeadersFooters Header Right color RGB 255 0 0 6 printer Option L HeadersFooters Header Right Value L Page Page VB 1 With PDFPrinter 2 QOption HeadersFooters Enabled TRUE 3 Option HeadersFooters Header Right Font Verdana 4 Qption HeadersFooters Header Right FontBold Yes 5 Option HeadersFooters Header Right FontSize 120 6 Option HeadersFooters Header Right color 255 1 Option HeadersFooters Header Right Value Page H Page 8 End With Copyright 2005 2013 Tracker Software Products Interface IPXC
5. J obl D parameter which specifies an internal Job identifier of the printed document This ID can be used when multiple documents are printing to determine from which document the event was fired The following events are supported in PDF XChange Driver 2012 Asynchronous Events e Event OnStartDoc is fired when a new document starts to print e Event OnStartPage is fired for each page when it starts to print e Event OnEndPage is fired for each page after it prints e Event OnEndDoc is fired when the complete document is spooled by the GDI Synchronous Events e Event OnDocSpooled is fired immediately when PDF XChange starts processing the document that was printed by the GDI e Event OnFileSaved is fired when the PDF file is saved e Event OnFileSent is fired when emailing of the PDF file was enabled and after the email was sent If emailing is not enabled this event will not fire e Event OnError is fired when an error occurs during the processing of the PDF file PDF XChange Drivers API SDK 2012 69 Interface IPXCPrinter Asynchronous Asynchronous Events The following Asynchronous events are supported in PDF XChange Driver 2012 e Event OnStartDoc is fired when a new document starts to print e Event OnStartPage is fired for each page when it starts to print e Event OnEndPage is fired for each page after it prints e Event OnEndDoc is fired when the complete document is spooled by the GDI Event OnStartDoc This ev
6. TRUE nTextcolor Specifies the text color of the watermark dwAlign Specifies the text alignment on the page When nFontSize is 0 zero this parameter is ignored and the watermark will be centered vertically and horizontally value 9 dwAlign may be a combination any of the following values Bit Value Meaning Oa Horizontal Center Align Right Align Cannot be set when bit O Horizontal center align is set When both bits 0 and 1 are not set Left align used a NAIG Vertical Center align Bottom Align Cannot bit set when bit 4 is set When both bits 4 and 5 are not set Top align used PDF XChange Drivers API SDK 2012 61 Interface IPXCPrinter xOffset yOffset Specify Horizontal and Vertical offsets for the watermark relative to the top left corner of the page Values are specified in tenths of millimeters nAngle Specifies the Rotation angle for the watermark Possible values are from 90 to 90 degrees Positive values mean counterclockwise rotation dwOpacity Specifies the Opacity level of the watermark Value must be in the range of 0 fully transparent to 100 fully opaque If the value is outside of the range it will be clipped dwFlags Bit combination integer value which defines how the watermark should be placed and when it should be visible may be a combination of the following flags Bit Value Meaning hs afl Not used If this bit is set the watermark will be placed as a background on the E pag
7. XChange If this flag is False all other properties from this section will be ignored Default value False Specifies a file with which the newly created PDF will be overlayed The value should be a fully qualified path name for the PDF file Default value empty string If the file specified by the OverlayFile property is encrypted with a valid user password OverlayPassword must contain a valid password for the file Default value empty string Defines where overlay pages should be located Background is the default unless specified Default value False KOPCE AA E Jet ale KE OPS IGE O NoRepeat 1 RepeatLastPage 2 RepeatContinuous Oe l Center Rasen Y Ao 1 Middle 2 Bottom Boolean value Boolean value Interface IPXCPrinter 36 Specifies the repeat option for overlaying Meaning of values O NoRepeat Do not Repeat begin at the start of the overlay file and apply each corresponding page from this file to the corresponding page number in the newly generated PDF file Should the newly created file have a greater number of pages than available in the overlay file no overlay is applied to the remaining pages created in the newly generated PDF document 1 RepeatLastPage Apply the PDF overlay file pages to the corresponding pages on the newly generated PDF file should the newly created file have a greater number of pages apply the last page of the overlay file
8. be downsampled Name Possible values Description O None Specifies which method should be used for downsampling e If the value of this property is 0 None images of this type will not Method Be be downsampled 3 Bicubic Default value O None These two properties define when an image should be downsampled ng A Default value 96 If the original DPI of the image is equal to or above that of the value specified by the property IfAbove the image will be downsampled to O the DPI specified by the property To Default value 128 PDF XChange Drivers API SDK 2012 27 Interface IPXCPrinter ndexed Convert Specifies whether indexed images should be converted to grayscale monochrome or black amp white Name Possible values Description 0 None Specifies how images of this type should be converted ABG CE Value 0 None means that no images of this type will be MAGA more 2 ToMonochrome converted 3 ToBlackAndWhite Default value O None Specifies whether images should be dithered during conversion This has meaning only for methods ToMonochrome and Dither Boolean Value ToBlackAndWhite Default value True MonoAndDrawings This section determines settings for downsampling and converting monochrome images and black amp white drawings e Subsection Downsample defines when and how images should be downsampled e Subsection Convert specifies whether mono or black amp white images should be conv
9. email account to use for the From email property Specifies various recipient s of the email If more than one recipient is specified they should be separated by the semicolon character Each recipient can be specified as recipient name for example John Smith and the email address will be resolved from the email client s address book email address for example john server com or as a combination of name and address John Smith lt john server com gt Default values empty string Defines the subject string for the email Default value empty string PDF XChange Drivers API SDK 2012 47 Interface IPXCPrinter Content String AP Server Boolean value String Defines content of the emall Default value empty string Specifies how the PDF file should be added as an attachment to the email When True the PDF file should be sent as a ZIP archive When False the PDF file should be sent as the original PDF file Default value True send as ZIP archive Specifies the name of the SMTP server for sending email This property is used only when the Method property has the value SendViaSMTP The SMTP server must be defined using AddSMPTServer method Default value empty string Copyright 2005 2013 Tracker Software Products Optimization Interface IPXCPrinter 48 This section controls Optimizations of the generated PDF file Name Blending DeTesselation WS SOE Possible values D
10. in DWoRD dwFlags VB Sub ApplyOptions dwFlags As Long AddBookmarkltem Method AddBookmarkl tem Method AddBookmarkl tem adds a new item into the bookmarks template tree Returned value from this method can be used for subsequent calls of this method Declaration C int AddBookmarkltem int nParent int dwDetectFlags string sDet FontName int nDet FontStyle int nDet Size int nDet SizeDelta int nDet Textcolor int dwDisplayFlags int dwDisplaycol or Copyright 2005 2013 Tracker Software Products C HRESULT AddBookmarkltem in long nParent in long dwDetectFlags in BSTR sDet Font Name in long nDet FontStyle in long nDet Size in long nDet SizeDelta in long nDet Textcolor in long dwDisplayFlags in long dwDisplaycolor out retval long pID VB Function AddBookmarkitem nParent As Long dwDetectFlags As Long sDet FontName As String nDet FontStyle As Long nDet Size As Long nDet SizeDelta As Long nDet Textcolor As Long dwDisplayFlags As Long dwDisplaycolor As Long As Long Parameters nParent Interface IPXCPrinter 56 Specifies the parent ID of the item to be created This could be a value returned from a previous call to this function or 1 if the item should be a top level item dwDetectFlags A bit combination integer value which specifies which properties of the body text are to be used to match it as a bookmark item A combination of the following va
11. installer contains all the required driver options required for all versions of Windows from Windows 2000 through to Windows 7 and all points in between both 32 and 64 bit Developers may either pack the provided installer within their own installation package or provide separately and simply call from their own installer script using the extensive command line switches provided below The latest PDF XChange Driver for redistribution purposes is always available from our web site Or from this link http www tracker software com PDFX5SA sm zip Please note it is a required that you use the above installer and do not attempt to reverse engineer or de compile and create your own if you are not willing to adhere to this specific condition you should not use the PDF XChange Driver within your application PDF XChange Drivers Silent Installation This functionality is provided for users with multiple licenses and Developer SDK s not for single end user licenses to be copied to multiple machines which is illegal A license is required for each machine to which PDF XChange is installed except for the Developer s SDK and evaluation use in demonstration mode Assuming you have a multiple user license installing PDF XChange to many workstations it may be useful to be able to silently install without the need for any user interaction This allows you to execute the install either from the command line with certain paramet
12. nn in minutes the PDFSaver4 module of the PDF XChange driver will unload Useful when installed on a Windows Terminal Server or Citrix Metaframe server with multiple Users to minimize memory in use when PDF creation is not being used by a user will automatically reload when required MAAMO ac Strictly speaking Autounload is not a component but a default setting parameter mainly used in Citrix Metaframe or Terminal Services installations to minimize memory use on a server where PDFSaver4 exe could be loaded multiple times Allows the license key to be registered during silent installation for live use Without this information PDF XChange will function in demo mode only MS DIA AEN DEN Allows the registered username to be registered during silent installation Were ese ema Nam Allows the Company details to be registered during silent installation Organization Tracker software Sets PDF XChange to be the system default Printer the default option without this entry is that PDF XChange will not be the default printer Sets the PDF XChange printer name as required the default option without this entry is currently PDF XChange 5 0 PName PDF XChange for my application Please note that the string content must begin and end with double quote marks Allows the users email address details to be registered during silent installation UserEmail my email com Installation 8 Sets a l
13. to enable faster file processing Name Enabled HasUserPassword HasOwnerPassword UserPassword OwnerPassword Possible values Boolean Value Boolean Value Boolean Value String String Description Specifies if the PDF document should be secured or not If this property has the value False no other properties from this section will be used Default value False These properties define if the PDF document will contain a valid User and Owner password If the PDF document has no user password this document can be opened without the need to enter a password in any PDF viewing or manipulation tool even if an Owner password Is set To ensure robust security set both an Owner and User password Default value False Default value False Defines the User password This password is used for opening the document with user privileges Default value empty string Defines the Owner password This password is required to change permissions security settings in the PDF document If this password is empty or the Same as the User password changing the permissions security will be impossible Default value empty string PDF XChange Drivers API SDK 2012 31 Interface IPXCPrinter O 40RSA 1 128RSA o AK SAT S S O25 6455 4 256AES_R6 Perms40 AllowPrinting Boolean Value Perms40 AllowChanging Boolean Value Perms40 AllowCopying Boolean Value Perms40 AllowComments Boolean Value Per
14. 1 72 inches This unit is 1 720 of an inch nDet_Textcolor Specifies text color to be used for matching dwDisplayFlags A bit combination integer value which defines how the bookmark item will be shown in the bookmark tree of the PDF viewing application May be a combination of the following flags Bit Value Meaning Gi lal When this bit is set the bookmark item will be drawn using a bold font I 2 When this bit is set the bookmark item will be drawn using an italic font When this bit is set the bookmark item will be initially opened in the bookmark tree window of the viewing application This flag is used only when the property Bookmarks DisplayMode has a value Byltem dwDisplaycolor Specifies the color bookmark items will be displayed in if matching this template in the viewer s bookmark tree window The RGB Macro defined in the Windows API may be used to specify the color value Return Value This function returns an internal ID for the newly created bookmark item This value may be used as a nParent parameter for later calls to the AddBookmarkl tem method Copyright 2005 2013 Tracker Software Products Interface IPXCPrinter 58 Example The following example creates simple bookmarks detection tree which makes text drawn using Times New Roman 12 pt bold font as top level items And items drawn by the same font but not bold as second level items Also items drawn using Arial bold 14 pt will be added as top lev
15. 8 x 210 mm 16 BO 1000 x 1414 mm 17 B1 7070 x 1000 mm 18 B2 5000 x 7070 mm 19 42 B4 ISO 250 x 353 6 mm 20 12 B4 JIS 257 x 364 mm 21 34 B5 176 x 250 mm 22 13 B5 JIS 182 x 257 mm 23 14 Folio 8 5 X13 24 15 Quarto 215 x 275 mm 25 18 Note opo AS 26 19 Envelope 9 3 875 x 8 875 21 20 Envelope 10 4 125 x 9 5 28 21 Envelope 11 4 5 x 10 375 29 23 Envelope 14 op LSS 30 21 Envelope DL 110 x 220 mm Copyright 2005 2013 Tracker Software Products 31 32 33 34 35 36 37 38 39 40 41 28 29 30 31 32 35 37 38 Envelope C5 Envelope C3 Envelope C4 Envelope C6 Envelope C65 Envelope B6 Envelope Monarch Envelope Personal 18x24 24x36 30x42 Interface IPXCPrinter 20 162 x 229 mm 324 x 458 mm 229 x 324 mm 114 x 162 mm 114 x 229 mm 125 x 176 mm MO 3 625 x 6 5 18x24 24 x 36 30 x 42 PDF XChange Drivers API SDK 2012 21 Interface IPXCPrinter General Properties in this section define the PDF Specification to be applied to the created PDF file and the parameters for the PDF viewing application which may be used to define the properties used when opening the document for Viewing Name Possible values PN Ene ol Sb AR OS 6 1 6 O Specificatron AEREA ej UB S baw o EDEN 2a 4 PDFA 2b EDEA O Default 1 ShowNone 2 Bookmarks Page asim Oan Mauban oa miles ASL Sen O Default 1 ShowNone PageMode 2 Bookmarks gt Ope Rona Conte ne Copy
16. AutoCAD Internet Explorer etc providing a set of 32 64 bit Virtual print drivers the PDF XChange Drivers API is an excellent choice Creating arguably the smallest and most reliable facsimile in PDF format of the original document available today at a very competitive price Other developer kits available for PDF Creation Manipulation and Viewing from Tracker Software Products include PDF Tools SDK PDF XChange PRO SDK and the PDF XChange Viewer SDK For more information on all of our developer products please visit our website http www tracker software com developers Windows Support From Version 4 we have dropped Drivers for all Windows versions prior to Windows 2000 should you still need to support Windows 9x ME NT we have continued to offer our highly successful PDF XChange Version 3 product range though it should be noted that NO further development will take place with our Version 3 product line Version 5 supports all Windows versions Windows 2000 and later PDF XChange Drivers API SDK 2012 3 Using Drivers API SDK The PDF XChange Drivers API ActiveX Allows developers to control the properties of the PDF XChange driver for the creation of PDF documents Developers are able to harness the full power of our award winning Driver by specifying parameters for PDF creation as used by many millions of contented End Users directly from within the developer s own Software applications The PDF XChange Drivers API i
17. Digital Signatures This section defines Digital Signature properties of the document and the properties for the signature used for signing Name Possible values Description If this property is False digital signing is not used and no other properties need to be specified Enabled Boolean value Default value False Defines which stored certificate should be used If the value of this property is 0 System the default O System user s stored system certificate will be used ACE IPs If the value of this property is 1 File an external PFX file must be specified Default value 0 System This property specifies the hash value of the certificate to be used for signing the document When Store value is 0 System PDF XChange will find Hash Binary the corresponding certificate within the system certificate storage When Store value is 1 File this property is not used When Store value is 1 File this specifies the PFX file which contains the digital signature for signing the document PFXFile String When Store value is 0 System this property is not used When Store value is 1 File this specifies the password for the PFX file PFXP d iS sing When Store value is 0 System this property is not used Reason O These properties define additional text properties to be String included with the digital signature within the PDF document Contact Default values empty string PDF XChange Drivers API SDK 2012 33 Inter
18. F file The value of this property must be the fully qualified path name of the application Default value empty string This property specifies the parameters that will be passed to the AppName application when opening the PDF file String f represents the full path name of the created PDF file Default value f EMail Interface IPXCPrinter 46 Email properties are used when the created PDF file should be emailed after creation and define the parameters for emailing The created PDF file will be sent as an attachment of this email Name Possible values Enabled Boolean value Method From Ge Bee Subject GO Ean ne ne mie 1 SendViaClient 2 SendViaSMTP String String String String String Description Specifies if the PDF document should be emailed after creation If the value of this property is False none of the other properties in this section are used Default value False Specifies how the email should be sent Value LaunchClient launches the default email client with parameters filled in from the other properties and the user will send the email manually after making any corrections or emendations as required Value SendViaClient launches the default email client and sending the email automatically without intervention from the user Value SendViaSMTP will use the SMTP server specified by the Server property to send the email Default value 0 LaunchClient Specifies the
19. Printer 42 Doclnfo Document Information The properties of this section allow PDF document information fields to be defined and allow adding of XMP Metadata within the PDF document Name Enabled AskForDocInfo AddXMP Title Subject Ae NO Keywords Creator Possible values Boolean value Boolean value Boolean value String String String String String Description If this property is False no information fields will be specified within the PDF document except the Producer field which is always specified and contains the PDF XChange version information for the creation of this PDF file Default value False If this option iS True a popup window where Document information fields can be entered will be shown after the document is spooled Default value False If this option is True XMP metadata will be added within the PDF document This metadata will contain values of information fields date of document creation etc Please note when PDF A mode used XMP metadata will be added into the document irregardless of the value of this property and Enabled property Default value False Specifies the Title information field of the document Default value empty string Specifies the Subject information field of the document Default value empty string Specifies the Author information field of the document Default value empty string Specifies the Keywords information field of
20. an be used to control printing process IPXCPrinter ActiveX interface provides the following Properties Methods and Events Properties 1 Property Name returns the name of the printer associated with the object 2 Property Option is used to specify almost all the properties of the printer The following sections define the specific Property Options 1 Section Paper properties in this section allow you to define page layouts for the created PDF document 1 Normal Used to specify position and size of the page on the sheet 2 n Up Defines how many and in which order pages should be placed on the sheet 3 Booklet Defines booklet or book creation parameters 2 Section General defines the PDF Specification to which the created PDF file should conform and the options for the PDF viewing application 3 Section Compression specifies which compression options should be used for the PDF document s text and images 1 Subsection Color specifies compression for True color images 2 Subsection Indexed specifies image compression for images with a color palette 3 Subsection Mono specifies the compression method to be used to compress monochrome black amp white images 4 Section Graphics specifies how different types of images should be processed before inserting into a PDF document 1 Subsection Color determines image downsampling and conversion options for True color images 1 Color Downsample defines whether and how images should be do
21. ancel the PDF file creation Default value True Defines the path where newly created PDF file should be saved If this property is an empty string the user s My Documents folder will be used for document storing In some cases this property is not used See the description of the File property Default value empty string Defines file name of the newly created PDF file This name can contain macros and a path If this property contains a path this path will used instead of path specified in Path property Default value DocName StrloPach Boolean value Pashnea naa 1 Overwrite 2 AutoNumber WhenExists 3 Append 4 InsertBefore AMO Ne Stakt O 999999 AutoNumber Me sl OS RunApp Boolean value Interface IPXCPrinter 44 Defines how value of macro DocName will be calculated If this property is True and the document name passed from the printing application contains the path this path will then be stripped during assigning Yo DocName property Default value False Specifies the action which will be performed during saving if the file with the name specified by Path and File properties already exists When value is ShowWarning pdfSaver will show a warning dialog where the user can choose what to do Value Overwrite allows pdfSaver to overwrite existing file without any warning dialogs If the value is AutoNumber pdfSaver will change the name of the destination file by append
22. anguage as the default language for the User Interface for all the installed programs and Print drivers PDF XChange PDF Tools OFFice2PDF and the MS Office Addin s etc LANG language en English nl Dutch uk Ukrainian fr French gr German it Italian sp Spanish ko Korean ch Chinese jp Japanese fi Finnish This may not be the complete list please see the Lang installation folder C Program Files Tracker Software PDF XChange 5 Languages for the up to date list of supported language files Example for German PDFX5SA_sm exe other parameters LANG gr Additional parameters DRVwoPRN Installs the printing drivers without a visible printer Warning Failure to ensure that special switch characters such as quote marks and are included in your command line or batch file in the correct position will result in failure to behave as required PDF XChange Drivers API SDK 2012 9 IPXCControlEx Object PXCControlEx Object The IPXCControlEx ActiveX object is used to create a new temporary PDF XChange printer instance and returns the I PXCPrinter object this in turn allows the developer s application to set and control the properties of the newly created printer instance Once the job is completed the printer instance is destroyed I PXCControlEx Printer Property I PXCControlEx Printer allows the creation of a new temporary printer based on the PDF XChange 2012 driver and return
23. cument Name Possible Description values EmbedAll Boolean Default value False Value EmbedProtected Boolean Default value True Value Wet peloUnmise ode Boolean Default value False Value If this option is enabled and if the percentage of characters used from the font specified is less than that specified in the Subset Level property only the actually used characters from the font will be embedded within the PDF document Boolean ano Subset Otherwise the complete font file will be embedded within the PDF Value SRD meas resulting in a larger PDF file but this will ensure consistent formatting viewing is always possible Default value True Sub erkese 1 100 Default value 100 Additionally there are two identical subsections AlwaysEmbed and NeverEmbed which define lists of fonts which should always be embedded or which never should be embedded Each of these subsections has the following properties Name Possible values Description Enable using the list defined by the Fonts property Enable Boolean Value Default value False Fonts String Contains a comma separated list of fonts Default value empty list Copyright 2005 2013 Tracker Software Products Security Interface IPXCPrinter 30 This section defines security options for the PDF document Note When the PDF A format is specified the security options for the document will not used and will be ignored it is advisable therefore to actually disable security
24. d how they are to be displayed Border property Possible Name Description values This will detect URL and mail links please note to be valid links must be valid and occupy a single line of the page Embedded links cannot be KG Boolean recognized e g Click Here value Default value False Links to files must be valid and contain a fully qualified path Boolean DetectFiles value Default value False Check a links validity as part of the recognition and PDF page inclusion process CheckExistance Boolean value Default value False The Border property of this section defines the links border parameters and the way the link will appear on the page Name Possible values Description O None 1 Underline Ha Type Specifies the type of links border Default value 0 None 2 Rectangle 0 Solid siege Basic Default value 0 Solid ZDS Specifies RGB value of color for links border Color Integer To specify this value RGB macro defined into Windows API can be used Default value 255 red color Defines the width of links border Value is specified in tenth of millimeters Width 5 50 Default value 10 Copyright 2005 2013 Tracker Software Products Watermarks Interface IPXCPrinter 38 These properties allow the developer to enable or disable adding watermark s into the document and to define a set of these watermarks Possible Name Values Description If this property is True wat
25. e Otherwise it will be placed in the foreground over the content of the existing page ss NA Watermark should be visible during viewing the PDF document in the PDF viewing application sola Watermark should be visible when the PDF document is exported for example as an image format from the viewing application 4 116 Watermark should be printed when the PDF document Is printed from the PDF viewing application dwPlaceType Defines on which pages the watermark should be placed May be any of the following values Value Meaning 0 Watermark will be placed on all pages of the document Il Watermark will be placed only on the first page of the document 2 Watermark will be placed only on the last page of the document 5 Watermark will be placed only on even pages of the document 4 Watermark will be placed only on odd pages of the document 5 Watermark will be placed on pages specified by the sRange parameter sRange A String defining the page range s onto which the watermark should be placed Each range can be page number or range of pages in the form p1 p2 which means from p1 to p2 inclusive One of p1 or p2 may be omitted In this case all pages prior to p2 or all pages after p1 will be included into the range Ranges should be separated by a comma or semicolon Example of range string 3 5 7 11 15 This decodes as pages 1 2 3 5 7 8 9 10 11 15 to the end of the document Copyright 2005 2013 Tracker Sof
26. e install should only request essential information from the user once started Once the install is complete no reboot will occur but beware PDF XChange does require a reboot before updates will take effect not recommended The full path to install all required files to created if not already available DIR C Program Files PDF XChange The Windows Start Menu folder in which to locate the Menu options provided when installing PDF XChange this will always be a Child menu option of the default Programs Files menu and this cannot be changed GROUP Tracker Software PDF XChange 2012 If this switch is specified only those components actually listed will be installed otherwise all components are installed The available components are pdfSaver Always Required PDF XChange driver Always Required Help Languagess please note ss is required Autounload COMPONENTS pdfSaver PDF XChange driver Help Languagess PDF XChange Drivers API SDK 2012 7 Installation AutoUnload nn Key Registration only to be used if you are also providing an END USER enabled license not included as part of your Developers SDK License EVER UserName Registration Organization Registration PDEFAULT Optional PName Optional printer renaming UserEmail Registration Copyright 2005 2013 Tracker Software Products If this option is specified after the specified timeout
27. e sequences Such optimization requires many manipulations with images but causes the resulting PDF to be much smaller and better for viewing Default value True Enables swapping images to the disk during image optimization When swapping is turned off optimization time is smaller as a rule but requires more memory Default value True Defines the image size in megabytes in memory starting from which this image will be swapped to disk if option EnableSwapping has True value Default value 1 Interface IPXCPrinter 50 Saver This section controls the ShowProgress property of the pdfSaver application Name Possible Description values If this property is True the progress dialog will be shown during the printing and PDF creation process Boolean ShowProgress Tala Value False disables this progress window Default value True Note Other properties may be added in the future Naming Macros PDF XChange supports macros for file naming and for headers footers text All macros have syntax Ss Macro extra Where Macro is a name of the macro value and extra defines extra specifier for the macro Items between are optional Not all macros use an extra specifier and will ignore all text after up to closing bracket 1 The following macros are supported into PDF XChange Possible Name Values Description Specifies the executable module of printing application It contains only a file name of exec
28. eNumber Zero based page number spooled Return Value PDF XChange ignores returned values from this event Copyright 2005 2013 Tracker Software Products Interface IPXCPrinter 72 Event OnEndDoc This event is fired when the complete document has been spooled by the GDI Declaration C event OnEndDoc int JoblD int bOK C HRESULT OnEndDoc LONG JoblD LONG bOK VB Event OnEndDoc JoblD As Long bOK As Long Parameters Jobi D Internal Job identifier bOK When this parameter is True the document has fully spooled and PDF XChange will continue to process this document to produce the PDF file If there was an error during printing e g printing cancelled there will be no further document processing Return Value PDF XChange ignores returned values from this event PDF XChange Drivers API SDK 2012 73 Interface IPXCPrinter Synchronous Synchronous Events The following Synchronous events are supported by the PDF XChange 2012 Driver e Event OnDocSpooled is fired immediately PDF XChange starts processing the document printed by the GDI e Event OnFileSaved is fired when the PDF file is saved e Event OnFileSent is fired when PDF emailing is enabled and after the email has been sent If emailing is not enabled this event will not fire e Event OnError is fired if an error occurs during the processing of the PDF file Event OnDocSpooled This event is fired immediately PDF XChange begins processing the docum
29. ed to the tree if a previously detected item of higher level already exists When False a detected item will always be added to the tree and if there was no parent detected at a higher level dummy parents will be added Default value False Defines which items of the bookmarks tree should be initially opened into the PDF viewer application Value A110pened means that all items will be opened Value Al 1Closed means that all items will be closed Value ByItem means the state of the item defined by its template definition will be used Value OpenToLevel means that all items up to the level specified by UpToLevel property will be opened All other items will be closed by default Default value 2 ByItem Defines the level into bookmarks tree up to which items will be initially opened into the PDF viewer application Only active if DisplayMode has the value 3 OpenToLevel Default value 1 Specified the name of Template used for detection and creation bookmarks tree within the PDF document This property is not used with the ActiveX control and should be an empty string which means current template The current template can be created by using method AddBookmarkl tem Default value empty string Interface IPXCPrinter 40 HeadersFooters These properties define headers and footers to be placed on all pages of the PDF document Headers and footers contain three parts left center and right Each part specifies t
30. ee NA ULA TON 11 Properties ai eh Sips eae cet Ga AA Genet cs Bane ANAN PEO II E E A 11 en ce Se PA AA ES 13 Option en 14 Property BE eo RDE te i E E bas ve ae aise 15 Paper AA 16 Caner CA PAA 21 Compression Ee en es te ee 23 Graphics paa ieee de we ao oe A we ved dae es epee oe ee ae oe eee aah ce ete ees 25 a ca esac a esse ecne ca tees tds Cage A APA 29 Security AE 30 DigSig Digital Signatures PAPER PARN 31 Overlay beent sanib Kaba auc wea basha aba BAGO PA Pa Ba a een 35 4 E BAONG NGANGA NARE NAGA bee saat EE ORNE RNR NEEN BEAR 37 NAGA ARA 38 EC ote nase oa se ee ADA ALA nA BANDANA KANE ANNA PAANAN AKNG nase piso ala dennen Rae 38 ela ela heenreis oie PUNNAGA mane aetna cana EER REEDE 40 Docinfo Document Information bin agnas eee en ee eee eee 42 APA PA 42 EN AA NA 46 Optimization AA eee aos 48 AA AA 50 Naming a unahan kad ag PG NG a Se AO a es LA eg te eee 50 POT AO an es ese et KANE NO eg Ge KAINAN de ke AND DD AYUN NN ALAN NO NABA AA AND AA Aa kak Anh 53 SetRegInfo naaa aan es DAA NAMAN ee eee 54 POLO HI sees A aes ie E aes ei ea ge eget ee ene ea ose ee A see AA T 54 ApplyOptions OD O En o O 55 AddBookmarkltem AA 55 ACT NAGIN swa aces e e e o ne 58 Addlmage Watermark Sn A A AA DA AA 61 StorePrinterOptions AA e o A eee caesarean 64 ReStorePrinterOptions a NA PAENG ANABU AUG SYA 64 SetAsDefaultPrinter AA 65 Baa Aa IC AE 66 CE TE CO na A ANA NAA NANA nes 66 PO OP SE OO a BANANA NGABA NG Dha edema nants eend 68 As
31. el item and will be displayed using red color VB Dim parent as Long parent PXCPrinter AddBookmarkltem 1 7 Ti mes New Roman 1 120 5 0 0 0 PXCPrinter AddBookmarkltem parent 7 Times New Roman 0 120 5 0 0 0 PC Pa Ee AAO BOOK Meni Kl Sel Aa ZN AddT extWatermark Method AddTextWatermark This method is used to define a new text watermark to be added to the document This methods parameters correspond to the parameters available in the PDF XChange Driver 2012 GUI during the adding editing of a Text Watermark topic Watermarks Add button Declaration C void AddText Water mark string sName string sText string sFont Name int i nt int i nt i nt int int int int int int int int dwFont Wei ght bl talic bOutl ine nFont Size nLineWi dth nTextcolor dwAli gn Offset yOffset nAngle dwOpacity dwFlags dwPlaceType string sRange PDF XChange Drivers API SDK 2012 59 Interface IPXCPrinter C HRESULT AddText Wat er mark in BSTR sName in BSTR sText in BSTR sFont Name in long dwFont Wei ght DM Ln ol eer te in long bOutl ine KE Tan since Sen in long nLineW dth in kong nlextcolor in long dwAlign in long xOffset in long yOffset in long nAngle in long dwOpacity in long dwFlags in long dwPlaceType in BSTR sRange VB Sub AddText Wat er mar k sName As String sText As String sFontName As String dwFont We
32. ent is fired when a new document starts to print Declaration C event OnStartDoc int JoblD string IpszDocName string pszAppName C HRESULT OnStartDoc LonG JoblD BSTR pszDocName BSTR pszAppName VB Event OnStartDoc JoblD As Long I pszDocName As String pszAppName As String Parameters Jobi D Internal Job identifier IpszDocName Specifies the document name as it was passed from the printing application IpszAppName Specifies the module name of the printing application Return Value PDF XChange ignores returned values from this event Copyright 2005 2013 Tracker Software Products Interface IPXCPrinter 70 Event OnStartPage This event is fired for each page when it starts to print Declaration C event OnStartPagelint JoblD int nPageNumber C HRESULT OnStartPagel LONG JoblD LONG nPageNumber VB Event OnStartPage JoblD As Long nPageNumber As Long Parameters Jobi D Internal Job identifier nPageNumber Zero based page number when spooling Return Value PDF XChange ignores returned values from this event PDF XChange Drivers API SDK 2012 71 Interface IPXCPrinter Event OnEndPage This event is fired for each page after printing completes Declaration C event OnEndPage int JoblD int nPageNumber C HRESULT OnEndPage Lonc JoblD LONG nPageNumber VB Event OnEndPage JoblD As Long nPageNumber As Long Parameters Jj obi D Internal Job identifier nPag
33. ent printed by the GDI Declaration C event OnDocSpooled int JoblD string IpszDocName string pszAppName C HRESULT OnDocSpooled LonGc JoblD BSTR I pszDocName BSTR pszAppName VB Event OnDocSpooled JoblD As Long pszDocName As String pszAppName As String Parameters These event parameters are identical to the parameters for the OnStartDoc event During handling for this event the application can set document specific properties for example the path where the PDF document should be stored as defined by the printing application The application should return S_OK from this event handler Copyright 2005 2013 Tracker Software Products Interface IPXCPrinter 74 Event OnFileSaved This event is fired when the PDF file is saved This allows the application to perform any application based processing to this file Declaration C event OnFileSaved int JoblD string IpszFileName C HRESULT OnFileSaved Lonc Jobl D BSTR pszFileName VB Event OnFileSaved JoblD As Long IpszFileName As String Parameters Jobi D Internal Job identifier IpszFileName Specifies the fully qualified path name for where the PDF document has been saved Return Value PDF XChange ignores returned values from this event PDF XChange Drivers API SDK 2012 75 Interface IPXCPrinter Event OnFileSent This event is fired when emailing of a PDF file is enabled and after the email has been sent If emailing is not enabled this e
34. er properties of the PXCControlEx object if a printer with the requested name already existed Copyright 2005 2013 Tracker Software Products Interface IPXCPrinter 14 Option Property Option This is a Write only parameterized property option and is used to specify almost all the properties of the PDF XChange printer Declaration C vold set Option string pOptionName object p2 C HRESULT put Option in BSTR pOptionName in VARIANT arg2 VB Property Option pOptionName As String A detailed list of all available properties with detailed descriptions is listed in Properties All properties are identified by a string for that pOptionName The name of the property will also usually contain some parts separated by the dot character Values of these properties can be strings integers boolean or binary values an array of bytes PDF XChange Drivers API SDK 2012 15 Interface IPXCPrinter Property Table Definition Each property section has a table detailing the possible property values The three columns of the tables provided are always e Name The name of the property This is what you assign the value to For example Paper LayoutType e Possible Values These are the allowed values for the property specified in Name e Description Describes the use or function of the property The possible values are described as numbers and corresponding strings and either may optionally be used to set the val
35. ermarks defined by Watermarks property will be Boolean added to the PDF file Otherwise watermarks will not be used Enabled value Default value False A semicolon separated list of watermark names that should be added to the document Watermarks String Each of these watermark should be added using AddTextWatermark or AddlmageWatermark methods Default value empty string Bookmarks This section activates automatic bookmark tree creation for the PDF document and defines the parameters for this process Name Possible values Enabled Boolean value AllowMultiLine Boolean value DocTitleAsRoot Boolean value Description Enables automatic creation of a bookmark tree within the document If the value of this property is False no bookmarks tree will be created and the rest of the properties of this section are ignored Default value False Activates detection of multiline bookmark items Default value True When True the Root element of the bookmarks tree will be the document title see Docl nfo Title property and all other top level bookmarks will be children of this element Default value False PDF XChange Drivers API SDK 2012 39 Interface IPXCPrinter Maro neo al Boolean value O AllOpened 1 AllClosed DisplayMode E 3 OpenToLevel UpToLevel Integer Template String Copyright 2005 2013 Tracker Software Products When True a detected non top level item will only be add
36. ers and switches applied or create a batch file bat file and distribute this with the main installation executable for your users to run directly alleviating the need for the System Administrator to visit each user and install Please note as with any system device such as a printer full Administrator privileges are required to install on later Win32 versions of Microsoft Windows Here is an example of the full command line string available Most items are optional unless otherwise stated C PDFX5SA_sm exe VERYSILENT NORESTART COMPONENTS pdfSaver PDF XChange driver Help Languagess DIR C Program Files PDF XChange 5 UserName lI am Organization Tracker software UserEmail my email com Broken down into sections these are the switches and what each does Copyright 2005 2013 Tracker Software Products Installation 6 Note Please note that the indicated string content must begin and end with double quote marks SWI TCHES MAIN install executable and path required NERYSI LENT SILENT NORESTART DIR required Group Optional COMPONENTS DESCRI PTI ON This is the full path to the installation executable note it is the standard install executable both silent and non silent installations are available from the single executable C PDFX5SA_sm exe Designates that the installation once started should be silent and require no user interaction Designates that th
37. erted MonoAndDrawings Downsample This subsection defines when and how images should be downsampled Name Possible values Description 0 None Specifies which method should be used for downsampling ea If the value of this property is 0 None images of this type will not be Method ee downsampled 3 Bicubic Default value O None These two properties define when an image should be downsampled ais priory Default value 96 If the original DPI of the image is equal to or above that of the value specified by the property IfAbove the image will be downsampled to Teor SL OMNES the DPI specified by the property To Default value 128 Copyright 2005 2013 Tracker Software Products Interface IPXCPrinter 28 MonoAndDrawings Convert Specifies images should be converted as either mono or black amp white images Name Possible values Description 0 None Defines how mono images and line art should be converted 1 ToGrayscale Value 0 None means that no conversions will be MAGA Ore 2 ToMonochrome performed 3 ToBlackAndWhite Default value 0 None Defines the level behind which color of line arts will be treated as black For comparison the grayscale level of line art color is Magecho du55 used Default value 128 PDF XChange Drivers API SDK 2012 29 Interface IPXCPrinter Fonts This section contains properties which define embedding and other options for fonts to be used in the PDF do
38. escription One of following integer value O Normal 1 Multiply 2 Screen 3 Overlay ADE Specifies blending mode used for blending line art during printing from some application for example from 5 Lighten AutoCAD when lines overlaying is enabled in it 6 colorDodge Default value 4 7 colorBurn 8 HardLight 9 SoftLight 10 Difference 11 Exclusion Specifies if detesselation should be used for a sequence of triangles Detesselation is useful when printing from AutoCAD and allow to produce smaller and optimal PDF O None Default value 1 Simple Enables transparency drawing into the PDF file PDF XChange can detect some drawing sequences and can then replace them with transparency drawing JOSE veule Please note when PDF A mode is used this property is forced to False value Default value True PDF XChange Drivers API SDK 2012 49 Interface IPXCPrinter seMaskedImages Boolean value GrayPaletteAsRGB Boolean value ImagesOptimization Boolean value EnableSwapping Boolean value Swap TODT ko Lama ES Copyright O 2005 2013 Tracker Software Products Using masked images produces smaller PDF files for some drawing sequences Default value True If this option is enabled the palettes of grayscaled images are stored as an RGB palette where each element of this palette has the same value for each of its RGB components Default value False Enables the optimization of imag
39. face IPXCPrinter Defines how the graphic left portion of the signature fields should be displayed If the value is None this will not be used and information about the digital signature will be placed in the entire area of baal the signature field Graphic Eoo If the value is Image the image file specified by 2 Name GraphicFileName will be used With the value Name the signer s name as in the certificate will be used Default value 2 Name When Graphic IS Image this is the fully qualified path name for the image to be used on the signature GraphicFileName String This image can be any one of the supported image formats A combination of flags which define how the signature field howF 1 ShowFlags Integer should look See details bellow Zero based page number on which the digital signature should be placed A value of 1 for this property places the Page Integer signature on the last page of the document Default value 1 This property define the position relative to the top left corner of the page Value are specified in tenths of a Lo Integer millimetre Default value 254 This property define the position relative to the top left corner of the page Value are specified in tenths of a Top Integer millimetre Default value 254 This property define the dimension of the signature field Value are specified in tenths of a millimetre Width nteger Default value 508 This proper
40. g sPassword As String bSecureConnection As Long Parameters sName Specifies the name or IP address of the SMTP server nPort Specifies the port number to be used to communicate with the SMTP server The usual SMTP default is port 25 bNeedAuth Set to True if the specified server requires authorization for sending email sUser User name used for authorization on the server Not used when bNeedAuth is False sPassword Password used for access authorization to the server Not used when bNeedAuth is False bSecureConnection Set to True if the server requires a secure connection or False otherwise Return Value Method returns S_OK if success and other values on fall Copyright 2005 2013 Tracker Software Products Interface IPXCPrinter 68 Events The I PXCPrinter interface provides events which can be used by a Developer s applications to determine the stage of the PDF creation process Some events are fired during document spooling and these events are asynchronous to prevent dead locking Events which are fired during the generation of PDF documents are synchronous An asynchronous event means that PDF XChange fires the event and will not wait while application receives this event and returns from it It also means that the application will receive these events immediately when they are fired When a synchronous event is fired PDF XChange will wait until the application has finished this event All events have a
41. gs Default value False Enables or disables vertical mirroring of all drawings Default value False Specifies the sheet used for PDF creation Value 2 means custom sheet size which is defined by properties SheetWidth and SheetHeight Value 1 means Auto sheet size In this case sheet size is dependant on the layout type and page size All other values are indices of the standard paper sizes defined in PDF XChange See List of Standard Paper Sizes Default value 1 Specifies the width and height of the sheet Values are in tenths of millimeters and must be within the specified range Default values 2100 width and 2970 height The maximum height width of a PDF page are 200 x 200 or approx 5080x5080 mm as defined in the PDF Specification PDF XChange Drivers API SDK 2012 17 Interface IPXCPrinter Normal The maximum height width of a PDF page are 200 x 200 or approx 5080x5080 mm as defined in the PDF Specification Name LeftPos Top Eos PageScale Integer Centern n Up Possible values Integer Description These properties define the position of the top left corner of the page relative to the top left corner of the sheet Values are in tenths of millimetres These properties are used when both the Centre and Fit properties have False Integer values Default values 0 Specifies the scale level to use when positioning the page on the sheet Value is in tenths of 1 percent
42. he texts color and font that should be inserted into the document e Text placed in the left part is left aligned and placed at the left of the page position for header s left part are defined by Off set Top and Of fsetLeft properties e Text of center part is center aligned on the page e Text of the right part is right aligned Any of the text fields may contain macros which will be replaced with their values during printing of the PDF Possible DEE Name Description values Enabled Boolean Default value False value Specifies the first page number for the headers and footers The value of this property is used in the Page macro FirstPageNumber Integer Default value 1 YE EE SES Values of these properties define the positions on the page where the hese roja headers and footers should be placed All values are in tenths of a millimetre OffsetRight Integer OE Default value 127 Header and footer are defined with two subsections Header and Footer which are identical and contain three identical subsections Left Center and Right Each part has properties Possible Name values Description The Font used for text which will be added into the document Font i on string Default value Arial Specifies font size for the text Font size is specified in tenth of point 1 point is 1 72 inch Homo ze ASA e Default value 100 Specifies if the font should be bold Font Bold Boolean value Default value
43. ight As Long ol talie As Long bOutline As Long nFontSize As Long nLineWidth As Long nTextcolor As Long dwAlign As Long xOffset As Long yOffset As Long nAngle As Long dwOpacity As Long dwFlags As Long dwPlaceType As Long sRange As String Copyright 2005 2013 Tracker Software Products Interface IPXCPrinter 60 Parameters sName Specifies the name of the newly created watermark item This name is used to identify this watermark in the Watermarks property string If there is already a watermark with the same name it will be overwritten sText Specifies the watermark text sFontName Specifies the font by name to use when drawing the watermark N B Required dwFontWeight Specifies the weight of the font Possible values are 400 for Normal and 700 for Bold bl talic When True specifies the italic variant of the font identified by the sFontName parameter bOutline When True the text will be drawn as an outline when False as solid filled text nFontSize Specifies the font size of the text Unlike V4 of the Drivers API in V5 the font size is specified in tenth points 1 pt 1 72 inch e to specify font size of 12pt the value of 120 should be passed in nFontSize When this parameter is 0 zero the font size will be adjusted to fit the entire page nLineWidth Specifies the line width for outlining the contour of the text Line width is specified in tenths of points Used only when bOutline is
44. ing with a numeric value The format of this number is specified by AutoNumber Start and AutoNumber NumDigits properties Values Append and InsertBefore allow pdfSaver to merge existing and newly created PDF documents by placing the newly created PDF at the end for value Append or at the beginning InsertBefore of the existing file Please note these options are not available when PDF A feature is used Default value 0 ShowWarning Define the start number when auto numbering used Default value 1 Define the format of the number when auto numbering used The number of digits defines the minimum number of digits used for the number if number is shorted it will be prepended by O characters Default value 3 Specifies if the newly created PDF document should be opened after creation Default value True PDF XChange Drivers API SDK 2012 45 Interface IPXCPrinter RunCustom Boolean value AppName String AppParams String Copyright 2005 2013 Tracker Software Products Defines which application should be used to open created PDF document If the value of this property is True application specified by AppName will be used otherwise the default PDF application will be used This property used only when RunApp is True Default value False This property is used only when both RunApp and RunCustom properties have the value RRUG It names the application which should be used for opening the created PD
45. ks determines whether to insert live links within the PDF document what kinds of links and how they are to be displayed Section Watermarks allows the developer to enable or disable adding watermark s into the document and to define a set of these watermarks Section HeadersFooters defines headers and footers to be placed on all pages of the PDF document Section Docl nfo allows PDF document information fields to be defined and allow adding of XMP Metadata within the PDF document Section Save allows you to define the folder where PDF document should be stored the file name of the document and other document saving options Section EMail is used when the created PDF file should be emailed after creation and define the parameters for emailing The created PDF file will be sent as an attachment of this email Section Optimization controls Optimizations of the generated PDF file Section Bookmarks activates automatic bookmark tree creation for the PDF document and defines the parameters for this process Section Saver controls the ShowProgress property of the pdfSaver application PDF XChange Drivers API SDK 2012 13 Interface IPXCPrinter Name Property Name This property is a read only property and returns the name of the printer associated with the object Declaration C string Name C HRESULT get Namel out retval BSTR pName VB Property Name As String Please note that this name can be different from that passed in the Print
46. lues can be used Bit Value Meaning If this bit is set the font name specified is used by the sDet FontName parameter to determine all matching text strings sDet FontName may not be NULL or an empty string when this flag is set If this bit is set the font style specified is used by the nDet_FontStyle parameter to determine all matching text strings If this bit is set the font size specified is used by the nDet_Size and nDet_SizeDelta parameters to determine all matching text strings Text with the font size nDet Size nDet SizeDelta matches and is therefore added as a bookmark item If this bit is set the text color specified by nDet_Textcolor is also used as part of the process in detecting potential matches The value of this parameter cannot be zero Q at least one matching parameter must be used PDF XChange Drivers API SDK 2012 57 Interface IPXCPrinter sDet FontName Specifies the font name for matching nDet FontStyle Specifies the font style for matching as an integer value which may have any one of the following values Value Meaning 0 Normal Font T Bold Font 2 Italic Font 2 Bold Italic Font nDet_Size Specifies the font size to be used for matching The font size is specified in tenths of a point one point 1 72 inches This unit is 1 720 of an inch nDet_SizeDelta Specifies the font size delta to be used for matching The delta value is specified in tenths of a point one point
47. mpression method to be used to compress images with palette Please note the compression method LZW cannot be used with the PDF A output specification Default value O Auto Defines the compression method to be used to compress Monochrome black amp white images Name Possible values Enabled Boolean Value O Auto ik SZ ASS AS Ma 3 CCITTA 4 RLE BIE iS Eee desen ereen MOREE Der GS vam er dk Description Default value True Defines the compression method to be used to compress monochrome black amp white images Please note the compression method J BIG2 cannot be used with the PDF A output specification Default value 0 Auto Specifies preprocessing method of images which will be compressed using J BIG2 method Default value 0 Standard PDF XChange Drivers API SDK 2012 25 Interface IPXCPrinter Graphics This section contains three subsections which define how different types of images should be processed before inserting into a PDF document Color Determines image downsampling and conversion options for True color images e Subsection Downsample defines when and how images should be downsampled e Subsection Convert specifies whether to use color reducing for True color images and into which format they should be converted Color Downsample This subsection defines when and how images should be downsampled Name Possible values Description 0 None Specifies which method sho
48. ms128 ContentAccess Boolean Value Perms128 AllowCopying Boolean Value Perms128 Changes 0 see 0 not allowed Perms128 Printing 1 low resolution 2 fully allowed Perms128 EncryptMeta Boolean Value Copyright 2005 2013 Tracker Software Products Defines the security method used for encrypting the document The value of this property specifies which subsection Perms40 or Perms128 will be used to define users permission for the document The last option 256AES R6 represents encryption algorithm that should be introduced in PDF 2 0 Specification but already used by Adobe Acrobat products Default value 0 40RSA Default value False Default value False Default value False Default value False Default value False Default value False Specifies the level of security to be applied regarding changes to the document 0 No changes will be allowed 1 Only document assembly is allowed for the user 2 Only form field fill in and signing is allowed 3 Allows comment authoring form field fill in and signing of the document 4 Allows general editing comments and form field authoring for the user Default value 0 Specifies user s permissions for printing the document Default value 0 Specifies if metadata In the PDF document should be encrypted or not N B This property is applicable for PDF specifications 1 6 and higher Default value True Interface IPXCPrinter 32 DigSig
49. ng Picture d dd ddd ele elle MM MMM MMMM pa NGA Gay gg Meaning Day of month as digits with no leading zero for single digit days Day of month as digits with leading zero for single digit days Day of week as a three letter abbreviation Depends of regional settings Day of week as its full name Depends of regional settings Month as digits with no leading zero for single digit months Month as digits with leading zero for single digit months Month as three letter abbreviation Depends of regional settings Month as its full name Depends of regional settings Year as last two digits but with no leading zero for years less than 10 Year as last two digits with leading zero for years less than 10 Year represented by full four or five digits depending of the calendar used Thai Buddhist and Korean calendars both have five digit year The yyyy pattern will show five digits for these two calendars and four digits for all other supported calendars Same as yyyy Period era string This element is ignored if the date does not have an associated era or period string Depends of regional settings Format of picture string used to form the time string The following elements can be used to construct a format picture string Picture fa hh El HH m mm S SIS t EE Meaning Hours with no leading zero for single digit hours 12 hour clock Hours with leading zero for single digit hours 12 hour clock H
50. ng the IPXCPrinter object Declaration C void SetAsDefaultPrinter C HRESULT SetAsDefaultPrinter VB Sub SetAsDefaultPrinter Return Value The method returns S_OK if successful otherwise an error code is returned Copyright 2005 2013 Tracker Software Products Interface IPXCPrinter 66 RestoreDefaultPrinter Method RestoreDefaultPrinter This method restores the original system default printer modified when calling SetAsDefaultPrinter method If the method SetAsDefaultPrinter was not previously called this method call will be ignored Declaration C void RestoreDefaultPrinter C HRESULT RestoreDefaultPrinter VB Sub RestoreDefaultPrinter Return Value The method returns S_OK if successful otherwise an error code is returned AddSMTPServer Method AddSMTPServer This method adds the parameters of a defined SMTP server which may then be used for sending PDF files via email For more details see description of EMail section Declaration C void AddSMTPSer ver string sName int nPort int bNeedAuth string sUser string sPassword long bSecureConnection PDF XChange Drivers API SDK 2012 67 Interface IPXCPrinter C HRESULT AddSMTPSer ver in BSTR sName in long nPort in long bNeedAuth in BSTR sUser in BSTR sPassword in long bSecureConnection VB Sub AddSMTPServer sName As String nPort As Long bNeedAuth As Long sUser As Strin
51. on 42 E EMail 46 Event OnDocSpooled 73 Event OnEndDoc 69 Event OnEndPage 69 Event OnError 73 Event OnFileSaved 73 Event OnFileSent 73 Event OnStartDoc 69 Event OnStartPage 69 Events 68 Events Asynchronous 69 Events Synchronous 73 F Fonts 29 G General 21 Graphics 25 H HeadersFooters 40 Installation 5 Interface IPXCPrinter 11 IPXCControlEx Object 9 L Links 37 Method AddBookmarkltem 55 Method AddlmageWatermark 61 Method AddSMTPServer 66 Method AddTextWatermark 58 Method ApplyOptions 55 Method ResetDefaults 54 Method RestoreDefaultPrinter 66 Method ReStorePrinterOptions 64 Method SetAsDefaultPrinter 65 Method SetRegInfo 54 Method StorePrinterOptions 64 Methods 53 N Naming Macros 50 O Optimization 48 Options Bookmarks 38 Options Compression 23 Options Digital Signatures 31 Options Docinto 42 Options EMail 46 Options Fonts 29 Options General 21 Options Graphics 25 Options HeadersFooters 40 Options Links 37 Options Optimization 48 Options Overlay 35 Options Paper 16 Options Save 42 Options Saver 50 Options Security 30 Options Watermarks 38 Overlay 35 P Paper 16 Properties 11 Property Declarations 77 Property Name 13 Property Option 14 Property Table Definition 15 S Save 42 Saver 50 Security 30 Silent Install Switches 5 U Using Drivers API SDK 2 W Watermarks 38 Welcome 1
52. ours with no leading zero for single digit hours 24 hour clock Hours with leading zero for single digit hours 24 hour clock Minutes with no leading zero for single digit minutes Minutes with leading zero for single digit minutes Seconds with no leading zero for single digit seconds Seconds with leading zero for single digit seconds One character time marker string such as A or P Depends of regional settings Multi character time marker string such as AM or PM Depends of regional settings PDF XChange Drivers API SDK 2012 53 Interface IPXCPrinter Methods Methods are used to perform ActiveX control actions that simple property assignments cannot accomplish Method SetRegl nfo is used to set registration information specific for developer for the printer Method ResetDefaults resets all properties to their default values Method ApplyOptions is used to apply all properties changed with property Option Method AddBookmarkl tem adds a new item into bookmarks template tree Method AddTextWatermark is used to define a new text watermark which may be added to the document Method Add mageWatermark is used to define a new image watermark which may be added to the document Method StorePrinterOptions is used to store all printer options into any external storage which supports an IStream interface Method ReStorePrinterOptions restores all printer options previously stored by method StorePrinterOptions Method SetAsDefaultPrinter
53. ped in typographic gatherings by the number specified in the SheetsInBook O Brochure property BOOK Lee pe a Otherwise the booklet will contain only one book with all the pages included Default value O Brochure Defines the number of sheets in one book when the property BookletType has the value Book Sheets1lnBook 1 64 Default value 4 Defines the gutter size for the booklet Value is specified in tenths of PARAS millimeters GutterSize Positive integer Default value PDF XChange Drivers API SDK 2012 19 Interface IPXCPrinter Standard Paper Sizes List of predefined papers in the PDF XChange 2012 Number specified into column Index can be used to specify the sheet size into property Paper SheetSizel ndex Column Standard I ndex contains index for the paper as it is defined into Windows API Please note that some paper definitions are specific for PDF XChange and have no standard index Dimension column defines the size of the paper for its standard orientation portrait Dimensions are specified in inches or in millimeters Index Standard Index Paper name Dimension 0 1 Letter ANSI A ll 1 3 Tabloid ANSI B Xo 2 ANSI Super B 13 x 19 3 24 ANSI C X22 4 25 ANSI D 22 x 34 5 26 ANSI E 34 x 44 6 ANSI F 28 x 40 7 5 US Legal 8 5 x14 8 6 Statement DSX 0 9 9 7 Executive T23 X 105 10 AO 841 x 1189 mm 11 Al 594 x 841 mm 12 62 A2 420 x 594 mm 13 8 A3 297 x 420 mm 14 9 A4 210 x 297 mm 15 11 A5 14
54. right O 2005 2013 Tracker Software Products Description Defines the PDF Specification level to which the PDF file should conform Value Auto 0 allows PDF XChange to choose the most efficient specification based on other specified options When the value from 5 to 1 specified PDF XChange will create a PDF file which conforms to ISO standard PDF A Please note that some PDF functions and content are not available allowed when specifying PDF A formatting Default value O Auto Default value O Default Default value O Default FullScreenMode MagnificationType MagnificationLevel Open To rage HideToolbars HideMenubar HideUl FitWindow CenterWindow ShowDocTitle O Default 1 ShowNone 2 Bookmarks SANOS TOMO Ie cuides O Default 1 ActualSize 2 FitPage Saa 4 FitHeight 5 Level 540 0 Boolean Value Boolean Value Boolean Value Boolean Value Boolean Value Boolean Value Default value Default value Default value Default value Default value Default value Default value Default value Default value Default value O De O De One False False False False False False Interface IPXCPrinter 22 fault Bene PDF XChange Drivers API SDK 2012 23 Interface IPXCPrinter Compression The properties of this section specify which compression should be used for the PDF document s text and images Possible Name Values Description
55. riginal source documents and materials pRegKey String containing the Developer registration key If this registration key is not present or is invalid the PDF XChange demo label will be added to all PDF pages generated by the printer pDevCode String containing the developer code If this developer code is not present or is invalid the PDF XChange demo label will be added to all PDF pages generated by the printer Return value If successful the function returns an IPXCPrinter object associated with newly created printer On failure the function returns a NULL Example VB 01 Dim PDFPFactory As New PXCComLib5 CPXCControl Ex 02 Dim WithEvents PDFPrinter As PXCComli b5 CPXCPrinter 03 04 Public Sub Form Load 05 Set PDFPrinter PDFPFactory Printer PDF XChange 2012 Sample lt reg gt lt dev gt 06 End Sub 07 08 Public Sub Form Unload Cancel As Integer 09 Set PDFPrinter Nothing 10 End Sub 11 lt dev gt lt reg gt PDF XChange Drivers API SDK 2012 11 Interface IPXCPrinter Interface PXCPrinter The IPXCPrinter ActiveX interface object is used to control all options of the PDF creation process The object with this interface is returned by the IPXCControlEx ActiveX object When printing is completed the PXCPrinter object should be released Note that releasing this object will also remove the virtual printer associated with this object Events provided by IPXCPrinter object c
56. s supplied as an ActiveX component Using its methods and properties all operations can be performed The sequence for creating a PDF file from a developer s application is 1 Create a new unique and temporary virtual printer using the PXCControlEx interface 2 Using the PXCPrinter interface returned by PXCControlEx set up all properties as required for PDF creation 3 Print to the virtual printer created by step 1 either directly from developer s application or from any 3rd party application run from this application 4 Close the created printer and destroy the temporary printer instance created Clarion for Windows Developers generally do not need to use Virtual Print Drivers to output their application reports using our products Clarion uses a method to output reports to a Windows Metafile format for viewing that our PDF Tools SDK is able to convert directly to PDF whilst still retaining the reports formatting and text data ensuring it is still a fully text searchable PDF file once created we therefore recommend that unless Clarion developer s are converting 3rd party formats such MS Office HTML AutoCAD etc to PDF they use our PDF Tools SDK and not the PDF XChange Drivers API SDK Troubleshooting In most environments the provided COM facilities are available transparently after the installation and registration are complete However for some 32 bit based IDE s for example Microsoft Visual Basic 6 running in 64 bi
57. s the IPXCPrinter object associated with this printer Declaration C object get Printer string pServerName string pPrinterName string pRegKey string pDevCode C HRESULT get Printer in BSTR pServer Name in BSTR pPrinter Name in BSTR pRegKey in BSTR pDevCode out retval VARIANT ppPrinter VB Property Printer pServerName As String pPrinterName As String pRegKey As String pDevCode As String Parameters pServerName Reserved for future use Should be a NULL or empty string pPrinterName Specifies the desired name for the printer to be created If a printer of the same name already exists then to ensure it is uniquely named the new printer name will have a suffix automatically generated based on the originally passed value Copyright 2005 2013 Tracker Software Products IPXCControlEx Object 10 Note Differences between Licensed and Evaluation use The following 2 items are provided as part of your license purchase If you are evaluating the PDF XChange Drivers API SDK all generated output will have evaluation watermarks printed on each page and these cannot be subsequently be removed Once licensed you must re compile your project embedding your license strings provided within your code as outlined above and all new PDF files generated will be free of the evaluation watermarks placed on all evaluation output All output created in evaluation mode will need to be recreated from the o
58. sets the printer associated with the IPXCPrinter object as the system default printer Method RestoreDefaultPrinter restores the system default printer which was stored during a call to the SetAsDefaultPrinter method Method AddSMTPServer adds a definition of an SMTP server which can be used for sending PDF files via email Copyright 2005 2013 Tracker Software Products Interface IPXCPrinter 54 SetRegl nfo Method SetRegl nfo This method is used to set registration information specific for developer for the printer This method may be used when registration information was not passed into the Printer property of PXCControlEx object during printer creation Declaration C void setreginfo string pRegKey string pDevCode C HRESULT setreginfo in BSTR pRegKey in pDevCode VB Sub setreginfo pRegKey As String pDevCode As String ResetDefaults Method ResetDefaults This method resets all properties to their default values as defined in the Properties sections above Declaration C void ResetDefaults C HRESULT Reset Defaults VB Sub Reset Defaults PDF XChange Drivers API SDK 2012 55 Interface IPXCPrinter ApplyOptions Method ApplyOptions This method is used to apply all properties changed with property Option This method should be called before printing onto the printer associated with the PXCPrinter object Declaration C void ApplyOptions int dwFlags C HRESULT ApplyOptions
59. t Windows this may be problematic In this event you should manually reference the type library pxccom tlb located in the PDF XChange installation directory Copyright 2005 2013 Tracker Software Products System Requirements 4 System Requirements PDF XChange Drivers API 2012 SDK supports all Windows 32 64 bit operating systems from Windows XP and later Compatible with a TOE um Windows 3 Windows 7 Version 5 2012 Microsoft Citrix Terminal Server compatible Version 4 Microsoft Citrix Terminal Server compatible Version 3 Still available for Windows 95 98 Note Though many users have virtualized some of our component products such as the PDF XChange Viewer and PDF Tools application using XenApp we do not support this at this time Particularly the printer drivers are not designed to work in a virtualized environment Limitations to product support for Windows XP To experience the best performance of our products on all Windows operating systems the onus is on users to ensure that they have all the latest available Microsoft Windows Service Packs amp Updates installed PDF XChange Drivers API SDK 2012 5 Installation Installation We provide a comprehensive installation executable for developer s to distribute with their application and this is the ONLY method authorized for distribution re engineering or disassembly of the installation package provided is specifically and absolutely prohibited Our
60. the document Keywords should be comma separated Default value empty string Specifies the Creator information field of the document Default value empty string PDF XChange Drivers API SDK 2012 43 Interface IPXCPrinter Save Using properties of this section it is possible to define the folder where PDF document should be stored the file name of the document and other document saving options Name Possible values O pdfSaver IM pena To lost Save pe D Soars jea ShowSaveDialog Boolean value Path String File String Copyright 2005 2013 Tracker Software Products Description Specifies the action which should be performed when document is spooled e pdfSaver specifies that the pdfSaver application the document creation application of PDF XChange will display the Job Management window where the action which should be performed can be specified e AppendToLast appends the newly printed document to the last job in the jobs list pdfSaver may then be used to create a PDF file from this job e Save most used generates and saves the PDF file from the printed document using other properties defined into this section e JustEmail creates the PDF file and emails it using properties defined in the EMail section Default value 2 Save If this property is True pdfSaver will display the Save As dialog where the path and file name of the PDF file must be specified Canceling the Save As dialog will c
61. tings Printing time as string Value can be formatted using format specified in extra part of the macro When no extra is specified default regional settings are used for formatting Hour of printing Format depends from regional settings Minute of printing Format depends from regional settings Seconds of printing Format depends from regional settings The name of user s computer The name login name of user who makes printing Current page number Can be used only for headers and footers Starting page number is defined by HeadersFooters FirstPageNumber property Total number of pages into the document Has a value of environment variable specified by extra string If there are no such environment variable or extra string isn t specified value of this macro will be an empty string For example Env UserName will have the login name of the user who prints Copyright 2005 2013 Tracker Software Products Interface IPXCPrinter 52 Format of picture string used to form the date string The following elements can be used to construct a format picture string If there are spaces to separate the elements in the format string these spaces will appear in the same location in the result string The letters must be in uppercase or lowercase as shown in the table for example MM not mm Characters in the format string that are enclosed in single quotation marks appear in the same location and unchanged in the output stri
62. to all remaining pages If the overlay file is a single page this will be placed on all of the generated files pages by default 2 RepeatContinuous Begin at the start of the overlay file and apply each corresponding page from this file to the corresponding page number in the generated PDF file Should the newly created file have a greater number of pages than available in the overlay file start at the beginning of the Overlay file and begin the process again applying the first page in the Overlay PDF file to the next page in the generated output PDF document in the sequence then page 2 of the overlay file to the next generated PDF document page and so on until the generated document is completed If the overlay file is a single page this will be placed on all of the generated files pages by default Default value 0 NoRepeat Specifies the horizontal alignment for the overlay pages relative to the new document s pages Default value 1 Center Specifies the vertical alignment for the overlay pages relative to the new document s pages Default value 1 Middle Fits the OverlayFile pages to match that of the host page Default value False The OverlayFile pages proportions should be retained when using other options Default value False PDF XChange Drivers API SDK 2012 37 Interface IPXCPrinter Links This property determines whether to insert live links within the PDF document what kinds of links an
63. tracHer SOFTWARE PRODUCTS PDF XChange Drivers API SDK 2012 User Manual Head Quarters Tracker Software Products Canada Ltd P O Box 79 9622 Chemainus Road Chemainus VOR IKO British Columbia Canada Sales Tel Canada 00 1 250 324 1621 Fax Canada 00 1 250 324 1623 In Europe Unit 17 Raleigh Court Priestly Way Crawley Sussex RH10 9PD England Sales Tel 44 0 20 8555 1122 Fax 00 1 250 324 1623 http www tracker software com sales tracker software com Created Thursday April 17 2014 Copyright O 2001 2014 Tracker Software Products All Rights Reserved PDF XChange Drivers API SDK 2012 copyright 2001 2014 Tracker Software Products All rights reserved http www tracker software com The information contained in this document is subject to change without notice This document contains proprietary information which is protected by copyright All rights are reserved No part of this document may be photocopied reproduced or translated to another language without the prior written consent of Tracker Software Products Table of Contents Chapter EWOO aa NA paanan ee es ee et eee eedt een eta sea ee Asha eee 1 Chapter 2 Using Drivers API SDK _ 2 0 ccc ccc EEEE EEEE EEEE 2 Chapter 2 System REQUIFTSMETMES cscs epee teres AA 4 Chapter an AN 5 Chapter 5 IPXCControlEx Object A NO eee GNUN PN PING ee o 9 Chapter 6 Interface IPO PANLAHAT NA NAN NENG LNG trant Uhd eR NG Cw a e
64. tware Products Interface IPXCPrinter 62 AddimageWatermark Method AddimageWatermark This method is used to define a new image watermark to be added to the document The parameters of this method correspond to the parameters available in the PDF XChange Driver 2012 UI during the adding editing of a text watermark page Watermarks Add button Declaration C void Addl mage Water mark string sName string sl mageFil eName int dwTranscol or int dwWidth nt dwHei ght nt dwAlign nt xOffset nt yOffset nt nAngle nt dwopacity nt dwFlags nt dwPlaceType string sRange C HRESULT Addl mage Water mar k in BSTR sName in BSTR sl mageFileName in long dwTranscolor in long dwWi dth in long dwHeight in long dwAlign in long xOffset in long yOffset in long nAngle in long dwOpacity in long dwFlags in long dwPlaceType in BSTR sRange PDF XChange Drivers API SDK 2012 63 Interface IPXCPrinter VB Sub Addl mageWater mark sName As String sl mageFileName As String dwTranscolor As Long dwWidth As Long dwHeight As Long dwAlign As Long xOffset As Long yOffset As Long nAngle As Long dwOpacity As Long dwFlags As Long dwPlaceType As Long sRange As String Parameters sName Specifies the name of the newly created watermark item This name may be used in the Watermarks property If there is already an existing watermark with the same name
65. ty define the dimension of the signature field Value are specified in tenths of a millimetre Height nteger Default value 168 Copyright 2005 2013 Tracker Software Products Interface IPXCPrinter 34 ShowFlags defines the information which should be placed on Signature field appearance It can be combination of the following values Value Meaning i If this value is used the name of the signer given from the certificate will be shown on the signature field 2 If this value is used signing date will be placed on signature field 4 If this value is used the text specified by Location property will shown 8 If this value is used the text specified by Reason property will shown 16 If this value is used Distinguished Name field from certificate will be added to the signature field 32 If this value used each text item placed on the signature field will be prepended by its corresponding label for example Name Tracker Software Ltd PDF XChange Drivers API SDK 2012 35 Interface IPXCPrinter Overlay This section contains properties which define how a newly created document can be overlayed using an existing PDF file Note Using overlays automatically disables the PDF A feature Name Possible values Enabled Boolean value OverlayFile String OverlayPassword String AsForeground Boolean value Copyright 2005 2013 Tracker Software Products Description Enables or disables overlay feature of the PDF
66. ucts Interface IPXCPrinter 64 StorePrinterOptions Method StorePrinterOptions This method is used to store all printer options into any external storage method supporting the IStream interface Declaration C void StorePrinterOptions Stream pStream C HRESULT StorePrinterOptions Stream pStream VB Sub StorePrinterOptions pStream As Stream Parameters pStream Pointer to the I Stream object into which all printer properties will be serialized Return Value The method returns S_OK if successful otherwise an error code is returned ReStorePrinterOptions Method ReStorePrinterOptions This method restores all original printer options previously saved using the method StorePrinterOptions to save to an external storage method supporting the I Stream interface Declaration C void ReStorePrinterOptions l Stream pStream PDF XChange Drivers API SDK 2012 65 Interface IPXCPrinter C HRESULT ReStorePrinterOptions l Stream pStream VB Sub ReStorePrinterOptions pStream As Stream Return Value The method returns S_OK if successful otherwise an error code is returned SetAsDefaultPrinter Method SetAsDefaultPrinter This method sets the printer associated with the IPXCPrinter object as the system default printer The original system default printer can be restored later using the method RestoreDefaultPrinter The original system default printer will be restored automatically when releasi
67. ue of the property For example O Normal means than this property can be set as the integer value O or as the string Normal Therefore both of these assignments are equivalent e pPrinter Option Paper LayoutType O e pPrinter Option Paper LayoutType Normal Within the table column Possible Values if the entry is Boolean Value then an acceptable entry maybe any of the following For the value O any one of the following strings would also be acceptable No False or Disabled For the value of 1 any one of the following strings would also be acceptable Yes True or Enable For example both of these two assignments are equivalent e pPrinter Option Compress Graphics 1 e pPrinter Option Compress Graphics Enable Please note names of properties and named values are case sensitive Copyright 2005 2013 Tracker Software Products Paper Interface IPXCPrinter 16 Properties in this section allow you to define page layouts for the created PDF document Possibl Mama ossible values O Normal fay our p e NAE 2 Booklet MirrorX Boolean Value MirrorY Boolean Value SheetSizelIndex From 2 to 41 SheetWidth 13 5080 SheetHeight LSO Description Defines the layout type used for page creation of the PDF document This property determines which other property sections are to be used Normal n Up or Booklet Default value O Normal Enables or disables horizontal mirroring of all drawin
68. uld be used for downsampling NG RADE If the value of this propertyis0 None images of this type will not be Method E downsampled 3 Bicubic Default value O None These two properties define when an image should be downsampled a A Default value 96 If the original DPI of the image is equal to or above that of the value specified by the property IfAbove the image will be downsampled to Neal the DPI specified by the property To Default value 128 Copyright 2005 2013 Tracker Software Products Interface IPXCPrinter 26 Color Convert Specifies whether color images should be converted to grayscale monochrome or black amp white Name Possible values Description 0 None Specifies how images of this type should be converted a ea Value 0 None means that no images of this type will be MAGA more 2 ToMonochrome converted 3 ToBlackAndWhite Default value O None Specifies whether images should be dithered during conversion This has meaning only for methods ToMonochrome and Dither Boolean Value ToBlackAndWhite Default value True Indexed Determines image downsampling and conversion options for indexed images with palettes e Subsection Downsample defines when and how images should be downsampled e Subsection Convert specifies whether to use color reducing for indexed images and into which format they should be converted I ndexed Downsample This subsection defines when and how images should
69. utable and doesn t contain the path of the this module For example when printing is from Microsoft Word this macro will have the value Winword exe Specifies the document name as it was passed to the PDF XChange driver by printing application via DOCINFO structure at printing start If property Save StripPath is True and document name passed by application contains a path this path will be stripped before assigning to the macro Specifies the path part if it is present of the document name passed by the printing application AppName not defined DocName not defined DocPath not defined PDF XChange Drivers API SDK 2012 51 Interface IPXCPrinter Date Year Month Day Time EOUN Minute Second Comey weg User Page Pages Env Format string See below for syntax of format string not defined not defined not defined Format string See below for syntax of format string not defined not defined not defined not defined not defined not defined not defined Environment variable name Has a value of date of document printing Value can be formatted using format specified in extra part of the macro When no extra is specified default regional settings are used for formatting Year number Format of this number two digits or four depends from regional settings Month number Format depends from regional settings Day of month as digits Format depends from regional set
70. vent will not be fired Declaration C event OnFileSent int JoblD string IpszFileName C HRESULT OnFileSent LonG JoblD BSTR IpszFileName VB Event OnFileSent JoblD As Long IpszFileName As String Parameters Parameters for this event are the same as the parameters for the OnFileSaved event PDF XChange ignores returned values from this event Copyright 2005 2013 Tracker Software Products Interface IPXCPrinter 76 Event OnError This event is fired when an error occurs during the processing of the PDF file It further indicates that the events OnFileSaved and or OnFileSent will not be fired for this document and processing of the document is terminated Declaration C event OnError int JoblD int dwErrorCode C HRESULT OnError LoNG JoblD LONG dwErrorCode VB Event OnError JoblD As Long dwErrorCode As Long Parameters Jobi D Internal Job identifier dwErrorCode Specifies an error code occurred during document processing Return Value PDF XChange ignores the returned values from this event PDF XChange Drivers API SDK 2012 77 Property Declarations Property Declarations Unsupported Property Declarations All these methods will return an E NOTIMPL error code e Event LastPrinterEvent e Method PrintDocument e Method WaitForPrintEvent Copyright 2005 2013 Tracker Software Products Index B Bookmarks 38 C Compression 23 D Digital Signatures 31 Document Informati
71. wnsampled i e have their resolution reduced 2 Color Convert defines whether color images should be converted to grayscale monochrome or black amp white 2 Subsection Indexed determines image downsampling and conversion options for indexed images with palettes 1 Indexed Downsample defines whether and how images should be downsampled i e have their resolution reduced 2 Indexed Convert defines whether color images should be converted to grayscale monochrome or black amp white 3 Subsection MonoAndDrawings determines settings for downsampling and converting monochrome images and black amp white drawings 1 MonoAndDrawings Downsample defines whether and how images should be downsampled i e have their resolution reduced 2 MonoAndDrawings Convert defines whether color images should be converted to Copyright 2005 2013 Tracker Software Products 10 11 12 13 14 15 16 17 Interface IPXCPrinter 12 grayscale monochrome or black amp white Section Fonts contains properties which define embedding and other options for fonts to be used in the PDF document Section Security defines security options for the PDF document Section DigSig Digital Signatures defines Digital Signature properties of the document and the properties for the signature used for signing Section Overlay contains properties which define how a newly created document can be overlayed using an existing PDF file Section Lin
72. ynchronous kabisa cave Re BAGA LENIN NA TABA NAA DALA KAG KAG KANA Ren RENNEN 69 Synchronous ee ee Op eal aes eda Ee rans eee en 73 Chapter 7 Property Declarations Atema AA dte eene VAA Chapter Ne tii 78 1 Welcome Welcome PDF XChange Drivers API 2012 SDK Help Manual Welcome to the Tracker Software Products online help system Browse through the help pages by clicking on the icons below or selecting pages in the table of contents to the left To quickly find specific product information enter search criteria in the search box above and click the search button Chapter Guide Most popular pages Ask Us 6 j Using Drivers API SDK Welcome System Requirements PXCControlEx Object If you re unable to Installation Using Drivers API SDK find what you re IPXCControlEx Object Interface PXCPrinter looking for in this help Interface IPXCPrinter Properties system try these Property Declarations Installation alternative resources Paper AddBookmarkltem Our Website Name Knowledgebase Asynchronous FAQ or contact our support team support tracker software com Copyright 2005 2013 Tracker Software Products Using Drivers API SDK 2 Using Drivers API SDK Who should use the PDF XChange Drivers API Developers requiring the ability to create PDF documents from their own applications Clarion Developers See below or indeed managing the output of other file formats to PDF from 3rd party applications such as MS Office

Download Pdf Manuals

Related Search

Related Contents

酵素反応実験の定量化  Lexmark S515  DW745 Heavy-Duty 10" (254 ram) Job Site Table Saw Scie  VMP73 Network media player  CG u&m EL63_11-PT, page 17 @ Preflight  4.1 Tipo de leitor  scarica file in PDF  Emerson EWC09D5 TV DVD Combo User Manual  medeaLAB Count & Classify Image Analysis System  In-Wall Rear Projection SMART Board Interactive Whiteboard  

Copyright © All rights reserved. Failed to retrieve file