Icon into a
glib::Variant. An equivalent
Icon can be retrieved
back by calling
Icon::deserialize() on the returned value.
As serialization will avoid using raw icon data when possible, it only
makes sense to transfer the
glib::Variant between processes on the same machine,
(as opposed to over the network), and within the same file system namespace.
Generates a textual representation of
self that can be used for
serialization such as when passing
self to a different process or
saving it to persistent storage. Use
self back from the returned string.
The encoding of the returned string is proprietary to
in the following two cases
FileIcon, the returned string is a native path (such as
/path/to/my icon.png) without escaping if the
selfis a native file. If the file is not native, the returned string is the result of
ThemedIconwith exactly one name and no fallbacks, the encoding is simply the name (such as
An allocated NUL-terminated UTF8 string or
self can’t be serialized. Use
g_free() to free.