DirectoryList
open class DirectoryList : GLibObject.Object, DirectoryListProtocol
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
[propertyGtk.DirectoryList:file
] property is set.
While the GtkDirectoryList
is being filled, the
[propertyGtk.DirectoryList: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 [propertyGtk.DirectoryList:error
]
property will be set to give more indication about the failure.
The GFileInfo
s returned from a GtkDirectoryList
have the “standardfile
”
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.
The DirectoryList
type acts as a reference-counted owner of an underlying GtkDirectoryList
instance.
It provides the methods that can operate on this data type through DirectoryListProtocol
conformance.
Use DirectoryList
as a strong reference or owner of a GtkDirectoryList
instance.
-
Designated initialiser from the underlying `C` data type.
This creates an instance without performing an unbalanced retain i.e., ownership is transferred to the
DirectoryList
instance.Declaration
Swift
@inlinable public init(_ op: UnsafeMutablePointer<GtkDirectoryList>)
Parameters
op
pointer to the underlying object
-
Designated initialiser from a constant pointer to the underlying
C
data type. This creates an instance without performing an unbalanced retain i.e., ownership is transferred to theDirectoryList
instance.Declaration
Swift
@inlinable public init(_ op: UnsafePointer<GtkDirectoryList>)
Parameters
op
pointer to the underlying object
-
Optional initialiser from a non-mutating
gpointer
to the underlyingC
data type. This creates an instance without performing an unbalanced retain i.e., ownership is transferred to theDirectoryList
instance.Declaration
Swift
@inlinable override public init!(gpointer op: gpointer?)
Parameters
op
gpointer to the underlying object
-
Optional initialiser from a non-mutating
gconstpointer
to the underlyingC
data type. This creates an instance without performing an unbalanced retain i.e., ownership is transferred to theDirectoryList
instance.Declaration
Swift
@inlinable override public init!(gconstpointer op: gconstpointer?)
Parameters
op
pointer to the underlying object
-
Optional initialiser from a constant pointer to the underlying
C
data type. This creates an instance without performing an unbalanced retain i.e., ownership is transferred to theDirectoryList
instance.Declaration
Swift
@inlinable public init!(_ op: UnsafePointer<GtkDirectoryList>?)
Parameters
op
pointer to the underlying object
-
Optional initialiser from the underlying
C
data type. This creates an instance without performing an unbalanced retain i.e., ownership is transferred to theDirectoryList
instance.Declaration
Swift
@inlinable public init!(_ op: UnsafeMutablePointer<GtkDirectoryList>?)
Parameters
op
pointer to the underlying object
-
Designated initialiser from the underlying
C
data type. Will retainGtkDirectoryList
. i.e., ownership is transferred to theDirectoryList
instance.Declaration
Swift
@inlinable public init(retaining op: UnsafeMutablePointer<GtkDirectoryList>)
Parameters
op
pointer to the underlying object
-
Reference intialiser for a related type that implements
DirectoryListProtocol
Will retainGtkDirectoryList
.Declaration
Swift
@inlinable public init<T>(directoryList other: T) where T : DirectoryListProtocol
Parameters
other
an instance of a related type that implements
DirectoryListProtocol
-
Unsafe typed initialiser. Do not use unless you know the underlying data type the pointer points to conforms to
DirectoryListProtocol
.Declaration
Swift
@inlinable override public init<T>(cPointer p: UnsafeMutablePointer<T>)
Parameters
cPointer
pointer to the underlying object
-
Unsafe typed, retaining initialiser. Do not use unless you know the underlying data type the pointer points to conforms to
DirectoryListProtocol
.Declaration
Swift
@inlinable override public init<T>(retainingCPointer cPointer: UnsafeMutablePointer<T>)
Parameters
cPointer
pointer to the underlying object
-
Unsafe untyped initialiser. Do not use unless you know the underlying data type the pointer points to conforms to
DirectoryListProtocol
.Declaration
Swift
@inlinable override public init(raw p: UnsafeRawPointer)
Parameters
p
raw pointer to the underlying object
-
Unsafe untyped, retaining initialiser. Do not use unless you know the underlying data type the pointer points to conforms to
DirectoryListProtocol
.Declaration
Swift
@inlinable override public init(retainingRaw raw: UnsafeRawPointer)
-
Unsafe untyped initialiser. Do not use unless you know the underlying data type the pointer points to conforms to
DirectoryListProtocol
.Declaration
Swift
@inlinable public required init(raw p: UnsafeMutableRawPointer)
Parameters
p
mutable raw pointer to the underlying object
-
Unsafe untyped, retaining initialiser. Do not use unless you know the underlying data type the pointer points to conforms to
DirectoryListProtocol
.Declaration
Swift
@inlinable required public init(retainingRaw raw: UnsafeMutableRawPointer)
Parameters
raw
mutable raw pointer to the underlying object
-
Unsafe untyped initialiser. Do not use unless you know the underlying data type the pointer points to conforms to
DirectoryListProtocol
.Declaration
Swift
@inlinable override public init(opaquePointer p: OpaquePointer)
Parameters
p
opaque pointer to the underlying object
-
Unsafe untyped, retaining initialiser. Do not use unless you know the underlying data type the pointer points to conforms to
DirectoryListProtocol
.Declaration
Swift
@inlinable override public init(retainingOpaquePointer p: OpaquePointer)
Parameters
p
opaque pointer to the underlying object
-
Creates a new
GtkDirectoryList
.The
GtkDirectoryList
is querying the givenfile
with the givenattributes
.Declaration
Swift
@inlinable public init<FileT>(attributes: UnsafePointer<CChar>? = nil, file: FileT?) where FileT : FileProtocol