=head1 NAME

Gtk2::Builder

=head1 HIERARCHY

  Glib::Object
  +----Gtk2::Builder


=head1 METHODS

=head2 builder = Gtk2::Builder-E<gt>B<new> 

=over

=back

=head2 integer = $builder-E<gt>B<add_from_file> ($filename)

=over

=over

=item * $filename (localized file name) 

=back



May croak with a L<Glib::Error> in $@ on failure.

=back

=head2 integer = $builder-E<gt>B<add_from_string> ($buffer)

=over

=over

=item * $buffer (string) 

=back



May croak with a L<Glib::Error> in $@ on failure.

=back

=head2 $builder->B<connect_signals> ($user_data)

=head2 $builder->B<connect_signals> ($user_data, $package)

=head2 $builder->B<connect_signals> ($user_data, %handlers)

=over

=over

=back


There are four ways to let Gtk2::Builder do the signal connecting work for you:

=over

=item C<< $builder->connect_signals ($user_data) >>

When invoked like this, Gtk2::Builder will connect signals to functions in the
calling package.  The callback names are specified in the UI description.

=item C<< $builder->connect_signals ($user_data, $package) >>

When invoked like this, Gtk2::Builder will connect signals to functions in the
package I<$package>.

=item C<< $builder->connect_signals ($user_data, $object) >>

When invoked like this, Gtk2::Builder will connect signals to method calls
against the object $object.

=item C<< $builder->connect_signals ($user_data, %handlers) >>

When invoked like this, I<%handlers> is used as a mapping from handler names to
code references.

=back


=back

=head2 $builder-E<gt>B<connect_signals_full> ($func, $user_data=undef)

=over

=over

=item * $func (scalar) 

=item * $user_data (scalar) 

=back

=back

=head2 object = $builder-E<gt>B<get_object> ($name)

=over

=over

=item * $name (string) 

=back

=back

=head2 list = $builder-E<gt>B<get_objects> 

=over

=back

=head2 string or undef = $builder-E<gt>B<get_translation_domain> 

=over

=back

=head2 $builder-E<gt>B<set_translation_domain> ($domain)

=over

=over

=item * $domain (string or undef) 

=back

=back


=head1 PROPERTIES

=over

=item 'translation-domain' (string : readable / writable / private)

The translation domain used by gettext

=back


=head1 SEE ALSO

L<Gtk2>, L<Glib::Object>

=head1 COPYRIGHT

Copyright (C) 2003-2007 by the gtk2-perl team.

This software is licensed under the LGPL.  See L<Gtk2> for a full notice.


=cut

