方法
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,则必须将其初始化为NULLGError。如果没有错误,方法将保留初始化参数为 NULL。在出现错误的情况下,参数将被设置为一个新的 GError;调用者将拥有数据的管理权,并负责释放它。