方法

GLibBookmarkFileset_application_info

自 2.66

声明 [源]

gboolean
g_bookmark_file_set_application_info (
  GBookmarkFile* bookmark,
  const char* uri,
  const char* name,
  const char* exec,
  int count,
  GDateTime* stamp,
  GError** error
)

描述 [源]

设置在 bookmark 中注册了 uri 的应用程序列表内部的 name 的元数据。

很少使用该函数;请使用 g_bookmark_file_add_application()g_bookmark_file_remove_application() 代替。

name 可以是任何用于标识应用程序的 UTF-8 编码字符串。《执行》可以有这两个修改符中的一个:“\%f”,它将被展开为从书签的 URI 获取的本地文件名;“\%u”,它将被展开为书签的 URI。在自动使用 g_bookmark_file_get_application_info() 函数检索存储的命令行时执行展开。count 是应用程序注册书签的次数;如果小于 0,当前的注册计数将增加一个,如果为 0,具有 name 的应用程序将从中删除注册应用程序列表。stamp 是最后一次注册的 Unix 时间。

如果尝试通过将应用的注册数设置为零来删除应用,且没有找到对应的uri书签,则返回FALSE并将错误设置为G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND;同样地,如果没有应用为uri注册书签,则返回FALSE并将错误设置为G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED。否则,如果没有找到相应的uri书签,将创建一个。

自:2.66

参数

uri

类型:const char*

有效的URI

数据属于方法的调用者。
该值是NUL终止的UTF-8字符串。
name

类型:const char*

应用的名字。

数据属于方法的调用者。
该值是NUL终止的UTF-8字符串。
exec

类型:const char*

应用的命令行。

数据属于方法的调用者。
该值是NUL终止的UTF-8字符串。
count

类型:int

为此应用完成的注册次数。

stamp

类型:GDateTime

为此应用最后注册的时间,如果count为0,则可能是NULL

此参数可以是NULL
数据属于方法的调用者。
error

类型:GError **

用于可恢复错误的返回位置。

此参数可以是NULL
如果返回位置不为NULL,则必须将其初始化为NULL GError
如果没有错误,方法将保留初始化参数为NULL
在出现错误的情况下,参数将被设置为一个新的GError;调用者将拥有数据的管理权,并负责释放它。

返回值

类型:gboolean

TRUE如果成功更改了应用的元数据。