@gtkx/ffi 0.6.1 → 0.8.0

package/dist/generated/giounix/desktop-app-info.d.ts

@@ -1,6 +1,8 @@
 import { Ref } from "@gtkx/native";
+import * as AppStream from "../appstream/index.js";
 import * as GLib from "../glib/index.js";
 import * as GObject from "../gobject/index.js";
+import * as Gdk from "../gdk/index.js";
 import * as Gio from "../gio/index.js";
 /**
  * `GDesktopAppInfo` is an implementation of [iface@Gio.AppInfo] based on
@@ -253,6 +255,195 @@ export declare class DesktopAppInfo extends GObject.GObject {
      * explicitly listed in the `Actions` key of the `Desktop Entry` group.
      */
     listActions(): string[];
+    /**
+     * Adds a content type to the application information to indicate the
+     * application is capable of opening files with the given content type.
+     * @param contentType - a string.
+     */
+    addSupportsType(contentType: string): boolean;
+    /**
+     * Obtains the information whether the [iface@Gio.AppInfo] can be deleted.
+     * See [method@Gio.AppInfo.delete].
+     */
+    canDelete(): boolean;
+    /**
+     * Checks if a supported content type can be removed from an application.
+     */
+    canRemoveSupportsType(): boolean;
+    /**
+     * 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].
+     */
+    delete(): boolean;
+    /**
+     * Creates a duplicate of a [iface@Gio.AppInfo].
+     */
+    dup(): Gio.AppInfo;
+    /**
+     * 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.
+     * @param appinfo2 - the second [iface@Gio.AppInfo].
+     */
+    equal(appinfo2: Gio.AppInfo): boolean;
+    /**
+     * Gets the commandline with which the application will be
+     * started.
+     */
+    getCommandline(): string | null;
+    /**
+     * Gets a human-readable description of an installed application.
+     */
+    getDescription(): string | null;
+    /**
+     * Gets the display name of the application. The display name is often more
+     * descriptive to the user than the name itself.
+     */
+    getDisplayName(): string;
+    /**
+     * 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.
+     */
+    getExecutable(): string;
+    /**
+     * Gets the icon for the application.
+     */
+    getIcon(): AppStream.Icon | null;
+    /**
+     * 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.
+     */
+    getId(): string | null;
+    /**
+     * Gets the installed name of the application.
+     */
+    getName(): string;
+    /**
+     * 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.
+     */
+    getSupportedTypes(): string[];
+    /**
+     * 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.
+     * @param files - a list of [iface@Gio.File] objects
+     * @param context - the launch context
+     */
+    launch(files?: Gio.File[] | null, context?: Gdk.AppLaunchContext | null): boolean;
+    /**
+     * 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.
+     * @param uris - a list of URIs to launch.
+     * @param context - the launch context
+     */
+    launchUris(uris?: string[] | null, context?: Gdk.AppLaunchContext | null): boolean;
+    /**
+     * 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].
+     * @param uris - a list of URIs to launch.
+     * @param context - the launch context
+     * @param cancellable - a [class@Gio.Cancellable]
+     * @param callback - a [type@Gio.AsyncReadyCallback] to call
+     * @param userData - data to pass to @callback
+     */
+    launchUrisAsync(uris?: string[] | null, context?: Gdk.AppLaunchContext | null, cancellable?: Gio.Cancellable | null, callback?: (...args: unknown[]) => unknown | null, userData?: number | null): void;
+    /**
+     * Finishes a [method@Gio.AppInfo.launch_uris_async] operation.
+     * @param result - the async result
+     */
+    launchUrisFinish(result: Gio.AsyncResult): boolean;
+    /**
+     * Removes a supported type from an application, if possible.
+     * @param contentType - a string.
+     */
+    removeSupportsType(contentType: string): boolean;
+    /**
+     * Sets the application as the default handler for the given file extension.
+     * @param extension - a string containing the file extension (without
+     */
+    setAsDefaultForExtension(extension: string): boolean;
+    /**
+     * Sets the application as the default handler for a given type.
+     * @param contentType - the content type.
+     */
+    setAsDefaultForType(contentType: string): boolean;
+    /**
+     * 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.
+     * @param contentType - the content type.
+     */
+    setAsLastUsedForType(contentType: string): boolean;
+    /**
+     * Checks if the application info should be shown in menus that
+     * list available applications.
+     */
+    shouldShow(): boolean;
+    /**
+     * Checks if the application accepts files as arguments.
+     */
+    supportsFiles(): boolean;
+    /**
+     * Checks if the application supports reading files and directories from URIs.
+     */
+    supportsUris(): boolean;
     connect(signal: "notify", handler: (self: DesktopAppInfo, pspec: GObject.ParamSpec) => void, after?: boolean): number;
     connect(signal: string, handler: (...args: any[]) => any, after?: boolean): number;
 }