Package: gtk

Function gtk-show-uri

Lambda List

gtk-show-uri (screen uri timestamp)

Arguments

screen -- a gdk-screen object to show the URi on or nil for the default screen
uri -- a string with the URI to show
timestamp -- a :uint with the timestamp to prevent focus stealing

Return Value

True on success, nil on error.

Details

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 function can be used as a replacement for gnome_vfs_url_show() and gnome_url_show().
 

See also

2020-9-20