456. How to display a list of thumbnail images using GtkIconView - Part 3 - hide text label and add tooltip?

Problem

You have displayed a list of thumbnail images using GtkIconView as described in the article How to display a list of thumbnail images using GtkIconView?

In Part 2, you have hidden the text label of the thumbnail image.

In this Part 3, we will add a tooltip so that the text label will appear will the user hovers the mouse over the thumbnail image as shown below.

How to display a list of thumbnail images using GtkIconView - Part 3 - hide text label and add tooltip?


Solution

Use GtkIconView::set_tooltip_column() to set the column in the iconview's model containing the tooltip text.

Important Note: This only works for PHP-GTK v2.0 (or PHP-GTK2 compliled with gtk+ v2.12 and above. If you are using an older version, for linux, you may follow the step-by-step instructions to recompile php-gtk2 with gtk+ v2.12. For windows, please refer to How to install php gtk2 on windows?


Sample Code

Note: The following image files are required by the sample code below. Please save a copy of the image files and put them in the same directory where you store the sample code.

 square_red.jpg
 square_yellow.jpg
 square_green.jpg
 square_blue.jpg
 square_blue2.jpg
 square_blue3.jpg

1   
2   
3   
4   
5   
6   
7   
8   
9   
10   
11   
12   
13   
14   
15   
16   
17   
18   
19   
20   
21   
22   
23   
24   
25   
26   
27   
28   
29   
30   
31   
32   
33   
34   
36   
37   
38   
39   
40   
41   
42   
43   
44   
45   
46   
47   
<?php
$window = new GtkWindow();
$window->set_title($argv[0]);
$window->set_size_request(400, 240);
$window->connect_simple('destroy', array('Gtk','main_quit'));

$window->add($vbox = new GtkVBox());

// display title
$title = new GtkLabel("Display thumbnail images using GtkIconView\n".
"                 Part 2 - hide text labels");
$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(), 0, 0); // add a small gap

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

if (defined("GObject::TYPE_STRING")) {
    $model = new GtkListStore(GdkPixbuf::gtype, GObject::TYPE_STRING);
} else {
    $model = new GtkListStore(GdkPixbuf::gtype, Gtk::TYPE_STRING);
}

foreach(array('square_red.jpg', 'square_yellow.jpg', 'square_green.jpg',
'square_blue.jpg', 'square_blue2.jpg', 'square_blue3.jpg') as $img) {
    $pixbuf = GdkPixbuf::new_from_file($img);
    $model->append(array($pixbuf, $img));
}

$view = new GtkIconView($model);
$view->set_pixbuf_column(0);
$view->set_text_column(-1); // note 1
$view->set_tooltip_column(1);
$view->set_selection_mode(Gtk::SELECTION_MULTIPLE);
$view->set_columns(0);
$view->set_item_width(120);

$scrolled_win->add($view);
$vbox->pack_start($scrolled_win);
$window->show_all();
Gtk::main();
?>

Output

As shown above.

 

Add comment


Security code
Refresh