User Guide

30 Chapter 5: New FSCommand and FSCommand2 commands
Unescape
The
Unescape function decodes an arbitrary encoded string that is safe for network transfer into
its normal form. All characters that are in hexadecimal format, that is, a percent character (%)
followed by two hexadecimal digits, are converted into their decoded form. The decoded string is
returned in a variable that is passed in by name.
This function is executed immediately upon invocation.
Syntax
status = FSCommand2( "Unescape", original, encoded )
In this example, original is the string to be decoded from a format safe for network transfer and
encoded is the resulting decoded string.
Return value
A value of 0 upon failure; 1 upon success.
Example
original_string = "hello, how are you?";
status = fscommand2("Escape", original_string, "encoded_string");
original_string2 = "Hello%7B%5BWorld%5D%7D";
status = fscommand2("Unescape", original_string2, "normal_string");
Input text fields
The commands in this section control the input text fields of Flash content on mobile phones.
SetInputTextType()
In Flash Lite, input text functionality is supported by asking the host application to start the
generic, device-specific, text-input interface, often referred to as the Front End Processor (FEP).
The
SetInputTextType() function specifies the mode in which the input text field should be
opened. The available options are
Numeric, Alpha, Alphanumeric, Latin, NonLatin and
NoRestriction.
These options are mutually exclusive and cannot be combined. When this command is not used,
the FEP is opened in default mode. The following rules apply when the following text-input
interface options are not supported on certain mobile phones:
• If Numeric mode is not supported, the FEP is opened in Alphanumeric mode.
• If Alpha mode is not supported, the FEP is opened in Alphanumeric mode.
• If Alphanumeric mode is not supported the FEP is opened in Latin mode.
• If Latin mode is not supported, the FEP is opened in NoRestriction mode.
Similarly, if
NonLatin mode is not supported, the FEP is opened in NoRestriction mode.
Note: Not all mobile phones support these input text field types. For this reason, you must validate
the input text data.
The SetInputTextType() function is executed immediately upon invocation.