/*
 * This file is part of gtkD.
 *
 * gtkD is free software; you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License
 * as published by the Free Software Foundation; either version 3
 * of the License, or (at your option) any later version, with
 * some exceptions, please read the COPYING file.
 *
 * gtkD is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with gtkD; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110, USA
 */

// generated automatically - do not change
// find conversion definition on APILookup.txt
// implement new conversion functionalities the gir-to-d pakage


module gio.AppInfoIF;

private import gio.AppInfoIF;
private import gio.AppLaunchContext;
private import gio.AsyncResultIF;
private import gio.Cancellable;
private import gio.FileIF;
private import gio.IconIF;
private import gio.c.functions;
public  import gio.c.types;
private import glib.ErrorG;
private import glib.GException;
private import glib.ListG;
private import glib.Str;
private import glib.c.functions;
private import gobject.ObjectG;


/**
 * Information about an installed application and methods to launch
 * it (with file arguments).
 * 
 * `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 [method@Gio.File.get_path]) when using [method@Gio.AppInfo.launch]
 * even if the application requested an URI and not a POSIX path. For example
 * for a desktop-file based application with the following Exec key:
 * 
 * ```
 * Exec=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 [iface@Gio.File] constructors (since GVfs
 * implements the GVfs extension point). As such, if the application
 * needs to examine the URI, it needs to use [method@Gio.File.get_uri]
 * or similar on [iface@Gio.File]. In other words, an application cannot
 * assume that the URI passed to e.g. [func@Gio.File.new_for_commandline_arg]
 * is equal to the result of [method@Gio.File.get_uri]. The following snippet
 * illustrates this:
 * 
 * ```c
 * 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;
 * 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.
 */
public interface AppInfoIF{
	/** Get the main Gtk struct */
	public GAppInfo* getAppInfoStruct(bool transferOwnership = false);

	/** the main Gtk struct as a void* */
	protected void* getStruct();


	/** */
	public static GType getType()
	{
		return g_app_info_get_type();
	}

	/**
	 * Creates a new [iface@Gio.AppInfo] from the given information.
	 *
	 * Note that for @commandline, the quoting rules of the `Exec` key of the
	 * [freedesktop.org Desktop Entry Specification](http://freedesktop.org/Standards/desktop-entry-spec)
	 * are applied. For example, if the @commandline contains
	 * percent-encoded URIs, the percent-character must be doubled in order to prevent it from
	 * being swallowed by `Exec` key unquoting. See
	 * [the specification](https://specifications.freedesktop.org/desktop-entry-spec/latest/ar01s07.html)
	 * for exact quoting rules.
	 *
	 * Params:
	 *     commandline = the command line to use
	 *     applicationName = the application name, or `NULL` to use @commandline
	 *     flags = flags that can specify details of the created [iface@Gio.AppInfo]
	 *
	 * Returns: new [iface@Gio.AppInfo] for given command.
	 *
	 * Throws: GException on failure.
	 */
	public static AppInfoIF createFromCommandline(string commandline, string applicationName, GAppInfoCreateFlags flags)
	{
		GError* err = null;

		auto __p = g_app_info_create_from_commandline(Str.toStringz(commandline), Str.toStringz(applicationName), flags, &err);

		if (err !is null)
		{
			throw new GException( new ErrorG(err) );
		}

		if(__p is null)
		{
			return null;
		}

		return ObjectG.getDObject!(AppInfoIF)(cast(GAppInfo*) __p, true);
	}

	/**
	 * Gets a list of all of the applications currently registered
	 * on this system.
	 *
	 * For desktop files, this includes applications that have
	 * [`NoDisplay=true`](https://specifications.freedesktop.org/desktop-entry-spec/latest/ar01s06.html#key-nodisplay)
	 * set or are excluded from display by means of
	 * [`OnlyShowIn`](https://specifications.freedesktop.org/desktop-entry-spec/latest/ar01s06.html#key-onlyshowin)
	 * or [`NotShowIn`](https://specifications.freedesktop.org/desktop-entry-spec/latest/ar01s06.html#key-notshowin).
	 * See [method@Gio.AppInfo.should_show].
	 *
	 * The returned list does not include applications which have the
	 * [`Hidden` key](https://specifications.freedesktop.org/desktop-entry-spec/latest/ar01s06.html#key-hidden)
	 * set.
	 *
	 * Returns: a newly allocated
	 *     list of references to [iface@Gio.AppInfo]s.
	 */
	public static ListG getAll()
	{
		auto __p = g_app_info_get_all();

		if(__p is null)
		{
			return null;
		}

		return new ListG(cast(GList*) __p, true);
	}

	/**
	 * Gets a list of all [iface@Gio.AppInfo]s for a given content type,
	 * including the recommended and fallback [iface@Gio.AppInfo]s. See
	 * [func@Gio.AppInfo.get_recommended_for_type] and
	 * [func@Gio.AppInfo.get_fallback_for_type].
	 *
	 * Params:
	 *     contentType = the content type to find a [iface@Gio.AppInfo] for
	 *
	 * Returns: list of
	 *     [iface@Gio.AppInfo]s for given @content_type.
	 */
	public static ListG getAllForType(string contentType)
	{
		auto __p = g_app_info_get_all_for_type(Str.toStringz(contentType));

		if(__p is null)
		{
			return null;
		}

		return new ListG(cast(GList*) __p, true);
	}

	/**
	 * Gets the default [iface@Gio.AppInfo] for a given content type.
	 *
	 * Params:
	 *     contentType = the content type to find a [iface@Gio.AppInfo] for
	 *     mustSupportUris = if `TRUE`, the [iface@Gio.AppInfo] is expected to
	 *         support URIs
	 *
	 * Returns: [iface@Gio.AppInfo] for given
	 *     @content_type or `NULL` on error.
	 */
	public static AppInfoIF getDefaultForType(string contentType, bool mustSupportUris)
	{
		auto __p = g_app_info_get_default_for_type(Str.toStringz(contentType), mustSupportUris);

		if(__p is null)
		{
			return null;
		}

		return ObjectG.getDObject!(AppInfoIF)(cast(GAppInfo*) __p, true);
	}

	/**
	 * Asynchronously gets the default [iface@Gio.AppInfo] for a given content
	 * type.
	 *
	 * Params:
	 *     contentType = the content type to find a [iface@Gio.AppInfo] for
	 *     mustSupportUris = if `TRUE`, the [iface@Gio.AppInfo] is expected to
	 *         support URIs
	 *     cancellable = a [class@Gio.Cancellable]
	 *     callback = a [type@Gio.AsyncReadyCallback] to call
	 *         when the request is done
	 *     userData = data to pass to @callback
	 *
	 * Since: 2.74
	 */
	public static void getDefaultForTypeAsync(string contentType, bool mustSupportUris, Cancellable cancellable, GAsyncReadyCallback callback, void* userData)
	{
		g_app_info_get_default_for_type_async(Str.toStringz(contentType), mustSupportUris, (cancellable is null) ? null : cancellable.getCancellableStruct(), callback, userData);
	}

	/**
	 * Finishes a default [iface@Gio.AppInfo] lookup started by
	 * [func@Gio.AppInfo.get_default_for_type_async].
	 *
	 * If no #[iface@Gio.AppInfo] is found, then @error will be set to
	 * [error@Gio.IOErrorEnum.NOT_FOUND].
	 *
	 * Params:
	 *     result = the async result
	 *
	 * Returns: [iface@Gio.AppInfo] for given @content_type or
	 *     `NULL` on error.
	 *
	 * Since: 2.74
	 *
	 * Throws: GException on failure.
	 */
	public static AppInfoIF getDefaultForTypeFinish(AsyncResultIF result)
	{
		GError* err = null;

		auto __p = g_app_info_get_default_for_type_finish((result is null) ? null : result.getAsyncResultStruct(), &err);

		if (err !is null)
		{
			throw new GException( new ErrorG(err) );
		}

		if(__p is null)
		{
			return null;
		}

		return ObjectG.getDObject!(AppInfoIF)(cast(GAppInfo*) __p, true);
	}

	/**
	 * Gets the default application for handling URIs with the given URI scheme.
	 *
	 * A URI scheme is the initial part of the URI, up to but not including the `:`.
	 * For example, `http`, `ftp` or `sip`.
	 *
	 * Params:
	 *     uriScheme = a string containing a URI scheme.
	 *
	 * Returns: [iface@Gio.AppInfo] for given
	 *     @uri_scheme or `NULL` on error.
	 */
	public static AppInfoIF getDefaultForUriScheme(string uriScheme)
	{
		auto __p = g_app_info_get_default_for_uri_scheme(Str.toStringz(uriScheme));

		if(__p is null)
		{
			return null;
		}

		return ObjectG.getDObject!(AppInfoIF)(cast(GAppInfo*) __p, true);
	}

	/**
	 * Asynchronously gets the default application for handling URIs with
	 * the given URI scheme. A URI scheme is the initial part
	 * of the URI, up to but not including the `:`, e.g. `http`,
	 * `ftp` or `sip`.
	 *
	 * Params:
	 *     uriScheme = a string containing a URI scheme.
	 *     cancellable = a [class@Gio.Cancellable]
	 *     callback = a [type@Gio.AsyncReadyCallback] to call
	 *         when the request is done
	 *     userData = data to pass to @callback
	 *
	 * Since: 2.74
	 */
	public static void getDefaultForUriSchemeAsync(string uriScheme, Cancellable cancellable, GAsyncReadyCallback callback, void* userData)
	{
		g_app_info_get_default_for_uri_scheme_async(Str.toStringz(uriScheme), (cancellable is null) ? null : cancellable.getCancellableStruct(), callback, userData);
	}

	/**
	 * Finishes a default [iface@Gio.AppInfo] lookup started by
	 * [func@Gio.AppInfo.get_default_for_uri_scheme_async].
	 *
	 * If no [iface@Gio.AppInfo] is found, then @error will be set to
	 * [error@Gio.IOErrorEnum.NOT_FOUND].
	 *
	 * Params:
	 *     result = the async result
	 *
	 * Returns: [iface@Gio.AppInfo] for given @uri_scheme or
	 *     `NULL` on error.
	 *
	 * Since: 2.74
	 *
	 * Throws: GException on failure.
	 */
	public static AppInfoIF getDefaultForUriSchemeFinish(AsyncResultIF result)
	{
		GError* err = null;

		auto __p = g_app_info_get_default_for_uri_scheme_finish((result is null) ? null : result.getAsyncResultStruct(), &err);

		if (err !is null)
		{
			throw new GException( new ErrorG(err) );
		}

		if(__p is null)
		{
			return null;
		}

		return ObjectG.getDObject!(AppInfoIF)(cast(GAppInfo*) __p, true);
	}

	/**
	 * Gets a list of fallback [iface@Gio.AppInfo]s for a given content type, i.e.
	 * those applications which claim to support the given content type by MIME
	 * type subclassing and not directly.
	 *
	 * Params:
	 *     contentType = the content type to find a [iface@Gio.AppInfo] for
	 *
	 * Returns: list of [iface@Gio.AppInfo]s
	 *     for given @content_type or `NULL` on error.
	 *
	 * Since: 2.28
	 */
	public static ListG getFallbackForType(string contentType)
	{
		auto __p = g_app_info_get_fallback_for_type(Str.toStringz(contentType));

		if(__p is null)
		{
			return null;
		}

		return new ListG(cast(GList*) __p, true);
	}

	/**
	 * Gets a list of recommended [iface@Gio.AppInfo]s for a given content type,
	 * i.e. those applications which claim to support the given content type
	 * exactly, and not by MIME type subclassing.
	 *
	 * Note that the first application of the list is the last used one, i.e.
	 * the last one for which [method@Gio.AppInfo.set_as_last_used_for_type] has
	 * been called.
	 *
	 * Params:
	 *     contentType = the content type to find a [iface@Gio.AppInfo] for
	 *
	 * Returns: list of
	 *     [iface@Gio.AppInfo]s for given @content_type or `NULL` on error.
	 *
	 * Since: 2.28
	 */
	public static ListG getRecommendedForType(string contentType)
	{
		auto __p = g_app_info_get_recommended_for_type(Str.toStringz(contentType));

		if(__p is null)
		{
			return null;
		}

		return new ListG(cast(GList*) __p, true);
	}

	/**
	 * Utility function that launches the default application registered to handle
	 * the specified uri. Synchronous I/O is done on the uri to detect the type of
	 * the file if required.
	 *
	 * The D-Bus–activated applications don’t have to be started if your application
	 * terminates too soon after this function. To prevent this, use
	 * [func@Gio.AppInfo.launch_default_for_uri_async] instead.
	 *
	 * Params:
	 *     uri = the uri to show
	 *     context = optional launch context
	 *
	 * Returns: `TRUE` on success, `FALSE` on error.
	 *
	 * Throws: GException on failure.
	 */
	public static bool launchDefaultForUri(string uri, AppLaunchContext context)
	{
		GError* err = null;

		auto __p = g_app_info_launch_default_for_uri(Str.toStringz(uri), (context is null) ? null : context.getAppLaunchContextStruct(), &err) != 0;

		if (err !is null)
		{
			throw new GException( new ErrorG(err) );
		}

		return __p;
	}

	/**
	 * Async version of [func@Gio.AppInfo.launch_default_for_uri].
	 *
	 * This version is useful if you are interested in receiving error information
	 * in the case where the application is sandboxed and the portal may present an
	 * application chooser dialog to the user.
	 *
	 * This is also useful if you want to be sure that the D-Bus–activated
	 * applications are really started before termination and if you are interested
	 * in receiving error information from their activation.
	 *
	 * Params:
	 *     uri = the uri to show
	 *     context = optional launch context
	 *     cancellable = a [class@Gio.Cancellable]
	 *     callback = a [type@Gio.AsyncReadyCallback] to call
	 *         when the request is done
	 *     userData = data to pass to @callback
	 *
	 * Since: 2.50
	 */
	public static void launchDefaultForUriAsync(string uri, AppLaunchContext context, Cancellable cancellable, GAsyncReadyCallback callback, void* userData)
	{
		g_app_info_launch_default_for_uri_async(Str.toStringz(uri), (context is null) ? null : context.getAppLaunchContextStruct(), (cancellable is null) ? null : cancellable.getCancellableStruct(), callback, userData);
	}

	/**
	 * Finishes an asynchronous launch-default-for-uri operation.
	 *
	 * Params:
	 *     result = the async result
	 *
	 * Returns: `TRUE` if the launch was successful, `FALSE` if @error is set
	 *
	 * Since: 2.50
	 *
	 * Throws: GException on failure.
	 */
	public static bool launchDefaultForUriFinish(AsyncResultIF result)
	{
		GError* err = null;

		auto __p = g_app_info_launch_default_for_uri_finish((result is null) ? null : result.getAsyncResultStruct(), &err) != 0;

		if (err !is null)
		{
			throw new GException( new ErrorG(err) );
		}

		return __p;
	}

	/**
	 * Removes all changes to the type associations done by
	 * [method@Gio.AppInfo.set_as_default_for_type],
	 * [method@Gio.AppInfo.set_as_default_for_extension],
	 * [method@Gio.AppInfo.add_supports_type] or
	 * [method@Gio.AppInfo.remove_supports_type].
	 *
	 * Params:
	 *     contentType = a content type
	 *
	 * Since: 2.20
	 */
	public static void resetTypeAssociations(string contentType)
	{
		g_app_info_reset_type_associations(Str.toStringz(contentType));
	}

	/**
	 * Adds a content type to the application information to indicate the
	 * application is capable of opening files with the given content type.
	 *
	 * Params:
	 *     contentType = a string.
	 *
	 * Returns: `TRUE` on success, `FALSE` on error.
	 *
	 * Throws: GException on failure.
	 */
	public bool addSupportsType(string contentType);

	/**
	 * Obtains the information whether the [iface@Gio.AppInfo] can be deleted.
	 * See [method@Gio.AppInfo.delete].
	 *
	 * Returns: `TRUE` if @appinfo can be deleted
	 *
	 * Since: 2.20
	 */
	public bool canDelete();

	/**
	 * Checks if a supported content type can be removed from an application.
	 *
	 * Returns: `TRUE` if it is possible to remove supported content types from a
	 *     given @appinfo, `FALSE` if not.
	 */
	public bool canRemoveSupportsType();

	alias delet = delete_;
	/**
	 * Tries to delete a [iface@Gio.AppInfo].
	 *
	 * On some platforms, there may be a difference between user-defined
	 * [iface@Gio.AppInfo]s which can be deleted, and system-wide ones which cannot.
	 * See [method@Gio.AppInfo.can_delete].
	 *
	 * Returns: `TRUE` if @appinfo has been deleted
	 *
	 * Since: 2.20
	 */
	public bool delete_();

	/**
	 * Creates a duplicate of a [iface@Gio.AppInfo].
	 *
	 * Returns: a duplicate of @appinfo.
	 */
	public AppInfoIF dup();

	/**
	 * Checks if two [iface@Gio.AppInfo]s are equal.
	 *
	 * Note that the check *may not* compare each individual field, and only does
	 * an identity check. In case detecting changes in the contents is needed,
	 * program code must additionally compare relevant fields.
	 *
	 * Params:
	 *     appinfo2 = the second [iface@Gio.AppInfo].
	 *
	 * Returns: `TRUE` if @appinfo1 is equal to @appinfo2. `FALSE` otherwise.
	 */
	public bool equal(AppInfoIF appinfo2);

	/**
	 * Gets the commandline with which the application will be
	 * started.
	 *
	 * Returns: a string containing the @appinfo’s
	 *     commandline, or `NULL` if this information is not available
	 *
	 * Since: 2.20
	 */
	public string getCommandline();

	/**
	 * Gets a human-readable description of an installed application.
	 *
	 * Returns: a string containing a description of the
	 *     application @appinfo, or `NULL` if none.
	 */
	public string getDescription();

	/**
	 * 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 @appinfo, or the name if
	 *     no display name is available.
	 *
	 * Since: 2.24
	 */
	public string getDisplayName();

	/**
	 * Gets the executable’s name for the installed application.
	 *
	 * This is intended to be used for debugging or labelling what program is going
	 * to be run. To launch the executable, use [method@Gio.AppInfo.launch] and related
	 * functions, rather than spawning the return value from this function.
	 *
	 * Returns: a string containing the @appinfo’s application
	 *     binaries name
	 */
	public string getExecutable();

	/**
	 * Gets the icon for the application.
	 *
	 * Returns: the default [iface@Gio.Icon] for
	 *     @appinfo or `NULL` if there is no default icon.
	 */
	public IconIF getIcon();

	/**
	 * 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: a string containing the application’s ID.
	 */
	public string getId();

	/**
	 * Gets the installed name of the application.
	 *
	 * Returns: the name of the application for @appinfo.
	 */
	public string getName();

	/**
	 * 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 `NULL`.
	 *
	 * This function does not take in consideration associations added with
	 * [method@Gio.AppInfo.add_supports_type], but only those exported directly by
	 * the application.
	 *
	 * Returns: a list of content types.
	 *
	 * Since: 2.34
	 */
	public string[] getSupportedTypes();

	/**
	 * 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 `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
	 * [method@Gio.AppInfo.launch_uris] instead.
	 *
	 * The launched application inherits the environment of the launching
	 * process, but it can be modified with [method@Gio.AppLaunchContext.setenv]
	 * and [method@Gio.AppLaunchContext.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`,
	 * `XDG_ACTIVATION_TOKEN` and `DESKTOP_STARTUP_ID` environment
	 * variables are also set, based on information provided in @context.
	 *
	 * Params:
	 *     files = a list of [iface@Gio.File] objects
	 *     context = the launch context
	 *
	 * Returns: `TRUE` on successful launch, `FALSE` otherwise.
	 *
	 * Throws: GException on failure.
	 */
	public bool launch(ListG files, AppLaunchContext context);

	/**
	 * 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. If the application only supports
	 * one URI per invocation as part of their command-line, multiple instances
	 * of the application will be spawned.
	 *
	 * To launch 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.
	 *
	 * Params:
	 *     uris = a list of URIs to launch.
	 *     context = the launch context
	 *
	 * Returns: `TRUE` on successful launch, `FALSE` otherwise.
	 *
	 * Throws: GException on failure.
	 */
	public bool launchUris(ListG uris, AppLaunchContext context);

	/**
	 * Async version of [method@Gio.AppInfo.launch_uris].
	 *
	 * The @callback is invoked immediately after the application launch, but it
	 * waits for activation in case of D-Bus–activated applications and also provides
	 * extended error information for sandboxed applications, see notes for
	 * [func@Gio.AppInfo.launch_default_for_uri_async].
	 *
	 * Params:
	 *     uris = a list of URIs to launch.
	 *     context = the launch context
	 *     cancellable = a [class@Gio.Cancellable]
	 *     callback = a [type@Gio.AsyncReadyCallback] to call
	 *         when the request is done
	 *     userData = data to pass to @callback
	 *
	 * Since: 2.60
	 */
	public void launchUrisAsync(ListG uris, AppLaunchContext context, Cancellable cancellable, GAsyncReadyCallback callback, void* userData);

	/**
	 * Finishes a [method@Gio.AppInfo.launch_uris_async] operation.
	 *
	 * Params:
	 *     result = the async result
	 *
	 * Returns: `TRUE` on successful launch, `FALSE` otherwise.
	 *
	 * Since: 2.60
	 *
	 * Throws: GException on failure.
	 */
	public bool launchUrisFinish(AsyncResultIF result);

	/**
	 * Removes a supported type from an application, if possible.
	 *
	 * Params:
	 *     contentType = a string.
	 *
	 * Returns: `TRUE` on success, `FALSE` on error.
	 *
	 * Throws: GException on failure.
	 */
	public bool removeSupportsType(string contentType);

	/**
	 * Sets the application as the default handler for the given file extension.
	 *
	 * Params:
	 *     extension = a string containing the file extension (without
	 *         the dot).
	 *
	 * Returns: `TRUE` on success, `FALSE` on error.
	 *
	 * Throws: GException on failure.
	 */
	public bool setAsDefaultForExtension(string extension);

	/**
	 * Sets the application as the default handler for a given type.
	 *
	 * Params:
	 *     contentType = the content type.
	 *
	 * Returns: `TRUE` on success, `FALSE` on error.
	 *
	 * Throws: GException on failure.
	 */
	public bool setAsDefaultForType(string contentType);

	/**
	 * 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
	 * [func@Gio.AppInfo.get_recommended_for_type], regardless of the default
	 * application for that content type.
	 *
	 * Params:
	 *     contentType = the content type.
	 *
	 * Returns: `TRUE` on success, `FALSE` on error.
	 *
	 * Throws: GException on failure.
	 */
	public bool setAsLastUsedForType(string contentType);

	/**
	 * Checks if the application info should be shown in menus that
	 * list available applications.
	 *
	 * Returns: `TRUE` if the @appinfo should be shown, `FALSE` otherwise.
	 */
	public bool shouldShow();

	/**
	 * Checks if the application accepts files as arguments.
	 *
	 * Returns: `TRUE` if the @appinfo supports files.
	 */
	public bool supportsFiles();

	/**
	 * Checks if the application supports reading files and directories from URIs.
	 *
	 * Returns: `TRUE` if the @appinfo supports URIs.
	 */
	public bool supportsUris();
}
