Package org.gnome.gtk

Class UriLauncher

java.lang.Object

org.javagi.base.ProxyInstance

org.gnome.gobject.TypeInstance

org.gnome.gobject.GObject

org.gnome.gtk.UriLauncher

All Implemented Interfaces:

Proxy

@Generated("io.github.jwharm.JavaGI")
public class UriLauncher
extends GObject

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 launch(org.gnome.gtk.Window, org.gnome.gio.Cancellable, org.gnome.gio.AsyncReadyCallback) function.

To launch a file, use FileLauncher.

Since:

4.10

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	UriLauncher.Builder<B extends UriLauncher.Builder<B>>	Inner class implementing a builder pattern to construct a GObject with properties.
static class	UriLauncher.UriLauncherClass

Nested classes/interfaces inherited from class org.gnome.gobject.GObject

GObject.NotifyCallback, GObject.ObjectClass

Constructor Summary

Constructors

Constructor	Description
UriLauncher()	Creates a new UriLauncher.
UriLauncher(@Nullable String uri)	Creates a new GtkUriLauncher object.
UriLauncher(MemorySegment address)	Create a UriLauncher proxy instance for the provided memory address.

Method Summary

Modifier and Type	Method	Description
protected UriLauncher	asParent()	Returns this instance as if it were its parent type.
static UriLauncher.Builder<? extends UriLauncher.Builder>	builder()	A UriLauncher.Builder object constructs a UriLauncher with the specified properties.
boolean	canLaunch(@Nullable Window parent)	Returns whether the launcher is likely to succeed in launching an application for its uri.
static @Nullable Type	getType()	Get the GType of the UriLauncher class
@Nullable String	getUri()	Gets the uri that will be opened.
void	launch(@Nullable Window parent, @Nullable Cancellable cancellable, @Nullable AsyncReadyCallback callback)	Launches an application to open the uri.
boolean	launchFinish(AsyncResult result)	Finishes the launch(org.gnome.gtk.Window, org.gnome.gio.Cancellable, org.gnome.gio.AsyncReadyCallback) call and returns the result.
void	setUri(@Nullable String uri)	Sets the uri that will be opened.

Methods inherited from class org.gnome.gobject.GObject

addToggleRef, addWeakPointer, bindProperty, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, compatControl, connect, connect, connect, constructed, disconnect, dispatchPropertiesChanged, dispose, dupData, dupQdata, emit, emitNotify, finalize_, forceFloating, freezeNotify, get, getData, getMemoryLayout, getProperty, getProperty, getProperty, getQdata, getv, interfaceFindProperty, interfaceInstallProperty, interfaceListProperties, isFloating, newInstance, newInstance, newv, notify, notify, notifyByPspec, onNotify, ref, refSink, removeToggleRef, removeWeakPointer, replaceData, replaceQdata, runDispose, set, setData, setDataFull, setProperty, setProperty, setProperty, setQdata, setQdataFull, setv, stealData, stealQdata, takeRef, thawNotify, unref, watchClosure, weakRef, weakUnref, withProperties

Methods inherited from class org.gnome.gobject.TypeInstance

callParent, callParent, cast, getPrivate, readGClass, writeGClass

Methods inherited from class org.javagi.base.ProxyInstance

equals, handle, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Details

UriLauncher

public UriLauncher(MemorySegment address)

Create a UriLauncher proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

UriLauncher

public UriLauncher(@Nullable String uri)

Creates a new GtkUriLauncher object.

Parameters:

uri - the uri to open

Since:

4.10

UriLauncher

public UriLauncher()

Creates a new UriLauncher.

Method Details

getType

public static @Nullable Type getType()

Get the GType of the UriLauncher class

Returns:

the GType

asParent

protected UriLauncher asParent()

Returns this instance as if it were its parent type. This is mostly synonymous to the Java super keyword, but will set the native typeclass function pointers to the parent type. When overriding a native virtual method in Java, "chaining up" with super.methodName() doesn't work, because it invokes the overridden function pointer again. To chain up, call asParent().methodName(). This will call the native function pointer of this virtual method in the typeclass of the parent type.

Overrides:

asParent in class GObject

canLaunch

public boolean canLaunch(@Nullable Window parent)

Returns whether the launcher is likely to succeed in launching an application for its uri.

This can be used to disable controls that trigger the launcher when they are known not to work.

Parameters:

parent - the parent window

Returns:

false if the launcher is known not to support the uri, true otherwise

Since:

4.20

getUri

public @Nullable String getUri()

Gets the uri that will be opened.

Returns:

the uri

Since:

4.10

launch

public void launch(@Nullable Window parent,
 @Nullable Cancellable cancellable,
 @Nullable AsyncReadyCallback callback)

Launches an application to open the uri.

This may present an app chooser dialog to the user.

Parameters:

parent - the parent window

cancellable - a cancellable to cancel the operation

callback - a callback to call when the operation is complete

Since:

4.10

launchFinish

public boolean launchFinish(AsyncResult result)
                     throws GErrorException

Finishes the launch(org.gnome.gtk.Window, org.gnome.gio.Cancellable, org.gnome.gio.AsyncReadyCallback) call and returns the result.

Parameters:

result - the result

Returns:

true if an application was launched

Throws:

GErrorException - see GError

Since:

4.10

setUri

public void setUri(@Nullable String uri)

Sets the uri that will be opened.

Parameters:

uri - the uri

Since:

4.10

builder

public static UriLauncher.Builder<? extends UriLauncher.Builder> builder()

A UriLauncher.Builder object constructs a UriLauncher with the specified properties. Use the various set...() methods to set properties, and finish construction with UriLauncher.Builder.build().

Returns:

the builder object