|
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:
- 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.)
- 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.
- 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.
- 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
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".)
Themes
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:
- Default entry: Clear the setting for the currently selected entry. A default value
(from previous levels) will be used instead.
- Default list: Clear the settings for all entries in the list shown.
- Default all: Clear the settings for all configuration entries (at this level).
- Reset entry: Reset the value of the current entry to the original value
- Reset list: Reset the settings for all entries in the list shown.
- Reset all: Reset the settings for all configuration entries (at this level).
The dialog box has the following buttons:
- Save: save the current settings (at the current level)
- Apply: change the settings of the running application to the current settings
- Themes: Pop up the theme selection dialog box
- Save As: save the current settings as a theme using the save configuration as dialog box
- Select level: Select the current configuration level
- Help: show this help text
- Close: close the dialog
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.)