Package: gtk

Class gtk:directory-list

Superclasses

gio:list-model, gobject:object, common-lisp:standard-object, common-lisp:t

Documented Subclasses

None

Direct Slots

attributes
The attributes property of type :string (Read / Write)
The attributes to query.
Default value: nil
error
The error property of type glib:error (Read)
The error encountered while loading files.
file
The file property of type g:file (Read / Write)
The file to query.
io-priority
The io-priority property of type :int (Read / Write)
The priority used when loading.
Allowed values: >= -2147483647
Default value: g:+priority-default+
item-type
The item-type property of type g:type-t (Read)
The type of items. Since 4.8
loading
The loading property of type :boolean (Read)
True if files are being loaded.
Default value: false
monitored
The monitored property of type :boolean (Read / Write)
True if the directory is monitored for changed.
Default value: true
n-items
The n-items property of type :uint (Read / Write)
The number of items. Since 4.8
Default value: 0

Details

The gtk:directory-list class is a list model that wraps the requested information from the g_file_enumerate_children_async() function. It presents a g:list-model object and fills it asynchronously with the g:file-info objects returned from that function. Enumeration will start automatically when the file property is set.

While the gtk:directory-list object is being filled, the loading property will be set to true. You can listen to that property if you want to show information like a gtk:spinner widget or a "Loading..." text.

If loading fails at any point, the error property will be set to give more indication about the failure.

The g:file-info objects returned from a gtk:directory-list object have the "standard::file" attribute set to the g:file object they refer to. This way you can get the file that is referred to in the same way you would via the g_file_enumerator_child() function. This means you do not need access to the gtk:directory-list object but can access the g:file object directly from the g:file-info object when operating with a gtk:list-view widget or similar.
 

Inherited Slot Access Functions

See also

2024-12-15