|
|
Gestalt Items |
Copyright © 2009 Arndt Roger Schneider
The RTL based option creator is used
to instantiate the template gooleditor 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.
The »goolbar« property accepts the pathName to a Goolbar or Zoolbar window. These window will be manipulated by the Gooleditor
The »displayed« property controls what part of a toolbar item is shown. Possible values are language dependent and do resemble the English terms:"Text Only", "Icon Only" and "Icon and Text". These property is used from inside the Gooleditor via ???.
Turns a Gooleditor into a preference-like navigation page.
The »custom« property accepts a procedure, which will create a custom dialog inside the gooleditor itself. The custom dialog is placed right to the »Show« menubutton.
Figure 4.4, “Gooleditor” displays a »galette« window, with »glyphs« and »vector« icons. The »Rectangle« item is being dragged into the toolbar. The toolbar items will be rearrange after the »Rectangle« was dropped into it.
The gooleditor is a toolbar customization dialog. The implementation follows the AQUA® Human User Interface Guidelines, when technically feasible.
Limitations are related to Drag'n'Drop, which does not work cross-window inside of Tcl/Tk.
The gooleditor has additional features, too. It uses: images, background and foreground bitmaps, glyph based vector icons and fully vectorized icons. Using vectors makes gooleditor »resolution independent« .
Since Drag'n'Drop is an gooleditor internal function, A »System Preferences« like design is also implemented in the gooleditor.
To-Do:
Toolbar add : Add a mark for disallowing remove from toolbar. Required for the preference panes. A customer should not being able to disable his entry points. The preference pane must be investigated further, such as: where to place the user interfaces ...
Revision : 05/19/2009, Roger Version 1.1
Allows semi-transparent drag images. These icons use the active color pair, works by-the-way very nicely for TkPath text glyphs –they are two-colored this way. See also : goolbar.tcl
A Window created through the gooleditor 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 gooleditor 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 gooleditor command.
Prepares the goolbareditor. This something similar to a secondary constructor.
Don't use it unconditional if the move operation has been started the following code should be deactivated ...
Align the inactive items in the center of the editor. The inactive items are the resources of of the toolbar.
Secondary constructor, geometry management for the »base« gooleditor. In addition, secondary controls are striped.
Tkpath 0.3 portability issue, caché must exist inside the stripes window and also destroyed when no longer needed (see.➊.
Figure out what text icon configuration was chosen set the -show attribute in the original toolbar destroy the editor window.
Cleanses a certain separator from the »show« property of the given toolbar. Separators are identified by there position inside the »show« property –they aren’t identifiable.
Needed for tkpath 0.3, clean the gstripes local caché created inside »init ➊«.
Execute an item inside the editor. If action performing is allowed, call the associated command inside the item. This is usually disallowed, except the current dialog is are preferences.
Redraw the active items inside toolbar section of the editor.
Main manipulation function. An »item« was dragged to the point »x, y«, if x and y are inside of the drop target a new entry is created for the edited toolbar. »index« might be rearranged as a side-effect.