MACROMEDIA FLASH 8-INTRODUCTION TO FLASH LITE 2.X... Reference manual

Introduction to Flash Lite 2.x ActionScript

Trademarks

1 Step RoboPDF, ActiveEdit, ActiveTest, Authorware, Blue Sky Software, Blue Sky, Breeze, Breezo, Captivate, Central,

ColdFusion, Contribute, Database Explorer, Director, Dreamweaver, Fireworks, Flash, FlashCast, FlashHelp, Flash Lite,

FlashPaper, Flash Video Endocer, Flex, Flex Builder, Fontographer, FreeHand, Generator, HomeSite, JRun, MacRecorder,

Macromedia, MXML, RoboEngine, RoboHelp, RoboInfo, RoboPDF, Roundtrip, Roundtrip HTML, Shockwave, SoundEdit,

Studio MX, UltraDev, and WebHelp are either registered trademarks or trademarks of Adobe Systems Incorporated and may be

registered in the United States or in other jurisdictions including internationally. Other product names, logos, designs, titles,

words, or phrases mentioned within this publication may be trademarks, service marks, or trade names of Adobe Systems

Incorporated or other entities and may be registered in certain jurisdictions including internationally.

Third-Party Information

This guide contains links to third-party websites that are not under the control of Adobe Systems Incorporated, and Adobe

Systems Incorporated is not responsible for the content on any linked site. If you access a third-party website mentioned in this

guide, then you do so at your own risk. Adobe Systems Incorporated provides these links only as a convenience, and the inclusion

of the link does not imply that Adobe Systems Incorporated endorses or accepts any responsibility for the content on those third-

party sites.

Sorenson™ Spark™ video compression and decompression technology licensed from

Sorenson Media, Inc.

Fraunhofer-IIS/Thomson Multimedia: MPEG Layer-3 audio compression technology licensed by Fraunhofer IIS and Thomson

Multimedia (http://www.iis.fhg.de/amm/)

Independent JPEG Group: This software is based in part on the work of the Independent JPEG Group.

Nellymoser, Inc.: Speech compression and decompression technology licensed by Nellymoser, Inc. (http:www.nellymoser.com).

Reserved. http://www.on2.com.

Visual SourceSafe is a registered trademark or trademark of Microsoft Corporation in the United States and/or other countries.

reproduced, translated, or converted to any electronic or machine-readable form in whole or in part without written

approval from Adobe Systems Incorporated. Notwithstanding the foregoing, the owner or authorized user of a valid copy

of the software with which this manual was provided may print out one copy of this manual from an electronic version of

this manual for the sole purpose of such owner or authorized user learning to use such software, provided that no part of

this manual may be printed out, reproduced, distributed, resold, or transmitted for any other purposes, including,

without limitation, commercial purposes, such as selling copies of this documentation or providing paid-for support

services.

Acknowledgments

Project Management: Mary Leigh Burke

Writing: Tim Statler

Managing Editor: Rosana Francescato

Editing: Linda Adler, Geta Carson, Mary Ferguson, Mary Kraemer

Production Management: Adam Barnett, Kristin Conradi

Localization: Luciano Arruda and Masayo Noda

Media Design and Production: Yuriko Ando, Aaron Begley, Paul Benkman. John Francis, Geeta Karmarkar, Paul Rangel,

Arena Reed, Mario Reynoso

Special thanks to Lisa Friendly, Bonnie Loo, Erick Vera, the beta testers, and the entire Flash Lite engineering and QA teams.

First Edition: January 2006

Adobe Systems Incorporated

601 Townsend St.

San Francisco, CA 94103

Contents

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Guide to instructional media. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Additional resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Typographical conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Chapter 1: Unsupported and Partially Supported ActionScript

Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Commands issued through fsCommand and fsCommand2. . . . . . . . . . 7

Commands partially supported or unsupported by fsCommand . . . . . . 8

Partially supported global properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Chapter 2: Unsupported and Partially Supported Classes . . . . . .11

Button class. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

Date class. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Key class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Mouse class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Event summary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

MovieClip class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

SharedObject class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

System class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

capabilities (System.capabilities) class . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Sound class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Stage class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

TextField class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

TextFormat class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Video class. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Introduction

Macromedia Flash Lite 1.0 and Flash Lite 1.1, the first versions of Flash Lite, are based on

Macromedia Flash Player 4. Flash Lite 2.0 is based on Flash Player 7, but differs from it in the

following respects:

■It does not support ActionScript 2.0 (as used with Flash Player 7 for Flash desktop

applications).

■It supports some features only partially.

■It adds some features specifically for mobile devices.

This document describes the differences between the ActionScript supported for Flash Lite

2.0 and the ActionScript that was supported for Flash Player 7. Wherever applicable, this

document includes cross-references to the following documents that provide additional details

about the various classes and how to use them when writing Flash Lite 2.0 applications:

■Flash Lite 2.x ActionScript Language Reference

■Developing Flash Lite 2.x Applications

■Learning ActionScript 2.0 in Flash

Guide to instructional media

The Flash Lite documentation package includes the following media to help you learn how to

create Flash Lite applications:

■Getting Started with Flash Lite 2.x provides an overview of Flash Lite technology and

developing Flash Lite 2.0 content for mobile devices. It also includes a step-by-step

tutorial for creating a Flash Lite 2.0 application.

■Developing Flash Lite 2.x Applications is a comprehensive guide to creating Flash Lite

content and includes instructions for testing your applications in the integrated Flash Lite

emulator.

■Flash Lite 2.x ActionScript Language Reference describes all the ActionScript language

features available to Flash Lite developers and provides example code.

6Introduction

■Learning ActionScript 2.0 in Flash describes how to write ActionScript for Flash Player 7.

Cross references in Introduction to Flash Lite 2.x ActionScript detail the sections of Learning

ActionScript 2.0 in Flash that apply to Flash Lite.

■The Flash Lite sample applications demonstrate key concepts and best practices discussed

or mentioned in the written documentation.

Additional resources

For the latest information on developing Flash Lite applications, plus advice from expert

users, advanced topics, examples, tips, and other updates, see the Mobile and Devices

Developer Center at www.macromedia.com/devnet/devices/.

For TechNotes, documentation updates, and links to additional resources in the Flash Lite

developer community, see the Macromedia Flash Lite Support Center at

www.macromedia.com/support/flashlite/.

Typographical conventions

The following typographical conventions are used in this manual:

■Italic font indicates a value that should be replaced (for example, in a folder path).

■Code font indicates ActionScript code.

■Code font italic indicates an ActionScript parameter.

■Bold font indicates a verbatim entry.

■Double quotation marks ("") in code examples indicate delimited strings. However,

programmers can also use single quotation marks (').

CHAPTER 1

Unsupported and Partially

Supported ActionScript Elements

This chapter describes the global functions and properties, constants, operators, statements,

extensions, and keywords that are either partially supported or not supported by ActionScript

for Flash Lite 2.0.

Commands issued through fsCommand and fsCommand2. . . . . . . . . . . . . . . . . . . . . 7

Commands partially supported or unsupported by fsCommand . . . . . . . . . . . . . . . . . 8

Partially supported global properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Commands issued through fsCommand

and fsCommand2

The fsCommand() and fsCommand2() global functions let the SWF file communicate with

either Flash Player or the program that is hosting Flash Player, such as a web browser.

Flash Lite 2.0 modifies the standard Flash Player 7 commands, and adds commands that are

specific to embedded devices. Flash Lite 2.0 also supports the fsCommand2() function, which

provides similar functionality to fsCommand(), with the exception that the command is

executed immediately, not deferred until after the calling frame is processed.

For more information on the fsCommand2() function, see the Flash Lite 2.x ActionScript

Language Reference.

8 Unsupported and Partially Supported ActionScript Elements

Commands unsupported and partially supported by

fsCommand

The following table lists the commands that are unsupported by fsCommand() when using

ActionScript 2.0 to create Flash Lite content.

Commands partially supported or

unsupported by fsCommand

The following table lists the ActionScript commands, functions, and keywords that are either

partially or not supported by Flash Lite 2.0.

Command Description

quit Closes the projector.

fullscreen Specifying true sets Flash Player to full-screen mode.

Specifying false returns the player to normal menu view.

allowscale Specifying false sets the player so the SWF file is always drawn

at its original size and is never scaled. Specifying true forces the

SWF file to scale to 100% of the screen.

showmenu Specifying true enables the full set of context menu items.

Specifying false hides all the context menu items except About

Flash Player and Settings.

exec Executes an application from within the projector.

trapallkeys Specifying true sends all key events, including accelerator keys,

to the onClipEvent(keyDown/keyUp) handler in Flash Player.

Command, function,

or keyword

Description Support

asfunction A protocol for URLs in HTML text fields. Not supported

fscommand() Function that lets the SWF file communicate

with either Flash Player or the program hosting

Flash Player, such as a web browser.

Partially

supported

on Prefix for events to execute when the event

occurs.

Limitation: The supported events are rollout,

rollover, and keyPress.

Partially

supported

Commands partially supported or unsupported by fsCommand 9

onClipEvent Event handler; triggers actions defined for a

specific instance of a movie clip.

Limitations: Supported events are press, load,

unload, enterFrame, keyDown, keyup, and data.

The mouseDown, mouseUp, and mouseMove events

are supported if either

System.capabilities.hasMouse or

System.capabilities.hasStylus are set to true.

Partially

supported

onUpdate The onUpdate event handler is defined for a live

preview used with a component.

Not supported

print() The print() function targets the movie clip

according to the boundaries specified in the

parameter.

Not supported

printAsBitmap() A function that prints the target movie clip as a

bitmap.

Not supported

printAsBitmaNum() A function that prints a level in Flash Player as a

bitmap according to the boundaries specified in

the parameter (bmovie, bmax, or bframe).

Not supported

printNum() A function that prints the level in Flash Player

according to the boundaries specified in the

boundingBox parameter (bmovie, bmax, or bframe).

Not supported

startDrag() A function that makes the target movie clip

draggable while the SWF is playing. Only one

movie clip can be dragged at a time.

Limitation: Supported if mouse or stylus

interface is supported.

Partially

supported

stopDrag() A function that stops the current drag operation.

Limitation:Supported if mouse or stylus

interface is supported.

Partially

supported

updateAfterEvent() A function that updates the display

(independent of the frames per second set for

the SWF file) when you call it in an

onClipEvent() handler or as part of a function or

method that you pass to setInterval().

Not supported

Command, function,

or keyword

Description Support

10 Unsupported and Partially Supported ActionScript Elements

Partially supported global properties

The following table lists the ActionScript global properties that are partially supported by

Flash Lite 2.0.

Properties Description Support

_droptarget Read-only property that returns the absolute path in

slash (/) syntax notation of the movie clip instance on

which the draggableInstanceName (the name of a movie

clip instance that was the target of a startDrag()

function was dropped. This property always returns a

path that starts with a slash (/).

Partially

supported

_highquality Global property that specifies the level of anti-aliasing

applied to the current SWF file. This property can also

control bitmap smoothing.

Limitation: Flash Lite does not support bitmap

smoothing.

Partially

supported

_url Read-only property that retrieves the URL of the SWF

file from which the movie clip was downloaded.

Partially

supported

This manual suits for next models

Table of contents

Other MACROMEDIA Software manuals

MACROMEDIA

MACROMEDIA DREAMWEAVER MX 2004-EXTENDING DREAMWEAVER User manual

MACROMEDIA

MACROMEDIA COLDFUSION MX 61 - CONFIGURING AND ADMINISTERING COLDFUSION... User manual

MACROMEDIA

MACROMEDIA FLASHLITE2 ACTIONSCRIPT-LANGUAGE Service manual

MACROMEDIA

MACROMEDIA FIREWORKS 2-USING FIREWORKS Mounting instructions

MACROMEDIA

MACROMEDIA FLEX-GETTING STARTED WITH FLEX User manual

MACROMEDIA

MACROMEDIA BREEZE-USING THE MACROMEDIA BREEZE MANAGER Mounting instructions

MACROMEDIA

MACROMEDIA DREAMWEAVER MX 2004-DREAMWEAVER API Service manual

MACROMEDIA

MACROMEDIA FLASH 8-GETTING STARTED WITH FLASH LITE User manual

MACROMEDIA

MACROMEDIA FLASH 8-USING FLASH Mounting instructions

MACROMEDIA

MACROMEDIA FLASH MX 2004-FLASH JAVASCRIPT DICTIONARY User manual

MACROMEDIA

MACROMEDIA FREEHAND 10-USING FREEHAND Mounting instructions

MACROMEDIA

MACROMEDIA HOMESITE Installation and operating instructions

MACROMEDIA

MACROMEDIA FLASH MX 2004-FLASH JAVASCRIPT DICTIONARY User manual

MACROMEDIA

MACROMEDIA CONTRIBUTE 3 - USING AND ADMINISTERING... Mounting instructions

MACROMEDIA

MACROMEDIA DIRECTOR MX 2004-USING DIRECTOR Mounting instructions

MACROMEDIA

MACROMEDIA COLFUSION MX 7-CFML Service manual

MACROMEDIA

MACROMEDIA FLASH 8-COMPONENTS LANGUAGE Service manual

MACROMEDIA

MACROMEDIA DIRECTOR MX-USING DIRECTOR MX Mounting instructions

MACROMEDIA

MACROMEDIA COLDFUSION 5 - INSTALING AND CONFIGURING... User manual

MACROMEDIA

MACROMEDIA COLDFUSION STUDIO 4.5-USING COLDFUSION... Mounting instructions

MACROMEDIA

MACROMEDIA FREEHAND MX 11 Mounting instructions

MACROMEDIA

MACROMEDIA BREEZE-MANAGING EXTERNAL BREEZE REPORTS User manual

MACROMEDIA

MACROMEDIA BREEZE-SECURITY User manual

MACROMEDIA

MACROMEDIA FLASH MEDIA SERVER 2-CLIENT-SIDE ACTIONSCRIPT LANGUAGE REFERENCE FOR FLASH MEDIA SERVER... Service manual

Popular Software manuals by other brands

COMPRO

COMPRO COMPROFM manual

Muratec

Muratec OFFICEBRIDGE ONLINE user guide

Oracle

Oracle Contact Center Anywhere 8.1 installation guide

Adobe

Adobe 65007312 - Photoshop Lightroom Programmer's guide

Avaya

Avaya NULL One-X for RIM Blackberry user guide

HP ProLiant BL420c user guide

PS Audio

PS Audio PowerPlay Programming manual

Brady

Brady LOCKOUT PRO 3.0 Administrator's guide

Avaya

Avaya Interaction Center user guide

Texas Instruments

Texas Instruments TI-83 Plus Silver Edition Guide book

Novell

Novell GROUPWISE 8 - INTERNET AGENT manual

Oracle

Oracle Application 9i Configuration guide

Acer

Acer RDM user guide

Canon

Canon Vixia HF21 instruction manual

Canon

Canon ZR950 instruction manual

Samsung

Samsung Auto Backup user manual

Polycom

Polycom Vortex EF2201 Application note

Brocade Communications Systems

Brocade Communications Systems Brocade 8/12c user manual