方法
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
;调用者将拥有数据的管理权,并负责释放它。