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