132. How to populate form with popup list - Part 2?

Problem

In Part 1, you have set up a form with several fields. At the press of a button, a popup list appears that allow users to select from the list. In Part 1, user must select with arrow key and press Return.

Now you would like to allow users to select with double-click as shown below:

How to populate form with popup list - Part 2?


Solution

  • Set up the form and the dialog as described in Part 1.
  • To add the support for double-click, we use the button-press-event.

Sample Code

1   
 2   
 3   
 4   
 5   
 6   
 7   
 8   
 9   
 10   
 11   
 12   
 13   
 14   
 15   
 16   
 17   
 18   
 19   
 20   
 21   
 23   
 24   
 25   
 26   
 27   
 28   
 29   
 30   
 31   
 32   
 33   
 35   
 36   
 38   
 40   
 41   
 42   
 44   
 45   
 46   
 47   
 48   
 49   
 50   
 51   
 52   
 53   
 54   
 55   
 57   
 58   
 59   
 60   
 61   
 62   
 63   
 64   
 65   
 66   
 67   
 68   
 70   
 71   
 72   
 73   
 74   
 75   
 76   
 77   
 78   
 79   
 80   
 81   
 82   
 83   
 84   
 86   
 89   
 90   
 91   
 92   
 93   
 94   
 95   
 96   
 98   
101   
103   
104   
106   
107   
108   
109   
110   
111   
112   
113   
114   
115   
116   
117   
118   
120   
121   
122   
123   
124   
125   
126   
127   
128   
129   
130   
131   
132   
133   
134   
135   
136   
137   
138   
139   
140   
141   
142   
143   
144   
145   
146   
147   
148   
154   
155   
156   
157   
158   
159   
160   
161   
162   
163   
164   
165   
166   
167   
168   
169   
170   
171   
172   
173   
174   
175   
176   
177   
178   
179   
180   
181   
182   
183   
184   
185   
186   
187   
188   
189   
190   
191   
192   
193   
194   
195   
196   
197   
198   
199   
200   
201   
202   
203   
207   
208   
209   
210   
211   
212   
213   
214   
215   
216   
217   
218   
219   
220   
221   
222   
223   
224   
225   
226   
227   
228   
229   
230   
231   
232   
233   
234   
235   
236   
237   
238   
239   
240   
241   
242   
243   
244   
245   
246   
247   
248   
249   
250   
252   
253   
254   
255   
256   
257   
258   
259   
260   
261   
262   
263   
264   
265   
266   
<?php
$window = new GtkWindow();
$window->set_size_request(400, 240);
$window->connect_simple('destroy', array('Gtk','main_quit'));
$window->add($vbox = new GtkVBox());

// display title
$title = new GtkLabel("Populate form with popup list - Part 2\n".
"   allow selection using double click");
$title->modify_font(new PangoFontDescription("Times New Roman Italic 10"));
$title->modify_fg(Gtk::STATE_NORMAL, GdkColor::parse("#0000ff"));
$title->set_size_request(-1, 40);
$vbox->pack_start($title, 0, 0);

$fields = array('Item number', 'Item Description', 'Unit price', 'Quantity');
$field_size = array(120, 200, 80, 80);
$entry = array(); // to store the text entries

$table = new GtkTable();
display_table($table, $fields, $field_size); // display the table

$vbox->pack_start($table);

function display_table($table, $fields, $field_size) {
    global $entry;
    $row = 0;
    foreach ($fields as $field) {
        $label = new GtkLabel("  $field: ");
        $alignment = new GtkAlignment(1, .5, 0, 0);
        $alignment->add($label);
        $table->attach($alignment, 0, 1, $row, $row+1, Gtk::FILL, Gtk::SHRINK, 0, 0);
        $entry[$row] = new GtkEntry();
        $alignment = new GtkAlignment(0, .5, 0, 0);
        $alignment->add($entry[$row]);
        $entry[$row]->set_size_request($field_size[$row], -1);

        if ($field=='Item number') {
            $hbox = new GtkHBox();
            // add a button to popup list after the label
            $button = new GtkButton('Select from list');

            $hbox->pack_start($alignment, 0, 0);
            $hbox->pack_start(new GtkLabel(' '), 0, 0);
            $hbox->pack_start($button, false);
            $widget = &$hbox;
        } else {
            $widget = $alignment;
        }

        $table->attach($widget, 1, 2, $row, $row+1);
        ++$row;
    }
    $button->connect('clicked', 'popup_list', $entry);
}

// create a submit button
$button = new GtkButton('Submit');
$button->set_size_request(60, 28);
$button->connect('clicked', 'on_click');
$row = count($fields);
$alignment = new GtkAlignment(0, 0.5, 0, 0);
$alignment->add($button);
$table->attach($alignment, 1, 2, $row, $row+1);

$window->show_all();
Gtk::main();

function on_click($button) {
    global $fields, $entry;
    $i=0;
    foreach($fields as $field) {
        echo "$field: ".$entry[$i]->get_text()."\n";
        ++$i;
    }
}

function popup_list($button, $entry) {
    $selection = prompt();
    if (count($selection)>0) {
        for ($i=0; $i<4; ++$i) {
            $entry[$i]->set_text($selection[$i]);
        }
    }
}

function prompt() {
    $prompt = new Prompt();
    $selection = array();
    if ($prompt->selected_iter!=null) {
        $model = $prompt->model;
        for ($i=0; $i<4; ++$i) {
            $selection[] = $model->get_value($prompt->selected_iter, $i);
        }
    }
    return $selection;
}

class Prompt{

    var $selected_iter = null;

    function Prompt() {
        $dialog = new GtkDialog('Select From List', null, Gtk::DIALOG_MODAL|Gtk::DIALOG_NO_SEPARATOR);
        $dialog->vbox->pack_start(new GtkLabel(), 0, 0);
        $dialog->vbox->pack_start(new GtkLabel('Select item with arrow keys and press Return.'), 0, 0);
        $dialog->vbox->pack_start(new GtkLabel('Or select by double-click the desired row.'), 0, 0);
        $dialog->vbox->pack_start(new GtkLabel(), 0, 0);


        // Set up a scroll window
        $scrolled_win = new GtkScrolledWindow();
        $scrolled_win->set_policy( Gtk::POLICY_AUTOMATIC, Gtk::POLICY_AUTOMATIC);
        $dialog->vbox->pack_start($scrolled_win);

        // the 2D table
        $data = array(
        array('id0', 'item 19', 2, 3.1),
        array('id1', 'item 16', 20, 6.21),
        array('id2', 'item 13', 8, 9.36),
        array('id3', 'item 10', 11, 12.4),
        array('id4', 'item 7', 5, 15.5),
        array('id5', 'item 4', 17, 18.6),
        array('id6', 'item 3', 20, 21.73));

        $this->display_table($scrolled_win, $data);

        $this->dialog = $dialog;
        $dialog->connect('key-press-event', array($this, 'on_key'));
        $dialog->show_all();
        $dialog->run();
        $dialog->destroy();
    }

    function display_table($scrolled_win, $data) {
        // Creates the list store
        if (defined("GObject::TYPE_STRING")) {
            $model = new GtkListStore(GObject::TYPE_STRING, GObject::TYPE_STRING,
                GObject::TYPE_LONG, GObject::TYPE_DOUBLE);
        } else {
            $model = new GtkListStore(Gtk::TYPE_STRING, Gtk::TYPE_STRING,
                Gtk::TYPE_LONG, Gtk::TYPE_DOUBLE);
        }
        $this->model = $model;
        $field_header = array('Item Number', 'Item Description', 'Qty', 'Price');
        $field_justification = array(0.5, 0.0, 0.5, 1.0);

        // Creates the view to display the list store
        $view = new GtkTreeView($model);
        $this->view = $view;
        $scrolled_win->add($view);
        $scrolled_win->set_size_request(300, 186);

        // Creates the columns
        for ($col=0; $col<count($field_header); ++$col) {
            $cell_renderer = new GtkCellRendererText();
            $cell_renderer->set_property("xalign", $field_justification[$col]);
            $column = new GtkTreeViewColumn($field_header[$col], $cell_renderer, 'text', $col);
            $column->set_alignment($field_justification[$col]);
            $column->set_sort_column_id($col);

            // set the header font and color
            $label = new GtkLabel($field_header[$col]);
            $label->modify_font(new PangoFontDescription("Arial Bold"));
            $label->modify_fg(Gtk::STATE_NORMAL, GdkColor::parse("#0000FF"));
            $column->set_widget($label);
            $label->show();

            // setup self-defined function to display alternate row color
            $column->set_cell_data_func($cell_renderer, array($this, 'format_col'), $col);
            $view->append_column($column);
        }

        for ($row=0; $row<count($data); ++$row) {
            $values = array();
            for ($col=0; $col<count($data[$row]); ++$col) {
                $values[] = $data[$row][$col];
            }
            $model->append($values);
        }

        $view->connect('button-press-event', array($this, 'on_button')); // note 1

    }

    function format_col($column, $cell, $model, $iter, $col_num) {
        $path = $model->get_path($iter);
        $row_num = $path[0];
        if ($col_num==3) {
            $amt = $model->get_value($iter, 3);
            $cell->set_property('text', '$'.number_format($amt,2));
        }
        $row_color = ($row_num%2==1) ? '#dddddd' : '#ffffff';
        $cell->set_property('cell-background', $row_color);
    }

    function on_selection($selection) {
        list($model, $iter) = $selection->get_selected();
        $desc = $model->get_value($iter, 1);
        $qty = $model->get_value($iter, 2);
        $price = $model->get_value($iter, 3);
        print "You have selected $desc: $qty ($price)\n";
    }

    function on_key($widget, $event) {
        print "key = $event->keyval\n";
        if ($event->keyval==65307) {
            // Gdk::KEY_Escape
            $this->dialog->destroy();
            return true;
        }

        if ($event->keyval!=65293) return false;
        // 65293 = Gdk::KEY_Return

        $selection = $this->view->get_selection();
        list($model, $iter) = $selection->get_selected();
        if ($iter==NULL) {
            echo("Please select an item first.");
            return true;
        }
        $this->selected_iter = $iter;
        $this->dialog->destroy();
    }

    function on_button($widget, $event) {
        if ($event->type==Gdk::_2BUTTON_PRESS) {  // note 2
            $selection = $this->view->get_selection();
            list($model, $iter) = $selection->get_selected();
            if ($iter==NULL) { // note 3
                echo("Please select an item first.");
                return true;
            }
            $this->selected_iter = $iter; // note 4
            $this->dialog->destroy();
        }

    }

}

?>

Output

As shown above.

 

Explanation

We make use of the code in Part 1.

What's new here:

  1. Register button-press-event on the treeview.
  2. Check if this is a double-click.
  3. Make sure there's a selection.
  4. Record the selected iter and destroy the dialog.

Related Links

Add comment

Security code
Refresh