This command sorts the items of the tablelist widget
pathName based on the elements of the column
specified by columnIndex. This is done by
invoking the sortbycolumn
subcommand of the Tcl command associated with the given tablelist
widget. If the items were last sorted in increasing order,
based on the same column given by columnIndex,
and no subsequent invocation of the resetsortinfo
subcommand was made, then the last argument passed to
sortbycolumn will be
-decreasing, otherwise
-increasing. After sorting the items, the
virtual event
<<TablelistColumnSorted>> is
generated. The command returns the corresponding sort order,
as decreasing or
increasing.
tablelist::sortByColumn is usually specified
as the value of the -labelcommand
configuration option for a tablelist widget.
