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 thirdparty sites. SorensonTM SparkTM 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). Opera ® browser Copyright © 1995-2002 Opera Software ASA and its suppliers. All rights reserved. Macromedia Flash 8 video is powered by On2 TrueMotion video technology. © 1992-2005 On2 Technologies, Inc. All Rights Reserved. http://www.on2.com. Visual SourceSafe is a registered trademark or trademark of Microsoft Corporation in the United States and/or other countries. Copyright © 2006 Adobe Systems Incorporated. All rights reserved. This manual may not be copied, photocopied, 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 3 4 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. 5 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 Code font italic ActionScript code. 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 ('). 6 Introduction 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 1 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. 7 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. Command quit fullscreen Description Closes the projector. Specifying true sets Flash Player to full-screen mode. Specifying false returns the player to normal menu view. 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. Specifying true enables the full set of context menu items. Specifying false hides all the context menu items except About Flash Player and Settings. Executes an application from within the projector. Specifying true sends all key events, including accelerator keys, to the onClipEvent(keyDown/keyUp) handler in Flash Player. allowscale showmenu exec trapallkeys 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, function, or keyword asfunction fscommand() Description A protocol for URLs in HTML text fields. Function that lets the SWF file communicate with either Flash Player or the program hosting Flash Player, such as a web browser. Prefix for events to execute when the event occurs. Limitation: The supported events are rollout, rollover, and keyPress. Support Not supported Partially supported Partially supported on 8 Unsupported and Partially Supported ActionScript Elements Command, function, or keyword onClipEvent Description 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. The onUpdate event handler is defined for a live preview used with a component. The print() function targets the movie clip according to the boundaries specified in the parameter. A function that prints the target movie clip as a bitmap. Support Partially supported onUpdate Not supported Not supported print() printAsBitmap() Not supported printAsBitmaNum() A function that prints a level in Flash Player as a Not supported bitmap according to the boundaries s ...