UriLauncher

Added in version 4.10.

class UriLauncher(**properties: Any)

Superclasses: Object

A GtkUriLauncher object collects the arguments that are needed to open a uri with an application.

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 launch function. This API follows the GIO async pattern, and the result can be obtained by calling launch_finish.

To launch a file, use FileLauncher.

Constructors

class UriLauncher

classmethod new(uri: str | None = None) → UriLauncher

Creates a new GtkUriLauncher object.

Added in version 4.10.

Parameters:

uri – the uri to open

Methods

class UriLauncher

get_uri() → str | None

Gets the uri that will be opened.

Added in version 4.10.

launch(parent: Window | None = None, cancellable: Cancellable | None = None, callback: Callable[[...], None] | None = None, *user_data: Any) → None

Launch an application to open the uri.

This may present an app chooser dialog to the user.

The callback will be called when the operation is completed. It should call launch_finish to obtain the result.

Added in version 4.10.

Parameters:

• parent – the parent GtkWindow

• cancellable – a GCancellable to cancel the operation

• callback – a callback to call when the operation is complete

• user_data – data to pass to callback

launch_finish(result: AsyncResult) → bool

Finishes the launch call and returns the result.

Added in version 4.10.

Parameters:

result – a GAsyncResult

set_uri(uri: str | None = None) → None

Sets the uri that will be opened.

Added in version 4.10.

Parameters:

uri – the uri

Properties

class UriLauncher

props.uri: str

The uri to launch.

Added in version 4.10.