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

#include <gtk/gtk.h>

            gtkrecentchoosermenu;
gtkwidget*  gtk_recent_chooser_menu_new     (void);
gtkwidget*  gtk_recent_chooser_menu_new_for_manager
                                            (gtkrecentmanager *manager);

gboolean    gtk_recent_chooser_menu_get_show_numbers
                                            (gtkrecentchoosermenu *menu);
void        gtk_recent_chooser_menu_set_show_numbers
                                            (gtkrecentchoosermenu *menu,
                                             gboolean show_numbers);

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

  gobject
   +----ginitiallyunowned
         +----gtkobject

               +----gtkwidget
                     +----gtkcontainer
                           +----gtkmenushell
                                 +----gtkmenu
                                       +----gtkrecentchoosermenu

реализуемые интерфейсы

gtkrecentchoosermenu реализует atkimplementoriface и gtkrecentchooser.

свойства

  "show-numbers"         gboolean              : read / write

описание

gtkrecentchoosermenu это виджет для отображения недавно использованных файлов в меню. он может использоваться для установки подменю gtkmenuitem используя gtk_menu_item_set_submenu(), или как меню gtkmenutoolbutton.

помните, gtkrecentchoosermenu не имеет собственных методов. вместо этого, вы должны использовать функции работающие в gtkrecentchooser.

помните также что gtkrecentchoosermenu не поддерживает множественные фильтры, поскольку нет способа позволить пользователю выбирать между ними как это делается в виджетах gtkrecentchooserwidget и gtkrecentchooserdialog. таким образом использование gtk_recent_chooser_add_filter() в gtkrecentchoosermenu виджете приведет к тому же результату как использование gtk_recent_chooser_set_filter(), заменяя любой текущий фильтр поставляемым фильтром; gtk_recent_chooser_remove_filter() удалит любой текущий установленный объект gtkrecentfilter и отменит текущий фильтр; gtk_recent_chooser_list_filters() вернёт список содержащий единственный объект gtkrecentfilter.

недавно использованные фалы поддерживаются начиная с версии gtk+ 2.10.

детали

gtkrecentchoosermenu

typedef struct _gtkrecentchoosermenu gtkrecentchoosermenu;

gtk_recent_chooser_menu_new ()

gtkwidget*  gtk_recent_chooser_menu_new     (void);

создаёт новый виджет gtkrecentchoosermenu.

этот класс виджета показывает список недавно использованных ресурсов как меню, каждый элемент как пункт меню. каждый пункт в меню может иметь значок, представляющий mime тип и номер, для мнемонического доступа.

этот виджет реализует интерфейс gtkrecentchooser.

виджет создаёт собственный объект gtkrecentmanager. смотрите функцию gtk_recent_chooser_menu_new_for_manager() чтобы понять как создаётся gtkrecentchoosermenu виджет связанный с другим gtkrecentmanager объектом.

начиная с версии 2.10

gtk_recent_chooser_menu_new_for_manager ()

gtkwidget*  gtk_recent_chooser_menu_new_for_manager
                                            (gtkrecentmanager *manager);

создаёт новый gtkrecentchoosermenu виджет используя manager как основной менеджер недавно использованных ресурсов.

это полезно если вы реализуете свой собственный менеджер, или если вы хотите настроить образец объекта gtkrecentmanager, или если вы желаете совместно использовать основной объект gtkrecentmanager наряду с множеством виджетов gtkrecentchooser.

начиная с версии 2.10

gtk_recent_chooser_menu_get_show_numbers ()

gboolean    gtk_recent_chooser_menu_get_show_numbers
                                            (gtkrecentchoosermenu *menu);

возвращает значение установленное с помощью gtk_recent_chooser_menu_set_show_numbers().

начиная с версии 2.10

gtk_recent_chooser_menu_set_show_numbers ()

void        gtk_recent_chooser_menu_set_show_numbers
                                            (gtkrecentchoosermenu *menu,
                                             gboolean show_numbers);

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

начиная с версии 2.10

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

свойство "show-numbers"

  "show-numbers"         gboolean              : read / write

должны ли первые десять пунктов в меню иметь номера уникальных мнемоников.

значение по умолчанию: false

начиная с версии 2.10

смотрите также

gtkrecentchooser