gio.Icon — Interface for icons.
is a very minimal interface for icons. It provides functions for checking
the equality of two icons, hashing of icons and serializing an icon to and from strings.
does not provide the actual pixmap for the icon as this is out of GIO's
scope, however implementations of
may contain the name of an icon (see
or the path to an icon (see
To check if two GIcons are equal, see
For serializing a
If your application or library provides one or more
implementations you need to ensure that each GType is registered
with the type system prior to calling
equal() method checks if two icons are equal.
|An UTF8 string or |
to_string() method generates a textual
representation of icon that can be used for serialization such as when
passing icon to a different process or saving it to persistent storage. Use
to get icon back from the returned string.
The encoding of the returned string is proprietary to GIcon except in the following two cases
If icon is a
the returned string is a native path (such as /path/to/my icon.png) without escaping
for icon is a native file. If the file is not native, the returned string is the result of
(such as sftp://path/to/my%20icon.png).
If icon is a
with exactly one name, the encoding is simply the name (such as network-server).
|A string obtained via
|An object implementing the
If your application or library provides one or more GIcon implementations you need
to ensure that each GType is registered with the type system prior to calling