A label which displays an accelerator key on the right of the text
gtkAccelLabelNew(string = NULL, show = TRUE)
gtkAccelLabel(string = NULL, show = TRUE)
1 2 3 4 5 6 7
GtkAccelLabel widget is a subclass of
GtkLabel that also displays an
accelerator key on the right of the label text, e.g. 'Ctl+S'.
It is commonly used in menus to show the keyboard short-cuts for commands.
The accelerator key to display is not set explicitly.
GtkAccelLabel displays the accelerators which have been added to
a particular widget. This widget is set by calling
For example, a
GtkMenuItem widget may have an accelerator added to emit the
"activate" signal when the 'Ctl+S' key combination is pressed.
GtkAccelLabel is created and added to the
gtkAccelLabelSetAccelWidget is called with the
GtkMenuItem as the
second argument. The
GtkAccelLabel will now display 'Ctl+S' after its label.
Note that creating a
one of the similar functions for
automatically adds a
GtkAccelLabel to the
GtkMenuItem and calls
gtkAccelLabelSetAccelWidget to set it up for you.
GtkAccelLabel will only display accelerators which have
GtkAccelLabel can display multiple accelerators and even signal names,
though it is almost always used to display just one accelerator key.
Creating a simple menu item with an accelerator key.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
## Creating a simple menu item with an accelerator key. ## Create a GtkAccelGroup and add it to the window. accel_group = gtkAccelGroup() window$addAccelGroup(accel_group) ## Create the menu item save_item = gtkMenuItem("Save") menu$add(save_item) ## Now add the accelerator to the GtkMenuItem. ## It will be activated if the user types ctrl-s ## We just need to make sure we use the "visible" flag here to show it. save_item$addAccelerator("activate", accel_group, GDK_S, "control-mask", "visible")
GtkAccelLabel struct contains private data only, and
should be accessed using the functions below.
gtkAccelLabel is the equivalent of
GClosure: * : Read / Write]
The closure to be monitored for accelerator changes.
GtkWidget: * : Read / Write]
The widget to be monitored for accelerator changes.
Derived by RGtkGen from GTK+ documentation
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.