Overview

The tclutil package is designed for use in a Tcl/C/C++ environment. It is made up of the following parts:

A collection of general purpose C++ classes and routines
A collection of C++ classes that support Tcl/Tk development
A library of Itcl classes and widgets

In addition, the configure script for the package exports a shell script file, tclutilConfig.sh , that can be used by the configure scripts in other packages to save work. The file sets shell variables based on information discovered by configure, in the same way as the tclConfig.sh script provided by Tcl. This tells you, for example, how to make shared libraries on a given system, the locations of various Tcl/Tk packages, the compiler name and options, etc.

The following tables give an overview of the classes and widgets found in this package. For more details, see the following section and the man pages in the Reference section.

General Purpose C++ Classes and Routines
Name	Description
Error Handling	Collection of C++ routines used to report errors. There are different versions for general errors, system errors and warnings. Some of the routines support a printf style interface. You can also supply a user defined error handler to be called for each error.
class HTTP	This is a generic class that can be used to do an HTTP GET on a given URL and return the results.
class Mem	This class makes it easy to memory map a file and use it as a string or other object in memory. SysV shared memory, mmap and malloced memory are all supported by the class in a transparent way.
Other C++ Utilities	This is a collection of general purpose C++ routines, mostly file and string operations.

C++ Classes for Tcl/Tk Development
Name	Description
TclCommand	Base class for C++ classes implementing a Tcl command (widgets and image types are also Tcl commands and are subclasses of this class).
TkWidget	Base class of C++ classes implementing a Tk image type.
TkImage	Base class of C++ classes implementing a Tk widget.

Itcl Classes and Widgets
Name	Description
Batch	Class for evaluatimg Tcl commands in the background.
ButtonFrame	Widget for a frame with a row of buttons.
CanvasDraw	Line graphic editor for a Tk canvas, supports interactive drawing, moving and resizing of various shapes, in a selected outline and fill color, width, etc.
CanvasPrint	Popup window to print the contents of a Tk canvas (Printing of embedded images is not supported in this version).
CanvasWidget	A canvas frame with optional scrollbars.
CheckEntry	A checkbutton and an entry widget in a frame.
ChoiceDialog	Popup window with a title and radiobuttons, to get the user to make a choice.
Chooser	Simple popup widget for selecting items based on filename, suffix and directory.
DialogWidget	Base class for popup dialog widgets.
DoubleList	Frame displaying 2 listboxes with arrows in between.
DoubleTableList	Frame with 2 TableList widgets and arrows in between.
EntryForm	Popup window with a configurable list of labels with entries.
FileSelect	Popup motif style file select dialog.
FrameWidget	Base class for widgets contained in a frame.
GraphPrint	Popup dialog to print a BLT graph.
InputDialog	Popup dialog to get input from the user.
LabelCheck	Frame containing a label and a checkbutton.
LabelChoice	Frame containing a label and a list of radiobuttons.
LabelEntry	Frame containing a label and an entry.
LabelEntryScale	Frame displaying a label, an entry and a scale widget (type in value or use slider).
LabelMenu	Frame displaying a label and a menubutton.
LabelMessage	Frame displaying a label and a message (for read-only items).
LabelNumber	Frame displaying a label and a number.
LabelValue	Frame displaying a label and some value.
LabelWidget	Base class of widgets with a label.
ListDialog	Dialog to display a listbox and some text in a popup window.
ListboxWidget	Listbox frame with optional scrollbars, methods to set/get selection and contents.
PrintDialog	Base class of print dialogs.
ProgressBar	Frame containing a netscape style progress bar and message.
TableList	Listbox based table widget with headings and columns formatted automatically, supports sorting, rearranging columns, printing,
TableListConfig	Popup widget for editing the table layout for the TableList class.
TableListConfigFile	Itcl class used to save configuration information for the TableList class.
TableListPrint	Print dialog for the TableList class.
TableListSort	Popup window used to set sorting options for the TableList class.
TextDialog	Popup dialog displaying a text window and a specified text.
TopLevelWidget	Base class of widgets with a top level window. Also provides methods for adding a menubar with menus and menu items at top and a short help window at the bottom. Provides support for user defined plugins for any subclass.