<< Click to Display Table of Contents >> Navigation: PDF-XChange Editor Plus User Manual > Appendix > Command Line Options |
The command line options detailed below are available in PDF-XChange Editor. Please note:
•If any values have spaces, backslashes or forwardslashes then the entire options list should be enclosed in quotation marks.
•If the optionslistfile contain spaces then it should be enclosed in quotation marks.
•If a profile is specified then changes will be made to that profile. If a profile is not specified then the changes will apply only to the current printer's settings.
•These options are for the PDFXEdit.exe executable, the default location of which is:
"C:\Program Files\Tracker Software\PDF Editor"
•Unless the path to PDFXEdit.exe is added to the system %path% variable, the full path to PDFXEdit.exe must be specified.
•Use semicolons to delimiter options when more than one option is being used.
<anytext> means any text string.
<a>|<b> means <a> or <b>.
[expression] is the optional part of the command line. For example if the syntax is: /print[:[default[=yes|no]][;showui[=yes|no]]] <filename> then the following examples are correct:
/print "c:\example.pdf"
/print:default "c:\example.pdf"
/print:default;showui "c:\example.pdf"
/print:default=yes;showui=yes "c:\example.pdf"
<filename> means full or relative path to file. When the path contains white spaces it should be enclosed in quotation marks. For example: c:\MyDocuments\MyTestDocument.pdf should be "c:\My Documents\My Test Document.pdf".
<pagesrange> specifies the range of pages to be processed. See here for further information.
This command installs new UI-languages from a special UI-languages pack. The UI-languages pack is a zip-archive that contains one or more *.xcl files. The format of the file will be .xclpack. See here for a list of available language packs for PDF-XChange Editor.
Syntax
/addlang[:[mode=]ask|user|all]] <filename>
Parameters
•mode=ask – asks user about installing mode: “for this user only” or “for all users on this machine”. This is the default mode.
•mode=user – installs new UI-languages silently, for only the current user.
•mode=all – installs new UI-languages silently, for all users on the target machine.
Please note that system administrator privileges are required when making changes that affect all users.
Example
PDFXEdit.exe /addlang:mode=user "c:\Users\John\Downloads\German.xclpack"
This command closes open documents according to the specified source file name.
Syntax
/close[:[mode=]save|discard|ask]
Parameters
•mode=ask – if the document has been edited then the software will prompt the user about saving changes before it closes. This is the default mode.
•mode=discard – closes the document silently, i.e. without prompting the user about saving changes.
•mode=save – if the document has been edited then the software saves changes silently before closing.
Examples
PDFXEdit.exe /close "c:\example.pdf"
PDFXEdit.exe /close:mode=save "c:\example.pdf"
PDFXEdit.exe /close:discard "c:\example.pdf"
This command exports all the application settings to a specified file. It creates a new file with a special format that contains all the non-default options.
Syntax
/exportp <filename>
Parameters
There are no available parameters for this command.
Example
PDFXEdit.exe /exportp "c:\PXCEditor.MySettings.Backup.dat"
This command exports settings of the application to a file on the local computer.
Syntax
/exportsettings[:<parameters>] <filename>
Parameters
•settings – exports all application settings. Supported values are: yes, no, 1, 0, true, false. The default value is true.
•stamps – exports all custom stamps collections. Supported values are: yes, no, 1, 0, true, false. The default value is false.
•history – exports the opening history of the active document. Supported values are: yes, no, 1, 0, true, false. The default value is true.
•pluginsdata – exports the advanced plugins data. Supported values are: yes, no, 1, 0, true, false. The default value is false.
Examples
PDFXEdit.exe /exportsettings "c:\PDFXChangeEditorSettings.xces"
PDFXEdit.exe /exportsettings:history=no "c:\PDFXChangeEditorSettings.xces"
PDFXEdit.exe /exportsettings:history=no;stamps=yes;pluginsdata=yes "c:\PDFXChangeEditorSettings.xces"
This command determines the file associations for PDF-XChange Editor.
Syntax
/fileassoc[:user=no|yes]
Parameters
•user=no - then file associations will be placed in HKEY_ LOCAL_MACHINE.
•user=yes - then file associations will be placed in HKEY_CURRENT_USER and HKEY_ LOCAL_MACHINE.
Example
PDFXEdit.exe /fileassoc:user=yes
This command launches PDF-XChange Editor and imports application settings from the specified file to the system registry or, in the case of portable applications, to a special settings file. The input file must be in the same format as the /ExportP command detailed below.
Syntax
/importp <filename>
Parameters
There are no available parameters for this command.
Example
PDFXEdit.exe /importp "c:\PXCEditor.MySettings.dat"
This command imports all settings from a file on the local computer created by the /ExportSettings command, or by the feature Menu/Edit/Export Settings. This can also be achieved via the feature Menu/Edit/Import Settings.
Syntax
/importsettings[:<parameters>] <filename>
Parameters
•settings – imports all application settings. Supported values are: yes, no, 1, 0, true, false. The default value is true.
•stamps – imports all custom stamps collections. Supported values are: yes, no, 1, 0, true, false. The default value is true.
•history – imports the opening history of the active document. Supported values are: yes, no, 1, 0, true, false, merge. The default value is true. The merge value can be used to combine the history of the active document with new values during import.
•pluginsdata – import advanced plugins data. Supported values are: yes, no, 1, 0, true, false. The default value is true.
Examples
PDFXEdit.exe /importsettings "c:\PDFXChangeEditorSettings.xces"
PDFXEdit.exe /importsettings:history=merge "c:\PDFXChangeEditorSettings.xces"
PDFXEdit.exe /importsettings:history=merge;stamps=yes;settings=no "c:\PDFXChangeEditorSettings.xces"
This command opens documents from a specified file and determines the custom view location, search words and highlight rectangles as necessary.
Syntax
/A <param1>=<value1>[;<param2>=<value2>[;...]][=OpenParameters] <filename>
Parameters
•nameddest=<destName> – specifies a named destination in the PDF document.
•page=<pageNum> – uses an integer value to specify a numbered page in the document. The document’s first page has a pageNum value of 1.
•comment=<commentID> – specifies a comment on a given page in the PDF document. Use the page parameter before this command. For example:
•page=1;comment=452fde0e-fd22-457c-84aa-2cf5bed5a349
•zoom=<scale>[,<left>,<top>] – sets the zoom and scroll factors using float or integer values. For example, a scale value of 100 indicates a zoom value of 100%. Scroll values left and top are in a coordinate system where 0,0 represents the top left corner of the visible page regardless of document rotation.
•view=Fit|FitH[,<top>]|FitV[,<left>]|FitB|FitBH[,<top>]|FitBV[,<left>] – sets the view of the displayed page using the keyword values defined in the PDF language specification. For more information, see the PDF Reference. Scroll values left and top are floats or integers in a coordinate system where 0,0 represents the top left corner of the visible page, regardless of document rotation. Use the page parameter before this command.
•viewrect=<left>,<top>,<width>,<height> – sets the view rectangle using float or integer values in a coordinate system where 0,0 represents the top left corner of the visible page, regardless of document rotation. Use the page parameter before this command.
•pagemode=<bookmarks|thumbs|none> – displays bookmarks or thumbnails. The default setting is none.
•scrollbar=1|0 – turns scrollbars on or off.
•search=<wordList> – opens the Search pane and performs a search for the words in the specified word list. All matching words are highlighted in the document. The words list must be enclosed in quotation marks and separated by spaces. It is only possible to search for single words. For example: search="sample search words" will locate and highlight the words sample, search and words. When searching for multiple terms they must be adjacent in the content, i.e. separated by only white space/simple punctuation, or they will not be identified.
•highlight=<left>,<right>,<top>,<bottom> – highlights a specified rectangle on the displayed page. Use the page parameter before it. The rectangle values are integers in a coordinate system where 0,0 represents the top left corner of the visible page, regardless of document rotation.
•fullscreen[=yes|no] – when enabled, the document will open in full screen mode.
•password=<password> – specifies the password string to open silently a password-protected document.
•usept[=yes|no] – when specified, all values for positioning are absolute and measured in points (1/72 inch).
Examples
PDFXEdit.exe /A zoom=1000 "c:\example.pdf"
PDFXEdit.exe /A "page=255;zoom=200;pagemode=thumbs;search=lazy dog" "c:\example.pdf"
This command prints pages from specified documents.
Syntax
/print[:[default[=yes|no]][;showui[=yes|no [;printer=<printername>][;pages=<pagesrange>]] <filename1> [<filename2> ... <filenameN>]
Parameters
•default - if specified then default parameters will be used for printing. PDF-XChange Editor uses the most recently used print parameters by default.
•showui - if specified then the standard print dialogue will be displayed before printing. The default setting is that the application prints pages silently (without user interaction).
•printer - is used to specify the printer to be used. The default printer will be used when this option is not enabled.
•pages - is used to specify the page range to be printed. All pages of the active document will be printed when this option is not enabled.
Example
PDFXEdit.exe /print:default=yes;showui=yes;printer="PDF-XChange Printer" "c:\example.pdf"
/runjs
This command launches JavaScript.
Syntax
/runjs[:log[=yes|no]] <scriptfilename> [<filename1> ... <filenameN>]
Parameters
•log=yes|no – if specified without a value, or the value is yes, then the application creates a log when this command is executed. The log file _RunJSLog.txt will be added to the program folder on the local computer.
•<scriptfilename> – specifies the full path to the text file that contains the JavaScript.
Example
The following command line adds a 'Draft' stamp to all pages in the active document:
PDFXEdit.exe /runjs "c:\AddDraftStampToAllPages.txt" "c:\example.pdf"
This command instructs the application to use the input file as the source for all settings.
Syntax
/usep[:readonly[=yes|no]] <filename>
Parameters
•readonly – if specified then the input file with the application settings will be used as "read-only" and will not be changed when the application is closed.
Example
PDFXEdit.exe /usep:readonly "c:\PXCEditor.MySettings.dat"
This command determines the mime type (web browser) associations for PDF-XChange Editor.
Syntax
/webassoc[:user=no|yes]
Parameters
•user=no - then mime type associations will be placed in HKEY_ LOCAL_MACHINE.
•user=yes - then mime type associations will be placed in HKEY_CURRENT_USER and HKEY_ LOCAL_MACHINE.
Example
PDFXEdit.exe /webassoc:user=yes