Difference between revisions of "AskMsgText"
(copied description) |
|||
Line 10: | Line 10: | ||
= Description = | = Description = | ||
− | Shows a message box with specified title, question and a textbox containing the default text, if any, and allowing up to maxText characters. It returns the text entered by the user into the text box, or the default if none. | + | Shows a message box with specified title, question and a textbox containing the default text, if any, and allowing up to maxText characters (or up to the number of characters in default, if that is greater). It returns the text entered by the user into the text box, or the default if none. |
+ | |||
+ | The message box appears only when this function is evaluated. Since Analytica caches results once they are computed, if you embed this in a variable, you will not see the question every time you view the result. To trigger the question again, you must change something upstream that the variable depends on, so the result is invalidated. If you place it inside a button script, you would see it everytime the button is pressed. | ||
+ | |||
+ | The box displays [OK] and [Cancel] buttons. Pressing Cancel causes the current computation to abort. |
Revision as of 09:14, 9 February 2007
(not documented prior to 4.0, but present in 3.1)
Declaration
AskMsgText(question : atomic Text; title : optional atomic text; maxText : optional positive ; default : optional atomic text)
Description
Shows a message box with specified title, question and a textbox containing the default text, if any, and allowing up to maxText characters (or up to the number of characters in default, if that is greater). It returns the text entered by the user into the text box, or the default if none.
The message box appears only when this function is evaluated. Since Analytica caches results once they are computed, if you embed this in a variable, you will not see the question every time you view the result. To trigger the question again, you must change something upstream that the variable depends on, so the result is invalidated. If you place it inside a button script, you would see it everytime the button is pressed.
The box displays [OK] and [Cancel] buttons. Pressing Cancel causes the current computation to abort.
Enable comment auto-refresher