User manual - Scripting_Guide

NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC
CETerm Scripting Guide Page 24
Multiple tone specifications can be concatenated.
PlayTone( volume, frequency, duration ) (deprecated)
Play a tone if supported by the handheld hardware. This method is provided for
backward compatibility within the web browser. New application should use
OS.Playtone() which provides the same functionality.
volume – is the volume 00 -10 (0 is off, 10 is loudest)
frequency – is the frequency in Hz.
duration – is the duration in milliseconds.
PostIDA( IDASymbolicName, session )
PostIDA submits an IDA action command and directs it to the specified session.
Valid session values are 1-4. The special session value of 0 will send the
command to the current session. Some IDA commands act at a global level and
ignore the session variable. See Appendix 1 for IDA Symbolic Names.
The PostIDA command will return before the action executes. In general, the
IDA action will not be applied until after the current script execution ends. We
recommend using PostIDA rather than SendIDA. There are only rare situations
when SendIDA must be used.
status = RunScript( script )
Run the specified script in the CETerm engine. This method must only be used
when the CETerm object is referenced from the web browser script engine. In
general, it is better to use PostIDA with an IDA_SCRIPT_xx action to run a pre-
defined script from the web browser. To execute a script contained in a string
from the CETerm engine use the JavaScript “eval()” method.
SendIDA( IDASymbolicName, session )
SendIDA sends an IDA action command and directs it to the specified session.
Valid session values are 1-4. The special session value of 0 will send the
command to the current session. See Appendix 1 for IDA Symbolic Names.
The SendIDA method will attempt to complete the action before returning. We
recommend using PostIDA rather than SendIDA. There are only rare situations
when SendIDA must be used. For example, SendIDA will be needed if you
need to invoke IBM field actions, such as Field Exit, between sending text to an
IBM session with SendText.