Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5d

Application v 5.25a

  

 

Chapter FiveGeneral Functions (continued)

YesNoRememberBox Function

Overview

The YesNoRememberBox function displays a message box with the “Yes” and “No” buttons or queries via the default console. A question icon is used with an option to remember the setting selected.

Syntax/Parameters

Syntax

int = YesNoRememberBox ( string message, [parameters ... ] );

Parameters

message

A string to display. If additional parameters are present, message is considered a formatted string. See Section 5.2 String Functions for more information on formatted strings.

parameters

Zero or more parameters to be formatted and inserted into message. If no parameters are supplied, message is simply passed through to the result string.

Return Value

Returns an int containing a formatted error code or a standard Windows ID code: IDCANCEL, IDYES or IDNO. Use the GetLastError function to retrieve the condition of the ‘remember’ option. The id will be placed in the last error if the “Remember Choice” check box is set. Cancel is never remembered.

Remarks

Do not call the YesNoRememberBox function from background threads or the command line; it returns automatically without displaying the dialog. The YesNoRememberBox function supports a maximum of 4096 characters.

The YesNoRememberBox function permits the usage of a formatted string to display information. Formatted strings allow numeric and other data to be formatted into a string for appropriate display. The format of the string and the data to be inserted depend upon the structure of the message parameter and the contents of the additional parameters passed to the function. For more information on formatted strings, see Formatted Strings in Section 5.2 String Functions.

Message boxes with a query cannot be opened by scripts running in the background.

This function does not support the detail and ID as set by the SetMessageBoxDetail function.

Related Functions

Platform Support

Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL

Legato IDE, Legato Basic