Function

Gtkshow_uri_on_window

Declaration [src]

gboolean
gtk_show_uri_on_window (
  GtkWindow* parent,
  const char* uri,
  guint32 timestamp,
  GError** error
)

Description [src]

This is a convenience function for launching the default application to show the uri. The uri must be of a form understood by GIO (i.e. you need to install gvfs to get support for uri schemes such as http:// or ftp://, as only local files are handled by GIO itself). Typical examples are - file:///home/gnome/pict.jpg - http://www.gnome.org - mailto:me@gnome.org

Ideally the timestamp is taken from the event triggering the gtk_show_uri() call. If timestamp is not known you can take GDK_CURRENT_TIME.

This is the recommended call to be used as it passes information necessary for sandbox helpers to parent their dialogs properly.

Available since:3.22

Parameters

parent GtkWindow
 

Parent window.

 The argument can be NULL.
 The data is owned by the caller of the function.
uri const char*
 

The uri to show.

 The data is owned by the caller of the function.
 The string is a NUL terminated UTF-8 string.
timestamp guint32
 

A timestamp to prevent focus stealing.

error GError **
  The return location for a GError*, or NULL.

Return value

Returns: gboolean
 

TRUE on success, FALSE on error.