Function gtk::functions::show_uri_on_window

source · [−]
pub fn show_uri_on_window(
    parent: Option<&impl IsA<Window>>, 
    uri: &str, 
    timestamp: u32
) -> Result<(), Error>
Available on crate feature v3_22 only.
Expand description

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:megnome``

Ideally the timestamp is taken from the event triggering the 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.

parent

parent window

uri

the uri to show

timestamp

a timestamp to prevent focus stealing

Returns

true on success, false on error