Gnome::Gtk4::T-show

Class initialization

new

Initialization of a type class is simple and only needed when the standalone functions are used.

method new ( )

Standalone Functions

show-uri

This function launches the default application for showing a given uri, or shows an error dialog if that fails.

method show-uri ( N-Object() $parent, Str $uri, UInt() $timestamp )

• $parent; parent window.

• $uri; the uri to show.

• $timestamp; timestamp from the event that triggered this call, or GDK_CURRENT_TIME.

show-uri-full This function is not yet available

This function launches the default application for showing a given uri.

The $callback will be called when the launch is completed. It should call .uri-full-finish() to obtain the result.

This is the recommended call to be used as it passes information necessary for sandbox helpers to parent their dialogs properly.

method show-uri-full ( N-Object() $parent, Str $uri, UInt() $timestamp, N-Object() $cancellable, …, gpointer $user-data )

• $parent; parent window.

• $uri; the uri to show.

• $timestamp; timestamp from the event that triggered this call, or GDK_CURRENT_TIME.

• $cancellable; a Gnome::Gio::Cancellable to cancel the launch.

• callback; a callback to call when the action is complete. Note that each argument must be specified as a type followed by its value!

• $user-data; data to pass to $callback.

show-uri-full-finish

Finishes the .uri() call and returns the result of the operation.

method show-uri-full-finish ( N-Object() $parent, N-Object() $result --> Bool )

• $parent; the Gnome::Gtk4::Window passed to .uri().

• $result; Gnome::Gio::R-AsyncResult that was passed to $callback.

Return value; True if the URI was shown successfully. Otherwise, False is returned and $error is set.