Equinox Online Help - Language Reference - A to Z

Home

InputPassword

Applies to
SyntaxInputPassword(MessageExpression, [SwitchExpression])
Action[Function] Prompts you to input data into a Password dialog.
ScopeUsable anywhere.
Notes

This function works in the same way as the Input function. The only difference is that you type data into a Password dialog instead of a standard Input dialog. When you type into a Password dialog, the text appears on screen as asterisk characters. You use a Password dialog to enter your password, when you login to Equinox.

This facility is useful if you want the user to enter secure information into the system, or set up your own customised security system.

This function sets the SysReply system workarea:

  • 0 Value returned (as normal)
  • -1 User pressed the Escape key, or chose the Cancel button
  • -2 No response (timeout error)
  • -3 Undefined error
  • CategoryUser dialogs
    See Also Alert, AlertBitmaps, AlertButtons, Beep, Edit, HelpAbout, Input, Message, PopupColour_PopupColor, PopupFlags, PopupFont, PopupJustification, PopupSize, PopupTitle, StatusLine
    Example

    This method requests a password from the user. The correct password is stored in the Masterkey workarea. The user is allowed three attempts at the password. If it is not entered correctly, the system is closed down.

    number i

    block
    for i = 1 to 3
    if (InputPassword("Master password") = Masterkey) then
    exit block
    end if
    Next

    Exit Application
    end block