|
Packit |
ae235b |
|
|
Packit |
ae235b |
<html>
|
|
Packit |
ae235b |
<head>
|
|
Packit |
ae235b |
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
Packit |
ae235b |
<title>Bookmark file parser: GLib Reference Manual</title>
|
|
Packit |
ae235b |
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
|
|
Packit |
ae235b |
<link rel="home" href="index.html" title="GLib Reference Manual">
|
|
Packit |
ae235b |
<link rel="up" href="glib-utilities.html" title="GLib Utilities">
|
|
Packit |
ae235b |
<link rel="prev" href="glib-Key-value-file-parser.html" title="Key-value file parser">
|
|
Packit |
ae235b |
<link rel="next" href="glib-Testing.html" title="Testing">
|
|
Packit |
ae235b |
<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
|
|
Packit |
ae235b |
<link rel="stylesheet" href="style.css" type="text/css">
|
|
Packit |
ae235b |
</head>
|
|
Packit |
ae235b |
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Top |
|
|
Packit |
ae235b |
Description
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Bookmark file parser
|
|
Packit |
ae235b |
Bookmark file parser — parses files containing bookmarks
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Functions
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GBookmarkFile *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_new ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_free ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_load_from_file ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_load_from_data ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_load_from_data_dirs ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gchar *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_to_data ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_to_file ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_has_item ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_has_group ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_has_application ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gint
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_size ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gchar **
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_uris ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gchar *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_title ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gchar *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_description ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gchar *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_mime_type ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_is_private ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_icon ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
time_t
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_added ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
time_t
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_modified ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
time_t
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_visited ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gchar **
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_groups ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gchar **
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_applications ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_app_info ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_set_title ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_set_description ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_set_mime_type ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_set_is_private ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_set_icon ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_set_added ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_set_groups ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_set_modified ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_set_visited ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_set_app_info ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_add_group ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_add_application ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_remove_group ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_remove_application ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_remove_item ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_move_item ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Types and Values
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
#define
|
|
Packit |
ae235b |
G_BOOKMARK_FILE_ERROR
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
enum
|
|
Packit |
ae235b |
GBookmarkFileError
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Includes
|
|
Packit |
ae235b |
#include <glib.h>
|
|
Packit |
ae235b |
#include <glib/gprintf.h>
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Description
|
|
Packit |
ae235b |
GBookmarkFile lets you parse, edit or create files containing bookmarks
|
|
Packit |
ae235b |
to URI, along with some meta-data about the resource pointed by the URI
|
|
Packit |
ae235b |
like its MIME type, the application that is registering the bookmark and
|
|
Packit |
ae235b |
the icon that should be used to represent the bookmark. The data is stored
|
|
Packit |
ae235b |
using the
|
|
Packit |
ae235b |
Desktop Bookmark Specification.
|
|
Packit |
ae235b |
The syntax of the bookmark files is described in detail inside the
|
|
Packit |
ae235b |
Desktop Bookmark Specification, here is a quick summary: bookmark
|
|
Packit |
ae235b |
files use a sub-class of the XML Bookmark Exchange Language
|
|
Packit |
ae235b |
specification, consisting of valid UTF-8 encoded XML, under the
|
|
Packit |
ae235b |
<xbel> root element; each bookmark is stored inside a
|
|
Packit |
ae235b |
<bookmark> element, using its URI: no relative paths can
|
|
Packit |
ae235b |
be used inside a bookmark file. The bookmark may have a user defined
|
|
Packit |
ae235b |
title and description, to be used instead of the URI. Under the
|
|
Packit |
ae235b |
<metadata> element, with its owner attribute set to
|
|
Packit |
ae235b |
http://freedesktop.org, is stored the meta-data about a resource
|
|
Packit |
ae235b |
pointed by its URI. The meta-data consists of the resource's MIME
|
|
Packit |
ae235b |
type; the applications that have registered a bookmark; the groups
|
|
Packit |
ae235b |
to which a bookmark belongs to; a visibility flag, used to set the
|
|
Packit |
ae235b |
bookmark as "private" to the applications and groups that has it
|
|
Packit |
ae235b |
registered; the URI and MIME type of an icon, to be used when
|
|
Packit |
ae235b |
displaying the bookmark inside a GUI.
|
|
Packit |
ae235b |
Here is an example of a bookmark file:
|
|
Packit |
ae235b |
bookmarks.xbel
|
|
Packit |
ae235b |
A bookmark file might contain more than one bookmark; each bookmark
|
|
Packit |
ae235b |
is accessed through its URI.
|
|
Packit |
ae235b |
The important caveat of bookmark files is that when you add a new
|
|
Packit |
ae235b |
bookmark you must also add the application that is registering it, using
|
|
Packit |
ae235b |
g_bookmark_file_add_application() or g_bookmark_file_set_app_info().
|
|
Packit |
ae235b |
If a bookmark has no applications then it won't be dumped when creating
|
|
Packit |
ae235b |
the on disk representation, using g_bookmark_file_to_data() or
|
|
Packit |
ae235b |
g_bookmark_file_to_file().
|
|
Packit |
ae235b |
The GBookmarkFile parser was added in GLib 2.12.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Functions
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_new ()
|
|
Packit |
ae235b |
GBookmarkFile *
|
|
Packit |
ae235b |
g_bookmark_file_new (void);
|
|
Packit |
ae235b |
Creates a new empty GBookmarkFile object.
|
|
Packit |
ae235b |
Use g_bookmark_file_load_from_file(), g_bookmark_file_load_from_data()
|
|
Packit |
ae235b |
or g_bookmark_file_load_from_data_dirs() to read an existing bookmark
|
|
Packit |
ae235b |
file.
|
|
Packit |
ae235b |
[constructor]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
an empty GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_free ()
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
g_bookmark_file_free (GBookmarkFile *bookmark);
|
|
Packit |
ae235b |
Frees a GBookmarkFile.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_load_from_file ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_bookmark_file_load_from_file (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *filename,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Loads a desktop bookmark file into an empty GBookmarkFile structure.
|
|
Packit |
ae235b |
If the file could not be loaded then error
|
|
Packit |
ae235b |
is set to either a GFileError
|
|
Packit |
ae235b |
or GBookmarkFileError.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
an empty GBookmarkFile struct
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
filename
|
|
Packit |
ae235b |
the path of a filename to load, in the
|
|
Packit |
ae235b |
GLib file name encoding.
|
|
Packit |
ae235b |
[type filename]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for a GError, or NULL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE if a desktop bookmark file could be loaded
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_load_from_data ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_bookmark_file_load_from_data (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *data,
|
|
Packit |
ae235b |
gsize length,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Loads a bookmark file from memory into an empty GBookmarkFile
|
|
Packit |
ae235b |
structure. If the object cannot be created then error
|
|
Packit |
ae235b |
is set to a
|
|
Packit |
ae235b |
GBookmarkFileError.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
an empty GBookmarkFile struct
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
data
|
|
Packit |
ae235b |
desktop bookmarks
|
|
Packit |
ae235b |
loaded in memory.
|
|
Packit |
ae235b |
[array length=length][element-type guint8]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
length
|
|
Packit |
ae235b |
the length of data
|
|
Packit |
ae235b |
in bytes
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for a GError, or NULL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE if a desktop bookmark could be loaded.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_load_from_data_dirs ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_bookmark_file_load_from_data_dirs (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *file,
|
|
Packit |
ae235b |
gchar **full_path,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
This function looks for a desktop bookmark file named file
|
|
Packit |
ae235b |
in the
|
|
Packit |
ae235b |
paths returned from g_get_user_data_dir() and g_get_system_data_dirs(),
|
|
Packit |
ae235b |
loads the file into bookmark
|
|
Packit |
ae235b |
and returns the file's full path in
|
|
Packit |
ae235b |
full_path
|
|
Packit |
ae235b |
. If the file could not be loaded then an error is
|
|
Packit |
ae235b |
set to either a GFileError or GBookmarkFileError.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
file
|
|
Packit |
ae235b |
a relative path to a filename to open and parse.
|
|
Packit |
ae235b |
[type filename]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
full_path
|
|
Packit |
ae235b |
return location for a string
|
|
Packit |
ae235b |
containing the full path of the file, or NULL.
|
|
Packit |
ae235b |
[out][optional][type filename]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for a GError, or NULL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE if a key file could be loaded, FALSE otherwise
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_to_data ()
|
|
Packit |
ae235b |
gchar *
|
|
Packit |
ae235b |
g_bookmark_file_to_data (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
gsize *length,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
This function outputs bookmark
|
|
Packit |
ae235b |
as a string.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
length
|
|
Packit |
ae235b |
return location for the length of the returned string, or NULL.
|
|
Packit |
ae235b |
[out][optional]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for a GError, or NULL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
a newly allocated string holding the contents of the GBookmarkFile.
|
|
Packit |
ae235b |
[array length=length][element-type guint8]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_to_file ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_bookmark_file_to_file (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *filename,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
This function outputs bookmark
|
|
Packit |
ae235b |
into a file. The write process is
|
|
Packit |
ae235b |
guaranteed to be atomic by using g_file_set_contents() internally.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
filename
|
|
Packit |
ae235b |
path of the output file.
|
|
Packit |
ae235b |
[type filename]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for a GError, or NULL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE if the file was successfully written.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_has_item ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_bookmark_file_has_item (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri);
|
|
Packit |
ae235b |
Looks whether the desktop bookmark has an item with its URI set to uri
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE if uri
|
|
Packit |
ae235b |
is inside bookmark
|
|
Packit |
ae235b |
, FALSE otherwise
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_has_group ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_bookmark_file_has_group (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
const gchar *group,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Checks whether group
|
|
Packit |
ae235b |
appears in the list of groups to which
|
|
Packit |
ae235b |
the bookmark for uri
|
|
Packit |
ae235b |
belongs to.
|
|
Packit |
ae235b |
In the event the URI cannot be found, FALSE is returned and
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
group
|
|
Packit |
ae235b |
the group name to be searched
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for a GError, or NULL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE if group
|
|
Packit |
ae235b |
was found.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_has_application ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_bookmark_file_has_application (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
const gchar *name,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Checks whether the bookmark for uri
|
|
Packit |
ae235b |
inside bookmark
|
|
Packit |
ae235b |
has been
|
|
Packit |
ae235b |
registered by application name
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
In the event the URI cannot be found, FALSE is returned and
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
name
|
|
Packit |
ae235b |
the name of the application
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for a GError or NULL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE if the application name
|
|
Packit |
ae235b |
was found
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_size ()
|
|
Packit |
ae235b |
gint
|
|
Packit |
ae235b |
g_bookmark_file_get_size (GBookmarkFile *bookmark);
|
|
Packit |
ae235b |
Gets the number of bookmarks inside bookmark
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
the number of bookmarks
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_uris ()
|
|
Packit |
ae235b |
gchar **
|
|
Packit |
ae235b |
g_bookmark_file_get_uris (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
gsize *length);
|
|
Packit |
ae235b |
Returns all URIs of the bookmarks in the bookmark file bookmark
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
The array of returned URIs will be NULL-terminated, so length
|
|
Packit |
ae235b |
may
|
|
Packit |
ae235b |
optionally be NULL.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
length
|
|
Packit |
ae235b |
return location for the number of returned URIs, or NULL.
|
|
Packit |
ae235b |
[out][optional]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
a newly allocated NULL-terminated array of strings.
|
|
Packit |
ae235b |
Use g_strfreev() to free it.
|
|
Packit |
ae235b |
[array length=length][transfer full]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_title ()
|
|
Packit |
ae235b |
gchar *
|
|
Packit |
ae235b |
g_bookmark_file_get_title (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Returns the title of the bookmark for uri
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
If uri
|
|
Packit |
ae235b |
is NULL, the title of bookmark
|
|
Packit |
ae235b |
is returned.
|
|
Packit |
ae235b |
In the event the URI cannot be found, NULL is returned and
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI or NULL.
|
|
Packit |
ae235b |
[nullable]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for a GError, or NULL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
a newly allocated string or NULL if the specified
|
|
Packit |
ae235b |
URI cannot be found.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_description ()
|
|
Packit |
ae235b |
gchar *
|
|
Packit |
ae235b |
g_bookmark_file_get_description (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Retrieves the description of the bookmark for uri
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
In the event the URI cannot be found, NULL is returned and
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for a GError, or NULL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
a newly allocated string or NULL if the specified
|
|
Packit |
ae235b |
URI cannot be found.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_mime_type ()
|
|
Packit |
ae235b |
gchar *
|
|
Packit |
ae235b |
g_bookmark_file_get_mime_type (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Retrieves the MIME type of the resource pointed by uri
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
In the event the URI cannot be found, NULL is returned and
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the
|
|
Packit |
ae235b |
event that the MIME type cannot be found, NULL is returned and
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
is set to G_BOOKMARK_FILE_ERROR_INVALID_VALUE.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for a GError, or NULL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
a newly allocated string or NULL if the specified
|
|
Packit |
ae235b |
URI cannot be found.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_is_private ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_bookmark_file_get_is_private (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Gets whether the private flag of the bookmark for uri
|
|
Packit |
ae235b |
is set.
|
|
Packit |
ae235b |
In the event the URI cannot be found, FALSE is returned and
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the
|
|
Packit |
ae235b |
event that the private flag cannot be found, FALSE is returned and
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
is set to G_BOOKMARK_FILE_ERROR_INVALID_VALUE.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for a GError, or NULL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE if the private flag is set, FALSE otherwise.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_icon ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_bookmark_file_get_icon (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
gchar **href,
|
|
Packit |
ae235b |
gchar **mime_type,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Gets the icon of the bookmark for uri
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
In the event the URI cannot be found, FALSE is returned and
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
href
|
|
Packit |
ae235b |
return location for the icon's location or NULL.
|
|
Packit |
ae235b |
[out][optional]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
mime_type
|
|
Packit |
ae235b |
return location for the icon's MIME type or NULL.
|
|
Packit |
ae235b |
[out][optional]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for a GError or NULL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE if the icon for the bookmark for the URI was found.
|
|
Packit |
ae235b |
You should free the returned strings.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_added ()
|
|
Packit |
ae235b |
time_t
|
|
Packit |
ae235b |
g_bookmark_file_get_added (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Gets the time the bookmark for uri
|
|
Packit |
ae235b |
was added to bookmark
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
In the event the URI cannot be found, -1 is returned and
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for a GError, or NULL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
a timestamp
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_modified ()
|
|
Packit |
ae235b |
time_t
|
|
Packit |
ae235b |
g_bookmark_file_get_modified (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Gets the time when the bookmark for uri
|
|
Packit |
ae235b |
was last modified.
|
|
Packit |
ae235b |
In the event the URI cannot be found, -1 is returned and
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for a GError, or NULL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
a timestamp
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_visited ()
|
|
Packit |
ae235b |
time_t
|
|
Packit |
ae235b |
g_bookmark_file_get_visited (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Gets the time the bookmark for uri
|
|
Packit |
ae235b |
was last visited.
|
|
Packit |
ae235b |
In the event the URI cannot be found, -1 is returned and
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for a GError, or NULL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
a timestamp.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_groups ()
|
|
Packit |
ae235b |
gchar **
|
|
Packit |
ae235b |
g_bookmark_file_get_groups (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
gsize *length,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Retrieves the list of group names of the bookmark for uri
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
In the event the URI cannot be found, NULL is returned and
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
|
|
Packit |
ae235b |
The returned array is NULL terminated, so length
|
|
Packit |
ae235b |
may optionally
|
|
Packit |
ae235b |
be NULL.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
length
|
|
Packit |
ae235b |
return location for the length of the returned string, or NULL.
|
|
Packit |
ae235b |
[out][optional]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for a GError, or NULL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
a newly allocated NULL-terminated array of group names.
|
|
Packit |
ae235b |
Use g_strfreev() to free it.
|
|
Packit |
ae235b |
[array length=length][transfer full]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_applications ()
|
|
Packit |
ae235b |
gchar **
|
|
Packit |
ae235b |
g_bookmark_file_get_applications (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
gsize *length,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Retrieves the names of the applications that have registered the
|
|
Packit |
ae235b |
bookmark for uri
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
In the event the URI cannot be found, NULL is returned and
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
length
|
|
Packit |
ae235b |
return location of the length of the returned list, or NULL.
|
|
Packit |
ae235b |
[out][optional]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for a GError, or NULL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
a newly allocated NULL-terminated array of strings.
|
|
Packit |
ae235b |
Use g_strfreev() to free it.
|
|
Packit |
ae235b |
[array length=length][transfer full]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_get_app_info ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_bookmark_file_get_app_info (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
const gchar *name,
|
|
Packit |
ae235b |
gchar **exec,
|
|
Packit |
ae235b |
guint *count,
|
|
Packit |
ae235b |
time_t *stamp,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Gets the registration informations of app_name
|
|
Packit |
ae235b |
for the bookmark for
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
. See g_bookmark_file_set_app_info() for more informations about
|
|
Packit |
ae235b |
the returned data.
|
|
Packit |
ae235b |
The string returned in app_exec
|
|
Packit |
ae235b |
must be freed.
|
|
Packit |
ae235b |
In the event the URI cannot be found, FALSE is returned and
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the
|
|
Packit |
ae235b |
event that no application with name app_name
|
|
Packit |
ae235b |
has registered a bookmark
|
|
Packit |
ae235b |
for uri
|
|
Packit |
ae235b |
, FALSE is returned and error is set to
|
|
Packit |
ae235b |
G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. In the event that unquoting
|
|
Packit |
ae235b |
the command line fails, an error of the G_SHELL_ERROR domain is
|
|
Packit |
ae235b |
set and FALSE is returned.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
name
|
|
Packit |
ae235b |
an application's name
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
exec
|
|
Packit |
ae235b |
return location for the command line of the application, or NULL.
|
|
Packit |
ae235b |
[out][optional]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
count
|
|
Packit |
ae235b |
return location for the registration count, or NULL.
|
|
Packit |
ae235b |
[out][optional]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
stamp
|
|
Packit |
ae235b |
return location for the last registration time, or NULL.
|
|
Packit |
ae235b |
[out][optional]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for a GError, or NULL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE on success.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_set_title ()
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
g_bookmark_file_set_title (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
const gchar *title);
|
|
Packit |
ae235b |
Sets title
|
|
Packit |
ae235b |
as the title of the bookmark for uri
|
|
Packit |
ae235b |
inside the
|
|
Packit |
ae235b |
bookmark file bookmark
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
If uri
|
|
Packit |
ae235b |
is NULL, the title of bookmark
|
|
Packit |
ae235b |
is set.
|
|
Packit |
ae235b |
If a bookmark for uri
|
|
Packit |
ae235b |
cannot be found then it is created.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI or NULL.
|
|
Packit |
ae235b |
[nullable]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
title
|
|
Packit |
ae235b |
a UTF-8 encoded string
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_set_description ()
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
g_bookmark_file_set_description (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
const gchar *description);
|
|
Packit |
ae235b |
Sets description
|
|
Packit |
ae235b |
as the description of the bookmark for uri
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
If uri
|
|
Packit |
ae235b |
is NULL, the description of bookmark
|
|
Packit |
ae235b |
is set.
|
|
Packit |
ae235b |
If a bookmark for uri
|
|
Packit |
ae235b |
cannot be found then it is created.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI or NULL.
|
|
Packit |
ae235b |
[nullable]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
description
|
|
Packit |
ae235b |
a string
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_set_mime_type ()
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
g_bookmark_file_set_mime_type (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
const gchar *mime_type);
|
|
Packit |
ae235b |
Sets mime_type
|
|
Packit |
ae235b |
as the MIME type of the bookmark for uri
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
If a bookmark for uri
|
|
Packit |
ae235b |
cannot be found then it is created.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
mime_type
|
|
Packit |
ae235b |
a MIME type
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_set_is_private ()
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
g_bookmark_file_set_is_private (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
gboolean is_private);
|
|
Packit |
ae235b |
Sets the private flag of the bookmark for uri
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
If a bookmark for uri
|
|
Packit |
ae235b |
cannot be found then it is created.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
is_private
|
|
Packit |
ae235b |
TRUE if the bookmark should be marked as private
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_set_icon ()
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
g_bookmark_file_set_icon (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
const gchar *href,
|
|
Packit |
ae235b |
const gchar *mime_type);
|
|
Packit |
ae235b |
Sets the icon for the bookmark for uri
|
|
Packit |
ae235b |
. If href
|
|
Packit |
ae235b |
is NULL, unsets
|
|
Packit |
ae235b |
the currently set icon. href
|
|
Packit |
ae235b |
can either be a full URL for the icon
|
|
Packit |
ae235b |
file or the icon name following the Icon Naming specification.
|
|
Packit |
ae235b |
If no bookmark for uri
|
|
Packit |
ae235b |
is found one is created.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
href
|
|
Packit |
ae235b |
the URI of the icon for the bookmark, or NULL.
|
|
Packit |
ae235b |
[nullable]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
mime_type
|
|
Packit |
ae235b |
the MIME type of the icon for the bookmark
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_set_added ()
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
g_bookmark_file_set_added (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
time_t added);
|
|
Packit |
ae235b |
Sets the time the bookmark for uri
|
|
Packit |
ae235b |
was added into bookmark
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
If no bookmark for uri
|
|
Packit |
ae235b |
is found then it is created.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
added
|
|
Packit |
ae235b |
a timestamp or -1 to use the current time
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_set_groups ()
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
g_bookmark_file_set_groups (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
const gchar **groups,
|
|
Packit |
ae235b |
gsize length);
|
|
Packit |
ae235b |
Sets a list of group names for the item with URI uri
|
|
Packit |
ae235b |
. Each previously
|
|
Packit |
ae235b |
set group name list is removed.
|
|
Packit |
ae235b |
If uri
|
|
Packit |
ae235b |
cannot be found then an item for it is created.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
an item's URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
groups
|
|
Packit |
ae235b |
an array of
|
|
Packit |
ae235b |
group names, or NULL to remove all groups.
|
|
Packit |
ae235b |
[nullable][array length=length][element-type utf8]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
length
|
|
Packit |
ae235b |
number of group name values in groups
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_set_modified ()
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
g_bookmark_file_set_modified (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
time_t modified);
|
|
Packit |
ae235b |
Sets the last time the bookmark for uri
|
|
Packit |
ae235b |
was last modified.
|
|
Packit |
ae235b |
If no bookmark for uri
|
|
Packit |
ae235b |
is found then it is created.
|
|
Packit |
ae235b |
The "modified" time should only be set when the bookmark's meta-data
|
|
Packit |
ae235b |
was actually changed. Every function of GBookmarkFile that
|
|
Packit |
ae235b |
modifies a bookmark also changes the modification time, except for
|
|
Packit |
ae235b |
g_bookmark_file_set_visited().
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
modified
|
|
Packit |
ae235b |
a timestamp or -1 to use the current time
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_set_visited ()
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
g_bookmark_file_set_visited (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
time_t visited);
|
|
Packit |
ae235b |
Sets the time the bookmark for uri
|
|
Packit |
ae235b |
was last visited.
|
|
Packit |
ae235b |
If no bookmark for uri
|
|
Packit |
ae235b |
is found then it is created.
|
|
Packit |
ae235b |
The "visited" time should only be set if the bookmark was launched,
|
|
Packit |
ae235b |
either using the command line retrieved by g_bookmark_file_get_app_info()
|
|
Packit |
ae235b |
or by the default application for the bookmark's MIME type, retrieved
|
|
Packit |
ae235b |
using g_bookmark_file_get_mime_type(). Changing the "visited" time
|
|
Packit |
ae235b |
does not affect the "modified" time.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
visited
|
|
Packit |
ae235b |
a timestamp or -1 to use the current time
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_set_app_info ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_bookmark_file_set_app_info (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
const gchar *name,
|
|
Packit |
ae235b |
const gchar *exec,
|
|
Packit |
ae235b |
gint count,
|
|
Packit |
ae235b |
time_t stamp,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Sets the meta-data of application name
|
|
Packit |
ae235b |
inside the list of
|
|
Packit |
ae235b |
applications that have registered a bookmark for uri
|
|
Packit |
ae235b |
inside
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
You should rarely use this function; use g_bookmark_file_add_application()
|
|
Packit |
ae235b |
and g_bookmark_file_remove_application() instead.
|
|
Packit |
ae235b |
name
|
|
Packit |
ae235b |
can be any UTF-8 encoded string used to identify an
|
|
Packit |
ae235b |
application.
|
|
Packit |
ae235b |
exec
|
|
Packit |
ae235b |
can have one of these two modifiers: "%f", which will
|
|
Packit |
ae235b |
be expanded as the local file name retrieved from the bookmark's
|
|
Packit |
ae235b |
URI; "%u", which will be expanded as the bookmark's URI.
|
|
Packit |
ae235b |
The expansion is done automatically when retrieving the stored
|
|
Packit |
ae235b |
command line using the g_bookmark_file_get_app_info() function.
|
|
Packit |
ae235b |
count
|
|
Packit |
ae235b |
is the number of times the application has registered the
|
|
Packit |
ae235b |
bookmark; if is < 0, the current registration count will be increased
|
|
Packit |
ae235b |
by one, if is 0, the application with name
|
|
Packit |
ae235b |
will be removed from
|
|
Packit |
ae235b |
the list of registered applications.
|
|
Packit |
ae235b |
stamp
|
|
Packit |
ae235b |
is the Unix time of the last registration; if it is -1, the
|
|
Packit |
ae235b |
current time will be used.
|
|
Packit |
ae235b |
If you try to remove an application by setting its registration count to
|
|
Packit |
ae235b |
zero, and no bookmark for uri
|
|
Packit |
ae235b |
is found, FALSE is returned and
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND; similarly,
|
|
Packit |
ae235b |
in the event that no application name
|
|
Packit |
ae235b |
has registered a bookmark
|
|
Packit |
ae235b |
for uri
|
|
Packit |
ae235b |
, FALSE is returned and error is set to
|
|
Packit |
ae235b |
G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. Otherwise, if no bookmark
|
|
Packit |
ae235b |
for uri
|
|
Packit |
ae235b |
is found, one is created.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
name
|
|
Packit |
ae235b |
an application's name
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
exec
|
|
Packit |
ae235b |
an application's command line
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
count
|
|
Packit |
ae235b |
the number of registrations done for this application
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
stamp
|
|
Packit |
ae235b |
the time of the last registration for this application
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for a GError or NULL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE if the application's meta-data was successfully
|
|
Packit |
ae235b |
changed.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_add_group ()
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
g_bookmark_file_add_group (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
const gchar *group);
|
|
Packit |
ae235b |
Adds group
|
|
Packit |
ae235b |
to the list of groups to which the bookmark for uri
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
belongs to.
|
|
Packit |
ae235b |
If no bookmark for uri
|
|
Packit |
ae235b |
is found then it is created.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
group
|
|
Packit |
ae235b |
the group name to be added
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_add_application ()
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
g_bookmark_file_add_application (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
const gchar *name,
|
|
Packit |
ae235b |
const gchar *exec);
|
|
Packit |
ae235b |
Adds the application with name
|
|
Packit |
ae235b |
and exec
|
|
Packit |
ae235b |
to the list of
|
|
Packit |
ae235b |
applications that have registered a bookmark for uri
|
|
Packit |
ae235b |
into
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
Every bookmark inside a GBookmarkFile must have at least an
|
|
Packit |
ae235b |
application registered. Each application must provide a name, a
|
|
Packit |
ae235b |
command line useful for launching the bookmark, the number of times
|
|
Packit |
ae235b |
the bookmark has been registered by the application and the last
|
|
Packit |
ae235b |
time the application registered this bookmark.
|
|
Packit |
ae235b |
If name
|
|
Packit |
ae235b |
is NULL, the name of the application will be the
|
|
Packit |
ae235b |
same returned by g_get_application_name(); if exec
|
|
Packit |
ae235b |
is NULL, the
|
|
Packit |
ae235b |
command line will be a composition of the program name as
|
|
Packit |
ae235b |
returned by g_get_prgname() and the "%u" modifier, which will be
|
|
Packit |
ae235b |
expanded to the bookmark's URI.
|
|
Packit |
ae235b |
This function will automatically take care of updating the
|
|
Packit |
ae235b |
registrations count and timestamping in case an application
|
|
Packit |
ae235b |
with the same name
|
|
Packit |
ae235b |
had already registered a bookmark for
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
inside bookmark
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
If no bookmark for uri
|
|
Packit |
ae235b |
is found, one is created.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
name
|
|
Packit |
ae235b |
the name of the application registering the bookmark
|
|
Packit |
ae235b |
or NULL.
|
|
Packit |
ae235b |
[nullable]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
exec
|
|
Packit |
ae235b |
command line to be used to launch the bookmark or NULL.
|
|
Packit |
ae235b |
[nullable]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_remove_group ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_bookmark_file_remove_group (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
const gchar *group,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Removes group
|
|
Packit |
ae235b |
from the list of groups to which the bookmark
|
|
Packit |
ae235b |
for uri
|
|
Packit |
ae235b |
belongs to.
|
|
Packit |
ae235b |
In the event the URI cannot be found, FALSE is returned and
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
|
|
Packit |
ae235b |
In the event no group was defined, FALSE is returned and
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
is set to G_BOOKMARK_FILE_ERROR_INVALID_VALUE.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
group
|
|
Packit |
ae235b |
the group name to be removed
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for a GError, or NULL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE if group
|
|
Packit |
ae235b |
was successfully removed.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_remove_application ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_bookmark_file_remove_application (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
const gchar *name,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Removes application registered with name
|
|
Packit |
ae235b |
from the list of applications
|
|
Packit |
ae235b |
that have registered a bookmark for uri
|
|
Packit |
ae235b |
inside bookmark
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
In the event the URI cannot be found, FALSE is returned and
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
|
|
Packit |
ae235b |
In the event that no application with name app_name
|
|
Packit |
ae235b |
has registered
|
|
Packit |
ae235b |
a bookmark for uri
|
|
Packit |
ae235b |
, FALSE is returned and error is set to
|
|
Packit |
ae235b |
G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
name
|
|
Packit |
ae235b |
the name of the application
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for a GError or NULL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE if the application was successfully removed.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_remove_item ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_bookmark_file_remove_item (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *uri,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Removes the bookmark for uri
|
|
Packit |
ae235b |
from the bookmark file bookmark
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for a GError, or NULL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE if the bookmark was removed successfully.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_bookmark_file_move_item ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_bookmark_file_move_item (GBookmarkFile *bookmark,
|
|
Packit |
ae235b |
const gchar *old_uri,
|
|
Packit |
ae235b |
const gchar *new_uri,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Changes the URI of a bookmark item from old_uri
|
|
Packit |
ae235b |
to new_uri
|
|
Packit |
ae235b |
. Any
|
|
Packit |
ae235b |
existing bookmark for new_uri
|
|
Packit |
ae235b |
will be overwritten. If new_uri
|
|
Packit |
ae235b |
is
|
|
Packit |
ae235b |
NULL, then the bookmark is removed.
|
|
Packit |
ae235b |
In the event the URI cannot be found, FALSE is returned and
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
is set to G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
bookmark
|
|
Packit |
ae235b |
a GBookmarkFile
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
old_uri
|
|
Packit |
ae235b |
a valid URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
new_uri
|
|
Packit |
ae235b |
a valid URI, or NULL.
|
|
Packit |
ae235b |
[nullable]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for a GError or NULL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE if the URI was successfully changed
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.12
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Types and Values
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GBookmarkFile
|
|
Packit |
ae235b |
typedef struct _GBookmarkFile GBookmarkFile;
|
|
Packit |
ae235b |
The GBookmarkFile structure contains only
|
|
Packit |
ae235b |
private data and should not be directly accessed.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
G_BOOKMARK_FILE_ERROR
|
|
Packit |
ae235b |
#define G_BOOKMARK_FILE_ERROR (g_bookmark_file_error_quark ())
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Error domain for bookmark file parsing.
|
|
Packit |
ae235b |
Errors in this domain will be from the GBookmarkFileError
|
|
Packit |
ae235b |
enumeration. See GError for information on error domains.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
enum GBookmarkFileError
|
|
Packit |
ae235b |
Error codes returned by bookmark file parsing.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Members
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
G_BOOKMARK_FILE_ERROR_INVALID_URI
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
URI was ill-formed
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
G_BOOKMARK_FILE_ERROR_INVALID_VALUE
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
a requested field was not found
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
a requested application did
|
|
Packit |
ae235b |
not register a bookmark
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
a requested URI was not found
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
G_BOOKMARK_FILE_ERROR_READ
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
document was ill formed
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
G_BOOKMARK_FILE_ERROR_UNKNOWN_ENCODING
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
the text being parsed was
|
|
Packit |
ae235b |
in an unknown encoding
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
G_BOOKMARK_FILE_ERROR_WRITE
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
an error occurred while writing
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
G_BOOKMARK_FILE_ERROR_FILE_NOT_FOUND
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
requested file was not found
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Generated by GTK-Doc V1.27
|
|
Packit |
ae235b |
</body>
|
|
Packit |
ae235b |
</html>
|