SetSoftKeys

Availability

Flash Lite 1.1.

Description

Remaps the Left and Right soft keys of the device, provided that they can be accessed and remapped.

After this command is executed, pressing the left key generates a PageUp keypress event, and pressing the right key generates a PageDown keypress event. ActionScript associated with the PageUp and PageDown keypress events is executed when the respective key is pressed.

This command is supported only when Flash Lite is running in stand-alone mode. It is not supported when the player is running in the context of another application (for example, as a plug-in to a browser).

Command

Parameters

Value returned

"SetSoftKeys"

left  Text to be displayed for the Left soft key.

right  Text to be displayed for the Right soft key.

These parameters are either names of variables or constant string values (for example, "Previous").

-1: Not supported.

0: Supported.

Example

The following example directs that the Left soft key be labeled Previous and the Right soft key be labeled Next:

status = fscommand2("SetSoftKeys", "Previous", "Next");

See also

ResetSoftKeys