Figure 6.1. grefresources

The command »grefresources« creates a »grefresources« window.

»grefresources« is the preference page related to the Option Database. The properties are organized in groups –the interface displays them as »Sets«.

Each group is stored inside its own variable. In order, to allow an unlimited number of predefined Resource Sets: Only the general preference array is provided to the window. The »grefresources« window does then access this array based on the implemented rule via an acronym »-subname« formatted with the »Set«.

Of special interest are: »-autocommand« and »-defaultVariable«.

The provided »autoCommand«, should parse the present project and collects the properties it finds. These properties are then listed inside a newly created »Auto« Set.

»-defaultVariable« is the working set for the code generation. The »-defaultVariable« gets filled with what was selected, after the »As Default« button was pressed.

Window Command

A Window created through the grefresources command exposes various functions. Using these functions has the following general form:

          pathName option ?arg arg ...?

PathName is the same as the window path name. Option and the args determine the exact behavior of the command. The following commands are possible for this window:

pathName cget option

Returns the current value of the configuration option given by option. Option may have any of the values accepted by the grefresources command.

pathName configure ?option? ?value option value ...?

Query or modify the configuration options of the window. If no option is specified, returns a list describing all of the available options for pathName (see Tk_ConfigureInfo for information on the format of this list). If option is specified with no value, then the command returns a list describing the one named option (this list will be identical to the corresponding sublist of the value returned if no option is specified). If one or more option-value pairs are specified, then the command modifies the given window option(s) to have the given value(s); in this case the command returns an empty string. Option may have any of the values accepted by the grefresources command.

pathName select ?group?

Interaction, in response to a menu set selection. Retrieves the content from the selected set and displays it inside the set gistbox.

A group has been selected populate the group list with the members of the selected group ...

pathName init

Secondary constructor, deal with platform specific margins and call for stripes. Initialize Extender. Rewritten : 11/26/2007, Roger

pathName addContent

Merges the content of the selected sets to the content of the edited set.

pathName populateMenu

Create a resource group menu from rat. Extended : 01/31/2008, Roger + stripes

pathName pendingGroups

Analyses the array names provided via »-subname« and collects these names as resource sets.

pathName groupAsDefault

Applies the content of the current edited set (group) to the »-defaultVariable«.