Adobe FLEX 2-PROGRAMMING ACTIONSCRIPT 3.0 Bedienungsanleitung

Programming ActionScript 3.0

Adobe®Flex™

Flex 2 Programming ActionScript 3.0

If this guide is distributed with software that includes an end-user agreement, this guide, as well as the software described in it, is

furnished under license and may be used or copied only in accordance with the terms of such license. Except as permitted by any

such license, no part of this guide may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means,

electronic, mechanical, recording, or otherwise, without the prior written permission of Adobe Systems Incorporated. Please note

that the content in this guide is protected under copyright law even if it is not distributed with software that includes an end-user

license agreement.

The content of this guide is furnished for informational use only, is subject to change without notice, and should not be

construed as a commitment by Adobe Systems Incorporated. Adobe Systems Incorporated assumes no responsibility or liability

for any errors or inaccuracies that may appear in the informational content contained in this guide.

Please remember that existing artwork or images that you may want to include in your project may be protected under copyright

law. The unauthorized incorporation of such material into your new work could be a violation of the rights of the copyright

owner. Please be sure to obtain any permission required from the copyright owner.

Any references to company names in sample templates are for demonstration purposes only and are not intended to refer to any

actual organization.

Adobe, the Adobe logo, Flex, Flex Builder and Flash Player are either registered trademarks or trademarks of Adobe Systems

Incorporated in the United States and/or other countries. ActiveX and Windows are either registered trademarks or trademarks of

Microsoft Corporation in the United States and other countries. Macintosh is a trademark of Apple Computer, Inc., registered in

the United States and other countries. All other trademarks are the property of their respective owners.

Speech compression and decompression technology licensed from Nellymoser, Inc. (www.nellymoser.com).

Sorenson™ Spark™ video compression and decompression technology licensed from Sorenson Media, Inc.

Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA

Notice to U.S. government end users. The software and documentation are “Commercial Items,” as that term is defined at 48

C.F.R. §2.101, consisting of “Commercial Computer Software” and “Commercial Computer Software Documentation,” as such

terms are used in 48 C.F.R. §12.212 or 48 C.F.R. §227.7202, as applicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R.

§§227.7202-1 through 227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software

Documentation are being licensed to U.S. Government end users (a) only as Commercial items and (b) with only those rights as

are granted to all other end users pursuant to the terms and conditions herein. Unpublished-rights reserved under the copyright

laws of the United States. Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA 95110-2704, USA. For U.S.

Government End Users, Adobe agrees to comply with all applicable equal opportunity laws including, if appropriate, the

provisions of Executive Order 11246, as amended, Section 402 of the Vietnam Era Veterans Readjustment Assistance Act of

1974 (38 USC 4212), and Section 503 of the Rehabilitation Act of 1973, as amended, and the regulations at 41 CFR Parts 60-1

through 60-60, 60-250 ,and 60-741. The affirmative action clause and regulations contained in the preceding sentence shall be

incorporated by reference.

Contents

PART 1: OVERVIEW OF ACTIONSCRIPT PROGRAMMING

About This Manual. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

Using this manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Accessing ActionScript documentation . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Developer Center . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Chapter 1: Introduction to ActionScript 3.0 . . . . . . . . . . . . . . . . . . 15

About ActionScript. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Advantages of ActionScript 3.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

What’s new in ActionScript 3.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Compatibility with previous versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Chapter 2: Getting Started with ActionScript . . . . . . . . . . . . . . . 23

The basic ActionScript development process . . . . . . . . . . . . . . . . . . . . 23

Options for organizing your code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Example: Creating a basic application . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Chapter 3: ActionScript Language and Syntax . . . . . . . . . . . . . 35

Language overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Objects and classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37

Packages and namespaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Data types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Conditionals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Looping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

Chapter 4: Object-Oriented Programming in ActionScript . . . . 107

Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107

Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126

Inheritance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130

4Contents

Advanced topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

Example: GeometricShapes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

Chapter 5: Display Programming . . . . . . . . . . . . . . . . . . . . . . . . . 159

Understanding the display architecture . . . . . . . . . . . . . . . . . . . . . . . . . 160

Working with display objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

Basics for working with the core display classes . . . . . . . . . . . . . . . . . 176

Example: SpriteArranger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187

PART 2: CORE ACTIONSCRIPT 3.0 DATA TYPES AND CLASS-

Chapter 6: Working with Dates and Times . . . . . . . . . . . . . . . . . 197

Managing calendar dates and times . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

Controlling time intervals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

Example: Simple analog clock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204

Chapter 7: Working with Strings . . . . . . . . . . . . . . . . . . . . . . . . 209

Creating strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

The length property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211

Working with characters in strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211

Comparing strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

Obtaining string representations of other objects . . . . . . . . . . . . . . . . 213

Concatenating strings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

Finding substrings and patterns in strings . . . . . . . . . . . . . . . . . . . . . . . 214

Converting strings between uppercase and lowercase . . . . . . . . . . . 219

Example: ASCII Art . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220

Chapter 8: Working with Arrays . . . . . . . . . . . . . . . . . . . . . . . . . 227

Indexed arrays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .227

Associative arrays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .236

Multidimensional arrays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240

Cloning arrays. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .243

Advanced Topics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .243

Example: PlayList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249

Chapter 9: Handling Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255

Types of errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .256

Error handling in ActionScript 3.0. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .258

Working with the debugger version of Flash Player . . . . . . . . . . . . . 260

Contents 5

Handling synchronous errors in an application . . . . . . . . . . . . . . . . . . .261

Creating custom error classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266

Responding to error events and status . . . . . . . . . . . . . . . . . . . . . . . . . 267

Comparing the Error classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271

Example: CustomErrors application. . . . . . . . . . . . . . . . . . . . . . . . . . . . 277

Chapter 10: Using Regular Expressions . . . . . . . . . . . . . . . . . . . 285

Introduction to Regular Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . 286

Regular expression syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287

Methods for using regular expressions with strings . . . . . . . . . . . . . . 303

Example: A Wiki parser. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304

Chapter 11: Working with XML . . . . . . . . . . . . . . . . . . . . . . . . . . . 311

A quick introduction to XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .312

The E4X approach to XML processing . . . . . . . . . . . . . . . . . . . . . . . . . .313

XML objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .315

XMLList objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317

Initializing XML variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .319

Assembling and transforming XML objects . . . . . . . . . . . . . . . . . . . . . 320

Traversing XML structures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322

Using XML namespaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327

XML type conversion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328

Reading external XML documents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330

Example: Loading RSS data from the Internet . . . . . . . . . . . . . . . . . . 330

PART 3: FLASH PLAYER APIS

Chapter 12: Flash Player API Overview . . . . . . . . . . . . . . . . . . . 337

flash.accessibility package. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338

flash.display package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338

flash.errors package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339

flash.events package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339

flash.external package. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340

flash.filters package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340

flash.geom package. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340

flash.media package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .341

flash.net package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .341

flash.printing package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .341

flash.profiler package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342

flash.system package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342

6Contents

flash.text package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .342

flash.ui package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .342

flash.utils package. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .343

flash.xml package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .343

Chapter 13: Handling Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345

Introduction to Event Handling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .346

How ActionScript 3.0 event handling differs from earlier versions .347

The event flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350

Event objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .352

Event listeners . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .357

Example: Alarm Clock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .365

Chapter 14: Networking and Communication . . . . . . . . . . . . . . . 371

Working with external data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .372

Connecting to other Flash Player instances . . . . . . . . . . . . . . . . . . . . .379

Socket connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .385

Storing local data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390

Working with file upload and download . . . . . . . . . . . . . . . . . . . . . . . . 394

Example: Building a Telnet client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404

Example: Uploading and downloading files. . . . . . . . . . . . . . . . . . . . . 408

Chapter 15: Working with Geometry . . . . . . . . . . . . . . . . . . . . . . 417

Using Point objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417

Using Rectangle objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420

Using Matrix objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .423

Example: Applying a matrix transformation to a display object. . . . .428

Chapter 16: Client System Environment . . . . . . . . . . . . . . . . . . 433

System class. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .433

Capabilities class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .435

ApplicationDomain class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .436

IME class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439

Example: Detecting system capabilities. . . . . . . . . . . . . . . . . . . . . . . . 444

Chapter 17: Flash Player Security. . . . . . . . . . . . . . . . . . . . . . . . 449

Flash Player Security overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450

Overview of permission controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452

Security sandboxes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461

Restricting networking APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464

Full-screen mode security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .465

Contents 7

Loading content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467

Cross-scripting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470

Accessing loaded media as data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474

Loading data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477

Loading embedded content from SWF files imported into a security do-

main . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479

Working with legacy content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480

Setting LocalConnection permissions. . . . . . . . . . . . . . . . . . . . . . . . . . .481

Controlling access to scripts in a host web page. . . . . . . . . . . . . . . . . .481

Shared objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483

Camera, microphone, Clipboard, mouse, and keyboard access . . . 484

Chapter 18: Printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487

What’s new for the PrintJob class using ActionScript 3.0 . . . . . . . . 488

Printing a page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488

Flash Player tasks and system printing . . . . . . . . . . . . . . . . . . . . . . . . . 489

Setting size, scale, and orientation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493

Example: Multiple-page printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495

Example: Scaling, cropping, and responding. . . . . . . . . . . . . . . . . . . . 498

Chapter 19: Using the External API. . . . . . . . . . . . . . . . . . . . . . . .501

About the External API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502

Using the ExternalInterface class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503

Example: Using the External API with a web page container . . . . . . 507

Example: Using the External API with an ActiveX container . . . . . . .514

8Contents

PART 1

Overview of ActionScript

Programming

This part describes fundamental programming concepts in ActionScript 3.0.

The following chapters are included:

About This Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Chapter 1: Introduction to ActionScript 3.0 . . . . . . . . . . . . . . . . . . . 15

Chapter 2: Getting Started with ActionScript . . . . . . . . . . . . . . . . .23

Chapter 3: ActionScript Language and Syntax. . . . . . . . . . . . . . . .35

Chapter 4: Object-Oriented Programming in ActionScript. . . . . 107

Chapter 5: Display Programming . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

Dieses Handbuch passt für folgende Modelle

Inhaltsverzeichnis

Andere Adobe Software Handbücher

Adobe

Adobe ACROBAT COM Bedienungsanleitung

Adobe

Adobe DRIVE 2 Bedienungsanleitung

Adobe

Adobe 65016038 - Contribute CS4 - Mac Bedienungsanleitung

Adobe

Adobe 29180155 - Photoshop Elements 4.0 Bedienungsanleitung

Adobe

Adobe 12040118 - After Effects Standard Leitfaden

Adobe

Adobe CONFIGURATOR 1 Bedienungsanleitung

Adobe

Adobe 23101764 - Photoshop CS - PC Bedienungsanleitung

Adobe

Adobe 38039336 - Flash CS3 Professional Betriebsanleitung

Adobe

Adobe 65016169 - Photoshop CS4 Extended Betriebsanleitung

Adobe

Adobe 0046100128056 - InDesign - Mac Bedienungsanleitung

Adobe

Adobe 16001500 - Illustrator CS2 - Mac Bedienungsanleitung

Adobe

Adobe 22002420 - Acrobat Standard - PC Bedienungsanleitung

Adobe

Adobe 8500 Bedienungsanleitung

Adobe

Adobe 22020807 Montage- und Bedienungsanleitung

Adobe

Adobe 65018518 - Flash CS4 Professional Leitfaden

Adobe

Adobe 718659340025 - InDesign CS - PC Konfigurationshandbuch

Adobe

Adobe 26001360 - Illustrator CS - PC Bedienungsanleitung

Adobe

Adobe FLASH PLAYER 10 - FOR IMMEDIATE RELEASE Bedienungsanleitung

Adobe

Adobe 38043740 - ColdFusion Standard - Mac Bedienungsanleitung

Adobe

Adobe PHOTOSHOP ELEMENTS Bedienungsanleitung

Adobe

Adobe 22020772 Bedienungsanleitung

Adobe

Adobe 22001438 - Acrobat - PC Leitfaden

Adobe

Adobe PHOTOSHOP ALBUM 2.0-STARTER EDITION Montage- und Bedienungsanleitung

Adobe

Adobe LIVE CYCLE 7.2 - INSTALLING AND CONFIGURING LIVECYCLE FOR... Bedienungsanleitung

Beliebte Software Handbücher anderer Marken

COMPRO

COMPRO COMPROFM Bedienungsanleitung

Muratec

Muratec OFFICEBRIDGE ONLINE Bedienungsanleitung

Oracle

Oracle Contact Center Anywhere 8.1 Bedienungsanleitung

Avaya

Avaya NULL One-X for RIM Blackberry Bedienungsanleitung

HP ProLiant BL420c Bedienungsanleitung

PS Audio

PS Audio PowerPlay Betriebsanleitung

Brady

Brady LOCKOUT PRO 3.0 Service-Handbuch

Avaya

Avaya Interaction Center Bedienungsanleitung

Texas Instruments

Texas Instruments TI-83 Plus Silver Edition Handbuch

Novell

Novell GROUPWISE 8 - INTERNET AGENT Bedienungsanleitung

Oracle

Oracle Application 9i Bedienungsanleitung

Acer

Acer RDM Bedienungsanleitung

Canon

Canon Vixia HF21 Bedienungsanleitung

Canon

Canon ZR950 Bedienungsanleitung

Samsung

Samsung Auto Backup Bedienungsanleitung

Polycom

Polycom Vortex EF2201 Montage- und Bedienungsanleitung

Brocade Communications Systems

Brocade Communications Systems Brocade 8/12c Bedienungsanleitung

Novell

Novell SP2 - S Bedienungsanleitung