AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2024-11-17 06:10:15 +00:00
Code Issues Projects Releases Wiki Activity

Added an additional explanation and code snippet for GtkImageMenuItem.c

Browse Source 
https://bugzilla.gnome.org/show_bug.cgi?id=752093
This commit is contained in:
Eric Williams 2015-07-07 14:54:32 -04:00 committed by Matthias Clasen
parent a74a3da745
commit 6038474060
1 changed files with 29 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
gtk/deprecated/gtkimagemenuitem.c
View File

@ -79,6 +79,35 @@
* consider using icons in menu items only sparingly, and for "objects" (or
* "nouns") elements only, like bookmarks, files, and links; "actions" (or
* "verbs") should not have icons.
*
* Furthermore, if you would like to display keyboard accelerator, you must
* pack the accel label into the box using gtk_box_pack_end() and align the
* label, otherwise the accelerator will not display correctly. The following
* code snippet adds a keyboard accelerator to the menu item, with a key
* binding of Ctrl+M:
*
* |[<!-- language="C" -->
* GtkWidget *box = gtk_box_new (GTK_ORIENTATION_HORIZONTAL, 6);
* GtkWidget *icon = gtk_image_new_from_icon_name ("folder-music-symbolic", GTK_ICON_SIZE_MENU);
* GtkWidget *label = gtk_accel_label_new ("Music");
* GtkWidget *menu_item = gtk_menu_item_new ();
* GtkAccelGroup *accel_group = gtk_accel_group_new ();
*
* gtk_container_add (GTK_CONTAINER (box), icon);
*
* gtk_label_set_use_underline (GTK_LABEL (label), TRUE);
* gtk_label_set_xalign (GTK_LABEL (label), 0.0);
*
* gtk_widget_add_accelerator (menu_item, "activate", accel_group,
* GDK_KEY_m, GDK_CONTROL_MASK, GTK_ACCEL_VISIBLE);
* gtk_accel_label_set_accel_widget (GTK_ACCEL_LABEL (label), menu_item);
*
* gtk_box_pack_end (GTK_BOX (box), label, TRUE, TRUE, 0);
*
* gtk_container_add (GTK_CONTAINER (menu_item), box);
*
* gtk_widget_show_all (menu_item);
* ]|
*/