Trait gio::prelude::AppInfoExt
source · pub trait AppInfoExt: 'static {
Show 23 methods
// Required methods
fn add_supports_type(&self, content_type: &str) -> Result<(), Error>;
fn can_delete(&self) -> bool;
fn can_remove_supports_type(&self) -> bool;
fn delete(&self) -> bool;
fn dup(&self) -> AppInfo;
fn equal(&self, appinfo2: &impl IsA<AppInfo>) -> bool;
fn commandline(&self) -> Option<PathBuf>;
fn description(&self) -> Option<GString>;
fn display_name(&self) -> GString;
fn executable(&self) -> PathBuf;
fn icon(&self) -> Option<Icon>;
fn id(&self) -> Option<GString>;
fn name(&self) -> GString;
fn supported_types(&self) -> Vec<GString>;
fn launch(
&self,
files: &[File],
context: Option<&impl IsA<AppLaunchContext>>
) -> Result<(), Error>;
fn launch_uris(
&self,
uris: &[&str],
context: Option<&impl IsA<AppLaunchContext>>
) -> Result<(), Error>;
fn remove_supports_type(&self, content_type: &str) -> Result<(), Error>;
fn set_as_default_for_extension(
&self,
extension: impl AsRef<Path>
) -> Result<(), Error>;
fn set_as_default_for_type(&self, content_type: &str) -> Result<(), Error>;
fn set_as_last_used_for_type(&self, content_type: &str) -> Result<(), Error>;
fn should_show(&self) -> bool;
fn supports_files(&self) -> bool;
fn supports_uris(&self) -> bool;
}
Expand description
Required Methods§
sourcefn add_supports_type(&self, content_type: &str) -> Result<(), Error>
fn add_supports_type(&self, content_type: &str) -> Result<(), Error>
Adds a content type to the application information to indicate the application is capable of opening files with the given content type.
content_type
a string.
Returns
sourcefn can_delete(&self) -> bool
fn can_delete(&self) -> bool
sourcefn can_remove_supports_type(&self) -> bool
fn can_remove_supports_type(&self) -> bool
sourcefn delete(&self) -> bool
fn delete(&self) -> bool
Tries to delete a AppInfo
.
On some platforms, there may be a difference between user-defined
GAppInfos
which can be deleted, and system-wide ones which cannot.
See can_delete()
.
Returns
true
if self
has been deleted
fn equal(&self, appinfo2: &impl IsA<AppInfo>) -> bool
sourcefn commandline(&self) -> Option<PathBuf>
fn commandline(&self) -> Option<PathBuf>
sourcefn description(&self) -> Option<GString>
fn description(&self) -> Option<GString>
sourcefn display_name(&self) -> GString
fn display_name(&self) -> GString
Gets the display name of the application. The display name is often more descriptive to the user than the name itself.
Returns
the display name of the application for self
, or the name if
no display name is available.
sourcefn executable(&self) -> PathBuf
fn executable(&self) -> PathBuf
Gets the executable’s name for the installed application.
Returns
a string containing the self
’s application
binaries name
sourcefn id(&self) -> Option<GString>
fn id(&self) -> Option<GString>
Gets the ID of an application. An id is a string that identifies the application. The exact format of the id is platform dependent. For instance, on Unix this is the desktop file id from the xdg menu specification.
Note that the returned ID may be None
, depending on how
the self
has been constructed.
Returns
a string containing the application’s ID.
sourcefn supported_types(&self) -> Vec<GString>
fn supported_types(&self) -> Vec<GString>
Retrieves the list of content types that app_info
claims to support.
If this information is not provided by the environment, this function
will return None
.
This function does not take in consideration associations added with
add_supports_type()
, but only those exported directly by
the application.
Returns
a list of content types.
sourcefn launch(
&self,
files: &[File],
context: Option<&impl IsA<AppLaunchContext>>
) -> Result<(), Error>
fn launch( &self, files: &[File], context: Option<&impl IsA<AppLaunchContext>> ) -> Result<(), Error>
Launches the application. Passes files
to the launched application
as arguments, using the optional context
to get information
about the details of the launcher (like what screen it is on).
On error, error
will be set accordingly.
To launch the application without arguments pass a None
files
list.
Note that even if the launch is successful the application launched can fail to start if it runs into problems during startup. There is no way to detect this.
Some URIs can be changed when passed through a GFile (for instance
unsupported URIs with strange formats like mailto:), so if you have
a textual URI you want to pass in as argument, consider using
launch_uris()
instead.
The launched application inherits the environment of the launching
process, but it can be modified with AppLaunchContextExt::setenv()
and AppLaunchContextExt::unsetenv()
.
On UNIX, this function sets the GIO_LAUNCHED_DESKTOP_FILE
environment variable with the path of the launched desktop file and
GIO_LAUNCHED_DESKTOP_FILE_PID
to the process id of the launched
process. This can be used to ignore GIO_LAUNCHED_DESKTOP_FILE
,
should it be inherited by further processes. The DISPLAY
and
DESKTOP_STARTUP_ID
environment variables are also set, based
on information provided in context
.
files
a GList
of File
objects
context
a AppLaunchContext
or None
Returns
sourcefn launch_uris(
&self,
uris: &[&str],
context: Option<&impl IsA<AppLaunchContext>>
) -> Result<(), Error>
fn launch_uris( &self, uris: &[&str], context: Option<&impl IsA<AppLaunchContext>> ) -> Result<(), Error>
Launches the application. This passes the uris
to the launched application
as arguments, using the optional context
to get information
about the details of the launcher (like what screen it is on).
On error, error
will be set accordingly.
To launch the application without arguments pass a None
uris
list.
Note that even if the launch is successful the application launched can fail to start if it runs into problems during startup. There is no way to detect this.
uris
a GList
containing URIs to launch.
context
a AppLaunchContext
or None