Description

Figure 7.1. gestalt


The »gestalt« command creates the »Jeszra« main window.

Purpose: composes the user interface of Jeszra.

Key Features

Dynamic menus

Dynamic menus are required to circumference various TK Menu Bugs under AQUA (refresh).

Note: the menus are first generated inside the init function; to ensure there are menus at all. This is also required in order to have active accelerators just after launch.

Palettes

Palettes are a special kind of toolbars, using the goolbar template.

Toolbar, Statusbar, Tooltips

Application typical decorational elements.

Inspector, Hierarchy

»Jeszra« specific elements.

Scripttool

Scripttool is also a palette, intended for recording and playback of scripts.

Window Command

A Window created through the gestalt 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 gestalt 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 gestalt command.

(unmanagedWindow object )

Remove the selected window from geometry management. Hide the window.

(addSectionAfter object container row )

Grid Menu. Increase the grid inside the container of the current selected window, by adding a new section row after it.

(showTextOnly object )

Hide the icons inside the palettes.

(analyzeScript object history )

Evaluation & substitution for historic commands

Stop recording and analyze what's been recorded process history data . remove index from each entry .. substitute defined command patterns ... substitute defined atoms.

Substitution. A substitution does occur whenever a context definition was inserted into the history. Such a context is defined as a history script with an action context. In addition the action (context) is added as a comment to the substitution command. A substitution will be applied on the following commands and on the previous command. The previous command is embedded within the substitution! Requiring that the previous command returns with the item of substitution.

Example:

newWidget ...
set frame_1 .top_1.frame_1;
set frame_1 [newWidget...];

(showStatusbar object )

Displays the status-bar at the bottom of the window.

(open object )

Open a project from disc.

(delete object )

Remove the current window.

(enterMenu object )

Executed in response to a F10-Key. A previously hidden menubar is displayed in response to the F10-Key.

(about object ?stream? )

Display copyright informations.

(addRowBefore object container row )

Grid Menu. Increases the grid inside the container of the current selected window, by adding a new row before it.

(perlWrapper object )

Undocumented.

(paste object )

Paste the content of the clipboard under the current selected window.

(closeTest object )

(scripts object )

Don’t use »scripttool« here, because this will launch the script editor. These editor displays the recorded stuff to the point of calling. Scripts is thus a substitute for accessing the dedicated scripttool window.

(test object )

Run the current project in a special test environment. This environment is configured through »tcltest.tcl«.

(isTemplate object )

Test whether the current window is the root window of a template –Internal used to generate DocBook, Elisp, Lisp.

(hierarchy2Svg object ?svgfile? )

Make a SVG screen-shot from the current hierarchy view -- including the tabset.

(gridManager object )

Undocumented.

(lispWrapper object )

Generate a Lisp Wrapper class for the selected tempalte.

(window2Svg object window ?svgfile? )

Make a screen-shot from a given child »window«.

(redo object )

Redo the previous action.

(rubyWrapper object )

Generate a Ruby Wrapper class for the selected template.

(showToolbar object )

Displays the main toolbar.

(hideToolbar object )

Unmaps the main toolbar.

(flatHierarchy object )

Turns the flat hierarchy mode on.

Flat hierarchy means that all windows are direct children of the toplevel window.

The container window will be different from the parent window.

(svgScreenshot object )

Create a SVG Screens hot from the selected toplevel window.

(filtersDef object )

Define initial filter definition. Button, menubutton, checkbutton & radiobutton are defined her in order to circumvent tile related stuff...

(actions object )

-

(packManager object )

Set the next used geometry manager to »pack«. This setting is permanent, until another geometry manager gets chosen.

(new object ?type? ?style? )

Create a new project of »type« and variant »style«.

(scripttool object )

Initialize the Tcl history mechanism.

(hideStatusbar object )

Hide the Status-bar at the bottom of the window.

(pythonWrapper object )

Generate a Python Wrapper class for the selected template.

(embeddedHelplines object )

Helpline editor for embedded Helplines. fixme (Roger) 04/21/2008 : Doesn't work properly. Help lines show/hide doesn't operate Remove Help lines doesn't work, either. Need to extend gelplines and hlines.

NOT YET USABLE

(importCode object )

(inspector object )

Return the current inspector.

(showTooltips object )

Activates interactive tool tips.

(statusbar object )

Return the current status bar to the caller.

(palettes object )

Give path to the palettes window

(windowManager object )

Set the next used geometry manager to »parent«. This setting is permanent, until another geometry manager gets chosen.

The »parent« geometry manager stands for any window built-in geometry manager.

Under normal conditions, the built-in geometry manager is anyway dominant to any other manager. This setting is only useful when the built-in geometry manager was turned of for the related window. See »grepkproperties« Built-in Manager.

(showMenubar object )

Displays a formerly hidden menubar. As a side-effect the show menubar button is destroyed.

(hideMenubar object )

hideMenubar places a small button as a place holder for the main menu bar. The menu bar is removed..

(customManager object manager )

Set the next used geometry manager to »manager«. This setting is permanent, until another geomentry manager gets chosen.

(customizeToolbar object ?toolbar? )

Starts and initialize the goolbarEditor For the provided toolbar.

The toolbar will be modified accordingly (the -show property).

(close object )

Close the current project.

(importIcons object )

Import the specified image file into the current project.

(isToplevel object )

Test whether the current window is a toplevel window –Internal used for SVG.

(hideTooltips object )

Disable interactive tool tips.

(runtimeEnvironment object )

Create »pkgIndex.tcl« and »tclIndex.tcl« inside the project directory.

(emacsSkeletons object )

Create Emacs skeletons for the selected template.

(saveAs object )

Undocumented.

(cut object )

Copy the selected windows to the clipboard and erase them.

(showHelplines object ?state? )

Display dynamic help lines.

(attachHandleToMenubar object )

Put a menubar hide button in the menubar. The function searches for the clone of the menubar and »place« a »handle« button in its left side.

X11, only.

(insertNextTo object )

Mark the current selected window as the insertion point. The next new window is put underneath this window.

(postAllMenus object ... )

Undocumented.

(placeManager object )

Set the next used geometry manager to »place«. This setting is permanent, until another geomentry manager gets chosen.

(xcodeMacros object )

Create XCode Text macros for the selected template.

(mytbicons object )

Creates a »giconscale« window. Similar to »myicons«, but exclusively dedicated to the main toolbar.

(inspector2Svg object ?svgfile? )

Make a SVG screen-shot from the current inspector edit session –only from the main inspector.

(evalEnsure object interp item )

Visit all palette windows and evaluate their »ensure« property with »item« inside the current project (»interp«).

(closeRun object )

Close the test project.

(pasteSpecial object )

Use a custom paste operation, in order to apply previous copied windows.

(undo object )

Undo the previous action.

(showStuff object ?showIcon? ?showText? )

Internal used; display the icon and text inside of palette windows according to »showIcon« and »showText«.

(showShell object )

Display an interactive console window. Revision : 09/18-28/2009, Roger–extendB and transient-

(find object )

Displays the »Find« Dialog. Revision : 09/09/2009, Roger

(docbook object )

Generate a DocBook Refentry for the selected tempalte.

(editHelplines object )

Display the »Help line Editor«. The help line editor is displayed and configured to work on the current window.

If the help line editor was previously open, then it is only reconfigured. Use the generic helplines property access. Revision : 09/09/2009, Roger

(addRowAfter object container row )

Grid Menu. Increase the grid inside the container of the current selected window, by adding a new row after it.

(copy object )

Copy the selected windows to the clipboard.

(quit object )

Terminate »Jeszra« and store the current preferences in a customization file.

(showPreferences object )

Display the preference dialog and register a refresh handler for modified settings.

(showIconOnly object )

Hide the text inside the palettes.

(init object )

Initialize gestalt. Populate palettes. Create the scripttool.

(containerOnly object ?state? )

Allow the window being dragged to the same container only. No sibling, nice or nephew is allowed. Apply current setting to current project –only.

(toolsmenu object )

Provides access to the »Tools« menu inside the main menu bar.

(hideHelplines object )

Hide dynamic help lines.

(removeRow object container row )

Grid Menu. Decrease the grid inside the container of the selected window, by removing the current row.

(hierarchy object )

Return the current hierarchy view.

(closeEdits object )

Close all open projects, including the test environment.

(save object )

Save the current project to disc.

(addSectionBefore object container row )

Grid Menu. Increases the grid inside the container of the current selected window, by adding a new section row before it.

(helplinesdialog object )

Return the current helplines dialog.

(deepHierarchy object )

Turns the »deephierarchy« mode on. This is default behavior.

In a deep hierarchy the parent window shall also be the container. Multiple levels of containing windows may exist.

(toggleToolbar object )

Switch the visibility from hidden to shown and vise-versa for the main toolbar.

Needed under Tk 8.5 / AQUA, to control the toolbar visibility from the title-bar.

(searchdialog object )

Return the current search dialog.

(tile object )

Looks for tile substitutions inside the option database.

(newmenu object )

Provides access to the »New« sub menu inside the »File« menu of the main menu bar.

(showIconText object )

Display both: icons and text inside the palettes.