gIconToString: gIconToString

In RGtk2: R Bindings for Gtk 2.8.0 and Above

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

gIconToString(object)

Arguments

object

a GIcon.

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

RGtk2 documentation built on Oct. 14, 2021, 5:08 p.m.