方法

JavaIconto_string

自: 2.20

声明 [src]

gchar*
g_icon_to_string (
  GIcon* icon
)

描述 [src]

生成 icon 的文本表示形式，可用于序列化，例如在将 icon 传递给不同的进程或将其保存到持久存储时。使用 g_icon_new_for_string() 从返回的字符串中获取 icon。

返回字符串的编码专属于 GIcon，但在以下两种情况下除外：

  • 如果 icon 是 GFileIcon，则返回的字符串是本地路径（例如 /path/to/my icon.png），如果没有转义，则是在 GFile 对于 icon 是本地文件的情况下。如果不是本地文件，则返回的字符串是 g_file_get_uri() 的结果（例如 sftp://path/to/my%20icon.png）。

  • 如果 icon 是具有一个名称且没有回退的 GThemedIcon，则编码只是名称（例如 network-server）。

自: 2.20

返回值

类型: gchar*

一个分配的以空字符终止的 UTF8 字符串或 NULL，如果 icon 无法序列化。使用 g_free() 释放。

方法调用者拥有返回数据的所有权，并负责释放它。
返回值可能是 NULL。
该值是空字符终止的 UTF-8 字符串。