121. How to arrange two related windows horizontally using GtkHPaned?

Problem

You would like to arrange two related windows horizontally using GtkHPaned. The HPaned widget is a container widget with two children arranged horizontally. The division between the two panes is adjustable by the user by dragging a handle as shown below.

How to arrange two related windows horizontally using GtkHPaned?


Solution

  • Create a GtkHpaned.
  • Stuff the widget to be displayed on the left using GtkPaned::add1().
  • Stuff the widget to be displayed on the right using GtkPaned::add2().
  • By default, nothing is around the children and gutter. So we usually create a GtkFrame and set the shadow type to Gtk::SHADOW_IN to make the gutter appears as a ridge.

Sample Code

1   
2   
3   
4   
5   
6   
7   
8   
9   
10   
11   
12   
13   
14   
15   
16   
17   
19   
20   
21   
22   
23   
24   
25   
26   
27   
28   
29   
30   
31   
32   
33   
34   
35   
36   
37   
38   
39   
40   
41   
42   
43   
44   
45   
46   
47   
48   
49   
50   
51   
52   
53   
54   
55   
56   
57   
58   
59   
60   
61   
62   
63   
64   
65   
66   
67   
68   
69   
70   
71   
72   
74   
75   
76   
77   
79   
80   
81   
82   
83   
84   
85   
86   
87   
88   
89   
90   
91   
92   
93   
94   
95   
96   
97   
98   
99   
100   
101   
102   
103   
104   
105   
106   
107   
108   
109   
110   
111   
112   
113   
114   
115   
116   
117   
118   
119   
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   
149   
150   
151   
152   
153   
154   
155   
156   
157   
158   
159   
160   
161   
162   
163   
164   
165   
166   
167   
168   
169   
170   
171   
172   
173   
174   
175   
176   
<?php
$window = new GtkWindow();
$window->set_size_request(400, 280);
$window->connect_simple('destroy', array('Gtk','main_quit'));
$window->add($vbox = new GtkVBox());

// display title
$title = new GtkLabel("Use of GtkHPaned");
$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);

$vbox->pack_start(new GtkLabel("Click on the options on the left pane."), 0, 0);
$vbox->pack_start(new GtkLabel(), 0, 0); // add a small gap

$hpane = new GtkHPaned(); // note 1
$vbox->pack_start($hpane);

// setup left pane
$left_pane = new GtkFrame(); // note 2
$left_pane->set_shadow_type(Gtk::SHADOW_IN); // note 2
$left_pane->add($vbox = new GtkVBox());
$vbox->pack_start(new GtkLabel('Options:'), 0 ,0);
$vbox->pack_start(create_link('Show All'), 0 ,0); // note 3
$vbox->pack_start(create_link('Qty > 10'), 0 ,0); // note 3
$vbox->pack_start(create_link('Price < $10'), 0 ,0); // note 3
$hpane->add1($left_pane);

$right_pane = new GtkFrame();
$right_pane->set_shadow_type(Gtk::SHADOW_IN);
$hpane->add2($right_pane);

// the 2D table
$data = array(
array('row0', 'item 42', 2, 3.1),
array('row1', 'item 36', 20, 6.21),
array('row2', 'item 21', 8, 9.36),
array('row3', 'item 10', 11, 12.4),
array('row4', 'item 7', 5, 15.5),
array('row5', 'item 4', 17, 18.6),
array('row6', 'item 3', 20, 21.73));

display_table ($right_pane, $data);

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

function display_table($container, $data) {

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

    // Creates the list store
    global $model, $modelfilter1, $modelfilter2, $view;
    if (defined("GObject::TYPE_STRING")) {
        $model = new GtkListStore(GObject::TYPE_STRING, GObject::TYPE_STRING,
                GObject::TYPE_LONG, GObject::TYPE_DOUBLE,
                GObject::TYPE_BOOLEAN, GObject::TYPE_BOOLEAN);
    } else {
        $model = new GtkListStore(Gtk::TYPE_STRING, Gtk::TYPE_STRING,
                    Gtk::TYPE_LONG, Gtk::TYPE_DOUBLE,
                    Gtk::TYPE_BOOLEAN, Gtk::TYPE_BOOLEAN);
    }
    $field_header = array('Row #', 'Description', 'Qty', 'Price');
    $field_justification = array(0.0, 0.0, 0.5, 1.0);

    // setup GtkTreeModelFilter1
    $modelfilter1 = new GtkTreeModelFilter($model);;
    $modelfilter1->set_visible_column(4);

    // setup GtkTreeModelFilter2
    $modelfilter2 = new GtkTreeModelFilter($model);;
    $modelfilter2->set_visible_column(5);

    $view = new GtkTreeView($model);
    $scrolled_win->add($view);

    // 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();

        $column->set_cell_data_func($cell_renderer, "format_col", $col);
        $view->append_column($column);
    }

    // pupulates the data
    for ($row=0; $row<count($data); ++$row) {
        $values = array();
        for ($col=0; $col<count($data[$row]); ++$col) {
            $values[] = $data[$row][$col];
        }

        // sets the flag for filter 1
        $qty = ($data[$row][2]>10) ? 1 : 0;
        $values[] = $qty;

        // sets the flag for filter 2
        $price = ($data[$row][3]<10) ? 1 : 0;
        $values[] = $price;

        $model->append($values);
        print "row = $row\n";
        print_r($values);
    }

    // setup selection
    $selection = $view->get_selection();
    $selection->connect('changed', 'on_selection');

}

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();
    if ($iter==NULL) return;
    $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 create_link($str) { // note 3
    static $i=0;
    $eventbox = new GtkEventBox();
    $label = new GtkLabel(' '.++$i.". ".$str.' ');
    $label->modify_fg(Gtk::STATE_NORMAL, GdkColor::parse("#0000ff"));
    $hbox = new GtkHBox();
    $hbox->pack_start($label, 0, 0);
    $hbox->pack_start(new GtkLabel());
    $eventbox->add($hbox);
    $eventbox->connect('button-press-event', 'link_clicked', $str);
    return $eventbox;
}

function link_clicked($widget, $event, $str) { // note 5
    global $model, $modelfilter1, $modelfilter2, $view;
    echo "link clicked: $str\n";
    if ($str=='Show All') {
        $view->set_model($model);
    } elseif ($str=='Qty > 10') {
        $view->set_model($modelfilter1);
    } elseif ($str=='Price < $10') {
        $view->set_model($modelfilter2);
    }
}

?>

Output

As shown above.
 

Explanation

The above example is based on How to selectively display rows in GtkTreeView with GtkTreeModelFilter - Part 2?. In that example, we use menus and accelerators (Ctrl-1, Ctrl-2 and Ctrl-3) to switch between the three views.

In this example, we use the "clickable options" on the left pane for selection of views. The clickable labels are created with the techniques as described in How to put a clickable link in GtkLabel - Part 1?

What's new here:

  1. Create a new GtkHPaned.
  2. Set up the left pane with frame.
  3. Create 'clickable options' using the technique as described in How to put a clickable link in GtkLabel - Part 1?.
  4. Stuff the treeview created in the article How to selectively display rows in GtkTreeView with GtkTreeModelFilter - Part 2? in the right pane.
  5. Process use selected options and set the filters as explained in the article How to selectively display rows in GtkTreeView with GtkTreeModelFilter - Part 2?

Note

  • Take a look at the article How to open a file with GtkFileChooser?. Note that GtkFileChooser uses GtkHPaned to display the folders and files.
  • If you have the Dev_Inspector, note that it also uses GtkHPaned, with the list of widgets on the left and the corresponding methods and signals on the right.

Related Links

Add comment


Security code
Refresh