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 GFileInfos
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 GFileInfos 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.