Back to Seed Clases

Gio

Classes

Interfaces

Structs

Unions

Enums

Interface Gio.AppInfo

Import line:	Gio = imports.gi.Gio;
GIR File:	Gio-2.0.gir
C documentation:	GAppInfo
Interface :	AppInfo
Implementations:	Gio.DesktopAppInfo

GAppInfo and GAppLaunchContext are used for describing and launching
applications installed on the system.
As of GLib 2.20, URIs will always be converted to POSIX paths
(using g_file_get_path()) when using g_app_info_launch() even if
the application requested an URI and not a POSIX path. For example
for an desktop-file based application with Exec key totem
%U and a single URI,
sftp://foo/file.avi, then
/home/user/.gvfs/sftp on foo/file.avi will be
passed. This will only work if a set of suitable GIO extensions
(such as gvfs 2.26 compiled with FUSE support), is available and
operational; if this is not the case, the URI will be passed
unmodified to the application. Some URIs, such as
mailto:, of course cannot be mapped to a POSIX
path (in gvfs there's no FUSE mount for it); such URIs will be
passed unmodified to the application.
Specifically for gvfs 2.26 and later, the POSIX URI will be mapped
back to the GIO URI in the GFile constructors (since gvfs
implements the GVfs extension point). As such, if the application
needs to examine the URI, it needs to use g_file_get_uri() or
similar on GFile. In other words, an application cannot assume
that the URI passed to e.g. g_file_new_for_commandline_arg() is
equal to the result of g_file_get_uri(). The following snippet
illustrates this:

GFile *f;
char *uri;
file = g_file_new_for_commandline_arg (uri_from_commandline);
uri = g_file_get_uri (file);
strcmp (uri, uri_from_commandline) == 0; // FALSE
g_free (uri);
if (g_file_has_uri_scheme (file, "cdda"))
{
// do something special with uri
}
g_object_unref (file);

This code will work when both cdda://sr0/Track
1.wav and /home/user/.gvfs/cdda on sr0/Track
1.wav is passed to the application. It should be noted
that it's generally not safe for applications to rely on the format
of a particular URIs. Different launcher applications (e.g. file
managers) may have different ideas of what a given URI means.

Properties
None

Methods / Constructors
Method / Constructor		Defined By
	add_supports_type (String *content_type) : gboolean Adds a content type to the application information to indicate the application is capable of opening files with the given content type. Adds a content type to the application information to indicate the application is capable of opening files with the given content type. Parameters: String content_type* Required (not null) a string. Returns: gboolean TRUE on success, FALSE on error.	Gio.AppInfo
	can_delete () : gboolean Obtains the information whether the GAppInfo can be deleted. Obtains the information whether the GAppInfo can be deleted. See g_app_info_delete(). Returns: gboolean TRUE if appinfo can be deleted	Gio.AppInfo
	can_remove_supports_type () : gboolean Checks if a supported content type can be removed from an application. Checks if a supported content type can be removed from an application. content types from a given appinfo, FALSE if not. Returns: gboolean TRUE if it is possible to remove supported	Gio.AppInfo
	delete () : gboolean Tries to delete a GAppInfo. Tries to delete a GAppInfo. On some platforms, there may be a difference between user-defined GAppInfos which can be deleted, and system-wide ones which cannot. See g_app_info_can_delete(). Returns: gboolean TRUE if appinfo has been deleted	Gio.AppInfo
	dup () : Gio.AppInfo Creates a duplicate of a GAppInfo. Creates a duplicate of a GAppInfo. Returns: Gio.AppInfo a duplicate of appinfo.	Gio.AppInfo
	equal (AppInfo *appinfo2) : gboolean Checks if two GAppInfos are equal. Checks if two GAppInfos are equal. Parameters: Gio.AppInfo appinfo2* Required (not null) the second GAppInfo. Returns: gboolean TRUE if appinfo1 is equal to appinfo2. FALSE otherwise.	Gio.AppInfo
	get_commandline () : String Gets the commandline with which the application will be started. Gets the commandline with which the application will be started. or NULL if this information is not available Returns: String a string containing the appinfo's commandline,	Gio.AppInfo
	get_description () : String Gets a human-readable description of an installed application. Gets a human-readable description of an installed application. application appinfo, or NULL if none. Returns: String a string containing a description of the	Gio.AppInfo
	get_display_name () : String Gets the display name of the application. Gets the display name of the application. The display name is often more descriptive to the user than the name itself. no display name is available. Returns: String the display name of the application for appinfo, or the name if	Gio.AppInfo
	get_executable () : String Gets the executable's name for the installed application. Gets the executable's name for the installed application. binaries name Returns: String a string containing the appinfo's application	Gio.AppInfo
	get_icon () : Gio.Icon Gets the icon for the application. Gets the icon for the application. Returns: Gio.Icon the default GIcon for appinfo.	Gio.AppInfo
	get_id () : String Gets the ID of an application. 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 NULL, depending on how the appinfo has been constructed. Returns: String a string containing the application's ID.	Gio.AppInfo
	get_name () : String Gets the installed name of the application. Gets the installed name of the application. Returns: String the name of the application for appinfo.	Gio.AppInfo
	launch (Array *files, AppLaunchContext launch_context) : gboolean Launches the application. Launches the application. Passes files* to the launched application as arguments, using the optional launch_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 NULL 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 g_app_info_launch_uris() instead. 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 launch_context. Parameters: Array files Required (not null) a GList of GFile objects Gio.AppLaunchContext launch_context a GAppLaunchContext or NULL Returns: gboolean TRUE on successful launch, FALSE otherwise.	Gio.AppInfo
	launch_uris (Array *uris, AppLaunchContext launch_context) : gboolean Launches the application. Launches the application. Passes uris* to the launched application as arguments, using the optional launch_context to get information about the details of the launcher (like what screen it is on). On error, error will be set accordingly. To lauch the application without arguments pass a NULL 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. Parameters: Array uris Required (not null) a GList containing URIs to launch. Gio.AppLaunchContext launch_context a GAppLaunchContext or NULL Returns: gboolean TRUE on successful launch, FALSE otherwise.	Gio.AppInfo
	remove_supports_type (String *content_type) : gboolean Removes a supported type from an application, if possible. Removes a supported type from an application, if possible. Parameters: String content_type* Required (not null) a string. Returns: gboolean TRUE on success, FALSE on error.	Gio.AppInfo
	set_as_default_for_extension (String *extension) : gboolean Sets the application as the default handler for the given file extension. Sets the application as the default handler for the given file extension. Parameters: String extension* Required (not null) a string containing the file extension (without the dot). Returns: gboolean TRUE on success, FALSE on error.	Gio.AppInfo
	set_as_default_for_type (String *content_type) : gboolean Sets the application as the default handler for a given type. Sets the application as the default handler for a given type. Parameters: String content_type* Required (not null) the content type. Returns: gboolean TRUE on success, FALSE on error.	Gio.AppInfo
	set_as_last_used_for_type (String *content_type) : gboolean Sets the application as the last used application for a given type. Sets the application as the last used application for a given type. This will make the application appear as first in the list returned by g_app_info_get_recommended_for_type, regardless of the default application for that content type. Parameters: String content_type* Required (not null) the content type. Returns: gboolean TRUE on success, FALSE on error.	Gio.AppInfo
	should_show () : gboolean Checks if the application info should be shown in menus that list available applications. Checks if the application info should be shown in menus that list available applications. Returns: gboolean TRUE if the appinfo should be shown, FALSE otherwise.	Gio.AppInfo
	supports_files () : gboolean Checks if the application accepts files as arguments. Checks if the application accepts files as arguments. Returns: gboolean TRUE if the appinfo supports files.	Gio.AppInfo
	supports_uris () : gboolean Checks if the application supports reading files and directories from URIs. Checks if the application supports reading files and directories from URIs. Returns: gboolean TRUE if the appinfo supports URIs.	Gio.AppInfo

Events
None

Used by These Methods / Signals / Properties
Class / Namespace	Method / Signal / Properties
Gio Method	Gio.app_info_create_from_commandline (String *commandline, String application_name, AppInfoCreateFlags flags) : Gio.AppInfo Creates a new GAppInfo* from the given information.
Gio Method	Gio.app_info_get_default_for_type (String *content_type, gboolean must_support_uris) : Gio.AppInfo Gets the GAppInfo* that corresponds to a given content type.
Gio Method	Gio.app_info_get_default_for_uri_scheme (String *uri_scheme*) : Gio.AppInfo Gets the default application for launching applications using this URI scheme.
Gio.AppLaunchContext Method	get_display (AppInfo *info, Array files) : String Gets the display string for the context*.
Gio.AppLaunchContext Method	get_startup_notify_id (AppInfo *info, Array files*) : String Initiates startup notification for the application and returns the DESKTOP_STARTUP_ID for the launched operation, if supported.
Gio.DesktopAppInfoLookup Method	get_default_for_uri_scheme (String *uri_scheme*) : Gio.AppInfo Gets the default application for launching applications using this URI scheme for a particular GDesktopAppInfoLookup implementation.
Gio.File Method	query_default_handler (Cancellable *cancellable) : Gio.AppInfo Returns the GAppInfo* that is registered as the default application to handle the file specified by file.
Gtk.AppChooser Method	get_app_info () : Gio.AppInfo Returns the currently selected application.
Gtk.AppChooserWidget Signal	application_activated (AppChooserWidget *self, AppInfo application*) : none Emitted when an application item is activated from the widget's list.
Gtk.AppChooserWidget Signal	application_selected (AppChooserWidget *self, AppInfo application*) : none Emitted when an application item is selected from the widget's list.
Gtk.AppChooserWidget Signal	populate_popup (AppChooserWidget *self, Menu menu, AppInfo application*) : none Emitted when a context menu is about to popup over an application item.
Gtk.RecentInfo Method	create_app_info (String *app_name) : Gio.AppInfo Creates a GAppInfo* for the specified GtkRecentInfo In case of error, error will be set either with a GTK_RECENT_MANAGER_ERROR or a G_IO_ERROR