方法

GLibBookmarkFileset_app_info

已弃用:2.66 自:2.12

声明 [源]

gboolean
g_bookmark_file_set_app_info (
  GBookmarkFile* bookmark,
  const gchar* uri,
  const gchar* name,
  const gchar* exec,
  gint count,
  time_t stamp,
  GError** error
)

描述 [源]

设置 bookmark 中已注册 uri 的应用列表中名为 name 的应用元数据。

很少需要使用此函数,请改用 g_bookmark_file_add_application()g_bookmark_file_remove_application()

name 可以是任何用于标识应用的 UTF-8 编码字符串。 exec 可以有以下两个修饰符之一:“\%f”,这会被展开为从书签的 URI 中检索到的本地文件名;“\%u”,这会被展开为书签的 URI。展开会在使用 g_bookmark_file_get_application_info() 函数检索存储的命令行时自动进行。《code>count 是应用已注册书签的次数;如果它是 < 0,当前的注册计数将增加一个,如果它是 0,带有 name 的应用将从已注册应用列表中删除。《code>stamp 是上次注册的 Unix 时间;如果它是 -1,将使用当前时间。

如果您尝试通过将注册计数设置为 0 来移除应用,并且找不到 uri 的书签,则返回 FALSE,并将 error 设置为 G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND;同样,如果没有应用 nameuri 注册书签,返回 FALSE,并将 error 设置为 G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED。否则,如果在 uri 中找不到书签,将创建一个新的书签。

自 2.12 版本起可用

自 2.66 版本起弃用

建议使用 g_bookmark_file_set_application_info() 代替,因为 time_t 由于 2038 年问题被弃用。

参数

uri

类型: const gchar*

一个有效的 URI

数据由方法的调用者拥有。
值是一个以 NUL 结尾的 UTF-8 字符串。
name

类型: const gchar*

一个应用的名。

数据由方法的调用者拥有。
值是一个以 NUL 结尾的 UTF-8 字符串。
exec

类型: const gchar*

一个应用的命令行。

数据由方法的调用者拥有。
值是一个以 NUL 结尾的 UTF-8 字符串。
count

类型: gint

为此应用所做的注册次数。

stamp

类型: time_t

为此应用进行最后一次注册的时间。

error

类型: GError **

一个可恢复错误的返回位置。

参数可以 NULL
如果返回位置不是 NULL,那么您必须将其初始化为一个 NULL GError*
如果没有错误,方法将保留参数初始化为 NULL
如果有错误,参数将设置为一个新的 GError;调用者将获得数据的所有权,并负责释放它。

返回值

类型: gboolean

如果成功更改了应用的元数据,则为 TRUE