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.
Functions
gcr_system_prompt_error_get_domain
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 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)
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.