Struct gtk4::UriLauncher

pub struct UriLauncher { /* private fields */ }

Available on crate feature v4_10 only.

A UriLauncher 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 Gtk::UriLauncher::launch_finish().

To launch a file, use FileLauncher.

Properties

uri

The uri to launch.

Readable | Writeable

Implements

[trait@glib::ObjectExt]

Implementations

impl UriLauncher

pub fn new(uri: &str) -> UriLauncher

Creates a new UriLauncher object.

uri

the uri to open

Returns

the new UriLauncher

pub fn builder() -> UriLauncherBuilder

Creates a new builder-pattern struct instance to construct UriLauncher objects.

This method returns an instance of UriLauncherBuilder which can be used to create UriLauncher objects.

pub fn uri(&self) -> Option<GString>

Gets the uri that will be opened.

Returns

the uri

pub fn launch<P: FnOnce(Result<(), Error>) + 'static>( &self, parent: Option<&impl IsA<Window>>, cancellable: Option<&impl IsA<Cancellable>>, callback: P )

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 Gtk::UriLauncher::launch_finish() to obtain the result.

parent

the parent Window

cancellable

a GCancellable to cancel the operation

callback

a callback to call when the operation is complete

pub fn launch_future( &self, parent: Option<&(impl IsA<Window> + Clone + 'static)> ) -> Pin<Box_<dyn Future<Output = Result<(), Error>> + 'static>>

pub fn set_uri(&self, uri: Option<&str>)

Sets the uri that will be opened.

uri

the uri

pub fn connect_uri_notify<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

Trait Implementations

impl Clone for UriLauncher

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for UriLauncher

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for UriLauncher

fn default() -> Self

Returns the “default value” for a type.

impl HasParamSpec for UriLauncher

type ParamSpec = ParamSpecObject

type SetValue = UriLauncher

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = fn(_: &str) -> ParamSpecObjectBuilder<'_, UriLauncher>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for UriLauncher

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for UriLauncher

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl ParentClassIs for UriLauncher

type Parent = Object

impl<OT: ObjectType> PartialEq<OT> for UriLauncher

fn eq(&self, other: &OT) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<OT: ObjectType> PartialOrd<OT> for UriLauncher

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for UriLauncher

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for UriLauncher