краткое описание

#include <gtk/gtk.h>


            gtkimagemenuitem;
void        gtk_image_menu_item_set_image   (gtkimagemenuitem *image_menu_item,
                                             gtkwidget *image);
gtkwidget*  gtk_image_menu_item_get_image   (gtkimagemenuitem *image_menu_item);
gtkwidget*  gtk_image_menu_item_new         (void);
gtkwidget*  gtk_image_menu_item_new_from_stock
                                            (const gchar *stock_id,
                                             gtkaccelgroup *accel_group);
gtkwidget*  gtk_image_menu_item_new_with_label
                                            (const gchar *label);
gtkwidget*  gtk_image_menu_item_new_with_mnemonic
                                            (const gchar *label);

иерархия объектов

  gobject
   +----ginitiallyunowned
         +----gtkobject
               +----gtkwidget
                     +----gtkcontainer
                           +----gtkbin
                                 +----gtkitem
                                       +----gtkmenuitem
                                             +----gtkimagemenuitem

осуществляемые интерфейсы

gtkimagemenuitem осуществляет atkimplementoriface.

свойства

  "image"                gtkwidget             : read / write

описание

gtkimagemenuitem это пункт меню в котором рядом с ярлыком располагается значок.

помните, пользователь может отключить отображение значков меню, так что лучше удостовериться в наличии текстового ярлыка.

детали

gtkimagemenuitem

typedef struct _gtkimagemenuitem gtkimagemenuitem;

gtk_image_menu_item_set_image ()

void        gtk_image_menu_item_set_image   (gtkimagemenuitem *image_menu_item,
                                             gtkwidget *image);

устанавливает изображение image_menu_item для данного виджета. помните отображение значков зависит от установок show-menu-images.

gtk_image_menu_item_get_image ()

gtkwidget*  gtk_image_menu_item_get_image   (gtkimagemenuitem *image_menu_item);

получает виджет установленный в текущий момент как изображение image_menu_item. смотрите gtk_image_menu_item_set_image().

gtk_image_menu_item_new ()

gtkwidget*  gtk_image_menu_item_new         (void);

создаёт новый gtkimagemenuitem с пустым ярлыком.

gtk_image_menu_item_new_from_stock ()

gtkwidget*  gtk_image_menu_item_new_from_stock
                                            (const gchar *stock_id,
                                             gtkaccelgroup *accel_group);

создаёт новый gtkimagemenuitem содержащий изображение и текст из заготовленных пунктов. некоторые id заготовок имеют макрокоманды препроцессора такие как gtk_stock_ok и gtk_stock_apply.

если вы хотите чтобы эти пункты меню имели изменяемые акселераторы, установите null для accel_group. затем вызовите gtk_menu_item_set_accel_path() с соответствующим путем пункта меню, используйте gtk_stock_lookup() для поиска стандартного акселератора для заготовленного пункта меню и если он найден, вызовите gtk_accel_map_add_entry() для регистрации.

gtk_image_menu_item_new_with_label ()

gtkwidget*  gtk_image_menu_item_new_with_label
                                            (const gchar *label);

создаёт новый gtkimagemenuitem содержащий ярлык.

gtk_image_menu_item_new_with_mnemonic ()

gtkwidget*  gtk_image_menu_item_new_with_mnemonic
                                            (const gchar *label);

создаёт новый gtkimagemenuitem содержащий ярлык. ярлык должен быть создан с помощью gtk_label_new_with_mnemonic(), таким образом подчеркивание в label указывает на мнемоник для пункта меню.

детали свойств

свойство "image"

  "image"                gtkwidget             : read / write

дочерний виджет появляющийся рядом с текстом пункта меню.