  |
GoFiler Legato Script Reference
Legato v 1.6b Application v 6.0c
|
| Table of Contents | < < Previous | Next >> |
Chapter Five — General Functions (continued)
Overview
The PasswordBox function displays a query for a passcode with an optional title and description.
Syntax/Parameters
Syntax
string = PasscodeBox ( [string title], [string description] );
Parameters
title
An optional string specifying the title of the passcode box to a maximum of 255 characters. If the string is empty, the default title is used.
description
An optional string specifying a description to be displayed in the top of the box to a maximum of 512. If omitted, this area of the dialog is collapsed.
Return Value
A string containing the passcode entered by the user or empty on failure. Use the GetLastError function to retrieve a formatted error code. The most typical error is ERROR_CANCEL.
Remarks
The dialog does not store or validate the passcode except that a passcode is required to continue.
While the title and description parameters are limited in number of characters, they are also limited in the available display size. The description is limited to displaying two lines of text. Return and other control characters are not allowed.
An example of the default operation:
Proper security precautions should be employed when storing and using passwords. This function abides by the Secure Memory Model.
The passcode dialog is essentially the same as the password dialog except for the name of the field.
Related Functions
Platform Support
GoFiler Complete
Legato IDE, Legato Basic
Page revised 2025-04-28
| Table of Contents | < < Previous | Next >> |
© 2012-2025 Novaworks, LLC. All rights reserved worldwide. Unauthorized use, duplication or transmission prohibited by law. Portions of the software are protected by US Patents 10,095,672, 10,706,221 and 11,210,456. Novaworks, GoFiler™ and Legato™ are registered trademarks of Novaworks, LLC. EDGAR® is a federally registered trademark of the U.S. Securities and Exchange Commission. Novaworks is not affiliated with or approved by the U.S. Securities and Exchange Commission. All other trademarks are property of their respective owners. Use of the features specified in this language are subject to terms, conditions and limitations of the Software License Agreement.