Hide navigation sidebar
Hide table of contents sidebar
Skip to content
Back to top
View this page
Toggle table of contents sidebar

# App Chooser

## Description

Interface for choosing an application

This backend can be used by portal implementations that need to choose an application from a list of applications.

This documentation describes version 2 of this interface.

## Methods

### org.freedesktop.impl.portal.AppChooser.ChooseApplication

    ChooseApplication (
      IN handle o,
      IN app_id s,
      IN parent_window s,
      IN choices as,
      IN options a{sv},
      OUT response u,
      OUT results a{sv}
    )

Presents a list of applications to the user to choose one.

Supported keys in the `options` vardict include:

- `last_choice` (`s`)

  The app id that was selected the last time.

- `modal` (`b`)

  Whether to make the dialog modal. Defaults to yes.

- `content_type` (`s`)

  The content type to choose an application for.

- `uri` (`s`)

  The uri to choose an application for.

- `filename` (`s`)

  The filename to choose an application for. Note that this is just a basename, without a path.

- `activation_token` (`s`)

  A token that can be used to activate the application chooser.

  The activation_token option was introduced in version 2 of the interface.

The following results get returned via the `results` vardict:

- `choice` (`s`)

  The app id that was selected.

- `activation_token` (`s`)

  A token that can be used to activate the chosen application. If the application selection has involved user interaction, a new token should be generated by the portal implementation. Otherwise, this token may be the same as the one passed in `options`.

  The activation_token option was introduced in version 2 of the interface.

handle

  Object path to export the Request object at

app_id

  App id of the application

parent_window

  Identifier for the application window, see Window Identifiers

choices

  App ids of applications to let the user choose from

options

  Vardict with optional further information

response

  Numeric response

results

  Vardict with the results of the call

### org.freedesktop.impl.portal.AppChooser.UpdateChoices

    UpdateChoices (
      IN handle o,
      IN choices as
    )

This method can be called between the time of a ChooseApplication call and receiving the Response signal, to update the list of applications that are offered by the backend.

handle

  the request handle

choices

  App ids of applications to let the user choose from