Class
Gtk.DirectoryList
Description [src]
final class Gtk.DirectoryList : GObject.Object {
/* No available fields */
}
GtkDirectoryList
is a list model that wraps g_file_enumerate_children_async()
.
It presents a GListModel
and fills it asynchronously with the GFileInfo
s
returned from that function.
Enumeration will start automatically when a the
GtkDirectoryList:file
property is set.
While the GtkDirectoryList
is being filled, the
GtkDirectoryList:loading
property will be set to TRUE
. You can
listen to that property if you want to show information like a GtkSpinner
or a “Loading…” text.
If loading fails at any point, the GtkDirectoryList:error
property will be set to give more indication about the failure.
The GFileInfo
s returned from a GtkDirectoryList
have the “standard::file”
attribute set to the GFile
they refer to. This way you can get at the file
that is referred to in the same way you would via g_file_enumerator_get_child()
.
This means you do not need access to the GtkDirectoryList
, but can access
the GFile
directly from the GFileInfo
when operating with a GtkListView
or similar.
Constructors
gtk_directory_list_new
Creates a new GtkDirectoryList
.
Instance methods
gtk_directory_list_get_attributes
Gets the attributes queried on the children.
gtk_directory_list_get_error
Gets the loading error, if any.
gtk_directory_list_get_file
Gets the file whose children are currently enumerated.
gtk_directory_list_get_io_priority
Gets the IO priority set via gtk_directory_list_set_io_priority()
.
gtk_directory_list_get_monitored
Returns whether the directory list is monitoring the directory for changes.
gtk_directory_list_is_loading
Returns TRUE
if the children enumeration is currently in progress.
gtk_directory_list_set_attributes
Sets the attributes
to be enumerated and starts the enumeration.
gtk_directory_list_set_file
Sets the file
to be enumerated and starts the enumeration.
gtk_directory_list_set_io_priority
Sets the IO priority to use while loading directories.
gtk_directory_list_set_monitored
Sets whether the directory list will monitor the directory for changes. If monitoring is enabled, the ::items-changed signal will be emitted when the directory contents change.
Properties
Gtk.DirectoryList:attributes
The attributes to query.
Gtk.DirectoryList:error
Error encountered while loading files.
Gtk.DirectoryList:file
File to query.
Gtk.DirectoryList:io-priority
Priority used when loading.
Gtk.DirectoryList:loading
TRUE
if files are being loaded.
Gtk.DirectoryList:monitored
TRUE
if the directory is monitored for changed.