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
Curses::UI::Dialog::Progress(3) User Contributed Perl Documentation Curses::UI::Dialog::Progress(3)

Curses::UI::Dialog::Progress - Create and manipulate progress dialogs

 Curses::UI::Widget
    |
    +----Curses::UI::Container
            |
            +----Curses::UI::Window
                    |
                    +----Curses::UI::Dialog::Progress

    use Curses::UI;
    my $cui = new Curses::UI;
    my $win = $cui->add('window_id', 'Window');

    # The hard way.
    # -------------
    my $dialog = $win->add(
        'mydialog', 'Dialog::Progress',
    -max       => 100,
        -message   => 'Some message',
    );

    $dialog->pos(10);
    $dialog->message('Some other message');
    $dialog->draw();

    $win->delete('mydialog');

    # The easy way (see Curses::UI documentation).
    # --------------------------------------------
    $cui->progress(
    -max       => 100,
        -message   => 'Some message',
    );
    $cui->setprogress(10, 'Some other message');
    $cui->noprogress;

Curses::UI::Dialog::Progress is not really a dialog, since the user has no way of interacting with it. It is merely a way of presenting progress information to the user of your program.

See exampes/demo-Curses::UI::Dialog::Progress in the distribution for a short demo.

  • -title < TEXT >

    Set the title of the dialog window to TEXT.

  • -message < TEXT >

    This option sets the initial message to show to TEXT. This message is displayed using a Curses::UI::Label, so it can not contain any newline (\n) characters.

  • -nomessage < BOOLEAN >

    If BOOLEAN has a true value, the dialog window will not contain a message label. By default -nomessage has a false value.

  • -min < VALUE >
  • -max < VALUE >
  • -pos < VALUE >
  • -nopercentage < BOOLEAN >
  • -nocenterline < BOOLEAN >

    These options control the progressbar of the dialog. For an explanation of these options, see Curses::UI::Progressbar.

  • new ( OPTIONS )
  • layout ( )
  • draw ( BOOLEAN )

    These are standard methods. See Curses::UI::Container for an explanation of these.

  • pos ( VALUE )

    This method will update the position of the progressbar to SCALAR. You will have to call the draw method to see the changes.

  • message ( TEXT )

    This method will update the message of the progress dialog to TEXT. You will have to call the draw method to see the changes.

Curses::UI, Curses::UI::Container, Curses::UI::Progressbar

Copyright (c) 2001-2002 Maurice Makaay. All rights reserved.

Maintained by Marcus Thiesen (marcus@cpan.thiesenweb.de)

This package is free software and is provided "as is" without express or implied warranty. It may be used, redistributed and/or modified under the same terms as perl itself.

2011-09-01 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

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