The configuration system

Home    Documentation    Screenshots    Binary distributions    Source distribution   

Configuration system

The Configuration system is used to change the ClassyTk configuration settings. Keys, mousebuttons, fonts, colors, menu and toolbar definitions and some general settings can be changed.

Configuration can be changed at different levels, making it possible to eg. to change the configuration for either all ClassyTk applications or for one specific application, for all users (Default) or just one specific user (personal). At startup, a ClassyTk application will parse the settings in the different levels in the following order:

  1. Default ClassyTk settings (def)
    This level contains the most general configuration settings. They apply to any ClassyTk application, and should never be deleted. However, they can be overruled by any of the other levels. (The configuration files for this level are stored in the conf subdirectory of the ClassyTk installation directory. Most settings are in the file conf.values. Icons,menus and toolbars are stored in the corresponding conf/icons, conf/menu and conf/toolbar subdirectory.)
  2. User ClassyTk settings (user)
    Settings at this level overrule the default settings for a particular user. The settings are stored in the subdirector .classy (or equivalent depending on OS) of the home directory of the user.
  3. Default application settings (appdef)
    Settings at this level overrule the default settings for a particular application. The configuration is stored in files in the subdirectory conf of the application directory.
  4. User application settings (appuser) These configuration settings are specific to the current user (Unix) and application. Settings at this level will overrule any other settings for that appliction and user. The settings are stored in the subdirectory .classy-apps/<application name> of the users home directory (or equivalent depending on OS).


Icons cannot be changed from the Configuration dialog yet, but they can be changed by replacing the files in the icon configuration directories in the different levels. Icons are searched by name, starting at the appuser level, followed by the appdef, user and def levels. (Icons are retrieved using the command "Classy::geticon iconname".)


A theme is a file that contains a collection of configuration settings (eg. blue or gray color style, Unix or Windows keys) that can be loaded into the currently selected level using the "Themes" button and created using the "Save As" button..

The configuration dialog

The configuration dialog consists of a notebook which presents all possible configuration settings in a hierarchy. A list of settings in the current hierarchy and a pane where a selected setting can be changed is shown. At the bottom of this pane are the following buttons:

The dialog box has the following buttons:

The general configuration dialog can usually be called from the File menu, by invoking an entry labeled "Customise". (The Tcl command to popup the configuration dialog is "Classy::Config dialog". The option -node can be used to open the configuration dialog at a certain node.)

Peter De Rijk
hosted at Logo