|
This verb opens a new window to run the dialog. The window stays around while you're running Frontier and the callback routine gains control when you click on a button.
The callback script must accept a single parameter that is the number of the item hit. It should return false to dismiss the dialog, true continue accepting user input.
Before the dialog is displayed and user input is accepted, the callback script is called with the special item value -1, to allow it to initialize the dialog's items as appropriate.
If the user clicks in the dialog window's close box, the callback script is called with the special item value -2, to allow it to perform any final actions. In this one case, the value returned by the callback is ignored.
The callback script can call clock.sleepFor to request that it be called again in a specified period, if no user input is received. The script will be called with the special item value -3 to indicate that that the user didn't select an item.
If a dialog with the same resnum is already running from another script, executing this verb brings that dialog to the front and returns true, but itemhitcallback is not called.
|