GtkDirectoryList

描述 [源代码]

final class Gtk.DirectoryList : GObject.Object
  implements Gio.ListModel {
  /* No available fields */
}

GtkDirectoryList 是包装 g_file_enumerate_children_async() 的列表模型。

它表示一个 GListModel,并使用从该函数返回的 GFileInfo 异步填充它。

GtkDirectoryList:file 属性设置为 时,枚举将自动开始。

GtkDirectoryList 填充期间,GtkDirectoryList:loading 属性将设置为 TRUE。如果你想显示像 GtkSpinner 或“正在加载...“ 等信息,可以监听该属性。

如果加载在任何时间点失败,GtkDirectoryList:error 属性将被设置为提供更多有关失败的信息。

从 GtkDirectoryList 返回的 GFileInfo 将“standard::file”属性设置为它们引用的 GFile。这样,你可以通过与通过 g_file_enumerator_get_child() 相同的方式获取引用的文件。这意味着你不需要访问 GtkDirectoryList,但可以在使用 GtkListView 或类似工具时直接从 GFileInfo 访问 GFile

层次

hierarchy this GtkDirectoryList implements_0 GListModel this--implements_0 ancestor_0 GObject ancestor_0--this

祖先

实现

构造函数

gtk_directory_list_new

创建一个新的 GtkDirectoryList

实例方法

gtk_directory_list_get_attributes

获取在子元素上查询的属性。

gtk_directory_list_get_error

获取加载错误(如果有)。

gtk_directory_list_get_file

获取当前枚举其子元素的文件。

gtk_directory_list_get_io_priority

获取通过 gtk_directory_list_set_io_priority() 设置的 IO 优先级。

gtk_directory_list_get_monitored

返回目录列表是否监控目录的更改内容。

gtk_directory_list_is_loading

如果子元素枚举当前正在进行,返回 TRUE

gtk_directory_list_set_attributes

设置要枚举的 attributes 并开始枚举。

gtk_directory_list_set_file

设置要枚举的 file 并开始枚举。

gtk_directory_list_set_io_priority

设置在加载目录时要使用的 IO 优先级。

gtk_directory_list_set_monitored

设置目录列表是否将监视目录是否有更改。

GObject (43) 继承的方法

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

GListModel (5) 继承的方法
g_list_model_get_item

获取 position 位置的项。

g_list_model_get_item_type

获取 list 中项的类型。

g_list_model_get_n_items

获取 list 中的项数。

g_list_model_get_object

获取 position 位置的项。

g_list_model_items_changed

list 上发出 GListModel::items-changed 信号。

属性

Gtk.DirectoryList:attributes

要查询的属性。

Gtk.DirectoryList:error

加载文件时遇到的错误。

Gtk.DirectoryList:file

要查询的文件。

Gtk.DirectoryList:io-priority

加载时使用的优先级。

Gtk.DirectoryList:item-type

项的类型。请参见 g_list_model_get_item_type()

since: 4.8

Gtk.DirectoryList:loading

如果正在加载文件,则为 TRUE

Gtk.DirectoryList:monitored

如果正在监视目录是否更改,则为 TRUE

Gtk.DirectoryList:n-items

项数。请参见 g_list_model_et_n_items()

since: 4.8

信号

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

当对象的某个属性的值通过 g_object_set_property()、g_object_set() 等函数设置时,会对该对象发出 notify 信号。

GListModel (1) 继承的信号
GListModel::items-changed

每当向 list 中添加项或从中移除项时,都会发出此信号。在 position 位置,已移除 removed 个项,已在该位置添加 added 个项。

类结构

struct GtkDirectoryListClass {
  GObjectClass parent_class;
  
}

暂无说明。

类成员
parent_class: GObjectClass

暂无说明。