Access

Description

Interface for presenting an access dialog

This backend can be used by portal implementations that need to ask a direct access question, such as “May xyz use the microphone?”

Methods

org.freedesktop.impl.portal.Access.AccessDialog

AccessDialog (
  IN handle o,
  IN app_id s,
  IN parent_window s,
  IN title s,
  IN subtitle s,
  IN body s,
  IN options a{sv},
  OUT response u,
  OUT results a{sv}
)

Presents a “deny/grant” question to the user.

Supported keys in the options include:

• modal (b)

  Whether to make the dialog modal. Defaults to true.

• deny_label (s)

  Label for the Deny button.

• grant_label (s)

  Label for the Grant button.

• icon (s)

  Icon name for an icon to show in the dialog. This should be a symbolic icon name.

• choices (a(ssa(ss)s))

  List of serialized choices. See org.freedesktop.portal.FileChooser.OpenFile for details.

The following results get returned via the results vardict:

• choices (a(ss))

  An array of pairs of strings, corresponding to the passed-in choices. See org.freedesktop.portal.FileChooser.OpenFile for details.

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

title

Title for the dialog

subtitle

Subtitle for the dialog

body

Body text, may be “”

options

Vardict with optional further information

response

Numeric response. The values allowed match the values allowed for org.freedesktop.portal.Request::Response signal.

results

Vardict with the results of the call