AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity

docs: Add replacement example for ImageMenuItem

Browse Source 
Otherwise we will be doomed to answer the question of how to replace
GtkImageMenuItem for all eternity.
This commit is contained in:
Emmanuele Bassi 2014-10-23 17:42:19 +01:00
parent 0144861dca
commit 183257f9e1
1 changed files with 30 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
gtk/deprecated/gtkimagemenuitem.c
View File

@ -49,8 +49,36 @@
*
* A GtkImageMenuItem is a menu item which has an icon next to the text label.
*
* Note that the user can disable display of menu icons, so make sure to still
* fill in the text label.
* This is functionally equivalent to:
*
* |[<!-- 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_label_new ("Music");
* GtkWidget *menu_item = gtk_menu_item_new ();
*
* gtk_container_add (GTK_CONTAINER (box), icon);
* gtk_container_add (GTK_CONTAINER (box), label);
*
* gtk_container_add (GTK_CONTAINER (menu_item), box);
*
* gtk_widget_show_all (menu_item);
* ]|
*
* Note that the user may disable display of menu icons using
* the #GtkSettings:gtk-menu-images setting, so make sure to still
* fill in the text label. If you want to ensure that your menu items
* show an icon you are strongly encouraged to use a #GtkMenuItem
* with a #GtkImage instead.
*
* #GtkImageMenuItem has been deprecated since GTK+ 3.10. If you want to
* display an icon in a menu item, you should use #GtkMenuItem and pack a
* #GtkBox with a #GtkImage and a #GtkLabel instead. You should also consider
* using #GtkBuilder and the XML #GMenu description for creating menus, by
* following the [GMenu guide][https://developer.gnome.org/GMenu/]. You should
* 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.
*/