The RTL based option creator is used
to instantiate the template grefresources with a
Tk Window. The used creator window must have a
-class
property.
Acceptable Tk Windows are: toplevel for floating windows, and frame for embedded windows.
See the options manual entry for details on the standard options.
Tcl Array, this array holds the preference settings.
Variable name inside of Tcl array »-array«. The Resource »Sets« are extracted and writtem to this »-array« using »-subname« as the template.
settings,Resource,%1$s,Items
Groups and items are stored inside an associated array (hash-table). The subName is used to determine the groups. The Groups names are inserted as %1$s items into the subName in order to find the appropriated array variable ... The group names are extracted in a similar fashion. If the user applies the current resource group to the default settings ... all items of this group will be placed inside the »-defaultVariable«.
Tcl Variable, points to the default Resource »Set«. This Resource »Set« is used for code generation.
If the user applies the current resource group to the default settings ... all items of this group will be placed inside the »-defaultVariable«.
Tcl command, used to generate the
»Auto« Resource »Set«. Default command is
mkAutoRes 1
.
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.
A Window created through the grefresources command exposes various functions. Using these functions has the following general form:
object.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:
Returns the current value of the configuration option given by option. Option may have any of the values accepted by the grefresources command.
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.
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 ...
Secondary constructor, deal with platform specific margins and call for stripes. Initialize Extender. Rewritten : 11/26/2007, Roger
Merges the content of the selected sets to the content of the edited set.
Create a resource group menu from rat. Extended : 01/31/2008, Roger + stripes
Analyses the array names provided via »-subname« and collects these names as resource sets.
Applies the content of the current edited set (group) to the »-defaultVariable«.