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  -  GTK2::PATHBUTTONBAR (3)

.ds Aq ’

NAME

Gtk2::PathButtonBar - Creates a bar for path manipulation.

CONTENTS

VERSION

Version 0.1.2

SYNOPSIS

This creates a collection of buttons and a entry widget to help with browsing a path or etc.

It is composed of two lines. The first line contains a set of buttons. The first button is a button that blanks the current path. This is the ’goRoot’ button and displays what ever the user has decided the root is by setting the ’root’ key when invoking the new funtions. The buttons after that are ones that correspond to a chunk of the path, broken up by what ever the delimiter is set to. When any of these are pressed, the entry text is changed as well to relfect it. The ’goRoot’ button clears the path to ’’.

The second line starts with a label. The label is the same as on the ’goRoot’ button and is what ever the root is set as. After that there is a single line text entry widget. This allows the path to be set by typing it in. After the text entry widget, there is a button labeled ’Go’. When this button is pressed, it updates the button bar with what is in text entry widget.

Any time the path is updated, ’$self->{exec}’ is ran through eval.



    use Gtk2;
    use Gtk2::PathButtonBar;
   
    Gtk2->init;
   
    my $window = Gtk2::Window->new();
   
    my $pbb=Gtk2::PathButtonBar->new({exec=>print "path=".${$myself}->{path}."\na=".${$myself}->{vars}{a}."\n";,
                                    vars=>{a=>1},
                                    });
   
    print $pbb->{vbox}."\n";
   
    $window->add($pbb->{vbox});
   
    $window->show;



FUNCTIONS

    new

This initiates this widget. This takes it’s arguements in the form of a hash. The accepted keys can be found below.

delimiter

This is what will be considered a delimiter between directories or whatever. The default is ’/’.

exec

This is a string that will be executed any time any change is done. Change the text in the string entry box does not constitute a change till the ’Go’ button is pressed.

For example, setting it to the following, would cause it to print the current path followed a new line and then a ’a=’ what ever ’$self->{vars}{a}’ is set to.



    exec=>print "path=".${$myself}->{path}."\na=".${$myself}->{vars}{a}."\n:;



If you wish to pass any sort of variables to this, it is strongly suggested you do it by using the ’vars’ key in the hash passed to the new function.

Upon a failure to execute the code in exec, it will issue a warning.

root

This is what will be displayed as being the root. This wills how up in the ’goRoot’ button and in the label before the entry box.

If it is not defined, it defaults to what ever the delimiter is. If the delimiter is not set, that means this will display ’/’, which works nicely for most unix FS stuff.

path

This is the path that the it will originally be set to.

vars

This is meant to contain variables that will be used with ’$self->{exec}’.

    go

This is called when a new path is set by pressing the go button.

There is no reason to ever call this from ’$self->{exec}’.

    goRoot

This is called when a new path is set by pressing the root button.

If you wish to call this from ’$self->{exec}’, do it as below.



    ${$myself}->goRoot;



    makeButtons

This is a internal function that rebuilds the button bar.

If you wish to call this from ’$self->{exec}’, do it as below.



    ${$myself}->makeButtons;



    setPath

This changes the current path.

One arguement is accepted and that is the path.



    $pbb->setPath($somepath);
    if($self->{error}){
        print "Error!\n";
    }



    errorblank

This blanks the error storage and is only meant for internal usage.

It does the following.



    $self->{error}=undef;
    $self->{errorString}="";



ERROR CODES

    1

No path specified.

AUTHOR

Zane C. Bowers, <vvelox at vvelox.net>

BUGS

Please report any bugs or feature requests to bug-gtk2-pathbuttonbar at rt.cpan.org, or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Gtk2-PathButtonBar>. I will be notified, and then you’ll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.



    perldoc Gtk2::PathButtonBar



You can also look for information at:
o RT: CPAN’s request tracker

<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Gtk2-PathButtonBar>

o AnnoCPAN: Annotated CPAN documentation

<http://annocpan.org/dist/Gtk2-PathButtonBar>

o CPAN Ratings

<http://cpanratings.perl.org/d/Gtk2-PathButtonBar>

o Search CPAN

<http://search.cpan.org/dist/Gtk2-PathButtonBar>

ACKNOWLEDGEMENTS

COPYRIGHT & LICENSE

Copyright 2008 Zane C. Bowers, 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


perl v5.20.3 GTK2::PATHBUTTONBAR (3) 2009-10-13

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