Tablelist::ColumnCtrl 1.1.1

by

Aldo Buratti

aldo.buratti@tiscali.it


Overview

What is ColumnCtrl ?

ColumnCtrl is a small companion widget for the tablelist widget.

ColumnCtrl adds a small button on a tablelist.
This button gives you the ability to open a popup-menu allowing to hide or show the columns .

Moreover, you can open an extended control-panel allowing you to:

Note that ColumnCtrl's User-Interface is designed for internationalization; currently the following message-catalogs are available:

Columnctrl supports the tile theme-engine:
If the 'attached' tablelist is tile-based, then also the columnctrl's user-interface will be tile-based.


Download


How to use ColumnCtrl

Included demos will show you how to add a column-control to your applications.

Basically, in order to activate a column-control you only need to add 2 lines:


  package require Tablelist::ColumnCtrl
  tablelist::columnctrl::attach $tbl
   # NOTE: replace $tbl with the name of your tablelist

For detailed instructions take a look at readme.txt


Command Reference

The tablelist::columnctrl::attach Command

NAME
tablelist::columnctrl::attach - Attach a column-control to tablelist.

SYNOPSIS
tablelist::columnctrl::attach tbl

DESCRIPTION
Attach a column-control to tablelist tbl.

Note that when you destroy tbl, the column-control (and all the associated data) will be automatically destroyed. Note that you can reorder the columns only if tbl allows movable columns.


The tablelist::columnctrl::detach Command

NAME
tablelist::columnctrl::detach - Remove the column-control.
SYNOPSIS
tablelist::columnctrl::detach tbl

DESCRIPTION
Remove the column-control from tablelist tbl and delete the associated data.


The tablelist::columnctrl::configure Command

NAME
tablelist::columnctrl::configure - Configure properties.

SYNOPSIS
tablelist::columnctrl::configure tbl -neverhide { colID ... }
tablelist::columnctrl::configure tbl -nevershow { colID ... }

DESCRIPTION
The -neverhide option, never allow to hide columns { colID ... }
By default, user can hide all the columns.

The -nevershow option, never allow to show columns { colID ... }
By default, the popup-list (or the extended control-panel) will show all the columns.


The tablelist::columnctrl::controlButton Command

NAME
tablelist::columnctrl::controlButton - Return the path of the button widget attached to $tbl

SYNOPSIS
tablelist::columnctrl::controlButton tbl

DESCRIPTION
Return the path of the button widget attached to tbl. This command can be used for changing the look&feel of the button.


The tablelist::columnctrl::controlMenu Command

NAME
tablelist::columnctrl::controlMenu - Return the path of the menu widget attached to $tbl

SYNOPSIS
tablelist::columnctrl::controlMenu tbl

DESCRIPTION
Return the path of the menu widget attached to tbl. This command can be used for changing the look&feel of the menu.