Package ch.bailu.gtk.glib

Klasse BookmarkFile

java.lang.Object
ch.bailu.gtk.type.Type
ch.bailu.gtk.type.Pointer
ch.bailu.gtk.type.Record
ch.bailu.gtk.glib.BookmarkFile
Alle implementierten Schnittstellen:
PointerInterface
public class BookmarkFile extends Record
`GBookmarkFile` lets you parse, edit or create files containing bookmarks.

Bookmarks refer to a URI, along with some meta-data about the resource
pointed by the URI like its MIME type, the application that is registering
the bookmark and the icon that should be used to represent the bookmark.
The data is stored using the
[Desktop Bookmark Specification](https://www.freedesktop.org/wiki/Specifications/desktop-bookmark-spec/).

The syntax of the bookmark files is described in detail inside the
Desktop Bookmark Specification, here is a quick summary: bookmark
files use a sub-class of the XML Bookmark Exchange Language
specification, consisting of valid UTF-8 encoded XML, under the
`<xbel>` root element; each bookmark is stored inside a
`<bookmark>` element, using its URI: no relative paths can
be used inside a bookmark file. The bookmark may have a user defined
title and description, to be used instead of the URI. Under the
`<metadata>` element, with its owner attribute set to
`http://freedesktop.org`, is stored the meta-data about a resource
pointed by its URI. The meta-data consists of the resource's MIME
type; the applications that have registered a bookmark; the groups
to which a bookmark belongs to; a visibility flag, used to set the
bookmark as "private" to the applications and groups that has it
registered; the URI and MIME type of an icon, to be used when
displaying the bookmark inside a GUI.

Here is an example of a bookmark file:
[bookmarks.xbel](https://gitlab.gnome.org/GNOME/glib/-/blob/HEAD/glib/tests/bookmarks.xbel)

A bookmark file might contain more than one bookmark; each bookmark
is accessed through its URI.

The important caveat of bookmark files is that when you add a new
bookmark you must also add the application that is registering it, using
[method@GLib.BookmarkFile.add_application] or [method@GLib.BookmarkFile.set_application_info].
If a bookmark has no applications then it won't be dumped when creating
the on disk representation, using [method@GLib.BookmarkFile.to_data] or
[method@GLib.BookmarkFile.to_file].

https://docs.gtk.org/glib/struct.BookmarkFile.html

  • Konstruktordetails

    • BookmarkFile

      public BookmarkFile(PointerContainer pointer)

    • BookmarkFile

      public BookmarkFile()
      Creates a new empty #GBookmarkFile object.

      Use g_bookmark_file_load_from_file(), g_bookmark_file_load_from_data()
      or g_bookmark_file_load_from_data_dirs() to read an existing bookmark
      file.

  • Methodendetails

    • getClassHandler

      public static ClassHandler getClassHandler()

    • addApplication

      public void addApplication(@Nonnull Str uri, @Nullable Str name, @Nullable Str exec)
      Adds the application with @name and @exec to the list of
      applications that have registered a bookmark for @uri into
      @bookmark.

      Every bookmark inside a #GBookmarkFile must have at least an
      application registered. Each application must provide a name, a
      command line useful for launching the bookmark, the number of times
      the bookmark has been registered by the application and the last
      time the application registered this bookmark.

      If @name is %NULL, the name of the application will be the
      same returned by g_get_application_name(); if @exec is %NULL, the
      command line will be a composition of the program name as
      returned by g_get_prgname() and the "\%u" modifier, which will be
      expanded to the bookmark's URI.

      This function will automatically take care of updating the
      registrations count and timestamping in case an application
      with the same @name had already registered a bookmark for
      @uri inside @bookmark.

      If no bookmark for @uri is found, one is created.
      Parameter:
      uri - a valid URI
      name - the name of the application registering the bookmark or %NULL
      exec - command line to be used to launch the bookmark or %NULL

    • addApplication

      public void addApplication(String uri, String name, String exec)
      Adds the application with @name and @exec to the list of
      applications that have registered a bookmark for @uri into
      @bookmark.

      Every bookmark inside a #GBookmarkFile must have at least an
      application registered. Each application must provide a name, a
      command line useful for launching the bookmark, the number of times
      the bookmark has been registered by the application and the last
      time the application registered this bookmark.

      If @name is %NULL, the name of the application will be the
      same returned by g_get_application_name(); if @exec is %NULL, the
      command line will be a composition of the program name as
      returned by g_get_prgname() and the "\%u" modifier, which will be
      expanded to the bookmark's URI.

      This function will automatically take care of updating the
      registrations count and timestamping in case an application
      with the same @name had already registered a bookmark for
      @uri inside @bookmark.

      If no bookmark for @uri is found, one is created.
      Parameter:
      uri - a valid URI
      name - the name of the application registering the bookmark or %NULL
      exec - command line to be used to launch the bookmark or %NULL

    • addGroup

      public void addGroup(@Nonnull Str uri, @Nonnull Str group)
      Adds @group to the list of groups to which the bookmark for @uri
      belongs to.

      If no bookmark for @uri is found then it is created.
      Parameter:
      uri - a valid URI
      group - the group name to be added

    • addGroup

      public void addGroup(String uri, String group)
      Adds @group to the list of groups to which the bookmark for @uri
      belongs to.

      If no bookmark for @uri is found then it is created.
      Parameter:
      uri - a valid URI
      group - the group name to be added

    • copy

      public BookmarkFile copy()
      Deeply copies a @bookmark #GBookmarkFile object to a new one.
      Gibt zurück:
      the copy of @bookmark. Use g_bookmark_free() when finished using it.

    • free

      public void free()
      Frees a #GBookmarkFile.

    • getAdded

      @Deprecated public long getAdded(@Nonnull Str uri) throws AllocationError
      Veraltet.
      Gets the time the bookmark for @uri was added to @bookmark

      In the event the URI cannot be found, -1 is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      Parameter:
      uri - a valid URI
      Gibt zurück:
      a timestamp
      Löst aus:
      AllocationError

    • getAdded

      @Deprecated public long getAdded(String uri) throws AllocationError
      Veraltet.
      Gets the time the bookmark for @uri was added to @bookmark

      In the event the URI cannot be found, -1 is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      Parameter:
      uri - a valid URI
      Gibt zurück:
      a timestamp
      Löst aus:
      AllocationError

    • getAddedDateTime

      public DateTime getAddedDateTime(@Nonnull Str uri) throws AllocationError
      Gets the time the bookmark for @uri was added to @bookmark

      In the event the URI cannot be found, %NULL is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      Parameter:
      uri - a valid URI
      Gibt zurück:
      a #GDateTime
      Löst aus:
      AllocationError

    • getAddedDateTime

      public DateTime getAddedDateTime(String uri) throws AllocationError
      Gets the time the bookmark for @uri was added to @bookmark

      In the event the URI cannot be found, %NULL is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      Parameter:
      uri - a valid URI
      Gibt zurück:
      a #GDateTime
      Löst aus:
      AllocationError

    • getDescription

      public Str getDescription(@Nonnull Str uri) throws AllocationError
      Retrieves the description of the bookmark for @uri.

      In the event the URI cannot be found, %NULL is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      Parameter:
      uri - a valid URI
      Gibt zurück:
      a newly allocated string or %NULL if the specified URI cannot be found.
      Löst aus:
      AllocationError

    • getDescription

      public Str getDescription(String uri) throws AllocationError
      Retrieves the description of the bookmark for @uri.

      In the event the URI cannot be found, %NULL is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      Parameter:
      uri - a valid URI
      Gibt zurück:
      a newly allocated string or %NULL if the specified URI cannot be found.
      Löst aus:
      AllocationError

    • getIsPrivate

      public boolean getIsPrivate(@Nonnull Str uri) throws AllocationError
      Gets whether the private flag of the bookmark for @uri is set.

      In the event the URI cannot be found, %FALSE is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the
      event that the private flag cannot be found, %FALSE is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_INVALID_VALUE.
      Parameter:
      uri - a valid URI
      Gibt zurück:
      %TRUE if the private flag is set, %FALSE otherwise.
      Löst aus:
      AllocationError

    • getIsPrivate

      public boolean getIsPrivate(String uri) throws AllocationError
      Gets whether the private flag of the bookmark for @uri is set.

      In the event the URI cannot be found, %FALSE is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the
      event that the private flag cannot be found, %FALSE is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_INVALID_VALUE.
      Parameter:
      uri - a valid URI
      Gibt zurück:
      %TRUE if the private flag is set, %FALSE otherwise.
      Löst aus:
      AllocationError

    • getMimeType

      public Str getMimeType(@Nonnull Str uri) throws AllocationError
      Retrieves the MIME type of the resource pointed by @uri.

      In the event the URI cannot be found, %NULL is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the
      event that the MIME type cannot be found, %NULL is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_INVALID_VALUE.
      Parameter:
      uri - a valid URI
      Gibt zurück:
      a newly allocated string or %NULL if the specified URI cannot be found.
      Löst aus:
      AllocationError

    • getMimeType

      public Str getMimeType(String uri) throws AllocationError
      Retrieves the MIME type of the resource pointed by @uri.

      In the event the URI cannot be found, %NULL is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the
      event that the MIME type cannot be found, %NULL is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_INVALID_VALUE.
      Parameter:
      uri - a valid URI
      Gibt zurück:
      a newly allocated string or %NULL if the specified URI cannot be found.
      Löst aus:
      AllocationError

    • getModified

      @Deprecated public long getModified(@Nonnull Str uri) throws AllocationError
      Veraltet.
      Gets the time when the bookmark for @uri was last modified.

      In the event the URI cannot be found, -1 is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      Parameter:
      uri - a valid URI
      Gibt zurück:
      a timestamp
      Löst aus:
      AllocationError

    • getModified

      @Deprecated public long getModified(String uri) throws AllocationError
      Veraltet.
      Gets the time when the bookmark for @uri was last modified.

      In the event the URI cannot be found, -1 is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      Parameter:
      uri - a valid URI
      Gibt zurück:
      a timestamp
      Löst aus:
      AllocationError

    • getModifiedDateTime

      public DateTime getModifiedDateTime(@Nonnull Str uri) throws AllocationError
      Gets the time when the bookmark for @uri was last modified.

      In the event the URI cannot be found, %NULL is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      Parameter:
      uri - a valid URI
      Gibt zurück:
      a #GDateTime
      Löst aus:
      AllocationError

    • getModifiedDateTime

      public DateTime getModifiedDateTime(String uri) throws AllocationError
      Gets the time when the bookmark for @uri was last modified.

      In the event the URI cannot be found, %NULL is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      Parameter:
      uri - a valid URI
      Gibt zurück:
      a #GDateTime
      Löst aus:
      AllocationError

    • getSize

      public int getSize()
      Gets the number of bookmarks inside @bookmark.
      Gibt zurück:
      the number of bookmarks

    • getTitle

      public Str getTitle(@Nullable Str uri) throws AllocationError
      Returns the title of the bookmark for @uri.

      If @uri is %NULL, the title of @bookmark is returned.

      In the event the URI cannot be found, %NULL is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      Parameter:
      uri - a valid URI or %NULL
      Gibt zurück:
      a newly allocated string or %NULL if the specified URI cannot be found.
      Löst aus:
      AllocationError

    • getTitle

      public Str getTitle(String uri) throws AllocationError
      Returns the title of the bookmark for @uri.

      If @uri is %NULL, the title of @bookmark is returned.

      In the event the URI cannot be found, %NULL is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      Parameter:
      uri - a valid URI or %NULL
      Gibt zurück:
      a newly allocated string or %NULL if the specified URI cannot be found.
      Löst aus:
      AllocationError

    • getVisited

      @Deprecated public long getVisited(@Nonnull Str uri) throws AllocationError
      Veraltet.
      Gets the time the bookmark for @uri was last visited.

      In the event the URI cannot be found, -1 is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      Parameter:
      uri - a valid URI
      Gibt zurück:
      a timestamp.
      Löst aus:
      AllocationError

    • getVisited

      @Deprecated public long getVisited(String uri) throws AllocationError
      Veraltet.
      Gets the time the bookmark for @uri was last visited.

      In the event the URI cannot be found, -1 is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      Parameter:
      uri - a valid URI
      Gibt zurück:
      a timestamp.
      Löst aus:
      AllocationError

    • getVisitedDateTime

      public DateTime getVisitedDateTime(@Nonnull Str uri) throws AllocationError
      Gets the time the bookmark for @uri was last visited.

      In the event the URI cannot be found, %NULL is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      Parameter:
      uri - a valid URI
      Gibt zurück:
      a #GDateTime
      Löst aus:
      AllocationError

    • getVisitedDateTime

      public DateTime getVisitedDateTime(String uri) throws AllocationError
      Gets the time the bookmark for @uri was last visited.

      In the event the URI cannot be found, %NULL is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      Parameter:
      uri - a valid URI
      Gibt zurück:
      a #GDateTime
      Löst aus:
      AllocationError

    • hasApplication

      public boolean hasApplication(@Nonnull Str uri, @Nonnull Str name) throws AllocationError
      Checks whether the bookmark for @uri inside @bookmark has been
      registered by application @name.

      In the event the URI cannot be found, %FALSE is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      Parameter:
      uri - a valid URI
      name - the name of the application
      Gibt zurück:
      %TRUE if the application @name was found
      Löst aus:
      AllocationError

    • hasApplication

      public boolean hasApplication(String uri, String name) throws AllocationError
      Checks whether the bookmark for @uri inside @bookmark has been
      registered by application @name.

      In the event the URI cannot be found, %FALSE is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      Parameter:
      uri - a valid URI
      name - the name of the application
      Gibt zurück:
      %TRUE if the application @name was found
      Löst aus:
      AllocationError

    • hasGroup

      public boolean hasGroup(@Nonnull Str uri, @Nonnull Str group) throws AllocationError
      Checks whether @group appears in the list of groups to which
      the bookmark for @uri belongs to.

      In the event the URI cannot be found, %FALSE is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      Parameter:
      uri - a valid URI
      group - the group name to be searched
      Gibt zurück:
      %TRUE if @group was found.
      Löst aus:
      AllocationError

    • hasGroup

      public boolean hasGroup(String uri, String group) throws AllocationError
      Checks whether @group appears in the list of groups to which
      the bookmark for @uri belongs to.

      In the event the URI cannot be found, %FALSE is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      Parameter:
      uri - a valid URI
      group - the group name to be searched
      Gibt zurück:
      %TRUE if @group was found.
      Löst aus:
      AllocationError

    • hasItem

      public boolean hasItem(@Nonnull Str uri)
      Looks whether the desktop bookmark has an item with its URI set to @uri.
      Parameter:
      uri - a valid URI
      Gibt zurück:
      %TRUE if @uri is inside @bookmark, %FALSE otherwise

    • hasItem

      public boolean hasItem(String uri)
      Looks whether the desktop bookmark has an item with its URI set to @uri.
      Parameter:
      uri - a valid URI
      Gibt zurück:
      %TRUE if @uri is inside @bookmark, %FALSE otherwise

    • loadFromData

      public boolean loadFromData(@Nonnull Str data, long length) throws AllocationError
      Loads a bookmark file from memory into an empty #GBookmarkFile
      structure. If the object cannot be created then @error is set to a
      #GBookmarkFileError.
      Parameter:
      data - desktop bookmarks loaded in memory
      length - the length of @data in bytes
      Gibt zurück:
      %TRUE if a desktop bookmark could be loaded.
      Löst aus:
      AllocationError

    • loadFromData

      public boolean loadFromData(String data, long length) throws AllocationError
      Loads a bookmark file from memory into an empty #GBookmarkFile
      structure. If the object cannot be created then @error is set to a
      #GBookmarkFileError.
      Parameter:
      data - desktop bookmarks loaded in memory
      length - the length of @data in bytes
      Gibt zurück:
      %TRUE if a desktop bookmark could be loaded.
      Löst aus:
      AllocationError

    • loadFromFile

      public boolean loadFromFile(@Nonnull Str filename) throws AllocationError
      Loads a desktop bookmark file into an empty #GBookmarkFile structure.
      If the file could not be loaded then @error is set to either a #GFileError
      or #GBookmarkFileError.
      Parameter:
      filename - the path of a filename to load, in the GLib file name encoding
      Gibt zurück:
      %TRUE if a desktop bookmark file could be loaded
      Löst aus:
      AllocationError

    • loadFromFile

      public boolean loadFromFile(String filename) throws AllocationError
      Loads a desktop bookmark file into an empty #GBookmarkFile structure.
      If the file could not be loaded then @error is set to either a #GFileError
      or #GBookmarkFileError.
      Parameter:
      filename - the path of a filename to load, in the GLib file name encoding
      Gibt zurück:
      %TRUE if a desktop bookmark file could be loaded
      Löst aus:
      AllocationError

    • moveItem

      public boolean moveItem(@Nonnull Str old_uri, @Nullable Str new_uri) throws AllocationError
      Changes the URI of a bookmark item from @old_uri to @new_uri. Any
      existing bookmark for @new_uri will be overwritten. If @new_uri is
      %NULL, then the bookmark is removed.

      In the event the URI cannot be found, %FALSE is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      Parameter:
      old_uri - a valid URI
      new_uri - a valid URI, or %NULL
      Gibt zurück:
      %TRUE if the URI was successfully changed
      Löst aus:
      AllocationError

    • moveItem

      public boolean moveItem(String old_uri, String new_uri) throws AllocationError
      Changes the URI of a bookmark item from @old_uri to @new_uri. Any
      existing bookmark for @new_uri will be overwritten. If @new_uri is
      %NULL, then the bookmark is removed.

      In the event the URI cannot be found, %FALSE is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      Parameter:
      old_uri - a valid URI
      new_uri - a valid URI, or %NULL
      Gibt zurück:
      %TRUE if the URI was successfully changed
      Löst aus:
      AllocationError

    • removeApplication

      public boolean removeApplication(@Nonnull Str uri, @Nonnull Str name) throws AllocationError
      Removes application registered with @name from the list of applications
      that have registered a bookmark for @uri inside @bookmark.

      In the event the URI cannot be found, %FALSE is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      In the event that no application with name @app_name has registered
      a bookmark for @uri, %FALSE is returned and error is set to
      %G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED.
      Parameter:
      uri - a valid URI
      name - the name of the application
      Gibt zurück:
      %TRUE if the application was successfully removed.
      Löst aus:
      AllocationError

    • removeApplication

      public boolean removeApplication(String uri, String name) throws AllocationError
      Removes application registered with @name from the list of applications
      that have registered a bookmark for @uri inside @bookmark.

      In the event the URI cannot be found, %FALSE is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      In the event that no application with name @app_name has registered
      a bookmark for @uri, %FALSE is returned and error is set to
      %G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED.
      Parameter:
      uri - a valid URI
      name - the name of the application
      Gibt zurück:
      %TRUE if the application was successfully removed.
      Löst aus:
      AllocationError

    • removeGroup

      public boolean removeGroup(@Nonnull Str uri, @Nonnull Str group) throws AllocationError
      Removes @group from the list of groups to which the bookmark
      for @uri belongs to.

      In the event the URI cannot be found, %FALSE is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      In the event no group was defined, %FALSE is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_INVALID_VALUE.
      Parameter:
      uri - a valid URI
      group - the group name to be removed
      Gibt zurück:
      %TRUE if @group was successfully removed.
      Löst aus:
      AllocationError

    • removeGroup

      public boolean removeGroup(String uri, String group) throws AllocationError
      Removes @group from the list of groups to which the bookmark
      for @uri belongs to.

      In the event the URI cannot be found, %FALSE is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
      In the event no group was defined, %FALSE is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_INVALID_VALUE.
      Parameter:
      uri - a valid URI
      group - the group name to be removed
      Gibt zurück:
      %TRUE if @group was successfully removed.
      Löst aus:
      AllocationError

    • removeItem

      public boolean removeItem(@Nonnull Str uri) throws AllocationError
      Removes the bookmark for @uri from the bookmark file @bookmark.
      Parameter:
      uri - a valid URI
      Gibt zurück:
      %TRUE if the bookmark was removed successfully.
      Löst aus:
      AllocationError

    • removeItem

      public boolean removeItem(String uri) throws AllocationError
      Removes the bookmark for @uri from the bookmark file @bookmark.
      Parameter:
      uri - a valid URI
      Gibt zurück:
      %TRUE if the bookmark was removed successfully.
      Löst aus:
      AllocationError

    • setAdded

      @Deprecated public void setAdded(@Nonnull Str uri, long added)
      Veraltet.
      Sets the time the bookmark for @uri was added into @bookmark.

      If no bookmark for @uri is found then it is created.
      Parameter:
      uri - a valid URI
      added - a timestamp or -1 to use the current time

    • setAdded

      @Deprecated public void setAdded(String uri, long added)
      Veraltet.
      Sets the time the bookmark for @uri was added into @bookmark.

      If no bookmark for @uri is found then it is created.
      Parameter:
      uri - a valid URI
      added - a timestamp or -1 to use the current time

    • setAddedDateTime

      public void setAddedDateTime(@Nonnull Str uri, @Nonnull DateTime added)
      Sets the time the bookmark for @uri was added into @bookmark.

      If no bookmark for @uri is found then it is created.
      Parameter:
      uri - a valid URI
      added - a #GDateTime

    • setAddedDateTime

      public void setAddedDateTime(String uri, @Nonnull DateTime added)
      Sets the time the bookmark for @uri was added into @bookmark.

      If no bookmark for @uri is found then it is created.
      Parameter:
      uri - a valid URI
      added - a #GDateTime

    • setAppInfo

      @Deprecated public boolean setAppInfo(@Nonnull Str uri, @Nonnull Str name, @Nonnull Str exec, int count, long stamp) throws AllocationError
      Veraltet.
      Sets the meta-data of application @name inside the list of
      applications that have registered a bookmark for @uri inside
      @bookmark.

      You should rarely use this function; use g_bookmark_file_add_application()
      and g_bookmark_file_remove_application() instead.

      @name can be any UTF-8 encoded string used to identify an
      application.
      @exec can have one of these two modifiers: "\%f", which will
      be expanded as the local file name retrieved from the bookmark's
      URI; "\%u", which will be expanded as the bookmark's URI.
      The expansion is done automatically when retrieving the stored
      command line using the g_bookmark_file_get_application_info() function.
      @count is the number of times the application has registered the
      bookmark; if is < 0, the current registration count will be increased
      by one, if is 0, the application with @name will be removed from
      the list of registered applications.
      @stamp is the Unix time of the last registration; if it is -1, the
      current time will be used.

      If you try to remove an application by setting its registration count to
      zero, and no bookmark for @uri is found, %FALSE is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND; similarly,
      in the event that no application @name has registered a bookmark
      for @uri, %FALSE is returned and error is set to
      %G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. Otherwise, if no bookmark
      for @uri is found, one is created.
      Parameter:
      uri - a valid URI
      name - an application's name
      exec - an application's command line
      count - the number of registrations done for this application
      stamp - the time of the last registration for this application
      Gibt zurück:
      %TRUE if the application's meta-data was successfully changed.
      Löst aus:
      AllocationError

    • setAppInfo

      @Deprecated public boolean setAppInfo(String uri, String name, String exec, int count, long stamp) throws AllocationError
      Veraltet.
      Sets the meta-data of application @name inside the list of
      applications that have registered a bookmark for @uri inside
      @bookmark.

      You should rarely use this function; use g_bookmark_file_add_application()
      and g_bookmark_file_remove_application() instead.

      @name can be any UTF-8 encoded string used to identify an
      application.
      @exec can have one of these two modifiers: "\%f", which will
      be expanded as the local file name retrieved from the bookmark's
      URI; "\%u", which will be expanded as the bookmark's URI.
      The expansion is done automatically when retrieving the stored
      command line using the g_bookmark_file_get_application_info() function.
      @count is the number of times the application has registered the
      bookmark; if is < 0, the current registration count will be increased
      by one, if is 0, the application with @name will be removed from
      the list of registered applications.
      @stamp is the Unix time of the last registration; if it is -1, the
      current time will be used.

      If you try to remove an application by setting its registration count to
      zero, and no bookmark for @uri is found, %FALSE is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND; similarly,
      in the event that no application @name has registered a bookmark
      for @uri, %FALSE is returned and error is set to
      %G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. Otherwise, if no bookmark
      for @uri is found, one is created.
      Parameter:
      uri - a valid URI
      name - an application's name
      exec - an application's command line
      count - the number of registrations done for this application
      stamp - the time of the last registration for this application
      Gibt zurück:
      %TRUE if the application's meta-data was successfully changed.
      Löst aus:
      AllocationError

    • setApplicationInfo

      public boolean setApplicationInfo(@Nonnull Str uri, @Nonnull Str name, @Nonnull Str exec, int count, @Nullable DateTime stamp) throws AllocationError
      Sets the meta-data of application @name inside the list of
      applications that have registered a bookmark for @uri inside
      @bookmark.

      You should rarely use this function; use g_bookmark_file_add_application()
      and g_bookmark_file_remove_application() instead.

      @name can be any UTF-8 encoded string used to identify an
      application.
      @exec can have one of these two modifiers: "\%f", which will
      be expanded as the local file name retrieved from the bookmark's
      URI; "\%u", which will be expanded as the bookmark's URI.
      The expansion is done automatically when retrieving the stored
      command line using the g_bookmark_file_get_application_info() function.
      @count is the number of times the application has registered the
      bookmark; if is < 0, the current registration count will be increased
      by one, if is 0, the application with @name will be removed from
      the list of registered applications.
      @stamp is the Unix time of the last registration.

      If you try to remove an application by setting its registration count to
      zero, and no bookmark for @uri is found, %FALSE is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND; similarly,
      in the event that no application @name has registered a bookmark
      for @uri, %FALSE is returned and error is set to
      %G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. Otherwise, if no bookmark
      for @uri is found, one is created.
      Parameter:
      uri - a valid URI
      name - an application's name
      exec - an application's command line
      count - the number of registrations done for this application
      stamp - the time of the last registration for this application, which may be %NULL if @count is 0
      Gibt zurück:
      %TRUE if the application's meta-data was successfully changed.
      Löst aus:
      AllocationError

    • setApplicationInfo

      public boolean setApplicationInfo(String uri, String name, String exec, int count, @Nullable DateTime stamp) throws AllocationError
      Sets the meta-data of application @name inside the list of
      applications that have registered a bookmark for @uri inside
      @bookmark.

      You should rarely use this function; use g_bookmark_file_add_application()
      and g_bookmark_file_remove_application() instead.

      @name can be any UTF-8 encoded string used to identify an
      application.
      @exec can have one of these two modifiers: "\%f", which will
      be expanded as the local file name retrieved from the bookmark's
      URI; "\%u", which will be expanded as the bookmark's URI.
      The expansion is done automatically when retrieving the stored
      command line using the g_bookmark_file_get_application_info() function.
      @count is the number of times the application has registered the
      bookmark; if is < 0, the current registration count will be increased
      by one, if is 0, the application with @name will be removed from
      the list of registered applications.
      @stamp is the Unix time of the last registration.

      If you try to remove an application by setting its registration count to
      zero, and no bookmark for @uri is found, %FALSE is returned and
      @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND; similarly,
      in the event that no application @name has registered a bookmark
      for @uri, %FALSE is returned and error is set to
      %G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. Otherwise, if no bookmark
      for @uri is found, one is created.
      Parameter:
      uri - a valid URI
      name - an application's name
      exec - an application's command line
      count - the number of registrations done for this application
      stamp - the time of the last registration for this application, which may be %NULL if @count is 0
      Gibt zurück:
      %TRUE if the application's meta-data was successfully changed.
      Löst aus:
      AllocationError

    • setDescription

      public void setDescription(@Nullable Str uri, @Nonnull Str description)
      Sets @description as the description of the bookmark for @uri.

      If @uri is %NULL, the description of @bookmark is set.

      If a bookmark for @uri cannot be found then it is created.
      Parameter:
      uri - a valid URI or %NULL
      description - a string

    • setDescription

      public void setDescription(String uri, String description)
      Sets @description as the description of the bookmark for @uri.

      If @uri is %NULL, the description of @bookmark is set.

      If a bookmark for @uri cannot be found then it is created.
      Parameter:
      uri - a valid URI or %NULL
      description - a string

    • setIcon

      public void setIcon(@Nonnull Str uri, @Nullable Str href, @Nonnull Str mime_type)
      Sets the icon for the bookmark for @uri. If @href is %NULL, unsets
      the currently set icon. @href can either be a full URL for the icon
      file or the icon name following the Icon Naming specification.

      If no bookmark for @uri is found one is created.
      Parameter:
      uri - a valid URI
      href - the URI of the icon for the bookmark, or %NULL
      mime_type - the MIME type of the icon for the bookmark

    • setIcon

      public void setIcon(String uri, String href, String mime_type)
      Sets the icon for the bookmark for @uri. If @href is %NULL, unsets
      the currently set icon. @href can either be a full URL for the icon
      file or the icon name following the Icon Naming specification.

      If no bookmark for @uri is found one is created.
      Parameter:
      uri - a valid URI
      href - the URI of the icon for the bookmark, or %NULL
      mime_type - the MIME type of the icon for the bookmark

    • setIsPrivate

      public void setIsPrivate(@Nonnull Str uri, boolean is_private)
      Sets the private flag of the bookmark for @uri.

      If a bookmark for @uri cannot be found then it is created.
      Parameter:
      uri - a valid URI
      is_private - %TRUE if the bookmark should be marked as private

    • setIsPrivate

      public void setIsPrivate(String uri, boolean is_private)
      Sets the private flag of the bookmark for @uri.

      If a bookmark for @uri cannot be found then it is created.
      Parameter:
      uri - a valid URI
      is_private - %TRUE if the bookmark should be marked as private

    • setMimeType

      public void setMimeType(@Nonnull Str uri, @Nonnull Str mime_type)
      Sets @mime_type as the MIME type of the bookmark for @uri.

      If a bookmark for @uri cannot be found then it is created.
      Parameter:
      uri - a valid URI
      mime_type - a MIME type

    • setMimeType

      public void setMimeType(String uri, String mime_type)
      Sets @mime_type as the MIME type of the bookmark for @uri.

      If a bookmark for @uri cannot be found then it is created.
      Parameter:
      uri - a valid URI
      mime_type - a MIME type

    • setModified

      @Deprecated public void setModified(@Nonnull Str uri, long modified)
      Veraltet.
      Sets the last time the bookmark for @uri was last modified.

      If no bookmark for @uri is found then it is created.

      The "modified" time should only be set when the bookmark's meta-data
      was actually changed. Every function of #GBookmarkFile that
      modifies a bookmark also changes the modification time, except for
      g_bookmark_file_set_visited_date_time().
      Parameter:
      uri - a valid URI
      modified - a timestamp or -1 to use the current time

    • setModified

      @Deprecated public void setModified(String uri, long modified)
      Veraltet.
      Sets the last time the bookmark for @uri was last modified.

      If no bookmark for @uri is found then it is created.

      The "modified" time should only be set when the bookmark's meta-data
      was actually changed. Every function of #GBookmarkFile that
      modifies a bookmark also changes the modification time, except for
      g_bookmark_file_set_visited_date_time().
      Parameter:
      uri - a valid URI
      modified - a timestamp or -1 to use the current time

    • setModifiedDateTime

      public void setModifiedDateTime(@Nonnull Str uri, @Nonnull DateTime modified)
      Sets the last time the bookmark for @uri was last modified.

      If no bookmark for @uri is found then it is created.

      The "modified" time should only be set when the bookmark's meta-data
      was actually changed. Every function of #GBookmarkFile that
      modifies a bookmark also changes the modification time, except for
      g_bookmark_file_set_visited_date_time().
      Parameter:
      uri - a valid URI
      modified - a #GDateTime

    • setModifiedDateTime

      public void setModifiedDateTime(String uri, @Nonnull DateTime modified)
      Sets the last time the bookmark for @uri was last modified.

      If no bookmark for @uri is found then it is created.

      The "modified" time should only be set when the bookmark's meta-data
      was actually changed. Every function of #GBookmarkFile that
      modifies a bookmark also changes the modification time, except for
      g_bookmark_file_set_visited_date_time().
      Parameter:
      uri - a valid URI
      modified - a #GDateTime

    • setTitle

      public void setTitle(@Nullable Str uri, @Nonnull Str title)
      Sets @title as the title of the bookmark for @uri inside the
      bookmark file @bookmark.

      If @uri is %NULL, the title of @bookmark is set.

      If a bookmark for @uri cannot be found then it is created.
      Parameter:
      uri - a valid URI or %NULL
      title - a UTF-8 encoded string

    • setTitle

      public void setTitle(String uri, String title)
      Sets @title as the title of the bookmark for @uri inside the
      bookmark file @bookmark.

      If @uri is %NULL, the title of @bookmark is set.

      If a bookmark for @uri cannot be found then it is created.
      Parameter:
      uri - a valid URI or %NULL
      title - a UTF-8 encoded string

    • setVisited

      @Deprecated public void setVisited(@Nonnull Str uri, long visited)
      Veraltet.
      Sets the time the bookmark for @uri was last visited.

      If no bookmark for @uri is found then it is created.

      The "visited" time should only be set if the bookmark was launched,
      either using the command line retrieved by g_bookmark_file_get_application_info()
      or by the default application for the bookmark's MIME type, retrieved
      using g_bookmark_file_get_mime_type(). Changing the "visited" time
      does not affect the "modified" time.
      Parameter:
      uri - a valid URI
      visited - a timestamp or -1 to use the current time

    • setVisited

      @Deprecated public void setVisited(String uri, long visited)
      Veraltet.
      Sets the time the bookmark for @uri was last visited.

      If no bookmark for @uri is found then it is created.

      The "visited" time should only be set if the bookmark was launched,
      either using the command line retrieved by g_bookmark_file_get_application_info()
      or by the default application for the bookmark's MIME type, retrieved
      using g_bookmark_file_get_mime_type(). Changing the "visited" time
      does not affect the "modified" time.
      Parameter:
      uri - a valid URI
      visited - a timestamp or -1 to use the current time

    • setVisitedDateTime

      public void setVisitedDateTime(@Nonnull Str uri, @Nonnull DateTime visited)
      Sets the time the bookmark for @uri was last visited.

      If no bookmark for @uri is found then it is created.

      The "visited" time should only be set if the bookmark was launched,
      either using the command line retrieved by g_bookmark_file_get_application_info()
      or by the default application for the bookmark's MIME type, retrieved
      using g_bookmark_file_get_mime_type(). Changing the "visited" time
      does not affect the "modified" time.
      Parameter:
      uri - a valid URI
      visited - a #GDateTime

    • setVisitedDateTime

      public void setVisitedDateTime(String uri, @Nonnull DateTime visited)
      Sets the time the bookmark for @uri was last visited.

      If no bookmark for @uri is found then it is created.

      The "visited" time should only be set if the bookmark was launched,
      either using the command line retrieved by g_bookmark_file_get_application_info()
      or by the default application for the bookmark's MIME type, retrieved
      using g_bookmark_file_get_mime_type(). Changing the "visited" time
      does not affect the "modified" time.
      Parameter:
      uri - a valid URI
      visited - a #GDateTime

    • toData

      public Str toData(@Nullable Int64 length) throws AllocationError
      This function outputs @bookmark as a string.
      Parameter:
      length - return location for the length of the returned string, or %NULL
      Gibt zurück:
      a newly allocated string holding the contents of the #GBookmarkFile
      Löst aus:
      AllocationError

    • toFile

      public boolean toFile(@Nonnull Str filename) throws AllocationError
      This function outputs @bookmark into a file. The write process is
      guaranteed to be atomic by using g_file_set_contents() internally.
      Parameter:
      filename - path of the output file
      Gibt zurück:
      %TRUE if the file was successfully written.
      Löst aus:
      AllocationError

    • toFile

      public boolean toFile(String filename) throws AllocationError
      This function outputs @bookmark into a file. The write process is
      guaranteed to be atomic by using g_file_set_contents() internally.
      Parameter:
      filename - path of the output file
      Gibt zurück:
      %TRUE if the file was successfully written.
      Löst aus:
      AllocationError

    • errorQuark

      public static int errorQuark()
      Gibt zurück:

    • getTypeID

      public static long getTypeID()

    • getParentTypeID

      public static long getParentTypeID()

    • getTypeSize

      public static TypeSystem.TypeSize getTypeSize()

    • getParentTypeSize

      public static TypeSystem.TypeSize getParentTypeSize()

    • getInstanceSize

      public static int getInstanceSize()