#!/usr/bin/perl =head1 NAME Debconf::Element::Gnome - gnome UI element =cut package Debconf::Element::Gnome; use warnings; use strict; use utf8; use Gtk3; use Debconf::Gettext; use Debconf::Encoding qw(to_Unicode); use base qw(Debconf::Element); =head1 DESCRIPTION This is a type of Element used by the gnome FrontEnd. It contains a hbox, into which the gnome UI element and any associated lables, help buttons, etc, are packaged. =head1 FIELDS =over 4 =item hbox This is the hbox that holds all the widgets for this element. =back =head1 METHODS =over 4 =item init Sets up the hbox. =cut sub init { my $this=shift; $this->hbox(Gtk3::VBox->new(0, 10)); $this->hline1(Gtk3::HBox->new(0, 10)); $this->hline1->show; $this->line1(Gtk3::VBox->new(0, 10)); $this->line1->show; $this->line1->pack_end ($this->hline1, 1, 1, 0); $this->hline2(Gtk3::HBox->new(0, 10)); $this->hline2->show; $this->line2(Gtk3::VBox->new(0, 10)); $this->line2->show; $this->line2->pack_end ($this->hline2, 1, 1, 0); $this->vbox(Gtk3::VBox->new(0, 5)); $this->vbox->pack_start($this->line1, 0, 0, 0); $this->vbox->pack_start($this->line2, 1, 1, 0); $this->vbox->show; $this->hbox->pack_start($this->vbox, 1, 1, 0); $this->hbox->show; # default is not to be expanded or to filled $this->fill(0); $this->expand(0); $this->multiline(0); } =item addwidget Packs the passed widget into the hbox. =cut sub addwidget { my $this=shift; my $widget=shift; if ($this->multiline == 0) { $this->hline1->pack_start($widget, 1, 1, 0); } else { $this->hline2->pack_start($widget, 1, 1, 0); } } =item adddescription Packs a label containing the short description into the hbox. =cut sub adddescription { my $this=shift; my $description=to_Unicode($this->question->description); my $label=Gtk3::Label->new($description); $label->show; $this->line1->pack_start($label, 0, 0, 0); } =item addbutton Packs a button into the first line of the hbox. The button is added at the end of the box. =cut sub addbutton { my $this=shift; my $text = shift; my $callback = shift; my $button = Gtk3::Button->new_with_mnemonic(to_Unicode($text)); $button->show; $button->signal_connect("clicked", $callback); my $vbox = Gtk3::VBox->new(0, 0); $vbox->show; $vbox->pack_start($button, 1, 0, 0); $this->hline1->pack_end($vbox, 0, 0, 0); } =item create_message_dialog This is needed because Gtk3::MessageDialog has a much worse behavior than the other Gtk3:: perl widgets when it comes to an UTF-8 locale. (This was originally written for Gtk2; is it still true for Gtk3?) =cut sub create_message_dialog { my $this = shift; my $type = shift; my $title = shift; my $text = shift; my $dialog = Gtk3::Dialog->new_with_buttons(to_Unicode($title), undef, "modal", "gtk-close", "close"); $dialog->set_border_width(3); my $hbox = Gtk3::HBox->new(0); $dialog->get_content_area->pack_start($hbox, 1, 1, 5); $hbox->show; my $alignment = Gtk3::Alignment->new(0.5, 0.0, 1.0, 0.0); $hbox->pack_start($alignment, 1, 1, 3); $alignment->show; my $image = Gtk3::Image->new_from_stock($type, "dialog"); $alignment->add($image); $image->show; my $label = Gtk3::Label->new(to_Unicode($text)); $label->set_line_wrap(1); $hbox->pack_start($label, 1, 1, 2); $label->show; $dialog->run; $dialog->destroy; } =item addhelp Packs a help button into the hbox. The button is omitted if there is no extended description to display as help. =cut sub addhelp { my $this=shift; my $help=$this->question->extended_description; return unless length $help; $this->addbutton(gettext("_Help"), sub { $this->create_message_dialog("gtk-dialog-info", gettext("Help"), to_Unicode($help)); }); if (defined $this->tip ){ $this->tip->set_tooltip_text(to_Unicode($help)); } } =item value Return the value the user entered. Defaults to returning nothing. =cut sub value { my $this=shift; return ''; } =back =head1 AUTHOR Eric Gillespie Gustavo Noronha Silva =cut 1