Mac(3)

NAME
Tk::ProgressBar::Mac - a blue, 3-D Macintosh Classic progress bar.

SYNOPSIS
 use Tk::ProgressBar::Mac;
 $pb = $parent->ProgressBar(-option => value);

DESCRIPTION
This widget provides a dynamic image that looks just like a Mac OS 9 progress bar. Packed around it are four Frames, north, south, east and west, within which you can stuff additional widgets. For example, see how Tk::Copy::Mac uses several Labels and a CollapsableFrame widget to create a reasonable facsimile of a Macintosh copy dialog.

The following option/value pairs are supported:

-width
    The maximun width of the Progressbar.

METHODS

reset
    Resets the progress bar image so that it appears unused (a $pb->set(0) still shows the bar's base and end cap).

set($percent)
    Sets the width of the progress bar, as a percentage of -width.

ADVERTISED WIDGETS
Component subwidgets can be accessed via the Subwidget method. Valid subwidget names are listed below.

Name:  label, Class:  Label
      Widget reference of the Label containing the ProgressBar
      Photo image.

Name:  tframe, Class:  Frame
      Widget reference of the Frame north the ProgressBar.

Name:  bframe, Class:  Frame
      Widget reference of the Frame south the ProgressBar.

Name:  lframe, Class:  Frame
      Widget reference of the Frame west the ProgressBar.

Name:  rframe, Class:  Frame
      Widget reference of the Frame east the ProgressBar.

EXAMPLE
 use Tk;
 use Tk::ProgressBar::Mac;
 use strict;

 my $mw = MainWindow->new;
 my $pb = $mw->ProgressBar(-width => 150, -bg => 'cyan')->pack;

 while (1) {
     my $w = rand(100);
     $pb->set($w);
     $mw->idletasks;
     $mw->after(250);
 }

AUTHOR and COPYRIGHT
sol0@Lehigh.EDU

Copyright (C) 2000 - 2003, Stephen O. Lidie.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

KEYWORDS
Apple, ProgressBar