Managing Settings

<< Click to Display Table of Contents >>

Navigation:  PDF-Tools > Customization >

Managing Settings


 

pdftools_logo Managing Settings

 


 

GUI-Based Settings Management

 

The user Interface for PDF-Tools can be customized via the application preferences:

 

tools.preferences.location

Figure 1. PDF-Tools UI, Options Dropdown Menu, Preferences Highlighted

 

When this option is clicked, the Preferences dialog box will open:

 

ToolsPreferencesDialogue

Figure 2. Preferences Dialog Box

 

Users can browse through the different Preferences categories and customize them as desired. These settings can then be saved to file using the Export All Settings option in the Options dropdown menu of the PDF-Tools UI:

 

ExportSettings

Figure 3. PDF-Tools UI, Options Dropdown Menu, Export All Settings Highlighted

 

A similar method can be used to import settings from file using the GUI and the Import All Settings option in conjunction with a previously exported settings file. Note that settings files are stored in a unique format and cannot be edited by users.


 

Unattended Command Line Import/Export for Settings

 

PDF-Tools also supports the import/export of settings from file via the command line. All command line options for PDF-Tools are available in the manual here. The command lines used for exporting and importing settings are detailed below:

 

/ExportSettings

 

This command line exports all program settings to a specified file.

 

Syntax

 

/ExportSettings <filename>

 

Parameters

 

<filename> - is the path to the file where program settings will be saved.

 

Example

 

PDFXTools.exe /ExportSettings "c:\PDF-Tools_AppSettings.pdts"

 

/ImportSettings

 

This command line imports program settings/tools from a specified file.

 

Syntax

 

/ImportSettings[:showui=no|yes|full] <filename>

 

Parameters

 

showui – if 'yes' is specified and the <filename> is a path to a PDF-Tools export file then the Choose Tools for Import dialog box will open. This allows users to select manually the tools to be imported. (If settings are being imported then the import will take place without a dialog box).  If 'full' is specified then the main window of the user interface will be displayed, and if the <filename> is a path to a PDF-Tools export file then the Choose Tools for Import dialog box will also open. The default value is 'yes'.

<filename> - is the path to the file that contains program settings/tools. These can be created using the /ExportSettings or /ExportTools commands (or the corresponding features in the user interface).

 

Examples

 

PDFXTools.exe /ImportSettings "c:\PDF-Tools_AppSettings.pdts" - to import all settings from the file "c:\PDF-Tools_AppSettings.pdts".

PDFXTools.exe /ImportSettings:showui=full "c:\PDF-Tools_Exchange.pdtex" - to display the main window of the user interface and import tools from the file "c:\PDF-Tools_Exchange.pdtex" via the Choose Tools for Import dialog box.