---

Contents

• Overview
• The tablelist::convEventFields Command
• The tablelist::getTablelistPath Command
• The tablelist::getTablelistColumn Command

---

Overview

The commands described in this reference page are designed to be used in binding scripts associated with the binding tags whose names are returned by the bodytag and labeltag subcommands of the Tcl command associated with a tablelist widget.  The first two of these commands are also used in the default binding scripts associated with the binding tag TablelistBody.  For details and examples see the sections DEFAULT AND INDIVIDUAL BINDINGS FOR THE TABLELIST BODY and DEFAULT AND INDIVIDUAL BINDINGS FOR THE HEADER LABELS.

---

The tablelist::convEventFields Command

NAME

tablelist::convEventFields – Convert event fields relative to a descendant of a tablelist widget

SYNOPSIS

tablelist::convEventFields descendantPathName x y

DESCRIPTION

This command gets the path name of a tablelist widget and the x and y coordinates relative to the latter from the path name descendantPathName of one of its descendants and from the x and y coordinates x, y relative to this descendant.  The command returns these values as the components of a list consisting of three elements.

In a binding script, the descendant widget corresponds to the event field %W, which can be the tablelist's body, one of the separator frames, a label widget displaying an embedded image, or (a descendant of) an embedded window.  It can also be a header label or an additional widget placed by Tablelist into a header label for displaying a header image or a sort arrow.  Likewise, the arguments x and y correspond to the event fields %x and %y.  The three elements of the list returned by the command are usually assigned to the help variables tablelist::W, tablelist::x, and tablelist::y, by using the statement

foreach {tablelist::W tablelist::x tablelist::y} \
    [tablelist::convEventFields %W %x %y] {}

KEYWORDS

tablelist, event fields, binding script

---

The tablelist::getTablelistPath Command

NAME

tablelist::getTablelistPath – Get the path name of a tablelist widget from the path name of one of its descendants

SYNOPSIS

tablelist::getTablelistPath descendantPathName

DESCRIPTION

This command gets the path name of a tablelist widget from the path name descendantPathName of one of its descendants.

In a binding script, the descendant widget corresponds to the event field %W, which can be the tablelist's body, one of the separator frames, a label widget displaying an embedded image, or (a descendant of) an embedded window.  It can also be a header label or an additional widget placed by Tablelist into a header label for displaying a header image or a sort arrow.  The return value is often assigned to the help variable tablelist::W.

KEYWORDS

tablelist, path name, binding script

---

The tablelist::getTablelistColumn Command

NAME

tablelist::getTablelistColumn – Get the column number from the path name of a tablelist header label

SYNOPSIS

tablelist::getTablelistColumn headerLabelPathName

DESCRIPTION

This command gets the column number from the path name headerLabelPathName of a tablelist header label or of an additional widget placed by Tablelist into a header label for displaying a header image or a sort arrow.

In a binding script, the command argument corresponds to the event field %W.  The return value is often assigned to the help variable tablelist::col.

KEYWORDS

tablelist, path name, binding script