password_run
Description:
Prompts for password.
Set the various properties on the prompt before calling this method to explain which password should be entered.
This method will block until the a response is returned from the prompter and will run a main loop similar to a gtk_dialog_run
.
The application will remain responsive but care must be taken to handle reentrancy issues.
A password will be returned if the user enters a password successfully. The returned password is valid until the next time a method is called to display another prompt.
null will be returned if the user cancels or if an error occurs. Check the throws argument to tell the difference.
Parameters:
this |
a prompt |
cancellable |
optional cancellation object |
Returns:
the password owned by the prompt, or null |