Greftools
← Chapter 4. Customize Tools →

Name

greftools — Create and manipulate greftools windows

Synopsis

          ;; package require greftools in Tcl/Tk.
          (with-ltk-greftools
             (make-instance 'greftools ?options ?))

Runtime Library Options

-creator

The RTL based option creator is used to instantiate the template greftools 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: -scripttool, Database Name: scripttool, Database Class; -

window pathName pointing to a Galette window, containing »scripts«.

A menu is created, referring to the items inside the »scriptool«. One, out of this items, can be selected and used as a custom start command for the application.

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

Tk menu window, path name to the »Tools« menu inside the main menu bar. This menu is modified by the »Tools« page inside the greftools dialog.

Description

Figure 4.1. greftools: Tools


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

»greftools« is used as a preferences page. This page allows the incorporation of external applications. In addition the scripttool is maintained by this page.

Figure 4.2. greftools: Scripts


Greftools provides the maintainment part for the scripttool and Add-ins inside the tools-menu. –The Jeszra Tools menu is deactivated on default and will be activated after the user has added some tools to it.

The scripttool is always available. It does follow the normal palettes concept –in every respect, except glyphs. The general editing stuff is also present, as a part of this configuration sheet.

Window Command

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

(scriptDelete object )

Delete the currently selected script from the »-scripttool«.

(scriptProperties object )

Display a sub dialog for editing the properties of the current selected script.

(init object )

Secondary constructor for a tools customization section inside a preferences dialog.

(selToolID object )

Get the ID of the currently selected entry inside the »tools« rtl_mlistbox.

(toolNew object )

Create a new entry inside the »-tools« menu and query for the details of this new entry. Revision : 08/31/2009, Roger–use properties-

(toolDelete object )

Delete the currently selected tool from the »-tools« menu.

(toolID object reqlabel )

Retrieve the ID for the given label »reqlabel« for the menu-entry inside the »-tools« menu of this application.

(toolProperties object ?ID? )

Display a sub dialog for editing details on the selected tool-entry from the »-tools« menu identified via »toolID«.

(refresh object )

Query the data from »-scripttool« and »-tools«. In order to redisplay the newly acquired data.

Dependencies

  • rtl

  • rtl_mlistbox

  • rtl_gridwin

  • rtl_tabset

  • gustomizescript

  • gustomizetool

  • gutilities

  • gstripes

← ↖ →
Chapter 4. Customize Tools ↑ Edittool
SourceForge Logo

Copyright © 2009–2010 Arndt Roger Schneider