Gcr.SystemPrompt
Description: Reference for Gcr.SystemPrompt

### Class

# GcrSystemPrompt

#### Description [src]

    class Gcr.SystemPrompt : GObject.Object {
      parent: GObject
    }

A `GcrPrompt` implementation which calls to the system prompter to display prompts in a system modal fashion.

Since the system prompter usually only displays one prompt at a time, you may have to wait for the prompt to be displayed. Use `gcr_system_prompt_open()` or a related function to open a prompt. Since this can take a long time, you should always check that the prompt is still needed after it is opened. A previous prompt may have already provided the information needed and you may no longer need to prompt.

Use `gcr_system_prompt_close()` to close the prompt when you’re done with it.

#### Hierarchy

#### Ancestors

- GObject

#### Implements

- GcrPrompt
- GAsyncInitable
- GInitable

#### Functions

###### gcr_system_prompt_error_get_domain

No description available.

###### gcr_system_prompt_open

Opens a system prompt with the default prompter.

###### gcr_system_prompt_open_async

Asynchronously open a system prompt with the default system prompter.

###### gcr_system_prompt_open_finish

Complete an operation to asynchronously open a system prompt.

###### gcr_system_prompt_open_for_prompter

Opens a system prompt. If prompter_name is `NULL`, then the default system prompter is used.

###### gcr_system_prompt_open_for_prompter_async

Opens a system prompt asynchronously. If prompter_name is `NULL`, then the default system prompter is used.

#### Instance methods

###### gcr_system_prompt_close

Close this prompt. After calling this function, no further prompts will succeed on this object. The prompt object is not unreferenced by this function, and you must unreference it once done.

###### gcr_system_prompt_close_async

Close this prompt asynchronously. After calling this function, no further methods may be called on this object. The prompt object is not unreferenced by this function, and you must unreference it once done.

###### gcr_system_prompt_close_finish

Complete operation to close this prompt.

###### gcr_system_prompt_get_secret_exchange

Get the current `GcrSecretExchange` used to transfer secrets in this prompt.

##### Methods inherited from GObject (43)

Please see GObject for a full list of methods.

##### Methods inherited from GcrPrompt (31)

Please see GcrPrompt for a full list of methods.

##### Methods inherited from GAsyncInitable (3)

###### g_async_initable_init_async

Starts asynchronous initialization of the object implementing the interface. This must be done before any real use of the object after initial construction. If the object also implements `GInitable` you can optionally call `g_initable_init()` instead.

Available since: 2.22

###### g_async_initable_init_finish

Finishes asynchronous initialization and returns the result. See g_async_initable_init_async().

Available since: 2.22

###### g_async_initable_new_finish

Finishes the async construction for the various g_async_initable_new calls, returning the created object or `NULL` on error.

Available since: 2.22

##### Methods inherited from GInitable (1)

###### g_initable_init

Initializes the object implementing the interface.

Available since: 2.22

#### Properties

###### Gcr.SystemPrompt:bus-name

The DBus bus name of the prompter to use for prompting, or `NULL` for the default prompter.

###### Gcr.SystemPrompt:secret-exchange

The `GcrSecretExchange` to use when transferring passwords. A default secret exchange will be used if this is not set.

###### Gcr.SystemPrompt:timeout-seconds

The timeout in seconds to wait when opening the prompt.

##### Properties inherited from GcrPrompt (11)

###### Gcr.Prompt:caller-window

The string handle of the caller’s window.

###### Gcr.Prompt:cancel-label

The label for the cancel button in the prompt.

###### Gcr.Prompt:choice-chosen

Whether the additional choice is chosen or not.

###### Gcr.Prompt:choice-label

The label for the additional choice.

###### Gcr.Prompt:continue-label

The label for the continue button in the prompt.

###### Gcr.Prompt:description

The detailed description of the prompt.

###### Gcr.Prompt:message

The prompt message for the user.

###### Gcr.Prompt:password-new

Whether the prompt will prompt for a new password.

###### Gcr.Prompt:password-strength

Indication of the password strength.

###### Gcr.Prompt:title

The title of the prompt.

###### Gcr.Prompt:warning

A prompt warning displayed on the prompt, or `NULL` for no warning.

#### Signals

##### Signals inherited from GObject (1)

###### GObject.Object::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

##### Signals inherited from GcrPrompt (1)

###### Gcr.Prompt::prompt-close

Action signal fired when the prompt is to be closed. After the default handler has run, the prompt is closed. The various prompting methods will return results as if the user dismissed the prompt.

#### Class structure

    struct GcrSystemPromptClass {
      GObjectClass parent_class;

    }

###### Class members

`parent_class` |
    GObjectClass
| No description available.