Sample Code 463: How to display tooltip on buttons using GtkTooltip - Part 2 - markup text?
Written by kksou   
Wednesday, 26 March 2008
Problem

In Part 1, I've showed you how to display tooltip as plain text on a GtkButton.

In this Part 2, instead of plain text, we will display the tooltip as markup text as shown below:

Key method used: GtkTooltip::set_markup().

How to display tooltip on buttons using GtkTooltip - Part 2 - markup text?


Solution
  • The setup of tooltip is exactly the same as that of Part 1.
  • The only difference is that instead of using GtkTooltip::set_text() , we use GtkTooltip::set_markup() to display the markup text.
  • Note that the markup follows that of the Pango Markup Language. I've written a quick reference guide for the Pango Markup Language here.

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
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   
<?php
$window = new GtkWindow();
$window->set_title($argv[0]);
$window->connect_simple('destroy', array( 'Gtk', 'main_quit'));
$window->set_size_request(400,150);
$window->add($vbox = new GtkVBox());

// display title
$title = new GtkLabel("Display tooltip on GtkButton using GtkTooltip\n".
"   Part 2 - display tooltip with pango markup text");
$title->modify_font(new PangoFontDescription("Times New Roman Italic 10"));
$title->modify_fg(Gtk::STATE_NORMAL, GdkColor::parse("#0000ff"));
$title->set_size_request(-1, 60);
$vbox->pack_start($title, 0, 0);

$vbox->pack_start($hbox=new GtkHBox(), 0, 0);
create_button($hbox, 'Blue');
create_button($hbox, 'Green');
create_button($hbox, 'Yellow');

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

function create_button($hbox, $button_label) {
    $button = new GtkButton($button_label);
    $button->set_size_request(80, 32);
    $hbox->pack_start($button, 1, 0);
    $button->connect('clicked', "on_button", $button_label);

    $button->set_property('has-tooltip', true); // note 1
    $button->connect('query-tooltip', 'on_tooltip'); // note 2
  • Note that this is only 70% of the sample code. You have to be a registered member to see the entire sample code. Please login or register.
  • Registration is free and immediate.
  • Have some doubt about the registration? Please read this forum article.
Explanation
  1. Enable tooltip on the widget.
  2. Connect to the signal 'query-tooltip'.
  3. Display the tooltip as markup text.

Related Links

User reviews

There are no user reviews yet.

Note: You have to be a registered member to leave a comment. Free registration here.

 
< Prev   Next >

Copyright © 2006-2008. kksou.com. All Rights Reserved