GtkRecentManager

描述 [src]

class Gtk.RecentManager : GObject.Object
{
  /* No available fields */
}

GtkRecentManager管理和查找最近使用的文件。

每个最近使用的文件由其URI 标识,并带有与之关联的元数据,例如已注册该文件的应用程序的名称和命令行、每个应用程序注册相同文件的时间次数、文件的 MIME 类型以及是否只有已注册文件的应用程序才应显示文件。它。

最近使用的文件列表因用户而异。

GtkRecentManager充当所有最近使用的文件的数据库。您可以创建新的GtkRecentManager 对象,但是使用由GTK 创建的默认管理器效率更高。

添加新的最近使用的文件与

GtkRecentManager *manager;

manager = gtk_recent_manager_get_default ();
gtk_recent_manager_add_item (manager, file_uri);

GtkRecentManager 将尝试通过GIO 从文件本身收集所有所需的信息。

根据其URI 查找与最近使用的文件关联的元数据需要调用gtk_recent_manager_lookup_item()

GtkRecentManager *manager;
GtkRecentInfo *info;
GError *error = NULL;

manager = gtk_recent_manager_get_default ();
info = gtk_recent_manager_lookup_item (manager, file_uri, &error);
if (error)
  {
    g_warning ("Could not find the file: %s", error->message);
    g_error_free (error);
  }
else
 {
   // Use the info object
   gtk_recent_info_unref (info);
 }

为了检索最近使用文件列表,可以使用gtk_recent_manager_get_items() ,它返回GtkRecentInfo 的列表。

请注意,可以通过GtkSettings:gtk-recent-files-max-age 属性控制最近使用文件列表的最大年龄。

层次结构

hierarchy this GtkRecentManager ancestor_0 GObject ancestor_0--this

上级

构造函数

gtk_recent_manager_new

创建一个新的最近管理器对象。

函数

gtk_recent_manager_get_default

获取GtkRecentManager的唯一实例,您可以在应用程序中共享它,而无需关心内存管理。

实例方法

gtk_recent_manager_add_full

recent_data 中传递的GtkRecentData 内指定的元数据,在最近使用的资源列表中添加一个新的资源,由uri 指向。

gtk_recent_manager_add_item

在最近使用的资源列表中添加一个新的资源,由uri 指向。

gtk_recent_manager_get_items

获取最近使用的资源列表。

gtk_recent_manager_has_item

检查最近管理器中是否注册了带有uri 的最近使用的资源。

gtk_recent_manager_lookup_item

在最近使用的资源列表中搜索URI,并返回一个包含有关资源的信息的GtkRecentInfo,例如它的MIME类型或显示名称。

gtk_recent_manager_move_item

将最近使用的资源的位置从uri 更改为new_uri

gtk_recent_manager_purge_items

清除最近使用的资源列表中的每个项目。

gtk_recent_manager_remove_item

将由 uri 指出的资源从最近使用的资源列表中移除,此列表由一个最近管理管理器处理。

GObject(43)继承的方法

有关完整方法列表,请参阅 GObject 。

属性

Gtk.RecentManager:filename

用于存储和读取最近使用的资源列表的文件的完整路径。

Gtk.RecentManager:size

最近使用的资源列表的大小。

信号

Gtk.RecentManager::changed

在当前最近使用的资源管理器更改其内容时发出。

GObject(1)继承的信号
GObject::notify

当对象的一个属性通过 g_object_set_property()、g_object_set() 等设置了其值后,会发出 notify 信号。

类结构

struct GtkRecentManagerClass {
  void (* changed) (
    GtkRecentManager* manager
  );
  void (* _gtk_recent1) (
void
  );
  void (* _gtk_recent2) (
void
  );
  void (* _gtk_recent3) (
void
  );
  void (* _gtk_recent4) (
void
  );
  
}

GtkRecentManagerClass 仅包含私有数据。

类成员
changed: void (* changed) ( GtkRecentManager* manager )

无可用说明。

_gtk_recent1: void (* _gtk_recent1) ( void )

无可用说明。

_gtk_recent2: void (* _gtk_recent2) ( void )

无可用说明。

_gtk_recent3: void (* _gtk_recent3) ( void )

无可用说明。

_gtk_recent4: void (* _gtk_recent4) ( void )

无可用说明。

虚方法

Gtk.RecentManagerClass.changed
无可用说明。