Copyright © 2008, 2009 Arndt Roger Schneider

Gooleditor
Prev Appendix A. Reference Next

Name

gooleditor — Create and manipulate gooleditor windows

Synopsis

          package require gooleditor
        
          gooleditor pathName ?options ?

Runtime Library Options

-creator

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.

Standard Options

See the options manual entry for details on the standard options.

Window-specific Options

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

The »goolbar« property accepts the pathName to a Goolbar or Zoolbar window. These window will be manipulated by the Gooleditor

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

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

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

Turns a Gooleditor into a preference-like navigation page.

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

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.

Description

Figure A.5. Gooleditor


Figure A.5, “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.

gooleditor and zoolbar

gooleditor uses a goolbar for implementation, it is however able to customize »zoolbar« windows, too. The limitations, in respect to »zoolbar«, are related to fully vectorized icons. The interface and drawing model for zinc and canvas / pathCanvas are far to different to support both inside of a single control.

Images and glyph based vectors are supported for »zoolbar«.

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

Window Command

A Window created through the gooleditor command exposes various functions. Using these functions has the following general form: 

pathName 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:

pathName cget option

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

pathName 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 gooleditor command.

pathName setup

Prepares the goolbareditor. This something similar to a secondary constructor.

pathName moveTo index x y

Don't use it unconditional if the move operation has been started the following code should be deactivated ...

pathName moveInactive

Undocumented.

pathName centerInactive

Align the inactive items in the center of the editor. The inactive items are the resources of of the toolbar.

pathName init

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

pathName done

Apply changes and destroy the gooleditor »base«.

pathName apply

Figure out what text icon configuration was chosen set the -show attribute in the original toolbar destroy the editor window.

pathName removeSeparator number

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.

pathName displayed text

Changes the explanation inside the editor.

pathName destroy

Needed for tkpath 0.3, clean the gstripes local caché created inside »init ➊«.

pathName invoke index x y

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.

pathName redrawShown

Redraw the active items inside toolbar section of the editor.

pathName drop index x y

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.

Dependencies

  • goolbar

  • rtl

  • gstripes

  • gstripesMenu

  • gtkp

Prev Up Next
Zoolbar Home Gstripes
SourceForge Logo Gestalt Items