Struct FileLauncher

pub struct FileLauncher { /* private fields */ }

Available on crate feature v4_10 only.

Collects the arguments that are needed to open a file 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.

To launch uris that don’t represent files, use UriLauncher.

Properties

always-ask

Whether to ask the user to choose an app for opening the file. If FALSE, the file might be opened with a default app or the previous choice.

Readable | Writeable

file

The file to launch.

Readable | Writeable

writable

Whether to make the file writable for the handler.

Readable | Writeable

Implements

[trait@glib::ObjectExt]

GLib type: GObject with reference counted clone semantics.

Implementations

impl FileLauncher

pub fn new(file: Option<&impl IsA<File>>) -> FileLauncher

Creates a new FileLauncher object.

file

the file to open

Returns

the new FileLauncher

pub fn must_always_ask(&self) -> bool

Available on crate feature v4_12 only.

Returns whether to ask the user which app to use.

Returns

true if always asking the user

pub fn file(&self) -> Option<File>

Gets the file that will be opened.

Returns

the file

pub fn is_writable(&self) -> bool

Available on crate feature v4_14 only.

Returns whether to make the file writable for the handler.

Returns

true if the file will be made writable

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

Launches an application to open the file.

This may present an app chooser dialog to the user.

parent

the parent window

cancellable

a cancellable 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 open_containing_folder<P: FnOnce(Result<(), Error>) + 'static>( &self, parent: Option<&impl IsA<Window>>, cancellable: Option<&impl IsA<Cancellable>>, callback: P, )

Launches a file manager to show the file in its parent directory.

This is only supported for native files. It will fail if @file is e.g. a http:// uri.

parent

the parent window

cancellable

a cancellable to cancel the operation

callback

a callback to call when the operation is complete

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

pub fn set_always_ask(&self, always_ask: bool)

Available on crate feature v4_12 only.

Sets whether to awlays ask the user which app to use.

If false, the file might be opened with a default app or the previous choice.

always_ask

whether to always ask

pub fn set_file(&self, file: Option<&impl IsA<File>>)

Sets the file that will be opened.

file

the file

pub fn set_writable(&self, writable: bool)

Available on crate feature v4_14 only.

Sets whether to make the file writable for the handler.

writable

whether to make the file writable

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

Available on crate feature v4_12 only.

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

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

Available on crate feature v4_14 only.

Trait Implementations

impl Clone for FileLauncher

fn clone(&self) -> Self

Makes a clone of this shared reference.

This increments the strong reference count of the object. Dropping the object will decrement it again.

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

Performs copy-assignment from source.

impl Debug for FileLauncher

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

Formats the value using the given formatter.

impl HasParamSpec for FileLauncher

type ParamSpec = ParamSpecObject

type SetValue = FileLauncher

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

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

fn param_spec_builder() -> Self::BuilderFn

impl Hash for FileLauncher

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

where H: Hasher,

Hashes the memory address of this object.

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 FileLauncher

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

Comparison for two GObjects.

Compares the memory addresses of the provided objects.

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,

Restrict a value to a certain interval.

impl ParentClassIs for FileLauncher

type Parent = Object

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

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

Equality for two GObjects.

Two GObjects are equal if their memory addresses are equal.

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

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

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

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

Partial comparison for two GObjects.

Compares the memory addresses of the provided objects.

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl StaticType for FileLauncher

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for FileLauncher