Strzelecki Łukasz > Gtk2-GladeXML-OO-0.501 > Gtk2::GladeXML::OO

Download:
Gtk2-GladeXML-OO-0.501.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.501   Source  

NAME ^

Gtk2::GladeXML::OO - Drop-in replacement for Gtk2::GladeXML with object oriented interface to Glade.

SYNOPSIS ^

        use Gtk2::GladeXML::OO;
        
        # exactly as in Gtk2::GladeXML
        our $gladexml = Gtk2::GladeXML::OO->new('glade/example.glade');
        $gladexml->signal_autoconnect_from_package('main');
        $gladexml->load_objects(qw/GUI_/);             # insert GUI objects to namespace
        $gladexml->debug(2);

        $::GUI_window->show;     # method "show" of widget with name "GUI_window"

        sub gtk_main_quit { Gtk2->main_quit; }

        # Object _MUST_ be declared as "our"
        our $myobject = MyObject->new();

        Gtk2->main;


        # ...and now callbacks in Glade can be:
        #
        #       myobject->method                <- Gtk2 will pass standard parameters to Your method
        #       myobject->method()              <- without any parameters, ie. window->hide()
        #       myobject->method("param0", "param1")    <- with Your parameters
        #       myobject->get_it()->do_sth("par0", "par1") <- multilevel call to Your object
        #       tree_view->get_selection->select_all()  <- multilevel call to Glade object!!
        #
        #       gtk_main_quit                   <- standard function interface, like before

        # See example.glade and example.pl in example directory!

DESCRIPTION ^

This module provides a clean and easy object-oriented interface in Glade callbacks (automagicaly loads objects and do all dirty work for you, no action is required on your part). Now You can use in callbacks: widgets, Your objects or standard functions like before. Callbacks can be even multilevel!

Gtk2::GladeXML::OO is a drop-in replacement for Gtk2::GladeXML, so after a change from Gtk2::GladeXML to Gtk2::GladeXML::OO all Your applications will work fine and will have new functionality.

AUTOLOAD ^

If You are using AUTOLOAD subroutine in main package, Gtk2::GladeXML::OO module will invoke it, when it cound'nt find any matching object in Glade file and Your code.

SUBROUTINES/METHODS ^

new('/path/to/file.glade')

This method should be called exactly as new in Gtk2::GladeXML. In example:

        # Gtk2::GladeXML::OO object
        our $gladexml = Gtk2::GladeXML::OO->new('glade/example.glade');
debug

This method turns on/off debug. Three levels are acceptable.

        0  =>  turns OFF debug
        1  =>  turns ON debug (only important information/warnings), DEFAULT
        2  =>  turns ON debug in verbose mode, use this when You are in a trouble

In example:

        # tunrs OFF debug
        $gladexml->debug(0);
        
        ...some code...

        # tunrs ON debug
        $gladexml->debug(1);
        
        ...some code...
        # turns ON debug in verbose mode
        $gledexml->debug(2);
load_objects(qr/regexp/)

This method loads to "main::" namespace all objects corresponding to widgets with names compatible with regexp. Default regexp is set to qr/^[A-Z]/.

For all other methods see Gtk2::GladeXML!

DEPENDENCIES ^

Carp (in standard Perl distribution)
Gtk2::GladeXML

INCOMPATIBILITIES ^

None known. You can even use AUTOLOAD in Your application and all modules.

BUGS AND LIMITATIONS ^

Limitation (will be resolved in a future): For now Your objects are loaded only from main package.

AUTHOR ^

Strzelecki Łukasz <lukasz@strzeleccy.eu>

LICENCE AND COPYRIGHT ^

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

See http://www.perl.com/perl/misc/Artistic.html

syntax highlighting: