GUI.PasswordQuery

Shows a dialog that lets a user input text, but with a password mask for the input box.

Syntax

function GUI.PasswordQuery(Caption, Prompt: string; var Value: string): boolean

Alternative Names

Description

Shows a dialog with an OK and CANCEL button, synchronized with the main thread and halts execution until the user closes it. You can modify the caption and prompt for user input.

Caption is the text in the dialog title.

Prompt holds a message about the input required.

The variable Value holds the entered text when the user clicks OK. If the variable has a value before showing the dialog, this text is put into the input box.

The Return Value is TRUE when the user clicks OK, FALSE otherwise.

See also

Example

execute UDSBlock returns (str_value varchar(100))

as

begin
  str_value = '';

  if GUI.PasswordQuery('Database Login', 'Enter SYSDBA password', str_value)

  then GUI.ShowMessage('Your password is "' || str_value || '"');

  suspend;

end