Macromedia flash mx professional 2004-macromedia flash lite 1.1 authoring guidelines Benutzerhandbuch

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:

•

Numeric

mode is not supported, the FEP is opened in

Alphanumeric

mode.

•

Alpha

mode is not supported, the FEP is opened in

Alphanumeric

mode.

•

Alphanumeric

mode is not supported the FEP is opened in

Latin

mode.

•

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.