MACROMEDIA FLASH 8-INTRODUCTION TO FLASH LITE 2.X... Manual de referencia

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

Este manual sirve para los siguientes modelos

Tabla de contenidos

Otros manuales de Software de MACROMEDIA

MACROMEDIA

MACROMEDIA FLASH MEDIA SERVER 2-DEVELOPING MEDIA Manual de usuario

MACROMEDIA

MACROMEDIA BREEZE-CLUSTERING BREEZE PRESENTATION... Manual de usuario

MACROMEDIA

MACROMEDIA BREEZE 5 Manual de usuario

MACROMEDIA

MACROMEDIA BREEZE-MANAGING EXTERNAL BREEZE REPORTS Manual de usuario

MACROMEDIA

MACROMEDIA BREEZE-FOR MEETING PRESENTERS Manual de usuario

MACROMEDIA

MACROMEDIA CONTRIBUTE 3-DEPLOYING CONTRIBUTE Manual de usuario

MACROMEDIA

MACROMEDIA FLASH 8-LEARNING FLASH LITE 1.X ACTIONSCRIPT Manual de usuario

MACROMEDIA

MACROMEDIA FLASH 8-COMPONENTS LANGUAGE Manual de servicio

MACROMEDIA

MACROMEDIA DRUMBEAT 2000 ECOMMERCE EDITION Manual de usuario

MACROMEDIA

MACROMEDIA BREEZE-FOR MEETING PARTICIPANTS Manual de usuario

MACROMEDIA

MACROMEDIA BREEZE Manual de usuario

MACROMEDIA

MACROMEDIA DIRECTOR MX-USING DIRECTOR MX Instrucciones de montaje

MACROMEDIA

MACROMEDIA BREEZE 5 Manual del operador

MACROMEDIA

MACROMEDIA FLASH MX 2004-DATA Instrucciones de operación

MACROMEDIA

MACROMEDIA COLDFUSION STUDIO 5-USING COLDFUSION 5... Instrucciones de montaje

MACROMEDIA

MACROMEDIA FLASH REMOTING MX-USING FLASH REMOTING FOR FLASH MX 2004 ACTIONSCRIPT... Instrucciones de montaje

MACROMEDIA

MACROMEDIA DREAMWEAVER MX 2004-DREAMWEAVER API Manual de servicio

MACROMEDIA

MACROMEDIA FLASH MX 2004 - FLASH LITE AUTHORING GUIDELINES FOR THE I-MODE... Manual de instrucciones

MACROMEDIA

MACROMEDIA FLASHLITE2 ACTIONSCRIPT-LANGUAGE Manual de servicio

MACROMEDIA

MACROMEDIA FLEX - DEVELOPING COMPONENTS AND THEMES Manual de usuario

MACROMEDIA

MACROMEDIA COLDFUSION MX 61 - CONFIGURING AND ADMINISTERING COLDFUSION... Guía

MACROMEDIA

MACROMEDIA DREAMWEAVER 8-DREAMWEAVER API Manual de servicio

MACROMEDIA

MACROMEDIA HOMESITE Instrucciones de instalación y funcionamiento

MACROMEDIA

MACROMEDIA COLDFUSION MX 7.0.2-USING COLDFUSION MX WITH FLEX... Instrucciones de montaje

Manuales populares de Software de otras marcas

COMPRO

COMPRO COMPROFM Manual de usuario

Muratec

Muratec OFFICEBRIDGE ONLINE Manual de usuario

Oracle

Oracle Contact Center Anywhere 8.1 Manual de usuario

Adobe

Adobe 65007312 - Photoshop Lightroom Manual

Avaya

Avaya NULL One-X for RIM Blackberry Manual de usuario

HP ProLiant BL420c Manual de usuario

PS Audio

PS Audio PowerPlay Manual del propietario

Brady

Brady LOCKOUT PRO 3.0 Manual de servicio

Avaya

Avaya Interaction Center Manual de usuario

Texas Instruments

Texas Instruments TI-83 Plus Silver Edition Manual

Novell

Novell GROUPWISE 8 - INTERNET AGENT Manual de usuario

Oracle

Oracle Application 9i Manual de usuario

Acer

Acer RDM Manual de usuario

Canon

Canon Vixia HF21 Manual de usuario

Canon

Canon ZR950 Manual de usuario

Samsung

Samsung Auto Backup Manual de usuario

Polycom

Polycom Vortex EF2201 Instrucciones de instalación y funcionamiento

Brocade Communications Systems

Brocade Communications Systems Brocade 8/12c Manual de usuario