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 -- an unsigned integer 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, that ist, 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 function call. If timestamp is not known you can take gdk:+current-time+.

This function can be used as a replacement for the gnome_vfs_url_show() and gnome_url_show() functions.
 

See also

#2024-11-20