Grefgenerate

Grefgenerate
←	Chapter 6. Code Generation Preferences	→

Runtime Library Options

-creator

The RTL based option creator is used to instantiate the template grefgenerate 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.

Standard Options

-highlightThickness, -highlightColor, -highlightBackground, -borderWidth, -background, -relief: See the options manual entry for details on the standard options.

Window-specific Options

Command-Line Name: -usagevariable, Database Name: usageVariable, Database Class; -

Tcl Variable, with a boolean value. The value 1 activates the »Message Catalog« usage.

Internal used by the checkbutton in the top area.

Command-Line Name: -propertiesvariable, Database Name: propertiesVariable, Database Class; -

Tcl Variable, contains a properties list. The list is maintained by the »grefmessages« dialog. The »Message Catalog« is used for the listed properties.

Command-Line Name: -languagevariable, Database Name: languageVariable, Database Class; -

Tcl Variable, contains the default LC denoting the design language.

Command-Line Name: -variablealways, Database Name: variableAlways, Database Class; -

Tcl Variable, this variable maintains the list of properties, which are under any circumstances included in the code generation.

Command-Line Name: -variableignore, Database Name: variableIgnore, Database Class; -

Tcl Variable, the list displays all the window properties, which have to be ignored during code generation. Typical examples are »colormap«, »vinst« ...

Command-Line Name: -variablegeneratewm, Database Name: variableGenerateWM, Database Class; -

Tcl Variable, for maintaining a list of »WM« geometry properties. The properties listed in the associated list yield generated code for toplevel-wm geometry managers. Conventional properties are »title«, »geometry« ...

Command-Line Name: -substitutesvariable, Database Name: substitutesVariable, Database Class; -

Tcl Variable, contains a list of window class and substitute pairs. This variable is used inside the top multi-column listbox.

The substituted term is used during code generation instead of the term in the first column.

Command-Line Name: -ignorevariable, Database Name: ignoreVariable, Database Class; -

Tcl Variable, contains a list of window class, shown in the left bottom listbox.

Window classes inside this list, usually feature dynamic created child windows. The purpose is to exclude all its children from code generation. Jeszra cannot by itself discriminate them from user created windows.

Command-Line Name: -ignorebyrulevariable, Database Name: ignoreByRuleVariable, Database Class; -

Tcl Variable, contains a list of window classes and regular expression. This variable is used inside the right bottom listbox.

Window classes inside this list, usually feature dynamic created child windows. The purpose is to exclude such dynamic created windows, based on a rule, from code generation. Jeszra cannot by itself discriminate them from user created windows. See also »ignoreVariable« above.

Command-Line Name: -array, Database Name: array, Database Class; -

Tcl Array, this array holds the preference settings.

Command-Line Name: -subname, Database Name: subName, Database Class; -

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«.

Command-Line Name: -defaultvariable, Database Name: defaultVariable, Database Class; -

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«.

Command-Line Name: -autocommand, Database Name: autoCommand, Database Class; -

Tcl command, used to generate the »Auto« Resource »Set«. Default command is mkAutoRes 1.

Description

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

»grefgenerate« is a multi-pages preferences page. It collects the settings related to code generation.

»grefgenerate« is container window for »grefmessages«, »grefresources«, »grefcode« and »grefwindows«.

Window Command

A Window created through the grefgenerate 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:

object.cget(option): Returns the current value of the configuration option given by option. Option may have any of the values accepted by the grefgenerate command.
object.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 grefgenerate command.

Dependencies

rtl_tabset
grefmessages
grefcode
grefresources
grefwindows

←	↖	→
Grefwindows	↑	Chapter 7. Jeszra Specific Templates

Name

Synopsis