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