Description

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 gIconNewForString to get icon back from the returned string.

Usage

Arguments

Details

The encoding of the returned string is proprietary to GIcon except in the following two cases

• If icon is a GFileIcon, the returned string is a native path (such as /path/to/my icon.png) without escaping if the GFile for icon is a native file. If the file is not native, the returned string is the result of gFileGetUri (such as sftp://path/to/my% 20icon .png).

• If icon is a GThemedIcon with exactly one name, the encoding is simply the name (such as network-server).

Since 2.20

Value

[character] An allocated UTF8 string or NULL if icon can't be serialized.

Author(s)

Derived by RGtkGen from GTK+ documentation