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:

(option object ?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:

(cget object :option)

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

(configure object ?: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.

(select object ?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 ...

(init object )

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

(addContent object )

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

(populateMenu object )

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

(pendingGroups object )

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

(groupAsDefault object )

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