Class

GtkDirectoryList

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.

Hierarchy

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

Ancestors

  • GObject

Implements

  • GListModel

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.

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.

Class structure

struct GtkDirectoryListClass {
  GObjectClass parent_class;
  
}
Class members
parent_class
GObjectClass
  No description available.