5. Configuring ViTables — ViTables Users' Guide v2.1 documentation

### Navigation

- index
- next |
- previous |
- ViTables Users' Guide v2.1 documentation »

# 5. Configuring ViTables

As mentioned earlier, many aspects of the ViTables behaviour can be customized by you through the Settings ‣ Preferences command.

It shows a dialog offering you several customization possibilities. The dialog is made of three stacked pages, General, Look & Feel and Plugins.

The General page allows to change the ViTables behavior at startup. You can set the initial working directory to be that one from which ViTables is starting or to be the last used working directory. And you can recover your last working session.

The Look & Feel page allows to change visual aspects of the application such as fonts, colors or even the general style, so you can adapt the global aspect of ViTables to what would be expected on your platform.

From the Plugins page the plugins can be managed. You can add or remove searching paths for plugins and enable or disable the available plugins

The OK button will apply the new settings and make them permanent by saving them in the Windows registry, in a configuration file (on Unix platforms) or in a plist file (on Mac OS X platforms). Even if settings are stored in a plain text file editing it by hand is not recommended. Some settings, like fonts or geometry settings [1], are stored in a way not really intended to be modified manually.

The configuration file is divided into sections, labeled as [section_name]. Every section is made of subsections written as key/value pairs and representing the item that is being customized. Currently the following sections/subsections are available:

[Geometry] HSplitter
  the size of the horizontal splitter
[Geometry] Layout
  the position and size of toolbars and dock widgets
[Geometry] Position
  the position and size of the application window
[Geometry] VSplitter
  the size of the vertical splitter
[HelpBrowser] Bookmarks
  the list of current bookmarks of the help browser
[HelpBrowser] History
  the navigation history of the help browser
[Logger] Font
  the logger font
[Logger] Paper
  the logger background color
[Logger] Text
  the logger text color
[Look] currentStyle
  the style that defines the application look & feel. Available styles fit the most common platforms, i.e., Windows, Unix (Motif and SGI flavors), and Macintosh
[Plugins] Enabled
  the list of full paths of enabled plugins
[Plugins] Paths
  the list of paths where plugins will be searched
[Recent] Files
  the list of files recently opened
[Session] Files
  the list of files and views that were open the last time ViTables was closed
[Startup] lastWorkingDir
  the last directory accessed from within ViTables via Open File dialog
[Startup] restoreLastSession
  the last working session is restored (if possible) which means that both files and leaves that were open in the last session will be reopen at application startup.
[Startup] startupWorkingDir
  possible values are current, and last. These values indicate how the application will setup the startup working directory.
[Workspace] Background
  the workspace background brush

Footnotes

[1] | Entries in the Geometry section allow for keeping the aspect, size and position of the application window between sessions.

### Navigation

- index
- next |
- previous |
- ViTables Users' Guide v2.1 documentation »