Gtk.UriLauncher¶

Subclasses:: None

Methods¶

Inherited:: GObject.Object (37)
Structs:: GObject.ObjectClass (5)

class	`new` (uri)
	`get_uri` ()
	`launch` (parent, cancellable, callback, *user_data)
	`launch_finish` (result)
	`set_uri` (uri)

Virtual Methods¶

Inherited:: GObject.Object (7)

Properties¶

Name	Type	Flags	Short Description
`uri`	`str`	r/w/en

Signals¶

Inherited:: GObject.Object (1)

Fields¶

Inherited:: GObject.Object (1)

Class Details¶

class Gtk.UriLauncher(**kwargs)¶

Bases:: GObject.Object
Abstract:: No
Structure:: Gtk.UriLauncherClass

Asynchronous API to open a uri with an application.

GtkUriLauncher collects the arguments that are needed to open the uri.

Depending on system configuration, user preferences and available APIs, this may or may not show an app chooser dialog or launch the default application right away.

The operation is started with the [method`Gtk`.UriLauncher.launch] function.

To launch a file, use [class`Gtk`.FileLauncher].

New in version 4.10.

classmethod new(uri)[source]¶

Parameters:: uri (str or None) – the uri to open
Returns:: the new GtkUriLauncher
Return type:: Gtk.UriLauncher

Creates a new GtkUriLauncher object.

New in version 4.10.

get_uri()[source]¶

Returns:: the uri
Return type:: str or None

Gets the uri that will be opened.

New in version 4.10.

launch(parent, cancellable, callback, *user_data)[source]¶

Parameters:

parent (Gtk.Window or None) – the parent window
cancellable (Gio.Cancellable or None) – a cancellable to cancel the operation
callback (Gio.AsyncReadyCallback or None) – a callback to call when the operation is complete
user_data (object or None) – data to pass to callback

Launches an application to open the uri.

This may present an app chooser dialog to the user.

New in version 4.10.

launch_finish(result)[source]¶

Parameters:: result (Gio.AsyncResult) – the result
Raises:: GLib.Error
Returns:: true if an application was launched
Return type:: bool

Finishes the [method`Gtk`.UriLauncher.launch] call and returns the result.

New in version 4.10.

set_uri(uri)[source]¶

Parameters:: uri (str or None) – the uri

Sets the uri that will be opened.

New in version 4.10.

Property Details¶

Gtk.UriLauncher.props.uri¶

Name:: uri
Type:: str
Default Value:: None
Flags:: READABLE, WRITABLE, EXPLICIT_NOTIFY

The uri to launch.

New in version 4.10.