Flashlite 2.x 3.x Aslr (1)

ADOBE FLASH LITE 2.x y 3.xReferencia del lenguaje Adobe ActionScript

Copyright 2008 Adobe Systems Incorporated. Todos los derechos reservados.Referencia del lenguaje ActionScript de Flash Lite 2.x y 3.x de AdobeSi este manual se distribuye con un software que contenga un contrato para usuarios finales, el manual, as como el software que en l se describe, se suministran bajo licencia y pueden utilizarse y copiarse segn lo dispuesto en los trminos de dicha licencia. Exceptuando lo que permite dicha licencia, ninguna parte de esta gua se puede reproducir, almacenar en ningn sistema de recuperacin o transmitir de ninguna forma o por ningn medio, ya sea electrnico, mecnico, de grabacin u otros, sin el consentimiento expreso previo de Adobe Systems Incorporated. Tenga en cuenta que el contenido de este manual est protegido por las leyes de copyright, incluso si no se distribuye con el software que incluye el contrato de licencia para usuarios finales. En contenido de este manual se suministra exclusivamente con fines informativos, est sujeto a cambios sin previo aviso y no debe entenderse como un compromiso por parte de Adobe Systems. Adobe Systems no se hace responsable en forma alguna de ningn error o inexactitud que pueda aparecer en el contenido informativo que se incluye en esta gua. Recuerde que las imgenes o ilustraciones existentes que tal vez desee incluir en su proyecto pueden estar protegidas por leyes de derechos de autor. La inclusin de dicho material sin autorizacin dentro de su nuevo trabajo puede violar los derechos de autor. Asegrese de obtener los permisos necesarios del propietario de los derechos de autor.Las referencias a nombres de compaas en las plantillas de muestra tienen el propsito de servir meramente de ejemplo y no se refieren a ninguna organizacin real.Adobe, the Adobe logo, ActionScript, Flash, and Flash Lite are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries.Windows, Windows NT, and Windows Vista are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Linux is the registered trademark of Linus Torvalds in the U.S. and other countries. All other trademarks are the property of their respective owners.

Sorenson Spark video compression and decompression technology licensed from Sorenson Media, Inc. MPEG Layer-3 audio compression technology licensed by Fraunhofer IIS and Thomson Multimedia (http://www.iis.fhg.de/amm/).Portions licensed from Nellymoser, Inc. (www.nellymoser.com).Adobe Flash 9.2 video is powered by On2 TrueMotion video technology. 1992-2005 On2 Technologies, Inc. All Rights Reserved. http://www.on2.com.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.

iii

Contenido

Captulo 1: Elementos del lenguaje ActionScriptDirectivas del compilador . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Constantes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Funciones globales . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Propiedades globales . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Operadores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Sentencias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

Comandos fscommand2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

Captulo 2: Clases de ActionScriptarguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181

Array . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

BitmapData (flash.display.BitmapData) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

Boolean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

capabilities (System.capabilities) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246

Color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

ColorTransform (flash.geom.ColorTransform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269

Date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283

Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309

ExtendedKey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313

Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317

Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320

LoadVars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333

LocalConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343

Math . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356

Matrix (flash.geom.Matrix)) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370

Mouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390

MovieClip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396

MovieClipLoader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469

NetConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482

NetStream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484

Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499

Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503

Point (flash.geom.Point) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520

Rectangle (flash.geom.Rectangle) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528

Security (System.security) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550

Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555

SharedObject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562

Sonido . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574

Stage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594

String . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600

ivREFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.XContenido

System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612

TextField . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615

TextFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 655

Transform (flash.geom.Transform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 669

Video . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 676

XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 682

XMLNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 700

XMLSocket . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 717

Captulo 3: Cdigo ActionScript desfasadoResumen de funciones desfasadas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 725

Resumen de propiedades desfasadas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 726

Resumen de operadores desfasados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 727

Captulo 4: ActionScript no admitidoClases no admitidas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 729

Mtodos no admitidos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 729

Propiedades no admitidas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 729

Funciones globales no admitidas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 729

Controladores de eventos no admitidos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 730

Funciones fscommand no admitidas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 730

ndice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 731

1Captulo 1: Elementos del lenguaje ActionScript

En esta seccin se proporciona la sintaxis, la informacin de uso y los ejemplos de cdigo para las funciones globales y propiedades (los elementos que no pertenecen a ninguna clase de ActionScript); las directivas del compilador y las constantes, operadores, sentencias y palabras clave utilizadas en ActionScript y definidas en el borrador de la especificacin del lenguaje ECMAScript (ECMA-262) edicin 4.

Directivas del compiladorEsta seccin contiene las directivas que deben incluirse en el archivo de ActionScript para que el compilador realice el preprocesamiento de determinadas instrucciones.

Resumen de directivas del compilador

#endinitclip, directiva#endinitclip

Directiva del compilador; indica el final de un bloque de acciones de inicializacin.

DisponibilidadFlash Lite 2.0

Ejemplo #initclip ...initialization actions go here... #endinitclip

#include, directiva#include "[path]filename.as"

Nota: No inserte un punto y coma (;) al final de la lnea que contiene la sentencia #include.

Directiva del compilador; incluye el contenido del archivo especificado, como si los comandos del archivo formaran parte del guin que realiza la llamada. La directiva #incluir se invoca durante la compilacin. Por lo tanto, si realiza modificaciones en un archivo externo deber guardarlo y volver a compilar todos los archivos FLA que lo utilizan.

Directiva Descripcin

#endinitclip Directiva del compilador; indica el final de un bloque de acciones de inicializacin.

#incluir Directiva del compilador; incluye el contenido del archivo especificado, como si los comandos del archivo formaran parte del guin que realiza la llamada.

#initclip Directiva del compilador; indica el comienzo de un bloque de acciones de inicializacin.

2REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.XElementos del lenguaje ActionScript

Si utiliza el botn Revisar sintaxis en un guin que contiene sentencias #incluir, tambin se revisar la sintaxis de los archivos incluidos.

Puede utilizar #incluir en archivos FLA y en archivos de guiones externos, pero no en archivos de clase de ActionScript 2.0.

Puede elegir entre no especificar ninguna ruta, especificar una ruta relativa o especificar una ruta absoluta del archivo que debe incluirse. Si no se especifica ninguna ruta, el archivo AS debe encontrarse en una de las siguientes ubicaciones:

El mismo directorio que el archivo FLA. El mismo directorio que el guin que contiene la sentencia #incluir

El directorio Include global, cuya ruta puede ser:

Windows 2000 o Windows XP: C:\Documents and Settings\usuario \Local

Settings\ Application Data\Adobe\Flash 10\idioma\Configuration\Include

Windows Vista: C:\Users\usuario \Local Settings\ Application Data\Adobe\Flash 8\idioma\Configuration\Include

Macintosh OS X: Hard Drive/Users/Library/Application Support/Adobe/Flash 10/idioma/Configuration/Include

El directorio Programa Flash \idioma\First Run\Include; si se guarda aqu un archivo, se copiar al directorio Include global la prxima vez que se inicie Flash.

Para especificar una ruta relativa del archivo AS, utilice un punto (.) para indicar el directorio actual, dos puntos (..) para indicar un directorio principal y barras diagonales (/) para indicar subdirectorios. Lea la siguiente seccin de ejemplo.

Para especificar una ruta absoluta del archivo AS, utilice el formato compatible con su plataforma (Macintosh o Windows). Lea la siguiente seccin de ejemplo. (No se recomienda este uso porque requiere tener la misma estructura de directorios en todos los equipos que se utilicen para compilar el guin.)

Nota: Si coloca archivos en el directorio First Run/Include o en el directorio Include global, realice una copia de seguridad de dichos archivos. Si alguna vez necesita desinstalar Flash y volver a instalarlo, es posible que se eliminen y sobrescriban estos directorios.


Parmetros[path]filename.as - filename.asEl nombre de archivo y la ruta opcional del guin que se aadirn al panel Acciones o al guin actual .as es la extensin de nombre de archivo recomendada.

EjemploLos ejemplos siguientes muestran varias formas de especificar una ruta para un archivo que se va a incluir en el guin:


// Note that #include statements do not end with a semicolon (;) // AS file is in same directory as FLA file or script // or is in the global Include directory or the First Run/Include directory #include "init_script.as" // AS file is in a subdirectory of one of the above directories // The subdirectory is named "FLA_includes" #include "FLA_includes/init_script.as" // AS file is in a subdirectory of the script file directory // The subdirectory is named "SCRIPT_includes" #include "SCRIPT_includes/init_script.as" // AS file is in a directory at the same level as one of the above directories // AS file is in a directory at the same level as the directory // that contains the script file // The directory is named "ALL_includes" #include "../ALL_includes/init_script.as" // AS file is specified by an absolute path in Windows // Note use of forward slashes, not backslashes #include "C:/Flash_scripts/init_script.as" // AS file is specified by an absolute path on Macintosh #include "Mac HD:Flash_scripts:init_script.as"

#initclip, directiva#initclip order

Nota: No inserte un punto y coma (;) al final de la lnea que contiene la sentencia #initclip.

Directiva del compilador; indica el comienzo de un bloque de acciones de inicializacin. Cuando se inicializan varios clips simultneamente, se puede utilizar el parmetro order para especificar la inicializacin que se ejecuta en primer lugar. Las acciones de inicializacin se ejecutan cuando se define un smbolo de clip de pelcula. Si el clip de pelcula es un smbolo exportado, las acciones de inicializacin se ejecutan antes que la acciones en el fotograma 1 del archivo SWF. De lo contrario, se ejecutan inmediatamente antes que las acciones del fotograma que contiene la primera instancia del smbolo de clip de pelcula asociado.

Las acciones de inicializacin se ejecutan slo una vez cuando se reproduce un archivo SWF; utilcelas para inicializaciones que se realizan una vez, como la definicin de clases y el registro.


Parmetrosorder - Un entero no negativo que especifica el orden de ejecucin de bloques de cdigo #initclip. Este parmetro es opcional. Debe especificar el valor utilizando un literal entero (slo se permiten valores decimales, no hexadecimales) y sin utilizar variables. Si incluye varios bloques #initclip en un solo smbolo de clip de pelcula, el compilador utiliza el ltimo valor order especificado en ese smbolo de clip de pelcula para todos los bloques #initclip del mismo.

EjemploEn el ejemplo siguiente, se inserta cdigo ActionScript en el fotograma 1 de una instancia de clip de pelcula. En el mismo directorio se inserta el archivo de texto variables.txt.


#initclip trace("initializing app"); var variables:LoadVars = new LoadVars(); variables.load("variables.txt"); variables.onLoad = function(success:Boolean) { trace("variables loaded:"+success); if (success) { for (i in variables) { trace("variables."+i+" = "+variables[i]); } } }; #endinitclip

ConstantesUna constante es una variable que se utiliza para representar una propiedad cuyo valor no cambia nunca. En esta seccin se describen las constantes globales disponibles en todos los guiones.

Resumen de constantes

false, constanteValor booleano exclusivo que representa lo contrario de true.

Cuando la introduccin automtica de datos convierte false en un nmero, pasa a ser 0; cuando convierte false en una cadena, pasa a ser "false".

Modificadores Constante Descripcin

false Valor booleano exclusivo que representa lo contrario de true.

Infinity Especifica el valor IEEE-754 que representa el infinito positivo.

-Infinity Especifica el valor IEEE-754 que representa el infinito negativo.

NaN Variable predefinida con el valor IEEE-754 para NaN (no es un nmero).

newline Inserta un carcter de retorno de carro (\r) que genera una lnea en blanco en la salida de texto que genera el cdigo.

null Valor especial que puede asignarse a las variables o ser devuelto por una funcin si no se ha proporcionado ningn dato.

true Valor booleano exclusivo que representa lo contrario de false.

undefined Valor especial que normalmente se utiliza para indicar que todava no se ha asignado un valor a una variable.



EjemploEste ejemplo muestra cmo la introduccin automtica de datos convierte false en un nmero y en una cadena:

var bool1:Boolean = Boolean(false); // converts it to the number 0 trace(1 + bool1); // outputs 1 // converts it to a string trace("String: " + bool1); // outputs String: false

Infinity, constanteEspecifica el valor IEEE-754 que representa el infinito positivo. El valor de esta constante es igual que Number.POSITIVE_INFINITY.


Vase tambinPOSITIVE_INFINITY (propiedad Number.POSITIVE_INFINITY)

-Infinity, constanteEspecifica el valor IEEE-754 que representa el infinito negativo. El valor de esta constante es igual que Number.NEGATIVE_INFINITY.


Vase tambinNEGATIVE_INFINITY (propiedad Number.NEGATIVE_INFINITY)

NaN, constanteVariable predefinida con el valor IEEE-754 para NaN (no es un nmero). Para determinar si un nmero es NaN, utilice isNAN().


Vase tambinisNaN, funcin, NaN (propiedad Number.NaN)


newline, constanteInserta un carcter de retorno de carro (\r) que genera una lnea en blanco en la salida de texto que genera el cdigo. Utilice newline para crear un espacio donde ubicar la informacin que recupera una funcin o sentencia del cdigo.


EjemploEl ejemplo siguiente muestra cmo newline presenta el resultado de la sentencia trace() en varias lneas.

var myName:String = "Lisa", myAge:Number = 30; trace(myName+myAge); trace("-----"); trace(myName+newline+myAge); // output: Lisa30 ----- Lisa 30

Vase tambintrace, funcin

null, constanteValor especial que puede asignarse a las variables o ser devuelto por una funcin si no se ha proporcionado ningn dato. Puede utilizar null para representar los valores que faltan o que no tienen un tipo de datos definido.


EjemploEn un contexto numrico, null da como resultado 0. Las pruebas de igualdad se pueden realizar con null. En esta sentencia, un nodo de rbol binario no tiene elemento secundario a la izquierda, por lo que el campo para este elemento podra establecerse en null.

if (tree.left == null) { tree.left = new TreeNode(); }

true, constanteValor booleano exclusivo que representa lo contrario de false. Cuando la introduccin automtica de datos convierte true en un nmero, pasa a ser 1; cuando convierte true en una cadena, pasa a ser "true".


EjemploEl ejemplo siguiente muestra el uso de true en una sentencia if:


var shouldExecute:Boolean; // ... // code that sets shouldExecute to either true or false goes here // shouldExecute is set to true for this example: shouldExecute = true; if (shouldExecute == true) { trace("your statements here"); } // true is also implied, so the if statement could also be written: // if (shouldExecute) { // trace("your statements here"); // }

El ejemplo siguiente muestra cmo la introduccin automtica de datos convierte true en el nmero 1:

var myNum:Number; myNum = 1 + true; trace(myNum); // output: 2

Vase tambinfalse, constante, Boolean

undefined, constanteValor especial que normalmente se utiliza para indicar que todava no se ha asignado un valor a una variable. Una referencia a un valor undefined devuelve el valor especial undefined. El cdigo ActionScript typeof(undefined) devuelve la cadena "undefined". El nico valor de tipo undefined es undefined.

En los archivos publicados para Flash Player 6 o anterior, el valor de String(undefined) es "" (una cadena vaca). En los archivos publicados para Flash Player 7 o posterior, el valor de String(undefined) es "undefined" (undefined se convierte en una cadena).

En los archivos publicados para Flash Player 6 o anterior, el valor de Number(undefined) es 0. En los archivos publicados para Flash Player 7 o anterior, el valor de Number(undefined) es NaN.

El valor undefined es similar al valor especial null. Cuando null y undefined se comparan con el operador de igualdad (==) se comparan como iguales. Sin embargo, cuando null y undefined se comparan con el operador de igualdad estricta (===), se comparan como no iguales.


EjemploEn el siguiente ejemplo, la variable x no se ha declarado y, por lo tanto, tiene el valor undefined.

En la primera seccin del cdigo, el operador de igualdad (==) compara el valor de x con el valor undefined y enva el resultado correspondiente al panel Salida. En la primera seccin del cdigo, el operador de igualdad (==) compara el valor de x con el valor undefined y enva el resultado correspondiente al archivo de registro.

En la segunda seccin del cdigo, el operador de igualdad (==) compara los valores null y undefined.


// x has not been declared trace("The value of x is "+x); if (x == undefined) { trace("x is undefined"); } else { trace("x is not undefined"); } trace("typeof (x) is "+typeof (x)); if (null == undefined) { trace("null and undefined are equal"); } else { trace("null and undefined are not equal"); }

El resultado siguiente se muestra en el panel Salida.

The value of x is undefined x is undefined typeof (x) is undefined null and undefined are equal

Funciones globalesEsta seccin contiene un conjunto de funciones incorporadas que se encuentran disponibles en cualquier parte de un archivo SWF donde se utilice ActionScript. Estas funciones globales abarcan una gran variedad de tareas de programacin frecuentes como, por ejemplo, trabajar con tipos de datos (Boolean(), int(), etc.), proporcionar informacin de depuracin (trace()) y comunicarse con Flash Player o con el navegador (fscommand()).

Resumen de funciones globales

Modificadores

Firma Descripcin

Array([numElements], [elementN]) : Array

Crea una nueva matriz vaca o convierte determinados elementos en una matriz.

Boolean(expression:Object) : Boolean

Convierte el parmetro expression en un valor booleano y devuelve true o false.

call(frame:Object) Desfasada desde Flash Player 5. Esta accin est desfasada y en su lugar debe utilizarse la sentenciafunction.

Ejecuta el guin en el fotograma llamado sin mover la cabeza lectora a ese fotograma.

chr(number:Number) : String

Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse String.fromCharCode().

Convierte nmeros de cdigo ASCII en caracteres.

clearInterval(intervalID:Number)

Cancela un intervalo creado por una llamada a setInterval().

duplicateMovieClip(target:Object, newname:String, depth:Number)

Crea una instancia de un clip de pelcula durante la reproduccin del archivo SWF.


escape(expression:String) : String

Convierte el parmetro en una cadena y la codifica con un formato URL codificado donde todos los caracteres no alfanumricos se sustituyen por secuencias hexadecimales %.

eval(expression:Object) : Object

Accede a las variables, propiedades, objetos o clips de pelcula por su nombre.

fscommand(command:String, parameters:String)

Permite que un archivo SWF se comunique con el reproductor Flash Lite o con el entorno de un dispositivo mvil (tal como un sistema operativo).

fscommand2(command:String, parameters:String)

Permite que el archivo SWF se comunique con el reproductor Flash Lite o con la aplicacin host de un dispositivo mvil.

getProperty(my_mc:Object, property:Object) : Object

Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse la sintaxis con punto, introducida en Flash Player 5.

Devuelve el valor de la propiedad especificada para el clip de pelcula my_mc.

getTimer() : Number Devuelve el nmero de milisegundos transcurridos desde que se inici la reproduccin del archivo SWF.

getURL(url:String, [window:String], [method:String])

Carga un documento de una URL especfica en una ventana o pasa variables a otra aplicacin en una URL definida.

getVersion() : String Devuelve una cadena que contiene informacin de la versin de Flash Player y de la plataforma.

gotoAndPlay([scene:String], frame:Object)

Enva la cabeza lectora al fotograma especificado en una escena y reproduce desde dicho fotograma.

gotoAndStop([scene:String], frame:Object)

Enva la cabeza lectora al fotograma especificado en una escena y la detiene.

ifFrameLoaded([scene:String], frame:Object, statement(s):Object)

Desfasada desde Flash Player 5. Esta funcin est desfasada. Adobe recomienda la utilizacin de la propiedad MovieClip._framesloaded.

Comprueba si el contenido de un fotograma especfico est disponible localmente.

int(value:Number) : Number

Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse Math.round().

Convierte un nmero decimal en un valor de entero truncando el valor decimal.

isFinite(expression:Object) : Boolean

Evala expression y devuelve true si es un nmero finito o false si es infinito o infinito negativo.

isNaN(expression:Object) : Boolean

Evala el parmetro y devuelve true si el valor es NaN (no es un nmero).

length(expression:String, variable:Object) : Number

Desfasada desde Flash Player 5. Esta funcin, junto con todas las funciones string, est desfasada. Adobe recomienda que utilice los mtodos de la clase String y la propiedad String.length para realizar las mismas operaciones.

Devuelve la longitud de la cadena o la variable especificada.

Modificadores

Firma Descripcin


loadMovie(url:String, target:Object, [method:String])

Carga un archivo SWF o JPEG en Flash Player durante la reproduccin del archivo SWF original.

loadMovieNum(url:String, level:Number, [method:String])

Carga un archivo SWF o JPEG en un nivel de Flash Player durante la reproduccin del archivo SWF que se carg originalmente.

loadVariables(url:String, target:Object, [method:String])

Lee datos de un archivo externo, como un archivo de texto o texto generado por ColdFusion, un guin CGI, pginas Active Server (ASP), un guin PHP o Perl, y establece los valores de las variables en un clip de pelcula de destino.

loadVariablesNum(url:String, level:Number, [method:String])

Lee datos de un archivo externo, como un archivo de texto o texto generado por ColdFusion, un guin CGI, pginas Active Server (ASP), un guin PHP o Perl, y establece los valores de las variables en un nivel de Flash Player.

mbchr(number:Number) Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse el mtodo String.fromCharCode().

Convierte un nmero de cdigo ASCII en un carcter multibyte.

mblength(string:String) : Number

Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse la propiedad String.length.

Devuelve la longitud de una cadena de caracteres multibyte.

mbord(character:String) : Number

Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse el mtodo String.charCodeAt().

Convierte el carcter especificado en un nmero multibyte.

mbsubstring(value:String, index:Number, count:Number) : String

Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse el mtodo String.substr().

Extrae una cadena de caracteres multibyte nueva de una cadena de caracteres multibyte.

nextFrame() Enva la cabeza lectora al siguiente fotograma.

nextScene() Enva la cabeza lectora al fotograma 1 de la siguiente escena.

Number(expression:Object) : Number

Convierte el parmetro expression en un nmero.

Object([value:Object]) : Object

Crea un nuevo objeto vaco o convierte en un objeto el nmero, la cadena o el valor booleano especificado.

on(mouseEvent:Object) Especifica el evento de ratn o la pulsacin de tecla que activa una accin.

onClipEvent(movieEvent:Object)

Activa acciones definidas para una determinada instancia de un clip de pelcula.

ord(character:String) : Number

Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar deben utilizarse los mtodos y propiedades de la clase String.

Convierte caracteres en nmeros de cdigo ASCII.

parseFloat(string:String) : Number

Convierte una cadena en un nmero de coma flotante.

Modificadores

Firma Descripcin


parseInt(expression:String, [radix:Number]) : Number

Convierte una cadena en un entero.

play() Mueve la cabeza lectora hacia delante en la lnea de tiempo.

prevFrame() Enva la cabeza lectora al fotograma anterior.

prevScene() Enva la cabeza lectora al fotograma 1 de la escena anterior.

random(value:Number) : Number

Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse Math.random().

Devuelve un entero aleatorio entre 0 y uno menos que el entero especificado en el parmetro value.

removeMovieClip(target:Object)

Elimina el clip de pelcula especificado.

setInterval(functionName:Object, interval:Number, [param:Object], objectName:Object, methodName:String) : Number

Llama a una funcin, un mtodo o un objeto en intervalos peridicos durante la reproduccin de un archivo SWF.

setProperty(target:Object, property:Object, expression:Object)

Cambia un valor de propiedad de un clip de pelcula durante la reproduccin del clip de pelcula.

startDrag(target:Object, [lock:Boolean], [left,top,right,bottom:Number])

Permite arrastrar el clip de pelcula target durante la reproduccin de la pelcula.

stop() Detiene el archivo SWF que se est reproduciendo.

stopAllSounds() Detiene todos los sonidos que se estn reproduciendo en un archivo SWF sin detener la cabeza lectora.

stopDrag() Detiene la operacin de arrastre actual.

String(expression:Object) : String

Devuelve una representacin de cadena del parmetro especificado.

substring(string:String, index:Number, count:Number) : String

Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse String.substr().

Extrae parte de una cadena.

targetPath(targetObject:Object) : String

Devuelve una cadena que contiene la ruta de destino de movieClipObject.

tellTarget(target:String, statement(s):Object)

Desfasada desde Flash Player 5. Adobe recomienda el uso de notacin de puntos (.) y la sentencia with.

Aplica las instrucciones especificadas en el parmetro statements a la lnea de tiempo especificada en el parmetro target.

toggleHighQuality() Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse _quality.

Activa y desactiva el suavizado en Flash Player.

trace(expression:Object) Evala la expresin y produce el resultado.

Modificadores

Firma Descripcin


Array, funcinArray(): Array Array(numElements:Number): Array Array( [element0:Object [, element1, element2, ...elementN] ]) : Array

Crea una nueva matriz de longitud cero o ms, o una matriz con una lista de elementos especificados, posiblemente de distintos tipos de datos.

Permite crear una de las matrices siguientes:

una matriz vaca.

una matriz de longitud especfica pero con elementos con valores no definidos

una matriz cuyos elementos tienen valores especficos.

El uso de esta funcin es similar a la creacin de una matriz con el constructor Array (vase "Constructor de la clase Array").

Puede pasar un nmero (numElements) o una lista de elementos que contenga uno o varios tipos (element0, element1, ..., elementN).

Los parmetros que pueden aceptar ms de un tipo de datos se muestran en la firma como tipo Object.


ParmetrosnumElements [opcional] - Un entero positivo que especifica el nmero de elementos de la matriz. Puede especificar numElements o la lista de elementos, pero no los dos.

elementN [opcional] - uno o ms parmetros, element0, element1, ... , elementN, cuyos valores pueden ser de cualquier tipo. Los parmetros que pueden aceptar ms de un tipo de datos se engloban en el tipo Object. Puede especificar numElements o la lista de elementos, pero no los dos.

Valor devueltoArray - Una matriz.

Ejemplo var myArray:Array = Array(); myArray.push(12); trace(myArray); //traces 12 myArray[4] = 7; trace(myArray); //traces 12,undefined,undefined,undefined,7

unescape(string:String) : String

Evala el parmetro x como una cadena, decodifica la cadena con formato URL codificado (convirtiendo todas las secuencias hexadecimales en caracteres ASCII) y devuelve la cadena.

unloadMovie(target) Elimina un clip de pelcula que se carg mediante loadMovie() desde Flash Player.

unloadMovieNum(level:Number)

Elimina un archivo SWF o una imagen que se carg mediante loadMovieNum() desde Flash Player.

Modificadores

Firma Descripcin


Sintaxis 2: El ejemplo siguiente crea una matriz de longitud 4 pero sin elementos definidos:

var myArray:Array = Array(4); trace(myArray.length); // traces 4 trace(myArray); // traces undefined,undefined,undefined,undefined

Sintaxis 3: El ejemplo siguiente crea una matriz con tres elementos definidos:

var myArray:Array = Array("firstElement", "secondElement", "thirdElement"); trace (myArray); // traces firstElement,secondElement,thirdElement

Nota: A diferencia del constructor de la clase Array, la funcin Array() no utiliza la palabra clave new.

Vase tambinArray

Boolean, funcinBoolean(expression:Object) : Boolean

Convierte el parmetro expression en un valor booleano y devuelve un valor como se describe en la siguiente lista:

Si expression es un valor Booleano, el valor devuelto es expression.

Si expression es un nmero, el valor devuelto es true si el nmero no es cero; en caso contrario, el valor devuelto es false.

Si expression es una cadena, el valor devuelto es el siguiente:

En el caso de archivos publicados para Flash Player 6 o versiones anteriores, la cadena se convierte primero en un nmero; el valor es true si el nmero no es cero, y false en el resto de los casos.

En archivos publicados para Flash Player 7 o posterior, el resultado es true si la longitud de la cadena es mayor que cero; el valor es false si la cadena est vaca.

Si expression es una cadena, el resultado es true si la longitud de la cadena es mayor que cero; el valor es false si la cadena est vaca.

Si expression es undefined o NaN (no un nmero), el valor devuelto es false.

Si expression es un clip de pelcula o un objeto, el valor devuelto es true.

Nota: A diferencia del constructor de la clase Boolean, la funcin Boolean() no utiliza la palabra clave new. Adems, el constructor de la clase Boolean inicializa un objeto Boolean como false si no se especifica ningn parmetro, mientras que la funcin Boolean() devuelve undefined si no se especifica ningn parmetro.


Parmetrosexpression:Object - Una expresin para convertir en un valor booleano.

Valor devueltoBoolean - Valor booleano.


Ejemplo trace(Boolean(-1)); // output: true trace(Boolean(0)); // output: false trace(Boolean(1)); // output: true trace(Boolean(true)); // output: true trace(Boolean(false)); // output: false trace(Boolean("true")); // output: true trace(Boolean("false")); // output: true trace(Boolean("Craiggers")); // output: true trace(Boolean("")); // output: false

Si los archivos se publican para Flash Player 6 y versiones anteriores, los resultados sern diferentes para tres de los ejemplos anteriores:

trace(Boolean("true")); // output: false trace(Boolean("false")); // output: false trace(Boolean("Craiggers")); // output: false

Este ejemplo muestra una diferencia significativa entre el uso de la funcin Boolean() y la clase Boolean. La funcin Boolean() crea un valor booleano, mientras que la clase Boolean crea un objeto booleano. Los valores booleanos se comparan por valor y los objetos booleanos se comparan por referencia.

// Variables representing Boolean values are compared by value var a:Boolean = Boolean("a"); // a is true var b:Boolean = Boolean(1); // b is true trace(a==b); // true // Variables representing Boolean objects are compared by reference var a:Boolean = new Boolean("a"); // a is true var b:Boolean = new Boolean(1); // b is true trace(a == b); // false

Vase tambinBoolean

call, funcincall(frame)

Desfasada desde Flash Player 5. Esta accin est desfasada y en su lugar debe utilizarse la sentenciafunction.

Ejecuta el guin en el fotograma llamado sin mover la cabeza lectora a ese fotograma. Las variables locales no existen despus de ejecutar el guin.

Si no se declaran variables en un bloque ({}) pero la lista de acciones se ejecut con una accin call(), las variables sern locales y caducarn al final de la lista actual.

Si no se declaran variables en un bloque y la lista de acciones actual no se ejecut con la accin call(), las variables se interpretarn como variables de la lnea de tiempo.



Parmetrosframe:Object - La etiqueta o el nmero de un fotograma en la lnea de tiempo.

Vase tambinArray, funcin, call (mtodo Function.call)

chr, funcinchr(number) : String

Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse String.fromCharCode().

Convierte nmeros de cdigo ASCII en caracteres.


Parmetrosnumber:Number - Un nmero de cdigo ASCII.

Valor devueltoString - El valor de carcter del cdigo ASCII especificado.

EjemploEl ejemplo siguiente convierte el nmero 65 en la letra A y la asigna a la variable myVar: myVar = chr(65);

Vase tambinfromCharCode (mtodo String.fromCharCode)

clearInterval, funcinclearInterval(intervalID:Number) : Void

Cancela un intervalo creado por una llamada a setInterval().


ParmetrosintervalID:Number - Un identificador numrico (entero) devuelto desde una llamada a setInterval().

EjemploEl ejemplo siguiente primero establece y luego borra una llamada de intervalo:

function callback() { trace("interval called: "+getTimer()+" ms."); } var intervalID:Number = setInterval(callback, 1000);


Deber borrar el intervalo cuando termine de utilizar la funcin. Cree un botn llamado clearInt_btn y utilice el cdigo ActionScript siguiente para borrar setInterval():

clearInt_btn.onRelease = function(){ clearInterval( intervalID ); trace("cleared interval"); };

Vase tambinsetInterval, funcin

duplicateMovieClip, funcinduplicateMovieClip(target:String, newname:String, depth:Number) : Void duplicateMovieClip(target:MovieClip, newname:String, depth:Number) : Void

Crea una instancia de un clip de pelcula durante la reproduccin del archivo SWF. En los clips de pelcula duplicados, la cabeza lectora siempre empieza en el fotograma 1, independientemente del lugar en el que se encuentre la cabeza lectora del clip de pelcula original. Las variables del clip de pelcula original no se copian en el clip de pelcula duplicado. Utilice la funcin o el mtodo removeMovieClip() para eliminar una instancia de clip de pelcula creada mediante duplicateMovieClip().


Parmetrostarget:Object - La ruta de destino del clip de pelcula que se va a duplicar. Este parmetro puede ser una cadena (por ejemplo, "my_mc") o una referencia directa a la instancia de clip de pelcula (por ejemplo, my_mc). Los parmetros que pueden aceptar ms de un tipo de datos se engloban en el tipo Object.

newname:String - Identificador exclusivo del clip de pelcula duplicado.

depth:Number - Nivel de profundidad exclusivo del clip de pelcula duplicado. El nivel de profundidad es el orden de apilamiento de los clips de pelcula duplicados. Este orden de apilamiento es similar al de las capas de la lnea de tiempo; los clips de pelcula con un nivel de profundidad inferior se ocultan bajo los clips con un orden de apilamiento superior. Se debe asignar a cada clip de pelcula duplicado un nivel de profundidad exclusivo para evitar la sustitucin de archivos SWF en niveles de profundidad ocupados.

EjemploEn el siguiente ejemplo, se crea una nueva instancia de clip de pelcula llamada img_mc. Se carga una imagen al clip de pelcula y, despus, se duplica el clip img_mc. El clip duplicado se llama newImg_mc y este nuevo clip pasa al escenario para que no se superponga al clip original, y se carga la misma imagen en el segundo clip.

this.createEmptyMovieClip("img_mc", this.getNextHighestDepth()); img_mc.loadMovie("http://www.helpexamples.com/flash/images/image1.jpg"); duplicateMovieClip(img_mc, "newImg_mc", this.getNextHighestDepth()); newImg_mc._x = 200; newImg_mc.loadMovie("http://www.helpexamples.com/flash/images/image1.jpg");

Para eliminar el clip de pelcula duplicado, puede aadir este cdigo para un botn llamado myButton_btn.

this.myButton_btn.onRelease = function(){ removeMovieClip(newImg_mc); };


Vase tambinremoveMovieClip, funcin, duplicateMovieClip (mtodo MovieClip.duplicateMovieClip), removeMovieClip (mtodo MovieClip.removeMovieClip)

escape, funcinescape(expression:String) : String

Convierte el parmetro en una cadena y la codifica con un formato URL codificado donde todos los caracteres no alfanumricos se sustituyen por secuencias hexadecimales %. Si se utiliza en una cadena con codificacin URL, el smbolo de porcentaje (%) introduce caracteres de escape y no es equivalente al operador de mdulo (%).


Parmetrosexpression:String - Expresin para convertir en una cadena y codificar en un formato URL codificado.

Valor devueltoString - Cadena con codificacin URL.

EjemploEl siguiente cdigo da como resultado someuser%40somedomain%2Ecom:

var email:String = "[email protected]"; trace(escape(email));

En este ejemplo, el smbolo de arroba (@) se ha sustituido por %40 y el smbolo de punto (.), por %2E. Estas sustituciones resultan tiles cuando se intenta pasar informacin a un servidor remoto y los datos contienen caracteres especiales (por ejemplo, & o ?), como se muestra en el cdigo siguiente:

var redirectUrl = "http://www.somedomain.com?loggedin=true&username=Gus"; getURL("http://www.myothersite.com?returnurl="+ escape(redirectUrl));

Vase tambinunescape, funcin

eval, funcineval(expression:Object) : Objecteval(expression:String) : Object

Accede a las variables, propiedades, objetos o clips de pelcula por su nombre. Si la expresin es una variable o una propiedad, se devuelve el valor de la variable o propiedad. Si la expresin es un objeto o clip de pelcula, se devuelve una referencia al objeto o clip de pelcula. Si no se encuentra el elemento designado en la expresin, se devuelve undefined.

En Flash 4, eval() se utilizaba para simular matrices; en Flash 5 o posterior, debera utilizarse la clase Array para simular matrices.

En Flash 4, se puede utilizar adems eval() para establecer y recuperar dinmicamente el valor de una variable o nombre de instancia. Sin embargo, esto tambin puede realizarse mediante el operador de acceso a la matriz ([]).


En Flash 5 o posterior, no se puede utilizar eval() para establecer y recuperar dinmicamente el valor de una variable o nombre de instancia porque no se puede utilizar eval() en el lado izquierdo de una ecuacin. Por ejemplo, sustituya el cdigo

eval ("var" + i) = "first";

por esto:

this["var"+i] = "first"

o esto:

set ("var" + i, "first");


Parmetrosexpression:Object - El nombre de una variable, propiedad, objeto o clip de pelcula que debe recuperarse. Este parmetro puede ser una cadena o una referencia directa a la instancia del objeto (el uso de las comillas (" ") es opcional).

Valor devueltoObject - Un valor, una referencia a un objeto o clip de pelcula, o undefined.

EjemploEl ejemplo siguiente utiliza eval() para establecer propiedades para clips de pelcula con nombres dinmicos. Este ActionScript establece la propiedad _rotation para tres clips de pelcula, llamados square1_mc, square2_mc y square3_mc.

for (var i = 1; i



Parmetroscommand:String - Una cadena que se pasa a la aplicacin host para cualquier uso o un comando que se pasa al reproductor Flash Player.

parameters:String - Una cadena que se pasa a la aplicacin host para cualquier uso o un comando que se pasa al reproductor Flash Lite.

EjemploEn el ejemplo siguiente, la funcin fscommand() abre wap.yahoo.com en el navegador Web o en el navegador de servicios en telfonos de la serie 60:

on(keyPress "9") { status = fscommand("launch", "z:\\system\apps\browser\browser.app,http://wap.yahoo.com"); }

fscommand2, funcinfscommand2(command:String, parameter1:String,...parameterN:String) : Void

Comando Parmetros Propsito

launch application-path, arg1, arg2,..., argn

Este comando inicia otra aplicacin en un dispositivo mvil. El nombre de la aplicacin y sus parmetros se pasan como un solo argumento.

Nota: Esta funcin depende del sistema operativo. Utilice este comando con precaucin, ya que podra llamar al dispositivo host y realizar una operacin no admitida. Si esto ocurriese, podra bloquear el dispositivo host.

Este comando slo puede utilizarse cuando el reproductor de Flash Lite se ejecuta en modo autnomo. No se admite cuando el reproductor se inicia en el contexto de otra aplicacin (por ejemplo, un complemento de un navegador).

activateTextField

"" (ignored) Este comando activa de forma asncrona el campo de texto seleccionado actualmente y lo activa para que los usuarios puedan editarlo. Dado su comportamiento asncrono, este comando se procesa al final del fotograma. El cdigo ActionScript que sigue justo despus de la llamada a fscommand() se ejecuta en primer lugar. Si no hay ningn campo de texto seleccionado al procesarse el comando, no ocurre nada. Este comando resalta un campo de texto pasado previamente al mtodo Selection.setFocua() y activa el campo de texto para poder editarlo. Este comando surte efecto nicamente si el telfono admite edicin de texto en lnea.

Este comando se puede llamar como parte de la funcin callback del detector de eventos Selection.onSetFocus(). Esto hace que los campos de texto se activen para la edicin al seleccionarlos.

Nota: como la funcin fscommand() se ejecuta de forma asncrona, el campo de texto no se activa inmediatamente: lo hace al final del fotograma.


Permite que el archivo SWF se comunique con el reproductor Flash Lite o con la aplicacin host de un dispositivo mvil.

Para utilizar fscommand2() y enviar un mensaje al reproductor Flash Lite, debe utilizar comandos y parmetros predefinidos. Consulte la "Comandos fscommand2" seccin "Elementos del lenguaje ActionScript" para conocer los valores que se pueden especificar para los comandos y los parmetros de la funcin fscommand(). Estos valores controlan archivos SWF que se reproducen en el reproductor Flash Lite.

La funcin fscommand2() es similar a fscommand(), con las siguientes diferencias:

La funcin fscommand2() admite cualquier nmero de argumentos. Por el contrario, la funcin fscommand() slo puede tomar un argumento.

Flash Lite ejecuta fscommand2() inmediatamente (es decir, dentro del fotograma), mientras que fscommand() se ejecuta al final del fotograma que se procesa.

La funcin fscommand2() devuelve un valor que puede utilizarse para informar de la ejecucin correcta, con error o el resultado del comando.

Nota: ninguno de los comandos fscommands2() estn disponibles en reproductores Web.


Comandos fscommand2() desfasadosEn Flash Lite 2.0, algunos comandos fscommand2() de Flash Lite 1.1 estn desfasados. La siguiente tabla muestra los comandos desfasados fscommand2():

Comando En su lugar debe utilizarse

Escape Funcin global escape

GetDateDay Mtodo getDate() del objeto Date

GetDateMonth Mtodo getMonth() del objeto Date

GetDateWeekday Mtodo getDay() del objeto Date

GetDateYear Mtodo getYear() del objeto Date

GetLanguage Propiedad System.capabilities.language

GetLocaleLongDate Mtodo getLocaleLongDate() del objeto Date

GetLocaleShortDate Mtodo getLocaleShortDate() del objeto Date

GetLocaleTime Mtodo getLocaleTime() del objeto Date

GetTimeHours Mtodo getHours() del objeto Date

GetTimeMinutes Mtodo getMinutes() del objeto Date

GetTimeSeconds Mtodo getSeconds() del objeto Date

GetTimeZoneOffset Mtodo getTimeZoneOffset() del objeto Date

SetQuality MovieClip._quality

Unescape Funcin global unescape()


Parmetroscommand:String - Una cadena que se pasa a la aplicacin host para cualquier uso o un comando que se pasa al reproductor Flash Player.

parameters:String - Una cadena que se pasa a la aplicacin host para cualquier uso o un comando que se pasa al reproductor Flash Lite.

getProperty, funcingetProperty(my_mc:Object, property:Object) : Object

Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse la sintaxis con punto, introducida en Flash Player 5.

Devuelve el valor de la propiedad especificada para el clip de pelcula my_mc.


Parmetrosmy_mc:Object - El nombre de instancia del clip de pelcula para el que se recupera la propiedad.

property:Object - Propiedad de un clip de pelcula.

Valor devueltoObject - Valor de la propiedad especificada.

EjemploEl ejemplo siguiente crea el clip de pelcula nuevo someClip_mc y muestra el valor alfa (_alpha) del clip someClip_mc en el panel Salida:

this.createEmptyMovieClip("someClip_mc", 999); trace("The alpha of "+getProperty(someClip_mc, _name)+" is: "+getProperty(someClip_mc, _alpha));

getTimer, funcingetTimer() : Number

Devuelve el nmero de milisegundos transcurridos desde que se inici la reproduccin del archivo SWF.


Valor devueltoNumber - Nmero de milisegundos transcurridos desde que se inici la reproduccin del archivo SWF.

EjemploEn el ejemplo siguiente, las funciones getTimer() y setInterval() se utilizan para crear un temporizador sencillo:


this.createTextField("timer_txt", this.getNextHighestDepth(), 0, 0, 100, 22); function updateTimer():Void { timer_txt.text = getTimer(); } var intervalID:Number = setInterval(updateTimer, 100);

getURL, funcingetURL(url:String [, window:String [, method:String] ]) : Void

Carga un documento de una URL especfica en una ventana o pasa variables a otra aplicacin en una URL definida. Para probar esta funcin, asegrese de que el archivo que se va a cargar se encuentra en la ubicacin especificada. Para utilizar una URL absoluta (por ejemplo, http://www.myserver.com), se necesita una conexin de red.

Nota: esta funcin no se admite en dispositivos BREW.


Parmetrosurl:String - URL del cual se obtiene el documento.

window:String [opcional] - Especifica la ventana o marco HTML donde debera cargarse el documento. Puede introducir el nombre de una ventana especfica o seleccionarlo de entre los siguientes nombres de destino reservados:

_self especifica el fotograma actual en la ventana actual.

_blank especifica una nueva ventana.

_parent especifica el elemento principal del fotograma actual.

_top especifica el fotograma de nivel superior de la ventana actual.

method:String [opcional] - Un mtodo GET o POST para enviar variables. Si no hay ninguna variable, omita este parmetro. El mtodo GET aade las variables al final de la URL y se utiliza para nmeros reducidos de variables. El mtodo POST enva las variables en un encabezado HTTP independiente y se utiliza para enviar cadenas de variable largas.

EjemploEste ejemplo carga una imagen en un clip de pelcula. Cuando se hace clic en la imagen, se carga una nueva URL en una nueva ventana del navegador.

var listenerObject:Object = new Object(); listenerObject.onLoadInit = function(target_mc:MovieClip) { target_mc.onRelease = function() { getURL("http://www.macromedia.com/software/flash/flashpro/", "_blank"); }; }; var logo:MovieClipLoader = new MovieClipLoader(); logo.addListener(listenerObject); logo.loadClip("http://www.helpexamples.com/flash/images/image1.jpg", this.createEmptyMovieClip("macromedia_mc", this.getNextHighestDepth()));

En el ejemplo siguiente, se utiliza getURL() para enviar un mensaje de correo electrnico:


myBtn_btn.onRelease = function(){ getURL("mailto:[email protected]"); };

Tambin puede utilizar GET o POST para enviar variables. El ejemplo siguiente utiliza GET para aadir variables a una URL:

var firstName:String = "Gus"; var lastName:String = "Richardson"; var age:Number = 92; myBtn_btn.onRelease = function() { getURL("http://www.macromedia.com", "_blank", "GET"); };

El cdigo ActionScript siguiente utiliza POST para enviar variables en el encabezado HTTP. Compruebe los documentos en una ventana del navegador. En caso contrario, las variables se enviarn utilizando GET:

var firstName:String = "Gus"; var lastName:String = "Richardson"; var age:Number = 92; getURL("http://www.macromedia.com", "_blank", "POST");

Vase tambinloadVariables, funcin, send (mtodo XML.send), sendAndLoad (mtodo XML.sendAndLoad)

getVersion, funcingetVersion() : String

Devuelve una cadena que contiene informacin de la versin de Flash Player y de la plataforma. La funcin getVersion devuelve informacin nicamente para Flash Player 5 o versiones posteriores de Flash Player.


Valor devueltoString - Cadena que contiene informacin de la versin de Flash Player y de la plataforma.

EjemploLos ejemplos siguientes realizan un seguimiento del nmero de versin de Flash Player que est reproduciendo el archivo SWF:

var flashVersion:String = getVersion(); trace(flashVersion); // output: WIN 8,0,1,0 trace($version); // output: WIN 8,0,1,0 trace(System.capabilities.version); // output: WIN 8,0,1,0

La funcin getVersion devuelve la cadena siguiente:

WIN 8,0,1,0

Esta cadena devuelta indica que la plataforma es Microsoft Windows y el nmero de versin de Flash Player es la versin principal 8, versin secundaria 1 (8.1).

Vase tambinos (propiedad capabilities.os), version (propiedad capabilities.version)


gotoAndPlay, funcingotoAndPlay( [scene:String,] frame:Object) : Void

Enva la cabeza lectora al fotograma especificado en una escena y reproduce desde dicho fotograma. Si no se especifica ninguna escena, la cabeza lectora se desplaza al fotograma especificado de la escena actual. Puede utilizar el parmetro scene nicamente en la lnea de tiempo raz, no en las lneas de tiempo de los clips de pelcula u otros objetos del documento.


Parmetrosscene :String [opcional] - Una cadena que especifica el nombre de la escena a la que se enva la cabeza lectora.

frame:Object - Nmero que representa el nmero de fotograma o la cadena que representa la etiqueta del fotograma al que se enva la cabeza lectora.

EjemploEn el ejemplo siguiente un documento tiene dos escenas: sceneOne y sceneTwo. La escena uno contiene una etiqueta de fotograma en el fotograma 10 llamada newFrame y dos botones, myBtn_btn y myOtherBtn_btn. Este cdigo ActionScript se inserta en el fotograma 1, escena 1 de la lnea de tiempo principal.

stop(); myBtn_btn.onRelease = function(){ gotoAndPlay("newFrame"); }; myOtherBtn_btn.onRelease = function(){ gotoAndPlay("sceneTwo", 1); };

Cuando el usuario hace clic en los botones, la cabeza lectora pasa a la ubicacin especificada y contina con la reproduccin.

Vase tambingotoAndPlay (mtodo MovieClip.gotoAndPlay), nextFrame, funcin, play, funcin, prevFrame, funcin

gotoAndStop, funcingotoAndStop( [scene:String,] frame:Object) : Void

Enva la cabeza lectora al fotograma especificado en una escena y la detiene. Si no se ha especificado ninguna escena, la cabeza lectora se enva al fotograma de la escena actual. Puede utilizar el parmetro scene slo en la lnea de tiempo raz, no en las lneas de tiempo de los clips de pelcula u otros objetos del documento.


Parmetrosscene :String [opcional] - Una cadena que especifica el nombre de la escena a la que se enva la cabeza lectora.


frame:Object - Nmero que representa el nmero de fotograma o la cadena que representa la etiqueta del fotograma al que se enva la cabeza lectora.

EjemploEn el ejemplo siguiente un documento tiene dos escenas: sceneOne y sceneTwo. La escena uno contiene una etiqueta de fotograma en el fotograma 10 llamada newFrame y dos botones, myBtn_btn y myOtherBtn_btn. Este cdigo ActionScript se inserta en el fotograma 1, escena 1 de la lnea de tiempo principal:

stop(); myBtn_btn.onRelease = function(){ gotoAndStop("newFrame"); }; myOtherBtn_btn.onRelease = function(){ gotoAndStop("sceneTwo", 1); };

Cuando el usuario hace clic en los botones, la cabeza lectora pasa a la ubicacin especificada y se detiene.

Vase tambingotoAndStop (mtodo MovieClip.gotoAndStop), stop, funcin, play, funcin, gotoAndPlay, funcin

ifFrameLoaded, funcinifFrameLoaded( [scene,] frame) { statement(s); }

Desfasada desde Flash Player 5. Esta funcin est desfasada. Adobe recomienda la utilizacin de la propiedad MovieClip._framesloaded.

Comprueba si el contenido de un fotograma especfico est disponible localmente. Utilice ifFrameLoaded para comenzar a reproducir una animacin sencilla mientras se descarga el resto del archivo SWF en un equipo local. La diferencia entre _framesloaded y ifFrameLoaded radica en que _framesloaded permite aadir sentencias if o else personalizadas.


Parmetrosscene:String [opcional] - Una cadena que especifica el nombre de la escena que se debe cargar.

frame:Object - Es necesario cargar el nmero de fotograma o la etiqueta de fotograma antes de ejecutar la sentencia siguiente.

statement(s):Object - Instrucciones que se deben ejecutar si se carga el fotograma, o la escena y el fotograma especificados.

Vase tambinaddListener (mtodo MovieClipLoader.addListener)


int, funcinint(value) : Number

Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse Math.round().

Convierte un nmero decimal en un valor de entero truncando el valor decimal. Esta funcin es equivalente a Math.floor() si el parmetro value es positivo y Math.ceil() si el parmetrovalue es negativo.


Parmetrosvalue:Number - Un nmero que se redondear a un entero.

Valor devueltoNumber - El valor de entero truncado.

Vase tambinround (mtodo Math.round), floor (mtodo Math.floor), ceil (mtodo Math.ceil)

isFinite, funcinisFinite(expression:Object) : Boolean

Evala expression y devuelve true si es un nmero finito o false si es infinito o infinito negativo. La presencia de infinito o infinito negativo indica un error matemtico como, por ejemplo, la divisin por 0.


Parmetrosexpression:Object - Valor booleano, variable u otra expresin que se va a evaluar.


EjemploEl ejemplo siguiente muestra los valores devueltos para isFinite:

isFinite(56) // returns true isFinite(Number.POSITIVE_INFINITY) //returns false

isNaN, funcinisNaN(expression:Object) : Boolean

Evala el parmetro y devuelve true si el valor es NaN (no es un nmero). Esta funcin es til para comprobar si una expresin matemtica da como resultado un nmero.



Parmetrosexpression:Object - Variable booleana u otra expresin que se va a evaluar.


EjemploEl cdigo siguiente ilustra los valores devueltos para la funcin isNaN():

trace( isNaN("Tree") ); // returns true trace( isNaN(56) ); // returns false trace( isNaN(Number.POSITIVE_INFINITY) ) // returns false

El ejemplo siguiente muestra cmo puede utilizar isNAN() para comprobar si una expresin matemtica contiene un error:

var dividend:Number; var divisor:Number; divisor = 1; trace( isNaN(dividend/divisor) ); // output: true // The output is true because the variable dividend is undefined. // Do not use isNAN() to check for division by 0 because it will return false. // A positive number divided by 0 equals Infinity (Number.POSITIVE_INFINITY). // A negative number divided by 0 equals -Infinity (Number.NEGATIVE_INFINITY).

Vase tambinNaN, constante, NaN (propiedad Number.NaN)

length, funcinlength(expression)length(variable)

Desfasada desde Flash Player 5. Esta funcin, junto con todas las funciones string, est desfasada. Adobe recomienda que utilice los mtodos de la clase String y la propiedad String.length para realizar las mismas operaciones.

Devuelve la longitud de la cadena o la variable especificada.


Parmetrosexpression:String - Una cadena.

variable:Object - El nombre de una variable.


Valor devueltoNumber - La longitud de la cadena o la variable especificada.

EjemploEl ejemplo siguiente devuelve la longitud de la cadena "Hello": length("Hello"); El resultado es 5.

Vase tambin" operador de delimitador de cadena, String, length (propiedad String.length)

loadMovie, funcinloadMovie(url:String, target:Object [, method:String]) : Void loadMovie(url:String, target:String [, method:String]) : Void

Carga un archivo SWF o JPEG en Flash Player durante la reproduccin del archivo SWF original. Los archivos JPEG guardados en formato progresivo no son compatibles.

Si desea controlar el progreso de la descarga, utilice MovieClipLoader.loadClip() en lugar de esta funcin.

La funcin loadMovie() permite mostrar varios archivos SWF simultneamente y cambiar entre archivos SWF sin cargar otro documento HTML. Sin la funcin loadMovie(), Flash Player muestra un solo archivo SWF.

Si desea cargar un archivo SWF o JPEG en un nivel especfico, utilice loadMovieNum() en lugar de loadMovie().

Cuando se carga un archivo SWF en un clip de pelcula de destino, se puede utilizar la ruta de destino de dicho clip de pelcula para buscar el archivo SWF cargado. Un archivo SWF o una imagen que se carga en un destino hereda las propiedades de posicin, rotacin y escala del clip de pelcula de destino. La esquina superior izquierda de la imagen o archivo SWF cargado se alinea con el punto de registro del clip de pelcula de destino. Como alternativa, si el destino se encuentra en la lnea de tiempo raz, la esquina superior izquierda de la imagen o del archivo SWF se alinea con la esquina superior izquierda del escenario.

Utilice unloadMovie() para eliminar los archivos SWF que se cargaron con loadMovie().


Parmetros url:String - URL absoluto o relativo del archivo SWF o JPEG que se va a cargar. Una ruta relativa debe ser relativa al archivo SWF en el nivel 0. Las URL absolutas deben incluir la referencia al protocolo, como http:// o file:///.

target:Object - Referencia a un objeto de clip de pelcula o a una cadena que representa la ruta de acceso a un clip de pelcula de destino. El clip de pelcula de destino se sustituye por el archivo SWF o la imagen que se carga.

method:String [opcional] - Especifica un mtodo HTTP para enviar variables. El parmetro debe ser la cadena GET o POST. Si no hay ninguna variable para enviar, omita este parmetro. El mtodo GET aade las variables al final de la URL y se utiliza para nmeros reducidos de variables. El mtodo POST enva las variables en un encabezado HTTP independiente y se utiliza para enviar cadenas de variable largas.

EjemploSintaxis 1: El ejemplo siguiente carga el archivo SWF circle.swf desde el mismo directorio y reemplaza un clip de pelcula llamado mySquare que ya existe en el escenario:


loadMovie("circle.swf", mySquare); // equivalent statement (Usage 1): loadMovie("circle.swf", _level0.mySquare); // equivalent statement (Usage 2): loadMovie("circle.swf", "mySquare");

El ejemplo siguiente carga el archivo SWF circle.swf desde el mismo directorio, pero reemplaza el clip de pelcula principal en lugar del clip mySquare:

loadMovie("circle.swf", this); // Note that using "this" as a string for the target parameter will not work // equivalent statement (Usage 2): loadMovie("circle.swf", "_level0");

La siguiente sentencia loadMovie() carga el archivo SWF sub.swf desde el mismo directorio en un clip de pelcula nuevo llamado logo_mc que se crea empleando createEmptyMovieClip():

this.createEmptyMovieClip("logo_mc", 999); loadMovie("sub.swf", logo_mc);

Puede aadir el cdigo siguiente para cargar una imagen JPEG llamada image1.jpg desde el mismo directorio que el archivo SWF que carga sub.swf. El JPEG se carga al hacer clic en un botn denominado myBtn_btn. Este cdigo carga el JPEG en logo_mc. Por tanto, reemplazar a sub.swf por la imagen JPEG.

myBtn_btn.onRelease = function(){ loadMovie("image1.jpg", logo_mc); };

Sintaxis 2: El ejemplo siguiente carga el archivo SWF circle.swf desde el mismo directorio y reemplaza un clip de pelcula llamado mySquare que ya existe en el escenario:

loadMovie("circle.swf", "mySquare");

Vase tambin_level, propiedad, loadMovieNum, funcin, loadMovie (mtodo MovieClip.loadMovie), loadClip (mtodo MovieClipLoader.loadClip)unloadMovie, funcin

loadMovieNum, funcinloadMovieNum(url:String, level:Number [, method:String]) : Void

Carga un archivo SWF o JPEG en un nivel de Flash Player durante la reproduccin del archivo SWF que se carg originalmente.

si desea controlar el progreso de la descarga, utilice MovieClipLoader.loadClip() en lugar de esta funcin.

Normalmente, Flash Player muestra un solo archivo SWF y se cierra. La accin loadMovieNum() permite mostrar varios archivos SWF simultneamente y cambiar entre archivos SWF sin cargar otro documento HTML.

Si desea especificar un destino en lugar de un nivel, utilice loadMovie() en vez de loadMovieNum().

Flash Player tiene un orden de apilamiento de niveles a partir del nivel 0. Estos niveles son como capas de acetato: son transparentes, excepto en los objetos de cada nivel. Cuando utilice loadMovieNum(), debe especificar un nivel en Flash Player donde se cargar el archivo SWF. Cuando se carga un archivo SWF en un nivel, puede utilizar la sintaxis _levelN, donde N es el nmero de nivel, para buscar el archivo SWF.


Cuando cargue un archivo SWF, puede especificar cualquier nmero de nivel y puede cargar archivos SWF en un nivel que ya tenga un archivo SWF cargado. De esta forma, el nuevo archivo SWF sustituir al archivo SWF existente. Si carga un archivo SWF en el nivel 0, se descargarn todos los niveles de Flash Player y se sustituir el nivel 0 por el nuevo archivo. El archivo SWF en el nivel 0 establece la velocidad de fotogramas, el color de fondo y el tamao de fotograma de todos los dems archivos SWF cargados.

La accin loadMovieNum() tambin permite cargar archivos JPEG en un archivo SWF durante su reproduccin. En las imgenes y archivos SWF, la esquina superior izquierda de la imagen se alinea con la esquina superior izquierda del escenario cuando se carga el archivo. Adems, en ambos casos, el archivo cargado hereda la rotacin y la escala, y el contenido original se sobrescribe en el nivel especificado.

Nota: Los archivos JPEG guardados en formato progresivo no son compatibles.

Utilice unloadMovieNum() para eliminar los archivos o imgenes SWF que se cargaron con loadMovieNum().


Parmetros url:String - URL absoluto o relativo del archivo SWF o JPEG que se va a cargar. Una ruta relativa debe ser relativa al archivo SWF en el nivel 0. Para utilizar Flash Player de forma independiente o para realizar pruebas en el modo de prueba de la aplicacin de edicin de Flash, todos los archivos SWF deben almacenarse en la misma carpeta y los nombres de archivo no pueden contener especificaciones de carpeta o unidad de disco.

level:Number - Entero que especifica el nivel de Flash Player en el que se cargar el archivo SWF.


EjemploEl ejemplo siguiente carga la imagen JPEG tim.jpg en el nivel 2 de Flash Player:

loadMovieNum("http://www.helpexamples.com/flash/images/image1.jpg", 2);

Vase tambinunloadMovieNum, funcin, loadMovie, funcin, loadClip (mtodo MovieClipLoader.loadClip), _level, propiedad

loadVariables, funcinloadVariables(url:String, target:Object [, method:String]) : Void

Lee datos de un archivo externo, como un archivo de texto o texto generado por ColdFusion, un guin CGI, pginas Active Server (ASP), un guin PHP o Perl, y establece los valores de las variables en un clip de pelcula de destino. Esta accin se puede utilizar adems para actualizar las variables del archivo SWF activo con nuevos valores.

El texto y la URL especificados deben tener el formato MIME estndar application/x-www-form-urlencoded (formato estndar que se utiliza en los guiones CGI). Se puede especificar cualquier nmero de variables. Por ejemplo, la siguiente frase define varias variables:

company=Macromedia&address=600+Townsend&city=San+Francisco&zip=94103


En archivos SWF que se ejecuten en una versin anterior a Flash Player 7, url debe estar en el mismo superdominio que el archivo SWF que emite esta llamada. El superdominio se obtiene al eliminar el componente ms a la izquierda de la URL de un archivo. Por ejemplo, un archivo SWF situado en www.someDomain.com puede cargar datos de una fuente situada en store.someDomain.com porque ambos archivos se encuentran en el mismo superdominio, denominado someDomain.com.

En los archivos SWF de cualquier versin que se ejecute en Flash Player 7 o posterior, el url debe pertenecer exactamente al mismo dominio que el archivo SWF que realiza esta llamada (vase "Funciones de seguridad de Flash Player" en Utilizacin de ActionScript en Flash). Por ejemplo, un archivo SWF en www.someDomain.com puede cargar datos nicamente desde orgenes que tambin se encuentren en www.someDomain.com. Si desea cargar datos de un dominio distinto, puede colocar un archivo de poltica para distintos dominios en el servidor que aloja el archivo SWF al que se obtiene acceso. Para ms informacin, consulte "Carga de datos de varios dominios" en Utilizacin de ActionScript en Flash.

Si desea cargar variables en un nivel especfico, utilice loadVariablesNum() en lugar de loadVariables().


Parmetrosurl:String - URL absoluta o relativa donde se ubican las variables. Si el archivo SWF que realiza esta llamada se ejecuta en un navegador Web, el valor url debe pertenecer al mismo dominio que el archivo SWF; para ver ms detalles, consulte la seccin Descripcin.

target:Object - Ruta de destino de un clip de pelcula que recibe las variables que se cargan.


EjemploEl ejemplo siguiente carga informacin desde un archivo de texto llamado params.txt en el clip de pelcula target_mc que se crea utilizando createEmptyMovieClip(). La funcin setInterval() se utiliza para comprobar el progreso de la carga. El guin busca en el archivo params.txt una variable denominada done.

this.createEmptyMovieClip("target_mc", this.getNextHighestDepth()); loadVariables("params.txt", target_mc); function checkParamsLoaded() { if (target_mc.done == undefined) { trace("not yet."); } else { trace("finished loading. killing interval."); trace("-------------"); for (i in target_mc) { trace(i+": "+target_mc[i]); } trace("-------------"); clearInterval(param_interval); } } var param_interval = setInterval(checkParamsLoaded, 100);

El archivo externo, params.txt, incluye el texto siguiente:


var1="hello"&var2="goodbye"&done="done"

Vase tambinloadVariablesNum, funcin, loadMovie, funcin, loadMovieNum, funcin, getURL, funcin, loadMovie (mtodo MovieClip.loadMovie)loadVariables (mtodo MovieClip.loadVariables), load (mtodo LoadVars.load)

loadVariablesNum, funcinloadVariablesNum(url:String, level:Number [, method:String]) : Void

Lee datos de un archivo externo, como un archivo de texto o texto generado por ColdFusion, un guin CGI, pginas Active Server (ASP), un guin PHP o Perl, y establece los valores de las variables en un nivel de Flash Player. Esta funcin se puede utilizar adems para actualizar las variables del archivo SWF activo con nuevos valores.

El texto y la URL especificados deben tener el formato MIME estndar application/x-www-form-urlencoded (formato estndar que se utiliza en los guiones CGI). Se puede especificar cualquier nmero de variables. Por ejemplo, la siguiente frase define varias variables:

company=Macromedia&address=601+Townsend&city=San+Francisco&zip=94103

En archivos SWF que se ejecuten en una versin del reproductor anterior a Flash Player 7, url debe estar en el mismo superdominio que el archivo SWF que emite esta llamada. El superdominio se obtiene al eliminar el componente ms a la izquierda de la URL de un archivo. Por ejemplo, un archivo SWF en www.someDomain.com puede cargar datos desde un origen en store.someDomain.com porque ambos archivos pertenecen al mismo superdominio (someDomain.com).

En los archivos SWF de cualquier versin que se ejecute en Flash Player 7 o posterior, el url debe pertenecer exactamente al mismo dominio que el archivo SWF que realiza esta llamada (vase "Funciones de seguridad de Flash Player" en Utilizacin de ActionScript en Flash). Por ejemplo, un archivo SWF situado en www.someDomain.com slo puede cargar datos de fuentes que tambin se encuentren en www.someDomain.com. Si desea cargar datos de un dominio diferente, puede colocar un archivo de poltica para distintos dominios en el servidor en el que se aloja el archivo SWF. Para ms informacin, consulte "Carga de datos de varios dominios" en Utilizacin de ActionScript en Flash.

Si desea cargar variables en un destino MovieClip, utilice loadVariables() en lugar de loadVariablesNum().


Parmetrosurl:String - URL absoluta o relativa donde se ubican las variables. Si el archivo SWF que realiza esta llamada se ejecuta en un navegador Web, el valor url debe pertenecer al mismo dominio que el archivo SWF; para ver ms detalles, consulte la seccin Descripcin.