summaryrefslogtreecommitdiff
path: root/gtk/gtklabel.c
diff options
context:
space:
mode:
authorHavoc Pennington <hp@redhat.com>2001-06-05 18:22:30 +0000
committerHavoc Pennington <hp@src.gnome.org>2001-06-05 18:22:30 +0000
commit8fd5c30b2fff090657936686d5c18d95157f4b4d (patch)
tree41e4de196cbe91b283df2a317dd8b7939bbd2c39 /gtk/gtklabel.c
parent40bd214919b35f8fb9d306d01180490a6db8a7ed (diff)
downloadgdk-pixbuf-8fd5c30b2fff090657936686d5c18d95157f4b4d.tar.gz
Use new mnemonic convenience functions
2001-06-05 Havoc Pennington <hp@redhat.com> * gtk/gtkcolorsel.c: Use new mnemonic convenience functions Applying patch from Jeff Franks, with function docs added. * gtk/gtkcheckbutton.c (gtk_check_button_new_with_mnemonic): remove call to set_mnemonic_widget, change docs a bit. * gtk/gtkimagemenuitem.c (gtk_image_menu_item_new_with_mnemonic): new function * gtk/gtkcheckmenuitem.c (gtk_check_menu_item_new_with_mnemonic): new function * gtk/gtkmenuitem.c (gtk_menu_item_new_with_mnemonic): new function * gtk/gtkradiobutton.c (gtk_radio_button_new_with_mnemonic): new function (gtk_radio_button_new_with_mnemonic_from_widget): new function * gtk/gtkradiomenuitem.c (gtk_radio_menu_item_new_with_mnemonic): new function * gtk/gtktogglebutton.c (gtk_toggle_button_new_with_mnemonic): new function * gtk/gtklabel.c (gtk_label_new_with_mnemonic): Improve docs on auto-selection of mnemonic widget.
Diffstat (limited to 'gtk/gtklabel.c')
-rw-r--r--gtk/gtklabel.c16
1 files changed, 12 insertions, 4 deletions
diff --git a/gtk/gtklabel.c b/gtk/gtklabel.c
index aa9019932..ac9e465df 100644
--- a/gtk/gtklabel.c
+++ b/gtk/gtklabel.c
@@ -423,10 +423,18 @@ gtk_label_new (const gchar *str)
*
* Creates a new #GtkLabel, containing the text in @str.
*
- * If characters in @str are preceded by an underscore, they are underlined
- * indicating that they represent a keyboard accelerator called a mnemonic.
- * The mnemonic key can be used to activate another widget, chosen automatically,
- * or explicitly using gtk_label_set_mnemonic_widget().
+ * If characters in @str are preceded by an underscore, they are
+ * underlined indicating that they represent a keyboard accelerator
+ * called a mnemonic. The mnemonic key can be used to activate
+ * another widget, chosen automatically, or explicitly using
+ * gtk_label_set_mnemonic_widget().
+ *
+ * If gtk_label_set_mnemonic_widget()
+ * is not called, then the first activatable ancestor of the #GtkLabel
+ * will be chosen as the mnemonic widget. For instance, if the
+ * label is inside a button or menu item, the button or menu item will
+ * automatically become the mnemonic widget and be activated by
+ * the mnemonic.
**/
GtkWidget*
gtk_label_new_with_mnemonic (const gchar *str)