php-gtk2 Cookbook: How to add mnemonic to GtkButton?

RSS Feed

Google Search

PHP-GTK2 eBooks

Most Recent Reviews

Frédéric rates article "Accordion Menu Apple style - variation 2":
Nov 19, 2008 8:07am
bescherelle rates sample code 507:
Nov 18, 2008 9:52am
Bartosz says: Hello, I have both Hide DirectPHP for RSS Feed and Hide include_content_item ...
Nov 17, 2008 9:57am
jerryhou rates article "StickyNote plugin":
Nov 16, 2008 9:42pm
sunil thakare rates article "2.2 Understand the Fill parameter":
Nov 16, 2008 10:54am
doutrax says: hello! looks like a nice plugin, but is it possible with a stand-a-lone ...
Nov 16, 2008 9:55am
acara2000 rates article "StickyNote plugin":
Nov 15, 2008 11:43am
mmka says: asd ...
Nov 15, 2008 5:07am
XeKtRuM rates sample code 530:
Nov 14, 2008 5:58am
underdpt rates sample code 530:
Nov 13, 2008 9:36am
Heinrich Stamerjohanns rates sample code 24:
Nov 12, 2008 3:27pm

Main Menu

Home

Sample Codes

List all sample codes

Browse all sample codes

Side Menu

Joomla Joomla Gadgets Joomla - sample 1 Joomla - sample 2 Joomla 1.0 to 1.5 Google Image Search Google News Search Wikipedia Search Google Book Search Google Video Search Yahoo Stock Quote

PHP-GTK2 Newsletter

PHP-GTK2 Tips & Techniques
FREE Newsletter
by kksou

Your privacy is respected.

Sample Code 188: How to add mnemonic to GtkButton?

Written by kksou

Thursday, 01 March 2007

Problem

In How to add mnemonic to GtkLabel?, we added mnemonics, or keyboard accelerators, to GtkLabels.

In this example, we will add mnemonics to GtkButtons as shown below:

How to add mnemonic to GtkButton?

Solution

First create a standard GtkButton.
Get the button label with GtkBin::child.
Then set the label text using GtkLabel::set_text_with_mnemonic() as outlined in the article How to add mnemonic to GtkLabel?

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

<?php
$window = new GtkWindow();
$window->set_size_request(400, 150);
$window->connect_simple('destroy', array('Gtk','main_quit'));
$window->add($vbox = new GtkVBox());

// display title
$title = new GtkLabel("Add mnemonic to GtkButotn");
$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);

$hbox = new GtkHBox();

for ($i=0; $i<3; ++$i) {
    $button = new GtkButton('');
    $button_label = $button->child; // note 1
    $button_label->set_text_with_mnemonic('button _'.($i+1)); // note 2
    $button->set_size_request(80, 32);
    $button->connect('clicked', 'on_click');
    $hbox->pack_start($button);
    $hbox->pack_start(new GtkLabel(''));
}

$alignment = new GtkAlignment(0.5, 0, 0, 0);

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

The example above makes use of the code from How to set the button to the exact size you want - Part 3 - group of buttons? to display the three buttons.

What's new here:

Get the button label.
Set the label text with mnemonic. Note the use of underscore to indicate the mnemonic.

You can now press Alt-1, Alt-2, Alt-3 to activate these buttons.

Note

Note that in the article How to add mnemonic to GtkLabel?, we need to use the method GtkLabel::set_mnemonic_widget() to associate each mnemonic to the widget that will be activated.

This method is not required in this example because php-gtk2 is smart enough to automatically associate the mnemonic we set on the button label to its parent (i.e. the button).