Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

Tk::Table (3)

Name

Tk::Table - Scrollable 2 dimensional table of Tk widgets

Synopsis

use Tk::Table;

$table = $parent->Table(-rows => number,
-columns => number,
-scrollbars => anchor,
-fixedrows => number,
-fixedcolumns => number,
-takefocus => boolean);

$widget = $table->Button(...);

$old = $table->put($row,$col,$widget);
$old = $table->put($row,$col,"Text");  # simple Label
$widget = $table->get($row,$col);

$cols = $table->totalColumns;
$rows = $table->totalRows;

$table->see($widget);
$table->see($row,$col);

($row,$col) = $table->Posn($widget);

Description

User Contributed Perl Documentation                                   Table(3)



NAME
       Tk::Table - Scrollable 2 dimensional table of Tk widgets

SYNOPSIS
         use Tk::Table;

         $table = $parent->Table(-rows => number,
                                 -columns => number,
                                 -scrollbars => anchor,
                                 -fixedrows => number,
                                 -fixedcolumns => number,
                                 -takefocus => boolean);

         $widget = $table->Button(...);

         $old = $table->put($row,$col,$widget);
         $old = $table->put($row,$col,"Text");  # simple Label
         $widget = $table->get($row,$col);

         $cols = $table->totalColumns;
         $rows = $table->totalRows;

         $table->see($widget);
         $table->see($row,$col);

         ($row,$col) = $table->Posn($widget);

DESCRIPTION
       Tk::Table is an all-perl widget/geometry manager which allows a two
       dimensional table of arbitary perl/Tk widgets to be displayed.

       Entries in the Table are simply ordinary perl/Tk widgets. They should
       be created with the Table as their parent. Widgets are positioned in
       the table using:

        $table->put($row,$col,$widget)

       If $widget is not a reference it is treated as a string, and a Lable
       widget is created with the string as its text.

       All the widgets in each column are set to the same width - the
       requested width of the widest widget in the column.  Likewise, all the
       widgets in each row are set to the same height - the requested height
       of the tallest widget in the column.

       A number of rows and/or columns can be marked as 'fixed' - and so can
       serve as 'headings' for the remainder the rows which are scrollable.

       The requested size of the table as a whole is such that the number of
       rows specified by -rows (default 10), and number of columns specified
       by -columns (default 10) can be displayed.

       If the Table is told it can take the keyboard focus then cursor and
       scroll keys scroll the displayed widgets.

       "-scrollbars". By default, scrollbars will be added "nw".  To disable
       scrollbars, set "-scrollbars" to an empty string:

         $table = $parent->Table(-scrollbars => '', ...);

       The table can be emptied using

        $table->clear

       the widgets which were in the table are destroyed.

       The Tk::Table widget is derived from a Tk::Frame, so inherits all its
       configure options.

       The default focus traversal is giving the focus only to the table
       widget as a whole. To enable focus traversal into table cells (e.g. if
       there are embedded entry widgets), then the option "-takefocus" has to
       be set to 0.

BUGS / Snags / Possible enhancements
       o   Very large Tables consume a lot of X windows.

       o   No equivalent of pack's -anchor/-pad etc. options


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+----------------------------+
       |ATTRIBUTE TYPE |      ATTRIBUTE VALUE       |
       +---------------+----------------------------+
       |Availability   | library/perl-5/perl-tk-532 |
       +---------------+----------------------------+
       |Stability      | Volatile                   |
       +---------------+----------------------------+

SEE ALSO
       Tk::grid, Tk::HList, Tk::TableMatrix, Tk::MListbox, Tk::Columns



NOTES
       Source code for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from
       http://search.cpan.org/CPAN/authors/id/S/SR/SREZIC/Tk-804.036.tar.gz.

       Further information about this software can be found on the open source
       community website at http://search.cpan.org/~srezic/Tk.



perl v5.32.0                      2019-10-20                          Table(3)