结构
GLibBookmarkFile
since: 2.12
说明 [src]
struct GBookmarkFile {
/* No available fields */
}
GBookmarkFile 允许你解析、编辑或创建包含书签的文件。
书签指代 URI，以及有关由 URI 指示的资源的一些元数据，如其 MIME 类型、注册书签的应用程序以及应该用来表示该书签的图标。使用 桌面书签规范 存储数据。
书签文件语法已在桌面书签规范中做了详细说明，这里做个简要总结：书签文件使用扩展自 XML 书签交换语言规范的子类，由有效的 UTF-8 编码 XML 以及 <xbel> 根元素组成；每个书签都存储在 <bookmark> 元素内，使用其 URI：书签文件中不能使用相对路径。书签可以有用户定义的标题和描述，用以代替 URI。在 <metadata> 元素（其所有者属性已设置为 http://freedesktop.org）之下，存储着由其 URI 指向的资源的元数据。元数据包括以下内容：资源的 MIME 类型；已注册书签的应用程序；书签所属的组；用于将书签设为“私密”，仅向已将其注册的应用程序和组开放的可见性标记；URI，以及当在 GUI 中显示书签时用到的图标的 MIME 类型。
以下是书签文件的一个示例：bookmarks.xbel
一个书签文件可能包含多个书签；可以利用其 URI 来访问每一个书签。
书签文件的重要的需要注意的是，当你添加新的书签时，还必须添加注册它的应用程序，方法是使用 g_bookmark_file_add_application() 或 g_bookmark_file_set_application_info()。如果某书签没有应用程序，该书签将不会在创建磁盘表示时转储，方法是使用 g_bookmark_file_to_data() 或 g_bookmark_file_to_file()。
自 2.12 起可用
实例方法
g_bookmark_file_add_application
将具有 name 和 exec 的应用程序添加到已为 uri 注册了书签的应用程序列表，存入 bookmark。
since: 2.12
g_bookmark_file_get_app_info
获取 uri 书签的 app_name 的注册信息。更多有关返回数据的详情，请参见 g_bookmark_file_set_application_info()。
已弃用：2.66 自 2.12 起可用
g_bookmark_file_get_application_info
获取 uri 书签的 app_name 的注册信息。更多有关返回数据的详情，请参见 g_bookmark_file_set_application_info()。
自 2.66 起可用
g_bookmark_file_load_from_data
从内存加载书签文件到一个空的 GBookmarkFile 结构中。如果无法创建对象，则将 error 设置为 GBookmarkFileError。
since: 2.12
g_bookmark_file_load_from_data_dirs
此函数从 g_get_user_data_dir() 和 g_get_system_data_dirs() 返回的路径中查找名为 file 的桌面书签文件，将文件加载到 bookmark 中，并在 full_path 中返回文件的完整路径。如果无法加载该文件，则将 error 设置为 GFileError 或 GBookmarkFileError。
since: 2.12
g_bookmark_file_load_from_file
将桌面书签文件加载到一个空的 GBookmarkFile 结构中。如果无法加载该文件，则将 error 设置为 GFileError 或 GBookmarkFileError。
since: 2.12
g_bookmark_file_move_item
将书签项目的 URI 从 old_uri 更改为 new_uri。将覆盖对 new_uri 的任何现有书签。如果 new_uri 为 NULL，则将移除该书签。
since: 2.12
g_bookmark_file_set_icon
设置 uri 的书签图标。如果 href 为 NULL，则取消设置当前设置的图标。href 可以是图标文件的完整 URL，也可以是遵循图标命名规范的图标名称。
since: 2.12