Command Line Options

<< Click to Display Table of Contents >>

Navigation:  PDF-XChange Editor Plus User Manual > Appendix >

Command Line Options


 

Editor-Icon 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.

 


 

Formal Syntax

 


 

<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.

 


 

Command Line Options

 


 

/addlang

 

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"

 


 

/close

 

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"

 


 

/exportp

 

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"

 


 

/exportsettings

 

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"

 


 

/fileassoc

 

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

 


 

/importp

 

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"

 


 

/importsettings

 

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"

 


 

/open - please note that /A can also be used for this command.

 

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"

 


 

/print

 

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"

 


 

/usep

 

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"

 


 

/webassoc

 

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