ANNOUNCE: Multi-column listbox and tree widget package Tablelist 5.5

[nemethi]

I am pleased to announce version 5.5 of the multi-column listbox and
tree widget package Tablelist.

What is new in Tablelist 5.5?
-----------------------------

1. Hidden tablelist elements are no longer excluded from the selection
(thanks to Martyn Smith for his proposal). (They are, however,
ignored when exporting the selection.)

2. Added the "cornerpath" and "cornerlabelpath" subcommands. The first
one makes it quite easy to respect the native Mac OS X look & feel,
where the vertical scrollbar appears placed under the header (thanks
to Torsten Berg for a related page on the Wiki, which provided me the
idea for these subcommands). The "cornerpath" subcommand is now used
in all demo scrips that contain vertical scrollbars.

3. Added support for the appearance-related changes introduced in Mac
OS X 10.7 (Lion).

4. On Mac OS X Aqua, the default values of the "-move(column)cursor"
and "-resizecursor" options are now native cursors. Besides
improving the look & feel of tablelist widgets on the Mac, this
change also works around the problem that on Mac OS X 10.7, Tk
versions 8.5 and 8.6 can only use native and native-mapped cursors.

5. Removed the "-labelbackground" option from Tablelist_tile, because
current versions of the tile engine no longer support setting the
background color for the header labels (and even with earlier tile
versions, some themes refused any attempt to change the background
color of the header labels).

6. Adapted the code to some changes in current tile versions, to make
sure that in disabled state the tile-based column labels will appear
in the theme-specific disabled foreground color, as it was the case
with earlier tile versions (thanks to "tombert" for his related
posting on comp.lang.tcl).

7. Improved a few binding scripts (thanks to Ulrich Seidl for his bug
report and testing).

8. Fixed a bug related to embedded windows in a tablelist used as a
tree widget (again, thanks to Ulrich Seidl for his bug report and
testing).

9. Several further improvements in the code, demo scripts, and
documentation.

How to get it?
--------------

Tablelist is available for free download from the URL

http://www.nemethi.de

The distribution file is "tablelist5.5.tar.gz" for UNIX and
"tablelist5_5.zip" for Windows. These files contain the same
information, except for the additional carriage return character
preceding the linefeed at the end of each line in the text files for
Windows.

Tablelist is also hosted on SourceForge, as part of tklib, which in
turn is contained in the tcllib project, having the address

http://sourceforge.net/projects/tcllib

How to install it?
------------------

Install the package as a subdirectory of one of the directories given
by the "auto_path" variable. For example, you can install it as a
directory at the same level as the Tcl and Tk script libraries. The
locations of these library directories are given by the "tcl_library"
and "tk_library" variables, respectively.

To install Tablelist on UNIX, "cd" to the desired directory and unpack
the distribution file "tablelist5.5.tar.gz":

gunzip -c tablelist5.5.tar.gz | tar -xf -

This command will create a directory named "tablelist5.5", with the
subdirectories "demos", "doc", and "scripts".

On Windows, use WinZip or some other program capable of unpacking the
distribution file "tablelist5_5.zip" into the directory "tablelist5.5",
with the subdirectories "demos", "doc", and "scripts".

The file "tablelistEdit.tcl" in the "scripts" directory is only needed
for applications making use of interactive cell editing. Similarly, the
file "tablelistMove.tcl" in the same directory is only required for
scripts invoking the "move" or "movecolumn" tablelist command. Finally,
the file "tablelistThemes.tcl" is only needed for applications using
the package Tablelist_tile (see next section).

Next, you should check the exact version number of your Tcl/Tk
distribution, given by the "tcl_patchLevel" and "tk_patchLevel"
variables. If you are using Tcl/Tk version 8.2.X, 8.3.0 - 8.3.2, or
8.4a1, then you should proceed as described in the "How to install it?"
section of the file "tablelist.html", located in the "doc" directory.

How to use it?
--------------

The Tablelist distribution provides two packages, called Tablelist and
Tablelist_tile. The main difference between the two is that
Tablelist_tile enables the tile-based, theme-specific appearance of
tablelist widgets; this package requires Tcl/Tk 8.4 or higher and tile
0.6 or higher. It is not possible to use both packages in one and the
same application, because both are implemented in the same "tablelist"
namespace and provide identical commands.

To be able to use the commands and variables implemented in the package
Tablelist, your scripts must contain one of the lines

package require tablelist ?version?
package require Tablelist ?version?

Likewise, to be able to use the commands and variables implemented in
the package Tablelist_tile, your scripts must contain one of the lines

package require tablelist_tile ?version?
package require Tablelist_tile ?version?

Since the packages Tablelist and Tablelist_tile are implemented in the
"tablelist" namespace, you must either import the procedures you need,
or use qualified names like "tablelist::tablelist".

For a detailed description of the commands and variables provided by
Tablelist and of the examples contained in the "demos" directory, see
the tutorial "tablelist.html" and the reference pages, all located in
the "doc" directory.

--
Csaba Nemethi http://www.nemethi.de mailto:csaba....@t-online.de