GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  TK::PROGRESSBAR (3)

.ds Aq ’

NAME

Tk::ProgressBar - A graphical progress bar

CONTENTS

SYNOPSIS



    use Tk::ProgressBar;

    $progress = $parent->ProgressBar(
        -width => 20,
        -length => 200,
        -anchor => s,
        -from => 0,
        -to => 100,
        -blocks => 10,
        -colors => [0, green, 50, yellow , 80, red],
        -variable => \$percent_done
    );

    $progress->value($position);



DESCRIPTION

<B>Tk::ProgressBarB> provides a widget which will show a graphical representation of a value, given maximum and minimum reference values.

STANDARD OPTIONS

The following standard widget options are supported:
<B>-borderwidthB>
<B>-highlightthicknessB> Defaults to 0.
<B>-padxB> Defaults to 0.
<B>-padyB> Defaults to 0.
<B>-reliefB> Defaults to sunken
<B>-troughcolorB> The color to be used for the background (trough) of the progress bar. Default is to use grey55.

WIDGET-SPECIFIC OPTIONS

<B>-anchorB> This can be used to position the start point of the bar. Default is ’w’ (horizontal bar starting from the left). A vertical bar can be configured by using either ’s’ or ’n’.
<B>-blocksB> This controls the number of blocks to be used to construct the progress bar. The default is to break the bar into 10 blocks.
<B>-colorsB> Controls the colors to be used for different positions of the progress bar. The colors should be supplied as a reference to an array containing pairs of positions and colors.



  -colors => [ 0, green, 50, red ]



means that for the range 0 to 50 the progress bar should be green and for higher values it should be red.

<B>-fromB> This sets the lower limit of the progress bar. If the bar is set to a value below the lower limt no bar will be displayed. Defaults to 0. See the -to description for more information.
<B>-gapB> This is the spacing (in pixels) between each block. Defaults to 1. Use 0 to get a continuous bar.
<B>-lengthB> Specifies the desired long dimension of the ProgressBar in screen units (i.e. any of the forms acceptable to Tk_GetPixels). For vertical ProgressBars this is the ProgressBars height; for horizontal scales it is the ProgressBars width. The default length is calculated from the values of -padx, -borderwidth, -highlightthickness and the difference between -from and -to.
<B>-resolutionB> A real value specifying the resolution for the scale. If this value is greater than zero then the scale’s value will always be rounded to an even multiple of this value, as will tick marks and the endpoints of the scale. If the value is less than zero then no rounding occurs. Defaults to 1 (i.e., the value will be integral).
<B>-toB> This sets the upper limit of the progress bar. If a value is specified (for example, using the value method) that lies above this value the full progress bar will be displayed. Defaults to 100.
<B>-variableB> Specifies the reference to a scalar variable to link to the ProgressBar. Whenever the value of the variable changes, the ProgressBar will update to reflect this value. (See also the <B>valueB> method below.)
<B>-valueB> This can be used to set the current position of the progress bar when used in conjunction with the standard configure. It is usually recommended to use the <B>valueB> method instead.
<B>-widthB> Specifies the desired narrow dimension of the ProgressBar in screen units (i.e. any of the forms acceptable to Tk_GetPixels). For vertical ProgressBars this is the ProgressBars width; for horizontal bars this is the ProgressBars height. The default width is derived from the values of -borderwidth and -pady and -highlightthickness.

WIDGET METHODS

$ProgressBar-><B>valueB>(?value?) If value is omitted, returns the current value of the ProgressBar. If value is given, the value of the ProgressBar is set. If $value is given but undefined the value of the option <B>-fromB> is used.

AUTHOR

Graham Barr <gbarr@pobox.com>

COPYRIGHT

Copyright (c) 1997-1998 Graham Barr. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
Search for    or go to Top of page |  Section 3 |  Main Index


Tk804.033 TK::PROGRESSBAR (3) 2013-11-15

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.