HowTo:GUI SelectionPanel

From PdfsamWiki

Almost every pdfsam plugin uses the same component to let the user select pdf documents, this component is called selection panel. The selection panel can be configured to better fit the needs of the specific plugins therefore you can find it with different number of buttons or colmuns depending on the plugin that's using it. This HowTo is intended to show all the available features.

Columns

All the selected document can be sorted clicking on the column headers, a little arrow sign will be displayed showing the sort direction.

• File name: name of the selected file.
• Path: path of the selected file.
• Pages: number of pages of the selected document.
• Password: this column can be edited by the user to provide a password if the document is password protected. Protected documents are shown in yellow or red background and the user must provide a password to be able to manipulate it. Once provided the user can reload the document right clicking on the row and selecting Reload and the selection panel should show a white background and all the document informations.
• Version: the pdf version of the selected document.
• Page Selection: if the page selection is an option available with the selected plugin, a Page Selection column is shown by the selection panel. This column can be edited by the user to provide a page selection, usually allowing these options:
  • Use a single number if you are interested in a single page.
  • Use an interval if you are interested in an interval of pages (Ex. 3-15).
  • Use an interval without ending term if you are interested in all the pages coming after the first term of the interval (Ex. 4-).

All the cases above can be combined using comma separated values to create the selection string. (Ex. 3,5,15-22,35-).

Context menu

Right clicking on a row of the selection table a context menu will pop up allowing the user to perform some operations on the select document.

• Remove: removes the document form the selection table.
• Reoload: reloads the document (usually after a password has been provided).
• Move up: moves the document up in the selection table.
• Move down: moves the document down in the selection table.
• Document properties: shows the document properties panel.
• Set output file: sets the destination file/folder to a default value using as parent directory the directory where the selected document is placed.
• Export as XML: this item is available only with the merge plugin and can be used to export the selected documents in an XML file that can be used as input for the pdfsam-console.