#!/import/bw/tools/local/perl-5.8.0/bin/perl -w
eval 'exec /import/bw/tools/local/perl-5.8.0/bin/perl -w -S $0 ${1+"$@"}'
if 0; # not running under some shell
use lib Tk->findINC('demos/widget_lib');
use Tk::widgets qw/Dialog ErrorDialog ROText/;
use subs qw/invoke lsearch see_code see_vars show_stat view_widget_code/;
use vars qw/$MW $FONT $WIDTRIB/;
use vars qw/$CODE $CODE_RERUN $CODE_TEXT $VARS $VIEW $VIEW_TEXT/;
use vars qw/$BRAKES $LIGHTS $OIL $SOBER $TRANS $WIPERS/;
use vars qw/$COLOR $FONT_STYLE $POINT_SIZE $DEMO_FILE %DEMO_DESCRIPTION/;
$MW = Tk::MainWindow->new;
$MW->configure(-menu => my $menubar = $MW->Menu);
@WidgetWrap::ISA = qw/Tk::MainWindow/;
# This magic conspires with widget's AUTOLOAD subroutine to make user
# contributed demonstrations that don't use WidgetDemo embed properly.
# The trick works because widget creates a superclass of Tk::MainWindow
# which invokes WidgetDemo() implicitly. You loose if you bypass the
# inheritance mechanism and call Tk::MainWindow directly.
my ($name) = $::DEMO_FILE =~ m#([^/]+).pl$#;
$::MW->WidgetDemo(-name => $name, -text => $::DEMO_DESCRIPTION{$name});
@MainWindow::ISA = 'WidgetWrap';
$MW->title('Widget Demonstration');
$FONT = '-*-Helvetica-Medium-R-Normal--*-140-*-*-*-*-*-*';
my $widget_lib = Tk->findINC('demos/widget_lib');
my $wd = "$widget_lib/WidgetDemo.pm";
$WIDTRIB = Tk->findINC('demos/widtrib');
$WIDTRIB = $ENV{WIDTRIB} if defined $ENV{WIDTRIB};
$WIDTRIB = $ARGV[0] if defined $ARGV[0];
# The code below creates the main window, consisting of a menu bar
# and a text widget that explains how to use the program, plus lists
# all of the demos as hypertext items.
my $file = $menubar->cascade(qw/-label File -underline 0 -menuitems/ =>
[cascade => '~View', -menuitems =>
[command => '~widget', -command => [\&view_widget_code, __FILE__]],
[command => '~WidgetDemo', -command => [\&view_widget_code, $wd]],
], # end cascade menuitems
[command => '~Quit', -command => [\&exit]],
my $help = $menubar->cascade(qw/-label Help -underline 0 -menuitems/ =>
my $T = $MW->Scrolled('ROText',
)->grid(qw/-sticky nsew/);
$MW->gridRowconfigure( 0, -weight => 1); # allow expansion in both ...
$MW->gridColumnconfigure(0, -weight => 1); # ... X and Y dimensions
my $status = $MW->Label(-textvariable => \$STATUS_VAR, qw/-anchor w/);
$status->grid(qw/-sticky ew/);
# Create a bunch of tags to use in the text widget, such as those for
# section titles and demo descriptions. Also define the bindings for
$T->tagConfigure(qw/title -font -*-Helvetica-Bold-R-Normal--*-180-*-*-*-*-*-*/);
$T->tagConfigure(qw/demo -lmargin1 1c -lmargin2 1c -foreground blue/);
$T->tagConfigure(qw/hot -background black -foreground white/);
$T->tagConfigure(qw/visited -lmargin1 1c -lmargin2 1c -underline 1/);
$T->tagConfigure(qw/hot -relief raised -borderwidth 1 -foreground red/);
$T->tagConfigure(qw/visited -lmargin1 1c -lmargin2 1c -foreground/ =>
$T->tagBind(qw/demo <ButtonRelease-1>/ => \&invoke);
$T->tagBind(qw/demo <Enter>/ => [sub {
my($x, $y) = ($e->x, $e->y);
$last_line = $text->index("\@$x,$y linestart");
$text->tagAdd('hot', $last_line, "$last_line lineend");
$text->configure(qw/-cursor hand2/);
show_stat $sv, $text, $text->index('current');
$T->tagBind(qw/demo <Leave>/ => [sub {
$text->tagRemove(qw/hot 1.0 end/);
$text->configure(qw/-cursor xterm/);
$T->tagBind(qw/demo <Motion>/ => [sub {
my($x, $y) = ($e->x, $e->y);
my $new_line = $text->index("\@$x,$y linestart");
if ($new_line ne $last_line) {
$text->tagRemove(qw/hot 1.0 end/);
$text->tagAdd('hot', $last_line, "$last_line lineend");
show_stat $sv, $text, $text->index('current');
# Create the text for the text widget.
$T->insert('end', "Perl/Tk Widget Demonstrations\n", 'title');
"\nThis application provides a front end for several short scripts that demonstrate what you can do with Tk widgets. Each of the numbered lines below describes a demonstration; you can click on it to invoke the demonstration. Once the demonstration window appears, you can click the \"See Code\" button to see the Perl/Tk code that created the demonstration. If you wish, you can edit the code and click the \"Rerun Demo\" button in the code window to reinvoke the demonstration with the modified code.\n");
# Define globals for demo toplevels, informative text with tags for
# highlighting and specifying the demo's file name.
$T->insert('end', "\n", '',
"Labels, buttons, checkbuttons, and radiobuttons\n", 'title');
$T->insert('end', "1. Labels (text and images).\n", [qw/demo demo-labels/]);
$T->insert('end', "2. Buttons.\n", [qw/demo demo-button/]);
$T->insert('end', "3. Checkbuttons (select any of a group).\n",
$T->insert('end', "4. Radiobuttons (select one of a group).\n",
$T->insert('end', "5. A 15-puzzle game made out of buttons.\n",
$T->insert('end', "6. Iconic buttons that use bitmaps.\n",
$T->insert('end', "7. Two labels displaying images.\n",
$T->insert('end', "8. A simple user interface for viewing images.\n",
$T->insert('end', "\n", '', "Listboxes\n", 'title');
$T->insert('end', "1. 50 states.\n", [qw/demo demo-states/]);
$T->insert('end', "2. Colors: change the color scheme for the application.\n",
$T->insert('end', "3. A collection of famous sayings.\n",
[qw/demo demo-sayings/]);
$T->insert('end', "\n", '', "Entries\n", 'title');
$T->insert('end', "1. Without scrollbars.\n", [qw/demo demo-entry1/]);
$T->insert('end', "2. With scrollbars.\n", [qw/demo demo-entry2/]);
$T->insert('end', "3. Simple Rolodex-like form.\n", [qw/demo demo-form/]);
$T->insert('end', "\n", '', "Text\n", 'title');
$T->insert('end', "1. Basic editable text.\n", [qw/demo demo-texts/]);
$T->insert('end', "2. Text display styles.\n", [qw/demo demo-style/]);
$T->insert('end', "3. Hypertext (tag bindings).\n", [qw/demo demo-bind/]);
$T->insert('end', "4. A text widget with embedded windows.\n",
$T->insert('end', "5. A search tool built with a text widget.\n",
$T->insert('end', "\n", '', "Canvases\n", 'title');
$T->insert('end', "1. The canvas item types.\n", [qw/demo demo-items/]);
$T->insert('end', "2. A simple 2-D plot.\n", [qw/demo demo-plot/]);
$T->insert('end', "3. Text items in canvases.\n", [qw/demo demo-ctext/]);
$T->insert('end', "4. An editor for arrowheads on canvas lines.\n",
$T->insert('end', "5. A ruler with adjustable tab stops.\n",
$T->insert('end', "6. A building floor plan.\n", [qw/demo demo-floor/]);
$T->insert('end', "7. A simple scrollable canvas.\n", [qw/demo demo-cscroll/]);
$T->insert('end', "8. Tiles and transparent images.\n", [qw/demo demo-transtile/]);
$T->insert('end', "\n", '', "Scales\n", 'title');
$T->insert('end', "1. Vertical scale.\n", [qw/demo demo-vscale/]);
$T->insert('end', "2. Horizontal scale.\n", [qw/demo demo-hscale/]);
$T->insert('end', "\n", '', "Menus\n", 'title');
$T->insert('end', "1. A window containing several menus and cascades.\n",
$T->insert('end', "2. Like above, but in a manner particular to Perl/Tk.\n",
$T->insert('end', "3. Menubuttons.\n", [qw/demo demo-menbut/]);
$T->insert('end', "\n", '', "Common Dialogs\n", 'title');
$T->insert('end', "1. Message boxes.\n", [qw/demo demo-msgBox/]);
#$T->insert('end', "2. File selector.\n", [qw/demo demo-fselect/]);
$T->insert('end', "2. File selection dialog.\n", [qw/demo demo-filebox/]);
$T->insert('end', "3. Color picker.\n", [qw/demo demo-clrpick/]);
$T->insert('end', "\n", '', "Simulations\n", 'title');
$T->insert('end', "1. Balls bouncing in a cavity.\n", [qw/demo demo-bounce/]);
$T->insert('end', "\n", '', "Miscellaneous\n", 'title');
$T->insert('end', "1. The built-in bitmaps.\n", [qw/demo demo-bitmaps/]);
$T->insert('end', "2. A dialog box with a local grab.\n",
[qw/demo demo-dialog1/]);
$T->insert('end', "3. A dialog box with a global grab.\n",
[qw/demo demo-dialog2/]);
$T->insert('end', "\n", '', "User Contributed Demonstrations\n", 'title');
opendir(C, $WIDTRIB) or warn "Cannot open $WIDTRIB: $!";
my(@dirent) = grep /^.+\.pl$/, sort(readdir C);
unshift @dirent, 'TEMPLATE.pl'; # I want it first
while ($_ = shift @dirent) {
next if /TEMPLATE\.pl/ and $i != 0;
unless (open(C, "$WIDTRIB/$_")) {
warn "Cannot open $_: $!" unless /TEMPLATE\.pl/;
my($name) = /^(.*)\.pl$/;
my($title) = /^#\s*(.*)$/;
$DEMO_DESCRIPTION{$name} = $title;
$T->insert('end', ++$i . ". $title\n", ['demo', "demo-$name"]);
# Create all the dialogs required by this demonstration.
my $DIALOG_ABOUT = $MW->Dialog(
-title => 'About widget',
-text => " widget\n\nPerl Version $]" .
"\nTk Version $Tk::VERSION\n\n 2000/07/07",
$help->cget(-menu)->entryconfigure('About',
-command => [$DIALOG_ABOUT => 'Show'],
my $DIALOG_ICON = $MW->Dialog(
-title => 'Bitmap Menu Entry',
-text => 'The menu entry you invoked displays a bitmap rather than a text string. Other than this, it is just like any other menu entry.',
$DIALOG_ICON->configure(-bitmap => undef); # keep -w from complaining
# This routine handles the loading of most demo methods.
$DEMO_FILE = "$WIDTRIB/${demo}.pl" if -f "$WIDTRIB/${demo}.pl";
$DEMO_FILE = "$widget_lib/${demo}.pl" if -f "$widget_lib/${demo}.pl";
goto &$::AUTOLOAD if defined &$::AUTOLOAD;
# This procedure is called when the user clicks on a demo description.
my $index = $text->index('current');
my @tags = $T->tagNames($index);
my $i = lsearch('demo\-.*', @tags);
my($demo) = $tags[$i] =~ /demo-(.*)/;
$T->tagAdd('visited', "$index linestart", "$index lineend");
# Search the list using the supplied regular expression and return it's
# ordinal, or -1 if not found.
for ($i=0; $i<=$#list; $i++) {
return $i if $list[$i] =~ /$regexp/;
# This procedure creates a toplevel window that displays the code for
# a demonstration and allows it to be edited and reinvoked.
my $code_buttons = $CODE->Frame;
$code_buttons->pack(qw/-side bottom -fill x/);
my $code_buttons_dismiss = $code_buttons->Button(
-command => [$CODE => 'withdraw'],
$CODE_RERUN = $code_buttons->Button(-text => 'Rerun Demo');
$CODE_TEXT = $CODE->Scrolled('Text',
qw/-scrollbars e -height 40 -setgrid 1/);
$code_buttons_dismiss->pack(qw/-side left -expand 1/);
$CODE_RERUN->pack(qw/-side left -expand 1/);
$CODE_TEXT->pack(qw/-side left -expand 1 -fill both/);
$CODE_RERUN->configure(-command => sub {
eval $CODE_TEXT->get(qw/1.0 end/);
$file = "$WIDTRIB/${demo}.pl" if -f "$WIDTRIB/${demo}.pl";
$file = "$widget_lib/${demo}.pl" if -f "$widget_lib/${demo}.pl";
$CODE->title("Demo code: $file");
$CODE_TEXT->delete(qw/1.0 end/);
open(CODE, "<$file") or warn "Cannot open demo file $file: $!";
$CODE_TEXT->insert('1.0', <CODE>);
$CODE_TEXT->markSet(qw/insert 1.0/);
# Create a top-level window that displays a bunch of global variable values
# and keeps the display up-to-date even when the variables change value.
# $args is a pointer to a list of list of 2:
# ["variable description", \$VAR]
# The old trick of passing a string to serve as the description and a soft
# reference to the variable no longer works with lexicals and use strict.
$VARS->destroy if Exists($VARS);
$VARS = $parent->Toplevel;
$VARS->geometry('+300+300');
$VARS->title('Variable Values');
$VARS->iconname('Variables');
my $title = $VARS->Label(
-text => 'Variable Values:',
-font => '-*-helvetica-medium-r-normal--*-180-*-*-*-*-*-*',
$title->pack(qw/-side top -fill x/);
my $wf = $VARS->Frame->pack(qw/-anchor w/);
$wf->Label(-text => "$label: ")->pack(qw/-side left/);
$wf->Label(-textvariable => $var)->pack(qw/-side left/);
$VARS->Button(-text => 'OK', -command => [$VARS => 'destroy'])->
pack(qw/-side bottom -pady 2/);
# Display name of current demonstration. $sv is a reference to the
# status Label -textvariable, $text is the Text widget reference and
# $index is the demonstration index in the Text widget.
my($sv, $text, $index) = @_;
my @tags = $text->tagNames($index);
my $i = lsearch('demo\-.*', @tags);
my($demo) = $tags[$i] =~ /demo-(.*)/;
$$sv = "Click Button-1 to run the \"$demo\" demonstration.";
# Expose a file's innards to the world too, but only for viewing.
$VIEW->iconname('widget');
my $view_buttons = $VIEW->Frame;
$view_buttons->pack(qw/-side bottom -expand 1 -fill x/);
my $view_buttons_dismiss = $view_buttons->Button(
-command => [$VIEW => 'withdraw'],
$view_buttons_dismiss->pack(qw/-side left -expand 1/);
$VIEW_TEXT = $VIEW->Scrolled('Text',
qw/-scrollbars e -height 40 -setgrid 1/);
$VIEW_TEXT->pack(qw/-side left -expand 1 -fill both/);
$VIEW->title("Demo code: $widget");
$VIEW_TEXT->configure(qw/-state normal/);
$VIEW_TEXT->delete(qw/1.0 end/);
open(VIEW, "<$widget") or warn "Cannot open demo file $widget: $!";
$VIEW_TEXT->insert('1.0', <VIEW>);
$VIEW_TEXT->markSet(qw/insert 1.0/);
$VIEW_TEXT->configure(qw/-state disabled/);
widget - Demonstration of Perl/Tk widgets
This script demonstrates the various widgets provided by Tk, along with
many of the features of the Tk toolkit. This file only contains code to
generate the main window for the application, which invokes individual
demonstrations. The code for the actual demonstrations is contained in
separate ".pl" files in the "widget_lib" directory, which are autoloaded
by this script as needed.
widget looks in the directory specified on the command line to load user
contributed demonstrations. If no directory name is specified when widget is
invoked and the environment variable WIDTRIB is defined then demonstrations
are loaded from the WIDTRIB directory. If WIDTRIB is undefined then widget
defaults to the released user contributed directory, "widtrib".
# Stephen O. Lidie, LUCC, 96/03/11. lusol@Lehigh.EDU
# Stephen O. Lidie, LUCC, 97/01/01. lusol@Lehigh.EDU
# Stephen O. Lidie, LUCC, 97/02/11. lusol@Lehigh.EDU
# Stephen O. Lidie, LUCC, 97/06/07. lusol@Lehigh.EDU
# Update for Tk402.00x. Total revamp: WidgetDemo, Scrolled, released
# composites, -menuitems, qw//, etcetera. Perl 5.004 required.
# Stephen O. Lidie, LUCC, 98/03/10. lusol@Lehigh.EDU
# Stephen O. Lidie, LUCC, 98/06/26. Stephen.O.Lidie@Lehigh.EDU
# Add Common Dialogs for Tk800.007.
# Stephen.O.Lidie@Lehigh.EDU, 1999/11/29, Lehigh University.
# Demo some "dash patch" changes.
# Stephen.O.Lidie@Lehigh.EDU, 2000/01/11, Lehigh University.
# Update menubar to Tk 8, fix color palette Menubutton demo.
# Stephen.O.Lidie@Lehigh.EDU, 2000/07/06, Lehigh University.
# Remove inswt() from widget and styles.pl to show the proper Perl/Tk
# idiom for inserting Text tags. Various and sundry cleanups.
Steve Lidie <Stephen.O.Lidie@Lehigh.EDU>