Declaration [src]

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 - -

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


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 value 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.