Flashlite 2.x 3.x Aslr

ADOBE FLASH LITE 2.x y 3.
Referencia del lenguaje Adobe ActionScript
2008 Adobe Systems Incorporated. Todos los derechos reservados.

Copyright
Referencia del lenguaje ActionScript de Flash Lite 2.x y 3.x de Adobe Si 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 ActionScript Directivas del compilador . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Constantes ............................................................................................................ 4 .................................................................................................... 8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 Funciones globales Propiedades globales Operadores Sentencias
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Comandos fscommand2
Captulo 2: Clases de ActionScript arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181 Array . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370 BitmapData (flash.display.BitmapData) Boolean Button Color Date Error
capabilities (System.capabilities)
ColorTransform (flash.geom.ColorTransform)
ExtendedKey Function Key LoadVars Math Mouse
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
LocalConnection
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482
Matrix (flash.geom.Matrix)) MovieClip
MovieClipLoader NetConnection NetStream Number Object
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550
Point (flash.geom.Point) Security (System.security) Selection Sonido Stage String SharedObject
Rectangle (flash.geom.Rectangle)
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600
REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X iv

Contenido
System TextField
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 655 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 669
TextFormat Video XML
Transform (flash.geom.Transform)
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 676 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 682 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 700 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 717
XMLNode XMLSocket
Captulo 3: Cdigo ActionScript desfasado Resumen de funciones desfasadas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 725 Resumen de propiedades desfasadas Resumen de operadores desfasados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 726 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 727
Captulo 4: ActionScript no admitido Clases no admitidas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 729 Mtodos no admitidos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 729 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 729 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 729 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 730 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 730 Propiedades no admitidas
Funciones globales no admitidas
Controladores de eventos no admitidos Funciones fscommand no admitidas ndice
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 731
Captulo 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 compilador

Esta 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
Directiva #endinitclip #incluir Descripcin Directiva del compilador; indica el final de un bloque de acciones de inicializacin. Directiva del compilador; incluye el contenido del archivo especificado, como si los comandos del archivo formaran parte del guin que realiza la llamada. Directiva del compilador; indica el comienzo de un bloque de acciones de inicializacin.
#initclip
#endinitclip, directiva
#endinitclip
Directiva del compilador; indica el final de un bloque de acciones de inicializacin. Disponibilidad Flash 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.
REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 2

Elementos 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. Disponibilidad Flash Lite 2.0 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. Ejemplo Los 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. Disponibilidad Flash Lite 2.0 Parmetros
order - 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. Ejemplo En 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
Constantes
Una 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
Modificadores Constante false Infinity -Infinity NaN Descripcin Valor booleano exclusivo que representa lo contrario de true. Especifica el valor IEEE-754 que representa el infinito positivo. Especifica el valor IEEE-754 que representa el infinito negativo. Variable predefinida con el valor IEEE-754 para NaN (no es un nmero). Inserta un carcter de retorno de carro (\r) que genera una lnea en blanco en la salida de texto que genera el cdigo. Valor especial que puede asignarse a las variables o ser devuelto por una funcin si no se ha proporcionado ningn dato. Valor booleano exclusivo que representa lo contrario de
false.
newline
null
true
undefined
Valor especial que normalmente se utiliza para indicar que todava no se ha asignado un valor a una variable.
false, constante
Valor 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".

Disponibilidad Flash Lite 1.1 Ejemplo Este 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, constante
Especifica el valor IEEE-754 que representa el infinito positivo. El valor de esta constante es igual que Number.POSITIVE_INFINITY. Disponibilidad Flash Lite 2.0 Vase tambin
POSITIVE_INFINITY (propiedad Number.POSITIVE_INFINITY)
-Infinity, constante
Especifica el valor IEEE-754 que representa el infinito negativo. El valor de esta constante es igual que Number.NEGATIVE_INFINITY. Disponibilidad Flash Lite 2.0 Vase tambin
NEGATIVE_INFINITY (propiedad Number.NEGATIVE_INFINITY)
NaN, constante
Variable predefinida con el valor IEEE-754 para NaN (no es un nmero). Para determinar si un nmero es NaN, utilice isNAN(). Disponibilidad Flash Lite 1.1 Vase tambin
isNaN, funcin, NaN (propiedad Number.NaN)

newline, constante
Inserta 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. Disponibilidad Flash Lite 1.1 Ejemplo El 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 tambin
trace, funcin
null, constante
Valor 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. Disponibilidad Flash Lite 1.1 Ejemplo En 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, constante
Valor 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". Disponibilidad Flash Lite 1.1 Ejemplo El 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 tambin
false, constante, Boolean
undefined, constante
Valor 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. Disponibilidad Flash Lite 1.1 Ejemplo En 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 globales
Esta 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
Modificador es Firma Descripcin
Array([numElements],
[elementN]) : Array
Crea una nueva matriz vaca o convierte determinados elementos en una matriz. Convierte el parmetro expression en un valor booleano y devuelve true o false. 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.
Boolean(expression:Obje
ct) : Boolean
call(frame:Object)
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:N
umber)
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.

Modificador es
Firma
Descripcin
escape(expression:Strin g) : 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 %. Accede a las variables, propiedades, objetos o clips de pelcula por su nombre. 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).
eval(expression:Object)
: Object
fscommand(command:Stri
ng, parameters:String)
fscommand2(command:Stri Permite que el archivo SWF se comunique con el reproductor ng, parameters:String) 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. Carga un documento de una URL especfica en una ventana o pasa variables a otra aplicacin en una URL definida.
getURL(url:String,
[window:String], [method:String])
getVersion() : String
Devuelve una cadena que contiene informacin de la versin de Flash Player y de la plataforma.
gotoAndPlay([scene:Strin Enva la cabeza lectora al fotograma especificado en una escena y g], frame:Object) reproduce desde dicho fotograma. gotoAndStop([scene:Stri
ng], frame:Object)
Enva la cabeza lectora al fotograma especificado en una escena y la detiene. 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.
ifFrameLoaded([scene:Str
ing], frame:Object, statement(s):Object)
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:Objec t) : Boolean isNaN(expression:Object

) : Boolean
Evala expression y devuelve true si es un nmero finito o false si es infinito o infinito negativo. Evala el parmetro y devuelve true si el valor es NaN (no es un nmero). 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.
length(expression:Strin
g, variable:Object) : Number

Modificador es
Firma
Descripcin
loadMovie(url:String, target:Object, [method:String]) loadMovieNum(url:String , level:Number, [method:String]) loadVariables(url:String,

target:Object, [method:String])
Carga un archivo SWF o JPEG en Flash Player durante la reproduccin del archivo SWF original.
Carga un archivo SWF o JPEG en un nivel de Flash Player durante la reproduccin del archivo SWF que se carg originalmente.
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:Stri Lee datos de un archivo externo, como un archivo de texto o texto ng, level:Number, generado por ColdFusion, un guin CGI, pginas Active Server [method:String]) (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 Desfasada desde Flash Player 5. Esta funcin est desfasada y en , index:Number, su lugar debe utilizarse el mtodo String.substr().
count:Number) : String
Extrae una cadena de caracteres multibyte nueva de una cadena de caracteres multibyte. Enva la cabeza lectora al siguiente fotograma. Enva la cabeza lectora al fotograma 1 de la siguiente escena. Convierte el parmetro expression en un nmero.
nextFrame() nextScene() Number(expression:Obje

ct) : Number
Object([value:Object]) :
Object
Crea un nuevo objeto vaco o convierte en un objeto el nmero, la cadena o el valor booleano especificado. Especifica el evento de ratn o la pulsacin de tecla que activa una accin. Activa acciones definidas para una determinada instancia de un clip de pelcula. 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.
on(mouseEvent:Object)
onClipEvent(movieEvent:O
bject)
ord(character:String) :
Number
parseFloat(string:String) Convierte una cadena en un nmero de coma flotante.

: Number

Modificador es
Firma
Descripcin
parseInt(expression:Stri ng, [radix:Number]) : Number play() prevFrame() prevScene() random(value:Number) :

Number
Convierte una cadena en un entero.
Mueve la cabeza lectora hacia delante en la lnea de tiempo. Enva la cabeza lectora al fotograma anterior. Enva la cabeza lectora al fotograma 1 de la escena anterior. 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:O
bject)
Elimina el clip de pelcula especificado.
setInterval(functionName:O Llama a una funcin, un mtodo o un objeto en intervalos bject, interval:Number, peridicos durante la reproduccin de un archivo SWF. [param:Object], objectName:Object, methodName:String) : Number setProperty(target:Object Cambia un valor de propiedad de un clip de pelcula durante la , property:Object, reproduccin del clip de pelcula.
expression:Object)
startDrag(target:Object,
[lock:Boolean], [left,top,right,bottom :Number])
Permite arrastrar el clip de pelcula target durante la reproduccin de la pelcula.
stop() stopAllSounds()
Detiene el archivo SWF que se est reproduciendo. Detiene todos los sonidos que se estn reproduciendo en un archivo SWF sin detener la cabeza lectora. Detiene la operacin de arrastre actual. Devuelve una representacin de cadena del parmetro especificado. Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse String.substr(). Extrae parte de una cadena. Devuelve una cadena que contiene la ruta de destino de movieClipObject. 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.
stopDrag() String(expression:Object
) : String
substring(string:String,
index:Number, count:Number) : String
targetPath(targetObject:
Object) : String
tellTarget(target:String, statement(s):Object)
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.

Modificador es
Firma
Descripcin 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. Elimina un clip de pelcula que se carg mediante loadMovie() desde Flash Player.
unescape(string:String)
: String
unloadMovie(target)
unloadMovieNum(level:Nu Elimina un archivo SWF o una imagen que se carg mediante mber) loadMovieNum() desde Flash Player.
Array, funcin
Array(): 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. Disponibilidad Flash Lite 2.0 Parmetros
numElements [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 devuelto Array - 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

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 tambin
Array
Boolean, funcin
Boolean(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. Disponibilidad Flash Lite 2.0 Parmetros
expression:Object - Una expresin para convertir en un valor booleano.
Valor devuelto Boolean - 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 tambin
Boolean
call, funcin
call(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. Disponibilidad Flash Lite 1.0

Parmetros
frame:Object - La etiqueta o el nmero de un fotograma en la lnea de tiempo.
Vase tambin
Array, funcin, call (mtodo Function.call)
chr, funcin
chr(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. Disponibilidad Flash Lite 1.0 Parmetros
number:Number - Un nmero de cdigo ASCII.
Valor devuelto
String - El valor de carcter del cdigo ASCII especificado.
Ejemplo El ejemplo siguiente convierte el nmero 65 en la letra A y la asigna a la variable myVar: myVar = chr(65); Vase tambin
fromCharCode (mtodo String.fromCharCode)
clearInterval, funcin
clearInterval(intervalID:Number) : Void
Cancela un intervalo creado por una llamada a setInterval(). Disponibilidad Flash Lite 2.0 Parmetros
intervalID:Number - Un identificador numrico (entero) devuelto desde una llamada a setInterval().
Ejemplo El 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 tambin
setInterval, funcin
duplicateMovieClip, funcin
duplicateMovieClip(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(). Disponibilidad Flash Lite 2.0 Parmetros
target: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.
Ejemplo En 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 tambin
removeMovieClip, funcin, duplicateMovieClip (mtodo MovieClip.duplicateMovieClip), removeMovieClip (mtodo MovieClip.removeMovieClip)
escape, funcin
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 %. 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 (%). Disponibilidad Flash Lite 2.0 Parmetros
expression:String - Expresin para convertir en una cadena y codificar en un formato URL codificado.
Valor devuelto String - Cadena con codificacin URL. Ejemplo El siguiente cdigo da como resultado someuser%40somedomain%2Ecom:
var email:String = "someuser@somedomain.com"; 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 tambin
unescape, funcin
eval, funcin
eval(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");
Disponibilidad Flash Lite 1.0 Parmetros

expression: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 devuelto Object - Un valor, una referencia a un objeto o clip de pelcula, o undefined. Ejemplo El 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 <= 3; i++) { setProperty(eval("square"+i+"_mc"), _rotation, 5); }
Tambin puede utilizar el cdigo ActionScript siguiente:

for (var i = 1; i <= 3; i++) { this["square"+i+"_mc"]._rotation = -5; }
Vase tambin Array, set variable, sentencia
fscommand, funcin
fscommand(command:String, parameters:String) : Void
La funcin fscommand() permite que un archivo SWF se comunique con el reproductor Flash Lite o con el entorno para un dispositivo mvil (como un sistema operativo). Los parmetros definen el nombre de la aplicacin que se inicia y sus parmetros correspondientes, separados por comas.

Comando
launch
Parmetros
application-path, arg1, arg2,..., argn
Propsito 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).
activateTextFiel d
"" (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.

command: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.
Ejemplo En 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, funcin
fscommand2(command:String, parameter1:String,...parameterN:String) : Void

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. Disponibilidad Flash Lite 1.1 Comandos fscommand2() desfasados En Flash Lite 2.0, algunos comandos fscommand2() de Flash Lite 1.1 estn desfasados. La siguiente tabla muestra los comandos desfasados fscommand2():
Comando Escape GetDateDay GetDateMonth GetDateWeekday GetDateYear GetLanguage GetLocaleLongDate GetLocaleShortDate GetLocaleTime GetTimeHours GetTimeMinutes GetTimeSeconds GetTimeZoneOffset SetQuality Unescape En su lugar debe utilizarse
Funcin global escape
Mtodo getDate() del objeto Date Mtodo getMonth() del objeto Date Mtodo getDay() del objeto Date Mtodo getYear() del objeto Date
Propiedad System.capabilities.language
Mtodo getLocaleLongDate() del objeto Date Mtodo getLocaleShortDate() del objeto Date Mtodo getLocaleTime() del objeto Date Mtodo getHours() del objeto Date Mtodo getMinutes() del objeto Date Mtodo getSeconds() del objeto Date Mtodo getTimeZoneOffset() del objeto Date
MovieClip._quality
Funcin global unescape()

Parmetros
command: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, funcin
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. Disponibilidad Flash Lite 1.0 Parmetros
my_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 devuelto
Object - Valor de la propiedad especificada.
Ejemplo El 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, funcin
getTimer() : Number
Devuelve el nmero de milisegundos transcurridos desde que se inici la reproduccin del archivo SWF. Disponibilidad Flash Lite 1.0 Valor devuelto Number - Nmero de milisegundos transcurridos desde que se inici la reproduccin del archivo SWF. Ejemplo En 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, funcin
getURL(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. Disponibilidad Flash Lite 1.0 Parmetros
url: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.
Ejemplo Este 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:you@somedomain.com"); };
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 tambin
loadVariables, funcin, send (mtodo XML.send), sendAndLoad (mtodo XML.sendAndLoad)
getVersion, funcin
getVersion() : 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. Disponibilidad Flash Lite 2.0 Valor devuelto
String - Cadena que contiene informacin de la versin de Flash Player y de la plataforma.
Ejemplo Los 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 tambin
os (propiedad capabilities.os), version (propiedad capabilities.version)

gotoAndPlay, funcin
gotoAndPlay( [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. Disponibilidad Flash Lite 1.0 Parmetros
scene :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.
Ejemplo En 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 tambin
gotoAndPlay (mtodo MovieClip.gotoAndPlay), nextFrame, funcin, play, funcin, prevFrame, funcin
gotoAndStop, funcin
gotoAndStop( [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. Disponibilidad Flash Lite 1.0 Parmetros
scene :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.
Ejemplo En 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 tambin
gotoAndStop (mtodo MovieClip.gotoAndStop), stop, funcin, play, funcin, gotoAndPlay, funcin
ifFrameLoaded, funcin
ifFrameLoaded( [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. Disponibilidad Flash Lite 1.0 Parmetros
scene: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 tambin

addListener (mtodo MovieClipLoader.addListener)

int, funcin
int(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.

value:Number - Un nmero que se redondear a un entero.
Valor devuelto Number - El valor de entero truncado. Vase tambin

round (mtodo Math.round), floor (mtodo Math.floor), ceil (mtodo Math.ceil)
isFinite, funcin
isFinite(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. Disponibilidad Flash Lite 2.0 Parmetros
expression:Object - Valor booleano, variable u otra expresin que se va a evaluar.
Valor devuelto Boolean - Valor booleano. Ejemplo El ejemplo siguiente muestra los valores devueltos para isFinite:
isFinite(56) // returns true isFinite(Number.POSITIVE_INFINITY) //returns false
isNaN, funcin
isNaN(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.


expression:Object - Variable booleana u otra expresin que se va a evaluar.
Valor devuelto Boolean - Valor booleano. Ejemplo El 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 tambin
NaN, constante, NaN (propiedad Number.NaN)
length, funcin
length(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. Disponibilidad Flash Lite 1.0 Parmetros
expression:String - Una cadena. variable:Object - El nombre de una variable.

Valor devuelto Number - La longitud de la cadena o la variable especificada. Ejemplo El 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, funcin
loadMovie(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(). Disponibilidad Flash Lite 1.1 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. Ejemplo Sintaxis 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, funcin
loadMovieNum(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(). Disponibilidad Flash Lite 1.1 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. 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. Ejemplo El 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 tambin
unloadMovieNum, funcin, loadMovie, funcin, loadClip (mtodo MovieClipLoader.loadClip), _level, propiedad
loadVariables, funcin
loadVariables(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(). Disponibilidad Flash Lite 1.1 Parmetros
url: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. 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. Ejemplo El 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 tambin
loadVariablesNum, funcin, loadMovie, funcin, loadMovieNum, funcin, getURL, funcin, loadMovie (mtodo MovieClip.loadMovie)loadVariables (mtodo MovieClip.loadVariables), load (mtodo LoadVars.load)
loadVariablesNum, funcin
loadVariablesNum(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(). Disponibilidad Flash Lite 1.1 Parmetros
url: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.
level:Number - Entero que especifica el nivel de Flash Player donde se van a recibir las variables. 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.

Ejemplo El ejemplo siguiente carga informacin desde un archivo de texto llamado params.txt en la lnea de tiempo principal del SWF en el nivel 2 de Flash Player. Los nombres de las variables de los campos de texto deben coincidir con los de las variables del archivo params.txt. La funcin setInterval() sirve para comprobar el progreso de los datos que se estn cargando en el SWF. El guin busca en el archivo params.txt una variable denominada done.
loadVariablesNum("params.txt", 2); function checkParamsLoaded() { if (_level2.done == undefined) { trace("not yet."); } else { trace("finished loading. killing interval."); trace("-------------"); for (i in _level2) { trace(i+": "+_level2[i]); } trace("-------------"); clearInterval(param_interval); } } var param_interval = setInterval(checkParamsLoaded, 100); // Params.txt includes the following text var1="hello"&var2="goodbye"&done="done"
Vase tambin
getURL, funcin, loadMovie, funcin, loadMovieNum, funcin, loadVariables, funcin, loadMovie (mtodo MovieClip.loadMovie)loadVariables (mtodo MovieClip.loadVariables), load (mtodo LoadVars.load)
mbchr, funcin
mbchr(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. Disponibilidad Flash Lite 1.0 Parmetros
number:Number - El nmero que se va a convertir en un carcter multibyte.
Vase tambin
mblength, funcin
mblength(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. Disponibilidad Flash Lite 1.0 Parmetros
string:String - La cadena que se va a medir.
Valor devuelto
Number - La longitud de la cadena de caracteres multibyte.
Vase tambin String, length (propiedad String.length)
mbord, funcin
mbord(character) : 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. Disponibilidad Flash Lite 1.0 Parmetros
character:String - El carcter que se va a convertir en un nmero multibyte.
Valor devuelto
Number - El carcter convertido.
Vase tambin
charCodeAt (mtodo String.charCodeAt)
mbsubstring, funcin
mbsubstring(value, index, count) : 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. Disponibilidad Flash Lite 1.0 Parmetros
value:String - La cadena multibyte de la que se va a extraer una nueva cadena multibyte. index:Number - El nmero del primer carcter que se va a extraer.

count:Number - El nmero de caracteres que se va a incluir en la cadena extrada, excluido el carcter de ndice.
Valor devuelto String - La cadena extrada de la cadena de caracteres multibyte. Vase tambin
substr (mtodo String.substr)
nextFrame, funcin
nextFrame() : Void
Enva la cabeza lectora al siguiente fotograma. Disponibilidad Flash Lite 1.0 Ejemplo En el ejemplo siguiente, cuando el usuario pulsa la tecla de flecha derecha o abajo, la cabeza lectora pasa al siguiente fotograma y se detiene. Si el usuario pulsa la tecla izquierda o arriba, la cabeza lectora pasa al fotograma anterior y se detiene. El detector se inicializa para esperar a que se pulse la tecla de flecha y la variable init se utiliza para evitar que el detector se redefina si la cabeza lectora vuelve al fotograma 1.
stop(); if (init == undefined) { someListener = new Object(); someListener.onKeyDown = function() { if (Key.isDown(Key.LEFT) || Key.isDown(Key.UP)) { _level0.prevFrame(); } else if (Key.isDown(Key.RIGHT) || Key.isDown(Key.DOWN)) { _level0.nextFrame(); } }; Key.addListener(someListener); init = 1; }
Vase tambin
prevFrame, funcin
nextScene, funcin
nextScene() : Void
Enva la cabeza lectora al fotograma 1 de la siguiente escena. Disponibilidad Flash Lite 1.0

Ejemplo En el ejemplo siguiente, cuando un usuario hace clic en el botn que se crea en tiempo de ejecucin, la cabeza lectora se enva al fotograma 1 de la escena siguiente. Cree dos escenas e introduzca el cdigo ActionScript siguiente en el fotograma 1 de la escena 1.
stop(); if (init == undefined) { this.createEmptyMovieClip("nextscene_mc", this.getNextHighestDepth()); nextscene_mc.createTextField("nextscene_txt", this.getNextHighestDepth(), 200, 0, 100, 22); nextscene_mc.nextscene_txt.autoSize = true; nextscene_mc.nextscene_txt.border = true; nextscene_mc.nextscene_txt.text = "Next Scene"; this.createEmptyMovieClip("prevscene_mc", this.getNextHighestDepth()); prevscene_mc.createTextField("prevscene_txt", this.getNextHighestDepth(), 00, 0, 100, 22); prevscene_mc.prevscene_txt.autoSize = true; prevscene_mc.prevscene_txt.border = true; prevscene_mc.prevscene_txt.text = "Prev Scene"; nextscene_mc.onRelease = function() { nextScene(); }; prevscene_mc.onRelease = function() { prevScene(); }; init = true; }
Asegrese de insertar una accin stop() en el fotograma 1 de la escena 2. Vase tambin

prevScene, funcin
Number, funcin
Number(expression) : Number
Convierte el parmetro expression en un nmero y devuelve un valor como se describe en la siguiente lista:
Si expression es un nmero, el valor devuelto es expression. Si expression es un valor booleano, el valor devuelto es 1 si expression es true y 0 si expression es false. Si expression es una cadena, la funcin intenta analizar expression como un nmero decimal con un exponente final
opcional (es decir, 1.57505e-3).
Si expression es NaN, el valor devuelto es NaN. Si expression es undefined, el valor devuelto es el siguiente: - En los archivos publicados para Flash Player 6 o anterior, el valor es 0. - En los archivos publicados para Flash Player 7 o versiones posteriores, el resultado es NaN.


expression:Object - Expresin para convertir en un nmero. Los nmeros o las cadenas que comienzan por 0x se interpretan como valores hexadecimales. Los nmeros o las cadenas que comienzan por 0 se interpretan como valores octales.
Valor devuelto Number - Un nmero o NaN (no es un nmero). Ejemplo En el ejemplo siguiente se crea un campo de texto en el escenario en tiempo de ejecucin:
this.createTextField("counter_txt", this.getNextHighestDepth(), 0, 0, 100, 22); counter_txt.autoSize = true; counter_txt.text = 0; function incrementInterval():Void { var counter:Number = counter_txt.text; // Without the Number() function, Flash would concatenate the value instead // of adding values. You could also use "counter_txt.text++;" counter_txt.text = Number(counter) + 1; } var intervalID:Number = setInterval(incrementInterval, 1000);
Vase tambin
NaN, constante, Number, parseInt, funcin, parseFloat, funcin
Object, funcin
Object( [value] ) : Object
Crea un nuevo objeto vaco o convierte en un objeto el nmero, la cadena o el valor booleano especificado. Este comando equivale a crear un objeto mediante el constructor de Object (vase "Constructor de la clase Object"). Disponibilidad Flash Lite 2.0 Parmetros
value:Object [opcional] - Un nmero, cadena o valor booleano.
Valor devuelto Object - Un objeto. Ejemplo En el ejemplo siguiente se crea un nuevo objeto vaco y, a continuacin, el objeto se llena de valores:

var company:Object = new Object(); company.name = "Macromedia, Inc."; company.address = "600 Townsend Street"; company.city = "San Francisco"; company.state = "CA"; company.postal = "94103"; for (var i in company) { trace("company."+i+" = "+company[i]); }
Vase tambin
Object
on, controlador
on(mouseEvent:Object) { // your statements here }
Especifica el evento de ratn o la pulsacin de tecla que activa una accin. Disponibilidad Flash Lite 2.0 Parmetros
mouseEvent:Object - Un mouseEvent es un desencadenante denominado evento. Cuando se produce el evento, se ejecutan las sentencias que aparecen a continuacin entre llaves ({ }). Puede especificarse cualquiera de los siguientes valores para el parmetro mouseEvent:
press Se presiona el botn del ratn mientras el puntero se encuentra sobre el botn. release Se suelta el botn del ratn mientras el puntero se encuentra sobre el botn. releaseOutside Mientras el puntero se encuentra sobre el botn, se presiona el botn del ratn, se desplaza fuera del rea del botn y se suelta. Tanto el evento press como dragOut siempre son anteriores a un evento releaseOutside. (Este evento se admite en Flash Lite slo si System.capabilities.hasMouse es true o System.capabilities.hasStylus es true.) rollOut El puntero se desplaza fuera del rea del botn. (Este evento se admite en Flash Lite slo si System.capabilities.hasMouse es true o System.capabilities.hasStylus es true.)
rollOver El puntero del ratn se desplaza sobre el botn. dragOut Mientras el puntero se encuentra sobre el botn, se presiona el botn del ratn y se desplaza fuera del rea
del botn.
dragOver Mientras el puntero se encuentra sobre el botn, se presiona el botn del ratn, a continuacin se
desplaza fuera del botn y luego se vuelve a desplazar sobre l.

keyPress "<key>" Se presiona la tecla especificada. En la parte key del parmetro, especifique una constante de tecla, tal y como se muestra en la sugerencia de cdigo del panel Acciones. Puede utilizar este parmetro para interceptar una pulsacin de tecla, es decir, para sustituir cualquier comportamiento incorporado por la tecla especificada. El botn puede encontrarse en cualquier lugar de la aplicacin, ya sea dentro o fuera del escenario. Una limitacin de esta tcnica es que no se puede aplicar el controlador on() en tiempo de ejecucin, sino que debe hacerse durante la edicin. Asegrese de que selecciona Control > Deshabilitar mtodos abreviados de teclado, ya que, de lo contrario, algunas teclas con comportamiento incorporado no se sustituirn cuando pruebe la aplicacin empleando Control > Probar pelcula.
Para ver una lista de las constantes de teclas, consulte la clase Key.

Ejemplo En el guin siguiente, la funcin startDrag() se ejecuta cuando se pulsa el ratn y el guin condicional se ejecuta cuando se suelta el botn del ratn y se coloca el objeto:
on (press) { startDrag(this); } on (release) { trace("X:"+this._x); trace("Y:"+this._y); stopDrag(); }
Vase tambin
onClipEvent, controlador, Key
onClipEvent, controlador
onClipEvent(movieEvent:Object) { // your statements here }
Activa acciones definidas para una determinada instancia de un clip de pelcula. Disponibilidad Flash Lite 2.0 Parmetros
movieEvent:Object - Un movieEvent es un desencadenante denominado evento. Cuando se produce el evento, se ejecutan las sentencias que aparecen a continuacin entre llaves ({}). Puede especificarse cualquiera de los siguientes valores para el parmetro movieEvent:
load La accin se inicia tan pronto como se crea una instancia del clip de pelcula y aparece en la lnea de tiempo. unload La accin se inicia en el primer fotograma despus de eliminar el clip de pelcula de la lnea de tiempo. Las
acciones asociadas con el evento de clip de pelcula Unload se procesan antes de aadir ninguna accin al fotograma afectado.
enterFrame La accin se gatilla continuamente a la velocidad de fotogramas del clip de pelcula. Las acciones
asociadas con el evento de clip enterFrame se procesan antes de aadir ninguna accin a los fotogramas afectados.
mouseMove La accin se inicia cada vez que se mueve el ratn. Utilice las propiedades _xmouse e _ymouse para determinar la posicin actual del ratn. (Este evento se admite en Flash Lite slo si System.capabilities.hasMouse es true.) mouseDown La accin se inicia cuando se presiona el botn izquierdo del ratn. (Este evento se admite en Flash Lite slo si System.capabilities.hasMouse es true o System.capabilities.hasStylus es true. mouseUp La accin se inicia cuando se suelta el botn izquierdo del ratn. (Este evento se admite en Flash Lite slo
si System.capabilities.hasMouse es true o System.capabilities.hasStylus es true.

keyDown La accin se inicia cuando se presiona una tecla. Utilice Key.getCode() para recuperar informacin
sobre la ltima tecla presionada.

keyUp La accin se inicia cuando se suelta una tecla. Utilice el mtodo Key.getCode() para recuperar informacin
sobre la ltima tecla presionada.

data La accin se inicia cuando se reciben datos en una accin loadVariables() o loadMovie(). Si se especifica con una accin loadVariables(), el evento data slo se produce una vez, concretamente cuando se carga la ltima variable. Si se especifica con una accin loadMovie(), el evento data se produce repetidas veces, cuando se recupera cada una de las porciones de datos.
Ejemplo El ejemplo siguiente utiliza onClipEvent() con el evento de pelcula keyDown y est diseado para asociarse a un clip de pelcula o a un botn. El evento de pelcula keyDown suele emplearse con uno o varios mtodos o propiedades del objeto Key. El guin siguiente utiliza Key.getCode() para averiguar qu tecla ha pulsado el usuario; si la tecla pulsada coincide con la propiedad Key.RIGHT, la cabeza lectora se enviar al siguiente fotograma; si la tecla pulsada coincide con la propiedad Key.LEFT, la cabeza lectora se enviar al fotograma anterior.
onClipEvent (keyDown) { if (Key.getCode() == Key.RIGHT) { this._parent.nextFrame(); } else if (Key.getCode() == Key.LEFT) { this._parent.prevFrame(); } }
El siguiente ejemplo utiliza onClipEvent() con los eventos de pelcula load y mouseMove. Las propiedades _xmouse e _ymouse realizan un seguimiento de la posicin del ratn cada vez que ste se mueve. Dicha posicin aparece en el campo de texto que se crea en tiempo de ejecucin.
onClipEvent (load) { this.createTextField("coords_txt", this.getNextHighestDepth(), 0, 0, 100, 22); coords_txt.autoSize = true; coords_txt.selectable = false; } onClipEvent (mouseMove) { coords_txt.text = "X:"+_root._xmouse+",Y:"+_root._ymouse; }
Vase tambin Key, _xmouse (propiedad MovieClip._xmouse), _ymouse (propiedad MovieClip._ymouse), Constantes
ord, funcin
ord(character) : 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. Disponibilidad Flash Lite 1.0 Parmetros
character:String - El carcter que se va a convertir en un nmero del cdigo ASCII.
Valor devuelto
Number - El nmero del cdigo ASCII del carcter especificado.

Vase tambin String, charCodeAt (mtodo String.charCodeAt)
parseFloat, funcin
parseFloat(string:String) : Number
Convierte una cadena en un nmero de coma flotante. La funcin lee, o analiza, y devuelve los nmeros en una cadena hasta que se alcanza un carcter que no forma parte del nmero inicial. Si la cadena no empieza por un nmero que pueda analizarse, parseFloat() devuelve NaN. Se ignoran los espacios en blanco que preceden a los enteros vlidos, y tambin los caracteres no numricos finales. Disponibilidad Flash Lite 2.0 Parmetros
string:String - Cadena que se va a leer y convertir en un nmero de coma flotante.
Valor devuelto
Number - Un nmero o NaN (no es un nmero).
Ejemplo Los ejemplos siguientes utilizan la funcin parseFloat() para evaluar distintos tipos de nmeros:
trace(parseFloat("-2")); // output: -2 trace(parseFloat("2.5")); // output: 2.5 trace(parseFloat(" 2.5")); // output: 2.5 trace(parseFloat("3.5e6")); // output: 3500000 trace(parseFloat("foobar")); // output: NaN trace(parseFloat("3.75math")); // output: 3.75 trace(parseFloat("0garbage")); // output: 0
Vase tambin
NaN, constante, parseInt, funcin
parseInt, funcin
parseInt(expression:String [, radix:Number]) : Number
Convierte una cadena en un entero. Si la cadena especificada en los parmetros no puede convertirse en un nmero, la funcin devuelve NaN. Las cadenas que empiezan con 0x se interpretan como nmeros hexadecimales. Los enteros que empiezan con 0 o que especifican una base de 8 se interpretan como nmeros octales. Se ignoran los espacios en blanco que preceden a los enteros vlidos, y tambin los caracteres no numricos finales. Disponibilidad Flash Lite 2.0 Parmetros
expression:String - Cadena que se va a convertir en un entero. radix:Number [opcional] - Entero que representa la base (radix) del nmero que se va a analizar. Los valores vlidos
van de 2 a 36.

Valor devuelto Number - Un nmero o NaN (no es un nmero). Ejemplo Los ejemplos de esta seccin utilizan la funcin parseInt() para evaluar distintos tipos de nmeros. El ejemplo siguiente devuelve 3:
parseInt("3.5")
El ejemplo siguiente devuelve NaN:

parseInt("bar")
El ejemplo siguiente devuelve 4:

parseInt("4foo")
El ejemplo siguiente muestra una conversin hexadecimal que devuelve 1016:

parseInt("0x3F8")
El ejemplo siguiente muestra una conversin hexadecimal que utiliza el parmetro opcional radix y devuelve 1000:
parseInt("3E8", 16)
El ejemplo siguiente muestra una conversin binaria y devuelve 10, que es la representacin decimal del 1010 binario:
parseInt("1010", 2)
Los ejemplos siguientes incluyen anlisis de nmeros octales y devuelven 511, que es la representacin decimal del 777 octal:
parseInt("0777") parseInt("777", 8)
Vase tambin
NaN, constante, parseFloat, funcin
play, funcin
play() : Void
Mueve la cabeza lectora hacia delante en la lnea de tiempo. Disponibilidad Flash Lite 1.0 Ejemplo En el ejemplo siguiente hay dos instancias de clip de pelcula en el escenario con los nombres stop_mc y play_mc. El cdigo ActionScript detiene la reproduccin del archivo SWF cuando se hace clic en la instancia de clip de pelcula stop_mc. La reproduccin se reanuda cuando se hace clic en la instancia play_mc.

this.stop_mc.onRelease = function() { stop(); }; this.play_mc.onRelease = function() { play(); }; trace("frame 1");
Vase tambin
gotoAndPlay, funcin, gotoAndPlay (mtodo MovieClip.gotoAndPlay)
prevFrame, funcin
prevFrame() : Void
Enva la cabeza lectora al fotograma anterior. Si el fotograma actual es el fotograma 1, la cabeza lectora no se mueve. Disponibilidad Flash Lite 1.0 Ejemplo Cuando el usuario hace clic en un botn llamado myBtn_btn y se inserta el cdigo ActionScript siguiente en un fotograma de la lnea de tiempo para ese botn, la cabeza lectora se enva al fotograma anterior:
stop(); this.myBtn_btn.onRelease = function(){ prevFrame(); };
Vase tambin
nextFrame, funcin, prevFrame (mtodo MovieClip.prevFrame)
prevScene, funcin
prevScene() : Void
Enva la cabeza lectora al fotograma 1 de la escena anterior. Disponibilidad Flash Lite 1.0 Vase tambin
nextScene, funcin
random, funcin
random(value) : 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.


value:Number - Un entero.
Valor devuelto Number - Un entero aleatorio. Ejemplo El uso siguiente de random() devuelve un valor de 0, 1, 2, 3 4: random(5); Vase tambin
random (mtodo Math.random)
removeMovieClip, funcin
removeMovieClip(target:Object)
Elimina el clip de pelcula especificado. Disponibilidad Flash Lite 1.0 Parmetros

target:Object - La ruta de destino de una instancia de clip de pelcula creado con duplicateMovieClip() o el nombre de la instancia de un clip de pelcula creado con MovieClip.attachMovie(), MovieClip.duplicateMovieClip(), o MovieClip.createEmptyMovieClip().
Ejemplo El ejemplo siguiente crea un clip de pelcula nuevo llamado myClip_mc y lo duplica. El segundo clip de pelcula se llama newClip_mc. Las imgenes se cargan en ambos clips de pelcula. Cuando se hace clic en un botn, button_mc, el clip de pelcula duplicado se elimina del escenario.
this.createEmptyMovieClip("myClip_mc", this.getNextHighestDepth()); myClip_mc.loadMovie("http://www.helpexamples.com/flash/images/image1.jpg"); duplicateMovieClip(this.myClip_mc, "newClip_mc", this.getNextHighestDepth()); newClip_mc.loadMovie("http://www.helpexamples.com/flash/images/image1.jpg"); newClip_mc._x = 200; this.button_mc.onRelease = function() { removeMovieClip(this._parent.newClip_mc); };
Vase tambin
duplicateMovieClip, funcin, duplicateMovieClip (mtodo MovieClip.duplicateMovieClip), attachMovie (mtodo MovieClip.attachMovie), removeMovieClip (mtodo MovieClip.removeMovieClip)createEmptyMovieClip (mtodo MovieClip.createEmptyMovieClip)

setInterval, funcin
setInterval(functionName:Object, interval:Number [, param1:Object, param2, ..., paramN]) : Number setInterval(objectName:Object, methodName:String, interval:Number [, param1:Object, param2, ..., paramN]) : Number
Llama a una funcin, un mtodo o un objeto en intervalos peridicos durante la reproduccin de un archivo SWF. Puede utilizar una funcin de intervalo para actualizar las variables desde una base de datos o para actualizar la visualizacin del tiempo. Si interval es superior a la velocidad de fotogramas del archivo SWF, la funcin de intervalo slo se llamar cada vez que la cabeza lectora entre en un fotograma; de este modo se reduce el impacto cada vez que se actualice la pantalla. Nota: en Flash Lite 2.0, el intervalo pasado a este mtodo se omite si es inferior a la velocidad de fotogramas del archivo SWF y la funcin de intervalo se llama slo en el intervalo de la velocidad de fotogramas del archivo SWF. Si el intervalo es superior a la velocidad de fotogramas del archivo SWF, el evento se llama en el siguiente fotograma una vez transcurrido el intervalo. Disponibilidad Flash Lite 2.0 Parmetros
functionName:Object - Nombre de funcin o referencia a una funcin annima. interval:Number - El tiempo en milisegundos entre llamadas al parmetro functionName o methodName. param:Object [opcional] - Parmetros que se transmiten al parmetro functionName o methodName. Cuando hay
varios parmetros, deben ir separados por comas: param1,param2, ...,paramN.

objectName:Object - Objeto que contiene el mtodo methodName. methodName:String - Un mtodo de objectName.
Valor devuelto Number - Un entero que identifica que se puede pasar a clearInterval() para cancelar el intervalo. Ejemplo Sintaxis 1: El ejemplo siguiente llama a una funcin annima cada 1000 milisegundos (1 segundo).
setInterval( function(){ trace("interval called"); }, 1000 );
Sintaxis 2: El siguiente ejemplo define dos controladores de eventos y llama a cada uno de ellos. La primera llamada a setInterval() invoca la funcin callback1(), que incluye la sentencia trace(). La segunda llamada a setInterval() transmite la cadena "interval called" a la funcin callback2() como un parmetro.
function callback1() { trace("interval called"); } function callback2(arg) { trace(arg); } setInterval( callback1, 1000 ); setInterval( callback2, 1000, "interval called" );

Sintaxis 3: Este ejemplo utiliza un mtodo de un objeto. Se debe utilizar esta sintaxis si se desea llamar a un mtodo definido para un objeto.
obj = new Object(); obj.interval = function() { trace("interval function called"); } setInterval( obj, "interval", 1000 ); obj2 = new Object(); obj2.interval = function(s) { trace(s); } setInterval( obj2, "interval", 1000, "interval function called" );
Se debe utilizar el segundo formulario de la sintaxis setInterval() para llamar al mtodo de un objeto, tal como se muestra en el siguiente ejemplo:
setInterval( obj2, "interval", 1000, "interval function called" );
Cuando se trabaja con esta funcin, se debe tener cuidado con la memoria que se utiliza en un archivo SWF. Por ejemplo, cuando se elimina un clip de pelcula del archivo SWF, no se eliminar ninguna funcin setInterval() que se ejecute dentro de l. Elimine siempre la funcin setInterval() utilizando clearInterval() cuando haya terminado de utilizarlo, tal como se muestra en el siguiente ejemplo:
// create an event listener object for our MovieClipLoader instance var listenerObjectbject = new Object(); listenerObject.onLoadInit = function(target_mc:MovieClip) { trace("start interval"); /* after the target movie clip loaded, create a callback which executes about every 1000 ms (1 second) and calls the intervalFunc function. */ target_mc.myInterval = setInterval(intervalFunc, 1000, target_mc); }; function intervalFunc(target_mc) { // display a trivial message which displays the instance name and arbitrary text. trace(target_mc+" has been loaded for "+getTimer()/1000+" seconds."); /* when the target movie clip is clicked (and released) you clear the interval and remove the movie clip. If you don't clear the interval before deleting the movie clip, the function still calls itself every second even though the movie clip instance is no longer present. */ target_mc.onRelease = function() { trace("clear interval"); clearInterval(this.myInterval); // delete the target movie clip removeMovieClip(this); }; } var jpeg_mcl:MovieClipLoader = new MovieClipLoader(); jpeg_mcl.addListener(listenerObject); jpeg_mcl.loadClip("http://www.helpexamples.com/flash/images/image1.jpg", this.createEmptyMovieClip("jpeg_mc", this.getNextHighestDepth()));
Si trabaja con setInterval() dentro de las clases, necesitar asegurarse de que utiliza la palabra clave this cuando llame a la funcin. La funcin setInterval()no tiene acceso a los miembros de la clase si no se utiliza la palabra clave. Esto se ilustra en el siguiente ejemplo. Para un archivo FLA con un botn llamado deleteUser_btn, aada el siguiente cdigo ActionScript al fotograma 1:

var me:User = new User("Gary"); this.deleteUser_btn.onRelease = function() { trace("Goodbye, "+me.username); clearInterval(me.intervalID); delete me; };
A continuacin, cree un archivo llamado User.as en el mismo directorio que el archivo FLA. Introduzca el cdigo ActionScript siguiente:
class User { var intervalID:Number; var username:String; function User(param_username:String) { trace("Welcome, "+param_username); this.username = param_username; this.intervalID = setInterval(this, "traceUsername", 1000, this.username); } function traceUsername(str:String) { trace(this.username+" is "+getTimer()/1000+" seconds old, happy birthday."); } }
Vase tambin
clearInterval, funcin
setProperty, funcin
setProperty(target:Object, property:Object, expression:Object) : Void
Cambia un valor de propiedad de un clip de pelcula durante la reproduccin del clip de pelcula. Disponibilidad Flash Lite 1.0 Parmetros
target:Object - Ruta al nombre de instancia del clip de pelcula cuya propiedad va a establecerse. property:Object - Propiedad que va a establecerse. expression:Object - El nuevo valor literal de la propiedad o una ecuacin que da como resultado el nuevo valor de
la propiedad. Ejemplo El cdigo ActionScript siguiente crea un clip de pelcula nuevo y carga una imagen en l. Se establecen las coordenadas _x e _y para el clip utilizando setProperty(). Cuando se hace clic en el botn llamado right_btn, la coordenada _x de un clip de pelcula llamado params_mc se incrementa en 20 pxeles.
this.createEmptyMovieClip("params_mc", 999); params_mc.loadMovie("http://www.helpexamples.com/flash/images/image1.jpg"); setProperty(this.params_mc, _y, 20); setProperty(this.params_mc, _x, 20); this.right_btn.onRelease = function() { setProperty(params_mc, _x, getProperty(params_mc, _x)+20); };

Vase tambin
getProperty, funcin
startDrag, funcin
startDrag(target:Object [, lock:Boolean, left:Number, top:Number, right:Number, bottom:Number]) : Void
Permite arrastrar el clip de pelcula target durante la reproduccin de la pelcula. Slo un clip de pelcula puede arrastrarse al mismo tiempo. Tras ejecutar la operacin startDrag(), todava es posible arrastrar el clip de pelcula hasta que se detenga de forma explcita mediante stopDrag() o hasta que se llame a una accin startDrag() de otro clip de pelcula. Nota: este mtodo se admite en Flash Lite slo si System.capabilities.hasMouse es true o System.capabilities.hasStylus es true. Disponibilidad Flash Lite 2.0 Parmetros
target:Object - La ruta de destino del clip de pelcula que se va a arrastrar. lock:Boolean[opcional] - Valor booleano que especifica si el clip de pelcula arrastrable est bloqueado en el centro de la posicin del ratn (true) o en el punto donde el usuario hizo clic por primera vez en el clip de pelcula (false). left,top,right,bottom:Number [opcional] - Valores relativos a las coordenadas del elemento principal del clip de pelcula, que especifican un rectngulo limitado para el clip de pelcula.
Ejemplo El ejemplo siguiente crea un clip de pelcula, pic_mc, en tiempo de ejecucin que los usuarios pueden arrastrar a cualquier ubicacin asociando las acciones startDrag() y stopDrag() al clip de pelcula. Se carga una imagen en pic_mc empleando la clase MovieClipLoader.
var pic_mcl:MovieClipLoader = new MovieClipLoader(); pic_mcl.loadClip("http://www.helpexamples.com/flash/images/image1.jpg", this.createEmptyMovieClip("pic_mc", this.getNextHighestDepth())); var listenerObject:Object = new Object(); listenerObject.onLoadInit = function(target_mc) { target_mc.onPress = function() { startDrag(this); }; target_mc.onRelease = function() { stopDrag(); }; }; pic_mcl.addListener(listenerObject);
Vase tambin
stopDrag, funcin, _droptarget (propiedad MovieClip._droptarget, propiedad), startDrag (mtodo MovieClip.startDrag)
stop, funcin
stop() : Void

Detiene el archivo SWF que se est reproduciendo. El uso ms comn de esta accin es controlar clips de pelcula mediante botones. Disponibilidad Flash Lite 1.0 Vase tambin
gotoAndStop, funcin, gotoAndStop (mtodo MovieClip.gotoAndStop)
stopAllSounds, funcin
stopAllSounds() : Void
Detiene todos los sonidos que se estn reproduciendo en un archivo SWF sin detener la cabeza lectora. La reproduccin de los sonidos transmitidos en flujo se reanudar a medida que la cabeza lectora se mueva sobre los fotogramas donde se encuentran. Disponibilidad Flash Lite 1.0 Ejemplo El cdigo siguiente crea un archivo de texto en el que aparece informacin ID3 sobre la cancin. Se crea una instancia nueva del objeto Sound y se carga el MP3 en el archivo SWF. La informacin ID3 se extrae del archivo de sonido. Cuando el usuario hace clic en stop_mc, se hace una pausa en el sonido. Cuando el usuario hace clic en play_mc, la cancin se reanuda desde la posicin en pausa.
this.createTextField("songinfo_txt", this.getNextHighestDepth, 0, 0, Stage.width, 22); var bg_sound:Sound = new Sound(); bg_sound.loadSound("yourSong.mp3", true); bg_sound.onID3 = function() { songinfo_txt.text = "(" + this.id3.artist + ") " + this.id3.album + " - " + this.id3.track + " - " + this.id3.songname; for (prop in this.id3) { trace(prop+" = "+this.id3[prop]); } trace("ID3 loaded."); }; this.play_mc.onRelease = function() { /* get the current offset. if you stop all sounds and click the play button, the MP3 continues from where it was stopped, instead of restarting from the beginning. */ var numSecondsOffset:Number = (bg_sound.position/1000); bg_sound.start(numSecondsOffset); }; this.stop_mc.onRelease = function() { stopAllSounds(); };
Vase tambin
Sonido

stopDrag, funcin
stopDrag() : Void
Detiene la operacin de arrastre actual. Nota: este mtodo se admite en Flash Lite slo si System.capabilities.hasMouse es true o System.capabilities.hasStylus es true. Disponibilidad Flash Lite 2.0 Ejemplo El cdigo siguiente, situado en la lnea de tiempo principal, detiene la accin de arrastre en la instancia de clip de pelcula my_mc cuando el usuario suelta el botn del ratn:
my_mc.onPress = function () { startDrag(this); } my_mc.onRelease = function() { stopDrag(); }
Vase tambin
startDrag, funcin, _droptarget (propiedad MovieClip._droptarget, propiedad), startDrag (mtodo MovieClip.startDrag)stopDrag (mtodo MovieClip.stopDrag)
String, funcin
String(expression:Object) : String
Devuelve una representacin de cadena del parmetro especificado, tal y como se describe en la siguiente lista:
Si expression es un nmero, la cadena devuelta es una representacin en texto del nmero. Si expression es una cadena, la cadena devuelta es expression. Si expression es un objeto, el valor devuelto es una cadena que representa el objeto generado al llamar a la propiedad
de cadena del objeto o al llamar a Object.toString() si no existe la propiedad.
Si expression es un valor booleano, la cadena devuelta es "true" o "false". Si expression es un clip de pelcula, el valor devuelto es la ruta de destino del clip de pelcula en notacin con barras (/).
Si expression es undefined, los valores devueltos son los siguientes:
En los archivos publicados para Flash Player 6 o versiones anteriores, el resultado es una cadena vaca (""). En los archivos publicados para Flash Player 7 o versiones posteriores, el resultado es undefined.
Nota:ActionScript 2.0 no admite la notacin con barras. Disponibilidad Flash Lite 1.0 Parmetros
expression:Object - Expresin para convertir en una cadena.

Valor devuelto String - Una cadena. Ejemplo En el ejemplo siguiente, utilice ActionScript para convertir expresiones especificadas en una cadena:
var string1:String = String("3"); var string2:String = String("9"); trace(string1+string2); // output: 39
Dado que ambos parmetros son cadenas, los valores se concatenan en lugar de aadirse. Vase tambin
toString (mtodo Number.toString), toString (mtodo Object.toString), String, " operador de delimitador de cadena
substring, funcin
substring("string", index, count) : String
Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse String.substr(). Extrae parte de una cadena. Esta funcin se basa en uno, mientras que los mtodos del objeto String se basan en cero. Disponibilidad Flash Lite 1.0 Parmetros
string:String - La cadena de la que se va a extraer la nueva cadena. index:Number - El nmero del primer carcter que se va a extraer. count:Number - El nmero de caracteres que se va a incluir en la cadena extrada, excluido el carcter de ndice.
Valor devuelto String - La subcadena extrada. Vase tambin

targetPath, funcin
targetpath(targetObject:Object) : String
Devuelve una cadena que contiene la ruta de destino de un objeto MovieClip, Button o TextField. Para devolver la ruta de destino se utiliza la notacin con punto (.). Para recuperar la ruta de destino en notacin con barras (/), utilice la propiedad _target. Disponibilidad Flash Lite 2.0

Parmetros
targetObject:Object - Referencia (por ejemplo, _root o _parent ) al objeto para el que se recupera la ruta de destino. Puede ser un objeto MovieClip, Button o TextField.
Valor devuelto String - Cadena que contiene la ruta de destino del objeto especificado. Ejemplo El ejemplo siguiente realiza un seguimiento de la ruta de destino de un clip de pelcula en cuanto se carga:
this.createEmptyMovieClip("myClip_mc", this.getNextHighestDepth()); trace(targetPath(myClip_mc)); // _level0.myClip_mc
Vase tambin
eval, funcin
tellTarget, funcin
tellTarget("target") { statement(s); }
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. La accin tellTarget resulta til para los controles de navegacin. Asigne tellTarget a botones que detengan o inicien clips de pelcula en otros lugares del escenario. Tambin puede hacer que los clips de pelcula pasen a un determinado fotograma de ese clip. Por ejemplo, puede asignar tellTarget a botones que detienen o inician clips de pelcula en el escenario o que hacen que clips de pelcula pasen a un determinado fotograma. En Flash 5 o versiones posteriores, puede utilizar la notacin de puntos (.) en lugar de la accin tellTarget. Puede utilizar la accin with para emitir mltiples acciones en la misma lnea de tiempo. Puede utilizar la accin with para referirse a cualquier objeto, mientras que la accin tellTarget slo puede referirse a clips de pelcula. Disponibilidad Flash Lite 1.0 Parmetros
target:String - Una cadena que especifica la ruta de destino de la lnea de tiempo que se va a controlar. statement(s):Object - Instrucciones que se ejecutarn si la condicin da como resultado true.
Ejemplo Esta sentencia tellTarget controla la instancia del clip de pelcula ball en la lnea de tiempo principal. El fotograma 1 de la instancia ball est en blanco y tiene una accin stop() para que no sea visible en el escenario. Cuando se hace clic en el botn con la accin siguiente, tellTarget indica a la cabeza lectora en ball que pase al fotograma 2, donde comienza la animacin:
on(release) { tellTarget("_parent.ball") { gotoAndPlay(2); } }

El ejemplo siguiente utiliza la notacin con punto (.) para conseguir los mismos resultados:
on(release) { _parent.ball.gotoAndPlay(2); }
Si necesita emitir varios comandos a la instancia ball, puede emplear la accin with, como se muestra en la sentencia siguiente:
on(release) { with(_parent.ball) { gotoAndPlay(2); _alpha = 15; _xscale = 50; _yscale = 50; } }
Vase tambin
with, sentencia
toggleHighQuality, funcin
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. El suavizado alisa los bordes de los objetos y ralentiza la reproduccin del SWF. Esta accin afecta a todos los archivos SWF de Flash Player. Disponibilidad Flash Lite 1.0 Ejemplo El cdigo siguiente puede aplicarse a un botn que, cuando se hace clic en l, activa o desactiva el suavizado:
on(release) { toggleHighQuality(); }
Vase tambin
_highquality, propiedad, _quality, propiedad
trace, funcin
trace(expression:Object)
Puede usar el Reproductor de depuracin de Flash para capturar la salida de la funcin trace() y escribir dicha salida en el archivo de registro. La sentencia evala la expresin y muestra el resultado en el panel Salida en modo de prueba.

Utilice esta sentencia para registrar las notas de programacin o para mostrar mensajes en el panel Salida mientras prueba un archivo SWF. Utilice el parmetro expression para comprobar si existe una condicin o para mostrar valores en el panel Salida. La sentencia trace() es similar a la funcin alert de JavaScript. Puede utilizar el comando Omitir acciones de trazado del cuadro de dilogo Configuracin de publicacin para eliminar acciones trace() del archivo SWF exportado. Disponibilidad Flash Lite 1.0 Parmetros
expression:Object - Expresin que se va a evaluar. Cuando se abre un archivo SWF en la herramienta de edicin
Flash (mediante el comando Probar pelcula), el valor del parmetro expression se muestra en el panel Salida. Ejemplo El ejemplo siguiente utiliza una sentencia trace() para mostrar en el panel Salida los mtodos y propiedades del campo de texto creado dinmicamente llamado error_txt:
this.createTextField("error_txt", this.getNextHighestDepth(), 0, 0, 100, 22); for (var i in error_txt) { trace("error_txt."+i+" = "+error_txt[i]); } /* output: error_txt.styleSheet = undefined error_txt.mouseWheelEnabled = true error_txt.condenseWhite = false ... error_txt.maxscroll = 1 error_txt.scroll = 1 */
unescape, funcin
unescape(x: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. Disponibilidad Flash Lite 1.1 Parmetros
string:String - Cadena con secuencias hexadecimales que se van a interpretar literalmente.
Valor devuelto
String - Cadena decodificada de un parmetro URL codificado.
Ejemplo El ejemplo siguiente muestra el proceso de conversin de escape en unescape:

var email:String = "user@somedomain.com"; trace(email); var escapedEmail:String = escape(email); trace(escapedEmail); var unescapedEmail:String = unescape(escapedEmail); trace(unescapedEmail);

user@somedomain.com user%40somedomain%2Ecom user@somedomain.com
unloadMovie, funcin
unloadMovie(target:MovieClip) : Void unloadMovie(target:String) : Void
Elimina un clip de pelcula que se carg mediante loadMovie() desde Flash Player. Para descargar un clip de pelcula cargado mediante loadMovieNum(), use unloadMovieNum() en lugar de unloadMovie(). Disponibilidad Flash Lite 1.1 Parmetros target - Ruta de destino de un clip de pelcula. 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. Ejemplo El ejemplo siguiente crea un clip de pelcula nuevo llamado pic_mc y carga una imagen en l. Se carga utilizando la clase MovieClipLoader. Cuando se hace clic en la imagen, el clip de pelcula se descarga del archivo SWF:
var pic_mcl:MovieClipLoader = new MovieClipLoader(); pic_mcl.loadClip("http://www.helpexamples.com/flash/images/image1.jpg", this.createEmptyMovieClip("pic_mc", this.getNextHighestDepth())); var listenerObject:Object = new Object(); listenerObject.onLoadInit = function(target_mc) { target_mc.onRelease = function() { unloadMovie(pic_mc); /* or you could use the following, which refers to the movie clip referenced by 'target_mc'. */ //unloadMovie(this); }; }; pic_mcl.addListener(listenerObject);
Vase tambin
loadMovie (mtodo MovieClip.loadMovie), unloadClip (mtodo MovieClipLoader.unloadClip)
unloadMovieNum, funcin
unloadMovieNum(level:Number) : Void

Elimina un archivo SWF o una imagen que se carg mediante loadMovieNum() desde Flash Player. Para descargar un SWF o una imagen que se carg con MovieClip.loadMovie(), use unloadMovie() en lugar de unloadMovieNum(). Disponibilidad Flash Lite 1.1 Parmetros
level:Number - El nivel (_levelN) de una pelcula cargada.
Ejemplo El ejemplo siguiente carga una imagen en un archivo SWF. Cuando se hace clic en unload_btn, se elimina el contenido cargado.
loadMovieNum("yourimage.jpg", 1); unload_btn.onRelease = function() { unloadMovieNum(1); }
Vase tambin
loadMovieNum, funcin, unloadMovie, funcin, loadMovie (mtodo MovieClip.loadMovie)
Propiedades globales
Las propiedades globales estn disponibles en todos los guiones y son visibles en todas las lneas de tiempo y mbitos del documento. Por ejemplo, las propiedades globales permiten acceder a las lneas de tiempo de otros clips de pelcula cargados, tanto relativos (_parent) como absolutos (_root). Tambin permiten restringir (this) o ampliar el mbito (super). Adems, las propiedades globales pueden utilizarse para ajustar la configuracin en tiempo de ejecucin, como la accesibilidad del lector de pantalla, la calidad de la reproduccin y el tamao de bfer de sonido. Resumen de propiedades globales
Modificadores Propiedad $version Descripcin Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.version. Contiene el nmero de versin de Flash Lite. _cap4WayKeyAS Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.has4WayKeyAS. Indica si Flash Lite ejecuta expresiones de ActionScript aadidas a controladores de eventos de teclas asociados a las teclas de flecha derecha, izquierda, arriba y abajo. _capCompoundSound Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasCompoundSound. Indica si Flash Lite puede procesar datos de sonido compuestos.

Modificadores
Propiedad _capEmail
Descripcin Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasEmail. Indica si el cliente de Flash Lite puede enviar mensajes de correo electrnico utilizando el comando GetURL() de ActionScript.
_capLoadData
Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasDataLoading. Indica si la aplicacin host puede cargar datos adicionales de forma dinmica a travs de llamadas a las funciones loadMovie(), loadMovieNum(), loadVariables() y loadVariablesNum().
_capMFi
Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasMFi. Indica si el dispositivo puede reproducir datos de sonido en formato de audio MFi (Melody Format for i-mode, Formato de meloda para i-mode).
_capMIDI
Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasMIDI. Indica si el dispositivo puede reproducir datos de sonido en formato de audio EDI (Electronic Data Interchange, Intercambio electrnico de datos).
_capMMS
Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasMMS. Indica si Flash Lite puede enviar mensajes MMS (Multimedia Messaging Service, Servicio de mensajera multimedia) utilizando el comando GetURL() de ActionScript. En caso afirmativo, esta variable est definida y tiene el el valor 1; en caso contrario, no est definida.
_capSMAF
Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasSMAF. Indica si el dispositivo puede reproducir archivos multimedia en formato SMAF (Synthetic music Mobile Application Format, Formato de aplicaciones mviles para msica con sintetizador). En caso afirmativo, esta variable est definida y tiene el el valor 1; en caso contrario, no est definida.
_capSMS
Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasSMS. Indica si Flash Lite puede enviar mensajes SMS (Short Message Service, Servicio de Mensajes Cortos) mediante el comando GetURL() de ActionScript.
_capStreamSound
Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasStreamingAudio. Indica si el dispositivo puede reproducir flujo de sonido (sincronizado).

Modificadores
Propiedad _focusrect
Descripcin Propiedad (global); especifica si aparece un rectngulo amarillo alrededor del botn o clip de pelcula que se selecciona con el teclado. Indica al reproductor Flash Lite que represente a la velocidad de fotogramas especificada. Referencia al objeto global que aloja las clases principales de ActionScript, como String, Object, Math y Array. Desfasada desde Flash Player 5. Esta propiedad est desfasada y en su lugar debe utilizarse _quality. Especifica el nivel de suavizado que se aplica al archivo SWF actual.
_forceframerate
_global
_highquality
_level maxscroll
Referencia a la lnea de tiempo raz de _levelN. Desfasada desde Flash Player 5. Esta propiedad est desfasada y en su lugar debe utilizarse TextField.maxscroll. Indica el nmero de lnea de la lnea superior de texto visible en un campo de texto cuando la lnea inferior del campo tambin est visible.
_parent
Especifica o devuelve una referencia al clip de pelcula u objeto que contiene el clip de pelcula u objeto actual. Establece o recupera la calidad de representacin que se utiliza para un clip de pelcula. Especifica o devuelve una referencia a la lnea de tiempo del clip de pelcula raz. Desfasada desde Flash Player 5. Esta propiedad est desfasada y en su lugar debe utilizarse TextField.scroll. Controla la visualizacin de informacin en un campo de texto asociado a una variable.
_quality
_root
scroll
_soundbuftime
Establece el nmero de segundos de flujo de sonido que se va a almacenar en el bfer. Hace referencia a una instancia de clip de pelcula u objeto.
this
$version, propiedad
$version
Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.version. Variable de cadena; contiene el nmero de versin de Flash Lite. Contiene un nmero superior, un nmero inferior, un nmero de versin y un nmero de versin interno, que suele ser 0 en todas las versiones publicadas. El nmero superior para todos los productos Flash Lite 1.x es 5. El nmero inferior de Flash Lite 1.0 es 1; el nmero inferior de Flash Lite 1.1 es 2. Disponibilidad Flash Lite 1.1

Ejemplo En el reproductor de Flash Lite 1.1, el cdigo siguiente establece el valor de myVersion como "5, 2, 12, 0":
myVersion = $version;
Vase tambin
version (propiedad capabilities.version)
_cap4WayKeyAS, propiedad
_cap4WayKeyAS
Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.has4WayKeyAS. Variable numrica; indica si Flash Lite ejecuta expresiones de ActionScript aadidas a controladores de eventos de teclas asociados a las teclas de flecha derecha, izquierda, arriba y abajo. La variable est definida y su valor es 1 slo cuando la aplicacin host utiliza el modo de navegacin con tecla de cuatro direcciones para desplazarse por los controles de Flash (los botones y los campos de introduccin de texto). En caso contrario, la variable no est definida. Al pulsar una de las teclas de cuatro direcciones, si el valor de la variable _cap4WayKeyAS es 1, Flash Lite buscar primero un controlador para dicha tecla. Si no encuentra ninguno, Flash pasa a controlar el desplazamiento. Sin embargo, si se encuentra un controlador de eventos, no se produce la navegacin correspondiente a esa tecla. Por ejemplo, si se encuentra un controlador de pulsacin de tecla para la tecla de flecha abajo, el usuario no podr navegar. Disponibilidad Flash Lite 1.1 Ejemplo El siguiente ejemplo establece canUse4Way en 1 en Flash Lite 1.1, pero lo deja como undefined en Flash Lite 1.0 (no obstante, no todos los telfonos con Flash Lite 1.1 admiten teclas de cuatro direcciones, por lo que este cdigo depende del telfono):
canUse4Way = _cap4WayKeyAS; if (canUse4Way == 1) { msg = "Use your directional joypad to navigate this application"; } else { msg = "Please use the 2 key to scroll up, the 6 key to scroll right, the 8 key to scroll down, and the 4 key to scroll left."; }
Vase tambin
_capCompoundSound, propiedad
_capCompoundSound
Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasCompoundSound.

Variable numrica; indica si Flash Lite puede procesar datos de sonido compuestos. En caso afirmativo, esta variable est definida y tiene el el valor 1; en caso contrario, no est definida. Por ejemplo, un slo archivo Flash puede contener el mismo sonido representado en formatos MIDI y MFi. Ser el reproductor quien reproduzca los datos en el formato adecuado en funcin del formato admitido por el dispositivo. Esta variable define si el reproductor Flash Lite admite esta funcin en el telfono actual. Disponibilidad Flash Lite 1.1 Ejemplo En el siguiente ejemplo, useCompoundSound se establece en 1 en Flash Lite 1.1, pero queda como undefined en Flash Lite 1.0:
useCompoundSound = _capCompoundSound; if (useCompoundSound == 1) { gotoAndPlay("withSound"); } else { gotoAndPlay("withoutSound");
Vase tambin
_capEmail, propiedad
_capEmail
Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasEmail. Variable numrica; indica si el cliente de Flash Lite puede enviar mensajes de correo electrnico utilizando el comando GetURL() de ActionScript. En caso afirmativo, esta variable est definida y tiene el el valor 1; en caso contrario, no est definida. Disponibilidad Flash Lite 1.1 Ejemplo Si la aplicacin host puede enviar mensajes de correo electrnico con el comando GetURL() de ActionScript, el ejemplo siguiente define canEmail() como 1:
canEmail = _capEmail; if (canEmail == 1) { getURL("mailto:someone@somewhere.com?subject=foo&body=bar"); }
Vase tambin

_capLoadData, propiedad
_capLoadData
Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasDataLoading. Variable numrica; indica si la aplicacin host puede cargar datos adicionales de forma dinmica a travs de llamadas a las funciones loadMovie(), loadMovieNum(), loadVariables() y loadVariablesNum(). En caso afirmativo, esta variable se define con el valor 1; en caso contrario, ser undefined. Disponibilidad Flash Lite 1.1 Ejemplo Si la aplicacin host puede cargar pelculas y variables de forma dinmica, el ejemplo siguiente define CanLoad como 1:
canLoad = _capLoadData; if (canLoad == 1) { loadVariables("http://www.somewhere.com/myVars.php", GET); } else { trace ("client does not support loading dynamic data"); }
Vase tambin
_capMFi, propiedad
_capMFi
Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasMFi. Variable numrica; indica si el dispositivo puede reproducir datos de sonido en formato de audio MFi (Melody Format for i-mode, Formato de meloda para i-mode). En caso afirmativo, esta variable est definida y tiene el el valor 1; en caso contrario, no est definida. Disponibilidad Flash Lite 1.1 Ejemplo Si el dispositivo puede reproducir datos de sonido MFi, el ejemplo siguiente define canMFi como 1:
canMFi = _capMFi; if (canMFi == 1) { // send movieclip buttons to frame with buttons that trigger events sounds tellTarget("buttons") { gotoAndPlay(2); } }

Vase tambin
hasMFI (propiedad capabilities.hasMFI)
_capMIDI, propiedad
_capMIDI
Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasMIDI. Variable numrica; indica si el dispositivo puede reproducir datos de sonido en formato de audio EDI (Electronic Data Interchange, Intercambio electrnico de datos). En caso afirmativo, esta variable est definida y tiene el el valor 1; en caso contrario, no est definida. Disponibilidad Flash Lite 1.1 Ejemplo Si el dispositivo puede reproducir datos de sonido MIDI, el ejemplo siguiente define _capMIDI como 1:
canMIDI = _capMIDI; if (canMIDI == 1) { // send movieclip buttons to frame with buttons that trigger events sounds tellTarget("buttons") { gotoAndPlay(2); } }
Vase tambin
_capMMS, propiedad
_capMMS
Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasMMS. Variable numrica; indica si Flash Lite puede enviar mensajes MMS (Multimedia Messaging Service, Servicio de Mensajera Multimedia) mediante el comando GetURL() de ActionScript. En caso afirmativo, esta variable est definida y tiene el el valor 1; en caso contrario, no est definida. Disponibilidad Flash Lite 1.1 Ejemplo El siguiente ejemplo establece canMMS en 1 en Flash Lite 1.1, pero lo deja como undefined en Flash Lite 1.0 (no obstante, no todos los telfonos con Flash Lite 1.1 pueden enviar mensajes MMS, por lo que este cdigo depende del telfono):

on(release) { canMMS = _capMMS; if (canMMS == 1) { // send an MMS myMessage = "mms:4156095555?body=sample mms message"; } else { // send an SMS myMessage = "sms:4156095555?body=sample sms message"; } getURL(myMessage); }
Vase tambin
_capSMAF, propiedad
_capSMAF
Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasSMAF. Variable numrica; indica si el dispositivo puede reproducir archivos multimedia en formato SMAF (Synthetic music Mobile Application Format, Formato de aplicaciones mviles para msica con sintetizador). En caso afirmativo, esta variable est definida y tiene el el valor 1; en caso contrario, no est definida. Disponibilidad Flash Lite 1.1 Ejemplo El siguiente ejemplo establece canSMAF en 1 en Flash Lite 1.1, pero lo deja como undefined en Flash Lite 1.0 (no obstante, no todos los telfonos con Flash Lite 1.1 pueden enviar mensajes SMAF, por lo que este cdigo depende del telfono):
canSMAF = _capSMAF; if (canSMAF) { // send movieclip buttons to frame with buttons that trigger events sounds tellTarget("buttons") { gotoAndPlay(2); } }
Vase tambin
_capSMS, propiedad
_capSMS
Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasSMS.

Variable numrica; indica si Flash Lite puede enviar mensajes MMS (Short Message Service, Servicio de mensajes cortos) utilizando el comando GetURL() de ActionScript. En caso afirmativo, esta variable est definida y tiene el el valor 1; en caso contrario, no est definida. Disponibilidad Flash Lite 1.1 Ejemplo El siguiente ejemplo establece canSMS en 1 en Flash Lite 1.1, pero lo deja como undefined en Flash Lite 1.0 (no obstante, no todos los telfonos con Flash Lite 1.1 pueden enviar mensajes SMS, por lo que este cdigo depende del telfono):
on(release) { canSMS = _capSMS; if (canSMS) { // send an SMS myMessage = "sms:4156095555?body=sample sms message"; getURL(myMessage); } }
Vase tambin
_capStreamSound, propiedad
_capStreamSound
Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasStreamingAudio. Variable numrica; indica si el dispositivo puede reproducir flujo de sonido (sincronizado). En caso afirmativo, esta variable est definida y tiene el el valor 1; en caso contrario, no est definida. Disponibilidad Flash Lite 1.1 Ejemplo El ejemplo siguiente reproduce flujos de sonido si canStreamSound est activada:
on(press) { canStreamSound = _capStreamSound; if (canStreamSound) { // play a streaming sound in a movieclip with this button tellTarget("music") { gotoAndPlay(2); } } }
Vase tambin

_focusrect, propiedad
_focusrect = Boolean;
Especifica si aparece un rectngulo amarillo alrededor del botn o clip de pelcula que se selecciona con el teclado. Si _focusrect se establece en su valor predeterminado o en true, aparece un rectngulo amarillo alrededor del botn o clip de pelcula actualmente seleccionado mientras el usuario presiona la tecla de tabulacin para desplazarse por los objetos de un archivo SWF. Especifique false si no desea mostrar el rectngulo amarillo. Es una propiedad que puede sustituirse en determinadas instancias. Si la propiedad global _focusrect se establece como false, el comportamiento predeterminado para todos los botones y clips de pelcula es que la navegacin mediante el teclado se limita a la tecla Tabulador. Todas las dems teclas, incluidas Intro y las teclas de flecha, se pasan por alto. Para restablecer el desplazamiento completo con el teclado, es preciso configurar _focusrect con el valor true. Para restaurar las funciones completas del teclado para un botn o clip de pelcula especfico, puede sustituir esta propiedad global empleando Button._focusrect o MovieClip._focusrect. Nota: si utiliza un componente, FocusManager sustituye el control de seleccin de Flash Player, incluido el uso de esta propiedad global. Nota: en el reproductor Flash Lite 2.0, cuando se desactiva la propiedad _focusrect (por ejemplo Button.focusRect = false o MovieClip.focusRect = false), el botn o el clip de pelcula sigue recibiendo todos los eventos. Este comportamiento ha cambiado con respecto a Flash Player, ya que si la propiedad _focusrect se desactiva, el botn o el clip de pelcula recibir los eventos rollOver y rollOut, pero no recibir los eventos press y release. Tambin en Flash Lite 2.0, se puede cambiar el color del rectngulo de seleccin utilizando el comando
SetFocusRectColor de la funcin fscommand2. Este comportamiento ha cambiado con respecto a Flash Player,
donde el color del rectngulo de seleccin nicamente puede ser amarillo. Disponibilidad Flash Lite 1.0 Ejemplo El ejemplo siguiente muestra cmo ocultar el rectngulo amarillo alrededor de las instancias en un archivo SWF cuando estn seleccionadas en una ventana del navegador. Cree algunos botones o clips de pelcula y aada el cdigo ActionScript siguiente al fotograma 1 de la lnea de tiempo:
_focusrect = false;
Vase tambin
_focusrect (propiedad Button._focusrect), _focusrect (propiedad MovieClip._focusrect)
_forceframerate, propiedad
_forceframerate
Si se establece en true, esta propiedad indica al reproductor Flash Lite que represente a la velocidad de fotogramas especificada. Se puede utilizar esta propiedad para sonido pseudosincronizado si el contenido incluye sonido de dispositivo. Se establece en false de forma predeterminada, lo que hace que Flash Lite lo represente con normalidad. Si se establece en true, el reproductor Flash Lite podra saltar la representacin de ciertos fotogramas para mantener la velocidad de fotogramas.

Disponibilidad Flash Lite 2.0
_global, propiedad
_global.identifier
Referencia al objeto global que aloja las clases principales de ActionScript, como String, Object, Math y Array. Por ejemplo, se puede crear una biblioteca que se expone como un objeto de ActionScript global, similar al objeto Math o Date. A diferencia de las funciones y variables declaradas localmente o en la lnea de tiempo, las funciones y variables globales son visibles en todas las lneas de tiempo y mbitos del archivo SWF, siempre y cuando no queden ocultas por identificadores con los mismos nombres en mbitos interiores. Nota: Al establecer el valor de una variable global, debe utilizarse el nombre completo de la variable, por ejemplo, _global.variableName. De lo contrario, se crear una variable local con el mismo nombre, que ocultar la variable global que se intenta establecer. Disponibilidad Flash Lite 2.0 Valor devuelto Referencia al objeto global que aloja las clases principales de ActionScript, como String, Object, Math y Array. Ejemplo El ejemplo siguiente crea una funcin de nivel superior, factorial(), que est disponible para todas las lneas de tiempo y mbitos en un archivo SWF:
_global.factorial = function(n:Number) { if (n<=1) { return 1; } else { return n*factorial(n-1); } } // Note: factorial 4 == 4*3*2*1 == 24 trace(factorial(4)); // output: 24
El ejemplo siguiente muestra cmo la no utilizacin del nombre de variable completo cuando se establece el valor de una variable global produce resultados imprevistos:
_global.myVar = "global"; trace("_global.myVar: " + _global.myVar); // _global.myVar: global trace("myVar: " + myVar); // myVar: global myVar = "local"; trace("_global.myVar: " + _global.myVar); // _global.myVar: global trace("myVar: " + myVar); // myVar: local
Vase tambin
set variable, sentencia
_highquality, propiedad
_highquality

Desfasada desde Flash Player 5. Esta propiedad est desfasada y en su lugar debe utilizarse _quality. Especifica el nivel de suavizado que se aplica al archivo SWF actual. Especifique 2 (mejor calidad) para aplicar la mejor calidad. Especifique 1 (alta calidad) para aplicar el suavizado. Especifique 0 (baja calidad) para evitar el suavizado. Disponibilidad Flash Lite 1.0 Ejemplo El siguiente cdigo ActionScript se inserta en la lnea de tiempo principal y define la propiedad de calidad global para aplicar el suavizado. _highquality = 1; Vase tambin
_quality, propiedad
_level, propiedad
_levelN
Referencia a la lnea de tiempo raz de _levelN. Debe utilizar loadMovieNum() para cargar archivos SWF en Flash Player antes de utilizar la propiedad _level para buscarlos. Tambin puede utilizar _levelN para buscar un archivo SWF cargado en el nivel asignado por N. El archivo SWF inicial cargado en la instancia de Flash Player se carga automticamente en _level0. El archivo SWF que se encuentra en _level0 establece la velocidad de fotogramas, el color de fondo y el tamao de fotograma de todos los archivos SWF que se cargan posteriormente. A continuacin, los archivos SWF se apilan en niveles de numeraciones superiores, por encima del archivo SWF de _level0. Debe asignar un nivel a cada archivo SWF que cargue en Flash Player mediante loadMovieNum(). Puede asignar niveles en cualquier orden. Si asigna un nivel que ya contiene un archivo SWF (incluido _level0), se descargar el archivo SWF de dicho nivel y ser sustituido por el nuevo archivo SWF. Disponibilidad Flash Lite 1.0 Ejemplo El ejemplo siguiente detiene la cabeza lectora en la lnea de tiempo principal del archivo SWF sub.swf que se carga en _level9. El archivo sub.swf contiene animacin y se encuentra en el mismo directorio que el documento que contiene el siguiente ActionScript:
loadMovieNum("sub.swf", 9); myBtn_btn.onRelease = function() { _level9.stop(); };
Puede reemplazar _level9.stop() en el ejemplo anterior por el cdigo siguiente:

_level9.gotoAndStop(5);
Esta accin enva la cabeza lectora en la lnea de tiempo principal del archivo SWF en _level9 al fotograma 5 en lugar de detener la cabeza lectora.

Vase tambin
loadMovie, funcin, swapDepths (mtodo MovieClip.swapDepths)
maxscroll, propiedad
variable_name.maxscroll
Desfasada desde Flash Player 5. Esta propiedad est desfasada y en su lugar debe utilizarse TextField.maxscroll. Indica el nmero de lnea de la lnea superior de texto visible en un campo de texto cuando la lnea inferior del campo tambin est visible. La propiedad maxscroll funciona con la propiedad scroll para controlar cmo aparece la informacin en un campo de texto. Esta propiedad puede recuperarse, pero no modificarse. Disponibilidad Flash Lite 1.1 Vase tambin
maxscroll (propiedad TextField.maxscroll), scroll (propiedad TextField.scroll)
_parent, propiedad
_parent.property _parent._parent.property
Especifica o devuelve una referencia al clip de pelcula u objeto que contiene el clip de pelcula u objeto actual. El objeto actual es el que contiene el cdigo ActionScript que hace referencia a _parent. Utilice _parent para especificar una ruta de acceso relativa a los clips de pelcula u objetos que se encuentran por encima del clip de pelcula u objeto actual. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente hay dos instancias de clip de pelcula en el escenario con el nombre square_mc. En ese clip de pelcula hay otro clip de pelcula con el nombre de instancia circle_mc. El siguiente ActionScript permite modificar la instancia principal circle_mc (que es square_mc) cuando se hace clic en el crculo. Cuando se trabaja con direccionamiento relativo (empleando _parent en lugar de _root), puede resultar ms fcil utilizar el botn Insertar ruta de destino en el panel Acciones en primer lugar.
this.square_mc.circle_mc.onRelease = function() { this._parent._alpha -= 5; };
Vase tambin
_root, propiedad, targetPath, funcin
_quality, propiedad
_quality:String
Establece o recupera la calidad de representacin que se utiliza para un clip de pelcula. Las fuentes de dispositivo siempre se muestran dentadas y, por consiguiente, no se ven afectadas por la propiedad _quality. La propiedad _quality puede configurarse con los siguientes valores:

Valor "LOW"
Descripcin Calidad de representacin baja.
Suavizado de grficos Los grficos no se suavizan.
Suavizado de mapa de bits Los mapas de bits no se suavizan.
"MEDIUM"
Calidad de representacin media. Este ajuste resulta adecuado para pelculas que no contengan texto. Calidad de representacin alta. Esta es la calidad de representacin predeterminada de Flash.
Los grficos se suavizan Los mapas de bits no se empleando una cuadrcula de 2 x suavizan. 2 pxeles.
"HIGH"
Los grficos se suavizan Los mapas de bits no se empleando una cuadrcula de 4 x suavizan. 4 pxeles.
Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente establece la calidad de representacin como LOW:
_quality = "LOW";
_root, propiedad
_root.movieClip _root.action _root.property
Especifica o devuelve una referencia a la lnea de tiempo del clip de pelcula raz. Si un clip de pelcula tiene varios niveles, la lnea de tiempo del clip de pelcula raz est en el nivel que contiene el guin que se est ejecutando. Por ejemplo, si un guin del nivel 1 consulta el valor de _root, se devuelve _level1. Especificar _root equivale a utilizar la notacin con barras (/) desfasada para especificar una ruta absoluta en el nivel actual. Nota: si un clip de pelcula que contiene _root se carga en otro clip de pelcula, _root hace referencia a la lnea de tiempo del clip de pelcula que se carga y no a la lnea de tiempo que contiene _root. Si desea asegurarse de que _root haga referencia a la lnea de tiempo del clip de pelcula cargado incluso cuando se cargue en otro clip de pelcula, utilice MovieClip._lockroot. Disponibilidad Flash Lite 2.0 Parmetros movieClip:String - Nombre de instancia del clip de pelcula. action:String - Accin o campo. property:String - Propiedad del objeto MovieClip. Ejemplo El ejemplo siguiente detiene la lnea de tiempo del nivel que contiene el guin que se est ejecutando:
_root.stop();

El ejemplo siguiente realiza un seguimiento de las variables e instancias en el mbito de _root:

for (prop in _root) { trace("_root."+prop+" = "+_root[prop]); }
Vase tambin
_lockroot (propiedad MovieClip._lockroot), _parent, propiedad, targetPath, funcin
scroll, propiedad
textFieldVariableName.scroll = x
Desfasada desde Flash Player 5. Esta propiedad est desfasada y en su lugar debe utilizarse TextField.scroll. Controla la visualizacin de informacin en un campo de texto asociado a una variable. La propiedad scroll define dnde comienza el campo de texto a mostrar contenido; despus de establecerla, Flash Player la actualiza a medida que el usuario se desplaza por el campo de texto. La propiedad scroll es til para dirigir a los usuarios a un prrafo especfico en un pasaje largo, o para crear campos de texto con desplazamiento. Esta propiedad puede recuperarse y modificarse. Disponibilidad Flash Lite 1.1 Ejemplo El cdigo siguiente se adjunta a un botn Arriba que desplaza el campo de texto llamado myText:
on (release) { myText.scroll = myText.scroll + 1; }
Vase tambin
maxscroll (propiedad TextField.maxscroll), scroll (propiedad TextField.scroll)
_soundbuftime, propiedad
_soundbuftime:Number = integer
Establece el nmero de segundos de flujo de sonido que se va a almacenar en el bfer. El valor predeterminado es 5 segundos. Disponibilidad Flash Lite 2.0 Parmetros integer:Number - Nmero de segundos transcurridos antes de que se inicie la reproduccin sin interrupcin del archivo SWF.

Ejemplo El ejemplo siguiente reproduce un archivo MP3 en flujo y almacena el sonido en el bfer antes de reproducirlo para este usuario. Se crean dos campos de texto en tiempo de ejecucin para contener un temporizador y la informacin de depuracin. La propiedad _soundbuftime se configura para almacenar el MP3 en bfer durante 10 segundos. Se crea una nueva instancia de objeto Sound para el MP3.
// create text fields to hold debug information. this.createTextField("counter_txt", this.getNextHighestDepth(), 0, 0, 100, 22); this.createTextField("debug_txt", this.getNextHighestDepth(), 0, 20, 100, 22); // set the sound buffer to 10 seconds. _soundbuftime = 10; // create the new sound object instance. var bg_sound:Sound = new Sound(); // load the MP3 sound file and set streaming to true. bg_sound.loadSound("yourSound.mp3", true); // function is triggered when the song finishes loading. bg_sound.onLoad = function() { debug_txt.text = "sound loaded"; }; debug_txt.text = "sound init"; function updateCounter() { counter_txt.text++; } counter_txt.text = 0; setInterval(updateCounter, 1000);
this, propiedad
this
Hace referencia a una instancia de clip de pelcula u objeto. Cuando se ejecuta un guin, this hace referencia a la instancia del clip de pelcula que contiene el guin. Cuando se llama a un campo, this contiene una referencia al objeto que contiene el campo al que se llama. Dentro de un controlador de eventos on() asociado a un botn, this hace referencia a la lnea de tiempo que contiene el botn. Dentro de un controlador de eventos onClipEvent() asociado a un clip de pelcula, this hace referencia a la lnea de tiempo del propio clip de pelcula. Dado que this se evala en el contexto del guin que lo contiene, no puede utilizar this en un guin para hacer referencia a una variable definida en un archivo de clase. Cree ApplyThis.as e introduzca el siguiente cdigo:
class ApplyThis { var str:String = "Defined in ApplyThis.as"; function conctStr(x:String):String { return x+x; } function addStr():String { return str; } }
Posteriormente, en un archivo FLA o AS, aada el siguiente cdigo ActionScript:

var obj:ApplyThis = new ApplyThis(); var abj:ApplyThis = new ApplyThis(); abj.str = "defined in FLA or AS"; trace(obj.addStr.call(abj, null)); //output: defined in FLA or AS trace(obj.addStr.call(this, null)); //output: undefined trace(obj.addStr.call(obj, null)); //output: Defined in applyThis.as
Del mismo modo, para llamar a una funcin definida en una clase dinmica, debe utilizar this para invocar la funcin en el mbito adecuado:
// incorrect version of Simple.as /* dynamic class Simple { function callfunc() { trace(func()); } } */ // correct version of Simple.as dynamic class simple { function callfunc() { trace(this.func()); } }
Dentro de un archivo FLA o AS, aada el siguiente cdigo ActionScript:

var obj:Simple = new Simple(); obj.num = 0; obj.func = function() { return true; }; obj.callfunc(); // output: true
Si utiliza la versin incorrecta de Simple.as, obtendr un error de sintaxis. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente, la palabra clave this hace referencia al objeto Circle:
function Circle(radius:Number):Void { this.radius = radius; this.area = Math.PI*Math.pow(radius, 2); } var myCircle = new Circle(4); trace(myCircle.area);
En la sentencia siguiente asignada a un fotograma dentro de un clip de pelcula, la palabra clave this hace referencia al clip de pelcula actual.
// sets the alpha property of the current movie clip to 20 this._alpha = 20;
En la sentencia siguiente dentro de un controlador de MovieClip.onPress, la palabra clave this hace referencia al clip de pelcula actual:

this.square_mc.onPress = function() { startDrag(this); }; this.square_mc.onRelease = function() { stopDrag(); };
Vase tambin Constantes, onClipEvent, controlador
Operadores
Los operadores simblicos son caracteres que especifican cmo combinar, comparar o modificar los valores de una expresin. Resumen de operadores
Operador
+ (addition) += (addition assignment) [] (array access)
Descripcin Aade expresiones numricas o concatena (combina) cadenas. Asigna a expression1 el valor de expression1 + expression2.
Inicializa una nueva matriz o matriz multidimensional con los elementos especificados (a0 y as sucesivamente) o accede a elementos de una matriz. Asigna el valor de expression2 (el parmetro a la derecha) a la variable, elemento de matriz o propiedad de expression1. Convierte expression1 y expression2 en enteros de 32 bits sin signo y ejecuta una operacin booleana AND en cada bit de los parmetros integer. Asigna a expression1 el valor de expression1 y expression2. Convierte expression1 y expression2 en enteros de 32-bits, y cambia todos los bits en expression1 a la izquierda por el nmero de espacios especificados por el entero resultante de la conversin de expression2. Este operador ejecuta una operacin de desplazamiento a la izquierda en modo bit (<<) y almacena el contenido como un resultado en expression1.
= (assignment)
& (bitwise AND)
&= (bitwise AND assignment) << (desplazamiento a la izquierda en modo bit)
<<= (asignacin y
desplazamiento a la izquierda en modo bit)

~ (NOT en modo bit)
Tambin conocido como operador complementario del uno u operador complementario en modo bit. Convierte expression1 y expression2 en enteros de 32 bits sin signo y devuelve un 1 en cada posicin de bit donde los correspondientes bits tanto de expression1 como de expression2 sean 1. Asigna a expression1 el valor de expression1 | expression2.
| (bitwise OR)
|= (asignacin de OR en modo bit) >> (desplazamiento a la derecha en modo bit)
Convierte expression1 y expression2 en enteros de 32-bits, y cambia todos los bits en expression1 a la derecha por el nmero de espacios especificados por el entero resultante de la conversin de expression2.

Operador
>>= (asignacin y
Descripcin Este operador ejecuta una operacin de desplazamiento a la derecha en modo bit y almacena el contenido como un resultado en expression1.
desplazamiento a la derecha en modo bit)

>>> (desplazamiento a la
Es igual al operador de desplazamiento a la derecha en modo bit (>>), con la diferencia derecha sin signo en modo de que no conserva el signo de la expression original porque los bits a la izquierda se bit) rellenan siempre con un 0. Los nmeros de coma flotante se convierten en enteros al descartarse los dgitos despus de la coma decimal.
>>>= (asignacin y
Ejecuta una operacin de desplazamiento a la derecha en modo bit sin signo y desplazamiento a la almacena el contenido como un resultado en expression1. derecha sin signo en modo bit)
^ (bitwise XOR)
Convierte expression1 y expression2 en enteros de 32 bits sin signo y devuelve un 1 en cada posicin de bit donde los correspondientes bits tanto de expression1 como de expression2, pero no ambos, sean 1.
^= (asignacin de XOR en Asigna a expression1 el valor de expression1 ^ expression2. modo bit) /* (block comment delimiter) , (comma) add (concatenation (cadenas))
Indica una o varias lneas de comentarios de guin. Evala primero expression1, luego expression2, y as sucesivamente. Desfasada desde Flash Player 5. Adobe recomienda utilizar el operador de suma (+) cuando cree contenido para Flash Player 5 o versiones posteriores. Nota: en Flash Lite 2.0, tambin el operador agregar est desfasado y en su lugar debe utilizarse el operador (+). Concatena dos o ms cadenas.
?: (conditional)
Indica a Flash que evale expression1 y si el valor de expression1 es true, devuelve el valor de expression2; en caso contrario, devuelve el valor de expression3. Operador unario de decremento previo y decremento posterior que resta 1 de expression1. Divide expression1 por expression2.
-- (decrement)
/ (division)
/= (division assignment) Asigna a expression1 el valor de expression1 / expression2. . (dot)
Se utiliza para navegar por las jerarquas de clips de pelcula y acceder a variables, propiedades o clips de pelcula anidados (secundarios). Comprueba la igualdad de dos expresiones. Desfasada desde Flash Player 5. Este operador est desfasado y en su lugar debe utilizarse el operador == (equality). Devuelve true si la representacin en cadena de expression1 es igual a la representacin en cadena de expression2; de lo contrario, devuelve false.
== (equality) eq (equality (cadenas))
> (greater than)
Compara dos expresiones y determina si expression1 es mayor que expression2; si lo es, el operador devuelve true. Desfasada desde Flash Player 5. Este operador est desfasado y en su lugar debe utilizarse el operador > (mayor que) Compara la representacin de cadena de expression1 con la representacin de cadena de expression2 y devuelve true si expression1 es mayor que expression2; en caso contrario, devuelve false.
amp;gt (mayor que (cadenas))
>= (greater than or equal
to)
Compara dos expresiones y determina si expression1 es mayor o igual que expression2 (true) o si expression1 es menor que expression2 (false).

Operador
Descripcin
ge (greater than or equal Desfasada desde Flash Player 5. Este operador est desfasado y en su lugar debe to (strings)) utilizarse el operador >= (mayor o igual que).
Devuelve true si expression1 es mayor o igual que expression2; de lo contrario, devuelve false.
++ (increment)
Operador unario de incremento previo e incremento posterior que aade 1 a expression1. Prueba el contrario exacto del operador de igualdad (==). Desfasada desde Flash Player 5. Este operador est desfasado. Adobe recomienda que utilice el operador != (inequality). Prueba el contrario exacto del operador de igualdad (==).
!= (desigualdad) <> (desigualdad)
instanceof
Comprueba si object es una instancia de classConstructor o una subclase de classConstructor. Compara dos expresiones y determina si expression1 es menor que expression2; si lo es, el operador devuelve true. Desfasado desde Flash Player 5. Este operador est desfasado y en su lugar debe utilizarse < (menor que). Devuelve true si expression1 es menor que expression2, y false en caso contrario.
< (less than)
amp;lt (menor que (cadenas))
<= (less than or equal to) Compara dos expresiones y determina si expression1 es menor o igual que expression2; si lo es, el operador devuelve true. le (less than or equal to (strings))
Desfasada desde Flash Player 5. Este operador est desfasado en Flash 5 y en su lugar debe utilizarse el operador <= (menor o igual que). Devuelve true si expression1 es menor o igual que expression2; de lo contrario, devuelve false.
// (line comment delimiter) && (AND lgico) y (AND lgico)
Indica el principio de un comentario de guin.
Ejecuta una operacin booleana en los valores una de las expresiones o en ambas. Desfasada desde Flash Player 5. Adobe recomienda que utilice el operador lgico AND (&&). Ejecuta una operacin de AND lgica (&&) en Flash Player 4.
! (logical NOT) no (logical NOT)
Invierte el valor booleano de una variable o expresin. Desfasada desde Flash Player 5. Este operador est desfasado y en su lugar debe utilizarse el operador ! (NOT lgico). Ejecuta una operacin NOT (!) lgica en Flash Player 4.
|| (logical OR)
Evala expression1 (la expresin en la parte izquierda del operador) y devuelve true si la expresin da como resultado true. Desfasado desde Flash Player 5. Este operador est desfasado y en su lugar debe utilizarse el operador || (OR lgico). Evala condition1 y condition2, y si alguna es true, toda la expresin es true.
o (logical OR)
% (modulo)
Calcula el resto de expression1 dividido por expression2.
%= (modulo assignment) Asigna a expression1 el valor de expression1 % expression2. * (multiplication)
Multiplica dos expresiones numricas.

Operador
*= (multiplication assignment)
Descripcin Asigna a expression1 el valor de expression1 * expression2.
new
Crea un objeto nuevo, inicialmente annimo, y llama a la funcin identificada por el parmetro constructor. Desfasada desde Flash Player 5. Este operador est desfasado y en su lugar debe utilizarse el operador !operador = (desigualdad). Devuelve true si expression1 no es igual que expression2; de lo contrario, devuelve
false.
ne (distinto (cadenas))
{} (object initializer)
Crea un nuevo objeto y lo inicializa con los pares de propiedades especificadas name y value. Ejecuta una operacin de agrupacin en uno o varios parmetros, lleva a cabo una evaluacin secuencial de las expresiones o rodea uno o varios parmetros y los pasa como parmetros a una funcin fuera del parntesis. Comprueba la igualdad de dos expresiones; el operador de igualdad estricta (===) hace lo mismo que el operador de igualdad (==) con la diferencia de que los tipos de datos no se convierten. Prueba el contrario exacto del operador de igualdad estricta (===). Si se utilizan antes y despus de caracteres, las comillas (") indican que los caracteres tienen un valor literal y se consideran una cadena y no una variable ni un valor numrico ni otro elemento de ActionScript. Se emplea para negar o restar. Asigna a expression1 el valor de expression1 - expression2.
() (parentheses)
=== (strict equality)
!== (strict inequality) " (string delimiter)
- (subtraction) -= (subtraction assignment) : (type)
Se utiliza en la clasificacin por tipos estricta; este operador especifica el tipo de variable, el tipo de devolucin de funcin o el tipo de parmetro de funcin. El operador typeof evala la expression y devuelve una cadena que especifica si la expresin es un String, MovieClip, Object, Function, Number, o un valor Boolean. El operador void evala una expresin y, a continuacin, descarta su valor, devolviendo undefined.
typeof
void
+ adicin, operador
expression1 + expression2
Aade expresiones numricas o concatena (combina) cadenas. Si una expresin es una cadena, todas las dems expresiones se convierten en cadenas y se concatenan. Si ambas expresiones son enteros, la suma es un entero; si al menos una de las expresiones es un nmero de coma flotante, la suma es un nmero de coma flotante. Nota: Flash Lite 2.0 es compatible con el operador de suma (+) para sumar expresiones numricas y concatenar cadenas. Flash Lite 1.x slo es compatible con el operador de suma (+) para sumar expresiones numricas (como var1 = 1 + 2 // output: 3). En Flash Lite 1.x, debe utilizar el operador add para concatenar cadenas. Disponibilidad Flash Lite 2.0 Operandos
expression1 - Un nmero o cadena.

expression2 - Un nmero o cadena.
Valor devuelto Object - Una cadena, un entero o un nmero de coma flotante. Ejemplo Sintaxis 1: El ejemplo siguiente concatena dos cadenas y muestra el resultado en el panel Salida.
var name:String = "Cola"; var instrument:String = "Drums"; trace(name + " plays " + instrument); // output: Cola plays Drums
Nota: Flash Lite 1.x no es compatible con el operador de suma (+) para concatenar cadenas. En Flash Lite 1.x, debe utilizar el operador add para concatenar cadenas. Sintaxis 2: Esta sentencia aade los enteros 2 y 3 y muestra el entero resultante, 5, en el panel Salida:
trace(2 + 3); // output: 5
Esta sentencia aade los nmeros de coma flotante 2,5 y 3,25 y muestra el nmero de coma flotante resultante, 5,75, en el panel Salida:
trace(2.5 + 3.25); // output: 5.75
Sintaxis 3: Las variables asociadas con los campos de texto dinmico y de entrada tienen un tipo de datos String. En el ejemplo siguiente, la variable deposit es un campo de texto de entrada en el escenario. Cuando un usuario introduce una cantidad de depsito, el guin intenta aadir deposit a oldBalance. Sin embargo, dado que deposit es un tipo de datos String, el guin concatena (se combina para formar una cadena) los valores variables en lugar de sumarlos.
var oldBalance:Number = 1345.23; var currentBalance = deposit_txt.text + oldBalance; trace(currentBalance);
Por ejemplo, si un usuario introduce 475 en el campo de texto de depsito, la funcin trace() enva el valor 4751345.23 al panel Salida. Para corregir esto, utilice la funcin Number() para convertir la cadena en un nmero, como se indica a continuacin:
var oldBalance:Number = 1345.23; var currentBalance:Number = Number(deposit_txt.text) + oldBalance; trace(currentBalance);
El ejemplo siguiente muestra cmo no se calculan las sumas numricas a la derecha de una expresin de cadena:
var a:String trace(a); // var b:String trace(b); // = 3 + 10 + "asdf"; 13asdf = "asdf" + 3 + 10; asdf310
+= operador de asignacin de adicin

expression1 += expression2
Asigna a expression1 el valor de expression1 + expression2. Por ejemplo, las dos sentencias siguientes tienen el mismo resultado:
x += y; x = x + y;

Este operador realiza adems una concatenacin de cadenas. Todas las reglas del operador de suma (+) se aplican al operador de asignacin de suma (+=) . Disponibilidad Flash Lite 1.0 Operandos
expression1 : Number - Un nmero o cadena. expression2 : Number - Un nmero o cadena.
Valor devuelto Number - El resultado de la suma. Ejemplo Sintaxis 1: Este ejemplo utiliza el operador += con una expresin de cadena y enva "My name is Gilbert" al panel Salida.
var x1:String = "My name is "; x1 += "Gilbert"; trace(x1); // output: My name is Gilbert
Sintaxis 2: El ejemplo siguiente muestra un uso numrico del operador de asignacin de suma (+=):
var x:Number = 5; var y:Number = 10; x += y; trace(x); // output: 15
Vase tambin
+ adicin, operador
Operador de acceso a matriz ([])

myArray = [ a0, a1,...aN ] myArray[ i ] = value myObject [ propertyName ]
Inicializa una nueva matriz o matriz multidimensional con los elementos especificados (a0 y as sucesivamente) o accede a elementos de una matriz. El operador de acceso a matriz permite establecer y recuperar dinmicamente nombres de instancia, variable y objeto. Tambin permite acceder a propiedades de objeto. Sintaxis 1: Una matriz es un objeto cuyas propiedades se denominan elementos, que se identifican mediante un nmero denominado ndice. Cuando se crea una matriz, se rodean los elementos con el operador de acceso a matriz ([]) (o corchetes). Una matriz puede contener elementos de diversos tipos. Por ejemplo, la siguiente matriz, denominada employee, tiene tres elementos; el primero es un nmero y los dos siguientes son cadenas (entre comillas):
var employee:Array = [15, "Barbara", "Jay"];
Puede anidar los corchetes para simular matrices multidimensionales. Puede anidar matrices hasta un mximo de 256 niveles de profundidad. El siguiente cdigo crea una matriz denominada ticTacToe, con tres elementos; cada elemento es a su vez una matriz con tres elementos:
var ticTacToe:Array = [[1, 2, 3], [4, 5, 6], [7, 8, 9]]; // Select Debug > List Variables in test mode // to see a list of the array elements.

Sintaxis 2: Ponga entre corchetes ([]) el ndice de cada elemento para acceder a l directamente; puede aadir un nuevo elemento a una matriz o puede cambiar o recuperar el valor de un elemento existente. El primer ndice de una matriz es siempre 0, tal y como se muestra en el siguiente ejemplo:
var my_array:Array = new Array(); my_array[0] = 15; my_array[1] = "Hello"; my_array[2] = true;
Puede utilizar corchetes ([]) para aadir un cuarto elemento, tal y como se muestra en el siguiente ejemplo:
my_array[3] = "George";
Puede utilizar corchetes ([]) para acceder a un elemento de una matriz multidimensional. El primer conjunto de corchetes identifica el elemento en la matriz original y el segundo conjunto identifica el elemento en la matriz anidada. Las siguientes lneas de cdigo envan el nmero 6 al panel Salida.
var ticTacToe:Array = [[1, 2, 3], [4, 5, 6], [7, 8, 9]]; trace(ticTacToe[1][2]);// output: 6
Sintaxis 3: Puede utilizar el operador de acceso a matriz ([]) en lugar de la funcin eval() para establecer dinmicamente y recuperar los valores de los nombres de clip de pelcula o cualquier propiedad de un objeto. La siguiente lnea de cdigo establece el nombre del clip de pelcula determinado por la concatenacin de la cadena mc con el valor de la variable i en left_corner.
name["mc" + i] = "left_corner";
Disponibilidad Flash Lite 2.0 Operandos

myArray : Object - Nombre de una matriz. a0,a1,...aN : Object - Elementos de una matriz; cualquier tipo nativo o instancia de objeto, incluidas las matrices
anidadas.
i : Number - ndice de nmero entero mayor o igual que 0. myObject : Object - Nombre de un objeto. propertyName : String - Cadena que denomina una propiedad del objeto.
Valor devuelto
Object -
Sintaxis 1: Una referencia a una matriz. Sintaxis 2: Un valor de la matriz, ya sea un tipo nativo o una instancia de objeto (incluida una instancia de Array). Sintaxis 3: Una propiedad del objeto, ya sea un tipo nativo o una instancia de objeto (incluida una instancia de Array). Ejemplo El ejemplo siguiente muestra dos formas de crear un nuevo objeto Array vaco; la primera lnea utiliza corchetes ([]):
var my_array:Array = []; var my_array:Array = new Array();

El ejemplo siguiente crea una matriz llamada employee_array y utiliza la sentencia trace() para enviar los elementos al panel Salida. En la cuarta lnea, se cambia un elemento de la matriz, y la quinta lnea enva la matriz recin modificada al panel Salida:
var employee_array = ["Barbara", "George", "Mary"]; trace(employee_array); // output: Barbara,George,Mary employee_array[2] = "Sam"; trace(employee_array); // output: Barbara,George,Sam
En el ejemplo siguiente, se evala la expresin entre corchetes ("piece" +i) y el resultado se utiliza como nombre de la variable que se va a recuperar del clip de pelcula my_pc: En este ejemplo, la variable i debe encontrarse en la misma lnea de tiempo que el botn. Si la variable i es igual a 5, por ejemplo, el valor de la variable piece5 en el clip de pelcula my_pc se mostrar en el panel Salida:
myBtn_btn.onRelease = function() { x = my_mc["piece"+i]; trace(x); };
En el ejemplo siguiente, se evala la expresin entre corchetes y el resultado se utiliza como nombre de la variable que se va a recuperar del clip de pelcula name_mc:
name_mc["A" + i];
Si conoce la sintaxis de barras de Flash 4 ActionScript, puede emplear la funcin eval() para conseguir el mismo resultado:
eval("name_mc.A" & i);
Puede utilizar el siguiente ActionScript para reproducir indefinidamente todos los objetos del mbito _root, algo que resulta til para depurar:
for (i in _root) { trace(i+": "+_root[i]); }
Tambin puede utilizar el operador de acceso a una matriz ([]) del lado izquierdo de una sentencia de asignacin para establecer dinmicamente nombres de instancia, variable y objeto:
employee_array[2] = "Sam";
Vase tambin Array, Object, eval, funcin
= operador de asignacin
expression1 = expression2
Asigna el valor de expression2 (el parmetro a la derecha) a la variable, elemento de matriz o propiedad de expression1. La asignacin puede ser por valor o por referencia. La asignacin por valor copia el valor actual de expression2 y lo almacena en expression1. La asignacin por valor se utiliza cuando se asigna un nmero o un literal de cadena a una variable. La asignacin por referencia almacena una referencia a expression2 en expression1. La asignacin por referencia suele utilizarse con operador new. El uso del operador new crea un objeto en la memoria y se asigna a la variable una referencia a dicha ubicacin en la memoria. Disponibilidad Flash Lite 1.0

Operandos
expression1 : Object - Una variable, un elemento de una matriz o una propiedad de un objeto. expression2 : Object - Un valor de cualquier tipo.
Valor devuelto Object - El valor asignado, expression2. Ejemplo El ejemplo siguiente utiliza asignacin por valor para asignar el valor de 5 a la variable x.
var x:Number = 5;
El ejemplo siguiente utiliza asignacin por valor para asignar el valor "hello" a la variable x:
var x:String;x = " hello ";
El ejemplo siguiente utiliza la asignacin por referencia para crear la variable moonsOfJupiter, que contiene una referencia a un objeto Array recin creado. A continuacin, se utiliza asignacin por valor para copiar el valor "Callisto" al primer elemento de la matriz a la que hace referencia la variable moonsOfJupiter:
var moonsOfJupiter:Array = new Array();moonsOfJupiter[0] = "Callisto";
El ejemplo siguiente utiliza asignacin por referencia para crear un objeto nuevo y asignar una referencia a ese objeto a la variable mercury. A continuacin, se utiliza asignacin por valor para asignar el valor de 3030 a la propiedad diameter del objeto mercury:
var mercury:Object = new Object(); mercury.diameter = 3030; // in miles trace (mercury.diameter); // output: 3030
El ejemplo siguiente se basa en el ejemplo anterior creando una variable llamada merkur ("mercury" en alemn) y asignndole el valor de mercury. De este modo se crean dos variables que hacen referencia al mismo objeto en la memoria, lo que significa que puede utilizar cualquiera de ellas para acceder a las propiedades del objeto. Seguidamente podemos cambiar la propiedad diameter para utilizar kilmetros en lugar de millas:
var merkur:Object = mercury; merkur.diameter = 4878; // in kilometers trace (mercury.diameter); // output: 4878
Vase tambin
== operador de igualdad
& operador AND en modo bit

expression1 & expression2
Convierte expression1 y expression2 en enteros de 32 bits sin signo y ejecuta una operacin booleana AND en cada bit de los parmetros integer. Los nmeros de coma flotante se convierten en enteros al descartarse los dgitos despus de la coma decimal. El resultado es un nuevo entero de 32 bits. Los enteros positivos se convierten en un valor hexadecimal sin signo con un valor mximo de 4294967295 o 0xFFFFFFFF; se descartan los dgitos ms significativos de los valores mayores que el mximo cuando se convierten, de forma que el valor siga siendo de 32 bits. Los nmeros negativos se convierten en un valor hexadecimal sin signo a travs de la notacin complementaria del dos, donde el mnimo es -2147483648 o 0x800000000; los nmeros menores que el mnimo se convierten en el complemento del dos con mayor precisin y tambin se descartan sus dgitos ms significativos.

El valor devuelto se interpreta como un nmero complementario del dos con signo, de forma que el valor devuelto sea un entero del intervalo comprendido entre -2147483648 y 2147483647. Disponibilidad Flash Lite 2.0 Operandos
expression1 : Number - Un nmero. expression2 : Number - Un nmero.
Valor devuelto Number - El resultado de la operacin en modo bit. Ejemplo El ejemplo siguiente compara la representacin de bits de los nmeros y devuelve 1 slo si los dos bits en la misma posicin son 1. En el siguiente cdigo ActionScript, se aade 13 (binario 1101) y 11 (binario 1011) y se devuelve 1 slo en la posicin en la que los nmeros tienen un 1.
var insert:Number = 13; var update:Number = 11; trace(insert & update); // output : 9 (or 1001 binary)
En los nmeros 13 y 11 el resultado es 9 porque slo la primera y la ltima posicin de ambos nmeros tienen el nmero 1. Los ejemplos siguientes muestran el comportamiento de la conversin del valor devuelto:
trace(0xFFFFFFFF); trace(0xFFFFFFFF & trace(0xFFFFFFFF & trace(4294967295 & trace(4294967295 & // 4294967295 0xFFFFFFFF); // -1 -1); // -1 -1); // -1 4294967295); // -1
Vase tambin
&= asignacin de AND en modo bit, operador, ^ operador XOR en modo bit, ^= asignacin de XOR en modo bit, operador, | operador OR en modo bit, |= asignacin de OR en modo bit, operador, ~ operador NOT en modo bit
&= asignacin de AND en modo bit, operador

expression1 &= expression2
Asigna a expression1 el valor de expression1& expression2. Por ejemplo, las dos expresiones siguientes son equivalentes:
x &= y; x = x & y;

expression1 : Number - Un nmero.

expression2 : Number - Un nmero.
Valor devuelto Number - El valor de expression1 & expression2. Ejemplo El ejemplo siguiente asigna el valor de 9 a x:
var x:Number = 15; var y:Number = 9; trace(x &= y); // output: 9
Vase tambin
& operador AND en modo bit, ^ operador XOR en modo bit, ^= asignacin de XOR en modo bit, operador, | operador OR en modo bit|= asignacin de OR en modo bit, operador, ~ operador NOT en modo bit
<< operador de desplazamiento a la izquierda en modo bit

expression1 << expression2
Convierte expression1 y expression2 en enteros de 32-bits, y cambia todos los bits en expression1 a la izquierda por el nmero de espacios especificados por el entero resultante de la conversin de expression2. Las posiciones de bit vacas fruto de esta operacin se llenan con 0 y los bits que se desplazan a la izquierda se descartan. Desplazar un valor una posicin a la izquierda equivale a multiplicarlo por 2. Los nmeros de coma flotante se convierten en enteros al descartarse los dgitos despus de la coma decimal. Los enteros positivos se convierten en un valor hexadecimal sin signo con un valor mximo de 4294967295 o 0xFFFFFFFF; se descartan los dgitos ms significativos de los valores mayores que el mximo cuando se convierten, de forma que el valor siga siendo de 32 bits. Los nmeros negativos se convierten en un valor hexadecimal sin signo a travs de la notacin complementaria del dos, donde el mnimo es -2147483648 o 0x800000000; los nmeros menores que el mnimo se convierten en el complemento del dos con una mayor precisin y tambin se descartan sus dgitos ms significativos. El valor devuelto se interpreta como un nmero complementario del dos con signo, de forma que el valor devuelto ser un entero del intervalo comprendido entre -2147483648 y 2147483647. Disponibilidad Flash Lite 2.0 Operandos
expression1 : Number - Nmero o expresin que se va a desplazar a la izquierda. expression2 : Number - Nmero o expresin que se convierte en un entero de 0 a 31.
Valor devuelto Number - El resultado de la operacin en modo bit.

Ejemplo En el ejemplo siguiente, el entero 1 se desplaza 10 bits a la izquierda: x = 1 << 10 El resultado de esta operacin es x = 1024. Eso se debe a que 1 decimal es igual a 1 binario, 1 binario desplazado 10 bits a la izquierda es 10000000000 binario, y 10000000000 binario es 1024 decimal. En el ejemplo siguiente, el entero 7 se desplaza 8 bits a la izquierda: x = 7 << 8 El resultado de esta operacin es x = 1792. Eso se debe a que 7 decimal es igual a 111 binario, 111 binario desplazado 8 bits a la izquierda es 11100000000 binario, y 11100000000 binario es 1792 decimal. Si se sigue el ejemplo siguiente, se podr comprobar que los bits se han desplazado dos espacios a la izquierda:
// 2 binary == 0010 // 8 binary == 1000 trace(2 << 2); // output: 8
Vase tambin
>>= operador de asignacin y desplazamiento a la derecha en modo bit, >> operador de desplazamiento a la derecha en modo bit, <<= operador de asignacin y desplazamiento a la izquierda en modo bit>>> operador de desplazamiento a la derecha en modo bit sin signo, >>>= operador de asignacin y desplazamiento a la derecha en modo bit sin signo
<<= operador de asignacin y desplazamiento a la izquierda en modo bit

expression1 <<= expression2
Este operador ejecuta una operacin de desplazamiento a la izquierda en modo bit (<<) y almacena el contenido como un resultado en expression1. Las dos expresiones siguientes son equivalentes:
A <<= BA = (A << B)

expression1 : Number - Nmero o expresin que se va a desplazar a la izquierda. expression2 : Number - Nmero o expresin que se convierte en un entero de 0 a 31.
Valor devuelto Number - El resultado de la operacin en modo bit. Ejemplo En el ejemplo siguiente, utilice el operador de asignacin y desplazamiento a la izquierda en modo bit (<<=) para desplazar todos los bits un espacio a la izquierda:
var x:Number = 4; // shift all bits one slot to the left. x <<= 1; trace(x); // output: 8 // 4 decimal = 0100 binary // 8 decimal = 1000 binary
Vase tambin
<< operador de desplazamiento a la izquierda en modo bit, >>= operador de asignacin y desplazamiento a la derecha en modo bit, >> operador de desplazamiento a la derecha en modo bit

~ operador NOT en modo bit

~expression
Tambin conocido como operador complementario del uno u operador complementario en modo bit. Convierte expression en un entero de 32 bits sin signo y, a continuacin, aplica un complemento de uno en modo bit. Es decir, que cada bit que sea 0 se establece como 1 en el resultado y cada bit que sea 1 se establece como 0 en el resultado. El resultado es un entero de 32 bits sin signo. Por ejemplo, el valor hexadecimal 0x7777 se representa como este nmero binario: 0111011101110111 La negacin en modo bit de dicho valor hexadecimal, ~0x7777, se corresponde con este nmero binario: 1000100010001000 El valor hexadecimal correspondiente es 0x8888. Por lo tanto, ~0x7777 es 0x8888. El uso ms comn de los operadores en modo bit es la representacin de bits indicadores (valores booleanos empaquetados en 1 bit cada uno). Los nmeros de coma flotante se convierten en enteros al descartarse los dgitos despus de la coma decimal. Los enteros positivos se convierten en un valor hexadecimal sin signo con un valor mximo de 4294967295 o 0xFFFFFFFF; se descartan los dgitos ms significativos de los valores mayores que el mximo cuando se convierten, de forma que el valor siga siendo de 32 bits. Los nmeros negativos se convierten en un valor hexadecimal sin signo a travs de la notacin complementaria del dos, donde el mnimo es -2147483648 o 0x800000000; los nmeros menores que el mnimo se convierten en el complemento del dos con una mayor precisin y tambin se descartan sus dgitos ms significativos. El valor devuelto se interpreta como un nmero complementario del dos con signo, de forma que el valor devuelto sea un entero del intervalo comprendido entre -2147483648 y 2147483647. Disponibilidad Flash Lite 2.0 Operandos
expression : Number - Un nmero.
Valor devuelto Number - El resultado de la operacin en modo bit. Ejemplo El ejemplo siguiente muestra un uso del operador NOT en modo bit (~) con bits indicadores:

var ReadOnlyFlag:Number = 0x0001; // defines bit 0 as the read-only flag var flags:Number = 0; trace(flags); /* To set the read-only flag in the flags variable, the following code uses the bitwise OR: */ flags |= ReadOnlyFlag; trace(flags); /* To clear the read-only flag in the flags variable, first construct a mask by using bitwise NOT on ReadOnlyFlag. In the mask, every bit is a 1 except for the read-only flag. Then, use bitwise AND with the mask to clear the read-only flag. The following code constructs the mask and performs the bitwise AND: */ flags &= ~ReadOnlyFlag; trace(flags); // output: 0 1 0
Vase tambin
& operador AND en modo bit, &= asignacin de AND en modo bit, operador, ^ operador XOR en modo bit, ^= asignacin de XOR en modo bit, operador| operador OR en modo bit, |= asignacin de OR en modo bit, operador
| operador OR en modo bit

expression1 | expression2
Convierte expression1 y expression2 en enteros de 32 bits sin signo y devuelve 1 en cada posicin de bit donde los correspondientes bits, tanto de expression1 como expression2 son 1. Los nmeros de coma flotante se convierten en enteros al descartarse los dgitos despus de la coma decimal. El resultado es un nuevo entero de 32 bits. Los enteros positivos se convierten en un valor hexadecimal sin signo con un valor mximo de 4294967295 o 0xFFFFFFFF; se descartan los dgitos ms significativos de los valores mayores que el mximo cuando se convierten, de forma que el valor siga siendo de 32 bits. Los nmeros negativos se convierten en un valor hexadecimal sin signo a travs de la notacin complementaria del dos, donde el mnimo es -2147483648 o 0x800000000; los nmeros menores que el mnimo se convierten en el complemento del dos con una mayor precisin y tambin se descartan sus dgitos ms significativos. El valor devuelto se interpreta como un nmero complementario del dos con signo, de forma que el valor devuelto ser un entero del intervalo comprendido entre -2147483648 y 2147483647. Disponibilidad Flash Lite 2.0 Operandos
Valor devuelto Number - El resultado de la operacin en modo bit.

Ejemplo A continuacin, se ofrece un ejemplo de una operacin OR (|) en modo bit:

// 15 decimal = 1111 binary var x:Number = 15; // 9 decimal = 1001 binary var y:Number = 9; // 1111 | 1001 = 1111 trace(x | y); // returns 15 decimal (1111 binary)
No se debe confundir | (OR en modo bit) con || (OR lgico). Vase tambin
& operador AND en modo bit, &= asignacin de AND en modo bit, operador, ^ operador XOR en modo bit, ^= asignacin de XOR en modo bit, operador|= asignacin de OR en modo bit, operador, ~ operador NOT en modo bit
|= asignacin de OR en modo bit, operador

expression1 |= expression2
Asigna a expression1 el valor de expression1 | expression2. Por ejemplo, las dos sentencias siguientes son equivalentes:
x |= y; and x = x | y;

expression1 : Number - Un nmero o variable. expression2 : Number - Un nmero o variable.
Valor devuelto Number - El resultado de la operacin en modo bit. Ejemplo El ejemplo siguiente utiliza el operador de asignacin OR en modo bit (|=):
// 15 decimal = 1111 binary var x:Number = 15; // 9 decimal = 1001 binary var y:Number = 9; // 1111 |= 1001 = 1111 trace(x |= y); // returns 15 decimal (1111 binary)
Vase tambin
& operador AND en modo bit, &= asignacin de AND en modo bit, operador, ^ operador XOR en modo bit, ^= asignacin de XOR en modo bit, operador| operador OR en modo bit, ~ operador NOT en modo bit
>> operador de desplazamiento a la derecha en modo bit

expression1 >> expression2

Convierte expression1 y expression2 en enteros de 32-bits, y cambia todos los bits en expression1 a la derecha por el nmero de espacios especificados por el entero resultante de la conversin de expression2. Los bits que se desplazan fuera del extremo derecho se descartan. Para conservar el signo del original expression, los bits a la izquierda se completan con un 0 si el bit ms importante (el situado en el extremo izquierdo) de expression1 es 0, y con 1 si el bit ms importante es 1. Desplazar un valor una posicin a la derecha equivale a dividir por 2 y descartar el resto. Los nmeros de coma flotante se convierten en enteros al descartarse los dgitos despus de la coma decimal. Los enteros positivos se convierten en un valor hexadecimal sin signo con un valor mximo de 4294967295 o 0xFFFFFFFF; se descartan los dgitos ms significativos de los valores mayores que el mximo cuando se convierten, de forma que el valor siga siendo de 32 bits. Los nmeros negativos se convierten en un valor hexadecimal sin signo a travs de la notacin complementaria del dos, donde el mnimo es -2147483648 o 0x800000000; los nmeros menores que el mnimo se convierten en el complemento del dos con una mayor precisin y tambin se descartan sus dgitos ms significativos. El valor devuelto se interpreta como un nmero complementario del dos con signo, de forma que el valor devuelto ser un entero del intervalo comprendido entre -2147483648 y 2147483647. Disponibilidad Flash Lite 2.0 Operandos
expression1 : Number - Nmero o expresin que se va a desplazar a la derecha. expression2 : Number - Nmero o expresin que se convierte en un entero de 0 a 31.
Valor devuelto Number - El resultado de la operacin en modo bit. Ejemplo El ejemplo siguiente convierte 65535 en un entero de 32 bits y lo desplaza 8 bits a la derecha:
var x:Number = 65535 >> 8; trace(x); // outputs 255
El ejemplo siguiente muestra el resultado del ejemplo anterior:

var x:Number = 255;
Eso se debe a que 65535 decimal es igual a 1111111111111111 binario (diecisis unos), 1111111111111111 binario desplazado 8 bits a la derecha es 11111111 binario, y 11111111 binario es 255 decimal. El bit ms significativo es 0 porque los enteros son de 32 bits, por lo que el bit de relleno es 0. El ejemplo siguiente convierte -1 en un entero de 32 bits y lo desplaza 1 bit a la derecha:
var x:Number = -1 >> 1; trace(x); // outputs -1
El ejemplo siguiente muestra el resultado del ejemplo anterior:

var x:Number = -1;
Esto se debe a que -1 decimal es igual a 11111111111111111111111111111111 binario (treinta y dos unos); el desplazamiento de un bit a la derecha hace que se descarte el bit menos significativo (el situado ms a la derecha) y que se rellene con 1 el bit ms significativo. El resultado es 11111111111111111111111111111111 binario (treinta y dos unos), lo que representa el entero de 32 bits -1.

Vase tambin
>>= operador de asignacin y desplazamiento a la derecha en modo bit

expression1 >>= expression2
Este operador ejecuta una operacin de desplazamiento a la derecha en modo bit y almacena el contenido como un resultado en expression1. Las dos sentencias siguientes son equivalentes:
A >>= B; and A = (A >> B);

Valor devuelto Number - El resultado de la operacin en modo bit. Ejemplo El siguiente cdigo comentado utiliza el operador de asignacin y desplazamiento a la derecha en modo bit (>>=).
function convertToBinary(numberToConvert:Number):String { var result:String = ""; for (var i = 0; i<32; i++) { // Extract least significant bit using bitwise AND var lsb:Number = numberToConvert & 1; // Add this bit to the result string result = (lsb ? "1" : "0")+result; // Shift numberToConvert right by one bit, to see next bit numberToConvert >>= 1; } return result; } trace(convertToBinary(479)); // Returns the string 00000000000000000000000111011111 // This string is the binary representation of the decimal // number 479
Vase tambin
>> operador de desplazamiento a la derecha en modo bit
>>> operador de desplazamiento a la derecha en modo bit sin signo

expression1 >>> expression2
Es igual al operador de desplazamiento a la derecha en modo bit (>>), con la diferencia de que no conserva el signo de la expression original porque los bits a la izquierda se rellenan siempre con un 0.

Los nmeros de coma flotante se convierten en enteros al descartarse los dgitos despus de la coma decimal. Los enteros positivos se convierten en un valor hexadecimal sin signo con un valor mximo de 4294967295 o 0xFFFFFFFF; se descartan los dgitos ms significativos de los valores mayores que el mximo cuando se convierten, de forma que el valor siga siendo de 32 bits. Los nmeros negativos se convierten en un valor hexadecimal sin signo a travs de la notacin complementaria del dos, donde el mnimo es -2147483648 o 0x800000000; los nmeros menores que el mnimo se convierten en el complemento del dos con una mayor precisin y tambin se descartan sus dgitos ms significativos. Disponibilidad Flash Lite 2.0 Operandos
expression1 : Number - Nmero o expresin que se va a desplazar a la derecha. expression2 : Number - Nmero o expresin que se convierte en un entero entre 0 y 31.
Valor devuelto Number - El resultado de la operacin en modo bit. Ejemplo El ejemplo siguiente convierte -1 en un entero de 32 bits y lo desplaza 1 bit a la derecha:
var x:Number = -1 >>> 1; trace(x); // output: 2147483647
Esto se debe a que -1 decimal es 11111111111111111111111111111111 binario (treinta y dos unos) y cuando se desplaza a la derecha (sin signo) 1 bit, se descarta el bit menos significativo (situado ms a la derecha) y se rellena el bit ms significativo (situado ms a la izquierda) con un 0. El resultado es 01111111111111111111111111111111 binario, lo que representa el entero de 32 bits 2147483647. Vase tambin
>>>= operador de asignacin y desplazamiento a la derecha en modo bit sin signo

expression1 >>>= expression2
Ejecuta una operacin de desplazamiento a la derecha en modo bit sin signo y almacena el contenido como un resultado en expression1. Las dos sentencias siguientes son equivalentes:
A >>>= B; and A = (A >>> B);


Valor devuelto Number - El resultado de la operacin en modo bit. Vase tambin

>>> operador de desplazamiento a la derecha en modo bit sin signo, >>= operador de asignacin y desplazamiento a la derecha en modo bit
^ operador XOR en modo bit

expression1 ^ expression2
Convierte expression1 y expression2 en enteros de 32 bits sin signo y devuelve un 1 en cada posicin de bit donde los correspondientes bits tanto de expression1 como de expression2, pero no ambos, sean 1. Los nmeros de coma flotante se convierten en enteros al descartarse los dgitos despus de la coma decimal. El resultado es un nuevo entero de 32 bits. Los enteros positivos se convierten en un valor hexadecimal sin signo con un valor mximo de 4294967295 o 0xFFFFFFFF; se descartan los dgitos ms significativos de los valores mayores que el mximo cuando se convierten, de forma que el valor siga siendo de 32 bits. Los nmeros negativos se convierten en un valor hexadecimal sin signo a travs de la notacin complementaria del dos, donde el mnimo es -2147483648 o 0x800000000; los nmeros menores que el mnimo se convierten en el complemento del dos con una mayor precisin y tambin se descartan sus dgitos ms significativos. El valor devuelto se interpreta como un nmero complementario del dos con signo, de forma que el valor devuelto ser un entero del intervalo comprendido entre -2147483648 y 2147483647. Disponibilidad Flash Lite 2.0 Operandos
Valor devuelto Number - El resultado de la operacin en modo bit. Ejemplo El ejemplo siguiente utiliza el operador XOR en modo bit en los decimales 15 y 9, y asigna el resultado a la variable x:
// 15 decimal = 1111 binary // 9 decimal = 1001 binary var x:Number = 15 ^ 9; trace(x); // 1111 ^ 1001 = 0110 // returns 6 decimal (0110 binary)
Vase tambin
& operador AND en modo bit, &= asignacin de AND en modo bit, operador, ^= asignacin de XOR en modo bit, operador, | operador OR en modo bit, |= asignacin de OR en modo bit, operador, ~ operador NOT en modo bit

^= asignacin de XOR en modo bit, operador

expression1 ^= expression2
Asigna a expression1 el valor de expression1 ^ expression2. Por ejemplo, las dos sentencias siguientes son equivalentes:
x ^= y x = x ^ y

expression1 : Number - Enteros y variables. expression2 : Number - Enteros y variables.
Valor devuelto Number - El resultado de la operacin en modo bit. Ejemplo El ejemplo siguiente muestra una operacin de asignacin de XOR en modo bit (^=):
// 15 decimal = 1111 binary var x:Number = 15; // 9 decimal = 1001 binary var y:Number = 9; trace(x ^= y); // returns 6 decimal (0110 binary)
Vase tambin
& operador AND en modo bit, &= asignacin de AND en modo bit, operador, ^ operador XOR en modo bit, | operador OR en modo bit|= asignacin de OR en modo bit, operador, ~ operador NOT en modo bit
/* operador de delimitador de comentario en bloque

/* comment */ /* comment comment */
Indica una o varias lneas de comentarios de guin. Los caracteres que aparecen entre la etiqueta de apertura de comentario (/*) y la etiqueta de cierre de comentario (*/) se interpretan como un comentario y el intrprete de ActionScript los omite. Utilice el delimitador de comentario // para identificar los comentarios en una sola lnea. Utilice el delimitador de comentario /* para identificar los comentarios en varias lneas sucesivas. Si no se inserta la etiqueta de cierre (*/) cuando se utiliza esta forma de delimitador de comentario, aparece un mensaje de error. Tambin aparece un mensaje de error si se intenta anidar comentarios. Despus de utilizar una etiqueta de apertura de comentario (/*), la primera etiqueta de cierre de comentario (/*) finalizar el comentario, independientemente del nmero de etiquetas de apertura (/*) que haya entre ambas. Disponibilidad Flash Lite 1.0 Operandos comment - Cualquier carcter.

Ejemplo El guin siguiente utiliza delimitadores de comentarios al principio:

/* records the X and Y positions of the ball and bat movie clips */ var ballX:Number = ball_mc._x; var ballY:Number = ball_mc._y; var batX:Number = bat_mc._x; var batY:Number = bat_mc._y;
Este intento de anidar comentarios producir un mensaje de error:

/* this is an attempt to nest comments. /* But the first closing tag will be paired with the first opening tag */ and this text will not be interpreted as a comment */
Vase tambin
// operador de delimitador de comentario de lnea
, operador de coma
(expression1 , expression2 [, expressionN... ])
Evala primero expression1, luego expression2, y as sucesivamente. Este operador se utiliza principalmente con la sentencia de bucle for y a menudo con el operador de parntesis (). Disponibilidad Flash Lite 1.0 Operandos
expression1 : Number - Expresin que se va a evaluar. expression2 : Number - Expresin que se va a evaluar. expressionN : Number - Cualquier nmero de expresiones adicionales que se van a evaluar.
Valor devuelto Object - El valor de expression1, expression2, y as sucesivamente. Ejemplo El ejemplo siguiente utiliza el operador de coma (,) en un bucle for:
for (i = 0, j = 0; i < 3 && j < 3; i++, j+=2) { trace("i = " + i + ", j = " + j); } // Output: // i = 0, j = 0 // i = 1, j = 2
El ejemplo siguiente utiliza el operador de coma (,) sin el operador de parntesis () e ilustra que el operador de coma devuelve nicamente el valor de la primera expresin sin el operador de parntesis ():
var v:Number = 0; v = 4, 5, 6; trace(v); // output: 4

El ejemplo siguiente utiliza el operador de coma (,) con el operador de parntesis () e ilustra que el operador de coma devuelve el valor de la ltima expresin cuando se utiliza con el operador de parntesis ():
var v:Number = 0; v = (4, 5, 6); trace(v); // output: 6
El ejemplo siguiente utiliza el operador de coma (,) sin el operador de parntesis () e ilustra que el operador de coma evala secuencialmente todas las expresiones pero devuelve el valor de la primera expresin. Se evala la segunda expresin, z++, y z se incrementa en uno.
var v:Number = 0; var z:Number = 0; v = v + 4 , z++, v + 6; trace(v); // output: 4 trace(z); // output: 1
El ejemplo siguiente es idntico al ejemplo anterior, salvo por la adicin del operador de parntesis () e ilustra una vez ms que, cuando se utiliza con el operador de parntesis (), el operador de coma (,) devuelve el valor de la ltima expresin de la serie:
var v:Number = 0; var z:Number = 0; v = (v + 4, z++, v + 6); trace(v); // output: 6 trace(z); // output: 1
Vase tambin
() operador de parntesis
suma de concatenacin (cadenas), operador

string1 add string2
Desfasada desde Flash Player 5. Adobe recomienda utilizar el operador de suma (+) cuando cree contenido para Flash Player 5 o versiones posteriores. Nota: en Flash Lite 2.0, tambin el operador agregar est desfasado y en su lugar debe utilizarse el operador (+). Concatena dos o ms cadenas. El operador de suma (+) sustituye al operador & de Flash 4; los archivos de Flash Player 4 que utilizan el operador & se convierten automticamente para utilizar el operador de suma (+) para la concatenacin de cadenas cuando pasan al entorno de edicin de Flash 5 o versiones posteriores. Debe utilizar el operador de suma (+) para concatenar cadenas si est creando contenido para Flash Player 4 o versiones anteriores de Flash Player. Disponibilidad Flash Lite 1.0 Operandos
string1 : String - Una cadena. string2 : String - Una cadena.
Valor devuelto String - La cadena concatenada.

Vase tambin
+ adicin, operador
?: conditional operator
expression1 ? expression2 : expression3
Indica a Flash que evale expression1 y si el valor de expression1 es true, devuelve el valor de expression2; en caso contrario, devuelve el valor de expression3. Disponibilidad Flash Lite 1.0 Operandos
: Object - expression1 Expresin que da como resultado un valor booleano; normalmente una expresin de comparacin, como x < 5. expression2 : Object - Valores de cualquier tipo. expression3 : Object - Valores de cualquier tipo.
Valor devuelto Object - El valor de expression2 o expression3. Ejemplo La siguiente sentencia asigna el valor de variable x a la variable z porque expression1 da como resultado true:
var x:Number = 5; var y:Number = 10; var z = (x < 6) ? x: y; trace (z); // returns 5
El ejemplo siguiente muestra una sentencia condicional escrita en forma abreviada:

var timecode:String = (new Date().getHours() < 11) ? "AM" : "PM"; trace(timecode);
La misma sentencia condicional tambin puede escribirse en forma no abreviada, como se muestra en el ejemplo siguiente:
if (new Date().getHours() < 11) { var timecode:String = "AM"; } else { var timecode:String = "PM"; } trace(timecode);
-- operador de decremento
--expression expression--
Operador unario de decremento previo y decremento posterior que resta 1 de expression1. La expression puede ser una variable, un elemento de una matriz o una propiedad de un objeto. La forma de decremento previo del operador (-expression) resta 1 de expression y devuelve el resultado. La forma de decremento posterior del operador (expression-) resta 1 de expression y devuelve el valor inicial de expression (el valor antes de la resta).


expression : Number - Nmero o variable que da como resultado un nmero.
Valor devuelto Number - El resultado del valor decrementado. Ejemplo La forma de decremento previo del operador decrementa x hasta 2 (x - 1 = 2) y devuelve el resultado como y:
var x:Number = 3; var y:Number = --x; //y is equal to 2
La forma de decremento previo del operador decrementa x hasta 2 (x - 1 = 2) y devuelve el valor original de x como el resultado y:
var x:Number = 3; var y:Number = x--; //y is equal to 3
El ejemplo siguiente reproduce indefinidamente de 10 a 1 y cada repeticin del bucle decrementa la variable de contador i en 1.
for (var i = 10; i>0; i--) { trace(i); }
/ operador de divisin
expression1 / expression2
Divide expression1 por expression2. El resultado de la operacin de divisin es un nmero de coma flotante de doble precisin. Disponibilidad Flash Lite 1.0 Operandos
Valor devuelto Number - El resultado de coma flotante de la operacin. Ejemplo La sentencia siguiente divide el ancho y el alto actuales del escenario y, a continuacin, muestra el resultado en el panel Salida.
trace(Stage.width/2); trace(Stage.height/2);
Con un ancho y un alto de escenario predeterminados de 550 x 400, el resultado es 275 y 150.

Vase tambin
% operador de mdulo
/= operador de asignacin de divisin

expression1 /= expression2
Asigna a expression1 el valor de expression1 / expression2. Por ejemplo, las dos sentencias siguientes son equivalentes:
x /= y; and x = x / y;

expression1 : Number - Nmero o variable que da como resultado un nmero. expression2 : Number - Nmero o variable que da como resultado un nmero.
Valor devuelto Number - Un nmero. Ejemplo El cdigo siguiente ilustra el uso del operador asignacin de divisin (/=) con variables y nmeros:
var x:Number = 10; var y:Number = 2; x /= y; trace(x); // output: 5
Vase tambin
/ operador de divisin
. operador de punto
object.property_or_method instancename.variable instancename.childinstance instancename.childinstance.variable
Se utiliza para navegar por las jerarquas de clips de pelcula y acceder a variables, propiedades o clips de pelcula anidados (secundarios). El operador de punto se utiliza tambin para probar o establecer las propiedades de un objeto o clase de nivel superior, para ejecutar un mtodo de un objeto o clase de nivel superior o para crear una estructura de datos. Disponibilidad Flash Lite 1.0 Operandos
object : Object - Una instancia de una clase. El objeto puede ser una instancia de cualquiera de las clases de
ActionScript incorporadas o una clase personalizada. Este parmetro se ubica siempre a la izquierda del operador de punto (.).

property_or_method - Nombre de una propiedad o mtodo asociado con un objeto. Todos los mtodos y
propiedades vlidos para las clases incorporadas se enumeran en las tablas de resumen de mtodo y propiedades de dicha clase. Este parmetro se ubica siempre a la derecha del operador de punto (.).
instancename : MovieClip- Nombre de instancia del clip de pelcula. variable Nombre de instancia a la izquierda del operador de punto (.) tambin puede representar una variable en
la lnea de tiempo del clip de pelcula.

childinstance : MovieClip - Nombre de instancia de un clip de pelcula que es un elemento secundario o anidado
de otro clip de pelcula. Valor devuelto

Object - El mtodo, propiedad o clip de pelcula que aparece a la derecha del punto.
Ejemplo El ejemplo siguiente identifica el valor actual de la variable hairColor en el clip de pelcula person_mc:
person_mc.hairColor
El entorno de edicin de Flash 4 no admita la sintaxis con punto, pero los archivos de Flash MX 2004 publicados para Player 4 pueden utilizar el operador de punto. El ejemplo anterior equivale a la siguiente sintaxis de Flash 4 (desfasada):
/person_mc:hairColor
El ejemplo siguiente crea un clip de pelcula nuevo en el mbito _root. A continuacin, se crea un campo de texto dentro del clip de pelcula llamado container_mc. La propiedad autoSize del campo de texto se establece como true y, a continuacin, se rellena con la fecha actual.
this.createEmptyMovieClip("container_mc", this.getNextHighestDepth()); this.container_mc.createTextField("date_txt", this.getNextHighestDepth(), 0, 0, 100, 22); this.container_mc.date_txt.autoSize = true; this.container_mc.date_txt.text = new Date();
El operador de punto (.) se utiliza para referirse a una instancia dentro del archivo SWF y cuando es necesario establecer propiedades y valores para esas instancias.
expression1 == expression2
Comprueba la igualdad de dos expresiones. El resultado es true si las expresiones son iguales. La definicin de igual depende del tipo de datos del parmetro:
Los valores numricos y booleanos se comparan por su valor y se consideran iguales si tienen el mismo valor. Las expresiones de cadena son iguales si tienen el mismo nmero de caracteres y stos son idnticos. Las variables que representan objetos, matrices y funciones se comparan por su referencia. Dos de estas variables
son iguales si hacen referencia al mismo objeto, matriz o funcin. Dos matrices independientes nunca se consideran iguales, aunque tengan el mismo nmero de elementos. Si se comparan por su valor y expression1 y expression2 tienen tipos de datos diferentes, ActionScript intentar convertir el tipo de datos de expression2 para que coincida con el de expression1. Disponibilidad Flash Lite 1.0

Operandos
expression1 : Object - Un nmero, cadena, valor booleano, variable, objeto, matriz o funcin. expression2 : Object - Un nmero, cadena, valor booleano, variable, objeto, matriz o funcin.
Valor devuelto Boolean - El resultado booleano de la comparacin. Ejemplo El ejemplo siguiente utiliza el operador de igualdad (==) con una sentencia if:
var a:String = "David", b:String = "David"; if (a == b) { trace("David is David"); }
Los ejemplos siguientes muestran los resultados de operaciones que comparan tipos mixtos:
var x:Number = 5; var y:String = "5"; trace(x == y); // output: true var x:String = "5"; var y:String = "66"; trace(x == y); // output: false var x:String = "chris"; var y:String = "steve"; trace(x == y); // output: false
Los ejemplos siguientes muestran una comparacin por referencia. El primer ejemplo compara dos matrices con una longitud y elementos idnticos. El operador de igualdad devolver false para estas dos matrices. Si bien las matrices parecen iguales, la comparacin por referencia requiere que ambas hagan referencia a la misma matriz. El segundo ejemplo crea la variable thirdArray, que seala a la misma matriz que la variable firstArray. El operador de igualdad devolver true para estas dos matrices porque las dos variables hacen referencia a la misma matriz.
var firstArray:Array = new Array("one", "two", "three"); var secondArray:Array = new Array("one", "two", "three"); trace(firstArray == secondArray); // will output false // Arrays are only considered equal // if the variables refer to the same array. var thirdArray:Array = firstArray; trace(firstArray == thirdArray); // will output true
Vase tambin
! operador NOT lgico, != operador de desigualdad, !== operador de desigualdad estricta, && AND lgico, operador|| OR lgico, operador, === operador de igualdad estricta
igualdad (eq) (cadenas), operador

expression1 eq expression2
Desfasada desde Flash Player 5. Este operador est desfasado y en su lugar debe utilizarse el operador == (equality). Compara la igualdad de dos expresiones y devuelve un valor de true si la representacin de cadena de expression1 es igual que la representacin de cadena de expression2; en caso contrario, devuelve false.


expression1 : Object - Nmeros, cadenas o variables. expression2 : Object - Nmeros, cadenas o variables.
Valor devuelto Boolean - El resultado de la comparacin. Vase tambin

> operador mayor que

expression1 > expression2
Compara dos expresiones y determina si expression1 es mayor que expression2; si lo es, el operador devuelve true. Si expression1 es menor o igual que expression2, el operador devuelve false. Las expresiones de cadena se evalan por orden alfabtico; todas las letras maysculas preceden a las minsculas. Disponibilidad Flash Lite 1.0 Operandos
expression1 : Object - Un nmero o cadena. expression2 : Object - Un nmero o cadena.
Valor devuelto Boolean - El resultado booleano de la comparacin. Ejemplo En el ejemplo siguiente, el operador mayor que (>) se utiliza para determinar si el valor del campo de texto score_txt es mayor que 90:
if (score_txt.text>90) { trace("Congratulations, you win!"); } else { trace("sorry, try again"); }
>gt, operador mayor que (cadenas)

expression1 gt expression2
Desfasada desde Flash Player 5. Este operador est desfasado y en su lugar debe utilizarse el operador > (mayor que) Compara la representacin de cadena de expression1 con la representacin de cadena de expression2 y devuelve true si expression1 es mayor que expression2; en caso contrario, devuelve false.


Valor devuelto Boolean - El resultado booleano de la comparacin. Vase tambin

> operador mayor que
>= ge, operador mayor o igual que

expression1 >= expression2
Compara dos expresiones y determina si expression1 es mayor o igual que expression2 (true) o si expression1 es menor que expression2 (false). Disponibilidad Flash Lite 1.0 Operandos
expression1 : Object - Una cadena, un entero o un nmero de coma flotante. expression2 : Object - Una cadena, un entero o un nmero de coma flotante.
Valor devuelto Boolean - El resultado booleano de la comparacin. Ejemplo En el ejemplo siguiente, el operador de mayor o igual que (>=) se emplea para determinar si la hora actual es mayor o igual que 12:
if (new Date().getHours() >= 12) { trace("good afternoon"); } else { trace("good morning"); }
ge, operador mayor o igual que (cadenas)

expression1 ge expression2
Desfasada desde Flash Player 5. Este operador est desfasado y en su lugar debe utilizarse el operador >= (mayor o igual que). Compara la representacin de cadena de expression1 con la representacin de cadena de expression2 y devuelve true si expression1 es mayor o igual que expression2; en caso contrario, devuelve false.



>= ge, operador mayor o igual que
++ operador de incremento
++expression expression++
Operador unario de incremento previo e incremento posterior que aade 1 a expression1. La expression puede ser una variable, un elemento de una matriz o una propiedad de un objeto. La forma de incremento previo del operador (++expression) agrega 1 a expression y devuelve el resultado. La forma de incremento posterior del operador (expression++) aade 1 a expression y devuelve el valor inicial de expression (el valor antes de la suma). La forma de incremento previo del operador incrementa x to 2 (x + 1 = 2) y devuelve el resultado como y:
var x:Number = var y:Number = trace("x:"+x); trace("y:"+y); 1; ++x; //traces x:2 //traces y:2
La forma de incremento posterior del operador incrementa x hasta 2 (x + 1 = 2) y devuelve el valor original de x como el resultado y:
var x:Number = var y:Number = trace("x:"+x); trace("y:"+y); 1; x++; //traces x:2 //traces y:1

Valor devuelto Number - El resultado del incremento. Ejemplo El ejemplo siguiente utiliza ++ como operador de incremento posterior para hacer que un bucle while se ejecute cinco veces:

var i:Number = 0; while (i++ < 5) { trace("this is execution " + i); } /* output: this is execution 1 this is execution 2 this is execution 3 this is execution 4 this is execution 5 */
El ejemplo siguiente utiliza ++ como operador de incremento previo:

var a:Array = new Array(); var i:Number = 0; while (i < 10) { a.push(++i); } trace(a.toString()); //traces: 1,2,3,4,5,6,7,8,9,10
Este ejemplo tambin utiliza ++ como operador de incremento previo.

var a:Array = []; for (var i = 1; i <= 10; ++i) { a.push(i); } trace(a.toString()); //traces: 1,2,3,4,5,6,7,8,9,10
Este guin muestra el siguiente resultado en el panel Salida: 1,2,3,4,5,6,7,8,9,10 El ejemplo siguiente utiliza ++ como operador de incremento posterior en un bucle while:
// using a while loop var a:Array = new Array(); var i:Number = 0; while (i < 10) { a.push(i++); } trace(a.toString()); //traces 0,1,2,3,4,5,6,7,8,9
El ejemplo siguiente utiliza ++ como operador de incremento posterior en un bucle for :

// using a for loop var a:Array = new Array(); for (var i = 0; i < 10; i++) { a.push(i); } trace(a.toString()); //traces 0,1,2,3,4,5,6,7,8,9
Este guin muestra el siguiente resultado en el panel Salida:

0,1,2,3,4,5,6,7,8,9
!= operador de desigualdad
expression1 != expression2

Prueba el contrario exacto del operador de igualdad (==). Si expression1 es igual que expression2 , el resultado es false. Como ocurre con el operador de igualdad (==), la definicin de igual depende de los tipos de datos que se comparan, tal y como se muestra en la siguiente lista:
Los nmeros, cadenas y valores booleanos se comparan por su valor. Los objetos, matrices y funciones se comparan por su referencia. Una variable se compara por su valor o referencia, en funcin de su tipo.
La comparacin por su valor significa que dos expresiones tienen el mismo valor. Por ejemplo, la expresin (2 + 3) es igual que la expresin (1 + 4) si se comparan sus valores. La comparacin por su referencia significa que dos expresiones son nicamente iguales si ambas hacen referencia al mismo objeto, matriz o funcin. No se comparan los valores dentro del objeto, matriz o funcin. Si se comparan por su valor y expression1 y expression2 tienen tipos de datos diferentes, ActionScript intentar convertir el tipo de datos de expression2 para que coincida con el de expression1. Disponibilidad Flash Lite 2.0 Operandos
Valor devuelto Boolean - El resultado booleano de la comparacin. Ejemplo El ejemplo siguiente ilustra el resultado del operador de desigualdad (!=):
trace(5 != 8); // returns true trace(5 != 5); //returns false
El ejemplo siguiente ilustra el uso del operador de desigualdad (!=) en una sentencia if:
var a:String = "David"; var b:String = "Fool"; if (a != b) { trace("David is not a fool"); }
El ejemplo siguiente ilustra la comparacin por referencia con dos funciones:

var a:Function = function() { trace("foo"); }; var b:Function = function() { trace("foo"); }; a(); // foo b(); // foo trace(a != b); // true a = b; a(); // foo b(); // foo trace(a != b); // false // trace statement output: foo foo true foo foo false
El ejemplo siguiente ilustra la comparacin por referencia con dos matrices:

var a:Array = [ 1, 2, 3 ]; var b:Array = [ 1, 2, 3 ]; trace(a); // 1, 2, 3 trace(b); // 1, 2, 3 trace(a!=b); // true a = b; trace(a); // 1, 2, 3 trace(b); // 1, 2, 3 trace(a != b); // false // trace statement output: 1,2,3 1,2,3 true 1,2,3 1,2,3 false
Vase tambin
! operador NOT lgico, !== operador de desigualdad estricta, && AND lgico, operador, || OR lgico, operador== operador de igualdad, === operador de igualdad estricta
<> operador de desigualdad

expression1 <> expression2
Desfasada desde Flash Player 5. Este operador est desfasado. Adobe recomienda que utilice el operador != (desigualdad). Prueba el contrario exacto del operador de igualdad (==). Si expression1 es igual que expression2 , el resultado es false. Como ocurre con el operador de igualdad (==), la definicin de igual depende de los tipos de datos que se comparan:
Los nmeros, cadenas y valores booleanos se comparan por su valor. Los objetos, matrices y funciones se comparan por su referencia. Las variables se comparan por su valor o por referencia, en funcin de su tipo.
Valor devuelto Boolean - El resultado booleano de la comparacin. Vase tambin

instanceof, operador
object instanceof classConstructor
Comprueba si object es una instancia de classConstructor o una subclase de classConstructor. El operador instanceof no convierte tipos de datos simples en objetos envolventes. Por ejemplo, el cdigo siguiente devuelve true:
new String("Hello") instanceof String;
Mientras que el cdigo siguiente devuelve false:

"Hello" instanceof String;

object : Object - Un objeto ActionScript. classConstructor : Function - Una referencia a una funcin constructora de ActionScript, como String o Date.
Valor devuelto
Boolean - Si object es una instancia o una subclase de classConstructor, instanceof devuelve true; de lo
contrario, devuelve false. Tambin, _global instanceof Object devuelve false. Vase tambin
typeof, operador
< operador menor que

expression1 < expression2
Compara dos expresiones y determina si expression1 es menor que expression2; si lo es, el operador devuelve true. Si expression1 es mayor o igual que expression2, el operador devuelve false. Las expresiones de cadena se evalan por orden alfabtico; todas las letras maysculas preceden a las minsculas. Disponibilidad Flash Lite 1.0 Operandos
expression1 : Number - Un nmero o cadena. expression2 : Number - Un nmero o cadena.
Valor devuelto Boolean - El resultado booleano de la comparacin. Ejemplo Los siguientes ejemplos muestran devoluciones true y false tanto para comparaciones numricas y de cadena:
trace(3 < 10); // true trace(10 < 3); // false trace("Allen" < "Jack"); // true trace("Jack" < "Allen"); //false trace("11" < "3"); // true trace("11" < 3); // false (numeric comparison) trace("C" < "abc"); // true trace("A" < "a"); // true
lt, operador menor que (cadenas)

expression1 lt expression2

Desfasado desde Flash Player 5. Este operador est desfasado y en su lugar debe utilizarse < (menor que). Compara expression1 con expression2 y devuelve true si expression1 es menor que expression2; de lo contrario, devuelve false . Disponibilidad Flash Lite 1.0 Operandos

< operador menor que
<= operador menor o igual que

expression1 <= expression2
Compara dos expresiones y determina si expression1 es menor o igual que expression2; si lo es, el operador devuelve true. Si expression1 es mayor que expression2, el operador devuelve false. Las expresiones de cadena se evalan por orden alfabtico; todas las letras maysculas preceden a las minsculas. Disponibilidad Flash Lite 1.0 Operandos
expression1 : Object - Un nmero o cadena. expression2 : Object - Un nmero o cadena.
Valor devuelto Boolean - El resultado booleano de la comparacin. Ejemplo Los siguientes ejemplos muestran resultados true y false para comparaciones tanto numricas como de cadena:
trace(5 <= 10); // true trace(2 <= 2); // true trace(10 <= 3); // false trace("Allen" <= "Jack"); // true trace("Jack" <= "Allen"); // false trace("11" <= "3"); // true trace("11" <= 3); // false (numeric comparison) trace("C" <= "abc"); // true trace("A" <= a); // true

le, operador menor o igual que (cadenas)

expression1 le expression2
Desfasada desde Flash Player 5. Este operador est desfasado en Flash 5 y en su lugar debe utilizarse el operador <= (menor o igual que). Compara expression1 con expression2 y devuelve un valor detrue si expression1 es menor o igual que expression2; de lo contrario, devuelve false. Disponibilidad Flash Lite 1.0 Operandos

<= operador menor o igual que
// operador de delimitador de comentario de lnea

// comment
Indica el principio de un comentario de guin. Los caracteres que aparecen entre el delimitador de comentario (//) y el carcter de final de lnea se interpretan como un comentario y el intrprete de ActionScript los omite. Disponibilidad Flash Lite 1.0 Operandos comment - Cualquier carcter. Ejemplo El guin siguiente utiliza delimitadores de comentario para identificar la primera, tercera, quinta y sptima lneas como comentarios:
// record the X position of the var ballX:Number = ball_mc._x; // record the Y position of the var ballY:Number = ball_mc._y; // record the X position of the var batX:Number = bat_mc._x; // record the Y position of the var batY:Number = bat_mc._y; ball movie clip ball movie clip bat movie clip ball movie clip
Vase tambin
/* operador de delimitador de comentario en bloque

&& AND lgico, operador

expression1 && expression2
Ejecuta una operacin booleana en los valores una de las expresiones o en ambas. Evala expression1 (la expresin en la parte izquierda del operador) y devuelve false si la expresin da como resultado false. Si expression1 da como resultado true, se evala expression2 (la expresin en la parte derecha del operador). Si expression2 da como resultado true, el resultado final es true; de lo contrario, es false.. La expresin true&&true da como resultado true, true&&false da como resultado false, false&&false da como resultado false y false&&true da como resultado false Disponibilidad Flash Lite 1.0 Operandos
expression1 : Number - Un valor booleano o una expresin que se convierta en un valor booleano. expression2 : Number - Un valor booleano o una expresin que se convierta en un valor booleano.
Valor devuelto Boolean - Un resultado booleano de la operacin lgica. Ejemplo El ejemplo siguiente utiliza el operador AND lgico (&&) para realizar una prueba para determinar si un jugador ha ganado la partida. La variable turns y la variable score se actualizan cuando un jugador juega o gana puntos durante el juego. El guin muestra "You Win the Game!" en el panel Salida cuando la puntuacin del jugador llega a 75 o ms en tres jugadas o menos.
var turns:Number = 2; var score:Number = 77; if ((turns <= 3) && (score >= 75)) { trace("You Win the Game!"); } else { trace("Try Again!"); } // output: You Win the Game!
Vase tambin
! operador NOT lgico, != operador de desigualdad, !== operador de desigualdad estricta, || OR lgico, operador== operador de igualdad, === operador de igualdad estricta
AND lgico (and), operador

condition1 and condition2
Desfasada desde Flash Player 5. Adobe recomienda que utilice el operador lgico AND (&&). Realiza una operacin de AND lgica (&&) en Flash Player 4. Si las dos expresiones dan como resultado true, toda la expresin ser true. Disponibilidad Flash Lite 1.0

Operandos
condition1 : Boolean - Una condicin o expresin que devuelve true o false. condition2 : Boolean - Una condicin o expresin que devuelve true o false.
Valor devuelto Boolean - Un resultado booleano de la operacin lgica. Vase tambin

&& AND lgico, operador
! operador NOT lgico

! expression
Invierte el valor booleano de una variable o expresin. Si expression es una variable con el valor true absoluto o convertido, el valor de !expression es false. Si la expresin x && y devuelve false, la expresin !(x && y) devuelve true. Por lo tanto, !true devuelve false y !false devuelve true. Disponibilidad Flash Lite 1.0 Operandos
expression : Boolean - Expresin o variable que da como resultado un valor booleano.
Valor devuelto Boolean - El resultado booleano de la operacin lgica. Ejemplo En el ejemplo siguiente, la variable happy se establece como false. La condicin if evala la condicin !happy y, si es true, la sentencia trace() statement enva una cadena al panel de Salida.
var happy:Boolean = false; if (!happy) { trace("don't worry, be happy"); //traces don't worry, be happy }
La sentencia realiza seguimiento porque !false es igual a true. Vase tambin

!= operador de desigualdad, !== operador de desigualdad estricta, && AND lgico, operador, || OR lgico, operador== operador de igualdad, === operador de igualdad estricta
not, operador NOT lgico

not expression
Desfasado desde Flash Player 5. Este operador est desfasado y en su lugar debe utilizarse el operador! (NOT lgico). Ejecuta una operacin NOT (!) lgica en Flash Player 4.


expression : Object - Una variable u otra expresin que se convierte en un valor booleano.
Valor devuelto Boolean - El resultado de la operacin lgica. Vase tambin

! operador NOT lgico
|| OR lgico, operador
expression1 || expression2
Evala expression1 (la expresin en la parte izquierda del operador) y devuelve true si la expresin da como resultado true. Si expression1 da como resultado false, se evala expression2 (la expresin en la parte derecha del operador). Si expression2 da como resultado false, el resultado final es false; de lo contrario, es true. Si utiliza una llamada de funcin como expression2, esa llamada no ejecutar la funcin si expression1 da como resultado true. El resultado es true si al menos una de las expresiones da como resultado true; el resultado es false slo si ambas expresiones dan como resultado false. Puede utilizar el operador OR lgico con cualquier nmero de operandos; si alguno de los operandos da como resultado true, el resultado es true. Disponibilidad Flash Lite 1.0 Operandos
expression1 : Number - Un valor booleano o una expresin que se convierta en un valor booleano. expression2 : Number - Un valor booleano o una expresin que se convierta en un valor booleano.
Valor devuelto Boolean - El resultado de la operacin lgica. Ejemplo El ejemplo siguiente utiliza el operador lgico OR (||) en una sentencia if. La segunda expresin da como resultado true, por lo que el resultado final es true:
var x:Number = 10; var y:Number = 250; var start:Boolean = false; if ((x > 25) || (y > 200) || (start)) { trace("the logical OR test passed"); // output: the logical OR test passed }
El mensaje que ha pasado la prueba de OR lgico aparece porque una de las condiciones de la sentencia if es true (y>200). Aunque las otras dos expresiones dan como resultado false, el bloque if se ejecuta porque una condicin da como resultado true.

El ejemplo siguiente demuestra cmo el uso de una llamada de funcin como expression2 puede producir resultados imprevistos. Si la expresin de la izquierda del operador da como resultado true, ese resultado se devolver sin evaluar la expresin de la derecha (no se llamar a la funcin fx2()).
function fx1():Boolean { trace("fx1 called"); return true; } function fx2():Boolean { trace("fx2 called"); return true; } if (fx1() || fx2()) { trace("IF statement entered"); } /* The following is sent to the Output panel: /* The following is sent to the log file: fx1 called IF statement entered */
Vase tambin
! operador NOT lgico, != operador de desigualdad, !== operador de desigualdad estricta, && AND lgico, operador== operador de igualdad, === operador de igualdad estricta
or, operador OR lgico

condition1 or condition2
Desfasado desde Flash Player 5. Este operador est desfasado y en su lugar debe utilizarse el operador || (OR lgico). Evala condition1 y condition2, y si alguna es true, toda la expresin es true. Disponibilidad Flash Lite 1.0 Operandos
condition1 : Boolean - Una expresin que devuelve true o false. condition2 : Boolean - Una expresin que devuelve true o false.
Valor devuelto
Boolean - El resultado de la operacin lgica.
Vase tambin
|| OR lgico, operador, | operador OR en modo bit
% operador de mdulo
expression1 % expression2
Calcula el resto de expression1 dividido por expression2. Si uno de los parmetros expression es no numrico, el operador de mdulo (%) intenta convertirlos en nmeros. La expression puede ser un nmero o una cadena que se convierte en un valor numrico.

El signo del resultado de la operacin de mdulo coincide con el signo del dividendo (el primer nmero). Por ejemplo, -4 % 3 y -4 % -3 ambos devuelven -1. Disponibilidad Flash Lite 1.0 Operandos
expression1 : Number - Nmero o expresin que da como resultado un nmero. expression2 : Number - Nmero o expresin que da como resultado un nmero.
Valor devuelto Number - El resultado de la operacin aritmtica. Ejemplo El siguiente ejemplo numrico utiliza el operador de mdulo (%):
trace(12%5); // traces 2 trace(4.3%2.1); // traces 0.0999999999999996 trace(4%4); // traces 0
El primer trace devuelve 2, en lugar de 12/5 o 2,4, porque el operador de mdulo (%) slo devuelve el resto. El segundo trace devuelve 0,0999999999999996 en lugar del previsto 0,1 debido a las limitaciones en la precisin de coma flotante del clculo binario. Vase tambin
/ operador de divisin, round (mtodo Math.round)
%= operador de asignacin de mdulo

expression1 %= expression2
Asigna a expression1 el valor de expression1 % expression2. Las dos sentencias siguientes son equivalentes:
x %= y; and x = x % y;

Valor devuelto Number - El resultado de la operacin aritmtica. Ejemplo El ejemplo siguiente asigna el valor de 4 a la variable x:
var x:Number = 14; var y:Number = 5; trace(x %= y); // output: 4

Vase tambin
% operador de mdulo
* operador de multiplicacin
expression1 * expression2
Multiplica dos expresiones numricas. Si ambas expresiones son enteros, el producto es un entero. Si una o ambas expresiones son nmeros de coma flotante, el producto es un nmero de coma flotante. Disponibilidad Flash Lite 1.0 Operandos
Valor devuelto Number - Un entero o un nmero de coma flotante. Ejemplo Sintaxis 1: La sentencia siguiente multiplica los enteros 2 y 3:
trace(2*3); // output: 6
El resultado, 6, es un entero. Sintaxis 2: Esta sentencia multiplica los nmeros de coma flotante 2,0 y 3,1416:
trace(2.0 * 3.1416); // output: 6.2832
El resultado, 6,2832, es un nmero de coma flotante.
*= operador de asignacin de multiplicacin

expression1 *= expression2
Asigna a expression1 el valor de expression1 * expression2. Por ejemplo, las dos expresiones siguientes son equivalentes:
x *= y x = x * y

Valor devuelto Number - El valor de expression1 * expression2. Si una expresin no se puede convertir en un valor numrico, devuelve NaN (no es un nmero).

Ejemplo Sintaxis 1: El ejemplo siguiente asigna el valor de 50 a la variable x:

var x:Number = 5; var y:Number = 10; trace(x *= y); // output: 50
Sintaxis 2: Las lneas segunda y tercera del ejemplo siguiente calculan las expresiones de la parte derecha del signo igual y asignan los resultados a x e y:
var i:Number = var x:Number = var y:Number = trace(x *= y); 5; 4 - 6; i + 2; // output: -14
Vase tambin
* operador de multiplicacin
new, operador
new constructor()
Crea un objeto nuevo, inicialmente annimo, y llama a la funcin identificada por el parmetro constructor. El operador new pasa a la funcin parmetros opcionales entre parntesis, as como el objeto recin creado, al que se hace referencia utilizando la palabra clave this. A continuacin, la funcin constructor puede utilizar this para establecer las variables del objeto. Disponibilidad Flash Lite 2.0 Operandos
constructor : Object - Una funcin seguida de parmetros opcionales entre parntesis. La funcin suele ser el
nombre del tipo de objeto (por ejemplo, Array, Number u Object) que se va a construir. Ejemplo El ejemplo siguiente crea la funcin Book() y, a continuacin, utiliza el operador new para crear los objetos book1 y book2.
function Book(name, price){ this.name = name; this.price = price; } book1 = new Book("Confederacy of Dunces", 19.95); book2 = new Book("The Floating Opera", 10.95);
El ejemplo siguiente utiliza el operador new para crear un objeto Array con 18 elementos:
golfCourse_array = new Array(18);
Vase tambin
Operador de acceso a matriz ([]), {} operador de inicializador de objeto

ne, operador distinto de (cadenas)

expression1 ne expression2
Desfasada desde Flash Player 5. Este operador est desfasado y en su lugar debe utilizarse el operador !operador =
(desigualdad).
Compara expression1 con expression2 y devuelve true si expression1 no es igual que expression2; de lo contrario, devuelve false . Disponibilidad Flash Lite 1.0 Operandos
Valor devuelto Boolean - Devuelve true si expression1 es distinto de expression2; en caso contrario, false. Vase tambin
{} operador de inicializador de objeto

object = { name1 : value1 , name2 : value2 ,... nameN : valueN } {expression1; [...expressionN]}
Crea un nuevo objeto y lo inicializa con los pares de propiedades especificadas name y value. Utilizar este operador equivale a utilizar la nueva sintaxis de newObject y llenar los pares de propiedades con el operador de asignacin. El prototipo del objeto recin creado se denomina de forma genrica el objeto Object. Este operador se utiliza adems para marcar bloques de cdigo contiguo asociado con sentencias de control de flujo (for, while, if, else, switch) y funciones. Disponibilidad Flash Lite 2.0 Operandos
object : Object - Objeto que se va a crear. name1,2,...N Nombres de las propiedades value1,2,...N Valores correspondientes a cada propiedad name.
Valor devuelto Object Sintaxis 1: Un objeto Object. Sintaxis 2: Ninguno, excepto cuando una funcin tiene una sentencia return explcita, en cuyo caso el tipo devuelto se especifica en la implementacin de la funcin.

Ejemplo La primera lnea del cdigo siguiente crea un objeto vaco utilizando el operador de inicializador de objeto ({}); la segunda lnea crea un objeto nuevo empleando una funcin constructora:
var object:Object = {}; var object:Object = new Object();
El siguiente ejemplo crea un objeto account e inicializa las propiedades name, address, city, state, zip y balance con los valores que acompaan:
var account:Object = {name:"Macromedia, Inc.", address:"600 Townsend Street", city:"San Francisco", state:"California", zip:"94103", balance:"1000"}; for (i in account) { trace("account." + i + " = " + account[i]); }
El ejemplo siguiente muestra cmo pueden anidarse los inicializadores de objeto y matriz uno dentro del otro.
var person:Object = {name:"Gina Vechio", children:["Ruby", "Chickie", "Puppa"]};
El ejemplo siguiente utiliza la informacin del ejemplo anterior y produce el mismo resultado utilizando las funciones constructoras:
var person:Object = new Object(); person.name = "Gina Vechio"; person.children = new Array(); person.children[0] = "Ruby"; person.children[1] = "Chickie"; person.children[2] = "Puppa";
El ejemplo ActionScript anterior tambin se puede escribir con el formato siguiente:

var person:Object = new Object(); person.name = "Gina Vechio"; person.children = new Array("Ruby", "Chickie", "Puppa");
Vase tambin
Object
() operador de parntesis
(expression1 [, expression2]) ( expression1, expression2 ) function ( parameter1,..., parameterN )
Ejecuta una operacin de agrupacin en uno o varios parmetros, lleva a cabo una evaluacin secuencial de las expresiones o rodea uno o varios parmetros y los pasa como parmetros a una funcin fuera del parntesis. Sintaxis 1: Controla el orden de ejecucin de los operadores en la expresin. Los parntesis sustituyen el orden de precedencia normal y pueden hacer que las expresiones entre parntesis se evalen primero. Cuando se anidan los parntesis, el contenido de los parntesis ms interiores se evala antes que el contenido de los ms exteriores. Sintaxis 2: Da como resultado una serie de expresiones, separadas por comas, en una secuencia y devuelve el resultado de la expresin final. Sintaxis 3: Rodea uno o varios parmetros y los pasa como parmetros a la funcin que est fuera del parntesis.


expression1 : Object - Nmeros, cadenas, variables o texto. expression2 : Object - Nmeros, cadenas, variables o texto. function : Function - Funcin que se ejecutar sobre el contenido del parntesis. parameter1...parameterN : Object - Una serie de parmetros que se ejecutar antes de que se pasen los resultados
como parmetros a la funcin que est fuera del parntesis. Ejemplo Sintaxis 1: Las sentencias siguientes muestran el uso de los parntesis para controlar el orden de ejecucin de las expresiones (el valor de cada expresin aparece en el panel Salida):
trace((2 + 3)*(4 + 5)); // displays 45 trace((2 + 3) * (4 + 5)); // writes 45 trace(2 + (3 * (4 + 5))); // displays 29 trace(2 + (3 * (4 + 5))); // writes 29 trace(2+(3*4)+5); // displays 19 trace(2 + (3 * 4) + 5); // writes19
Sintaxis 2: El ejemplo siguiente evala la funcin foo() y, a continuacin, la funcin bar(), y devuelve el resultado de la expresin a + b:
var a:Number = 1; var b:Number = 2; function foo() { a += b; } function bar() { b *= 10; } trace((foo(), bar(), a + b)); // outputs 23
Sintaxis 3: El ejemplo siguiente muestra el uso de parntesis con funciones:

var today:Date = new Date(); trace(today.getFullYear()); // traces current year function traceParameter(param):Void { trace(param); } traceParameter(2 * 2); //traces 4
Vase tambin
with, sentencia
=== operador de igualdad estricta

expression1 === expression2
Comprueba la igualdad de dos expresiones; el operador de igualdad estricta (===) hace lo mismo que el operador de igualdad (==) con la diferencia de que los tipos de datos no se convierten. El resultado es true si ambas expresiones, incluidos sus tipos de datos, son iguales. La definicin de igual depende del tipo de datos del parmetro:
Los valores numricos y booleanos se comparan por su valor y se consideran iguales si tienen el mismo valor. Las expresiones de cadena son iguales si tienen el mismo nmero de caracteres y stos son idnticos.

Las variables que representan objetos, matrices y funciones se comparan por su referencia. Dos de estas variables
son iguales si hacen referencia al mismo objeto, matriz o funcin. Dos matrices independientes nunca se consideran iguales, aunque tengan el mismo nmero de elementos. Disponibilidad Flash Lite 2.0 Operandos
Valor devuelto Boolean - El resultado booleano de la comparacin. Ejemplo Los comentarios del cdigo siguiente muestran el valor devuelto de operaciones que utilizan los operadores de igualdad y de igualdad estricta:
// Both return true because no conversion is done var string1:String = "5"; var string2:String = "5"; trace(string1 == string2); // true trace(string1 === string2); // true // Automatic data typing in this example converts 5 to "5" var string1:String = "5"; var num:Number = 5; trace(string1 == num); // true trace(string1 === num); // false // Automatic data typing in this example converts true to "1" var string1:String = "1"; var bool1:Boolean = true; trace(string1 == bool1); // true trace(string1 === bool1); // false // Automatic data typing in this example converts false to "0" var string1:String = "0"; var bool2:Boolean = false; trace(string1 == bool2); // true trace(string1 === bool2); // false
Los ejemplos siguientes muestran cmo el operador de igualdad estricta trata las variables que son referencias de forma distinta a las variables que contienen valores literales. Esta es una razn para utilizar en todo momento literales de cadena y evitar el uso del operador new con la clase String.

// Create a string variable using a literal value var str:String = "asdf"; // Create a variable that is a reference var stringRef:String = new String("asdf"); // The equality operator does not distinguish among literals, variables, // and references trace(stringRef == "asdf"); // true trace(stringRef == str); // true trace("asdf" == str); // true // The strict equality operator considers variables that are references // distinct from literals and variables trace(stringRef === "asdf"); // false trace(stringRef === str); // false
Vase tambin
! operador NOT lgico, != operador de desigualdad, !== operador de desigualdad estricta, && AND lgico, operador|| OR lgico, operador, == operador de igualdad
!== operador de desigualdad estricta

expression1 !== expression2
Prueba el contrario exacto del operador de igualdad estricta (===). El operador de desigualdad estricta realiza lo mismo que el operador de desigualdad, con la diferencia de que no se convierten los tipos de datos. Si expression1 es igual que expression2, y sus tipos de datos son iguales, el resultado es false. Como ocurre con el operador de igualdad estricta (===), la definicin de igual depende de los tipos de datos que se comparan, tal y como se muestra en la siguiente lista:
Los nmeros, cadenas y valores booleanos se comparan por su valor. Los objetos, matrices y funciones se comparan por su referencia. Una variable se compara por su valor o referencia, en funcin de su tipo.
Valor devuelto Boolean - El resultado booleano de la comparacin. Ejemplo Los comentarios del cdigo siguiente muestran el valor devuelto de operaciones que utilizan los operadores de igualdad (==), de igualdad estricta (===) y de desigualdad estricta (!==):

var s1:String = "5"; var s2:String = "5"; var s3:String = "Hello"; var n:Number = 5; var b:Boolean = true; trace(s1 == s2); // true trace(s1 == s3); // false trace(s1 == n); // true trace(s1 == b); // false trace(s1 === s2); // true trace(s1 === s3); // false trace(s1 === n); // false trace(s1 === b); // false trace(s1 !== s2); // false trace(s1 !== s3); // true trace(s1 !== n); // true trace(s1 !== b); // true
Vase tambin
! operador NOT lgico, != operador de desigualdad, && AND lgico, operador, || OR lgico, operador, == operador de igualdad, === operador de igualdad estricta
" operador de delimitador de cadena

"text"
Si se utilizan antes y despus de caracteres, las comillas (") indican que los caracteres tienen un valor literal y se consideran una cadena y no una variable ni un valor numrico ni otro elemento de ActionScript. Disponibilidad Flash Lite 1.0 Operandos
text : String - Una secuencia de cero o ms caracteres.
Ejemplo El ejemplo siguiente utiliza comillas (") para indicar que el valor de la variable yourGuess es la cadena literal "Prince Edward Island" y no el nombre de una variable. El valor de province es una variable, no un literal; para determinar el valor de province, es necesario localizar el valor de yourGuess.
var yourGuess:String = "Prince Edward Island"; submit_btn.onRelease = function() { trace(yourGuess); }; // displays Prince Edward Island in the Output panel // writes Prince Edward Island to the log file
Vase tambin String, String, funcin
- operador de resta
(Negation) -expression (Subtraction) expression1 - expression2

Se emplea para negar o restar. Sintaxis 1: Si se utiliza para negar, invierte el signo de la expression numrica. Sintaxis 2: Si se utiliza para restar, ejecuta una resta aritmtica en dos expresiones numricas, restando expression2 de expression1. Si ambas expresiones son enteros, la diferencia es un entero. Si una o ambas expresiones son nmeros de coma flotante, la diferencia es un nmero de coma flotante. Disponibilidad Flash Lite 1.0 Operandos
Valor devuelto Number - Un entero o un nmero de coma flotante. Ejemplo Sintaxis 1: La sentencia siguiente invierte el signo de la expresin 2 + 3:
trace(-(2+3)); // output: -5
Sintaxis 2: La sentencia siguiente resta el entero 2 del entero 5:

trace(5-2); // output: 3
El resultado, 3, es un entero. La sentencia siguiente resta el nmero de coma flotante 1,5 del nmero de coma flotante 3,25:
trace(3.25-1.5); // output: 1.75
El resultado, 1.75, es un nmero de coma flotante.
-= operador de asignacin de resta

expression1 -= expression2
Asigna a expression1 el valor de expression1 - expression2. Por ejemplo, las dos sentencias siguientes son equivalentes:
x -= y ; x = x - y;
Las expresiones de cadenas deben convertirse a nmeros; en caso contrario, el resultado es NaN (no es un nmero). Disponibilidad Flash Lite 1.0 Operandos
Valor devuelto Number - El resultado de la operacin aritmtica.

Ejemplo El ejemplo siguiente utiliza el operador de asignacin de resta (-=) para restar 10 de 5 y asigna el resultado a la variable x:
var x:Number = 5; var y:Number = 10; x -= y; trace(x); // output: -5
El ejemplo siguiente muestra cmo se convierten las cadenas en nmeros:

var x:String = "5"; var y:String = "10"; x -= y; trace(x); // output: -5
Vase tambin
- operador de resta
: operador de tipo
[ modifiers ] var variableName : type function functionName () : type { ... } function functionName ( parameter1:type , ... , parameterN:type ) [ :type ]{ ... }
Se utiliza en la clasificacin por tipos estricta; este operador especifica el tipo de variable, el tipo de devolucin de funcin o el tipo de parmetro de funcin. Cuando se utiliza en una asignacin o declaracin de variable, este operador especifica el tipo de la variable; cuando se utiliza en una declaracin o definicin de funcin, este operador especifica el tipo de devolucin de la funcin; cuando se utiliza con un parmetro de funcin en una definicin de funcin, este operador especifica el tipo de variable que se espera para dicho parmetro. Los tipos son una funcin slo de compilacin. Todos los tipos se comprueban durante la compilacin y se generan errores cuando hay una discordancia. Pueden producirse discordancias durante las operaciones de asignacin, llamadas a funciones y eliminacin de referencias a miembros de clase con el operador de punto (.). Para evitar errores de discordancia de tipo, utilice la clasificacin por tipos estricta. Los tipos que pueden utilizarse son todos los tipos de objetos nativos, clases e interfaces definidas por el usuario, Function y Void. Los tipos nativos reconocidos son Boolean, Number y String. Tambin se admiten como tipos nativos todas las clases incorporadas. Disponibilidad Flash Lite 2.0 Operandos
variableName : Object - Identificador para una variable. type: Tipo de datos nativo, nombre de clase que ha definido o nombre de interfaz. functionName: Identificador de una funcin. parameter: Identificador de un parmetro de funcin.
Ejemplo Sintaxis 1: El ejemplo siguiente declara una variable pblica llamada userName cuyo tipo es String y le asigna una cadena vaca:
var userName:String = "";

Sintaxis 2: El ejemplo siguiente muestra cmo especificar el tipo de parmetro de una funcin definiendo una funcin llamada randomInt() que toma un parmetro llamado integer de tipo Number:
function randomInt(integer:Number):Number { return Math.round(Math.random()*integer); } trace(randomInt(8));
Sintaxis 3: El ejemplo siguiente define una funcin llamada squareRoot() que toma un parmetro llamado val de tipo Number y devuelve la raz cuadrada de val, tambin de tipo Number:
function squareRoot(val:Number):Number { return Math.sqrt(val); } trace(squareRoot(121));
Vase tambin
set variable, sentencia, Array, funcin
typeof, operador
typeof(expression)
El operador typeof evala expression y devuelve una cadena que especifica si la expresin es un valor String, MovieClip, Object, Function, Number o Boolean. Disponibilidad Flash Lite 2.0 Operandos
expression : Object - Una cadena, clip de pelcula, botn, objeto o funcin.
Valor devuelto String - Una representacin en String del tipo de expression. La tabla siguiente muestra los resultados del operador typeof en cada tipo de expression.
Tipo de expresin String Clip de pelcula Button Campo de texto Number Boolean Object Function Resultado
string movieclip enmascaramiento enmascaramiento nmero boolean enmascaramiento function
Vase tambin

void, operador
void expression
El operador void evala una expresin y, a continuacin, descarta su valor, devolviendo undefined. El operador void se emplea a menudo en comparaciones utilizando el operador == para comprobar valores no definidos. Disponibilidad Flash Lite 2.0 Operandos
expression : Object - Expresin que se va a evaluar.
Sentencias
Las sentencias son elementos del lenguaje que realizan o especifican una accin. Por ejemplo, la sentencia return devuelve un resultado como valor de la funcin en la que se ejecuta. La sentencia if evala una condicin para determinar la siguiente accin que se debe efectuar. La sentencia switch crea una estructura ramificada para sentencias de ActionScript. Resumen de sentencias
Sentencia break Descripcin Aparece en un bucle (for, for..in, do..while o while) o en un bloque de sentencias asociadas con un determinado caso de una sentencia switch. Define una condicin de la sentencia switch. Define una clase personalizada que permite crear instancias de objetos que comparten mtodos y propiedades definidas por el usuario. Omite todas las sentencias restantes en el bucle ms interior e inicia la siguiente repeticin del bucle como si el control se hubiera pasado al final del bucle normalmente. Define el caso predeterminado de una sentencia switch. Destruye la referencia de objeto especificada por el parmetro reference y devuelve true si se elimina la referencia correctamente; de lo contrario, devuelve false. Similar al bucle while, con la diferencia de que las sentencias se ejecutan una vez antes de la evaluacin inicial de la condicin. Especifica que el objeto basado en la clase especificada puede aadir propiedades dinmicas y acceder a ellas en tiempo de ejecucin. Especifica las sentencias que se ejecutarn si la condicin en la sentencia if devuelve false. Evala una condicin y especifica las sentencias que se ejecutarn si la condicin en la sentencia if inicial devuelve false. Define una clase que es una subclase de otra clase; la ltima es la superclase. Evala la expresin init (inicializar) una vez y, a continuacin, inicia una secuencia de reproduccin indefinida.
case clase
continue
default delete
do..while
dynamic
else
else if
extends for

Sentencia for..in
Descripcin Repite las propiedades de un objeto o los elementos de una matriz y ejecuta statement para cada propiedad o elemento. Consta de un conjunto de sentencias que se definen para ejecutar una determinada tarea. Permite la obtencin implcita de propiedades asociadas con objetos basados en las clases definidas en archivos de clase externos. Evala una condicin para determinar la siguiente accin en un archivo SWF. Especifica que una clase debe definir todos los mtodos declarados en la interfaz o interfaces que se estn implementando. Permite acceder a las clases sin especificar sus nombres completos. Define una interfaz. Permite verificar en tiempo de compilacin los tipos de clases definidas anteriormente. Especifica que una variable o funcin est nicamente disponible para la clase que la declara o define, o para las subclases de dicha clase. Especifica que una variable o funcin est disponible para cualquier origen de llamada. Especifica el valor devuelto por una funcin. Permite el establecimiento implcito de propiedades asociadas con objetos basados en las clases definidas en archivos de clase externos. Asigna un valor a una variable. Especifica que una variable o funcin se cree una sola vez por cada clase, en lugar en cada objeto basado en dicha clase. Invoca la versin de superclase de un mtodo o constructor. Crea una estructura ramificada para sentencias de ActionScript. Genera o emite un error que puede controlarse o capturarse mediante un bloque de cdigo catch{}. Encierra un bloque de cdigo en el que puede producirse un error y, a continuacin, responde al error. Se utiliza para declarar variables locales o de la lnea de tiempo. Evala una condicin y, si sta da como resultado true, ejecuta una sentencia o serie de sentencias antes de volver a ejecutar el bucle para evaluar la condicin nuevamente. Permite especificar un objeto (como un clip de pelcula) con el parmetro object y evaluar expresiones y acciones en dicho objeto con el parmetro statement(s).
function
get
if implements
import interface intrinsic
private
public
return set
set variable static
super switch throw
try..catch..finally
var while
with
break, sentencia
break

Aparece en un bucle (for, for..in, do..while o while) o en un bloque de sentencias asociadas con un determinado caso de una sentencia switch. Cuando se utiliza en un bucle, la sentencia break ordena a Flash que omita el resto del cuerpo del bucle, detenga la accin de bucle y ejecute la sentencia a continuacin de la sentencia de bucle. Cuando se utiliza en una sentencia switch, la sentencia break ordena a Flash que omita el resto de sentencias existentes en ese bloque case y que salte a la primera sentencia que vaya a continuacin de la sentencia switch. En bucles anidados, la sentencia break slo omite el resto del bucle inmediato, no toda la serie de bucles anidados. Para salir de toda una serie de bucles anidados, debe usar try..catch..finally. Disponibilidad Flash Lite 1.0 Ejemplo El ejemplo siguiente utiliza la sentencia break para salir de un bucle que, de otro modo, sera infinito:
var i:Number = 0; while (true) { trace(i); if (i >= 10) { break; // this will terminate/exit the loop } i++; }
que obtiene el resultado siguiente:

0 1 2 3 4 5 6 7 8 9 10
Vase tambin
_forceframerate, propiedad
case, sentencia
case expression : statement(s)
Define una condicin de la sentencia switch. Si el parmetro expression es igual que el parmetro expression de la sentencia switch que utiliza igualdad estricta (===), Flash Player ejecutar sentencias en el parmetro statement(s) hasta que encuentre una sentencia break o el final de la sentencia switch. Si se utiliza la sentencia case fuera de una sentencia switch, se produce un error y el guin no se compila. Nota: debera finalizar siempre el parmetro statement(s) con una sentencia break. Si omite la break statement del parmetro statement(s), contina ejecutndose con la siguiente sentencia case en lugar de salir de la sentencia switch.

Disponibilidad Flash Lite 1.0 Parmetros expression:String - Cualquier expresin. Ejemplo El ejemplo siguiente define condiciones para la sentencia switchthisMonth. Si thisMonth es igual que la expresin de la sentencia case, se ejecutar la sentencia.
var thisMonth:Number = new Date().getMonth(); switch (thisMonth) { case 0 : trace("January"); break; case 1 : trace("February"); break; case 5 : case 6 : case 7 : trace("Some summer month"); break; case 8 : trace("September"); break; default : trace("some other month"); }
Vase tambin
break, sentencia
class, sentencia
[dynamic] class className [ extends superClass ] [ implements interfaceName[, interfaceName... ] ] { // class definition here}
Define una clase personalizada que permite crear instancias de objetos que comparten mtodos y propiedades definidas por el usuario. Por ejemplo, si est desarrollando un sistema de seguimiento de facturas, podra crear una clase invoice (factura) que defina todos los mtodos y propiedades que debera tener cada factura. Utilizara entonces el nuevo comando new invoice() para crear objetos invoice. El nombre de la clase debe coincidir con el nombre del archivo externo que contiene la clase. El nombre del archivo externo debe ser el nombre de la clase con la extensin de archivo .as. Por ejemplo, si se denomina a una clase Student, el archivo que defina la clase debe denominarse Student.as. Si una clase est contenida en un paquete, la declaracin de clase debe utilizar el nombre completo con el formato base.sub1.sub2.MyClass. Adems, el archivo AS de la clase debe almacenarse en la ruta de una estructura de directorios que refleje la estructura del paquete, como base/sub1/sub2/MyClass.as. Si la definicin de la clase tiene el formato "class MyClass", sta se encuentra en el paquete predeterminado y el archivo MyClass.as debera estar en el nivel superior de algn directorio de la ruta.

Por este motivo, es aconsejable planificar una estructura de directorios antes de empezar a crear clases. De otro modo, si decide mover archivos de clases despus de crearlos, deber modificar las sentencias de declaracin de clases para reflejar su nueva ubicacin. No es posible anidar definiciones de clase, es decir, no se pueden definir clases adicionales en una definicin de clase. Para indicar que los objetos pueden aadir propiedades dinmicas y acceder a ellas en tiempo de ejecucin, incluya la palabra clave dynamic antes de la sentencia class. Para declarar que una clase implemente una interfaz, utilice la palabra clave implements. Para crear subclases de una clase, utilice la palabra clave extends. (Una clase slo puede ampliar una clase pero puede implementar varias interfaces.) Puede utilizar las palabras clave implements y extends en una sola sentencia. En el siguiente ejemplo se muestran diversos usos habituales de las palabras claves implements y extends:
class C implements Interface_i, Interface_j // OK class C extends Class_d implements Interface_i, Interface_j // OK class C extends Class_d, Class_e // not OK
Disponibilidad Flash Lite 2.0 Parmetros className:String - Nombre completo de la clase. Ejemplo En el siguiente ejemplo se crea una clase llamada Plant. El constructor Plant utiliza dos parmetros.
// Filename Plant.as class Plant { // Define property names and types var leafType:String; var bloomSeason:String; // Following line is constructor // because it has the same name as the class function Plant(param_leafType:String, param_bloomSeason:String) { // Assign passed values to properties when new Plant object is created this.leafType = param_leafType; this.bloomSeason = param_bloomSeason; } // Create methods to return property values, because best practice // recommends against directly referencing a property of a class function getLeafType():String { return leafType; } function getBloomSeason():String { return bloomSeason; } }
En un archivo de guin externo o en el panel Acciones, utilice el operador new para crear un objeto Plant.
var pineTree:Plant = new Plant("Evergreen", "N/A"); // Confirm parameters were passed correctly trace(pineTree.getLeafType()); trace(pineTree.getBloomSeason());
En el siguiente ejemplo se crea una clase llamada ImageLoader. El constructor ImageLoader utiliza tres parmetros.

// Filename ImageLoader.as class ImageLoader extends MovieClip { function ImageLoader(image:String, target_mc:MovieClip, init:Object) { var listenerObject:Object = new Object(); listenerObject.onLoadInit = function(target) { for (var i in init) { target[i] = init[i]; } }; var JPEG_mcl:MovieClipLoader = new MovieClipLoader(); JPEG_mcl.addListener(listenerObject); JPEG_mcl.loadClip(image, target_mc); } }
En un archivo de guin externo o en el panel Acciones, utilice el operador new para crear un objeto ImageLoader.
var jakob_mc:MovieClip = this.createEmptyMovieClip("jakob_mc", this.getNextHighestDepth()); var jakob:ImageLoader = new ImageLoader("http://www.helpexamples.com/flash/images/image1.jpg", jakob_mc, {_x:10, _y:10, _alpha:70, _rotation:-5});
Vase tambin
dynamic, sentencia
continue, sentencia
continue
Omite todas las sentencias restantes en el bucle ms interior e inicia la siguiente repeticin del bucle como si el control se hubiera pasado al final del bucle normalmente. No tiene ningn efecto fuera de un bucle. Disponibilidad Flash Lite 1.0 Ejemplo En el siguiente bucle while, continue hace que el intrprete de Flash Lite omita el resto del cuerpo del bucle y salte al principio del bucle, donde se prueba la condicin:
trace("example 1"); var i:Number = 0; while (i < 10) { if (i % 3 == 0) { i++; continue; } trace(i); i++; }
En el siguiente bucle do..while loop, continue hace que el intrprete de Flash Lite omita el resto del cuerpo del bucle y salte al final del bucle, donde se prueba la condicin:

trace("example 2"); var i:Number = 0; do { if (i % 3 == 0) { i++; continue; } trace(i); i++; } while (i < 10);
En un bucle for, continue hace que el intrprete de Flash omita el resto del cuerpo del bucle. En el ejemplo siguiente, si el mdulo i 3 es igual a 0, se omitir la sentencia trace(i):
trace("example 3"); for (var i = 0; i < 10; i++) { if (i % 3 == 0) { continue; } trace(i); }
En el siguiente bucle for..in loop, continue hace que el intrprete de Flash omita el resto del cuerpo del bucle y salte otra vez a la parte superior del bucle, donde se procesa el siguiente valor de la numeracin:
for (i in _root) { if (i == "$version") { continue; } trace(i); }
Vase tambin
do..while, sentencia
default, sentencia
default: statements
Define el caso predeterminado de una sentencia switch. Las sentencias se ejecutan si el parmetro expression de la sentencia switch no equivale (mediante la operacin de igualdad estricta [===]) a ninguno de los parmetros expression que siguen a las palabras claves case de una determinada sentencia switch. No es necesario que la sentencia switch tenga una sentencia case default. Una sentencia case default no tiene que ser necesariamente la ltima de la lista. Si se utiliza la sentencia default fuera de una sentencia switch, se produce un error y el guin no se compila. Disponibilidad Flash Lite 2.0 Parmetros statements:String - Cualquier sentencia.

Ejemplo En el ejemplo siguiente, la expresin A no es igual a las expresiones B o D, por lo que se ejecuta la sentencia que sigue a la palabra clave default y la sentencia trace() se enva al panel Salida.
var dayOfWeek:Number = new Date().getDay(); switch (dayOfWeek) { case 1 : trace("Monday"); break; case 2 : trace("Tuesday"); break; case 3 : trace("Wednesday"); break; case 4 : trace("Thursday"); break; case 5 : trace("Friday"); break; default : trace("Weekend"); }
Vase tambin
switch, sentencia
delete, sentencia
delete reference
Destruye la referencia de objeto especificada por el parmetro reference y devuelve true si se elimina la referencia correctamente; de lo contrario, devuelve false. Este operador es til para liberar la memoria que utilizan los guiones. Puede utilizar el operador delete para eliminar referencias a objetos. Tras eliminar todas las referencias a un objeto, Flash Player se encarga de eliminar el objeto y de liberar la memoria utilizada por dicho objeto. Aunque delete es un operador, suele utilizarse como una sentencia, tal y como se muestra en el siguiente ejemplo:
delete x;
El operador delete puede no ejecutarse correctamente y devolver false si el parmetro reference no existe o no puede eliminarse. No pueden eliminarse los objetos y propiedades predefinidos, ni las variables declaradas en una funcin con la sentencia var. No se puede utilizar el operador delete para eliminar clips de pelcula. Disponibilidad Flash Lite 2.0 Valor devuelto Boolean - Valor booleano. Parmetros reference:Object - Nombre de la variable o del objeto que se va a eliminar.

Ejemplo Sintaxis 1: El ejemplo siguiente crea un objeto, lo utiliza y lo elimina cuando ya no es necesario:
var account:Object = new Object(); account.name = "Jon"; account.balance = 10000; trace(account.name); //output: Jon delete account; trace(account.name); //output: undefined
Sintaxis 2: El ejemplo siguiente elimina una propiedad de un objeto:

// create the new object "account" var account:Object = new Object(); // assign property name to the account account.name = "Jon"; // delete the property delete account.name;
Sintaxis 3: El ejemplo siguiente elimina una propiedad de un objeto:

var my_array:Array = new Array(); my_array[0] = "abc"; // my_array.length == 1 my_array[1] = "def"; // my_array.length == 2 my_array[2] = "ghi"; // my_array.length == 3 // my_array[2] is deleted, but Array.length is not changed delete my_array[2]; trace(my_array.length); // output: 3 trace(my_array); // output: abc,def,undefined
Sintaxis 4: El ejemplo siguiente muestra el comportamiento de delete en referencias de objeto:

var ref1:Object = new Object(); ref1.name = "Jody"; // copy the reference variable into a new variable // and delete ref1 ref2 = ref1; delete ref1; trace("ref1.name "+ref1.name); //output: ref1.name undefined trace("ref2.name "+ref2.name); //output: ref2.name Jody
Si no se hubiera copiado ref1 en ref2, el objeto se habra eliminado cuando se elimin ref1 porque no habra referencias a l. Si elimina ref2, no hay referencias al objeto, que se destruir y la memoria que ocupaba quedar disponible. Vase tambin
do..while, sentencia
do { statement(s) } while (condition)
Similar al bucle while, con la diferencia de que las sentencias se ejecutan una vez antes de la evaluacin inicial de la condicin. Las sentencias a continuacin slo se ejecutan si la condicin da como resultado true. Un bucle do..while garantiza que el cdigo dentro del bucle se ejecutar al menos una vez. Aunque esto tambin puede realizarse con un bucle while colocando una copia de las sentencias que se van a ejecutar antes de que se inicie el bucle while, muchos programadores creen que es ms fcil leer los bucles do..while.

Si la condicin da siempre como resultado true, el bucle do..while es infinito. Si se introduce un bucle infinito, habr problemas con Flash Player y finalmente se obtendr un mensaje de advertencia o se bloquear el reproductor. Siempre que sea posible, utilice un bucle for si sabe el nmero de veces que desea ejecutar el bucle. Aunque es fcil leer y depurar los bucles for no siempre pueden sustituir a los bucles do..while. Disponibilidad Flash Lite 1.0 Parmetros condition:Boolean - La condicin que se va a evaluar. Las statement(s) dentro del bloque de cdigo do se ejecutarn siempre que el parmetro condition sea true. Ejemplo El siguiente ejemplo utiliza el bucle do..while para evaluar si una condicin es true, y realiza un seguimiento de myVar hasta que myVar es mayor que 5. Cuando myVar es mayor que 5, el bucle termina.
var myVar:Number = 0; do { trace(myVar); myVar++; } while (myVar < 5); /* output: 0 1 2 3 4 */
Vase tambin
break, sentencia
dynamic, sentencia
dynamic class className [ extends superClass ] [ implements interfaceName[, interfaceName... ] ] { // class definition here }
Especifica que el objeto basado en la clase especificada puede aadir propiedades dinmicas y acceder a ellas en tiempo de ejecucin. La verificacin de tipos en las clases dinmicas es menos estricto que en las clases no dinmicas porque los miembros a los que se accede dentro de la definicin de clase y en las instancias de clase no se comparan con los definidos en el mbito de la clase. Sin embargo, pueden verificarse los tipos return y parameter de las funciones de miembros de clase. Este comportamiento es especialmente til cuando se trabaja con objetos MovieClip, porque hay varias formas de aadir propiedades y objetos a un clip de pelcula dinmicamente, por ejemplo, mediante MovieClip.createEmptyMovieClip() y MovieClip.createTextField(). Las subclases de clases dinmicas son tambin dinmicas. Disponibilidad Flash Lite 2.0

Ejemplo En el ejemplo siguiente, la clase Person2 an no se ha marcado como dinmica, por lo que al llamar a una funcin no declarada en ella se genera un error en tiempo de compilacin:
class Person2 { var name:String; var age:Number; function Person2(param_name:String, param_age:Number) { trace ("anything"); this.name = param_name; this.age = param_age; } }
En un archivo FLA o AS que se encuentre en el mismo directorio, aada el cdigo ActionScript siguiente al fotograma 1 de la lnea de tiempo:
// Before dynamic is added var craig:Person2 = new Person2("Craiggers", 32); for (i in craig) { trace("craig." + i + " = " + craig[i]); } /* output: craig.age = 32 craig.name = Craiggers */
Si aade una funcin no declarada, dance, se generar un error, como se muestra en el ejemplo siguiente:
trace(""); craig.dance = true; for (i in craig) { trace("craig." + i + " = " + craig[i]); } /* output: **Error** Scene=Scene 1, layer=Layer 1, frame=1:Line 14: There is no property with the name 'dance'. craig.dance = true; Total ActionScript Errors: 1 Reported Errors: 1 */
Aada la palabra clave dynamic a la clase Person2, de modo que la primera lnea aparezca de este modo:
dynamic class Person2 {
Pruebe el cdigo de nuevo. Obtendr el resultado siguiente:

craig.dance = true craig.age = 32 craig.name = Craiggers
Vase tambin
class, sentencia
else, sentencia
if (condition){ statement(s); } else { statement(s); }
Especifica las sentencias que se ejecutarn si la condicin en la sentencia if devuelve false. Las llaves ({}) que se utilizan para incluir el bloque de sentencias que se ejecutan con la sentencia else no son necesarias si slo se ejecuta una sentencia. Disponibilidad Flash Lite 1.0

Parmetros condition:Boolean - Expresin que devuelve true o false. Ejemplo En el ejemplo siguiente se utiliza la condicin else para comprobar si la variable age_txt es mayor o menor que 18:
if (age_txt.text>=18) { trace("welcome, user"); } else { trace("sorry, junior"); userObject.minor = true; userObject.accessAllowed = false; }
En el ejemplo siguiente las llaves ({}) no son necesarias porque slo una sentencia sigue a la sentencia else:
if (age_txt.text>18) { trace("welcome, user"); } else trace("sorry, junior");
Vase tambin
else if, sentencia

if (condition){ statement(s); } else if (condition){ statement(s);}
Evala una condicin y especifica las sentencias que se ejecutarn si la condicin en la sentencia if inicial devuelve false. Si la condicin else if devuelve true, el intrprete de Flash ejecuta las sentencias que hay entre llaves ({}), a continuacin de la condicin. Si la condicin else if es false, Flash omite las sentencias entre llaves y ejecuta las sentencias que hay a continuacin. Utilice la sentencia else if para crear una lgica ramificada en los guiones. Si hay varias ramas, debera pensar en la posibilidad de utilizar una sentencia switch. Disponibilidad Flash Lite 1.0 Parmetros condition:Boolean - Expresin que devuelve true o false. Ejemplo El ejemplo siguiente utiliza sentencias else if para comparar score_txt con un valor especificado:
if (score_txt.text>90) { trace("A"); } else if (score_txt.text>75) { trace("B"); } else if (score_txt.text>60) { trace("C"); } else { trace("F"); }
Vase tambin
extends, sentencia
Sintaxis 1:
class className extends otherClassName {}
Sintaxis 2:
interface interfaceName extends otherInterfaceName {}

Nota: para utilizar esta palabra clave, debe especificar ActionScript 2.0 y Flash Player 6 o posterior en la ficha Flash del cuadro de dilogo Configuracin de publicacin del archivo FLA. Esta palabra clave slo se admite cuando se utiliza en archivos de guin externos y no en los guiones escritos en el panel Acciones. Define una clase que es una subclase de otra clase; la ltima es la superclase. La subclase hereda todos los mtodos, propiedades, funciones, etc. definidos en la superclase. Las interfaces tambin pueden ampliarse con la palabra clave extends. Una interfaz que ampla otra interfaz incluye todas las declaraciones del mtodo de la interfaz original. Disponibilidad Flash Lite 2.0 Parmetros className:String - Nombre de la clase que se define. Ejemplo En el ejemplo siguiente, la clase Car ampla la clase Vehicle de modo que se hereden todos sus mtodos, propiedades y funciones. Si el guin crea una instancia de un objeto Car, podrn utilizarse los mtodos de la clase Car y de la clase Vehicle. El ejemplo siguiente muestra el contenido de un archivo llamado Vehicle.as, que define la clase Vehicle:
class Vehicle { var numDoors:Number; var color:String; function Vehicle(param_numDoors:Number, param_color:String) { this.numDoors = param_numDoors; this.color = param_color; } function start():Void { trace("[Vehicle] start"); } function stop():Void { trace("[Vehicle] stop"); } function reverse():Void { trace("[Vehicle] reverse"); } }
El ejemplo siguiente muestra un segundo archivo AS, llamado Car.as, en el mismo directorio. Esta clase ampla la clase Vehicle, modificndola de tres formas. En primer lugar, la clase Car aade una variable fullSizeSpare para realizar un seguimiento de si el objeto car tiene una rueda de repuesto a tamao completo. En segundo lugar, aade un nuevo mtodo especfico de coches, activateCarAlarm(), que activa la alarma antirrobo del coche. En tercer lugar, anula la funcin stop() para aadir el hecho de que la clase Car utiliza un sistema de frenado ABS para detenerse.

class Car extends Vehicle { var fullSizeSpare:Boolean; function Car(param_numDoors:Number, param_color:String, param_fullSizeSpare:Boolean) { this.numDoors = param_numDoors; this.color = param_color; this.fullSizeSpare = param_fullSizeSpare; } function activateCarAlarm():Void { trace("[Car] activateCarAlarm"); } function stop():Void { trace("[Car] stop with anti-lock brakes"); } }
El ejemplo siguiente crea una instancia de un objeto Car, llama a un mtodo definido en la clase Vehicle (start()), luego llama al mtodo anulado por la clase Car (stop()) y, por ltimo, llama a un mtodo de la clase Car (activateCarAlarm()):
var myNewCar:Car = new Car(2, "Red", true); myNewCar.start(); // output: [Vehicle] start myNewCar.stop(); // output: [Car] stop with anti-lock brakes myNewCar.activateCarAlarm(); // output: [Car] activateCarAlarm
Tambin se puede escribir una subclase de la clase Vehicle utilizando la palabra clave super, que puede utilizar la subclase para acceder a propiedades y mtodos de la misma. El ejemplo siguiente muestra un tercer archivo AS, llamado Truck.as, tambin en el mismo directorio. La clase Truck utiliza la palabra clave super en el constructor y tambin en la funcin reverse() anulada.
class Truck extends Vehicle { var numWheels:Number; function Truck(param_numDoors:Number, param_color:String, param_numWheels:Number) { super(param_numDoors, param_color); this.numWheels = param_numWheels; } function reverse():Void { beep(); super.reverse(); } function beep():Void { trace("[Truck] make beeping sound"); } }
El ejemplo siguiente crea una instancia del objeto Truck, llama a un mtodo anulado por la clase Truck (reverse()) y, a continuacin, llama a un mtodo definido en la clase Vehicle (stop()):
var myTruck:Truck = new Truck(2, "White", 18); myTruck.reverse(); // output: [Truck] make beeping sound [Vehicle] reverse myTruck.stop(); // output: [Vehicle] stop
Vase tambin
class, sentencia

for, sentencia
for(init; condition; next) { statement(s); }
Evala la expresin init (inicializar) una vez y, a continuacin, inicia una secuencia de reproduccin indefinida. La secuencia de reproduccin indefinida se inicia evaluando la expresin condition. Si la expresin condition resulta true, statement se ejecuta y la expresin next es la resultante. La secuencia de reproduccin indefinida se inicia nuevamente con la evaluacin de la expresin condition. Las llaves ({}) que se utilizan para incluir el bloque de sentencias que se ejecutan con la sentencia for no son necesarias si slo se ejecuta una sentencia. Disponibilidad Flash Lite 1.0 Parmetros init - Expresin que se va a evaluar antes de iniciar la secuencia de reproduccin indefinida; normalmente es una expresin de asignacin. En este parmetro tambin se permite la sentencia var. Ejemplo El ejemplo siguiente utiliza for para aadir los elementos a una matriz:
var my_array:Array = new Array(); for (var i:Number = 0; i < 10; i++) { my_array[i] = (i + 5) * 10; } trace(my_array); // output: 50,60,70,80,90,100,110,120,130,140
El ejemplo siguiente utiliza for para realizar la misma accin repetidamente. En el cdigo, el bucle for aade los nmeros de 1 a 100.
var sum:Number = 0; for (var i:Number = 1; i <= 100; i++) { sum += i; } trace(sum); // output: 5050
El ejemplo siguiente muestra que las llaves ({}) no son necesarias si slo se va a ejecutar una sentencia:
var sum:Number = 0; for (var i:Number = 1; i <= 100; i++) sum += i; trace(sum); // output: 5050
Vase tambin
++ operador de incremento
for..en la sentencia
for (variableIterant in object) { ] statement(s); }

Repite las propiedades de un objeto o los elementos de una matriz y ejecuta statement para cada propiedad o elemento. Los mtodos de un objeto no se enumeran mediante la accin for..in. Algunas propiedades no pueden enumerarse mediante la accin for..in. Por ejemplo, las propiedades de clips de pelcula, como _x e _y, no se incluyen. En archivos de clase externos, los miembros estticos no pueden enumerarse, a diferencia de los miembros de instancia. La sentencia for..in repite las propiedades de los objetos de la cadena prototipo del objeto repetido. Primero se enumeran las propiedades del objeto, luego las propiedades de su prototipo inmediato y seguidamente las propiedades del prototipo del prototipo, y as sucesivamente. La sentencia for..in no enumera el mismo nombre de propiedad dos veces. Si el objeto child tiene el prototipoparent y ambos contienen la propiedadprop, la sentencia for..in llamada en child enumera prop de child pero ignora la de parent. Las llaves{}) que se utilizan para incluir el bloque de sentencias que se ejecutan con la sentencia for..in no son necesarias si slo se ejecuta una sentencia. Si escribe un bucle for..en un archivo de clase (un archivo AS externo), los miembros de instancias no estarn disponibles para el bucle, pero s los miembros estticos. Sin embargo, si escribe un bucle for..in en un archivo FLA para una instancia de la clase, los miembros de instancias estarn disponibles, pero no los miembros estticos. Disponibilidad Flash Lite 2.0 Parmetros variableIterant:String - Nombre de una variable que actuar como repetidor, haciendo referencia a cada propiedad de un objeto o elemento de una matriz. Ejemplo En el siguiente ejemplo se utiliza for..in para repetirlo en las propiedades de un objeto:
var myObject:Object = {firstName:"Tara", age:27, city:"San Francisco"}; for (var prop in myObject) { trace("myObject."+prop+" = "+myObject[prop]); } //output myObject.firstName = Tara myObject.age = 27 myObject.city = San Francisco
En el siguiente ejemplo se utiliza for..in para repetirlo en los elementos de una matriz:
var myArray:Array = new Array("one", "two", "three"); for (var index in myArray) trace("myArray["+index+"] = " + myArray[index]); // output: myArray[2] = three myArray[1] = two myArray[0] = one
EL siguiente ejemplo utiliza el operador typeof con for..in para repetir un determinado tipo de elemento secundario:

for (var name in this) { if (typeof (this[name]) == "movieclip") { trace("I have a movie clip child named "+name); } }
Nota: si tiene varios clips de pelcula, el resultado consiste en los nombres de instancia de esos clips. En el ejemplo siguiente se enumeran los elementos secundarios de un clip de pelcula y se enva cada uno al fotograma 2 en sus lneas de tiempo respectivas. El clip de pelcula RadioButtonGroup es uno principal con varios secundarios, _RedRadioButton_, _GreenRadioButton_, y _BlueRadioButton_.
for (var name in RadioButtonGroup) { RadioButtonGroup[name].gotoAndStop(2); }
function, sentencia
Sintaxis 1: (Declara una funcin nombrada.)
function functionname([parameter0, parameter1,...parameterN]){statement(s)}
Sintaxis 2: (Declara una funcin annima y devuelve una referencia.)

function ([parameter0, parameter1,...parameterN]){ statement(s) }
Consta de un conjunto de sentencias que se definen para ejecutar una determinada tarea. Puede definir una funcin en una ubicacin e invocarla o llamarla desde distintos guiones de un archivo SWF. Cuando defina una funcin, puede adems especificar parmetros para dicha funcin. Los parmetros son marcadores de posicin de los valores sobre los que opera la funcin. Puede pasar distintos parmetros a una funcin cada vez que la llame para poder reutilizar una misma funcin en situaciones diferentes. Utilice la sentencia return en statement(s) de una funcin para que sta genere, o return, un valor. Puede utilizar esta sentencia para definir una function con los functionname, parmetros y statement(s) especificados. Cuando un guin llama a una funcin, se ejecutan las sentencias de la definicin de la funcin. Se permite la creacin de referencias hacia delante; en un mismo guin, se puede declarar una funcin despus de que ha sido llamada. Una definicin de funcin sustituye cualquier definicin anterior de la misma funcin. Puede utilizar esta sintaxis donde se permita una sentencia. Tambin puede utilizar esta sentencia para crear una funcin annima y devolverle una referencia. Esta sintaxis se utiliza en expresiones y es especialmente til para instalar mtodos en objetos. Para aadir funcionalidad, puede utilizar el objeto arguments en la definicin de la funcin. El objeto arguments suele utilizarse para crear una funcin que acepte un nmero variable de parmetros y crear una funcin annima recursiva. Disponibilidad Flash Lite 2.0 Valor devuelto String - Usage 1: El formulario de declaracin no devuelve nada. Sintaxis 2: Una referencia a la funcin annima. Parmetros functionname:String - Nombre de la funcin declarada. Ejemplo El ejemplo siguiente define la funcin sqr, que acepta un parmetro y devuelve Math.pow(x, 2) del parmetro:

function sqr(x:Number) { return Math.pow(x, 2); } var y:Number = sqr(3); trace(y); // output: 9
Si se define y utiliza la funcin en el mismo guin, la definicin de la funcin puede aparecer despus de usar la funcin:
var y:Number = sqr(3); trace(y); // output: 9 function sqr(x:Number) { return Math.pow(x, 2); }
La funcin siguiente crea un objeto LoadVars y carga params.txt en el archivo SWF. Cuando el archivo se carga correctamente, se realiza un seguimiento de variables loaded:
var myLV:LoadVars = new LoadVars(); myLV.load("params.txt"); myLV.onLoad = function(success:Boolean) { trace("variables loaded"); }
get, sentencia
function get property () { // your statements here }
Nota: para utilizar esta palabra clave, debe especificar ActionScript 2.0 y Flash Player 6 o posterior en la ficha Flash del cuadro de dilogo Configuracin de publicacin del archivo FLA. Esta palabra clave slo se admite cuando se utiliza en archivos de guin externos y no en los guiones escritos en el panel Acciones. Permite la obtencin implcita de propiedades asociadas con objetos basados en las clases definidas en archivos de clase externos. El uso de mtodos get implcitos permite acceder a propiedades de los objetos sin necesidad de acceder directamente a la propiedad. Los mtodos get/set implcitos son la abreviatura sintctica del mtodo Object.addProperty() en ActionScript 1. Disponibilidad Flash Lite 2.0 Parmetros property:String - Palabra que se utiliza para hacer referencia a la propiedad a la que accede get; este valor debe coincidir con el valor utilizado en el comando set correspondiente. Ejemplo En el ejemplo siguiente se define una clase Team. La clase Team incluye mtodos get/set que permiten recuperar y establecer propiedades dentro de la clase:

class Team { var teamName:String; var teamCode:String; var teamPlayers:Array = new Array(); function Team(param_name:String, param_code:String) { this.teamName = param_name; this.teamCode = param_code; } function get name():String { return this.teamName; } function set name(param_name:String):Void { this.teamName = param_name; } }
Introduzca el cdigo ActionScript siguiente en un fotograma de la lnea de tiempo:

var giants:Team = new Team("San Fran", "SFO"); trace(giants.name); giants.name = "San Francisco"; trace(giants.name); /* output: San Fran San Francisco */
Cuando realiza un seguimiento de giants.name, utilice el mtodo get para devolver el valor de la propiedad. Vase tambin
addProperty (mtodo Object.addProperty)
if, sentencia
if(condition) { statement(s); }
Evala una condicin para determinar la siguiente accin en un archivo SWF. Si la condicin es true, Flash ejecuta las sentencias que hay entre llaves ({}), a continuacin de la condicin. Si la condicin es false, Flash omite las sentencias entre llaves y ejecuta las sentencias que hay a continuacin. Utilice la sentencia if junto con las sentencias else y else if para crear una lgica ramificada en los guiones. Las llaves ({}) que se utilizan para incluir el bloque de sentencias que se ejecutan con la sentencia if no son necesarias si slo se ejecuta una sentencia. Disponibilidad Flash Lite 1.0 Parmetros condition:Boolean - Expresin que devuelve true o false. Ejemplo En el ejemplo siguiente, la condicin entre parntesis evala la variable name para ver si tiene el valor literal "Erica". Si lo tiene, se ejecutar la funcin play() dentro de las llaves.
if(name == "Erica"){ play(); }

El ejemplo siguiente utiliza una sentencia if para evaluar cunto tarda un usuario en hacer clic en la instancia submit_btn en un archivo SWF. Si un usuario hace clic en el botn ms de 10 segundos despus de que se reproduzca el archivo SWF, la condicin dar como resultado true y aparecer el mensaje dentro de las llaves ({}) en un campo de texto que se crea en tiempo de ejecucin (utilizando createTextField()). Si el usuario hace clic en el botn menos de 10 segundos despus de que se reproduzca el archivo SWF, la condicin dar como resultado false y aparecer otro mensaje.
this.createTextField("message_txt", this.getNextHighestDepth, 0, 0, 100, 22); message_txt.autoSize = true; var startTime:Number = getTimer(); this.submit_btn.onRelease = function() { var difference:Number = (getTimer() - startTime) / 1000; if (difference > 10) { this._parent.message_txt.text = "Not very speedy, you took "+difference+" seconds."; } else { this._parent.message_txt.text = "Very good, you hit the button in "+difference+" seconds."; } };
Vase tambin
else, sentencia
implements, sentencia
className implements interface01 [, interface02 , ...]
Nota: para utilizar esta palabra clave, debe especificar ActionScript 2.0 y Flash Player 6 o posterior en la ficha Flash del cuadro de dilogo Configuracin de publicacin del archivo FLA. Esta palabra clave slo se admite cuando se utiliza en archivos de guin externos y no en los guiones escritos en el panel Acciones. Especifica que una clase debe definir todos los mtodos declarados en la interfaz o interfaces que se estn implementando. Disponibilidad Flash Lite 2.0 Ejemplo Vase interfaz. Vase tambin
class, sentencia
import, sentencia
import className import packageName.*
Nota: para utilizar esta palabra clave, debe especificar ActionScript 2.0 y Flash Player 6 o posterior en la ficha Flash del cuadro de dilogo Configuracin de publicacin del archivo FLA. Esta sentencia es compatible con el panel Acciones, as como con archivos de clase externos.

Permite acceder a las clases sin especificar sus nombres completos. Por ejemplo, si desea utilizar una clase personalizada macr.util.users.UserClass en un guin, debe referirse a ella por su nombre completo o importarla; si la importa, puede referirse a ella por el nombre de clase:
// before importing var myUser:macr.util.users.UserClass = new macr.util.users.UserClass(); // after importing import macr.util.users.UserClass; var myUser:UserClass = new UserClass();
Si hay varios archivos de clase en el paquete (working_directory/macr/utils/users) a los que desea acceder, puede importarlos todos en una sola sentencia, tal y como se muestra en el siguiente ejemplo:
import macr.util.users.*;
Debe emitir la sentencia import antes de intentar acceder a la clase importada sin especificar su nombre completo. Si importa una clase pero no la utiliza en el guin, la clase no se exporta como parte del archivo SWF. Eso significa que puede importar paquetes grandes sin preocuparse del tamao del archivo SWF; el cdigo de bytes asociado con una clase se incluye en un archivo SWF nicamente si dicha clase se utiliza realmente. La sentencia import slo se aplica al guin actual (fotograma u objeto) en el que se llama. Por ejemplo, supongamos que importa todas las clases del paquete macr.util en el fotograma 1 de un documento de Flash. En dicho fotograma, se puede hacer referencia a las clases del paquete por sus nombres simples:
// On Frame 1 of a FLA: import macr.util.*; var myFoo:foo = new foo();
Sin embargo, en otro guin del fotograma necesitara hacer referencia a las clases del paquete por sus nombres completos (var myFoo:foo = new macr.util.foo();) o aadir una sentencia import al otro fotograma que importa las clases en dicho paquete. Disponibilidad Flash Lite 2.0 Parmetros className:String - Nombre completo de una clase definida en un archivo de clase externo.
interface, sentencia
interface InterfaceName [extends InterfaceName ] {}
Nota: para utilizar esta palabra clave, debe especificar ActionScript 2.0 y Flash Player 6 o posterior en la ficha Flash del cuadro de dilogo Configuracin de publicacin del archivo FLA. Esta palabra clave slo se admite cuando se utiliza en archivos de guin externos y no en los guiones escritos en el panel Acciones. Define una interfaz. Una interfaz es similar a una clase, pero presenta estas diferencias importantes:
Las interfaces slo contienen declaraciones de mtodos, no su implementacin. Es decir, cada clase que implemente
una interfaz debe proporcionar una implementacin para cada mtodo declarado en la interfaz.
Slo se permiten miembros pblicos en una definicin de interfaz; no se permiten miembros de instancia ni de
clase.
En las definiciones de interfaces no se permiten las sentencias get ni set.

Ejemplo El ejemplo siguiente muestra varias formas de definir e implementar interfaces:

(in top-level package .as files Ia, B, C, Ib, D, Ic, E) // filename Ia.as interface Ia { function k():Number; // method declaration only function n(x:Number):Number; // without implementation } // filename B.as class B implements Ia { function k():Number { return 25; } function n(x:Number):Number { return x + 5; } } // external script or Actions panel // script file var mvar:B = new B(); trace(mvar.k()); // 25 trace(mvar.n(7)); // 12 // filename c.as class C implements Ia { function k():Number { return 25; } } // error: class must implement all interface methods // filename Ib.as interface Ib { function o():Void; } class D implements Ia, Ib { function k():Number { return 15; } function n(x:Number):Number { return x * x; } function o():Void { trace("o"); } } // external script or Actions panel // script file mvar = new D();

trace(mvar.k()); // 15 trace(mvar.n(7)); // 49 trace(mvar.o()); // "o" interface Ic extends Ia { function p():Void; } class E implements Ib, Ic { function k():Number { return 25; } function n(x:Number):Number { return x + 5; } function o():Void { trace("o"); } function p():Void { trace("p"); } }
Vase tambin
class, sentencia
intrinsic, sentencia
intrinsic class className [extends superClass] [implements interfaceName [, interfaceName...] ] { //class definition here }
Permite verificar en tiempo de compilacin los tipos de clases definidas anteriormente. Flash utiliza declaraciones de clase intrinsic para permitir la comprobacin de tipos de clases incorporadas en tiempo de compilacin, como Array, Object y String. Esta palabra clave indica al compilador que no se requiere una implementacin de funcin y que no se debe generar ningn cdigo de bytes para ella. La palabra clave intrinsic tambin puede emplearse con declaraciones de variable y funcin. Flash utiliza esta palabra clave para permitir la verificacin de tipos en tiempo de compilacin para funciones y propiedades globales. La palabra clave intrinsic se ha creado especficamente para permitir la comprobacin de tipos en tiempo de compilacin para clases y objetos incorporados, as como variables y funciones globales. Esta palabra clave no se ha diseado para uso general, aunque puede tener cierto valor para desarrolladores que deseen permitir la verificacin de tipos en tiempo de compilacin con clases definidas anteriormente, especialmente si las clases se definen empleando ActionScript 1.0. Esta palabra clave slo se admite cuando se utiliza en archivos de guin externos y no en los guiones escritos en el panel Acciones. Disponibilidad Flash Lite 2.0

Ejemplo El ejemplo siguiente muestra cmo permitir la verificacin de archivos en tiempo de compilacin para una clase ActionScript 1.0 definida anteriormente. El cdigo generar un error de tiempo de compilacin porque la llamada myCircle.setRadius() enva un valor de cadena (String) como parmetro en lugar de un valor de nmero (Number). Puede evitar el error cambiando el parmetro por un valor de nmero (Number) (por ejemplo, cambiando "10" por 10).
// The following code must be placed in a file named Circle.as // that resides within your classpath: intrinsic class Circle { var radius:Number; function Circle(radius:Number); function getArea():Number; function getDiameter():Number; function setRadius(param_radius:Number):Number; } // This ActionScript 1.0 class definition may be placed in your FLA file. // Circle class is defined using ActionScript 1.0 function Circle(radius) { this.radius = radius; this.getArea = function(){ return Math.PI*this.radius*this.radius; }; this.getDiameter = function() { return 2*this.radius; }; this.setRadius = function(param_radius) { this.radius = param_radius; } } // ActionScript 2.0 code that uses the Circle class var myCircle:Circle = new Circle(5); trace(myCircle.getArea()); trace(myCircle.getDiameter()); myCircle.setRadius("10"); trace(myCircle.radius); trace(myCircle.getArea()); trace(myCircle.getDiameter());
Vase tambin
class, sentencia
private, sentencia
class className{ private var name; private function name() { // your statements here } }

Nota: para utilizar esta palabra clave, debe especificar ActionScript 2.0 y Flash Player 6 o posterior en la ficha Flash del cuadro de dilogo Configuracin de publicacin del archivo FLA. Esta palabra clave slo se admite cuando se utiliza en archivos de guin externos y no en los guiones escritos en el panel Acciones. Especifica que una variable o funcin est nicamente disponible para la clase que la declara o define, o para las subclases de dicha clase. De manera predeterminada, una variable o funcin est disponible para cualquier origen de llamada. Utilice esta palabra clave si desea restringir el acceso a una variable o funcin. Puede utilizar esta palabra clave nicamente en definiciones de clase, no en definiciones de interfaz. Disponibilidad Flash Lite 2.0 Parmetros name:String - Nombre de la variable o funcin que desea especificar como private (privada). Ejemplo El siguiente ejemplo muestra cmo se pueden ocultar ciertas propiedades de una clase con la palabra clave private. Cree un archivo AS nuevo llamado Login.as.
class Login { private var loginUserName:String; private var loginPassword:String; public function Login(param_username:String, param_password:String) { this.loginUserName = param_username; this.loginPassword = param_password; } public function get username():String { return this.loginUserName; } public function set username(param_username:String):Void { this.loginUserName = param_username; } public function set password(param_password:String):Void { this.loginPassword = param_password; } }
En el mismo directorio que Login.as, cree un nuevo documento FLA o AS. Introduzca el cdigo ActionScript siguiente en el fotograma 1 de la lnea de tiempo:
import Login; var gus:Login = new Login("Gus", "Smith"); trace(gus.username); // output: Gus trace(gus.password); // output: undefined trace(gus.loginPassword); // error
Dado que loginPassword es una variable private, no se puede acceder a ella desde fuera del archivo de clase Login.as. Si se intenta acceder a la variable privada, se obtendr un mensaje de error. Vase tambin
public, sentencia

public, sentencia
class className{ public var name; public function name() { // your statements here } }
Nota: para utilizar esta palabra clave, debe especificar ActionScript 2.0 y Flash Player 6 o posterior en la ficha Flash del cuadro de dilogo Configuracin de publicacin del archivo FLA. Esta palabra clave slo se admite cuando se utiliza en archivos de guin externos y no en los guiones escritos en el panel Acciones. Especifica que una variable o funcin est disponible para cualquier origen de llamada. Dado que las variables y funciones son pblicas de forma predeterminada, esta palabra clave se utiliza principalmente por motivos de estilo. Por ejemplo, se recomienda utilizarla para mantener la coherencia de un bloque de cdigo que contenga adems variables privadas o estticas. Disponibilidad Flash Lite 2.0 Parmetros name:String - Nombre de la variable o funcin que desea especificar como public. Ejemplo El ejemplo siguiente muestra cmo se pueden utilizar variables pblicas en un archivo de clase. Cree un archivo de clase nuevo llamado User.as e introduzca el cdigo siguiente:
class User { public var age:Number; public var name:String; }
A continuacin, cree un archivo FLA o AS nuevo en el mismo directorio e introduzca el cdigo ActionScript siguiente en el fotograma 1 de la lnea de tiempo:
import User; var jimmy:User = new User(); jimmy.age = 27; jimmy.name = "jimmy";
Si cambia una de las variables pblicas en la clase User por una variable privada, se generar un error al intentar acceder a la propiedad. Vase tambin
private, sentencia
return, sentencia
return[expression]
Especifica el valor devuelto por una funcin. La sentencia return evala expression y devuelve el resultado como valor de la funcin en la que se ejecuta. La sentencia return devuelve inmediatamente la ejecucin a la funcin que realiza la llamada. Si la sentencia return se utiliza sola, devuelve undefined. No es posible devolver varios valores. Si intenta hacerlo, slo se devolver el ltimo valor. En el siguiente ejemplo se devuelve c:

return a, b, c ;
Si es necesario devolver varios valores, se recomienda utilizar una matriz u objeto en su lugar. Disponibilidad Flash Lite 2.0 Valor devuelto String - El parmetro expression evaluado, si se proporciona. Parmetros expression - Cadena, nmero, valor booleano, matriz u objeto que se va a evaluar y devolver como un valor de la funcin. Este parmetro es opcional. Ejemplo El ejemplo siguiente utiliza la sentencia return dentro del cuerpo de la funcin sum() para devolver el valor sumado de los tres parmetros. La siguiente lnea de cdigo llama a sum() y asigna el valor devuelto a la variable newValue.
function sum(a:Number, b:Number, c:Number):Number { return (a + b + c); } var newValue:Number = sum(4, 32, 78); trace(newValue); // output: 114
Vase tambin
Array, funcin
set, sentencia
function set property(varName) { // your statements here }
Nota: para utilizar esta palabra clave, debe especificar ActionScript 2.0 y Flash Player 6 o posterior en la ficha Flash del cuadro de dilogo Configuracin de publicacin del archivo FLA. Esta palabra clave slo se admite cuando se utiliza en archivos de guin externos y no en los guiones escritos en el panel Acciones. Permite el establecimiento implcito de propiedades asociadas con objetos basados en las clases definidas en archivos de clase externos. El uso de mtodos set implcitos permite modificar el valor de la propiedad de un objeto sin acceder a la propiedad directamente. Los mtodos get/set implcitos son la abreviatura sintctica del mtodo Object.addProperty() en ActionScript 1. Disponibilidad Flash Lite 2.0 Parmetros property:String - Palabra que hace referencia a la propiedad a la que accede set; este valor debe coincidir con el valor utilizado en el comando get correspondiente.

Ejemplo El ejemplo siguiente crea una clase Login que demuestra cmo se puede utilizar la palabra clave set para establecer variables privadas:
class Login { private var loginUserName:String; private var loginPassword:String; public function Login(param_username:String, param_password:String) { this.loginUserName = param_username; this.loginPassword = param_password; } public function get username():String { return this.loginUserName; } public function set username(param_username:String):Void { this.loginUserName = param_username; } public function set password(param_password:String):Void { this.loginPassword = param_password; } }
En un archivo FLA o AS que se encuentre en el mismo directorio que Login.as, introduzca el cdigo ActionScript siguiente en el fotograma 1 de la lnea de tiempo:
var gus:Login = new Login("Gus", "Smith"); trace(gus.username); // output: Gus gus.username = "Rupert"; trace(gus.username); // output: Rupert
En este ejemplo, la funcin get se ejecuta cuando se realiza un seguimiento del valor. La funcin set slo se activa cuando se le pasa un valor, como se muestra en la lnea:
gus.username = "Rupert";
Vase tambin
getProperty, funcin

set("variableString",expression)
Asigna un valor a una variable. Una variable es un contenedor que almacena datos. El contenedor es siempre el mismo, pero el contenido puede cambiar. La modificacin del valor de una variable a medida que se reproduce el archivo SWF permite registrar y guardar informacin sobre las acciones del usuario, registrar valores que se modifican conforme se reproduce el archivo SWF o comprobar si una determinada condicin es true o false. Las variables pueden contener cualquier tipo de datos (por ejemplo, String, Number, Boolean, Object o MovieClip). La lnea de tiempo de cada archivo SWF y clip de pelcula tiene su propio conjunto de variables y cada variable tiene su propio valor independiente de las variables de otras lneas de tiempo. En una sentencia set no se permite el uso de "strict data typing". Si se utiliza esta sentencia para establecer una variable en un valor cuyo tipo de datos sea distinto del tipo de datos asociado con la variable en un archivo de clase, no se genera ningn error de compilador.

Una distincin sutil pero importante que hay que tener en cuenta es que el parmetro variableString es una cadena, no un nombre de variable. Si pasa a set() un nombre de variable que ya existe como primer parmetro, sin poner el nombre entre comillas (""), la variable se evala antes de que se le asigne el valor de expression. Por ejemplo, si crea una variable de cadena denominada myVariable y le asigna el valor "Tuesday" pero se olvida de ponerlo entre comillas, crear accidentalmente una nueva variable denominada Tuesday que contendr el valor que intent asignar a myVariable:
var myVariable:String = "Tuesday"; set (myVariable, "Saturday"); trace(myVariable); // outputs Tuesday trace(Tuesday); // outputs Saturday
Para evitarlo, utilice las comillas (""):

set ("myVariable", "Saturday"); trace(myVariable); //outputs Saturday
Disponibilidad Flash Lite 2.0 Parmetros variableString:String - Cadena que denomina una variable que contiene el valor del parmetro expression. Ejemplo En el ejemplo siguiente se asigna un valor a una variable. Se asigna el valor de "Jakob" a la variable name.
set("name", "Jakob"); trace(name);
El cdigo siguiente se reproduce tres veces y crea tres nuevas variables, llamadas caption0, caption1 y caption2:
for (var i = 0; i < 3; i++) { set("caption" + i, "this is caption " + i); } trace(caption0); trace(caption1); trace(caption2);
static, sentencia
class className{ static var name; static function name() { // your statements here } }
Nota: para utilizar esta palabra clave, debe especificar ActionScript 2.0 y Flash Player 6 o posterior en la ficha Flash del cuadro de dilogo Configuracin de publicacin del archivo FLA. Esta palabra clave slo se admite cuando se utiliza en archivos de guin externos y no en los guiones escritos en el panel Acciones. Especifica que una variable o funcin se cree una sola vez por cada clase, en lugar en cada objeto basado en dicha clase. Puede acceder a un miembro de clase esttico sin crear una instancia de la clase utilizando la sintaxis someClassName.name. Si crea una instancia de la clase, tambin puede acceder a un miembro esttico utilizando la instancia, pero nicamente a travs de una funcin no esttica que acceda al miembro esttico. Esta palabra clave puede utilizarse nicamente en definiciones de clases, no en definiciones de interfaces.

Disponibilidad Flash Lite 2.0 Parmetros name:String - Nombre de la variable o funcin que desea especificar como esttica. Ejemplo El ejemplo siguiente demuestra cmo se puede utilizar la palabra clave static para crear un contador que realiza un seguimiento del nmero de instancias de la clase que se han creado. Dado que la variable numInstances es esttica, se crear slo una vez para toda la clase, no para cada instancia individual. Cree un archivo nuevo llamado User.as e introduzca el cdigo siguiente:
class Users { private static var numInstances:Number = 0; function Users() { numInstances++; } static function get instances():Number { return numInstances; } }
Cree un documento FLA o AS en el mismo directorio e introduzca el cdigo ActionScript siguiente en el fotograma 1 de la lnea de tiempo:
trace(Users.instances); var user1:Users = new Users(); trace(Users.instances); var user2:Users = new Users(); trace(Users.instances);
Vase tambin
private, sentencia
super, sentencia
super.method([arg1, ..., argN]) super([arg1, ..., argN])
El primer estilo de sintaxis puede utilizarse en el cuerpo de un mtodo de objeto para invocar la versin de superclase de un mtodo y puede pasar opcionalmente parmetros arg1 ... argN) al mtodo de superclase. Esto resulta til para crear mtodos de subclase que aadan comportamientos adicionales a los mtodos de superclase y que tambin invoquen los mtodos de superclase para que ejecuten su comportamiento original. El segundo estilo de sintaxis puede utilizarse en el cuerpo de una funcin constructora para invocar la versin de superclase de la funcin constructora y, opcionalmente, puede pasarle parmetros. Esto resulta til para crear una subclase que ejecute una inicializacin adicional y que adems invoque el constructor de superclase para que inicialice la superclase. Disponibilidad Flash Lite 2.0

Valor devuelto En ambos casos se invoca una funcin. La funcin puede devolver cualquier valor. Parmetros method:Function - Mtodo que se invocar en la superclase. argN - Parmetros opcionales que se pasan a la versin de superclase del mtodo (sintaxis 1) o a la funcin constructora de la superclase (sintaxis 2).
switch, sentencia
switch (expression){caseClause: [defaultClause:] }
Crea una estructura ramificada para sentencias de ActionScript. Al igual que la sentencia if la sentencia switch prueba una condicin y ejecuta sentencias si la condicin devuelve un valor true. Todas las sentencias switch deberan incluir un caso predeterminado. El caso predeterminado debe incluir una sentencia break para evitar que por error se pase al siguiente caso si se aade posteriormente otro caso. Cuando se pasa al siguiente caso, es porque no se incluye una sentencia break. Disponibilidad Flash Lite 1.0 Parmetros expression - Cualquier expresin. Ejemplo En el siguiente ejemplo, si el parmetro String.fromCharCode(Key.getAscii()) evala a A, la sentencia trace() que sigue se ejecuta case "A"; si el parmetro evala a a, la sentencia trace() que sigue a case "a"se ejecuta; y as sucesivamente. Si ninguna expresin case coincide con el parmetro String.fromCharCode(Key.getAscii()), se ejecuta la sentencia trace() que sigue a la palabra clave default.

var listenerObj:Object = new Object(); listenerObj.onKeyDown = function() { switch (String.fromCharCode(Key.getAscii())) { case "A" : trace("you pressed A"); break; case "a" : trace("you pressed a"); break; case "E" : case "e" : trace("you pressed E or e"); break; case "I" : case "i" : trace("you pressed I or i"); break; default : trace("you pressed some other key"); break; } }; Key.addListener(listenerObj);
Vase tambin
=== operador de igualdad estricta
throw, sentencia
throw expression
Genera o emite un error que puede controlarse o capturarse mediante un bloque de cdigo catch{}. Si un bloque catch no captura una excepcin, la representacin de cadena del valor emitido se enva al panel Salida. Normalmente, se emiten instancias de la clase Error o de sus subclases (vase el apartado Ejemplo). Disponibilidad Flash Lite 2.0 Parmetros expression:Object - Expresin u objeto de ActionScript. Ejemplo En este ejemplo, una funcin llamada checkEmail() comprueba si la cadena que se le pasa es una direccin de correo electrnico con el formato adecuado. Si la cadena no contiene un smbolo @, la funcin emite un error.
function checkEmail(email:String) { if (email.indexOf("@") == -1) { throw new Error("Invalid email address"); } } checkEmail("someuser_theirdomain.com");
El cdigo siguiente llama a continuacin a la funcin checkEmail() dentro de un bloque de cdigo try. Si email_txt no contiene una direccin de correo electrnico vlida, el mensaje de error aparece en un campo de texto (error_txt).

try { checkEmail("Joe Smith"); } catch (e) { error_txt.text = e.toString(); }
En el ejemplo siguiente se emite una subclase de la clase Error. La funcin checkEmail se modifica para emitir una instancia de esa subclase.
// Define Error subclass InvalidEmailError // In InvalidEmailError.as: class InvalidEmailAddress extends Error { var message = "Invalid email address."; }
En un archivo FLA o AS, introduzca el cdigo ActionScript siguiente en el fotograma 1 de la lnea de tiempo:
import InvalidEmailAddress; function checkEmail(email:String) { if (email.indexOf("@") == -1) { throw new InvalidEmailAddress(); } } try { checkEmail("Joe Smith"); } catch (e) { this.createTextField("error_txt", this.getNextHighestDepth(), 0, 0, 100, 22); error_txt.autoSize = true; error_txt.text = e.toString(); }
Vase tambin
Error
try..catch..finally statement
try {// ... try block ... } finally { // ... finally block ... } try { // ... try block ... } catch(error [:ErrorType1]) // ... catch block ... } [catch(error[:ErrorTypeN]) { // ... catch block ... }] [finally { // ... finally block ... }]
Encierra un bloque de cdigo en el que puede producirse un error y, a continuacin, responde al error. Si alguna parte del cdigo del bloque try genera un error (mediante la sentencia throw), el control pasa al bloque catch, si existe uno y, a continuacin, al bloque de cdigo finally, si existe uno. El bloque finally se ejecuta siempre, independientemente de que se haya emitido o no un error. Si el cdigo del bloque try no emite un error (es decir, si el bloque try se completa con normalidad), el cdigo contina ejecutndose por el bloque finally. El bloque finally se ejecuta aunque el bloque try finalice con una sentencia return. Un bloque try debe ir seguido de un bloque catch, un bloque finally, o ambos. Un nico bloque try puede incluir mltiples bloques catch pero slo un bloque finally. Puede anidar los bloques try tantos niveles como desee. El parmetro error especificado en un controlador catch debe ser un identificador simple como e o theException o x. Tambin puede escribirse la variable en un controlador catch. Cuando se utilizan con varios bloques catch, los errores clasificados por tipos permiten capturar varios tipos de errores emitidos desde un solo bloque try.

Si la excepcin emitida es un objeto, el tipo coincidir si el objeto emitido es una subclase del tipo especificado. Si se emite un error de un tipo especfico, se ejecuta el bloque catch que controla el error correspondiente. Si se emite una excepcin que no es del tipo especificado, el bloque catch no se ejecuta y la excepcin se enva automticamente fuera del bloque try a un controlador catch coincidente. Si se emite un error en una funcin y sta no incluye un controlador catch, el intrprete de ActionScript abandona esta funcin y cualquier otra que realice llamadas hasta que encuentra un bloque catch. Durante este proceso, se realizan llamadas a controladores finally en todos los niveles. Disponibilidad Flash Lite 2.0 Parmetros error:Object - Expresin emitida desde una sentencia throw, normalmente una instancia de la clase Error o una de sus subclases. Ejemplo El ejemplo siguiente muestra cmo crear una sentencia try..finally. Dado que la ejecucin del cdigo del bloque finally est garantizada, suele emplearse para realizar la limpieza necesaria despus de que se ejecuta un bloque try. En el ejemplo siguiente, setInterval() llama a una funcin cada 1000 milisegundos (1 segundo). Si se produce un error, se emitir dicho error y ser recogido por el bloque catch. El bloque finally siempre se ejecuta, tanto si se produce un error como si no. Dado que se utiliza setInterval(), debe situarse clearInterval() en el bloque finally para garantizar que el intervalo se borra de la memoria.
myFunction = function () { trace("this is myFunction"); }; try { myInterval = setInterval(this, "myFunction", 1000); throw new Error("my error"); } catch (myError:Error) { trace("error caught: "+myError); } finally { clearInterval(myInterval); trace("error is cleared"); }
En el ejemplo siguiente, el bloque finally se utiliza para eliminar un objeto ActionScript, independientemente de que se haya producido un error o no. Cree un archivo AS nuevo llamado Account.as.
class Account { var balance:Number = 1000; function getAccountInfo():Number { return (Math.round(Math.random() * 10) % 2); } }
Cree un documento AS o FLA en el mismo directorio que Account.as e introduzca el cdigo ActionScript siguiente en el fotograma 1 de la lnea de tiempo:

import Account; var account:Account = new Account(); try { var returnVal = account.getAccountInfo(); if (returnVal != 0) { throw new Error("Error getting account information."); } } finally { if (account != null) { delete account; } }
El siguiente ejemplo demuestra una sentencia try..catch. Se ejecutar el cdigo que se encuentra dentro del bloque try. Si un cdigo del bloque try emite una excepcin, el control pasar al bloque try, que mostrar el mensaje de error en un campo de texto utilizando el mtodo Error.toString(). Cree un documento FLA en el mismo directorio que Account.as e introduzca el cdigo ActionScript siguiente en el fotograma 1 de la lnea de tiempo:
import Account; var account:Account = new Account(); try { var returnVal = account.getAccountInfo(); if (returnVal != 0) { throw new Error("Error getting account information."); } trace("success"); } catch (e) { this.createTextField("status_txt", this.getNextHighestDepth(), 0, 0, 100, 22); status_txt.autoSize = true; status_txt.text = e.toString(); }
El ejemplo siguiente muestra un bloque de cdigo try con mltiples bloques de cdigo catch clasificados. Segn el tipo de error que se haya producido, el bloque de cdigo try emite un tipo de objeto distinto. En este caso, myRecordSet es una instancia de una clase (hipottica) llamada RecordSet cuyo mtodo sortRows() puede emitir dos tipos de errores, RecordSetException y MalformedRecord. En el ejemplo siguiente, los objetos RecordSetException y MalformedRecord son subclases de la clase Error. Cada uno se define en su propio archivo de clase AS.
// In RecordSetException.as: class RecordSetException extends Error { var message = "Record set exception occurred."; } // In MalformedRecord.as: class MalformedRecord extends Error { var message = "Malformed record exception occurred."; }
En el mtodo sortRows() de la clase RecordSet se emite uno de los objetos de error definidos anteriormente, segn el tipo de excepcin que se haya producido. El ejemplo siguiente muestra qu aspecto puede tener este cdigo:

class RecordSet { function sortRows() { var returnVal:Number = randomNum(); if (returnVal == 1) { throw new RecordSetException(); } else if (returnVal == 2) { throw new MalformedRecord(); } } function randomNum():Number { return Math.round(Math.random() * 10) % 3; } }
Por ltimo, en otro archivo AS o guin FLA, el cdigo siguiente invoca el mtodo sortRows() en una instancia de la clase RecordSet. Define bloques catch para cada tipo de error que emite sortRows().
import RecordSet; var myRecordSet:RecordSet = new RecordSet(); try { myRecordSet.sortRows(); trace("everything is fine"); } catch (e:RecordSetException) { trace(e.toString()); } catch (e:MalformedRecord) { trace(e.toString()); }
Vase tambin
Error
var, sentencia
var variableName [= value1][...,variableNameN[=valueN]]
Se utiliza para declarar variables locales. Si declara variables dentro de una funcin, las variables son locales. Se definen para la funcin y caducan al finalizar la llamada a la funcin. En concreto, una variable definida mediante var es local en el bloque de cdigo que la contiene. Los bloques de cdigo se delimitan mediante llaves ({}). Si declara variables fuera de una funcin, las variables estarn disponibles en toda la lnea de tiempo que contiene la sentencia. No es posible declarar como variable local una variable incluida en el mbito de otro objeto.
my_array.length = 25; // ok var my_array.length = 25; // syntax error
Cuando utilice var, puede aplicar "strict data typing" a la variable. Es posible declarar mltiples variables en una sentencia, separando las declaraciones con comas (si bien esta sintaxis puede reducir la claridad del cdigo):
var first:String = "Bart", middle:String = "J.", last:String = "Bartleby";

Nota: debe utilizar adems var cuando declare propiedades en definiciones de clase en guiones externos. Los archivos de clase tambin son compatibles con los mbitos de variables pblicas, privadas y estticas. Disponibilidad Flash Lite 2.0 Parmetros variableName:String - Un identificador. Ejemplo El siguiente ActionScript crea una nueva matriz de nombres de productos. Array.push agrega un elemento al final de la matriz. Si desea utilizar "strict data typing", es fundamental que utilice la palabra clave var. Sin var delante de product_array, obtendr errores cuando intente utilizar "strict data typing".
var product_array:Array = new Array("MX 2004", "Studio", "Dreamweaver", "Flash", "ColdFusion", "Contribute", "Breeze"); product_array.push("Flex"); trace(product_array); // output: MX 2004,Studio,Dreamweaver,Flash,ColdFusion,Contribute,Breeze,Flex
while, sentencia
while(condition) { statement(s); }
Evala una condicin y, si sta da como resultado true, ejecuta una sentencia o serie de sentencias antes de volver a ejecutar el bucle para evaluar la condicin nuevamente. Cuando la condicin d como resultado false, se omitir la sentencia o serie de sentencias y finaliza el bucle. La sentencia while ejecuta la siguiente serie de pasos. Cada repeticin de pasos del 1 al 4 se denomina repeticin del bucle. Al principio de cada repeticin, se vuelve a probar la condicin condition, tal y como se muestra en los siguientes pasos:
Se evala la expresin condition. Si condition da como resultado true o un valor que se convierte en el valor booleano true, por ejemplo, un nmero
distinto de cero, vaya al paso 3. De lo contrario, se completa la sentencia while y se reanuda la ejecucin en la sentencia que hay a continuacin del bucle while.
Ejecute el bloque de sentencias statement(s). Vaya al paso 1.

La reproduccin en bucle suele utilizarse para ejecutar una accin mientras la variable de contador sea inferior al valor especificado. Al final de cada bucle se incrementa el contador hasta que se alcanza el valor especificado. En dicho punto, condition ya no es true y finaliza el bucle. Las llaves ({}) que se utilizan para incluir el bloque de sentencias que se ejecutan con la sentencia while no son necesarias si slo se ejecuta una sentencia. Disponibilidad Flash Lite 1.0 Parmetros condition:Boolean - Expresin que devuelve true o false.

Ejemplo En el ejemplo siguiente, la sentencia while se utiliza para comprobar una expresin. Cuando el valor de i es menor que 20, se realizar un seguimiento de dicho valor (i). Cuando la condicin deja de ser true, se bucle finaliza.
var i:Number = 0; while (i < 20) { trace(i); i += 3; }

0 3 6 9 12 15 18
Vase tambin
continue, sentencia
with, sentencia
with (object:Object) { statement(s); }
Permite especificar un objeto (como un clip de pelcula) con el parmetro object y evaluar expresiones y acciones en dicho objeto con el parmetro statement(s). De esta forma, no ser necesario que escribir una y otra vez el nombre del objeto o la ruta de acceso al objeto. El parmetro object se convierte en el contexto en el que se leen las propiedades, variables y funciones del parmetro statement(s). Por ejemplo, siobject es my_array y dos de las propiedades especificadas son length y concat, esas propiedades se leen automticamente como my_arraylength y my_array.concat. En otro ejemplo, si object es state.california, cualquier accin o sentencia dentro de la sentencia with se llama desde dentro de la instancia california. Para buscar el valor de un identificador en el parmetro statement(s), ActionScript empieza al principio de la cadena de mbito especificada por object y busca el identificador en cada nivel de la cadena de mbito, en un orden especfico. La cadena de mbito que utiliza la sentencia with para dirigirse a los identificadores empieza con el primer elemento de la siguiente lista y contina hasta el ltimo elemento:
El objeto especificado en el parmetro object en la sentencia El objeto especificado en el parmetro object en la sentencia
las variables locales a las que se llama en la funcin).
with ms interior. with ms exterior.
El objeto Activation. (Objeto temporal que se crea automticamente cuando se llama a una funcin que contiene El clip de pelcula que contiene el guin que se est ejecutando. El objeto Global (objetos incorporados como Math y String).
Para establecer una variable dentro de una sentencia with, debe haber declarado la variable fuera de la sentencia with o debe introducir la ruta de acceso completa a la lnea de tiempo en la que desea incluir la variable. Si establece una variable en una sentencia with sin declararla, la sentencia with buscar el valor segn la cadena de mbito. Si la variable no existe ya, se establecer el nuevo valor en la lnea de tiempo desde la que se ha llamado a la sentencia with.

En lugar de utilizar with(), puede utilizar rutas directas. Si cree que es incmodo escribir las largas rutas de acceso, puede crear una variable local y almacenar la ruta en la variable, que luego se puede reutilizar en el cdigo, tal y como ocurre en el siguiente cdigo ActionScript:
var shortcut = this._parent._parent.name_txt; shortcut.text = "Hank"; shortcut.autoSize = true;
Disponibilidad Flash Lite 2.0 Parmetros object:Object - Una instancia de un objeto o clip de pelcula de ActionScript. Ejemplo El ejemplo siguiente establece las propiedades _x e _y de la instancia someOther_mc y, a continuacin, indica a someOther_mc que pase al fotograma 3 y se detenga.
with (someOther_mc) { _x = 50; _y = 100; gotoAndStop(3); }
El fragmento de cdigo siguiente muestra cmo escribir el cdigo anterior sin utilizar una sentencia with.
someOther_mc._x = 50; someOther_mc._y = 100; someOther_mc.gotoAndStop(3);
La sentencia with resulta til para acceder a mltiples elementos de una lista de cadena de mbito simultneamente. En el ejemplo siguiente, el objeto Math incorporado se sita delante de la cadena de mbito. Establecer Math como objeto predeterminado resuelve los identificadores cos, sin, y PI a Math.cos, Math.sin, y Math.PI, respectivamente. Los identificadores a, x, y y r no son mtodos ni propiedades del objeto Math, pero dado que existen en el mbito de activacin de objetos de la funcin polar(), se resuelven en las variables locales correspondientes.
function polar(r:Number):Void { var a:Number, x:Number, y:Number; with (Math) { a = PI * pow(r, 2); x = r * cos(PI); y = r * sin(PI / 2); } trace("area = " + a); trace("x = " + x); trace("y = " + y); } polar(3);

area = 28.2743338823081 x = -3 y = 3

Comandos fscommand2
Los siguientes comandos estn disponibles para la funcin fscommand2(). Si desea obtener una descripcin de la funcin fscommand2(), consulte Funcin fscommand2 en "Funciones globales". Comandos fscommand2
Comando Descripcin
ExtendBacklightDuration Ampla la duracin de la retroiluminacin durante un periodo de tiempo especificado. FullScreen GetBatteryLevel GetDevice GetDeviceID Establece el tamao del rea de visualizacin que se utilizar para la representacin. Devuelve el nivel actual de la batera. Establece un parmetro que identifica el dispositivo en el que se ejecuta Flash Lite. Establece un parmetro que representa el identificador exclusivo del dispositivo (por ejemplo, el nmero de serie). Devuelve la cantidad de memoria heap (en kilobytes) disponible en Flash Lite. Devuelve el nivel mximo de la batera del dispositivo. Devuelve el nivel de intensidad mxima de la seal como un valor numrico. Devuelve el nivel mximo del volumen del dispositivo como un valor numrico.
GetFreePlayerMemory GetMaxBatteryLevel GetMaxSignalLevel GetMaxVolumeLevel
GetNetworkConnectionN Devuelve el nombre de la conexin de red activa o predeterminada. ame GetNetworkConnectStat us GetNetworkGeneration Devuelve un valor que indica el estado de la conexin de red activa.
Devuelve la generacin de la red inalmbrica mvil actual (por ejemplo, redes mviles 2G o de segunda generacin). Establece un parmetro para el nombre de la red actual.
GetNetworkName
GetNetworkRequestStatu Devuelve un valor que indica el estado de la solicitud HTTP ms reciente. s GetNetworkStatus Devuelve un valor que indica el estado de la red del telfono (es decir, si existe una red registrada y si el telfono se encuentra actualmente en itinerancia). Establece un parmetro que identifica la plataforma actual, que describe en trminos generales la clase del dispositivo. Devuelve un valor que indica si la fuente de alimentacin es una batera o una fuente externa. Devuelve la intensidad de seal actual como un valor numrico. Devuelve un valor que indica la ubicacin de las teclas programables en el dispositivo. Devuelve la cantidad total de memoria heap (en kilobytes) asignada a Flash Lite. Devuelve el nivel del volumen actual del dispositivo como un valor numrico. Hace que el reproductor Flash Lite detenga la reproduccin y se cierre. Restablece las teclas programables en su configuracin original. Establece el color del rectngulo de seleccin en cualquier color. Especifica el modo en que debera abrirse el campo de texto de introduccin.
GetPlatform
GetPowerSource
GetSignalLevel GetSoftKeyLocation GetTotalPlayerMemory GetVolumeLevel Quit ResetSoftKeys SetFocusRectColor SetInputTextType

Comando SetSoftKeys StartVibrate StopVibrate
Descripcin Reasigna las teclas programables de un dispositivo mvil. Inicia la funcin de vibracin del telfono. Detiene la vibracin, si sta se estaba produciendo.
Comando fscommand2 ExtendBacklightDuration

ExtendBacklightDuration
Ampla la duracin de la retroiluminacin durante un periodo de tiempo especificado. Si la duracin es mayor que cero, este comando especifica la cantidad de tiempo en segundos (con un mximo de 60 segundos) que deber mantenerse encendida la retroiluminacin. Si este periodo de tiempo transcurre sin ninguna llamada adicional a este comando, el comportamiento de la retroiluminacin volver a la duracin predeterminada. Si la duracin es igual a cero, el comportamiento de la retroiluminacin vuelve inmediatamente al comportamiento predeterminado. Nota: esta funcin depende del sistema. Por ejemplo, algunos sistemas limitan la duracin total a la que se puede prolongar la retroiluminacin. Nota: este comando no se admite en dispositivos BREW.
Comando ExtendBacklightDuration Parmetros
duration Duracin de la retroiluminacin, en segundos. Valor mximo de
Valor devuelto - 1: no se admite. 0: se ha producido un error y no ha sido posible completar la operacin. 1: correcto.
60 segundos.
Disponibilidad Flash Lite 2.0 Ejemplo En el siguiente ejemplo, la duracin de la retroiluminacin se prolonga en 45 segundos:
status = FSCommand2("ExtendBacklightDuration", 45)
Comando fscommand2 FullScreen

FullScreen
Establece el tamao del rea de visualizacin que se utilizar para la representacin. El tamao puede ser una variable definida o un valor constante de cadena, con uno de los valores siguientes: true (pantalla completa) o false (inferior a pantalla completa). Cualquier otro valor se trata como false. Nota: este comando slo se admite si Flash Lite se ejecuta en modo independiente. No se admite cuando el reproductor se inicia en el contexto de otra aplicacin (por ejemplo, un complemento de un navegador).
Comando FullScreen Parmetros size Valor devuelto - 1: no se admite. 0: se admite.

Disponibilidad Flash Lite 1.1 Ejemplo En el siguiente ejemplo se define el tamao del rea de visualizacin en pantalla completa:
status = fscommand2("FullScreen", true);
Comando fscommand2 GetBatteryLevel

GetBatteryLevel
Devuelve el nivel actual de la batera. Se trata de un valor numrico entre 0 y el mximo valor devuelto por la variable GetMaxBatteryLevel. Nota: este comando no se admite en dispositivos BREW.
Comando GetBatteryLevel Parmetros Ninguno. Valor devuelto - 1: no se admite. Otros valores numricos: nivel actual de la batera.
Disponibilidad Flash Lite 1.1 Ejemplo El ejemplo siguiente define la variable battLevel como el nivel actual de la batera:
battLevel = fscommand2("GetBatteryLevel");
Comando fscommand2 GetDevice

GetDevice
Establece un parmetro que identifica el dispositivo en el que se ejecuta Flash Lite. Este identificador suele ser el nombre del modelo.
Comando GetDevice Parmetros Valor devuelto
device Cadena que va a recibir el identificador del dispositivo. - 1: no se admite. Puede ser el nombre de una variable o un valor de cadena que 0: se admite.. contiene el nombre de una variable.
Disponibilidad Flash Lite 1.1 Ejemplo El ejemplo siguiente asigna el identificador de dispositivo a la variable device:
status = fscommand2("GetDevice", "device");
A continuacin, se incluyen algunos resultados de muestra y los dispositivos a los que hacen referencia:

D506i - Telfono Mitsubishi 506i. DFOMA1 - Telfono Mitsubishi FOMA1. F506i - Telfono Fujitsu 506i. FFOMA1 - Telfono Fujitsu FOMA1. N506i - Telfono NEC 506i. NFOMA1 - Telfono NEC FOMA1. Nokia3650 Un telfono Nokia 3650. p506i Un telfono Panasonic 506i. PFOMA1- Telfono Panasonic FOMA1. SH506i- Telfono Sharp 506i. SHFOMA1- Telfono Sharp FOMA1. SO506i- Telfono Sony 506iphone.
Comando fscommand2 GetDeviceID

GetDeviceID
Establece un parmetro que representa el identificador exclusivo del dispositivo (por ejemplo, el nmero de serie).
Comando GetDeviceID Parmetros
id Cadena para recibir el identificador exclusivo del dispositivo. Puede ser el nombre de
Valor devuelto - 1: no se admite.
una variable o un valor de cadena que contiene el nombre de 0: se admite. una variable.
Disponibilidad Flash Lite 1.1 Ejemplo El ejemplo siguiente asigna el identificador exclusivo a la variable deviceID:
status = fscommand2("GetDeviceID", "deviceID");
GetFreePlayerMemory Comando fscommand2

GetFreePlayerMemory
Devuelve la cantidad de memoria heap (en kilobytes) disponible en Flash Lite.

Comando GetFreePlayerMemory Parmetros Ninguno Valor devuelto - 1: no se admite. 0 o valor positivo: kilobytes disponibles de memoria Heap.
Disponibilidad Flash Lite 1.1 Ejemplo El siguiente ejemplo define status como la cantidad de memoria libre:
status = fscommand2("GetFreePlayerMemory");
Comando fscommand2 GetMaxBatteryLevel

GetMaxBatteryLevel
Devuelve el nivel mximo de la batera del dispositivo. Se trata de un valor numrico mayor que 0. Nota: este comando no se admite en dispositivos BREW.

Comando GetMaxBatteryLevel
Parmetros Ninguno
Valor devuelto - 1: no se admite. Otros valores: nivel mximo de la batera.
Disponibilidad Flash Lite 1.1 Ejemplo El ejemplo siguiente define la variable maxBatt como el nivel de batera mximo:
maxBatt = fscommand2("GetMaxBatteryLevel");
Comando fscommand2 GetMaxSignalLevel

GetMaxSignalLevel
Devuelve el nivel de intensidad mxima de la seal como un valor numrico. Nota: este comando no se admite en dispositivos BREW.
Comando GetMaxSignalLevel Parmetros Ninguno Valor devuelto - 1: no se admite. Otros valores numricos: nivel mximo de la seal.
Disponibilidad Flash Lite 1.1 Ejemplo El ejemplo siguiente asigna la mxima intensidad de seal a la variable sigStrengthMax:
sigStrengthMax = fscommand2("GetMaxSignalLevel");
Comando fscommand2 GetMaxVolumeLevel

GetMaxVolumeLevel
Devuelve el nivel mximo del volumen del dispositivo como un valor numrico.
Comando GetMaxVolumeLevel Parmetros Ninguno Valor devuelto - 1: no se admite. Otros valores: nivel mximo de volumen.
Disponibilidad Flash Lite 1.1 Ejemplo El ejemplo siguiente define la variable maxvolume como el nivel mximo de volumen del dispositivo:
maxvolume = fscommand2("GetMaxVolumeLevel"); trace (maxvolume); // output: 80

Comando fscommand2 GetNetworkConnectionName

GetNetworkConnectionName
Devuelve el nombre de la conexin de red activa o predeterminada. Para telfonos mviles, esta conexin tambin recibe el nombre de punto de acceso. Nota: este comando no se admite en dispositivos BREW.
Comando GetNetworkConnectionName Parmetros Ninguno Valor devuelto
- 1: no se admite. 0: correcto: devuelve el nombre de la conexin de red
activa.
1: correcto: devuelve el nombre de la conexin de red
predeterminada.
2: no se puede recuperar el nombre de la conexin.
Disponibilidad Flash Lite 2.0 Ejemplo En el siguiente ejemplo se devuelve el nombre de la conexin de red activa o predeterminada en el argumento myConnectionName:
status = FSCommand2("GetNetworkConnectionName", "myConnectionName");
Comando fscommand2 GetNetworkConnectStatus

GetNetworkConnectStatus
Devuelve un valor que indica el estado de la conexin de red activa. Nota: este comando no se admite en dispositivos BREW.
Comando GetNetworkConnectStatus Parmetros Ninguno Valor devuelto
- 1: no se admite. 0: actualmente hay una conexin de red activa. 1: el dispositivo est intentando conectarse a la
red.
2: actualmente no hay ninguna conexin de red
activa.
3: la conexin de red est suspendida. 4: no se puede determinar la conexin de red.
Disponibilidad Flash Lite 1.1 Ejemplo El ejemplo siguiente asigna el estado de conexin de red a la variable connectstatus y, a continuacin, utiliza una sentencia switch para actualizar el estado de conexin en un campo de texto:

connectstatus = FSCommand2("GetNetworkConnectStatus"); switch (connectstatus) { case -1 : _root.myText += "connectstatus not supported" + "\n"; break; case 0 : _root.myText += "connectstatus shows active connection" + "\n"; break; case 1 : _root.myText += "connectstatus shows attempting connection" + "\n"; break; case 2 : _root.myText += "connectstatus shows no connection" + "\n"; break; case 3 : _root.myText += "connectstatus shows suspended connection" + "\n"; break; case 4 : _root.myText += "connectstatus shows indeterminable state" + "\n"; break; }
Comando fscommand2 GetNetworkGeneration

GetNetworkGeneration
Devuelve la generacin de la red inalmbrica mvil actual (por ejemplo, redes mviles 2G o de segunda generacin).
Comando GetNetworkGeneration Parmetros Ninguno Valor devuelto
- 1: no se admite 0: generacin de red inalmbrica mvil
desconocida
1: 2G 2: 2.5G 3: 3G
Disponibilidad Flash Lite 2.0 Ejemplo En el siguiente ejemplo se muestra la sintaxis para devolver la generacin de la red:
status = fscommand2("GetNetworkGeneration");
Comando fscommand2 GetNetworkName

GetNetworkName
Establece un parmetro para el nombre de la red actual. Nota: este comando no se admite en dispositivos BREW.

Comando GetNetworkName
Parmetros
networkName Cadena que representa el nombre de la red. Puede ser el
Valor devuelto - 1: no se admite.
nombre de una variable o un valor de cadena 0: no hay ninguna red registrada. que contiene el nombre de una variable. 1: la red est registrada, pero se Si la red est registrada y se puede determinar ignora su nombre. su nombre, networkname se establece en el 2: la red est registrada y se conoce nombre de la red; de lo contrario, se establece su nombre. en una cadena vaca.
Disponibilidad Flash Lite 1.1 Ejemplo El ejemplo siguiente asigna el nombre de la red actual al parmetro myNetName y un valor de estado a la variable netNameStatus:
netNameStatus = fscommand2("GetNetworkName", myNetName);
Comando fscommand2 GetNetworkRequestStatus

GetNetworkRequestStatus
Devuelve un valor que indica el estado de la solicitud HTTP ms reciente. Nota: este comando no se admite en dispositivos BREW.
Comando GetNetworkRequestStatus Parmetros Ninguno Valor devuelto
-1: no se admite el comando. 0: existe una solicitud pendiente, se ha establecido una
conexin de red, el nombre del host del servidor se ha resuelto y se ha realizado una conexin con el servidor.
1: existe una solicitud pendiente y se est
estableciendo una conexin de red.

2: existe una solicitud pendiente pero an no se ha
establecido una conexin de red.

3: existe una solicitud pendiente, se ha establecido una
conexin de red y el nombre del host del servidor se est resolviendo.

4: la solicitud ha fallado debido a un error de red. 5: la solicitud ha fallado debido a un fallo de conexin
con el servidor.
6: el servidor ha devuelto un error HTTP (por ejemplo,
404).
7: la solicitud ha fallado debido a un fallo al acceder al
servidor DNS o al resolver el nombre del servidor.

8: la solicitud se ha realizado correctamente. 9: la solicitud ha fallado porque se agot el tiempo de espera. 10: la solicitud no se ha realizado todava.

Disponibilidad Flash Lite 1.1 Ejemplo El ejemplo siguiente asigna el estado de la ltima solicitud HTTP a la variable requeststatus y, a continuacin, utiliza una sentencia switch para actualizar el estado en un campo de texto:
requeststatus = fscommand2("GetNetworkRequestStatus"); switch (requeststatus) { case -1: _root.myText += "requeststatus not supported" + "\n"; break; case 0: _root.myText += "connection to server has been made" + "\n"; break; case 1: _root.myText += "connection is being established" + "\n"; break; case 2: _root.myText += "pending request, contacting network" + "\n"; break; case 3: _root.myText += "pending request, resolving domain" + "\n"; break; case 4: _root.myText += "failed, network error" + "\n"; break; case 5: _root.myText += "failed, couldn't reach server" + "\n"; break; case 6: _root.myText += "HTTP error" + "\n"; break; case 7: _root.myText += "DNS failure" + "\n"; break; case 8: _root.myText += "request has been fulfilled" + "\n"; break; case 9: _root.myText += "request timedout" + "\n"; break; case 10: _root.myText += "no HTTP request has been made" + "\n"; break; }
Comando fscommand2 GetNetworkStatus

GetNetworkStatus
Devuelve un valor que indica el estado de la red del telfono (es decir, si existe una red registrada y si el telfono se encuentra actualmente en itinerancia).

Comando GetNetworkStatus
Parmetros Ninguno
Valor devuelto
-1: no se admite el comando. 0: ninguna red registrada. 1: en red original. 2: en red original ampliada. 3: itinerancia (lejos de la red principal).
Disponibilidad Flash Lite 1.1 Ejemplo El ejemplo siguiente asigna el estado de conexin de red a la variable networkstatus y, a continuacin, utiliza una sentencia switch para actualizar el estado en un campo de texto:
networkstatus = fscommand2("GetNetworkStatus"); switch(networkstatus) { case -1: _root.myText += "network status not supported" + "\n"; break; case 0: _root.myText += "no network registered" + "\n"; break; case 1: _root.myText += "on home network" + "\n"; break; case 2: _root.myText += "on extended home network" + "\n"; break; case 3: _root.myText += "roaming" + "\n"; break; }
Comando fscommand2 GetPlatform

GetPlatform
Establece un parmetro que identifica la plataforma actual, que describe en trminos generales la clase del dispositivo. Para dispositivos con sistemas operativos abiertos, este identificador suele coincidir con el nombre y la versin del sistema operativo.
Comando GetPlatform Parmetros
platform Cadena que va a recibir el identificador de la plataforma.
Valor devuelto
- 1: no se admite. 0: se admite.
Disponibilidad Flash Lite 1.1 Ejemplo En el siguiente ejemplo se define el parmetro platform en el identificador para la plataforma actual:

status = fscommand2("GetPlatform", "platform");
En los ejemplos siguientes se muestran algunos resultados de muestra para platform:

506i - Telfono 506i. FOMA1 - Telfono FOMA1. Symbian6.1_s60.1 - Telfono Symbian 6.1, Series 60 versin 1. Symbian7.0 - Telfono Symbian 7.0.
Comando fscommand2 GetPowerSource

GetPowerSource
Devuelve un valor que indica si la fuente de alimentacin es una batera o una fuente externa. Nota: este comando no se admite en dispositivos BREW.
Comando GetPowerSource Parmetros Ninguno Valor devuelto
- 1: no se admite. 0: el dispositivo funciona gracias a una batera. 1: el dispositivo funciona gracias a una fuente de
alimentacin externa.
Disponibilidad Flash Lite 1.1 Ejemplo El ejemplo siguiente define la variable myPower para que indique la fuente de alimentacin o -1 si no puede hacerlo.
myPower = fscommand2("GetPowerSource");
Comando fscommand2 GetSignalLevel

GetSignalLevel
Devuelve la intensidad de seal actual como un valor numrico. Nota: este comando no se admite en dispositivos BREW.
Comando GetSignalLevel Parmetros Ninguno Valor devuelto
- 1: no se admite.
Otros valores numricos: El nivel de seal actual, desde 0 al valor mximo que devuelve GetMaxSignalLevel.
Disponibilidad Flash Lite 1.1 Ejemplo El ejemplo siguiente asigna el valor de nivel de seal a la variable sigLevel:
sigLevel = fscommand2("GetSignalLevel");

Comando fscommand2 GetSoftKeyLocation

GetSoftKeyLocation
Devuelve un valor que indica la ubicacin de las teclas programables en el dispositivo.

Comando GetSoftKeyLocation Parmetros Ninguno Valor devuelto - 1: no se admite. 0: teclas programables arriba. 1: teclas programables a la izquierda. 2: teclas programables abajo. 3: teclas programables a la derecha.
Disponibilidad Flash Lite 2.0 Ejemplo El siguiente ejemplo establece la variable status para indicar la ubicacin de las teclas programables o en -1 si las teclas programables no son compatibles con el dispositivo:
status = fscommand2("GetSoftKeyLocation");
Comando fscommand2 GetTotalPlayerMemory

GetTotalPlayerMemory
Devuelve la cantidad total de memoria heap (en kilobytes) asignada a Flash Lite.
Comando GetTotalPlayerMemory Parmetros Ninguno Valor devuelto
- 1: no se admite. 0 o valor positivo: kilobytes totales de memoria
Heap.
Disponibilidad Flash Lite 1.1 Ejemplo El ejemplo siguiente define la variable status como la cantidad total de memoria de pila:
status = fscommand2("GetTotalPlayerMemory");
Comando fscommand2 GetVolumeLevel

GetVolumeLevel
Devuelve el nivel del volumen actual del dispositivo como un valor numrico.

Comando GetVolumeLevel
Parmetros Ninguno
Valor devuelto
- 1: no se admite.
Otros valores numricos: el volumen actual, desde 0 al valor que devuelve fscommand2("GetMaxVolumeLevel").
Disponibilidad Flash Lite 1.1 Ejemplo El ejemplo siguiente asigna el nivel actual del volumen a la variable volume:
volume = fscommand2("GetVolumeLevel"); trace (volume); // output: 50
Comando fscommand2 Quit

Quit
Hace que el reproductor Flash Lite detenga la reproduccin y se cierre. Este comando slo se admite si Flash Lite se ejecuta en modo independiente. No se admite cuando el reproductor se inicia en el contexto de otra aplicacin (por ejemplo, un complemento de un navegador).
Comando Quit Parmetros Ninguno Valor devuelto
- 1: no se admite.
Disponibilidad Flash Lite 1.1 Ejemplo El siguiente ejemplo hace que Flash Lite detenga la reproduccin y se cierre si se ejecuta en modo independiente:
status = fscommand2("Quit");
Comando fscommand2 ResetSoftKeys

ResetSoftKeys
Restablece las teclas programables en su configuracin original. Este comando slo se admite si Flash Lite se ejecuta en modo independiente. No se admite cuando el reproductor se inicia en el contexto de otra aplicacin (por ejemplo, un complemento de un navegador).
Comando ResetSoftKeys Parmetros Ninguno Valor devuelto
- 1: no se admite.

Ejemplo La siguiente sentencia restablece las teclas programables en su configuracin original:

status = fscommand2("ResetSoftKeys");
Comando fscommand2 SetFocusRectColor

SetFocusRectColor
Establece el color del rectngulo de seleccin en cualquier color. El rango de valores admitidos para rojo, verde y azul es 0-255. En Flash, no se puede cambiar el color predeterminado del rectngulo de seleccin, que es amarillo.
Comando SetFocusRectColor Parmetros Ninguno Valor devuelto
- 1: no se admite. 0: no se puede determinar. 1: correcto.
Disponibilidad Flash Lite 2.0 Ejemplo La siguiente sentencia restablece el color del rectngulo de seleccin:
status = fscommand2("SetFocusRectColor, <red>, <green>, <blue>);
Comando fscommand2 SetInputTextType

SetInputTextType
Especifica el modo en que debera abrirse el campo de texto de introduccin. Flash Lite admite la funcin de introduccin de texto solicitando a la aplicacin host que inicie la interfaz de introduccin de texto especfica del dispositivo genrico, con frecuencia denominada procesador principal (FEP). Si no se utiliza el comando SetInputTextType, el FEP se abre en modo predeterminado.
Comando SetInputTextType Parmetros
variableName Nombre del campo de introduccin de texto. Puede ser el nombre de una variable o un valor
Valor devuelto
0: fallido. 1: correcto.
de cadena que contiene el nombre de una variable. Nota: el nombre de la variable del campo de texto no es el mismo que el de la instancia. Puede especificar el nombre de variable de un campo de texto en el cuadro de texto Var del inspector de propiedades, o bien mediante ActionScript. Por ejemplo, el siguiente cdigo restringe la introduccin a caracteres numricos para la instancia del campo de texto (numTxt) cuyo nombre de variable asociado es "numTxt_var".
var numTxt:TextField;numTxt.variable = "numTxt_var";fscommand2("SetInputTextType", "numTxt_var", "Numeric"); type Uno de los valores Numeric, Alpha, Alphanumeric, Latin, NonLatin, o NoRestriction.

En la siguiente tabla se muestra el efecto que tiene cada modo y qu modos se sustituyen:
Modo InputTextType Establece el FEP en uno de estos modos que se excluyen entre s Slo nmeros (0-9) Slo caracteres alfabticos (A-Z o a-z) Slo caracteres alfanumricos (0-9, AZ o a-z) Slo caracteres latinos (alfanumricos y signos de puntuacin) Slo caracteres no latinos (por ejemplo, kanji y kana) Modo predeterminado (no establece restriccin alguna en el FEP) Si no se admite en el dispositivo actual, abre el FEP en este modo Alphanumeric Alphanumeric Latin
Numeric Alfa Alphanumeric
Latin
NoRestriction
NonLatin
NoRestriction
NoRestriction
N/D
NOTA: no todos los telfonos mviles admiten estos tipos de campos de introduccin de texto. Por este motivo, se deben validar los datos de texto introducidos.
Disponibilidad Flash Lite 1.1 Ejemplo La siguiente lnea de cdigo establece el tipo de texto del campo asociado con la variable input1 de modo que se reciban datos numricos:
status = fscommand2("SetInputTextType", "input1", "Numeric");
Comando fscommand2 SetSoftKeys

SetSoftKeys
Reasigna las teclas programables de un dispositivo mvil. Cuando el usuario pulsa una tecla programable, se ejecuta cualquier cdigo de ActionScript asociado al evento de la tecla programable. El reproductor Flash ejecuta esta funcin de forma inmediata cuando se invoca. Este comando slo se admite si Flash Lite se ejecuta en modo independiente. No se admite cuando el reproductor se inicia en el contexto de otra aplicacin (por ejemplo, un complemento de un navegador). Para conseguir compatibilidad retroactiva con Flash Lite 1.1, la tecla programable SOFT1 siempre se asigna a la tecla izquierda del telfono y la tecla programable SOFT2 siempre se asigna a la tecla derecha. Para la tecla programable SOFT3 y superiores, la ubicacin depende de cada telfono. Los argumentos para este comando especifican el texto que se mostrar en cada tecla programable. Cuando se ejecuta el comando SetSoftKeys, al pulsar la tecla izquierda se genera un evento de pulsacin de tecla SOFT1 y, al pulsar la tecla derecha, se genera un evento de pulsacin de tecla SOFT2. Al pulsar las teclas programables SOFT3 a SOFT12 se generan sus respectivos eventos. Nota: la reasignacin de teclas programables depende de cada dispositivo mvil. Pngase en contacto con el fabricante del dispositivo para verificar si se admite la reasignacin de las teclas programables.

Comando SetSoftKeys
Parmetros
soft1 Texto que se ver para la tecla programable SOFT1. soft2 Texto que se ver para la tecla programable SOFT2.
Valor devuelto - 1: no se admite. 0: se admite.
Estos parmetros o bien son nombres de variables o valores de cadenas constantes (por ejemplo, "Previous").
Disponibilidad Flash Lite 1.1 Ejemplo En el siguiente ejemplo se etiquetan las teclas programables SOFT1 ("Anterior") y SOFT2 ("Siguiente"):
status = fscommand2("SetSoftKeys", "Previous", "Next");
Se pueden definir variables o utilizar valores de cadenas constantes para cada tecla programable:
status = fscommand2("SetSoftKeys", soft1, soft2, [soft3], [soft4], ..., [softn])
Nota: se puede definir una tecla programable sin necesidad de definir el resto. Los ejemplos siguientes muestran la sintaxis y el comportamiento que implica definir una tecla programable concreta sin que esto afecte al resto de las teclas:
Para establecer la etiqueta de la tecla programable izquierda en "soft1" y dejar la derecha vaca:
status = fscommand2("SetSoftKeys", "soft1", "")
Para dejar la etiqueta de la tecla programable izquierda tal como est y establecer la derecha en "soft2":
status = fscommand2("SetSoftKeys", undefined, "soft2")
Para dejar la etiqueta de la tecla programable izquierda tal como est y establecer la derecha en "soft2":
status = fscommand2("SetSoftKeys", null, "soft2")
Para establecer la etiqueta de la tecla programable izquierda en "soft1" y dejar la derecha tal como est:
status = fscommand2("SetSoftKeys", "soft1")
Comando fscommand2 StartVibrate

StartVibrate
Inicia la funcin de vibracin del telfono. Si ya est activada la vibracin, Flash Lite la detiene antes de iniciar una nueva. Las vibraciones tambin se detienen cuando se detiene (total o temporalmente) la aplicacin Flash, as como cuando se cierra el reproductor Flash Lite.

Comando StartVibrate
Parmetros
time_on Cantidad de tiempo, en milisegundos (hasta un mximo de 5 segundos) que est activada la vibracin. time_off Cantidad de tiempo, en milisegundos (hasta un mximo de 5 segundos) que est desactivada la vibracin. repeat Nmero de veces (hasta un mximo de 3) que se va a repetir esta vibracin.
Valor devuelto
- 1: no se admite. 0: la vibracin se ha iniciado. 1: se ha producido un error y no ha
sido posible iniciar la vibracin.
Disponibilidad Flash Lite 1.1 Ejemplo El siguiente ejemplo intenta iniciar una secuencia de vibracin de 2,5 segundos de activacin y 1 segundo de desactivacin, repetido dos veces. Asigna un valor a la variable status que indica que si se ha realizado correctamente o si se ha producido un error:
fscommand2("StartVibrate", 2500, 1000, 2);
Comando fscommand2 StopVibrate

StopVibrate
Detiene la vibracin, si sta se estaba produciendo.

Comando StopVibrate Parmetros Ninguno Valor devuelto
- 1: no se admite. 0: la vibracin se ha detenido.
Disponibilidad Flash Lite 1.1 Ejemplo El siguiente ejemplo llama a StopVibrate y guarda el resultado (no admitido o vibracin detenida) en la variable status:
status = fscommand2("StopVibrate");
181
Captulo 2: Clases de ActionScript

La documentacin de las clases de ActionScript incluye la sintaxis, la informacin de uso y los ejemplos de cdigo de los mtodos, las propiedades y los eventos que pertenecen a cada una de las clases. Las clases se muestran alfabticamente. Si no est seguro de la clase a la que pertenece un mtodo, una propiedad o un evento, busque en el ndice.
arguments
Object | +-arguments public class arguments extends Object
Un objeto arguments se utiliza para almacenar y acceder a argumentos de funcin. Desde dentro del cuerpo de funcin se puede acceder a l con la variable arguments local. Los argumentos se almacenan como elementos de matriz, al primero se accede como arguments[0], al segundo como
arguments[1], etc. La propiedad arguments.length indica el nmero de argumentos que se pasan a la funcin.
Observe que puede haber diferencia entre el nmero de argumentos que se pasan y los que declara la funcin. Disponibilidad Flash Lite 2.0 Vase tambin
Function
Resumen de propiedades
Modificadores Propiedad callee:Object caller:Object Descripcin Referencia a la funcin que se est ejecutando. Una referencia a la funcin que llam a la funcin que se est ejecutando o null si no se llam desde otra funcin. El nmero de argumentos que se pasan a la funcin.
length:Number
Propiedades heredadas de la clase Object

constructor (propiedad Object.constructor), __proto__ (Object.__proto__, propiedad)prototype (propiedad Object.prototype), __resolve (Object.__resolve, propiedad)
Resumen de mtodos Mtodos heredados de la clase Object

Clases de ActionScript
addProperty (mtodo Object.addProperty), hasOwnProperty (mtodo Object.hasOwnProperty)isPropertyEnumerable (mtodo Object.isPropertyEnumerable)isPrototypeOf (mtodo Object.isPrototypeOf)registerClass (mtodo Object.registerClass), toString (mtodo Object.toString)unwatch (mtodo Object.unwatch), valueOf (mtodo Object.valueOf)watch (mtodo Object.watch)
callee (propiedad arguments.callee)

public callee : Object
Referencia a la funcin que se est ejecutando. Disponibilidad Flash Lite 2.0 Vase tambin
caller (propiedad arguments.caller)
caller (propiedad arguments.caller)

public caller : Object
Una referencia a la funcin que llam a la funcin que se est ejecutando o null si no se llam desde otra funcin. Disponibilidad Flash Lite 2.0 Vase tambin
callee (propiedad arguments.callee)
length (propiedad arguments.length)

public length : Number
El nmero de argumentos que se pasan a la funcin. Puede ser mayor o menor que el que declara la funcin. Disponibilidad Flash Lite 2.0
Array
Object | +-Array public dynamic class Array extends Object

La clase Array le permite obtener acceso a matrices indexadas y manipularlas. Una matriz indexada es un objeto cuyas propiedades se identifican mediante un nmero que representa su posicin en la matriz. Este nmero se conoce como ndice. Todas las matrices indexadas estn basadas en cero, lo que significa que el primer elemento de la matriz es [0], el segundo elemento, [1], y as sucesivamente. Para crear un objeto Array, deber utilizar el constructor newArray(). Para obtener acceso a elementos de una matriz, utilice el operador de acceso a matriz ([]). Puede almacenar una amplia variedad de tipos de datos en un elemento de matriz, incluidos nmeros, cadenas, objetos e incluso otras matrices. Puede crear una matriz multidimensional creando una matriz indexada y asignando a cada uno de sus elementos una matriz indexada distinta. Una matriz de este tipo se considera multidimensional porque puede emplearse para representar datos en una tabla. La asignacin de matriz se hace por referencia en lugar de por valor: cuando se asigna una variable de matriz a otra variable de matriz, ambas hacen referencia a la misma matriz:
var oneArray:Array = new Array("a", "b", "c"); var twoArray:Array = oneArray; // Both array variables refer to the same array. twoArray[0] = "z"; trace(oneArray); // Output: z,b,c.
No se debe utilizar la clase Array para crear matriz asociativas, que son estructuras de datos distintas que contienen elementos con nombre en lugar de elementos numerados. Deber emplear el objeto Object para crear matrices asociativas (tambin llamadas hashes). Si bien ActionScript permite crear matrices asociativas empleando la clase Array, no es posible utilizar ninguno de los mtodos o las propiedades de la clase Array. En el fondo, una matriz asociativa es una instancia de la clase Object y cada par clave-valor se representa mediante una propiedad y su valor. Otra razn para declarar una matriz asociativa como tipo Object es que permite utilizar un literal de objeto para llenar la matriz asociativa (pero slo en el momento en que se declara). El ejemplo siguiente crea una matriz asociativa utilizando un literal de objeto, accede a los elementos empleando el operador de punto y el operador de acceso a matriz y, a continuacin, aade un nuevo par clave-valor creando una propiedad nueva:
var myAssocArray:Object = {fname:"John", lname:"Public"}; trace(myAssocArray.fname); // Output: John trace(myAssocArray["lname"]); // Output: Public myAssocArray.initial = "Q"; trace(myAssocArray.initial); // Output: Q
Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente, my_array contiene cuatro meses del ao:
var my_array:Array = new Array(); my_array[0] = "January"; my_array[1] = "February"; my_array[2] = "March"; my_array[3] = "April";

Modificadores
static
Propiedad CASEINSENSITIVE:Numbe r DESCENDING:Number length:Number
Descripcin Representa una ordenacin sin distincin entre maysculas y minsculas. Representa una ordenacin en orden descendente. Un entero no negativo que especifica el nmero de elementos de la matriz. Representa una ordenacin numrica en lugar de una ordenacin basada en cadenas. Representa la opcin para devolver una matriz indexada como resultado de llamar al mtodo sort() o sortOn(). Representa el requisito de ordenacin exclusiva.
static
static
NUMERIC:Number
static
RETURNINDEXEDARRAY: Number UNIQUESORT:Number
static

Resumen de constructores
Firma Descripcin
Array([valor:Object]) Permite crear una matriz.
Resumen de mtodos
Modificadores Firma concat([valor:Object] ) : Array join([delimiter:String ]) : String Descripcin Concatena los elementos especificados en los parmetros con los elementos de una matriz y crea una matriz nueva. Convierte los elementos de una matriz en cadenas, inserta el separador especificado entre los elementos, los concatena y devuelve la cadena resultante. Elimina el ltimo elemento de una matriz y devuelve el valor de dicho elemento. Aade uno o varios elementos al final de una matriz y devuelve la nueva longitud de la matriz. Invierte la matriz en su sitio. Elimina el primer elemento de una matriz y devuelve dicho elemento. Devuelve una matriz nueva que consta de un rango de elementos de la matriz original, sin modificar la matriz original.
pop() : Object
push(valor:Object) : Number reverse() : Void shift() : Object
slice([startIndex:Nu mber], [endIndex:Number]) : Array sort([compareFunctio n:Object], [opciones:Number]) : Array
Ordena los elementos de una matriz.

Modificadores
Firma
Descripcin
sortOn(fieldName:Obje Ordena los elementos de una matriz por uno o varios campos ct, de la matriz. [opciones:Object]) : Array splice(startIndex:Nu mber, [deleteCount:Number ], [valor:Object]) : Array toString() : String Aade y elimina elementos de una matriz.
Devuelve un valor de cadena que representa los elementos del objeto Array especificado. Aade uno o varios elementos al comienzo de una matriz y devuelve la nueva longitud de la matriz.
unshift(valor:Object) : Number
Mtodos heredados de la clase Object

Constructor Array
public Array([value:Object])
Permite crear una matriz. Puede utilizar el constructor para crear diferentes tipos de matrices: una matriz vaca, una matriz con una longitud especfica pero cuyos elementos tengan valores no definidos o una matriz cuyos elementos tengan valores especficos. Sintaxis 1: Si no especifica ningn parmetro, se crear una matriz con una longitud de 0. Sintaxis 2: Si especifica slo una longitud, se crear una matriz con el nmero de elementos length. El valor de cada elemento se establece como undefined. Sintaxis 3: Si utiliza los parmetros element para especificar los valores, se crear una matriz con valores especficos. Disponibilidad Flash Lite 2.0 Parmetros valor:Object [opcional] - Uno de los siguientes valores:
Entero que especifica el nmero de elementos de la matriz. Una lista de dos o ms valores arbitrarios. Los valores pueden ser de tipo Boolean, Number, String, Object o Array.
El primer elemento de una matriz siempre tiene un ndice o una posicin de 0. Nota: si slo se pasa un parmetro numrico al constructor Array, se asumir que es length y se convertir a un entero empleando la funcin Integer(). Ejemplo Sintaxis 1: El ejemplo siguiente crea un objeto Array nuevo con una longitud inicial de 0:

var my_array:Array = new Array(); trace(my_array.length); // Traces 0.
Sintaxis 2: El ejemplo siguiente crea un objeto Array nuevo con una longitud inicial de 4:
var my_array:Array = new Array(4); trace(my_array.length); // Returns 4. trace(my_array[0]); // Returns undefined. if (my_array[0] == undefined) { // No quotation marks around undefined. trace("undefined is a special value, not a string"); } // Traces: undefined is a special value, not a string.
Sintaxis 3: El ejemplo siguiente crea el objeto Array nuevo go_gos_array con una longitud inicial de 5:
var go_gos_array:Array = new Array("Belinda", "Gina", "Kathy", "Charlotte", "Jane"); trace(go_gos_array.length); // Returns 5. trace(go_gos_array.join(", ")); // Displays elements.
Los elementos iniciales de la matriz go_gos_array estn identificados, como se muestra en el ejemplo siguiente:
go_gos_array[0] go_gos_array[1] go_gos_array[2] go_gos_array[3] go_gos_array[4] = = = = = "Belinda"; "Gina"; "Kathy"; "Charlotte"; "Jane";
El cdigo siguiente aade un sexto elemento a la matriz go_gos_array y cambia el segundo elemento:
go_gos_array[5] = "Donna"; go_gos_array[1] = "Nina" trace(go_gos_array.join(" + ")); // Returns Belinda + Nina + Kathy + Charlotte + Jane + Donna.
Vase tambin
Operador de acceso a matriz ([]), length (propiedad Array.length)
CASEINSENSITIVE (propiedad Array.CASEINSENSITIVE)

public static CASEINSENSITIVE : Number
Representa una ordenacin sin distincin entre maysculas y minsculas. Puede utilizar esta constante para el parmetro options en el mtodo sort() o sortOn(). El valor de esta constante es 1. Disponibilidad Flash Lite 2.0 Vase tambin
sort (mtodo Array.sort), sortOn (mtodo Array.sortOn)
concat (mtodo Array.concat)

public concat([value:Object]) : Array
Concatena los elementos especificados en los parmetros con los elementos de una matriz y crea una matriz nueva. Si los parmetros de value especifican una matriz, se concatenarn los elementos de dicha matriz en lugar de la propia matriz. La matriz my_array permanece sin cambios.

Disponibilidad Flash Lite 2.0 Parmetros valor:Object [opcional] - Nmeros, elementos o cadenas que se van a concatenar en una matriz nueva. Si no se pasa ningn valor, se crear un duplicado de my_array. Valor devuelto Array - Matriz que contiene los elementos de esta matriz seguidos de los elementos de los parmetros. Ejemplo El cdigo siguiente concatena dos matrices:
var alpha_array:Array = new Array("a","b","c"); var numeric_array:Array = new Array(1,2,3); var alphaNumeric_array:Array =alpha_array.concat(numeric_array); trace(alphaNumeric_array); // Creates array [a,b,c,1,2,3].
El cdigo siguiente concatena tres matrices:

var num1_array:Array = [1,3,5]; var num2_array:Array = [2,4,6]; var num3_array:Array = [7,8,9]; var nums_array:Array=num1_array.concat(num2_array,num3_array) trace(nums_array); // Creates array [1,3,5,2,4,6,7,8,9].
Las matrices anidadas no se alisan de la misma forma que las matrices normales. Los elementos de una matriz anidada no se dividen en elementos separados en la matriz x_array, como se muestra en el ejemplo siguiente:
var a_array:Array = new Array ("a","b","c"); // 2 and 3 are elements in a nested array. var n_array:Array = new Array(1, [2, 3], 4); var x_array:Array = a_array.concat(n_array); trace(x_array[0]); // a trace(x_array[1]); // b trace(x_array[2]); // c trace(x_array[3]); // 1 trace(x_array[4]); // 2, 3 trace(x_array[5]); // 4
DESCENDING (propiedad Array.DESCENDING)

public static DESCENDING : Number
Representa una ordenacin en orden descendente. Puede utilizar esta constante para el parmetro options en el mtodo sort() o sortOn(). El valor de esta constante es 2. Disponibilidad Flash Lite 2.0

Vase tambin
join (mtodo Array.join)

public join([delimiter:String]) : String
Convierte los elementos de una matriz en cadenas, inserta el separador especificado entre los elementos, los concatena y devuelve la cadena resultante. Una matriz anidada siempre va separada por una coma (,), no por el separador pasado al mtodo join(). Disponibilidad Flash Lite 2.0 Parmetros delimiter:String [opcional] - Carcter o cadena que separa los elementos de matriz en la cadena devuelta. Si se omite este parmetro, se utilizar una coma (,) como separador predeterminado. Valor devuelto String - Una cadena. Ejemplo El ejemplo siguiente crea una matriz con tres elementos: Earth, Moon y Sun. A continuacin, une la matriz tres veces: la primera, utilizando el separador predeterminado (una coma [,] y un espacio), luego empleando un guin (-) y, por ltimo, con un signo ms (+).
var a_array:Array = new Array("Earth","Moon","Sun") trace(a_array.join()); // Displays Earth,Moon,Sun. trace(a_array.join(" - ")); // Displays Earth - Moon - Sun. trace(a_array.join(" + ")); // Displays Earth + Moon + Sun.
En el ejemplo siguiente se crea una matriz anidada que contiene dos matrices. La primera matriz tiene tres elementos: Europa, Io y Callisto. La segunda matriz tiene dos elementos: Titan y Rhea. Se une la matriz con el signo ms (+), pero los elementos dentro de cada matriz anidada permanecen separados por comas (,).
var a_nested_array:Array = new Array(["Europa", "Io", "Callisto"], ["Titan", "Rhea"]); trace(a_nested_array.join(" + ")); // Returns Europa,Io,Callisto + Titan,Rhea.
Vase tambin
split (mtodo String.split)
length (propiedad Array.length)

Un entero no negativo que especifica el nmero de elementos de la matriz. Esta propiedad se actualiza automticamente cuando se aaden nuevos elementos a la matriz. Cuando se asigna un valor a un elemento de matriz (por ejemplo, my_array[index] = value), si index es un nmero e index+1 es mayor que la propiedad length, esta propiedad length se actualizar a index+1.

Nota: si asigna un valor a la propiedad length inferior a la longitud existente, la matriz se truncar. Disponibilidad Flash Lite 2.0 Ejemplo El cdigo siguiente explica cmo se actualiza la propiedad length. La longitud inicial es 0 y luego se actualiza a 1, 2 y 10. Si asigna una valor a la propiedad length inferior a la longitud existente, la matriz se truncar:
var my_array:Array = new Array(); trace(my_array.length); // initial length is 0 my_array[0] = "a"; trace(my_array.length); // my_array.length is updated to 1 my_array[1] = "b"; trace(my_array.length); // my_array.length is updated to 2 my_array[9] = "c"; trace(my_array.length); // my_array.length is updated to 10 trace(my_array); // displays: // a,b,undefined,undefined,undefined,undefined,undefined,undefined,undefined,c // if the length property is now set to 5, the array will be truncated my_array.length = 5; trace(my_array.length); // my_array.length is updated to 5 trace(my_array); // outputs: a,b,undefined,undefined,undefined
NUMERIC (propiedad Array.NUMERIC)

public static NUMERIC : Number
Representa una ordenacin numrica en lugar de una ordenacin basada en cadenas. La ordenacin basada en cadenas, que es la configuracin predeterminada, trata los nmeros como cadenas al ordenarlos. Por ejemplo, la ordenacin basada en cadenas coloca un 10 por delante de un 3. Una ordenacin numrica trata los elementos como nmeros, por lo que el 3 ira delante del 10. Se puede utilizar esta constante para el parmetro options en el mtodo sort() o sortOn(). El valor de esta constante es 16. Disponibilidad Flash Lite 2.0 Vase tambin
pop (mtodo Array.pop)

public pop() : Object
Elimina el ltimo elemento de una matriz y devuelve el valor de dicho elemento. Disponibilidad Flash Lite 2.0

Valor devuelto Object - Valor del ltimo elemento de la matriz especificada. Ejemplo El cdigo siguiente crea la matriz myPets_ que contiene cuatro elementos y, a continuacin, elimina su ltimo elemento:
var myPets_array:Array = new Array("cat", "dog", "bird", "fish"); var popped:Object = myPets_array.pop(); trace(popped); // Displays fish. trace(myPets_array); // Displays cat,dog,bird.
Vase tambin
push (mtodo Array.push), shift (mtodo Array.shift), unshift (mtodo Array.unshift)
push (mtodo Array.push)

public push(value:Object) : Number
Aade uno o varios elementos al final de una matriz y devuelve la nueva longitud de la matriz. Disponibilidad Flash Lite 2.0 Parmetros valor:Object - Uno o ms valores que se aadirn a la matriz. Valor devuelto Number - Entero que representa la longitud de la nueva matriz. Ejemplo El ejemplo siguiente crea una matriz myPets_array con dos elementos definidos: cat y dog. La segunda lnea aade dos elementos a la matriz. Dado que el mtodo push() devuelve la nueva longitud de la matriz, la sentencia trace() de la ltima lnea enva la nueva longitud de myPets_array (4) al panel Salida.
var myPets_array:Array = new Array("cat", "dog"); var pushed:Number = myPets_array.push("bird", "fish"); trace(pushed); // Displays 4.
Vase tambin
pop (mtodo Array.pop), shift (mtodo Array.shift), unshift (mtodo Array.unshift)
RETURNINDEXEDARRAY (propiedad Array.RETURNINDEXEDARRAY)

public static RETURNINDEXEDARRAY : Number
Representa la opcin para devolver una matriz indexada como resultado de llamar al mtodo sort() o sortOn(). Puede utilizar esta constante para el parmetro options en el mtodo sort() o sortOn(). Proporciona funciones de vista previa o copia devolviendo una matriz que representa los resultados de la ordenacin y deja la matriz original sin modificar. El valor de esta constante es 8.

Disponibilidad Flash Lite 2.0 Vase tambin

reverse (mtodo Array.reverse)

public reverse() : Void
Invierte la matriz en su sitio. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente utiliza este mtodo para invertir la matriz numbers_array:
var numbers_array:Array = new Array(1, 2, 3, 4, 5, 6); trace(numbers_array); // Displays 1,2,3,4,5,6. numbers_array.reverse(); trace(numbers_array); // Displays 6,5,4,3,2,1.
shift (mtodo Array.shift)

public shift() : Object
Elimina el primer elemento de una matriz y devuelve dicho elemento. Disponibilidad Flash Lite 2.0 Valor devuelto Object - Primer elemento de una matriz. Ejemplo El cdigo siguiente crea la matriz myPets_array y, a continuacin, elimina el primer elemento de la matriz y lo asigna a la variable shifted:
var myPets_array:Array = new Array("cat", "dog", "bird", "fish"); var shifted:Object = myPets_array.shift(); trace(shifted); // Displays "cat". trace(myPets_array); // Displays dog,bird,fish.
Vase tambin
pop (mtodo Array.pop), push (mtodo Array.push), unshift (mtodo Array.unshift)
slice (mtodo Array.slice)

public slice([startIndex:Number], [endIndex:Number]) : Array

Devuelve una matriz nueva que consta de un rango de elementos de la matriz original, sin modificar la matriz original. La matriz devuelta incluye el elemento startIndex y todos los elementos hasta endIndex, sin incluir ste. Si no se pasa ningn parmetro, se crear un duplicado de la matriz original. Disponibilidad Flash Lite 2.0 Parmetros startIndex:Number [opcional] - Nmero que especifica el ndice del punto inicial para la divisin. Si start es un nmero negativo, el punto inicial comenzar al final de la matriz, donde -1 es el ltimo elemento. endIndex:Number [opcional] - Nmero que especifica el ndice del punto final para la divisin. Si se omite este parmetro, la divisin incluir todos los elementos desde el punto inicial hasta el final de la matriz. Si end es un nmero negativo, el punto final se especificar desde el final de la matriz, donde -1 es el ltimo elemento. Valor devuelto Array - Matriz que consta de un rango de elementos de la matriz original. Ejemplo El ejemplo siguiente crea una matriz de cinco mascotas y utiliza slice() para llenar una nueva matriz que slo contiene las mascotas con cuatro patas:
var myPets_array:Array = new Array("cat", "dog", "fish", "canary", "parrot"); var myFourLeggedPets_array:Array = new Array(); var myFourLeggedPets_array = myPets_array.slice(0, 2); trace(myFourLeggedPets_array); // Returns cat,dog. trace(myPets_array); // Returns cat,dog,fish,canary,parrot.
El ejemplo siguiente crea una matriz de cinco mascotas y, a continuacin, utiliza slice() con un parmetro start negativo para copiar los dos ltimos elementos de la matriz:
var myPets_array:Array = new Array("cat", "dog", "fish", "canary", "parrot"); var myFlyingPets_array:Array = myPets_array.slice(-2); trace(myFlyingPets_array); // Traces canary,parrot.
El ejemplo siguiente crea una matriz de cinco mascotas y utiliza slice() con un parmetro end negativo para copiar el elemento central de la matriz:
var myPets_array:Array = new Array("cat", "dog", "fish", "canary", "parrot"); var myAquaticPets_array:Array = myPets_array.slice(2,-2); trace(myAquaticPets_array); // Returns fish.
sort (mtodo Array.sort)

public sort([compareFunction:Object], [options:Number]) : Array
Ordena los elementos de una matriz. Flash ordena por valores Unicode. (ASCII es un subconjunto de Unicode.) De manera predeterminada, Array.sort() funciona de la forma descrita en la siguiente lista:
La ordenacin distingue entre maysculas y minsculas (Z precede a a). La ordenacin es ascendente (a precede a b). La matriz se modifica para reflejar el orden de ordenacin; los elementos que tengan campos de ordenacin
idnticos se sitan consecutivamente en la matriz ordenada sin seguir ningn orden especfico.

Los campos numricos se ordenan como si fueran cadenas, de manera que 100 precede a 99, dado que "1" es un
valor de cadena inferior a "9". Si desea ordenar una matriz utilizando valores que se desvan de los predeterminados, puede utilizar una de las opciones de ordenacin que se describen en la entrada del parmetro options o puede crear una funcin personalizada para realizar la ordenacin. Si crea una funcin personalizada, podr utilizarla llamando al mtodo sort(), con el nombre de dicha funcin como primer parmetro (compareFunction). Disponibilidad Flash Lite 2.0 Parmetros compareFunction:Object [opcional] - Funcin de comparacin utilizada para determinar el orden de los elementos de una matriz. Dados los elementos A y B, el resultado de compareFunction puede tener uno de los tres valores siguientes:
-1, si A debe aparecer antes que B en la secuencia ordenada 0, si A es igual a B 1, si A debe aparecer despus que B en la secuencia ordenada
options:Number [opcional] - Uno o ms nmeros o nombres de constantes definidas, separados por el operador | (OR en modo bit), que cambian el comportamiento de la ordenacin respecto al valor predeterminado. Estos son los valores vlidos del parmetro options:
Array.CASEINSENSITIVE o 1 Array.DESCENDING o 2 Array.UNIQUESORT o 4 Array.RETURNINDEXEDARRAY u 8 Array.NUMERIC o 16
Para ms informacin sobre este parmetro, consulte el mtodo Array.sortOn(). Nota: Array.sort() se define en ECMA-262, pero las opciones de ordenacin de matrices introducidas en Flash Player 7 son extensiones especficas de Flash para la especificacin ECMA-262. Valor devuelto Array - El valor devuelto depende de si se pasa algn parmetro, como se describe en la siguiente lista:
Si especifica el valor 4 o Array.UNIQUESORT para el parmetro options y dos o ms elementos ordenados tienen
campos de ordenacin idnticos, Flash devolver el valor 0 y no modificar la matriz.
Si especifica el valor 8 o Array.RETURNINDEXEDARRAY para el parmetro options, Flash devolver una matriz que
reflejar los resultados de la ordenacin y no modificar la matriz.
En cualquier otro caso, Flash no devuelve nada y modifica la matriz de manera que refleje el orden de ordenacin.
Ejemplo Sintaxis 1: El ejemplo siguiente muestra el uso de Array.sort() con y sin un valor pasado para options:

var fruits_array:Array = new Array("oranges", "apples", "strawberries", "pineapples", "cherries"); trace(fruits_array); // Displays oranges,apples,strawberries,pineapples,cherries. fruits_array.sort(); trace(fruits_array); // Displays apples,cherries,oranges,pineapples,strawberries. fruits_array.sort(Array.DESCENDING); trace(fruits_array); // Displays strawberries,pineapples,oranges,cherries,apples.
Sintaxis 2: El ejemplo siguiente utiliza Array.sort() con una funcin de comparacin. Las entradas se ordenan en el formato nombre: contrasea. Ordene utilizando como criterio la parte del nombre solamente:
var passwords_array:Array = new Array("mom:glam", "ana:ring", "jay:mag", "anne:home", "regina:silly"); function order(a, b):Number { var name1:String = a.split(":")[0]; var name2:String = b.split(":")[0]; if (name1<name2) { return -1; } else if (name1>name2) { return 1; } else { return 0; } } trace("Unsorted:"); trace(passwords_array); //Displays mom:glam,ana:ring,jay:mag,anne:home,regina:silly. passwords_array.sort(order); trace("Sorted:"); trace(passwords_array); //Displays ana:ring,anne:home,jay:mag,mom:glam,regina:silly.
Vase tambin
| operador OR en modo bit, sortOn (mtodo Array.sortOn)
sortOn (mtodo Array.sortOn)

public sortOn(fieldName:Object, [options:Object]) : Array
Ordena los elementos de una matriz por uno o varios campos de la matriz. La matriz debe tener las siguientes caractersticas:
La matriz es indexada, no asociativa. Cada elemento de la matriz contiene un objeto con una o varias propiedades. Todos los objetos tienen al menos una propiedad en comn, cuyos valores pueden emplearse para ordenar la
matriz. Esa propiedad se denomina field. Si pasa varios parmetros fieldName, el primer campo representar al campo de ordenacin principal, el segundo representar al siguiente campo de ordenacin, etc. Flash ordena por valores Unicode. (ASCII es un subconjunto de Unicode.) Si uno de los elementos que se estn comparando no contiene el campo especificado en el parmetro fieldName, se dar por hecho que el campo no est definido (undefined) y los elementos se colocarn consecutivamente en la matriz ordenada sin seguir ningn orden determinado. De manera predeterminada, Array.sortOn() funciona de la forma descrita en la siguiente lista:
La ordenacin distingue entre maysculas y minsculas (Z precede a a).

La ordenacin es ascendente (a precede a b). La matriz se modifica para reflejar el orden de ordenacin; los elementos que tengan campos de ordenacin
idnticos se sitan consecutivamente en la matriz ordenada sin seguir ningn orden especfico.
Los campos numricos se ordenan como si fueran cadenas, de manera que 100 precede a 99, dado que "1" es un
valor de cadena inferior a "9". Se puede utilizar el parmetro options para sustituir el comportamiento de ordenacin predeterminado. Si quiere ordenar una matriz sencilla (por ejemplo, una matriz con un solo campo) o si desea especificar un orden de clasificacin que el parmetro options no admite, utilice Array.sort(). Para pasar varios indicadores, seprelos con el operador OR en modo de bit (|):
my_array.sortOn(someFieldName, Array.DESCENDING | Array.NUMERIC);
Disponibilidad Flash Lite 2.0 Parmetros fieldName:Object - Cadena que identifica un campo que se va a utilizar como valor de ordenacin, o matriz en la cual el primer elemento representa el campo de ordenacin principal, el segundo representa el campo de ordenacin secundario, etc. options:Object [opcional] - Uno o ms nmeros o nombres de constantes definidas, separados por el operador | (OR en modo bit), que cambian el comportamiento de la ordenacin. Estos son los valores vlidos del parmetro options:
Array.CASEINSENSITIVE o 1 Array.DESCENDING o 2 Array.UNIQUESORT o 4 Array.RETURNINDEXEDARRAY u 8 Array.NUMERIC o 16
Las sugerencias estn activadas si se utiliza la forma de cadena del indicador (por ejemplo, DESCENDING) en lugar de su forma numrica (2). Valor devuelto Array - El valor devuelto depende de si se pasa algn parmetro, como se describe en la siguiente lista:
Si especifica el valor 4 o Array.UNIQUESORT para el parmetro options y dos o ms elementos ordenados tienen
campos de ordenacin idnticos, Flash devolver el valor 0 y no modificar la matriz.
Si especifica el valor 8 o Array.RETURNINDEXEDARRAY para el parmetro options, Flash devolver una matriz que
reflejar los resultados de la ordenacin y no modificar la matriz.
En cualquier otro caso, Flash no devuelve nada y modifica la matriz de manera que refleje el orden de ordenacin.
Ejemplo El ejemplo siguiente crea una matriz nueva y la ordena de acuerdo con los campos name y city. La primera ordenacin utiliza name como primer valor de ordenacin y city como segundo. La segunda ordenacin utiliza city como primer valor de ordenacin y name como segundo.

var rec_array:Array = new Array(); rec_array.push({name: "john", city: "omaha", zip: 68144}); rec_array.push({name: "john", city: "kansas city", zip: 72345}); rec_array.push({name: "bob", city: "omaha", zip: 94010}); for(i=0; i<rec_array.length; i++){ trace(rec_array[i].name + ", " + rec_array[i].city); } // Results: // john, omaha // john, kansas city // bob, omaha rec_array.sortOn(["name", "city"]); for(i=0; i<rec_array.length; i++){ trace(rec_array[i].name + ", " + rec_array[i].city); } // Results: // bob, omaha // john, kansas city // john, omaha rec_array.sortOn(["city", "name" ]); for(i=0; i<rec_array.length; i++){ trace(rec_array[i].name + ", " + rec_array[i].city); } // Results: // john, kansas city // bob, omaha // john, omaha
La matriz de objetos siguiente se utiliza en los ejemplos restantes, que muestran cmo utilizar el parmetro options:
var my_array:Array = new my_array.push({password: my_array.push({password: my_array.push({password: my_array.push({password: Array(); "Bob", age:29}); "abcd", age:3}); "barb", age:35}); "catchy", age:4});
La ordenacin predeterminada por el campo password produce el siguiente resultado:

my_array.sortOn("password"); // Bob // abcd // barb // catchy
La ordenacin con distincin entre maysculas y minsculas por el campo password produce el siguiente resultado:
my_array.sortOn("password", Array.CASEINSENSITIVE); // abcd // barb // Bob // catchy
La ordenacin con distincin entre maysculas y minsculas en orden descendente por el campo password produce el siguiente resultado:

my_array.sortOn("password", Array.CASEINSENSITIVE | Array.DESCENDING); // catchy // Bob // barb // abcd
La ordenacin predeterminada por el campo age produce el siguiente resultado:

my_array.sortOn("age"); // 29 // 3 // 35 // 4
La ordenacin numrica por el campo age produce el siguiente resultado:

my_array.sortOn("age", Array.NUMERIC); // my_array[0].age = 3 // my_array[1].age = 4 // my_array[2].age = 29 // my_array[3].age = 35
La ordenacin numrica descendente por el campo age produce el siguiente resultado:

my_array.sortOn("age", Array.DESCENDING | Array.NUMERIC); // my_array[0].age = 35 // my_array[1].age = 29 // my_array[2].age = 4 // my_array[3].age = 3
Cuando utilice la opcin de ordenacin Array.RETURNINDEXARRAY, deber asignar el valor devuelto a otra matriz. La matriz original no se modifica.
var indexArray:Array = my_array.sortOn("age", Array.RETURNINDEXEDARRAY);
Vase tambin
| operador OR en modo bit, sort (mtodo Array.sort)
splice (mtodo Array.splice)

public splice(startIndex:Number, [deleteCount:Number], [value:Object]) : Array
Aade y elimina elementos de una matriz. Este mtodo modifica la matriz sin realizar ninguna copia de ella. Disponibilidad Flash Lite 2.0 Parmetros startIndex:Number - Entero que especifica el ndice del elemento de la matriz donde comienza la insercin o eliminacin. Se puede especificar un entero negativo para establecer una posicin relativa al final de la matriz (por ejemplo, -1 es el ltimo elemento de la matriz). deleteCount:Number [opcional] - Entero que especifica el nmero de elementos que se va a eliminar. Este nmero incluye el elemento especificado en el parmetro startIndex. Si no se ha especificado ningn valor para el parmetro deleteCount, el mtodo elimina todos los valores desde el elemento startIndex hasta el ltimo elemento de la matriz. Si el valor es 0, no se eliminar ningn elemento.

valor:Object [opcional] - Especifica los valores que se van a insertar en la matriz en el punto de insercin especificado en el parmetro startIndex. Valor devuelto Array - Matriz que contiene los elementos eliminados de la matriz original. Ejemplo El ejemplo siguiente crea una matriz y la divide utilizando el ndice de elemento 1 para el parmetro startIndex. De este modo se eliminan todos los elementos de la matriz a partir del segundo elemento, dejando nicamente el elemento del ndice 0 en la matriz original:
var myPets_array:Array = new Array("cat", "dog", "bird", "fish"); trace( myPets_array.splice(1) ); // Displays dog,bird,fish. trace( myPets_array ); // cat
El ejemplo siguiente crea una matriz y la divide utilizando el ndice de elemento 1 para el parmetro startIndex y el nmero 2 para el parmetro deleteCount. De este modo se eliminan dos elementos de la matriz a partir del segundo elemento, dejando el primero y el ltimo elemento en la matriz original:
var myFlowers_array:Array = new Array("roses", "tulips", "lilies", "orchids"); trace( myFlowers_array.splice(1,2 ) ); // Displays tulips,lilies. trace( myFlowers_array ); // roses,orchids
El ejemplo siguiente crea una matriz y la divide utilizando el ndice de elemento 1 para el parmetro startIndex, el nmero 0 para el parmetro deleteCount y la cadena chair para el parmetro value. No se elimina nada de la matriz original y aade la cadena chair en el ndice 1:
var myFurniture_array:Array = new Array("couch", "bed", "desk", "lamp"); trace( myFurniture_array.splice(1,0, "chair" ) ); // Displays empty array. trace( myFurniture_array ); // displays couch,chair,bed,desk,lamp
toString (mtodo Array.toString)

public toString() : String
Devuelve un valor de cadena que representa los elementos del objeto Array especificado. Cada elemento de la matriz, comenzando por el ndice 0 y terminando por el ndice ms alto, se convierte en una cadena concatenada separada por comas. Para especificar un separador personalizado, utilice el mtodo Array.join(). Disponibilidad Flash Lite 2.0 Valor devuelto String - Una cadena. Ejemplo El ejemplo siguiente crea my_array y la convierte en una cadena.

var my_array:Array = new Array(); my_array[0] = 1; my_array[1] = 2; my_array[2] = 3; my_array[3] = 4; my_array[4] = 5; trace(my_array.toString()); // Displays 1,2,3,4,5.
Este ejemplo produce 1,2,3,4,5 como resultado de la sentencia trace. Vase tambin
split (mtodo String.split), join (mtodo Array.join)
UNIQUESORT (propiedad Array.UNIQUESORT)

public static UNIQUESORT : Number
Representa el requisito de ordenacin exclusiva. Puede utilizar esta constante para el parmetro options en el mtodo sort() o sortOn(). La opcin de ordenacin exclusiva interrumpe la ordenacin si dos de los elementos o campos que se estn ordenando tienen valores idnticos. El valor de esta constante es 4. Disponibilidad Flash Lite 2.0 Vase tambin
unshift (mtodo Array.unshift)

public unshift(value:Object) : Number
Aade uno o varios elementos al comienzo de una matriz y devuelve la nueva longitud de la matriz. Disponibilidad Flash Lite 2.0 Parmetros valor:Object - Uno o ms nmeros, elementos o variables que se insertarn al principio de la matriz. Valor devuelto Number - Entero que representa la nueva longitud de la matriz. Ejemplo El ejemplo siguiente muestra el uso del mtodo Array.unshift():
var pets_array:Array = new Array("dog", "cat", "fish"); trace( pets_array ); // Displays dog,cat,fish. pets_array.unshift("ferrets", "gophers", "engineers"); trace( pets_array ); // Displays ferrets,gophers,engineers,dog,cat,fish.
Vase tambin
pop (mtodo Array.pop), push (mtodo Array.push), shift (mtodo Array.shift)

BitmapData (flash.display.BitmapData)
Object | +-flash.display.BitmapData public class BitmapData extends Object
La clase BitmapData permite crear imgenes de mapa de bits de cualquier tamao tanto transparentes como opacas y manipularlas de varias maneras en tiempo de ejecucin. Esta clase le permite separar las operaciones de representacin de mapa de bits de las rutinas de actualizacin de la visualizacin internas de Flash Lite Player. Con la manipulacin directa de un objeto BitmapData es posible crear imgenes muy complejas sin recargar cada fotograma por redibujar constantemente el contenido de datos vectoriales. Los mtodos de la clase BitmapData admiten una amplia gama de efectos que no estn disponibles a travs de la interfaz genrica de filtros. Un objeto BitmapData contiene una matriz de datos de pxeles. Estos datos pueden representar un mapa de bits completamente opaco o un mapa de bits transparente que contiene datos del canal alfa. Ambos tipos de objetos BitmapData se almacenan como bfer de enteros de 32 bits. Cada entero de 32 bits determina las propiedades de un pxel nico del mapa de bits. Cada entero de 32 bits es una combinacin de cuatro valores de canal de 8 bits (de cero a 255) que describen los valores de transparencia alfa, y rojo, verde y azul (ARGB) del pxel. Los cuatro canales (rojo, verde, azul y alfa) se representan como nmeros cuando se utilizan con el mtodo BitmapData.copyChannel() o las propiedades DisplacementMapFilter.componentX y DisplacementMapFilter.componentY, de la siguiente manera:
1 (rojo) 2 (verde) 4 (azul) 8 (alfa)
Puede asociar objetos BitmapData a un objeto MovieClip utilizando el mtodo MovieClip.attachBitmap(). Puede utilizar un objeto BitmapData para rellenar un rea de un clip de pelcula utilizando el mtodo MovieClip.beginBitmapFill(). Un objeto BitmapData puede tener una altura y una anchura mximas de 2.880 pxeles. Disponibilidad Flash Lite 3.1 Vase tambin
attachBitmap (mtodo MovieClip.attachBitmap), beginFill (mtodo MovieClip.beginFill)

Modificadores Propiedad height:Number [slo lectura] rectangle:Rectngulo [slo lectura] Descripcin Altura de la imagen de mapa de bits, expresada en pxeles.
Rectngulo que define el tamao y la ubicacin de la imagen de mapa de bits.
transparent:Boolean [slo Define si la imagen de mapa de bits admite transparencia por pxel. lectura] width:Boolean [slo lectura] Anchura de la imagen de mapa de bits, expresada en pxeles.
constructor (propiedad Object.constructor), __proto__ (Object.__proto__, propiedad), prototype (propiedad Object.prototype), __resolve (Object.__resolve, propiedad)
Firma Descripcin
BitmapData(width:Num Crea un nuevo objeto BitmapData con una determinada anchura y altura. ber, height:Number,[tran sparent:Boolean], [fillColor:Number])
Resumen de mtodos
Modificadores Firma
applyFilter
Descripcin Toma una imagen de origen y un objeto de filtro y genera la imagen filtrada. Flash Lite 3.1 no admite filtros, por lo que este mtodo no es compatible.
clone(): BitmapData
Devuelve un objeto BitmapData nuevo que es un clon de la instancia original con una copia exacta del mapa de bits contenido. Ajusta los valores de color en una determinada rea de una imagen de mapa de bits mediante un objeto ColorTransform.
colorTransform(rect:Re ctngulo, colorTransform:Color Transform) : Void
copyChannel(sourceBit Transfiere datos de un canal de otro objeto BitmapData o del map:BitmapData, objeto BitmapData actual a un canal del objeto BitmapData actual. sourceRect: Rectngulo, destPoint:Point, sourceChannel:Numbe r, destChannel: Number: Void

Modificadores
Firma copyPixels(sourceBitm ap:BitmapData,

sourceRect:
Descripcin Proporciona una rutina rpida para la manipulacin de pxeles entre imgenes sin efectos de color, rotacin ni expansin.
Rectngulo,
destPoint:Point, [alphaBitmap:BitmapD ata] , [alphaPoint:Point, [mergeAlpha:Boolean] ) : Void
dispose() : Void
Libera memoria que se utiliza para almacenar el objeto BitmapData.
draw(source:Object, Dibuja un clip de pelcula o una imagen de origen en una imagen [matriz:Matrix],[colo de destino, utilizando el procesador de vectores del reproductor rTransform:ColorTransf de Flash Lite. orm],[blendMode:Obje ct],[cliprect:Rectng ulo],[smooth:Boolean] ) : Void fillRect(rect:Rectngulo Rellena un rea rectangular de pxeles con un determinado color ,color:Number) : ARGB.
Void
Realiza una operacin de relleno en una imagen empezando por floodFill(x:Number, y:Number, una coordenada (x, y) y rellenando con un determinado color. color:Number) : Void
generateFilterRect
Determina el rectngulo de destino al que afecta la llamada applyFilter(), dados un objeto BitmapData, un rectngulo de origen y un objeto de filtro. Flash Lite no admite este mtodo.
getColorBoundsRect(mas k:Number, color:Number, [findColor:Boolean] ) :Rectngulo getPixel(x:Number, y:Number) : Number getPixel32(x:Number, y:Number) : Number hitTest(firstPoint:Poi nt,
firstAlphaThreshold :Number, secondObject:Object, [secondBitmapPoint: Point] ,[secondAlphaThresh old:Number] ) :Boolean static
Determina una regin rectangular que encierra completamente todos los pxeles de un determinado color dentro de la imagen de mapa de bits.
Devuelve un entero que representa un valor de pxel RGB de un objeto BitmapData en un punto especfico (x, y). Devuelve un valor de color ARGB que contiene datos del canal alfa y datos de RGB. Detecta la zona activa a nivel de pxeles entre una imagen de mapa de bits y un punto, un rectngulo u otra imagen de mapa de bits.
loadBitmap(id:String): BitmapData
Devuelve un nuevo objeto BitmapData que contiene una representacin de imagen de mapa de bits del smbolo identificado por un determinado ID de vinculacin en la biblioteca.

Modificadores
Firma
Descripcin
merge(sourceBitmap:B Realiza una mezcla por canal de una imagen de origen a una itmapData, imagen de destino.
sourceRect:
Rectngulo,
destPoint:Point, redMult:Number, greenMult:Number, blueMult:Number, alphaMult:Number) : Void noise
Rellena una imagen con pxeles que representan ruido aleatorio. Flash Lite no admite este mtodo.
paletteMap
Reasigna los valores del canal de color en una imagen proporcionada a cuatro conjuntos de datos de la paleta de colores, una por cada canal. Flash Lite no admite este mtodo.
perlinNoise
Genera una imagen de ruido Perlin. Flash Lite no admite este mtodo.
pixelDissolve
Realiza una disolucin de pxeles de una imagen de origen a una imagen de destino o utilizando la misma imagen. Flash Lite no admite este mtodo.
scroll
Desplaza una imagen una determinada cantidad de pxeles (x, y). Flash Lite no admite este mtodo.
setPixel(x:Number, Establece el color de un nico pxel de un objeto BitmapData. y:Number, color:Number) : Void Establece los valores de color y transparencia alfa de un solo pxel setPixel32(x:Number, y:Number, de un objeto BitmapData. color:Number) : Void
threshold
Prueba valores de pxel en una imagen con un umbral especificado y define los pxeles que se pasan para probar los valores del nuevo color. Flash Lite no admite este mtodo.
addProperty (mtodo Object.addProperty), hasOwnProperty (mtodo Object.hasOwnProperty), isPropertyEnumerable (mtodo Object.isPropertyEnumerable), isPrototypeOf (mtodo Object.isPrototypeOf), registerClass (mtodo Object.registerClass), toString (mtodo Object.toString), unwatch (mtodo Object.unwatch), valueOf (mtodo Object.valueOf), watch (mtodo Object.watch)
Constructor BitmapData
public BitmapData(width:Number, height:Number, [transparent:Boolean], [fillColor:Number])
Crea un nuevo objeto BitmapData con una determinada anchura y altura. Si especifica un valor para el parmetro fillColor, todos los pxeles del mapa de bits utilizan ese color.

De forma predeterminada, el mapa de bits se crea como opaco, a menos que pase el valor true para el parmetro transparent. Una vez que se ha creado un mapa de bits opaco, no se puede cambiar a uno transparente. Todos los pxeles de un mapa de bits opaco utilizan 24 bits de informacin del canal de color. Si define el mapa de bits como transparente, todos los pxeles utilizan 32 bits de informacin del canal de color, incluido un canal de transparencia alfa. Un objeto BitmapData puede tener una altura y una anchura mximas de 2.880 pxeles. Si especifica un valor de anchura o altura mayor que 2.880, no se crear una instancia nueva. Disponibilidad Flash Lite 3.1 Parmetros width:Number - Anchura de la imagen de mapa de bits, expresada en pxeles. height:Number - Altura de la imagen de mapa de bits, expresada en pxeles. transparent:Boolean [opcional] - Especifica si la imagen de mapa de bits admite transparencia por pxel. El valor predeterminado es true (transparente). Para crear un mapa de bits totalmente transparente, defina el valor del parmetro transparent como true y el valor del parmetro fillColor con 0x00000000 (o a 0). fillColor:Number [opcional] - Valor de color ARGB de 32 bits que se utiliza para rellenar el rea de la imagen de mapa de bits. El valor predeterminado es 0xFFFFFFFF (blanco slido). Ejemplo El ejemplo siguiente crea un nuevo objeto BitmapData. Los valores de este ejemplo son los valores predeterminados para los parmetros transparent y fillColor; puede llamar al constructor sin estos parmetros para obtener el mismo resultado.
import flash.display.BitmapData; var var var var width:Number = 100; height:Number = 80; transparent:Boolean = true; fillColor:Number = 0xFFFFFFFF;
var bitmap_1:BitmapData = new BitmapData(width, height, transparent, fillColor); trace(bitmap_1.width); // 100 trace(bitmap_1.height); // 80 trace(bitmap_1.transparent); // true var bitmap_2:BitmapData = new BitmapData(width, height); trace(bitmap_2.width); // 100 trace(bitmap_2.height); // 80 trace(bitmap_2.transparent); // true
clone (mtodo BitmapData.clone)

public clone() : BitmapData
Devuelve un nuevo objeto BitmapData, que es una copia del mapa de bits actual. Un clon y el objeto clonado tienen propiedades idnticas. No obstante, un clon no se evala como idntico al objeto BitmapData que se ha clonado debido a que las propiedades del objeto original se pasan segn valor al clon, no se pasan segn referencia. Si cambia los valores del objeto original despus de crear el clon, ste no recibir los nuevos valores.

Disponibilidad Flash Lite 3.1 Valor devuelto BitmapData - Un objeto BitmapData nuevo que es idntico al original. Ejemplo El ejemplo siguiente crea tres objetos BitmapData y los compara. El cdigo usa el constructor BitmapData para crear la instancia bitmap_1. Crea la instancia bitmap_2 definindola como igual a bitmap_1. Crea la instancia clonedBitmap clonando bitmap_1. Observe que aunque se evala que bitmap_2 es igual a bitmap_1, no ocurre as con clonedBitmap, a pesar de que contenga los mismos valores que bitmap_1.
import flash.display.BitmapData; var bitmap_1:BitmapData = new BitmapData(100, 80, false, 0x000000); var bitmap_2:BitmapData = bitmap_1; var clonedBitmap:BitmapData = bitmap_1.clone(); trace("bitmap_1 == bitmap_2 " + (bitmap_1 == bitmap_2)); // true trace("bitmap_1 == clonedBitmap " + (bitmap_1 == clonedBitmap)); // false trace("-------------bitmap_1 properties-------------") for(var i in bitmap_1) { trace(">> " + i + ": " + bitmap_1[i]); } trace("-------------bitmap_2 properties-------------") for(var i in bitmap_2) { trace(">> " + i + ": " + bitmap_1[i]); } trace("-------------clonedBitmap properties-------------") for(var i in clonedBitmap) { trace(">> " + i + ": " + clonedBitmap[i]); }
Para seguir viendo las relaciones existentes entre bitmap_1, bitmap_2 y clonedBitmap, el ejemplo siguiente modifica el valor del pxel situado en (1, 1) de bitmap_1. La modificacin del valor del pxel situado en (1, 1) cambia el valor del pxel de bitmap_2 porque bitmap_2 incluye referencias a bitmap_1. La modificacin de bitmap_1 no cambia clonedBitmap porque clonedBitmap no hace referencia a los valores de bitmap_1.

import flash.display.BitmapData; var bitmap_1:BitmapData = new BitmapData(100, 80, false, 0x000000); var bitmap_2:BitmapData = bitmap_1; var clonedBitmap:BitmapData = bitmap_1.clone(); trace(bitmap_1.getPixel32(1, 1)); // -16777216 trace(bitmap_2.getPixel32(1, 1)); // -16777216 trace(clonedBitmap.getPixel32(1, 1)); // -16777216 bitmap_1.setPixel32(1, 1, 0xFFFFFF); trace(bitmap_1.getPixel32(1, 1)); // -1 trace(bitmap_2.getPixel32(1, 1)); // -1 trace(clonedBitmap.getPixel32(1, 1)); // -16777216
colorTransform (mtodo BitmapData.colorTransform)

public colorTransform(rect: Rectangle, colorTransform: ColorTransform) : Void
Ajusta los valores de color en una determinada rea de una imagen de mapa de bits mediante un objeto ColorTransform. Si el rectngulo coincide con los lmites de la imagen de mapa de bits, este mtodo transformar los valores de color de toda la imagen. Disponibilidad Flash Lite 3.1 Parmetros rect:Rectngulo - Un objeto Rectangle que define el rea de la imagen en la que se aplica el objeto ColorTransform. colorTransform:ColorTransform - Un objeto ColorTransform que describe los valores de transformacin de color que se van a aplicar. Ejemplo En el ejemplo siguiente, se muestra cmo aplicar una operacin de transformacin del color a una instancia de BitmapData.
fscommand2("SetSoftKeys"); import flash.display.BitmapData; import flash.geom.ColorTransform; var myBitmapData:BitmapData = new BitmapData(100, 80, false, 0x00CCCCCC); var mc:MovieClip = this.createEmptyMovieClip("mc", this.getNextHighestDepth()); mc.attachBitmap(myBitmapData, this.getNextHighestDepth()); var myListener:Object = new Object (); myListener.onKeyDown = function () { var keyCode = Key.getCode (); if (keyCode == ExtendedKey.SOFT1) { // Handle left soft key event myBitmapData.colorTransform(myBitmapData.rectangle, new ColorTransform(1, 0, 0, 1, 255, 0, 0, 0)); } };

Vase tambin
ColorTransform (flash.geom.ColorTransform), Rectangle (flash.geom.Rectangle)
copyChannel (mtodo BitmapData.copyChannel)

public copyChannel(sourceBitmap:BitmapData, sourceRect:Rectangle, destPoint:Point, sourceChannel:Number, destChannel:Number) : Void
Transfiere datos de un canal de otro objeto BitmapData o del objeto BitmapData actual a un canal del objeto BitmapData actual. Se mantendrn todos los datos de los dems canales del objeto BitmapData de destino. El valor del canal de origen y el valor del canal de destino pueden ser uno de los siguientes valores o la suma de alguno de los valores:
1 (rojo) 2 (verde) 4 (azul) 8 (alfa)
Disponibilidad Flash Lite 3.1 Parmetros sourceBitmap:BitmapData - La imagen de mapa de bits de entrada que se va a utilizar. La imagen de origen puede ser otro objeto BitmapData o puede hacer referencia al objeto BitmapData actual. sourceRect:Rectngulo - El objeto Rectangle de origen. Especifique un rectngulo de origen con un tamao menor que el tamao global del objeto BitmapData si slo desea copiar los datos del canal de un rea menor del mapa de bits. destPoint:Point - Objeto Point de destino que representa la esquina superior izquierda del rea rectangular donde se situarn los nuevos datos del canal. Especifique un punto distinto de (0,0) si desea copiar los datos del canal de un rea a otra de la imagen de destino. sourceChannel:Number - El canal de origen. Utilice un valor del conjunto (1,2,4,8), que representan respectivamente los canales rojo, verde, azul y alfa, o una suma de los valores deseados. destChannel:Number - El canal de destino. Utilice un valor del conjunto (1,2,4,8), que representan respectivamente los canales rojo, verde, azul y alfa, o una suma de los valores deseados. Ejemplo En el ejemplo siguiente, se muestra cmo copiar un canal ARGB de origen desde un objeto BitmapData sobre s mismo en otra ubicacin:

fscommand2("SetSoftKeys"); import flash.display.BitmapData; import flash.geom.Rectangle; import flash.geom.Point; var myBitmapData:BitmapData = new BitmapData(100, 80, false, 0x00CCCCCC); var mc:MovieClip = this.createEmptyMovieClip("mc", this.getNextHighestDepth()); mc.attachBitmap(myBitmapData, this.getNextHighestDepth()); var myListener:Object = new Object (); myListener.onKeyDown = function () { var keyCode = Key.getCode (); if (keyCode == ExtendedKey.SOFT1) { // Handle left soft key event myBitmapData.copyChannel(myBitmapData, new Rectangle(0, 0, 50, 80), new Point(51, 0), 3, 1); } };
Vase tambin
copyPixels (mtodo BitmapData.copyPixels)

public copyPixels(sourceBitmap:BitmapData, sourceRect:Rectangle, destPoint:Point) : Void
Proporciona una rutina rpida para la manipulacin de pxeles entre imgenes sin efectos de color, rotacin ni expansin. Este mtodo copia un rea rectangular de una imagen de origen en un rea rectangular del mismo tamao en el punto de destino del objeto BitmapData de destino. Disponibilidad Flash Lite 3.1 Parmetros sourceBitmap:BitmapData - La imagen de mapa de bits de entrada desde la que se van a copiar pxeles. La imagen de origen puede ser otra instancia de BitmapData o puede hacer referencia a la instancia de BitmapData actual. sourceRect:Rectngulo - Rectngulo que define el rea de la imagen de origen que se va a utilizar como entrada. destPoint:Point - Punto de destino, que representa la esquina superior izquierda del rea rectangular donde se situarn los nuevos datos del canal. Ejemplo En el siguiente ejemplo se muestra cmo copiar pxeles de una instancia de BitmapData a otra.

fscommand2("SetSoftKeys"); import flash.display.BitmapData; import flash.geom.Rectangle; import flash.geom.Point; var bitmapData_1:BitmapData = new BitmapData(100, 80, false, 0x00CCCCCC); var bitmapData_2:BitmapData = new BitmapData(100, 80, false, 0x00FF0000); var mc_1:MovieClip = this.createEmptyMovieClip("mc", this.getNextHighestDepth()); mc_1.attachBitmap(bitmapData_1, this.getNextHighestDepth()); var mc_2:MovieClip = this.createEmptyMovieClip("mc", this.getNextHighestDepth()); mc_2.attachBitmap(bitmapData_2, this.getNextHighestDepth()); mc_2._x = 101; var myListener:Object = new Object (); myListener.onKeyDown = function () { var keyCode = Key.getCode (); if (keyCode == ExtendedKey.SOFT1) { // Handle left soft key event bitmapData_2.copyPixels(bitmapData_1, new Rectangle(0, 0, 50, 80), new Point(51, 0)); } else if (keyCode == ExtendedKey.SOFT2) { // Handle right soft key event bitmapData_1.copyPixels(bitmapData_2, new Rectangle(0, 0, 50, 80), new Point(51, 0)); } };
dispose (mtodo BitmapData.dispose)

public dispose() : Void
Libera memoria que se utiliza para almacenar el objeto BitmapData. Llame a myBitmapData.dispose() para definir la anchura y la altura de la imagen en 0. Una vez liberada la memoria de un objeto BitmapData, fallarn las llamadas de acceso a los mtodos y las propiedades de la instancia, que devolvern el valor -1. Disponibilidad Flash Lite 3.1 Ejemplo En el siguiente ejemplo se muestra cmo liberar la memoria de una instancia de BitmapData, lo que ocasiona que se borre la instancia.

import flash.display.BitmapData; var myBitmapData:BitmapData = new BitmapData(100, 80, false, 0x00CCCCCC); var mc:MovieClip = this.createEmptyMovieClip("mc", this.getNextHighestDepth()); mc.attachBitmap(myBitmapData, this.getNextHighestDepth()); var myListener:Object = new Object (); myListener.onKeyDown = function () { var keyCode = Key.getCode (); if (keyCode == ExtendedKey.SOFT1) { // Handle left soft key event myBitmapData.dispose() trace(myBitmapData.width); // -1 trace(myBitmapData.height); // -1 trace(myBitmapData.transparent); // 1 } };
draw (mtodo BitmapData.draw)

public draw(source:Object, [matrix:Matrix], [colorTransform:ColorTransform], [clipRect:Rectangle], [smooth:Boolean]) : Void
Dibuja un clip de pelcula o una imagen de origen en una imagen de destino, utilizando el procesador de vectores del reproductor de Flash Lite. Puede utilizar los objetos Matrix, ColorTransform y BlendMode junto con un objeto Rectangle de destino para controlar como se realiza la representacin. Tambin puede especificar si el mapa de bits se debe suavizar cuando se le aplique una escala (esto slo funciona si el objeto de origen es un objeto BitmapData). Este mtodo corresponde directamente al modo en que se dibujan los objetos con el procesador de vectores estndar para objetos en la interfaz de la herramienta de edicin. Un objeto MovieClip de origen no utiliza ninguna de sus transformaciones realizadas en el escenario para esta llamada. Se trata tal como se encuentra en la biblioteca o el archivo, sin transformacin matricial, transformacin de color ni modo de mezcla. Si desea dibujar el clip de pelcula utilizando sus propias propiedades de transformacin, puede utilizar su objeto Transform para pasarle las diferentes propiedades de transformacin. El parmetro blendMode no se admite en Flash Lite. Disponibilidad Flash Lite 3.1 Parmetros source:Object - Objeto BitmapData que se desea dibujar. matrix:Matrix [opcional] - Objeto Matrix utilizado para escalar, rotar o trasladar las coordenadas del mapa de bits. Si no se proporciona ningn objeto, no se transformar la imagen de mapa de bits. Si desea pasar este parmetro pero no quiere transformar la imagen, especifique una matriz identidad para este parmetro, que puede crear utilizando el constructor predeterminado new Matrix(). colorTransform:ColorTransform [opcional] - Objeto ColorTransform que puede utilizar para ajustar los valores de color del mapa de bits. Si no se proporciona ningn objeto, no se transformar los colores de la imagen de mapa de bits. Si desea pasar este parmetro pero no quiere transformar la imagen, especifique para este parmetro un objeto ColorTransform creado utilizando el constructor predeterminado new ColorTransform().

clipRect:Rectngulo [opcional] - Objeto Rectangle. Si no proporciona este valor, no se realizar ningn recorte. smooth:Boolean [opcional] - Valor booleano que determina si se suaviza un objeto BitmapData al escalarlo. El valor predeterminado es false. Ejemplo En el siguiente ejemplo, se muestra cmo dibujar desde una instancia de MovieClip de origen a un objeto BitmapData.
fscommand2("SetSoftKeys"); im p ort flash.displa y .BitmapData; import flash.geom . R e c t a n g l e ; impor t fl a sh. g e o m.M a tr i x; import flash .ge o m.Colo rTrans form; v ar myBi tmapDat a:Bit m apData = new BitmapDa ta(100, 80, fal s e, 0x0 0C CCCCC); var mc_1: Mov i eCli p = this .cre ateEmptyMo vieClip("m c ", this .getNextHighestDepth()); mc_1.a tta chB itmap (my Bit mapDa ta, th is . ge tNe xtH ig h es tDe pth () ) ; va r m c _2:MovieClip mc _ 2 ._x = 101; = cr eat eRe c t angle(50, 40, 0x FF0000);
va r myMatrix:Mat ri x = new Matrix ( ); myMatrix.ro tate(Math.PI/2) ; var translate M a trix:Matrix = n ew Mat rix(); tra nsl ate Matrix .trans lat e(7 0, 15) ; my Matr ix. con cat (transl at eMat rix ); var myCol orTr ans form: C olorTransfo rm = new C o lorTransf orm (0, 0, 1 , 1, 0, 0 , 255, 0); v ar blend Mode:String = "nor mal"; var m yRectangle:Rectangle = new Rectangle(0, 0, 100, 80); var smooth:Boolean = true; var myListener:Object = new Object (); myListener.onKeyDown = function () { var keyCode = Key.getCode (); if (keyCode == ExtendedKey.SOFT1) { // Handle left soft key event myBitmapData.draw(mc_2, myMatrix, myColorTransform, blendMode, myRectangle, smooth); } }; Key.addListener (myListener); function createRectangle(width:Number, height:Number, color:Number):MovieClip { var depth:Number = this.getNextHighestDepth(); var mc:MovieClip = this.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }
fillRect (mtodo BitmapData.fillRect)

public fillRect(rect:Rectangle, color:Number) : Void
Rellena un rea rectangular de pxeles con un determinado color ARGB.

Disponibilidad Flash Lite 3.1 Parmetros rect:Rectngulo - El rea rectangular que se va a rellenar. color:Number - El valor de color ARGB que rellena el rea. Los colores ARGB se especifican a menudo en formato hexadecimal, como 0xFF336699. Ejemplo En el siguiente ejemplo, se muestra cmo rellenar un rea definida por un objeto Rectangle dentro de un BitmapData con un color.
fscommand2("SetSoftKeys"); import flash.display.BitmapData; import flash.geom.Rectangle; var myBitmapData:BitmapData = new BitmapData(100, 80, false, 0x00CCCCCC); var mc:MovieClip = this.createEmptyMovieClip("mc", this.getNextHighestDepth()); mc.attachBitmap(myBitmapData, this.getNextHighestDepth()); var myListener:Object = new Object (); myListener.onKeyDown = function () { var keyCode = Key.getCode (); if (keyCode == ExtendedKey.SOFT1) { // Handle left soft key event myBitmapData.fillRect(new Rectangle(0, 0, 50, 40), 0x00FF0000); } };
Vase tambin
floodFill (mtodo BitmapData.floodFill)

public floodFill(x:Number, y:Number, color:Number) : Void
Realiza una operacin de relleno en una imagen empezando por una coordenada (x, y) y rellenando con un determinado color. El mtodo floodFill() es similar a la herramienta cubo de pintura que incorporan muchos programas de dibujo. El color es un color ARGB que contiene informacin alfa y de color. Disponibilidad Flash Lite 3.1 Parmetros x:Number - La coordenada x de la imagen. y:Number - La coordenada y de la imagen. color:Number - El color ARGB que se va a utilizar como relleno. Los colores ARGB suelen especificarse en formato hexadecimal, por ejemplo 0xFF336699.

Ejemplo En el siguiente ejemplo, se muestra cmo aplicar un relleno de color a una imagen a partir del punto donde el usuario hace clic con el ratn dentro de un objeto BitmapData.
fscommand2("SetSoftKeys"); import flash.display.BitmapData; import flash.geom.Rectangle; var myBitmapData:BitmapData = new BitmapData(100, 80, false, 0x00CCCCCC); var mc:MovieClip = this.createEmptyMovieClip("mc", this.getNextHighestDepth()); mc.attachBitmap(myBitmapData, this.getNextHighestDepth()); myBitmapData.fillRect(new Rectangle(0, 0, 50, 40), 0x00FF0000); var myListener:Object = new Object (); myListener.onKeyDown = function () { var keyCode = Key.getCode (); if (keyCode == ExtendedKey.SOFT1) { // Handle left soft key event myBitmapData.floodFill(_xmouse, _ymouse, 0x000000FF);} };
getColorBoundsRect (mtodo BitmapData.getColorBoundsRect)

public getColorBoundsRect(mask:Number, color:Number, [findColor:Boolean]) : Rectangle
Determina una regin rectangular que encierra completamente todos los pxeles de un determinado color dentro de la imagen de mapa de bits. Por ejemplo, si tiene una imagen de origen y desea determinar el rectngulo de la imagen que contiene un canal alfa distinto de cero, pase {mask: 0xFF000000, color: 0x00000000} como parmetros. Se buscarn en toda la imagen los lmites de los pxeles en los que (value & mask) != color. Para determinar el espacio blanco alrededor de una imagen, pase {mask: 0xFFFFFFFF, color: 0xFFFFFFFF} para buscar los lmites de los pxeles no blancos. Disponibilidad Flash Lite 3.1 Parmetros mask:Number - Valor de color hexadecimal. color:Number - Valor de color hexadecimal. findColor:Boolean [opcional] - Si el valor se establece como true, devuelve los lmites de un valor de color de una imagen. Si es false, devuelve los lmites de donde no existe este color en la imagen. El valor predeterminado es true. Valor devuelto Rectngulo - Regin de la imagen que es del color especificado. Ejemplo En el siguiente ejemplo, se muestra cmo determinar una regin rectangular que incluya completamente todos los pxeles de un determinado color dentro de la imagen de mapa de bits:

fscommand2("SetSoftKeys"); import flash.display.BitmapData; import flash.geom.Rectangle; var myBitmapData:BitmapData = new BitmapData(100, 80, false, 0x00CCCCCC); var mc:MovieClip = this.createEmptyMovieClip("mc", this.getNextHighestDepth()); mc.attachBitmap(myBitmapData, this.getNextHighestDepth()); myBitmapData.fillRect(new Rectangle(0, 0, 50, 40), 0x00FF0000); var myListener:Object = new Object (); myListener.onKeyDown = function () { var keyCode = Key.getCode (); if (keyCode == ExtendedKey.SOFT1) { // Handle left soft key event var colorBoundsRect:Rectangle = myBitmapData.getColorBoundsRect(0x00FFFFFF, 0x00FF0000, true); trace(colorBoundsRect); // (x=0, y=0, w=50, h=40) } }; Key.addListener (myListener);
getPixel (mtodo BitmapData.getPixel)

public getPixel(x:Number, y:Number) : Number
Devuelve un entero que representa un valor de pxel RGB de un objeto BitmapData en un punto especfico (x, y). El mtodo getPixel() devuelve un valor de pxel no multiplicado. No se devuelve informacin de alfa. Todos los pxeles de un objeto BitmapData se almacenan como valores de color premultiplicados. El pxel de imagen premultiplicado ya tiene los valores de canal de color rojo, verde y azul multiplicados por los datos alfa. Por ejemplo, si el valor alfa es cero, los canales RGB tambin son cero, independientemente de sus valores no multiplicados. Esta prdida de datos puede ocasionar algunos problemas al realizar operaciones. Todos los mtodos de Flash Lite Player toman y devuelven valores no multiplicados. La representacin interna de pxeles se convierte a no multiplicada antes de devolverla como valor. Durante una operacin dada, el valor de pxel se premultiplica antes de establecer el pxel de imagen en bruto. Disponibilidad Flash Lite 3.1 Parmetros x:Number - La posicin x del pxel. y:Number - La posicin y del pxel. Valor devuelto Number - Nmero que representa un valor de pxel RGB. Si las coordenadas (x, y) se encuentran fuera de los lmites de la imagen, se devuelve 0. Ejemplo En el siguiente ejemplo, se utiliza el mtodo getPixel() para recuperar el valor RGB de un pxel en una determinada posicin x e y.

import flash.display.BitmapData; var myBitmapData:BitmapData = new BitmapData(100, 80, false, 0x00CCCCCC); var mc:MovieClip = this.createEmptyMovieClip("mc", this.getNextHighestDepth()); mc.attachBitmap(myBitmapData, this.getNextHighestDepth()); trace("0x" + myBitmapData.getPixel(0, 0).toString(16)); // 0xcccccc
Vase tambin
getPixel32 (mtodo BitmapData.getPixel32)
getPixel32 (mtodo BitmapData.getPixel32)

public getPixel32(x:Number, y:Number) : Number
Devuelve un valor de color ARGB que contiene datos del canal alfa y datos de RGB. Este mtodo es similar a getPixel(), que devuelve un color RGB sin datos del canal alfa. Disponibilidad Flash Lite 3.1 Parmetros x:Number - La posicin x del pxel. y:Number - La posicin y del pxel. Valor devuelto Number - Nmero que representa un valor de pxel ARGB. Si las coordenadas (x, y) se encuentran fuera de los lmites de la imagen, se devuelve 0. Si el mapa de bits se cre como un mapa de bits opaco y no como uno transparente, este mtodo devolver un cdigo de error de -1. Ejemplo En el siguiente ejemplo, se utiliza el mtodo getPixel32() para recuperar el valor ARGB de un pxel en una determinada posicin x e y:

import flash.display.BitmapData; var myBitmapData:BitmapData = new BitmapData(100, 80, true, 0xFFAACCEE); var mc:MovieClip = this.createEmptyMovieClip("mc", this.getNextHighestDepth()); mc.attachBitmap(myBitmapData, this.getNextHighestDepth()); var alpha:String = (myBitmapData.getPixel32(0, 0) >> 24 & 0xFF).toString(16); trace(">> alpha: " + alpha); // ff var red:String = (myBitmapData.getPixel32(0, 0) >> 16 & 0xFF).toString(16); trace(">> red: " + red); // aa var green:String = (myBitmapData.getPixel32(0, 0) >> 8 & 0xFF).toString(16); trace(">> green: " + green); // cc var blue:String = (myBitmapData.getPixel32(0, 0) & 0xFF).toString(16); trace(">> blue: " + blue); // ee trace("0x" + alpha + red + green + blue); // 0xffaaccee
Vase tambin
getPixel (mtodo BitmapData.getPixel)
height (propiedad BitmapData.height)

public height : Number [read-only]
Altura de la imagen de mapa de bits, expresada en pxeles. Disponibilidad Flash Lite 3.1 Ejemplo En el siguiente ejemplo, se muestra que la propiedad height de la instancia de BitmapData es de slo lectura intentando establecerla sin xito:
import flash.display.BitmapData; var myBitmapData:BitmapData = new BitmapData(100, 80, false, 0x00CCCCCC); var mc:MovieClip = this.createEmptyMovieClip("mc", this.getNextHighestDepth()); mc.attachBitmap(myBitmapData, this.getNextHighestDepth()); trace(myBitmapData.height); // 80 myBitmapData.height = 999; trace(myBitmapData.height); // 80
hitTest (mtodo BitmapData.hitTest)

public hitTest(firstPoint:Point, firstAlphaThreshold:Number, secondObject:Object, [secondBitmapPoint:Point], [secondAlphaThreshold:Number]) : Boolean

Detecta la zona activa a nivel de pxeles entre una imagen de mapa de bits y un punto, un rectngulo u otra imagen de mapa de bits. Cuando se realiza la prueba de zona activa no se tiene en cuenta expansin, rotacin ni ninguna otra transformacin de ninguno de los objetos. Si una imagen es opaca, se considerar un rectngulo totalmente opaco para este mtodo. Las dos imgenes deben ser transparentes para realizar pruebas de zona activa a nivel de pxeles que tengan en cuenta la transparencia. Cuando se comprueban dos imgenes transparentes, los parmetros de umbral alfa controlan qu valores de canal, de 0 a 255, se consideran opacos. Disponibilidad Flash Lite 3.1 Parmetros firstPoint:Point - Punto que define una ubicacin de pxel en la instancia actual de BitmapData. firstAlphaThreshold:Number - Valor de canal alfa ms alto que se considera opaco para esta prueba. secondObject:Object - Un objeto Rectangle, Point, o BitmapData. secondBitmapPoint:Point [opcional] - Punto que define una ubicacin de pxel en el segundo objeto BitmapData. Utilice este parmetro nicamente cuando el valor de secondObject sea un objeto BitmapData. secondAlphaThreshold:Number [opcional] - Valor de canal alfa ms alto que se considera opaco en el segundo objeto BitmapData. Utilice este parmetro nicamente cuando el valor de secondObject sea un objeto BitmapData, y los dos objetos BitmapData sean transparentes. Valor devuelto Boolean - Valor booleano. Si hay una colisin, se devuelve el valor true; en caso contrario, false. Ejemplo En el siguiente ejemplo, se muestra cmo determinar si un objeto BitmapData est colisionando con un MovieClip.

import flash.display.BitmapData; import flash.geom.Point; var myBitmapData:BitmapData = new BitmapData(100, 80, false, 0x00CCCCCC); var mc_1:MovieClip = this.createEmptyMovieClip("mc", this.getNextHighestDepth()); mc_1.attachBitmap(myBitmapData, this.getNextHighestDepth()); var mc_2:MovieClip = createRectangle(20, 20, 0xFF0000); var destPoint:Point = new Point(myBitmapData.rectangle.x, myBitmapData.rectangle.y); var currPoint:Point = new Point(); mc_1.onEnterFrame = function() { currPoint.x = mc_2._x; currPoint.y = mc_2._y; if(myBitmapData.hitTest(destPoint, 255, currPoint)) { trace(">> Collision at x:" + currPoint.x + " and y:" + currPoint.y); } } mc_2.startDrag(true); function createRectangle(width:Number, height:Number, color:Number):MovieClip { var depth:Number = this.getNextHighestDepth(); var mc:MovieClip = this.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }
loadBitmap (mtodo BitmapData.loadBitmap)

public static loadBitmap(id:String) : BitmapData
Devuelve un nuevo objeto BitmapData que contiene una representacin de imagen de mapa de bits del smbolo identificado por un determinado ID de vinculacin en la biblioteca. Disponibilidad Flash Lite 3.1 Parmetros id:String - ID de vinculacin de un smbolo de la biblioteca. Valor devuelto BitmapData - Representacin de imagen de mapa de bits del smbolo. Ejemplo El siguiente ejemplo carga un mapa de bits con el ID de vinculacin libraryBitmap de la biblioteca. Debe asociarlo a un objeto MovieClip para darle una representacin visual.

import flash.display.BitmapData; var linkageId:String = "libraryBitmap"; var myBitmapData:BitmapData = BitmapData.loadBitmap(linkageId); trace(myBitmapData instanceof BitmapData); // true var mc:MovieClip = this.createEmptyMovieClip("mc", this.getNextHighestDepth()); mc.attachBitmap(myBitmapData, this.getNextHighestDepth());
merge (mtodo BitmapData.merge)

public merge(sourceBitmap:BitmapData, sourceRect:Rectangle, destPoint:Rectangle, redMult:Number, greenMult:Number, blueMult:Number, alphaMult:Number) : Void
Realiza una mezcla por canal de una imagen de origen a una imagen de destino. Se utiliza la frmula siguiente para cada canal:
new red dest = (red source * redMult) + (red dest * (256 - redMult) / 256;
Los valores de redMult, greenMult, blueMult y alphaMult son los multiplicadores empleados para cada canal de color. Su rango vlido va de 0 a 256. Disponibilidad Flash Lite 3.1 Parmetros sourceBitmap:BitmapData - La imagen de mapa de bits de entrada que se va a utilizar. La imagen de origen puede ser otro objeto BitmapData o puede hacer referencia al objeto BitmapData actual. sourceRect:Rectngulo - Rectngulo que define el rea de la imagen de origen que se va a utilizar como entrada. destPoint:Point - Punto de la imagen de destino (la instancia de BitmapData actual) que corresponde a la esquina superior izquierda del rectngulo de origen. redMult:Number - Nmero por el que se multiplica el valor del canal rojo. greenMult:Number - Nmero por el que se multiplica el valor del canal verde. blueMult:Number - Nmero por el que se multiplica el valor del canal azul. alphaMult:Number - Nmero por el que se multiplica el valor de transparencia alfa. Ejemplo En el siguiente ejemplo se muestra cmo mezclar parte de un BitmapData con otro.

fscommand2("SetSoftKeys"); import flash.display.BitmapData; import flash.geom.Rectangle; import flash.geom.Point; var bitmapData_1:BitmapData = new BitmapData(100, 80, false, 0x00CCCCCC); var bitmapData_2:BitmapData = new BitmapData(100, 80, false, 0x00FF0000); var mc_1:MovieClip = this.createEmptyMovieClip("mc", this.getNextHighestDepth()); mc_1.attachBitmap(bitmapData_1, this.getNextHighestDepth()); var mc_2:MovieClip = this.createEmptyMovieClip("mc", this.getNextHighestDepth()); mc_2.attachBitmap(bitmapData_2, this.getNextHighestDepth()); mc_2._x = 101; var myListener:Object = new Object (); myListener.onKeyDown = function () { var keyCode = Key.getCode (); if (keyCode == ExtendedKey.SOFT1) { // Handle left soft key event bitmapData_1.merge(bitmapData_2, new Rectangle(0, 0, 50, 40), new Point(25, 20), 128, 0, 0, 0); } }; Key.addListener (myListener);
rectangle (propiedad BitmapData.rectangle)

public rectangle : Rectangle [read-only]
Rectngulo que define el tamao y la ubicacin de la imagen de mapa de bits. Las partes superior e izquierda del rectngulo son 0; el ancho y el alto son iguales al ancho y al alto en pxeles del objeto BitmapData. Disponibilidad Flash Lite 3.1 Ejemplo En el siguiente ejemplo, se muestra que la propiedad rectangle de la instancia de Bitmap es de slo lectura intentando establecerla sin xito:
import flash.display.BitmapData; import flash.geom.Rectangle; var myBitmapData:BitmapData = new BitmapData(100, 80, false, 0x00CCCCCC); var mc:MovieClip = this.createEmptyMovieClip("mc", this.getNextHighestDepth()); mc.attachBitmap(myBitmapData, this.getNextHighestDepth()); trace(myBitmapData.rectangle); // (x=0, y=0, w=100, h=80) myBitmapData.rectangle = new Rectangle(1, 2, 4, 8); trace(myBitmapData.rectangle); // (x=0, y=0, w=100, h=80)
setPixel (mtodo BitmapData.setPixel)

public setPixel(x:Number, y:Number, color:Number) : Void

Establece el color de un nico pxel de un objeto BitmapData. Durante esta operacin se mantiene el valor del canal alfa actual del pxel de la imagen. El valor del parmetro de color RGB se trata como un valor de color no multiplicado. Disponibilidad Flash Lite 3.1 Parmetros x:Number - La posicin x del pxel cuyo valor cambia. y:Number - La posicin y del pxel cuyo valor cambia. color:Number - Color RGB al que se va a asignar el pxel. Vase tambin
getPixel (mtodo BitmapData.getPixel), setPixel32 (mtodo BitmapData.setPixel32)
setPixel32 (mtodo BitmapData.setPixel32)

public setPixel32(x:Number, y:Number, color:Number) : Void
Establece los valores de color y transparencia alfa de un solo pxel de un objeto BitmapData. Este mtodo es similar a setPixel(); la diferencia principal radica en que el mtodo setPixel32() toma un valor de color ARGB que contiene informacin del canal alfa. Disponibilidad Flash Lite 3.1 Parmetros x:Number - La posicin x del pxel cuyo valor cambia. y:Number - La posicin y del pxel cuyo valor cambia. color:Number - Color ARGB al que se va a asignar el pxel. Si ha creado un mapa de bits opaco (que no sea transparente), se ignorar la parte de transparencia de este valor de color. Vase tambin
getPixel32 (mtodo BitmapData.getPixel32), setPixel (mtodo BitmapData.setPixel)
transparent (propiedad BitmapData.transparent)

public transparent : Boolean [read-only]
Define si la imagen de mapa de bits admite transparencia por pxel. Slo puede definir este valor cuando cree un objeto BitmapData pasando true para el parmetro transparent. Tras crear un objeto BitmapData, puede comprobar si admite transparencia por pxel comprobando si el valor de la propiedad transparent es true. Disponibilidad Flash Lite 3.1
width (propiedad BitmapData.width)

public width : Number [read-only]

Anchura de la imagen de mapa de bits, expresada en pxeles. Disponibilidad Flash Lite 3.1
Boolean
Object | +-Boolean public class Boolean extends Object
La clase Boolean es un objeto envolvente con la misma funcionalidad que el objeto Boolean estndar de JavaScript. Utilice la clase Boolean para recuperar el tipo de datos simple o la representacin de cadena de un objeto booleano. Debe utilizar el constructor new Boolean() para crear un objeto booleano antes de llamar a sus mtodos. Disponibilidad Flash Lite 2.0 Resumen de propiedades Propiedades heredadas de la clase Object
Firma Boolean([valor:Objec t]) Descripcin Crea un objeto Boolean.
Resumen de mtodos
Modificadores Firma toString() : String Descripcin Devuelve la representacin de cadena ("true" o "false") del objeto Boolean. Devuelve true si el tipo de valor simple del objeto Boolean especificado es true; en cualquier otro caso, devuelve false.
valueOf() : Boolean


Constructor Boolean
public Boolean([value:Object])
Crea un objeto Boolean. Si omite el parmetro value, el objeto Boolean se inicializa con el valor false. Si especifica un valor para el parmetro value, el mtodo lo evaluar y devolver el resultado como un valor booleano conforme a las reglas de la funcin Boolean(). Disponibilidad Flash Lite 2.0 Parmetros valor:Object [opcional] - Cualquier expresin. El valor predeterminado es false. Ejemplo El cdigo siguiente crea un nuevo objeto Boolean vaco llamado myBoolean:
var myBoolean:Boolean = new Boolean();
toString (mtodo Boolean.toString)

Devuelve la representacin de cadena ("true" o "false") del objeto Boolean. Disponibilidad Flash Lite 2.0 Valor devuelto String - Una cadena; "true" o "false". Ejemplo Este ejemplo crea una variable de tipo booleano y utiliza toString() para convertir el valor en una cadena para utilizarla en la sentencia trace:
var myBool:Boolean = true; trace("The value of the Boolean myBool is: " + myBool.toString()); myBool = false; trace("The value of the Boolean myBool is: " + myBool.toString());
valueOf (mtodo Boolean.valueOf)

public valueOf() : Boolean
Devuelve true si el tipo de valor simple del objeto Boolean especificado es true; en cualquier otro caso, devuelve false. Disponibilidad Flash Lite 2.0 Valor devuelto Boolean - Valor booleano.

Ejemplo El ejemplo siguiente muestra cmo funciona este mtodo y tambin que el tipo de valor simple de un objeto Boolean nuevo es false:
var x:Boolean = new Boolean(); trace(x.valueOf()); // false x = (6==3+3); trace(x.valueOf()); // true
Button
Object | +-Button public class Button extends Object
Todos los smbolos de botn son instancias del objeto Button. Puede asignar a un botn un nombre de instancia en el inspector de propiedades y utilizar los mtodos y propiedades de la clase Button para manipular botones con ActionScript. Los nombres de instancias de Button se muestran en el explorador de pelculas y en el cuadro de dilogo Insertar ruta de destino del panel Acciones. Disponibilidad Flash Lite 2.0 Vase tambin
Object
Modificadores Propiedad _alpha:Number enabled:Boolean _focusrect:Boolean Descripcin Valor de transparencia alfa del botn. Valor booleano que especifica si est activado un botn. Valor booleano que especifica si un botn debe mostrar un rectngulo amarillo a su alrededor cuando tiene seleccin de entrada. Altura del botn, expresada en pxeles. Desfasada desde Flash Player 7. Esta propiedad est desfasada y en su lugar debe utilizarse Button._quality. Especifica el nivel de suavizado que se aplica al archivo SWF actual. _name:String _parent:MovieClip Nombre de instancia del botn. Referencia al clip de pelcula o un objeto que contiene el clip de pelcula u objeto actual. Propiedad (global); establece o recupera la calidad de representacin utilizada por un archivo SWF.
_height:Number _highquality:Number
_quality:String

Modificadores
Propiedad _rotation:Number
Descripcin Giro del botn, expresado en grados, con respecto a su orientacin original. Especifica el nmero de segundos que un sonido debe almacenarse en el bfer antes de que comience a reproducirse sin interrupcin. Especifica si hay un botn incluido en el orden de tabulacin automtico. Permite personalizar el orden de tabulacin de los objetos de un archivo SWF. Devuelve la ruta de destino de la instancia de botn.
_soundbuftime:Number
tabEnabled:Boolean
tabIndex:Number
_target:String [slo lectura] trackAsMenu:Boolean
Valor booleano que indica si otros botones o clips de pelcula pueden recibir un evento de liberacin de un ratn o lpiz stylus. Recupera la URL del archivo SWF que cre el botn. Valor booleano que indica si el botn es visible. Anchura del botn, expresada en pxeles. Entero que establece la coordenada x de un botn relativa a las coordenadas locales del clip de pelcula principal. Devuelve la coordenada x de la posicin del ratn relativa al botn. Escala horizontal del botn aplicada desde el punto de registro del botn, expresada como porcentaje. Coordenada y del botn relativa a las coordenadas locales del clip de pelcula principal. Devuelve la coordenada y de la posicin del ratn relativa al botn. Escala vertical del botn aplicada desde el punto de registro del botn, expresada como porcentaje.
_url:String [slo lectura] _visible:Boolean _width:Number _x:Number
_xmouse:Number [slo lectura] _xscale:Number
_y:Number
_ymouse:Number [slo lectura] _yscale:Number

Resumen de eventos
Evento onDragOut =
function() {}
Descripcin Se invoca cuando el usuario hace clic en el botn y despus arrastra el puntero fuera del botn. Se invoca cuando el usuario hace clic fuera del botn y despus arrastra el puntero encima del botn. Se invoca cuando un botn se ha seleccionado con el teclado y se presiona una tecla.
onDragOver = function() {} onKeyDown =

function() {}

Evento onKeyUp =
function() {}
Descripcin Se invoca cuando un botn tiene la seleccin de entrada y se suelta una tecla.
onKillFocus =
function(newFocus: Object) {}
Se invoca cuando un botn deja de estar seleccionado con el teclado.
onPress = function()
{}
Se invoca cuando se presiona un botn.
onRelease = function() {} onReleaseOutside =

function() {}
Se invoca cuando se suelta un botn.
Se invoca cuando se suelta el botn del ratn mientras el puntero est fuera del botn despus de haber pulsado el botn del ratn mientras el puntero estaba dentro del botn. Se invoca cuando el botn deja de estar seleccionado.
onRollOut =
function() {}
onRollOver =
function() {}
Se invoca cuando el botn se selecciona.
onSetFocus =
function(oldFocus: Object) {}
Se invoca cuando un botn queda seleccionado con el teclado.
Resumen de mtodos
Modificadores Firma getDepth() : Number Descripcin Devuelve la profundidad de la instancia de botn.

_alpha (propiedad MovieClip._alpha)

public _alpha : Number
Valor de transparencia alfa del botn especificado por my_btn. Los valores vlidos son los comprendidos entre 0 (totalmente transparente) y 100 (totalmente opaco). El valor predeterminado es 100. Los objetos existentes en un botn que tenga configurado _alpha con el valor 0 continuarn activos aunque no sean visibles. Disponibilidad Flash Lite 2.0 Ejemplo El cdigo siguiente establece la propiedad _alpha de un botn llamado myBtn_btn al 50% cuando el usuario hace clic en el botn. Primero, aada una instancia Button al escenario. A continuacin, asigne a la instancia el nombre myBtn_btn. Por ltimo, con el fotograma 1 seleccionado, introduzca el cdigo siguiente en el panel Acciones:

myBtn_btn.onRelease = function(){ this._alpha = 50; };
Vase tambin
_alpha (propiedad MovieClip._alpha), _alpha (propiedad TextField._alpha)
enabled (propiedad Button.enabled)

public enabled : Boolean
Valor booleano que especifica si est activado un botn. Cuando un botn est desactivado (la propiedad enabled est configurada como false), el botn est visible pero no se puede hacer clic en l. El valor predeterminado es true. Esta propiedad resulta til si se desea desactivar parte de la navegacin; por ejemplo, se recomienda desactivar un botn de la pgina mostrada actualmente para que no se pueda hacer clic en l y no pueda volver a cargarse la pgina. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente demuestra cmo desactivar y activar el clic de los botones. Dos botones, myBtn1_btn y myBtn2_btn,, se encuentran en el escenario y se aade el cdigo ActionScript siguiente de modo que no se pueda hacer clic en el botn myBtn2_btn. Primero, aada dos instancias Button al escenario. A continuacin, asigne a las instancias los nombres myBtn1_btn y myBtn2_btn. Por ltimo, introduzca el siguiente cdigo en el fotograma 1 para activar o desactivar los botones.
myBtn1_btn.enabled = true; myBtn2_btn.enabled = false; //button code // the following function will not get called // because myBtn2_btn.enabled was set to false myBtn1_btn.onRelease = function() { trace( "you clicked : " + this._name ); }; myBtn2_btn.onRelease = function() { trace( "you clicked : " + this._name ); };
_focusrect (propiedad Button._focusrect)

public _focusrect : Boolean
Valor booleano que especifica si un botn debe mostrar un rectngulo amarillo a su alrededor cuando tiene seleccin de entrada. Esta propiedad puede sustituir a la propiedad global _focusrect. De manera predeterminada, la propiedad _focusrect de una instancia de botn es nula (null); la instancia de botn no sustituye a la propiedad global _focusrect. Si la propiedad _focusrect de una instancia de botn se establece como true o false, sta sustituir a la configuracin de la propiedad global _focusrect para la instancia de botn en cuestin. En archivos SWF de Flash Player 4 y Flash Player 5, la propiedad _focusrect controla la propiedad global
_focusrect. Se trata de un valor booleano. Este comportamiento cambi en Flash Player 6 y versiones posteriores
para permitir la personalizacin de la propiedad _focusrect en un clip de pelcula concreto.

Si la propiedad _focusrect se estable como false, la navegacin con el teclado para ese botn quedar limitada a la tecla Tabulador. Todas las dems teclas, incluidas Intro y las teclas de flecha, se pasan por alto. Para restablecer el desplazamiento completo con el teclado, es preciso configurar _focusrect con el valor true. Nota: en el reproductor Flash Lite 2.0, si se desactiva la propiedad _focusrect (es decir, Button.focusRect es false), el botn recibe todos los eventos. Este comportamiento ha cambiado con respecto a Flash Lite Player, ya que si la propiedad _focusrect se desactiva, el botn recibe los eventos rollOver y rollOut pero no recibe los eventos press y release. Tambin en Flash Lite 2.0, se puede cambiar el color del rectngulo de seleccin utilizando el comando SetFocusRectColor de la funcin fscommand2. Este comportamiento tambin ha cambiado con respecto a Flash Lite Player, donde el color del rectngulo de seleccin nicamente puede ser amarillo. Disponibilidad Flash Lite 2.0 Ejemplo Este ejemplo muestra cmo ocultar el rectngulo amarillo alrededor de una instancia de botn especificada en un archivo SWF cuando est seleccionada en una ventana del navegador. Cree tres botones llamados myBtn1_btn, myBtn2_btn y myBtn3_btn, y aada el cdigo ActionScript siguiente al fotograma 1 de la lnea de tiempo:
myBtn2_btn._focusrect = false;
getDepth (mtodo Button.getDepth)

public getDepth() : Number
Devuelve la profundidad de la instancia de botn. Cada clip de pelcula, botn y campo de texto tiene asociada una profundidad exclusiva que determina cmo aparece el objeto delante o detrs de otros objetos. Los objetos con mayor profundidad aparecen delante. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Profundidad de la instancia de botn. Ejemplo Si crea myBtn1_btn y myBtn2_btn en el escenario, podr realizar un seguimiento de su profundidad empleando el cdigo ActionScript siguiente:
trace(myBtn1_btn.getDepth()); trace(myBtn2_btn.getDepth());
Si carga un archivo SWF llamado buttonMovie.swf en este documento, podr realizar un seguimiento de la profundidad de un botn, myBtn4_btn, dentro de ese archivo SWF empleando otro botn del SWF principal:
this.createEmptyMovieClip("myClip_mc", 999); myClip_mc.loadMovie("buttonMovie.swf"); myBtn3_btn.onRelease = function(){ trace(myClip_mc.myBtn4_btn.getDepth()); };

Quiz haya observado que dos de estos botones tienen el mismo valor de profundidad, uno en el archivo SWF principal y otro en el archivo SWF cargado. Esto resulta engaoso, porque buttonMovie.swf se carg con una profundidad de 999, lo que significa que el botn que contiene tambin tendr una profundidad de 999 en relacin con los botones del archivo SWF principal. Tenga en cuenta que cada clip de pelcula tiene su propio orden z interno, lo que significa que cada clip de pelcula tiene su propio conjunto de valores de profundidad. Los dos botones pueden tener el mismo valor de profundidad, pero los valores slo tienen significado en relacin con otros objetos del mismo orden z. En este caso, los botones tienen el mismo valor de profundidad, pero los valores hacen referencia a clips de pelcula distintos: el valor de profundidad del botn del archivo SWF principal hace referencia al orden z de la lnea de tiempo principal, mientras que el valor de profundidad del botn del archivo SWF cargado se refiere al orden z interno del clip de pelcula myClip_mc. Vase tambin
getDepth (mtodo MovieClip.getDepth), getDepth (mtodo TextField.getDepth), getInstanceAtDepth (mtodo MovieClip.getInstanceAtDepth)
_height (propiedad Button._height)

public _height : Number
Altura del botn, expresada en pxeles. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente establece la altura y anchura de un botn llamado my_btn con unos valores especificados.
my_btn._width = 500; my_btn._height = 200;
_highquality (propiedad Button._highquality)

public _highquality : Number
Desfasada desde Flash Player 7. Esta propiedad est desfasada y en su lugar debe utilizarse Button._quality. Especifica el nivel de suavizado que se aplica al archivo SWF actual. Especifique 2 (mejor calidad) para aplicar alta calidad con el suavizado de mapa de bits siempre activado. Especifique 1 (alta calidad) para aplicar e; suavizado; esto suaviza los mapas de bits si el archivo SWF no contiene animacin y es el valor predeterminado. Especifique 0 (baja calidad) para evitar el suavizado. Disponibilidad Flash Lite 2.0 Ejemplo Aada una instancia de botn al escenario y asgnele el nombre myBtn_btn. Dibuje un valo en el escenario utilizando la herramienta valo que tiene un color de trazo y relleno. Seleccione el fotograma 1 y aada el cdigo ActionScript siguiente a travs del panel Acciones:
myBtn_btn.onRelease = function() { myBtn_btn._highquality = 0; };

Si se hace clic en myBtn_btn, el trazo del crculo adquiere un aspecto dentado. En su lugar puede aadir el cdigo ActionScript siguiente para que afecte el SWF globalmente:
_quality = 0;
Vase tambin
_quality (propiedad Button._quality, propiedad), propiedad _quality, propiedad
_name (propiedad Button._name)

public _name : String
Nombre de instancia del botn especificado por my_btn. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento de todos los nombres de instancia de cualquier instancia Button que se encuentre en la lnea de tiempo actual de un archivo SWF.
for (i in this) { if (this[i] instanceof Button) { trace(this[i]._name); } }
onDragOut (controlador Button.onDragOut)

onDragOut = function() {}
Se invoca cuando el usuario presiona el botn del ratn encima del botn y despus arrastra el puntero fuera del botn. Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Nota: el controlador de eventos onDragOut es compatible con Flash Lite 2.0 nicamente si se cumple System.capabilities.hasMouse es true o System.capabilities.hasStylus es true. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente demuestra cmo se pueden ejecutar las sentencias cuando se arrastra el puntero fuera de un botn. Cree un botn llamado my_btn en el escenario e introduzca el cdigo ActionScript siguiente en un fotograma de la lnea de tiempo:
my_btn.onDragOut = function() { trace("onDragOut: "+this._name); }; my_btn.onDragOver = function() { trace("onDragOver: "+this._name); };

onDragOver (controlador Button.onDragOver)

onDragOver = function() {}
Se invoca cuando el usuario presiona el botn del ratn fuera del botn y despus arrastra el puntero encima del botn. Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Nota: el controlador de eventos onDragOver es compatible con Flash Lite 2.0 nicamente si se cumple System.capabilities.hasMouse es true o System.capabilities.hasStylus es true. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente define una funcin del controlador onDragOver que enva una sentencia trace() al panel Salida. Cree un botn llamado my_btn en el escenario e introduzca el cdigo ActionScript siguiente en la lnea de tiempo:
my_btn.onDragOut = function() { trace("onDragOut: "+this._name); }; my_btn.onDragOver = function() { trace("onDragOver: "+this._name); };
Cuando pruebe el archivo SWF, arrastre el puntero fuera de la instancia de botn. A continuacin, mientras pulsa el botn del ratn, vuelva a arrastrarlo sobre la instancia de botn. Observe que el panel Salida realiza un seguimiento de los movimientos. Vase tambin
onDragOut (controlador Button.onDragOut)
onKeyDown (controlador Button.onKeyDown)

onKeyDown = function() {}
Se invoca cuando un botn se ha seleccionado con el teclado y se presiona una tecla. El controlador de eventos onKeyDown se invoca sin parmetros. Puede utilizar los mtodosKey.getAscii() y Key.getCode() para determinar qu tecla ha presionado el usuario. Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se define una funcin que enva texto al panel Salida para el controlador onKeyDown. Cree un botn llamado my_btn en el escenario e introduzca el cdigo ActionScript siguiente en un fotograma de la lnea de tiempo:

my_btn.onKeyDown = function() { trace("onKeyDown: "+this._name+" (Key: "+getKeyPressed()+")"); }; function getKeyPressed():String { var theKey:String; switch (Key.getAscii()) { case Key.BACKSPACE : theKey = "BACKSPACE"; break; case Key.SPACE : theKey = "SPACE"; break; default : theKey = chr(Key.getAscii()); } return theKey; }
Seleccione Control > Probar pelcula para probar el archivo SWF. Seleccione Control > Deshabilitar mtodos abreviados de teclado en el entorno de prueba. A continuacin, pulse la tecla Tabulador hasta que el botn quede seleccionado (aparecer un rectngulo amarillo alrededor de la instancia my_btn) y comience a pulsar teclas en el teclado. Cuando se pulsan, las teclas se muestran en el panel Salida. Vase tambin
onKeyUp (controlador Button.onKeyUp), getAscii (mtodo Key.getAscii), getCode (mtodo Key.getCode)
onKeyUp (controlador Button.onKeyUp)

onKeyUp = function() {}
Se invoca cuando un botn tiene la seleccin de entrada y se suelta una tecla. El controlador de eventos onKeyUp se invoca sin parmetros. Puede utilizar los mtodosKey.getAscii() y Key.getCode() para determinar qu tecla ha presionado el usuario. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se define una funcin que enva texto al panel Salida para el controlador onKeyDown. Cree un botn llamado my_btn en el escenario e introduzca el cdigo ActionScript siguiente en un fotograma de la lnea de tiempo:

my_btn.onKeyDown = function() { trace("onKeyDown: "+this._name+" (Key: "+getKeyPressed()+")"); }; my_btn.onKeyUp = function() { trace("onKeyUp: "+this._name+" (Key: "+getKeyPressed()+")"); }; function getKeyPressed():String { var theKey:String; switch (Key.getAscii()) { case Key.BACKSPACE : theKey = "BACKSPACE"; break; case Key.SPACE : theKey = "SPACE"; break; default : theKey = chr(Key.getAscii()); } return theKey; }
Pulse Control+Intro para comprobar el archivo SWF. Seleccione Control > Deshabilitar mtodos abreviados de teclado en el entorno de prueba. A continuacin, pulse la tecla Tabulador hasta que el botn quede seleccionado (aparecer un rectngulo amarillo alrededor de la instancia my_btn) y comience a pulsar teclas en el teclado. Cuando se pulsan, las teclas se muestran en el panel Salida. Vase tambin
onKeyDown (controlador Button.onKeyDown), getAscii (mtodo Key.getAscii), getCode (mtodo Key.getCode)
onKillFocus (controlador Button.onKillFocus)

onKillFocus = function(newFocus:Object) {}
Se invoca cuando un botn deja de estar seleccionado con el teclado. El controlador onKillFocus recibe un parmetro, newFocus, que es un objeto que representa al nuevo objeto seleccionado. Si no hay ningn objeto seleccionado con el teclado, newFocus contendr el valor null (nulo). Disponibilidad Flash Lite 2.0 Parmetros newFocus:Object - El objeto que recibe la seleccin. Ejemplo El ejemplo siguiente demuestra cmo pueden ejecutarse sentencias cuando un botn deja de estar seleccionado. Cree una instancia de botn llamada my_btn en el escenario y aada el cdigo ActionScript siguiente al fotograma 1 de la lnea de tiempo:

this.createTextField("output_txt", this.getNextHighestDepth(), 0, 0, 300, 200); output_txt.wordWrap = true; output_txt.multiline = true; output_txt.border = true; my_btn.onKillFocus = function() { output_txt.text = "onKillFocus: "+this._name+newline+output_txt.text; };
Pruebe el archivo SWF en una ventana del navegador y utilice la tecla Tabulador para desplazarse por los elementos de la ventana. Cuando la instancia de botn deja de estar seleccionada, se enva texto al campo de texto output_txt.
onPress (controlador Button.onPress)

onPress = function() {}
Se invoca cuando se presiona un botn. Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se define una funcin que enva una sentencia trace() al panel Salida para el controlador onPress:
my_btn.onPress = function () { trace ("onPress called"); };
onRelease (controlador Button.onRelease)

onRelease = function() {}
Se invoca cuando se suelta un botn. Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se define una funcin que enva una sentencia trace() al panel Salida para el controlador onRelease:
my_btn.onRelease = function () { trace ("onRelease called"); };
onReleaseOutside (controlador Button.onReleaseOutside)

onReleaseOutside = function() {}
Se invoca cuando se suelta el botn del ratn mientras el puntero est fuera del botn despus de haber pulsado el botn del ratn mientras el puntero estaba dentro del botn. Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos.

Nota: el controlador de eventos onReleaseOutside es compatible con Flash Lite 2.0 nicamente si se cumple System.capabilities.hasMouse es true o System.capabilities.hasStylus es true. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se define una funcin que enva una sentencia trace() al panel Salida para el controlador onReleaseOutside:
my_btn.onReleaseOutside = function () { trace ("onReleaseOutside called"); };
onRollOut (controlador Button.onRollOut)

onRollOut = function() {}
Se invoca cuando el botn deja de estar seleccionado. Esto puede ocurrir cuando el usuario hace clic en otro botn o rea fuera del botn seleccionado. Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se define una funcin que enva una sentencia trace() al panel Salida para el controlador onRollOut:
my_btn.onRollOut = function () { trace ("onRollOut called"); };
onRollOver (controlador Button.onRollOver)

onRollOver = function() {}
Se invoca cuando el botn se selecciona. Esto puede ocurrir cuando el usuario hace clic en otro botn fuera del botn seleccionado. Se invoca cuando el puntero se desplaza sobre el rea de un botn. Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se define una funcin que enva una sentencia trace() al panel Salida para el controlador onRollOver:
my_btn.onRollOver = function () { trace ("onRollOver called"); };

onSetFocus (controlador Button.onSetFocus)

onSetFocus = function(oldFocus:Object) {}
Se invoca cuando un botn queda seleccionado con el teclado. El parmetro oldFocus es el objeto que deja de estar seleccionado. Por ejemplo, si el usuario presiona la tecla Tabulador para desplazar la seleccin del teclado de un campo de texto a un botn, oldFocus contendr la instancia del campo de texto. Si anteriormente no haba ningn objeto seleccionado con el teclado, oldFocus contendr un valor null (nulo). Disponibilidad Flash Lite 2.0 Parmetros oldFocus:Object - El objeto que deja de estar seleccionado. Ejemplo El ejemplo siguiente demuestra cmo ejecutar sentencias cuando el usuario de un archivo SWF desplaza la seleccin de un botn a otro. Cree dos botones, btn1_btn y btn2_btn, e introduzca el cdigo ActionScript siguiente en el fotograma 1 de la lnea de tiempo:
Selection.setFocus(btn1_btn); trace(Selection.getFocus()); btn2_btn.onSetFocus = function(oldFocus) { trace(oldFocus._name + "lost focus"); };
Compruebe el archivo SWF pulsando Control+Intro. Seleccione Control > Deshabilitar mtodos abreviados de teclado si no est seleccionado. La seleccin pasar a btn1_btn. Cuando btn1_btn deja de estar seleccionado y pasa a estarlo btn2_btn, se muestra informacin en el panel Salida.
_parent (propiedad Button._parent)

public _parent : MovieClip
Referencia al clip de pelcula o un objeto que contiene el clip de pelcula u objeto actual. El objeto actual es el que contiene el cdigo ActionScript que hace referencia a _parent. Utilice _parent para especificar una ruta de acceso relativa a los clips de pelcula u objetos que se encuentran por encima del clip de pelcula u objeto actual. Puede utilizar _parent para subir mltiples niveles en la lista de visualizacin, como se muestra a continuacin:
this._parent._parent._alpha = 20;
Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente, un botn llamado my_btn se sita dentro de un clip de pelcula llamado my_mc. El cdigo siguiente muestra cmo utilizar la propiedad _parent para obtener una referencia al clip de pelcula my_mc:
trace(my_mc.my_btn._parent);
El panel Salida muestra lo siguiente:

_level0.my_mc

Vase tambin
_parent (propiedad MovieClip._parent), _target (propiedad MovieClip._target), _root, propiedad
_quality (propiedad Button._quality, propiedad)

public _quality : String
Propiedad (global); establece o recupera la calidad de representacin utilizada por un archivo SWF. Las fuentes de dispositivo siempre se muestran dentadas y, por consiguiente, no se ven afectadas por la propiedad _quality. La propiedad _quality puede configurarse con los siguientes valores:
"LOW" Calidad de representacin baja. No se suavizan ni los grficos ni los mapas de bits. "MEDIUM" Calidad de representacin media. Los grficos se suavizan empleando una cuadrcula de 2 x 2 pxeles,
pero los mapas de bits no se suavizan. Esta configuracin resulta adecuada para pelculas que no contengan texto.
"HIGH" Calidad de representacin alta. Los grficos se suavizan empleando una cuadrcula de 4 x 4 pxeles, mientras
que los mapas de bits se suavizan si la pelcula es esttica. Esta es la calidad de representacin predeterminada de Flash. Nota: aunque puede especificar esta propiedad para un objeto Button, se trata en realidad de una propiedad global, por lo que puede especificar su valor simplemente como _quality. Disponibilidad Flash Lite 2.0 Ejemplo Este ejemplo establece como LOW la calidad de representacin de un botn llamado my_btn:
my_btn._quality = "LOW";
_rotation (propiedad Button._rotation)

public _rotation : Number
Giro del botn, expresado en grados, con respecto a su orientacin original. Los valores comprendidos entre 0 y 180 representan un giro en el sentido de las agujas del reloj, mientras que los comprendidos entre 0 y -180 representan un giro en sentido contrario al de las agujas del reloj. Los valores situados fuera de este rango se suman o restan de 360 para obtener un valor que s est comprendido en el rango. Por ejemplo, la sentencia my_btn._rotation = 450 es igual que my_btn._rotation = 90. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente gira dos botones en el escenario. Cree dos botones en el escenario llamados control_btn y my_btn. Procure que my_btn no sea completamente redondo, para poder ver cmo gira. A continuacin, introduzca el cdigo ActionScript siguiente en el fotograma 1 de la lnea de tiempo:
var control_btn:Button; var my_btn:Button; control_btn.onRelease = function() { my_btn._rotation += 10; };

Ahora puede crear otro botn en el escenario llamado myOther_btn, procurando que no sea completamente redondo (para poder ver cmo gira). Introduzca el cdigo ActionScript siguiente en el fotograma 1 de la lnea de tiempo:
var myOther_btn:Button; this.createEmptyMovieClip("rotater_mc", this.getNextHighestDepth()); rotater_mc.onEnterFrame = function() { myOther_btn._rotation += 2; };
Vase tambin
_rotation (propiedad MovieClip._rotation), _rotation (propiedad TextField._rotation)
_soundbuftime (propiedad Button._soundbuftime)

public _soundbuftime : Number
Especifica el nmero de segundos que un sonido debe almacenarse en el bfer antes de que comience a reproducirse sin interrupcin. Nota: aunque puede especificar esta propiedad para un objeto Button, se trata en realidad de una propiedad global que se aplica a todos los sonidos cargados y puede especificar su valor simplemente como _soundbuftime. Al establecer esta propiedad para un objeto Button en realidad se establece la propiedad global. Para ms informacin y ver un ejemplo, consulte_soundbuftime. Disponibilidad Flash Lite 2.0 Vase tambin
tabEnabled (propiedad Button.tabEnabled)

public tabEnabled : Boolean
Especifica si my_btn est incluido en el orden de tabulacin automtico. De manera predeterminada, tiene el valor undefined. Si la propiedad tabEnabled es undefined o true, el objeto se incluir en el orden de tabulacin automtico. Si la propiedad tabIndex tambin est configurada con un valor, el objeto se incluir tambin en el orden de tabulacin personalizado. Si tabEnabled tiene el valor false, el objeto no se incluir en el orden de tabulacin automtico ni en el personalizado aunque se establezca la propiedad tabIndex. Disponibilidad Flash Lite 2.0 Ejemplo El cdigo ActionScript siguiente se utiliza para establecer la propiedad tabEnabled como false para un botn de cuatro. Sin embargo, los cuatro botones (one_btn, two_btn, three_btn, y four_btn) se colocan en un orden de tabulacin personalizado utilizando tabIndex. Aunque se establece tabIndex para three_btn, no se incluye three_btn en un orden de tabulacin personalizado o automtico, ya que tabEnabled se establece como false para esa instancia. Para establecer el orden de tabulacin para los cuatro botones, aada el cdigo ActionScript siguiente al fotograma 1 de la lnea de tiempo:

three_btn.tabEnabled = false; two_btn.tabIndex = 1; four_btn.tabIndex = 2; three_btn.tabIndex = 3; one_btn.tabIndex = 4;
Vase tambin
tabIndex (propiedad Button.tabIndex), tabEnabled (propiedad MovieClip.tabEnabled), tabEnabled (propiedad TextField.tabEnabled)
tabIndex (propiedad Button.tabIndex)

public tabIndex : Number
Permite personalizar el orden de tabulacin de los objetos de un archivo SWF. Puede establecer la propiedad tabIndex de un botn, un clip de pelcula o una instancia de campo de texto; la configuracin predeterminada es undefined (no definido). Si algn objeto mostrado actualmente en el archivo SWF contiene una propiedad tabIndex, se desactivar el orden de tabulacin automtico y el orden de tabulacin se calcular a partir de las propiedades tabIndex de los objetos del archivo SWF. El orden de tabulacin personalizado slo incluye objetos que tienen propiedades tabIndex. La propiedad tabIndex puede ser un entero no negativo. Los objetos se ordenan conforme a lo que indiquen las propiedades tabIndex y en orden ascendente. Un objeto que tenga un valor tabIndex de 1 preceder a otro objeto que tenga un valor tabIndex de 2. Si hay dos objetos con el mismo valor tabIndex, el que precede al otro en el orden de tabulacin es undefined. El orden de tabulacin personalizado definido por la propiedad tabIndex es flat (plano o no jerrquico). Esto significa que no se tienen en cuenta las relaciones jerrquicas entre los objetos del archivo SWF. Todos los objetos del archivo SWF con propiedades tabIndex tendrn su lugar en el orden de tabulacin, que se determinar por el orden de los valores de tabIndex. Si dos objetos tienen el mismo valor de tabIndex, el que va en primer lugar no estar definido ( undefined). No debe utilizar el mismo valor de tabIndex para varios objetos. Disponibilidad Flash Lite 2.0 Ejemplo El cdigo ActionScript siguiente se utiliza para establecer la propiedad tabEnabled como false para un botn de cuatro. Sin embargo, los cuatro botones (one_btn, two_btn, three_btn, y four_btn) se colocan en un orden de tabulacin personalizado utilizando tabIndex. Aunque se establece tabIndex para three_btn, no se incluye three_btn en un orden de tabulacin personalizado o automtico, ya que tabEnabled se establece como false para esa instancia. Para establecer el orden de tabulacin para los cuatro botones, aada el cdigo ActionScript siguiente al fotograma 1 de la lnea de tiempo:
three_btn.tabEnabled = false; two_btn.tabIndex = 1; four_btn.tabIndex = 2; three_btn.tabIndex = 3; one_btn.tabIndex = 4;

Vase tambin
tabEnabled (propiedad Button.tabEnabled), tabChildren (propiedad MovieClip.tabChildren), tabEnabled (propiedad MovieClip.tabEnabled), tabIndex (propiedad MovieClip.tabIndex), tabIndex (propiedad TextField.tabIndex)
_target (propiedad Button._target)

public _target : String [read-only]
Devuelve la ruta de destino de la instancia de botn especificada por my_btn. Disponibilidad Flash Lite 2.0 Ejemplo Aada una instancia de botn al escenario con el nombre my_btn y aada el cdigo siguiente al fotograma 1 de la lnea de tiempo:
trace(my_btn._target); //displays /my_btn
Seleccione my_btn y convirtalo en un clip de pelcula. Asigne al clip de pelcula nuevo el nombre de instancia my_mc. Elimine el cdigo ActionScript existente en el fotograma 1 de la lnea de tiempo y sustityalo por:
my_mc.my_btn.onRelease = function(){ trace(this._target); //displays /my_mc/my_btn };
Para convertir la notacin con barras en notacin con punto, cambie el ejemplo del cdigo anterior por el siguiente:
my_mc.my_btn.onRelease = function(){ trace(eval(this._target)); //displays _level0.my_mc.my_btn };
Este cdigo permite acceder a mtodos y parmetros del objeto de destino, como:
my_mc.my_btn.onRelease = function(){ var target_btn:Button = eval(this._target); trace(target_btn._name); //displays my_btn };
Vase tambin
_target (propiedad MovieClip._target)
trackAsMenu (propiedad Button.trackAsMenu)

public trackAsMenu : Boolean
Valor booleano que indica si otros botones o clips de pelcula pueden recibir un evento de liberacin de un ratn o lpiz stylus. Si arrastra el puntero del ratn o un lpiz stylus encima de un botn y lo suelta sobre un segundo botn, el evento onRelease se registrar para el segundo botn. Esto permite crear mens para el segundo botn. Puede establecer la propiedad trackAsMenu en cualquier botn u objeto del clip de pelcula. Si no ha definido la propiedad trackAsMenu, el comportamiento predeterminado es false. Puede cambiar la propiedad trackAsMenu en cualquier momento; el botn modificado adoptar de inmediato el nuevo comportamiento.

Nota: la propiedad trackAsMenu es compatible con Flash Lite 2.0 nicamente si se cumple System.capabilities.hasMouse es true o System.capabilities.hasStylus es true. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente demuestra cmo realizar el seguimiento de dos botones como un men. Site dos instancias de botn llamadas one_btn y two_btn en el escenario. Introduzca el cdigo ActionScript siguiente en la lnea de tiempo:
var one_btn:Button; var two_btn:Button; one_btn.trackAsMenu = true; two_btn.trackAsMenu = true; one_btn.onRelease = function() { trace("clicked one_btn"); }; two_btn.onRelease = function() { trace("clicked two_btn"); };
Para comprobar el archivo SWF, haga clic en one_btn en el escenario, manteniendo pulsado el botn del ratn y liberndolo sobre two_btn. A continuacin, marque como comentario las dos lneas de ActionScript que contienen trackAsMenu y pruebe el archivo SWF otra vez para ver la diferencia en el comportamiento del botn. Vase tambin
trackAsMenu (propiedad MovieClip.trackAsMenu)
_url (propiedad Button._url)

public _url : String [read-only]
Recupera la URL del archivo SWF que cre el botn. Disponibilidad Flash Lite 2.0 Ejemplo Cree dos instancias de botn en el escenario, llamadas one_btn y two_btn. Introduzca el siguiente cdigo ActionScript en el fotograma 1 de la lnea de tiempo:

var one_btn:Button; var two_btn:Button; this.createTextField("output_txt", 999, 0, 0, 100, 22); output_txt.autoSize = true; one_btn.onRelease = function() { trace("clicked one_btn"); trace(this._url); }; two_btn.onRelease = function() { trace("clicked "+this._name); var url_array:Array = this._url.split("/"); var my_str:String = String(url_array.pop()); output_txt.text = unescape(my_str); };
Cuando haga clic en cada botn, se mostrar en el panel Salida el nombre del archivo SWF que contiene los botones.
_visible (propiedad Button._visible)

public _visible : Boolean
Valor booleano que indica si el botn especificado por my_btn es visible. Los botones no visibles (que tienen la propiedad _visible configurada como false) se desactivan. Disponibilidad Flash Lite 2.0 Ejemplo Cree dos botones en el escenario con los nombres de instancia myBtn1_btn y myBtn2_btn. Introduzca el siguiente cdigo ActionScript en el fotograma 1 de la lnea de tiempo:
myBtn1_btn.onRelease = function() { this._visible = false; trace("clicked "+this._name); }; myBtn2_btn.onRelease = function() { this._alpha = 0; trace("clicked "+this._name); };
Observe que puede seguir haciendo clic en myBtn2_btn despus de establecer el alfa en 0. Vase tambin
_visible (propiedad MovieClip._visible), _visible (propiedad TextField._visible)
_width (propiedad Button._width)

public _width : Number
Anchura del botn, expresada en pxeles. Disponibilidad Flash Lite 2.0

Ejemplo El ejemplo siguiente incrementa la propiedad width de un botn llamado my_btn, y muestra la anchura en el panel Salida. Introduzca el siguiente cdigo ActionScript en el fotograma 1 de la lnea de tiempo:
my_btn.onRelease = function() { trace(this._width); this._width ~= 1.1; };
Vase tambin
_width (propiedad MovieClip._width)
_x (Button._x, propiedad)
public _x : Number
Entero que establece la coordenada x de un botn relativa a las coordenadas locales del clip de pelcula principal. Si un botn se encuentra en la lnea de tiempo principal, su sistema de coordenadas hace referencia a la esquina superior izquierda del escenario como (0, 0). Si el botn est dentro de un clip de pelcula que incluye transformaciones, el botn estar en el sistema de coordenadas local del clip de pelcula en el que est contenido. Por consiguiente, en el caso de un clip de pelcula con un giro de 90 grados en sentido contrario al de las agujas del reloj, el botn contenido hereda un sistema de coordenadas con un giro de 90 grados en sentido contrario al de las agujas del reloj. Las coordenadas del botn hacen referencia a la posicin del punto de registro. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente establece las coordenadas de my_btn en 0 en el escenario. Cree un botn llamado my_btn e introduzca el cdigo ActionScript siguiente en el fotograma 1 de la lnea de tiempo:
my_btn._x = 0; my_btn._y = 0;
Vase tambin
_xscale (propiedad Button._xscale), _y (propiedad Button._y, propiedad), _yscale (propiedad Button._yscale)
_xmouse (propiedad Button._xmouse)

public _xmouse : Number [read-only]
Devuelve la coordenada x de la posicin del ratn relativa al botn. Nota: la propiedad _xmouse es compatible con Flash Lite 2.0 nicamente si se cumple System.capabilities.hasMouse es true o System.capabilities.hasStylus es true. Disponibilidad Flash Lite 2.0

Ejemplo El ejemplo siguiente muestra la coordenada x de la posicin del ratn para el escenario y un botn llamado my_btn que se sita en el escenario. Introduzca el siguiente cdigo ActionScript en el fotograma 1 de la lnea de tiempo:
this.createTextField("mouse_txt", 999, 5, 5, 150, 40); mouse_txt.html = true; mouse_txt.wordWrap = true; mouse_txt.border = true; mouse_txt.autoSize = true; mouse_txt.selectable = false; // var mouseListener:Object = new Object(); mouseListener.onMouseMove = function() { var table_str:String = "<textformat tabstops='[50,100]'>"; table_str += "Stage\t"+"x:"+_xmouse+"\t"+"y:"+_ymouse+newline; table_str += "Button\t"+"x:"+my_btn._xmouse+"\t"+"y:"+my_btn._ymouse+newline; table_str += "</textformat>"; mouse_txt.htmlText = table_str; }; Mouse.addListener(mouseListener);
Vase tambin
_ymouse (propiedad Button._ymouse)
_xscale (propiedad Button._xscale)

public _xscale : Number
Escala horizontal del botn aplicada desde el punto de registro del botn, expresada como porcentaje. El punto de registro predeterminado es (0,0). La escala del sistema de coordenadas local afecta a la configuracin de las propiedades de _x e _y, que se definen en pxeles. Por ejemplo, si se aplica una escala del 50% al clip de pelcula principal, la configuracin de la propiedad _x desplazar un objeto situado en el botn la mitad de pxeles que si el archivo SWF tuviera una escala del 100%. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente escala un botn llamado my_btn. Cuando hace clic y suelta el botn, crece un 10% en los ejes x e y. Introduzca el siguiente cdigo ActionScript en el fotograma 1 de la lnea de tiempo:
my_btn.onRelease = function(){ this._xscale ~= 1.1; this._yscale ~= 1.1; };
Vase tambin
_x (Button._x, propiedad), _y (propiedad Button._y, propiedad), _yscale (propiedad Button._yscale)
_y (propiedad Button._y, propiedad)

public _y : Number

Coordenada y del botn relativa a las coordenadas locales del clip de pelcula principal. Si un botn se encuentra en la lnea de tiempo principal, su sistema de coordenadas hace referencia a la esquina superior izquierda del escenario como (0, 0). Si el botn est dentro de otro clip de pelcula que incluye transformaciones, el botn estar en el sistema de coordenadas local del clip de pelcula en el que est contenido. Por consiguiente, en el caso de un clip de pelcula con un giro de 90 grados en sentido contrario al de las agujas del reloj, el botn contenido hereda un sistema de coordenadas con un giro de 90 grados en sentido contrario al de las agujas del reloj. Las coordenadas del botn hacen referencia a la posicin del punto de registro. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente establece las coordenadas de my_btn en 0 en el escenario. Cree un botn llamado my_btn e introduzca el cdigo ActionScript siguiente en el fotograma 1 de la lnea de tiempo:
my_btn._x = 0; my_btn._y = 0;
Vase tambin
_x (Button._x, propiedad), _xscale (propiedad Button._xscale), _yscale (propiedad Button._yscale)
_ymouse (propiedad Button._ymouse)

public _ymouse : Number [read-only]
Devuelve la coordenada y de la posicin del ratn relativa al botn. Nota: la propiedad _ymouse es compatible con Flash Lite 2.0 nicamente si se cumple
System.capabilities.hasMouse es true o System.capabilities.hasStylus es true.
Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente muestra la coordenada x de la posicin del ratn para el escenario y un botn llamado my_btn que se sita en el escenario. Introduzca el siguiente cdigo ActionScript en el fotograma 1 de la lnea de tiempo:

this.createTextField("mouse_txt", 999, 5, 5, 150, 40); mouse_txt.html = true; mouse_txt.wordWrap = true; mouse_txt.border = true; mouse_txt.autoSize = true; mouse_txt.selectable = false; // var mouseListener:Object = new Object(); mouseListener.onMouseMove = function() { var table_str:String = "<textformat tabstops='[50,100]'>"; table_str += "Stage\t"+"x:"+_xmouse+"\t"+"y:"+_ymouse+newline; table_str += "Button\t"+"x:"+my_btn._xmouse+"\t"+"y:"+my_btn._ymouse+newline; table_str += "</textformat>"; mouse_txt.htmlText = table_str; }; Mouse.addListener(mouseListener);
Vase tambin
_xmouse (propiedad Button._xmouse)
_yscale (propiedad Button._yscale)

public _yscale : Number
Escala vertical del botn aplicada desde el punto de registro del botn, expresada como porcentaje. El punto de registro predeterminado es (0,0). Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente escala un botn llamado my_btn. Cuando hace clic y suelta el botn, crece un 10% en los ejes x e y. Introduzca el siguiente cdigo ActionScript en el fotograma 1 de la lnea de tiempo:
my_btn.onRelease = function(){ this._xscale ~= 1.1; this._yscale ~ 1.1; };
Vase tambin
_y (propiedad Button._y, propiedad), _x (Button._x, propiedad), _xscale (propiedad Button._xscale)
Object | +-System.capabilities public class capabilities extends Object

La clase Capabilities determina la capacidad del sistema y del reproductor que alojan un archivo SWF, lo que permite adaptar el contenido a los diferentes formatos. Por ejemplo, la pantalla de un dispositivo mvil es distinta a la de un equipo. Con el fin de ofrecer el contenido adecuado al mayor nmero posible de usuarios, puede utilizar el objeto System.capabilities para determinar el tipo de dispositivo de que dispone un usuario. Luego podr indicar al servidor que enve archivos SWF diferentes en funcin de las capacidades del dispositivo o indicar al archivo SWF que modifique su presentacin segn las capacidades del dispositivo. Puede enviar informacin de prestaciones utilizando el mtodo HTTP GET o POST. En el siguiente ejemplo se muestra una cadena para un dispositivo mvil:
que indica una orientacin de pantalla normal que se ejecuta en un idioma no determinado que se ejecuta en el sistema operativo Symbian7.0sSeries60V2 que est configurado de tal modo que el usuario no puede acceder al disco duro, a la cmara ni al micrfono que tiene el reproductor Flash Lite como versin oficial para el que el reproductor Flash Lite no admite el desarrollo ni la reproduccin de aplicaciones de difusin en
pantalla para su ejecucin a travs de Flash Media Server
que no admite la impresin en el dispositivo en el que el reproductor Flash Lite se ejecuta en un dispositivo mvil que admite vdeo incorporado.
undefinedScreenOrientation=normal language=xu OS=Symbian7.0sSeries60V2 localFileReadDisable=true avHardwareDisable=true isDebugger=false hasScreenBroadcast=false hasScreenPlayback=false hasPrinting=false hasEmbeddedVideo=true
La mayora de la propiedades del objeto System.capabilities son de slo lectura. Disponibilidad Flash Lite 2.0 Resumen de propiedades
Modificadores
static
Propiedad audioMIMETypes:Array [slo lectura]
Descripcin Devuelve una matriz de tipos MIME para cdecs de audio compatibles con un dispositivo mvil.
static
avHardwareDisable:Boole Valor booleano que especifica si el acceso a la cmara y al an [slo lectura] micrfono del usuario ha sido prohibido (true) o autorizado ( false) administrativamente. has4WayKeyAS:Boolean [slo lectura] Valor booleano que devuelve true si el reproductor Flash Lite ejecuta el cdigo ActionScript asociado a los controladores de eventos de teclas que, a su vez, estn asociados a las teclas izquierda, derecha, arriba y abajo.
static

Modificadores
static
Propiedad hasAccessibility:Boolean [slo lectura]
Descripcin Valor booleano que da como resultado true si el reproductor se est ejecutando en un entorno que admite la comunicacin entre Flash Lite Player y las ayudas de accesibilidad; en caso contrario, da como resultado false. Especifica si el sistema tiene capacidades de audio.
static
hasAudio:Boolean [slo lectura] hasAudioEncoder:Boolea n [slo lectura] hasCMIDI:Boolean [slo lectura]
static
Especifica si Flash Lite Player puede codificar un flujo de audio.
static
Devuelve true si el dispositivo mvil puede reproducir datos de sonido en formato de audio CMIDI.
static
hasCompoundSound:Boo Devuelve true si el reproductor Flash Lite puede procesar lean [slo lectura] datos de sonido compuestos. hasDataLoading:Boolean [slo lectura] Devuelve true si el reproductor Flash Lite puede cargar dinmicamente datos adicionales mediante llamadas a funciones especficas. Devuelve true si el reproductor Flash Lite puede enviar mensajes de correo electrnico con el comando GetURL de ActionScript. Valor booleano que indica si el dispositivo mvil admite o no vdeo incorporado. Devuelve true si el dispositivo mvil permite restablecer o reasignar etiquetas de teclas programables o controlar eventos a partir de dichas teclas. Devuelve true si el dispositivo mvil puede reproducir datos de sonido en formato de audio MFI. Devuelve true si el dispositivo mvil puede reproducir datos de sonido en formato de audio MIDI. Devuelve true si el dispositivo mvil puede enviar mensajes MMS con el comando GetURLde ActionScript. Indica si el dispositivo mvil enva eventos relacionados con el ratn a un reproductor Flash Lite. Especifica si el dispositivo mvil dispone de un decodificador de MP3. Valor booleano que da como resultado true si el reproductor se est ejecutando en un dispositivo mvil que admite impresin; en caso contrario, da como resultado false. Devuelve true si el reproductor Flash Lite puede procesar cdigo ActionScript asociado a todas las teclas de un teclado occidental estndar (QWERTY), incluida la tecla RETROCESO. Valor booleano que da como resultado true si el reproductor admite el desarrollo de aplicaciones de difusin de pantallas para su ejecucin a travs de Flash Media Server; en caso contrario, da como resultado false. Valor booleano que da como resultado true si el reproductor admite la reproduccin de aplicaciones de difusin de pantallas que se estn ejecutando a travs de Flash Media Server; en caso contrario, da como resultado false.
static
static
hasEmail:Boolean [slo lectura]
static
hasEmbeddedVideo:Bool ean [slo lectura] hasMappableSoftKeys:Bo olean
static
static
hasMFI:Boolean [slo lectura] hasMIDI:Boolean [slo lectura] hasMMS:Boolean [slo lectura] hasMouse:Boolean [slo lectura] hasMP3:Boolean [slo lectura] hasPrinting:Boolean [slo lectura]
static
static
static
static
static
static
hasQWERTYKeyboard:Bo olean [slo lectura]
static
hasScreenBroadcast:Bool ean [slo lectura]
static
hasScreenPlayback:Boole an [slo lectura]

Modificadores
static
Propiedad hasSharedObjects:Boolea n [slo lectura]
Descripcin Devuelve true si el contenido Flash Lite que se reproduce en una aplicacin puede acceder a la versin Flash Lite de los objetos compartidos. Devuelve true si el dispositivo mvil puede reproducir datos de sonido en formato de audio SMAF. Indica si el dispositivo mvil puede enviar mensajes SMS con el comando GetURL de ActionScript. Valor booleano que da como resultado true si el reproductor es capaz de reproducir un flujo de audio; en caso contrario, da como resultado false.
static
hasSMAF:Boolean [slo lectura] hasSMS:Number [slo lectura] hasStreamingAudio:Bool ean [slo lectura]
static
static
static
hasStreamingVideo:Boole Valor booleano que indica si el reproductor es capaz de an [slo lectura] reproducir vdeo sin interrupcin. hasStylus:Boolean [slo lectura] hasVideoEncoder:Boolea n [slo lectura] hasXMLSocket:Number [slo lectura] imageMIMETypes:Array [slo lectura] Indica si el dispositivo mvil admite eventos relacionados con el lpiz stylus. Especifica si Flash Lite Player puede codificar un flujo de vdeo.
static
static
static
Indica si la aplicacin host admite sockets XML.
static
Devuelve una matriz que contiene todos los tipos MIME con los que la funcin loadMovie y los cdecs del dispositivo mvil son compatibles para poder procesar imgenes.
static
isDebugger:Boolean [slo Valor booleano que especifica si el reproductor es de una lectura] versin lanzada oficialmente (false) o una versin especial de depuracin ( true). language:String [slo lectura] Indica el idioma del sistema en el que se est ejecutando el reproductor.
static
static
localFileReadDisable:Bool Valor booleano que indica si el acceso de lectura al disco duro ean [slo lectura] del usuario ha sido prohibido (true) o autorizado ( false) administrativamente. MIMETypes:Array [slo lectura] Devuelve una matriz que contiene todos los tipos MIME compatibles con la funcin loadMovie y los objetos Sound y Video. Cadena que indica el sistema operativo actual. Esta variable de miembro del objeto System.capabilities indica la orientacin actual de la pantalla. Entero que indica la resolucin horizontal mxima de la pantalla. Entero que indica la resolucin vertical mxima de la pantalla.
static
static static
os:String [slo lectura] screenOrientation:String [slo lectura] screenResolutionX:Numb er [slo lectura] screenResolutionY:Numb er [slo lectura] softKeyCount:Number [slo lectura] version:String [slo lectura] videoMIMETypes:Array [slo lectura]
static
static
static
Indica el nmero de teclas programables reasignables compatibles con el dispositivo mvil. Cadena que contiene la informacin de plataforma y versin de Flash Lite Player (por ejemplo, "WIN 7,1,0,0"). Indica todos los tipos MIME para vdeo compatibles con los cdecs del dispositivo mvil.
static
static



audioMIMETypes (propiedad capabilities.audioMIMETypes)

public static audioMIMETypes : Array [read-only]
Devuelve una matriz de tipos MIME para cdecs de audio compatibles con un dispositivo mvil. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.audioMIMETypes);
avHardwareDisable (propiedad capabilities.avHardwareDisable)

public static avHardwareDisable : Boolean [read-only]
Valor booleano que especifica si el acceso a la cmara y al micrfono del usuario ha sido prohibido (true) o autorizado ( false) administrativamente. La cadena de servidor es AVD. Nota: en Flash Lite 2.0, el valor devuelto es siempre true. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.avHardwareDisable);
has4WayKeyAS (propiedad capabilities.has4WayKeyAS)

public static has4WayKeyAS : Boolean [read-only]

Valor booleano que devuelve true si el reproductor Flash Lite ejecuta el cdigo ActionScript asociado a los controladores de eventos de teclas que, a su vez, estn asociados a las teclas izquierda, derecha, arriba y abajo. En caso contrario, esta propiedad devuelve false. Si el valor de esta variable es true, al presionar una de las teclas de cuatro direcciones, el reproductor primero busca un controlador para dicha tecla. Si no se encuentra ninguno, Flash controla el desplazamiento. Sin embargo, si se encuentra un controlador de eventos, no se produce la navegacin correspondiente a esa tecla. En otras palabras, la presencia de un controlador de pulsacin de teclas para una tecla hacia abajo desactiva la posibilidad de desplazarse hacia abajo. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.has4WayKeyAS);
hasAccessibility (propiedad capabilities.hasAccessibility)

public static hasAccessibility : Boolean [read-only]
Valor booleano que da como resultado true si el reproductor se est ejecutando en un entorno que admite la comunicacin entre Flash Lite Player y las ayudas de accesibilidad; en caso contrario, da como resultado false. La cadena de servidor es ACC. Nota: en Flash Lite 2.0, el valor devuelto es siempre false. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.hasAccessibility);
hasAudio (propiedad capabilities.hasAudio)

public static hasAudio : Boolean [read-only]
Especifica si el sistema tiene capacidades de audio. Valor booleano que da como resultado true si el reproductor se est ejecutando en un sistema con prestaciones de audio; en caso contrario, da como resultado false. La cadena de servidor es A. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:

trace(System.capabilities.hasAudio);
hasAudioEncoder (propiedad capabilities.hasAudioEncoder)

public static hasAudioEncoder : Boolean [read-only]
Especifica si Flash Lite Player puede codificar un flujo de audio. Valor booleano que da como resultado true si el reproductor permite codificar un flujo de audio, como, por ejemplo, el procedente de un micrfono; en caso contrario, da como resultado false. La cadena de servidor es AE. Nota: en Flash Lite 2.0, el valor devuelto es siempre false. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.hasAudioEncoder);
hasCMIDI (propiedad capabilities.hasCMIDI)

public static hasCMIDI : Boolean [read-only]
Devuelve true si el dispositivo mvil puede reproducir datos de sonido en formato de audio CMIDI. En caso contrario, esta propiedad devuelve false. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.hasCMIDI);
hasCompoundSound (propiedad capabilities.hasCompoundSound)

public static hasCompoundSound : Boolean [read-only]
Devuelve true si el reproductor Flash Lite puede procesar datos de sonido compuestos. De lo contrario, devuelve false. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:

trace(System.capabilities.hasCompoundSound);
hasDataLoading (propiedad capabilities.hasDataLoading)

public static hasDataLoading : Boolean [read-only]
Devuelve true si el reproductor Flash Lite puede cargar dinmicamente datos adicionales mediante llamadas a funciones especficas. Puede llamar a las siguientes funciones especficas:
loadMovie() loadMovieNum() loadVariables() loadVariablesNum() XML.parseXML() Sound.loadSound() MovieClip.loadVariables() MovieClip.loadMovie() MovieClipLoader.loadClip() LoadVars.load() LoadVars.sendAndLoad()
En caso contrario, esta propiedad devuelve false. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.hasDataLoading);
hasEmail (propiedad capabilities.hasEmail)

public static hasEmail : Boolean [read-only]
Devuelve true si el reproductor Flash Lite puede enviar mensajes de correo electrnico con el comando GetURL de ActionScript. En caso contrario, esta propiedad devuelve false. Disponibilidad Flash Lite 2.0

Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.hasEmail);
hasEmbeddedVideo (propiedad capabilities.hasEmbeddedVideo)

public static hasEmbeddedVideo : Boolean [read-only]
Valor booleano que indica si el dispositivo mvil admite o no vdeo incorporado. Nota: la propiedad hasEmbeddedVideo siempre es true en Flash Lite 2.0 y Flash Lite 2.1, indicando la compatibilidad de la biblioteca con el vdeo de dispositivo. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.hasEmbeddedVideo);
hasMappableSoftKeys (propiedad capabilities.hasMappableSoftKeys)

public static hasMappableSoftKeys : Boolean
Devuelve true si el dispositivo mvil permite restablecer o reasignar etiquetas de teclas programables o controlar eventos a partir de dichas teclas. De lo contrario, devuelve false. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.hasMappableSoftKeys);
hasMFI (propiedad capabilities.hasMFI)

public static hasMFI : Boolean [read-only]
Devuelve true si el dispositivo mvil puede reproducir datos de sonido en formato de audio MFI. En caso contrario, esta propiedad devuelve false. Disponibilidad Flash Lite 2.0

trace(System.capabilities.hasMFI);
hasMIDI (propiedad capabilities.hasMIDI)

public static hasMIDI : Boolean [read-only]
Devuelve true si el dispositivo mvil puede reproducir datos de sonido en formato de audio MIDI. En caso contrario, esta propiedad devuelve false. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.hasMIDI);
hasMMS (propiedad capabilities.hasMMS)

public static hasMMS : Boolean [read-only]
Devuelve true si el dispositivo mvil puede enviar mensajes MMS con el comando GetURL de ActionScript. En caso contrario, esta propiedad devuelve false. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.hasMMS);
hasMouse (propiedad capabilities.hasMouse)

public static hasMouse : Boolean [read-only]
Indica si el dispositivo mvil enva eventos relacionados con el ratn a un reproductor Flash Lite. Esta propiedad devuelve true si el dispositivo mvil enva eventos relacionados con el ratn a un reproductor Flash Lite. De lo contrario, devuelve false. Disponibilidad Flash Lite 2.0

trace(System.capabilities.hasMouse);
hasMP3 (propiedad capabilities.hasMP3)

public static hasMP3 : Boolean [read-only]
Especifica si el dispositivo mvil dispone de un decodificador de MP3. Valor booleano que da como resultado true si el reproductor se est ejecutando en un sistema con decodificador MP3; en caso contrario, da como resultado false. La cadena de servidor es MP3. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.hasMP3);
hasPrinting (propiedad capabilities.hasPrinting)

public static hasPrinting : Boolean [read-only]
Valor booleano que da como resultado true si el reproductor se est ejecutando en un dispositivo mvil que admite impresin; en caso contrario, da como resultado false. La cadena de servidor es PR. Nota: en Flash Lite 2.0, el valor devuelto es siempre false. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.hasPrinting);
hasQWERTYKeyboard (propiedad capabilities.hasQWERTYKeyboard)

public static hasQWERTYKeyboard : Boolean [read-only]
Devuelve true si el reproductor Flash Lite puede procesar cdigo ActionScript asociado a todas las teclas de un teclado occidental estndar (QWERTY), incluida la tecla RETROCESO. En caso contrario, esta propiedad devuelve false. Disponibilidad Flash Lite 2.0

trace(System.capabilities.hasQWERTYKeyboard);
hasScreenBroadcast (propiedad capabilities.hasScreenBroadcast)

public static hasScreenBroadcast : Boolean [read-only]
Valor booleano que da como resultado true si el reproductor admite el desarrollo de aplicaciones de difusin de pantallas para su ejecucin a travs de Flash Media Server; en caso contrario, da como resultado false. La cadena de servidor es SB. Nota: en Flash Lite 2.0, el valor devuelto es siempre false. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.hasScreenBroadcast);
hasScreenPlayback (propiedad capabilities.hasScreenPlayback)

public static hasScreenPlayback : Boolean [read-only]
Valor booleano que da como resultado true si el reproductor admite la reproduccin de aplicaciones de difusin de pantallas que se estn ejecutando a travs de Flash Media Server; en caso contrario, da como resultado false. La cadena de servidor es SP. Nota: en Flash Lite 2.0, el valor devuelto es siempre false. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.hasScreenPlayback);
hasSharedObjects (propiedad capabilities.hasSharedObjects)

public static hasSharedObjects : Boolean [read-only]
Devuelve true si el contenido Flash Lite que se reproduce en una aplicacin puede acceder a la versin Flash Lite de los objetos compartidos. En caso contrario, esta propiedad devuelve false.

Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.hasSharedObjects);
hasSMAF (propiedad capabilities.hasSMAF)

public static hasSMAF : Boolean [read-only]
Devuelve true si el dispositivo mvil puede reproducir datos de sonido en formato de audio SMAF. En caso contrario, esta propiedad devuelve false. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.hasSMAF);
hasSMS (propiedad capabilities.hasSMS)

public static hasSMS : Number [read-only]
Indica si el dispositivo mvil puede enviar mensajes SMS con el comando GetURL de ActionScript. Si Flash Lite puede enviar mensajes SMS, esta variable est definida y tiene el valor 1. De lo contrario, la variable no est definida. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.hasSMS);
hasStreamingAudio (propiedad capabilities.hasStreamingAudio)

public static hasStreamingAudio : Boolean [read-only]
Valor booleano que da como resultado true si el reproductor es capaz de reproducir un flujo de audio; en caso contrario, da como resultado false. La cadena de servidor es SA.

trace(System.capabilities.hasStreamingAudio);
hasStreamingVideo (propiedad capabilities.hasStreamingVideo)

public static hasStreamingVideo : Boolean [read-only]
Valor booleano que indica si el reproductor es capaz de reproducir vdeo sin interrupcin. Nota: la propiedad hasStreamingVideo siempre es false en Flash Lite 2.0 y Flash Lite 2.1, indicando que los archivos FLV de flujo no son compatibles. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.hasStreamingVideo);
hasStylus (propiedad capabilities.hasStylus)

public static hasStylus : Boolean [read-only]
Indica si el dispositivo mvil admite eventos relacionados con el lpiz stylus. Esta propiedad devuelve true si la plataforma del dispositivo mvil no es compatible con eventos relacionados con el lpiz stylus. En caso contrario, esta propiedad devuelve false. El lpiz stylus no es compatible con el evento onMouseMove. Este indicador permite que el contenido de Flash compruebe si la plataforma para un dispositivo mvil es compatible con este evento. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.hasStylus);
hasVideoEncoder (propiedad capabilities.hasVideoEncoder)

public static hasVideoEncoder : Boolean [read-only]

Especifica si Flash Lite Player puede codificar un flujo de vdeo. Valor booleano que da como resultado true si el reproductor permite codificar un flujo de vdeo, como, por ejemplo, el procedente de una cmara; en caso contrario, el resultado es false. La cadena de servidor es VE. Nota: en Flash Lite 2.0, el valor devuelto es siempre false. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.hasVideoEncoder);
hasXMLSocket (propiedad capabilities.hasXMLSocket)

public static hasXMLSocket : Number [read-only]
Indica si la aplicacin host admite sockets XML. Si la aplicacin host admite sockets XML, esta variable est definida y tiene el valor 1. De lo contrario, la variable no est definida.
imageMIMETypes (propiedad capabilities.imageMIMETypes)

public static imageMIMETypes : Array [read-only]
Devuelve una matriz que contiene todos los tipos MIME con los que la funcin loadMovie y los cdecs del dispositivo mvil son compatibles para poder procesar imgenes. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.imageMIMETypes);
isDebugger (propiedad capabilities.isDebugger)

public static isDebugger : Boolean [read-only]
Valor booleano que especifica si el reproductor es de una versin lanzada oficialmente (false) o una versin especial de depuracin ( true). La cadena de servidor es DEB. Nota: en Flash Lite 2.0, el valor devuelto es siempre false. Disponibilidad Flash Lite 2.0

trace(System.capabilities.isDebugger);
***note about space instead of tab used for indents in code
language (propiedad capabilities.language)

public static language : String [read-only]
Indica el idioma del sistema en el que se est ejecutando el reproductor. Esta propiedad se especifica como un cdigo de idioma de dos letras en minsculas segn ISO 639-1. En el caso del idioma chino, una subetiqueta adicional de cdigo de dos letras de pas segn ISO 3166 permite distinguir si se trata de chino simplificado o chino tradicional. Los idiomas en s se denominan con las etiquetas en ingls. Por ejemplo, fr especifica francs. Esta propiedad cambi de dos formas en Flash Player 7. En primer lugar, el cdigo de idioma de los sistemas en ingls ya no incluye el cdigo de idioma. En Flash Player 6, todos los sistemas en ingls devolvan el cdigo de idioma y la subetiqueta de cdigo de pas de dos letras (en-US). En Flash Player 7, los sistemas en ingls slo devuelven el cdigo de idioma (en). En segundo lugar, en sistemas Microsoft Windows, esta propiedad ahora devuelve el idioma de la interfaz de usuario. En Flash Player 6 ejecutado en la plataforma Microsoft Windows, System.capabilities.language devuelve la configuracin regional del usuario, que controla la configuracin de formato para fechas, horas, divisa y nmeros grandes. En Flash Player 7 ejecutado en la plataforma Microsoft Windows, esta propiedad devuelve ahora el idioma de la interfaz de usuario, que hace referencia al idioma empleado en todos los mens, cuadros de dilogo, mensajes de error y archivos de ayuda.
Idioma Checo Dans Holands Ingls Finlands Francs Alemn Hngaro Italiano Japons Coreano Noruego Otro/desconocido Polaco Portugus Ruso Chino simplificado Etiqueta cs da nl en fi fr de hu it ja ko no xu pl pt ru zh-CN

Idioma Espaol Sueco Chino tradicional Turco
Etiqueta es sv zh-TW tr
trace(System.capabilities.language);
localFileReadDisable (propiedad capabilities.localFileReadDisable)

public static localFileReadDisable : Boolean [read-only]
Valor booleano que indica si el acceso de lectura al disco duro del usuario ha sido prohibido (true) o autorizado (
false) administrativamente. Si es true, Flash Lite Player no podr leer archivos (incluido el primer archivo SWF con
el que se inicia Flash Lite Player) del disco duro del usuario. Por ejemplo, los intentos de lectura de un archivo del disco duro del usuario mediante XML.load(), LoadMovie() o LoadVars.load() fallarn si esta propiedad se establece como true. La lectura de bibliotecas compartidas en tiempo de ejecucin tambin se bloquear si esta propiedad se establece como
true, aunque se autorizar la lectura de objetos compartidos locales con independencia de cul sea el valor de esta
propiedad. La cadena de servidor es LFD. Nota: en Flash Lite 2.0, el valor devuelto es siempre true. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.localFileReadDisable);
MIMETypes (propiedad capabilities.MIMETypes)

public static MIMETypes : Array [read-only]
Devuelve una matriz que contiene todos los tipos MIME compatibles con la funcin loadMovie y los objetos Sound y Video. Disponibilidad Flash Lite 2.0

trace(System.capabilities.MIMETypes);
os (propiedad capabilities.os)
public static os : String [read-only]
Cadena que indica el sistema operativo actual. La propiedad os puede devolver las siguientes cadenas: "Windows XP", "Windows 2000", "Windows NT", "Windows 98/ME", "Windows 95", "Windows CE" (slo disponible en Flash Player SDK, no en la versin de escritorio), "Linux" y "MacOS". La cadena de servidor es OS. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.os);
screenOrientation (propiedad capabilities.screenOrientation)

public static screenOrientation : String [read-only]
Una variable de miembro del objeto System.capabilities indica la orientacin actual de la pantalla. Posibles valores para la propiedad screenOrientation:
normal: la pantalla tiene orientacin normal rotated90: la pantalla se gira 90 grados rotated180: la pantalla se gira 180 grados rotated270: la pantalla se gira 270 grados
trace(System.capabilities.screenOrientation);
screenResolutionX (propiedad capabilities.screenResolutionX)

public static screenResolutionX : Number [read-only]
Entero que indica la resolucin horizontal mxima de la pantalla. La cadena de servidor es R (que devuelve la anchura y la altura de la pantalla).

trace(System.capabilities.screenResolutionX);
screenResolutionY (propiedad capabilities.screenResolutionY)

public static screenResolutionY : Number [read-only]
Entero que indica la resolucin vertical mxima de la pantalla. La cadena de servidor es R (que devuelve la anchura y la altura de la pantalla). Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.screenResolutionY);
softKeyCount (propiedad capabilities.softKeyCount)

public static softKeyCount : Number [read-only]
Indica el nmero de teclas programables reasignables compatibles con el dispositivo mvil. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.softKeyCount);
version (propiedad capabilities.version)

public static version : String [read-only]
Cadena que contiene la informacin de plataforma y versin de Flash Lite Player (por ejemplo, "WIN 7,1,0,0"). La cadena de servidor es V. Disponibilidad Flash Lite 2.0

trace(System.capabilities.version);
videoMIMETypes (propiedad capabilities.videoMIMETypes)

public static videoMIMETypes : Array [read-only]
Indica todos los tipos MIME para vdeo compatibles con los cdecs del dispositivo mvil. Esta propiedad devuelve una matriz con todos los tipos MIME para vdeo compatibles con los cdecs del dispositivo mvil. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente realiza un seguimiento del valor de esta propiedad de slo lectura:
trace(System.capabilities.videoMIMETypes);
Color
Object | +-Color public class Color extends Object
La clase Color le permite establecer el valor de color RGB y la transformacin de color de los clips de pelcula y recuperar dichos valores una vez que se hayan establecido. Debe utilizar el constructor new new Color() para crear un objeto Color antes de llamar a sus mtodos. Disponibilidad Flash Lite 2.0 Resumen de propiedades Propiedades heredadas de la clase Object

Firma Color(target:Object) Descripcin Crea un objeto Color para el clip de pelcula especificado por el parmetro target_mc.
Resumen de mtodos
Modificadores Firma getRGB() : Number Descripcin Devuelve la combinacin R+G+B utilizada por el objeto de color.
getTransform() : Object Devuelve el valor de transformacin establecido por la ltima llamada a Color.setTransform(). setRGB(offset:Number ) : Void Especifica un color RGB para un objeto Color.
setTransform(transform Establece la informacin de transformacin para un objeto Object:Object) : Void Color.

Constructor Color()
public Color(target:Object)
Crea un objeto Color para el clip de pelcula especificado por el parmetro target_mc. Posteriormente se podrn utilizar los mtodos de dicho objeto Color para cambiar el color de todo el clip de pelcula de destino. Disponibilidad Flash Lite 2.0 Parmetros target:Object - Nombre de instancia del clip de pelcula. Ejemplo El ejemplo siguiente crea un objeto Color llamado my_color para el clip de pelcula my_mc y establece su valor RGB en naranja:
var my_color:Color = new Color(my_mc); my_color.setRGB(0xff9933);
getRGB (mtodo Color.getRGB)

public getRGB() : Number
Devuelve la combinacin R+G+B utilizada por el objeto de color.

Disponibilidad Flash Lite 2.0 Valor devuelto Number - Nmero que representa el valor de nmero RGB para el color especificado. Ejemplo El cdigo siguiente recupera el valor RGB para el objeto my_color, convierte el valor en una cadena hexadecimal y la asigna a la variable myValue. Para ver cmo funciona este cdigo, aada una instancia de clip de pelcula al escenario y asgnele el nombre de instancia my_mc:
var my_color:Color = new Color(my_mc); // set the color my_color.setRGB(0xff9933); var myValue:String = my_color.getRGB().toString(16); // trace the color value trace(myValue); // traces ff9933
Vase tambin
setRGB (mtodo Color.setRGB)
getTransform (mtodo Color.getTransform)

public getTransform() : Object
Devuelve el valor de transformacin establecido por la ltima llamada a Color.setTransform(). Disponibilidad Flash Lite 2.0 Valor devuelto Object - Objeto cuyas propiedades contienen los valores actuales de desplazamiento y porcentaje para el color especificado. Ejemplo El ejemplo siguiente obtiene el objeto de transformacin y, a continuacin, establece nuevos porcentajes para colores y alfa de my_mc en relacin con sus valores actuales. Para ver cmo funciona esta cdigo, site un clip de pelcula multicolor en el escenario con el nombre de instancia my_mc. A continuacin, site el cdigo siguiente en el fotograma 1 de la lnea de tiempo principal y seleccione Control > Probar pelcula:
var my_color:Color = new Color(my_mc); var myTransform:Object = my_color.getTransform(); myTransform = { ra: 50, ba: 50, aa: 30}; my_color.setTransform(myTransform);
Para obtener descripciones de los parmetros de un objeto de transformacin de color, consulte Color.setTransform(). Vase tambin
setTransform (mtodo Color.setTransform)

setRGB (mtodo Color.setRGB)

public setRGB(offset:Number) : Void
Especifica un color RGB para un objeto Color. La llamada a este mtodo provoca la sustitucin de toda la configuracin anterior de Color.setTransform(). Disponibilidad Flash Lite 2.0 Parmetros offset:Number - 0xRRGGBB Color RGB o hexadecimal que se desea establecer. RR, GG y BB constan cada uno de dos dgitos hexadecimales que especifican el desplazamiento de cada componente de color. El 0x indica al compilador de ActionScript que el nmero es un valor hexadecimal. Ejemplo Este ejemplo establece el valor de color RGB del clip de pelcula my_mc. Para ver cmo funciona esta cdigo, site un clip de pelcula en el escenario con el nombre de instancia my_mc. A continuacin, site el cdigo siguiente en el fotograma 1 de la lnea de tiempo principal y seleccione Control > Probar pelcula:
var my_color:Color = new Color(my_mc); my_color.setRGB(0xFF0000); // my_mc turns red
Vase tambin

public setTransform(transformObject:Object) : Void
Establece la informacin de transformacin para un objeto Color. El parmetro colorTransformObject es un objeto genrico que usted crea desde el constructor new Object. Incluye parmetros que especifican los valores de porcentaje y desplazamiento para los componentes rojo, verde, azul y alfa (transparencia) de un color, introducidos en el formato 0xRRGGBBAA. Los parmetros de un objeto de transformacin de color corresponden a la configuracin del cuadro de dilogo Efecto avanzado y se definen de la siguiente forma:
ra es el porcentaje del componente rojo (de -100 a 100). rb es el desplazamiento del componente rojo (de -255 a 255). ga es el porcentaje del componente verde (de -100 a 100). gb es el desplazamiento del componente verde (de -255 a 255). ba es el porcentaje del componente azul (de -100 a 100). bb es el desplazamiento del componente azul (de -255 a 255). aa es el porcentaje de alfa (de -100 a 100). ab es el desplazamiento de alfa (de -255 a 255).
Un parmetro colorTransformObject se crea de la siguiente forma:

var myColorTransform:Object = new Object(); myColorTransform.ra = 50; myColorTransform.rb = 244; myColorTransform.ga = 40; myColorTransform.gb = 112; myColorTransform.ba = 12; myColorTransform.bb = 90; myColorTransform.aa = 40; myColorTransform.ab = 70;
Tambin puede utilizar la siguiente sintaxis para crear un parmetro colorTransformObject:

var myColorTransform:Object = { ra: 50, rb: 244, ga: 40, gb: 112, ba: 12, bb: 90, aa: 40, ab: 70}
Disponibilidad Flash Lite 2.0 Parmetros transformObject:Object - Objeto creado con el constructor new Object. Esta instancia de la clase Object debe tener las siguientes propiedades que especifican valores de transformacin de color: ra, rb, ga , gb , ba , bb , aa , ab. A continuacin, se explican estas propiedades. Ejemplo Este ejemplo crea un objeto Color para un archivo SWF de destino, crea un objeto genrico llamado myColorTransform con las propiedades definidas anteriormente y utiliza el mtodo setTransform() para pasar colorTransformObject a un objeto Color. Para utilizar este cdigo en un documento de Flash (FLA), sitelo en el fotograma 1 de la lnea de tiempo principal y site un clip de pelcula en el escenario con el nombre de instancia my_mc, como en el cdigo siguiente:
// Create a color object called my_color for the target my_mc var my_color:Color = new Color(my_mc); // Create a color transform object called myColorTransform using // Set the values for myColorTransform var myColorTransform:Object = { ra: 50, rb: 244, ga: 40, gb: 112, ba: 12, bb: 90, aa: 40, ab: 70}; // Associate the color transform object with the Color object // created for my_mc my_color.setTransform(myColorTransform);
Vase tambin
Object
ColorTransform (flash.geom.ColorTransform)
Object | +-flash.geom.ColorTransform public class ColorTransform extends Object

La clase ColorTransform permite ajustar matemticamente todos los valores de color de un clip de pelcula. La funcin de ajuste del color o transformacin del color se puede a los cuatro canales: rojo, verde, azul y transparencia alfa. Cuando se aplica un objeto ColorTransform a un objeto de visualizacin, se calcula de este modo un valor nuevo para cada canal de color:
Nuevo valor rojo = (valor rojo antiguo * redMultiplier) + redOffset Nuevo valor verde = (valor verde antiguo * greenMultiplier) + greenOffset Nuevo valor azul = (valor azul antiguo * blueMultiplier) + blueOffset Nuevo valor alfa = (valor alfa antiguo * alphaMultiplier) + alphaOffset
Si alguno de los valores de canales de color es superior a 255 despus del clculo, se establece en 255. Si es inferior a 0, se establece en 0. Debe utilizar el constructor new ColorTransform() nuevo para crear un objeto ColorTransform antes de llamar a los mtodos del objeto ColorTransform. Las transformaciones de color no se aplican al color del fondo de un clip de pelcula (como un objeto SWF cargado). Slo se aplican a grficos y smbolos asociados al clip de pelcula. Disponibilidad Flash Lite 3.1 Vase tambin
colorTransform (propiedad Transform.colorTransform)
Modificadores Propiedad alphaMultiplier:Number Descripcin Valor decimal por el que se multiplica por el valor del canal de transparencia alfa. Nmero de -255 a 255 que se aade al valor del canal de transparencia alfa despus de multiplicarse por el valor de alphaMultiplier. Valor decimal por el que se multiplica por el valor del canal azul. Nmero de -255 a 255 que se aade al valor del canal azul despus de multiplicarse por el valor de blueMultiplier. Valor decimal por el que se multiplica por el valor del canal verde. Nmero de -255 a 255 que se aade al valor del canal verde despus de multiplicarse por el valor de greenMultiplier. Valor decimal por el que se multiplica por el valor del canal rojo. Nmero de -255 a 255 que se aade al valor del canal rojo despus de multiplicarse por el valor de redMultiplier. Valor del color RVA de un objeto ColorTransform.
alphaOffset:Number
blueMultiplier:Number blueOffset:Number
greenMultiplier:Number greenOffset:Number
redMultiplier:Number redOffset:Number
rgb:Number
constructor (propiedad Object.constructor) en la pgina 507, __proto__ (Object.__proto__, propiedad), prototype (propiedad Object.prototype), __resolve (Object.__resolve, propiedad) en la pgina 512

Firma Descripcin
ColorTransform([redMult Crea un objeto ColorTransform para un objeto de visualizacin con los valores de iplier:Number], canales de color y alfa especificados. [greenMultiplier:Number
], [blueMultiplier:Number] , [alphaMultiplier:Number ], [redOffset:Number], [greenOffset:Number], [blueOffset:Number], [alphaOffset:Number])
Resumen de mtodos
Modificadores Firma concat(second:ColorT ransform) : Void toString() : String Descripcin Aplica una segunda transformacin de color aditiva al clip de pelcula. Formatea y devuelve una cadena que describe todas las propiedades del objeto ColorTransform.
addProperty (mtodo Object.addProperty) en la pgina 504, hasOwnProperty (mtodo Object.hasOwnProperty) en la pgina 508, isPropertyEnumerable (mtodo Object.isPropertyEnumerable) en la pgina 508, isPrototypeOf (mtodo Object.isPrototypeOf) en la pgina 509, registerClass (mtodo Object.registerClass) en la pgina 511, toString (mtodo Object.toString) en la pgina 515, unwatch (mtodo Object.unwatch) en la pgina 516, valueOf (mtodo Object.valueOf),watch (mtodo Object.watch) en la pgina 518
alphaMultiplier (propiedad ColorTransform.alphaMultiplier)

public alphaMultiplier : Number
Valor decimal por el que se multiplica por el valor del canal de transparencia alfa. Si establece el valor de transparencia alfa de un clip de pelcula directamente utilizando la propiedad MovieClip._alpha, afectar al valor de la propiedad alphaMultiplier del objeto ColorTransform de dicho clip de pelcula. Disponibilidad Flash Lite 3.1 Ejemplo En el siguiente ejemplo, se crea el objeto ColorTransform colorTrans y se ajusta su valor de alphaMultiplier de 1 a .5.

import flash.geom.ColorTransform; import flash.geom.Transform; var colorTrans:ColorTransform = new ColorTransform(); trace(colorTrans.alphaMultiplier); // 1 colorTrans.alphaMultiplier = .5; trace(colorTrans.alphaMultiplier); // .5 var rect:MovieClip = createRectangle(20, 80, 0x000000); var trans:Transform = new Transform(rect); trans.colorTransform = colorTrans; function createRectangle(width:Number, height:Number, color:Number, scope:MovieClip):MovieClip { scope = (scope == undefined) ? this : scope; var depth:Number = scope.getNextHighestDepth(); var mc:MovieClip = scope.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }
Vase tambin
alphaOffset (propiedad ColorTransform.alphaOffset)

public alphaOffset : Number
Nmero de -255 a 255 que se aade al valor del canal de transparencia alfa despus de multiplicarse por el valor de alphaMultiplier. Disponibilidad Flash Lite 3.1 Ejemplo En el siguiente ejemplo, se crea el objeto ColorTransform colorTrans y se ajusta su valor de alphaOffset de 0 a -128.

import flash.geom.ColorTransform; import flash.geom.Transform; var colorTrans:ColorTransform = new ColorTransform(); trace(colorTrans.alphaOffset); // 0 colorTrans.alphaOffset = -128; trace(colorTrans.alphaOffset); // -128 var rect:MovieClip = createRectangle(20, 80, 0x000000); var trans:Transform = new Transform(rect); trans.colorTransform = colorTrans; function createRectangle(width:Number, height:Number, color:Number, scope:MovieClip):MovieClip { scope = (scope == undefined) ? this : scope; var depth:Number = scope.getNextHighestDepth(); var mc:MovieClip = scope.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }
blueMultiplier (propiedad ColorTransform.blueMultiplier)

public blueMultiplier : Number
Valor decimal por el que se multiplica por el valor del canal azul. Disponibilidad Flash Lite 3.1 Ejemplo En el siguiente ejemplo, se crea el objeto ColorTransform colorTrans y se ajusta su valor de blueMultiplier de 1 a .5.

import flash.geom.ColorTransform; import flash.geom.Transform; var colorTrans:ColorTransform = new ColorTransform(); trace(colorTrans.blueMultiplier); // 1 colorTrans.blueMultiplier = .5; trace(colorTrans.blueMultiplier); // .5 var rect:MovieClip = createRectangle(20, 80, 0x0000FF); var trans:Transform = new Transform(rect); trans.colorTransform = colorTrans; function createRectangle(width:Number, height:Number, color:Number, scope:MovieClip):MovieClip { scope = (scope == undefined) ? this : scope; var depth:Number = scope.getNextHighestDepth(); var mc:MovieClip = scope.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }
blueOffset (propiedad ColorTransform.blueOffset)

public blueOffset : Number
Nmero de -255 a 255 que se aade al valor del canal azul despus de multiplicarse por el valor de blueMultiplier. Disponibilidad Flash Lite 3.1 Ejemplo En el siguiente ejemplo, se crea el objeto ColorTransform colorTrans y se ajusta su valor de blueOffset de 0 a 255.

import flash.geom.ColorTransform; import flash.geom.Transform; var colorTrans:ColorTransform = new ColorTransform(); trace(colorTrans.blueOffset); // 0 colorTrans.blueOffset = 255; trace(colorTrans.blueOffset); // 255 var rect:MovieClip = createRectangle(20, 80, 0x000000); var trans:Transform = new Transform(rect); trans.colorTransform = colorTrans; function createRectangle(width:Number, height:Number, color:Number, scope:MovieClip):MovieClip { scope = (scope == undefined) ? this : scope; var depth:Number = scope.getNextHighestDepth(); var mc:MovieClip = scope.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }
Constructor ColorTransform
public ColorTransform([redMultiplier:Number], [greenMultiplier:Number], [blueMultiplier:Number], [alphaMultiplier:Number], [redOffset:Number], [greenOffset:Number], [blueOffset:Number], [alphaOffset:Number])
Crea un objeto ColorTransform para un objeto de visualizacin con los valores de canales de color y alfa especificados. Disponibilidad Flash Lite 3.1 Parmetros redMultiplier:Number [opcional] - Valor del multiplicador rojo, en el rango de 0 a 1. El valor predeterminado es 1. greenMultiplier:Number [opcional] - Valor del multiplicador verde, en el rango de 0 a 1. El valor predeterminado es 1. blueMultiplier:Number [opcional] - Valor del multiplicador azul, en el rango de 0 a 1. El valor predeterminado es 1. alphaMultiplier:Number [opcional] - Valor del multiplicador de transparencia alfa, en el rango de 0 a 1. El valor predeterminado es 1. redOffset:Number [opcional] - Desplazamiento del valor del canal del color rojo (de -255 a 255). El valor predeterminado es 0. greenOffset:Number [opcional] - Desplazamiento del valor del canal del color verde (de -255 a 255). El valor predeterminado es 0. blueOffset:Number [opcional] - Desplazamiento del valor del canal del color azul (de -255 a 255). El valor predeterminado es 0. alphaOffset:Number [opcional] - Desplazamiento del valor de transparencia alfa (de -255 a 255). El valor predeterminado es 0.

Ejemplo En el ejemplo siguiente se crea un objeto ColorTransform denominado greenTransform:

var greenTransform:flash.geom.ColorTransform = new flash.geom.ColorTransform(0.5, 1.0, 0.5, 0.5, 10, 10, 10, 0);
En el ejemplo siguiente se crea el objeto ColorTransfrom colorTrans_1 con los valores predeterminados del constructor. El hecho de que colorTrans_1 y colorTrans_2 tracen los mismos valores demuestra que se han utilizado los valores predeterminados del constructor.
import flash.geom.ColorTransform; var colorTrans_1:ColorTransform = new ColorTransform(1, 1, 1, 1, 0, 0, 0, 0); trace(colorTrans_1); //(redMultiplier=1, greenMultiplier=1, blueMultiplier=1, alphaMultiplier=1, redOffset=0, greenOffset=0, blueOffset=0, alphaOffset=0) var colorTrans_2:ColorTransform = new ColorTransform(); trace(colorTrans_2); //(redMultiplier=1, greenMultiplier=1, blueMultiplier=1, alphaMultiplier=1, redOffset=0, greenOffset=0, blueOffset=0, alphaOffset=0)
concat (mtodo ColorTransform.concat)

public concat(second:ColorTransform) : Void
Aplica una segunda transformacin de color aditiva al clip de pelcula. El segundo conjunto de parmetros de transformacin se aplica a los colores del clip de pelcula una vez finalizada la primera transformacin. Disponibilidad Flash Lite 3.1 Parmetros second:ColorTransform - Segundo objeto ColorTransform que se desea combinar con el objeto ColorTransform actual. Ejemplo En el siguiente ejemplo, se concatenan los objetos ColorTransform de colorTrans_2 a colorTrans_1 lo que ocasiona un desplazamiento completo a rojo con un multiplicador alfa .5.

import flash.geom.ColorTransform; import flash.geom.Transform; var colorTrans_1:ColorTransform = new ColorTransform(1, 1, 1, 1, 255, 0, 0, 0); trace(colorTrans_1); // (redMultiplier=1, greenMultiplier=1, blueMultiplier=1, alphaMultiplier=1, redOffset=255, greenOffset=0, blueOffset=0, alphaOffset=0) var colorTrans_2:ColorTransform = new ColorTransform(1, 1, 1, .5, 0, 0, 0, 0); trace(colorTrans_2); // (redMultiplier=1, greenMultiplier=1, blueMultiplier=1, alphaMultiplier=0.5, redOffset=0, greenOffset=0, blueOffset=0, alphaOffset=0) colorTrans_1.concat(colorTrans_2); trace(colorTrans_1); // (redMultiplier=1, greenMultiplier=1, blueMultiplier=1, alphaMultiplier=0.5, redOffset=255, greenOffset=0, blueOffset=0, alphaOffset=0) var rect:MovieClip = createRectangle(20, 80, 0x000000); var trans:Transform = new Transform(rect); trans.colorTransform = colorTrans_1; function createRectangle(width:Number, height:Number, color:Number, scope:MovieClip):MovieClip { scope = (scope == undefined) ? this : scope; var depth:Number = scope.getNextHighestDepth(); var mc:MovieClip = scope.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }
greenMultiplier (propiedad ColorTransform.greenMultiplier)

public greenMultiplier : Number
Valor decimal por el que se multiplica por el valor del canal verde. Disponibilidad Flash Lite 3.1 Ejemplo En el siguiente ejemplo, se crea el objeto ColorTransform colorTrans y se ajusta su valor de greenMultiplier de 1 a .5.

import flash.geom.ColorTransform; import flash.geom.Transform; var colorTrans:ColorTransform = new ColorTransform(); trace(colorTrans.greenMultiplier); // 1 colorTrans.greenMultiplier = .5; trace(colorTrans.greenMultiplier); // .5 var rect:MovieClip = createRectangle(20, 80, 0x00FF00), this; var trans:Transform = new Transform(rect); trans.colorTransform = colorTrans; function createRectangle(width:Number, height:Number, color:Number, scope:MovieClip):MovieClip { scope = (scope == undefined) ? this : scope; var depth:Number = scope.getNextHighestDepth(); var mc:MovieClip = scope.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }
greenOffset (propiedad ColorTransform.greenOffset)

public greenOffset : Number
Nmero de -255 a 255 que se aade al valor del canal verde despus de multiplicarse por el valor de greenMultiplier. Disponibilidad Flash Lite 2.0 Ejemplo En el siguiente ejemplo, se crea el objeto ColorTransform colorTrans y se ajusta su valor de greenOffset de 0 a 255.

import flash.geom.ColorTransform; import flash.geom.Transform; var colorTrans:ColorTransform = new ColorTransform(); trace(colorTrans.greenOffset); // 0 colorTrans.greenOffset = 255; trace(colorTrans.greenOffset); // 255 var rect:MovieClip = createRectangle(20, 80, 0x000000); var trans:Transform = new Transform(rect); trans.colorTransform = colorTrans; function createRectangle(width:Number, height:Number, color:Number, scope:MovieClip):MovieClip { scope = (scope == undefined) ? this : scope; var depth:Number = scope.getNextHighestDepth(); var mc:MovieClip = scope.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }
redMultiplier (propiedad ColorTransform.redMultiplier)

public redMultiplier : Number
Valor decimal por el que se multiplica por el valor del canal rojo. Disponibilidad Flash Lite 2.0 Ejemplo En el siguiente ejemplo, se crea el objeto ColorTransform colorTrans y se ajusta su valor de redMultiplier de 1 a .5.

import flash.geom.ColorTransform; import flash.geom.Transform; var colorTrans:ColorTransform = new ColorTransform(); trace(colorTrans.redMultiplier); // 1 colorTrans.redMultiplier = .5; trace(colorTrans.redMultiplier); // .5 var rect:MovieClip = createRectangle(20, 80, 0xFF0000); var trans:Transform = new Transform(rect); trans.colorTransform = colorTrans; function createRectangle(width:Number, height:Number, color:Number, scope:MovieClip):MovieClip { scope = (scope == undefined) ? this : scope; var depth:Number = scope.getNextHighestDepth(); var mc:MovieClip = scope.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }
redOffset (propiedad ColorTransform.redOffset)

public redOffset : Number
Nmero de -255 a 255 que se aade al valor del canal rojo despus de multiplicarse por el valor de redMultiplier. Disponibilidad Flash Lite 2.0 Ejemplo En el siguiente ejemplo, se crea el objeto ColorTransform colorTrans y se ajusta su valor de redOffset de 0 a 255.

import flash.geom.ColorTransform; import flash.geom.Transform; var colorTrans:ColorTransform = new ColorTransform(); trace(colorTrans.redOffset); // 0 colorTrans.redOffset = 255; trace(colorTrans.redOffset); // 255 var rect:MovieClip = createRectangle(20, 80, 0x000000); var trans:Transform = new Transform(rect); trans.colorTransform = colorTrans; function createRectangle(width:Number, height:Number, color:Number, scope:MovieClip):MovieClip { scope = (scope == undefined) ? this : scope; var depth:Number = scope.getNextHighestDepth(); var mc:MovieClip = scope.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }
rgb (propiedad ColorTransform.rgb)

public rgb : Number
Valor del color RVA de un objeto ColorTransform. Al definir esta propiedad, se cambian los tres valores de desplazamiento de color (redOffset, greenOffset y blueOffset) y define los tres valores de multiplicador de color (redMultiplier, greenMultiplier y blueMultiplier) como 0. El multiplicador y los valores de desplazamiento de alfa no se modifican. Pase un valor para esta propiedad con el formato: 0xRRGGBB. RR, GG y BB constan cada uno de dos dgitos hexadecimales que especifican el desplazamiento de cada componente de color. El 0x indica al compilador de ActionScript que el nmero es un valor hexadecimal. Disponibilidad Flash Lite 2.0 Ejemplo En el siguiente ejemplo, se crea el objeto ColorTransform colorTrans y se ajusta su valor de rgb en 0xFF0000.

import flash.geom.ColorTransform; import flash.geom.Transform; var colorTrans:ColorTransform = new ColorTransform(); trace(colorTrans.rgb); // 0 colorTrans.rgb = 0xFF0000; trace(colorTrans.rgb); // 16711680 trace("0x" + colorTrans.rgb.toString(16)); // 0xff0000 var rect:MovieClip = createRectangle(20, 80, 0x000000); var trans:Transform = new Transform(rect); trans.colorTransform = colorTrans; function createRectangle(width:Number, height:Number, color:Number, scope:MovieClip):MovieClip { scope = (scope == undefined) ? this : scope; var depth:Number = scope.getNextHighestDepth(); var mc:MovieClip = scope.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }
toString (mtodo ColorTransform.toString)

Formatea y devuelve una cadena que describe todas las propiedades del objeto ColorTransform. Disponibilidad Flash Lite 2.0 Valor devuelto String Cadena que muestra todas las propiedades del objeto ColorTransform. Ejemplo En el siguiente ejemplo se crea el objeto ColorTransform colorTrans y se llama a su mtodo toSting(). Este mtodo produce una cadena con el siguiente formato: (redMultiplier=RM, greenMultiplier=GM, blueMultiplier=BM, alphaMultiplier=AM, redOffset=RO, greenOffset=GO, blueOffset=BO, alphaOffset=AO).
import flash.geom.ColorTransform; var colorTrans:ColorTransform = new ColorTransform(1, 2, 3, 4, -255, -128, 128, 255); trace(colorTrans.toString()); // (redMultiplier=1, greenMultiplier=2, blueMultiplier=3, alphaMultiplier=4, redOffset=-255, greenOffset=-128, blueOffset=128, alphaOffset=255)

Date
Object | +-Date public class Date extends Object
La clase Date permite recuperar los valores de fecha y hora relativos a la hora universal (hora de Greenwich, ahora conocida como hora universal o UTC) o al sistema operativo en el que se ejecuta Flash Lite Player. Los mtodos de la clase Date no son estticos, pero afectan solamente al objeto Date concreto especificado al llamar al mtodo. El mtodo Date.UTC() es una excepcin; es un mtodo esttico. La clase Date controla el horario de verano de forma distinta en funcin del sistema operativo y la versin de Flash Player. Flash Player 6 y posteriores controlan el horario de verano en los siguientes sistemas operativos como se indica a continuacin:
Windows: el objeto Date ajusta automticamente su salida para el horario de verano. El objeto Date detecta si se
emplea el horario de verano en la ubicacin actual y, si es as, detecta la fecha y la hora en la que se produce el cambio del horario estndar al horario de verano. No obstante, las fechas de transicin en vigor actualmente se aplican a fechas pasadas y futuras, por lo que el horario de verano podra calcularse errneamente en el caso de fechas pasadas si en la ubicacin en cuestin las fechas de transicin eran diferentes.
Mac OS X: el objeto Date ajusta automticamente su salida para el horario de verano. La base de datos de
informacin de zona horaria de Mac OS X se utiliza para determinar si debe aplicarse el cambio de hora a alguna fecha u hora actual o pasada.
Mac OS 9: el sistema operativo slo proporciona informacin suficiente para determinar si debe aplicarse el cambio
de hora a la fecha y la hora actuales. Por consiguiente, el objeto de fecha supone que el cambio de hora actual se aplica tanto a fechas y horas futuras como pasadas. Flash Player 5 controla el cambio de hora en los siguientes sistemas operativos como se indica a continuacin:
Windows: se aplican siempre las normas estadounidenses de cambio de hora, lo que lleva a transiciones incorrectas
en Europa y otras zonas que emplean el cambio de hora pero con transiciones diferentes a las de EE. UU. Flash detecta correctamente si se utiliza el cambio de hora en la ubicacin actual. Para llamar a los mtodos de la clase Date, primero debe crearse un objeto Date utilizando el constructor para la clase Date, descrito posteriormente en esta seccin. Disponibilidad Flash Lite 2.0 Resumen de propiedades Propiedades heredadas de la clase Object

Firma Date([yearOrTimevalue:Number], [month:Number], [date:Number], [hour:Number], [minute:Number], [second:Number], [millisecond:Number]) Descripcin Crea un nuevo objeto Date que contiene la fecha y la hora especificadas.
Resumen de mtodos
Modificadores Firma getDate():Number Descripcin Devuelve el da del mes (entero del 1 al 31) del objeto Date especificado de acuerdo con la hora local. Devuelve el da de la semana (0 para domingo, 1 para lunes, etc.) del objeto Date especificado de acuerdo con la hora local.
getDay():Number
getFullYear() : Number Devuelve el ao completo (un nmero de cuatro dgitos, como, por ejemplo, 2000) del objeto Date especificado de acuerdo con la hora local. getHours() : Number Devuelve la hora (entero de 0 a 23) del objeto Date especificado de acuerdo con la hora local. Devuelve una cadena que representa la fecha actual, en formato largo, con formato segn la configuracin local definida. Devuelve una cadena que representa la fecha actual, en formato corto, con formato segn la configuracin local definida. Devuelve una cadena que representa la hora actual con formato segn la configuracin local definida. Devuelve los milisegundos (entero de 0 a 999) del objeto Date especificado de acuerdo con la hora local.
getLocaleLongDate() : String
getLocaleShortDate() : String
getLocaleTime() : String getMilliseconds() : Number
getMinutes() : Number Devuelve los minutos (entero de 0 a 59) del objeto Date especificado de acuerdo con la hora local. getMonth() : Number Devuelve el mes (0 para enero, 1 para febrero, etc.) del objeto Date especificado de acuerdo con la hora local.
getSeconds() : Number Devuelve los segundos (entero de 0 a 59) del objeto Date especificado de acuerdo con la hora local. getTime() : Number Devuelve el nmero de milisegundos desde la media noche del 1 de enero de 1970, hora universal, para el objeto Date especificado. Devuelve la diferencia, en minutos, entre la hora local del equipo y la hora universal.
getTimezoneOffset() : Number
getUTCDate() : Number Devuelve el da del mes (entero del 1 al 31) del objeto Date especificado de acuerdo con la hora universal. getUTCDay() : Number Devuelve el da de la semana (0 para domingo, 1 para lunes, etc.) del objeto Date especificado de acuerdo con la hora universal.

Modificadores
Firma getUTCFullYear() : Number getUTCHours() : Number getUTCMilliseconds() : Number getUTCMinutes() : Number getUTCMonth() : Number getUTCSeconds() : Number
Descripcin Devuelve los cuatro dgitos del ao del objeto Date especificado de acuerdo con la hora universal. Devuelve la hora (entero de 0 a 23) del objeto Date especificado de acuerdo con la hora universal. Devuelve los milisegundos (entero de 0 a 999) del objeto Date especificado de acuerdo con la hora universal. Devuelve los minutos (entero de 0 a 59) del objeto Date especificado de acuerdo con la hora universal. Devuelve el mes (de 0 [enero] a 11 [diciembre]) del objeto Date especificado de acuerdo con la hora universal. Devuelve los segundos (entero de 0 a 59) del objeto Date especificado de acuerdo con la hora universal.
getUTCYear() : Number Devuelve el ao de este objeto Date segn la hora universal (UTC). getYear() : Number Devuelve el ao del objeto Date especificado de acuerdo con la hora local. Establece el da del mes para el objeto Date especificado de acuerdo con la hora local y devuelve la nueva hora en milisegundos.
setDate(date:Number) : Number
setFullYear(year:Numbe Establece el ao del objeto Date especificado de acuerdo con r, [month:Number], la hora local y devuelve la nueva hora en milisegundos. [date:Number]) : Number setHours(hour:Number) Establece las horas del objeto Date especificado de acuerdo : Number con la hora local y devuelve la nueva hora en milisegundos. setMilliseconds(millise cond:Number) : Number setMinutes(minute:Nu mber) : Number Establece los milisegundos del objeto Date especificado de acuerdo con la hora local y devuelve la nueva hora en milisegundos. Establece los minutos del objeto Date especificado de acuerdo con la hora local y devuelve la nueva hora en milisegundos.
setMonth(month:Numbe Establece el mes del objeto Date especificado en la hora local r, [date:Number]) : y devuelve la nueva hora en milisegundos. Number setSeconds(second:Nu mber) : Number setTime(millisecond: Number) : Number Establece los segundos del objeto Date especificado en la hora local y devuelve la nueva hora en milisegundos. Establece la fecha del objeto Date especificado en milisegundos desde la media noche del 1 de enero de 1970 y devuelve la nueva hora en milisegundos. Establece la fecha del objeto Date especificado en la hora universal y devuelve la nueva hora en milisegundos. Establece el ao del objeto Date especificado (my_date) en la hora universal y devuelve la nueva hora en milisegundos.
setUTCDate(date:Numb er) : Number setUTCFullYear(year:Nu mber, [month:Number], [date:Number]) : Number

Modificadores
Firma setUTCHours(hour:Num ber, [minute:Number], [second:Number], [millisecond:Number ]) : Number setUTCMilliseconds(mill isecond:Number) : Number setUTCMinutes(minute: Number, [second:Number], [millisecond:Number ]) : Number setUTCMonth(month:Nu mber, [date:Number]) : Number
Descripcin Establece la hora del objeto Date especificado en la hora universal y devuelve la nueva hora en milisegundos.
Establece los milisegundos del objeto Date especificado en la hora universal y devuelve la nueva hora en milisegundos.
Establece el minuto del objeto Date especificado en la hora universal y devuelve la nueva hora en milisegundos.
Establece el mes y, opcionalmente, el da del objeto Date especificado en la hora universal y devuelve la nueva hora en milisegundos.
setUTCSeconds(second: Establece los segundos del objeto Date especificado en la hora Number, universal y devuelve la nueva hora en milisegundos. [millisecond:Number ]) : Number setYear(year:Number) : Number toString() : String Establece el ao del objeto Date especificado en la hora local y devuelve la nueva hora en milisegundos. Devuelve un valor de cadena para el objeto de fecha especificado en un formato legible. Devuelve el nmero de milisegundos entre la media noche del 1 de enero de 1970, hora universal, y la hora especificada en los parmetros.
static
UTC(year:Number, month:Number, [date:Number], [hour:Number], [minute:Number], [second:Number], [millisecond:Number ]) : Number valueOf() : Number
Devuelve el nmero de milisegundos desde la media noche del 1 de enero de 1970, hora universal, para este objeto Date.

Constructor Date
public Date([yearOrTimevalue:Number], [month:Number], [date:Number], [hour:Number], [minute:Number], [second:Number], [millisecond:Number])
Crea un nuevo objeto Date que contiene la fecha y la hora especificadas.

El constructor Date() requiere hasta siete parmetros para especificar una fecha y una hora con precisin de milisegundos. Tambin es posible pasar un valor nico al constructor Date() que indique un valor de hora basado en el nmero de milisegundos desde el 1 de enero de 1970 a las 0:00:000 GMT. Tambin es posible no especificar parmetros y asignar al objeto de fecha Date() la fecha y la hora actuales. El siguiente cdigo muestra varias formas distintas de crear un objeto Date:
var var var var d1:Date d3:Date d4:Date d5:Date = = = = new new new new Date(); Date(2000, 0, 1); Date(65, 2, 6, 9, 30, 15, 0); Date(-14159025000);
En la primera lnea de cdigo, se establece un objeto Date con la hora en que se ejecut la sentencia de asignacin. En la segunda lnea se crea un objeto Date con los parmetros year, month y date que se le han pasado, lo que da como resultado la hora 0:00:00 GMT del 1 de enero de 2000. En la tercera lnea, se crea un objeto Date al que se han pasado los parmetros year, month y date, lo que da como resultado la hora 09:30:15 GMT (+ 0 milisegundos) del 6 de marzo de 1965. El parmetro year se especifica como un entero de dos dgitos, por lo que se interpreta como 1965. En la cuarta lnea slo se pasa un parmetro, que es un valor de hora que representa el nmero de milisegundos antes o despus de las 0:00:00 GMT del 1 de enero de 1970; dado que el valor es negativo, representa una hora anterior a las 0:00:00 GMT del 1 de enero de 1970 y, en este caso, la hora es 02:56:15 GMT del 21 de julio de 1969. Disponibilidad Flash Lite 2.0 Parmetros yearOrTimevalue:Number [opcional] - Si se especifican otros parmetros, este nmero representa un ao (por ejemplo, 1965); en caso contrario, representa un valor de hora. Si el nmero representa un ao, un valor de 0 a 99 indica de 1900 a 1999; en caso contrario deben especificarse los cuatro dgitos del ao. Si el nmero representa un valor de hora (no se especifican otros parmetros), es el nmero de milisegundos antes o despus de las 0:00:00 GMT del 1 de enero de 1970; un valor negativo representa una hora anterior a las 0:00:00 GMT del 1 de enero de 1970, y un valor positivo representa una hora posterior. month:Number [opcional] - Entero de 0 (enero) a 11 (diciembre). date:Number [opcional] - Entero de 1 a 31. hour:Number [opcional] - Entero de 0 (medianoche) a 23 (11 de la noche). minute:Number [opcional] - Entero de 0 a 59. second:Number [opcional] - Entero de 0 a 59. millisecond:Number [opcional] - Entero de 0 a 999 milisegundos. Ejemplo El ejemplo siguiente recupera la fecha y la hora actuales:
var now_date:Date = new Date();
El ejemplo siguiente crea un nuevo objeto Date para el cumpleaos de Mary, el 12 de agosto de 1974 (dado que el parmetro month se basa en ceros, el ejemplo utiliza 7 para el mes, no 8):
var maryBirthday:Date = new Date (74, 7, 12);

El ejemplo siguiente crea un nuevo objeto Date y concatena los valores devueltos de Date.getMonth(), Date.getDate() y Date.getFullYear():
var today_date:Date = new Date(); var date_str:String = ((today_date.getMonth()+1)+"/"+today_date.getDate()+"/"+today_date.getFullYear()); trace(date_str); // displays current date in United States date format
Vase tambin
getMonth (mtodo Date.getMonth), getDate (mtodo Date.getDate), getFullYear (mtodo Date.getFullYear)
getDate (mtodo Date.getDate)

public getDate() : Number
Devuelve el da del mes (entero del 1 al 31) del objeto Date especificado de acuerdo con la hora local. La hora local la determina el sistema operativo en el que se ejecuta Flash Lite Player. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea un nuevo objeto Date y concatena los valores devueltos de Date.getMonth(), Date.getDate() y Date.getFullYear():
var today_date:Date = new Date(); var date_str:String = (today_date.getDate()+"/"+(today_date.getMonth()+1)+"/"+today_date.getFullYear()); trace(date_str); // displays current date in United States date format
Vase tambin
getMonth (mtodo Date.getMonth), getFullYear (mtodo Date.getFullYear)
getDay (mtodo Date.getDay)

public getDay() : Number
Devuelve el da de la semana (0 para domingo, 1 para lunes, etc.) del objeto Date especificado de acuerdo con la hora local. La hora local la determina el sistema operativo en el que se ejecuta Flash Lite Player. Disponibilidad Flash Lite 2.0 Valor devuelto Number -- Entero que representa el da de la semana. Ejemplo El ejemplo siguiente crea un objeto new Date y utiliza getDay() para determinar el da actual de la semana:

var dayOfWeek_array:Array = new Array("Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"); var today_date:Date = new Date(); var day_str:String = dayOfWeek_array[today_date.getDay()]; trace("Today is "+day_str);
getFullYear (mtodo Date.getFullYear)

public getFullYear() : Number
Devuelve el ao completo (un nmero de cuatro dgitos, como, por ejemplo, 2000) del objeto Date especificado de acuerdo con la hora local. La hora local la determina el sistema operativo en el que se ejecuta Flash Lite Player. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Entero que representa el ao. Ejemplo El ejemplo siguiente utiliza el constructor para crear un objeto Date. La sentencia trace muestra el valor devuelto por el mtodo getFullYear().
var my_date:Date = new Date(); trace(my_date.getYear()); // displays 104 trace(my_date.getFullYear()); // displays current year
getHours (mtodo Date.getHours)

public getHours() : Number
Devuelve la hora (entero de 0 a 23) del objeto Date especificado de acuerdo con la hora local. La hora local la determina el sistema operativo en el que se ejecuta Flash Lite Player. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente utiliza el constructor para crear un objeto Date basado en la hora actual y utiliza el mtodo getHours() para mostrar valores de hora de ese objeto:

var my_date:Date = new Date(); trace(my_date.getHours()); var my_date:Date = new Date(); var hourObj:Object = getHoursAmPm(my_date.getHours()); trace(hourObj.hours); trace(hourObj.ampm); function getHoursAmPm(hour24:Number):Object { var returnObj:Object = new Object(); returnObj.ampm = (hour24<12) ? "AM" : "PM"; var hour12:Number = hour24%12; if (hour12 == 0) { hour12 = 12; } returnObj.hours = hour12; return returnObj; }
getLocaleLongDate (mtodo Date.getLocaleLongDate)

public getLocaleLongDate() : String
Devuelve una cadena que representa la fecha actual, en formato largo, con formato segn la configuracin local definida. Nota: el formato de la fecha depende del dispositivo mvil y de la configuracin local. Disponibilidad Flash Lite 2.0 Valor devuelto String - Cadena que representa la fecha actual, en formato largo, con formato segn la configuracin local definida. Ejemplo El ejemplo siguiente utiliza el constructor para crear un objeto Date segn la hora actual. Tambin utiliza el mtodo getLocaleLongDate() para devolver la fecha actual, en formato largo, con formato segn la configuracin local definida, del siguiente modo:
var my_date:Date = new Date(); trace(my_date.getLocaleLongDate());
A continuacin, se muestran los valores de muestra devueltos por getLocaleLongDate():

October 16, 2005 16 October 2005
getLocaleShortDate (mtodo Date.getLocaleShortDate)

public getLocaleShortDate() : String
Devuelve una cadena que representa la fecha actual, en formato corto, con formato segn la configuracin local definida. Nota: el formato de la fecha depende del dispositivo mvil y de la configuracin local.

Disponibilidad Flash Lite 2.0 Valor devuelto String - Cadena que representa la fecha actual, en formato corto, con formato segn la configuracin local definida. Ejemplo El ejemplo siguiente utiliza el constructor para crear un objeto Date segn la hora actual. Tambin utiliza el mtodo getLocaleShortDate() para devolver la fecha actual, en formato corto, con formato segn la configuracin local definida, del siguiente modo:
var my_date:Date = new Date(); trace(my_date.getLocaleShortDate());
A continuacin, se muestran los valores de muestra devueltos por getLocaleLongDate():

10/16/2005 16-10-2005
getLocaleTime (mtodo Date.getLocaleTime)

public getLocaleTime() : String
Devuelve una cadena que representa la hora actual con formato segn la configuracin local definida. Nota: el formato de la fecha depende del dispositivo mvil y de la configuracin local. Disponibilidad Flash Lite 2.0 Valor devuelto String - Cadena que representa la hora actual con formato segn la configuracin local definida. Ejemplo El ejemplo siguiente utiliza el constructor para crear un objeto Date segn la hora actual. Tambin utiliza el mtodo getLocaleTime() para devolver la hora de la configuracin local, de la manera siguiente:
var my_date:Date = new Date(); trace(my_date.getLocaleTime());
A continuacin, se muestran los valores de muestra devueltos por getLocaleTime():

6:10:44 PM 18:10:44
getMilliseconds (mtodo Date.getMilliseconds)

public getMilliseconds() : Number
Devuelve los milisegundos (entero de 0 a 999) del objeto Date especificado de acuerdo con la hora local. La hora local la determina el sistema operativo en el que se ejecuta Flash Lite Player. Disponibilidad Flash Lite 2.0

Valor devuelto Number Un entero. Ejemplo El ejemplo siguiente utiliza el constructor para crear un objeto Date basado en la hora actual y utiliza el mtodo getMilliseconds() para devolver el valor en milisegundos de ese objeto:
var my_date:Date = new Date(); trace(my_date.getMilliseconds());
getMinutes (mtodo Date.getMinutes)

public getMinutes() : Number
Devuelve los minutos (entero de 0 a 59) del objeto Date especificado de acuerdo con la hora local. La hora local la determina el sistema operativo en el que se ejecuta Flash Lite Player. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente utiliza el constructor para crear un objeto Date basado en la hora actual y utiliza el mtodo getMinutes() para devolver el valor en minutos de ese objeto:
var my_date:Date = new Date(); trace(my_date.getMinutes());
getMonth (mtodo Date.getMonth)

public getMonth() : Number
Devuelve el mes (0 para enero, 1 para febrero, etc.) del objeto Date especificado de acuerdo con la hora local. La hora local la determina el sistema operativo en el que se ejecuta Flash Lite Player. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente utiliza el constructor para crear un objeto Date basado en la hora actual y utiliza el mtodo getMonth() para devolver el valor del mes de ese objeto:
var my_date:Date = new Date(); trace(my_date.getMonth());
El ejemplo siguiente utiliza el constructor para crear un objeto Date basado en la hora actual y utiliza el mtodo getMonth() para mostrar el mes actual como un valor numrico y mostrar el nombre del mes.

var my_date:Date = new Date(); trace(my_date.getMonth()); trace(getMonthAsString(my_date.getMonth())); function getMonthAsString(month:Number):String { var monthNames_array:Array = new Array("January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"); return monthNames_array[month]; }
getSeconds (mtodo Date.getSeconds)

public getSeconds() : Number
Devuelve los segundos (entero de 0 a 59) del objeto Date especificado de acuerdo con la hora local. La hora local la determina el sistema operativo en el que se ejecuta Flash Lite Player. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente utiliza el constructor para crear un objeto Date basado en la hora actual y utiliza el mtodo getSeconds() para devolver el valor en segundos de ese objeto:
var my_date:Date = new Date(); trace(my_date.getSeconds());
getTime (mtodo Date.getTime)

public getTime() : Number
Devuelve el nmero de milisegundos desde la media noche del 1 de enero de 1970, hora universal, para el objeto Date especificado. Utilice este mtodo para representar un instante concreto en el tiempo al comparar dos o ms objetos Date. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente utiliza el constructor para crear un objeto Date basado en la hora actual y utiliza el mtodo getTime() para devolver el nmero de milisegundos desde la medianoche del 1 de enero de 1970:
var my_date:Date = new Date(); trace(my_date.getTime());
getTimezoneOffset (mtodo Date.getTimezoneOffset)

public getTimezoneOffset() : Number

Devuelve la diferencia, en minutos, entre la hora local del equipo y la hora universal. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente devuelve la diferencia entre la hora de verano local de San Francisco y la hora universal. La hora de verano slo se tiene en cuenta en el resultado si la fecha definida en el objeto Date se encuentra dentro del horario de verano. El resultado de este ejemplo es 420 minutos y aparece en el panel Salida (7 horas * 60 minutos/hora = 420 minutos). Este ejemplo utiliza el horario de verano de la costa del Pacfico de EE.UU. (PDT, GMT-0700). El resultado vara segn la ubicacin y el momento del ao.
var my_date:Date = new Date(); trace(my_date.getTimezoneOffset());
getUTCDate (mtodo Date.getUTCDate)

public getUTCDate() : Number
Devuelve el da del mes (entero del 1 al 31) del objeto Date especificado de acuerdo con la hora universal. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea un nuevo objeto Date y emplea Date.getUTCDate() y Date.getDate(). El valor que devuelve Date.getUTCDate() puede ser distinto del valor que devuelve Date.getDate(), segn la relacin existente entre la zona horaria local y la hora universal.
var my_date:Date = new Date(2004,8,25); trace(my_date.getUTCDate()); // output: 25
Vase tambin
getDate (mtodo Date.getDate)
getUTCDay (mtodo Date.getUTCDay)

public getUTCDay() : Number
Devuelve el da de la semana (0 para domingo, 1 para lunes, etc.) del objeto Date especificado de acuerdo con la hora universal. Disponibilidad Flash Lite 2.0

Valor devuelto Number Un entero. Ejemplo El ejemplo siguiente crea un nuevo objeto Date y emplea Date.getUTCDay() y Date.getDay(). El valor que devuelve Date.getUTCDay() puede ser distinto del valor que devuelve Date.getDay(), segn la relacin existente entre la zona horaria local y la hora universal.
var today_date:Date = new Date(); trace(today_date.getDay()); // output will be based on local timezone trace(today_date.getUTCDay()); // output will equal getDay() plus or minus one
Vase tambin
getDay (mtodo Date.getDay)
getUTCFullYear (mtodo Date.getUTCFullYear)

public getUTCFullYear() : Number
Devuelve los cuatro dgitos del ao del objeto Date especificado de acuerdo con la hora universal. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea un nuevo objeto Date y emplea Date.getUTCFullYear() y Date.getFullYear(). El valor que devuelve Date.getUTCFullYear() puede ser distinto del valor que devuelve Date.getFullYear() si la fecha del da es 31 de diciembre o 1 de enero, segn la relacin existente entre la zona horaria local y la hora universal.
var today_date:Date = new Date(); trace(today_date.getFullYear()); // display based on local timezone trace(today_date.getUTCFullYear()); // displays getYear() plus or minus 1
Vase tambin
getUTCHours (mtodo Date.getUTCHours)

public getUTCHours() : Number
Devuelve la hora (entero de 0 a 23) del objeto Date especificado de acuerdo con la hora universal. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Un entero.

Ejemplo El ejemplo siguiente crea un nuevo objeto Date y emplea Date.getUTCHours() y Date.getHours(). El valor que devuelve Date.getUTCHours() puede ser distinto del valor que devuelve Date.getHours(), segn la relacin existente entre la zona horaria local y la hora universal.
var today_date:Date = new Date(); trace(today_date.getHours()); // display based on local timezone trace(today_date.getUTCHours()); // display equals getHours() plus or minus 12
Vase tambin
getHours (mtodo Date.getHours)
getUTCMilliseconds (mtodo Date.getUTCMilliseconds)

public getUTCMilliseconds() : Number
Devuelve los milisegundos (entero de 0 a 999) del objeto Date especificado de acuerdo con la hora universal. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea un objeto new Date y utiliza getUTCMilliseconds() para devolver el valor en milisegundos del objeto Date.
var today_date:Date = new Date(); trace(today_date.getUTCMilliseconds());
getUTCMinutes (mtodo Date.getUTCMinutes)

public getUTCMinutes() : Number
Devuelve los minutos (entero de 0 a 59) del objeto Date especificado de acuerdo con la hora universal. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea un objeto new Date y utiliza getUTCMinutes() para devolver el valor en minutos del objeto Date.
var today_date:Date = new Date(); trace(today_date.getUTCMinutes());

getUTCMonth (mtodo Date.getUTCMonth)

public getUTCMonth() : Number
Devuelve el mes (de 0 [enero] a 11 [diciembre]) del objeto Date especificado de acuerdo con la hora universal. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea un nuevo objeto Date y emplea Date.getUTCMonth() y Date.getMonth(). El valor que devuelve Date.getUTCMonth() puede ser distinto del valor que devuelve Date.getMonth() si la fecha del da es el primer o el ltimo da del mes, segn la relacin existente entre la zona horaria local y la hora universal.
var today_date:Date = new Date(); trace(today_date.getMonth()); // output based on local timezone trace(today_date.getUTCMonth()); // output equals getMonth() plus or minus 1
Vase tambin
getMonth (mtodo Date.getMonth)
getUTCSeconds (mtodo Date.getUTCSeconds)

public getUTCSeconds() : Number
Devuelve los segundos (entero de 0 a 59) del objeto Date especificado de acuerdo con la hora universal. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea un objeto new Date y utiliza getUTCSeconds() para devolver el valor en segundos del objeto Date.
var today_date:Date = new Date(); trace(today_date.getUTCSeconds());
getUTCYear (mtodo Date.getUTCYear)

public getUTCYear() : Number
Devuelve el ao de este objeto Date segn la hora universal (UTC). El ao es el ao completo menos 1900. Por ejemplo, el ao 2000 se representa como 100. Disponibilidad Flash Lite 2.0

Valor devuelto Number Ejemplo El ejemplo siguiente crea un nuevo objeto Date y emplea Date.getUTCFullYear() y Date.getFullYear(). El valor que devuelve Date.getUTCFullYear() puede ser distinto del valor que devuelve Date.getFullYear() si la fecha del da es 31 de diciembre o 1 de enero, segn la relacin existente entre la zona horaria local y la hora universal.
var today_date:Date = new Date(); trace(today_date.getFullYear()); // display based on local timezone trace(today_date.getUTCFullYear()); // displays getYear() plus or minus 1
getYear (mtodo Date.getYear)

public getYear() : Number
Devuelve el ao del objeto Date especificado de acuerdo con la hora local. La hora local la determina el sistema operativo en el que se ejecuta Flash Lite Player. El ao es el ao completo menos 1900. Por ejemplo, el ao 2000 se representa como 100. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea un objeto Date con el mes y el ao como mayo de 2004. El mtodo Date.getYear() devuelve 104 y Date.getFullYear() devuelve 2004:
var today_date:Date = new Date(2004,4); trace(today_date.getYear()); // output: 104 trace(today_date.getFullYear()); // output: 2004
Vase tambin
setDate (mtodo Date.setDate)

public setDate(date:Number) : Number
Establece el da del mes para el objeto Date especificado de acuerdo con la hora local y devuelve la nueva hora en milisegundos. La hora local la determina el sistema operativo en el que se ejecuta Flash Lite Player. Disponibilidad Flash Lite 2.0 Parmetros date:Number - Entero de 1 a 31.

Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea inicialmente un objeto new Date, que establece la fecha como 15 de mayo de 2004 y utiliza Date.setDate() para cambiar la fecha a 25 de mayo de 2004.
var today_date:Date = new Date(2004,4,15); trace(today_date.getDate()); //displays 15 today_date.setDate(25); trace(today_date.getDate()); //displays 25
setFullYear (mtodo Date.setFullYear)

public setFullYear(year:Number, [month:Number], [date:Number]) : Number
Establece el ao del objeto Date especificado de acuerdo con la hora local y devuelve la nueva hora en milisegundos. Si se especifican los parmetros month y date, stos se establecen con la hora local. La hora local la determina el sistema operativo en el que se ejecuta Flash Lite Player. La llamada a este mtodo no modifica los dems campos del objeto Date especificado, aunque Date.getUTCDay() y
Date.getDay() pueden indicar un nuevo valor si cambia el da de la semana como resultado de la llamada a este
mtodo. Disponibilidad Flash Lite 2.0 Parmetros year:Number - Nmero de cuatro dgitos que especifica un ao. Los nmeros de dos dgitos no representan aos de cuatro dgitos; por ejemplo, 99 no es el ao 1999, sino el ao 99. month:Number [opcional] - Entero de 0 (enero) a 11 (diciembre). Si se omite este parmetro, no se modificar el campo month del objeto Date especificado. date:Number [opcional] - Nmero del 1 al 31. Si se omite este parmetro, no se modificar el campo date del objeto Date especificado. Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea inicialmente un objeto new Date, que establece la fecha como 15 de mayo de 2004 y utiliza Date.setFullYear() para cambiar la fecha a 15 de mayo de 2002:
var my_date:Date = new Date(2004,4,15); trace(my_date.getFullYear()); //output: 2004 my_date.setFullYear(2002); trace(my_date.getFullYear()); //output: 2002
Vase tambin
getUTCDay (mtodo Date.getUTCDay), getDay (mtodo Date.getDay)

setHours (mtodo Date.setHours)

public setHours(hour:Number) : Number
Establece las horas del objeto Date especificado de acuerdo con la hora local y devuelve la nueva hora en milisegundos. La hora local la determina el sistema operativo en el que se ejecuta Flash Lite Player. Disponibilidad Flash Lite 2.0 Parmetros hour:Number - Entero de 0 (medianoche) a 23 (11 de la noche). Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea inicialmente un objeto new Date, que establece la hora y la fecha como 8:00 de la maana del 15 de mayo de 2004, y utiliza Date.setHours() para cambiar la hora a las 4:00 de la tarde:
var my_date:Date = new Date(2004,4,15,8); trace(my_date.getHours()); // output: 8 my_date.setHours(16); trace(my_date.getHours()); // output: 16
setMilliseconds (mtodo Date.setMilliseconds)

public setMilliseconds(millisecond:Number) : Number
Establece los milisegundos del objeto Date especificado de acuerdo con la hora local y devuelve la nueva hora en milisegundos. La hora local la determina el sistema operativo en el que se ejecuta Flash Lite Player. Disponibilidad Flash Lite 2.0 Parmetros millisecond:Number - Entero de 1 a 999. Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea inicialmente un objeto new Date, que establece la fecha como las 8:30 de la maana del 15 de mayo de 2004 con el valor de milisegundos como 250 y, a continuacin, utiliza Date.setMilliseconds() para cambiar el valor de milisegundos a 575:
var my_date:Date = new Date(2004,4,15,8,30,0,250); trace(my_date.getMilliseconds()); // output: 250 my_date.setMilliseconds(575); trace(my_date.getMilliseconds()); // output: 575

setMinutes (mtodo Date.setMinutes)

public setMinutes(minute:Number) : Number
Establece los minutos del objeto Date especificado de acuerdo con la hora local y devuelve la nueva hora en milisegundos. La hora local la determina el sistema operativo en el que se ejecuta Flash Lite Player. Disponibilidad Flash Lite 2.0 Parmetros minute:Number - Entero de 1 a 59. Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea inicialmente un objeto new Date, que establece la hora y la fecha como las 8:00 de la maana del 15 de mayo de 2004 y, a continuacin, utiliza Date.setMinutes() para cambiar la hora a las 8:30 de la maana:
var my_date:Date = new Date(2004,4,15,8,0); trace(my_date.getMinutes()); // output: 0 my_date.setMinutes(30); trace(my_date.getMinutes()); // output: 30
setMonth (mtodo Date.setMonth)

public setMonth(month:Number, [date:Number]) : Number
Establece el mes del objeto Date especificado en la hora local y devuelve la nueva hora en milisegundos. La hora local la determina el sistema operativo en el que se ejecuta Flash Lite Player. Disponibilidad Flash Lite 2.0 Parmetros month:Number - Un entero de 0 (enero) a 11 (diciembre). date:Number [opcional] - Entero de 1 a 31. Si se omite este parmetro, no se modificar el campo date del objeto Date especificado. Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea inicialmente un objeto new Date, que establece la fecha como 15 de mayo de 2004 y utiliza Date.setMonth() para cambiar la fecha a 15 de junio de 2004.
var my_date:Date = new Date(2004,4,15); trace(my_date.getMonth()); //output: 4 my_date.setMonth(5); trace(my_date.getMonth()); //output: 5

setSeconds (mtodo Date.setSeconds)

public setSeconds(second:Number) : Number
Establece los segundos del objeto Date especificado en la hora local y devuelve la nueva hora en milisegundos. La hora local la determina el sistema operativo en el que se ejecuta Flash Lite Player. Disponibilidad Flash Lite 2.0 Parmetros second:Number - Entero de 1 a 59. Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea inicialmente un objeto new Date, que establece la hora y la fecha como 08:00:00 de la maana del 15 de mayo de 2004, y utiliza Date.setSeconds() para cambiar la hora a las 8:00:45 de la maana:
var my_date:Date = new Date(2004,4,15,8,0,0); trace(my_date.getSeconds()); // output: 0 my_date.setSeconds(45); trace(my_date.getSeconds()); // output: 45
setTime (mtodo Date.setTime)

public setTime(millisecond:Number) : Number
Establece la fecha del objeto Date especificado en milisegundos desde la media noche del 1 de enero de 1970 y devuelve la nueva hora en milisegundos. Disponibilidad Flash Lite 2.0 Parmetros millisecond:Number - Nmero; un valor de entero, donde 0 es la medianoche del 1 de enero, hora universal. Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea inicialmente un objeto new Date, que establece la hora y la fecha como 08:00:00 de la maana del 15 de mayo de 2004, y utiliza Date.setTime() para cambiar la hora a las 08:30:00 de la maana:

var my_date:Date = new Date(2004,4,15,8,0,0); var myDate_num:Number = my_date.getTime(); // convert my_date to milliseconds myDate_num += 30 * 60 * 1000; // add 30 minutes in milliseconds my_date.setTime(myDate_num); // set my_date Date object 30 minutes forward trace(my_date.getFullYear()); // output: 2004 trace(my_date.getMonth()); // output: 4 trace(my_date.getDate()); // output: 15 trace(my_date.getHours()); // output: 8 trace(my_date.getMinutes()); // output: 30
setUTCDate (mtodo Date.setUTCDate)

public setUTCDate(date:Number) : Number
Establece la fecha del objeto Date especificado en la hora universal y devuelve la nueva hora en milisegundos. La llamada a este mtodo no modifica los dems campos del objeto Date especificado, aunque Date.getUTCDay() y Date.getDay() pueden indicar un nuevo valor si cambia el da de la semana como resultado de la llamada a este mtodo. Disponibilidad Flash Lite 2.0 Parmetros date:Number - Un nmero; un entero de 1 a 31. Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea inicialmente un objeto new Date con la fecha del da, utiliza Date.setUTCDate() para cambiar el valor de fecha a 10 y lo vuelve a cambiar a 25:
var my_date:Date = new Date(); my_date.setUTCDate(10); trace(my_date.getUTCDate()); // output: 10 my_date.setUTCDate(25); trace(my_date.getUTCDate()); // output: 25
Vase tambin
getUTCFullYear (mtodo Date.getUTCFullYear)

public setUTCFullYear(year:Number, [month:Number], [date:Number]) : Number
Establece el ao del objeto Date especificado (my_date) en la hora universal y devuelve la nueva hora en milisegundos. Opcionalmente, este mtodo tambin puede establecer el mes y la fecha representados por el objeto Date especificado. La llamada a este mtodo no modifica los dems campos del objeto Date especificado, aunque Date.getUTCDay() y Date.getDay() pueden indicar un nuevo valor si cambia el da de la semana como resultado de la llamada a este mtodo.

Disponibilidad Flash Lite 2.0 Parmetros year:Number - Entero que representa el ao especificado como ao completo de cuatro dgitos, como 2000. month:Number [opcional] - Entero de 0 (enero) a 11 (diciembre). Si se omite este parmetro, no se modificar el campo month del objeto Date especificado. date:Number [opcional] - Entero de 1 a 31. Si se omite este parmetro, no se modificar el campo date del objeto Date especificado. Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea inicialmente un objeto new Date con la fecha del da, utiliza Date.setUTCFullYear() para cambiar el valor de ao a 2001 y cambia la fecha a 25 de mayo de 1995:
var my_date:Date = new Date(); my_date.setUTCFullYear(2001); trace(my_date.getUTCFullYear()); // output: 2001 my_date.setUTCFullYear(1995, 4, 25); trace(my_date.getUTCFullYear()); // output: 1995 trace(my_date.getUTCMonth()); // output: 4 trace(my_date.getUTCDate()); // output: 25
Vase tambin
setUTCHours (mtodo Date.setUTCHours)

public setUTCHours(hour:Number, [minute:Number], [second:Number], [millisecond:Number]) : Number
Establece la hora del objeto Date especificado en la hora universal y devuelve la nueva hora en milisegundos. Disponibilidad Flash Lite 2.0 Parmetros hour:Number - Nmero; entero de 0 (medianoche) a 23 (11 de la noche). minute:Number [opcional] - Nmero entero de 0 a 59. Si se omite este parmetro, no se modificar el campo minutes del objeto Date especificado. second:Number [opcional] - Nmero entero de 0 a 59. Si se omite este parmetro, no se modificar el campo seconds del objeto Date especificado. millisecond:Number [opcional] - Nmero entero de 0 a 999. Si se omite este parmetro, no se modificar el campo milliseconds del objeto Date especificado.

Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea inicialmente un objeto new Date con la fecha del da, utiliza Date.setUTCHours() para cambiar la hora a 8:30 de la maana y vuelve a cambiar la hora a 5:30:47 de la tarde:
var my_date:Date = new Date(); my_date.setUTCHours(8,30); trace(my_date.getUTCHours()); // output: 8 trace(my_date.getUTCMinutes()); // output: 30 my_date.setUTCHours(17,30,47); trace(my_date.getUTCHours()); // output: 17 trace(my_date.getUTCMinutes()); // output: 30 trace(my_date.getUTCSeconds()); // output: 47
setUTCMilliseconds (mtodo Date.setUTCMilliseconds)

public setUTCMilliseconds(millisecond:Number) : Number
Establece los milisegundos del objeto Date especificado en la hora universal y devuelve la nueva hora en milisegundos. Disponibilidad Flash Lite 2.0 Parmetros millisecond:Number - Entero de 1 a 999. Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea inicialmente un objeto new Date, que establece la fecha como las 8:30 de la maana del 15 de mayo de 2004 con el valor de milisegundos como 250 y, a continuacin, utiliza Date.setUTCMilliseconds() para cambiar el valor de milisegundos a 575:
var my_date:Date = new Date(2004,4,15,8,30,0,250); trace(my_date.getUTCMilliseconds()); // output: 250 my_date.setUTCMilliseconds(575); trace(my_date.getUTCMilliseconds()); // output: 575
setUTCMinutes (mtodo Date.setUTCMinutes)

public setUTCMinutes(minute:Number, [second:Number], [millisecond:Number]) : Number
Establece el minuto del objeto Date especificado en la hora universal y devuelve la nueva hora en milisegundos. Disponibilidad Flash Lite 2.0 Parmetros minute:Number - Entero de 1 a 59.

second:Number [opcional] - Entero de 0 a 59. Si se omite este parmetro, no se modificar el campo seconds del objeto Date especificado. millisecond:Number [opcional] - Entero de 0 a 999. Si se omite este parmetro, no se modificar el campo milliseconds del objeto Date especificado. Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea inicialmente un objeto new Date, que establece la hora y la fecha como 08:00:00 de la maana del 15 de mayo de 2004, y utiliza Date.setUTCMinutes() para cambiar la hora a las 08:30:00 de la maana:
var my_date:Date = new Date(2004,4,15,8,0); trace(my_date.getUTCMinutes()); // output: 0 my_date.setUTCMinutes(30); trace(my_date.getUTCMinutes()); // output: 30
setUTCMonth (mtodo Date.setUTCMonth)

public setUTCMonth(month:Number, [date:Number]) : Number
Establece el mes y, opcionalmente, el da del objeto Date especificado en la hora universal y devuelve la nueva hora en milisegundos. La llamada a este mtodo no modifica los dems campos del objeto Date especificado, aunque Date.getUTCDay() y Date.getDay() podran indicar un nuevo valor si cambia el da de la semana como resultado de especificar un valor para el parmetro date. Disponibilidad Flash Lite 2.0 Parmetros month:Number - Un entero de 0 (enero) a 11 (diciembre). date:Number [opcional] - Entero de 1 a 31. Si se omite este parmetro, no se modificar el campo date del objeto Date especificado. Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea inicialmente un objeto new Date, que establece la fecha como 15 de mayo de 2004 y utiliza Date.setMonth() para cambiar la fecha a 15 de junio de 2004.
var today_date:Date = new Date(2004,4,15); trace(today_date.getUTCMonth()); // output: 4 today_date.setUTCMonth(5); trace(today_date.getUTCMonth()); // output: 5
Vase tambin

setUTCSeconds (mtodo Date.setUTCSeconds)

public setUTCSeconds(second:Number, [millisecond:Number]) : Number
Establece los segundos del objeto Date especificado en la hora universal y devuelve la nueva hora en milisegundos. Disponibilidad Flash Lite 2.0 Parmetros second:Number - Entero de 1 a 59. millisecond:Number [opcional] - Entero de 0 a 999. Si se omite este parmetro, no se modificar el campo milliseconds del objeto Date especificado. Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea inicialmente un objeto new Date, que establece la hora y la fecha como 08:00:00 de la maana del 15 de mayo de 2004, y utiliza Date.setSeconds() para cambiar la hora a las 08:30:45 de la maana:
var my_date:Date = new Date(2004,4,15,8,0,0); trace(my_date.getUTCSeconds()); // output: 0 my_date.setUTCSeconds(45); trace(my_date.getUTCSeconds()); // output: 45
setYear (mtodo Date.setYear)

public setYear(year:Number) : Number
Establece el ao del objeto Date especificado en la hora local y devuelve la nueva hora en milisegundos. La hora local la determina el sistema operativo en el que se ejecuta Flash Lite Player. Disponibilidad Flash Lite 2.0 Parmetros year:Number - Nmero que representa el ao. Si year es un entero entre 0 y 99, setYear define el ao como 1900 + year ; en caso contrario, el ao es el valor del parmetro year. Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea un objeto new Date en el que se establece la fecha como 25 de mayo de 2004, utiliza setYear() para cambiar el ao a 1999 y cambia el ao a 2003:

var my_date:Date = new Date(2004,4,25); trace(my_date.getYear()); // output: 104 trace(my_date.getFullYear()); // output: 2004 my_date.setYear(99); trace(my_date.getYear()); // output: 99 trace(my_date.getFullYear()); // output: 1999 my_date.setYear(2003); trace(my_date.getYear()); // output: 103 trace(my_date.getFullYear()); // output: 2003
toString (mtodo Date.toString)

Devuelve un valor de cadena para el objeto de fecha especificado en un formato legible. Disponibilidad Flash Lite 2.0 Valor devuelto String - Una cadena. Ejemplo El ejemplo siguiente devuelve la informacin del objeto Date dateOfBirth_date como una cadena. El resultado de las sentencias trace est en hora local y varan segn corresponda. En el caso del horario de verano de la costa del Pacfico de EE.UU, el resultado es siete horas anterior a la hora universal: lunes, 12 de agosto 18:15:00 GMT-0700 de 1974.
var dateOfBirth_date:Date = new Date(74, 7, 12, 18, 15); trace (dateOfBirth_date); trace (dateOfBirth_date.toString());
UTC (mtodo Date.UTC)

public static UTC(year:Number, month:Number, [date:Number], [hour:Number], [minute:Number], [second:Number], [millisecond:Number]) : Number
Devuelve el nmero de milisegundos entre la media noche del 1 de enero de 1970, hora universal, y la hora especificada en los parmetros. Este es un mtodo esttico que se invoca a travs del constructor del objeto Date, no a travs de un objeto Date especfico. Este mtodo permite crear un objeto Date que supone que la fecha est en la hora universal, mientras que el constructor de Date supone que la fecha est en la hora local. Disponibilidad Flash Lite 2.0 Parmetros year:Number - Entero de cuatro dgitos que representa el ao (por ejemplo, 2000). month:Number - Un entero de 0 (enero) a 11 (diciembre). date:Number [opcional] - Entero de 1 a 31. hour:Number [opcional] - Entero de 0 (medianoche) a 23 (11 de la noche).

minute:Number [opcional] - Entero de 0 a 59. second:Number [opcional] - Entero de 0 a 59. millisecond:Number [opcional] - Entero de 0 a 999. Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea un nuevo objeto Date maryBirthday_date definido en hora universal. Esta es la variacin en hora universal del ejemplo empleado con el mtodo del constructor new Date. El resultado se expresa en hora local y vara segn corresponda. En el caso del horario de verano de la costa del Pacfico de EE.UU, el resultado es siete horas anterior a la hora universal: domingo, 11 de agosto 17:00:00 GMT-0700 de 1974.
var maryBirthday_date:Date = new Date(Date.UTC(1974, 7, 12)); trace(maryBirthday_date);
valueOf (mtodo Date.valueOf)

public valueOf() : Number
Devuelve el nmero de milisegundos desde la media noche del 1 de enero de 1970, hora universal, para este objeto Date. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Nmero de milisegundos.
Error
Object | +-Error public class Error extends Object
Contiene informacin sobre un error que se ha producido en un guin. Puede crear un objeto Error utilizando la funcin constructora Error. Normalmente emitir (throw) un nuevo objeto Error desde dentro de un bloque de cdigo try que posteriormente ser detectado por un bloque de cdigo catch o finally. Tambin puede crear una subclase de la clase Error y emitir instancias de dicha subclase. Disponibilidad Flash Lite 2.0

Modificadores Propiedad message:String name:String Descripcin Contiene el mensaje asociado al objeto Error. Contiene el nombre del objeto Error.

Firma Error([message:String
])
Descripcin Crea un nuevo objeto Error.
Resumen de mtodos
Modificadores Firma toString() : String Descripcin Devuelve la cadena "Error" de manera predeterminada o el valor contenido en Error.message, si se ha definido.

Constructor Error
public Error([message:String])
Crea un nuevo objeto Error. Si se pasa un parmetro message, su valor se asignar a la propiedad Error.message. Disponibilidad Flash Lite 2.0 Parmetros message:String [opcional] - Cadena asociada al objeto Error. Ejemplo En el ejemplo siguiente, una funcin emite un error (con un mensaje especificado) si las dos cadenas que se pasan no son idnticas:

function compareStrings(str1_str:String, str2_str:String):Void { if (str1_str != str2_str) { throw new Error("Strings do not match."); } } try { compareStrings("Dog", "dog"); // output: Strings do not match. } catch (e_err:Error) { trace(e_err.toString()); }
Vase tambin
throw, sentencia, try..catch..finally statement
message (propiedad Error.message)

public message : String
Mensaje asociado al objeto Error. De manera predeterminada, el valor de esta propiedad es "Error". Puede especificar una propiedad message cuando cree un objeto Error pasando la cadena de error a la funcin constructora Error. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente, una funcin emite un mensaje especificado segn los parmetros introducidos en theNum. Si pueden dividirse dos nmeros, se mostrarn SUCCESS y el nmero. Se mostrarn errores especficos si se intenta dividir entre 0 o slo se introduce un parmetro:
function divideNum(num1:Number, num2:Number):Number { if (isNaN(num1) || isNaN(num2)) { throw new Error("divideNum function requires two numeric parameters."); } else if (num2 == 0) { throw new Error("cannot divide by zero."); } return num1/num2; } try { var theNum:Number = divideNum(1, 0); trace("SUCCESS! "+theNum); } catch (e_err:Error) { trace("ERROR! "+e_err.message); trace("\t"+e_err.name); }
Si prueba este cdigo ActionScript sin ninguna modificacin en los nmeros que se dividen, aparecer un error en el panel Salida porque est intentando dividir entre 0. Vase tambin

name (propiedad Error.name)

public name : String
Contiene el nombre del objeto Error. De manera predeterminada, el valor de esta propiedad es "Error". Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente, una funcin emite un error especificado segn los dos nmeros que se intentan dividir. Aada el cdigo ActionScript siguiente al fotograma 1 de la lnea de tiempo:
function divideNumber(numerator:Number, denominator:Number):Number { if (isNaN(numerator) || isNaN(denominator)) { throw new Error("divideNumber() function requires two numeric parameters."); } else if (denominator == 0) { throw new DivideByZeroError(); } return numerator/denominator; } try { var theNum:Number = divideNumber(1, 0); trace("SUCCESS! "+theNum); // output: DivideByZeroError -> Unable to divide by zero. } catch (e_err:DivideByZeroError) { // divide by zero error occurred trace(e_err.name+" -> "+e_err.toString()); } catch (e_err:Error) { // generic error occurred trace(e_err.name+" -> "+e_err.toString()); }
Aada el siguiente cdigo a un archivo .as llamado DivideByZeroError.as y guarde el archivo de clase en el mismo directorio que el documento .fla.
class DivideByZeroError extends Error { var name:String = "DivideByZeroError"; var message:String = "Unable to divide by zero."; }
Vase tambin
toString (mtodo Error.toString)

Devuelve la cadena "Error" o el valor contenido en Error.message, si se ha definido. Disponibilidad Flash Lite 2.0 Valor devuelto String Cadena

Ejemplo En el ejemplo siguiente, una funcin emite un error (con un mensaje especificado) si las dos cadenas que se pasan no son idnticas:
function compareStrings(str1_str:String, str2_str:String):Void { if (str1_str != str2_str) { throw new Error("Strings do not match."); } } try { compareStrings("Dog", "dog"); // output: Strings do not match. } catch (e_err:Error) { trace(e_err.toString()); }
Vase tambin
message (propiedad Error.message), throw, sentencia, try..catch..finally statement
ExtendedKey
Object | +-ExtendedKey public class ExtendedKey extends Object
Proporciona cdigos de teclas ampliados que se pueden devolver desde el mtodo Key.getCode(). Disponibilidad Flash Lite 2.0 Ejemplo El siguiente ejemplo crea un detector al que se llama cuando se pulsa una tecla. Utiliza el mtodo Key.getCode() para obtener el cdigo de tecla de la tecla presionada:
var myListener = new Object(); myListener.onKeyDown = function() { var code = Key.getCode(); trace(code + " down"); } myListener.onKeyUp = function() { trace("onKeyUp called"); } Key.addListener(myListener);
Vase tambin
getCode (mtodo Key.getCode)

Modificadores
static static static static static static static static static static static static
Propiedad SOFT1:String SOFT3:String SOFT4:String SOFT5:String SOFT6:String SOFT7:String SOFT8:String SOFT9:String SOFT10:String SOFT11:String SOFT12:String SOFT2:String
Descripcin Valor del cdigo de tecla para la tecla programable SOFT1. Valor del cdigo de tecla para la tecla programable SOFT3. Valor del cdigo de tecla para la tecla programable SOFT4. Valor del cdigo de tecla para la tecla programable SOFT5. Valor del cdigo de tecla para la tecla programable SOFT6. Valor del cdigo de tecla para la tecla programable SOFT7. Valor del cdigo de tecla para la tecla programable SOFT8. Valor del cdigo de tecla para la tecla programable SOFT9. Valor del cdigo de tecla para la tecla programable SOFT10. Valor del cdigo de tecla para la tecla programable SOFT11. Valor del cdigo de tecla para la tecla programable SOFT12. Valor del cdigo de tecla para la tecla programable SOFT2.


SOFT1 (propiedad ExtendedKey.SOFT1)

public static SOFT1 : String
Valor del cdigo de tecla para la tecla programable SOFT1. El cdigo de tecla SOFT1 siempre corresponde a la tecla programable izquierda; SOFT2 siempre corresponde a la tecla programable derecha. Disponibilidad Flash Lite 2.0 Ejemplo El siguiente ejemplo crea un detector que gestiona las teclas programables izquierda y derecha:

var myListener:Object = new Object(); myListener.onKeyDown = function () { var keyCode = Key.getCode(); switch (keyCode) { case ExtendedKey.SOFT1: // Handle left soft key. break; case ExtendedKey.SOFT2: // Handle right soft key break; } } Key.addListener(myListener);

Valor del cdigo de tecla para la tecla programable SOFT2. El cdigo de tecla SOFT2 siempre corresponde a la tecla programable derecha; SOFT1 siempre corresponde a la tecla programable izquierda. Disponibilidad Flash Lite 2.0 Vase tambin

Valor del cdigo de tecla para la tecla programable SOFT3. Disponibilidad Flash Lite 2.0







Valor del cdigo de tecla para la tecla programable SOFT9.




Function
Object | +-Function public dynamic class Function extends Object
Tanto las funciones definidas por el usuario como las funciones incorporadas de ActionScript se representan mediante objetos Function, que son instancias de la funcin Function. Disponibilidad Flash Lite 2.0 Resumen de propiedades Propiedades heredadas de la clase Object
Resumen de mtodos
Modificadores Firma Descripcin
apply(thisObject:Obje Especifica el valor de thisObject que debe utilizarse dentro ct, [argArray:Array]) de cualquier funcin a la que llame ActionScript. call(thisObject:Object
, [parameter1:Object])
Invoca la funcin representada por un objeto Function.

apply (mtodo Function.apply)

public apply(thisObject:Object, [argArray:Array])
Especifica el valor de thisObject que debe utilizarse dentro de cualquier funcin a la que llame ActionScript. Este mtodo tambin especifica los parmetros que deben pasarse a las funciones llamadas. Dado que apply() es un mtodo de la clase Function, es tambin un mtodo de todos los objetos Function de ActionScript.

Los parmetros se especifican como objeto Array, a diferencia de Function.call(), que especifica los parmetros como una lista separada por comas. Suele ser til cuando no se conoce el nmero de parmetros que se van a pasar hasta que se ejecuta el guin. Devuelve el valor que la funcin llamada especifica como el valor de devolucin. Disponibilidad Flash Lite 2.0 Parmetros thisObject:Object - Objeto al que se aplica myFunction. argArray:Array [opcional] - Matriz cuyos elementos se pasan a myFunction como parmetros. Valor devuelto Cualquier valor especificado por la funcin llamada. Ejemplo Las siguientes invocaciones de funcin son equivalentes:
Math.atan2(1, 0) Math.atan2.apply(null, [1, 0])
El siguiente ejemplo muestra cmo apply() pasa una matriz de parmetros:

function theFunction() { trace(arguments); } // create a new array to pass as a parameter to apply() var firstArray:Array = new Array(1,2,3); theFunction.apply(null,firstArray); // outputs: 1,2,3 // create a second array to pass as a parameter to apply() var secondArray:Array = new Array("a", "b", "c"); theFunction.apply(null,secondArray); // outputs a,b,c
El ejemplo siguiente muestra cmo apply() pasa una matriz de parmetros y especifica el valor de sta:

// define a function function theFunction() { trace("this == myObj? " + (this == myObj)); trace("arguments: " + arguments); } // instantiate an object var myObj:Object = new Object(); // create arrays to pass as a parameter to apply() var firstArray:Array = new Array(1,2,3); var secondArray:Array = new Array("a", "b", "c"); // use apply() to set the value of this to be myObj and send firstArray theFunction.apply(myObj,firstArray); // output: // this == myObj? true // arguments: 1,2,3 // use apply() to set the value of this to be myObj and send secondArray theFunction.apply(myObj,secondArray); // output: // this == myObj? true // arguments: a,b,c
Vase tambin
call (mtodo Function.call)
call (mtodo Function.call)

public call(thisObject:Object, [parameter1:Object])
Invoca la funcin representada por un objeto Function. Cada funcin de ActionScript se representa mediante un objeto Function, de modo que todas las funciones admiten este mtodo. En casi todos los casos puede utilizarse el operador de llamada de funcin (()) en lugar de este mtodo. El operador de llamada de funcin hace que el cdigo sea conciso y legible. Este mtodo es de gran utilidad cuando debe controlarse explcitamente el parmetro thisObject de la llamada de funcin. Normalmente, si se invoca una funcin como mtodo de un objeto, el parmetro thisObject se establece en myObject dentro del cuerpo de la funcin, como se muestra en el siguiente ejemplo:
myObject.myMethod(1, 2, 3);
En algunos casos, es posible que desee que thisObject haga referencia a otro elemento; por ejemplo, si debe invocarse una funcin como un mtodo de un objeto, pero en realidad no se almacena como mtodo de dicho objeto:
myObject.myMethod.call(myOtherObject, 1, 2, 3);
Puede pasar el valor null para el parmetro thisObject para invocar una funcin como funcin regular y no como un mtodo de un objeto. Por ejemplo, las llamadas de funcin siguientes son equivalentes:
Math.sin(Math.PI / 4) Math.sin.call(null, Math.PI / 4)
Devuelve el valor que la funcin llamada especifica como el valor de devolucin.

Disponibilidad Flash Lite 2.0 Parmetros thisObject:Object - Objeto que especifica el valor de thisObject en el cuerpo de la funcin. parameter1:Object [opcional] - Parmetro que se pasa a myFunction. Puede especificar cero o ms parmetros. Ejemplo El ejemplo siguiente utiliza Function.call() para hacer que una funcin se comporte como un mtodo de otro objeto, sin almacenar la funcin en el objeto:
function myObject() { } function myMethod(obj) { trace("this == obj? " + (this == obj)); } var obj:Object = new myObject(); myMethod.call(obj, obj);
La sentencia trace() muestra:

this == obj? true
Vase tambin
apply (mtodo Function.apply)
Key
Object | +-Key public class Key extends Object
La clase Key es una clase de nivel superior cuyos mtodos y propiedades se pueden utilizar sin emplear un constructor. Utilice los mtodos de la clase Key para crear interfaces. Las propiedades de la clase Key son constantes que representan las teclas ms utilizadas en las aplicaciones de control, como las teclas de flecha, AvPg y RePg. Utilice las propiedades System.capabilities para determinar las teclas que admite un dispositivo. No todos los dispositivos y tipos de contenido de Flash Lite admiten todas las teclas. Por ejemplo, los dispositivos que admiten navegacin en dos direcciones no son compatibles con las teclas de desplazamiento izquierda y derecha. Asimismo, no todos los dispositivos tienen acceso a las teclas programables de un dispositivo. Para obtener ms informacin, consulte Desarrollo de aplicaciones Flash Lite 2.x y 3.x. Disponibilidad Flash Lite 2.0 Vase tambin
ExtendedKey

has4WayKeyAS (propiedad capabilities.has4WayKeyAS) en la pgina 250 hasMappableSoftKeys (propiedad capabilities.hasMappableSoftKeys) en la pgina 254 hasQWERTYKeyboard (propiedad capabilities.hasQWERTYKeyboard) en la pgina 256 softKeyCount (propiedad capabilities.softKeyCount) en la pgina 264
Modificadores
static static static static static
Propiedad BACKSPACE:Number CAPSLOCK:Number CONTROL:Number DELETEKEY:Number DOWN:Number
Descripcin Valor de cdigo de tecla asociado a la tecla Retroceso (8). Valor de cdigo de tecla asociado a la tecla Bloq Mays (20). Valor de cdigo de tecla asociado a la tecla Control (17). Valor de cdigo de tecla asociado a la tecla Supr (46). Valor de cdigo de tecla asociado a la tecla de flecha abajo (40). Valor de cdigo de tecla asociado a la tecla Fin (35). Valor de cdigo de tecla asociado a la tecla Intro (13). Valor de cdigo de tecla asociado a la tecla Esc (27). Valor de cdigo de tecla asociado a la tecla Inicio (36). Valor de cdigo de tecla asociado a la tecla Insert (45). Valor de cdigo de tecla asociado a la tecla de flecha izquierda (37). Lista de referencias a todos los objetos detectores registrados con el objeto Key. Valor de cdigo de tecla asociado a la tecla AvPg (34). Valor de cdigo de tecla asociado a la tecla RePg (33). Valor de cdigo de tecla asociado a la tecla de flecha derecha (39). Valor de cdigo de tecla asociado a la tecla Mays (16). Valor de cdigo de tecla asociado a la tecla Barra espaciadora (32). Valor de cdigo de tecla asociado a la tecla Tabulador (9). Valor de cdigo de tecla asociado a la tecla de flecha arriba (38).
static static static static static static
END:Number ENTER:Number ESCAPE:Number HOME:Number INSERT:Number LEFT:Number
static
_listeners:Array [slo lectura] PGDN:Number PGUP:Number RIGHT:Number
static static static
static static
SHIFT:Number SPACE:Number
static static
TAB:Number UP:Number


Resumen de eventos
Evento onKeyDown =
function() {}
Descripcin Se notifica cuando se presiona una tecla.
onKeyUp =
function() {}
Se notifica cuando se suelta una tecla.
Resumen de mtodos
Modificadores
static
Firma addListener(listener: Object) : Void getAscii() : Number
Descripcin Registra un objeto para recibir notificacin de onKeyDown y

onKeyUp.
static
Devuelve el cdigo ASCII de la ltima tecla presionada o soltada. Devuelve el valor del cdigo de la ltima tecla presionada. Devuelve true si est presionada la tecla especificada en code ; false, en caso contrario.
static static
getCode() : Number isDown(code:Number) : Boolean
static
removeListener(listene Elimina un objeto registrado previamente con r:Object) : Boolean Key.addListener().

addProperty (mtodo Object.addProperty), hasOwnProperty (mtodo Object.hasOwnProperty), isPropertyEnumerable (mtodo Object.isPropertyEnumerable), isPrototypeOf (mtodo Object.isPrototypeOf)registerClass (mtodo Object.registerClass), toString (mtodo Object.toString)unwatch (mtodo Object.unwatch), valueOf (mtodo Object.valueOf), watch (mtodo Object.watch)
addListener (mtodo Key.addListener)

public static addListener(listener:Object) : Void
Registra un objeto para recibir notificaciones de onKeyDown y onKeyUp. Cuando se presiona o se suelta una tecla, con independencia de donde se encuentre la seleccin de entrada del teclado, se invocar el mtodo addListener() u onKeyDown de todos los objetos que estn a la escucha registrados con onKeyUp. Varios objetos pueden detectar las notificaciones de teclado. Disponibilidad Flash Lite 2.0 Parmetros listener:Object - Objeto con los mtodos onKeyDown y onKeyUp. Ejemplo En el ejemplo siguiente se crea un nuevo objeto detector y se definen funciones para onKeyDown y onKeyUp. En la ltima lnea se llama a addListener() para registrar el detector con el objeto Key de modo que se pueda recibir una notificacin de los eventos que se producen al presionar y soltar teclas.

var myListener:Object = new Object(); myListener.onKeyDown = function () { trace ("You pressed a key."); } myListener.onKeyUp = function () { trace ("You released a key."); } Key.addListener(myListener);
Vase tambin
getCode (mtodo Key.getCode), isDown (mtodo Key.isDown), onKeyDown (detector de eventos Key.onKeyDown), onKeyUp (detector de eventos Key.onKeyUp), removeListener (mtodo Key.removeListener)
BACKSPACE (propiedad Key.BACKSPACE)

public static BACKSPACE : Number
Valor de cdigo de tecla asociado a la tecla Retroceso (8). Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se crea un nuevo objeto detector y se define una funcin para onKeyDown. En la ltima lnea se utiliza addListener() para registrar el detector con el objeto Key de modo que se pueda recibir notificacin de los eventos que se producen al presionar teclas.
var keyListener:Object = new Object(); keyListener.onKeyDown = function() { if (Key.isDown(Key.BACKSPACE)) { trace("you pressed the Backspace key."); } else { trace("you DIDN'T press the Backspace key."); } }; Key.addListener(keyListener);
CAPSLOCK (propiedad Key.CAPSLOCK)

public static CAPSLOCK : Number
Valor de cdigo de tecla asociado a la tecla Bloq Mays (20). Disponibilidad Flash Lite 2.0
CONTROL (propiedad Key.CONTROL)

public static CONTROL : Number
Valor de cdigo de tecla asociado a la tecla Control (17).

DELETEKEY (propiedad Key.DELETEKEY)

public static DELETEKEY : Number
Valor de cdigo de tecla asociado a la tecla Supr (46). Disponibilidad Flash Lite 2.0
DOWN (propiedad Key.DOWN)

public static DOWN : Number
Valor de cdigo de tecla asociado a la tecla de flecha abajo (40). Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente mueve un clip de pelcula denominado car_mc hasta una distancia constante (10) al presionar las teclas de flecha. Coloque cualquier clip de pelcula en el escenario y asgnele el nombre de instancia car_mc.
var DISTANCE:Number = 10; var keyListener_obj:Object = new Object(); keyListener_obj.onKeyDown = function() { switch (Key.getCode()) { case Key.LEFT : car_mc._x -= DISTANCE; break; case Key.UP : car_mc._y -= DISTANCE; break; case Key.RIGHT : car_mc._x += DISTANCE; break; case Key.DOWN : car_mc._y += DISTANCE; break; } }; Key.addListener(keyListener_obj);
END (propiedad Key.END)

public static END : Number
Valor de cdigo de tecla asociado a la tecla Fin (35). Disponibilidad Flash Lite 2.0

ENTER (propiedad Key.ENTER)

public static ENTER : Number
Valor de cdigo de tecla asociado a la tecla Intro (13). Disponibilidad Flash Lite 2.0 Ejemplo El siguiente ejemplo mueve un clip de pelcula cuando se presionan las teclas de flecha. El clip de pelcula cuando se presiona Seleccionar y elimina el evento onEnterFrame. Coloque cualquier clip de pelcula en el escenario y asgnele el nombre de instancia car_mc.
var DISTANCE:Number = 5; var keyListener:Object = new Object(); keyListener.onKeyDown = function() { switch (Key.getCode()) { case Key.LEFT : car_mc.onEnterFrame = function() { this._x -= DISTANCE; }; break; case Key.UP : car_mc.onEnterFrame = function() { this._y -= DISTANCE; }; break; case Key.RIGHT : car_mc.onEnterFrame = function() { this._x += DISTANCE; }; break; case Key.DOWN : car_mc.onEnterFrame = function() { this._y += DISTANCE; }; break; case Key.ENTER : delete car_mc.onEnterFrame; break; } }; Key.addListener(keyListener);
ESCAPE (propiedad Key.ESCAPE)

public static ESCAPE : Number
Valor de cdigo de tecla asociado a la tecla Esc (27). Disponibilidad Flash Lite 2.0

Ejemplo En el ejemplo siguiente se define un temporizador. Cuando se presiona Seleccionar, el panel Salida muestra cunto se ha tardado en presionar la tecla.
var keyListener:Object = new Object(); keyListener.onKeyDown = function() { if (Key.isDown(Key.ENTER)) { // get the current timer, convert the value // to seconds and round it to two decimal places. var timer:Number = Math.round(getTimer()/10)/100; trace("You pressed the Select key after: "+getTimer()+"ms ("+timer+"s)"); } }; Key.addListener(keyListener);
getAscii (mtodo Key.getAscii)

public static getAscii() : Number
Devuelve el cdigo ASCII de la ltima tecla presionada o soltada. Los valores ASCII devueltos son los correspondientes a un teclado ingls. Por ejemplo, si presiona Mays+2 en un teclado japons o ingls, Key.getAscii() devuelve @. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Devuelve el valor ASCII de la ltima tecla presionada. Este mtodo devuelve 0 si no se ha presionado ni soltado ninguna tecla, o si no se puede acceder al cdigo ASCII por motivos de seguridad. Ejemplo En el ejemplo siguiente se llama al mtodo getAscii() siempre que se presiona una tecla. En el ejemplo se crea un objeto detector denominado keyListener y se define una funcin que responde al evento onKeyDown realizando una llamada a Key.getAscii(). Despus se registra el objeto keyListener en el objeto Key, que difunde el mensaje onKeyDown siempre que se presione una tecla durante la reproduccin del archivo SWF.
var keyListener:Object = new Object(); keyListener.onKeyDown = function() { trace("The ASCII code for the last key typed is: "+Key.getAscii()); }; Key.addListener(keyListener);
En el ejemplo siguiente se aade una llamada a Key.getAscii() para sealar la diferencia entre getAscii() y getCode(). La principal diferencia es que Key.getAscii() distingue entre caracteres en maysculas y en minsculas, mientras que Key.getCode() no hace distinciones.
var keyListener:Object = new Object(); keyListener.onKeyDown = function() { trace("For the last key typed:"); trace("\tThe Key code is: "+Key.getCode()); trace("\tThe ASCII value is: "+Key.getAscii()); trace(""); }; Key.addListener(keyListener);

getCode (mtodo Key.getCode)

public static getCode() : Number
Devuelve el valor del cdigo de la ltima tecla presionada. la implementacin de Flash Lite de este mtodo devuelve una cadena o un nmero, segn el cdigo de tecla pasado en la plataforma. Los nicos cdigos de teclas vlidos son los cdigos estndar aceptados por esta clase y los cdigos especiales que se muestran como propiedades de la clase ExtendedKey. Disponibilidad Flash Lite 2.0 Valor devuelto Number - El cdigo de tecla de la ltima tecla presionada. Este mtodo devuelve 0 si no se ha presionado ni soltado ninguna tecla, o si no se puede acceder al cdigo de tecla por motivos de seguridad. Ejemplo En el ejemplo siguiente se llama al mtodo getCode() siempre que se presiona una tecla. En el ejemplo se crea un objeto detector denominado keyListener y se define una funcin que responde al evento onKeyDown realizando una llamada a Key.getCode(). Se registra el objeto keyListener en el objeto Key, que difunde el mensaje onKeyDown siempre que se presione una tecla durante la reproduccin del archivo SWF.
var keyListener:Object = new Object(); keyListener.onKeyDown = function() { // Compare return value of getCode() to constant if (Key.getCode() == Key.ENTER) { trace ("Virtual key code: "+Key.getCode()+" (ENTER key)"); } else { trace("Virtual key code: "+Key.getCode()); } }; Key.addListener(keyListener);
En el ejemplo siguiente se aade una llamada a Key.getAscii() para sealar la diferencia entre los dos mtodos. La principal diferencia es que Key.getAscii() distingue entre caracteres en maysculas y en minsculas, mientras que Key.getCode() no hace distinciones.
var keyListener:Object = new Object(); keyListener.onKeyDown = function() { trace("For the last key typed:"); trace("\tThe Key code is: "+Key.getCode()); trace("\tThe ASCII value is: "+Key.getAscii()); trace(""); }; Key.addListener(keyListener);
Disponibilidad Flash Lite 2.0 Vase tambin

getAscii (mtodo Key.getAscii)

HOME (propiedad Key.HOME)

public static HOME : Number
Valor de cdigo de tecla asociado a la tecla Inicio (36). Disponibilidad Flash Lite 2.0
INSERT (propiedad Key.INSERT)

public static INSERT : Number
Valor de cdigo de tecla asociado a la tecla Insert (45). Disponibilidad Flash Lite 2.0
isDown (mtodo Key.isDown)

public static isDown(code:Number) : Boolean
Devuelve true si est presionada la tecla especificada en code ; false, en caso contrario. Disponibilidad Flash Lite 2.0 Parmetros code:Number - Valor de cdigo de tecla asignado a una tecla especfica o propiedad de clase Key asociada con una determinada tecla. Valor devuelto Boolean - Valor true si est presionada la tecla especificada en code; false, en caso contrario. Ejemplo El siguiente guin permite al usuario utilizar las teclas Izquierda y Derecha para controlar la posicin de un clip de pelcula en el escenario llamado car_mc:
car_mc.onEnterFrame = function() { if (Key.isDown(Key.RIGHT)) { this._x += 10; } else if (Key.isDown(Key.LEFT)) { this._x -= 10; } };
LEFT (propiedad Key.LEFT)

public static LEFT : Number
Valor de cdigo de tecla asociado a la tecla de flecha izquierda (37).

_listeners (propiedad Key._listeners)

public static _listeners : Array [read-only]
Lista de referencias a todos los objetos detectores registrados con el objeto Key. Esta propiedad es para uso interno, aunque puede resultar til para determinar el nmero de detectores registrados actualmente en el objeto Key. Los objetos se aaden y se quitan de esta matriz mediante llamadas a los mtodos addListener() y removeListener(). Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se muestra cmo utilizar la propiedad length para determinar el nmero de objetos detectores que estn registrados actualmente en el objeto Key.
var myListener:Object = new Object(); myListener.onKeyDown = function () { trace ("You pressed a key."); } Key.addListener(myListener); trace(Key._listeners.length); // Output: 1
onKeyDown (detector de eventos Key.onKeyDown)

Se notifica cuando se presiona una tecla. Para utilizar onKeyDown, deber crear un objeto detector. Posteriormente podr definir una funcin para onKeyDown y utilizar addListener() para registrar el detector en el objeto Key, como se muestra en el siguiente ejemplo:
var keyListener:Object = new Object(); keyListener.onKeyDown = function() { trace("DOWN -> Code: "+Key.getCode()+"\tACSII: "+Key.getAscii()+"\tKey: "+chr(Key.getAscii())); }; keyListener.onKeyUp = function() { trace("UP -> Code: "+Key.getCode()+"\tACSII: "+Key.getAscii()+"\tKey: "+chr(Key.getAscii())); }; Key.addListener(keyListener);
Los detectores permiten que diversas partes del cdigo cooperen, ya que varios detectores pueden recibir notificacin de un solo evento. Disponibilidad Flash Lite 2.0 Vase tambin

onKeyUp (detector de eventos Key.onKeyUp)

Se notifica cuando se suelta una tecla. Para utilizar onKeyUp, deber crear un objeto detector. Posteriormente podr definir una funcin para onKeyUp y utilizar addListener() para registrar el detector en el objeto Key, como se muestra en el siguiente ejemplo:
var keyListener:Object = new Object(); keyListener.onKeyDown = function() { trace("DOWN -> Code: "+Key.getCode()+"\tACSII: "+Key.getAscii()+"\tKey: "+chr(Key.getAscii())); }; keyListener.onKeyUp = function() { trace("UP -> Code: "+Key.getCode()+"\tACSII: "+Key.getAscii()+"\tKey: "+chr(Key.getAscii())); }; Key.addListener(keyListener);
Los detectores permiten que diversas partes del cdigo cooperen, ya que varios detectores pueden recibir notificacin de un solo evento. Disponibilidad Flash Lite 2.0 Vase tambin
PGDN (propiedad Key.PGDN)

public static PGDN : Number
Valor de cdigo de tecla asociado a la tecla AvPg (34). Disponibilidad Flash Lite 2.0
PGUP (propiedad Key.PGUP)

public static PGUP : Number
Valor de cdigo de tecla asociado a la tecla RePg (33). Disponibilidad Flash Lite 2.0
removeListener (mtodo Key.removeListener)

public static removeListener(listener:Object) : Boolean
Elimina un objeto registrado previamente con Key.addListener(). Disponibilidad Flash Lite 2.0

Parmetros listener:Object - Un objeto. Valor devuelto Boolean - Si listener se ha eliminado correctamente, el mtodo devolver un valor true. Si listener no se ha eliminado correctamente (por ejemplo, porque listener no se encontraba en la lista de detectores del objeto Key), el mtodo devolver false.
RIGHT (propiedad Key.RIGHT)

public static RIGHT : Number
Valor de cdigo de tecla asociado a la tecla de flecha derecha (39). Disponibilidad Flash Lite 2.0 Ejemplo El siguiente ejemplo mueve un clip de pelcula en el escenario llamado car_mc al presionar las teclas de flecha.
SHIFT (propiedad Key.SHIFT)

public static SHIFT : Number
Valor de cdigo de tecla asociado a la tecla Mays (16). Disponibilidad Flash Lite 2.0
SPACE (propiedad Key.SPACE)

public static SPACE : Number
Valor de cdigo de tecla asociado a la tecla Barra espaciadora (32).

TAB (propiedad Key.TAB)

public static TAB : Number
Valor de cdigo de tecla asociado a la tecla Tabulador (9). Disponibilidad Flash Lite 2.0
UP (propiedad Key.UP)
public static UP : Number
Valor de cdigo de tecla asociado a la tecla de flecha arriba (38). Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente mueve un clip de pelcula en el escenario denominado car_mc hasta una distancia constante (10) al presionar las teclas de flecha.

LoadVars
Object | +-LoadVars public dynamic class LoadVars extends Object
La clase LoadVars es una alternativa a la funcin loadVariables() para la transferencia de variables entre Flash Lite y un servidor web a travs de HTTP. Utilice la clase LoadVars para obtener confirmacin de que determinados datos se han cargado correctamente y para controlar el progreso de las descargas. La clase LoadVars permite enviar todas las variables de un objeto a una URL y cargar todas las variables de una URL en un objeto. Tambin permite enviar variables concretas en lugar de todas las variables, lo que puede contribuir a que la aplicacin sea ms eficaz. Utilice el controlador LoadVars.onLoad para asegurarse de que la aplicacin se ejecute cuando se carguen datos y no antes. La clase LoadVars funciona de forma similar a la clase XML; utiliza los mtodos load(), send() y sendAndLoad() para comunicarse con un servidor. La principal diferencia entre la clase LoadVars y la clase XML es que LoadVars transfiere pares de nombre y valor ActionScript, en lugar de un rbol DOM XML almacenado en el objeto XML. La clase LoadVars presenta las mismas restricciones de seguridad que la clase XML. Disponibilidad Flash Lite 2.0 Vase tambin
loadVariables, funcin, onLoad (controlador LoadVars.onLoad), hasXMLSocket (propiedad capabilities.hasXMLSocket)
Modificadores Propiedad contentType:String Descripcin El tipo MIME que se enva al servidor cuando se llama a
LoadVars.send() o LoadVars.sendAndLoad().
loaded:Boolean
Valor booleano que indica si una operacin load o sendAndLoad ha finalizado; el valor predeterminado es undefined (no definido).


Resumen de eventos
Evento onData = function(src:String) {} onLoad = Descripcin Se invoca cuando se han descargado completamente los datos del servidor o cuando se produce un error mientras se estn descargando datos de un servidor.
Se invoca cuando ha finalizado una operacin LoadVars.load() o
function(success:Bo LoadVars.sendAndLoad(). olean) {}
Firma LoadVars() Descripcin Crea un objeto LoadVars.
Resumen de mtodos
Modificadores Firma addRequestHeader(head er:Object, headerValue:String) :
Void
Descripcin Aade o cambia los encabezados de peticiones HTTP (como Content-Type o SOAPAction) enviados con las acciones POST.
decode(queryString:S tring) : Void getBytesLoaded() : Number getBytesTotal() : Number load(url:String) : Boolean
Convierte la cadena variable en propiedades del objeto LoadVars especificado. Devuelve el nmero de bytes descargados por LoadVars.load() o LoadVars.sendAndLoad(). Devuelve el nmero total de bytes descargados por LoadVars.load() o LoadVars.sendAndLoad(). Descarga variables de la URL especificada, analiza los datos de la variable y coloca las variables resultantes en el objeto LoadVars. Enva las variables contenidas en el objeto LoadVars a la URL especificada.
send(url:String, target:String, [method:String]) : Boolean sendAndLoad(url:Strin g, target:Object, [method:String]) : Boolean toString() : String
Coloca las variables contenidas en el objeto LoadVars en la URL especificada.
Devuelve una cadena que contiene todas las variables enumerables del objeto LoadVars, en la codificacin de contenido MIME application/x-www-form-urlencoded.

addProperty (mtodo Object.addProperty), hasOwnProperty (mtodo Object.hasOwnProperty), isPropertyEnumerable (mtodo Object.isPropertyEnumerable)isPrototypeOf (mtodo Object.isPrototypeOf), registerClass (mtodo Object.registerClass), toString (mtodo Object.toString)unwatch (mtodo Object.unwatch), valueOf (mtodo Object.valueOf), watch (mtodo Object.watch)

addRequestHeader (mtodo LoadVars.addRequestHeader)

public addRequestHeader(header:Object, headerValue:String) : Void
Aade o cambia los encabezados de peticiones HTTP (como Content-Type o SOAPAction) enviados con las acciones POST. En la primera sintaxis, se pasan dos cadenas al mtodo: header y headerValue. En la segunda sintaxis, se pasa una matriz de cadenas, alternando los nombres de los encabezados y los valores de los encabezados. Si se realizan varias llamadas para establecer el mismo nombre de encabezado, cada valor sucesivo reemplazar al valor establecido en la llamada anterior. Los siguientes encabezados HTTP estndar no se pueden aadir ni cambiar con este mtodo: Accept-Ranges, Age ,
Allow , Allowed , Connection , Content-Length , Content-Location , Content-Range , ETag , Host , Last-Modified , Locations , Max-Forwards , Proxy-Authenticate , Proxy-Authorization , Public , Range , Retry-After , Server , TE , Trailer , Transfer-Encoding , Upgrade , URI , Vary , Via , Warning y WWW-Authenticate.
Disponibilidad Flash Lite 2.0 Parmetros header:Object - Cadena o matriz de cadenas que representan un nombre de encabezado de peticin HTTP. headerValue:String - Cadena que representa el valor asociado a header. Ejemplo El ejemplo siguiente aade un encabezado HTTP personalizado denominado SOAPAction con un valor de Foo al objeto my_lv :
my_lv.addRequestHeader("SOAPAction", "'Foo'");
El ejemplo siguiente crea una matriz headers que contiene dos encabezados HTTP alternativos y sus valores asociados. La matriz se pasa como un argumento a addRequestHeader().
var headers = ["Content-Type", "text/plain", "X-ClientAppVersion", "2.0"]; my_lv.addRequestHeader(headers);
El ejemplo siguiente crea un nuevo objeto LoadVars que aade un encabezado de peticin denominado FLASH-UUID. El encabezado contiene una variable que el servidor puede comprobar.
var my_lv:LoadVars = new LoadVars(); my_lv.addRequestHeader("FLASH-UUID", "41472"); my_lv.name = "Mort"; my_lv.age = 26; my_lv.send("http://flash-mx.com/mm/cgivars.cfm", "_blank", "POST");
Vase tambin
addRequestHeader (mtodo XML.addRequestHeader)
contentType (propiedad LoadVars.contentType)

public contentType : String
El tipo MIME que se enva al servidor cuando se llama a LoadVars.send() o LoadVars.sendAndLoad(). El valor predeterminado es application/x-www-form-urlencoded.

Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un objeto LoadVars y muestra el tipo de contenido predeterminado de los datos enviados al servidor.
var my_lv:LoadVars = new LoadVars(); trace(my_lv.contentType); // output: application/x-www-form-urlencoded
Vase tambin
send (mtodo LoadVars.send), sendAndLoad (mtodo LoadVars.sendAndLoad)
decode (mtodo LoadVars.decode)

public decode(queryString:String) : Void
Convierte la cadena variable en propiedades del objeto LoadVars especificado. El controlador de eventos LoadVars.onData utiliza internamente este mtodo. La mayora de los usuarios no necesitan llamar a este mtodo directamente. Si sustituye el controlador de eventos LoadVars.onData, puede llamar explcitamente a LoadVars.decode() para analizar una cadena de variables. Disponibilidad Flash Lite 2.0 Parmetros queryString:String - Cadena de consulta con codificacin URL con pares nombre/valor. Ejemplo El ejemplo siguiente rastrea las tres variables:
// Create a new LoadVars object var my_lv:LoadVars = new LoadVars(); //Convert the variable string to properties my_lv.decode("name=Mort&score=250000"); trace(my_lv.toString()); // Iterate over properties in my_lv for (var prop in my_lv) { trace(prop+" -> "+my_lv[prop]); }
Vase tambin
onData (controlador LoadVars.onData), parseXML (mtodo XML.parseXML)
getBytesLoaded (mtodo LoadVars.getBytesLoaded)

public getBytesLoaded() : Number
Devuelve el nmero de bytes descargados por una llamada a LoadVars.load() o LoadVars.sendAndLoad(). Este mtodo devuelve undefined si no hay ninguna operacin de carga en curso o si no ha comenzado todava ninguna operacin de carga.

Nota: No puede utilizar este mtodo para devolver informacin acerca de un archivo local en el disco duro. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Un entero. Vase tambin
load (mtodo LoadVars.load), sendAndLoad (mtodo LoadVars.sendAndLoad)
getBytesTotal (mtodo LoadVars.getBytesTotal)

public getBytesTotal() : Number
Devuelve el nmero total de bytes descargados por LoadVars.load() o LoadVars.sendAndLoad(). Este mtodo devuelve undefined si no hay ninguna operacin en curso o si no ha comenzado ninguna operacin de carga. Este mtodo tambin devuelve undefined si el nmero total de bytes no se puede determinar (por ejemplo, si la descarga se inici pero el servidor no transmiti un content-length HTTP). Nota: No puede utilizar este mtodo para devolver informacin acerca de un archivo local en el disco duro. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Un entero. Vase tambin
load (mtodo LoadVars.load), sendAndLoad (mtodo LoadVars.sendAndLoad)
load (mtodo LoadVars.load)

public load(url:String) : Boolean
Descarga variables de la URL especificada, analiza los datos de la variable y coloca las variables resultantes en un objeto LoadVars. Las propiedades existentes en el objeto LoadVars que tengan los mismos nombres que las variables descargadas se sobrescribirn. Las propiedades existentes en el objeto LoadVars que tengan nombres diferentes a los de las variables descargadas no se eliminarn. Esta es una accin asncrona. Los datos descargados deben tener el tipo de contenido MIME application/x-www-form-urlencoded. Es el mismo formato que se utiliza en loadVariables(). 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 puede obtenerse eliminando el componente situado ms a la izquierda de la URL de un archivo. Por ejemplo, un archivo SWF situado en www.someDomain.com puede cargar datos de fuentes situadas en store.someDomain.com porque ambos archivos se encuentran en el mismo superdominio, denominado someDomain.com.

En archivos SWF de cualquier versin que se ejecuten en Flash Player 7 o posterior, url debe estar exactamente en el mismo dominio. 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. Asimismo, en archivos publicados para Flash Player 7, la distincin entre maysculas y minsculas se admite para variables externas cargadas con LoadVars.load(). Este mtodo es similar a XML.load(). Disponibilidad Flash Lite 2.0 Parmetros url:String - URL desde la que se descargarn 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. Valor devuelto Boolean - Si no se pasa ningn parmetro (null), false; en los dems casos, true. Utilice el controlador de eventos onLoad() para comprobar el estado de los datos cargados. Ejemplo El siguiente cdigo define un controlador onLoad que indica cundo se devuelven los datos a la aplicacin desde un archivo de texto y, a continuacin, carga los datos del archivo de texto y los enva a la ventana Salida.
var my_lv:LoadVars = new LoadVars(); my_lv.onLoad = function(success:Boolean) { if (success) { trace(this.toString()); } else { trace("Error loading/parsing LoadVars."); } }; my_lv.load("http://www.helpexamples.com/flash/params.txt");
Vase tambin
load (mtodo XML.load), loaded (propiedad LoadVars.loaded), onLoad (controlador LoadVars.onLoad)
loaded (propiedad LoadVars.loaded)

public loaded : Boolean
Valor booleano que indica si una operacin load o sendAndLoad ha finalizado; el valor predeterminado es undefined (no definido). Cuando se inicia una operacin LoadVars.load() o LoadVars.sendAndLoad(), la propiedad loaded es false ; cuando finaliza la operacin, la propiedad loaded es true. Si la operacin no ha finalizado o ha fallado con un error, la propiedad loaded continuar establecida en false. Esta propiedad es similar a XML.loaded. Disponibilidad Flash Lite 2.0

Ejemplo El ejemplo siguiente carga un archivo de texto y muestra informacin en el panel Salida al finalizar la operacin.
var my_lv:LoadVars = new LoadVars(); my_lv.onLoad = function(success:Boolean) { trace("LoadVars loaded successfully: "+this.loaded); }; my_lv.load("http://www.helpexamples.com/flash/params.txt");
Vase tambin
load (mtodo LoadVars.load), sendAndLoad (mtodo LoadVars.sendAndLoad), load (mtodo XML.load)
Constructor LoadVars
public LoadVars()
Crea un objeto LoadVars. Llame a los mtodos de dicho objeto LoadVars para enviar y cargar datos. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se crea un objeto LoadVars denominado my_lv:
var my_lv:LoadVars = new LoadVars();
onData (controlador LoadVars.onData)

onData = function(src:String) {}
Se invoca cuando se han descargado completamente los datos del servidor o cuando se produce un error mientras se estn descargando datos de un servidor. Este controlador se invoca antes de analizar los datos, por lo que puede utilizarse para llamar a una rutina de anlisis personalizada en lugar de la incorporada en Flash Lite. El valor del parmetro src pasado a la funcin asignada a LoadVars.onData puede ser undefined (no definido) o una cadena que contenga los pares nombre-valor con codificacin URL descargados del servidor. Si el parmetro src tiene el valor undefined, ello indica que se ha producido un error al descargar los datos del servidor. La implementacin predeterminada de LoadVars.onData llama a LoadVars.onLoad. Puede sustituir esta implementacin predeterminada asignando una funcin personalizada a LoadVars.onData, pero no se llama a LoadVars.onLoad a menos que lo haga en su implementacin de LoadVars.onData. Disponibilidad Flash Lite 2.0 Parmetros src:String - Cadena o undefined; los datos sin analizar de una llamada a un mtodo LoadVars.load() o LoadVars.sendAndLoad(). Ejemplo El ejemplo siguiente carga un archivo de texto y muestra su contenido en una instancia TextField denominada content_txt al finalizar la operacin. Si se produce un error, aparecer informacin en el panel Salida.

var my_lv:LoadVars = new LoadVars(); my_lv.onData = function(src:String) { if (src == undefined) { trace("Error loading content."); return; } content_txt.text = src; }; my_lv.load("http://www.helpexamples.com/flash/params.txt", my_lv, "GET");
Vase tambin
onLoad (controlador LoadVars.onLoad), load (mtodo LoadVars.load), sendAndLoad (mtodo LoadVars.sendAndLoad)
onLoad (controlador LoadVars.onLoad)

onLoad = function(success:Boolean) {}
Se invoca cuando ha finalizado una operacin LoadVars.load() o LoadVars.sendAndLoad(). Si la operacin se ha realizado correctamente, my_lv se llena con las variables descargadas por la operacin y dichas variables estarn disponibles cuando se invoque este controlador. De manera predeterminada, este controlador tiene el valor undefined (no definido). Este controlador de eventos es similar a XML.onLoad. Disponibilidad Flash Lite 2.0 Parmetros success:Boolean - Indica si la operacin de carga ha finalizado correctamente (true) o ha fallado (false). Ejemplo Consulte el ejemplo para el mtodo LoadVars.sendAndLoad(). Vase tambin
onLoad (controlador XML.onLoad), loaded (propiedad LoadVars.loaded), load (mtodo LoadVars.load), sendAndLoad (mtodo LoadVars.sendAndLoad)
send (mtodo LoadVars.send)

public send(url:String, target:String, [method:String]) : Boolean
Enva las variables contenidas en el objeto LoadVars a la URL especificada. Las variables se concatenan en una cadena en formato application/x-www-form-urlencoded o el valor de LoadVars.contentType. Se utiliza el mtodo POST a no ser que se especifique GET. Debe especificar el parmetro target para ejecutar el guin o la aplicacin de la URL especificada. Si omite el parmetro target, la funcin devolver true, pero el guin o la aplicacin no se ejecutarn. El mtodo send() resulta til si se desea la respuesta del servidor para:
Reemplazar el contenido del SWF (utilice "_self" como parmetro de
target); target);
Que aparezca en una nueva ventana (utilice "_blank" como parmetro de

Que aparezca en el marco superior o del nivel ms alto (utilice "_parent" o

target);
"_top" como parmetro de
Que aparezca en un marco sin nombre (utilice el nombre del marco como cadena para el parmetro target).
Una llamada correcta al mtodo send() siempre abrir una nueva ventana del navegador o reemplazar el contenido de una ventana o marco existente. Si prefiere enviar la informacin a un servidor y seguir reproduciendo el archivo SWF sin abrir una ventana nueva ni reemplazar el contenido de una ventana o un marco existente, utilice el mtodo LoadVars.sendAndLoad(). Este mtodo es similar a XML.send(). Disponibilidad Flash Lite 2.0 Parmetros url:String - URL a la que se cargarn las variables. target:String - Ventana o marco del navegador en el que aparecer una respuesta. 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) - Mtodo GET o POST del protocolo HTTP. El valor predeterminado es POST. Valor devuelto Boolean - Si no se especifica ningn parmetro, false; en los dems casos, true. Ejemplo El ejemplo siguiente copia dos valores de campos de texto y enva los datos a un guin CFM, utilizado para manejar la informacin. Por ejemplo, el guin puede comprobar si el usuario ha obtenido una puntuacin alta e insertar los datos en una tabla de base de datos.
var my_lv:LoadVars = new LoadVars(); my_lv.playerName = playerName_txt.text; my_lv.playerScore = playerScore_txt.text; my_lv.send("setscore.cfm", "_blank", "POST");
Vase tambin
sendAndLoad (mtodo LoadVars.sendAndLoad), send (mtodo XML.send)
sendAndLoad (mtodo LoadVars.sendAndLoad)

public sendAndLoad(url:String, target:Object, [method:String]) : Boolean
Coloca las variables contenidas en el objeto LoadVars en la URL especificada. La respuesta del servidor se descarga, se analiza y las variables resultantes se colocan en el objeto target. Las variables se colocan de la misma forma que en el caso de LoadVars.send(). Las variables se descargan en target de la misma forma que en el caso de LoadVars.load().

En los archivos SWF que se ejecutan en una versin del reproductor anterior a la Flash Player 7 (es decir, Flash Lite 1.x), url debe estar en el mismo superdominio que el archivo SWF que emite esta llamada. El superdominio puede obtenerse eliminando el componente situado ms a la izquierda de la URL de un archivo. Por ejemplo, un archivo SWF situado en www.someDomain.com puede cargar datos de fuentes situadas 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 ejecutan en Flash Player 7 o posterior (es decir, Flash Lite 2.x y 3.x),
url debe encontrarse exactamente en el mismo dominio. 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. Este mtodo es similar a XML.sendAndLoad(). Disponibilidad Flash Lite 2.0 Parmetros url:String - URL a la que se cargarn 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. target:Object - Objeto LoadVars o XML que recibe las variables descargadas. method:String (opcional) - Mtodo GET o POST del protocolo HTTP. El valor predeterminado es POST. Valor devuelto Boolean Ejemplo Para el siguiente ejemplo, aada un campo de texto de entrada llamado name_txt, un campo de texto dinmico llamado result_txt y un botn llamado submit_btn al escenario. Cuando el usuario hace clic en el botn, se crean dos objetos LoadVars: send_lv y result_lv. El objeto send_lv copia el nombre de la instancia name_txt y enva los datos a greeting.cfm. El resultado de este guin se carga en el objeto result_lv y la respuesta del servidor aparece en el campo de texto result_txt. Aada el cdigo ActionScript siguiente al fotograma 1 de la lnea de tiempo:
var send_lv:LoadVars = new LoadVars(); var result_lv:LoadVars = new LoadVars(); result_lv.onLoad = function(success:Boolean) { if (success) { result_txt.text = result_lv.welcomeMessage; } else { result_txt.text = "Error connecting to server."; } }; submit_btn.onRelease = function(){ send_lv.name = name_txt.text; send_lv.sendAndLoad("http://www.flash-mx.com/mm/greeting.cfm", result_lv); }
Vase tambin
send (mtodo LoadVars.send), load (mtodo LoadVars.load), sendAndLoad (mtodo XML.sendAndLoad)

toString (mtodo LoadVars.toString)

Devuelve una cadena que contiene todas las variables enumerables del objeto LoadVars, en la codificacin de contenido MIME application/x-www-form-urlencoded. Disponibilidad Flash Lite 2.0 Valor devuelto String Ejemplo El ejemplo siguiente crea una instancia de un nuevo objeto LoadVars(), crea dos propiedades y utiliza toString() para devolver una cadena que contiene las dos propiedades en un formato URL codificado:
var my_lv:LoadVars = new LoadVars(); my_lv.name = "Gary"; my_lv.age = 26; trace (my_lv.toString()); //output: age=26&name=Gary
LocalConnection
Object | +-LocalConnection public dynamic class LocalConnection extends Object
La clase LocalConnection le permite desarrollar archivos SWF que pueden enviarse entre s instrucciones sin utilizar fscommand() ni JavaScript. Los objetos LocalConnection slo pueden comunicarse entre archivos SWF que se estn ejecutando en el mismo dispositivo cliente, pero pueden estar ejecutndose en aplicaciones diferentes. Puede utilizar objetos LocalConnection para enviar y recibir datos dentro de un nico archivo SWF, pero no es la implementacin estndar; todos los ejemplos de esta seccin ilustran la comunicacin entre diferentes archivos SWF. Utilice los mtodos LocalConnection.send() y LocalConnection.connect() para enviar y recibir datos. Observe que los dos comandos LocalConnection.send() y LocalConnection.connect() especifican el mismo nombre de conexin, lc_name:
// Code in the receiving SWF file this.createTextField("result_txt", 1, 10, 10, 100, 22); result_txt.border = true; var receiving_lc:LocalConnection = new LocalConnection(); receiving_lc.methodToExecute = function(param1:Number, param2:Number) { result_txt.text = param1+param2; }; receiving_lc.connect("lc_name"); // Code in the sending SWF file var sending_lc:LocalConnection = new LocalConnection(); sending_lc.send("lc_name", "methodToExecute", 5, 7);

La manera ms sencilla de utilizar un objeto LocalConnection es permitir la comunicacin nicamente entre los objetos LocalConnection situados en el mismo dominio, ya que no tendr problemas de seguridad. No obstante, si necesita permitir la comunicacin entre dominios, dispone de varias opciones para implementar medidas de seguridad. Para obtener ms informacin, consulte la explicacin sobre el parmetro connectionName en las entradas LocalConnection.send(), LocalConnection.allowDomain y LocalConnection.domain(). Disponibilidad Flash Lite 3.1 Resumen de propiedades
Resumen de eventos
Evento allowDomain =
function([sendi ngDomain:]) {}String
Descripcin Se invoca cada vez que un objeto LocalConnection recibe una solicitud para invocar un mtodo de otro objeto LocalConnection.
allowInsecureDomai n =
function([sendi ngDomain:]) {}String
Se invoca cada vez que un objeto LocalConnection receptor, que se encuentra en un archivo SWF alojado en un dominio que utiliza un protocolo seguro (HTTPS), recibe una solicitud para invocar un mtodo de un objeto LocalConnection emisor que se encuentra en un archivo SWF alojado en un protocolo no seguro.
onStatus =
function(infoOb ject:Object){}
Se invoca despus de que un objeto LocalConnection emisor intente enviar un comando a un objeto LocalConnection receptor.
Firma LocalConnection() Descripcin Crea un objeto LocalConnection.
Resumen de mtodos
Modificadores Firma close() : Void connect(connectionNa me:String) :Boolean Descripcin Cierra (desconecta) un objeto LocalConnection. Prepara un objeto LocalConnection para recibir comandos de un comando LocalConnection.send() (denominado sending LocalConnection object). Devuelve una cadena que representa el dominio de la ubicacin del archivo SWF actual. Invoca el mtodo denominado method en una conexin abierta con el mtodo LocalConnection.connect(connectionName) (el objeto LocalConnection receptor).
domain() : String
send(connectionName: String, methodName:String, [args: Object]) :Boolean

allowDomain (controlador LocalConnection.allowDomain)

allowDomain = function([sendingDomain:String]) {}
Se invoca cuando receiving_lc recibe una solicitud para invocar un mtodo desde un objeto LocalConnection emisor. Flash espera que el cdigo que implemente en este controlador devuelva un valor booleano de true o false. Si el controlador no devuelve un valor true, se ignora la solicitud del objeto emisor y no se invoca el mtodo. Si no est este controlador de eventos, Flash Lite Player aplica una poltica de seguridad predeterminada que equivale al cdigo siguiente:
my_lc.allowDomain = function (sendingDomain) { return (sendingDomain == this.domain()); }
Use LocalConnection.allowDomain para permitir explcitamente que los objetos LocalConnection de los dominios especificados, o de cualquier dominio, ejecuten los mtodos del objeto LocalConnection receptor. Si no declara el parmetro sendingDomain, es probable que desee aceptar comandos de cualquier dominio y el cdigo de su controlador slo tendra que devolver el valor true. Si declara sendingDomain, es probable que desee comparar el valor de sendingDomain con los dominios de los que desea aceptar comandos. Los ejemplos siguientes muestran ambas implementaciones. En los archivos creados para Flash Player 6 o anterior (es decir, Flash Lite 1.x), el parmetro sendingDomain contiene el superdominio del origen de la llamada. En los archivos creados para Flash Player 7 o posterior (es decir, Flash Lite 2.x y 3.x), el parmetro sendingDomain contiene el dominio exacto del origen de la llamada. En el ltimo caso, para permitir el acceso mediante los archivos SWF alojados en www.domain.com o store.domain.com, debe permitir el acceso explcitamente desde ambos dominios.
// For Flash Player 6 receiving_lc.allowDomain = function(sendingDomain) { return(sendingDomain=="domain.com"); } // For Flash Player 7 or later receiving_lc.allowDomain = function(sendingDomain) { return(sendingDomain=="www.domain.com" || sendingDomain=="store.domain.com"); }
Asimismo, en el caso de archivos que se crean para Flash Player 7 o posterior (es decir, Flash Lite 2.x y 3.x), no se podr utilizar este mtodo para permitir que los archivos SWF alojados mediante un protocolo seguro (HTTPS) permitan el acceso desde archivos SWF alojados en protocolos no seguros; en ese caso se debe utilizar el controlador de eventos LocalConnection.allowInsecureDomain. Es posible que, en ocasiones, se encuentre con la siguiente situacin. Supongamos que carga un archivo SWF secundario de un dominio diferente. Desea implementar este mtodo para que este archivo SWF secundario pueda realizar llamadas LocalConnection al archivo SWF principal, pero no conoce el dominio final desde el que vendr el archivo SWF secundario. Esto puede ocurrir, por ejemplo, cuando se utilizan redirecciones de reparto de carga o servidores de terceros.

En esta situacin, puede usar la propiedad MovieClip._url en su implementacin de este mtodo. Por ejemplo, si carga un archivo SWF en my_mc, podr implementar despus este mtodo comprobando si el argumento del dominio coincide con el dominio de my_mc._url. (Debe extraer el dominio de la URL completa incluida en my_mc._url.) Si lo hace, espere a que se cargue el archivo SWF de my_mc, ya que la propiedad _url no dispondr de su valor final correcto hasta que el archivo est completamente cargado. El mejor modo de determinar si un archivo SWF secundario ha terminado de cargarse es utilizar MovieClipLoader.onLoadComplete. Tambin puede darse la situacin contraria: puede crear un archivo SWF secundario que desee aceptar llamadas LocalConnection de su archivo principal pero que no conozca el dominio de su archivo principal. En este caso, implemente este mtodo comprobando si el argumento del dominio coincide con el dominio de _parent._url. Una vez ms, deber extraer el dominio de la URL completa de _parent._url. En este caso, no tendr que esperar a que se cargue el archivo SWF principal; el archivo principal ya estar cargado en el momento en que se cargue el archivo secundario. Disponibilidad Flash Lite 3.1 Parmetros sendingDomain:String [opcional] - Cadena que especifica el dominio del archivo SWF que contiene el objeto LocalConnection emisor. Ejemplo El siguiente ejemplo muestra cmo un objeto LocalConnection de un archivo SWF receptor puede permitir que los archivos SWF de cualquier dominio invoquen a sus mtodos. Compare esto con el ejemplo de LocalConnection.connect(), en el que slo los archivos SWF del mismo dominio pueden invocar el mtodo trace() del archivo SWF receptor. Para ver una explicacin del uso de caracteres de subrayado (_) en el nombre de la conexin, consulte LocalConnection.send().
this.createTextField("welcome_txt", this.getNextHighestDepth(), 10, 10, 100, 20); var my_lc:LocalConnection = new LocalConnection(); my_lc.allowDomain = function(sendingDomain:String) { domain_txt.text = sendingDomain; return true; }; my_lc.allowInsecureDomain = function(sendingDomain:String) { return (sendingDomain == this.domain()); } my_lc.sayHello = function(name:String) { welcome_txt.text = "Hello, "+name; }; my_lc.connect("_mylc");
El ejemplo siguiente enva una cadena al archivo SWF anterior y muestra un mensaje de estado indicando si la conexin local se pudo conectar al archivo. Se usa un componente TextInput llamado name_ti, una instancia de TextArea llamada status_ta y una instancia de Button llamada send_button para mostrar el contenido.

var sending_lc:LocalConnection; var sendListener:Object = new Object(); sendListener.click = function(evt:Object) { sending_lc = new LocalConnection(); sending_lc.onStatus = function(infoObject:Object) { switch (infoObject.level) { case 'status' : status_ta.text = "LocalConnection connected successfully."; break; case 'error' : status_ta.text = "LocalConnection encountered an error."; break; } }; sending_lc.send("_mylc", "sayHello", name_ti.text); }; send_button.addEventListener("click", sendListener);
En el ejemplo siguiente, el archivo SWF receptor, que se encuentra en thisDomain.com, acepta slo comandos de archivos SWF situados en thisDomain.com o thatDomain.com:
var aLocalConn:LocalConnection = new LocalConnection(); aLocalConn.Trace = function(aString) { aTextField += aString+newline; }; aLocalConn.allowDomain = function(sendingDomain) { return (sendingDomain == this.domain() || sendingDomain == "www.macromedia.com"); }; aLocalConn.connect("_mylc");
Al publicar para Flash Player 7 o versiones posteriores (Flash Lite 2.x y 3.x), se emplea la coincidencia exacta de dominios. Es decir, el ejemplo no funcionar si los archivos SWF se encuentran en www.thatDomain.com, pero s funcionar si los archivos se encuentran en thatDomain.com. Vase tambin
connect (mtodo LocalConnection.connect), domain (mtodo LocalConnection.domain), send (mtodo LocalConnection.send), _url (propiedad MovieClip._url), onLoadComplete (detector de eventos MovieClipLoader.onLoadComplete), _parent, propiedad
allowInsecureDomain (controlador LocalConnection.allowInsecureDomain)

allowInsecureDomain = function([sendingDomain:String]) {}
Se invoca cada vez que receiving_lc, que se encuentra en un archivo SWF alojado en un dominio que utiliza un protocolo seguro (HTTPS), recibe una solicitud para invocar un mtodo de un objeto LocalConnection emisor que se encuentra en un archivo SWF alojado en un protocolo no seguro. Flash espera que el cdigo que implemente en este controlador devuelva un valor booleano true o false. Si el controlador no devuelve un valor true, se ignora la solicitud del objeto emisor y no se invoca el mtodo. De manera predeterminada, slo los archivos SWF alojados mediante un protocolo HTTPS pueden acceder a otros archivos SWF alojados mediante el protocolo HTTPS. Esta implementacin mantiene la integridad que ofrece el protocolo HTTPS.

No es recomendable utilizar este mtodo para sustituir el comportamiento predeterminado, ya que pone en riesgo la seguridad de HTTPS. Sin embargo, es posible que tenga que hacerlo, por ejemplo, si necesita permitir el acceso a archivos HTTPS publicados para Flash Player 7 o posterior (es decir, Flash Lite 2.x y 3.x) desde archivos HTTP publicados para Flash Player 6. Un archivo SWF publicado para Flash Player 6 puede utilizar el controlador de eventos LocalConnection.allowDomain para permitir acceso HTTP a HTTPS. Sin embargo, dado que la seguridad se implementa de forma distinta en Flash Player 7, se debe utilizar el mtodo LocalConnection.allowInsecureDomain() para permitir dicho acceso en archivos SWF publicados para Flash Player 7 o versiones posteriores. Disponibilidad Flash Lite 3.1 Parmetros sendingDomain:String [opcional] - Cadena que especifica el dominio del archivo SWF que contiene el objeto LocalConnection emisor. Ejemplo El siguiente ejemplo permite conexiones desde el dominio actual o desde www.macromedia.com, o bien permite conexiones no seguras slo desde el dominio actual.
this.createTextField("welcome_txt", this.getNextHighestDepth(), 10, 10, 100, 20); var my_lc:LocalConnection = new LocalConnection(); my_lc.allowDomain = function(sendingDomain:String) { domain_txt.text = sendingDomain; return (sendingDomain == this.domain() || sendingDomain == "www.macromedia.com"); }; my_lc.allowInsecureDomain = function(sendingDomain:String) { return (sendingDomain == this.domain()); } my_lc.sayHello = function(name:String) { welcome_txt.text = "Hello, "+name; }; my_lc.connect("lc_name");
Vase tambin
allowDomain (controlador LocalConnection.allowDomain), connect (mtodo LocalConnection.connect)
close (mtodo LocalConnection.close)

public close() : Void
Cierra (desconecta) un objeto LocalConnection. Enve este comando cuando ya no desee que el objeto acepte comandos (por ejemplo, cuando desee enviar un comando LocalConnection.connect() utilizando el mismo parmetro connectionName en otro archivo SWF). Disponibilidad Flash Lite 3.1

Vase tambin
connect (mtodo LocalConnection.connect)
connect (mtodo LocalConnection.connect)

public connect(connectionName:String) : Boolean
Prepara un objeto LocalConnection para recibir comandos de un comando LocalConnection.send() (denominado sending LocalConnection object). El objeto que llama a este comando se conoce como objeto LocalConnection receptor. Los objetos receptor y emisor deben estar en ejecucin en el mismo equipo cliente. Asegrese de definir los mtodos asociados a receiving_lc antes de llamar a este mtodo, segn puede ver en todos los ejemplos de esta seccin. De forma predeterminada, Flash Lite resuelve connectionName como un valor de "superdomain:connectionName", donde superdomain es el superdominio del archivo SWF que contiene el comando LocalConnection.connect(). Por ejemplo, si el archivo SWF que contiene el objeto LocalConnection receptor est ubicado en www.someDomain.com, connectionName se resuelve como "someDomain.com:connectionName". (Si un archivo SWF est situado en un equipo cliente, el valor asignado a superdomain es "localhost"). Asimismo, de forma predeterminada, Flash Lite permite que el objeto LocalConnection receptor acepte solamente comandos de objetos LocalConnection emisores cuyo nombre de conexin tambin se resuelva en el valor "superdomain:connectionName". De esta forma, Flash Lite facilita la comunicacin entre archivos SWF situados en el mismo dominio. S slo va a implementar la comunicacin entre archivos SWF del mismo dominio, especifique una cadena para connectionName que no comience por un carcter de subrayado (_) y que no especifique un nombre de dominio (por ejemplo, "myDomain:connectionName"). Utilice la misma cadena en el comando LocalConnection.connect(connectionName). Si va a implementar comunicacin entre archivos SWF de diferentes dominios, la especificacin de una cadena para connectionName que comience por un carcter de subrayado (_) permitir que el archivo SWF que tiene el objeto LocalConnection receptor presente una mayor portabilidad entre dominios. Estos son los dos casos posibles:
Si la cadena para connectionName no comienza por un carcter de subrayado (_), Flash Lite aade un prefijo con
el superdominio y dos puntos (por ejemplo, "myDomain:connectionName"). Aunque esto garantiza que la conexin no entre en conflicto con conexiones de otros dominios que tengan el mismo nombre, los objetos LocalConnection emisores deben especificar este superdominio (por ejemplo, "myDomain:connectionName"). Si el SWF que contiene el objeto LocalConnection receptor se traslada a otro dominio, el reproductor cambiar el prefijo para reflejar el nuevo superdominio (por ejemplo, "anotherDomain:connectionName"). Sera necesario editar manualmente todos los objetos LocalConnection emisores para que apuntaran al nuevo superdominio.
Si la cadena de connectionName comienza por un carcter de subrayado (por ejemplo, "_connectionName"), Flash
Lite no aadir ningn prefijo a la cadena. Esto significa que los objetos LocalConnection receptores y emisores utilizarn idnticas cadenas para connectionName. Si el objeto receptor utiliza LocalConnection.allowDomain para especificar que se acepten las conexiones de cualquier dominio, el SWF que contiene el objeto LocalConnection receptor podr trasladarse a otro dominio sin modificar ningn objeto LocalConnection emisor. Para obtener ms informacin, consulte la explicacin sobre connectionName en LocalConnection.send() y tambin las entradas LocalConnection.allowDomain y LocalConnection.domain(). Nota: los dos puntos se utilizan como caracteres especiales que separan el superdominio de la cadena connectionName . La cadena de connectionName no puede incluir dos puntos.

Disponibilidad Flash Lite 3.1 Parmetros connectionName:String - Cadena que corresponde al nombre de conexin especificado en el comando LocalConnection.send() que quiere comunicarse con receiving_lc. Valor devuelto Boolean - Valor booleano: true si ningn otro proceso que se est ejecutando en el mismo equipo cliente ha emitido ya este comando utilizando el mismo valor para el parmetro connectionName ; false en otro caso. Ejemplo En el siguiente ejemplo, se muestra cmo un archivo SWF de un determinado dominio puede invocar un mtodo llamado printOut de un archivo SWF receptor del mismo dominio. En primer lugar, cree un archivo SWF con el siguiente cdigo:
this.createTextField("tf", this.getNextHighestDepth(), 10, 10, 300, 100); var aLocalConnection:LocalConnection = new LocalConnection(); aLocalConnection.connect("demoConnection"); aLocalConnection.printOut = function(aString:String):Void{ tf.text += aString; }
A continuacin, cree un segundo archivo con este cdigo:

var sending_lc:LocalConnection = new LocalConnection(); sending_lc.send("demoConnection", "printOut", "This is a message from file B. Hello.");
Para probar este ejemplo, ejecute el primer archivo SWF y, a continuacin, el segundo. Vase tambin
send (mtodo LocalConnection.send), allowDomain (controlador LocalConnection.allowDomain), domain (mtodo LocalConnection.domain)
domain (mtodo LocalConnection.domain)

public domain() : String
Devuelve una cadena que representa el dominio de la ubicacin del archivo SWF actual. En los archivos SWF publicados para Flash Player 6 o anterior (es decir, Flash Lite 1.x), la cadena devuelta es el superdominio del archivo SWF actual. Por ejemplo, si el archivo SWF est situado en www.adobe.com, este comando devolver "adobe.com". En los archivos SWF publicados para Flash Player 2 o anterior (es decir, Flash Lite 3.x), la cadena devuelta es el superdominio del archivo SWF actual. Por ejemplo, si el archivo SWF est situado en www.adobe.com, este comando devolver "www.adobe.com". Si el archivo SWF actual es un archivo local que reside en el equipo cliente, este comando devolver "localhost". Este comando suele utilizarse incluyendo el nombre de dominio del objeto LocalConnection emisor como parmetro del mtodo que desea invocar en el objeto LocalConnection receptor o con LocalConnection.allowDomain para aceptar comandos procedentes de un determinado dominio. Si desea permitir la comunicacin slo entre objetos LocalConnection que se encuentren en el mismo dominio, probablemente no necesite utilizar este comando.

Disponibilidad Flash Lite 3.1 Valor devuelto String - Cadena que representa el dominio de la ubicacin del archivo SWF actual; para obtener ms informacin, consulte la seccin Descripcin. Ejemplo En el siguiente ejemplo, un archivo SWF receptor slo acepta comandos procedentes de archivos SWF situados en el mismo dominio o en example.com:
// If both the sending and receiving SWF files are Flash Player 6, // then use the superdomain var my_lc:LocalConnection = new LocalConnection(); my_lc.allowDomain = function(sendingDomain):String{ return (sendingDomain==this.domain() || sendingDomain=="example.com"); } // If either the sending or receiving SWF file is Flash Player 7 or later, // then use the exact domain. In this case, commands from a SWF file posted // at www.example.com will be accepted, but those from one posted at // a different subdomain, e.g. test.example.com, will not. var my_lc:LocalConnection = new LocalConnection(); my_lc.allowDomain = function(sendingDomain):String{ return (sendingDomain==this.domain() || sendingDomain=="www.example.com"); }
En el siguiente ejemplo, un archivo SWF emisor situado en www.yourdomain.com invoca un mtodo de un archivo SWF situado en www.mydomain.com. El archivo SWF emisor incluye su nombre de dominio como parmetro del mtodo que invoca, por lo que el archivo SWF receptor puede devolver un valor de respuesta a un objeto LocalConnection del dominio correcto. El archivo SWF emisor tambin especifica que nicamente aceptar comandos de los archivos SWF que se encuentren en mydomain.com. Los nmeros de lnea se incluyen con carcter nicamente informativo. La secuencia de eventos se describe en la siguiente lista:
El archivo SWF receptor se prepara para recibir comandos mediante una conexin llamada "sum" (lnea 11). Flash
Lite Player resuelve el nombre de esta conexin como "mydomain.com:sum" (consulte
LocalConnection.connect()).
El archivo SWF emisor se prepara para recibir una respuesta mediante el objeto LocalConnection llamado
"result" (lnea 67). Tambin especifica que slo aceptar los comandos procedentes de los archivos SWF que haya
en mydomain.com (lneas de la 51 a la 53).
El archivo SWF emisor invoca el mtodo aSum de una conexin llamada "mydomain.com:sum" (lnea 68) y pasa
los siguientes parmetros: su superdominio, el nombre de la conexin que recibir la respuesta ("result") y los valores que utilizar aSum (123 y 456).
Se invoca el mtodo aSum (lnea 6) con los siguientes valores: sender = "mydomain.com:result", replyMethod =
"aResult", n1 = 123 y n2 = 456. A continuacin, ejecuta la siguiente lnea de cdigo: this.send("mydomain.com:result", "aResult", (123 + 456));
El mtodo aResult (lnea 54) muestra el valor devuelto por aSum (579).

// The receiving SWF at http://www.mydomain.com/folder/movie.swf // contains the following code 1 var aLocalConnection:LocalConnection = new LocalConnection(); 2 aLocalConnection.allowDomain = function() 3 { // Allow connections from any domain 4 return true; 5 } 6 aLocalConnection.aSum = function(sender, replyMethod, n1, n2) 7 { 8 this.send(sender, replyMethod, (n1 + n2)); 9 } 10 11 aLocalConnection.connect("sum"); // The sending SWF at http://www.yourdomain.com/folder/movie.swf // contains the following code 50 var lc:LocalConnection = new LocalConnection(); 51 lc.allowDomain = function(aDomain) { // Allow connections only from mydomain.com 52 return (aDomain == "mydomain.com"); 53 } 54 lc.aResult = function(aParam) { 55 trace("The sum is " + aParam); 56 } // determine our domain and see if we need to truncate it 57 var channelDomain:String = lc.domain(); 58 if (getVersion() >= 7 && this.getSWFVersion() >= 7) 59 { // split domain name into elements 60 var domainArray:Array = channelDomain.split("."); // if more than two elements are found, // chop off first element to create superdomain if (domainArray.length > 2) { domainArray.shift(); channelDomain = domainArray.join("."); } }
61 62 63 64 65 66
67 lc.connect("result"); 68 lc.send("mydomain.com:sum", "aSum", channelDomain + ':' + "result", "aResult", 123, 456);
Vase tambin
allowDomain (controlador LocalConnection.allowDomain), connect (mtodo LocalConnection.connect)
Constructor LocalConnection
public LocalConnection()

Crea un objeto LocalConnection. Disponibilidad Flash Lite 3.1 Ejemplo En el siguiente ejemplo, se muestra como los archivos SWF receptor y emisor crean objetos LocalConnnection. Los dos archivos SWF pueden utilizar el mismo nombre o nombres diferentes para sus respectivos objetos LocalConnection. En este ejemplo utilizan nombres diferentes.
// Code in the receiving SWF file this.createTextField("result_txt", 1, 10, 10, 100, 22); result_txt.border = true; var receiving_lc:LocalConnection = new LocalConnection(); receiving_lc.methodToExecute = function(param1:Number, param2:Number) { result_txt.text = param1+param2; }; receiving_lc.connect("lc_name");
El siguiente archivo SWF enva la solicitud al primer archivo SWF.

// Code in the sending SWF file var sending_lc:LocalConnection = new LocalConnection(); sending_lc.send("lc_name", "methodToExecute", 5, 7);
Vase tambin
connect (mtodo LocalConnection.connect), send (mtodo LocalConnection.send)
onStatus (controlador LocalConnection.onStatus)

onStatus = function(infoObject:Object) {}
Se invoca despus de que un objeto LocalConnection emisor intente enviar un comando a un objeto LocalConnection receptor. Si desea responder a este controlador de eventos, deber crear una funcin que procese el objeto de informacin enviado por el objeto LocalConnection. Si el objeto de informacin devuelto por este controlador de eventos incluye un valor de estado de nivel, Flash envi correctamente el comando a un objeto LocalConnection receptor. Esto no significa que Flash invocara correctamente el mtodo especificado del objeto LocalConnection receptor; slo significa que Flash ha podido enviar el comando. Por ejemplo, el mtodo no se invoca si el objeto LocalConnection receptor no permite las conexiones del dominio emisor o si el mtodo no existe. La nica forma de saber con seguridad si se ha invocado el mtodo consiste en hacer que el objeto receptor enve una respuesta al objeto emisor. Si el objeto de informacin devuelto por este controlador de eventos incluye un valor de error de nivel, Flash no puede enviar el comando a un objeto LocalConnection receptor, probablemente porque no hay ningn objeto LocalConnection receptor conectado cuyo nombre se corresponda con el nombre especificado en el comando sending_lc.send() que invoc este controlador. Adems de este controlador onStatus, Flash tambin proporciona una sper funcin denominada System.onStatus. Si se invoca onStatus para un objeto concreto y no hay ninguna funcin asignada para responder, Flash procesa una funcin asignada a System.onStatus, si existe. En la mayora de los casos, se implementa este controlador slo para responder a los estados de error, como se muestra en el ejemplo siguiente.

Disponibilidad Flash Lite 3.1 Parmetros infoObject:Object - Parmetro definido de acuerdo con el mensaje de estado. Para obtener detalles acerca de este parmetro, consulte la seccin Descripcin. Ejemplo El siguiente ejemplo muestra un mensaje de estado que indica si el archivo SWF se conecta otro objeto de conexin local llamado lc_name. Se usa un componente TextInput llamado name_ti, una instancia de TextArea llamada status_ta y una instancia de Button llamada send_button para mostrar el contenido.
var sending_lc:LocalConnection; var sendListener:Object = new Object(); sendListener.click = function(evt:Object) { sending_lc = new LocalConnection(); sending_lc.onStatus = function(infoObject:Object) { switch (infoObject.level) { case 'status' : status_ta.text = "LocalConnection connected successfully."; break; case 'error' : status_ta.text = "LocalConnection encountered an error."; break; } }; sending_lc.send("lc_name", "sayHello", name_ti.text); }; send_button.addEventListener("click", sendListener);
Vase tambin
send (mtodo LocalConnection.send), onStatus (controlador System.onStatus)
send (mtodo LocalConnection.send)

public send(connectionName:String, methodName:String, [args:Object]) : Boolean
Invoca el mtodo llamado method en una conexin abierta por un objeto LocalConnection receptor. El objeto que llama a este mtodo es el objeto LocalConnection emisor. Los archivos SWF que contienen los objetos emisor y receptor deben estar en ejecucin en el mismo dispositivo cliente. Existe un lmite de 40 kilobytes para la cantidad de datos que puede pasar en forma de parmetros a este comando. Si el comando devuelve false pero la sintaxis es correcta, pruebe a dividir las solicitudes de LocalConnection.send() en varios comandos, cada uno de ellos con menos de 40 KB de datos.

Tal y como se describe en la entrada LocalConnection.connect(), Flash Lite aade el superdominio actual a connectionName de forma predeterminada. Si est implementando la comunicacin entre diferentes dominios, debe definir connectionName en los objetos LocalConnection emisor y receptor de manera que Flash no aada el superdominio actual a connectionName. Puede hacerlo de una de las dos formas siguientes:
Utilice un carcter de subrayado (_) al comienzo de connectionName en los objetos LocalConnection emisor y
receptor. En el archivo SWF que contiene el objeto receptor, utilice LocalConnection.allowDomain para especificar que se acepten las conexiones procedentes de cualquier dominio. Esta implementacin le permite almacenar los archivos SWF emisor y receptor en cualquier dominio.
Incluya el superdominio de connectionName en el objeto LocalConnection emisor (por ejemplo,

myDomain.com:myConnectionName). En el objeto receptor, utilice LocalConnection.allowDomain para
especificar que se acepten las conexiones desde el superdominio especificado (en este caso, myDomain.com) o que se acepten las conexiones desde cualquier dominio. Nota: no puede especificar un superdominio en connectionName en el objeto LocalConnection receptor (slo puede hacerlo en el objeto LocalConnection emisor). Cuando utilice este mtodo tenga en cuenta el modelo de seguridad de Flash Lite. De forma predeterminada, un objeto LocalConnection est asociado con el entorno limitado del archivo SWF que lo cre y no se admiten llamadas de varios dominios a objetos LocalConnection a menos que se haya invocado el mtodo LocalConnection.allowDomain(). Para ms informacin, consulte lo siguiente:
Captulo 17, "Descripcin de la seguridad", en Aprendizaje de ActionScript 2.0 en Flash El documento tcnico sobre seguridad de Flash Player 8 en http://www.macromedia.com/go/fp8_security El documento tcnico sobre la API relativa a la seguridad de Flash Player 8 en
http://www.macromedia.com/go/fp8_security_apis Disponibilidad Flash Lite 3.1 Parmetros connectionName:String - Cadena que corresponde al nombre de conexin especificado en el comando LocalConnection.connect() que quiere comunicarse con sending_lc. methodName:String - Cadena que especifica el nombre del mtodo que se invocar en el objeto LocalConnection receptor. Los siguientes nombres de mtodo provocan que el comando falle: send, connect, close, domain, onStatus y allowDomain. args:Object [opcional] - Argumentos que se desea pasar al mtodo especificado. Valor devuelto Boolean - Valor booleano: true si Flash puede llevar a cabo la solicitud; false en caso contrario. Nota: Si se devuelve un valor true, no significa necesariamente que Flash Lite se haya conectado correctamente a un objeto LocalConnection receptor. Slo significa que la sintaxis del comando es correcta. Para determinar si la conexin se ha realizado correctamente, consulte LocalConnection.onStatus. Ejemplo Para ver un ejemplo de comunicacin entre objetos LocalConnection situados en el mismo dominio, consulte LocalConnection.connect(). Para ver un ejemplo de comunicacin entre objetos LocalConnection situados en determinados dominios, consulte LocalConnection.domain().

Vase tambin
allowDomain (controlador LocalConnection.allowDomain), connect (mtodo LocalConnection.connect), domain (mtodo LocalConnection.domain), onStatus (controlador LocalConnection.onStatus)
Math
Object | +-Math public class Math extends Object
La clase Math es una clase de nivel superior cuyos mtodos y propiedades pueden utilizarse sin emplear un constructor. Utilice los mtodos y propiedades de esta clase para acceder a las constantes y funciones matemticas y manipularlas. Todos los mtodos y propiedades de la clase Math son estticos y deben llamarse utilizando la sintaxis Math.method() o Math.CONSTANT. En ActionScript, las constantes se definen con la mxima precisin de los nmeros de coma flotante IEEE-754 de doble precisin. Varios mtodos de la clase Math utilizan la medida de un ngulo en radianes como parmetro. Puede utilizar la siguiente ecuacin para calcular el valor en radianes antes de llamar al mtodo y luego proporcionar el valor calculado como parmetro, o bien puede proporcionar toda la parte derecha de la ecuacin (con la medida del ngulo en radianes en lugar de degrees) como el parmetro radian. Para calcular un valor en radianes, utilice la siguiente frmula:
radians = degrees * Math.PI/180
A continuacin se ofrece un ejemplo en el que se pasa la ecuacin como parmetro para calcular el seno de un ngulo de 45:
Math.sin(45 * Math.PI/180) es igual que Math.sin(.7854)
Disponibilidad Flash Lite 2.0 Resumen de propiedades

Modificadores
static
Propiedad E:Number
Descripcin Constante matemtica de la base de los logaritmos neperianos expresada como nmero e. Constante matemtica del logaritmo neperiano de 10, expresada como loge10, con un valor aproximado de 2,302585092994046. Constante matemtica del logaritmo neperiano de 2, expresada como loge2, con un valor aproximado de 0,6931471805599453.
static
LN10:Number
static
LN2:Number

Modificadores
static
Propiedad LOG10E:Number
Descripcin Constante matemtica del logaritmo en base 10 de la constante e (Math.E), expresada como log10e, con un valor aproximado de 0,4342944819032518. Constante matemtica del logaritmo en base 2 de la constante e (Math.E), expresada como log2e, con un valor aproximado de 1,442695040888963387. Constante matemtica del radio de la circunferencia de un crculo con respecto a su dimetro, expresada como pi, con un valor aproximado de 3,141592653589793. Constante matemtica para la raz cuadrada de una mitad, con un valor aproximado de 0,7071067811865476. Constante matemtica para la raz cuadrada de 2, con un valor aproximado de 1,4142135623730951.
static
LOG2E:Number
static
PI:Number
static
SQRT1_2:Number
static
SQRT2:Number

constructor (propiedad Object.constructor), __proto__ (Object.__proto__, propiedad). prototype (propiedad Object.prototype), __resolve (Object.__resolve, propiedad)
Resumen de mtodos
Modificadores
static
Firma abs(x:Number) : Number acos(x:Number) : Number asin(x:Number) : Number atan(tangent:Number) : Number atan2(y:Number, x:Number) : Number
Descripcin Calcula y devuelve un valor absoluto para el nmero especificado por el parmetro x. Calcula y devuelve el arco coseno del nmero especificado por el parmetro x, en radianes. Calcula y devuelve el arco seno del nmero especificado por el parmetro x, en radianes. Calcula y devuelve el valor en radianes del ngulo cuya tangente se especifica en el parmetro tangent. Calcula y devuelve el ngulo del punto y/x en radianes cuando se mide en sentido contrario al de las agujas del reloj desde el eje x de un crculo (siendo 0,0 en el centro del crculo). Devuelve el valor mximo del nmero o expresin especificada. Calcula y devuelve el coseno del ngulo especificado en radianes. Devuelve el valor de la base del logaritmo neperiano (e) elevado a la potencia del exponente especificado en el parmetro x. Devuelve el valor redondeado a la baja del nmero o expresin especificada en el parmetro x. Devuelve el logaritmo del parmetro x.
static
static
static
static
static
ceil(x:Number) : Number cos(x:Number) : Number exp(x:Number) : Number
static
static
static
floor(x:Number) : Number log(x:Number) : Number max(x:Number, y:Number) : Number
static
static
Calcula x e y y devuelve el valor mayor.

Modificadores
static
Firma min(x:Number, y:Number) : Number pow(x:Number, y:Number) : Number random() : Number round(x:Number) : Number sin(x:Number) : Number sqrt(x:Number) : Number tan(x:Number) : Number
Descripcin Calcula x e y y devuelve el menor.
static
Calcula y devuelve x elevado a la potencia de y.
static static
Devuelve un nmero n seudo-aleatorio, donde 0 <= n < 1. Redondea el valor del parmetro x hacia arriba o hacia abajo con el entero ms prximo y devuelve el valor resultante. Calcula y devuelve el seno del ngulo especificado en radianes.
static
static
Calcula y devuelve la raz cuadrada del nmero especificado.
static
Calcula y devuelve la tangente del ngulo especificado.

addProperty (mtodo Object.addProperty), hasOwnProperty (mtodo Object.hasOwnProperty), isPropertyEnumerable (mtodo Object.isPropertyEnumerable), isPrototypeOf (mtodo Object.isPrototypeOf)registerClass (mtodo Object.registerClass), toString (mtodo Object.toString), unwatch (mtodo Object.unwatch), valueOf (mtodo Object.valueOf), watch (mtodo Object.watch)
abs (mtodo Math.abs)

public static abs(x:Number) : Number
Calcula y devuelve un valor absoluto para el nmero especificado por el parmetro x. Disponibilidad Flash Lite 2.0 Parmetros x:Number - Un nmero. Valor devuelto Number - Un nmero. Ejemplo El ejemplo siguiente muestra cmo Math.abs() devuelve el valor absoluto de un nmero y no afecta al valor del parmetro x (denominado num en este ejemplo):
var num:Number = -12; var numAbsolute:Number = Math.abs(num); trace(num); // output: -12 trace(numAbsolute); // output: 12
acos (mtodo Math.acos)

public static acos(x:Number) : Number

Calcula y devuelve el arco coseno del nmero especificado por el parmetro x, en radianes. Disponibilidad Flash Lite 2.0 Parmetros x:Number - Nmero entre -1.0 y 1.0. Valor devuelto Number - Nmero; el arco coseno del parmetro x. Ejemplo El ejemplo siguiente muestra el arco coseno de varios valores.
trace(Math.acos(-1)); // output: 3.14159265358979 trace(Math.acos(0)); // output: 1.5707963267949 trace(Math.acos(1)); // output: 0
Vase tambin
asin (mtodo Math.asin), atan (mtodo Math.atan), atan2 (mtodo Math.atan2), cos (mtodo Math.cos), sin (mtodo Math.sin), tan (mtodo Math.tan)
asin (mtodo Math.asin)

public static asin(x:Number) : Number
Calcula y devuelve el arco seno del nmero especificado por el parmetro x, en radianes. Disponibilidad Flash Lite 2.0 Parmetros x:Number - Nmero entre -1.0 y 1.0. Valor devuelto Number - Nmero comprendido entre pi negativo dividido por 2 y pi positivo dividido por 2. Ejemplo El ejemplo siguiente muestra el arco seno de varios valores.
trace(Math.asin(-1)); // output: -1.5707963267949 trace(Math.asin(0)); // output: 0 trace(Math.asin(1)); // output: 1.5707963267949
Vase tambin
acos (mtodo Math.acos), atan (mtodo Math.atan), atan2 (mtodo Math.atan2), cos (mtodo Math.cos), sin (mtodo Math.sin), tan (mtodo Math.tan)

atan (mtodo Math.atan)

public static atan(tangent:Number) : Number
Calcula y devuelve el valor en radianes del ngulo cuya tangente se especifica en el parmetro tangent. El valor devuelto est comprendido entre pi negativo dividido por 2 y pi positivo dividido por 2. Disponibilidad Flash Lite 2.0 Parmetros tangent:Number - Nmero que representa la tangente de un ngulo. Valor devuelto Number - Nmero comprendido entre pi negativo dividido por 2 y pi positivo dividido por 2. Ejemplo El ejemplo siguiente muestra el valor del ngulo para varias tangentes.
trace(Math.atan(-1)); // output: -0.785398163397448 trace(Math.atan(0)); // output: 0 trace(Math.atan(1)); // output: 0.785398163397448
Vase tambin
acos (mtodo Math.acos), asin (mtodo Math.asin), atan2 (mtodo Math.atan2), cos (mtodo Math.cos), sin (mtodo Math.sin), tan (mtodo Math.tan)
atan2 (mtodo Math.atan2)

public static atan2(y:Number, x:Number) : Number
Calcula y devuelve el ngulo del punto y/x en radianes cuando se mide en sentido contrario al de las agujas del reloj desde el eje x de un crculo (siendo 0,0 en el centro del crculo). El valor devuelto est comprendido entre pi positivo y pi negativo. Disponibilidad Flash Lite 2.0 Parmetros y:Number - Nmero que especifica la coordenada y del punto. x:Number - Nmero que especifica la coordenada x del punto. Valor devuelto Number - Un nmero. Ejemplo El ejemplo siguiente devuelve el ngulo, en radianes, del punto especificado por las coordenadas (0, 10), de forma que x = 0 e y = 10. Observe que el primer parmetro de atan2 es siempre la coordenada y.
trace(Math.atan2(10, 0)); // output: 1.5707963267949

Vase tambin
acos (mtodo Math.acos), asin (mtodo Math.asin), atan (mtodo Math.atan), cos (mtodo Math.cos), sin (mtodo Math.sin), tan (mtodo Math.tan)
ceil (mtodo Math.ceil)

public static ceil(x:Number) : Number
Devuelve el valor mximo del nmero o expresin especificada. El valor mximo de un nmero es el nmero entero ms cercano mayor o igual al nmero. Disponibilidad Flash Lite 2.0 Parmetros x:Number - Un nmero o expresin. Valor devuelto Number - Entero que es, al mismo tiempo, el ms prximo y mayor o igual que el parmetro x. Ejemplo El cdigo siguiente devuelve un valor de 13:
Math.ceil(12.5);
Vase tambin
floor (mtodo Math.floor), round (mtodo Math.round)
cos (mtodo Math.cos)

public static cos(x:Number) : Number
Calcula y devuelve el coseno del ngulo especificado en radianes. Para calcular un radin, consulte la descripcin incluida en la entrada de la clase Math. Disponibilidad Flash Lite 2.0 Parmetros x:Number - Nmero que representa un ngulo medido en radianes. Valor devuelto Number - Nmero entre -1.0 y 1.0. Ejemplo El ejemplo siguiente muestra el coseno de varios ngulos diferentes.
trace trace trace trace (Math.cos(0)); // 0 degree angle. Output: 1 (Math.cos(Math.PI/2)); // 90 degree angle. Output: 6.12303176911189e-17 (Math.cos(Math.PI)); // 180 degree angle. Output: -1 (Math.cos(Math.PI*2)); // 360 degree angle. Output: 1

Nota: el coseno de un ngulo de 90 grados es cero, pero debido a la falta de precisin inherente de los clculos decimales con nmeros binarios, Flash Lite Player generar un nmero muy cercano pero que no es exactamente igual a cero. Vase tambin
acos (mtodo Math.acos), asin (mtodo Math.asin), atan (mtodo Math.atan), atan2 (mtodo Math.atan2), sin (mtodo Math.sin), tan (mtodo Math.tan)
E (propiedad Math.E)
public static E : Number
Constante matemtica de la base de los logaritmos neperianos expresada como nmero e. El valor aproximado de e es 2,71828182845905. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente muestra cmo se puede utilizar Math.E para calcular continuamente intereses compuestos en un sencillo caso de un inters del 100 por cien en un periodo de un ao.
var principal:Number = 100; var simpleInterest:Number = 100; var continuouslyCompoundedInterest:Number = (100 * Math.E) - principal; trace ("Beginning principal: $" + principal); trace ("Simple interest after one year: $" + simpleInterest); trace ("Continuously compounded interest after one year: $" + continuouslyCompoundedInterest); // Output: Beginning principal: $100 Simple interest after one year: $100 Continuously compounded interest after one year: $171.828182845905
exp (mtodo Math.exp)

public static exp(x:Number) : Number
Devuelve el valor de la base del logaritmo neperiano (e) elevado a la potencia del exponente especificado en el parmetro x. La constante Math.E puede proporcionar el valor de e. Disponibilidad Flash Lite 2.0 Parmetros x:Number - El exponente; un nmero o expresin. Valor devuelto Number - Un nmero.

Ejemplo El ejemplo siguiente muestra el logaritmo de dos nmeros.

trace(Math.exp(1)); // output: 2.71828182845905 trace(Math.exp(2)); // output: 7.38905609893065
Vase tambin
E (propiedad Math.E)
floor (mtodo Math.floor)

public static floor(x:Number) : Number
Devuelve el valor redondeado a la baja del nmero o expresin especificada en el parmetro x. El valor mnimo es el entero ms cercano inferior o igual al nmero o expresin especificada. Disponibilidad Flash Lite 2.0 Parmetros x:Number - Un nmero o expresin. Valor devuelto Number - Entero que es, al mismo tiempo, el ms prximo y menor o igual que el parmetro x. Ejemplo El cdigo siguiente devuelve un valor de 12:
Math.floor(12.5);
El cdigo siguiente devuelve un valor de -7:

Math.floor(-6.5);
LN10 (propiedad Math.LN10)

public static LN10 : Number
Constante matemtica del logaritmo neperiano de 10, expresada como loge10, con un valor aproximado de 2,302585092994046. Disponibilidad Flash Lite 2.0 Ejemplo Este ejemplo rastrea el valor de Math.LN10.
trace(Math.LN10); // output: 2.30258509299405
LN2 (propiedad Math.LN2)

public static LN2 : Number

Constante matemtica del logaritmo neperiano de 2, expresada como loge2, con un valor aproximado de 0,6931471805599453. Disponibilidad Flash Lite 2.0
log (mtodo Math.log)

public static log(x:Number) : Number
Devuelve el logaritmo del parmetro x. Disponibilidad Flash Lite 2.0 Parmetros x:Number - Un nmero o expresin con un valor mayor que 0. Valor devuelto Number - Devuelve el logaritmo neperiano del parmetro x. Ejemplo El ejemplo siguiente muestra el logaritmo de tres valores numricos.
trace(Math.log(0)); // output: -Infinity trace(Math.log(1)); // output: 0 trace(Math.log(2)); // output: 0.693147180559945 trace(Math.log(Math.E)); // output: 1
LOG10E (propiedad Math.LOG10E)

public static LOG10E : Number
Constante matemtica del logaritmo en base 10 de la constante e (Math.E), expresada como log10e, con un valor aproximado de 0,4342944819032518. El mtodo Math.log() calcula el logaritmo neperiano de un nmero. Multiplique el resultado de Math.log() por Math.LOG10E para obtener el logaritmo de base 10. Disponibilidad Flash Lite 2.0 Ejemplo Este ejemplo muestra cmo obtener el logaritmo de base 10 de un nmero:
trace(Math.log(1000) * Math.LOG10E); // Output: 3
LOG2E (propiedad Math.LOG2E)

public static LOG2E : Number

Constante matemtica del logaritmo en base 2 de la constante e (Math.E), expresada como log2e, con un valor aproximado de 1,442695040888963387. El mtodo Math.log calcula el logaritmo neperiano de un nmero. Multiplique el resultado de Math.log() por Math.LOG2E para obtener el logaritmo de base 2. Disponibilidad Flash Lite 2.0 Ejemplo Este ejemplo muestra cmo obtener el logaritmo de base 2 de un nmero:
trace(Math.log(16) * Math.LOG2E); // Output: 4
max (mtodo Math.max)

public static max(x:Number, y:Number) : Number
Calcula x e y y devuelve el valor mayor. Disponibilidad Flash Lite 2.0 Parmetros x:Number - Un nmero o expresin. y:Number - Un nmero o expresin. Valor devuelto Number - Un nmero. Ejemplo El ejemplo siguiente muestra Thu Dec 30 00:00:00 GMT-0700 2004, que es la mayor de las expresiones evaluadas.
var date1:Date = new Date(2004, 11, 25); var date2:Date = new Date(2004, 11, 30); var maxDate:Number = Math.max(date1.getTime(), date2.getTime()); trace(new Date(maxDate).toString());
Vase tambin
min (mtodo Math.min)
min (mtodo Math.min)

public static min(x:Number, y:Number) : Number
Calcula x e y y devuelve el menor. Disponibilidad Flash Lite 2.0

Parmetros x:Number - Un nmero o expresin. y:Number - Un nmero o expresin. Valor devuelto Number - Un nmero. Ejemplo El ejemplo siguiente muestra Sat Dec 25 00:00:00 GMT-0700 2004, que es la menor de las expresiones evaluadas.
var date1:Date = new Date(2004, 11, 25); var date2:Date = new Date(2004, 11, 30); var minDate:Number = Math.min(date1.getTime(), date2.getTime()); trace(new Date(minDate).toString());
Vase tambin
max (mtodo Math.max)
PI (propiedad Math.PI)
public static PI : Number
Constante matemtica del radio de la circunferencia de un crculo con respecto a su dimetro, expresada como pi, con un valor aproximado de 3,141592653589793. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente dibuja un crculo utilizando la constante matemtica pi y la API de dibujo.
drawCircle(this, 100, 100, 50); // function drawCircle(mc:MovieClip, x:Number, y:Number, r:Number):Void { mc.lineStyle(2, 0xFF0000, 100); mc.moveTo(x+r, y); mc.curveTo(r+x, Math.tan(Math.PI/8)*r+y, Math.sin(Math.PI/4)*r+x, Math.sin(Math.PI/4)*r+y); mc.curveTo(Math.tan(Math.PI/8)*r+x, r+y, x, r+y); mc.curveTo(-Math.tan(Math.PI/8)*r+x, r+y, -Math.sin(Math.PI/4)*r+x, Math.sin(Math.PI/4)*r+y); mc.curveTo(-r+x, Math.tan(Math.PI/8)*r+y, -r+x, y); mc.curveTo(-r+x, -Math.tan(Math.PI/8)*r+y, -Math.sin(Math.PI/4)*r+x, Math.sin(Math.PI/4)*r+y); mc.curveTo(-Math.tan(Math.PI/8)*r+x, -r+y, x, -r+y); mc.curveTo(Math.tan(Math.PI/8)*r+x, -r+y, Math.sin(Math.PI/4)*r+x, Math.sin(Math.PI/4)*r+y); mc.curveTo(r+x, -Math.tan(Math.PI/8)*r+y, r+x, y); }
pow (mtodo Math.pow)

public static pow(x:Number, y:Number) : Number

Calcula y devuelve x elevado a la potencia de y. Disponibilidad Flash Lite 2.0 Parmetros x:Number - Nmero elevado a una potencia. y:Number - Nmero que especifica la potencia a la que se eleva el parmetro x. Valor devuelto Number - Un nmero.
random (mtodo Math.random)

public static random() : Number
Devuelve un nmero n seudo-aleatorio, donde 0 <= n < 1. El nmero devuelto es seudo-aleatorio porque no se genera mediante un fenmeno natural realmente aleatorio, como una desintegracin radioactiva. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Un nmero. Ejemplo El siguiente ejemplo obtiene 100 enteros aleatorios entre 4 y 11 (inclusive):
function randRange(min:Number, max:Number):Number { var randomNum:Number = Math.floor(Math.random() * (max - min + 1)) + min; return randomNum; } for (var i = 0; i < 100; i++) { var n:Number = randRange(4, 11) trace(n); }
round (mtodo Math.round)

public static round(x:Number) : Number
Redondea el valor del parmetro x hacia arriba o hacia abajo con el entero ms prximo y devuelve el valor resultante. Si el parmetro x es equidistante de los dos enteros ms prximos a l (es decir, que el nmero termina en 0,5), el valor se redondea al alza con el siguiente entero mayor. Disponibilidad Flash Lite 2.0 Parmetros x:Number - Un nmero.

Valor devuelto Number - Nmero; entero. Ejemplo El ejemplo siguiente devuelve un nmero aleatorio comprendido entre dos enteros especificados.
function randRange(min:Number, max:Number):Number { var randomNum:Number = Math.round(Math.random() * (max-min+1) + (min-.5)); return randomNum; } for (var i = 0; i<25; i++) { trace(randRange(4, 11)); }
Vase tambin
ceil (mtodo Math.ceil), floor (mtodo Math.floor)
sin (mtodo Math.sin)

public static sin(x:Number) : Number
Calcula y devuelve el seno del ngulo especificado en radianes. Para calcular un radin, consulte la descripcin incluida en la entrada de la clase Math. Disponibilidad Flash Lite 2.0 Parmetros x:Number - Nmero que representa un ngulo medido en radianes. Valor devuelto Number - Nmero; seno del ngulo especificado (entre -1.0 y 1.0). Ejemplo El ejemplo siguiente dibuja un crculo utilizando la constante matemtica pi, el seno de un ngulo y la API de dibujo

Vase tambin
acos (mtodo Math.acos), asin (mtodo Math.asin), atan (mtodo Math.atan), atan2 (mtodo Math.atan2), cos (mtodo Math.cos), tan (mtodo Math.tan)
sqrt (mtodo Math.sqrt)

public static sqrt(x:Number) : Number
Calcula y devuelve la raz cuadrada del nmero especificado. Disponibilidad Flash Lite 2.0 Parmetros x:Number - Nmero o expresin mayor o igual que 0. Valor devuelto Number - Un nmero si el parmetro x es mayor o igual a cero; en caso contrario, NaN (no es un nmero).
SQRT1_2 (propiedad Math.SQRT1_2)

public static SQRT1_2 : Number
Constante matemtica para la raz cuadrada de una mitad, con un valor aproximado de 0,7071067811865476. Disponibilidad Flash Lite 2.0 Ejemplo Este ejemplo rastrea el valor de Math.SQRT1_2.
trace(Math.SQRT1_2); // Output: 0.707106781186548
SQRT2 (propiedad Math.SQRT2)

public static SQRT2 : Number
Constante matemtica para la raz cuadrada de 2, con un valor aproximado de 1,4142135623730951. Disponibilidad Flash Lite 2.0 Ejemplo Este ejemplo rastrea el valor de Math.SQRT2.
trace(Math.SQRT2); // Output: 1.4142135623731
tan (mtodo Math.tan)

public static tan(x:Number) : Number

Calcula y devuelve la tangente del ngulo especificado. Para calcular un radin, utilice la informacin descrita en la introduccin a la clase Math. Disponibilidad Flash Lite 2.0 Parmetros x:Number - Nmero que representa un ngulo medido en radianes. Valor devuelto Number - Un nmero; tangente del parmetro x. Ejemplo El ejemplo siguiente dibuja un crculo utilizando la constante matemtica pi, la tangente de un ngulo y la API de dibujo.
Vase tambin
acos (mtodo Math.acos), asin (mtodo Math.asin), atan (mtodo Math.atan), atan2 (mtodo Math.atan2), cos (mtodo Math.cos), sin (mtodo Math.sin)
Matrix (flash.geom.Matrix))
Object | +-flash.geom.Matrix public class Matrix extends Object
La clase flash.geom.Matrix representa una matriz de transformacin que determina cmo asignar puntos de un espacio de coordenadas a otro. Si establece las propiedades de un objeto Matrix y lo aplica a un objeto MovieClip o BitmapData, puede realizar varias transformaciones grficas en el objeto. Estas funciones de transformacin son la traslacin (cambio de posicin x e y), giro, cambio de escala y sesgo.

En su conjunto estas transformaciones se conocen como transformaciones afines. Las transformaciones afines conservan la colinealidad durante las transformaciones, por lo que las lneas paralelas siguen siendo paralelas. Para aplicar una matriz de transformacin a un clip de pelcula, cree un objeto flash.geom. Transforme el objeto y defina su propiedad Matrix en la matriz de transformacin. Los objetos Matrix tambin se utilizan como parmetros de algunos mtodos, como el mtodo draw() de la clase flash.display.BitmapData. Un objeto de matriz de transformacin se considera como una matriz de 3 x 3 con el contenido siguiente:
En las matrices de transformacin tradicionales, las propiedades u, v y w ofrecen capacidades adicionales. La clase Matrix slo puede funcionar en un espacio bidimensional de modo que siempre presupone que los valores de propiedadu y v son 0.0 y que el valor de propiedad w es 1.0. Es decir, los valores efectivos de la matriz son los siguientes:
Es posible obtener y establecer los valores de las otras seis propiedades de un objeto Matrix: a, b, c, d, tx y ty. La clase Matrix admite las cuatro tipos principales de funciones de transformacin: traslacin, escala, rotacin y sesgo. Hay mtodos especializados para tres de estas funciones, segn se describe en la siguiente tabla.
Transformacin Mtodo Valores Matrix Resultado mostrado Descripcin
Traslacin (desplazamiento)
translate(tx, ty)
Desplaza la imagen tx pxeles hacia la derecha y ty pxeles hacia abajo.

Transformacin
Mtodo
Valores Matrix
Resultado mostrado
Descripcin
Escala
scale(sx, sy)
Cambia el tamao de la imagen multiplicando la ubicacin de cada pxel por sx en el eje x y por sy en el eje y. Gira la imagen segn el ngulo q, medido en radianes
Rotacin
rotate(q)
Sesgo o inclinacin
Ninguno; se deben establecer las propiedades b y c.
Desplaza de forma progresiva la imagen en una direccin paralela al eje x o y. El valor skx acta como multiplicador para controlar la distancia de deslizamiento a lo largo del eje x; sky controla la distancia de deslizamiento a lo largo del eje y.
Cada funcin de transformacin altera las propiedades de la matriz actual de forma que puede combinar distintas transformaciones. Para ello, puede llamar a ms de una funcin de transformacin antes de aplicar la matriz a el destino de mapa de bits o el clip de pelcula. Disponibilidad Flash Lite 3.1 Vase tambin
transform (propiedad MovieClip.transform), Transform (flash.geom.Transform), draw (mtodo BitmapData.draw), a (propiedad Matrix.a), b (propiedad Matrix.b), c (propiedad Matrix.c), d (propiedad Matrix.d), tx (propiedad Matrix.tx), ty (propiedad Matrix.ty), translate (mtodo Matrix.translate), scale (mtodo Matrix.scale), rotate (mtodo Matrix.rotate)

Modificadores Propiedad a:Number Descripcin El valor de la primera fila y la primera columna del objeto Matrix, que afecta a la posicin de los pxeles a lo largo del eje x cuando se cambia la escala o gira una imagen. El valor de la primera fila y la segunda columna del objeto Matrix, que afecta a la posicin de los pxeles a lo largo del eje y cuando se gira o sesga una imagen. El valor de la segunda fila y la primera columna del objeto Matrix, que afecta a la posicin de los pxeles a lo largo del eje x cuando se gira o sesga una imagen. El valor de la segunda fila y la segunda columna del objeto Matrix, que afecta a la posicin de los pxeles a lo largo del eje y cuando se cambia la escala o se gira una imagen. La distancia que se trasladar cada punto a lo largo del eje x. La distancia que se trasladar cada punto a lo largo del eje y.
b:Number
c :Number
d: Number
tx: Number ty: Number
Firma Matrix([a:Number, [b:Number], [c:Number], [d:Number], [tx:Number], [ty:Number]) Descripcin Crea un nuevo objeto Matrix con los parmetros especificados.
Resumen de mtodos
Modificadores Firma clone(): Matrix Descripcin Devuelve un nuevo objeto Matrix que es una copia de esta matriz, con una copia exacta del objeto contenido. Concatena una matriz con la matriz actual y combina eficazmente los efectos geomtricos de ambas matrices. Incluye parmetros para escala, rotacin y traslacin.
concat(m:Matrix) :
Void
createBox(scaleX:Num ber, scaleY:Number,[rota tion:Number],[tx:Nu mber], [ty:Number])

: Void
createGradientBox(widt h:Number, height:Number,[rota tion:Number],[tx:Nu mber],[ty:Number:]) : Void
Crea el estilo especfico de matriz esperado por el mtodo MovieClip.beginGradientFill().

Modificadores
Firma deltaTransformPoint(pt: Point) :Point
Descripcin Tras especificar un punto en el espacio de coordenadas previas a la transformacin, devuelve las coordenadas de dicho punto despus de la transformacin. Establece cada propiedad de la matriz con un valor que hace que una pelcula o un constructo geomtrico transformado sea idntico al original. Realiza la transformacin inversa de la matriz original. Establece los valores de la matriz actual de manera que la matriz se pueda utilizar para aplicar una transformacin de rotacin. Modifica una matriz de manera que su efecto, cuando se aplique, sea cambiar el tamao de una imagen. Devuelve un valor de texto con las propiedades del objeto Matrix. Aplica una transformacin geomtrica representada por el objeto Matrix al punto especificado. Modifica un objeto Matrix de manera que el efecto de su transformacin sea mover un objeto a lo largo de los ejes x e y.
identity() : Void
invert() : Void rotate(angle:Number)

: Void
scale(sx:Number, sy:Number) : Void toString() : String transformPoint(pt:Point ):Point translate(tx:Number, ty:Number) : Void
a (propiedad Matrix.a)
public a : Number
El valor de la primera fila y la primera columna del objeto Matrix, que afecta a la posicin de los pxeles a lo largo del eje x cuando se cambia la escala o gira una imagen. Disponibilidad Flash Lite 3.1 Ejemplo En el ejemplo siguiente, se crea el objeto Matrix myMatrix y se define su valor a.
import flash.geom.Matrix; var myMatrix:Matrix = new Matrix(); trace(myMatrix.a); // 1 myMatrix.a = 2; trace(myMatrix.a); // 2
b (propiedad Matrix.b)
public b : Number
El valor de la primera fila y la segunda columna del objeto Matrix, que afecta a la posicin de los pxeles a lo largo del eje y cuando se gira o sesga una imagen.

Disponibilidad Flash Lite 3.1 Ejemplo En el ejemplo siguiente, se crea el objeto Matrix myMatrix y se define su valor b.
import flash.geom.Matrix; var myMatrix:Matrix = new Matrix(); trace(myMatrix.b); // 0 var degrees:Number = 45; var radians:Number = (degrees/180) Math.PI; myMatrix.b = radians; trace(myMatrix.b); // 0.785398163397448
c (propiedad Matrix.c)
public c : Number
El valor de la segunda fila y la primera columna del objeto Matrix, que afecta a la posicin de los pxeles a lo largo del eje x cuando se gira o sesga una imagen. Disponibilidad Flash Lite 3.1 Ejemplo En el ejemplo siguiente, se crea el objeto Matrix myMatrix y se define su valor c.
import flash.geom.Matrix; var myMatrix:Matrix = new Matrix(); trace(myMatrix.c); // 0 var degrees:Number = 45; var radians:Number = (degrees/180) Math.PI; myMatrix.c = radians; trace(myMatrix.c); // 0.785398163397448
clone (mtodo Matrix.clone)

public clone() : Matrix
Devuelve un nuevo objeto Matrix que es una copia de esta matriz, con una copia exacta del objeto contenido. Disponibilidad Flash Lite 3.1 Valor devuelto Matrix - Un objeto Matrix.

Ejemplo El siguiente ejemplo crea la variable clonedMatrix a partir de la variable myMatrix. La clase Matrix no tiene un mtodo equals, por lo que el siguiente ejemplo utiliza una funcin escrita de manera personalizada para comprobar la igualdad de dos matrices.
import flash.geom.Matrix; var myMatrix:Matrix = new Matrix(2, 0, 0, 2, 0, 0); var clonedMatrix:Matrix = new Matrix(); trace(myMatrix); // (a=2, b=0, c=0, d=2, tx=0, ty=0) trace(clonedMatrix); // (a=1, b=0, c=0, d=1, tx=0, ty=0) trace(equals(myMatrix, clonedMatrix)); // false clonedMatrix = myMatrix.clone(); trace(myMatrix); // (a=2, b=0, c=0, d=2, tx=0, ty=0) trace(clonedMatrix); // (a=2, b=0, c=0, d=2, tx=0, ty=0) trace(equals(myMatrix, clonedMatrix)); // true function equals(m1:Matrix, m2:Matrix):Boolean { return m1.toString() == m2.toString(); }
concat (mtodo Matrix.concat)

public concat(m:Matrix) : Void
Concatena una matriz con la matriz actual y combina eficazmente los efectos geomtricos de ambas matrices. En trminos matemticos, la concatenacin de matrices equivale a combinarlas utilizando la multiplicacin de matrices. Por ejemplo, si la matriz m1 aplica a un objeto una escala de factor cuatro y la matriz m2 gira un objeto 1.5707963267949 radianes (Math.PI/2), m1.concat(m2) transforma m1 en una matriz que aplica a un objeto una escala cuatro y gira el objeto Math.PI/2 radianes. Este mtodo sustituye la matriz original con la concatenada. Si desea concatenar dos matrices sin alterar ninguna de las originales, puede copiar primero la matriz de origen con el mtodo clone(), tal como se muestra en la seccin de ejemplos. Disponibilidad Flash Lite 3.1 Parmetros m:Matrix - La matriz que se concatenar con la matriz original. Ejemplo El ejemplo siguiente crea tres matrices que definen transformaciones para tres clips de pelcula rectangulares. Las primeras dos matrices rotate45Matrix y doubleScaleMatrix se aplican a los dos rectngulos rectangleMc_1 y rectangleMc_2. A continuacin, se crea la tercera matriz utilizando el mtodo concat() con rotate45Matrix y doubleScaleMatrix para crear scaleAndRotateMatrix. Esta matriz se aplica entonces a rectangleMc_3 para escalar y rotar.

import flash.geom.Matrix; import flash.geom.Transform; var var var var rectangleMc_0:MovieClip rectangleMc_1:MovieClip rectangleMc_2:MovieClip rectangleMc_3:MovieClip = = = = createRectangle(20, createRectangle(20, createRectangle(20, createRectangle(20, 80, 80, 80, 80, 0x000000); 0xFF0000); 0x00FF00); 0x0000FF);
var rectangleTrans_1:Transform = new Transform(rectangleMc_1); var rectangleTrans_2:Transform = new Transform(rectangleMc_2); var rectangleTrans_3:Transform = new Transform(rectangleMc_3); var rotate45Matrix:Matrix = new Matrix(); rotate45Matrix.rotate(Math.PI/4); rectangleTrans_1.matrix = rotate45Matrix; rectangleMc_1._x = 100; trace(rotate45Matrix.toString()); // (a=0.707106781186548, b=0.707106781186547, c=0.707106781186547, d=0.707106781186548, tx=0, ty=0) var doubleScaleMatrix:Matrix = new Matrix(); doubleScaleMatrix.scale(2, 2); rectangleTrans_2.matrix = doubleScaleMatrix; rectangleMc_2._x = 200; trace(doubleScaleMatrix.toString()); // (a=2, b=0, c=0, d=2, tx=0, ty=0) var scaleAndRotateMatrix:Matrix = doubleScaleMatrix.clone(); scaleAndRotateMatrix.concat(rotate45Matrix); rectangleTrans_3.matrix = scaleAndRotateMatrix; rectangleMc_3._x = 300; trace(scaleAndRotateMatrix.toString()); // (a=1.4142135623731, b=1.41421356237309, c=1.41421356237309, d=1.4142135623731, tx=0, ty=0) function createRectangle(width:Number, height:Number, color:Number):MovieClip { var depth:Number = this.getNextHighestDepth(); var mc:MovieClip = this.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }
createBox (mtodo Matrix.createBox)

public createBox(scaleX:Number, scaleY:Number, [rotation:Number], [tx:Number], [ty:Number]) : Void
Incluye parmetros para escala, rotacin y traslacin. Cuando se aplica a una matriz define sus valores en funcin de dichos parmetros. El mtodo createBox() permite obtener la misma matriz que si aplicara los mtodos identity(), rotate(), scale() y translate() de forma consecutiva. Por ejemplo, mat1.createBox(2,2,Math.PI/5, 100, 100) tiene el mismo efecto que lo siguiente:

import flash.geom.Matrix; var mat1:Matrix = new Matrix(); mat1.identity(); mat1.rotate(Math.PI/4); mat1.scale(2,2); mat1.translate(10,20);
Disponibilidad Flash Lite 3.1 Parmetros scaleX:Number - El factor de escala horizontal. scaleY:Number - El factor de escala vertical. rotation:Number [opcional] - Cantidad que se desea rotar, en radianes. El valor predeterminado es 0. tx:Number [opcional] - Nmero de pxeles que se trasladarn (movern) hacia la derecha a lo largo del eje x. El valor predeterminado es 0. ty:Number [opcional] - Nmero de pxeles que se trasladarn (movern) hacia abajo a lo largo del eje y. El valor predeterminado es 0. Ejemplo En el ejemplo siguiente se definen las escalas scaleX y scaleY, la rotacin, la ubicacin x y la ubicacin y de myMatrix llamando a su mtodo createBox().
import flash.geom.Matrix; import flash.geom.Transform; var myMatrix:Matrix = new Matrix(); trace(myMatrix.toString()); // (a=1, b=0, c=0, d=1, tx=0, ty=0) myMatrix.createBox(1, 2, Math.PI/4, 100, 200); trace(myMatrix.toString()); // (a=0.707106781186548, b=1.41421356237309, c=0.707106781186547, d=1.4142135623731, tx=100, ty=200) var rectangleMc:MovieClip = createRectangle(20, 80, 0xFF0000); var rectangleTrans:Transform = new Transform(rectangleMc); rectangleTrans.matrix = myMatrix;
createGradientBox (mtodo Matrix.createGradientBox)

public createGradientBox(width:Number, height:Number, [rotation:Number], [tx:Number], [ty:Number]) : Void
Crea el estilo especfico de matriz esperado por el mtodo MovieClip.beginGradientFill(). La anchura y altura se cambian a un valor de par scaleX/scaleY y los valores tx/ty se desplazan con la mitad de la anchura y altura. Disponibilidad Flash Lite 3.1

Parmetros width:Number - La anchura del cuadro de degradado. height:Number - La altura del cuadro de degradado. rotation:Number [opcional] - Cantidad que se desea rotar, en radianes. El valor predeterminado es 0. tx:Number [opcional] - Distancia en pxeles que se trasladar (movern) hacia la derecha a lo largo del eje x. Este valor se desplazar la mitad del parmetro width. El valor predeterminado es 0. ty:Number [opcional] - Distancia en pxeles que se trasladar (movern) hacia la derecha a lo largo del eje y. Este valor se desplazar la mitad del parmetro height. El valor predeterminado es 0. Ejemplo El siguiente ejemplo utiliza myMatrix como parmetro del mtodo beginGradientFill() de un objeto MovieClip.
import flash.geom.Matrix; var myMatrix:Matrix = new Matrix(); trace(myMatrix.toString()); // (a=1, b=0, c=0, d=1, tx=0, ty=0) myMatrix.createGradientBox(200, 200, 0, 50, 50); trace(myMatrix.toString()); // (a=0.1220703125, b=0, c=0, d=0.1220703125, tx=150, ty=150) var depth:Number = this.getNextHighestDepth(); var mc:MovieClip = this.createEmptyMovieClip("mc_" + depth, depth); var colors:Array = [0xFF0000, 0x0000FF]; var alphas:Array = [100, 100]; var ratios:Array = [0, 0xFF]; mc.beginGradientFill("linear", colors, alphas, ratios, myMatrix); mc.lineTo(0, 300); mc.lineTo(300, 300); mc.lineTo(300, 0); mc.lineTo(0, 0);
Vase tambin
beginGradientFill (mtodo MovieClip.beginGradientFill)
d (propiedad Matrix.d)
public d : Number
El valor de la segunda fila y la segunda columna del objeto Matrix, que afecta a la posicin de los pxeles a lo largo del eje y cuando se cambia la escala o se gira una imagen. Disponibilidad Flash Lite 3.1 Ejemplo En el ejemplo siguiente, se crea el objeto Matrix myMatrix y se define su valor d.

import flash.geom.Matrix; var myMatrix:Matrix = new Matrix(); trace(myMatrix.d); // 1 myMatrix.d = 2; trace(myMatrix.d); // 2
deltaTransformPoint (mtodo Matrix.deltaTransformPoint)

public deltaTransformPoint(pt:Point) : Point
Tras especificar un punto en el espacio de coordenadas previas a la transformacin, devuelve las coordenadas de dicho punto despus de la transformacin. A diferencia de la transformacin estndar aplicada con el mtodo transformPoint(), la transformacin del mtodo deltaTransformPoint() no tiene en cuenta los parmetros de traslacin tx e ty. Disponibilidad Flash Lite 3.1 Parmetros pt:Point - Objeto Point. Valor devuelto Point - El nuevo objeto Point. Ejemplo El siguiente ejemplo utiliza el mtodo deltaTransformPoint() para crear deltaTransformedPoint a partir de myPoint. En el ejemplo, el mtodo translate() no alterna la posicin del punto llamado deltaTransformedPoint. No obstante, el mtodo scale() s afecta a la posicin del punto. Aumenta el valor x del punto multiplicndolo por tres, con lo que pasa de 50 a 150.

import flash.geom.Matrix; import flash.geom.Point; var myMatrix:Matrix = new Matrix(); trace(myMatrix); // (a=1, b=0, c=0, d=1, tx=0, ty=0) myMatrix.translate(100, 0); trace(myMatrix); // (a=1, b=0, c=0, d=1, tx=100, ty=0) myMatrix.scale(3, 3); trace(myMatrix); // (a=3, b=0, c=0, d=3, tx=300, ty=0) var myPoint:Point = new Point(50,0); trace(myPoint); // (50, 0) var deltaTransformedPoint:Point = myMatrix.deltaTransformPoint(myPoint); trace(deltaTransformedPoint); // (150, 0) var pointMc_0:MovieClip = createRectangle(10, 10, 0xFF0000); pointMc_0._x = myPoint.x; var pointMc_1:MovieClip = createRectangle(10, 10, 0x00FF00); pointMc_1._x = deltaTransformedPoint.x; function createRectangle(width:Number, height:Number, color:Number):MovieClip { var depth:Number = this.getNextHighestDepth(); var mc:MovieClip = this.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }
identity (mtodo Matrix.identity)

public identity() : Void
Establece cada propiedad de la matriz con un valor que hace que una pelcula o un constructo geomtrico transformado sea idntico al original. Despus de llamar al mtodo identity(), la matriz resultante tiene las propiedades siguientes: a=1, b=0, c=0, d=1, tx=0, ty=0. En la notacin de matrices, la matriz de identidad tendr este aspecto:

Ejemplo El siguiente ejemplo ilustra como una llamada al mtodo identity() convierte el objeto Matrix que realiza la llamada en un objeto Matrix identidad. El nmero y los tipos de transformaciones aplicadas al objeto Matrix original previamente carecen de importancia. Si se llama a identity(), los valores de la matriz se convierten a (a=1, b=0, c=0, d=1, tx=0, ty=0).
import flash.geom.Matrix; var myMatrix:Matrix = new Matrix(2, 0, 0, 2, 0 ,0); trace(myMatrix.toString()); // (a=2, b=0, c=0, d=2, tx=0, ty=0) myMatrix.rotate(Math.atan(3/4)); trace(myMatrix.toString()); // (a=1.6, b=1.2, c=-1.2, d=1.6, tx=0, ty=0) myMatrix.translate(100,200); trace(myMatrix.toString()); // (a=1.6, b=1.2, c=-1.2, d=1.6, tx=100, ty=200) myMatrix.scale(2, 2); trace(myMatrix.toString()); // (a=3.2, b=2.4, c=-2.4, d=3.2, tx=200, ty=400) myMatrix.identity(); trace(myMatrix.toString()); // (a=1, b=0, c=0, d=1, tx=0, ty=0)
invert (mtodo Matrix.invert)

public invert() : Void
Realiza la transformacin inversa de la matriz original. Puede aplicar la matriz inversa a un objeto para deshacer la transformacin realizada al aplicar la matriz original. Disponibilidad Flash Lite 3.1 Ejemplo El siguiente ejemplo crea halfScaleMatrix llamando al mtodo invert() de doubleScaleMatrix y, a continuacin, muestra que estas dos matrices son una la inversa de la otra, es decir, matrices que deshacen todas las transformaciones realizadas por la otra. El ejemplo muestra esta inversin creando originalAndInverseMatrix, que es igual a noScaleMatrix.

import flash.geom.Matrix; import flash.geom.Transform; var var var var var var var var rectangleMc_0:MovieClip rectangleMc_1:MovieClip rectangleMc_2:MovieClip rectangleMc_3:MovieClip = = = = createRectangle(20, createRectangle(20, createRectangle(20, createRectangle(20, = = = = new new new new 80, 80, 80, 80, 0xFF0000); 0x00FF00); 0x0000FF); 0x000000);
rectangleTrans_0:Transform rectangleTrans_1:Transform rectangleTrans_2:Transform rectangleTrans_3:Transform
Transform(rectangleMc_0); Transform(rectangleMc_1); Transform(rectangleMc_2); Transform(rectangleMc_3);
var doubleScaleMatrix:Matrix = new Matrix(2, 0, 0, 2, 0, 0); rectangleTrans_0.matrix = doubleScaleMatrix; trace(doubleScaleMatrix.toString()); // (a=2, b=0, c=0, d=2, tx=0, ty=0) var noScaleMatrix:Matrix = new Matrix(1, 0, 0, 1, 0, 0); rectangleTrans_1.matrix = noScaleMatrix; rectangleMc_1._x = 100; trace(noScaleMatrix.toString()); // (a=1, b=0, c=0, d=1, tx=0, ty=0) var halfScaleMatrix:Matrix = doubleScaleMatrix.clone(); halfScaleMatrix.invert(); rectangleTrans_2.matrix = halfScaleMatrix; rectangleMc_2._x = 200; trace(halfScaleMatrix.toString()); // (a=0.5, b=0, c=0, d=0.5, tx=0, ty=0) var originalAndInverseMatrix:Matrix = doubleScaleMatrix.clone(); originalAndInverseMatrix.concat(halfScaleMatrix); rectangleTrans_3.matrix = originalAndInverseMatrix; rectangleMc_3._x = 300; trace(originalAndInverseMatrix.toString()); // (a=1, b=0, c=0, d=1, tx=0, ty=0) function createRectangle(width:Number, height:Number, color:Number):MovieClip { var depth:Number = this.getNextHighestDepth(); var mc:MovieClip = this.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }
Constructor Matrix
public Matrix([a:Number], [b:Number], [c:Number], [d:Number], [tx:Number], [ty:Number])
Crea un nuevo objeto Matrix con los parmetros especificados. En la notacin de matrices, las propiedades se organizarn de este modo:

Si no proporciona ningn parmetro para el nuevo constructor Matrix(), se crea una "matriz identidad" con los valores siguientes:
a = 1 c = 0 tx = 0 b = 0 d = 1 ty = 0
En la notacin de matrices, la matriz de identidad tendr este aspecto:
Disponibilidad Flash Lite 3.1 Parmetros a:Number [opcional] - Valor de la primera fila y la primera columna del nuevo objeto Matrix. b:Number [opcional] - Valor de la primera fila y la segunda columna del nuevo objeto Matrix. c:Number [opcional] - Valor de la segunda fila y la primera columna del nuevo objeto Matrix. d:Number [opcional] - Valor de la segunda fila y la segunda columna del nuevo objeto Matrix. tx:Number [opcional] - Valor de la tercera fila y la primera columna del nuevo objeto Matrix. ty:Number [opcional] - Valor de la tercera fila y la segunda columna del nuevo objeto Matrix. Ejemplo En el ejemplo siguiente, se crea matrix_1 sin enviar ningn parmetro al constructor Matrix y matrix_2 enviando parmetros a dicho constructor. El objeto Matrix matrix_1, que se crea sin parmetros, es una matriz identidad con los valores (a=1, b=0, c=0, d=1, tx=0, ty=0).
import flash.geom.Matrix; var matrix_1:Matrix = new Matrix(); trace(matrix_1); // (a=1, b=0, c=0, d=1, tx=0, ty=0) var matrix_2:Matrix = new Matrix(1, 2, 3, 4, 5, 6); trace(matrix_2); // (a=1, b=2, c=3, d=4, tx=5, ty=6)
rotate (mtodo Matrix.rotate)

public rotate(angle:Number) : Void
Establece los valores de la matriz actual de manera que la matriz se pueda utilizar para aplicar una transformacin de rotacin.

El mtodo rotate() modifica las propiedades a y d del objeto Matrix. En la notacin de matrices, se representara de la siguiente manera:
Disponibilidad Flash Lite 3.1 Parmetros angle:Number - El ngulo de rotacin expresado en radianes. Ejemplo En el siguiente ejemplo, se muestra cmo el mtodo rotate() gira rectangleMc 30 grados en el sentido de las agujas del reloj. Si se aplica myMatrix a rectangleMc se restablecer su valor _x, lo que le permitir restablecerlo a 100 manualmente.
import flash.geom.Matrix; import flash.geom.Transform; var myMatrix:Matrix = new Matrix(); trace(myMatrix.toString()); // (a=1, b=0, c=0, d=1, tx=0, ty=0) var degrees:Number = 30; var radians:Number = (degrees/180) Math.PI; myMatrix.rotate(radians); trace(myMatrix.toString()); // (a=0.866025403784439, b=0.5, c=-0.5, d=0.866025403784439, tx=0, ty=0) var rectangleMc:MovieClip = createRectangle(20, 80, 0xFF0000); trace(rectangleMc._x); // 0 rectangleMc._x = 100; trace(rectangleMc._x); // 100 var rectangleTrans:Transform = new Transform(rectangleMc); rectangleTrans.matrix = myMatrix; trace(rectangleMc._x); // 0 rectangleMc._x = 100; trace(rectangleMc._x); // 100 function createRectangle(width:Number, height:Number, color:Number):MovieClip { var depth:Number = this.getNextHighestDepth(); var mc:MovieClip = this.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }

El ejemplo anterior utiliza la propiedad _x del objeto MovieClip para cambiar de posicin rectangleMc. Por lo general, cuando se trabaja con la colocacin de objetos Matrix, se considera poco elegante mezclar diferentes tcnicas de colocacin. El ejemplo anterior, escrito con la sintaxis correcta, concatenara una matriz de traslacin con myMatrix para cambiar la ubicacin horizontal de rectangleMc. El siguiente ejemplo ilustra este procedimiento.
import flash.geom.Matrix; import flash.geom.Transform; var myMatrix:Matrix = new Matrix(); trace(myMatrix.toString()); // (a=1, b=0, c=0, d=1, tx=0, ty=0) var degrees:Number = 30; var radians:Number = (degrees/180) * Math.PI; myMatrix.rotate(radians); trace(myMatrix.toString()); // (a=0.866025403784439, b=0.5, c=-0.5, d=0.866025403784439, tx=0, ty=0) var translateMatrix:Matrix = new Matrix(); translateMatrix.translate(100, 0); myMatrix.concat(translateMatrix); trace(myMatrix.toString()); // (a=0.866025403784439, b=0.5, c=-0.5, d=0.866025403784439, tx=100, ty=0) var rectangleMc:MovieClip = createRectangle(20, 80, 0xFF0000); trace(rectangleMc._x); // 0 rectangleMc._x = 100; trace(rectangleMc._x); // 100 var rectangleTrans:Transform = new Transform(rectangleMc); rectangleTrans.matrix = myMatrix; trace(rectangleMc._x); // 100 function createRectangle(width:Number, height:Number, color:Number):MovieClip { var depth:Number = this.getNextHighestDepth(); var mc:MovieClip = this.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }
scale (mtodo Matrix.scale)

public scale(sx:Number, sy:Number) : Void
Modifica una matriz de manera que su efecto, cuando se aplique, sea cambiar el tamao de una imagen. En la imagen tras el cambio de tamao, la ubicacin de cada pxel del eje x se multiplica por sx y en el eje y la ubicacin se multiplica por sy.

El mtodo scale() modifica las propiedades a y d del objeto Matrix. En la notacin de matrices, se representara de la siguiente manera:
Disponibilidad Flash Lite 3.1 Parmetros sx:Number - Multiplicador utilizado para aplicar una escala al objeto a lo largo del eje x. sy:Number - Multiplicador utilizado para aplicar una escala al objeto a lo largo del eje y. Ejemplo El siguiente ejemplo utiliza el mtodo scale() para aplicar una escala a myMatrix con el factor tres horizontalmente y el factor cuatro verticalmente.
import flash.geom.Matrix; var myMatrix:Matrix = new Matrix(2, 0, 0, 2, 100, 100); trace(myMatrix.toString()); // (a=2, b=0, c=0, d=2, tx=100, ty=100) myMatrix.scale(3, 4); trace(myMatrix.toString()); // (a=6, b=0, c=0, d=8, tx=300, ty=400)
toString (mtodo Matrix.toString)

Devuelve un valor de texto con las propiedades del objeto Matrix. Disponibilidad Flash Lite 3.1 Valor devuelto
String en la pgina 600 - Cadena con los valores de las propiedades del objeto Matrix: a, b, c, d, tx y ty.
Ejemplo El siguiente ejemplo crea myMatrix y convierte sus valores a una cadena con el formato (a=A, b=B, c=C, d=D, tx=TX, ty=TY).
import flash.geom.Matrix; var myMatrix:Matrix = new Matrix(); trace("myMatrix: " + myMatrix.toString()); // (a=1, b=0, c=0, d=1, tx=0, ty=0)
transformPoint (mtodo Matrix.transformPoint)

public transformPoint(pt:Point) : Point

Aplica una transformacin geomtrica representada por el objeto Matrix al punto especificado. Disponibilidad Flash Lite 3.1 Parmetros pt:Point - Objeto Point (x,y) que se desea transformar. Valor devuelto Point (flash.geom.Point) - El nuevo objeto Point. Ejemplo El siguiente ejemplo utiliza el mtodo transformPoint() para crear transformedPoint a partir de myPoint. El mtodo translate() no afecta a la posicin de transformedPoint. En el ejemplo, scale() aumenta el valor x original multiplicndolo por tres, por lo que pasa de 50 a 150 y el mtodotranslate() aumenta x en 300, por lo que alcanza un valor total de 450.
import flash.geom.Matrix; import flash.geom.Point; var myMatrix:Matrix = new Matrix(); trace(myMatrix); // (a=1, b=0, c=0, d=1, tx=0, ty=0) myMatrix.translate(100, 0); trace(myMatrix); // (a=1, b=0, c=0, d=1, tx=100, ty=0) myMatrix.scale(3, 3); trace(myMatrix); // (a=3, b=0, c=0, d=3, tx=300, ty=0) var myPoint:Point = new Point(50,0); trace(myPoint); // (50, 0) var transformedPoint:Point = myMatrix.transformPoint(myPoint); trace(transformedPoint); // (450, 0) var pointMc_0:MovieClip = createRectangle(10, 10, 0xFF0000); pointMc_0._x = myPoint.x; var pointMc_1:MovieClip = createRectangle(10, 10, 0x00FF00); pointMc_1._x = transformedPoint.x; function createRectangle(width:Number, height:Number, color:Number):MovieClip { var depth:Number = this.getNextHighestDepth(); var mc:MovieClip = this.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }

translate (mtodo Matrix.translate)

public translate(tx:Number, ty:Number) : Void
Modifica un objeto Matrix de manera que el efecto de su transformacin sea mover un objeto a lo largo de los ejes x e y. El mtodo translate() modifica las propiedades tx y ty del objeto Matrix. En la notacin de matrices, se representara de la siguiente manera:
Disponibilidad Flash Lite 3.1 Parmetros tx:Number - Movimiento total hacia la derecha a lo largo del eje x, en pxeles. ty:Number - Movimiento total hacia abajo a lo largo del eje y, en pxeles. Ejemplo El siguiente ejemplo utiliza el mtodo translate() para cambiar la posicin de rectangleMc x:100 e y:50. El mtodo translate() afecta a las propiedades de traslacin tx y ty, pero no afecta a las propiedades a, b, c o d.
import flash.geom.Matrix; var myMatrix:Matrix = new Matrix(2, 0, 0, 2, 100, 100); trace(myMatrix.toString()); // (a=2, b=0, c=0, d=2, tx=100, ty=100) myMatrix.translate(100, 50); trace(myMatrix.toString()); // (a=2, b=0, c=0, d=2, tx=200, ty=150)
tx (propiedad Matrix.tx)
public tx : Number
La distancia que se trasladar cada punto a lo largo del eje x. Representa el valor de la tercera fila y la primera columna del nuevo objeto Matrix. Disponibilidad Flash Lite 3.1 Ejemplo En el ejemplo siguiente, se crea el objeto Matrix myMatrix y se define su valor tx.
import flash.geom.Matrix; var myMatrix:Matrix = new Matrix(); trace(myMatrix.tx); // 0 myMatrix.tx = 50; // 50 trace(myMatrix.tx);

ty (propiedad Matrix.ty)
public ty : Number
La distancia que se trasladar cada punto a lo largo del eje y. Representa el valor de la tercera fila y la segunda columna del nuevo objeto Matrix. Disponibilidad Flash Lite 3.1 Ejemplo El ejemplo siguiente crea el objeto Matrix myMatrix y define su valor ty.
import flash.geom.Matrix; var myMatrix:Matrix = new Matrix(); trace(myMatrix.ty); // 0 myMatrix.ty = 50; trace(myMatrix.ty); // 50
Mouse
Object | +-Mouse public class Mouse extends Object
La clase Mouse es una clase de nivel superior a cuyos mtodos y propiedades puede acceder sin emplear un constructor. Puede utilizar los mtodos de la clase Mouse para aadir y eliminar detectores y para gestionar eventos de ratn. Los miembros de esta clase se admiten en Flash Lite slo si System.capabilities.hasMouse es true o System.capabilities.hasStylus es true. Disponibilidad Flash Lite 2.0 Resumen de propiedades Propiedades heredadas de la clase Object

Resumen de eventos
Evento onMouseDown = function() {} onMouseMove =
function() {}
Descripcin Se notifica cuando se presiona el botn del ratn.
Se notifica cuando se mueve el ratn.
onMouseUp =
function() {}
Se notifica cuando se suelta el botn del ratn.
Resumen de mtodos
Modificadores
static
Firma addListener(listener: Object) : Void
Descripcin Registra un objeto para recibir notificaciones de los detectores onMouseDown, onMouseMove y onMouseUp.
static
removeListener(listene Elimina un objeto registrado previamente con r:Object) : Boolean addListener().

addProperty (mtodo Object.addProperty), hasOwnProperty (mtodo Object.hasOwnProperty), isPropertyEnumerable (mtodo Object.isPropertyEnumerable), isPrototypeOf (mtodo Object.isPrototypeOf), registerClass (mtodo Object.registerClass), toString (mtodo Object.toString)unwatch (mtodo Object.unwatch), valueOf (mtodo Object.valueOf), watch (mtodo Object.watch)
addListener (mtodo Mouse.addListener)

Registra un objeto para recibir notificaciones de los detectores onMouseDown, onMouseMove y onMouseUp. El parmetro listener debe contener un objeto que tenga un mtodo definido al menos para uno de los detectores. Cuando el botn del ratn se presiona, se mueve, se suelta o se utiliza para desplazamiento, con independencia de cul sea la seleccin de entrada, se invocar el mtodo onMouseDown, onMouseMove u onMouseUp de todos los objetos a la escucha que estn registrados con este mtodo. Varios objetos pueden detectar las notificaciones de ratn. Si el detector ya est registrado, no se producir ningn cambio. Nota: este mtodo se admite en Flash Lite slo si System.capabilities.hasMouse es true o
System.capabilities.hasStylus es true.
Disponibilidad Flash Lite 2.0 Parmetros listener:Object Ejemplo Este ejemplo enva la posicin del cursor a la ventana Salida.

// Create a mouse listener object. var mouseListener:Object = new Object(); mouseListener.onMouseMove = function() { trace(_xmouse); trace(_ymouse); }; Mouse.addListener(mouseListener);
Vase tambin
onMouseDown (detector de eventos Mouse.onMouseDown), onMouseMove (detector de eventos Mouse.onMouseMove), onMouseUp (detector de eventos Mouse.onMouseUp)
onMouseDown (detector de eventos Mouse.onMouseDown)

onMouseDown = function() {}
Se notifica cuando se presiona el botn del ratn. Para utilizar el detector onMouseDown, debe crear un objeto detector. Defina una funcin para onMouseDown y llame a addListener() para registrar el detector en el objeto Mouse, como se muestra en el siguiente cdigo:
var someListener:Object = new Object(); someListener.onMouseDown = function () { ... }; Mouse.addListener(someListener);
Los detectores permiten que diversas partes del cdigo cooperen, ya que varios detectores pueden recibir notificacin de un solo evento. Este detector de eventos se admite en Flash Lite slo si System.capabilities.hasMouse es true o System.capabilities.hasStylus es true. Disponibilidad Flash Lite 2.0 Ejemplo El siguiente ejemplo utiliza la API de dibujo para trazar un rectngulo cuando el usuario pulsa el botn del ratn, lo desplaza y, despus, lo suelta en tiempo de ejecucin.

this.createEmptyMovieClip("canvas_mc", this.getNextHighestDepth()); var mouseListener:Object = new Object(); mouseListener.onMouseDown = function() { this.isDrawing = true; this.orig_x = _xmouse; this.orig_y = _ymouse; this.target_mc = canvas_mc.createEmptyMovieClip("", canvas_mc.getNextHighestDepth()); }; mouseListener.onMouseMove = function() { if (this.isDrawing) { this.target_mc.clear(); this.target_mc.lineStyle(1, 0xFF0000, 100); this.target_mc.moveTo(this.orig_x, this.orig_y); this.target_mc.lineTo(_xmouse, this.orig_y); this.target_mc.lineTo(_xmouse, _ymouse); this.target_mc.lineTo(this.orig_x, _ymouse); this.target_mc.lineTo(this.orig_x, this.orig_y); } updateAfterEvent(); }; mouseListener.onMouseUp = function() { this.isDrawing = false; }; Mouse.addListener(mouseListener);
Vase tambin
onMouseMove (detector de eventos Mouse.onMouseMove)

onMouseMove = function() {}
Se notifica cuando se mueve el ratn. Para utilizar el detector onMouseMove, debe crear un objeto detector. Posteriormente podr definir una funcin para onMouseMove y utilizar addListener() para registrar el detector en el objeto Mouse, como se muestra en el siguiente cdigo:
var someListener:Object = new Object(); someListener.onMouseMove = function () { ... }; Mouse.addListener(someListener);
Los detectores permiten que diversas partes del cdigo cooperen, ya que varios detectores pueden recibir notificacin de un solo evento. Este detector de eventos se admite en Flash Lite slo si System.capabilities.hasMouse es true. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente utiliza el puntero del ratn como herramienta para dibujar lneas con onMouseMove y la interfaz API de dibujo. El usuario dibuja una lnea desplazando el puntero.

this.createEmptyMovieClip("canvas_mc", this.getNextHighestDepth()); var mouseListener:Object = new Object(); mouseListener.onMouseDown = function() { this.isDrawing = true; canvas_mc.lineStyle(2, 0xFF0000, 100); canvas_mc.moveTo(_xmouse, _ymouse); }; mouseListener.onMouseMove = function() { if (this.isDrawing) { canvas_mc.lineTo(_xmouse, _ymouse); } updateAfterEvent(); }; mouseListener.onMouseUp = function() { this.isDrawing = false; }; Mouse.addListener(mouseListener);
El siguiente ejemplo establece las posiciones x e y de la instancia del clip de pelcula pointer_mc en la posicin del puntero x e y. El dispositivo debe admitir un lpiz stylus o un ratn para que el ejemplo funcione. Para utilizar el ejemplo, cree un clip de pelcula y establezca su identificador de vinculacin en pointer_id. A continuacin, aada el siguiente cdigo ActionScript al fotograma 1 de la lnea de tiempo:
this.attachMovie("pointer_id", "pointer_mc", this.getNextHighestDepth()); var mouseListener:Object = new Object(); mouseListener.onMouseMove = function() { pointer_mc._x = _xmouse; pointer_mc._y = _ymouse; }; Mouse.addListener(mouseListener);
Vase tambin
onMouseUp (detector de eventos Mouse.onMouseUp)

onMouseUp = function() {}
Se notifica cuando se suelta el botn del ratn. Para utilizar el detector onMouseUp, debe crear un objeto detector. Posteriormente podr definir una funcin para onMouseUp y utilizar addListener() para registrar el detector en el objeto Mouse, como se muestra en el siguiente cdigo:
var someListener:Object = new Object(); someListener.onMouseUp = function () { ... }; Mouse.addListener(someListener);
Los detectores permiten que diversas partes del cdigo cooperen, ya que varios detectores pueden recibir notificacin de un solo evento. Este detector de eventos se admite en Flash Lite slo si System.capabilities.hasMouse es true o System.capabilities.hasStylus es true. Disponibilidad Flash Lite 2.0

Ejemplo El ejemplo siguiente utiliza el puntero del ratn como herramienta para dibujar lneas con onMouseMove y la interfaz API de dibujo. El usuario dibuja una lnea desplazando el puntero y deja de trazarla soltando el botn del ratn.
this.createEmptyMovieClip("canvas_mc", this.getNextHighestDepth()); var mouseListener:Object = new Object(); mouseListener.onMouseDown = function() { this.isDrawing = true; canvas_mc.lineStyle(2, 0xFF0000, 100); canvas_mc.moveTo(_xmouse, _ymouse); }; mouseListener.onMouseMove = function() { if (this.isDrawing) { canvas_mc.lineTo(_xmouse, _ymouse); } updateAfterEvent(); }; mouseListener.onMouseUp = function() { this.isDrawing = false; }; Mouse.addListener(mouseListener);
Vase tambin
removeListener (mtodo Mouse.removeListener)

Elimina un objeto registrado previamente con addListener(). Nota: este mtodo se admite en Flash Lite slo si System.capabilities.hasMouse es true o System.capabilities.hasStylus es true. Disponibilidad Flash Lite 2.0 Parmetros listener:Object Valor devuelto Boolean - Si el objeto detector se elimina correctamente, el mtodo devolver true; si el objeto detector no se elimina correctamente (por ejemplo, si el objeto detector no se encontraba en la lista de detectores del objeto Mouse), el mtodo devolver false. Ejemplo El ejemplo siguiente asocia tres botones al escenario y permite que el usuario dibuje lneas en el archivo SWF con el puntero del ratn en tiempo de ejecucin. Un botn borra todas las lneas del archivo SWF. El segundo botn elimina el detector del ratn, de modo que el usuario no puede dibujar lneas. El tercer botn aade el detector del ratn despus de que se ha eliminado, de modo que el usuario puede volver a dibujar lneas. Aada el cdigo ActionScript siguiente al fotograma 1 de la lnea de tiempo:

this.createClassObject(mx.controls.Button, "clear_button", this.getNextHighestDepth(), {_x:10, _y:10, label:'clear'}); this.createClassObject(mx.controls.Button, "stopDrawing_button", this.getNextHighestDepth(), {_x:120, _y:10, label:'stop drawing'}); this.createClassObject(mx.controls.Button, "startDrawing_button", this.getNextHighestDepth(), {_x:230, _y:10, label:'start drawing'}); startDrawing_button.enabled = false; // this.createEmptyMovieClip("canvas_mc", this.getNextHighestDepth()); var mouseListener:Object = new Object(); mouseListener.onMouseDown = function() { this.isDrawing = true; canvas_mc.lineStyle(2, 0xFF0000, 100); canvas_mc.moveTo(_xmouse, _ymouse); }; mouseListener.onMouseMove = function() { if (this.isDrawing) { canvas_mc.lineTo(_xmouse, _ymouse); } updateAfterEvent(); }; mouseListener.onMouseUp = function() { this.isDrawing = false; }; Mouse.addListener(mouseListener); var clearListener:Object = new Object(); clearListener.click = function() { canvas_mc.clear(); }; clear_button.addEventListener("click", clearListener); // var stopDrawingListener:Object = new Object(); stopDrawingListener.click = function(evt:Object) { Mouse.removeListener(mouseListener); evt.target.enabled = false; startDrawing_button.enabled = true; }; stopDrawing_button.addEventListener("click", stopDrawingListener); var startDrawingListener:Object = new Object(); startDrawingListener.click = function(evt:Object) { Mouse.addListener(mouseListener); evt.target.enabled = false; stopDrawing_button.enabled = true; }; startDrawing_button.addEventListener("click", startDrawingListener);
MovieClip
Object | +-MovieClip public dynamic class MovieClip extends Object

Utilice la clase MovieClip para manejar clips de pelcula con ActionScript. No hay ningn constructor para la clase MovieClip. Para crear una nueva instancia de un clip de pelcula, siga uno de estos pasos:
Dibuje un clip de pelcula en el escenario con una herramienta de edicin de Flash y asgnele un nombre de
instancia en el inspector de propiedades.
Llame al mtodo attachMovie() para crear una nueva instancia de clip de pelcula basada en un smbolo de clip
de pelcula que existe en la biblioteca.
Llame a createEmptyMovieClip() para crear una nueva instancia vaca de clip de pelcula como elemento
secundario de otro clip de pelcula.
Llame al mtodo duplicateMovieClip() para crear una instancia de clip de pelcula basada en otro clip de
pelcula. Disponibilidad Flash Lite 2.0 Resumen de propiedades
Modificadores Propiedad _alpha:Number _currentframe:Number [slo lectura] _droptarget:String [slo lectura] Descripcin Valor de transparencia alfa del clip de pelcula. Devuelve el nmero del fotograma en el que est situada la cabeza lectora en la lnea de tiempo del clip de pelcula. Devuelve la ruta absoluta en notacin de sintaxis con barras de la instancia de clip de pelcula en la que se ha colocado dicho clip de pelcula. Valor booleano que indica si un clip de pelcula est activado. Si el valor es undefined o false, un clip de pelcula no puede quedar resaltado a menos que sea un botn. Valor booleano que especifica si un clip de pelcula debe mostrar un rectngulo amarillo a su alrededor cuando tiene la seleccin de entrada. Nmero de fotogramas que se han cargado de un archivo SWF de flujo. Altura del clip de pelcula, expresada en pxeles. Desfasada desde Flash Player 7. Esta propiedad est desfasada y en su lugar debe utilizarse MovieClip._quality. Especifica el nivel de suavizado que se aplica al archivo SWF actual. hitArea:Object Designa otro clip de pelcula para que acte como rea activa de un clip de pelcula. Un valor booleano que especifica a qu hace referencia _root cuando se carga un archivo SWF en un clip de pelcula. Nombre de instancia del clip de pelcula. Referencia al clip de pelcula o un objeto que contiene el clip de pelcula u objeto actual.
enabled:Boolean focusEnabled:Boolean
_focusrect:Boolean
_framesloaded:Number [slo lectura] _height:Number _highquality:Number
_lockroot:Boolean
_name:String _parent:MovieClip

Modificadores
Propiedad _quality:String
Descripcin Establece o recupera la calidad de representacin que se utiliza para un archivo SWF. Especifica el giro del clip de pelcula, expresado en grados, con respecto a su orientacin original. Especifica el nmero de segundos que un sonido debe almacenarse en el bfer antes de que comience a reproducirse sin interrupcin. Determina si los elementos secundarios de un clip de pelcula se incluyen en el orden de tabulacin automtico. Especifica si el clip de pelcula se incluye en el orden de tabulacin automtico. Permite personalizar el orden de tabulacin de los objetos de una pelcula. Devuelve la ruta de destino de la instancia de clip de pelcula en notacin con barras. Devuelve el nmero total de fotogramas de la instancia de clip de pelcula especificada en el parmetro MovieClip. Valor booleano que indica si otros botones o clips de pelcula pueden recibir un evento de liberacin de un ratn o lpiz stylus. Recupera la URL del archivo SWF, JPEG, GIF o PNG de la que se descarg el clip de pelcula. Valor booleano que indica si un clip de pelcula est visible. Anchura del clip de pelcula, expresada en pxeles. Entero que establece la coordenada x de un clip de pelcula con respecto a las coordenadas locales del clip de pelcula principal. Devuelve la coordenada x de la posicin del ratn.
_rotation:Number
tabChildren:Boolean
tabEnabled:Boolean
tabIndex:Number
_target:String [slo lectura] _totalframes:Number [slo lectura] trackAsMenu:Boolean
_url:String [slo lectura]
_visible:Boolean _width:Number _x:Number
Establece la escala horizontal (percentage) del clip de pelcula aplicada desde el punto de registro del clip de pelcula. Establece la coordenada y de un clip de pelcula con respecto a las coordenadas locales del clip de pelcula principal. Indica la coordenada y de la posicin del ratn.
_y:Number
Establece la escala vertical (percentage) del clip de pelcula aplicada desde el punto de registro del clip de pelcula.


Resumen de eventos
Evento onData = function()
{}
Descripcin Se invoca cuando un clip de pelcula recibe datos de una llamada MovieClip.loadVariables() o MovieClip.loadMovie(). Se invoca cuando se presiona el botn del ratn y el puntero se desplaza fuera del objeto. Se invoca cuando el puntero se arrastra fuera del clip de pelcula y luego se pasa por encima de ste. Se invoca de manera repetida a la velocidad de fotogramas del archivo SWF.
onDragOut =
function() {}
onDragOver = function() {} onEnterFrame =

function() {}
onKeyDown =
function() {}
Se invoca cuando un clip de pelcula est resaltado y se presiona una tecla.
onKeyUp =
function() {}
Se invoca cuando se suelta una tecla.
onKillFocus =
Se invoca cuando un clip de pelcula deja de tener la seleccin de entrada.
onLoad = function()
{}
Se invoca cuando se crea una instancia de clip de pelcula y sta aparece en la lnea de tiempo. Se invoca cuando se presiona el botn del ratn.
onMouseDown =
function() {}
onMouseMove =
function() {}
Se invoca cuando se mueve el ratn.
onMouseUp =
function() {}
Se invoca cuando se suelta el botn del ratn.
onPress = function()
{}
Se invoca cuando el usuario hace clic en el ratn mientras el puntero se encuentra sobre un clip de pelcula. Se invoca cuanto se suelta el botn del ratn sobre un clip de pelcula.
onRelease = function() {} onReleaseOutside =

function() {}
Se invoca cuando se presiona el botn del ratn dentro del rea del clip de pelcula y luego se suelta despus fuera del rea. Se invoca cuando el puntero se desplaza fuera del rea de un clip de pelcula.
onRollOut =
function() {}
onRollOver =
function() {}
Se invoca cuando el puntero se desplaza sobre el rea de un clip de pelcula.
onSetFocus =
Se invoca cuando un clip de pelcula recibe la seleccin de entrada.
onUnload = function() {}
Se invoca en el primer fotograma despus de que se elimina el clip de pelcula de la lnea de tiempo.

Resumen de mtodos
Modificadores Firma attachMovie(id:String, name:String, depth:Number, [initObject:Object]) : MovieClip beginFill(rgb:Number, [alpha:Number]) : Void Descripcin Localiza un smbolo de la biblioteca y lo asocia al clip de pelcula.
Indica el comienzo de un nuevo trazo de dibujo.
beginGradientFill(fillT Indica el comienzo de un nuevo trazo de dibujo. ype:String, colors:Array, alphas:Array, ratios:Array, matriz:Object) : Void clear() : Void Elimina todos los grficos creados en tiempo de ejecucin empleando los mtodos de dibujo del clip de pelcula, incluidos los estilos de lnea especificados con MovieClip.lineStyle(). Crea un clip de pelcula vaco como elemento secundario de un clip de pelcula existente.
createEmptyMovieClip(n ame:String, depth:Number) : MovieClip createTextField(instanc eName:String, depth:Number, x:Number, y:Number, width:Number, height:Number) : TextField
Crea un nuevo campo de texto vaco como elemento secundario del clip de pelcula en el cual se llama a este mtodo.
curveTo(controlX:Num Dibuja una curva con el estilo de lnea actual desde la posicin ber, de dibujo actual hasta (anchorX, anchorY) utilizando el controlY:Number, punto de control especificado con (controlX, controlY). anchorX:Number, anchorY:Number) :
Void
duplicateMovieClip(name :String, depth:Number, [initObject:Object]) : MovieClip endFill() : Void
Crea una instancia del clip de pelcula especificado mientras se reproduce el archivo SWF.
Aplica un relleno a las lneas y curvas aadidas desde la ltima llamada a beginFill() o beginGradientFill().
getBounds(bounds:Obje Devuelve las propiedades que son los valores de coordenada mnimo y mximo x e y del clip de pelcula para el parmetro ct) : Object bounds. getBytesLoaded() : Number getBytesTotal() : Number getDepth() : Number Devuelve el nmero de bytes que ya se han cargado (reproducido sin interrupcin) para el clip de pelcula. Devuelve el tamao en bytes del clip de pelcula.
Devuelve la profundidad de la instancia del clip de pelcula.

Modificadores
Firma getInstanceAtDepth(dep th:Number) : MovieClip getNextHighestDepth() : Number
Descripcin Determina si una profundidad especfica ya est ocupada por un clip de pelcula.
Le permite determinar un valor de profundidad que puede pasar a MovieClip.attachMovie(), MovieClip.duplicateMovieClip() o MovieClip.createEmptyMovieClip() para asegurarse de que Flash Lite representa el clip de pelcula delante de todos los dems objetos situados en el mismo nivel y capa del clip de pelcula actual. Devuelve un entero que indica la versin de publicacin de Flash Lite del clip de pelcula. Carga un documento de la URL especificada en la ventana indicada.
getSWFVersion() : Number getURL(url:String, [window:String], [method:String]) : Void globalToLocal(pt:Object

) : Void
Convierte el objeto pt de las coordenadas del escenario (globales) en coordenadas del clip de pelcula (locales).
gotoAndPlay(fotograma Inicia la reproduccin del archivo SWF en el fotograma :Object) : Void especificado. gotoAndStop(fotogram a:Object) : Void hitTest() : Boolean Traslada la cabeza lectora al fotograma especificado del clip de pelcula y la detiene en dicho lugar. Evala el clip de pelcula para comprobar si se superpone o corta con el rea activa identificada mediante los parmetros de coordenadas target o x e y. Especifica un estilo de lnea para las posteriores llamadas a lineTo() y curveTo() hasta que llame a lineStyle() con otros parmetros.
lineStyle(grosor:Numb er, rgb:Number, alpha:Number, pixelHinting:Boolean , noScale:String, capsStyle:String, jointStyle:String, miterLimit:Number)

: Void
lineTo(x:Number, y:Number) : Void
Dibuja una lnea utilizando el estilo de lnea actual desde la posicin de dibujo actual hasta (x, y); la posicin de dibujo actual se establece posteriormente como (x, y). Carga un archivo SWF o JPEG en un clip de pelcula en Flash Lite mientras se reproduce el archivo SWF original.
loadMovie(url:String, [method:String]) :
Void
loadVariables(url:String Lee datos de un archivo externo y establece los valores de las , [method:String]) : variables en el clip de pelcula.
Void
localToGlobal(pt:Object
) : Void
Convierte el objeto pt de coordenadas del clip de pelcula (locales) en coordenadas del escenario (globales). Mueve la posicin de dibujo actual a (x, y).
moveTo(x:Number, y:Number) : Void nextFrame() : Void
Traslada la cabeza lectora al siguiente fotograma y la detiene en dicho punto.

Modificadores
Firma play() : Void
Descripcin Mueve la cabeza lectora en la lnea de tiempo del clip de pelcula. Traslada la cabeza lectora al fotograma anterior y la detiene en dicho punto. Elimina una instancia de clip de pelcula creada por duplicateMovieClip(), MovieClip.duplicateMovieClip(), MovieClip.createEmptyMovieClip() o MovieClip.attachMovie(). Convierte el clip de pelcula del parmetro mc en una mscara que revela el clip de pelcula especificado por el clip de pelcula. Permite al usuario arrastrar el clip de pelcula especificado.
prevFrame() : Void
removeMovieClip() :
Void
setMask(mc:Object) :
Void
startDrag([lockCenter :Boolean], [izquierda:Number], [arriba:Number], [derecha:Number], [abajo:Number]) : Void stop() : Void
Detiene el clip de pelcula que se est reproduciendo actualmente. Finaliza una llamada al mtodo MovieClip.startDrag().
stopDrag() : Void
swapDepths(target:Ob Intercambia el apilamiento o nivel de profundidad (orden z), ject) : Void de este clip de pelcula con el clip de pelcula especificado por el parmetro target o con el clip de pelcula que ocupa actualmente el nivel de profundidad especificado en el parmetro target. unloadMovie() : Void Elimina el contenido de una instancia de clip de pelcula.


Valor de transparencia alfa de un clip de pelcula. Los valores vlidos son los comprendidos entre 0 (totalmente transparente) y 100 (totalmente opaco). El valor predeterminado es 100. Los objetos existentes en un clip de pelcula que tenga configurado _alpha con el valor 0 continuarn activos aunque no sean visibles. Por ejemplo, puede hacer clic en un botn de un clip de pelcula aunque su propiedad _alpha est configurada con el valor 0. Para desactivar el botn completamente, puede establecer la propiedad _visible del clip de pelcula con el valor false. Disponibilidad Flash Lite 2.0

Ejemplo El siguiente cdigo define la propiedad _alpha de un clip de pelcula llamado rect_mc al 50% cuando se presiona un botn llamado my_btn.
my_btn.onPress = function(){ rect_mc._alpha = 50 ; } my_btn.onRelease = function(){ rect_mc._alpha = 100; }
Vase tambin
_alpha (propiedad MovieClip._alpha), _alpha (propiedad TextField._alpha), _visible (propiedad MovieClip._visible)
attachBitmap (mtodo MovieClip.attachBitmap)

public attachBitmap(bmp:BitmapData, depth:Number, [pixelSnapping:String], [smoothing:Boolean]) : Void
Asocia una imagen de mapa de bits a un clip de pelcula. Una vez asociado el mapa de bits al clip de pelcula, se hace una referencia desde el clip de pelcula al objeto de mapa de bits. Al asociar un mapa de bits, puede especificar los parmetros pixelSnapping y smoothing para modificar la apariencia del mapa de bits. Una vez aadido un objeto de mapa de bits al clip de pelcula, ya no se podr acceder a l. Los parmetros depth, pixelSnapping y smoothing slo se pueden establecer durante la llamada al mtodo attachBitmap() y no se podrn cambiar ms adelante. En primer lugar, utilice createEmptyMovieClip() para crear un clip de pelcula vaco y, a continuacin, llame al mtodo attachBitmap(). De esta manera, puede aplicar transformaciones al clip de pelcula que transformen el mapa de bits; por ejemplo, puede llamar a la propiedad matrix de un clip de pelcula. El ajuste de pxeles obliga a que la posicin del mapa de bits sea el valor de pxel entero ms cercano en vez de permitir que la posicin est en un pxel parcial. Hay tres modos de ajuste de pxeles:
El modo Auto realiza el ajuste de pxeles siempre que no se estire ni se gire el mapa de bits. El modo Always realiza siempre el ajuste de pxeles, independientemente de que se gire o se estire. El modo Never desactiva el ajuste de pxeles del clip de pelcula.
El modo de suavizado afecta al aspecto de la imagen cuando se le aplica una escala. Parmetros bmp:flash.display.BitmapData - Imagen de mapa de bits opaca o transparente. depth:Number - Entero que especifica el nivel de profundidad dentro del clip de pelcula donde debe colocarse la imagen de mapa de bits. pixelSnapping:String [opcional] - Los modos de ajuste de pxeles son auto, always y never. El modo predeterminado es auto. smoothing:Boolean [opcional] - El modo de suavizado puede ser true si se desea activar el suavizado o false si se prefiere desactivarlo. El modo predeterminado es desactivado.

Disponibilidad Flash Lite 3.1 Ejemplo El siguiente cdigo crea un objeto BitmapData y lo asocia a un clip de pelcula:
import flash.display.*; this.createEmptyMovieClip("bmp1", 99); var bmpData1:BitmapData = new BitmapData(200, 200, false, 0xaa3344); bmp1.attachBitmap(bmpData1, 2, "auto", true);
attachMovie (mtodo MovieClip.attachMovie)

public attachMovie(id:String, name:String, depth:Number, [initObject:Object]) : MovieClip
Localiza un smbolo de la biblioteca y lo asocia al clip de pelcula. Utilice MovieClip.removeMovieClip() o MovieClip.unloadMovie() para eliminar un smbolo asociado a attachMovie(). Disponibilidad Flash Lite 2.0 Parmetros id:String - Nombre de vinculacin del smbolo de clip de pelcula de la biblioteca que va a asociarse a un clip de pelcula del escenario. Es el nombre introducido en el campo Identificador del cuadro de dilogo Propiedades de vinculacin. name:String - Nombre de instancia exclusivo del clip de pelcula que va a asociarse al clip de pelcula. depth:Number - Entero que especifica el nivel de profundidad en el que est situado el archivo SWF. initObject:Object [opcional] - (Admitido en Flash Player 6 y versiones posteriores) Objeto que contiene propiedades con las que rellenar el clip de pelcula que se acaba de asociar. Este parmetro permite a los clips de pelcula creados dinmicamente recibir parmetros del clip. Si initObject no es un objeto, se omite. Todas las propiedades de initObject se copian en la nueva instancia. Las propiedades especificadas con initObject estn disponibles para la funcin constructora. Valor devuelto MovieClip - Referencia a la nueva instancia creada. Ejemplo El siguiente ejemplo asocia dos instancias de un smbolo con el identificador de vinculacin "circle" a una instancia de clip de pelcula del escenario:
this.attachMovie("circle", "circle1_mc", this.getNextHighestDepth()); this.attachMovie("circle", "circle2_mc", this.getNextHighestDepth(), {_x:50, _y:50});
Vase tambin
removeMovieClip (mtodo MovieClip.removeMovieClip), unloadMovie (mtodo MovieClip.unloadMovie), removeMovieClip, funcin
beginFill (mtodo MovieClip.beginFill)

public beginFill(rgb:Number, [alpha:Number]) : Void

Indica el comienzo de un nuevo trazo de dibujo. Si existe un trazado abierto (es decir, si la posicin de dibujo actual no es la misma que la posicin anterior especificada en un mtodo MovieClip.moveTo() y tiene un relleno asociado, dicho trazado se cerrar con una lnea y luego se rellenar. Se trata de un resultado similar al que se obtiene cuando se llama a MovieClip.endFill(). Disponibilidad Flash Lite 2.0 Parmetros rgb:Number - Valor de color hexadecimal (por ejemplo, rojo es 0xFF0000, azul es 0x0000FF, etc.). Si no se proporciona este valor o no est definido, no se crea un relleno. alpha:Number [opcional] - Entero entre 0 y 100 que especifica el valor alfa del relleno. Si no se proporciona este valor, se utiliza 100 (continuo). Si el valor es inferior a 0, Flash utiliza 0. Si el valor es mayor que 100, Flash utiliza 100. Ejemplo El ejemplo siguiente crea un cuadrado con relleno rojo en el escenario:
this.createEmptyMovieClip("square_mc", this.getNextHighestDepth()); square_mc.beginFill(0xFF0000); square_mc.moveTo(10, 10); square_mc.lineTo(100, 10); square_mc.lineTo(100, 100); square_mc.lineTo(10, 100); square_mc.lineTo(10, 10); square_mc.endFill();
Vase tambin
moveTo (mtodo MovieClip.moveTo), endFill (mtodo MovieClip.endFill), beginGradientFill (mtodo MovieClip.beginGradientFill)
beginGradientFill (mtodo MovieClip.beginGradientFill)

public beginGradientFill(fillType:String, colors:Array, alphas:Array, ratios:Array, matrix:Object) : Void
Indica el comienzo de un nuevo trazo de dibujo. Si el primer parmetro es undefined o si no se han pasado parmetros, el trazado no tendr relleno. Si existe un trazado abierto (es decir, si la posicin de dibujo actual no es la misma que la posicin anterior especificada en un mtodo MovieClip.moveTo()) y tiene un relleno asociado, dicho trazado se cerrar con una lnea y luego se rellenar. Se trata de un resultado similar al que se obtiene cuando se llama a MovieClip.endFill(). Este mtodo falla si se da una de las situaciones siguientes:
El nmero de elementos de los parmetros colors, alphas y ratios no coincide. El parmetro fillType no es "linear" o "radial". Alguno de los campos del objeto correspondiente al parmetro matrix no estn presentes o no son vlidos.
Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0

Parmetros fillType:String - Cadena "linear" o cadena "radial". colors:Array - Matriz de valores de color RGB hexadecimales que se utiliza en el degradado (por ejemplo, rojo es 0xFF0000, azul es 0x0000FF, etc.). alphas:Array - Matriz de valores alfa para los colores correspondientes de la matriz colors; los valores vlidos son del 0 al 100. Si el valor es inferior a 0, Flash utiliza 0. Si el valor es mayor que 100, Flash utiliza 100. ratios:Array - Matriz de proporciones de distribucin de colores; los valores vlidos son del 0 al 255. Este valor define el porcentaje de la anchura donde el color se muestrea al 100 por ciento. matrix:Object - Matriz de transformacin que es un objeto con uno de los dos conjuntos de propiedades siguientes:
a, b, c, d, e, f, g, h, i, para describir una matriz de 3 x 3 de la forma siguiente: a b c d e f g h i
El ejemplo siguiente utiliza el mtodo beginGradientFill() con un parmetro matrix de este tipo:
this.createEmptyMovieClip("gradient_mc", this.getNextHighestDepth()); gradient_mc._x = -100; gradient_mc._y = -100; with (gradient_mc) { colors = [0xFF0000, 0x0000FF]; fillType = "radial" alphas = [100, 100]; ratios = [0, 0xFF]; matrix = {a:200, b:0, c:0, d:0, e:200, f:0, g:200, h:200, i:1}; beginGradientFill(fillType, colors, alphas, ratios, matrix); moveTo(100, 100); lineTo(100, 300); lineTo(300, 300); lineTo(300, 100); lineTo(100, 100); endFill(); }
Este cdigo dibuja la imagen siguiente en la pantalla:
matrixType, x, y, w, h, r.

Las propiedades indican lo siguiente: matrixType es la cadena "box", x es la posicin horizontal de la esquina superior izquierda del degradado con respecto al punto de registro del clip principal, y es la posicin vertical de la esquina superior izquierda del degradado con respecto al punto de registro del clip principal, w es la anchura del degradado, h es la altura del degradado y r es la rotacin en radianes del degradado. El ejemplo siguiente utiliza el mtodo beginGradientFill() con un parmetro matrix de este tipo:
this.createEmptyMovieClip("gradient_mc", this.getNextHighestDepth()); gradient_mc._x = -100; gradient_mc._y = -100; with (gradient_mc) { colors = [0xFF0000, 0x0000FF]; fillType = "radial" alphas = [100, 100]; ratios = [0, 0xFF]; matrix = {matrixType:"box", x:100, y:100, w:200, h:200, r:(45/180)*Math.PI}; beginGradientFill(fillType, colors, alphas, ratios, matrix); moveTo(100, 100); lineTo(100, 300); lineTo(300, 300); lineTo(300, 100); lineTo(100, 100); endFill(); }
Este cdigo dibuja la imagen siguiente en la pantalla:
Vase tambin
beginFill (mtodo MovieClip.beginFill), endFill (mtodo MovieClip.endFill), lineStyle (mtodo MovieClip.lineStyle)lineTo (mtodo MovieClip.lineTo), moveTo (mtodo MovieClip.moveTo)
clear (mtodo MovieClip.clear)

public clear() : Void
Elimina todos los grficos creados en tiempo de ejecucin empleando los mtodos de dibujo del clip de pelcula, incluidos los estilos de lnea especificados con MovieClip.lineStyle(). Las formas y lneas que se dibujan manualmente durante la etapa de edicin (con las herramientas de dibujo de Flash) no se ven afectadas.

Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente dibuja un recuadro en el escenario. Cuando el usuario hace clic en un botn llamado removeBox_btn, se elimina el grfico.
this.createEmptyMovieClip("box_mc", 1); drawBox(box_mc, 10, 10, 100, 100); function drawBox(mc:MovieClip, x:Number, y:Number, w:Number, h:Number):Void { mc.lineStyle(5); mc.beginFill(0x009999); mc.moveTo(x, y); mc.lineTo(x+w, y); mc.lineTo(x+w, y+h); mc.lineTo(x, y+h); mc.lineTo(x, y); mc.endFill(); } removeBox_btn.onRelease = function(){ box_mc.clear(); }
Vase tambin
lineStyle (mtodo MovieClip.lineStyle)
createEmptyMovieClip (mtodo MovieClip.createEmptyMovieClip)

public createEmptyMovieClip(name:String, depth:Number) : MovieClip
Crea un clip de pelcula vaco como elemento secundario de un clip de pelcula existente. Este mtodo se comporta de forma similar al mtodo attachMovie(), aunque no es necesario proporcionar un identificador de vinculacin externo para el nuevo clip de pelcula. El punto de registro de un clip de pelcula vaco recin creado es la esquina superior izquierda. Este mtodo falla si falta cualquiera de los parmetros. Disponibilidad Flash Lite 2.0 Parmetros name:String - Cadena que identifica el nombre de instancia del nuevo clip de pelcula. depth:Number - Entero que especifica la profundidad del nuevo clip de pelcula. Valor devuelto MovieClip - Referencia al nuevo clip de pelcula creado. Ejemplo El ejemplo siguiente crea un objeto MovieClip vaco denominado container, crea un nuevo objeto TextField en su interior y define la nueva propiedad TextField.text.
var container:MovieClip = this.createEmptyMovieClip("container", this.getNextHighestDepth()); var label:TextField = container.createTextField("label", 1, 0, 0, 150, 20); label.text = "Hello World";

Vase tambin
attachMovie (mtodo MovieClip.attachMovie)
createTextField (mtodo MovieClip.createTextField)

public createTextField(instanceName:String, depth:Number, x:Number, y:Number, width:Number, height:Number) : TextField
Crea un nuevo campo de texto vaco como elemento secundario del clip de pelcula en el cual se llama a este mtodo. Puede utilizar el mtodo createTextField() para crear campos de texto mientras se reproduce un archivo SWF. El parmetro depth determina el nivel de profundidad del nuevo campo de texto (posicin de orden z) del clip de pelcula. Cada nivel de profundidad slo puede contener un objeto. Si crea un nuevo campo de texto en una profundidad en la que ya hay un campo de texto, el nuevo campo de texto reemplaza al existente. Para evitar sobrescribir campos de texto existentes, utilice MovieClip.getInstanceAtDepth() con el fin de determinar si una profundidad ya est ocupada o MovieClip.getNextHighestDepth() para determinar la profundidad ms alta no ocupada. El campo de texto se sita en (x, y) con las dimensiones width (anchura) por height (altura). Los parmetros x e y son relativos al clip de pelcula del contenedor; estos parmetros corresponden a las propiedades _x e _y del campo de texto. Los parmetros width y height corresponden a las propiedades _width y _height del campo de texto. Las propiedades predeterminadas de un campo de texto son las siguientes:
type = "dynamic" border = false background = false password = false multiline = false html = false embedFonts = false selectable = true wordWrap = false mouseWheelEnabled = true condenseWhite = false restrict = null variable = null maxChars = null styleSheet = undefined tabInded = undefined
Un campo de texto creado con createTextField() recibe los ajustes del siguiente objeto TextFormat predeterminado:

font = "Times New Roman" // "Times" on Mac OS size = 12 color = 0x000000 bold = false italic = false underline = false url = "" target = "" align = "left" leftMargin = 0 rightMargin = 0 indent = 0 leading = 0 blockIndent = 0 bullet = false display = block tabStops = [] // (empty array)
Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0 Parmetros instanceName:String - Cadena que identifica el nombre de instancia del nuevo campo de texto. depth:Number - Entero positivo que especifica la profundidad del nuevo campo de texto. x:Number - Entero que especifica la coordenada x del nuevo campo de texto. y:Number - Entero que especifica la coordenada y del nuevo campo de texto. width:Number - Entero positivo que especifica la anchura del nuevo campo de texto. height:Number - Entero positivo que especifica la altura del nuevo campo de texto. Valor devuelto TextField Ejemplo El ejemplo siguiente crea un campo de texto con una anchura de 300, una altura de 100, una coordenada x de 100, una coordenada y de 100, sin bordes, rojo y texto subrayado:
this.createTextField("my_txt", 1, 100, 100, 300, 100); my_txt.multiline = true; my_txt.wordWrap = true; var my_fmt:TextFormat = new TextFormat(); my_fmt.color = 0xFF0000; my_fmt.underline = true; my_txt.text = "This is my first test field object text."; my_txt.setTextFormat(my_fmt);
Tambin hay un ejemplo en el archivo animations.fla de la carpeta de ejemplos de ActionScript de www.adobe.com/go/learn_fl_samples_es. Descargue y descomprima el archivo .zip y acceda a la carpeta de su versin de ActionScript para poder ver el ejemplo.

Vase tambin
getInstanceAtDepth (mtodo MovieClip.getInstanceAtDepth), getNextHighestDepth (mtodo MovieClip.getNextHighestDepth), getNewTextFormat (mtodo TextField.getNewTextFormat)
_currentframe (propiedad MovieClip._currentframe)

public _currentframe : Number [read-only]
Devuelve el nmero del fotograma en el que est situada la cabeza lectora en la lnea de tiempo del clip de pelcula. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente utiliza la propiedad _currentframe para ordenar a la cabeza lectora del clip de pelcula actionClip_mc que avance cinco fotogramas con respecto a su posicin actual:
actionClip_mc.gotoAndStop(actionClip_mc._currentframe + 5);
curveTo (mtodo MovieClip.curveTo)

public curveTo(controlX:Number, controlY:Number, anchorX:Number, anchorY:Number) : Void
Dibuja una curva con el estilo de lnea actual desde la posicin de dibujo actual hasta (anchorX, anchorY) utilizando el punto de control especificado con ((controlX, controlY). La posicin de dibujo actual se establece entonces como (anchorX, anchorY). Si el clip de pelcula en el que est dibujando incluye contenido creado con las herramientas de dibujo de Flash, las llamadas a curveTo() se dibujarn debajo de este contenido. Si llama a curveTo() antes de realizar ninguna llamada al mtodo moveTo(), se adoptar la posicin de dibujo predeterminada (0,0). Si falta alguno de los parmetros, este mtodo falla y la posicin de dibujo actual no cambia. Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0 Parmetros controlX:Number - Entero que especifica la posicin horizontal del punto de control con respecto al punto de registro del clip de pelcula principal. controlY:Number - Entero que especifica la posicin vertical del punto de control con respecto al punto de registro del clip de pelcula principal. anchorX:Number - Entero que especifica la posicin horizontal del siguiente punto de anclaje con respecto al punto de registro del clip de pelcula principal. anchorY:Number - Entero que especifica la posicin vertical del siguiente punto de anclaje con respecto al punto de registro del clip de pelcula principal. Ejemplo El ejemplo siguiente dibuja una curva casi circular con un trazo fino continuo azul y un relleno continuo rojo:

this.createEmptyMovieClip("circle_mc", 1); with (circle_mc) { lineStyle(0, 0x0000FF, 100); beginFill(0xFF0000); moveTo(0, 100); curveTo(0,200,100,200); curveTo(200,200,200,100); curveTo(200,0,100,0); curveTo(0,0,0,100); endFill(); }
La curva dibujada en este ejemplo es una curva cuadrtica de Bzier. Las curvas cuadrticas de Bzier constan de dos puntos de anclaje y un punto de control. La curva interpola los dos puntos de anclaje y forma una curva hacia el punto de control.
En el guin siguiente se utiliza el mtodo curveTo() y la clase Math para crear un crculo:
this.createEmptyMovieClip("circle2_mc", 2); circle2_mc.lineStyle(0, 0x000000); drawCircle(circle2_mc, 100, 100, 100); function drawCircle(mc:MovieClip, x:Number, y:Number, r:Number):Void { mc.moveTo(x+r, y); mc.curveTo(r+x, Math.tan(Math.PI/8)*r+y, Math.sin(Math.PI/4)*r+x, Math.sin(Math.PI/4)*r+y); mc.curveTo(Math.tan(Math.PI/8)*r+x, r+y, x, '+y); mc.curveTo(-Math.tan(Math.PI/8)*r+x, r+y, -Math.sin(Math.PI/4)*r+x, Math.sin(Math.PI/4)*r+y); mc.curveTo(-r+x, Math.tan(Math.PI/8)*r+y, -r+x, y); mc.curveTo(-r+x, -Math.tan(Math.PI/8)*r+y, -Math.sin(Math.PI/4)*r+x, -Math.sin(Math.PI/4)*r+y); mc.curveTo(-Math.tan(Math.PI/8)*r+x, -r+y, x, -r+y); mc.curveTo(Math.tan(Math.PI/8)*r+x, -r+y, Math.sin(Math.PI/4)*r+x, -Math.sin(Math.PI/4)*r+y); mc.curveTo(r+x, -Math.tan(Math.PI/8)*r+y, r+x, y); }
Tambin hay un ejemplo en el archivo drawingapi.fla de la carpeta de ejemplos de ActionScript de www.adobe.com/go/learn_fl_samples_es. Descargue y descomprima el archivo .zip y acceda a la carpeta de su versin de ActionScript para poder ver el ejemplo. Vase tambin
beginFill (mtodo MovieClip.beginFill), createEmptyMovieClip (mtodo MovieClip.createEmptyMovieClip), endFill (mtodo MovieClip.endFill), lineStyle (mtodo MovieClip.lineStyle), lineTo (mtodo MovieClip.lineTo), moveTo (mtodo MovieClip.moveTo), Math

_droptarget (propiedad MovieClip._droptarget, propiedad)

public _droptarget : String [read-only]
Devuelve la ruta absoluta en notacin de sintaxis con barras de la instancia de clip de pelcula en la que se ha colocado dicho clip de pelcula. La propiedad _droptarget siempre devuelve una ruta que comienza con una barra (/). Para comparar la propiedad _droptarget de una instancia con una referencia, utilice la funcin eval() para convertir el valor devuelto de la sintaxis con barras a una referencia de sintaxis con punto (ActionScript 2.0 no admite sintaxis con barras). Nota: esta propiedad se admite en Flash Lite slo si System.capabilities.hasMouse es true o
Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente evala la propiedad _droptarget de la instancia de clip de pelcula garbage_mc y utiliza eval() para convertirla de sintaxis con barras a una referencia de sintaxis con punto. A continuacin, la referencia a garbage_mc se compara con la referencia a la instancia de clip de pelcula trashcan_mc. Si las dos referencias son equivalentes, la visibilidad de garbage_mc se establece en el valor false. Si no son equivalentes, la instancia garbage recupera su posicin original.
origX = garbage_mc._x; origY = garbage_mc._y; garbage_mc.onPress = function() { this.startDrag(); }; garbage_mc.onRelease = function() { this.stopDrag(); if (eval(this._droptarget) == trashcan_mc) { this._visible = false; } else { this._x = origX; this._y = origY; } };
Vase tambin
startDrag (mtodo MovieClip.startDrag), stopDrag (mtodo MovieClip.stopDrag), eval, funcin
duplicateMovieClip (mtodo MovieClip.duplicateMovieClip)

public duplicateMovieClip(name:String, depth:Number, [initObject:Object]) : MovieClip
Crea una instancia del clip de pelcula especificado mientras se reproduce el archivo SWF. Los clips de pelcula duplicados siempre comienzan a reproducirse por el fotograma 1, con independencia del fotograma en el que se encontrara el clip de pelcula original cuando se llam al mtodo duplicateMovieClip(). Las variables del clip de pelcula principal no se copian en el clip de pelcula duplicado. Los clips de pelcula que se han creado con duplicateMovieClip() no se duplican si efecta una llamada a duplicateMovieClip() en el clip principal. Si se elimina el clip de pelcula principal, el clip de pelcula duplicado tambin se elimina. Si ha utilizado MovieClip.loadMovie() o la clase MovieClipLoader para cargar un clip de pelcula, el contenido del archivo SWF no se duplica. Esto significa que no puede ahorrar ancho de banda cargando un archivo JPEG, GIF, PNG o SWF y duplicando posteriormente el clip de pelcula.

Compare este mtodo con la versin de funcin global de duplicateMovieClip(). La versin global de este mtodo requiere un parmetro que especifique el clip de pelcula de destino que se va a duplicar. Este parmetro no es necesario para la versin de clase MovieClip, ya que el destino de este mtodo es la instancia de clip de pelcula en la que se invoca este mtodo. Adems, la versin global de duplicateMovieClip() no admite el parmetro initobject ni el valor devuelto de una referencia a la instancia de MovieClip recin creada. Disponibilidad Flash Lite 2.0 Parmetros name:String - Identificador exclusivo del clip de pelcula duplicado. depth:Number - Entero exclusivo que especifica la profundidad a la que debe colocarse el nuevo clip de pelcula. Utilice la profundidad -16384 para colocar la nueva instancia de clip de pelcula debajo del contenido creado en el entorno de edicin de Flash. Los valores comprendidos entre -16384 y -1, ambos inclusive, estn reservados para utilizarse en el entorno de edicin y no deben emplearse con este mtodo. Los dems valores de profundidad vlidos oscilan entre 0 y 1048575, ambos inclusive. initObject:Object [opcional] - (Admitido en Flash Player 6 y versiones posteriores.) Objeto que contiene propiedades con las que rellenar el clip de pelcula duplicado. Este parmetro permite a los clips de pelcula creados dinmicamente recibir parmetros del clip. Si initObject no es un objeto, se omite. Todas las propiedades de initObject se copian en la nueva instancia. Las propiedades especificadas con initObject estn disponibles para la funcin constructora. Valor devuelto MovieClip - Referencia al clip de pelcula duplicado (admitido en Flash Player 6 y posteriores). Ejemplo El ejemplo siguiente duplica varias veces un objeto MovieClip creado recientemente y detecta el destino de cada duplicado.
var container:MovieClip = setUpContainer(); var ln:Number = 10; var spacer:Number = 1; var duplicate:MovieClip; for(var i:Number = 1; i < ln; i++) { var newY:Number = i * (container._height + spacer); duplicate = container.duplicateMovieClip("clip-" + i, i, {_y:newY}); trace(duplicate); // _level0.clip-[number] } function setUpContainer():MovieClip { var mc:MovieClip = this.createEmptyMovieClip("container", this.getNextHighestDepth()); var w:Number = 100; var h:Number = 20; mc.beginFill(0x333333); mc.lineTo(w, 0); mc.lineTo(w, h); mc.lineTo(0, h); mc.lineTo(0, 0); mc.endFill(); return mc; }

Vase tambin
loadMovie (mtodo MovieClip.loadMovie), removeMovieClip (mtodo MovieClip.removeMovieClip), duplicateMovieClip, funcin
enabled (propiedad MovieClip.enabled)

public enabled : Boolean
Valor booleano que indica si un clip de pelcula est activado. El valor predeterminado de enabled es true. Si enabled se configura con el valor false, ya no se invocarn los mtodos callback y controladores de eventos onaction del clip de pelcula, al tiempo que se desactivarn los fotogramas Over, Down y Up. La propiedad enabled no afecta a la lnea de tiempo del clip de pelcula; si se est reproduciendo un clip de pelcula, ste continuar reproducindose. El clip de pelcula continuar recibiendo los eventos de clip de pelcula (por ejemplo, mouseDown, mouseUp, keyDown y keyUp). La propiedad enabled slo controla las propiedades de botn de un clip de pelcula. Puede cambiar la propiedad enabled en cualquier momento; el clip de pelcula modificado se activa o desactiva de inmediato. La propiedad enabled puede leerse de un objeto prototipo. Si enabled se establece con el valor false, el objeto no se incluir en el orden de tabulacin automtico. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente desactiva el clip de pelcula circle_mc cuando el usuario hace clic en l:
circle_mc.onRelease = function() { trace("disabling the "+this._name+" movie clip."); this.enabled = false; };
endFill (mtodo MovieClip.endFill)

public endFill() : Void
Aplica un relleno a las lneas y curvas aadidas desde la ltima llamada a beginFill() o beginGradientFill(). Flash utiliza el relleno especificado en la anterior llamada a beginFill() o beginGradientFill(). Si la posicin de dibujo actual no es la misma que la posicin anterior especificada en un mtodo moveTo() y se ha definido un relleno, el trazado se cerrar con una lnea y luego se rellenar. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un cuadrado con relleno rojo en el escenario:
this.createEmptyMovieClip("square_mc", this.getNextHighestDepth()); square_mc.beginFill(0xFF0000); square_mc.moveTo(10, 10); square_mc.lineTo(100, 10); square_mc.lineTo(100, 100); square_mc.lineTo(10, 100); square_mc.lineTo(10, 10); square_mc.endFill();

Tambin hay un ejemplo en el archivo drawingapi.fla de la carpeta de ejemplos de ActionScript de www.adobe.com/go/learn_fl_samples_es. Descargue y descomprima el archivo .zip y acceda a la carpeta de su versin de ActionScript para poder ver el ejemplo. Vase tambin
beginFill (mtodo MovieClip.beginFill), beginGradientFill (mtodo MovieClip.beginGradientFill), moveTo (mtodo MovieClip.moveTo)
focusEnabled (propiedad MovieClip.focusEnabled)

public focusEnabled : Boolean
Si el valor es undefined o false, un clip de pelcula no puede quedar resaltado a menos que sea un botn. Si el valor de la propiedad focusEnabled es true, el clip de pelcula podr seleccionarse con el teclado aunque no sea un botn. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente configura la propiedad focusEnabled del clip de pelcula my_mc en false:
my_mc.focusEnabled = false;
_focusrect (propiedad MovieClip._focusrect)

public _focusrect : Boolean
Valor booleano que especifica si un clip de pelcula debe mostrar un rectngulo amarillo a su alrededor cuando tiene la seleccin de entrada. Esta propiedad puede sustituir a la propiedad global _focusrect. El valor predeterminado de la propiedad _focusrect de una instancia de clip de pelcula es null, la instancia de clip de pelcula no sustituye a la propiedad global _focusrect. Si la propiedad _focusrect de una instancia de clip de pelcula se establece como true o false, sta sustituir a la configuracin de la propiedad global _focusrect para la instancia de clip de pelcula en cuestin. Nota: En Flash Lite 2.0, cuando se desactiva la propiedad _focusrect (dicho de otro modo, MovieClip._focusrect se establece en false), el clip de pelcula seguir recibiendo todos los eventos de pulsacin de teclas y de ratn. Tambin en Flash Lite 2.0, se puede cambiar el color del rectngulo de seleccin utilizando el comando SetFocusRectColor de la funcin fscommand2. Este comportamiento tambin ha cambiado con respecto a Flash Lite Player, donde el color del rectngulo de seleccin nicamente puede ser amarillo. Disponibilidad Flash Lite 2.0 Ejemplo Este ejemplo muestra cmo ocultar el rectngulo amarillo que rodea una determinada instancia de clip de pelcula de un archivo SWF cuando est seleccionada la instancia en una ventana del navegador. Cree tres clips de pelcula denominados mc1_mc, mc2_mc y mc3_mc, y aada el siguiente cdigo ActionScript al fotograma 1 de la lnea de tiempo:

mc1_mc._focusrect = true; mc2_mc._focusrect = false; mc3_mc._focusrect = true; mc1_mc.onRelease = traceOnRelease; mc3_mc.onRelease = traceOnRelease; function traceOnRelease() { trace(this._name); }
Para probar el archivo SWF en una ventana del navegador, seleccione Archivo > Vista previa de publicacin > HTML. Para seleccionar el archivo SWF, haga clic sobre l en la ventana del navegador y pulse la tecla Tabulador para seleccionar cada instancia. Si _focusrect est desactivado, no podr ejecutar cdigo en el navegador para este clip de pelcula con la tecla Intro ni la barra espaciadora. Tambin puede probar el archivo SWF en el entorno de prueba. Seleccione Control > Deshabilitar mtodos abreviados de teclado en el entorno de prueba. Esto le permitir ver el rectngulo de seleccin alrededor de las instancias del archivo SWF. Vase tambin
_focusrect, propiedad, _focusrect (propiedad Button._focusrect)
_framesloaded (propiedad MovieClip._framesloaded)

public _framesloaded : Number [read-only]
Nmero de fotogramas que se han cargado de un archivo SWF de flujo. Esta propiedad es til para determinar si se ha cargado el contenido de un fotograma especfico y de todos los que le preceden y si est disponible localmente en el navegador. Tambin resulta til para controlar la descarga de los archivos SWF grandes. Por ejemplo, se recomienda mostrar un mensaje a los usuarios para indicar que el archivo SWF se est cargando hasta que un fotograma concreto del archivo SWF termine de cargarse. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente utiliza la propiedad _framesloaded para iniciar un archivo SWF cuando se han cargado todos los fotogramas. Si no estn cargados todos los fotogramas, la propiedad _xscale de la instancia de clip de pelcula bar_mc aumenta proporcionalmente para crear una barra de progreso. Introduzca el siguiente cdigo ActionScript en el fotograma 1 de la lnea de tiempo:
var pctLoaded:Number = Math.round(this.getBytesLoaded()/this.getBytesTotal()*100); bar_mc._xscale = pctLoaded;
Aada el siguiente cdigo al fotograma 2:

if (this._framesloaded < this._totalframes) { this.gotoAndPlay(1); } else { this.gotoAndStop(3); }
Coloque el contenido en el fotograma 3 o despus de ste. A continuacin aada el cdigo siguiente al fotograma 3:

stop();
Vase tambin
MovieClipLoader
getBounds (mtodo MovieClip.getBounds)

public getBounds(bounds:Object) : Object
Devuelve las propiedades que son los valores de coordenada mnimo y mximo x e y del clip de pelcula para el parmetro bounds. Nota: utilice MovieClip.lcalToGlobal() y MovieClip.globalToLocal() para convertir las coordenadas locales del clip de pelcula en coordenadas de escenario o las coordenadas de escenario en coordenadas locales, respectivamente. Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0 Parmetros bounds:Object - Ruta de destino de la lnea de tiempo cuyo sistema de coordenadas se desee utilizar como punto de referencia. Valor devuelto Object - Objeto con las propiedades xMin, xMax, yMin y yMax. Ejemplo El ejemplo siguiente crea un clip de pelcula denominado square_mc. El cdigo dibuja un cuadrado para este clip de pelcula y utiliza MovieClip.getBounds() para mostrar los valores de coordenada de la instancia en el panel Salida.
this.createEmptyMovieClip("square_mc", 1); square_mc._x = 10; square_mc._y = 10; square_mc.beginFill(0xFF0000); square_mc.moveTo(0, 0); square_mc.lineTo(100, 0); square_mc.lineTo(100, 100); square_mc.lineTo(0, 100); square_mc.lineTo(0, 0); square_mc.endFill(); var bounds_obj:Object = square_mc.getBounds(this); for (var i in bounds_obj) { trace(i+" --> "+bounds_obj[i]); }
Aparecer la informacin siguiente en el panel Salida:

yMax yMin xMax xMin --> --> --> --> 110 10 110 10

Vase tambin
globalToLocal (mtodo MovieClip.globalToLocal), localToGlobal (mtodo MovieClip.localToGlobal)
getBytesLoaded (mtodo MovieClip.getBytesLoaded)

Devuelve el nmero de bytes que ya se han cargado (reproducido sin interrupcin) para el clip de pelcula. Puede comparar este valor con el devuelto por MovieClip.getBytesTotal() para determinar el porcentaje de un clip de pelcula que se ha cargado. Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Entero que indica el nmero de bytes cargados. Ejemplo El ejemplo siguiente utiliza la propiedad _framesloaded para iniciar un archivo SWF cuando se han cargado todos los fotogramas. Si no estn cargados todos los fotogramas, la propiedad _xscale de la instancia de clip de pelcula loader aumenta proporcionalmente para crear una barra de progreso. Introduzca el siguiente cdigo ActionScript en el fotograma 1 de la lnea de tiempo:
var pctLoaded:Number = Math.round(this.getBytesLoaded()/this.getBytesTotal() * 100); bar_mc._xscale = pctLoaded;

if (this._framesloaded<this._totalframes) { this.gotoAndPlay(1); } else { this.gotoAndStop(3); }
Coloque el contenido en el fotograma 3 o despus de ste y aada el cdigo siguiente al fotograma 3:

stop();
Vase tambin
getBytesTotal (mtodo MovieClip.getBytesTotal)
getBytesTotal (mtodo MovieClip.getBytesTotal)

Devuelve el tamao en bytes del clip de pelcula. En el caso de clips de pelcula externos (el archivo SWF raz o un clip de pelcula que se est cargando en un destino o un nivel), el valor devuelto es el tamao sin comprimir del archivo SWF. Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0

Valor devuelto Number - Entero que indica el tamao total en bytes del clip de pelcula. Ejemplo El ejemplo siguiente utiliza la propiedad _framesloaded para iniciar un archivo SWF cuando se han cargado todos los fotogramas. Si no estn cargados todos los fotogramas, la propiedad _xscale de la instancia de clip de pelcula loader aumenta proporcionalmente para crear una barra de progreso. Introduzca el siguiente cdigo ActionScript en el fotograma 1 de la lnea de tiempo:

stop();
Vase tambin
getBytesLoaded (mtodo MovieClip.getBytesLoaded)
getDepth (mtodo MovieClip.getDepth)

Devuelve la profundidad de la instancia del clip de pelcula. Cada clip de pelcula, botn y campo de texto tiene asociada una profundidad exclusiva que determina cmo aparece el objeto delante o detrs de otros objetos. Los objetos con mayor profundidad aparecen delante. Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0 Valor devuelto Number - La profundidad del clip de pelcula. Ejemplo El cdigo siguiente averigua la profundidad de todas las instancias de clip de pelcula del escenario:
for (var i in this) { if (typeof (this[i]) == "movieclip") { trace("movie clip '"+this[i]._name+"' is at depth "+this[i].getDepth()); } }

Vase tambin
getInstanceAtDepth (mtodo MovieClip.getInstanceAtDepth), getNextHighestDepth (mtodo MovieClip.getNextHighestDepth), swapDepths (mtodo MovieClip.swapDepths), getDepth (mtodo TextField.getDepth), getDepth (mtodo Button.getDepth)
getInstanceAtDepth (mtodo MovieClip.getInstanceAtDepth)

public getInstanceAtDepth(depth:Number) : MovieClip
Determina si una profundidad especfica ya est ocupada por un clip de pelcula. Puede utilizar ese mtodo antes de utilizar MovieClip.attachMovie(), MovieClip.duplicateMovieClip() o MovieClip.createEmptyMovieClip() para determinar si el parmetro de profundidad que desea pasar a alguno de estos mtodos ya contiene un clip de pelcula. Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0 Parmetros depth:Number - Entero que especifica el nivel de profundidad de la consulta. Valor devuelto MovieClip - Referencia a la instancia MovieClip situada en la profundidad especificada o undefined si no hay ningn clip de pelcula en dicha profundidad. Ejemplo El ejemplo siguiente muestra la profundidad ocupada por la instancia de clip de pelcula triangle en el panel Salida:
this.createEmptyMovieClip("triangle", 1); triangle.beginFill(0x0000FF, 100); triangle.moveTo(100, 100); triangle.lineTo(100, 150); triangle.lineTo(150, 100); triangle.lineTo(100, 100); trace(this.getInstanceAtDepth(1)); // output: _level0.triangle
Vase tambin
attachMovie (mtodo MovieClip.attachMovie), duplicateMovieClip (mtodo MovieClip.duplicateMovieClip), createEmptyMovieClip (mtodo MovieClip.createEmptyMovieClip), getDepth (mtodo MovieClip.getDepth), getNextHighestDepth (mtodo MovieClip.getNextHighestDepth), swapDepths (mtodo MovieClip.swapDepths)
getNextHighestDepth (mtodo MovieClip.getNextHighestDepth)

public getNextHighestDepth() : Number

Le permite determinar un valor de profundidad que puede pasar a MovieClip.attachMovie(), MovieClip.duplicateMovieClip() o MovieClip.createEmptyMovieClip() para asegurarse de que Flash representa el clip de pelcula delante de todos los dems objetos situados en el mismo nivel y capa del clip de pelcula actual. El valor devuelto es 0 o un valor mayor (es decir, no se devuelven nmeros negativos). Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Entero que refleja el siguiente ndice de profundidad disponible que se representara por encima de todos los dems objetos del mismo nivel y capa dentro del clip de pelcula. Ejemplo El ejemplo siguiente dibuja tres instancias de clip de pelcula utilizando el mtodo getNextHighestDepth() como parmetro depth del mtodo createEmptyMovieClip(), adems etiqueta cada clip de pelcula con su profundidad:
for (i = 0; i < 3; i++) { drawClip(i); } function drawClip(n:Number):Void { this.createEmptyMovieClip("triangle" + n, this.getNextHighestDepth()); var mc:MovieClip = eval("triangle" + n); mc.beginFill(0x00aaFF, 100); mc.lineStyle(4, 0xFF0000, 100); mc.moveTo(0, 0); mc.lineTo(100, 100); mc.lineTo(0, 100); mc.lineTo(0, 0); mc._x = n * 30; mc._y = n * 50 mc.createTextField("label", this.getNextHighestDepth(), 20, 50, 200, 200) mc.label.text = mc.getDepth(); }
Vase tambin
getDepth (mtodo MovieClip.getDepth), getInstanceAtDepth (mtodo MovieClip.getInstanceAtDepth), swapDepths (mtodo MovieClip.swapDepths), attachMovie (mtodo MovieClip.attachMovie), duplicateMovieClip (mtodo MovieClip.duplicateMovieClip), createEmptyMovieClip (mtodo MovieClip.createEmptyMovieClip)
getSWFVersion (mtodo MovieClip.getSWFVersion)

public getSWFVersion() : Number
Devuelve un entero que indica la versin de Flash Lite Player para la que se ha publicado el clip de pelcula. Si el clip de pelcula es un archivo JPEG, GIF o PNG, o si se produce un error y Flash Player no logra determinar la versin de SWF del clip de pelcula, se devuelve -1. Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase.

Disponibilidad Flash Lite 2.0 Valor devuelto Number - Entero que especifica la versin de Flash Lite Player de destino cuando se public el archivo SWF cargado en el clip de pelcula. Ejemplo El ejemplo siguiente crea un nuevo contenedor y ofrece como salida el valor de getSWFVersion(). Despus utiliza MovieClipLoader para cargar un archivo SWF externo que se public con Flash Player 7 y muestra el valor de getSWFVersion() despus de activarse el controlador onLoadInit.
var container:MovieClip = this.createEmptyMovieClip("container", this.getUpperEmptyDepth()); var listener:Object = new Object(); listener.onLoadInit = function(target:MovieClip):Void { trace("target: " + target.getSWFVersion()); // target: 7 } var mcLoader:MovieClipLoader = new MovieClipLoader(); mcLoader.addListener(listener); trace("container: " + container.getSWFVersion()); // container: 8 mcLoader.loadClip("FlashPlayer7.swf", container);
getURL (mtodo MovieClip.getURL)

public getURL(url:String, [window:String], [method:String]) : Void
Carga un documento de la URL especificada en la ventana indicada. El mtodo getURL() tambin puede utilizarse para pasar variables a otra aplicacin definida en la URL mediante un mtodo GET o POST. Las pginas Web que albergan pelculas Flash deben definir explcitamente el atributo allowScriptAccess para permitir o denegar la creacin de guiones de Flash Lite Player a partir del cdigo HTML (en la etiqueta PARAM para Internet Explorer o la etiqueta EMBED para Netscape Navigator):
Cuando allowScriptAccess es "never", la creacin de guiones salientes falla siempre. Cuando allowScriptAccess es "always", la creacin de guiones salientes siempre es correcta. Cuando allowScriptAccess es "sameDomain" (admitido en los archivos SWF a partir de la versin 8), se permite
la creacin de guiones salientes si el archivo SWF pertenece al mismo dominio de la pgina Web que lo aloja.
Si una pgina HTML no especifica allowScriptAccess, el valor predeterminado es "sameDomain" para los
archivos SWF de la versin 8; en el caso de archivos SWF de versiones anteriores, el valor predeterminado es
"always".
Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0 Parmetros url:String - URL del cual se obtiene el documento.

window:String [opcional] - Parmetro que especifica el nombre, fotograma o expresin que especifica la ventana o fotograma HTML en el que se carga el documento. Tambin es posible utilizar uno de los siguientes nombres de destino reservados: La opcin _self especifica el marco actual de la ventana actual, _blank especifica una ventana nueva, _parent especifica el nivel superior del marco actual y _top especifica el marco del nivel ms alto de la ventana actual. method:String [opcional] - Cadena ("GET" o "POST") que especifica un mtodo para enviar las variables asociadas al archivo SWF que va a cargarse. Si no hay variables, omita este parmetro; de lo contrario, especifique si las variables han de cargarse con el mtodo GET o POST. El mtodo GET aade las variables al final de la URL y se
utiliza para un nmero reducido de variables. El mtodo POST enva las variables en un encabezado HTTP independiente y se utiliza para cadenas de variables largas.
Ejemplo El siguiente cdigo ActionScript crea una instancia nueva de clip de pelcula y abre el sitio Web de Macromedia en una nueva ventana del navegador:
this.createEmptyMovieClip("loader_mc", this.getNextHighestDepth()); loader_mc.getURL("http://www.adobe.com", "_blank");
El mtodo getURL() tambin permite enviar variables a un guin de servidor remoto, como muestra el cdigo siguiente:
this.createEmptyMovieClip("loader_mc", this.getNextHighestDepth()); loader_mc.username = "some user input"; loader_mc.password = "random string"; loader_mc.getURL("http://www.flash-mx.com/mm/viewscope.cfm", "_blank", "GET");
Vase tambin
getURL, funcin, sendAndLoad (mtodo LoadVars.sendAndLoad), send (mtodo LoadVars.send)
globalToLocal (mtodo MovieClip.globalToLocal)

public globalToLocal(pt:Object) : Void
Convierte el objeto pt de las coordenadas del escenario (globales) en coordenadas del clip de pelcula (locales). El mtodo MovieClip.globalToLocal() permite convertir los valores de las coordenadas x e y dadas, relativos a la esquina superior izquierda del escenario, en valores relativos a la esquina superior izquierda de un clip de pelcula especificado. En primer lugar deber crear un objeto genrico con dos propiedades, x e y. Estos valores x e y (deben llamarse x e y) se denominan coordenadas globales porque son relativas a la esquina superior izquierda del escenario. La propiedad x representa el desplazamiento horizontal con respecto a la esquina superior izquierda. En otras palabras, representa la distancia del punto hacia la derecha. Por ejemplo, si x = 50, el punto queda 50 pxeles a la derecha de la esquina superior izquierda. La propiedad y representa el desplazamiento vertical con respecto a la esquina superior izquierda. En otras palabras, representa la distancia del punto hacia abajo. Por ejemplo, si y = 20, el punto queda 20 pxeles por debajo de la esquina superior izquierda. El cdigo siguiente crea un objeto genrico con estas coordenadas:
var myPoint:Object = new Object(); myPoint.x = 50; myPoint.y = 20;
Tambin es posible crear el objeto y asignarle simultneamente los valores con un valor literal de objeto:
var myPoint:Object = {x:50, y:20};

Una vez creado un objeto punto con coordenadas globales, puede convertir las coordenadas en coordenadas locales. El mtodo globalToLocal() no devuelve un valor porque cambia los valores de x e y del objeto genrico enviado como parmetro. Los cambia de valores relativos al escenario (coordenadas globales) a valores relativos a un clip de pelcula especfico (coordenadas locales). Por ejemplo, si crea un clip de pelcula situado en el punto (_x:100, _y:100) y pasa el punto global que representa la esquina superior izquierda del escenario (x:0, y:0) al mtodo globalToLocal(), el mtodo debera convertir los valores de x e y en coordenadas locales, en este caso (x:-100, y:-100). Esta conversin ocurre porque ahora las coordenadas x e y se expresan en relacin con la esquina superior izquierda del clip de pelcula, no del escenario. Los valores son negativos porque para pasar de la esquina superior izquierda del clip de pelcula a la esquina superior izquierda del escenario, es necesario desplazarse 100 pxeles a la izquierda (x negativo) y 100 pxeles hacia arriba (y negativo). Las coordenadas del clip de pelcula se han expresado con _x e _y porque son las propiedades de MovieClip utilizadas para definir los valores x e y para MovieClips. Sin embargo, el objeto genrico utiliza x e y sin subrayado. El siguiente cdigo convierte los valores de x e y en coordenadas locales:
var myPoint:Object = {x:0, y:0}; // Create your generic point object. this.createEmptyMovieClip("myMovieClip", this.getNextHighestDepth()); myMovieClip._x = 100; // _x for movieclip x position myMovieClip._y = 100; // _y for movieclip y position myMovieClip.globalToLocal(myPoint); trace ("x: " + myPoint.x); // output: -100 trace ("y: " + myPoint.y); // output: -100
Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0 Parmetros pt:Object - Nombre o identificador de un objeto creado con la clase Object genrica. El objeto especifica las coordenadas x e y como propiedades. Ejemplo Aada el siguiente cdigo ActionScript a un archivo FLA o AS del mismo directorio como una imagen denominada photo1.jpg:

this.createTextField("coords_txt", this.getNextHighestDepth(), 10, 10, 100, 22); coords_txt.html = true; coords_txt.multiline = true; coords_txt.autoSize = true; this.createEmptyMovieClip("target_mc", this.getNextHighestDepth()); target_mc._x = 100; target_mc._y = 100; target_mc.loadMovie("photo1.jpg"); var mouseListener:Object = new Object(); mouseListener.onMouseMove = function() { var point:Object = {x:_xmouse, y:_ymouse}; target_mc.globalToLocal(point); var rowHeaders = " \t_x\t_y"; var row_1 = "_root\t"+_xmouse+"\t"+_ymouse; var row_2 = "target_mc\t"+point.x+"\t"+point.y; coords_txt.htmlText = "<textformat tabstops='[100, 150]'>"; coords_txt.htmlText += rowHeaders; coords_txt.htmlText += row_1; coords_txt.htmlText += row_2; coords_txt.htmlText += "</textformat>"; }; Mouse.addListener(mouseListener);
Vase tambin
getBounds (mtodo MovieClip.getBounds), localToGlobal (mtodo MovieClip.localToGlobal), Object
gotoAndPlay (mtodo MovieClip.gotoAndPlay)

public gotoAndPlay(frame:Object) : Void
Inicia la reproduccin del archivo SWF en el fotograma especificado. Para especificar una escena adems de un fotograma, utilice gotoAndPlay(). Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0 Parmetros frame:Object - Nmero que representa el nmero del fotograma o cadena que representa la etiqueta del fotograma al que se enva la cabeza lectora. Ejemplo El ejemplo siguiente utiliza la propiedad _framesloaded para iniciar un archivo SWF cuando se han cargado todos los fotogramas. Si no estn cargados todos los fotogramas, la propiedad _xscale de la instancia de clip de pelcula loader aumenta proporcionalmente para crear una barra de progreso. Introduzca el siguiente cdigo ActionScript en el fotograma 1 de la lnea de tiempo:

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

public gotoAndStop(frame:Object) : Void
Traslada la cabeza lectora al fotograma especificado del clip de pelcula y la detiene en dicho lugar. Para especificar una escena adems de un fotograma, utilice gotoAndStop(). Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0 Parmetros frame:Object - Nmero del fotograma al que se enva la cabeza lectora. Ejemplo El ejemplo siguiente utiliza la propiedad _framesloaded para iniciar un archivo SWF cuando se han cargado todos los fotogramas. Si no estn cargados todos los fotogramas, la propiedad _xscale de la instancia de clip de pelcula loader aumenta proporcionalmente para crear una barra de progreso. Introduzca el siguiente cdigo ActionScript en el fotograma 1 de la lnea de tiempo:

stop();
Vase tambin
gotoAndStop, funcin, stop, funcin
_height (propiedad MovieClip._height)


Altura del clip de pelcula, expresada en pxeles. Disponibilidad Flash Lite 2.0 Ejemplo El siguiente ejemplo de cdigo muestra la altura y anchura de un clip de pelcula en el panel Salida:
this.createEmptyMovieClip("image_mc", this.getNextHighestDepth()); var image_mcl:MovieClipLoader = new MovieClipLoader(); var mclListener:Object = new Object(); mclListener.onLoadInit = function(target_mc:MovieClip) { trace(target_mc._name+" = "+target_mc._width+" X "+target_mc._height+" pixels"); }; image_mcl.addListener(mclListener); image_mcl.loadClip("example.jpg", image_mc);
Vase tambin
_highquality (propiedad MovieClip._highquality)

Desfasada desde Flash Player 7. Esta propiedad est desfasada y en su lugar debe utilizarse MovieClip._quality. Especifica el nivel de suavizado que se aplica al archivo SWF actual. Especifique 2 (mejor calidad) para aplicar alta calidad con el suavizado de mapa de bits siempre activado. Especifique 1 (alta calidad) para aplicar el suavizado; esto suaviza los mapas de bits si el archivo SWF no contiene animacin. Especifique 0 (baja calidad) para evitar el suavizado. Esta propiedad puede sobrescribir a la propiedad global _highquality. Disponibilidad Flash Lite 2.0 Ejemplo El siguiente cdigo ActionScript especifica la aplicacin de suavizado de la mejor calidad al archivo SWF.
my_mc._highquality = 2;
Vase tambin
_quality (propiedad MovieClip._quality, propiedad), propiedad _quality, propiedad
hitArea (propiedad MovieClip.hitArea)

public hitArea : Object
Designa otro clip de pelcula para que acte como rea activa de un clip de pelcula. Si la propiedad hitArea no existe o tiene el valor null o undefined, se utilizar el propio clip de pelcula como rea activa. El valor de la propiedad hitArea puede ser una referencia a un objeto de clip de pelcula.

Puede cambiar la propiedad hitArea en cualquier momento; el clip de pelcula modificado adoptar de inmediato el nuevo comportamiento de rea activa. No es preciso que el clip de pelcula designado como rea activa est visible; se detectar la condicin de "activa" de su forma grfica aunque no sea visible. La propiedad hitArea puede leerse de un objeto prototipo. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente configura el clip de pelcula circle_mc como rea activa del clip de pelcula square_mc. Coloque los dos clips de pelcula en el escenario y pruebe el documento. Al hacer clic en circle_mc, el clip de pelcula square_mc detecta que se ha hecho clic.
square_mc.hitArea = circle_mc; square_mc.onRelease = function() { trace("hit! "+this._name); };
Tambin es posible configurar como circle_mc la propiedad visible del clip de pelcula false para ocultar el rea activa de square_mc.
circle_mc._visible = false;
Vase tambin
hitTest (mtodo MovieClip.hitTest)
hitTest (mtodo MovieClip.hitTest)

public hitTest() : Boolean
Evala el clip de pelcula para comprobar si se superpone o corta con el rea activa identificada mediante los parmetros de coordenadas target o x e y. Sintaxis 1: Compara las coordenadas x e y con la forma o el recuadro de delimitacin de la instancia especificada, segn la configuracin de shapeFlag. Si shapeFlag se configura como true, slo se evaluar el rea del escenario que ocupa la instancia en s y, si x e y se solapan en algn punto, se devolver el valor true. Esta evaluacin resulta til para determinar si el clip de pelcula se encuentra dentro de un rea activa especificada. Sintaxis 2: Evala los recuadros de delimitacin del destino (target) y la instancia especificada y devuelve true si se solapan o cortan en algn punto. Parmetros x: Number La coordenada x del rea activa en el escenario.
y: Number La coordenada y del rea activa en el escenario.
Las coordenadas x e y se definen en el espacio de coordenadas globales.

shapeFlag: Boolean - Valor booleano que especifica si debe evaluarse la forma completa de la instancia especificada
(true) o slo el recuadro de delimitacin (false). Este parmetro slo puede especificarse si el rea activa se identifica empleando los parmetros de coordenadas x ey.
target: Object El trazado de destino del rea activa que puede solaparse con la instancia especificada por el clip de
pelcula. El parmetro target normalmente representa un botn o campo de introduccin de texto.

Disponibilidad Flash Lite 2.0 Valor devuelto Boolean - Valor booleano de true si el clip de pelcula se solapa con el rea activa especificada; false, en caso contrario. Ejemplo El ejemplo siguiente utiliza hitTest() para determinar si el clip de pelcula circle_mc se solapa con el clip de pelcula square_mc cuando el usuario suelta el botn del ratn:
square_mc.onPress = function() { this.startDrag(); }; square_mc.onRelease = function() { this.stopDrag(); if (this.hitTest(circle_mc)) { trace("you hit the circle"); } };
Vase tambin
getBounds (mtodo MovieClip.getBounds), globalToLocal (mtodo MovieClip.globalToLocal), localToGlobal (mtodo MovieClip.localToGlobal)
lineStyle (mtodo MovieClip.lineStyle)

public lineStyle(thickness:Number, rgb:Number, alpha:Number, pixelHinting:Boolean, noScale:String, capsStyle:String, jointStyle:String, miterLimit:Number) : Void
Especifica un estilo de lnea que Flash utilizar para las posteriores llamadas a lineTo() y curveTo() hasta que llame a lineStyle() con otros parmetros. Puede llamar a lineStyle() en mitad de un trazado para especificar diferentes estilos para los distintos segmentos de lnea de un trazado. Nota: las llamadas a clear() volvern a establecer el estilo de lnea con el valor undefined. Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0 Parmetros thickness:Number - Entero que indica el grosor de la lnea en puntos; los valores vlidos son del 0 al 255. Si no se especifica ningn nmero o si el parmetro es undefined, no se traza ninguna lnea. Si se pasa un valor inferior a 0, Flash Player utiliza 0. El valor 0 indica un grosor muy fino; el grosor mximo es 255. Si se pasa un valor superior a 255, el intrprete de Flash utiliza 255. rgb:Number - Valor de color hexadecimal (por ejemplo, rojo es 0xFF0000, azul es 0x0000FF, etc.) de la lnea. Si no se indica ningn valor, Flash utiliza 0x000000 (negro). alpha:Number - Entero que indica el valor alfa del color de la lnea; los valores vlidos son del 0 al 100. Si no se indica ningn valor, Flash utiliza 100 (continuo). Si el valor es inferior a 0, Flash utiliza 0; si el valor es mayor que 100, Flash utiliza 100.

pixelHinting:Boolean - Un valor booleano que especifica si se permite o no sugerir trazos a pxeles completos. Esto afecta a la posicin de los anclajes de una curva y al tamao propiamente dicho del trazo de la lnea. Con pixelHinting definido con el valor true, el reproductor Flash Lite sugiere anchuras de lnea que ocupen la anchura completa de los pxeles. Con pixelHinting definido con el valor false, pueden aparecer curvas y lneas rectas no conectadas. noScale:String - Cadena que especifica cmo cambiar la escala de un trazo. Los valores vlidos son los siguientes: "normal"- Siempre se cambia la escala del grosor (valor predeterminado)."none"- Nunca se cambia la escala del grosor."vertical"- No se cambia la escala del grosor si se cambia la escala del objeto slo verticalmente."horizontal"- No se cambia la escala del grosor si se cambia la escala del objeto slo horizontalmente capsStyle:String - Cadena que especifica el tipo de extremo al final de las lneas. Los valores vlidos son: "round", "square" y "none". Si no se indica ningn valor, Flash utiliza extremos redondos. jointStyle:String - Cadena que especifica el tipo de aspecto de la junta que se usa en los ngulos. Los valores vlidos son: "round", "miter" y "bevel". Si no se indica ningn valor, Flash utiliza juntas redondas. miterLimit:Number - Nmero que indica el lmite en que se corta una esquina. Los valores posibles estn comprendidos entre 1 y 255 (los valores que no estn dentro del rango se redondean a 1 o 255). Este valor slo se utiliza si jointStyle se define como "miter". Si no se indica ningn valor, Flash utiliza el valor 3. El valor de miterLimit representa la longitud con la que una esquina se puede extender ms all del punto en que las lneas se cortan para formar una unin. El valor expresa un factor del valor de thickness (grosor) de la lnea. Por ejemplo, con un factor miterLimit de 2,5 y un valor thickness (grosor) de 10 pxeles, la esquina se corta a los 25 pxeles. Ejemplo El cdigo siguiente dibuja un tringulo de 5 pxeles con una lnea slida magenta y sin relleno.
this.createEmptyMovieClip("triangle_mc", 1); triangle_mc.lineStyle(5, 0xff00ff, 100); triangle_mc.moveTo(200, 200); triangle_mc.lineTo(300, 300); triangle_mc.lineTo(100, 300); triangle_mc.lineTo(200, 200);
Vase tambin
beginFill (mtodo MovieClip.beginFill), beginGradientFill (mtodo MovieClip.beginGradientFill), clear (mtodo MovieClip.clear), curveTo (mtodo MovieClip.curveTo), lineTo (mtodo MovieClip.lineTo), moveTo (mtodo MovieClip.moveTo)
lineTo (mtodo MovieClip.lineTo)

public lineTo(x:Number, y:Number) : Void
Dibuja una lnea utilizando el estilo de lnea actual desde la posicin de dibujo actual hasta (x, y); la posicin de dibujo actual se establece posteriormente como (x, y). Si el clip de pelcula en el que est dibujando incluye contenido creado con las herramientas de dibujo de Flash, las llamadas a lineTo() se dibujarn debajo de este contenido. Si llama a lineTo() antes de realizar ninguna llamada al mtodo moveTo(), se adoptar la posicin de dibujo predeterminada (0,0). Si falta alguno de los parmetros, este mtodo falla y la posicin de dibujo actual no cambia. Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0

Parmetros x:Number - Entero que indica la posicin horizontal con respecto al punto de registro del clip de pelcula principal. y:Number - Entero que indica la posicin vertical con respecto al punto de registro del clip de pelcula principal. Ejemplo El ejemplo siguiente dibuja un tringulo con una lnea continua magenta de 5 pxeles y un relleno azul parcialmente transparente:
this.createEmptyMovieClip("triangle_mc", 1); triangle_mc.beginFill(0x0000FF, 30); triangle_mc.lineStyle(5, 0xFF00FF, 100); triangle_mc.moveTo(200, 200); triangle_mc.lineTo(300, 300); triangle_mc.lineTo(100, 300); triangle_mc.lineTo(200, 200); triangle_mc.endFill();
Vase tambin
beginFill (mtodo MovieClip.beginFill), createEmptyMovieClip (mtodo MovieClip.createEmptyMovieClip),endFill (mtodo MovieClip.endFill), lineStyle (mtodo MovieClip.lineStyle), moveTo (mtodo MovieClip.moveTo)
loadMovie (mtodo MovieClip.loadMovie)

public loadMovie(url:String, [method:String]) : Void
Carga archivos SWF o JPEG en un clip de pelcula de un archivo SWF que se est reproduciendo en Flash Lite. Sugerencia: para controlar el progreso de la descarga, utilice MovieClipLoader.loadClip() en lugar del mtodo loadMovie(). El mtodo loadMovie() permite mostrar varios archivos SWF a la vez y cambiar entre archivos SWF sin cargar otro documento HTML. Un archivo SWF o imagen cargada en un clip de pelcula hereda las propiedades de posicin, giro y escala del clip de pelcula. Puede utilizar la ruta de destino del clip de pelcula para emplear como destino el archivo SWF cargado. Llame a loadMovie() para cargar cualquier formato de imagen compatible con el dispositivo. Por ejemplo, si el dispositivo de destino admite archivos PNG, el cdigo siguiente carga y muestra un archivo PNG externo que resida en un servidor Web:
loadMovie("http://www.adobe.com/image.png", "image_target");
Para determinar qu formatos de imagen se admiten en el dispositivo de destino, puede utilizar la propiedad System.capabilities.imageMIMETypes, que contiene una matriz de tipos MIME de imagen admitidos. ndice de cada elemento de la matriz equivale a cada tipo MIME admitido. Por ejemplo, el siguiente cdigo determina si un dispositivo admite imgenes PNG antes de que el dispositivo intente cargar un archivo PNG externo:
if (System.capabilities.imageMIMETypes["image/png"]) { loadMovie("images/image.png", "mc_myPngImage"); }
Flash Lite limita a cinco el nmero de operaciones loadMovie() que puede realizar una aplicacin en un fotograma determinado. Flash Lite limita a diez el nmero de operaciones loadMovie() totales en cualquier momento. Por ejemplo, suponga que la aplicacin contiene cdigo en el fotograma 1 para cargar seis imgenes JPEG externas:

image1.loadMovie("image1.jpg"); image2.loadMovie("image2.jpg"); image3.loadMovie("image3.jpg"); image4.loadMovie("image4.jpg"); image5.loadMovie("image5.jpg"); image6.loadMovie("image6.jpg"); // Won't load
En este caso, slo se cargarn las cinco primeras imgenes (de image1.jpg a image5.jpg); la ltima (image6.jpg) no se cargar, ya que se ha alcanzado el lmite de cinco conexiones. Una solucin pasa por repartir las llamadas loadMovie() entre varios fotogramas para que cada uno contenga un mximo de cinco llamadas loadMovie(). Cuando se realice una llamada al mtodo loadMovie(), defina la propiedad MovieClip._lockroot en true en la pelcula de cargador, tal como se muestra en el ejemplo siguiente. Si no establece _lockroot en true en la pelcula de cargador, todas las referencias a _root que contenga la pelcula cargada sealan a _root del cargador en lugar de a _root de la pelcula cargada.
myMovieClip._lockroot = true;
Utilice el mtodo MovieClip.unloadMovie() para eliminar los archivos o imgenes SWF cargados con el mtodo loadMovie(). Utilice el mtodo MovieClip.loadVariables(), el objeto XML, Flash Remoting u objetos compartidos para mantener el archivo SWF activo y cargar nuevos datos en l. La utilizacin de controladores de evento con MovieClip.loadMovie() puede producir resultados impredecibles. Si asocia un controlador de eventos a un botn mediante on(), o si crea un controlador dinmico empleando un mtodo de controlador de eventos como MovieClip.onPress, y posteriormente efecta una llamada a loadMovie(), el controlador de eventos no permanecer despus de cargarse el nuevo contenido. No obstante, si asocia un controlador de eventos a un clip de pelcula utilizando onClipEvent() u on() y luego efecta una llamada a loadMovie() en dicho clip de pelcula, el controlador de eventos permanecer despus de cargarse el nuevo contenido. Disponibilidad Flash Lite 2.0 Parmetros url:String - URL absoluta o relativa 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:///. method:String [opcional] - Especifica un mtodo HTTP para enviar o cargar variables. El parmetro debe ser la cadena GET o POST. Si no necesita enviar variables, 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. Ejemplo El ejemplo siguiente crea dinmicamente un nuevo de clip de pelcula, despus, crea un elemento secundario en dicho clip de pelcula y carga una imagen PNG en el elemento secundario. De este modo el elemento principal conserva los valores de instancia que se asignaron antes de realizar la llamada a loadMovie.
var mc:MovieClip = this.createEmptyMovieClip("mc", this.getNextHighestDepth()); mc.onRelease = function():Void { trace(this.image._url); // http://www.w3.org/Icons/w3c_main.png } var image:MovieClip = mc.createEmptyMovieClip("image", mc.getNextHighestDepth()); image.loadMovie("http://www.w3.org/Icons/w3c_main.png");

Vase tambin
_lockroot (propiedad MovieClip._lockroot), unloadMovie (mtodo MovieClip.unloadMovie), loadVariables (mtodo MovieClip.loadVariables), loadMovie (mtodo MovieClip.loadMovie), onPress (controlador MovieClip.onPress), MovieClipLoader, onClipEvent, controlador, Constantes, loadMovieNum, funcin, unloadMovie, funcin, unloadMovieNum, funcin
loadVariables (mtodo MovieClip.loadVariables)

public loadVariables(url:String, [method:String]) : Void
Lee datos de un archivo externo y establece los valores de las variables en el clip de pelcula. El archivo externo puede ser un archivo de texto generado por ColdFusion, un guin CGI, Active Server Page (ASP) o un guin PHP o cualquier archivo de texto que tenga los formatos correctos. El archivo puede contener cualquier nmero de variables. El mtodo loadVariables se puede utilizar adems para actualizar las variables del clip de pelcula activo con nuevos valores. El mtodo loadVariables exige que el texto de la URL est en formato MIME estndar: application/x-www-formurlencoded (formato de guin CGI). 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 puede obtenerse eliminando el componente situado 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 archivos SWF de cualquier versin que se ejecuten en Flash Player 7 o versiones posteriores, url debe estar exactamente en el mismo dominio que el archivo SWF que emite esta llamada. Por ejemplo, un archivo SWF en www.someDomain.com puede cargar datos nicamente desde orgenes que tambin se encuentren en www.someDomain.com. Para cargar datos de un dominio distinto, puede colocar un archivo de poltica para distintos dominios en el servidor que aloja el origen de los datos a los que se obtiene acceso. Para cargar variables en un nivel especfico, utilice loadVariablesNum() en lugar de loadVariables(). Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0 Parmetros url:String - URL absoluta o relativa del archivo externo que contiene las variables que se van a cargar. 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" ms abajo. method:String [opcional] - Especifica un mtodo HTTP para enviar variables. El parmetro debe ser la cadena GET o POST. Si no se enva 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. Ejemplo El ejemplo siguiente carga informacin de un archivo de texto denominado params.txt en el clip de pelcula target_mc que se ha creado con 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()); target_mc.loadVariables("params.txt"); 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 params.txt incluye el texto siguiente:

var1="hello"&var2="goodbye"&done="done"
Vase tambin
loadMovie (mtodo MovieClip.loadMovie), loadVariablesNum, funcin, unloadMovie (mtodo MovieClip.unloadMovie)
localToGlobal (mtodo MovieClip.localToGlobal)

public localToGlobal(pt:Object) : Void
Convierte el objeto pt de coordenadas del clip de pelcula (locales) en coordenadas del escenario (globales). El mtodo MovieClip.localToGlobal() permite convertir los valores de las coordenadas x e y dadas, relativos a la esquina superior izquierda de un clip de pelcula especificado, en valores relativos a la esquina superior izquierda del escenario. En primer lugar deber crear un objeto genrico con dos propiedades, x e y. Estos valores x e y (deben llamarse x e y) se denominan coordenadas locales porque son relativas a la esquina superior izquierda del clip de pelcula. La propiedad x representa el desplazamiento horizontal con respecto a la esquina superior izquierda del clip de pelcula. En otras palabras, representa la distancia del punto hacia la derecha. Por ejemplo, si x = 50, el punto queda 50 pxeles a la derecha de la esquina superior izquierda. La propiedad y representa el desplazamiento vertical con respecto a la esquina superior izquierda del clip de pelcula. En otras palabras, representa la distancia del punto hacia abajo. Por ejemplo, si y = 20, el punto queda 20 pxeles por debajo de la esquina superior izquierda. El cdigo siguiente crea un objeto genrico con estas coordenadas.
var myPoint:Object = new Object(); myPoint.x = 50; myPoint.y = 20;
Tambin es posible crear el objeto y asignarle simultneamente los valores con un valor literal de objeto.
var myPoint:Object = {x:50, y:20};
Una vez creado un objeto punto con coordenadas locales, puede convertir las coordenadas en coordenadas globales. El mtodo localToGlobal() no devuelve un valor porque cambia los valores de x e y del objeto genrico enviado como parmetro. Sustituye los valores relativos a un clip de pelcula determinado (coordenadas locales) por valores relativos al escenario (coordenadas globales).

Por ejemplo, si crea un clip de pelcula situado en el punto (_x:100, _y:100) y pasa un punto local que representa un punto prximo a la esquina superior izquierda del clip de pelcula (x:10, y:10) al mtodo localToGlobal() el mtodo debera convertir los valores de x e y en coordenadas globales, en este caso (x:110, y:110). Esta conversin ocurre porque ahora las coordenadas x e y se expresan en relacin con la esquina superior izquierda del escenario, no del clip de pelcula. Las coordenadas del clip de pelcula se han expresado con _x e _y porque son las propiedades de MovieClip utilizadas para definir los valores x e y para MovieClips. Sin embargo, el objeto genrico utiliza x e y sin subrayado. El siguiente cdigo convierte las coordenadas x e y en coordenadas globales:
var myPoint:Object = {x:10, y:10}; // create your generic point object this.createEmptyMovieClip("myMovieClip", this.getNextHighestDepth()); myMovieClip._x = 100; // _x for movieclip x position myMovieClip._y = 100; // _y for movieclip y position myMovieClip.localToGlobal(myPoint); trace ("x: " + myPoint.x); // output: 110 trace ("y: " + myPoint.y); // output: 110
Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0 Parmetros pt:Object - Nombre o identificador de un objeto creado con la clase Object que especifica las coordenadas x e y como propiedades. Ejemplo El ejemplo siguiente convierte las coordenadas x e y del objeto my_mc, coordenadas de clip de pelcula (locales), en coordenadas del escenario (globales). El punto central del clip de pelcula se refleja despus de hacer clic en la instancia y arrastrarla.
this.createTextField("point_txt", this.getNextHighestDepth(), 0, 0, 100, 22); var mouseListener:Object = new Object(); mouseListener.onMouseMove = function() { var point:Object = {x:my_mc._width/2, y:my_mc._height/2}; my_mc.localToGlobal(point); point_txt.text = "x:"+point.x+", y:"+point.y; }; Mouse.addListener(mouseListener); my_mc.onPress = function() { this.startDrag(); }; my_mc.onRelease = function() { this.stopDrag(); };
Vase tambin
globalToLocal (mtodo MovieClip.globalToLocal)
_lockroot (propiedad MovieClip._lockroot)

public _lockroot : Boolean

Un valor booleano que especifica a qu hace referencia _root cuando se carga un archivo SWF en un clip de pelcula. De manera predeterminada, la propiedad _lockroot es undefined. Se puede establecer esta propiedad dentro del archivo SWF que se est cargando o en el controlador que est cargando el clip de pelcula. Por ejemplo, supongamos que tiene un documento denominado Games.fla que permite a un usuario elegir un juego y que carga dicho juego (por ejemplo, Chess.swf) en el clip de pelcula game_mc. Asegrese de que despus de haber cargado Games.swf, cualquier uso de _root en Chess.swf hace referencia a _root en Chess.swf (y no a _root en Games.swf). Si tiene acceso a Chess.fla y lo publica con Flash Player 7 o una versin posterior, puede agregar esta sentencia en lnea de tiempo principal de Chess.fla:
this._lockroot = true;
Si no dispone de acceso a Chess.fla (por ejemplo, si est cargando Chess.swf en chess_mc desde un sitio ajeno), podr establecer la propiedad _lockroot de Chess.swf cuando la cargue. Site el siguiente cdigo ActionScript en la lnea de tiempo principal de Games.fla:
chess_mc._lockroot = true;
En este caso, Chess.swf se podr publicar para cualquier versin de Flash Player, siempre y cuando Games.swf se publique para Flash Player 7 o posterior. Cuando se realice una llamada al mtodo loadMovie(), defina la propiedad MovieClip._lockroot en true en la pelcula de cargador, tal como se muestra en el ejemplo siguiente. Si no establece _lockroot en true en la pelcula de cargador, todas las referencias a _root que contenga la pelcula cargada sealan a _root del cargador en lugar de a _root de la pelcula cargada:
myMovieClip._lockroot = true;
Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente, lockroot.fla tiene _lockroot aplicado en el archivo SWF principal. Si est cargado en otro documento FLA, _root siempre hace referencia al mbito de lockroot.swf, lo que ayuda a prevenir conflictos. Coloque el siguiente cdigo ActionScript en la lnea de tiempo principal de lockroot.fla:
this._lockroot = true; _root.myVar = 1; _root.myOtherVar = 2; trace("from lockroot.swf"); for (i in _root) { trace(" "+i+" -> "+_root[i]); } trace("");
que obtiene la siguiente informacin:

from lockroot.swf myOtherVar -> 2 myVar -> 1 _lockroot -> true $version -> WIN 7,0,19,0
El ejemplo siguiente carga dos archivos SWF, lockroot.swf y nolockroot.swf. El documento lockroot.fla contiene el cdigo ActionScript del ejemplo anterior. El archivo FLA nolockroot tiene el siguiente cdigo insertado en el fotograma 1 de la lnea de tiempo:

_root.myVar = 1; _root.myOtherVar = 2; trace("from nolockroot.swf"); for (i in _root) { trace(" "+i+" -> "+_root[i]); } trace("");
El archivo lockroot.swf tiene aplicado _lockroot, no as nolockroot.swf. Una vez cargados los archivos, cada uno muestra los valores de las variables de sus mbitos _root. Inserte el siguiente cdigo ActionScript en la lnea de tiempo principal del documento FLA:
this.createEmptyMovieClip("lockroot_mc", this.getNextHighestDepth()); lockroot_mc.loadMovie("lockroot.swf"); this.createEmptyMovieClip("nolockroot_mc", this.getNextHighestDepth()); nolockroot_mc.loadMovie("nolockroot.swf"); function dumpRoot() { trace("from current SWF file"); for (i in _root) { trace(" "+i+" -> "+_root[i]); } trace(""); } dumpRoot();
que obtiene la siguiente informacin:

from current SWF file dumpRoot -> [type Function] $version -> WIN 7,0,19,0 nolockroot_mc -> _level0.nolockroot_mc lockroot_mc -> _level0.lockroot_mc from nolockroot.swf myVar -> 1 i -> lockroot_mc dumpRoot -> [type Function] $version -> WIN 7,0,19,0 nolockroot_mc -> _level0.nolockroot_mc lockroot_mc -> _level0.lockroot_mc from lockroot.swf myOtherVar -> 2 myVar -> 1
El archivo que no tiene _lockroot aplicado tambin contiene todas las dems variables que contiene el archivo SWF raz. Si no tiene acceso a nolockroot.fla, puede utilizar el siguiente cdigo ActionScript aadido a la lnea de tiempo principal para cambiar _lockroot en el documento FLA principal precedente:
this.createEmptyMovieClip("nolockroot_mc", this.getNextHighestDepth()); nolockroot_mc._lockroot = true; nolockroot_mc.loadMovie("nolockroot.swf");
que entonces obtiene lo siguiente:

from current SWF file dumpRoot -> [type Function] $version -> WIN 7,0,19,0 nolockroot_mc -> _level0.nolockroot_mc lockroot_mc -> _level0.lockroot_mc from nolockroot.swf myOtherVar -> 2 myVar -> 1 from lockroot.swf myOtherVar -> 2 myVar -> 1
Vase tambin
_root, propiedad, _lockroot (propiedad MovieClip._lockroot), attachMovie (mtodo MovieClip.attachMovie), loadMovie (mtodo MovieClip.loadMovie), onLoadInit (detector de eventos MovieClipLoader.onLoadInit)
moveTo (mtodo MovieClip.moveTo)

public moveTo(x:Number, y:Number) : Void
Mueve la posicin de dibujo actual a (x, y). Si falta alguno de los parmetros, este mtodo falla y la posicin de dibujo actual no cambia. Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0 Parmetros x:Number - Entero que indica la posicin horizontal con respecto al punto de registro del clip de pelcula principal. y:Number - Entero que indica la posicin vertical con respecto al punto de registro del clip de pelcula principal. Ejemplo El ejemplo siguiente dibuja un tringulo con una lnea continua magenta de 5 pxeles y un relleno azul parcialmente transparente:
this.createEmptyMovieClip("triangle_mc", 1); triangle_mc.beginFill(0x0000FF, 30); triangle_mc.lineStyle(5, 0xFF00FF, 100); triangle_mc.moveTo(200, 200); triangle_mc.lineTo(300, 300); triangle_mc.lineTo(100, 300); triangle_mc.lineTo(200, 200); triangle_mc.endFill();
Vase tambin
createEmptyMovieClip (mtodo MovieClip.createEmptyMovieClip), lineStyle (mtodo MovieClip.lineStyle), lineTo (mtodo MovieClip.lineTo)

_name (propiedad MovieClip._name)

Nombre de instancia del clip de pelcula. Disponibilidad Flash Lite 2.0 Vase tambin
_name (propiedad Button._name)
nextFrame (mtodo MovieClip.nextFrame)

public nextFrame() : Void
Traslada la cabeza lectora al siguiente fotograma y la detiene en dicho punto. Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente utiliza _framesloaded y nextFrame() para cargar contenido en un archivo SWF. No aada ningn cdigo al fotograma 1, pero aada el siguiente cdigo ActionScript en el fotograma 2 de la lnea de tiempo:
if (this._framesloaded >= 3) { this.nextFrame(); } else { this.gotoAndPlay(1); }
A continuacin, aada el cdigo siguiente (y el contenido que desee cargar) al fotograma 3:

stop();
Vase tambin
nextFrame, funcin, prevFrame, funcin, prevFrame (mtodo MovieClip.prevFrame)
onData (controlador MovieClip.onData)

onData = function() {}
Se invoca cuando un clip de pelcula recibe datos de una llamada MovieClip.loadVariables() o MovieClip.loadMovie(). Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Puede definir la funcin en la lnea de tiempo o en un archivo de clase que ample la clase MovieClip o est vinculado a un smbolo de la biblioteca. Este controlador slo se puede utilizar con clips de pelcula para los que se dispondr de un smbolo en la biblioteca asociada a la clase. Si desea que se invoque el controlador de eventos cuando un clip de pelcula concreto reciba datos, deber utilizar onClipEvent() en lugar de este controlador. Este ltimo controlador se invoca cuando algn clip de pelcula recibe datos. Disponibilidad Flash Lite 2.0

Ejemplo El ejemplo siguiente ilustra cmo utilizar correctamente el mtodo MovieClip.onData() y onClipEvent(data). El smbolo symbol_mc es un smbolo de clip de pelcula de la biblioteca. Est vinculado a la clase MovieClip. La primera funcin que se muestra a continuacin se activa para cada instancia de symbol_mc cuando recibe datos. El clip de pelcula dynamic_mc se carga con MovieClip.loadMovie(). El cdigo que utiliza dynamic_mc a continuacin intenta llamar a una funcin cuando se carga el clip de pelcula, pero no funciona. El archivo SWF cargado debe ser un smbolo de la biblioteca asociado a la clase MovieClip. La ltima funcin utiliza onClipEvent(data). El controlador de eventos onClipEvent() se invoca para cualquier clip de pelcula que reciba datos, se encuentre o no en la biblioteca. Por lo tanto, la ltima funcin de este ejemplo se invoca cuando se crea una instancia de symbol_mc y tambin cuando se carga replacement.swf.
// The following function is triggered for each instance of symbol_mc // when it receives data. symbol_mc.onData = function() { trace("The movie clip has received data"); } // This code attempts to call a function when the clip is loaded, // but it will not work, because the loaded SWF is not a symbol // in the library associated with the MovieClip class. function output() { trace("Will never be called."); } dynamic_mc.onData = output; dynamic_mc.loadMovie("replacement.swf"); // The following function is invoked for any movie clip that // receives data, whether it is in the library or not. onClipEvent( data ) { trace("The movie clip has received data"); }
Vase tambin
onClipEvent, controlador
onDragOut (controlador MovieClip.onDragOut)

onDragOut = function() {}
Se invoca cuando se presiona el botn del ratn y el puntero se desplaza fuera del objeto. Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Puede definir la funcin en la lnea de tiempo o en un archivo de clase que ample la clase MovieClip o est vinculado a un smbolo de la biblioteca. Nota: este controlador de eventos se admite en Flash Lite slo si System.capabilities.hasMouse es true o System.capabilities.hasStylus es true. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente define una funcin para el mtodo onDragOut que enva una accin trace() al panel Salida:

my_mc.onDragOut = function () { trace ("onDragOut called"); }
Vase tambin
onDragOver (controlador MovieClip.onDragOver)
onDragOver (controlador MovieClip.onDragOver)

onDragOver = function() {}
Se invoca cuando el puntero se arrastra fuera del clip de pelcula y luego se pasa por encima de ste. Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Puede definir la funcin en la lnea de tiempo o en un archivo de clase que ample la clase MovieClip o est vinculado a un smbolo de la biblioteca. Nota: este controlador de eventos se admite en Flash Lite slo si System.capabilities.hasMouse es true o System.capabilities.hasStylus es true. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente define una funcin para el mtodo onDragOver que enva una accin trace() al panel Salida:
my_mc.onDragOver = function () { trace ("onDragOver called"); }
Vase tambin
onDragOut (controlador MovieClip.onDragOut)
onEnterFrame (controlador MovieClip.onEnterFrame)

onEnterFrame = function() {}
Se invoca de manera repetida a la velocidad de fotogramas del archivo SWF. La funcin que se asigne al controlador de eventos onEnterFrame se procesa antes que cualquier otro cdigo ActionScript que est asignado a los fotogramas afectados. Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Puede definir la funcin en la lnea de tiempo o en un archivo de clase que ample la clase MovieClip o est vinculado a un smbolo de la biblioteca. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente define una funcin para el controlador de eventos onEnterFrame que enva una accin trace() al panel Salida:
my_mc.onEnterFrame = function () { trace ("onEnterFrame called"); }

onKeyDown (controlador MovieClip.onKeyDown)

Se invoca cuando un clip de pelcula est resaltado y se presiona una tecla. El controlador de eventos onKeyDown se invoca sin parmetros. Puede utilizar los mtodosKey.getAscii() y Key.getCode() para determinar qu tecla ha presionado el usuario. Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Puede definir la funcin en la lnea de tiempo o en un archivo de clase que ample la clase MovieClip o est vinculado a un smbolo de la biblioteca. El controlador de eventos onKeyDown slo funciona si el clip de pelcula tiene la seleccin de entrada activada y establecida. En primer lugar, la propiedad MovieClip.focusEnabled debe establecerse como true para el clip de pelcula. Seguidamente, el clip debe recibir la seleccin de entrada. Esto puede hacerse utilizando Selection.setFocus() o estableciendo la tecla Tabulador para que se desplace al clip de pelcula. Si utiliza Selection.setFocus(), la ruta del clip de pelcula deber pasarse a Selection.setFocus(). Es fcil que otros elementos reciban la seleccin de entrada despus de que un usuario mueva el ratn. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente define una funcin para el mtodo onKeyDown() que enva una accin trace() al panel Salida. Cree un clip de pelcula denominado my_mc y aada el siguiente cdigo ActionScript al archivo FLA o AS:
my_mc.onKeyDown = function () { trace ("key was pressed"); }
El clip de pelcula debe estar seleccionado para que el controlador de eventos onKeyDown funcione. Aada el siguiente cdigo ActionScript para establecer la seleccin de entrada:
my_mc.tabEnabled = true; my_mc.focusEnabled = true; Selection.setFocus(my_mc);
Si utiliza el tabulador para acceder al clip de pelcula y presiona una tecla, se mostrar key was pressed en el panel Salida. Sin embargo, esto no ocurre si se desplaza el ratn, porque el clip de pelcula deja de estar seleccionado. Por lo tanto, deber utilizar Key.onKeyDown en la mayora de los casos. Vase tambin
getAscii (mtodo Key.getAscii), getCode (mtodo Key.getCode), focusEnabled (propiedad MovieClip.focusEnabled), setFocus (mtodo Selection.setFocus), onKeyDown (detector de eventos Key.onKeyDown), onKeyUp (controlador MovieClip.onKeyUp)
onKeyUp (controlador MovieClip.onKeyUp)

Se invoca cuando se suelta una tecla. El controlador de eventos onKeyUp se invoca sin parmetros. Puede utilizar los mtodosKey.getAscii() y Key.getCode() para determinar qu tecla ha presionado el usuario. Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Puede definir la funcin en la lnea de tiempo o en un archivo de clase que ample la clase MovieClip o est vinculado a un smbolo de la biblioteca.

El controlador de eventos onKeyUp slo funciona si el clip de pelcula tiene la seleccin de entrada activada y establecida. En primer lugar, la propiedad MovieClip.focusEnabled debe establecerse como true para el clip de pelcula. Seguidamente, el clip debe recibir la seleccin de entrada. Esto puede hacerse utilizando Selection.setFocus() o estableciendo la tecla Tabulador para que se desplace al clip de pelcula. Si utiliza Selection.setFocus(), la ruta del clip de pelcula deber pasarse a Selection.setFocus(). Es fcil que otros elementos reciban la seleccin de entrada despus de que un usuario mueva el ratn. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente define una funcin para el mtodo onKeyUp que enva una accin trace() al panel Salida:
my_mc.onKeyUp = function () { trace ("onKey called"); }
El ejemplo siguiente define la seleccin de entrada:

my_mc.focusEnabled = true; Selection.setFocus(my_mc);
Vase tambin
getAscii (mtodo Key.getAscii), getCode (mtodo Key.getCode), focusEnabled (propiedad MovieClip.focusEnabled), setFocus (mtodo Selection.setFocus), onKeyDown (detector de eventos Key.onKeyDown), onKeyDown (controlador MovieClip.onKeyDown)
onKillFocus (controlador MovieClip.onKillFocus)

Se invoca cuando un clip de pelcula deja de tener la seleccin de entrada. El mtodo onKillFocus recibe un parmetro, newFocus, que es un objeto que representa al nuevo objeto seleccionado. Si no hay ningn objeto seleccionado con el teclado, newFocus contendr el valor null (nulo). Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Puede definir la funcin en la lnea de tiempo o en un archivo de clase que ample la clase MovieClip o est vinculado a un smbolo de la biblioteca. Disponibilidad Flash Lite 2.0 Parmetros newFocus:Object - Objeto que recibe la seleccin de entrada. Ejemplo El ejemplo siguiente muestra informacin sobre el clip de pelcula que deja de estar seleccionado y la instancia que est seleccionada actualmente. En el escenario hay dos clips de pelcula denominados my_mc y other_mc. Puede aadir el siguiente cdigo ActionScript al documento FLA o AS:

my_mc.onRelease = Void; other_mc.onRelease = Void; my_mc.onKillFocus = function(newFocus) { trace("onKillFocus called, new focus is: "+newFocus); };
Si presiona la tecla Tabulador para desplazarse entre las dos instancias, la informacin se mostrar en el panel Salida. Vase tambin
onSetFocus (controlador MovieClip.onSetFocus)
onLoad (controlador MovieClip.onLoad)

onLoad = function() {}
Se invoca cuando se crea una instancia de clip de pelcula y sta aparece en la lnea de tiempo. Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Puede definir la funcin en la lnea de tiempo o en un archivo de clase que ample la clase MovieClip o est vinculado a un smbolo de la biblioteca. Este controlador slo se puede utilizar con clips de pelcula para los que se dispondr de un smbolo en la biblioteca asociada a la clase. Si desea que se invoque un controlador de eventos al cargarse un determinado clip de pelcula, deber utilizar onClipEvent(load) o la clase MovieClipLoader en lugar de este controlador, por ejemplo, cuando utilice MovieClip.loadMovie() para cargar dinmicamente un archivo SWF. A diferencia de MovieClip.onLoad, los dems controladores se invocan cuando se carga cualquier clip de pelcula. Disponibilidad Flash Lite 2.0 Ejemplo Este ejemplo muestra cmo utilizar el controlador de eventos onLoad en una definicin de clase de ActionScript 2.0 que ampla la clase MovieClip. En primer lugar, cree un archivo de clase llamado Oval.as y defina un mtodo de clase llamado onLoad(). Asegrese de que el archivo de clase se coloca en la ruta adecuada:
// contents of Oval.as class Oval extends MovieClip{ public function onLoad () { trace ("onLoad called"); } }
En segundo lugar, cree un smbolo de clip de pelcula en la biblioteca y denomnelo Oval. Haga clic en cualquier punto del smbolo en el panel Biblioteca (normalmente con el botn derecho del ratn) y seleccione Vinculacin... en el men emergente. Haga clic en "Exportar para ActionScript" y rellene los campos "Identificador" y "Clase ActionScript 2.0" con la palabra "Oval" (sin comillas). Deje la opcin "Exportar en primer fotograma" sin seleccionar y haga clic en Aceptar. En tercer lugar, desplcese al primer fotograma del archivo e introduzca el cdigo siguiente en el panel Acciones:
var myOval:Oval = Oval(attachMovie("Oval","Oval_1",1));
Finalmente, realice una prueba de la pelcula; deber ver el texto de salida "onLoad called". Vase tambin
loadMovie (mtodo MovieClip.loadMovie), onClipEvent, controlador, MovieClipLoader

onMouseDown (controlador MovieClip.onMouseDown)

onMouseDown = function() {}
Se invoca cuando se presiona el botn del ratn. Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Puede definir la funcin en la lnea de tiempo o en un archivo de clase que ample la clase MovieClip o est vinculado a un smbolo de la biblioteca. Nota: este controlador de eventos se admite en Flash Lite slo si System.capabilities.hasMouse es true o System.capabilities.hasStylus es true. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente define una funcin para el mtodo onMouseDown que enva una accin trace() al panel Salida:
my_mc.onMouseDown = function () { trace ("onMouseDown called"); }
onMouseMove (controlador MovieClip.onMouseMove)

onMouseMove = function() {}
Se invoca cuando se mueve el ratn. Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Puede definir la funcin en la lnea de tiempo o en un archivo de clase que ample la clase MovieClip o est vinculado a un smbolo de la biblioteca. Nota: este controlador de eventos se admite en Flash Lite slo si System.capabilities.hasMouse es true. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente define una funcin para el mtodo onMouseMove que enva una accin trace() al panel Salida:
my_mc.onMouseMove = function () { trace ("onMouseMove called"); }
onMouseUp (controlador MovieClip.onMouseUp)

onMouseUp = function() {}
Se invoca cuando se suelta el botn del ratn. Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Puede definir la funcin en la lnea de tiempo o en un archivo de clase que ample la clase MovieClip o est vinculado a un smbolo de la biblioteca. Nota: este controlador de eventos se admite en Flash Lite slo si System.capabilities.hasMouse es true o System.capabilities.hasStylus es true. Disponibilidad Flash Lite 2.0

Ejemplo El ejemplo siguiente define una funcin para el mtodo onMouseUp que enva una accin trace() al panel Salida:
my_mc.onMouseUp = function () { trace ("onMouseUp called"); }
onPress (controlador MovieClip.onPress)

onPress = function() {}
Se invoca cuando el usuario hace clic en el ratn mientras el puntero se encuentra sobre un clip de pelcula. Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Puede definir la funcin en la biblioteca. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente define una funcin para el mtodo onPress que enva una accin trace() al panel Salida:
my_mc.onPress = function () { trace ("onPress called"); }
onRelease (controlador MovieClip.onRelease)

onRelease = function() {}
Se invoca cuanto se suelta el botn del ratn sobre un clip de pelcula. Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Puede definir la funcin en la lnea de tiempo o en un archivo de clase que ample la clase MovieClip o est vinculado a un smbolo de la biblioteca. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente define una funcin para el mtodo onRelease que enva una accin trace() al panel Salida:
my_mc.onRelease = function () { trace ("onRelease called"); }
onReleaseOutside (controlador MovieClip.onReleaseOutside)

onReleaseOutside = function() {}
Se invoca cuando se presiona el botn del ratn dentro del rea del clip de pelcula y luego se suelta despus fuera del rea. Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Puede definir la funcin en la lnea de tiempo o en un archivo de clase que ample la clase MovieClip o est vinculado a un smbolo de la biblioteca. Nota: este controlador de eventos se admite en Flash Lite slo si System.capabilities.hasMouse es true o System.capabilities.hasStylus es true.

Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente define una funcin para el mtodo onReleaseOutside que enva una accin trace() al panel Salida:
my_mc.onReleaseOutside = function () { trace ("onReleaseOutside called"); }
onRollOut (controlador MovieClip.onRollOut)

onRollOut = function() {}
Se invoca cuando el puntero se desplaza fuera del rea de un clip de pelcula. Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Puede definir la funcin en la lnea de tiempo o en un archivo de clase que ample la clase MovieClip o est vinculado a un smbolo de la biblioteca. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente define una funcin para el mtodo onRollOut que enva una accin trace() al panel Salida:
my_mc.onRollOut = function () { trace ("onRollOut called"); }
onRollOver (controlador MovieClip.onRollOver)

onRollOver = function() {}
Se invoca cuando el puntero se desplaza sobre el rea de un clip de pelcula. Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Puede definir la funcin en la lnea de tiempo o en un archivo de clase que ample la clase MovieClip o est vinculado a un smbolo de la biblioteca. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente define una funcin para el mtodo onRollOver que enva una accin trace() al panel Salida:
my_mc.onRollOver = function () { trace ("onRollOver called"); }
onSetFocus (controlador MovieClip.onSetFocus)


Se invoca cuando un clip de pelcula recibe la seleccin de entrada. El parmetro oldFocus es el objeto que deja de estar seleccionado. Por ejemplo, si el usuario presiona la tecla Tabulador para desplazar la seleccin del teclado de un clip de pelcula a un campo de texto, oldFocus contendr la instancia del clip de pelcula. Si anteriormente no haba ningn objeto seleccionado con el teclado, oldFocus contendr un valor null (nulo). Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Puede definir la funcin en la lnea de tiempo o en un archivo de clase que ample la clase MovieClip o est vinculado a un smbolo de la biblioteca. Disponibilidad Flash Lite 2.0 Parmetros oldFocus:Object - El objeto que deja de estar seleccionado. Ejemplo El ejemplo siguiente muestra informacin sobre el clip de pelcula que tiene la seleccin de entrada y la instancia que estaba seleccionada anteriormente. En el escenario hay dos clips de pelcula denominados my_mc y other_mc. Aada el siguiente cdigo ActionScript al documento FLA o AS:
my_mc.onRelease = Void; other_mc.onRelease = Void; my_mc.onSetFocus = function(oldFocus) { trace("onSetFocus called, previous focus was: "+oldFocus); }
Si presiona la tecla Tabulador entre las dos instancias, la informacin se mostrar en el panel Salida. Vase tambin
onKillFocus (controlador MovieClip.onKillFocus)
onUnload (controlador MovieClip.onUnload)

onUnload = function() {}
Se invoca en el primer fotograma despus de que se elimina el clip de pelcula de la lnea de tiempo. Flash procesa las acciones asociadas al controlador de eventos onUnload antes de asociar acciones al fotograma afectado. Debe definir la funcin que ha de ejecutarse cuando se invoca el controlador de eventos. Puede definir la funcin en la lnea de tiempo o en un archivo de clase que ample la clase MovieClip o est vinculado a un smbolo de la biblioteca. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente define una funcin para el mtodo MovieClip.onUnload que enva una accin trace() al panel Salida:
my_mc.onUnload = function () { trace ("onUnload called"); }

_parent (propiedad MovieClip._parent)

Referencia al clip de pelcula o un objeto que contiene el clip de pelcula u objeto actual. El parmetro _parent es la referencia del objeto actual. Utilice la propiedad _parent para especificar una ruta de acceso relativa a los clips de pelcula u objetos que se encuentran por encima del clip de pelcula u objeto actual. Puede utilizar _parent para subir mltiples niveles en la lista de visualizacin, como se muestra a continuacin:
this._parent._parent._alpha = 20;
Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente obtiene la referencia a un clip de pelcula y su relacin con la lnea de tiempo principal. Cree un clip de pelcula con el nombre de instancia my_mc y adalo a la lnea de tiempo principal. Aada el siguiente cdigo ActionScript al archivo FLA o AS:
my_mc.onRelease = function() { trace("You clicked the movie clip: "+this); trace("The parent of "+this._name+" is: "+this._parent); }
Al hacer clic en el clip de pelcula, aparecer la siguiente informacin en el panel Salida:

You clicked the movie clip: _level0.my_mc The parent of my_mc is: _level0
Vase tambin
_parent (propiedad Button._parent), _root, propiedad, targetPath, funcin, _parent (propiedad TextField._parent)
play (mtodo MovieClip.play)

public play() : Void
Mueve la cabeza lectora en la lnea de tiempo del clip de pelcula. Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0 Ejemplo Utilice el siguiente cdigo ActionScript para reproducir la lnea de tiempo principal de un archivo SWF. Este cdigo ActionScript es para un botn de clip de pelcula denominado my_mc de la lnea de tiempo principal:
stop(); my_mc.onRelease = function() { this._parent.play(); };

Utilice el siguiente cdigo ActionScript para reproducir la lnea de tiempo de un clip de pelcula en un archivo SWF. Este cdigo ActionScript es para un botn denominado my_btn de la lnea de tiempo principal que reproduce un clip de pelcula llamado animation_mc:
animation_mc.stop(); my_btn.onRelease = function(){ animation_mc.play(); };
Vase tambin
play, funcin, gotoAndPlay (mtodo MovieClip.gotoAndPlay), gotoAndPlay, funcin
prevFrame (mtodo MovieClip.prevFrame)

public prevFrame() : Void
Traslada la cabeza lectora al fotograma anterior y la detiene en dicho punto. Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente, dos botones de clip de pelcula controlan la lnea de tiempo. El botn prev_mc desplaza la cabeza lectora al fotograma anterior, mientras que el botn next_mc la desplaza al fotograma siguiente. Aada contenido a una serie de fotogramas de la lnea de tiempo y aada el siguiente cdigo ActionScript al fotograma 1 de la lnea de tiempo:
stop(); prev_mc.onRelease = function() { var parent_mc:MovieClip = this._parent; if (parent_mc._currentframe>1) { parent_mc.prevFrame(); } else { parent_mc.gotoAndStop(parent_mc._totalframes); } }; next_mc.onRelease = function() { var parent_mc:MovieClip = this._parent; if (parent_mc._currentframe<parent_mc._totalframes) { parent_mc.nextFrame(); } else { parent_mc.gotoAndStop(1); } };
Vase tambin
prevFrame, funcin
_quality (propiedad MovieClip._quality, propiedad)


Establece o recupera la calidad de representacin que se utiliza para un archivo SWF. Las fuentes de dispositivo siempre se muestran dentadas y, por consiguiente, no se ven afectadas por la propiedad _quality. La propiedad _quality puede configurarse con los siguientes valores:
Valor "LOW" "MEDIUM" Descripcin Calidad de representacin baja. Suavizado de grficos Los grficos no se suavizan.
Calidad de representacin media. Los grficos se suavizan empleando una Este ajuste resulta adecuado para cuadrcula de 2 x 2 pxeles. pelculas que no contengan texto. Calidad de representacin alta. Esta es la calidad de representacin predeterminada de Flash. Calidad de representacin muy alta. Los grficos se suavizan empleando una cuadrcula de 4 x 4 pxeles.
"HIGH"
"BEST"
Los grficos se suavizan empleando una cuadrcula de 4 x 4 pxeles.
Nota: aunque puede especificar esta propiedad para un objeto MovieClip, se trata en realidad de una propiedad global, por lo que puede especificar su valor simplemente como _quality. Disponibilidad Flash Lite 2.0 Ejemplo Este ejemplo establece en my_mc la calidad de representacin de un clip de pelcula denominado LOW:
my_mc._quality = "LOW";
Vase tambin
_quality, propiedad
removeMovieClip (mtodo MovieClip.removeMovieClip)

public removeMovieClip() : Void
Elimina una instancia de clip de pelcula creada por duplicateMovieClip(), MovieClip.duplicateMovieClip(), MovieClip.createEmptyMovieClip() o MovieClip.attachMovie(). Este mtodo no elimina clips de pelcula asignados a valores de profundidad negativos. Los clips de pelcula creados en la herramienta del entorno de edicin tienen asignados valores de profundidad negativos de forma predeterminada. Para eliminar un clip de pelcula que tiene asignado un valor negativo de profundidad, en primer lugar utilice MovieClip.swapDepths() para desplazar el clip de pelcula a un valor de profundidad positivo. Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0 Ejemplo Cada vez que se hace clic en un botn en el ejemplo siguiente, se asocia una instancia de clip de pelcula al escenario en una posicin aleatoria. Al hacer clic en una instancia de clip de pelcula, se eliminar esa instancia del archivo SWF.

function randRange(min:Number, max:Number):Number { var randNum:Number = Math.round(Math.random()*(max-min))+min; return randNum; } var bugNum:Number = 0; addBug_btn.onRelease = addBug; function addBug() { var thisBug:MovieClip = this._parent.attachMovie("bug_id", "bug"+bugNum+"_mc", bugNum, {_x:randRange(50, 500), _y:randRange(50, 350)}); thisBug.onRelease = function() { this.removeMovieClip(); }; bugNum++; }
Vase tambin
duplicateMovieClip, funcin, createEmptyMovieClip (mtodo MovieClip.createEmptyMovieClip), duplicateMovieClip (mtodo MovieClip.duplicateMovieClip), attachMovie (mtodo MovieClip.attachMovie)swapDepths (mtodo MovieClip.swapDepths)
_rotation (propiedad MovieClip._rotation)

Especifica el giro del clip de pelcula, expresado en grados, con respecto a su orientacin original. Los valores comprendidos entre 0 y 180 representan un giro en el sentido de las agujas del reloj, mientras que los comprendidos entre 0 y -180 representan un giro en sentido contrario al de las agujas del reloj. Los valores situados fuera de este rango se suman o restan de 360 para obtener un valor que s est comprendido en el rango. Por ejemplo, la sentencia my_mc._rotation = 450 es igual que my_mc._rotation = 90. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea dinmicamente un clip de pelcula denominado triangle. Cuando ejecute el archivo SWF, haga clic en el clip de pelcula para girarlo:
this.createEmptyMovieClip("triangle", this.getNextHighestDepth()); triangle.beginFill(0x0000FF, 100); triangle.moveTo(100, 100); triangle.lineTo(100, 150); triangle.lineTo(150, 100); triangle.lineTo(100, 100); triangle.onMouseUp= function() { this._rotation += 15; };
Vase tambin
_rotation (propiedad Button._rotation), _rotation (propiedad TextField._rotation)

setMask (mtodo MovieClip.setMask)

public setMask(mc:Object) : Void
Convierte el clip de pelcula del parmetro mc en una mscara que revela el clip de pelcula especificado por el clip de pelcula. El mtodo setMask() permite a los clips de pelcula de mltiples fotogramas con contenido complejo en mltiples capas actuar como mscaras (lo cual es posible utilizando capas de mscara). Si en un clip de pelcula con mscara hay fuentes de dispositivo, stas se dibujarn pero no se enmascararn. No es posible configurar un clip de pelcula de forma que sea su propia mscara (por ejemplo, my_mc.setMask(my_mc)). Si crea una capa de mscara que contiene un clip de pelcula y luego le aplica el mtodo setMask(), la llamada a setMask() tiene prioridad y es irreversible. Por ejemplo, puede tener un clip de pelcula en una capa de mscara denominada UIMask que enmascare otra capa que contiene otro clip de pelcula denominado UIMaskee. Si, durante la reproduccin del archivo SWF, efecta una llamada a UIMask.setMask(UIMaskee), UIMask quedar enmascarada por UIMaskee. Para cancelar una mscara creada con ActionScript, pase el valor null al mtodo setMask(). El siguiente cdigo cancela la mscara sin que ello afecte a la capa de mscara en la lnea de tiempo.
UIMask.setMask(null);
Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0 Parmetros mc:Object - Nombre de instancia de un clip de pelcula que se va a enmascarar. Puede ser una cadena o un objeto MovieClip. Ejemplo En este ejemplo se utiliza un clip de pelcula circleMask_mc para enmascarar al clip de pelcula theMaskee_mc:
theMaskee_mc.setMask(circleMask_mc);
_soundbuftime (propiedad MovieClip._soundbuftime)

Especifica el nmero de segundos que un sonido debe almacenarse en el bfer antes de que comience a reproducirse sin interrupcin. Nota: aunque puede especificar esta propiedad para un objeto MovieClip, se trata en realidad de una propiedad global que se aplica a todos los sonidos cargados, por lo que puede especificar su valor simplemente como _soundbuftime. Al establecer esta propiedad para un objeto MovieClip, en realidad se define la propiedad global. Disponibilidad Flash Lite 2.0 Vase tambin

startDrag (mtodo MovieClip.startDrag)

public startDrag([lockCenter:Boolean], [left:Number], [top:Number], [right:Number], [bottom:Number]) : Void
Permite al usuario arrastrar el clip de pelcula especificado. Es posible continuar arrastrando el clip de pelcula hasta que se detenga explcitamente mediante una llamada a MovieClip.stopDrag() o hasta que otro clip de pelcula pueda arrastrarse. Slo es posible arrastrar clips de pelcula de uno en uno. Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Nota: este mtodo se admite en Flash Lite slo si System.capabilities.hasMouse es true o System.capabilities.hasStylus es true. Disponibilidad Flash Lite 2.0 Parmetros lockCenter:Boolean [opcional] - Valor booleano que especifica si el clip de pelcula que puede arrastrarse est bloqueado en el centro de la posicin del ratn (true), o en el punto donde el usuario hizo clic por primera vez en el clip de pelcula (false). left:Number [opcional] - Valor relativo a las coordenadas del elemento principal del clip de pelcula, que especifican un rectngulo de delimitacin para el clip de pelcula. top:Number [opcional] - Valor relativo a las coordenadas del elemento principal del clip de pelcula, que especifican un rectngulo de delimitacin para el clip de pelcula. right:Number [opcional] - Valor relativo a las coordenadas del elemento principal del clip de pelcula, que especifican un rectngulo de delimitacin para el clip de pelcula. bottom:Number [opcional] - Valor relativo a las coordenadas del elemento principal del clip de pelcula, que especifican un rectngulo de delimitacin para el clip de pelcula. Ejemplo El ejemplo siguiente crea una instancia de clip de pelcula que puede arrastrarse denominada mc_1.
this.createEmptyMovieClip("mc_1", 1); with (mc_1) { lineStyle(1, 0xCCCCCC); beginFill(0x4827CF); moveTo(0, 0); lineTo(80, 0); lineTo(80, 60); lineTo(0, 60); lineTo(0, 0); endFill(); } mc_1.onPress = function() { this.startDrag(); }; mc_1.onRelease = function() { this.stopDrag(); };

Vase tambin
_droptarget (propiedad MovieClip._droptarget, propiedad), startDrag, funcin, stopDrag (mtodo MovieClip.stopDrag)
stop (mtodo MovieClip.stop)

public stop() : Void
Detiene el clip de pelcula que se est reproduciendo actualmente. Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente muestra cmo detener un clip de pelcula denominado aMovieClip:
aMovieClip.stop();
Vase tambin
stop, funcin
stopDrag (mtodo MovieClip.stopDrag)

public stopDrag() : Void
Finaliza un mtodo MovieClip.startDrag(). Un clip de pelcula que puede arrastrarse mediante dicho mtodo podr arrastrarse hasta que se aada un mtodo stopDrag() o hasta que se pueda arrastrar otro clip de pelcula. Slo es posible arrastrar clips de pelcula de uno en uno. Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Nota: este mtodo se admite en Flash Lite slo si System.capabilities.hasMouse es true o
Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea una instancia de clip de pelcula que puede arrastrarse denominada mc_1.

this.createEmptyMovieClip("mc_1", 1); with (mc_1) { lineStyle(1, 0xCCCCCC); beginFill(0x4827CF); moveTo(0, 0); lineTo(80, 0); lineTo(80, 60); lineTo(0, 60); lineTo(0, 0); endFill(); } mc_1.onPress = function() { this.startDrag(); }; mc_1.onRelease = function() { this.stopDrag(); };
Vase tambin
_droptarget (propiedad MovieClip._droptarget, propiedad), startDrag (mtodo MovieClip.startDrag), stopDrag, funcin
swapDepths (mtodo MovieClip.swapDepths)

public swapDepths(target:Object) : Void
Intercambia el apilamiento o nivel de profundidad (orden z), de este clip de pelcula con el clip de pelcula especificado por el parmetro target o con el clip de pelcula que ocupa actualmente el nivel de profundidad especificado en el parmetro target. Ambos clips de pelcula deben tener el mismo clip de pelcula principal. El cambio del nivel de profundidad de los clips de pelcula hace que un clip de pelcula se site delante o detrs del otro. Si se est interpolando un clip de pelcula cuando se llama a este mtodo, la interpolacin se detendr. Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0 Parmetros target:Object - Este parmetro puede tener una de las dos formas siguientes:
Entero exclusivo que especifica la profundidad a la que debe colocarse el nuevo clip de pelcula. Cadena que especifica la instancia de clip de pelcula cuya profundidad se intercambiar con el clip de pelcula al
que se va a aplicar el mtodo. Ambos clips de pelcula deben tener el mismo clip de pelcula principal. Ejemplo El ejemplo siguiente cambia el orden de apilamiento de dos instancias de clip de pelcula. Superponga en el escenario dos instancias de clip de pelcula denominadas myMC1_mc y myMC2_mc y despus aada el siguiente cdigo ActionScript a la lnea de tiempo principal:

myMC1_mc.onRelease = function() { this.swapDepths(myMC2_mc); }; myMC2_mc.onRelease = function() { this.swapDepths(myMC1_mc); };
Vase tambin
_level, propiedad, getDepth (mtodo MovieClip.getDepth), getInstanceAtDepth (mtodo MovieClip.getInstanceAtDepth), getNextHighestDepth (mtodo MovieClip.getNextHighestDepth)
tabChildren (propiedad MovieClip.tabChildren)

public tabChildren : Boolean
Determina si los elementos secundarios de un clip de pelcula se incluyen en el orden de tabulacin automtico. Si la propiedad tabChildren tiene el valor undefined o true, los elementos secundarios de un clip de pelcula se incluirn en el orden de tabulacin automtico. Si el valor de tabChildren es false, los elementos secundarios de un clip de pelcula no se incluirn en el orden de tabulacin automtico. El valor predeterminado es undefined. Disponibilidad Flash Lite 2.0 Ejemplo Un widget de cuadro de lista de la interfaz de usuario creado como un clip de pelcula contiene varios elementos. El usuario puede hacer clic en cada elemento para seleccionarlo, por lo que cada elemento aparece como un botn. Sin embargo, slo el cuadro de lista propiamente dicho debe ser una tabulacin. Los elementos del interior del cuadro de lista deben quedar excluidos del orden de tabulacin. Para ello, la propiedad tabChildren del cuadro de lista debe configurarse como false. La propiedad tabChildren no tiene ningn efecto si se utiliza la propiedad tabIndex; la propiedad tabChildren slo afecta al orden de tabulacin automtico. El ejemplo siguiente desactiva la tabulacin de todos los clips de pelcula secundarios del interior de un clip de pelcula principal denominado menu_mc:
menu_mc.onRelease = function(){}; menu_mc.menu1_mc.onRelease = function(){}; menu_mc.menu2_mc.onRelease = function(){}; menu_mc.menu3_mc.onRelease = function(){}; menu_mc.menu4_mc.onRelease = function(){}; menu_mc.tabChildren = false;
Cambie la ltima lnea de cdigo por lo siguiente para incluir las instancias de clip de pelcula secundarias de menu_mc en el orden de tabulacin automtico:
menu_mc.tabChildren = true;
Vase tambin
tabIndex (propiedad Button.tabIndex), tabEnabled (propiedad MovieClip.tabEnabled), tabIndex (propiedad MovieClip.tabIndex), tabIndex (propiedad TextField.tabIndex)

tabEnabled (propiedad MovieClip.tabEnabled)

Especifica si el clip de pelcula se incluye en el orden de tabulacin automtico. De manera predeterminada, tiene el valor undefined. Si la propiedad tabEnabled es undefined, el objeto slo se incluir en el orden de tabulacin automtico si define al menos un controlador de clip de pelcula, como MovieClip.onRelease. Si tabEnabled se establece con el valor true, el objeto se incluir en el orden de tabulacin automtico. Si la propiedad tabIndex tambin est configurada con un valor, el objeto se incluir tambin en el orden de tabulacin personalizado. Si tabEnabled tiene el valor false, el objeto no se incluir en el orden de tabulacin automtico ni en el personalizado aunque se establezca la propiedad tabIndex. No obstante, si MovieClip.tabChildren tiene el valor true, los elementos secundarios del clip de pelcula podrn incluirse en el orden de tabulacin automtico aunque tabEnabled tenga el valor false. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente no incluye myMC2_mc en el orden de tabulacin automtico:
myMC1_mc.onRelease = function() {}; myMC2_mc.onRelease = function() {}; myMC3_mc.onRelease = function() {}; myMC2_mc.tabEnabled = false;
Vase tambin
onRelease (controlador MovieClip.onRelease), tabEnabled (propiedad Button.tabEnabled), tabChildren (propiedad MovieClip.tabChildren), tabIndex (propiedad MovieClip.tabIndex), tabEnabled (propiedad TextField.tabEnabled)
tabIndex (propiedad MovieClip.tabIndex)

Permite personalizar el orden de tabulacin de los objetos de una pelcula. De manera predeterminada, la propiedad tabIndex es undefined. Puede establecer tabIndex en una instancia de botn, clip de pelcula o campo de texto. Si un objeto de un archivo SWF contiene una propiedad tabIndex, se desactivar el orden de tabulacin automtico y el orden de tabulacin se calcular a partir de las propiedades tabIndex de los objetos del archivo SWF. El orden de tabulacin personalizado slo incluye objetos que tienen propiedades tabIndex. La propiedad tabIndex debe ser un entero positivo. Los objetos se ordenan conforme a lo que indiquen las propiedades tabIndex y en orden ascendente. Un objeto que tenga un valor tabIndex de 1 preceder a otro objeto que tenga un valor tabIndex de 2. El orden de tabulacin personalizado no tiene en cuenta las relaciones jerrquicas de los objetos de un archivo SWF. Todos los objetos del archivo SWF que tengan propiedades tabIndex se incluirn en el orden de tabulacin. No utilice el mismo valor de tabIndex para varios objetos. Disponibilidad Flash Lite 2.0

Ejemplo El siguiente cdigo ActionScript establece un orden de tabulacin personalizado para tres instancias de clip de pelcula.
myMC1_mc.onRelease = function() {}; myMC2_mc.onRelease = function() {}; myMC3_mc.onRelease = function() {}; myMC1_mc.tabIndex = 2; myMC2_mc.tabIndex = 1; myMC3_mc.tabIndex = 3;
Vase tambin
tabIndex (propiedad Button.tabIndex), tabIndex (propiedad TextField.tabIndex)
_target (propiedad MovieClip._target)

Devuelve la ruta de destino de la instancia de clip de pelcula en notacin con barras. Utilice la funcin eval() para convertir la ruta de acceso de destino a notacin con punto. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente muestra las rutas de destino de instancias de clip de pelcula de un archivo SWF en notacin con barras y con punto.
for (var i in this) { if (typeof (this[i]) == "movieclip") { trace("name: " + this[i]._name + ",\t target: " + this[i]._target + ",\t target(2):" + eval(this[i]._target)); } }
_totalframes (propiedad MovieClip._totalframes)

public _totalframes : Number [read-only]
Devuelve el nmero total de fotogramas de la instancia de clip de pelcula especificada en el parmetro MovieClip. Ejemplo En el ejemplo siguiente, dos botones de clip de pelcula controlan la lnea de tiempo. El botn prev_mc desplaza la cabeza lectora al fotograma anterior, mientras que el botn next_mc la desplaza al fotograma siguiente. Aada contenido a una serie de fotogramas de la lnea de tiempo y aada el siguiente cdigo ActionScript al fotograma 1 de la lnea de tiempo:

stop(); prev_mc.onRelease = function() { var parent_mc:MovieClip = this._parent; if (parent_mc._currentframe>1) { parent_mc.prevFrame(); } else { parent_mc.gotoAndStop(parent_mc._totalframes); } }; next_mc.onRelease = function() { var parent_mc:MovieClip = this._parent; if (parent_mc._currentframe<parent_mc._totalframes) { parent_mc.nextFrame(); } else { parent_mc.gotoAndStop(1); } };
trackAsMenu (propiedad MovieClip.trackAsMenu)

public trackAsMenu : Boolean
Valor booleano que indica si otros botones o clips de pelcula pueden recibir un evento de liberacin de un ratn o lpiz stylus. Si arrastra un ratn o un lpiz stylus encima de un clip de pelcula y lo suelta sobre un segundo clip de pelcula, el evento onRelease se registrar para el segundo clip de pelcula. De este modo, puede crear mens para el segundo clip de pelcula. Puede establecer la propiedad trackAsMenu en cualquier botn u objeto del clip de pelcula. Si no ha definido la propiedad trackAsMenu, el comportamiento predeterminado es false. Puede cambiar la propiedad trackAsMenu en cualquier momento; el clip de pelcula modificado adoptar de inmediato el nuevo comportamiento. Nota: esta propiedad se admite en Flash Lite slo si System.capabilities.hasMouse es true o System.capabilities.hasStylus es true. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente define la propiedad trackAsMenu para tres clips de pelcula del escenario. Haga clic en un clip de pelcula y suelte el botn del ratn sobre un segundo clip de pelcula para ver qu instancia recibe el evento.
myMC1_mc.trackAsMenu = true; myMC2_mc.trackAsMenu = true; myMC3_mc.trackAsMenu = false; myMC1_mc.onRelease = clickMC; myMC2_mc.onRelease = clickMC; myMC3_mc.onRelease = clickMC; function clickMC() { trace("you clicked the "+this._name+" movie clip."); };
Vase tambin
trackAsMenu (propiedad Button.trackAsMenu)

transform (propiedad MovieClip.transform)

public transform : Transform
Objeto con propiedades pertenecientes a una matriz, transformacin de color y lmites de pxel de un clip de pelcula. Las propiedades especficas matrix, colorTransform y tres propiedades de slo lectura (concatenatedMatrix, concatenatedColorTransform y pixelBounds) se describen en la entrada de la clase Transform. Cada una de las propiedades del objeto transform es un objeto en s. Esto es importante porque el nico modo de definir nuevos valores para objetos matrix o colorTransform es crear un nuevo objeto y copiarlo en la propiedad transform.matrix o transform.colorTransform. Por ejemplo, para aumentar el valor tx de la matriz de un clip de pelcula, debe realizar una copia de la matriz del objeto completa, modifique la propiedad tx del nuevo objeto y, a continuacin, copie el nuevo objeto en la propiedad matrix del objeto transform:
var myMatrix:Object = myDisplayObject.transform.matrix; myMatrix.tx += 10; myDisplayObject.transform.matrix = myMatrix;
La propiedad tx no puede configurarse directamente. El cdigo siguiente no afecta a myDisplayObject:

myDisplayObject.transform.matrix.tx += 10;
Tambin puede copiar un objeto transform completo y asignarlo a la propiedad transform de otro clip de pelcula. Por ejemplo, el cdigo siguiente copia el objeto transform completo de myOldDisplayObj a myNewDisplayObj:
myNewDisplayObj.transform = myOldDisplayObj.transform;
El nuevo clip de pelcula, myNewDisplayObj, tiene ahora los mismos valores de matriz, transformacin de color y lmites de pxel que el antiguo objeto de visualizacin, myOldDisplayObj. Disponibilidad Flash Lite 3.1 Ejemplo El siguiente ejemplo muestra cmo se usa la propiedad transform de un clip de pelcula para modificar y acceder a la ubicacin de un clip de pelcula mediante el posicionamiento de Matrix.

import flash.geom.Matrix; var rect:MovieClip = createRectangle(20, 80, 0xFF0000); var translateMatrix:Matrix = new Matrix(); translateMatrix.translate(10, 0); rect.onPress = function() { var tmpMatrix:Matrix = this.transform.matrix; tmpMatrix.concat(translateMatrix); this.transform.matrix = tmpMatrix; } function createRectangle(width:Number, height:Number, color:Number, scope:MovieClip):MovieClip { scope = (scope == undefined) ? this : scope; var depth:Number = scope.getNextHighestDepth(); var mc:MovieClip = scope.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }
Vase tambin Transform (flash.geom.Transform) en la pgina 669
unloadMovie (mtodo MovieClip.unloadMovie)

public unloadMovie() : Void
Elimina el contenido de una instancia de clip de pelcula. Se conservan las propiedades de instancia y los controladores de clip. Para eliminar la instancia, incluidas sus propiedades y controladores de clip, utilice MovieClip.removeMovieClip(). Puede ampliar los mtodos y los controladores de eventos de la clase MovieClip creando una subclase. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente descarga una instancia de clip de pelcula denominada box cuando un usuario hace clic en el clip de pelcula box.

this.createEmptyMovieClip("box", 1); with (box) { lineStyle(1, 0xCCCCCC); beginFill(0x4827CF); moveTo(0, 0); lineTo(80, 0); lineTo(80, 60); lineTo(0, 60); lineTo(0, 0); endFill(); } box.onRelease = function() { box.unloadMovie(); };
Vase tambin
removeMovieClip (mtodo MovieClip.removeMovieClip), attachMovie (mtodo MovieClip.attachMovie), loadMovie (mtodo MovieClip.loadMovie), unloadMovie, funcin, unloadMovieNum, funcin
_url (propiedad MovieClip._url)

Recupera la URL del archivo SWF, JPEG, GIF o PNG de la que se descarg el clip de pelcula. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente muestra la URL de la imagen que se ha cargado en la instancia image_mc en el panel Salida.
this.createEmptyMovieClip("image_mc", 1); var mclListener:Object = new Object(); mclListener.onLoadInit = function(target_mc:MovieClip) { trace("_url: "+target_mc._url); }; var image_mcl:MovieClipLoader = new MovieClipLoader(); image_mcl.addListener(mclListener); image_mcl.loadClip("http://www.helpexamples.com/flash/images/image1.jpg", image_mc);
_visible (propiedad MovieClip._visible)

Valor booleano que indica si un clip de pelcula est visible. Los clips de pelcula no visibles (que tienen la propiedad _visible configurada como false) se desactivan. Por ejemplo, no es posible hacer clic en un botn de un clip de pelcula con _visible configurado con el valorfalse. Disponibilidad Flash Lite 2.0

Ejemplo El ejemplo siguiente establece la propiedad _visible en dos clips de pelcula denominados myMC1_mc y myMC2_mc. La propiedad se configura como true para una instancia y como false para la otra. Observe que no es posible hacer clic en la instancia myMC1_mc tras definir la propiedad _visible en false.
myMC1_mc.onRelease = function() trace(this._name+"._visible this._visible = false; }; myMC2_mc.onRelease = function() trace(this._name+"._alpha = this._alpha = 0; }; { = false");
{ 0");
Vase tambin
_visible (propiedad Button._visible), _visible (propiedad TextField._visible)

Anchura del clip de pelcula, expresada en pxeles. Disponibilidad Flash Lite 2.0 Ejemplo El siguiente ejemplo de cdigo muestra la altura y anchura de un clip de pelcula en el panel Salida:
this.createEmptyMovieClip("triangle", this.getNextHighestDepth()); triangle.beginFill(0x0000FF, 100); triangle.moveTo(100, 100); triangle.lineTo(100, 150); triangle.lineTo(150, 100); triangle.lineTo(100, 100); trace(triangle._name + " = " + triangle._width + " X " + triangle._height + " pixels");
Vase tambin
_height (propiedad MovieClip._height)
_x (MovieClip._x, propiedad)
public _x : Number

Entero que establece la coordenada x de un clip de pelcula con respecto a las coordenadas locales del clip de pelcula principal. Si un clip de pelcula se encuentra en la lnea de tiempo principal, su sistema de coordenadas hace referencia a la esquina superior izquierda del escenario como (0, 0). Si el clip de pelcula est dentro de otro clip de pelcula que incluye transformaciones, el clip de pelcula estar en el sistema de coordenadas local del clip de pelcula en el que est contenido. Por consiguiente, en el caso de un clip de pelcula con un giro de 90 en sentido contrario al de las agujas del reloj, los clips de pelcula secundarios de este clip de pelcula heredarn un sistema de coordenadas con un giro de 90 en sentido contrario al de las agujas del reloj. Las coordenadas del clip de pelcula hacen referencia a la posicin del punto de registro. Disponibilidad Flash Lite 2.0 Vase tambin
_xscale (propiedad MovieClip._xscale), _y (propiedad MovieClip._y, propiedad), _yscale (propiedad MovieClip._yscale)
_xmouse (propiedad MovieClip._xmouse)

Devuelve la coordenada x de la posicin del ratn. Nota: esta propiedad se admite en Flash Lite slo si System.capabilities.hasMouse es true o System.capabilities.hasStylus es true. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente devuelve las coordenadas x e y actuales del ratn en el escenario (_level0) y con respecto a un clip de pelcula del escenario llamado my_mc:
this.createTextField("mouse_txt", this.getNextHighestDepth(), 0, 0, 150, 66); mouse_txt.html = true; mouse_txt.multiline = true; var row1_str:String = " \t_xmouse\t_ymouse"; my_mc.onMouseMove = function() { mouse_txt.htmlText = "<textformat tabStops='[50,100]'>"; mouse_txt.htmlText += row1_str; mouse_txt.htmlText += "_level0\t"+_xmouse+"\t"+_ymouse; mouse_txt.htmlText += "my_mc\t"+this._xmouse+"\t"+this._ymouse; mouse_txt.htmlText += "</textformat>"; };
Vase tambin
hasMouse (propiedad capabilities.hasMouse), _ymouse (propiedad MovieClip._ymouse)
_xscale (propiedad MovieClip._xscale)

Establece la escala horizontal (percentage) del clip de pelcula aplicada desde el punto de registro del clip de pelcula. El punto de registro predeterminado es (0,0).

La escala del sistema de coordenadas local afecta a la configuracin de las propiedades de _x e _y, que se definen en pxeles completos. Por ejemplo, si se aplica una escala del 50% al clip de pelcula principal, la configuracin de la propiedad _y desplazar un objeto situado en el clip de pelcula la mitad de pxeles que si la pelcula tuviera una escala del 100%. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un clip de pelcula denominado box_mc en tiempo de ejecucin. La API de dibujo se utiliza para dibujar un recuadro en esta instancia y, cuando el ratn se desplaza sobre el recuadro, se aplica un cambio de escala horizontal y vertical al clip de pelcula. Cuando el ratn se desplaza fuera de la instancia, sta recupera la escala anterior.
this.createEmptyMovieClip("box_mc", 1); box_mc._x = 100; box_mc._y = 100; with (box_mc) { lineStyle(1, 0xCCCCCC); beginFill(0xEEEEEE); moveTo(0, 0); lineTo(80, 0); lineTo(80, 60); lineTo(0, 60); lineTo(0, 0); endFill(); }; box_mc.onRollOver = function() { this._x -= this._width/2; this._y -= this._height/2; this._xscale = 200; this._yscale = 200; }; box_mc.onRollOut = function() { this._xscale = 100; this._yscale = 100; this._x += this._width/2; this._y += this._height/2; };
Vase tambin
_x (MovieClip._x, propiedad), _y (propiedad MovieClip._y, propiedad), _yscale (propiedad MovieClip._yscale), _width (propiedad MovieClip._width)
_y (propiedad MovieClip._y, propiedad)

public _y : Number

Establece la coordenada y de un clip de pelcula con respecto a las coordenadas locales del clip de pelcula principal. Si un clip de pelcula se encuentra en la lnea de tiempo principal, su sistema de coordenadas hace referencia a la esquina superior izquierda del escenario como (0,0). Si el clip de pelcula est dentro de otro clip de pelcula que incluye transformaciones, el clip de pelcula estar en el sistema de coordenadas local del clip de pelcula en el que est contenido. Por consiguiente, en el caso de un clip de pelcula con un giro de 90 en sentido contrario al de las agujas del reloj, los clips de pelcula secundarios de este clip de pelcula heredarn un sistema de coordenadas con un giro de 90 en sentido contrario al de las agujas del reloj. Las coordenadas del clip de pelcula hacen referencia a la posicin del punto de registro. Disponibilidad Flash Lite 2.0 Vase tambin
_x (MovieClip._x, propiedad), _xscale (propiedad MovieClip._xscale), _yscale (propiedad MovieClip._yscale)
_ymouse (propiedad MovieClip._ymouse)

Indica la coordenada y de la posicin del ratn. Nota: esta propiedad se admite en Flash Lite slo si System.capabilities.hasMouse es true o System.capabilities.hasStylus es true. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente devuelve las coordenadas x e y actuales del ratn en el escenario (_level0) y con respecto a un clip de pelcula del escenario llamado my_mc.
this.createTextField("mouse_txt", this.getNextHighestDepth(), 0, 0, 150, 66); mouse_txt.html = true; mouse_txt.multiline = true; var row1_str:String = " \t_xmouse\t_ymouse"; my_mc.onMouseMove = function() { mouse_txt.htmlText = "<textformat tabStops='[50,100]'>"; mouse_txt.htmlText += row1_str; mouse_txt.htmlText += "_level0\t"+_xmouse+"\t"+_ymouse; mouse_txt.htmlText += "my_mc\t"+this._xmouse+"\t"+this._ymouse; mouse_txt.htmlText += "</textformat>"; };
Vase tambin
hasMouse (propiedad capabilities.hasMouse), _xmouse (propiedad MovieClip._xmouse)
_yscale (propiedad MovieClip._yscale)

Establece la escala vertical (percentage) del clip de pelcula aplicada desde el punto de registro del clip de pelcula. El punto de registro predeterminado es (0,0).

La escala del sistema de coordenadas local afecta a la configuracin de las propiedades de _x e _y, que se definen en pxeles completos. Por ejemplo, si se aplica una escala del 50% al clip de pelcula principal, la configuracin de la propiedad _x desplazar un objeto situado en el clip de pelcula la mitad de pxeles que si la pelcula tuviera una escala del 100%. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un clip de pelcula denominado box_mc en tiempo de ejecucin. La API de dibujo se utiliza para dibujar un recuadro en esta instancia y, cuando el ratn se desplaza sobre el recuadro, se aplica un cambio de escala horizontal y vertical al clip de pelcula. Cuando el ratn se desplaza fuera de la instancia, sta recupera la escala anterior.
this.createEmptyMovieClip("box_mc", 1); box_mc._x = 100; box_mc._y = 100; with (box_mc) { lineStyle(1, 0xCCCCCC); beginFill(0xEEEEEE); moveTo(0, 0); lineTo(80, 0); lineTo(80, 60); lineTo(0, 60); lineTo(0, 0); endFill(); }; box_mc.onRollOver = function() { this._x -= this._width/2; this._y -= this._height/2; this._xscale = 200; this._yscale = 200; }; box_mc.onRollOut = function() { this._xscale = 100; this._yscale = 100; this._x += this._width/2; this._y += this._height/2; };
Vase tambin
_x (MovieClip._x, propiedad), _xscale (propiedad MovieClip._xscale), _y (propiedad MovieClip._y, propiedad), _height (propiedad MovieClip._height)
MovieClipLoader
Object | +-MovieClipLoader public class MovieClipLoader extends Object

La clase MovieClipLoader permite implementar funciones callback de detector que proporcionan informacin de estado mientras se cargan (descargan) archivos SWF, JPEG, GIF o PNG en clips de pelcula. Para utilizar las funciones de MovieClipLoader, utilice MovieClipLoader.loadClip() en lugar de loadMovie() o MovieClip.loadMovie() para cargar archivos SWF. Una vez que enve el mtodo MovieClipLoader.loadClip(), tendrn lugar los siguientes eventos en el orden en que se enumeran:
Cuando se hayan grabado en el disco duro los primeros bytes del archivo descargado, se invocar el detector
MovieClipLoader.onLoadStart.
Si ha implementado el detector MovieClipLoader.onLoadProgress, ste se invocar durante el proceso de carga. Nota: puede efectuar una llamada a MovieClipLoader.getProgress() en cualquier momento durante el proceso
de carga.
Cuando se hayan grabado en el disco duro los primeros bytes del archivo descargado, se invocar el detector
MovieClipLoader.onLoadComplete.
Una vez que se hayan ejecutado las acciones del primer fotograma del archivo descargado, se invocar el detector
MovieClipLoader.onLoadInit.
Una vez que se haya invocado MovieClipLoader.onLoadInit podr establecer propiedades, utilizar mtodos e interactuar con la pelcula descargada. Si el archivo no se carga completamente, se invocar el detector MovieClipLoader.onLoadError. Disponibilidad Flash Lite 2.0 Resumen de propiedades Propiedades heredadas de la clase Object
Resumen de eventos
Evento onLoadComplete = Descripcin Se invoca cuando un archivo cargado con MovieClipLoader.loadClip() se ha
function(listenerOb descargado completamente. ject, [target_mc]) {}
onLoadError =
Se invoca cuando un archivo cargado con MovieClipLoader.loadClip() no se
function(target_mc, carga correctamente. errorCode) {}

Evento
Descripcin
onLoadInit = Se invoca cuando se ejecutan las acciones del primer fotograma del clip cargado. function([target_mc ]) {} onLoadProgress = Se invoca cada vez que se graba en el disco duro el contenido durante el proceso de
function([target_mc carga (es decir, entre MovieClipLoader.onLoadStart y ], loadedBytes, MovieClipLoader.onLoadComplete). totalBytes) {}
onLoadStart =
Se invoca cuando una llamada a MovieClipLoader.loadClip() ha iniciado function([target_mc correctamente la descarga de un archivo. ]) {}
Firma MovieClipLoader() Descripcin Crea un objeto MovieClipLoader que se puede utilizar para implementar una serie de detectores que respondan a eventos mientras se descarga un archivo SWF, JPEG, GIF o PNG.
Resumen de mtodos
Modificadores Firma addListener(listener: Object) : Boolean Descripcin Registra un objeto para recibir notificacin de la invocacin de un controlador de eventos MovieClipLoader.
getProgress(target:Obj Devuelve el nmero de bytes cargados y el nmero total de bytes de un archivo que se est cargando mediante ect) : Object MovieClipLoader.loadClip(); en el caso de pelculas comprimidas, el mtodo getProgress refleja el nmero de bytes comprimidos. loadClip(url:String, target:Object) : Boolean Carga un archivo SWF o JPEG en un clip de pelcula en Flash Lite Player mientras se reproduce el clip de pelcula original.
removeListener(listene Elimina el detector que se ha utilizado para recibir una r:Object) : Boolean notificacin de la invocacin del controlador de eventos MovieClipLoader. unloadClip(target:Obje Elimina un clip de pelcula que se ha cargado mediante MovieClipLoader.loadClip(). ct) : Boolean


public addListener(listener:Object) : Boolean
Registra un objeto para recibir notificacin de la invocacin de un controlador de eventos MovieClipLoader.

Disponibilidad Flash Lite 2.0 Parmetros listener:Object - Objeto que detecta una notificacin callback de los controladores de eventos MovieClipLoader. Valor devuelto Boolean - Valor booleano. El valor devuelto es true si el detector se ha establecido correctamente; de lo contrario, el valor devuelto es false. Ejemplo El ejemplo siguiente carga una imagen en un clip de pelcula llamado image_mc. La instancia de clip de pelcula se gira y se centra en el escenario, y se dibuja un trazo alrededor del permetro del escenario y del clip de pelcula.
this.createEmptyMovieClip("image_mc", this.getNextHighestDepth()); var mclListener:Object = new Object(); mclListener.onLoadInit = function(target_mc:MovieClip) { target_mc._x = Stage.width/2-target_mc._width/2; target_mc._y = Stage.height/2-target_mc._width/2; var w:Number = target_mc._width; var h:Number = target_mc._height; target_mc.lineStyle(4, 0x000000); target_mc.moveTo(0, 0); target_mc.lineTo(w, 0); target_mc.lineTo(w, h); target_mc.lineTo(0, h); target_mc.lineTo(0, 0); target_mc._rotation = 3; }; var image_mcl:MovieClipLoader = new MovieClipLoader(); image_mcl.addListener(mclListener); image_mcl.loadClip("http://www.helpexamples.com/flash/images/image1.jpg", image_mc);
Vase tambin
onLoadComplete (detector de eventos MovieClipLoader.onLoadComplete), onLoadError (detector de eventos MovieClipLoader.onLoadError), onLoadInit (detector de eventos MovieClipLoader.onLoadInit), onLoadProgress (detector de eventos MovieClipLoader.onLoadProgress), onLoadStart (detector de eventos MovieClipLoader.onLoadStart), removeListener (mtodo MovieClipLoader.removeListener)
getProgress (mtodo MovieClipLoader.getProgress)

public getProgress(target:Object) : Object
Devuelve el nmero de bytes cargados y el nmero total de bytes de un archivo que se est cargando mediante MovieClipLoader.loadClip(); en el caso de pelculas comprimidas, el mtodo getProgress refleja el nmero de bytes comprimidos. El mtodo getProgress permite solicitar explcitamente esta informacin en lugar de (o adems de) escribir una funcin de detector MovieClipLoader.onLoadProgress. Disponibilidad Flash Lite 2.0

Parmetros target:Object - Archivo SWF, JPEG, GIF o PNG que se carga mediante MovieClipLoader.loadClip(). Valor devuelto Object - Objeto que dispone de dos propiedades de enteros: bytesLoaded y bytesTotal. Ejemplo El ejemplo siguiente muestra el uso del mtodo getProgress. En lugar de utilizar este mtodo, normalmente se crea un objeto detector para el evento onLoadProgress. Otra observacin importante sobre este mtodo es que la primera llamada sincronizada a getProgress puede devolver bytesLoaded y bytesTotal del contenedor y no los valores del objeto solicitado externamente.
var container:MovieClip = this.createEmptyMovieClip("container", this.getNextHighestDepth()); var image:MovieClip = container.createEmptyMovieClip("image", container.getNextHighestDepth()); var mcLoader:MovieClipLoader = new MovieClipLoader(); var listener:Object = new Object(); listener.onLoadProgress = function(target:MovieClip, bytesLoaded:Number, bytesTotal:Number):Void { trace(target + ".onLoadProgress with " + bytesLoaded + " bytes of " + bytesTotal); } mcLoader.addListener(listener); mcLoader.loadClip("http://www.w3.org/Icons/w3c_main.png", image); var interval:Object = new Object(); interval.id = setInterval(checkProgress, 100, mcLoader, image, interval); function checkProgress(mcLoader:MovieClipLoader, image:MovieClip, interval:Object):Void { trace(">> checking progress now with : " + interval.id); var progress:Object = mcLoader.getProgress(image); trace("bytesLoaded: " + progress.bytesLoaded + " bytesTotal: " + progress.bytesTotal); if(progress.bytesLoaded == progress.bytesTotal) { clearInterval(interval.id); } }
Vase tambin
loadClip (mtodo MovieClipLoader.loadClip), onLoadProgress (detector de eventos MovieClipLoader.onLoadProgress)
loadClip (mtodo MovieClipLoader.loadClip)

public loadClip(url:String, target:Object) : Boolean
Carga un archivo SWF o JPEG en un clip de pelcula en Flash Lite Player mientras se reproduce el clip de pelcula original. Mediante este mtodo es posible mostrar varios archivos SWF a la vez y cambiar entre archivos SWF sin cargar otro documento HTML. La utilizacin del mtodo loadClip() en lugar de loadMovie() o MovieClip.loadMovie() ofrece diversas ventajas. Los siguientes controladores se implementan mediante el uso de un objeto detector. Active el detector utilizando MovieClipLoader.addListener(listenerObject) para registrarlo con la clase MovieClipLoader.
El controlador MovieClipLoader.onLoadStart se invoca cuando comienza la carga. El controlador MovieClipLoader.onLoadError se invoca si no es posible cargar el clip.

El controlador MovieClipLoader.onLoadProgress se invoca mientras progresa el proceso de carga. El controlador MovieClipLoader.onLoadComplete se invoca cuando finaliza la descarga de un archivo, pero
antes de que estn disponibles los mtodos y propiedades del clip de pelcula cargado. Se llama a este controlador antes que al controlador onLoadInit.
El controlador MovieClipLoader.onLoadInit se invoca despus de que se hayan ejecutado las acciones del
primer fotograma del clip para que pueda manipular el clip cargado. Se llama a este controlador antes que al controlador onLoadComplete. En la mayora de los casos, utilice el controlador onLoadInit. Un archivo SWF o imagen cargada en un clip de pelcula hereda las propiedades de posicin, giro y escala del clip de pelcula. Puede utilizar la ruta de destino del clip de pelcula para emplear como destino la pelcula cargada. Puede utilizar el mtodo loadClip() para cargar uno o varios archivos en un solo clip de pelcula o nivel; los objetos detectores MovieClipLoader se pasan a la instancia de clip de pelcula de destino que se est cargando como parmetro. Como alternativa, puede crear un objeto MovieClipLoader diferente para cada archivo que cargue. Utilice MovieClipLoader.unloadClip() para eliminar pelculas o imgenes cargadas con este mtodo o cancelar una operacin de carga que se encuentra en curso.
MovieClipLoader.getProgress() y MovieClipLoaderListener.onLoadProgress no informan de los valores reales de bytesLoaded y bytesTotal en el reproductor de edicin si los archivos son locales. Si utiliza la funcin Visor de anchos de banda del entorno de edicin, MovieClipLoader.getProgress() y MovieClipLoaderListener.onLoadProgress informarn de la descarga con la velocidad de descarga real, no con la velocidad de ancho de banda reducido que ofrece el Visor de anchos de banda.
Disponibilidad Flash Lite 2.0 Parmetros url:String - URL absoluta o relativa 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:///. Los nombres de archivo no pueden incluir especificaciones de unidad de disco. target:Object - Ruta de destino de un clip de pelcula, o entero que especifica el nivel de Flash Lite Player en el que se cargar la pelcula. El clip de pelcula de destino se sustituye por el archivo SWF o la imagen que se carga. Valor devuelto Boolean - Valor booleano. El valor devuelto es true si la solicitud de URL se ha enviado correctamente; de lo contrario, el valor devuelto es false. Ejemplo Los ejemplos siguientes muestran cmo utilizar el mtodo MovieClipLoader.loadClip creando un controlador para el evento onLoadInit y realizando a continuacin la peticin. El siguiente cdigo debe situarse directamente en una accin de fotograma en una lnea de tiempo o pegarse en una clase que ample MovieClip. Cree un mtodo detector para el evento onLoadInit.
public function onLoadInit(mc:MovieClip):Void { trace("onLoadInit: " + mc); }
Cree un MovieClip vaco y utilice MovieClipLoader para cargar una imagen.

var container:MovieClip = createEmptyMovieClip("container", getNextHighestDepth()); var mcLoader:MovieClipLoader = new MovieClipLoader(); mcLoader.addListener(this); mcLoader.loadClip("YourImage.jpg", container); function onLoadInit(mc:MovieClip) { trace("onLoadInit: " + mc); }
Vase tambin
onLoadInit (detector de eventos MovieClipLoader.onLoadInit)
Constructor MovieClipLoader
public MovieClipLoader()
Crea un objeto MovieClipLoader que se puede utilizar para implementar una serie de detectores que respondan a eventos mientras se descarga un archivo SWF, JPEG, GIF o PNG. Disponibilidad Flash Lite 2.0 Ejemplo Consulte MovieClipLoader.loadClip(). Vase tambin
addListener (mtodo MovieClipLoader.addListener), loadClip (mtodo MovieClipLoader.loadClip)
onLoadComplete (detector de eventos MovieClipLoader.onLoadComplete)

onLoadComplete = function(listenerObject, [target_mc]) {}
Se invoca cuando un archivo cargado con MovieClipLoader.loadClip() se ha descargado completamente. El valor de target_mc identifica al clip de pelcula para el que se ha realizado esta llamada. Esto resulta til si se estn cargando varios archivos con el mismo conjunto de detectores. Flash pasa este parmetro al cdigo, aunque no es necesario implementar todos los parmetros de la funcin de detector. Cuando utilice los eventos onLoadComplete y onLoadInit con la clase MovieClipLoader, es importante entender la diferencia que existe al funcionar con el archivo SWF. La llamada al evento onLoadComplete se produce despus de que se cargue el archivo SWF o JPEG, pero antes de que la aplicacin se haya inicializado. En este momento no se puede acceder a las propiedades y mtodos del clip de pelcula cargado y, por ello, no se puede llamar a una funcin, desplazarse a un fotograma especfico, etc. En la mayora de los casos, es preferible utilizar el evento onLoadInit, al que se llama despus de que el contenido se haya cargado y est totalmente inicializado. Disponibilidad Flash Lite 2.0 Parmetros listenerObject: - Objeto detector aadido con MovieClipLoader.addListener().

target_mc: [opcional] - Clip de pelcula cargado por un mtodo MovieClipLoader.loadClip(). Este parmetro es opcional. Ejemplo El ejemplo siguiente carga una imagen en una instancia de clip de pelcula denominada image_mc. Los eventos onLoadInit y onLoadComplete se utilizan para determinar el tiempo que tarda en cargarse la imagen. La informacin se muestra en un campo de texto creado dinmicamente llamado timer_txt.
this.createEmptyMovieClip("image_mc", this.getNextHighestDepth()); var mclListener:Object = new Object(); mclListener.onLoadStart = function(target_mc:MovieClip) { target_mc.startTimer = getTimer(); }; mclListener.onLoadComplete = function(target_mc:MovieClip) { target_mc.completeTimer = getTimer(); }; mclListener.onLoadInit = function(target_mc:MovieClip) { var timerMS:Number = target_mc.completeTimer-target_mc.startTimer; target_mc.createTextField("timer_txt", target_mc.getNextHighestDepth(), 0, target_mc._height, target_mc._width, 22); target_mc.timer_txt.text = "loaded in "+timerMS+" ms."; }; var image_mcl:MovieClipLoader = new MovieClipLoader(); image_mcl.addListener(mclListener); image_mcl.loadClip("http://www.macromedia.com/images/shared/product_boxes/112x112/box_studio _112x112.jpg", image_mc);
Vase tambin
addListener (mtodo MovieClipLoader.addListener), loadClip (mtodo MovieClipLoader.loadClip), onLoadStart (detector de eventos MovieClipLoader.onLoadStart), onLoadError (detector de eventos MovieClipLoader.onLoadError), onLoadInit (detector de eventos MovieClipLoader.onLoadInit)
onLoadError (detector de eventos MovieClipLoader.onLoadError)

onLoadError = function(target_mc, errorCode) {}
Se invoca cuando un archivo cargado con MovieClipLoader.loadClip() no se carga correctamente. Este detector se puede invocar por varios motivos (incluido si el servidor no funciona) si no se puede localizar el archivo o se produce un problema de seguridad. Realice una llamada a este detector sobre un objeto agregado con MovieClipLoader.addListener(). El valor de target_mc identifica al clip de pelcula para el que se ha realizado esta llamada. Este parmetro es til cuando se cargan varios archivos con el mismo conjunto de detectores. En el caso del parmetro errorCode, se devuelve la cadena "URLNotFound" si no se ha realizado ninguna llamada a los detectores MovieClipLoader.onLoadStart o MovieClipLoader.onLoadComplete; por ejemplo, si el servidor no funciona, no se puede localizar el archivo. Se devuelve la cadena "LoadNeverCompleted" si se llam a MovieClipLoader.onLoadStart sin realizar una llamada a MovieClipLoader.onLoadComplete por ejemplo, si se interrumpi la descarga debido una sobrecarga o una cada del servidor, etc. Disponibilidad Flash Lite 2.0

Parmetros target_mc: - Clip de pelcula cargado por un mtodo MovieClipLoader.loadClip(). errorCode: - Una cadena que explica el motivo del fallo. Ejemplo El ejemplo siguiente muestra informacin en el panel Salida cuando se produce un error al cargar la imagen.
this.createEmptyMovieClip("image_mc", this.getNextHighestDepth()); var mclListener:Object = new Object(); mclListener.onLoadError = function(target_mc:MovieClip, errorCode:String) { trace("ERROR!"); switch (errorCode) { case 'URLNotFound' : trace("\t Unable to connect to URL: "+target_mc._url); break; case 'LoadNeverCompleted' : trace("\t Unable to complete download: "+target_mc); break; } }; mclListener.onLoadInit = function(target_mc:MovieClip) { trace("success"); trace(image_mcl.getProgress(target_mc).bytesTotal+" bytes loaded"); }; var image_mcl:MovieClipLoader = new MovieClipLoader(); image_mcl.addListener(mclListener); image_mcl.loadClip("http://www.fakedomain.com/images/bad_hair_day.jpg", image_mc);
Vase tambin
addListener (mtodo MovieClipLoader.addListener), loadClip (mtodo MovieClipLoader.loadClip), onLoadStart (detector de eventos MovieClipLoader.onLoadStart), onLoadComplete (detector de eventos MovieClipLoader.onLoadComplete)
onLoadInit (detector de eventos MovieClipLoader.onLoadInit)

onLoadInit = function([target_mc]) {}
Se invoca cuando se ejecutan las acciones del primer fotograma del clip cargado. Una vez que se haya invocado este detector, podr establecer propiedades, utilizar mtodos e interactuar con la pelcula descargada. Realice una llamada a este detector sobre un objeto agregado con MovieClipLoader.addListener(). El valor de target_mc identifica al clip de pelcula para el que se ha realizado esta llamada. Este parmetro es til cuando se cargan varios archivos con el mismo conjunto de detectores. Disponibilidad Flash Lite 2.0 Parmetros target_mc: [opcional] - Clip de pelcula cargado por un mtodo MovieClipLoader.loadClip().

Ejemplo El ejemplo siguiente carga una imagen en una instancia de clip de pelcula denominada image_mc. Los eventos onLoadInit y onLoadComplete se utilizan para determinar el tiempo que tarda en cargarse la imagen. La informacin se muestra en un campo de texto llamado timer_txt.
this.createEmptyMovieClip("image_mc", this.getNextHighestDepth()); var mclListener:Object = new Object(); mclListener.onLoadStart = function(target_mc:MovieClip) { target_mc.startTimer = getTimer(); }; mclListener.onLoadComplete = function(target_mc:MovieClip) { target_mc.completeTimer = getTimer(); }; mclListener.onLoadInit = function(target_mc:MovieClip) { var timerMS:Number = target_mc.completeTimer-target_mc.startTimer; target_mc.createTextField("timer_txt", target_mc.getNextHighestDepth(), 0, target_mc._height, target_mc._width, 22); target_mc.timer_txt.text = "loaded in "+timerMS+" ms."; }; var image_mcl:MovieClipLoader = new MovieClipLoader(); image_mcl.addListener(mclListener); image_mcl.loadClip("http://www.helpexamples.com/flash/images/image1.jpg", image_mc);
El ejemplo siguiente comprueba si se ha cargado una pelcula en un clip de pelcula creado en tiempo de ejecucin:
this.createEmptyMovieClip("tester_mc", 1); var mclListener:Object = new Object(); mclListener.onLoadInit = function(target_mc:MovieClip) { trace("movie loaded"); } var image_mcl:MovieClipLoader = new MovieClipLoader(); image_mcl.addListener(mclListener); image_mcl.loadClip("http://www.yourserver.com/your_movie.swf", tester_mc);
Vase tambin
addListener (mtodo MovieClipLoader.addListener), loadClip (mtodo MovieClipLoader.loadClip), onLoadStart (detector de eventos MovieClipLoader.onLoadStart)
onLoadProgress (detector de eventos MovieClipLoader.onLoadProgress)

onLoadProgress = function([target_mc], loadedBytes, totalBytes) {}
Se invoca cada vez que se graba en el disco duro el contenido durante el proceso de carga (es decir, entre MovieClipLoader.onLoadStart y MovieClipLoader.onLoadComplete). Realice una llamada a este detector sobre un objeto agregado con MovieClipLoader.addListener(). Puede utilizar este mtodo para mostrar informacin sobre el progreso de la descarga utilizando los parmetros loadedBytes y totalBytes. El valor de target_mc identifica al clip de pelcula para el que se ha realizado esta llamada. Esto resulta til si se estn cargando varios archivos con el mismo conjunto de detectores. Nota: si intenta utilizar onLoadProgress en modo de prueba de pelcula con un archivo local que se encuentre en el disco duro, no funcionar correctamente porque, en dicho modo, Flash Lite Player carga los archivos locales ntegramente.

Parmetros
target_mc: MovieClip [opcional] - Clip de pelcula cargado por un mtodo MovieClipLoader.loadClip(). loadedBytes: Number El nmero de bytes que se haban cargado al invocar al detector. totalBytes: Number El nmero total de bytes del archivo que se est cargando.
Disponibilidad Flash Lite 2.0 Parmetros target_mc: [opcional] - Clip de pelcula cargado por un mtodo MovieClipLoader.loadClip(). loadedBytes: - El nmero de bytes que se haban cargado al invocar al detector. totalBytes: - El nmero total de bytes del archivo que se est cargando. Ejemplo El ejemplo siguiente crea un clip de pelcula, un nuevo MovieClipLoader y un detector de eventos annimo. Deber mostrar, de forma peridica, el progreso de un proceso de carga y notificar cundo ha finalizado la carga y el recurso queda disponible para ActionScript.
var container:MovieClip = this.createEmptyMovieClip("container", this.getNextHighestDepth()); var mcLoader:MovieClipLoader = new MovieClipLoader(); var listener:Object = new Object(); listener.onLoadProgress = function(target:MovieClip, bytesLoaded:Number, bytesTotal:Number):Void { trace(target + ".onLoadProgress with " + bytesLoaded + " bytes of " + bytesTotal); } listener.onLoadInit = function(target:MovieClip):Void { trace(target + ".onLoadInit"); } mcLoader.addListener(listener); mcLoader.loadClip("http://www.w3.org/Icons/w3c_main.png", container);
Vase tambin
addListener (mtodo MovieClipLoader.addListener), loadClip (mtodo MovieClipLoader.loadClip), getProgress (mtodo MovieClipLoader.getProgress)
onLoadStart (detector de eventos MovieClipLoader.onLoadStart)

onLoadStart = function([target_mc]) {}
Se invoca cuando una llamada a MovieClipLoader.loadClip() ha iniciado correctamente la descarga de un archivo. Realice una llamada a este detector sobre un objeto agregado con MovieClipLoader.addListener(). El valor de target_mc identifica al clip de pelcula para el que se ha realizado esta llamada. Este parmetro es til cuando se cargan varios archivos con el mismo conjunto de detectores. Disponibilidad Flash Lite 2.0 Parmetros target_mc: [opcional] - Clip de pelcula cargado por un mtodo MovieClipLoader.loadClip().

Ejemplo El ejemplo siguiente carga una imagen en una instancia de clip de pelcula denominada image_mc. Los eventos onLoadInit y onLoadComplete se utilizan para determinar el tiempo que tarda en cargarse la imagen. La informacin se muestra en un campo de texto llamado timer_txt.
this.createEmptyMovieClip("image_mc", this.getNextHighestDepth()); var mclListener:Object = new Object(); mclListener.onLoadStart = function(target_mc:MovieClip) { target_mc.startTimer = getTimer(); }; mclListener.onLoadComplete = function(target_mc:MovieClip) { target_mc.completeTimer = getTimer(); }; mclListener.onLoadInit = function(target_mc:MovieClip) { var timerMS:Number = target_mc.completeTimer-target_mc.startTimer; target_mc.createTextField("timer_txt", target_mc.getNextHighestDepth(), 0, target_mc._height, target_mc._width, 22); target_mc.timer_txt.text = "loaded in "+timerMS+" ms."; }; var image_mcl:MovieClipLoader = new MovieClipLoader(); image_mcl.addListener(mclListener); image_mcl.loadClip("http://www.helpexamples.com/flash/images/image1.jpg", image_mc);
Vase tambin
addListener (mtodo MovieClipLoader.addListener), loadClip (mtodo MovieClipLoader.loadClip), onLoadError (detector de eventos MovieClipLoader.onLoadError), onLoadInit (detector de eventos MovieClipLoader.onLoadInit)onLoadComplete (detector de eventos MovieClipLoader.onLoadComplete)
removeListener (mtodo MovieClipLoader.removeListener)

public removeListener(listener:Object) : Boolean
Elimina el detector que se ha utilizado para recibir una notificacin de la invocacin del controlador de eventos MovieClipLoader. No se recibirn ms mensajes de carga. Disponibilidad Flash Lite 2.0 Parmetros listener:Object - Objeto detector aadido con MovieClipLoader.addListener(). Valor devuelto Boolean Ejemplo El ejemplo siguiente carga una imagen en un clip de pelcula y permite al usuario iniciar y detener el proceso de carga mediante dos botones llamados start_button y stop_button. Cuando el usuario inicia o detiene el proceso, se muestra informacin en el panel Salida.

this.createEmptyMovieClip("image_mc", this.getNextHighestDepth()); var mclListener:Object = new Object(); mclListener.onLoadStart = function(target_mc:MovieClip) { trace("\t onLoadStart"); }; mclListener.onLoadComplete = function(target_mc:MovieClip) { trace("\t onLoadComplete"); }; mclListener.onLoadError = function(target_mc:MovieClip, errorCode:String) { trace("\t onLoadError: "+errorCode); }; mclListener.onLoadInit = function(target_mc:MovieClip) { trace("\t onLoadInit"); start_button.enabled = true; stop_button.enabled = false; }; var image_mcl:MovieClipLoader = new MovieClipLoader(); // start_button.clickHandler = function() { trace("Starting..."); start_button.enabled = false; stop_button.enabled = true; // image_mcl.addListener(mclListener); image_mcl.loadClip("http://www.helpexamples.com/flash/images/image1.jpg", image_mc); }; stop_button.clickHandler = function() { trace("Stopping..."); start_button.enabled = true; stop_button.enabled = false; // image_mcl.removeListener(mclListener); }; stop_button.enabled = false;
Vase tambin
unloadClip (mtodo MovieClipLoader.unloadClip)

public unloadClip(target:Object) : Boolean
Elimina un clip de pelcula que se ha cargado mediante MovieClipLoader.loadClip(). Si enva este mtodo mientras se est cargando una pelcula, se invocar MovieClipLoader.onLoadError. Disponibilidad Flash Lite 2.0 Parmetros target:Object - Cadena o entero que se pasa a la llamada correspondiente a my_mcl.loadClip(). Valor devuelto Boolean -

Ejemplo El ejemplo siguiente carga una imagen en un clip de pelcula llamado image_mc. Si hace clic en el clip de pelcula, ste se elimina y se muestra informacin en el panel Salida.
this.createEmptyMovieClip("image_mc", this.getNextHighestDepth()); var mclListener:Object = new Object(); mclListener.onLoadInit = function(target_mc:MovieClip) { target_mc._x = 100; target_mc._y = 100; target_mc.onRelease = function() { trace("Unloading clip..."); trace("\t name: "+target_mc._name); trace("\t url: "+target_mc._url); image_mcl.unloadClip(target_mc); }; }; var image_mcl:MovieClipLoader = new MovieClipLoader(); image_mcl.addListener(mclListener); image_mcl.loadClip("http://www.helpexamples.com/flash/images/image1.jpg", image_mc);
Vase tambin
loadClip (mtodo MovieClipLoader.loadClip), onLoadError (detector de eventos MovieClipLoader.onLoadError)
NetConnection
Crea un objeto NetConnection que se puede utilizar con un objeto NetStream para invocar comandos en un servidor remoto de aplicaciones para reproducir archivos de vdeo sin interrupcin (FLV) localmente o desde un servidor.
Mtodo
connect();
Descripcin
connect(command:String, ... arguments):void
Abre una conexin con un servidor.

close(); close():void
Cierra la conexin abierta localmente o con el servidor y distribuye el evento netStatus con una propiedad code de NetConnection.Connect.Close.
connect (mtodo NetConnection.connect)

Abre una conexin con un servidor. A travs de esta conexin, se pueden reproducir archivos de audio o de vdeo (FLV) desde el sistema de archivos local o se pueden invocar comandos en un servidor remoto. Cuando utilice este mtodo, tenga en cuenta el modelo de seguridad de Flash Lite Player y las siguientes consideraciones sobre seguridad:
De manera predeterminada, el sitio Web deniega el acceso entre entornos limitados. El sitio Web puede activar el
acceso a un recurso utilizando un archivo de poltica para distintos dominios.

Un sitio Web puede denegar el acceso a un recurso aadiendo lgica de aplicacin ActionScript del lado del
servidor en Flash Media Server.
No se puede utilizar el mtodo NetConnection.connect() si el archivo SWF que realiza la llamada se encuentra
en el entorno limitado local con sistema de archivos.
Se puede evitar que un archivo SWF utilice este mtodo estableciendo el parmetro allowNetworking del objeto
e incorporar etiquetas en la pgina HTML que tiene el contenido SWF. Disponibilidad Flash Lite 3.0
close (mtodo NetConnection.close)

public function close():void
Cierra la conexin abierta localmente o con el servidor y distribuye el evento netStatus con una propiedad code de NetConnection.Connect.Close. Este mtodo desconecta todos los objetos NetStream que se ejecuten a travs de esta conexin; los datos puestos en cola que no se hayan enviado se descartarn. (Para terminar los flujos sin cerrar la conexin, utilice NetStream.close()). Si llama a este mtodo y, a continuacin, desea volver a conectar, debe volver a crear el objeto NetStream. Disponibilidad Flash Lite 3.0 Vase tambin NetStream
Constructor NetConnection
public NetConnection en la pgina 482()
Crea un objeto NetConnection que se puede utilizar con un objeto NetStream para reproducir archivos de flujo de vdeo (FLV). Tras crear el objeto NetConnection, utilice el mtodo Connect(NetConnection.connect) para establecer la conexin en s. La reproduccin de archivos FLV externos ofrece varias ventajas frente a la incorporacin de vdeo en un documento de Flash, como por ejemplo mejor rendimiento y administracin de la memoria y velocidades de fotogramas de vdeo y Flash independientes. La clase NetConnection proporciona los medios para reproducir archivos FLV de flujo desde una unidad local o desde una direccin HTTP. Disponibilidad Flash Lite 3.0 Ejemplo Consulte el ejemplo del mtodo connect (NetConnection.connect). Vase tambin connect (mtodo NetConnection.connect) en la pgina 482, attachVideo (mtodo Video.attachVideo) en la pgina 678,NetStream en la pgina 484

NetStream
Crea un flujo que puede utilizarse para reproducir archivos FLV a travs del objeto NetConnection especificado. Tambin se admiten las URL de archivos locales con slo reemplazar http: por file:. Por ejemplo:
NetStream.play("http://somefile.flv"); NetStream.play("file://somefile.flv");
Nota: Se aplican restricciones estndar de seguridad. Por ejemplo, un archivo SWF remoto no puede acceder a las URL file:// absolutas con el formato "file://C:/somefile.flv". Disponibilidad Flash Lite 3.0 Mtodos de la clase NetStream
Mtodo
close()
Descripcin
close():void
Detiene la reproduccin de todos los datos del flujo, establece la propiedad time con el valor 0 y pone el flujo a disposicin de otro usuario.
pause() pause():void
Hace una pausa en la reproduccin de un flujo de vdeo.

play() play(... arguments):void
Comienza la reproduccin de un archivo de audio o vdeo externo (FLV).

seek()
Busca el fotograma clave ms cercano al nmero de segundos especificado desde el comienzo del flujo. Especifica el tiempo que deben almacenarse los mensajes en el bfer antes de comenzar a mostrarlos.
setBufferTime()
Propiedades de la clase NetStream

Propiedades
bufferLength bufferTime bytesLoaded bytesTotal currentFPS time
Descripcin Nmero de segundos de datos almacenados actualmente en el bfer. El nmero de segundos asignados al bfer por setBufferTime(). El nmero de bytes de datos que se han cargado en el reproductor. Tamao total en bytes del archivo que se est cargando en el reproductor. El nmero de fotogramas por segundo que se muestran. La posicin, en segundos, de la cabeza lectora.

Eventos de la clase NetStream

Evento
onStatus onCuePoint
Descripcin Se invoca cuando se publica un cambio de estado o error para el objeto NetStream. Se invoca cuando se alcanza un punto de referencia incorporado durante la reproduccin de un FLV. Se invoca cuando Flash Lite Player recibe la informacin descriptiva incorporada en el archivo FLV.
OnMetaData
bufferLength (propiedad NetStream.bufferLength)

public bufferLength : Number [read-only]
Nmero de segundos de datos almacenados actualmente en el bfer. Puede utilizar esta propiedad conjuntamente con NetStream.bufferTime para estimar cunto le falta al bfer para llenarse (por ejemplo, para mostrar informacin al usuario que est esperando a que los datos se carguen en el bfer). Disponibilidad Flash Lite 3.0 Nota: esta propiedad tambin es compatible con Flash Player 6 cuando se utiliza con Flash Media Server. Para obtener ms informacin, consulte la documentacin de Flash Media Server. Ejemplo El ejemplo siguiente crea de forma dinmica un campo de texto que muestra informacin sobre el nmero de segundos que hay actualmente en el bfer. El campo de texto muestra tambin la longitud del bfer definida para el vdeo, as como el porcentaje del bfer que est lleno.
this.createTextField("buffer_txt", this.getNextHighestDepth(), 10, 10, 300, 22); buffer_txt.html = true; var connection_nc:NetConnection = new NetConnection(); connection_nc.connect(null); var stream_ns:NetStream = new NetStream(connection_nc); stream_ns.setBufferTime(3); my_video.attachVideo(stream_ns); stream_ns.play("video1.flv"); var buffer_interval:Number = setInterval(checkBufferTime, 100, stream_ns); function checkBufferTime(my_ns:NetStream):Void { var bufferPct:Number = Math.min(Math.round(my_ns.bufferLength/my_ns.bufferTime*100), 100); var output_str:String = "<textformat tabStops='[100,200]'>"; output_str += "Length: "+my_ns.bufferLength+"\t"+"Time: "+my_ns.bufferTime+"\t"+"Buffer:"+bufferPct+"%"; output_str += "</textformat>"; buffer_txt.htmlText = output_str; }
bufferTime (propiedad NetStream.bufferTime)

public bufferTime : Number [read-only]

El nmero de segundos asignados al bfer por NetStream.setBufferTime(). El valor predeterminado es 0,1 (una dcima de segundo). Para determinar el nmero de segundos que hay actualmente en el bfer, utilice NetStream.bufferLength. Disponibilidad Flash Lite 3.0 Nota: esta propiedad tambin es compatible con Flash Player 6 cuando se utiliza con Flash Media Server. Para obtener ms informacin, consulte la documentacin de Flash Media Server. Ejemplo El ejemplo siguiente crea de forma dinmica un campo de texto que muestra informacin sobre el nmero de segundos que hay actualmente en el bfer. El campo de texto muestra tambin la longitud del bfer definida para el vdeo, as como el porcentaje del bfer que est lleno.
this.createTextField("buffer_txt", this.getNextHighestDepth(), 10, 10, 300, 22); buffer_txt.html = true; var connection_nc:NetConnection = new NetConnection(); connection_nc.connect(null); var stream_ns:NetStream = new NetStream(connection_nc); stream_ns.setBufferTime(3); my_video.attachVideo(stream_ns); stream_ns.play("video1.flv"); var buffer_interval:Number = setInterval(checkBufferTime, 100, stream_ns); function checkBufferTime(my_ns:NetStream):Void { var bufferPct:Number = Math.min(Math.round(my_ns.bufferLength my_ns.bufferTime*100), 100); var output_str:String = "<textformat tabStops='[100,200]'>"; output_str += "Length: "+my_ns.bufferLength+"\t"+"Time: "+my_ns.bufferTime+"\t"+"Buffer:"+bufferPct+"%"; output_str += "</textformat>"; buffer_txt.htmlText = output_str; }
bytesLoaded (propiedad NetStream.bytesLoaded)

public bytesLoaded : Number [read-only]
El nmero de bytes de datos que se han cargado en el reproductor. Puede utilizar este mtodo conjuntamente con NetStream.bytesTotal para estimar cunto le falta al bfer para llenarse (por ejemplo, para mostrar informacin al usuario que est esperando a que los datos se carguen en el bfer). Disponibilidad Flash Lite 3.0 Ejemplo El ejemplo siguiente crea una barra de progreso utilizando la interfaz API de dibujo y las propiedades bytesLoaded y bytesTotal. La barra muestra el progreso de la carga de video1.flv en la instancia de objeto de vdeo llamada my_video. Asimismo se crea de forma dinmica un campo de texto llamado loaded_txt para ver informacin sobre el proceso de carga.

var connection_nc:NetConnection = new NetConnection(); connection_nc.connect(null); var stream_ns:NetStream = new NetStream(connection_nc); my_video.attachVideo(stream_ns); stream_ns.play("video1.flv"); this.createTextField("loaded_txt", this.getNextHighestDepth(), 10, 10, 160, 22); this.createEmptyMovieClip("progressBar_mc", this.getNextHighestDepth()); progressBar_mc.createEmptyMovieClip("bar_mc", progressBar_mc.getNextHighestDepth()); with (progressBar_mc.bar_mc) { beginFill(0xFF0000); moveTo(0, 0); lineTo(100, 0); lineTo(100, 10); lineTo(0, 10); lineTo(0, 0); endFill(); _xscale = 0; } progressBar_mc.createEmptyMovieClip("stroke_mc", progressBar_mc.getNextHighestDepth()); with (progressBar_mc.stroke_mc) { lineStyle(0, 0x000000); moveTo(0, 0); lineTo(100, 0); lineTo(100, 10); lineTo(0, 10); lineTo(0, 0); } var loaded_interval:Number = setInterval(checkBytesLoaded, 500, stream_ns); function checkBytesLoaded(my_ns:NetStream) { var pctLoaded:Number = Math.round(my_ns.bytesLoaded/my_ns.bytesTotal*100); loaded_txt.text = Math.round(my_ns.bytesLoaded/1000)+" of "+Math.round(my_ns.bytesTotal/1000)+" KB loaded ("+pctLoaded+"%)"; progressBar_mc.bar_mc._xscale = pctLoaded; if (pctLoaded>=100) { clearInterval(loaded_interval); } }
bytesTotal (propiedad NetStream.bytesTotal)

public bytesTotal : Number [read-only]
Tamao total en bytes del archivo que se est cargando en el reproductor. Disponibilidad Flash Lite 3.0 Ejemplo El ejemplo siguiente crea una barra de progreso utilizando la interfaz API de dibujo y las propiedades bytesLoaded y bytesTotal. La barra muestra el progreso de la carga de video1.flv en la instancia de objeto de vdeo llamada my_video. Asimismo se crea de forma dinmica un campo de texto llamado loaded_txt para ver informacin sobre el proceso de carga.

var connection_nc:NetConnection = new NetConnection(); connection_nc.connect(null); var stream_ns:NetStream = new NetStream(connection_nc); my_video.attachVideo(stream_ns); stream_ns.play("video1.flv"); this.createTextField("loaded_txt", this.getNextHighestDepth(), 10, 10, 160, 22); this.createEmptyMovieClip("progressBar_mc", this.getNextHighestDepth()); progressBar_mc.createEmptyMovieClip("bar_mc", progressBar_mc.getNextHighestDepth()); with (progressBar_mc.bar_mc) { beginFill(0xFF0000); moveTo(0, 0); lineTo(100, 0); lineTo(100, 10); lineTo(0, 10); lineTo(0, 0); endFill(); _xscale = 0; } progressBar_mc.createEmptyMovieClip("stroke_mc", progressBar_mc.getNextHighestDepth()); with (progressBar_mc.stroke_mc) { lineStyle(0, 0x000000); moveTo(0, 0); lineTo(100, 0); lineTo(100, 10); lineTo(0, 10); lineTo(0, 0); } var loaded_interval:Number = setInterval(checkBytesLoaded, 500, stream_ns); function checkBytesLoaded(my_ns:NetStream) { var pctLoaded:Number = Math.round(my_ns.bytesLoaded/my_ns.bytesTotal*100); loaded_txt.text = Math.round(my_ns.bytesLoaded/1000)+" of "+Math.round(my_ns.bytesTotal/1000)+" KB loaded ("+pctLoaded+"%)"; progressBar_mc.bar_mc._xscale = pctLoaded; if (pctLoaded>=100) { clearInterval(loaded_interval); } }
currentFps (propiedad NetStream.currentFps)

public currentFps : Number [read-only]
El nmero de fotogramas por segundo que se muestran. Si est exportando archivos FLV que van a reproducirse en diversos sistemas, puede comprobar este valor durante la realizacin de las pruebas para determinar la cantidad de compresin que debe aplicarse al exportar el archivo. Disponibilidad Flash Lite 3.0 Nota: esta propiedad tambin es compatible con Flash Player 6 cuando se utiliza con Flash Media Server. Para obtener ms informacin, consulte la documentacin de Flash Media Server.

Ejemplo El ejemplo siguiente crea un campo de texto que muestra el nmero actual de fotogramas por segundo que muestra video1.flv.
var connection_nc:NetConnection = new NetConnection(); connection_nc.connect(null); var stream_ns:NetStream = new NetStream(connection_nc); my_video.attachVideo(stream_ns); stream_ns.play("video1.flv"); this.createTextField("fps_txt", this.getNextHighestDepth(), 10, 10, 50, 22); fps_txt.autoSize = true; var fps_interval:Number = setInterval(displayFPS, 500, stream_ns); function displayFPS(my_ns:NetStream) { fps_txt.text = "currentFps (frames per second): "+Math.floor(my_ns.currentFps); } time (NetStream.time property)
constructor NetStream
public NetStream(connection:NetConnection en la pgina 482)
Crea un flujo que puede utilizarse para reproducir archivos FLV a travs del objeto NetConnection especificado. Nota: Esta clase tambin es compatible con Flash Player 6 cuando se utiliza con Flash Communication Server. Para obtener ms informacin, consulte la documentacin de Flash Communication Server. Parmetros connection:NetConnection: objeto NetConnection. Ejemplo El cdigo siguiente construye primero un nuevo objeto NetConnection, connection_nc, y lo usa para construir un nuevo objeto NetStream llamado stream_ns. Seleccione Nuevo vdeo en el men de opciones del panel
Biblioteca para crear una instancia de objeto de vdeo y asgnele el nombre de instancia my_video. var connection_nc:NetConnection = new NetConnection(); connection_nc.connect(null); var stream_ns:NetStream = new NetStream(connection_nc); my_video.attachVideo(stream_ns); stream_ns.play("video1.flv");
Vase tambin
NetConnection en la pgina 482, attachVideo (mtodo Video.attachVideo) en la pgina 678
time (propiedad NetStream.time)

public time : Number [read-only]
La posicin, en segundos, de la cabeza lectora. Disponibilidad Flash Lite 3.0

Nota: esta propiedad tambin es compatible con Flash Player 6 cuando se utiliza con Flash Media Server. Para obtener ms informacin, consulte la documentacin de Flash Media Server. Ejemplo El ejemplo siguiente muestra la posicin actual de la cabeza lectora en un campo de texto creado de forma dinmica llamado time_txt. Seleccione Nuevo vdeo en el men de opciones del panel Biblioteca para crear una instancia de objeto de vdeo y asgnele el nombre de instancia my_video. Cree un nuevo objeto de vdeo llamado my_video. Aada el siguiente cdigo ActionScript al archivo FLA o AS:
var connection_nc:NetConnection = new NetConnection(); connection_nc.connect(null); var stream_ns:NetStream = new NetStream(connection_nc); my_video.attachVideo(stream_ns); stream_ns.play("video1.flv"); // stream_ns.onStatus = function(infoObject:Object) { statusCode_txt.text = infoObject.code; }; this.createTextField("time_txt", this.getNextHighestDepth(), 10, 10, 100, 22); time_txt.text = "LOADING"; var time_interval:Number = setInterval(checkTime, 500, stream_ns); function checkTime(my_ns:NetStream) { var ns_seconds:Number = my_ns.time; var minutes:Number = Math.floor(ns_seconds/60); var seconds = Math.floor(ns_seconds%60); if (seconds<10) { seconds = "0"+seconds; } time_txt.text = minutes+":"+seconds; }
onStatus (controlador NetStream.onStatus)

Se invoca cada vez que se publica un cambio de estado o error para el objeto NetStream. Si desea responder a este controlador de eventos, deber crear una funcin que procese el objeto de informacin. El objeto de informacin tiene una propiedad code que contiene una cadena que describe el resultado del controlador onStatus, as como una propiedad level que contiene una cadena que puede indicar status o error. Los siguientes eventos le notifican cundo tienen lugar determinadas actividades NetStream.

Propiedad de cdigo
NetStream.Buffer.Empty
Propiedad de nivel status
Significado No se estn recibiendo datos con la velocidad suficiente para llenar el bfer. Se interrumpir el flujo hasta que se vuelva a llenar el bfer; en este momento se enviar un mensaje NetStream.Buffer.Full y se iniciar de nuevo la reproduccin del flujo. El bfer est lleno y va a comenzar la reproduccin del flujo. Se ha finalizado el envo de datos y se vaciar el bfer restante. Se ha iniciado la reproduccin. Se ha detenido la reproduccin. No se encuentra el archivo FLV pasado al mtodo play(). En el caso de vdeo descargado de forma progresiva, el usuario ha intentado buscar o reproducir ms all de los datos de vdeo descargados hasta ese momento o ms all del final del vdeo despus de haber descargado todo el archivo. La propiedad Error.message.details contiene un cdigo de tiempo que indica la ltima posicin vlida que puede buscar el usuario. Consulte la propiedad Error.message. La operacin de bsqueda ha finalizado.
NetStream.Buffer.Full
status
NetStream.Buffer.Flush
status
NetStream.Play.Start NetStream.Play.Stop NetStream.Play.StreamNotFound
status status status
NetStream.Seek.InvalidTime
error
NetStream.Seek.Notify
status
Si siempre aparecen errores relacionados con el bfer, deber intentar cambiar el bfer utilizando el mtodo NetStream.setBufferTime(). Disponibilidad Flash Lite 3.0 Parmetros infoObject:Object - Un parmetro definido de acuerdo con el mensaje de estado o el mensaje de error. Ejemplo El ejemplo siguiente muestra datos sobre el flujo en el panel Salida:
var connection_nc:NetConnection = new NetConnection(); connection_nc.connect(null); var stream_ns:NetStream = new NetStream(connection_nc); my_video.attachVideo(stream_ns); stream_ns.play("video1.flv"); stream_ns.onStatus = function(infoObject:Object) { trace("NetStream.onStatus called: ("+getTimer()+" ms)"); for (var prop in infoObject) { trace("\t"+prop+":\t"+infoObject[prop]); } trace(""); };

onCuePoint (controlador NetStream.onCuePoint)

onCuePoint = function(infoObject:Object) {}
Se invoca cuando se alcanza un punto de referencia incorporado durante la reproduccin de un archivo FLV. Puede utilizar este controlador para activar acciones en el cdigo cuando el vdeo alcance un punto de referencia especfico. Esto le permite sincronizar otras acciones de su aplicacin con eventos de reproduccin de vdeo. Se pueden incorporar dos tipos de puntos de referencia en un archivo FLV. Un punto de referencia de navegacin especifica un fotograma clave dentro del archivo FLV y la propiedad time del punto de referencia corresponde a ese fotograma clave exactamente. Los puntos de referencia de navegacin se utilizan a menudo como marcadores o puntos de entrada para que los usuarios puedan navegar dentro del archivo de vdeo. Un punto de referencia de evento se especifica por tiempo, corresponda o no ese tiempo a un fotograma clave especfico. Un punto de referencia de evento por lo general representa un momento del vdeo en que sucede algo que se podra utilizar para activar otros eventos de la aplicacin. El controlador de eventos onCuePoint recibe un objeto con estas propiedades:
Propiedad name time Descripcin Nombre dado al punto de referencia cuando se incorpor al archivo FLV. Momento en segundos en el que se produjo el punto de referencia en el archivo de vdeo durante la reproduccin. Tipo de punto de referencia que se alcanz, ya sea de "navegacin" o de "evento". Matriz asociativa de cadenas de pares nombre/valor especificada para este punto de referencia. Se puede utilizar cualquier cadena vlida para el parmetro nombre o valor.
type parameters
Puede definir puntos de referencia en un archivo FLV la primera vez que codifique el archivo, o al importar un clip de vdeo en la herramienta de edicin de Flash utilizando el Asistente de importacin de vdeo. El controlador de eventos onMetaData tambin recupera informacin sobre los puntos de referencia en un archivo de vdeo. Sin embargo, el controlador de eventos onMetaData obtiene informacin sobre todos los puntos de referencia antes de que el vdeo empiece a reproducirse. El controlador de eventos onCuePoint recibe informacin sobre un solo punto de referencia en el momento especificado para ese punto de referencia durante la reproduccin. Por lo general, si desea que el cdigo responda a un punto de referencia especfico en el momento en que se produzca, debe utilizar el controlador de eventos onCuePoint para activar alguna accin en el cdigo. Puede utilizar la lista de puntos de referencia proporcionada en el controlador de eventos onMetaData() para permitir que el usuario empiece a reproducir el vdeo en puntos predefinidos durante el flujo de vdeo. Transfiere el valor de la propiedad time del punto de referencia al mtodo NetStream.seek() para reproducir el vdeo desde dicho punto de referencia. Disponibilidad Flash Lite 3.0 Parmetros infoObject:Object - Objeto que contiene el nombre, tiempo, tipo y parmetros para el punto de referencia.

Ejemplo El cdigo de este ejemplo comienza creando nuevos objetos NetConnection y NetStream. Despus define el controlador onCuePoint() para el objeto NetStream. El controlador utiliza cada propiedad con nombre en el objeto infoObject e imprime el nombre y el valor de la propiedad. Cuando encuentra los parmetros con nombre de la propiedad, pasa por cada nombre de parmetro de la lista e imprime el nombre y el valor del parmetro.
var nc:NetConnection = new NetConnection(); nc.connect(null); var ns:NetStream = new NetStream(nc); ns.onCuePoint = function(infoObject:Object) { trace("onCuePoint:"); for (var propName:String in infoObject) { if (propName != "parameters") { trace(propName + " = " + infoObject[propName]); } else { trace("parameters ="); if (infoObject.parameters != undefined) { for (var paramName:String in infoObject.parameters) { trace(" " + paramName + ": " + infoObject.parameters[paramName]); } } else { trace("undefined"); } } } trace("---------"); } ns.play("http://www.helpexamples.com/flash/video/cuepoints.flv");
De este modo se puede ver la informacin siguiente:

onCuePoint: parameters = lights: beginning type = navigation time = 0.418 name = point1 --------onCuePoint: parameters = lights: middle type = navigation time = 7.748 name = point2 --------onCuePoint: parameters = lights: end type = navigation time = 16.02 name = point3 ---------
El nombre de parmetro lights es un nombre arbitrario utilizado por el autor del vdeo de ejemplo. Puede poner a los parmetros de punto de referencia el nombre que desee.
onMetaData (controlador NetStream.onMetaData)

onMetaData = function(infoObject:Object) {}
Se invoca cuando Flash Lite Player recibe informacin descriptiva incorporada en el archivo FLV que se est reproduciendo. La utilidad Flash Video Exporter (versin 1.1 o posterior) incorpora la duracin del vdeo, fecha de creacin, velocidad de datos y otra informacin en el propio archivo de vdeo. Los distintos codificadores de vdeo incorporan diferentes conjuntos de metadatos. Este controlador se activa despus de una llamada al mtodo NetStream.play(), pero antes de que avance la cabeza lectora de vdeo. En muchos casos el valor de duracin incorporado en los metadatos del archivo FLV es slo un valor aproximado sin llegar a ser exacto. Es decir, no coincide siempre con el valor de la propiedad NetStream.time cuando la cabeza lectora se encuentra al final del archivo de vdeo. Disponibilidad Flash Lite 3.0 Parmetros
infoObject: Object - Objeto que contiene una propiedad para cada elemento de metadatos.
Ejemplo El cdigo de este ejemplo comienza creando nuevos objetos NetConnection y NetStream. Despus define el controlador onMetaData() para el objeto NetStream. El controlador utiliza cada propiedad con nombre en el objeto infoObject e imprime el nombre y el valor de la propiedad.

var nc:NetConnection = new NetConnection(); nc.connect(null); var ns:NetStream = new NetStream(nc); ns.onMetaData = function(infoObject:Object) { for (var propName:String in infoObject) { trace(propName + " = " + infoObject[propName]); } }; ns.play("http://www.helpexamples.com/flash/video/water.flv");
De este modo se puede ver la informacin siguiente:

canSeekToEnd = true videocodecid = 4 framerate = 15 videodatarate = 400 height = 215 width = 320 duration = 7.347
La lista de propiedades variar en funcin del software utilizado para codificar el archivo FLV.
mtodo close (NetStream.close)

Detiene la reproduccin de todos los datos del flujo, establece la propiedad NetStream.time con el valor 0 y pone el flujo a disposicin para otro uso. Este comando tambin elimina la copia local de un archivo FLV descargado mediante HTTP. Aunque Flash Lite Player elimina la copia local del archivo FLV que crea, es posible que permanezca una copia del vdeo en el directorio de memoria cach del navegador. Si es preciso impedir totalmente la creacin de un cach o almacenamiento local del archivo FLV, utilice Flash Media Server. Disponibilidad Flash Lite 3.0 Nota: este mtodo tambin es compatible con Flash Player 6 cuando se utiliza con Flash Media Server. Para obtener ms informacin, consulte la documentacin de Flash Media Server. Ejemplo La funcin close() siguiente cierra una conexin y elimina la copia temporal de video1.flv que se almacen en el disco local al hacer clic en el botn llamado close_btn:
var connection_nc:NetConnection = new NetConnection(); connection_nc.connect(null); var stream_ns:NetStream = new NetStream(connection_nc); my_video.attachVideo(stream_ns); stream_ns.play("video1.flv"); close_btn.onRelease = function(){ stream_ns.close(); };

pause (mtodo NetStream.pause)

public pause([flag:Boolean]) : Void
Realiza una pausa o reanuda la reproduccin de un flujo. La primera vez que se llame a este mtodo (sin enviar ningn parmetro), se realizar una pausa en la reproduccin; la siguiente vez, se reanudar la reproduccin. Puede ser til asociar este mtodo a un botn de manera que el usuario pueda presionarlo para hacer una pausa o reanudar la reproduccin. Disponibilidad Flash Lite 3.0 Nota: este mtodo tambin es compatible con Flash Player 6 cuando se utiliza con Flash Media Server. Para obtener ms informacin, consulte la documentacin de Flash Media Server. Parmetros flag : Boolean [opcional] - Valor booleano que especifica si se hace una pausa en la reproduccin (true) o se reanuda (false). Si omite este parmetro, NetStream.pause() acta como un conmutador: la primera vez que se llama en un flujo determinado, hace una pausa en la reproduccin, y la siguiente vez, la reanuda. Ejemplo El ejemplo siguiente ilustra algunos usos de este mtodo:
my_ns.pause(); // pauses play first time issued my_ns.pause(); // resumes play my_ns.pause(false); // no effect, play continues my_ns.pause(); // pauses play
play (mtodo NetStream.play)

public play(name:Object, start:Number, len:Number, reset:Object) : Void
Comienza la reproduccin de un archivo de vdeo externo (FLV). Para ver datos de vdeo, deber llamar a un mtodo Video.attachVideo(); el sonido que se transmita sin interrupcin junto al vdeo, o un archivo FLV que contenga slo audio, se reproducir automticamente. Si desea controlar el audio asociado a un archivo FLV, puede utilizar MovieClip.attachAudio() para dirigir el audio a un clip de pelcula; posteriormente, podr crear un objeto Sound para controlar algunos aspectos del audio. Para ms informacin, consulte MovieClip.attachAudio(). Si no se encuentra el archivo FLV, se invocar el controlador de eventos NetStream.onStatus. Si desea detener un flujo que se est reproduciendo actualmente, utilice NetStream.close(). Puede reproducir archivos FLV locales almacenados en el mismo directorio que el archivo SWF o en un subdirectorio; no es posible desplazarse a un directorio de nivel superior. Por ejemplo, si el archivo SWF est situado en un directorio denominado /training y desea reproducir un vdeo almacenado en el directorio /training/videos, deber utilizar la siguiente sintaxis:
my_ns.play("videos/videoName.flv");
Para reproducir un vdeo almacenado en el directorio /training, deber utilizar la siguiente sintaxis:
my_ns.play("videoName.flv");
Cuando utilice este mtodo tenga en cuenta el modelo de seguridad de Flash Player.

Para Flash Player 8: No se admite NetStream.play() si el archivo SWF que realiza la llamada se encuentra en el entorno limitado local con sistema de archivos y el recurso se encuentra en un entorno limitado que no sea local. Para acceder al entorno limitado de red desde el entorno limitado local de confianza o local con acceso a la red se necesitan permisos del sitio Web a travs de un archivo de poltica para distintos dominios. Para obtener ms informacin, consulte lo siguiente: El documento tcnico sobre seguridad de Flash Player 9 en http://www.adobe.com/go/fp9_0_security El documento tcnico sobre la API relativa a la seguridad de Flash Player 8 en http://www.adobe.com/go/fp8_security_apis Disponibilidad Flash Lite 3.0 Nota: este mtodo tambin es compatible con Flash Player 6 cuando se utiliza con Flash Media Server. Para obtener ms informacin, consulte la documentacin de Flash Media Server. Parmetros name : Object - El nombre, entre comillas, del archivo FLV que se va a reproducir. Se admiten los formatos http:// y file://; la ubicacin file:// es siempre relativa a la ubicacin del archivo SWF.
start : Number - Utilizar con Flash Media Server; consulte: la documentacin de Flash Media Server. len : Number - Utilizar con Flash Media Server; consulte: la documentacin de Flash Media Server. reset : Object - Utilizar con Flash Media Server; consulte: la documentacin de Flash Media Server.
Ejemplo El ejemplo siguiente ilustra algunos modos de utilizar el mtodo NetStream.play(). Puede reproducir un archivo que se encuentre en el equipo de un usuario. El directorio joe_user es un subdirectorio del directorio donde est almacenado el archivo SWF. Adems, puede reproducir un archivo en un servidor:
// Play a file that is on the user's computer. my_ns.play("file://joe_user/flash/videos/lectureJune26.flv"); // Play a file on a server. my_ns.play("http://someServer.someDomain.com/flash/video/orientation.flv");
seek (mtodo NetStream.seek)

public seek(offset:Number) : Void
Busca el fotograma clave ms cercano al nmero de segundos especificado desde el comienzo del flujo. La reproduccin se reanuda cuando se alcanza esta ubicacin. Disponibilidad Flash Lite 3.0 Nota: este mtodo tambin es compatible con Flash Player 6 cuando se utiliza con Flash Media Server. Para obtener ms informacin, consulte la documentacin de Flash Media Server.

Parmetros offset:Number - Valor de tiempo aproximado, en segundos, de desplazamiento de la cabeza lectora en un archivo FLV. La cabeza lectora se mueve al fotograma clave del vdeo ms cercano al valor que offset especifica.
Para volver al principio del flujo, pase 0 para offset. Para hacer una bsqueda hacia delante desde el principio del flujo, pase el nmero de segundos que desea avanzar.
Por ejemplo, para situar la cabeza lectora a 15 segundos del principio, utilice my_ns.seek(15).
Para hacer una bsqueda relativa a la posicin actual, pase my_ns.time
+ n o my_ns.time - n para buscar n segundos hacia adelante o hacia atrs, respectivamente, desde la posicin actual. Por ejemplo, para rebobinar 20 segundos desde la posicin actual, utilice my_ns.seek(my_ns.time - 20).
Ubicacin concreta a la que se traslada la cabeza lectora vara segn la configuracin de fotogramas por segundo (fps) en la que se expone el vdeo. Por ejemplo, imagine que tiene dos objetos de vdeo que representan el mismo vdeo, uno exportado a 6 fps y el otro a 30 fps. Si, a continuacin, utiliza my_ns.seek(15) para ambos objetos, la cabeza lectora se desplazar a distintas ubicaciones. Ejemplo El ejemplo siguiente ilustra algunos modos de utilizar el comando NetStream.seek(). Es posible regresar al comienzo del vdeo, desplazarse hasta un punto ubicado a 30 segundos del comienzo del vdeo e ir hacia atrs 3 minutos a partir del punto actual:
// Return to the beginning of the stream my_ns.seek(0); // Move to a location 30 seconds from the beginning of the stream my_ns.seek(30); // Move backwards three minutes from current location my_ns.seek(my_ns.time - 180);
setBufferTime (mtodo NetStream.setBufferTime)

public setBufferTime(bufferTime:Number) : Void
Especifica el tiempo que deben almacenarse en el bfer los mensajes antes de comenzar a mostrar el flujo. Por ejemplo, si desea asegurarse de que los 15 primeros segundos del flujo se reproduzcan sin interrupcin, establezca bufferTime con el valor 15; Flash comenzar a reproducir el flujo slo despus de que se acumulen 15 segundos de datos en el bfer. Disponibilidad Flash Lite 3.0 Nota: este mtodo tambin es compatible con Flash Player 6 cuando se utiliza con Flash Media Server. Para obtener ms informacin, consulte la documentacin de Flash Media Server. Parmetros
bufferTime:Number - Tiempo, en segundos, durante el cual se almacenan los datos en el bfer antes de que Flash comience a mostrarlos. El valor predeterminado es 0,1 (una dcima de segundo).
Ejemplo Consulte el ejemplo para NetStream.bufferLength.

Number
Object | +-Number public class Number extends Object
La clase Number es un objeto envolvente sencillo para el tipo de datos Number. Puede manipular valores numricos simples utilizando los mtodos y propiedades asociados a la clase Number. Esta clase es idntica a la clase Number de JavaScript. Las propiedades de la clase Number son estticas, lo que significa que no se necesita un objeto para utilizarlas, por lo que no es preciso utilizar el constructor. En el siguiente ejemplo, se llama al mtodo toString() de la clase Number, que devuelve la cadena 1234:
var myNumber:Number = new Number(1234); myNumber.toString();
El siguiente ejemplo asigna el valor de la propiedad MIN_VALUE a una variable declarada sin utilizar el constructor:
var smallest:Number = Number.MIN_VALUE;
Disponibilidad Flash Lite 2.0 Resumen de propiedades

Modificadores
static
Propiedad MAX_VALUE:Number
Descripcin El nmero ms grande que puede representarse (doble precisin IEEE-754). El nmero ms pequeo que puede representarse (doble precisin IEEE-754). El valor IEEE-754 que representa a Not A Number (NaN, no es un nmero). Especifica el valor IEEE-754 que representa el infinito negativo.
static
MIN_VALUE:Number
static
NaN:Number
static
NEGATIVE_INFINITY:Num ber POSITIVE_INFINITY:Numb er
static
Especifica el valor IEEE-754 que representa el infinito positivo.

Firma Number(num:Object) Descripcin Crea un nuevo objeto Number.

Resumen de mtodos
Modificadores Firma toString(radix:Number ) : String valueOf() : Number Descripcin Devuelve la representacin de cadena del objeto Number especificado (myNumber). Devuelve el tipo de valor simple del objeto Number especificado.

MAX_VALUE (propiedad Number.MAX_VALUE)

public static MAX_VALUE : Number
El nmero ms grande que puede representarse (doble precisin IEEE-754). Este nmero es aproximadamente 1,79e+308. Disponibilidad Flash Lite 2.0 Ejemplo El siguiente cdigo ActionScript muestra, en el panel Salida, los nmeros ms grande y ms pequeo que pueden representarse.
trace("Number.MIN_VALUE = "+Number.MIN_VALUE); trace("Number.MAX_VALUE = "+Number.MAX_VALUE);
Este cdigo muestra los siguientes valores:

Number.MIN_VALUE = 4.94065645841247e-324 Number.MAX_VALUE = 1.79769313486232e+308
MIN_VALUE (propiedad Number.MIN_VALUE)

public static MIN_VALUE : Number
El nmero ms pequeo que puede representarse (doble precisin IEEE-754). Este nmero es aproximadamente 5e-324. Disponibilidad Flash Lite 2.0 Ejemplo El siguiente cdigo ActionScript muestra, en el panel Salida, los nmeros ms grande y ms pequeo que pueden representarse.
trace("Number.MIN_VALUE = "+Number.MIN_VALUE); trace("Number.MAX_VALUE = "+Number.MAX_VALUE);
Este cdigo muestra los siguientes valores:

Number.MIN_VALUE = 4.94065645841247e-324 Number.MAX_VALUE = 1.79769313486232e+308
NaN (propiedad Number.NaN)

public static NaN : Number
El valor IEEE-754 que representa a Not A Number (NaN, no es un nmero). Disponibilidad Flash Lite 2.0 Vase tambin
isNaN, funcin
NEGATIVE_INFINITY (propiedad Number.NEGATIVE_INFINITY)

public static NEGATIVE_INFINITY : Number
Especifica el valor IEEE-754 que representa el infinito negativo. El valor de esta propiedad es el mismo que el de la constante -Infinity. Infinito negativo es un valor numrico especial que se devuelve cuando una operacin o funcin matemtica devuelve un valor negativo mayor de lo que es posible representar. Disponibilidad Flash Lite 2.0 Ejemplo Este ejemplo compara el resultado de dividir los siguientes valores.
var posResult:Number = 1/0; if (posResult == Number.POSITIVE_INFINITY) { trace("posResult = "+posResult); // output: posResult = Infinity } var negResult:Number = -1/0; if (negResult == Number.NEGATIVE_INFINITY) { trace("negResult = "+negResult); // output: negResult = -Infinity
Constructor Number
public Number(num:Object)
Crea un nuevo objeto Number. El nuevo constructor new Number se utiliza principalmente como marcador de posicin. Un objeto Number no es lo mismo que la funcin Number() que convierte un parmetro en un valor simple. Disponibilidad Flash Lite 2.0 Parmetros num : Object - Valor numrico del objeto Number que se crea o un valor que se va a convertir en un nmero. Si no se especifica value, el valor predeterminado es 0.

Ejemplo El cdigo siguiente construye nuevos objetos Number:

var n1:Number = new Number(3.4); var n2:Number = new Number(-10);
Vase tambin
toString (mtodo Number.toString), valueOf (mtodo Number.valueOf)
POSITIVE_INFINITY (propiedad Number.POSITIVE_INFINITY)

public static POSITIVE_INFINITY : Number
Especifica el valor IEEE-754 que representa el infinito positivo. El valor de esta propiedad es el mismo que el de la constante Infinity. Infinito positivo es un valor numrico especial que se devuelve cuando una operacin o funcin matemtica devuelve un valor positivo mayor de lo que es posible representar. Disponibilidad Flash Lite 2.0 Ejemplo Este ejemplo compara el resultado de dividir los siguientes valores.
var posResult:Number = 1/0; if (posResult == Number.POSITIVE_INFINITY) { trace("posResult = "+posResult); // output: posResult = Infinity } var negResult:Number = -1/0; if (negResult == Number.NEGATIVE_INFINITY) { trace("negResult = "+negResult); // output: negResult = -Infinity
toString (mtodo Number.toString)

public toString(radix:Number) : String
Devuelve la representacin de cadena del objeto Number especificado (myNumber). Disponibilidad Flash Lite 2.0 Parmetros radix : Number - Especifica la base numrica (de 2 a 36) para utilizar en la conversin de nmero a cadena. Si no especifica el parmetro radix, el valor predeterminado es 10. Valor devuelto String - Una cadena. Ejemplo El ejemplo siguiente utiliza 2 y 8 para el parmetro radix y devuelve una cadena que contiene la representacin correspondiente del nmero 9:

var myNumber:Number = new Number(9); trace(myNumber.toString(2)); // output: 1001 trace(myNumber.toString(8)); // output: 11
El ejemplo siguiente da como resultado un valor hexadecimal.

var r:Number = new Number(250); var g:Number = new Number(128); var b:Number = new Number(114); var rgb:String = "0x"+ r.toString(16)+g.toString(16)+b.toString(16); trace(rgb); // output: rgb:0xFA8072 (Hexadecimal equivalent of the color 'salmon')
valueOf (mtodo Number.valueOf)

public valueOf() : Number
Devuelve el tipo de valor simple del objeto Number especificado. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Una cadena. Ejemplo El ejemplo siguiente da como resultado un valor simple del objeto numSocks.
var numSocks = new Number(2); trace(numSocks.valueOf()); // output: 2
Object
Object public class Object
La clase Object se encuentra en la raz de la jerarqua de clases de ActionScript. Esta clase contiene un pequeo subconjunto de las funciones proporcionadas por la clase Object de JavaScript. Disponibilidad Flash Lite 2.0

Modificadores Propiedad constructor:Object Descripcin Referencia a la funcin constructora para una instancia de objeto determinada. Hace referencia a la propiedad prototype de la clase (ActionScript 2.0) o funcin constructora (ActionScript 1.0) utilizada para crear el objeto. Referencia a la superclase de una clase u objeto de funcin. Referencia a una funcin definida por el usuario que se invoca si el cdigo ActionScript hace referencia a una propiedad o un mtodo no definido.
__proto__:Object
static
prototype:Object __resolve:Object
Firma Object() Descripcin Crea un objeto Object y almacena una referencia al mtodo constructor del objeto en la propiedad constructor del objeto.
Resumen de mtodos
addProperty(name:String Crea una propiedad getter/setter. , getter:Function, setter:Function) : Boolean hasOwnProperty(name:S tring) : Boolean Indica si un objeto tiene definida una propiedad especificada.
isPropertyEnumerable(na Indica si existe la propiedad especificada y si es enumerable. me:String) : Boolean isPrototypeOf(theClass :Object) : Boolean
static
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como un argumento. Asocia un smbolo de clip de pelcula a una clase Object de ActionScript.
registerClass(name:Strin g, theClass:Function) : Boolean toString() : String
Convierte el objeto especificado en una cadena y devuelve dicha cadena. Elimina un punto de observacin creado por Object.watch(). Devuelve el valor simple del objeto especificado. Registra un controlador de eventos que debe invocarse cuando cambia una propiedad especificada de un objeto de ActionScript.
unwatch(name:String) : Boolean valueOf() : Object watch(name:String, callback:Function, [userData:Object]) : Boolean
addProperty (mtodo Object.addProperty)

public addProperty(name:String, getter:Function, setter:Function) : Boolean

Crea una propiedad getter/setter. Cuando Flash lee una propiedad getter/setter (captador/definidor), invoca la funcin get y el valor devuelto por la funcin se convierte en un valor de name. Cuando Flash escribe una propiedad getter/setter (captador/definidor), invoca la funcin set y le pasa el nuevo valor como parmetro. Si ya existe una propiedad con ese nombre concreto, la nueva propiedad lo sobrescribe. La funcin "get" carece de parmetros. El valor devuelto puede ser de cualquier tipo. El tipo de valor puede cambiar segn la invocacin. El valor devuelto se trata como el valor actual de la propiedad. La funcin "set" es una funcin que acepta un parmetro: el nuevo valor de la propiedad. Por ejemplo, si la propiedad x se asigna mediante la sentencia x = 1, la funcin set recibir el parmetro 1 del tipo number (nmero). El valor devuelto por la funcin set no se tiene en cuenta. Puede aadir propiedades de getter/setter a los objetos prototipo. Si aade una propiedad de getter/setter a un objeto prototipo, todas las instancias del objeto que heredan el objeto prototipo heredarn la propiedad de getter/setter. Esto permite aadir una propiedad de getter/setter a una ubicacin, el objeto prototipo, y aplicarla a todas las instancias de una clase (como si se agregaran mtodos a objetos prototipo). Si se invoca una funcin get/set para una propiedad de getter/setter de un objeto prototipo heredado, la referencia que se pasa a la funcin getter/setter ser el objeto referenciado originalmente, no el objeto prototipo. Si se invoca incorrectamente, puede que Object.addProperty() falle y muestre un error. En la siguiente tabla se describen los errores que pueden tener lugar:
Situacin de error
name no es un nombre de propiedad vlido; por ejemplo, una cadena vaca. getter no es un objeto de funcin vlido. setter no es un objeto de funcin vlido.
Qu ocurre Devuelve false y la propiedad no se aade.
Devuelve false y la propiedad no se aade.
Devuelve false y la propiedad no se aade.
Disponibilidad Flash Lite 2.0 Parmetros name:String - Cadena; nombre de la propiedad del objeto que se va a crear. getter:Function - Funcin que se invoca para recuperar el valor de la propiedad; este parmetro es un objeto Function. setter:Function - Funcin que se invoca para establecer el valor de la propiedad; este parmetro es un objeto Function. Si se pasa el valor null para este parmetro, la propiedad es de slo lectura. Valor devuelto Boolean - Valor booleano: true si la propiedad se crea correctamente, y false en caso contrario. Ejemplo En el ejemplo siguiente, un objeto tiene dos mtodos internos: setQuantity() y getQuantity(). Cuando se define o recupera, se puede utilizar una propiedad, bookcount, para invocar estos mtodos. Un tercer mtodo interno, getTitle(), devuelve un valor de slo lectura que est asociado a la propiedad bookname. Cuando un guin recupera el valor de myBook.bookcount, el intrprete de ActionScript invoca automticamente myBook.getQuantity(). Si un guin modifica el valor de myBook.bookcount, el intrprete invoca myObject.setQuantity(). Como la propiedad bookname no especifica una funcin set, los intentos de modificar la propiedad bookname no se tienen en cuenta.

function Book() { this.setQuantity = function(numBooks:Number):Void { this.books = numBooks; }; this.getQuantity = function():Number { return this.books; }; this.getTitle = function():String { return "Catcher in the Rye"; }; this.addProperty("bookcount", this.getQuantity, this.setQuantity); this.addProperty("bookname", this.getTitle, null); } var myBook = new Book(); myBook.bookcount = 5; trace("You ordered "+myBook.bookcount+" copies of "+myBook.bookname); // output: You ordered 5 copies of Catcher in the Rye
Aunque el ejemplo anterior funciona, las propiedades bookcount y bookname se aaden a cada instancia del objeto Book, lo que exige disponer de dos propiedades para cada instancia del objeto. La inclusin de muchas propiedades, como bookcount y bookname, en una clase puede conllevar un gran consumo de memoria. Como solucin puede agregar las propiedades a Book.prototype de modo que las propiedades bookcount y bookname slo existan en un lugar. Sin embargo, produce el mismo efecto que el cdigo del ejemplo, que aadi bookcount y bookname directamente a cada instancia. Si se intenta acceder a alguna de estas propiedades en una instancia Book, la ausencia de la propiedad har que se ascienda por la cadena de prototipo hasta que se encuentren las versiones definidas en Book.prototype. En el ejemplo siguiente se muestra la forma de aadir propiedades a Book.prototype:
function Book() {} Book.prototype.setQuantity = function(numBooks:Number):Void { this.books = numBooks; }; Book.prototype.getQuantity = function():Number { return this.books; }; Book.prototype.getTitle = function():String { return "Catcher in the Rye"; }; Book.prototype.addProperty("bookcount", Book.prototype.getQuantity, Book.prototype.setQuantity); Book.prototype.addProperty("bookname", Book.prototype.getTitle, null); var myBook = new Book(); myBook.bookcount = 5; trace("You ordered "+myBook.bookcount+" copies of "+myBook.bookname);
En el ejemplo siguiente se muestra cmo utilizar las funciones getter y setter implcitas que estn disponibles en ActionScript 2.0. En lugar de definir la funcin Book y editar Book.prototype, la clase Book se define en un archivo externo denominado Book.as. El cdigo siguiente debe encontrarse en un archivo externo separado, denominado Book.as, que contiene esta definicin de clase exclusivamente y reside en la ruta de clases de la aplicacin Flash:

class Book { var books:Number; function set bookcount(numBooks:Number):Void { this.books = numBooks; } function get bookcount():Number { return this.books; } function get bookname():String { return "Catcher in the Rye"; } }
Luego se puede incluir el cdigo siguiente en un archivo FLA y seguir funcionando de la misma manera que en los ejemplos anteriores:
var myBook:Book = new Book(); myBook.bookcount = 5; trace("You ordered "+myBook.bookcount+" copies of "+myBook.bookname);
Vase tambin
getProperty, funcin, setInterval, funcin
constructor (propiedad Object.constructor)

public constructor : Object
Referencia a la funcin constructora para una instancia de objeto determinada. La propiedad constructor se asigna automticamente a todos los objetos cuando se crean utilizando el constructor de la clase Object. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente es una referencia a la funcin constructora del objeto myObject.
var my_str:String = new String("sven"); trace(my_str.constructor == String); //output: true
Si utiliza el operador instanceof, tambin puede determinar si un objeto pertenece a una clase especificada:
var my_str:String = new String("sven"); trace(my_str instanceof String); //output: true
Sin embargo, en el ejemplo siguiente la propiedad Object.constructor convierte los tipos de datos simples (como el literal de cadena que aparece aqu) en objetos envolventes. El operador instanceof no realiza ninguna conversin, como se aprecia en el ejemplo siguiente:
var my_str:String = "sven"; trace(my_str.constructor == String); //output: true trace(my_str instanceof String); //output: false
Vase tambin

hasOwnProperty (mtodo Object.hasOwnProperty)

public hasOwnProperty(name:String) : Boolean
Indica si un objeto tiene definida una propiedad especificada. Este mtodo devuelve true si el objeto de destino tiene una propiedad que coincide con la cadena especificada por el parmetro name, y false en caso contrario. Este mtodo no comprueba la cadena de prototipo del objeto y devuelve true solamente cuando la propiedad existe en el propio objeto. Disponibilidad Flash Lite 2.0 Parmetros name:String - Cadena; nombre de la propiedad. Valor devuelto Boolean - Valor booleano: true si el objeto de destino tiene la propiedad especificada por el parmetro name, false en caso contrario.
isPropertyEnumerable (mtodo Object.isPropertyEnumerable)

public isPropertyEnumerable(name:String) : Boolean
Indica si existe la propiedad especificada y si es enumerable. Si su valor es true, la propiedad existe y puede enumerarse en un bucle for.in. La propiedad tiene que existir en el objeto de destino porque este mtodo no comprueba la cadena de prototipo del objeto de destino. Aunque las propiedades que se crean son enumerables, las propiedades incorporadas no suelen ser enumerables. Disponibilidad Flash Lite 2.0 Parmetros name : String - Nombre de la propiedad que se va a buscar. Valor devuelto Boolean - Valor booleano: true si la propiedad especificada por el parmetro name es enumerable. Ejemplo En el ejemplo siguiente se crea un objeto genrico, se le aade una propiedad y luego se comprueba si el objeto es enumerable. A modo de comparacin, en el ejemplo tambin se muestra que una propiedad incorporada, Array.length, no es enumerable.
var myObj:Object = new Object(); myObj.prop1 = "hello"; trace(myObj.isPropertyEnumerable("prop1")); // Output: true var myArray = new Array(); trace(myArray.isPropertyEnumerable("length")); // Output: false
Vase tambin
for..en la sentencia

isPrototypeOf (mtodo Object.isPrototypeOf)

public isPrototypeOf(theClass:Object) : Boolean
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como un argumento. Este mtodo devuelve true si el objeto est presente en la cadena de prototipo del objeto especificado por el parmetro theClass. Devuelve false no slo cuando el objeto de destino no est presente en la cadena de prototipo del objeto theClass, sino tambin cuando el argumento theClass no es un objeto. Disponibilidad Flash Lite 2.0 Parmetros theClass:Object - Clase en cuya cadena de prototipo buscar el objeto. Valor devuelto Boolean - Valor booleano: true si el objeto est presente en la cadena de prototipo del objeto especificado por el parmetro theClass, y false en caso contrario.
Constructor Object
public Object()
Crea un objeto Object y almacena una referencia al mtodo constructor del objeto en la propiedad constructor del objeto. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se crea un objeto genrico denominado myObject:
var myObject:Object = new Object();
__proto__ (Object.__proto__, propiedad)

public __proto__ : Object
Hace referencia a la propiedad prototype de la clase (ActionScript 2.0) o funcin constructora (ActionScript 1.0) utilizada para crear el objeto. La propiedad __proto__ se asigna automticamente a todos los objetos cuando se crean. El intrprete de ActionScript utiliza la propiedad __proto__ para acceder a la propiedad prototype de la clase o funcin constructor del objeto con el fin de averiguar las propiedades y mtodos que hereda el objeto de su superclase. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se crea una clase denominada Shape y una subclase de Shape con el nombre Circle.

// Shape class defined in external file named Shape.as class Shape { function Shape() {} } // Circle class defined in external file named Circle.as class Circle extends Shape{ function Circle() {} }
La clase Circle se puede utilizar para crear dos instancias de Circle:

var oneCircle:Circle = new Circle(); var twoCircle:Circle = new Circle();
En las siguientes sentencias trace se muestra que la propiedad __proto_ de ambas instancias hace referencia a la propiedad prototype de la clase Circle.
trace(Circle.prototype == oneCircle.__proto__); // Output: true trace(Circle.prototype == twoCircle.__proto__); // Output: true
Vase tambin
prototype (propiedad Object.prototype)
prototype (propiedad Object.prototype)

public static prototype : Object
Referencia a la superclase de una clase u objeto de funcin. La propiedad prototype se crea y asocia automticamente a cualquier clase u objeto de funcin creado. Esta propiedad se considera esttica porque es especfica de la clase o funcin que se ha creado. Por ejemplo, si crea una clase personalizada, todas las instancias de la clase compartirn el valor de la propiedad prototype y slo ser accesible como propiedad de clase. Aunque las instancias de la clase personalizada no tienen acceso directo a la propiedad prototype, pueden acceder a ella a travs de la propiedad __proto__. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se crea una clase denominada Shape y una subclase de Shape con el nombre Circle.
// Shape class defined in external file named Shape.as class Shape { function Shape() {} } // Circle class defined in external file named Circle.as class Circle extends Shape{ function Circle() {} }
La clase Circle se puede utilizar para crear dos instancias de Circle:

var oneCircle:Circle = new Circle(); var twoCircle:Circle = new Circle();

En la siguiente sentencia trace se muestra que la propiedad prototype de la clase Circle seala a su superclase Shape. El identificador Shape hace referencia a la funcin constructora de la clase Shape.
trace(Circle.prototype.constructor == Shape); // Output: true
La siguiente sentencia trace muestra cmo utilizar juntas las propiedades prototype y __proto__ para subir dos niveles en la jerarqua de herencia (o cadena de prototipo). La propiedad Circle.prototype.__proto__ contiene una referencia a la superclase de la clase Shape.
trace(Circle.prototype.__proto__ == Shape.prototype); // Output: true
Vase tambin
__proto__ (Object.__proto__, propiedad)
registerClass (mtodo Object.registerClass)

public static registerClass(name:String, theClass:Function) : Boolean
Asocia un smbolo de clip de pelcula a una clase Object de ActionScript. Si un smbolo no existe, Flash crea una asociacin entre un identificador de cadena y una clase de objeto. Cuando se coloca una instancia del smbolo de clip de pelcula especificado en la lnea de tiempo, sta se registra en la clase especificada por el parmetro theClass, no en la clase MovieClip. Cuando se crea una instancia del smbolo de clip de pelcula especificado mediante MovieClip.attachMovie() o
MovieClip.duplicateMovieClip(), sta se registra en la clase especificada por theClass, no en la clase MovieClip.
Si heClass tiene el valor null, este mtodo elimina cualquier definicin de clase de ActionScript asociada al smbolo de clip de pelcula o identificador de clase especificado. En el caso de los smbolos de clip de pelcula, las instancias existentes del clip de pelcula permanecern sin cambios, pero las nuevas instancias del smbolo se asociarn a la clase predeterminada MovieClip. Si ya hay un smbolo registrado en una clase, este mtodo lo reemplazar por el nuevo registro. Si la lnea de tiempo coloca una instancia de clip de pelcula o sta se crea utilizando attachMovie() o duplicateMovieClip(), ActionScript invocar el constructor de la clase correspondiente con la palabra clave this apuntando al objeto. La funcin constructor se invoca sin parmetros. Si utiliza este mtodo para registrar un clip de pelcula en una clase de ActionScript distinta de MovieClip, el smbolo de clip de pelcula no heredar los mtodos, propiedades y eventos de la clase MovieClip incorporada, a no ser que incluya la clase MovieClip en la cadena de prototipo de la nueva clase. El siguiente cdigo crea una nueva clase de ActionScript denominada theClass que hereda las propiedades de la clase MovieClip:
theClass.prototype = new MovieClip();
Disponibilidad Flash Lite 2.0 Parmetros name : String - Cadena; identificador de vinculacin del smbolo del clip de pelcula o identificador de cadena de la clase ActionScript. theClass : Function - Referencia a la funcin constructora de la clase ActionScript o null para anular el registro del smbolo.

Valor devuelto Boolean - Valor booleano: si el registro de la clase se realiza correctamente, se devuelve el valor true; false en caso contrario. Vase tambin
attachMovie (mtodo MovieClip.attachMovie), duplicateMovieClip (mtodo MovieClip.duplicateMovieClip)
__resolve (Object.__resolve, propiedad)

public __resolve : Object
Referencia a una funcin definida por el usuario que se invoca si el cdigo ActionScript hace referencia a una propiedad o un mtodo no definido. Si el cdigo ActionScript hace referencia a una propiedad o mtodo no definido de un objeto, Flash Lite Player determinar si se ha definido la propiedad __resolve del objeto. Si se ha definido __resolve, se ejecutar la funcin a la que hace referencia y se pasar a ella el nombre de la propiedad o mtodo no definido. Esto permite proporcionar de manera programtica valores para propiedades no definidas y sentencias para mtodos no definidos y hacer que parezca como si las propiedades o los mtodos estuvieran realmente definidos. Esta propiedad resulta til para permitir una comunicacin altamente transparente entre el cliente y el servidor y es la forma recomendada de invocar mtodos de servidor. Disponibilidad Flash Lite 2.0 Ejemplo Los ejemplos siguientes forman una secuencia basada en el primer ejemplo e ilustran cinco usos distintos de la propiedad __resolve. Para facilitar la comprensin, las sentencias clave que difieren del uso anterior aparecen en negrita. Sintaxis 1: en el ejemplo siguiente, __resolve se utiliza para crear un objeto en el que cada propiedad no definida devuelve el valor "Hello, world!".
// instantiate a new object var myObject:Object = new Object(); // define the __resolve function myObject.__resolve = function (name) { return "Hello, world!"; }; trace (myObject.property1); // output: Hello, world! trace (myObject.property2); // output: Hello, world!
Sintaxis 2: en el ejemplo siguiente se utiliza __resolve como functor; es decir, como funcin que genera funciones. Mediante __resolve, las llamadas de mtodo no definido se redirigen a una funcin genrica denominada myFunction.

// instantiate a new object var myObject:Object = new Object(); // define a function for __resolve to call myObject.myFunction = function (name) { trace("Method " + name + " was called"); }; // define the __resolve function myObject.__resolve = function (name) { return function () { this.myFunction(name); }; }; // test __resolve using undefined method names myObject.someMethod(); // output: Method someMethod was called myObject.someOtherMethod(); //output: Method someOtherMethod was called
Sintaxis 3: el ejemplo siguiente se basa en el anterior, pero ofrece la posibilidad de guardar en el cach los mtodos resueltos. Cuando los mtodos se guardan en el cach, slo se llama a __resolve una vez por cada mtodo de inters. Esto permite la construccin diferida de mtodos de objeto. La construccin diferida es una tcnica de optimizacin que aplaza la creacin, o construccin, de mtodos hasta el momento en que se utiliza un mtodo por primera vez.
// instantiate a new object var myObject:Object = new Object(); // define a function for __resolve to call myObject.myFunction = function(name) { trace("Method "+name+" was called"); }; // define the __resolve function myObject.__resolve = function(name) { trace("Resolve called for "+name); // to check when __resolve is called // Not only call the function, but also save a reference to it var f:Function = function () { this.myFunction(name); }; // create a new object method and assign it the reference this[name] = f; // return the reference return f; }; // test __resolve using undefined method names // __resolve will only be called once for each method name myObject.someMethod(); // calls __resolve myObject.someMethod(); // does not call __resolve because it is now defined myObject.someOtherMethod(); // calls __resolve myObject.someOtherMethod(); // does not call __resolve, no longer undefined
Sintaxis 4: en el ejemplo siguiente, basado en el anterior, se reserva un nombre de mtodo, onStatus(), para uso local con el fin de evitar que se resuelva de la misma forma que otras propiedades no definidas. El cdigo que se aade aparece en negrita.

// instantiate a new object var myObject:Object = new Object(); // define a function for __resolve to call myObject.myFunction = function(name) { trace("Method "+name+" was called"); }; // define the __resolve function myObject.__resolve = function(name) { // reserve the name "onStatus" for local use if (name == "onStatus") { return undefined; } trace("Resolve called for "+name); // to check when __resolve is called // Not only call the function, but also save a reference to it var f:Function = function () { this.myFunction(name); }; // create a new object method and assign it the reference this[name] = f; // return the reference return f; }; // test __resolve using the method name "onStatus" trace(myObject.onStatus("hello")); // output: undefined
Sintaxis 5: el ejemplo siguiente est basado en el anterior, pero en este caso se crea un functor que acepta parmetros. Adems de hacer uso extensivo del objeto arguments, en este ejemplo se utilizan varios mtodos de la clase Array.

// instantiate a new object var myObject:Object = new Object(); // define a generic function for __resolve to call myObject.myFunction = function (name) { arguments.shift(); trace("Method " + name + " was called with arguments: " + arguments.join(',')); }; // define the __resolve function myObject.__resolve = function (name) { // reserve the name "onStatus" for local use if (name == "onStatus") { return undefined; } var f:Function = function () { arguments.unshift(name); this.myFunction.apply(this, arguments); }; // create a new object method and assign it the reference this[name] = f; // return the reference to the function return f; }; // test __resolve using undefined method names with parameters myObject.someMethod("hello"); // output: Method someMethod was called with arguments: hello myObject.someOtherMethod("hello","world"); // output: Method someOtherMethod was called with arguments: hello,world
Vase tambin arguments, Array
toString (mtodo Object.toString)

Convierte el objeto especificado en una cadena y devuelve dicha cadena. Disponibilidad Flash Lite 2.0 Valor devuelto String - Una cadena. Ejemplo En este ejemplo se muestra el valor que se devuelve para toString() en un objeto genrico:
var myObject:Object = new Object(); trace(myObject.toString()); // output: [object Object]
Este mtodo se puede sustituir para que se devuelva un valor ms significativo. En los ejemplos siguientes se muestra que este mtodo se ha sustituido para las clases incorporadas Date, Array y Number:

// Date.toString() returns the current date and time var myDate:Date = new Date(); trace(myDate.toString()); // output: [current date and time] // Array.toString() returns the array contents as a comma-delimited string var myArray:Array = new Array("one", "two"); trace(myArray.toString()); // output: one,two // Number.toString() returns the number value as a string // Because trace() won't tell us whether the value is a string or number // we will also use typeof() to test whether toString() works. var myNumber:Number = 5; trace(typeof (myNumber)); // output: number trace(myNumber.toString()); // output: 5 trace(typeof (myNumber.toString())); // output: string
En el ejemplo siguiente se muestra cmo sustituir toString() en una clase personalizada. Primero cree un archivo de texto denominado Vehicle.as que slo contenga la definicin de la clase Vehicle y luego colquelo en la carpeta Classes dentro de la carpeta Configuration.
// contents of Vehicle.as class Vehicle { var numDoors:Number; var color:String; function Vehicle(param_numDoors:Number, param_color:String) { this.numDoors = param_numDoors; this.color = param_color; } function toString():String { var doors:String = "door"; if (this.numDoors > 1) { doors += "s"; } return ("A vehicle that is " + this.color + " and has " + this.numDoors + " " + doors); } } // code to place into a FLA file var myVehicle:Vehicle = new Vehicle(2, "red"); trace(myVehicle.toString()); // output: A vehicle that is red and has 2 doors // for comparison purposes, this is a call to valueOf() // there is no primitive value of myVehicle, so the object is returned // giving the same output as toString(). trace(myVehicle.valueOf()); // output: A vehicle that is red and has 2 doors
unwatch (mtodo Object.unwatch)

public unwatch(name:String) : Boolean
Elimina un punto de observacin creado por Object.watch(). Este mtodo devuelve el valor true si el punto de observacin se elimina correctamente, y false en caso contrario.

Disponibilidad Flash Lite 2.0 Parmetros name : String - Cadena; el nombre de la propiedad del objeto que debera dejar de observarse. Valor devuelto Boolean - Valor booleano: true si el punto de observacin se elimina correctamente; false en caso contrario. Ejemplo Consulte el ejemplo para Object.watch(). Vase tambin
watch (mtodo Object.watch), addProperty (mtodo Object.addProperty)
valueOf (mtodo Object.valueOf)

public valueOf() : Object
Devuelve el valor simple del objeto especificado. Si el objeto no tiene un valor simple, se devuelve el objeto. Disponibilidad Flash Lite 2.0 Valor devuelto Object - El valor simple del objeto especificado o el propio objeto. Ejemplo En el ejemplo siguiente se muestra el valor devuelto de valueOf() para un objeto genrico (que no tiene un valor simple) y se compara con el valor devuelto de toString(). En primer lugar, cree un objeto genrico. A continuacin, cree un nuevo objeto Date establecido en February 1, 2004, 8:15 AM. El mtodo toString() devuelve la hora actual con un formato legible. El mtodo valueOf() devuelve el valor simple en milisegundos. Finalmente, cree un nuevo objeto Array que contenga dos elementos sencillos. Tanto toString() como valueOf() devuelven el mismo valor: one,two:
// Create a generic object var myObject:Object = new Object(); trace(myObject.valueOf()); // output: [object Object] trace(myObject.toString()); // output: [object Object]
En los ejemplos siguientes se muestran los valores devueltos para las clases incorporadas Date y Array, y se comparan con los valores devueltos de Object.toString():

// Create a new Date object set to February 1, 2004, 8:15 AM // The toString() method returns the current time in human-readable form // The valueOf() method returns the primitive value in milliseconds var myDate:Date = new Date(2004,01,01,8,15); trace(myDate.toString()); // output: Sun Feb 1 08:15:00 GMT-0800 2004 trace(myDate.valueOf()); // output: 1075652100000 // Create a new Array object containing two simple elements // In this case both toString() and valueOf() return the same value: one,two var myArray:Array = new Array("one", "two"); trace(myArray.toString()); // output: one,two trace(myArray.valueOf()); // output: one,two
En el ejemplo de Object.toString() puede encontrar un ejemplo del valor devuelto de Object.valueOf() para una clase personalizada que sustituye a toString(). Vase tambin
toString (mtodo Object.toString)
watch (mtodo Object.watch)

public watch(name:String, callback:Function, [userData:Object]) : Boolean
Registra un controlador de eventos que debe invocarse cuando cambia una propiedad especificada de un objeto de ActionScript. Cuando cambia la propiedad, se invoca el controlador de eventos con myObject como objeto contenedor. Puede utilizar la sentencia return de la definicin del mtodo callback para modificar el valor de la propiedad que est observando. El valor devuelto por el mtodo callback se asigna a la propiedad del objeto observado. El valor de devolucin que elija depender de si desea controlar, modificar o evitar cambios en la propiedad:
Si simplemente est controlando la propiedad, devuelva el parmetro newVal. Si est modificando el valor de la propiedad, devuelva su propio valor. Si desea evitar cambios en la propiedad, devuelva el parmetro oldVal.
Si el mtodo callback que usted define no tiene una sentencia return, se asignar el valor undefined a la propiedad del objeto observado. Un punto de observacin puede filtrar (o convertir en nula) la asignacin de valor mediante la devolucin de un newval (u oldval). Si elimina una propiedad para la que se ha establecido un punto de observacin, el punto de observacin no desaparecer. Si posteriormente vuelve a crear la propiedad, el punto de observacin seguir surtiendo efecto. Para eliminar un punto de observacin, utilice el mtodo Object.unwatch. Slo puede registrarse un punto de observacin en una propiedad. Las posteriores llamadas a Object.watch() en la misma propiedad reemplazan al punto de observacin original. El mtodo Object.watch() se comporta de manera similar a la funcin Object.watch() en JavaScript 1.2 y posterior. La diferencia principal es el parmetro userData que Flash aade a Object.watch() y que Netscape Navigator no admite. Puede pasar el parmetro userData al controlador de eventos y utilizarlo en el controlador de eventos.

El mtodo Object.watch() no puede observar propiedades getter/setter. Las propiedades getter/setter operan mediante evaluacin diferida - el valor de la propiedad no se determina hasta que se consulta realmente la propiedad. La evaluacin diferida suele ser eficaz porque la propiedad no se actualiza constantemente; ms bien se evala cuando es necesario. No obstante, Object.watch() necesita evaluar una propiedad para determinar si debe invocarse la funcin callback. Para trabajar con una propiedad getter/setter, Object.watch() necesita evaluar la propiedad constantemente, lo cual no resulta eficaz. Generalmente, las propiedades predefinidas de ActionScript, como _x, _y, _width y _height, son propiedades getter/setter que no pueden observarse con Object.watch(). Disponibilidad Flash Lite 2.0 Parmetros name:String - Cadena; nombre de la propiedad del objeto que se va a observar. callback:Function - La funcin que se invoca cuando la propiedad observada cambia. Este parmetro es un objeto de funcin, en lugar de un nombre de funcin como una cadena. El formato de callback es callback(prop, oldVal, newVal, userData). userData:Object [opcional] - Parte cualquiera de los datos ActionScript que se pasa al mtodo callback. Si se omite el parmetro userData, se pasa undefined al mtodo callback. Valor devuelto Boolean - Valor booleano: true si el punto de observacin se crea correctamente; false en caso contrario. Ejemplo En el ejemplo siguiente se emplea watch() para determinar si la propiedad speed supera el lmite de velocidad:

// Create a new object var myObject:Object = new Object(); // Add a property that tracks speed myObject.speed = 0; // Write the callback function to be executed if the speed property changes var speedWatcher:Function = function(prop, oldVal, newVal, speedLimit) { // Check whether speed is above the limit if (newVal > speedLimit) { trace ("You are speeding."); } else { trace ("You are not speeding."); } // Return the value of newVal. return newVal; } // Use watch() to register the event handler, passing as parameters: // - the name of the property to watch: "speed" // - a reference to the callback function speedWatcher // - the speedLimit of 55 as the userData parameter myObject.watch("speed", speedWatcher, 55); // set the speed property to 54, then to 57 myObject.speed = 54; // output: You are not speeding myObject.speed = 57; // output: You are speeding // unwatch the object myObject.unwatch("speed"); myObject.speed = 54; // there should be no output
Vase tambin
addProperty (mtodo Object.addProperty), unwatch (mtodo Object.unwatch)
Point (flash.geom.Point)
Object | +-flash.geom.Point public class Point extends Object
La clase Point representa una ubicacin en un sistema de coordenadas bidimensional, donde x representa el eje horizontal e y representa el eje vertical. Mediante el cdigo siguiente se crea un punto en las coordenadas (0,0):
var myPoint:Point = new Point();

Modificadores Propiedad length:Number x:Number y:Number Descripcin Longitud del segmento de lnea desde (0,0) hasta este punto. Coordenada horizontal del punto. Coordenada vertical del punto.
Firma Point(x:Number, y:Number) Descripcin Crea un nuevo punto.
Resumen de mtodos
Modificadores Firma add(v:Point): Point Descripcin Aade las coordenadas de otro punto a las coordenadas de ste para crear un nuevo punto. Crea una copia de este objeto Point. Devuelve la distancia entre pto1 y pto2.
clone() : Point
static
distance(pt1:Point, pt2:Point) : Number equals(toCompare:Obje ct) : Boolean
Determina si dos puntos son iguales.
static
interpolate(pt1:Point, pt2:Point , f:Number) : Point normalize(length:Num ber) : Void offset(dx:Number, dy:Number) : Void
Determina un punto entre dos puntos especificados.
Ajusta a una longitud establecida el tamao del segmento de lnea entre (0,0) y el punto actual. Desplaza el objeto Point en la cantidad especificada.
static
Convierte un par de coordenadas polares en una coordenada polar(len:Number, angle:Number) : Point cartesiana. resta(v:Point : Point Resta las coordenadas de otro punto de las coordenadas de ste para crear un nuevo punto.
Devuelve una cadena que contiene los valores de las coordenadas toString (mtodo Point.toString)() : String x e y.
addProperty (mtodo Object.addProperty), hasOwnProperty (mtodo Object.hasOwnProperty), isPropertyEnumerable (mtodo Object.isPropertyEnumerable), isPrototypeOf (mtodo Object.isPrototypeOf)registerClass (mtodo Object.registerClass), toString (mtodo Object.toString), unwatch (mtodo Object.unwatch), valueOf (mtodo Object.valueOf), watch (mtodo Object.watch)

add (mtodo Point.add)

public add(v:Point) : Point
Aade las coordenadas de otro punto a las coordenadas de ste para crear un nuevo punto. Disponibilidad Flash Lite 3.1 Parmetros v:Point - El punto que se va a aadir. Valor devuelto Point - El nuevo punto. Ejemplo El siguiente ejemplo crea un objeto Point resultPoint aadiendo point_2 a point_1.
import flash.geom.Point; var point_1:Point = new Point(4, 8); var point_2:Point = new Point(1, 2); var resultPoint:Point = point_1.add(point_2); trace(resultPoint.toString()); // (x=5, y=10)
clone (mtodo Point.clone)

public clone() : Point
Crea una copia de este objeto Point. Disponibilidad Flash Lite 3.1 Valor devuelto Point - El nuevo objeto Point. Ejemplo El siguiente ejemplo crea una copia del objeto Point llamada clonedPoint a partir de los valores encontrados en el objeto myPoint. El objeto clonedPoint contiene todos los valores de myPoint, pero no es el mismo objeto.
import flash.geom.Point; var myPoint:Point = new Point(1, 2); var clonedPoint:Point = myPoint.clone(); trace(clonedPoint.x); // 1 trace(clonedPoint.y); // 2 trace(myPoint.equals(clonedPoint)); // true trace(myPoint === clonedPoint); // false
distance (mtodo Point.distance)

public static distance(pt1:Point, pt2:Point)) : Number
Devuelve la distancia entre pto1 y pto2.

Disponibilidad Flash Lite 3.1 Parmetros pt1:Point - El primer punto. pt2:Point - El segundo punto. Valor devuelto Number - Distancia entre el primer y el segundo punto Ejemplo El siguiente ejemplo crea point_1 y point_2 y, a continuacin, determina la distancia entre ellos (distanceBetween).
import flash.geom.Point; var point_1:Point = new Point(-5, 0); var point_2:Point = new Point(5, 0); var distanceBetween:Number = Point.distance(point_1, point_2); trace(distanceBetween); // 10
equals (mtodo Point.equals)

public equals(toCompare:Object) : Boolean
Determina si dos puntos son iguales. Para que se consideren iguales, los dos puntos deben tener los mismos valores x e y. Disponibilidad Flash Lite 3.1 Parmetros toCompare:Object - El punto que se va a comparar. Valor devuelto Boolean - Si el objeto es igual a este objeto Point, true; si no es igual, false. Ejemplo El siguiente ejemplo determina si los valores de un punto son iguales a los valores de otro punto. Si los objetos son iguales, equals() no devolver el mismo resultado que el operador de igualdad estricta (===).
import flash.geom.Point; var point_1:Point = new Point(1, 2); var point_2:Point = new Point(1, 2); var point_3:Point = new Point(4, 8); trace(point_1.equals(point_2)); // true trace(point_1.equals(point_3)); // false trace(point_1 === point_2); // false trace(point_1 === point_3); // false
interpolate (mtodo Point.interpolate)

public static interpolate(pt1:Point, pt2:Point, f:Number) : Point

Determina un punto entre dos puntos especificados. Disponibilidad Flash Lite 3.1 Parmetros pt1:Point - El primer punto. pt2:Point - El segundo punto. f:Number - El nivel de interpolacin entre dos puntos. Indica la posicin del nuevo punto a lo largo de la lnea entre pt1 y pt2. Si f=0, se devuelve pt1; si f=1, se devuelvept2. Valor devuelto Point - El nuevo punto interpolado. Ejemplo El siguiente ejemplo sita el punto interpolado (interpolatedPoint) a medio camino (50%) entre point_1 y point_2.
import flash.geom.Point; var point_1:Point = new Point(-100, -100); var point_2:Point = new Point(50, 50); var interpolatedPoint:Point = Point.interpolate(point_1, point_2, .5); trace(interpolatedPoint.toString()); // (x=-25, y=-25)
length (propiedad Point.length)

Longitud del segmento de lnea desde (0,0) hasta este punto. Disponibilidad Flash Lite 3.1 Ejemplo El siguiente ejemplo crea un objeto Point, myPoint, y determina la longitud de una lnea desde (0, 0) hasta ese punto.
import flash.geom.Point; var myPoint:Point = new Point(3,4); trace(myPoint.length); // 5
Vase tambin
polar (mtodo Point.polar)
normalize (mtodo Point.normalize)

public normalize(length:Number) : Void
Ajusta a una longitud establecida el tamao del segmento de lnea entre (0,0) y el punto actual. Disponibilidad Flash Lite 3.1

Parmetros length:Number - El valor de ajuste a escala. Por ejemplo, si el punto actual se encuentra en las coordenadas (0,5) y se estandariza a 1, el valor que se devuelve es (0,1). Ejemplo El siguiente ejemplo ampla la longitud del objeto normalizedPoint de 5 a 10.
import flash.geom.Point; var normalizedPoint:Point = new Point(3, 4); trace(normalizedPoint.length); // 5 trace(normalizedPoint.toString()); // (x=3, y=4) normalizedPoint.normalize(10); trace(normalizedPoint.length); // 10 trace(normalizedPoint.toString()); // (x=6, y=8)
Vase tambin
length (propiedad Point.length)
offset (mtodo Point.offset)

public offset(dx:Number, dy:Number) : Void
Desplaza el objeto Point en la cantidad especificada. El valor de dx se suma al valor original de x para crear un nuevo valor x. El valor de dy se suma al valor original de y para crear un valor y nuevo. Disponibilidad Flash Lite 3.1 Parmetros dx:Number - Cantidad que se desplaza la coordenada horizontal, x. dy:Number - Cantidad que se desplaza la coordenada vertical, y. Ejemplo El siguiente ejemplo desplaza la posicin de un punto a una distancia x e y especificadas.
import flash.geom.Point; var myPoint:Point = new Point(1, 2); trace(myPoint.toString()); // (x=1, y=2) myPoint.offset(4, 8); trace(myPoint.toString()); // (x=5, y=10)
Vase tambin
add (mtodo Point.add)
Constructor Point
public Point(x:Number, y:Number)
Crea un nuevo punto. Si no se pasan parmetros a este mtodo, se crea un punto en las coordenadas (0,0). Disponibilidad Flash Lite 3.1

Parmetros x:Number - Coordenada horizontal. El valor predeterminado es 0. y:Number - Coordenada vertical. El valor predeterminado es 0. Ejemplo El primer ejemplo crea un objeto Point point_1 con el constructor predeterminado.
import flash.geom.Point; var point_1:Point = new Point(); trace(point_1.x); // 0 trace(point_1.y); // 0
El segundo ejemplo crea un objeto Point point_2 con las coordenadas x = 1 e y = 2.

import flash.geom.Point; var point_2:Point = new Point(1, 2); trace(point_2.x); // 1 trace(point_2.y); // 2
polar (mtodo Point.polar)

public static polar(len:Number, angle:Number) : Point
Convierte un par de coordenadas polares en una coordenada cartesiana. Disponibilidad Flash Lite 3.1 Parmetros len:Number - La coordenada del par de coordenadas polares que determina la longitud. angle:Number - El ngulo, en radianes, del par de coordenadas polares. Valor devuelto Point - La coordenada cartesiana. Ejemplo El siguiente ejemplo crea un objeto Point cartesianPoint a partir del valor de angleInRadians y una longitud de lnea de 5. Se usa el valor angleInRadians igual a Math.atan(3/4) debido a las caractersticas de los tringulos rectngulos cuyos lados tienen las proporciones 3:4:5.
import flash.geom.Point; var len:Number = 5; var angleInRadians:Number = Math.atan(3/4); var cartesianPoint:Point = Point.polar(len, angleInRadians); trace(cartesianPoint.toString()); // (x=4, y=3)
Cuando los equipos trabajan con nmeros transcendentales, como pi, pueden producirse ciertos errores de redondeo debido a que la aritmtica de punto flotante slo tiene una precisin finita. Si utiliza Math.PI, plantese usar la funcin Math.round(), como se muestra en el siguiente ejemplo.

import flash.geom.Point; var len:Number = 10; var angleInRadians:Number = Math.PI; var cartesianPoint:Point = Point.polar(len, angleInRadians); trace(cartesianPoint.toString()); // should be (x=-10, y=0), but is (x=-10, y=1.22460635382238e-15) trace(Math.round(cartesianPoint.y)); // 0
Vase tambin
length (propiedad Point.length), round (mtodo Math.round)
subtract (mtodo Point.subtract)

public subtract(v:Point) : Point
Resta las coordenadas de otro punto de las coordenadas de ste para crear un nuevo punto. Disponibilidad Flash Lite 3.1 Parmetros v:Point - El punto que se va a restar. Valor devuelto Point - El nuevo punto. Ejemplo El siguiente ejemplo crea point_3 restando point_2 de point_1.
import flash.geom.Point; var point_1:Point = new Point(4, 8); var point_2:Point = new Point(1, 2); var resultPoint:Point = point_1.subtract(point_2); trace(resultPoint.toString()); // (x=3, y=6)
toString (mtodo Point.toString)

Devuelve una cadena que contiene los valores de las coordenadas x e y. Tiene el formato (x, y), por lo que un punto situado en 23,17 dara como resultado "(x=23, y=17)". Disponibilidad Flash Lite 3.1 Valor devuelto String - Una cadena. Ejemplo El ejemplo siguiente crea un punto y convierte sus valores en una cadena con el formato (x=x, y=y).

import flash.geom.Point; var myPoint:Point = new Point(1, 2); trace("myPoint: " + myPoint.toString()); // (x=1, y=2)
x (propiedad Point.x.)
public x : Number
Coordenada horizontal del punto. El valor predeterminado es 0. Disponibilidad Flash Lite 3.1 Ejemplo El ejemplo siguiente crea un objeto Point myPoint y define el valor de la coordenada x.
import flash.geom.Point; var myPoint:Point = new Point(); trace(myPoint.x); // 0 myPoint.x = 5; trace(myPoint.x); // 5
y (propiedad Point.y)
public y : Number
Coordenada vertical del punto. El valor predeterminado es 0. Disponibilidad Flash Lite 3.1 Ejemplo El ejemplo siguiente crea un objeto Point myPoint y define el valor de la coordenada y.
import flash.geom.Point; var myPoint:Point = new Point(); trace(myPoint.y); // 0 myPoint.y = 5; trace(myPoint.y); // 5
Object | +-flash.geom.Rectangle public class Rectangle extends Object

La clase Rectangle permite crear y modificar objetos Rectangle. Un objeto Rectangle es un rea definida por su posicin, segn se determina en funcin de su ngulo superior izquierdo (x, y) y de su altura y anchura. Tenga cuidado al disear estas reas. Si un rectngulo se describe especificando que su esquina superior izquierda se encuentra en 0,0 y tiene 10 de altura y 20 de anchura, la esquina inferior derecha se encontrar en 9,19, ya que la anchura y la altura se empiezan a contar a partir de 0,0. Como las propiedadesx, y, width y height de la clase Rectangle son independientes entre s, el cambio del valor de una propiedad no afecta a las otras. No obstante, las propiedades right y bottom estn estrechamente relacionadas con estas cuatro: si se cambia right, tambin se cambiar width; si se cambia bottom, tambin se cambiar height, etc. Adems, deber establecer las propiedades left o x antes de establecer las propiedades width o right. Disponibilidad Flash Lite 3.1 Resumen de propiedades
Modificadores Propiedad bottom:Number bottomright:Point Descripcin Suma de las propiedades y y height. La posicin del ngulo inferior derecho del objeto Rectangle viene determinada por los valores x e y. La altura del rectngulo en pxeles. La coordenada x del ngulo superior izquierdo del rectngulo. Suma de las propiedades x y width. El tamao del objeto Rectangle, expresado como un objeto Point con valores width y height. La coordenada y del ngulo superior izquierdo del rectngulo. La posicin del ngulo superior izquierdo del objeto Rectangle viene determinada por los valores x e y del punto. Anchura del rectngulo, en pxeles. La coordenada x del ngulo superior izquierdo del rectngulo. La coordenada y del ngulo superior izquierdo del rectngulo.
height:Number left:Number right:Number size:Point
top:Number topLeft:Point
width:Number x:Number y:Number
Constructor Object, __proto__ (Object.__proto__, propiedad), prototype (propiedad Object.prototype), __resolve (Object.__resolve, propiedad)
Firma Rectngulo(x:Number, y:Number, width:Number, height:Number) Descripcin Crea un nuevo objeto Rectangle cuya esquina superior izquierda est especificada por los parmetros x e y.

Resumen de mtodos
Modificadores Firma clone() : Rectngulo Descripcin Devuelve un objeto Rectangle nuevo con las mismas propiedades
x, y, width y height que el objeto Rectangle original.
contains(x:Number, y:Number) : Boolean containsPoint(pt:Point (flash.geom.Point)) : Boolean
Determina si el punto especificado est incluido en la regin rectangular definida por este objeto Rectangle. Determina si el punto especificado est incluido en la regin rectangular definida por este objeto Rectangle.
containsRectangle(rect: Determina si el objeto Rectangle especificado por el parmetro Rectngulo) : Boolean rect est contenido en este objeto Rectangle. equals(toCompare:Obje ct) : Boolean inflate(dx:Number, dy:Number) : Void inflatePoint(pt:Point) :
Void
Determina si el objeto especificado en el parmetro toCompare es igual a este objeto Rectangle. Aumenta el tamao del objeto Rectangle segn las cantidades especificadas. Aumenta el tamao del objeto Rectangle.
intersection(toInterse ct:Rectngulo) : Rectngulo
Si el objeto Rectangle especificado en el parmetro toIntersect presenta un punto de interseccin con este objeto, el mtodo intersection() devuelve el rea de interseccin como un objeto Rectangle.
intersects(toIntersect Determina si el objeto especificado en el parmetro :Rectngulo) : Boolean toIntersect presenta un punto de interseccin con este objeto Rectangle. isEmpty() : Boolean offset(dx:Number, dy:Number) : Void offsetPoint(pt:Point) :
Void
Determina si este objeto Rectangle est vaco o no. Ajusta la posicin del objeto Rectangle, definida por su ngulo superior izquierdo, segn las cantidades especificadas. Ajusta la ubicacin del objeto Rectangle utilizando un objeto Point como parmetro. Establece todas las propiedades del objeto Rectangle en 0. Crea y devuelve una cadena en la que se indican las posiciones horizontal y vertical, as como la anchura y la altura, del objeto Rectangle. Une dos rectngulos para crear un objeto Rectangle nuevo, y rellena los espacios horizontal y vertical que quedan entre los dos rectngulos.
setEmpty() : Void toString() : String
union(toUnion:Rectng ulo) : Rectngulo
addProperty (mtodo Object.addProperty) en la pgina 504, hasOwnProperty (mtodo Object.hasOwnProperty) en la pgina 508, isPropertyEnumerable (mtodo Object.isPropertyEnumerable), isPrototypeOf (mtodo Object.isPrototypeOf), registerClass (mtodo Object.registerClass), toString (mtodo Object.toString), unwatch (mtodo Object.unwatch), valueOf (mtodo Object.valueOf), watch (mtodo Object.watch)
bottom (propiedad Rectangle.bottom)

public bottom : Number

Suma de las propiedades y y height.
Disponibilidad Flash Lite 3.1 Ejemplo El siguiente ejemplo crea un objeto Rectangle y cambia el valor de su propiedad bottom de 15 a 30. Observe que el valor de rect.height tambin cambia, de 10 a 25.
import flash.geom.Rectangle; var rect:Rectangle = new Rectangle(5, 5, 10, 10); trace(rect.height); // 10 trace(rect.bottom); // 15 rect.bottom = 30; trace(rect.height); // 25 trace(rect.bottom); // 30
Vase tambin
y (propiedad Rectangle.y), height (propiedad Rectangle.height)
bottomright (propiedad Rectangle.bottomright)

public bottomRight : Point
La posicin del ngulo inferior derecho del objeto Rectangle viene determinada por los valores x e y.
Disponibilidad Flash Lite 3.1 Ejemplo El siguiente ejemplo establece la propiedad bottomRight del objeto Rectangle utilizando los valores del objeto Point. Observe que tambin cambian los valores de rect.width y rect.height.

import flash.geom.Rectangle; import flash.geom.Point; var rect:Rectangle = new Rectangle(1, 2, 4, 8); trace(rect.bottom); // 10 trace(rect.right); // 5 trace(rect.height); // 8 trace(rect.width); // 4 var myBottomRight:Point = new Point(16, 32); rect.bottomRight = myBottomRight; trace(rect.bottom); // 32 trace(rect.right); // 16 trace(rect.height); // 30 trace(rect.width); // 15
Vase tambin
clone (mtodo Rectangle.clone)

public clone() : Rectangle
Devuelve un objeto Rectangle nuevo con las mismas propiedades x, y, width y height que el objeto Rectangle original. Disponibilidad Flash Lite 3.1 Valor devuelto Rectngulo - Devuelve un objeto Rectangle nuevo con las mismas propiedades x, y, width y height que el objeto Rectangle original. Ejemplo El ejemplo siguiente crea tres objetos Rectangle y los compara. rect_1 se crea utilizando el constructor Rectangle. rect_2 se crea establecindolo como igual a rect_1. Por ltimo, clonedRect se crea clonando rect_1. Observe que mientras que rect_2 se evala como igual a rect_1, no ocurre as con clonedRect, a pesar de contener los mismos valores que rect_1.

import flash.geom.Rectangle; var rect_1:Rectangle = new Rectangle(1, 2, 4, 8); var rect_2:Rectangle = rect_1; var clonedRect:Rectangle = rect_1.clone(); trace(rect_1 == rect_2); // true trace(rect_1 == clonedFilter); // false for(var i in rect_1) { trace(">> " + i + ": " + rect_1[i]); >> toString: [type Function] >> equals: [type Function] >> union: [type Function] >> intersects: [type Function] >> intersection: [type Function] >> containsRectangle: [type Function] >> containsPoint: [type Function] >> contains: [type Function] >> offsetPoint: [type Function] >> offset: [type Function] >> inflatePoint: [type Function] >> inflate: [type Function] >> size: (x=4, y=8) >> bottomRight: (x=5, y=10) >> topLeft: (x=1, y=2) >> bottom: 10 >> top: 2 >> right: 5 >> left: 1 >> isEmpty: [type Function] >> setEmpty: [type Function] >> clone: [type Function] >> height: 8 >> width: 4 >> y: 2 >> x: 1 } for(var i in clonedRect) { trace(">> " + i + ": " + clonedRect[i]); >> toString: [type Function] >> equals: [type Function] >> union: [type Function] >> intersects: [type Function] >> intersection: [type Function] >> containsRectangle: [type Function] >> containsPoint: [type Function]

>> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> }
contains: [type Function] offsetPoint: [type Function] offset: [type Function] inflatePoint: [type Function] inflate: [type Function] size: (x=4, y=8) bottomRight: (x=5, y=10) topLeft: (x=1, y=2) bottom: 10 top: 2 right: 5 left: 1 isEmpty: [type Function] setEmpty: [type Function] clone: [type Function] height: 8 width: 4 y: 2 x: 1
Para continuar mostrando las relaciones existentes entre rect_1, rect_2 y clonedRect, el ejemplo siguiente modifica la propiedad x de rect_1. Al modificar x vemos que el mtodo clone() crea una nueva instancia basada en los valores de rect_1 en vez de apuntar a ellos como referencia.
import flash.geom.Rectangle; var rect_1:Rectangle = new Rectangle(1, 2, 4, 8); var rect_2:Rectangle = rect_1; var clonedRect:Rectangle = rect_1.clone(); trace(rect_1.x); // 1 trace(rect_2.x); // 1 trace(clonedRect.x); // 1 rect_1.x = 10; trace(rect_1.x); // 10 trace(rect_2.x); // 10 trace(clonedRect.x); // 1
Vase tambin
x (propiedad Rectangle.x), y (propiedad Rectangle.y), width (propiedad Rectangle.width), height (propiedad Rectangle.height)
contains (mtodo Rectangle.contains)

public contains(x:Number, y:Number) : Boolean
Determina si el punto especificado est incluido en la regin rectangular definida por este objeto Rectangle. Disponibilidad Flash Lite 3.1

Parmetros x:Number - Valor x (posicin horizontal) del punto. y:Number - Valor y (posicin vertical) del punto. Valor devuelto Boolean - Si el punto especificado est dentro del objeto Rectangle, devuelve true; en caso contrario, devuelve false. Ejemplo El siguiente ejemplo crea un objeto Rectangle y comprueba si tres cada uno de tres pares de coordenadas se encuentran dentro de sus lmites.
import flash.geom.Rectangle; var rect:Rectangle = new Rectangle(10, 10, 50, 50); trace(rect.contains(59, 59)); // true trace(rect.contains(10, 10)); // true trace(rect.contains(60, 60)); // false
Vase tambin
containsPoint (mtodo Rectangle.containsPoint)

public containsPoint(pt:Point (flash.geom.Point)) : Boolean
Determina si el punto especificado est incluido en la regin rectangular definida por este objeto Rectangle. Este mtodo es similar al mtodo Rectangle.contains(), con la salvedad de que toma un objeto Point como parmetro. Disponibilidad Flash Lite 3.1 Parmetros pt:Point - Punto, representado por sus valores x e y. Valor devuelto Boolean - Si el punto especificado est dentro de este objeto Rectangle, devuelve true; en caso contrario, devuelve false. Ejemplo El siguiente ejemplo crea un objeto Rectangle y tres objetos Point, y comprueba si cada uno de estos puntos est dentro de los lmites del rectngulo.
import flash.geom.Rectangle; import flash.geom.Point; var rect:Rectangle = new Rectangle(10, trace(rect.containsPoint(new Point(10, trace(rect.containsPoint(new Point(59, trace(rect.containsPoint(new Point(60, 10, 50, 50); 10))); // true 59))); // true 60))); // false

Vase tambin
contains (mtodo Rectangle.contains), Point (flash.geom.Point)
containsRectangle (mtodo Rectangle.containsRectangle)

public containsRectangle(rect:Rectangle) : Boolean
Determina si el objeto Rectangle especificado por el parmetro rect est contenido en este objeto Rectangle. Se considera que un rectngulo contiene otro si el segundo est completamente incluido dentro de los lmites del primero. Disponibilidad Flash Lite 3.1 Parmetros rect:Rectngulo - El objeto Rectangle que se comprueba. Valor devuelto Boolean - Si el objeto Rectangle que ha especificado est dentro de este objeto Rectangle, devuelve true; en caso contrario, devuelve false. Ejemplo El siguiente ejemplo crea cuatro nuevos objetos Rectangle y determina si el rectngulo A contiene los rectngulos B, C o D.
import flash.geom.Rectangle; var var var var rectA:Rectangle rectB:Rectangle rectC:Rectangle rectD:Rectangle = = = = new new new new Rectangle(10, Rectangle(10, Rectangle(10, Rectangle(15, 10, 10, 10, 15, 50, 50, 51, 45, 50); 50); 51); 45);
trace(rectA.containsRectangle(rectB)); // true trace(rectA.containsRectangle(rectC)); // false trace(rectA.containsRectangle(rectD)); // true
equals (mtodo Rectangle.equals)

public equals(toCompare:Object) : Boolean
Determina si el objeto especificado en el parmetro toCompare es igual a este objeto Rectangle. Este mtodo compara las propiedades x, y, width y height de un objeto con las de este objeto Rectangle. Disponibilidad Flash Lite 3.1 Parmetros toCompare:Object - El rectngulo que desea comparar con este objeto Rectangle. Valor devuelto Boolean - Si el objeto tiene exactamente los mismos valores para las propiedades x, y, width y height que este objeto Rectangle, devuelve true; en caso contrario, devuelve false.

Ejemplo En el siguiente ejemplo, rect_1 y rect_2 son iguales, pero rect_3 no es igual a los otros dos objetos ya que sus propiedades x, y, width y height no son iguales a las correspondientes propiedades de rect_1 y rect_2.
import flash.geom.Rectangle; var rect_1:Rectangle = new Rectangle(0, 0, 50, 100); var rect_2:Rectangle = new Rectangle(0, 0, 50, 100); var rect_3:Rectangle = new Rectangle(10, 10, 60, 110); trace(rect_1.equals(rect_2)); // true; trace(rect_1.equals(rect_3)); // false;
Aunque la firma del mtodo slo espera un objeto abstracto, nicamente se tratarn como iguales otras instancias de objetos Rectangle.
import flash.geom.Rectangle; var rect_1:Rectangle = new Rectangle(0, 0, 50, 100); var nonRect:Object = new Object(); nonRect.x = 0; nonRect.y = 0; nonRect.width = 50; nonRect.height = 100; trace(rect_1.equals(nonRect));
Vase tambin
height (propiedad Rectangle.height)

public height : Number
La altura del rectngulo en pxeles. El cambio del valor de height de un objeto Rectangle no afecta a las propiedades x, y y width.
Disponibilidad Flash Lite 3.1 Ejemplo El siguiente ejemplo crea un objeto Rectangle y cambia su propiedad height de 10 a 20. Observe que tambin cambia rect.bottom.

import flash.geom.Rectangle; var rect:Rectangle = new Rectangle(5, 5, 10, 10); trace(rect.height); // 10 trace(rect.bottom); // 15 rect.height = 20; trace(rect.height); // 20 trace(rect.bottom); // 25
Vase tambin
x (propiedad Rectangle.x), y (propiedad Rectangle.y), width (propiedad Rectangle.width)
inflate (mtodo Rectangle.inflate)

public inflate(dx:Number, dy:Number) : Void
Aumenta el tamao del objeto Rectangle segn las cantidades especificadas. El punto central del objeto Rectangle permanece igual y su tamao aumenta hacia la izquierda y la derecha en funcin del valor dx y hacia arriba y abajo segn el valor dy. Disponibilidad Flash Lite 3.1 Parmetros dx:Number - Valor que se aadir a la izquierda y derecha del objeto Rectangle. La ecuacin que se utiliza para calcular la nueva anchura y la posicin del rectngulo es la siguiente:
x -= dx; width += 2 * dx;
dy:Number - Valor que se aadir por arriba y por abajo del objeto Rectangle. La ecuacin que se utiliza para calcular la nueva altura y la posicin del rectngulo es la siguiente.
y -= dy; height += 2 * dy;
Ejemplo El siguiente ejemplo crea un objeto Rectangle y aumenta el valor de su propiedad width por 16 * 2 (32) y su propiedad height por 32 * 2 (64)
import flash.geom.Rectangle; var rect:Rectangle = new Rectangle(1, 2, 4, 8); trace(rect.toString()); // (x=1, y=2, w=4, h=8) rect.inflate(16, 32); trace(rect.toString()); // (x=-15, y=-30, w=36, h=72)
Vase tambin
x (propiedad Rectangle.x), y (propiedad Rectangle.y)

inflatePoint (mtodo Rectangle.inflatePoint)

public inflatePoint(pt:Point) : Void
Aumenta el tamao del objeto Rectangle. Este mtodo es similar al mtodo Rectangle.inflate(), con la salvedad de que toma un objeto Point como parmetro. Los siguientes dos ejemplos de cdigo logran el mismo resultado:
rect1 = new flash.geom.Rectangle(0,0,2,5); rect1.inflate(2,2) rect1 = new flash.geom.Rectangle(0,0,2,5); pt1 = new flash.geom.Point(2,2); rect1.inflatePoint(pt1)
Disponibilidad Flash Lite 3.1 Parmetros pt:Point - Aumenta el rectngulo con los valores de las coordenadas x e y del punto. Ejemplo El siguiente ejemplo crea un objeto Rectangle y lo aumenta con las cantidades x (horizontal) e y (vertical) de un punto.
import flash.geom.Rectangle; import flash.geom.Point; var rect:Rectangle = new Rectangle(0, 0, 2, 5); trace(rect.toString()); // (x=0, y=0, w=2, h=5 var myPoint:Point = new Point(2, 2); rect.inflatePoint(myPoint); trace(rect.toString()); // (x=-2, y=-2, w=6, h=9)
Vase tambin
intersection (mtodo Rectangle.intersection)

public intersection(toIntersect:Rectangle) : Rectangle
Si el objeto Rectangle especificado en el parmetro toIntersect presenta un punto de interseccin con este objeto, el mtodo intersection() devuelve el rea de interseccin como un objeto Rectangle. Si los rectngulos no presentan un punto de interseccin, este mtodo devuelve un objeto Rectangle vaco con las propiedades definidas en 0.

Parmetros toIntersect:Rectngulo - Objeto Rectangle que quiere comparar para determinar si presenta un punto de interseccin con este objeto Rectangle. Valor devuelto Rectngulo - Objeto Rectangle que equivale al rea de interseccin. Si los rectngulos no presentan un punto de interseccin, este mtodo devuelve un objeto Rectangle vaco con las propiedades x, y, width y height definidas como 0. Ejemplo El siguiente ejemplo determina el rea en la que rect_1 intersecta a rect_2.
import flash.geom.Rectangle; var rect_1:Rectangle = new Rectangle(0, 0, 50, 50); var rect_2:Rectangle = new Rectangle(25, 25, 100, 100); var intersectingArea:Rectangle = rect_1.intersection(rect_2); trace(intersectingArea.toString()); // (x=25, y=25, w=25, h=25)
intersects (mtodo Rectangle.intersects)

public intersects(toIntersect:Rectangle) : Boolean
Determina si el objeto especificado en el parmetro toIntersect presenta un punto de interseccin con este objeto Rectangle. Este mtodo comprueba las propiedades x, y, width y height del objeto Rectangle especificado para determinar si presenta un punto de interseccin con este objeto Rectangle. Disponibilidad Flash Lite 3.1 Parmetros toIntersect:Rectngulo - El objeto Rectangle que se va a comparar con este objeto Rectangle. Valor devuelto Boolean - Si el objeto especificado tiene un rea de interseccin con este objeto Rectangle, devuelve true; en caso contrario, devuelve false. Ejemplo El siguiente ejemplo determina si rectA tiene un rea de interseccin con rectB o rectC.
import flash.geom.Rectangle; var rectA:Rectangle = new Rectangle(10, 10, 50, 50); var rectB:Rectangle = new Rectangle(59, 59, 50, 50); var rectC:Rectangle = new Rectangle(60, 60, 50, 50); var rectAIntersectsB:Boolean = rectA.intersects(rectB); var rectAIntersectsC:Boolean = rectA.intersects(rectC); trace(rectAIntersectsB); // true trace(rectAIntersectsC); // false var firstPixel:Rectangle = new Rectangle(0, 0, 1, 1); var adjacentPixel:Rectangle = new Rectangle(1, 1, 1, 1); var pixelsIntersect:Boolean = firstPixel.intersects(adjacentPixel); trace(pixelsIntersect); // false

Vase tambin
isEmpty (mtodo Rectangle.isEmpty)

public isEmpty() : Boolean
Determina si este objeto Rectangle est vaco o no. Disponibilidad Flash Lite 3.1 Valor devuelto
Boolean en la pgina 222 - Si la anchura o la altura de un objeto Rectangle es menor o igual que 0, devuelve true; en caso contrario, devuelve false.
Ejemplo El siguiente ejemplo crea un objeto Rectangle vaco y comprueba que est vaco.
import flash.geom.*; var rect:Rectangle = new Rectangle(1, 2, 0, 0); trace(rect.toString()); // (x=1, y=2, w=0, h=0) trace(rect.isEmpty()); // true
El siguiente ejemplo crea un objeto Rectangle que no est vaco y hace que pase a estar vaco.
import flash.geom.Rectangle; var rect:Rectangle = new Rectangle(1, 2, 4, 8); trace(rect.isEmpty()); // false rect.width = 0; trace(rect.isEmpty()); // true rect.width = 4; trace(rect.isEmpty()); // false rect.height = 0; trace(rect.isEmpty()); // true
left (propiedad Rectangle.left)

public left : Number
La coordenada x del ngulo superior izquierdo del rectngulo. El cambio del valor de x de un objeto Rectangle no afecta a las propiedades y, width y height. La propiedad left es igual a la propiedad x.

Disponibilidad Flash Lite 3.1 Ejemplo El siguiente ejemplo cambia la propiedad left de 0 a 10. Observe que rect.x tambin cambia.
import flash.geom.Rectangle; var rect:Rectangle = new Rectangle(); trace(rect.left); // 0 trace(rect.x); // 0 rect.left = 10; trace(rect.left); // 10 trace(rect.x); // 10
Vase tambin
x (propiedad Rectangle.x), y (propiedad Rectangle.y), width (propiedad Rectangle.width) en la pgina 548, height (propiedad Rectangle.height)
offset (mtodo Rectangle.offset)

public offset(dx:Number, dy:Number) : Void
Ajusta la posicin del objeto Rectangle, definida por su ngulo superior izquierdo, segn las cantidades especificadas. Disponibilidad Flash Lite 3.1 Parmetros dx:Number - Desplaza el valor x del objeto Rectangle segn esta cantidad. dy:Number - Desplaza el valor y del objeto Rectangle segn esta cantidad. Ejemplo El siguiente ejemplo crea un objeto Rectangle y desplaza sus valores x e y en 5 y 10 respectivamente.
import flash.geom.Rectangle; var rect:Rectangle = new Rectangle(1, 2, 4, 8); trace(rect.toString()); // (x=1, y=2, w=4, h=8) rect.offset(16, 32); trace(rect.toString()); // (x=17, y=34, w=4, h=8)
offsetPoint (mtodo Rectangle.offsetPoint)

public offsetPoint(pt:Point) : Void
Ajusta la ubicacin del objeto Rectangle utilizando un objeto Point como parmetro. Este mtodo es similar al mtodo Rectangle.offset(), con la salvedad de que toma un objeto Point como parmetro.

Disponibilidad Flash Lite 3.1 Parmetros pt:Point - Un objeto Point que se va a utilizar para desplazar este objeto Rectangle. Ejemplo El siguiente ejemplo desplaza un rectngulo utilizando los valores de un punto.
import flash.geom.Rectangle; import flash.geom.Point; var rect:Rectangle = new Rectangle(1, 2, 4, 8); trace(rect.toString()); // (x=1, y=2, w=4, h=8) var myPoint:Point = new Point(16, 32); rect.offsetPoint(myPoint); trace(rect.toString()); // (x=17, y=34, w=4, h=8)
Vase tambin
Constructor Rectangle
public Rectangle(x:Number, y:Number, width:Number, height:Number)
Crea un nuevo objeto Rectangle cuya esquina superior izquierda est especificada por los parmetros x e y. Si llama a esta funcin sin ningn parmetro, se crear un rectngulo con las propiedades x, y, width y height definidas en 0. Disponibilidad Flash Lite 3.1 Parmetros x:Number - La coordenada x del ngulo superior izquierdo del rectngulo. y:Number - La coordenada y del ngulo superior izquierdo del rectngulo. width:Number - Anchura del rectngulo, en pxeles. height:Number - La altura del rectngulo en pxeles. Ejemplo El siguiente ejemplo crea un objeto Rectangle con los parmetros especificados.
import flash.geom.Rectangle; var rect:Rectangle = new Rectangle(5, 10, 50, 100); trace(rect.toString()); // (x=5, y=10, w=50, h=100)
Vase tambin
x (propiedad Rectangle.x), y (propiedad Rectangle.y), width (propiedad Rectangle.width) en la pgina 548, height (propiedad Rectangle.height)

right (propiedad Rectangle.right)

public right : Number
Suma de las propiedades x y width.
Disponibilidad Flash Lite 3.1 Ejemplo El siguiente ejemplo crea un objeto Rectangle y cambia su propiedad right de 15 a 30. Observe que rect.width tambin cambia.
import flash.geom.Rectangle; var rect:Rectangle = new Rectangle(5, 5, 10, 10); trace(rect.width); // 10 trace(rect.right); // 15 rect.right = 30; trace(rect.width); // 25 trace(rect.right); // 30
Vase tambin
x (propiedad Rectangle.x), width (propiedad Rectangle.width)
setEmpty (mtodo Rectangle.setEmpty)

public setEmpty() : Void
Establece todas las propiedades del objeto Rectangle en 0. Un objeto Rectangle est vaco si su anchura o su altura es igual o menor que 0. Este mtodo establece los valores de las propiedades x, y, width y height en 0. Disponibilidad Flash Lite 3.1 Ejemplo El siguiente ejemplo crea un objeto Rectangle que no est vaco y hace que pase a estar vaco.
import flash.geom.Rectangle; var rect:Rectangle = new Rectangle(5, 10, 50, 100); trace(rect.isEmpty()); // false rect.setEmpty(); trace(rect.isEmpty()); // true

Vase tambin
size (propiedad Rectangle.size)

public size : Point
El tamao del objeto Rectangle, expresado como un objeto Point con valores width y height. Disponibilidad Flash Lite 3.1 Ejemplo El siguiente ejemplo crea un objeto Rectangle, recupera su tamao (size), cambia su tamao (size) y establece los nuevos valores del objeto Rectangle. Es importante recordar que el objeto Point utilizado por la propiedad size emplea los valores x e y para representar las propiedades width y height del objeto Rectangle.
import flash.geom.Rectangle; import flash.geom.Point; var rect:Rectangle = new Rectangle(1, 2, 4, 8); var size:Point = rect.size; trace(size.x); // 4; trace(size.y); // 8; size.x = 16; size.y = 32; rect.size = size; trace(rect.x); // 1 trace(rect.y); // 2 trace(rect.width); // 16 trace(rect.height); // 32
Vase tambin
top (propiedad Rectangle.top)

public top : Number
La coordenada y del ngulo superior izquierdo del rectngulo. El cambio del valor de la propiedad top de un objeto Rectangle no afecta a las propiedades x, width o height. El valor de la propiedad top es igual que el valor de la propiedad y.

Disponibilidad Flash Lite 3.1 Ejemplo Este ejemplo cambia el valor de la propiedad top de 0 a 10. Observe que rect.y tambin cambia.
import flash.geom.Rectangle; var rect:Rectangle = new Rectangle(); trace(rect.top); // 0 trace(rect.y); // 0 rect.top = 10; trace(rect.top); // 10 trace(rect.y); // 10
Vase tambin
topLeft (propiedad Rectangle.topLeft)

public topLeft : Point
La posicin del ngulo superior izquierdo del objeto Rectangle viene determinada por los valores x e y del punto.
Disponibilidad Flash Lite 3.1 Ejemplo El siguiente ejemplo establece la propiedad topLeft del objeto Rectangle utilizando los valores del objeto Point. Observe que tambin cambian los valores de rect.x y rect.y.

import flash.geom.Rectangle; import flash.geom.Point; var rect:Rectangle = new Rectangle(); trace(rect.left); // 0 trace(rect.top); // 0 trace(rect.x); // 0 trace(rect.y); // 0 var myTopLeft:Point = new Point(5, 15); rect.topLeft = myTopLeft; trace(rect.left); // 5 trace(rect.top); // 15 trace(rect.x); // 5 trace(rect.y); // 15
Vase tambin
Point (flash.geom.Point), x (propiedad Rectangle.x), y (propiedad Rectangle.y)
toString (mtodo Rectangle.toString)

Crea y devuelve una cadena en la que se indican las posiciones horizontal y vertical, as como la anchura y la altura, del objeto Rectangle. Disponibilidad Flash Lite 3.1 Valor devuelto String - Cadena con el valor de cada una de las siguientes propiedades del objeto Rectangle: x, y, width y height. Ejemplo El siguiente ejemplo concatena una representacin en forma de cadena de rect_1 con texto til para la depuracin.
import flash.geom.Rectangle; var rect_1:Rectangle = new Rectangle(0, 0, 50, 100); trace("Rectangle 1 : " + rect_1.toString()); // Rectangle 1 : (x=0, y=0, w=50, h=100)
Vase tambin
union (mtodo Rectangle.union)

public union(toUnion:Rectangle) : Rectangle

Une dos rectngulos para crear un objeto Rectangle nuevo, y rellena los espacios horizontal y vertical que quedan entre los dos rectngulos.
Disponibilidad Flash Lite 3.1 Parmetros toUnion:Rectngulo - El objeto Rectangle que se va a aadir a este objeto Rectangle. Valor devuelto Rectngulo - Nuevo objeto Rectangle que es la unin de los dos rectngulos. Ejemplo El siguiente ejemplo crea un objeto Rectangle uniendo dos rectngulos. Por ejemplo, imaginemos un rectngulo con las propiedades x=20, y=50, width=60 y height=30 (20, 50, 60, 30), y un segundo rectngulo con las propiedades (150, 130, 50, 30). La unin de estos dos rectngulos ser un rectngulo de mayor tamao que abarque los dos rectngulos con las propiedades (20, 50, 180, 110).
import flash.geom.Rectangle; var rect_1:Rectangle = new Rectangle(20, 50, 60, 30); var rect_2:Rectangle = new Rectangle(150, 130, 50, 30); var combined:Rectangle = rect_1.union(rect_2); trace(combined.toString()); // (x=20, y=50, w=180, h=110)
width (propiedad Rectangle.width)

public width : Number
Anchura del rectngulo, en pxeles. El cambio del valor de la propiedad width de un objeto Rectangle no afecta a las propiedades x, y o height.

Ejemplo El siguiente ejemplo crea un objeto Rectangle y cambia su propiedad width de 10 a 20. Observe que rect.right tambin cambia.
import flash.geom.Rectangle; var rect:Rectangle = new Rectangle(5, 5, 10, 10); trace(rect.width); // 10 trace(rect.right); // 15 rect.width = 20; trace(rect.width); // 20 trace(rect.right); // 25
Vase tambin
x (propiedad Rectangle.x), y (propiedad Rectangle.y), height (propiedad Rectangle.height)
x (propiedad Rectangle.x)
public x : Number
La coordenada x del ngulo superior izquierdo del rectngulo. El cambio del valor de la propiedad x de un objeto Rectangle no afecta a las propiedades y, width o height. La propiedad x es igual a la propiedad left. Disponibilidad Flash Lite 3.1 Ejemplo El siguiente ejemplo crea un rectngulo vaco y establece su propiedad x a 10. Observe que tambin cambia rect.left.
import flash.geom.Rectangle; var rect:Rectangle = new Rectangle(); trace(rect.x); // 0 trace(rect.left); // 0 rect.x = 10; trace(rect.x); // 10 trace(rect.left); // 10
Vase tambin
left (propiedad Rectangle.left)
y (propiedad Rectangle.y)
public y : Number
La coordenada y del ngulo superior izquierdo del rectngulo. El cambio del valor de la propiedad y de un objeto Rectangle no afecta a las propiedades x, width o height. La propiedad y es igual a la propiedad top.

Disponibilidad Flash Lite 3.1 Ejemplo El siguiente ejemplo crea un rectngulo vaco y establece su propiedad y a 10. Observe que tambin cambia rect.top.
import flash.geom.Rectangle; var rect:Rectangle = new Rectangle(); trace(rect.y); // 0 trace(rect.top); // 0 rect.y = 10; trace(rect.y); // 10 trace(rect.top); // 10
Vase tambin
x (propiedad Rectangle.x), width (propiedad Rectangle.width), height (propiedad Rectangle.height)top (propiedad Rectangle.top)
Security (System.security)
Object | +-System.security public class security extends Object
La clase System.security contiene mtodos que especifican cmo pueden comunicarse entre s los archivos SWF de diferentes dominios. Disponibilidad Flash Lite 2.0 Resumen de propiedades Propiedades heredadas de la clase Object

Resumen de mtodos
Modificadores
static
Firma
Descripcin
allowDomain(domain1:S Permite a los archivos SWF y HTML de los dominios tring) : Void identificados acceder a los objetos y variables del archivo SWF que llama o de cualquier otro archivo SWF del mismo dominio que el archivo SWF que llama. allowInsecureDomain(do main:String) : Void Permite a los archivos SWF y HTML de los dominios identificados acceder a los objetos y variables del archivo SWF que llama, que se aloja mediante el protocolo HTTPS.
static
static
loadPolicyFile(url:String Carga un archivo de poltica para distintos dominios de una ) : Void ubicacin especificada por el parmetro url.

allowDomain (mtodo security.allowDomain)

public static allowDomain(domain1:String) : Void
Permite a los archivos SWF y HTML de los dominios identificados acceder a los objetos y variables del archivo SWF que llama o de cualquier otro archivo SWF del mismo dominio que el archivo SWF que llama. En archivos que se reproducen en Flash Player 7 o posterior, los parmetros transferidos deben seguir las reglas de nomenclatura de dominio exacto. Por ejemplo, para permitir el acceso a los archivos SWF alojados en www.domain.com o en store.domain.com, se deben transferir ambos nombres de dominio:
// For Flash Player 6 System.security.allowDomain("domain.com"); // Corresponding commands to allow access by SWF files // that are running in Flash Player 7 or later System.security.allowDomain("www.domain.com", "store.domain.com");
Asimismo, en el caso de archivos que se ejecutan en Flash Player 7 o en versiones posteriores, no se podr utilizar este mtodo para permitir que los archivos SWF alojados mediante un protocolo seguro (HTTPS) permitan el acceso desde archivos SWF alojados en protocolos no seguros; en ese caso se debe utilizar System.security.allowInsecureDomain(). Es posible que, en ocasiones, se encuentre con la siguiente situacin: El usuario carga un archivo SWF secundario de un dominio diferente y desea que el archivo SWF secundario pueda crear un guin en el archivo SWF principal, pero no conoce el dominio final del que proceder el archivo SWF secundario. Esto puede ocurrir, por ejemplo, cuando se utilizan redirecciones de reparto de carga o servidores de terceros. En esta situacin, puede utilizar la propiedad MovieClip._url como argumento de este mtodo. Por ejemplo, si carga un archivo SWF en my_mc, podr llamar a System.security.allowDomain(my_mc._url). Si lo hace, espere a que se cargue el archivo SWF de my_mc, ya que la propiedad _url no dispondr de su valor final correcto hasta que el archivo est completamente cargado. El mejor modo de determinar si un archivo SWF secundario ha finalizado la carga es utilizar MovieClipLoader.onLoadComplete.

Tambin puede darse la situacin contraria, es decir, podra crear un archivo SWF secundario en el que desee que su archivo principal use guiones, pero no conoce cul ser el dominio de su archivo principal. En este caso, llame a System.security.allowDomain(_parent._url) desde el archivo SWF secundario. En este caso, no tendr que esperar a que se cargue el archivo SWF principal; el archivo principal ya estar cargado en el momento en que se cargue el archivo secundario. Disponibilidad Flash Lite 2.0 Parmetros domain1:String - Una o varias cadenas que especifican dominios que tienen acceso a objetos y variables del archivo SWF que contiene la llamada a System.Security.allowDomain(). Los dominios pueden presentar formatos diferentes:
"domain.com" "http://domain.com" "http://IPaddress"
Ejemplo El archivo SWF ubicado en www.macromedia.com/MovieA.swf contiene las lneas siguientes:

System.security.allowDomain("www.shockwave.com"); loadMovie("http://www.shockwave.com/MovieB.swf", my_mc);
Como MovieA contiene la llamada allowDomain(), MovieB puede acceder a los objetos y variables de MovieA. Si MovieA no contuviera esta llamada, la funcin de seguridad de Flash Player impedira que MovieB accediese a los objetos y variables de MovieA. Vase tambin
onLoadComplete (detector de eventos MovieClipLoader.onLoadComplete), _parent (propiedad MovieClip._parent), _url (propiedad MovieClip._url), allowInsecureDomain (mtodo security.allowInsecureDomain)
allowInsecureDomain (mtodo security.allowInsecureDomain)

public static allowInsecureDomain(domain:String) : Void
Permite a los archivos SWF y HTML de los dominios identificados acceder a los objetos y variables del archivo SWF que llama, que se aloja mediante el protocolo HTTPS. Tambin permite que los archivos SWF de los dominios identificados puedan acceder a otros archivos SWF del mismo dominio que el archivo SWF que llama. De manera predeterminada, slo los archivos SWF alojados mediante un protocolo HTTPS pueden acceder a otros archivos SWF alojados mediante el protocolo HTTPS. Esta implementacin mantiene la integridad que ofrece el protocolo HTTPS. Adobe desaconseja utilizar este mtodo para sustituir el comportamiento predeterminado, ya que pone en riesgo la seguridad HTTPS. Sin embargo, es posible que tenga que hacerlo, por ejemplo, si necesita permitir el acceso a archivos HTTPS publicados para Flash Player 7 o posterior desde archivos HTTP publicados para Flash Player 6.

Un archivo SWF publicado para Flash Player 6 puede utilizar System.security.allowDomain() para permitir acceso HTTP a HTTPS. Sin embargo, dado que la seguridad se implementa de forma distinta en Flash Player 7, se debe utilizar System.Security.allowInsecureDomain() para permitir dicho acceso en archivos SWF publicados para Flash Player 7 o versiones posteriores. Nota: a veces resulta necesario llamar a System.security.allowInsecureDomain() con un argumento que coincida exactamente con el dominio del archivo SWF en el que aparece la llamada. No es lo mismo que el mtodo System.security.allowDomain(), al que no es necesario llamar nunca con el dominio propio de un archivo SWF como argumento. El motivo por el que a veces s es necesario hacerlo con System.security.allowInsecureDomain() es que, de forma predeterminada, un archivo SWF en http://foo.com no podr crear un guin de un archivo SWF en https://foo.com, incluso si los dominios son idnticos. Disponibilidad Flash Lite 2.0 Parmetros domain:String - Nombre de dominio exacto, por ejemplo www.myDomainName.com o store.myDomainName.com. Ejemplo En el ejemplo siguiente usted aloja un examen de matemticas en un dominio seguro, de forma que slo puedan acceder a l los estudiantes registrados. Tambin ha creado una serie de archivos SWF que ilustran determinados conceptos, que estn alojados en un dominio no seguro. Quiere que los estudiantes accedan al examen desde el archivo SWF que contiene la informacin relacionada con un concepto.
// This SWF file is at https://myEducationSite.somewhere.com/mathTest.swf // Concept files are at http://myEducationSite.somewhere.com System.security.allowInsecureDomain("myEducationSite.somewhere.com");
Vase tambin
allowDomain (mtodo security.allowDomain)
loadPolicyFile (mtodo security.loadPolicyFile)

public static loadPolicyFile(url:String) : Void
Carga un archivo de poltica para distintos dominios de una ubicacin especificada por el parmetro url. Flash Lite Player utiliza archivos de poltica como mecanismo de permiso para permitir que las pelculas Flash carguen datos desde servidores que no sean el suyo propio. Flash Player 7.0.14.0 buscaba archivos de poltica slo en una ubicacin: /crossdomain.xml en el servidor al que se haba solicitado una peticin de carga de datos. Para un intento de conexin XMLSocket, Flash Player 7.0.14.0 buscaba /crossdomain.xml en un servidor HTTP (puerto 80) del subdominio en el que se intentaba realizar la conexin XMLSocket. Flash Player 7.0.14.0 (y todos los reproductores anteriores) tambin limitaban las conexiones XMLSocket a los puertos 1024 y posteriores. Con la incorporacin de System.security.loadPolicyFile(), Flash Player 7.0.19.0 puede cargar archivos de poltica de ubicaciones arbitrarias, como se muestra en el siguiente ejemplo:
System.security.loadPolicyFile("http://foo.com/sub/dir/pf.xml");
De este modo, Flash Player recupera un archivo de poltica de la URL especificada. Los permisos otorgados por el archivo de poltica de dicha ubicacin se aplicarn a todo el contenido del mismo nivel o de un nivel inferior de la jerarqua de directorios virtual del servidor. El siguiente cdigo es continuacin del ejemplo anterior:

loadVariables("http://foo.com/sub/dir/vars.txt") // allowed loadVariables("http://foo.com/sub/dir/deep/vars2.txt") // allowed loadVariables("http://foo.com/elsewhere/vars3.txt") // not allowed
Puede utilizar loadPolicyFile() para cargar los archivos de poltica que desee. Al considerar una solicitud que requiere un archivo de poltica, Flash Player siempre espera a que termine la descarga de archivos de poltica antes de denegar una solicitud. Como opcin final, si no hay ningn archivo de poltica especificado con loadPolicyFile() que autorice una solicitud, Flash Player consulta la ubicacin predeterminada original: /crossdomain.xml. La utilizacin del protocolo xmlsocket con un nmero de puerto especfico le permite recuperar archivos de poltica directamente de un servidor XMLSocket, como se muestra en el siguiente ejemplo:
System.security.loadPolicyFile("xmlsocket://foo.com:414");
De este modo, Flash Player intenta recuperar un archivo de poltica desde el host y el puerto especificados. Puede utilizarse cualquier puerto, no slo los puertos 1024 y superiores. Tras establecer una conexin con el puerto especificado, Flash Player transmite <policy-file-request />, terminada por un byte null. Puede configurarse un servidor XMLSocket para que responda a solicitudes de archivos de poltica y a conexiones XMLSocket normales en el mismo puerto; en este caso, el servidor deber esperar <policy-file-request /> antes de transmitir un archivo de poltica. Tambin puede configurarse un servidor para que responda a peticiones de archivos de poltica en un puerto distinto de las conexiones estndar; en este caso, el servidor puede enviar un archivo de poltica en cuanto se establece una conexin en el puerto del archivo de poltica dedicado. El servidor debe enviar un byte nulo para terminar un archivo de poltica y ms tarde podr cerrar la conexin; si el servidor no cierra la conexin, Flash Player la cerrar despus de recibir el byte null de terminacin. Un archivo de poltica proporcionado por un servidor XMLSocket tiene la misma sintaxis que cualquier otro archivo de poltica, pero debe especificar tambin los puertos a los que se concede el acceso. Cuando un archivo de poltica procede de un puerto inferior a 1024, dicho archivo puede conceder acceso a cualquier puerto; cuando un archivo de poltica procede del puerto 1024 o superior, slo puede conceder acceso a otros puertos 1024 y superiores. Los puertos permitidos se especifican en el atributo "to-ports" de la etiqueta <allow-access-from>. Los nmeros de puerto nicos, los intervalos de puertos y los comodines estn permitidos. El siguiente ejemplo muestra un archivo de poltica XMLSocket:
<cross-domain-policy> <allow-access-from domain="*" to-ports="507" /> <allow-access-from domain="*.foo.com" to-ports="507,516" /> <allow-access-from domain="*.bar.com" to-ports="516-523" /> <allow-access-from domain="www.foo.com" to-ports="507,516-523" /> <allow-access-from domain="www.bar.com" to-ports="*" /> </cross-domain-policy>
Un archivo de poltica procedente de la ubicacin predeterminada original (/crossdomain.xml en un servidor HTTP del puerto 80) autoriza implcitamente el acceso a todos los puertos 1024 y superiores. No hay ninguna manera de recuperar un archivo de poltica que autorice operaciones de XMLSocket desde cualquier otra ubicacin de un servidor HTTP; las ubicaciones personalizadas para los archivos de poltica XMLSocket deben encontrarse en un servidor XMLSocket. Dado que la capacidad de conectar con puertos inferiores a 1024 es una novedad, para autorizar esta conexin siempre es necesario un archivo de poltica cargado con loadPolicyFile(), incluso cuando un clip de pelcula se conecta a su propio subdominio. Disponibilidad Flash Lite 2.0

Parmetros url:String - Cadena: URL en la que se encuentra el archivo de poltica de varios dominios que se va a cargar.
Selection
Object | +-Selection public class Selection extends Object
La clase Selection permite establecer y controlar el campo de texto en el que se encuentra el punto de insercin (es decir, el campo seleccionado). Los ndices de espacio de seleccin estn basados en cero (por ejemplo, la primera posicin es 0, la segunda posicin es 1, etc.). No existe ninguna funcin constructora para la clase Selection, ya que slo puede haber un campo seleccionado a la vez. El objeto Selection es vlido slo si el dispositivo admite la introduccin de texto en lnea. Si un dispositivo no admite la introduccin de texto en lnea y se necesita un procesador principal (FEP) para introducir texto, se har caso omiso de todas las llamadas al objeto Selection. Disponibilidad Flash Lite 2.0 Resumen de propiedades Propiedades heredadas de la clase Object
Resumen de eventos
Evento onSetFocus =
function([oldfocus] , [newfocus]) {}
Descripcin Recibe una notificacin cuando cambia la seleccin de entrada.
Resumen de mtodos
Modificadores
static
Firma addListener(listener: Object) : Void getFocus() : String
Descripcin Registra un objeto para recibir notificaciones de cambio de seleccin con el teclado. Devuelve una cadena que especifica la ruta de destino del objeto que est seleccionado con el teclado.
static

Modificadores
static
Firma
Descripcin
removeListener(listene Elimina un objeto registrado previamente con el mtodo r:Object) : Boolean Selection.addListener(). setFocus(newFocus:Obj ect) : Boolean Selecciona con el teclado el campo de texto, botn o clip de pelcula seleccionable (editable) especificado por el parmetro newFocus. Establece el espacio de seleccin del campo de texto seleccionado actualmente.
static
static
setSelection(beginInde x:Number, endIndex:Number) : Void

addListener (mtodo Selection.addListener)

Registra un objeto para recibir notificaciones de cambio de seleccin con el teclado. Cuando se selecciona con el teclado otro elemento (por ejemplo, cuando se invoca el mtodo Selection.setFocus()), se invocar el mtodo addListener() de cada objeto detector registrado en onSetFocus(). El cambio de seleccin del teclado pueden detectarlo varios objetos. Si el detector especificado ya se ha registrado, no se producir ningn cambio. Disponibilidad Flash Lite 2.0 Parmetros listener:Object - Nuevo objeto con un mtodo onSetFocus. Ejemplo El ejemplo siguiente crea dos campos de introduccin de texto en tiempo de ejecucin y define los bordes de cada campo de texto como true. Este cdigo crea un objeto de ActionScript nuevo (genrico) denominado ocusListener. Este objeto define para s mismo una propiedad onSetFocus, a la cual asigna una funcin. La funcin est formada por dos parmetros: una referencia al campo de texto que ha dejado de estar seleccionado y una referencia al campo de texto que pasa a estar seleccionado. La funcin define la propiedad border del campo de texto que ha dejado de estar seleccionado con el valor false y define la propiedad border del campo que pasa a estar seleccionado con el valor true:

this.createTextField("one_txt", 99, 10, 10, 200, 20); this.createTextField("two_txt", 100, 10, 50, 200, 20); one_txt.border = true; one_txt.type = "input"; two_txt.border = true; two_txt.type = "input"; var focusListener:Object = new Object(); focusListener.onSetFocus = function(oldFocus_txt, newFocus_txt) { oldFocus_txt.border = false; newFocus_txt.border = true; }; Selection.addListener(focusListener);
Vase tambin
setFocus (mtodo Selection.setFocus)
getFocus (mtodo Selection.getFocus)

public static getFocus() : String
Devuelve una cadena que especifica la ruta de destino del objeto que est seleccionado con el teclado.
Si un objeto TextField est seleccionado con el teclado y tiene un nombre de instancia, el mtodo getFocus()
devuelve la ruta de destino del objeto TextField. En caso contrario, devuelve el nombre de la variable TextField.
Si un objeto Button o un clip de pelcula de botn est seleccionado con el teclado, el mtodo getFocus() devuelve
la ruta de destino del objeto Button o el clip de pelcula de botn.
Si no hay seleccionado con el teclado un objeto TextField, un objeto Button, una instancia de componente ni un
clip de pelcula de botn, el mtodo getFocus() devuelve el valor null. Disponibilidad Flash Lite 2.0 Valor devuelto String - Cadena o null. Ejemplo El siguiente ejemplo crea un campo de texto para mostrar la ruta del objeto seleccionado actualmente. A continuacin, utiliza una funcin interval para actualizar peridicamente el campo. Para probarlo, aade varias instancias de botones en el escenario con distintos nombres de instancia y, a continuacin, aade el siguiente cdigo ActionScript al archivo AS o FLA.

this.createTextField("status_txt", this.getNextHighestDepth(), 0, 0, 150, 25); function FocusUpdate() { s = Selection.getFocus(); if ( s ) { status_txt.text = s; } } setInterval( FocusUpdate, 100 );
Vase tambin
onSetFocus (detector de eventos Selection.onSetFocus), setFocus (mtodo Selection.setFocus)
onSetFocus (detector de eventos Selection.onSetFocus)

onSetFocus = function([oldfocus], [newfocus]) {}
Recibe una notificacin cuando cambia la seleccin de entrada. Para utilizar este detector, debe crearse un objeto detector. A continuacin puede definir una funcin para este detector y utilizar el mtodo Selection.addListener() para registrar el detector con el objeto Selection, como en el cdigo siguiente:
var someListener:Object = new Object(); someListener.onSetFocus = function () { // statements } Selection.addListener(someListener);
Los detectores permiten que diversas partes del cdigo cooperen, ya que varios detectores pueden recibir notificacin de un solo evento. Disponibilidad Flash Lite 2.0 Parmetros oldfocus: [opcional] - El objeto que deja de estar seleccionado. newfocus: [opcional] - El objeto que se selecciona. Ejemplo El ejemplo siguiente indica cmo determinar cundo cambia la seleccin de entrada en un archivo SWF entre varios campos de texto creados de forma dinmica. Introduzca el siguiente cdigo ActionScript en un archivo FLA o AS y pruebe el documento:

this.createTextField("one_txt", 1, 0, 0, 100, 22); this.createTextField("two_txt", 2, 0, 25, 100, 22); this.createTextField("three_txt", 3, 0, 50, 100, 22); this.createTextField("four_txt", 4, 0, 75, 100, 22); for (var i in this) { if (this[i] instanceof TextField) { this[i].border = true; this[i].type = "input"; } } this.createTextField("status_txt", this.getNextHighestDepth(), 200, 10, 300, 100); status_txt.html = true; status_txt.multiline = true; var someListener:Object = new Object(); someListener.onSetFocus = function(oldFocus, newFocus) { status_txt.htmlText = "setFocus triggered"; status_txt.htmlText += "<textformat tabStops='[20,80]'>"; status_txt.htmlText += " \toldFocus:\t"+oldFocus; status_txt.htmlText += " \tnewFocus:\t"+newFocus; status_txt.htmlText += " \tgetFocus:\t"+Selection.getFocus(); status_txt.htmlText += "</textformat>"; }; Selection.addListener(someListener);
Vase tambin
addListener (mtodo Selection.addListener), setFocus (mtodo Selection.setFocus)
removeListener (mtodo Selection.removeListener)

Elimina un objeto registrado previamente con el mtodo Selection.addListener(). Disponibilidad Flash Lite 2.0 Parmetros listener:Object - Objeto que ya no recibe notificaciones de seleccin. Valor devuelto Boolean - Si el listener se ha eliminado correctamente, el mtodo devolver un valor true. Si el objeto listener no se ha eliminado correctamente (por ejemplo, porque listener no se encontraba en la lista de detectores del objeto Selection), el mtodo devolver el valor false. Ejemplo El cdigo ActionScript siguiente crea varias instancias de campo de texto de forma dinmica. Al seleccionar un campo de texto, aparece la informacin en el panel Salida. Cuando haga clic en la instancia remove_btn, se eliminar el detector y dejar de mostrarse la informacin en el panel Salida.

this.createTextField("one_txt", 1, 0, 0, 100, 22); this.createTextField("two_txt", 2, 0, 25, 100, 22); this.createTextField("three_txt", 3, 0, 50, 100, 22); this.createTextField("four_txt", 4, 0, 75, 100, 22); for (var i in this) { if (this[i] instanceof TextField) { this[i].border = true; this[i].type = "input"; } } var selectionListener:Object = new Object(); selectionListener.onSetFocus = function(oldFocus, newFocus) { trace("Focus shifted from "+oldFocus+" to "+newFocus); }; Selection.addListener(selectionListener); remove_btn.onRelease = function() { trace("removeListener invoked"); Selection.removeListener(selectionListener); };
Vase tambin
addListener (mtodo Selection.addListener)

public static setFocus(newFocus:Object) : Boolean
Selecciona con el teclado el campo de texto, botn o clip de pelcula seleccionable (editable) especificado por el parmetro newFocus. Puede utilizar notacin con barras o notacin con punto. Puede utilizar tambin una ruta relativa o absoluta. Si est utilizando ActionScript 2.0, deber utilizar notacin con punto. Si se pasa el valor null, se eliminar la seleccin actual de teclado. Disponibilidad Flash Lite 2.0 Parmetros newFocus:Object - Objeto, como una instancia de botn, clip de pelcula o campo de texto, o cadena que especifica la ruta a una instancia de botn, clip de pelcula o campo de texto. Valor devuelto Boolean - Un valor booleano; true si el intento de seleccin con el teclado es correcto; false si dicho intento fracasa. Ejemplo En el ejemplo siguiente, se resalta el campo de texto username_txt cuando se ejecuta en una ventana del navegador. Si el usuario no rellena uno de los campos de texto obligatorios (username_txt y password_txt), el cursor se sita automticamente en el campo de texto al que le faltan datos. Por ejemplo, si el usuario no escribe nada en el campo de texto username_txt y hace clic en el botn de envo, aparece un mensaje de error y el cursor se sita en el campo de texto username_txt.

this.createTextField("status_txt", this.getNextHighestDepth(), 100, 70, 100, 22); this.createTextField("username_txt", this.getNextHighestDepth(), 100, 100, 100, 22); this.createTextField("password_txt", this.getNextHighestDepth(), 100, 130, 100, 22); this.createEmptyMovieClip("submit_mc", this.getNextHighestDepth()); submit_mc.createTextField("submit_txt", this.getNextHighestDepth(), 100, 160, 100, 22); submit_mc.submit_txt.autoSize = "center"; submit_mc.submit_txt.text = "Submit"; submit_mc.submit_txt.border = true; submit_mc.onRelease = checkForm; username_txt.border = true; password_txt.border = true; username_txt.type = "input"; password_txt.type = "input"; password_txt.password = true; Selection.setFocus("username_txt"); fscommand("activateTextField"); // function checkForm():Boolean { if (username_txt.text.length == 0) { status_txt.text = "fill in username"; Selection.setFocus("username_txt"); fscommand("activateTextField"); return false; } if (password_txt.text.length == 0) { status_txt.text = "fill in password"; Selection.setFocus("password_txt"); fscommand("activateTextField"); return false; } status_txt.text = "success!"; Selection.setFocus(null); return true; }
Vase tambin
getFocus (mtodo Selection.getFocus)
setSelection (mtodo Selection.setSelection)

public static setSelection(beginIndex:Number, endIndex:Number) : Void
Establece el espacio de seleccin del campo de texto seleccionado actualmente. El nuevo espacio de seleccin comienza por el ndice especificado en el parmetro beginIndex y termina en el ndice especificado en el parmetro endIndex. Los ndices de espacio de seleccin estn basados en cero (por ejemplo, la primera posicin es 0, la segunda posicin es 1, etc.). Este mtodo no surte efecto si no hay ningn campo de texto seleccionado en ese momento. Si se llama al mtodo setSelection() y el control de texto est seleccionado, el resaltado se mostrar nicamente si el campo de texto se est editando de forma activa. El mtodo setSelection() se puede invocar despus de Selection.setFocus() o desde un detector de eventos onSetFocus(), pero la seleccin slo estar visible despus de una llamada al comando fscommand activateTextField. Disponibilidad Flash Lite 2.0

Parmetros beginIndex:Number - El primer ndice del espacio de seleccin. endIndex:Number - El ltimo ndice del espacio de seleccin. Ejemplo El siguiente cdigo ActionScript crea un campo de texto en tiempo de ejecucin y le aade una cadena. Seguidamente, asigna un controlador de eventos para el evento onSetFocus que selecciona todo el texto del campo de texto y activa la edicin. Nota: si se llama al mtodo Selection.setSelection(), el texto no se mostrar en pantalla hasta que no se active el campo de texto (despus de llamar al comando fscommand activateTextField).
this.createTextField("myText_txt", 99, 10, 10, 200, 30); myText_txt.type = "input"; myText_txt.text = "this is my text"; myText_txt.onSetFocus = function(){ Selection.setSelection(0,myText_txt.text.length); fscommand("activateTextField"); }
El siguiente ejemplo ilustra cmo el parmetro endIndex no es inclusivo. Para seleccionar el primer carcter, debe utilizar un parmetro endIndex 1, no 0. Si cambia el parmetro endIndex a 0, no se selecciona nada.
this.createTextField("myText_txt", 99, 10, 10, 200, 30); myText_txt.text = "this is my text"; this.onEnterFrame = function () { Selection.setFocus("myText_txt"); Selection.setSelection(0, 1); delete this.onEnterFrame; }
SharedObject
Object | +-SharedObject public dynamic class SharedObject extends Object
La versin de Flash Lite de la clase SharedObject permite que los archivos SWF de Flash guarden datos en el dispositivo cuando est cerrado y carguen dichos datos desde el dispositivo cuando se vuelva a reproducir. Los objetos compartidos Flash Lite almacenan un conjunto de pares nombre/valor en el dispositivo. Nota: el nombre "SharedObject" proviene de la clase SharedObject de Flash. La versin de Flash de esta clase permite que varios archivos SWF de Flash puedan compartir los datos guardados. Sin embargo, la versin de Flash Lite de la clase SharedObject no admite compartir datos entre distintos archivos SWF de Flash. En Flash Lite, se considera que un archivo SWF es de una versin diferente si se ha modificado desde su versin original, aunque an conserve el mismo nombre. No ocurre lo mismo en Flash Player, donde se considera que un archivo SWF es igual si su URL y su nombre no cambian, aunque el archivo SWF s se haya modificado. En Flash Lite, dos versiones distintas de un archivo SWF no pueden acceder a los objetos compartidos de cada una.

Para mantener la coherencia con la plataforma Flash, en el reproductor Flash Lite se utilizan las mismas convenciones de llamada y creacin de ActionScript. Los siguientes ejemplos describen el potencial de la utilizacin de objetos compartidos:
Una aplicacin Flash puede utilizarse como interfaz de usuario para un servicio que permita al usuario realizar
bsquedas en listados de coches usados. La aplicacin se conecta a un servidor que proporciona listados de coches basndose en las condiciones de bsqueda y preferencias introducidas por el usuario. La aplicacin Flash puede guardar la ltima bsqueda realizada por el usuario y precumplimentar los formularios la prxima vez que se reproduzca el archivo SWF. Para ello, se crea una instancia SharedObject que almacena los parmetros de bsqueda cada vez que el usuario lanza una nueva bsqueda. Cuando se cierra el archivo SWF, el reproductor guarda los datos en el objeto compartido del dispositivo. La prxima vez que se reproduzca el archivo SWF, el reproductor Flash Lite cargar el objeto compartido y precumplimentar el formulario de bsqueda con los mismos datos que introdujo el usuario la vez anterior.
Una aplicacin Flash puede utilizarse como interfaz de usuario para un servicio que permita al usuario buscar
crticas musicales. La aplicacin permite que el usuario almacene informacin sobre sus discos favoritos. Esta informacin se puede almacenar en el servidor remoto, pero suele causar problemas si la aplicacin no puede conectarse al servicio. Asimismo, recuperar datos desde un servicio remoto suele ser un proceso lento y empobrece la experiencia del usuario. Los objetos compartidos permiten que la aplicacin almacene la informacin de los discos en el dispositivo para cargarla rpidamente cuando sea necesario. Nota: dado que los dispositivos mviles tienen espacio limitado, los datos no son completamente persistentes; en determinadas situaciones, la plataforma podra eliminar los datos ms antiguos. Para crear un objeto local compartido, utilice la siguiente sintaxis:
var so:shared object = shared object.getLocal("mySharedObject");
La lectura y escritura de los datos en un telfono puede ser un proceso lento. Para garantizar la disponibilidad inmediata de los datos cuando la aplicacin los solicite al dispositivo, Flash Lite 2.0 necesita configurar un detector. El reproductor invoca al detector cuando el dispositivo ha cargado los datos del objeto compartido. Los mtodos que acceden a la instancia SharedObject devuelta por la llamada a getLocal() tendrn que esperar hasta que se invoque al detector antes de intentar realizar ninguna operacin. Disponibilidad Flash Lite 2.0 Ejemplo En el siguiente ejemplo, un archivo SWF crea una funcin de detector llamada Prefs y, despus, crea un objeto compartido. El reproductor llama a la funcin loadCompletePrefs cuando los datos estn disponibles.

function loadCompletePrefs (mySO:SharedObject) { if (0 == mySO.getSize() ) { // If the size is 0, we need to initialize the data: mySO.data.name = "Sigismund"; mySO.data.email = "siggy@macromedia.com"; } else { // Trace all the data in mySO: trace( "Prefs:" ); for (var idx in mySO.data) { trace( " " + idx +": " + mySO.data[idx] ); } } } SharedObject.addListener( "Prefs", loadCompletePrefs ); // We can now create the shared object: var Prefs:SharedObject = SharedObject.getLocal("Prefs");
Cuando el reproductor ha notificado al detector sobre la disponibilidad de los datos, la aplicacin puede utilizar el objeto compartido devuelto por la llamada al mtodo getLocal() del mismo modo que se utiliza un objeto compartido en Flash. La aplicacin puede aadir, modificar o eliminar propiedades mientras se reproduce el contenido. Cuando el contenido est descargado, es posible que el objeto compartido quede registrado en el dispositivo; sin embargo, para garantizar que el objeto compartido quede registrado, la aplicacin debe forzar una operacin de escritura llamando al flush(). Los objetos compartidos de Flash Lite slo estn disponibles en archivos SWF almacenados localmente. Los archivos SWF que se reproducen desde la red no pueden utilizar objetos compartidos de Flash Lite. La cantidad total de almacenamiento para objetos compartidos de Flash Lite por cada archivo SWF est limitada por el dispositivo en un tamao predeterminado. El tamao se puede determinar utilizando el mtodo SharedObject.getMaxSize(). Nota: los objetos compartidos remotos no se admiten en Flash Lite 2.0. Vase tambin
flush (mtodo SharedObject.flush), onStatus (controlador SharedObject.onStatus)
Modificadores Propiedad data:Object Descripcin Coleccin de atributos asignados a la propiedad data del objeto.


Resumen de eventos
Evento onStatus = Descripcin Se invoca cada vez que se publica un error, una advertencia o una nota informativa para
function(infoObject un objeto compartido. :Object) {}
Resumen de mtodos
Modificadores
static
Firma
Descripcin
addListener(objectName Crea un detector de eventos al que invoca el reproductor Flash :String, Lite cuando se han cargado los datos del objeto compartido notifyFunction:Functi desde el dispositivo. on) : Void clear() : Void Depura todos los datos del objeto compartido y elimina el objeto compartido del disco.
flush(minDiskSpace:Nu Escribe el objeto compartido en un archivo local y persistente. mber) : Object

static
getLocal(name:String) : SharedObject
Devuelve una referencia a un objeto compartido persistente localmente que slo est disponible para el cliente actual.
static
getMaxSize() : Number Devuelve el nmero total de bytes que puede utilizar el archivo SWF para almacenar objetos compartidos mviles en el dispositivo. getSize() : Number Obtiene el tamao actual en bytes del objeto compartido.
static
ame:String)
removeListener(objectN Elimina todos los detectores aadidos con el mtodo addListener().

addProperty (mtodo Object.addProperty), hasOwnProperty (mtodo Object.hasOwnProperty), isPropertyEnumerable (mtodo Object.isPropertyEnumerable)isPrototypeOf (mtodo Object.isPrototypeOf), registerClass (mtodo Object.registerClass), toString (mtodo Object.toString)unwatch (mtodo Object.unwatch), valueOf (mtodo Object.valueOf), watch (mtodo Object.watch)
addListener (mtodo SharedObject.addListener)

public static addListener(objectName:String, notifyFunction:Function) : Void
Crea un detector de eventos al que invoca el reproductor Flash Lite cuando se han cargado los datos del objeto compartido desde el dispositivo. Los mtodos que acceden a la instancia SharedObject devuelta por la llamada al mtodo getLocal() tendrn que esperar hasta que se invoque al detector antes de intentar realizar ninguna operacin. Disponibilidad Flash Lite 2.0 Parmetros objectName:String - Cadena que representa el nombre del objeto. notifyFunction:Function - Nombre de la funcin a la que llama el reproductor para notificar a la aplicacin sobre la ejecucin del mtodo getLocal() y sobre la finalizacin de la carga de datos.

clear (mtodo SharedObject.clear)

public clear() : Void
Depura todos los datos del objeto compartido y elimina el objeto compartido del disco. La referencia a my_so contina activa y my_so est ahora vaco. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente guarda datos en el objeto compartido y, a continuacin, vaca todos los datos del objeto compartido:
var my_so:SharedObject = SharedObject.getLocal("superfoo"); my_so.data.name = "Hector"; trace("before my_so.clear():"); for (var prop in my_so.data) { trace("\t"+prop); } trace(""); my_so.clear(); trace("after my_so.clear():"); for (var prop in my_so.data) { trace("\t"+prop); }
Este cdigo ActionScript muestra el siguiente mensaje en el panel Salida:

before my_so.clear(): name after my_so.clear():
data (propiedad SharedObject.data)

public data : Object
Coleccin de atributos asignados a la propiedad data del objeto. Cada atributo puede ser un objeto de cualquier tipo bsico de ActionScript o JavaScript (Array, Number, Boolean, etc.). Por ejemplo, las siguientes lneas asignan valores a diversos aspectos de un objeto compartido. Nota: en Flash Lite, si no se invoca al detector de objetos compartidos, la propiedad data podra contener valores no definidos. Consulte la descripcin del mtodo addListener() para obtener ms informacin.

var items_array:Array = new Array(101, 346, 483); var currentUserIsAdmin:Boolean = true; var currentUserName:String = "Ramona"; var my_so:SharedObject = SharedObject.getLocal("superfoo"); my_so.data.itemNumbers = items_array; my_so.data.adminPrivileges = currentUserIsAdmin; my_so.data.userName = currentUserName; for (var prop in my_so.data) { trace(prop+": "+my_so.data[prop]); } soResult = ""; for (var prop in my_so.data) { soResult += prop+": "+my_so.data[prop] +"\n"; } result.text = soResult;
Todos los atributos de la propiedad data de un objeto compartido se guardan si el objeto es persistente, y el objeto compartido contiene la siguiente informacin:
userName: Ramona adminPrivileges: true itemNumbers: 101,346,483
Nota: no asigne valores directamente a la propiedad data de un objeto compartido (por ejemplo, so.data = someValue). Flash omitir estas asignaciones. Para eliminar atributos de objetos locales compartidos, utilice cdigo como, por ejemplo, delete
so.data.attributeName; la configuracin de un atributo con el valor null o undefined para un objeto local
compartido no elimina el atributo en cuestin. Para crear valores private para un objeto compartido (valores que slo estn disponibles para la instancia de cliente mientras el objeto se est utilizando y no se almacenan con el objeto cuando se cierra), cree propiedades que no sean data para almacenarlos, como se muestra en el siguiente ejemplo:
var my_so:SharedObject = SharedObject.getLocal("superfoo"); my_so.favoriteColor = "blue"; my_so.favoriteNightClub = "The Bluenote Tavern"; my_so.favoriteSong = "My World is Blue"; for (var prop in my_so) { trace(prop+": "+my_so[prop]); }
El objeto compartido contiene los siguientes datos:

favoriteSong: My World is Blue favoriteNightClub: The Bluenote Tavern favoriteColor: blue data: [object Object]

Ejemplo El ejemplo siguiente guarda texto en un objeto compartido con el nombre my_so (para ver el ejemplo completo, consulte SharedObject.getLocal()):
var my_so:SharedObject = SharedObject.getLocal("savedText"); // myText is an input text field and inputText is a dynamic text field. myText.text = my_so.data.myTextSaved; // Assign an empty string to myText_ti if the shared object is undefined // to prevent the text input box from displaying "undefined" when // this script is first run. if (myText.text == "undefined") { myText.text = ""; } changedListener = new Object(); changedListener.onChanged = function (changedField) { my_so.data.myTextSaved = changedField.text; inputText.text = ""; inputText.text = my_so.data.myTextSaved; } myText.addListener(changedListener);
flush (mtodo SharedObject.flush)

public flush(minDiskSpace:Number) : Object
Escribe el objeto compartido en un archivo local y persistente. Para garantizar que el objeto compartido quede registrado, la aplicacin debe forzar una operacin de escritura llamando al mtodo flush(). Al contrario de lo que ocurre en Flash Player, la operacin de escritura es asncrona y el resultado no se obtiene inmediatamente. Disponibilidad Flash Lite 2.0 Parmetros minDiskSpace:Number - Entero que especifica el nmero de bytes que debe asignarse a este objeto. El valor predeterminado es 0. Valor devuelto Object - Valor booleano, true o false; o valor de cadena de "pending". El mtodo flush() devuelve pending en la mayora de las solicitudes, con las excepciones siguientes:
Si no se necesita escribir datos (es decir, si los datos ya estn escritos), flush() devuelve true. Si el parmetro minimumDiskSpace supera el mximo espacio disponible para un archivo SWF (o el espacio
disponible restante para un archivo SWF) o si se ha producido un error al procesar la solicitud, flush() devuelve false.

Si el mtodo flush() devuelve pending, el reproductor Flash Lite puede mostrar un cuadro de dilogo para pedir al usuario que libere espacio para poder aumentar el espacio disponible en disco para los objetos compartidos. Para permitir que crezca el espacio asignado al objeto compartido cuando vuelva a guardarse, lo que evita que se devuelva el valor pending, pase un valor para minimumDiskSpace. Cuando el reproductor Flash Lite intenta grabar el archivo, busca el nmero de bytes pasados a minimumDiskSpace, en lugar de buscar el espacio suficiente para guardar el objeto compartido con su tamao actual. Ejemplo El siguiente ejemplo gestiona los posibles valores devueltos para el mtodo flush():
so_big = SharedObject.getLocal("large"); so_big.data.name = "This is a long string of text."; so_big.flush(); var flushResult = so_big.flush(); switch (flushResult) { case 'pending' : result.text += "pending"; break; case true : result.text += "Data was flushed."; break; case false : result.text += "Test failed. Data was not flushed."; break; }
Vase tambin
clear (mtodo SharedObject.clear), onStatus (controlador SharedObject.onStatus)
getLocal (mtodo SharedObject.getLocal)

public static getLocal(name:String) : SharedObject
Devuelve una referencia a un objeto compartido persistente localmente que slo est disponible para el cliente actual. Si el objeto compartido no existe ya, getLocal() crea uno. Se trata de un mtodo esttico de la clase SharedObject. Nota: en Flash Lite, un objeto compartido no se puede compartir entre dos archivos SWF. Para asignar el objeto a una variable, utilice una sintaxis como la siguiente
var so:SharedObject = SharedObject.getLocal("savedData")
Dado que los datos no estn disponibles para su lectura en el dispositivo de forma inmediata, la aplicacin debe crear y registrar un detector para el objeto compartido identificado por name. Consulte la descripcin del mtodo addListener() para obtener ms informacin. Disponibilidad Flash Lite 2.0

Parmetros name:String - Cadena que representa el nombre del objeto. El nombre puede incluir barras diagonales (/); por ejemplo, work/addresses es un nombre vlido. No se admiten espacios en los nombres de objetos compartidos, ni tampoco los siguientes caracteres:
~ % & \ ; : " ' , < > ? #
Valor devuelto SharedObject - Referencia a un objeto compartido persistente localmente que slo est disponible para el cliente actual. Si Flash no puede crear ni encontrar un objeto compartido, getLocal() devuelve null. Este mtodo falla y devuelve null si se ha prohibido a contenido de Flash de terceros la creacin y el almacenamiento de objetos compartidos persistentes. Ejemplo El ejemplo siguiente guarda el ltimo fotograma introducido por un usuario en un objeto compartido local llamado kookie:
// Get the kookie var my_so:SharedObject = SharedObject.getLocal("kookie"); // Get the user of the kookie and go to the frame number saved for this user. if (my_so.data.user != undefined) { this.user = my_so.data.user; this.gotoAndStop(my_so.data.frame); }
El siguiente bloque de cdigo se coloca en cada fotograma del archivo SWF:

// On each frame, call the rememberme function to save the frame number. function rememberme() { my_so.data.frame=this._currentframe; my_so.data.user="John"; }
getMaxSize (mtodo SharedObject.getMaxSize)

public static getMaxSize() : Number
Devuelve el nmero total de bytes que puede utilizar el archivo SWF para almacenar objetos compartidos mviles en el dispositivo. Por ejemplo, si el mtodo devuelve 1K, la pelcula puede guardar un objeto compartido de 1 K (o varios objetos compartidos ms pequeos) siempre que el tamao combinado no supere 1 K. Se trata de un mtodo esttico de la clase SharedObject. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Valor numrico que especifica el nmero total de bytes que la pelcula puede almacenar en el dispositivo. Tambin es el tamao disponible para todo el contenido cargado dinmicamente mediante loadMovie().

Ejemplo El siguiente ejemplo comprueba si hay ms de 1 KB de espacio de almacenamiento reservado antes de crear un objeto compartido Flash Lite.
if (SharedObject.getMaxSize() > 1024) { var my_so:SharedObject = SharedObject.getLocal("sharedObject1"); } else { trace("SharedObject's maximum size is less than 1 KB."); }
getSize (mtodo SharedObject.getSize)

public getSize() : Number
Obtiene el tamao actual en bytes del objeto compartido. Flash calcula el tamao de un objeto compartido analizando todas sus propiedades de datos; cuantas ms propiedades de datos tenga el objeto, mayor ser el tiempo necesario para calcular su tamao. El clculo del tamao de un objeto puede consumir bastante tiempo de proceso, por lo que se recomienda evitar este mtodo si no se necesita por un motivo concreto. Si an no se ha llamado al detector del objeto compartido, getSize() devuelve 0. Consulte el mtodo addListener() para obtener informacin sobre la utilizacin del detector. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Valor numrico que especifica el tamao en bytes del objeto compartido. Ejemplo El ejemplo siguiente obtiene el tamao del objeto compartido my_so:
var items_array:Array = new Array(101, 346, 483); var currentUserIsAdmin:Boolean = true; var currentUserName:String = "Ramona"; var my_so:SharedObject = SharedObject.getLocal("superfoo"); my_so.data.itemNumbers = items_array; my_so.data.adminPrivileges = currentUserIsAdmin; my_so.data.userName = currentUserName; var soSize:Number = my_so.getSize(); trace(soSize);
onStatus (controlador SharedObject.onStatus)

Se invoca cada vez que se publica un error, una advertencia o una nota informativa para un objeto compartido. Para responder a este controlador de eventos, deber crear una funcin que procese el objeto de informacin generado por el objeto compartido. El objeto de informacin tiene una propiedad code con una cadena que describe el resultado del controlador onStatus, as como una propiedad level que contiene una cadena que puede indicar "Status" o "Error".

Adems de este controlador, Flash Lite tambin proporciona una superfuncin denominada System.onStatus. Si se llama a onStatus para un objeto concreto y no hay ninguna funcin asignada para responder, Flash procesa una funcin asignada a System.onStatus, si existe. Los siguientes eventos le notifican cundo tienen lugar determinadas actividades SharedObject:
Propiedad de cdigo Propiedad de nivel Significado El mtodo SharedObject.flush() que ha devuelto "pending" ha fallado (el usuario no ha asignado espacio adicional del disco para el objeto compartido cuando Flash Lite Player mostr el cuadro de dilogo Configuracin global de almacenamiento). El mtodo SharedObject.flush() que devolvi "pending" ha finalizado correctamente (el usuario ha asignado espacio adicional del disco para el objeto compartido).
SharedObject.Flush.Fai Error led
SharedObject.Flush.Suc Status cess
Disponibilidad Flash Lite 2.0 Parmetros infoObject:Object - Parmetro definido de acuerdo con el mensaje de estado. Ejemplo El ejemplo siguiente muestra distintos mensajes que dependen de si el usuario ha elegido permitir o denegar que la instancia de objeto SharedObject escriba en el disco.

this.createTextField("message_txt", this.getNextHighestDepth(), 0, 30, 120, 50); this.message_txt.wordWrap = true; this.createTextField("status_txt", this.getNextHighestDepth(), 0, 90, 120, 100); this.status_txt.wordWrap = true; var items_array:Array = new Array(101, 346, 483); var currentUserIsAdmin:Boolean = true; var currentUserName:String = "Ramona"; var my_so:SharedObject = SharedObject.getLocal("superfoo"); my_so.data.itemNumbers = items_array; my_so.data.adminPrivileges = currentUserIsAdmin; my_so.data.userName = currentUserName; my_so.onStatus = function(infoObject:Object) { for (var i in infoObject) { status_txt.text += i+"-"+infoObject[i] +"\n"; } }; var flushResult = my_so.flush(1000001); switch (flushResult) { case 'pending' : message_txt.text = "flush is pending, waiting on user interaction."; break; case true : message_txt.text = "flush was successful. Requested storage space approved."; break; case false : message_txt.text = "flush failed. User denied request for additional storage."; break; }
Vase tambin
onStatus (controlador System.onStatus)
removeListener (mtodo SharedObject.removeListener)

public static removeListener(objectName:String)
Elimina todos los detectores aadidos con el mtodo addListener(). Disponibilidad Flash Lite 2.0 Parmetros objectName:String - Cadena que representa el nombre del objeto.

Sonido
Object | +-Sound public class Sound extends Object
La clase Sound le permite controlar el sonido de una pelcula. Puede aadir sonidos de la biblioteca a un clip de pelcula mientras se reproduce la pelcula, as como controlar dichos sonidos. Si no se especifica un destino al crear un nuevo objeto Sound, podr utilizar los mtodos para controlar el sonido de toda la pelcula. Deber utilizar el constructor new Sound para crear un objeto Sound antes de llamar a los mtodos de la clase Sound. Disponibilidad Flash Lite 2.0 Resumen de propiedades
Modificadores Propiedad duration:Number [slo lectura] id3:Object [slo lectura] Descripcin Duracin de un sonido, en milisegundos.
Proporciona acceso a los metadatos que forman parte de un archivo MP3. Nmero de milisegundos que se ha estado reproduciendo un sonido.
position:Number [slo lectura]

Resumen de eventos
Evento onID3 = function()
{}
Descripcin Se invoca cada vez que hay nuevos datos ID3 disponibles para un archivo MP3 cargado mediante Sound.attachSound() o Sound.loadSound(). Se invoca automticamente cuando se carga un sonido.
onLoad =
function(success:Bo olean) {}
onSoundComplete =
function() {}
Se invoca automticamente cuando se deja de reproducir un sonido.
Firma Sonido([target:Objec t]) Descripcin Crea un nuevo objeto Sound para un clip de pelcula especificado.

Resumen de mtodos
Modificadores Firma attachSound(id:String)
: Void
Descripcin Asocia el sonido especificado en el parmetro id al objeto Sound indicado. Devuelve el nmero de bytes cargados (sin interrupcin) para el objeto Sound especificado. Devuelve el tamao en bytes del objeto Sound especificado.
getBytesLoaded() : Number getBytesTotal() : Number getPan() : Number
Devuelve el nivel de desplazamiento horizontal establecido en la ltima llamada a setPan() como un entero entre -100 (izquierda) y +100 (derecha).
getTransform() : Object Devuelve la informacin de transformacin de sonido para el objeto Sound especificado configurado con la ltima llamada a Sound.setTransform(). getVolume() : Number Devuelve el nivel de volumen del sonido como un entero entre 0 y 100, donde 0 es desactivado y 100 es volumen total. Carga un archivo MP3 en un objeto Sound.
loadSound(url:String, isStreaming:Boolean)
: Void
setPan(valor:Number)
: Void
Determina cmo se reproduce el sonido en los canales (altavoces) izquierdo y derecho.
setTransform(transform Establece la informacin de transformacin (o balance) de Object:Object) : Void sonido para un objeto Sound. setVolume(valor:Numb Establece el volumen para el objeto Sound. er) : Void start([secondOffset:N Comienza la reproduccin del ltimo sonido asociado desde el umber], principio, si no hay ningn parmetro especificado, o a partir [loops:Number]) : del punto del sonido especificado por el parmetro Void secondOffset. stop([linkageID:String Detiene todos los sonidos que se estn reproduciendo ]) : Void actualmente, si no se ha especificado ningn parmetro, o slo el sonido especificado por el parmetro idName.

attachSound (mtodo Sound.attachSound)

public attachSound(id:String) : Void
Asocia el sonido especificado en el parmetro id al objeto Sound indicado. El sonido debe encontrarse en la biblioteca del archivo SWF actual y debe estar especificado para la exportacin en el cuadro de dilogo Propiedades de vinculacin. Debe llamar a Sound.start() para comenzar a reproducir el sonido. Para asegurarse de que el sonido puede controlarse desde cualquier escena del archivo SWF, coloque el sonido en la lnea de tiempo principal del archivo SWF.

Disponibilidad Flash Lite 2.0 Parmetros id:String - Identificador de un sonido exportado en la biblioteca. El identificador se encuentra en el cuadro de dilogo Propiedades de vinculacin. Ejemplo El ejemplo siguiente asocia el logoff_id del sonido a my_sound. Un sonido en la biblioteca tiene el identificador de vinculacin logoff_id.
var my_sound:Sound = new Sound(); my_sound.attachSound("logoff_id"); my_sound.start();
duration (propiedad Sound.duration)

public duration : Number [read-only]
Duracin de un sonido, en milisegundos. Nota: Flash Lite 2.0 slo admite esta propiedad para sonido nativo de Flash. No se admiten formatos de sonido especficos para un dispositivo host. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente carga un sonido y muestra la duracin del archivo de sonido en el panel Salida. Aada el siguiente cdigo ActionScript al archivo FLA o AS:
var my_sound:Sound = new Sound(); my_sound.onLoad = function(success:Boolean) { var totalSeconds:Number = this.duration/1000; trace(this.duration+" ms ("+Math.round(totalSeconds)+" seconds)"); var minutes:Number = Math.floor(totalSeconds/60); var seconds = Math.floor(totalSeconds)%60; if (seconds<10) { seconds = "0"+seconds; } trace(minutes+":"+seconds); }; my_sound.loadSound("song1.mp3", true);
El siguiente ejemplo carga varias canciones en un archivo SWF. Una barra de progreso, creada en la interfaz API de dibujo, muestra cmo avanza la carga. Cuando comienza y finaliza la carga de la msica, aparece la informacin correspondiente en el panel Salida. Cuando comienza y finaliza la carga de la msica, se escribe la informacin correspondiente en el archivo de registro. Aada el siguiente cdigo ActionScript al archivo FLA o AS:

var pb_height:Number = 10; var pb_width:Number = 100; var pb:MovieClip = this.createEmptyMovieClip("progressBar_mc", this.getNextHighestDepth()); pb.createEmptyMovieClip("bar_mc", pb.getNextHighestDepth()); pb.createEmptyMovieClip("vBar_mc", pb.getNextHighestDepth()); pb.createEmptyMovieClip("stroke_mc", pb.getNextHighestDepth()); pb.createTextField("pos_txt", pb.getNextHighestDepth(), 0, pb_height, pb_width, 22); pb._x = 100; pb._y = 100; with (pb.bar_mc) { beginFill(0x00FF00); moveTo(0, 0); lineTo(pb_width, 0); lineTo(pb_width, pb_height); lineTo(0, pb_height); lineTo(0, 0); endFill(); _xscale = 0; } with (pb.vBar_mc) { lineStyle(1, 0x000000); moveTo(0, 0); lineTo(0, pb_height); } with (pb.stroke_mc) { lineStyle(3, 0x000000); moveTo(0, 0); lineTo(pb_width, 0); lineTo(pb_width, pb_height); lineTo(0, pb_height); lineTo(0, 0); } var my_interval:Number; var my_sound:Sound = new Sound(); my_sound.onLoad = function(success:Boolean) { if (success) { trace("sound loaded"); } }; my_sound.onSoundComplete = function() { clearInterval(my_interval); trace("Cleared interval"); } my_sound.loadSound("song3.mp3", true); my_interval = setInterval(updateProgressBar, 100, my_sound); function updateProgressBar(the_sound:Sound):Void { var pos:Number = Math.round(the_sound.position/the_sound.duration 100); pb.bar_mc._xscale = pos; pb.vBar_mc._x = pb.bar_mc._width; pb.pos_txt.text = pos+"%"; }

Vase tambin
position (propiedad Sound.position)
getBytesLoaded (mtodo Sound.getBytesLoaded)

Devuelve el nmero de bytes cargados (sin interrupcin) para el objeto Sound especificado. Puede comparar el valor de getBytesLoaded() con el valor de getBytesTotal() para determinar el porcentaje de un sonido que se ha cargado. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Entero que indica el nmero de bytes cargados. Ejemplo El ejemplo siguiente crea de forma dinmica dos campos de texto que muestran los bytes cargados y el total de bytes de un archivo de sonido que se carga en el archivo SWF. Un campo de texto muestra tambin un mensaje cuando termina la carga del archivo. Aada el siguiente cdigo ActionScript al archivo FLA o AS:
this.createTextField("message_txt", this.getNextHighestDepth(), 10,10,300,22) this.createTextField("status_txt", this.getNextHighestDepth(), 10, 50, 300, 40); status_txt.autoSize = true; status_txt.multiline = true; status_txt.border = false; var my_sound:Sound = new Sound(); my_sound.onLoad = function(success:Boolean) { if (success) { this.start(); message_txt.text = "Finished loading"; } }; my_sound.onSoundComplete = function() { message_txt.text = "Clearing interval"; clearInterval(my_interval); }; my_sound.loadSound("song2.mp3", true); var my_interval:Number; my_interval = setInterval(checkProgress, 100, my_sound); function checkProgress(the_sound:Sound):Void { var pct:Number = Math.round(the_sound.getBytesLoaded()/the_sound.getBytesTotal() 100); var pos:Number = Math.round(the_sound.position/the_sound.duration 100); status_txt.text = the_sound.getBytesLoaded()+" of "+the_sound.getBytesTotal()+" bytes ("+pct+"%)"+newline; status_txt.text += the_sound.position+" of "+the_sound.duration+" milliseconds ("+pos+"%)"+newline; }
Vase tambin
getBytesTotal (mtodo Sound.getBytesTotal)

getBytesTotal (mtodo Sound.getBytesTotal)

Devuelve el tamao en bytes del objeto Sound especificado. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Entero que indica el tamao total en bytes del objeto Sound especificado. Ejemplo Para obtener una muestra de cmo se utiliza este mtodo, consulte Sound.getBytesLoaded(). Vase tambin
getBytesLoaded (mtodo Sound.getBytesLoaded)
getPan (mtodo Sound.getPan)

public getPan() : Number
Devuelve el nivel de desplazamiento horizontal establecido en la ltima llamada a setPan() como un entero entre -100 (izquierda) y +100 (derecha). (0 establece de la misma forma los canales izquierdo y derecho.) La configuracin de desplazamiento horizontal controla el balance izquierda-derecha del sonido actual y los sonidos futuros del archivo SWF. Este mtodo es acumulativo con setVolume() o setTransform(). Nota: Flash Lite 2.0 slo admite este mtodo para sonido nativo de Flash. No se admiten formatos de sonido especficos para un dispositivo host. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Un entero. Ejemplo El siguiente ejemplo crea un campo de texto para mostrar el valor del nivel de desplazamiento para sonido nativo de Flash. El identificador de vinculacin para el sonido es "combo". Aada el siguiente cdigo ActionScript al archivo FLA o AS:
this.createTextField("pan_txt", 1, 0, 100, 100, 100); mix=new Sound(); mix.attachSound("combo"); mix.start(); mix.setPan(-100); pan_txt.text = mix.getPan(this);
Puede utilizar el ejemplo siguiente para iniciar el sonido de dispositivo. Dado que Flash Lite no admite flujo de sonido, se recomienda cargar el sonido antes de reproducirlo.

var my_sound:Sound = new Sound(); my_sound.onLoad = function(success) { if (success) { my_sound.start(); } else { output.text = "loading failure"; } }; my_sound.loadSound("song1.mp3",false);
Vase tambin
setPan (mtodo Sound.setPan)
getTransform (mtodo Sound.getTransform)

public getTransform() : Object
Devuelve la informacin de transformacin de sonido para el objeto Sound especificado configurado con la ltima llamada a Sound.setTransform(). Nota: Flash Lite 2.0 slo admite este mtodo para sonido nativo de Flash. No se admiten formatos de sonido especficos para un dispositivo host. Disponibilidad Flash Lite 2.0 Valor devuelto Object - Objeto con propiedades que contienen los valores de porcentaje de los canales del objeto Sound especificado. Ejemplo El ejemplo siguiente asocia cuatro clips de pelcula desde un smbolo de la biblioteca (identificador de vinculacin: knob_id) utilizados como controles deslizantes (o botones) para controlar el archivo de sonido que se carga en el archivo SWF. Estos controles deslizantes controlan el objeto de transformacin, o balance, de un archivo de sonido. Para obtener ms informacin, consulte la entrada para Sound.setTransform(). Aada el siguiente cdigo ActionScript al archivo FLA o AS:

var my_sound:Sound = new Sound(); my_sound.loadSound("song1.mp3", true); var transform_obj:Object = my_sound.getTransform(); this.createEmptyMovieClip("transform_mc", this.getNextHighestDepth()); transform_mc.createTextField("transform_txt", transform_mc.getNextHighestDepth, 0, 8, 120, 22); transform_mc.transform_txt.html = true; var knob_ll:MovieClip = transform_mc.attachMovie("knob_id", transform_mc.getNextHighestDepth(), {_x:0, _y:30}); var knob_lr:MovieClip = transform_mc.attachMovie("knob_id", transform_mc.getNextHighestDepth(), {_x:30, _y:30}); var knob_rl:MovieClip = transform_mc.attachMovie("knob_id", transform_mc.getNextHighestDepth(), {_x:60, _y:30}); var knob_rr:MovieClip = transform_mc.attachMovie("knob_id", transform_mc.getNextHighestDepth(), {_x:90, _y:30}); knob_ll.top = knob_ll._y; knob_ll.bottom = knob_ll._y+100; knob_ll.left = knob_ll._x; knob_ll.right = knob_ll._x; knob_ll._y = knob_ll._y+(100-transform_obj['ll']); knob_ll.onPress = pressKnob; knob_ll.onRelease = releaseKnob; knob_ll.onReleaseOutside = releaseKnob; knob_lr.top = knob_lr._y; knob_lr.bottom = knob_lr._y+100; knob_lr.left = knob_lr._x; knob_lr.right = knob_lr._x; knob_lr._y = knob_lr._y+(100-transform_obj['lr']); knob_lr.onPress = pressKnob; knob_lr.onRelease = releaseKnob; knob_lr.onReleaseOutside = releaseKnob; knob_rl.top = knob_rl._y; knob_rl.bottom = knob_rl._y+100; knob_rl.left = knob_rl._x; knob_rl.right = knob_rl._x; knob_rl._y = knob_rl._y+(100-transform_obj['rl']); knob_rl.onPress = pressKnob; knob_rl.onRelease = releaseKnob; knob_rl.onReleaseOutside = releaseKnob; knob_rr.top = knob_rr._y; knob_rr.bottom = knob_rr._y+100; knob_rr.left = knob_rr._x; knob_rr.right = knob_rr._x; knob_rr._y = knob_rr._y+(100-transform_obj['rr']); knob_rr.onPress = pressKnob; knob_rr.onRelease = releaseKnob; knob_rr.onReleaseOutside = releaseKnob; "ll_mc", "lr_mc", "rl_mc", "rr_mc",

updateTransformTxt(); function pressKnob() { this.startDrag(false, this.left, this.top, this.right, this.bottom); } function releaseKnob() { this.stopDrag(); updateTransformTxt(); } function updateTransformTxt() { var ll_num:Number = 30+100-knob_ll._y; var lr_num:Number = 30+100-knob_lr._y; var rl_num:Number = 30+100-knob_rl._y; var rr_num:Number = 30+100-knob_rr._y; my_sound.setTransform({ll:ll_num, lr:lr_num, rl:rl_num, rr:rr_num}); transform_mc.transform_txt.htmlText = "<textformat tabStops='[0,30,60,90]'>"; transform_mc.transform_txt.htmlText += ll_num+"\t"+lr_num+"\t"+rl_num+"\t"+rr_num; transform_mc.transform_txt.htmlText += "</textformat>"; }
Vase tambin
setTransform (mtodo Sound.setTransform)
getVolume (mtodo Sound.getVolume)

public getVolume() : Number
Devuelve el nivel de volumen del sonido como un entero entre 0 y 100, donde 0 es desactivado y 100 es volumen total. El valor predeterminado es 100. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente crea un control deslizante que utiliza la interfaz API de dibujo y un clip de pelcula creado en tiempo de ejecucin. Un campo de texto creado de forma dinmica muestra el nivel de volumen actual del sonido que se reproduce en el archivo SWF. Aada el siguiente cdigo ActionScript al archivo ActionScript o FLA:

var my_sound:Sound = new Sound(); my_sound.loadSound("song3.mp3", true); this.createEmptyMovieClip("knob_mc", this.getNextHighestDepth()); knob_mc.left = knob_mc._x; knob_mc.right = knob_mc.left+100; knob_mc.top = knob_mc._y; knob_mc.bottom = knob_mc._y; knob_mc._x = my_sound.getVolume(); with (knob_mc) { lineStyle(0, 0x000000); beginFill(0xCCCCCC); moveTo(0, 0); lineTo(4, 0); lineTo(4, 18); lineTo(0, 18); lineTo(0, 0); endFill(); } knob_mc.createTextField("volume_txt", knob_mc.getNextHighestDepth(), knob_mc._width+4, 0, 30, 22); knob_mc.volume_txt.text = my_sound.getVolume(); knob_mc.onPress = function() { this.startDrag(false, this.left, this.top, this.right, this.bottom); this.isDragging = true; }; knob_mc.onMouseMove = function() { if (this.isDragging) { this.volume_txt.text = this._x; } } knob_mc.onRelease = function() { this.stopDrag(); this.isDragging = false; my_sound.setVolume(this._x); };
Vase tambin
setVolume (mtodo Sound.setVolume)
id3 (propiedad Sound.id3)

public id3 : Object [read-only]
Proporciona acceso a los metadatos que forman parte de un archivo MP3. Los archivos de sonido MP3 pueden contener etiquetas ID3 que proporcionan metadatos sobre el archivo. Si un sonido MP3 que usted carga utilizando Sound.attachSound() o Sound.loadSound() contiene etiquetas ID3, puede consultar estas propiedades. Slo se admiten las etiquetas ID3 que utilizan el conjunto de caracteres UTF-8.

Flash Player 6 (6.0.40.0) y versiones posteriores utilizan la propiedad Sound.id3 para lograr la compatibilidad con las etiquetas ID3 1.0 e ID3 1.1. Flash Player 7 aade compatibilidad con las etiquetas ID3 2.0, especficamente con las de las versiones 2.3 y 2.4. En la siguiente tabla se enumeran las etiquetas ID3 2.0 estndar y el tipo de contenido que representan las etiquetas; las consultas de estas etiquetas se realizan con el formato my_sound.id3.COMM, my_sound.id3.TIME, etc. Los archivos MP3 pueden contener etiquetas distintas de las indicadas en esta tabla; Sound.id3 proporciona el acceso tambin a dichas etiquetas.
Propiedad TFLT TIME TIT1 TIT2 TIT3 TKEY TLAN TLEN TMED TOAL TOFN TOLY TOPE TORY TOWN TPE1 TPE2 TPE3 TPE4 TPOS TPUB TRCK TRDA TRSN TRSO TSIZ TSRC Descripcin Tipo de archivo Tiempo Descripcin de grupo de contenido Ttulo/nombre de cancin/descripcin de contenido Subttulo/descripcin adicional Clave inicial Idiomas Longitud Tipo de medio lbum/pelcula/ttulo de espectculo original Nombre de archivo original Letristas/escritores originales Artistas/intrpretes originales Ao de publicacin original Propietario/licenciatario del archivo Intrpretes/solistas principales Grupo/orquesta/acompaamiento Director/intrprete adicional Interpretado, remezclado o editado por Parte de un conjunto Editor Nmero de pista/posicin en el conjunto Fechas de grabacin Nombre de emisora de Internet Propietario de emisora de Internet Tamao ISRC (cdigo de grabacin estndar internacional)

Propiedad TSSE
Descripcin Software/hardware y configuracin empleados para la codificacin Ao Fotograma de vnculo de URL
TYER WXXX
Flash Player 6 admita diversas etiquetas ID3 1.0. Si dichas etiquetas no estn en el archivo MP3 pero s lo estn las correspondientes etiquetas ID3 2.0, las etiquetas ID3 2.0 se copiarn en las propiedades de ID3 1.0, como se muestra en la siguiente tabla. Este proceso ofrece compatibilidad con guiones de versiones anteriores que pueda haber escrito con anterioridad y que lean propiedades ID3 1.0.
Etiqueta ID3 2.0 COMM TALB TCON TIT2 TPE1 TRCK TYER Etiqueta ID3 1.0 correspondiente Sound.id3.comment Sound.id3.album Sound.id3.genre Sound.id3.songname Sound.id3.artist Sound.id3.track Sound.id3.year
Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente sigue la evolucin de las propiedades ID3 de song.mp3 en el panel Salida:
var my_sound:Sound = new Sound(); my_sound.onID3 = function(){ for( var prop in my_sound.id3 ){ trace( prop + " : "+ my_sound.id3[prop] ); } } my_sound.loadSound("song.mp3", false);
Vase tambin
attachSound (mtodo Sound.attachSound), loadSound (mtodo Sound.loadSound)
loadSound (mtodo Sound.loadSound)

public loadSound(url:String, isStreaming:Boolean) : Void
Carga un archivo MP3 en un objeto Sound. Puede utilizar el parmetro isStreaming para indicar si el sonido es un evento o un sonido de flujo. Los sonidos de eventos se cargan completamente antes de reproducirse. Se administran mediante la clase Sound de ActionScript y responden a todos los mtodos y propiedades de esta clase.

Los sonidos de flujo se reproducen mientras se estn descargando. La reproduccin comienza cuando se han recibido suficientes datos para iniciar el descompresor. Todos los MP3 (sonidos de eventos y de flujo) cargados con este mtodo se guardan en la memoria del cach del navegador del sistema del usuario. Nota: en Flash Lite 2.0, puede omitir el parmetro isStreaming, ya que Flash Lite 2.0 trata cada sonido como un evento de sonido. Disponibilidad Flash Lite 2.0 Parmetros url:String - Ubicacin de un archivo de sonido MP3 en un servidor. isStreaming:Boolean - Valor booleano que indica si el sonido es un flujo de sonido (true) o un sonido de evento (false). Ejemplo El ejemplo siguiente carga un sonido de evento, que no puede reproducirse hasta que se ha cargado completamente:
var my_sound:Sound = new Sound(); my_sound.loadSound("song1.mp3", false);
El siguiente ejemplo carga un flujo de sonido:

var my_sound:Sound = new Sound(); my_sound.loadSound("song1.mp3", true);
Vase tambin
onLoad (controlador Sound.onLoad)
onID3 (controlador Sound.onID3)

onID3 = function() {}
Se invoca cada vez que hay nuevos datos ID3 disponibles para un archivo MP3 cargado mediante Sound.attachSound() o Sound.loadSound(). Este controlador proporciona acceso a datos ID3 sin realizar ningn sondeo. Si hay etiquetas ID3 1.0 y ID3 2.0 en el archivo, se llamar a este controlador dos veces. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente muestra las propiedades ID3 de song1.mp3 en una instancia del componente DataGrid. Aada un DataGrid con el nombre de instancia d3_dg a su documento y el siguiente cdigo ActionScript a su archivo FLA o AS:

import mx.controls.gridclasses.DataGridColumn; var id3_dg:mx.controls.DataGrid; id3_dg.move(0, 0); id3_dg.setSize(Stage.width, Stage.height); var property_dgc:DataGridColumn = id3_dg.addColumn(new DataGridColumn("property")); property_dgc.width = 100; property_dgc.headerText = "ID3 Property"; var value_dgc:DataGridColumn = id3_dg.addColumn(new DataGridColumn("value")); value_dgc.width = id3_dg._width-property_dgc.width; value_dgc.headerText = "ID3 Value"; var my_sound:Sound = new Sound(); my_sound.onID3 = function() { trace("onID3 called at "+getTimer()+" ms."); for (var prop in this.id3) { id3_dg.addItem({property:prop, value:this.id3[prop]}); } }; my_sound.loadSound("song1.mp3", true);
Vase tambin
attachSound (mtodo Sound.attachSound), id3 (propiedad Sound.id3), loadSound (mtodo Sound.loadSound)

Se invoca automticamente cuando se carga un sonido. Deber crear una funcin que se ejecute cuando se invoque el controlador this. Puede utilizar una funcin annima o una funcin con nombre (para ver un ejemplo de cada una, consulte Sound.onSoundComplete). Debe definir este controlador antes de llamar a mySound.loadSound(). Disponibilidad Flash Lite 2.0 Parmetros success:Boolean - Valor booleano de true si my_sound se carga correctamente; false en caso contrario. Ejemplo El ejemplo siguiente crea un nuevo objeto Sound y carga un sonido. El controlador onLoad gestiona la carga del sonido, por lo que puede iniciar la cancin una vez que se ha cargado sin errores. Cree un nuevo archivo FLA y aada el siguiente cdigo ActionScript al archivo FLA o AS. Para que este ejemplo funcione, debe tener un MP3 con el nombre song1.mp3 en el mismo directorio que el archivo FLA o AS.

this.createTextField("status_txt", this.getNextHighestDepth(), 0,0,100,22); // create a new Sound object var my_sound:Sound = new Sound(); // If the sound loads, play it; if not, trace failure loading. my_sound.onLoad = function(success:Boolean) { if (success) { my_sound.start(); status_txt.text = "Sound loaded"; } else { status_txt.text = "Sound failed"; } }; // Load the sound. my_sound.loadSound("song1.mp3", true);
Vase tambin
loadSound (mtodo Sound.loadSound)
onSoundComplete (controlador Sound.onSoundComplete)

onSoundComplete = function() {}
Se invoca automticamente cuando se deja de reproducir un sonido. Puede utilizar este controlador para activar eventos de un archivo SWF cuando un sonido termine de reproducirse. Deber crear una funcin que se ejecute cuando se invoque este controlador. Puede utilizar una funcin annima o una funcin con nombre. Disponibilidad Flash Lite 2.0 Ejemplo Sintaxis 1: El ejemplo siguiente utiliza una funcin annima:
var my_sound:Sound = new Sound(); my_sound.attachSound("mySoundID"); my_sound.onSoundComplete = function() { trace("mySoundID completed"); }; my_sound.start();
Sintaxis 2: El ejemplo siguiente utiliza una funcin con nombre:

function callback1() { trace("mySoundID completed"); } var my_sound:Sound = new Sound(); my_sound.attachSound("mySoundID"); my_sound.onSoundComplete = callback1; my_sound.start();
Vase tambin

position (propiedad Sound.position)

public position : Number [read-only]
Nmero de milisegundos que se ha estado reproduciendo un sonido. Si el sonido se reproduce de manera indefinida, la posicin se restablece en 0 al comienzo de cada nueva bucle. Nota: Flash Lite 2.0 slo admite esta propiedad para sonido nativo de Flash. No se admiten formatos de sonido especficos para un dispositivo host. Disponibilidad Flash Lite 2.0 Ejemplo Para obtener una muestra de cmo se utiliza esta propiedad, consulte Sound.duration. Vase tambin
duration (propiedad Sound.duration)
setPan (mtodo Sound.setPan)

public setPan(value:Number) : Void
Determina cmo se reproduce el sonido en los canales (altavoces) izquierdo y derecho. En el caso de sonidos mono, pan determina a travs de qu altavoz (izquierdo o derecho) se reproduce el sonido. Nota: Flash Lite 2.0 slo admite este mtodo para sonido nativo de Flash. No se admiten formatos de sonido especficos para un dispositivo host. Disponibilidad Flash Lite 2.0 Parmetros valor:Number - Entero que especifica el balance izquierda-derecha de un sonido. El intervalo de valores vlidos es de -100 a 100, donde -100 utiliza slo el canal izquierdo, 100 utiliza slo el canal derecho y 0 reparte el sonido de forma uniforme entre los dos canales. Ejemplo Para obtener una muestra de cmo se utiliza este mtodo, consulte Sound.getPan(). Vase tambin
attachSound (mtodo Sound.attachSound), getPan (mtodo Sound.getPan), setTransform (mtodo Sound.setTransform)setVolume (mtodo Sound.setVolume), start (mtodo Sound.start)
setTransform (mtodo Sound.setTransform)

public setTransform(transformObject:Object) : Void
Establece la informacin de transformacin (o balance) de sonido para un objeto Sound. El parmetro soundTransformObject es un objeto que se crea utilizando el mtodo constructor de la clase Object genrica con parmetros que especifican cmo se distribuye el sonido entre los canales (altavoces) izquierdo y derecho.

Los sonidos necesitan una cantidad considerable de espacio en disco y de memoria. Dado que los sonidos estreo utilizan el doble de informacin que los sonidos mono, normalmente es preferible utilizar sonidos mono de 6 bits a 22 KHz. Puede utilizar setTransform() para reproducir sonidos mono como si fueran estreo, reproducir sonidos estreo en mono y agregar a los sonidos efectos muy atractivos. Nota: Flash Lite 2.0 slo admite este mtodo para sonido nativo de Flash. No se admiten formatos de sonido especficos para un dispositivo host. Las propiedades de soundTransformObject son stas:
11 - Un valor porcentual que especifica la cantidad de entrada izquierda que debe reproducirse en el altavoz izquierdo
(0-100).
1r - Un valor porcentual que especifica la cantidad de entrada derecha que debe reproducirse en el altavoz izquierdo
(0-100).
rr - Un valor porcentual que especifica la cantidad de entrada derecha que debe reproducirse en el altavoz derecho (0-100). rl - Un valor porcentual que especifica la cantidad de entrada izquierda que debe reproducirse en el altavoz derecho
(0-100). El resultado neto de estos parmetros se representa mediante la siguiente frmula:

leftOutput = left_input ~ ll + right_input ~ lr rightOutput = right_input ~ rr + left_input ~ rl
Los valores de left_input o right_input se determinan mediante el tipo (estreo o mono) de sonido del archivo SWF. Los sonidos estreo dividen la entrada de sonido de manera homognea entre los altavoces izquierdo y derecho y tienen la siguiente configuracin de transformacin predeterminada:
ll lr rr rl = = = = 100 0 100 0
Los sonidos mono reproducen toda la entrada de sonido en el altavoz izquierdo y tienen la siguiente configuracin de transformacin predeterminada:
ll lr rr rl = = = = 100 100 0 0
Disponibilidad Flash Lite 2.0 Parmetros transformObject:Object - Objeto creado con el constructor de la clase Object genrica. Ejemplo El ejemplo siguiente muestra una configuracin que puede conseguirse mediante el uso de setTransform(), pero que no se obtiene si se utilizan setVolume() o setPan(), aunque se hayan combinado. El cdigo siguiente crea un nuevo objeto soundTransformObject y establece sus propiedades de forma que el sonido de los dos canales se reproduzca solamente por el canal izquierdo.

var mySoundTransformObject:Object = new Object(); mySoundTransformObject.ll = 100; mySoundTransformObject.lr = 100; mySoundTransformObject.rr = 0; mySoundTransformObject.rl = 0;
Para aplicar el objeto soundTransformObject a un objeto Sound, debe pasarlo al objeto Sound mediante setTransform() de la forma siguiente:
my_sound.setTransform(mySoundTransformObject);
El ejemplo siguiente reproduce un sonido estreo como mono; el objeto soundTransformObjectMono tiene los siguientes parmetros:
var mySoundTransformObjectMono:Object = new Object(); mySoundTransformObjectMono.ll = 50; mySoundTransformObjectMono.lr = 50; mySoundTransformObjectMono.rr = 50; mySoundTransformObjectMono.rl = 50; my_sound.setTransform(mySoundTransformObjectMono);
Este ejemplo reproduce en el canal izquierdo a media capacidad y aade el resto al canal derecho; el objeto soundTransformObjectHalf tiene los siguientes parmetros:
var mySoundTransformObjectHalf:Object = new Object(); mySoundTransformObjectHalf.ll = 50; mySoundTransformObjectHalf.lr = 0; mySoundTransformObjectHalf.rr = 100; mySoundTransformObjectHalf.rl = 50; my_sound.setTransform(mySoundTransformObjectHalf); var mySoundTransformObjectHalf:Object = {ll:50, lr:0, rr:100, rl:50};
Vase tambin Object, getTransform (mtodo Sound.getTransform)
setVolume (mtodo Sound.setVolume)

public setVolume(value:Number) : Void
Establece el volumen para el objeto Sound. Disponibilidad Flash Lite 2.0 Parmetros valor:Number - Nmero de 0 a 100 que representa un nivel de volumen. 100 es mximo volumen y 0 es sin volumen. El valor predeterminado es 100. Ejemplo Para obtener una muestra de cmo se utiliza este mtodo, consulte Sound.getVolume(). Vase tambin
setPan (mtodo Sound.setPan), setTransform (mtodo Sound.setTransform)

Constructor Sound
public Sound([target:Object])
Crea un nuevo objeto Sound para un clip de pelcula especificado. Si no se especifica una instancia de destino, el objeto Sound controlar todos los sonidos de la pelcula. Disponibilidad Flash Lite 2.0 Parmetros target:Object [opcional] - Instancia de clip de pelcula en la que se utiliza el objeto Sound. Ejemplo El siguiente ejemplo crea un nuevo objeto Sound con el nombre global_sound. La segunda lnea llama a setVolume() y ajusta el volumen de todos los sonidos de la pelcula al 50%.
var global_sound:Sound = new Sound(); global_sound.setVolume(50);
El siguiente ejemplo crea un objeto Sound, lo pasa al clip de pelcula de destino my_mc y llama al mtodo start, que reproduce todos los sonidos de my_mc.
var movie_sound:Sound = new Sound(my_mc); movie_sound.start();
start (mtodo Sound.start)

public start([secondOffset:Number], [loops:Number]) : Void
Comienza la reproduccin del ltimo sonido asociado desde el principio, si no hay ningn parmetro especificado, o a partir del punto del sonido especificado por el parmetro secondOffset. Disponibilidad Flash Lite 2.0 Parmetros secondOffset:Number [opcional] - Parmetro que permite iniciar la reproduccin del sonido en un punto especfico. Por ejemplo, si tiene un sonido de 30 segundos y desea que comience a reproducirse a la mitad, especifique 15 para el parmetro secondOffset. El sonido no se retrasa 15 segundos sino que empieza a reproducirse en la marca de 15 segundos. loops:Number [opcional] - Parmetro que permite especificar el nmero de veces consecutivas que debe reproducirse el sonido. Este parmetro no est disponible en el caso de flujos de sonido. Ejemplo El ejemplo siguiente crea un nuevo objeto Sound y carga un sonido. El controlador onLoad carga el sonido, por lo que puede iniciar la cancin una vez que se ha cargado sin errores. Posteriormente, el sonido utiliza el mtodo start() para iniciar la reproduccin. Cree un nuevo archivo FLA y aada el siguiente cdigo ActionScript al archivo FLA o ActionScript. Para que este ejemplo funcione, debe tener un MP3 denominado song1.mp3 en el mismo directorio que el archivo FLA o AS.

this.createTextField("status_txt", this.getNextHighestDepth(), 0,0,100,22); // create a new Sound object var my_sound:Sound = new Sound(); // If the sound loads, play it; if not, trace failure loading. my_sound.onLoad = function(success:Boolean) { if (success) { my_sound.start(); status_txt.text = "Sound loaded"; } else { status_txt.text = "Sound failed"; } }; // Load the sound. my_sound.loadSound("song1.mp3", true);
Vase tambin
stop (mtodo Sound.stop)
stop (mtodo Sound.stop)

public stop([linkageID:String]) : Void
Detiene todos los sonidos que se estn reproduciendo actualmente, si no se ha especificado ningn parmetro, o slo el sonido especificado por el parmetro idName. Disponibilidad Flash Lite 2.0 Parmetros linkageID:String [opcional] - Parmetro que especifica que deje de reproducirse un sonido determinado. El parmetro idName debe ir entre comillas (" "). Ejemplo El ejemplo siguiente emplea dos botones, stop_btn y play_btn, para controlar la reproduccin de un sonido que se carga en un archivo SWF. Aada dos botones a su documento y el siguiente cdigo ActionScript a su archivo FLA o AS:
var my_sound:Sound = new Sound(); my_sound.loadSound("song1.mp3", true); stop_btn.onRelease = function() { trace("sound stopped"); my_sound.stop(); }; play_btn.onRelease = function() { trace("sound started"); my_sound.start(); };
Vase tambin
start (mtodo Sound.start)

Stage
Object | +-Stage public class Stage extends Object
La clase Stage es una clase de nivel superior a cuyos mtodos, propiedades y controladores puede acceder sin emplear un constructor. Utilice los mtodos y propiedades de esta clase para acceder a la informacin de lmites de un archivo SWF y manipularla. Disponibilidad Flash Lite 2.0 Resumen de propiedades
Modificadores
static
Propiedad align:String
Descripcin Indica la alineacin actual del archivo SWF en el reproductor o navegador. Propiedad (slo lectura); indica la altura actual en pxeles del escenario. Indica la escala actual del archivo SWF dentro de Flash Lite Player. Propiedad (slo lectura); indica la anchura actual en pxeles del escenario.
static
height:Number
static
scaleMode:String
static
width:Number

Resumen de eventos
Evento onResize =
function() {}
Descripcin Se invoca cuando Stage.scaleMode se establece como noScale y se redimensiona el archivo SWF.
Resumen de mtodos
Modificadores
static
Firma addListener(listener: Object) : Void
Descripcin Detecta cundo se redimensiona un archivo SWF (pero slo si Stage.scaleMode = "noScale").
static
removeListener(listene Elimina un objeto detector creado con addListener(). r:Object) : Boolean

addListener (mtodo Stage.addListener)

Detecta cundo se redimensiona un archivo SWF (pero slo si Stage.scaleMode = "noScale"). El mtodo addListener() no funciona con la configuracin predeterminada de escala de clip de pelcula (showAll) ni con otras configuraciones de escala (exactFit y noBorder). Para utilizar addListener(), deber crear primero un listener object (objeto detector). Los objetos detectores del escenario reciben notificacin de Stage.onResize. Disponibilidad Flash Lite 2.0 Parmetros listener:Object - Objeto que detecta una notificacin callback del evento Stage.onResize. Ejemplo Este ejemplo crea un nuevo objeto detector con el nombre stageListener. A continuacin, utiliza stageListener para llamar a onResize y definir una funcin que se llamar cuando se active onResize. Por ltimo, el cdigo aade el objeto stageListener a la lista de funciones callback del objeto Stage. Los objetos detectores permiten que varios objetos detecten las notificaciones de cambio de tamao.
this.createTextField("stageSize_txt", this.getNextHighestDepth(), 10, 10, 100, 22); var stageListener:Object = new Object(); stageListener.onResize = function() { stageSize_txt.text = "w:"+Stage.width+", h:"+Stage.height; }; Stage.scaleMode = "noScale"; Stage.addListener(stageListener);
Vase tambin
onResize (detector de eventos Stage.onResize), removeListener (mtodo Stage.removeListener)
align (propiedad Stage.align)

public static align : String
Indica la alineacin actual del archivo SWF en el reproductor o navegador. En la siguiente tabla se enumeran los valores de la propiedad align. Todos aquellos valores no incluidos aqu centran el archivo SWF en Flash Player o el navegador, que es la configuracin predeterminada.

Valor "T" "B" "L" "R" "TL" "TR" "BL" "BR"
Vertical arriba abajo centro centro arriba arriba abajo abajo
Horizontal centro centro izquierda derecha izquierda derecha izquierda derecha
Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente demuestra las distintas alineaciones del archivo SWF. Aada una instancia de ComboBox al documento con el nombre stageAlign_cb. Aada el siguiente cdigo ActionScript al archivo FLA o AS:
var stageAlign_cb:mx.controls.ComboBox; stageAlign_cb.dataProvider = ['T', 'B', 'L', 'R', 'TL', 'TR', 'BL', 'BR']; var cbListener:Object = new Object(); cbListener.change = function(evt:Object) { var align:String = evt.target.selectedItem; Stage.align = align; }; stageAlign_cb.addEventListener("change", cbListener); Stage.scaleMode = "noScale";
Seleccione distintas configuraciones de alineacin desde el ComboBox.
height (propiedad Stage.height)

public static height : Number
Propiedad (slo lectura); indica la altura actual en pxeles del escenario. Cuando el valor de Stage.scaleMode es noScale, la propiedad height representa la altura de Flash Lite Player. Cuando el valor de Stage.scaleMode no es noScale, la propiedad height representa la altura del archivo SWF. Disponibilidad Flash Lite 2.0 Ejemplo Este ejemplo crea un nuevo objeto detector con el nombre stageListener. A continuacin, utiliza myListener para llamar a onResize y definir una funcin que se llamar cuando se active onResize. Por ltimo, el cdigo aade el objeto myListener a la lista de funciones callback del objeto Stage. Los objetos detectores permiten que varios objetos detecten las notificaciones de cambio de tamao.

Vase tambin
align (propiedad Stage.align), scaleMode (propiedad Stage.scaleMode), width (propiedad Stage.width)
onResize (detector de eventos Stage.onResize)

onResize = function() {}
Se invoca cuando Stage.scaleMode se establece como noScale y se redimensiona el archivo SWF. Puede utilizar este controlador de eventos para escribir una funcin que disponga los objetos en el escenario cuando se redimensione el archivo SWF. Disponibilidad Flash Lite 2.0 Ejemplo El siguiente ejemplo muestra un mensaje en el panel Salida cuando se cambia el tamao del escenario:
Stage.scaleMode = "noScale" var myListener:Object = new Object(); myListener.onResize = function () { trace("Stage size is now " + Stage.width + " by " + Stage.height); } Stage.addListener(myListener); // later, call Stage.removeListener(myListener)
Vase tambin
scaleMode (propiedad Stage.scaleMode), addListener (mtodo Stage.addListener), removeListener (mtodo Stage.removeListener)
removeListener (mtodo Stage.removeListener)

Elimina un objeto detector creado con addListener(). Disponibilidad Flash Lite 2.0 Parmetros listener:Object - Objeto aadido a una lista de funciones de callback de un objeto con addListener(). Valor devuelto Boolean - Valor booleano.

Ejemplo El ejemplo siguiente muestra las dimensiones del escenario en un campo de texto creado de forma dinmica. Cuando se modifica el tamao del escenario, se actualizan los valores del campo de texto. Cree un botn con el nombre de instancia remove_btn. Aada el siguiente cdigo ActionScript al fotograma 1 de la lnea de tiempo.
this.createTextField("stageSize_txt", this.getNextHighestDepth(), 10, 10, 100, 22); stageSize_txt.autoSize = true; stageSize_txt.border = true; var stageListener:Object = new Object(); stageListener.onResize = function() { stageSize_txt.text = "w:"+Stage.width+", h:"+Stage.height; }; Stage.addListener(stageListener); remove_btn.onRelease = function() { stageSize_txt.text = "Removing Stage listener..."; Stage.removeListener(stageListener); }
Seleccione Control > Probar pelcula para probar este ejemplo. Los valores que se ven en el campo de texto se actualizan cuando se cambia el tamao del entorno de prueba. Al hacer clic en remove_btn, el detector desaparece y los valores dejan de actualizarse en el campo de texto. Vase tambin
addListener (mtodo Stage.addListener)
scaleMode (propiedad Stage.scaleMode)

public static scaleMode : String
Indica la escala actual del archivo SWF dentro de Flash Lite Player. La propiedad scaleMode fuerza al archivo SWF a adoptar un modo de escala especfico. De manera predeterminada, el archivo SWF utiliza los parmetros HTML establecidos en el cuadro de dilogo Configuracin de publicacin. La propiedad scaleMode puede utilizar los valores "exactFit", "showAll", "noBorder" y "noScale". Cualquier otro valor establece la propiedad scaleMode con el valor predeterminado, "showAll".
showAll (Predeterminada) permite ver todo el contenido de Flash en el rea especificada sin distorsin, al mismo
tiempo que mantiene la proporcin original del contenido. Es posible que aparezcan bordes a ambos lados de la aplicacin.
noBorder modifica la escala del contenido de Flash para que ocupe toda el rea especificada, sin distorsin pero quiz con algn recorte, al mismo tiempo que mantiene la proporcin original de la aplicacin.
exactFit hace que la totalidad del contenido de Flash sea visible en el rea especificada sin intentar mantener la proporcin original. Puede ocurrir una distorsin. noScale hace que el tamao del contenido de Flash sea fijo, de manera que permanezca sin cambios aunque cambie el tamao de la ventana del reproductor. Puede producirse un recorte si la
ventana del reproductor es ms pequea que el contenido de Flash. Nota: la configuracin predeterminada es showAll, salvo en el modo de probar pelcula, en el
que la configuracin predeterminada es noScale

Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente prueba varias configuraciones de escala para el archivo SWF. Aada una instancia de ComboBox al documento con el nombre scaleMode_cb. Aada el siguiente cdigo ActionScript al archivo FLA o AS:
var scaleMode_cb:mx.controls.ComboBox; scaleMode_cb.dataProvider = ["showAll", "exactFit", "noBorder", "noScale"]; var cbListener:Object = new Object(); cbListener.change = function(evt:Object) { var scaleMode_str:String = evt.target.selectedItem; Stage.scaleMode = scaleMode_str; }; scaleMode_cb.addEventListener("change", cbListener);
Para ver otro ejemplo, consulte el archivo stagesize.fla de la carpeta de ejemplos de ActionScript en www.adobe.com/go/learn_fl_samples_and_tutorials. Descargue y descomprima el archivo Samples_and_Tutorials.zip para su versin de Flash Lite y acceda a la carpeta ActionScript para abrir el archivo de ejemplo.
width (propiedad Stage.width)

public static width : Number
Propiedad (slo lectura); indica la anchura actual en pxeles del escenario. Cuando el valor de Stage.scaleMode es "noScale", la propiedad width representa la anchura de Flash Lite Player. Esto significa que Stage.width variar al redimensionar la ventana del reproductor. Cuando el valor de Stage.scaleMode no es "noScale", width representa la anchura del archivo SWF configurada durante la edicin del archivo en el cuadro de dilogo Propiedades del documento. Esto significa que el valor de width se mantiene constante al redimensionar la ventana del reproductor. Disponibilidad Flash Lite 2.0 Ejemplo Este ejemplo crea un nuevo objeto detector con el nombre stageListener. A continuacin, utiliza stageListener para llamar a onResize y definir una funcin que se llamar cuando se active onResize. Por ltimo, el cdigo aade el objeto stageListener a la lista de funciones callback del objeto Stage. Los objetos detectores permiten que varios objetos detecten las notificaciones de cambio de tamao.
Vase tambin
align (propiedad Stage.align), height (propiedad Stage.height), scaleMode (propiedad Stage.scaleMode)

String
Object | +-String public class String extends Object
La clase String es un envolvente para el tipo de datos primitivo de cadena y proporciona mtodos y propiedades que permiten manipular tipos de valores de cadena primitivos. Puede convertir el valor de cualquier objeto en una cadena utilizando la funcin String(). Todos los mtodos de la clase String, salvo concat(), fromCharCode(), slice() y substr() son genricos, lo que significa que los mtodos llaman a toString() antes de realizar sus operaciones y puede llamar a estos mtodos con otros objetos que no sean String. Dado que todos los ndices de cadenas estn basados en cero, el ndice del ltimo carcter de cualquier cadena x es
x.length - 1.
Puede llamar a cualquiera de los mtodos de la clase String utilizando el mtodo constructor new String o utilizando un nuevo valor de literal de cadena. Si especifica un literal de cadena, el intrprete de ActionScript lo convierte automticamente en un objeto String temporal, llama al mtodo y luego descarta el objeto String temporal. Tambin puede utilizar la propiedad String.length con un literal de cadena. No debe confundir un literal de cadena con un objeto String. En el siguiente ejemplo, la primera lnea de cdigo crea el literal de first_string, mientras que la segunda lnea de cdigo crea el objeto String second_string:
var first_string:String = "foo" var second_string:String = new String("foo")
Utilice literales de cadena a no ser que necesite utilizar un objeto String especficamente. Disponibilidad Flash Lite 2.0 Resumen de propiedades
Modificadores Propiedad length:Number Descripcin Entero que especifica el nmero de caracteres del objeto String especificado.

Firma String(valor:String) Descripcin Crea un nuevo objeto String.

Resumen de mtodos
Modificadores Firma charAt(index:Number) : String Descripcin Devuelve el carcter situado en la posicin especificada por el parmetro index.
charCodeAt(index:Num Devuelve un entero de 16 bits comprendido entre 0 y 65535 que representa el carcter especificado por index. ber) : Number concat(valor:Object) : String Combina el valor del objeto String con los parmetros y devuelve la nueva cadena formada; el valor original, my_str, permanece sin cambios. Devuelve una cadena formada por los caracteres representados por los valores Unicode de los parmetros. Busca la cadena y devuelve la posicin en la que aparece por primera vez value en la posicin de startIndex o despus de dicha posicin dentro de la cadena que origina la llamada. Busca la cadena de derecha a izquierda y devuelve el ndice de la ltima posicin en que aparece value antes que startIndex dentro de la cadena que origina la llamada.
static
fromCharCode() : String indexOf(valor:String, [startIndex:Number] ) : Number lastIndexOf(valor:Strin g, [startIndex:Number] ) : Number slice(start:Number, end:Number) : String
Devuelve una cadena que incluye el carcter inicial (start) y todos los caracteres que aparecen hasta el carcter final (end), exclusive.
split(delimiter:String, Divide un objeto String en subcadenas fragmentndolo [limit:Number]) : siempre que aparece el parmetro delimitador (delimiter) Array especificado y devuelve las subcadenas en una matriz. substr(start:Number, length:Number) : String Devuelve los caracteres contenidos en una cadena desde el ndice especificado por el parmetro start hasta el nmero de caracteres especificado por el parmetro length.
substring(start:Numbe Devuelve una cadena formada por los caracteres r, end:Number) : comprendidos entre los puntos especificados por los String parmetros start y end. toLowerCase() : String Devuelve una copia del objeto String con todos los caracteres en maysculas convertidos en minsculas. Devuelve las propiedades de un objeto como cadenas aunque no lo sean. Devuelve una copia del objeto String con todos los caracteres en minsculas convertidos en maysculas. Devuelve la cadena.
toString() : String
toUpperCase() : String
valueOf() : String

addProperty (mtodo Object.addProperty), hasOwnProperty (mtodo Object.hasOwnProperty)isPropertyEnumerable (mtodo Object.isPropertyEnumerable)isPrototypeOf (mtodo Object.isPrototypeOf), registerClass (mtodo Object.registerClass), toString (mtodo Object.toString). unwatch (mtodo Object.unwatch), valueOf (mtodo Object.valueOf), watch (mtodo Object.watch)
charAt (mtodo String.charAt)

public charAt(index:Number) : String

Devuelve el carcter situado en la posicin especificada por el parmetro index. Si index no es un nmero entre 0 y string.length - 1, se devolver una cadena vaca. Este mtodo es igual que String.charCodeAt(), con la diferencia de que el valor devuelto es un carcter, no un cdigo de carcter de entero de 16 bits. Disponibilidad Flash Lite 2.0 Parmetros index:Number - Entero que especifica la posicin de un carcter en la cadena. El primer carcter se indica por 0 y el ltimo por my_str.length - 1. Valor devuelto String - El carcter en el ndice especificado. O una cadena (String) vaca si el ndice especificado est fuera del rango de los ndices de esta String. Ejemplo En el ejemplo siguiente, este mtodo se llama en la primera letra de la cadena "Chris":
var my_str:String = "Chris"; var firstChar_str:String = my_str.charAt(0); trace(firstChar_str); // output: C
Vase tambin

public charCodeAt(index:Number) : Number
Devuelve un entero de 16 bits comprendido entre 0 y 65535 que representa el carcter especificado por index. Si index no es un nmero entre 0 y string.length - 1, se devolver NaN. Este mtodo es igual que String.charAt(), con la diferencia de que el valor devuelto es un cdigo de carcter de entero de 16 bits, no un carcter. Disponibilidad Flash Lite 2.0 Parmetros index:Number - Entero que especifica la posicin de un carcter en la cadena. El primer carcter se indica por 0 y el ltimo, por my_str.length -1. Valor devuelto Number - Entero que representa el carcter especificado por index. Ejemplo En el ejemplo siguiente, se llama a este mtodo en la primera letra de la cadena "Chris":

var my_str:String = "Chris"; var firstChar_num:Number = my_str.charCodeAt(0); trace(firstChar_num); // output: 67
Vase tambin
charAt (mtodo String.charAt)
concat (mtodo String.concat)

public concat(value:Object) : String
Combina el valor del objeto String con los parmetros y devuelve la nueva cadena formada; el valor original, my_str, permanece sin cambios. Disponibilidad Flash Lite 2.0 Parmetros valor:Object - value1[,...valueN] - Cero o ms valores para concatenar. Valor devuelto String - Una cadena. Ejemplo El ejemplo siguiente crea dos cadenas y las combina utilizado String.concat():
var stringA:String = "Hello"; var stringB:String = "World"; var combinedAB:String = stringA.concat(" ", stringB); trace(combinedAB); // output: Hello World

public static fromCharCode() : String
Devuelve una cadena formada por los caracteres representados por los valores Unicode de los parmetros. Disponibilidad Flash Lite 2.0 Valor devuelto String - Cadena de los cdigos de caracteres Unicode especificados. Ejemplo El ejemplo siguiente utiliza fromCharCode() para insertar un carcter @ en la direccin de correo electrnico:
var address_str:String = "dog"+String.fromCharCode(64)+"house.net"; trace(address_str); // output: dog@house.net
indexOf (mtodo String.indexOf)

public indexOf(value:String, [startIndex:Number]) : Number

Busca la cadena y devuelve la posicin en la que aparece por primera vez value en la posicin de startIndex o despus de dicha posicin dentro de la cadena que origina la llamada. Este ndice est basado en cero, con lo cual se considera que el primer carcter est en el ndice 0, no en el ndice 1. Si no se encuentra value, el mtodo devuelve -1. Disponibilidad Flash Lite 2.0 Parmetros valor:String - Cadena que especifica que texto de la bsqueda. startIndex:Number [opcional] - Entero que especifica el ndice inicial de la bsqueda. Valor devuelto Number - Posicin en la que aparece por primera vez la subcadena especificada o -1. Ejemplo Los siguientes ejemplos utilizan indexOf() para devolver el ndice de caracteres y subcadenas:
var searchString:String = "Lorem ipsum dolor sit amet."; var index:Number; index = searchString.indexOf("L"); trace(index); // output: 0 index = searchString.indexOf("l"); trace(index); // output: 14 index = searchString.indexOf("i"); trace(index); // output: 6 index = searchString.indexOf("ipsum"); trace(index); // output: 6 index = searchString.indexOf("i", 7); trace(index); // output: 19 index = searchString.indexOf("z"); trace(index); // output: -1
Vase tambin
lastIndexOf (mtodo String.lastIndexOf)
lastIndexOf (mtodo String.lastIndexOf)

public lastIndexOf(value:String, [startIndex:Number]) : Number
Busca la cadena de derecha a izquierda y devuelve el ndice de la ltima posicin en que aparece value antes que startIndex dentro de la cadena que origina la llamada. Este ndice est basado en cero, con lo cual se considera que el primer carcter est en el ndice 0, no en el ndice 1. Si no se encuentra value, el mtodo devuelve -1. Disponibilidad Flash Lite 2.0

Parmetros valor:String - La cadena que se busca. startIndex:Number [opcional] - Entero que especifica dnde se inicia la bsqueda de value. Valor devuelto Number - Posicin en la que aparece por ltima vez la subcadena especificada o -1. Ejemplo El ejemplo siguiente muestra cmo utilizar lastIndexOf() para devolver el ndice de un carcter determinado:
var searchString:String = "Lorem ipsum dolor sit amet."; var index:Number; index = searchString.lastIndexOf("L"); trace(index); // output: 0 index = searchString.lastIndexOf("l"); trace(index); // output: 14 index = searchString.lastIndexOf("i"); trace(index); // output: 19 index = searchString.lastIndexOf("ipsum"); trace(index); // output: 6 index = searchString.lastIndexOf("i", 18); trace(index); // output: 6 index = searchString.lastIndexOf("z"); trace(index); // output: -1
Vase tambin
indexOf (mtodo String.indexOf)
length (propiedad String.length)

Entero que especifica el nmero de caracteres del objeto String especificado. Dado que todos los ndices de cadenas estn basados en cero, el ndice del ltimo carcter de cualquier cadena x es x.length - 1. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un nuevo objeto String y utiliza String.length para contar el nmero de caracteres:
var my_str:String = "Hello world!"; trace(my_str.length); // output: 12
El ejemplo siguiente pasa de 0 a my_str.length. El cdigo comprueba los caracteres de una cadena y si contiene el carcter @, true en el panel Salida. Si no contiene el carcter @, aparece false en el panel Salida.

function checkAtSymbol(my_str:String):Boolean { for (var i = 0; i<my_str.length; i++) { if (my_str.charAt(i) == "@") { return true; } } return false; } trace(checkAtSymbol("dog@house.net")); // output: true trace(checkAtSymbol("Chris")); // output: false
Tambin hay un ejemplo en el archivo Strings.fla de la carpeta de ejemplos de ActionScript de www.adobe.com/go/learn_fl_samples_es. Descargue y descomprima el archivo .zip y acceda a la carpeta de su versin de ActionScript para poder ver el ejemplo.
slice (mtodo String.slice)

public slice(start:Number, end:Number) : String
Devuelve una cadena que incluye el carcter inicial (start) y todos los caracteres que aparecen hasta el carcter final (end), exclusive. El objeto String original no se modifica. Si no se especifica el parmetro end, el final de la subcadena ser el final de la cadena. Si el carcter indexado por start es el mismo o est situado a la derecha del carcter indexado por end, el mtodo devolver una cadena vaca. Disponibilidad Flash Lite 2.0 Parmetros start:Number - ndice basado en cero del punto inicial de la divisin. Si start es un nmero negativo, el punto de inicio se establece desde el final de la cadena, donde -1 es el ltimo carcter. end:Number - Entero que es un nmero por encima del ndice del punto final de la divisin. El carcter indexado por el parmetro end no se incluye en la cadena extrada. Si se omite este parmetro, se emplear String.length. Si end es un nmero negativo, el punto final se establece desde el final de la cadena, donde -1 es el ltimo carcter. Valor devuelto String - Subcadena de la cadena especificada. Ejemplo El ejemplo siguiente crea una variable, my_str, le asigna un valor String y llama al mtodo slice() utilizando distintos valores para los parmetros start y end. Cada llamada a slice() se ajusta en una sentencia trace() que muestra la salida en el panel Salida.

// // // //
Index values for the string literal positive index: 0 1 2 3 4 string: L o r e m negative index: -5 -4 -3 -2 -1
var my_str:String = "Lorem"; // slice the first character trace("slice(0,1): "+my_str.slice(0, 1)); // output: slice(0,1): L trace("slice(-5,1): "+my_str.slice(-5, 1)); // output: slice(-5,1): L // slice the middle three characters trace("slice(1,4): "+my_str.slice(1, 4)); // slice(1,4): ore trace("slice(1,-1): "+my_str.slice(1, -1)); // slice(1,-1): ore // slices that return empty strings because start is not to the left of end trace("slice(1,1): "+my_str.slice(1, 1)); // slice(1,1): trace("slice(3,2): "+my_str.slice(3, 2)); // slice(3,2): trace("slice(-2,2): "+my_str.slice(-2, 2)); // slice(-2,2): // slices that omit the end parameter use String.length, which equals 5 trace("slice(0): "+my_str.slice(0)); // slice(0): Lorem trace("slice(3): "+my_str.slice(3)); // slice(3): em
Tambin hay un ejemplo en el archivo Strings.fla de la carpeta de ejemplos de ActionScript de www.adobe.com/go/learn_fl_samples_es. Descargue y descomprima el archivo .zip y acceda a la carpeta de su versin de ActionScript para poder ver el ejemplo. Vase tambin
substr (mtodo String.substr), substring (mtodo String.substring)
split (mtodo String.split)

public split(delimiter:String, [limit:Number]) : Array
Divide un objeto String en subcadenas fragmentndolo siempre que aparece el parmetro delimitador (delimiter) especificado y devuelve las subcadenas en una matriz. Si utiliza una cadena vaca ("") como delimitador, cada carcter de la cadena se situar como elemento de la matriz. Si el parmetro delimiter tiene el valor undefined, se situar la cadena completa en el primer elemento de la matriz devuelta. Disponibilidad Flash Lite 2.0 Parmetros delimiter:String - Una cadena; el carcter o la cadena donde se divide my_str. limit:Number [opcional] - Nmero de elementos que se va a incluir en la matriz. Valor devuelto Array - Matriz que contiene las subcadenas de my_str.

Ejemplo El ejemplo siguiente devuelve una matriz con cinco elementos:

var my_str:String = "P,A,T,S,Y"; var my_array:Array = my_str.split(","); for (var i = 0; i<my_array.length; i++) { trace(my_array[i]); } // output: P A T S Y
El ejemplo siguiente devuelve una matriz con dos elementos, "P" y "A":
var my_str:String = "P,A,T,S,Y"; var my_array:Array = my_str.split(",", 2); trace(my_array); // output: P,A
El ejemplo siguiente muestra que si utiliza una cadena vaca ("") para el parmetro delimiter, cada carcter de la cadena se situar como elemento de la matriz:
var my_str:String = new String("Joe"); var my_array:Array = my_str.split(""); for (var i = 0; i<my_array.length; i++) { trace(my_array[i]); } // output: J o e
Tambin hay un ejemplo en el archivo Strings.fla de la carpeta de ejemplos de ActionScript de www.adobe.com/go/learn_fl_samples_es. Descargue y descomprima el archivo .zip y acceda a la carpeta de su versin de ActionScript para poder ver el ejemplo. Vase tambin
join (mtodo Array.join)
Constructor String
public String(value:String)
Crea un nuevo objeto String. Nota: dado que los literales de cadena utilizan menos espacio que los objetos String y son generalmente ms fciles de usar, deber utilizar literales de cadena en lugar del constructor de la clase String a no ser que exista un motivo especfico para utilizar un objeto String en lugar de un literal de cadena. Disponibilidad Flash Lite 2.0

Parmetros valor:String - Valor inicial del nuevo objeto String.

public substr(start:Number, length:Number) : String
Devuelve los caracteres contenidos en una cadena desde el ndice especificado por el parmetro start hasta el nmero de caracteres especificado por el parmetro length. El mtodo substr no cambia la cadena especificada por my_str, sino que devuelve una cadena nueva. Disponibilidad Flash Lite 2.0 Parmetros start:Number - Entero que indica la posicin del primer carcter de my_str que se va a utilizar para crear la subcadena. Si start es un nmero negativo, el punto de inicio se establece desde el final de la cadena, donde -1 es el ltimo carcter. length:Number - Nmero de caracteres de la subcadena que se va a crear. Si no se especifica length, la subcadena incluye todos los caracteres desde el principio al final de la cadena. Valor devuelto String - Subcadena de la cadena especificada. Ejemplo El ejemplo siguiente crea una nueva cadena, my_str y utiliza substr() para devolver la segunda palabra de la cadena; primero utilizando un parmetro start positivo y, a continuacin, con un parmetro start negativo:
var my_str:String = new String("Hello world"); var mySubstring:String = new String(); mySubstring = my_str.substr(6,5); trace(mySubstring); // output: world mySubstring = my_str.substr(-5,5); trace(mySubstring); // output: world
substring (mtodo String.substring)

public substring(start:Number, end:Number) : String
Devuelve una cadena formada por los caracteres comprendidos entre los puntos especificados por los parmetros start y end. Si no se especifica el parmetro end, el final de la subcadena ser el final de la cadena. Si el valor de start es igual al valor de end, el mtodo devolver una cadena vaca. Si el valor de start es mayor que el valor de end, los parmetros se intercambiarn automticamente antes de que se ejecute la funcin y el valor original permanecer sin cambios. Disponibilidad Flash Lite 2.0

Parmetros start:Number - Entero que indica la posicin del primer carcter de my_str que se va a utilizar para crear la subcadena. Los valores vlidos para start incluyen del 0 a String.length - 1. Si start es un nmero negativo, se utiliza 0. end:Number - Entero que es 1+ el ndice del ltimo carcter de my_str que se va a extraer. Los valores vlidos para end son desde 1 hasta String.length. El carcter indexado por el parmetro end no se incluye en la cadena extrada. Si se omite este parmetro, se emplear String.length. Si este parmetro es un valor negativo, se utiliza 0. Valor devuelto String - Subcadena de la cadena especificada. Ejemplo El ejemplo siguiente muestra cmo utilizar substring():
var my_str:String = "Hello world"; var mySubstring:String = my_str.substring(6,11); trace(mySubstring); // output: world
El ejemplo siguiente muestra qu ocurre si se utiliza un parmetro start negativo:

var my_str:String = "Hello world"; var mySubstring:String = my_str.substring(-5,5); trace(mySubstring); // output: Hello
toLowerCase (mtodo String.toLowerCase)

public toLowerCase() : String
Devuelve una copia del objeto String con todos los caracteres en maysculas convertidos en minsculas. El valor original permanece sin cambios. Disponibilidad Flash Lite 2.0 Valor devuelto String - Una cadena. Ejemplo El ejemplo siguiente crea una cadena con todos los caracteres en maysculas y, a continuacin, crea una copia de esa cadena mediante toLowerCase() para convertir todos los caracteres a minsculas:
var upperCase:String = "LOREM IPSUM DOLOR"; var lowerCase:String = upperCase.toLowerCase(); trace("upperCase: " + upperCase); // output: upperCase: LOREM IPSUM DOLOR trace("lowerCase: " + lowerCase); // output: lowerCase: lorem ipsum dolor
Tambin hay un ejemplo en el archivo Strings.fla de la carpeta de ejemplos de ActionScript de La pgina de ejemplos de Adobe Flash. Descargue y descomprima el archivo .zip y acceda a la carpeta de su versin de ActionScript para poder ver el ejemplo.

Vase tambin
toUpperCase (mtodo String.toUpperCase)
toString (mtodo String.toString)

Devuelve las propiedades de un objeto como cadenas aunque no lo sean. Disponibilidad Flash Lite 2.0 Valor devuelto String - La cadena. Ejemplo El ejemplo siguiente devuelve una cadena en maysculas que incluye todas las propiedades de un objeto, sean o no sean cadenas:
var employee:Object = new Object(); employee.name = "bob"; employee.salary = 60000; employee.id = 284759021; var employeeData:String = new String(); for (prop in employee) { employeeData += employee[prop].toString().toUpperCase() + " "; } trace(employeeData);
Si el mtodo toString() no se incluyera en este cdigo (y la lnea dentro del bucle for utilizara employee[prop].toUpperCase()), la salida sera "undefined undefined BOB". Al incluir el mtodo toString(), se obtiene la salida deseada: "284759021 60000 BOB".
toUpperCase (mtodo String.toUpperCase)

public toUpperCase() : String
Devuelve una copia del objeto String con todos los caracteres en minsculas convertidos en maysculas. El valor original permanece sin cambios. Disponibilidad Flash Lite 2.0 Valor devuelto String - Una cadena. Ejemplo El ejemplo siguiente crea una cadena con todos los caracteres en maysculas y, a continuacin, crea una copia de la cadena con toUpperCase():

var lowerCase:String = "lorem ipsum dolor"; var upperCase:String = lowerCase.toUpperCase(); trace("lowerCase: " + lowerCase); // output: lowerCase: lorem ipsum dolor trace("upperCase: " + upperCase); // output: upperCase: LOREM IPSUM DOLOR
Tambin hay un ejemplo en el archivo Strings.fla de la carpeta de ejemplos de ActionScript de La pgina de ejemplos de Adobe Flash. Descargue y descomprima el archivo .zip y acceda a la carpeta de su versin de ActionScript para poder ver el ejemplo. Vase tambin
toLowerCase (mtodo String.toLowerCase)
valueOf (mtodo String.valueOf)

public valueOf() : String
Devuelve la cadena. Disponibilidad Flash Lite 2.0 Valor devuelto String - Valor de la cadena. Ejemplo El ejemplo siguiente crea una nueva instancia del objeto String y a continuacin muestra que el mtodo valueOf devuelve una referencia al valor primitivo, en lugar de una instancia del objeto.
var str:String = new String("Hello World"); var value:String = str.valueOf(); trace(str instanceof String); // true trace(value instanceof String); // false trace(str === value); // false
System
Object | +-System public class System extends Object
La clase System contiene propiedades relacionadas con determinadas operaciones que tienen lugar en el equipo del usuario como, por ejemplo, operaciones con objetos compartidos y el portapapeles. El paquete System incluye las siguientes propiedades y mtodos adicionales en clases especficas: la clase capabilities (vase System.capabilities) y la clase security (vase System.security). Disponibilidad Flash Lite 2.0

Vase tambin
capabilities (System.capabilities), Security (System.security)
Modificadores
static
Propiedad useCodepage:Boolean
Descripcin Valor booleano que indica a Flash Lite Player si debe utilizar Unicode o la pgina de cdigos tradicional del sistema operativo en el que se ejecuta el reproductor para interpretar los archivos de texto externos.

Resumen de eventos
Evento onStatus =
function(infoObject:Object) {}
Descripcin Controlador de eventos: ofrece un supercontrolador de eventos para determinados objetos.

onStatus (controlador System.onStatus)

Controlador de eventos: ofrece un supercontrolador de eventos para determinados objetos. La clase SharedObject ofrece un controlador de eventos onStatus() que utiliza un objeto de informacin para proporcionar mensajes de informacin, estado o error. Para responder a este controlador de eventos, deber crear una funcin que procese el objeto de informacin y deber conocer el formato y el contenido del objeto de informacin devuelto. Adems del mtodo SharedObject.onStatus(), Flash tambin ofrece una superfuncin denominada System.onStatus() que acta como controlador secundario de mensajes de error. Si una instancia de la clase SharedObject pasa un objeto de informacin con la propiedad de nivel "error" pero no ha definido una funcin onStatus() para esa instancia concreta, Flash utilizar en su lugar la funcin que defina para System.onStatus(). Disponibilidad Flash Lite 2.0 Parmetros infoObject:Object - Parmetro definido de acuerdo con el mensaje de estado.

Ejemplo El ejemplo siguiente muestra cmo crear una funcin System.onStatus() para procesar objetos de informacin cuando no existe una funcin onStatus() especfica de clase:
// Create generic function System.onStatus = function(genericError:Object){ // Your script would do something more meaningful here trace("An error has occurred. Please try again."); }
Vase tambin
onStatus (controlador SharedObject.onStatus)
useCodepage (propiedad System.useCodepage)

public static useCodepage : Boolean
Valor booleano que indica a Flash Lite Player si debe utilizar Unicode o la pgina de cdigos tradicional del sistema operativo en el que se ejecuta el reproductor para interpretar los archivos de texto externos. El valor predeterminado de System.useCodepage es false.
Si la propiedad est definida en false, Flash Lite Player interpretar los archivos de texto externos como Unicode.
(Estos archivos deben codificarse como Unicode cuando se guardan.)
Si la propiedad se establece con el valor true, Flash Lite Player interpretar los archivos de texto externos empleando
la pgina de cdigos tradicional del sistema operativo en el que se ejecuta el reproductor. Deber codificar como Unicode el texto que cargue como archivo externo (mediante las sentencias loadVariables() o getURL(), o bien las clases LoadVars o XML) al guardar el archivo de texto para que Flash Lite Player lo reconozca como Unicode. Para codificar archivos externos como Unicode, guarde los archivos en una aplicacin que admita Unicode, como el Bloc de notas de Windows 2000. Si carga archivos de texto externos que no estn codificados como Unicode, deber configurar System.useCodepage con el valor true. Aada el cdigo siguiente como la primera lnea de cdigo del primer fotograma del archivo SWF que carga los datos:
System.useCodepage = true;
Cuando este cdigo est presente, Flash Lite Player interpreta el texto externo empleando la pgina de cdigos tradicional del sistema operativo en el que se ejecuta Flash Lite Player. sta es normalmente CP1252 para el sistema operativo Windows en ingls y Shift-JIS para un sistema operativo en japons. Si establece System.useCodepage con el valor true, Flash Player 6 y versiones posteriores tratarn el texto de la misma forma que Flash Player 5. (Flash Player 5 trataba todo el texto como si estuviera en la pgina de cdigos tradicional del sistema operativo en el que se ejecuta el reproductor.) Si establece System.useCodepage con el valor true, recuerde que la pgina de cdigos tradicional del sistema operativo en el que se ejecuta el reproductor debe incluir los caracteres utilizados en el archivo de texto externo para que se muestre el texto. Por ejemplo, si carga un archivo de texto externo que contiene caracteres chinos, dichos caracteres no se visualizarn en un sistema que utilice la pgina de cdigos CP1252, ya que dicha pgina de cdigos no contiene caracteres chinos. Para garantizar que los usuarios de todas las plataformas puedan ver los archivos de texto externos que se utilizan en sus archivos SWF, debe codificar todos los archivos de texto externos como Unicode y establecer System.useCodepage en false de forma predeterminada. De esta forma, Flash Player 6 y versiones posteriores interpretar el texto como Unicode.

TextField
Object | +-TextField public dynamic class TextField extends Object
La clase TextField se utiliza para crear reas para ver e introducir texto. Todos los campos dinmicos y de entrada de texto son instancias de la clase TextField. Puede asignar a un campo de texto un nombre de instancia en el inspector de propiedades y utilizar los mtodos y propiedades de la clase TextField para manipularlo con ActionScript. Los nombres de instancias de TextField se muestran en el explorador de pelculas y en el cuadro de dilogo Insertar ruta de destino del panel Acciones. Para crear un campo de texto de forma dinmica, llame a MovieClip.createTextField(). Los mtodos de la clase TextField permiten establecer, seleccionar y manipular texto de un campo de texto dinmico o de entrada que se cree durante la edicin o la ejecucin. Disponibilidad Flash Lite 2.0 Vase tambin Object, createTextField (mtodo MovieClip.createTextField) Resumen de propiedades
Modificadores Propiedad _alpha:Number Descripcin Establece o recupera el valor de transparencia alfa del campo de texto. Controla la asignacin de tamao y alineacin automticas de los campos de texto. Especifica si el campo de texto tiene relleno de fondo. Color del fondo del campo de texto.
autoSize:Object
background:Boolean backgroundColor:Numbe r border:Boolean borderColor:Number bottomScroll:Number [slo lectura] condenseWhite:Boolean
Especifica si el campo de texto tiene un borde. Color del borde del campo de texto. Entero (ndice basado en uno) que indica la ltima lnea visible en el campo de texto. Valor booleano que especifica si debe eliminarse el espacio en blanco adicional (espacios, saltos de lnea, etc.) de un campo de texto HTML cuando el campo se muestra en un navegador. Valor booleano que especifica si se representar el campo de texto empleando los contornos de fuentes incorporadas.
embedFonts:Boolean

Modificadores
Propiedad _height:Number _highquality:Number
Descripcin Altura del campo de texto, expresada en pxeles. Desfasada desde Flash Player 7. Esta propiedad est desfasada y en su lugar debe utilizarse TextField._quality. Especifica el nivel de suavizado que se aplica al archivo SWF actual.
hscroll:Number html:Boolean
Indica la posicin de desplazamiento horizontal actual. Indicador que especifica si el campo de texto contiene una representacin HTML. Si el campo de texto es HTML, esta propiedad contiene la representacin HTML del contenido del campo de texto. Indica el nmero de caracteres de un campo de texto.
htmlText:String
length:Number [slo lectura] maxChars:Number
Indica el nmero mximo de caracteres que puede contener el campo de texto. Valor mximo de TextField.hscroll.
maxhscroll:Number [slo lectura] maxscroll:Number [slo lectura] multiline:Boolean _name:String _parent:MovieClip
Valor mximo de TextField.scroll.
Indica si el campo de texto consta de varias lneas. Nombre de instancia del campo de texto. Referencia al clip de pelcula u objeto que contiene el campo de texto u objeto actual. Especifica si el campo de texto es un campo de texto de contrasea. Propiedad (global); establece o recupera la calidad de representacin utilizada por un archivo SWF. Giro del campo de texto, expresado en grados, con respecto a su orientacin original. Define la posicin vertical del texto de un campo de texto. Valor booleano que indica si el campo de texto puede seleccionarse. Especifica el nmero de segundos que un sonido debe almacenarse en el bfer antes de que comience a reproducirse sin interrupcin. Especifica si el campo de texto se incluye en el orden de tabulacin automtico. Permite personalizar el orden de tabulacin de los objetos de un archivo SWF. Ruta de destino de la instancia del campo de texto.
password:Boolean
_quality:String
_rotation:Number
scroll:Number selectable:Boolean
tabEnabled:Boolean
tabIndex:Number
_target:String [slo lectura] text:String textColor:Number textHeight:Number
Indica el texto actual del campo de texto. Indica el color del texto de un campo de texto. Indica la altura del texto.

Modificadores
Propiedad textWidth:Number type:String _url:String [slo lectura] variable:String _visible:Boolean
Descripcin Indica la anchura del texto. Especifica el tipo de campo de texto. Recupera el URL del archivo SWF que cre el campo de texto. Nombre de la variable a la que est asociada el campo de texto. Valor booleano que indica si el campo de texto my_txt puede seleccionarse. Anchura del campo de texto, expresada en pxeles. Valor booleano que indica si el campo de texto tiene ajuste de texto. Entero que establece la coordenada x de un campo de texto relativa a las coordenadas locales del clip de pelcula principal. Devuelve la coordenada x de la posicin del ratn relativa al campo de texto. Determina la escala horizontal del campo de texto aplicada desde el punto de registro del campo de texto, expresada como porcentaje. Establece la coordenada y de un campo de texto relativa a las coordenadas locales del clip de pelcula principal. Indica la coordenada y de la posicin del ratn relativa al campo de texto. La escala vertical del campo de texto aplicada desde el punto de registro del campo de texto, expresada como porcentaje.
_width:Number wordWrap:Boolean
_x:Number
_y:Number

Resumen de eventos
Evento onChanged = Descripcin Controlador de eventos/detector; se invoca cuando cambia el contenido de un campo
function(changedFie de texto. ld:TextField) {}
onKillFocus =
Se invoca cuando un campo de texto deja de estar seleccionado con el teclado.
Controlador de eventos/detector; se invoca cuando cambia una de las propiedades de onScroller = function(scrolledFi desplazamiento de un campo de texto. eld:TextField) {} onSetFocus =
Se invoca cuando un campo de texto se selecciona con el teclado.

Resumen de mtodos
Modificadores Firma addListener(listener: Object) : Boolean getDepth() : Number getNewTextFormat() : TextFormat getTextFormat([beginI ndex:Number], [endIndex:Number]) : TextFormat Descripcin Registra un objeto para recibir mensajes de notificacin de eventos TextField. Devuelve la profundidad de un campo de texto. Devuelve un objeto TextFormat que contiene una copia del objeto de formato de texto del campo de texto. Devuelve un objeto TextFormat para un carcter, rango de caracteres u objeto completo TextField.
removeListener(listene Elimina un objeto detector anteriormente registrado en una r:Object) : Boolean instancia de campo de texto con TextField.addListener(). removeTextField() :
Void
Elimina el campo de texto.
replaceSel(newText:Stri ng) : Void
Reemplaza la seleccin actual por el contenido del parmetro newText.
replaceText(beginIndex Reemplaza el rango de caracteres especificado por los :Number, parmetros beginIndex y endIndex del campo de texto endIndex:Number, indicado por el contenido del parmetro newText. newText:String) :
Void
setNewTextFormat(tf:T extFormat) : Void
Establece el formato de texto nuevo predeterminado de un campo de texto.
setTextFormat([beginIn Aplica el formato de texto especificado por el parmetro dex:Number], textFormat a todo el texto de un campo de texto o a parte de [endIndex:Number], ste. textFormat:TextFormat ) : Void

addProperty (mtodo Object.addProperty), hasOwnProperty (mtodo Object.hasOwnProperty), isPropertyEnumerable (mtodo Object.isPropertyEnumerable), isPrototypeOf (mtodo Object.isPrototypeOf), registerClass (mtodo Object.registerClass), toString (mtodo Object.toString). unwatch (mtodo Object.unwatch), valueOf (mtodo Object.valueOf), watch (mtodo Object.watch)
addListener (mtodo TextField.addListener)

public addListener(listener:Object) : Boolean
Registra un objeto para recibir mensajes de notificacin de eventos TextField. El objeto recibir notificaciones de eventos siempre que se llame a los controladores de eventos onChanged y onScroller. Cuando un campo de texto cambia o se desplaza, se invocan los controladores de eventos TextField.onChanged y TextField.onScroller, seguidos de los controladores de eventos onChanged y onScroller de los objetos registrados como detectores. Pueden registrarse varios objetos como detectores. Para eliminar un objeto detector de un campo de texto, llame a TextField.removeListener().

La fuente del evento pasa a los controladores onScroller y onChanged una referencia a la instancia de campo de texto como parmetro. Se pueden capturar estos datos colocando un parmetro en el mtodo del controlador de eventos. Por ejemplo, el siguiente cdigo utiliza txt como parmetro que se pasa al controlador de eventos onScroller. Luego se utiliza el parmetro en una sentencia trace para enviar el nombre de instancia del campo de texto al panel Salida. Posteriormente se utiliza en un mtodo trace() para escribir el nombre de instancia del campo de texto en el archivo de registro.
my_txt.onScroller = function(textfield_txt:TextField) { trace(textfield_txt._name+" scrolled"); };
Disponibilidad Flash Lite 2.0 Parmetros listener:Object - Objeto con un controlador de eventos onChanged o onScroller. Valor devuelto Boolean Ejemplo El siguiente ejemplo define un controlador onChanged para el campo de texto my_txt. A continuacin, define un nuevo objeto detector txtListener y define un controlador onChanged para ese objeto. Este controlador se invocar cuando el campo de texto my_txt cambie. La ltima lnea de cdigo llama a TextField.addListener para registrar el objeto detector txtListener con el campo de texto my_txt para que reciba una notificacin cuando cambie my_txt.
this.createTextField("my_txt", this.getNextHighestDepth(), 10, 10, 100, 22); my_txt.border = true; my_txt.type = "input"; my_txt.onChanged = function(textfield_(xt:TextField) { trace(textfield_txt._name+" changed"); }; var txtListener:Object = new Object(); txtListener.onChanged = function(textfield_txt:TextField) { trace(textfield_txt._name+" changed and notified myListener"); }; my_txt.addListener(txtListener);
Vase tambin
onChanged (controlador TextField.onChanged), onScroller (controlador TextField.onScroller), removeListener (mtodo TextField.removeListener)
_alpha (propiedad TextField._alpha)

Establece o recupera el valor de transparencia alfa del campo de texto. Los valores vlidos son los comprendidos entre 0 (totalmente transparente) y 100 (totalmente opaco). El valor predeterminado es 100. Los valores de transparencia no se admiten para campos de texto que utilizan fuentes de dispositivo. Deber utilizar fuentes incorporadas para utilizar la propiedad de transparencia _alpha con un campo de texto.

Nota: la propiedad no admite fuentes para rabe, hebreo y tailands. Disponibilidad Flash Lite 2.0 Ejemplo El siguiente cdigo define la propiedad _alpha de un campo de texto denominado my_txt como 20%. Cree un nuevo smbolo de fuente en la biblioteca seleccionando Nueva Fuente en el men de opciones Biblioteca. Posteriormente se establece la vinculacin de la fuente en my font. Se establece la vinculacin para un smbolo de fuente en my font. Aada el siguiente cdigo ActionScript al archivo ActionScript o FLA:
var my_fmt:TextFormat = new TextFormat(); my_fmt.font = "my font"; // where 'my font' is the linkage name of a font in the Library this.createTextField("my_txt", this.getNextHighestDepth(), 10, 10, 100, 22); my_txt.border = true; my_txt.embedFonts = true; my_txt.text = "Hello World"; my_txt.setTextFormat(my_fmt); my_txt._alpha = 20;
Vase tambin
_alpha (propiedad MovieClip._alpha), _alpha (propiedad MovieClip._alpha)
autoSize (propiedad TextField.autoSize)

public autoSize : Object
Controla la asignacin de tamao y alineacin automticas de los campos de texto. Los valores aceptables para autoSize son "none" (predeterminado), "left", "right" y "center". Cuando define la propiedad autoSize property, true es un sinnimo de "left" y false es un sinnimo de "none". Los valores de autoSize y TextField.wordWrap determinan si un campo de texto se ampla o contrae hacia el lado izquierdo, el derecho o el inferior. El valor predeterminado de estas propiedades es false. Si autoSize se establece con el valor "none" (predeterminado) o false, no se producir cambio de tamao. Si autoSize se establece en "left" o true, se considerar que el texto est justificado a la izquierda, lo que significa que el lado izquierdo del campo de texto permanecer fijo y el cambio de tamao de un campo de texto de una sola lnea tendr lugar en el lado derecho. Si el texto incluye un salto de lnea (por ejemplo, "\n" or "\r"), tambin se cambiar el tamao del lado inferior para dar cabida a la siguiente lnea de texto. Si wordWrap tambin se ha configurado con el valor true, slo se cambiar el tamao del lado inferior del campo de texto, mientras que el lado derecho permanecer fijo. Si autoSize se establece en "right", se considerar que el texto est justificado a la derecha, lo que significa que el lado derecho del campo de texto permanecer fijo y el cambio de tamao de un campo de texto de una sola lnea tendr lugar en el lado izquierdo. Si el texto incluye un salto de lnea (por ejemplo, "\n" or "\r"), tambin se cambiar el tamao del lado inferior para dar cabida a la siguiente lnea de texto. Si wordWrap tambin se ha configurado con el valor true, slo se cambiar el tamao del lado inferior del campo de texto, mientras que el lado izquierdo permanecer fijo.

Si autoSize se establece en "center", se considerar que el texto est centrado, lo que significa que el cambio de tamao de un campo de texto de una sola lnea se distribuir por igual entre los lados derecho e izquierdo. Si el texto incluye un salto de lnea (por ejemplo, "\n" o "\r"), tambin se cambiar el tamao del lado inferior para dar cabida a la siguiente lnea de texto. Si wordWrap tambin se ha configurado con el valor true, slo se cambiar el tamao del lado inferior del campo de texto, mientras que los lados izquierdo y derecho permanecern fijos. Disponibilidad Flash Lite 2.0 Ejemplo Puede utilizar el cdigo siguiente y especificar otros valores para autoSize para ver cmo cambia el tamao del campo cuando se modifican estos valores. Si hace clic con el ratn mientras se reproduce el archivo SWF, se reemplazar la cadena "short text" de cada campo de texto por texto ms largo utilizando distintas configuraciones de autoSize.
this.createTextField("left_txt", 997, 10, 10, 70, 30); this.createTextField("center_txt", 998, 10, 50, 70, 30); this.createTextField("right_txt", 999, 10, 100, 70, 30); this.createTextField("true_txt", 1000, 10, 150, 70, 30); this.createTextField("false_txt", 1001, 10, 200, 70, 30); left_txt.text = "short text"; left_txt.border = true; center_txt.text = "short text"; center_txt.border = true; right_txt.text = "short text"; right_txt.border = true; true_txt.text = "short text"; true_txt.border = true; false_txt.text = "short text"; false_txt.border = true; // create a mouse listener object to detect mouse clicks var myMouseListener:Object = new Object(); // define a function that executes when a user clicks the mouse myMouseListener.onMouseDown = function() { left_txt.autoSize = "left"; left_txt.text = "This is much longer text"; center_txt.autoSize = "center"; center_txt.text = "This is much longer text"; right_txt.autoSize = "right"; right_txt.text = "This is much longer text"; true_txt.autoSize = true; true_txt.text = "This is much longer text"; false_txt.autoSize = false; false_txt.text = "This is much longer text"; }; // register the listener object with the Mouse object Mouse.addListener(myMouseListener);

background (propiedad TextField.background)

public background : Boolean
Especifica si el campo de texto tiene relleno de fondo. Si es true, el campo de texto tiene relleno de fondo. Si es false, el campo de texto no tiene relleno de fondo. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un campo de texto con un color de fondo que se activa y desactiva cuando se presiona casi cualquier tecla del teclado.
this.createTextField("my_txt", this.getNextHighestDepth(), 10, 10, 320, 240); my_txt.border = true; my_txt.text = "Lorum ipsum"; my_txt.backgroundColor = 0xFF0000; var keyListener:Object = new Object(); keyListener.onKeyDown = function() { my_txt.background = !my_txt.background; }; Key.addListener(keyListener);
backgroundColor (propiedad TextField.backgroundColor)

public backgroundColor : Number
Color del fondo del campo de texto. El valor predeterminado es 0xFFFFFF (blanco). Esta propiedad puede recuperarse o establecerse aunque no haya actualmente ningn fondo, pero el color slo estar visible si el campo de texto tiene un borde. Disponibilidad Flash Lite 2.0 Ejemplo Consulte el ejemplo de TextField.background. Vase tambin
background (propiedad TextField.background)
border (propiedad TextField.border)

public border : Boolean
Especifica si el campo de texto tiene un borde. Si es true, especifica si el campo de texto tiene un borde. Si es false, el campo de texto no tiene borde. Disponibilidad Flash Lite 2.0

Ejemplo El ejemplo siguiente crea un campo de texto denominado my_txt, define la propiedad border como true y muestra texto en el campo.
this.createTextField("my_txt", this.getNextHighestDepth(), 10, 10, 320, 240); my_txt.border = true; my_txt.text = "Lorum ipsum";
borderColor (propiedad TextField.borderColor)

public borderColor : Number
Color del borde del campo de texto. El valor predeterminado es 0x000000 (negro). Esta propiedad puede recuperarse o establecerse aunque no haya actualmente ningn borde. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un campo de texto denominado my_txt, define la propiedad border como true y muestra texto en el campo.
this.createTextField("my_txt", this.getNextHighestDepth(), 10, 10, 100, 100); my_txt.border = true; my_txt.borderColor = 0x00FF00; my_txt.text = "Lorum ipsum";
Vase tambin
border (propiedad TextField.border)
bottomScroll (propiedad TextField.bottomScroll)

public bottomScroll : Number [read-only]
Entero (ndice basado en uno) que indica la ltima lnea visible en el campo de texto. Considere el campo de texto como una ventana en un bloque de texto. La propiedad TextField.scroll es el ndice basado en uno de la primera lnea visible en la ventana. Todo el texto existente entre las lneas TextField.scroll y TextField.bottomScroll est visible actualmente en el campo de texto. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un campo de texto y lo llena de texto. Cree un botn con el nombre de instancia my_btn y, al hacer clic en l, las propiedades scroll y bottomScroll del campo de texto aparecern en el campo comment_txt.

this.createTextField("comment_txt", this.getNextHighestDepth(), 0, 0, 160, 120); comment_txt.html = true; comment_txt.selectable = true; comment_txt.multiline = true; comment_txt.wordWrap = true; comment_txt.htmlText = "What is hexadecimal? " + "The hexadecimal color system uses six digits to represent color values. " + "Each digit has sixteen possible values or characters. The characters range" + " from 0 to 9 and then A to F. Black is represented by (#000000) and white, " + "at the (pposite end of the color system, is (#FFFFFF)."; my_btn.onRelease = function() { trace("scroll: "+comment_txt.scroll); trace("bottomScroll: "+comment_txt.bottomScroll); };
condenseWhite (propiedad TextField.condenseWhite)

public condenseWhite : Boolean
Valor booleano que especifica si debe eliminarse el espacio en blanco adicional (espacios, saltos de lnea, etc.) de un campo de texto HTML cuando el campo se muestra en un navegador. El valor predeterminado es false. Si establece el valor true, deber utilizar comandos HTML estndar, como y , para incluir saltos de lnea en el campo de texto. Si el .html del campo de texto es false, esta propiedad no se tiene en cuenta. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea dos campos de texto, denominados first_txt y second_txt. El espacio en blanco se elimina del segundo campo de texto. Aada el siguiente cdigo ActionScript al archivo ActionScript o FLA:
var my_str:String = "Hello\tWorld\nHow are you?\t\t\tEnd"; this.createTextField("first_txt", this.getNextHighestDepth(), 10, 10, 160, 120); first_txt.html = true; first_txt.multiline = true; first_txt.wordWrap = true; first_txt.condenseWhite = false; first_txt.border = true; first_txt.htmlText = my_str; this.createTextField("second_txt", this.getNextHighestDepth(), 180, 10, 160, 120); second_txt.html = true; second_txt.multiline = true; second_txt.wordWrap = true; second_txt.condenseWhite = true; second_txt.border = true; second_txt.htmlText = my_str;
Vase tambin
html (propiedad TextField.html)

embedFonts (propiedad TextField.embedFonts)

public embedFonts : Boolean
Valor booleano que especifica si se representar el campo de texto empleando los contornos de fuentes incorporadas. Si el valor es true, Flash Lite representa el campo de texto utilizando contornos de fuente incorporados. Si el valor es false, Flash Lite representa el campo de texto utilizando fuentes de dispositivo. Si define embedFonts como true para un campo de texto, debe especificar una fuente para ese texto mediante la propiedad font de un objeto TextFormat aplicado al campo de texto. Si la fuente especificada no existe en la biblioteca (con el identificador de vinculacin correspondiente), el texto no se mostrar. Nota: la propiedad no admite fuentes para rabe, hebreo y tailands. Disponibilidad Flash Lite 2.0 Ejemplo En este ejemplo, debe crear un campo de texto dinmico denominado my_txt y utilizar el siguiente cdigo ActionScript para incorporar fuentes y girar el campo de texto. La cadena my font hace referencia a un smbolo de fuente de la biblioteca, con el nombre de identificador de vinculacin my font. El ejemplo asume que tiene un smbolo de fuente de la biblioteca llamado my font, con las propiedades de vinculacin siguientes: el identificador definido como my font, y las opciones Exportar para ActionScript y Exportar en primer fotograma seleccionadas.
var my_fmt:TextFormat = new TextFormat(); my_fmt.font = "my font"; this.createTextField("my_txt", this.getNextHighestDepth(), 10, 10, 160, 120); my_txt.wordWrap = true; my_txt.embedFonts = true; my_txt.text = "Hello world"; my_txt.setTextFormat(my_fmt); my_txt._rotation = 45;
getDepth (mtodo TextField.getDepth)

Devuelve la profundidad de un campo de texto. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Un entero. Ejemplo El ejemplo siguiente muestra campos de texto que residen a distintas profundidades. Cree un campo de texto dinmico en el escenario. Aada el siguiente cdigo ActionScript al archivo FLA o ActionScript, que crea dinmicamente dos campos de texto en tiempo de ejecucin y devuelve sus profundidades.

this.createTextField("first_mc", this.getNextHighestDepth(), 10, 10, 100, 22); this.createTextField("second_mc", this.getNextHighestDepth(), 10, 10, 100, 22); for (var prop in this) { if (this[prop] instanceof TextField) { var this_txt:TextField = this[prop]; trace(this_txt._name+" is a TextField at depth: "+this_txt.getDepth()); } }
getNewTextFormat (mtodo TextField.getNewTextFormat)

public getNewTextFormat() : TextFormat
Devuelve un objeto TextFormat que contiene una copia del objeto de formato de texto del campo de texto. El objeto de formato de texto es el formato que recibe el texto recin insertado, como, por ejemplo, el texto introducido por un usuario. Cuando se invoca getNewTextFormat(), el objeto TextFormat devuelto tiene todas sus propiedades definidas. Ninguna de las propiedades tiene el valor null. Disponibilidad Flash Lite 2.0 Valor devuelto TextFormat - Objeto TextFormat. Ejemplo El ejemplo siguiente muestra el objeto TextFormat del campo de texto especificado (my_txt).
this.createTextField("my_txt", this.getNextHighestDepth(), 10, 10, 160, 120); var my_fmt:TextFormat = my_txt.getNewTextFormat(); trace("TextFormat has the following properties:"); for (var prop in my_fmt) { trace(prop+": "+my_fmt[prop]); }
getTextFormat (mtodo TextField.getTextFormat)

public getTextFormat([beginIndex:Number], [endIndex:Number]) : TextFormat
Devuelve un objeto TextFormat para un carcter, rango de caracteres u objeto completo TextField.
Sintaxis 1:my_textField.getTextFormat()
Devuelve un objeto TextFormat que contiene informacin de formato para todo el texto de un campo de texto. En el objeto TextFormat resultante, slo se establecen las propiedades que son comunes a todo el texto del campo de texto. Todas las propiedades que sean mixtas, es decir, que tengan valores diferentes en distintos puntos del texto, tendrn el valor null.
Sintaxis 2:my_textField.getTextFormat(beginIndex:Number)
Devuelve un objeto TextFormat que contiene una copia del formato del texto del campo de texto en la posicin de beginIndex.
Sintaxis 3:my_(extField.getTextFormat(beginIndex:Number,endIndex:Number)

Devuelve un objeto TextFormat que contiene informacin de formato para el texto comprendido entre beginIndex y endIndex. En el objeto TextFormat resultante, slo se establecen las propiedades que son comunes a todo el texto del rango especificado. Todas las propiedades que sean mixtas (es decir, que tengan valores diferentes en distintos puntos del rango), estarn configuradas con el valor null. Disponibilidad Flash Lite 2.0 Parmetros beginIndex:Number [opcional] - Entero que especifica un carcter en una cadena. Si no especifica beginIndex y endIndex, el objeto TextFormat devuelto afecta al TextField completo. endIndex:Number [opcional] - Entero que especifica la posicin final de un fragmento de texto. Si especifica
beginIndex pero no especifica endIndex, TextFormat afecta al nico carcter que especifica beginIndex.
Valor devuelto TextFormat - Un objeto. Ejemplo El siguiente cdigo ActionScript lleva un control de toda la informacin de formato de un campo de texto creado en tiempo de ejecucin.
this.createTextField("dyn_txt", this.getNextHighestDepth(), 0, 0, 100, 200); dyn_txt.text = "Frank"; dyn_txt.setTextFormat(new TextFormat()); var my_fmt:TextFormat = dyn_txt.getTextFormat(); for (var prop in my_fmt) { trace(prop+": "+my_fmt[prop]); }
Vase tambin
getNewTextFormat (mtodo TextField.getNewTextFormat), setNewTextFormat (mtodo TextField.setNewTextFormat)setTextFormat (mtodo TextField.setTextFormat)
_height (propiedad TextField._height)

Altura del campo de texto, expresada en pxeles. Disponibilidad Flash Lite 2.0 Ejemplo El siguiente ejemplo de cdigo establece la altura y anchura de un campo de texto:
my_txt._width = 200; my_txt._height = 200;
_highquality (propiedad TextField._highquality)


Desfasada desde Flash Player 7. Esta propiedad est desfasada y en su lugar debe utilizarse TextField._quality. Especifica el nivel de suavizado que se aplica al archivo SWF actual. Especifique 2 (mejor calidad) para aplicar alta calidad con el suavizado de mapa de bits siempre activado. Especifique 1 (alta calidad) para aplicar e; suavizado; esto suaviza los mapas de bits si el archivo SWF no contiene animacin y es el valor predeterminado. Especifique 0 (baja calidad) para evitar el suavizado. Disponibilidad Flash Lite 2.0 Vase tambin
_quality (propiedad TextField._quality)
hscroll (propiedad TextField.hscroll)

public hscroll : Number
Indica la posicin de desplazamiento horizontal actual. Si la propiedad hscroll es 0, el texto no se desplazar horizontalmente. Las unidades de desplazamiento horizontal son pxeles, mientras que las de desplazamiento vertical son lneas. El desplazamiento horizontal se mide en pxeles porque la mayora de las fuentes que se utilizan normalmente tienen espaciado proporcional y, por lo tanto, los caracteres pueden tener anchuras diferentes. Flash realiza el desplazamiento vertical por lneas porque los usuarios normalmente desean ver una lnea de texto ntegramente y no slo parte de ella. Aunque en una lnea se utilicen varias fuentes, la altura de la lnea se ajusta a la de la fuente ms grande. Nota: la propiedad hscroll est basada en cero (a diferencia de la propiedad de desplazamiento vertical TextField.scroll, que est basada en uno). Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente desplaza el campo my_txt horizontalmente mediante dos botones llamados scrollLeft_btn y scrollRight_btn. El desplazamiento se muestra en un campo de texto denominado scroll_txt. Aada el siguiente cdigo ActionScript al archivo ActionScript o FLA:
this.createTextField("scroll_txt", this.getNextHighestDepth(), 10, 10, 160, 20); this.createTextField("my_txt", this.getNextHighestDepth(), 10, 30, 160, 22); my_txt.border = true; my_txt.multiline = false; my_txt.wordWrap = false; my_txt.text = "Lorem ipsum dolor sit amet, consectetuer adipiscing..."; scrollLeft_btn.onRelease = function() { my_txt.hscroll -= 10; scroll_txt.text = my_txt.hscroll+" of "+my_txt.maxhscroll; }; scrollRight_btn.onRelease = function() { my_txt.hscroll += 10; scroll_txt.text = my_txt.hscroll+" of "+my_txt.maxhscroll; };

Vase tambin
maxhscroll (propiedad TextField.maxhscroll), scroll (propiedad TextField.scroll)

public html : Boolean
Indicador que especifica si el campo de texto contiene una representacin HTML. Si el valor de la propiedad html es true, el campo de texto es un campo de texto HTML. Si el valor de html es false, el campo de texto no es HTML. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un campo de texto que establece la propiedad html como true. En el campo de texto aparece texto con formato HTML.
this.createTextField("my_txt", this.getNextHighestDepth(), 10, 10, 160, 22); my_txt.html = true; my_txt.htmlText = " this is bold text ";
Vase tambin
htmlText (propiedad TextField.htmlText)

public htmlText : String
Si el campo de texto es HTML, esta propiedad contiene la representacin HTML del contenido del campo de texto. Si el campo de texto no es un campo de texto HTML, se comportar de forma idntica a la propiedad text. Puede indicar que un campo de texto es un campo de texto HTML en el inspector de propiedades o estableciendo la propiedad html del campo de texto con el valor true. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un campo de texto que establece la propiedad html como true. En el campo de texto aparece texto con formato HTML.
this.createTextField("my_txt", this.getNextHighestDepth(), 10, 10, 160, 22); my_txt.html = true; my_txt.htmlText = "< this is bold text >";
Vase tambin
length (propiedad TextField.length)

public length : Number [read-only]

Indica el nmero de caracteres de un campo de texto. Esta propiedad devuelve el mismo valor que text.length, aunque es ms rpida. El carcter de tabulador (\t) cuenta como un carcter. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente devuelve el nmero de caracteres del campo de texto date_txt que muestra la fecha actual.
var today:Date = new Date(); this.createTextField("date_txt", this.getNextHighestDepth(), 10, 10, 100, 22); date_txt.autoSize = true; date_txt.text = today.toString(); trace(date_txt.length);
maxChars (propiedad TextField.maxChars)

public maxChars : Number
Indica el nmero mximo de caracteres que puede contener el campo de texto. Un guin puede insertar ms texto que maxChars; la propiedad maxChars slo indica cunto texto puede introducir el usuario. Si el valor de esta propiedad es null, no hay lmite en cuanto a la cantidad de texto que puede introducirse. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un campo de texto llamado age_txt que slo permite a los usuarios introducir un mximo de dos nmeros en el campo.
this.createTextField("age_txt", this.getNextHighestDepth(), 10, 10, 30, 22); age_txt.type = "input"; age_txt.border = true; age_txt.maxChars = 2;
maxhscroll (propiedad TextField.maxhscroll)

public maxhscroll : Number [read-only]
Valor mximo de TextField.hscroll. Disponibilidad Flash Lite 2.0 Ejemplo Consulte el ejemplo de TextField.hscroll.
maxscroll (propiedad TextField.maxscroll)

public maxscroll : Number [read-only]
Valor mximo de TextField.scroll.

Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente establece el valor mximo del campo de texto de desplazamiento my_txt. Cree dos botones, scrollUp_btn y scrollDown_btn, para desplazar el campo de texto. Aada el siguiente cdigo ActionScript al archivo ActionScript o FLA.
this.createTextField("scroll_txt", this.getNextHighestDepth(), 10, 10, 160, 20); this.createTextField("my_txt", this.getNextHighestDepth(), 10, 30, 320, 240); my_txt.multiline = true; my_txt.wordWrap = true; for (var i = 0; i<10; i++) { my_txt.text += "Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh " + "euismod tincidunt ut laoreet dolore magna aliquam erat volutpat."; } scrollUp_btn.onRelease = function() { my_txt.scroll--; scroll_txt.text = my_txt.scroll+" of "+my_txt.maxscroll; }; scrollDown_btn.onRelease = function() { my_txt.scroll++; scroll_txt.text = my_txt.scroll+" of "+my_txt.maxscroll; };
multiline (propiedad TextField.multiline)

public multiline : Boolean
Indica si el campo de texto consta de varias lneas. Si el valor es true, el campo de texto consta de varias lneas; si el valor es false, se trata de un campo de texto de una sola lnea. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un campo de texto multilnea llamado myText.
this.createTextField("myText", this.getNextHighestDepth(), 10, 30, 110, 100); myText.text = "Flash is an authoring tool that designers and developers use to create presentations, applications, and other content that enables user interaction."; myText.border = true; myText.wordWrap = true; myText.multiline = true;
_name (propiedad TextField._name)

Nombre de instancia del campo de texto.

Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente muestra campos de texto que residen a distintas profundidades. Cree un campo de texto dinmico en el escenario. Aada el siguiente cdigo ActionScript al archivo FLA o ActionScript, que crea dinmicamente dos campos de texto en tiempo de ejecucin y muestra sus profundidades en el panel Salida.
this.createTextField("first_mc", this.getNextHighestDepth(), 10, 10, 100, 22); this.createTextField("second_mc", this.getNextHighestDepth(), 10, 10, 100, 22); for (var prop in this) { if (this[prop] instanceof TextField) { var this_txt:TextField = this[prop]; trace(this_txt._name+" is a TextField at depth: "+this_txt.getDepth()); } }
Al probar el documento, el nombre de instancia y la profundidad se muestran en el panel Salida. Al probar el documento, el nombre de instancia y la profundidad se escriben en el archivo de registro.
onChanged (controlador TextField.onChanged)

onChanged = function(changedField:TextField) {}
Se invoca cuando cambia el contenido de un campo de texto. De manera predeterminada, tiene el valor undefined (no definido). Se puede definir en un guin. Una referencia a la instancia de campo de texto se pasa como parmetro al controlador onChanged. Se pueden capturar estos datos colocando un parmetro en el mtodo del controlador de eventos. Por ejemplo, el siguiente cdigo utiliza textfield_txt como parmetro que se pasa al controlador de eventos onChanged. El parmetro se utiliza posteriormente en una sentencia trace() para enviar el nombre de instancia del campo de texto al panel Salida:
this.createTextField("myInputText_txt", 99, 10, 10, 300, 20); myInputText_txt.border = true; myInputText_txt.type = "input"; myInputText_txt.onChanged = function(textfield_txt:TextField) { trace("the value of "+textfield_txt._name+" was changed. New value is: "+textfield_txt.text); };
El controlador onChanged slo se activa cuando el cambio se debe a la interaccin del usuario; por ejemplo, cuando el usuario est escribiendo algo en el teclado, cambiando algo en el campo de texto con el ratn o seleccionando un elemento de un men. Los cambios programticos en el campo de texto no activan el evento onChanged, ya que el cdigo reconoce los cambios realizados en el campo de texto. Disponibilidad Flash Lite 2.0 Parmetros changedField:TextField - Campo que activa el evento. Vase tambin
getNewTextFormat (mtodo TextField.getNewTextFormat), setNewTextFormat (mtodo TextField.setNewTextFormat)

onKillFocus (controlador TextField.onKillFocus)

Se invoca cuando un campo de texto deja de estar seleccionado con el teclado. El mtodo onKillFocus recibe un parmetro, newFocus, que es un objeto que representa al nuevo objeto seleccionado. Si no hay ningn objeto seleccionado con el teclado, newFocus contendr el valor null (nulo). Disponibilidad Flash Lite 2.0 Parmetros newFocus:Object - El objeto que recibe la seleccin. Ejemplo El ejemplo siguiente crea dos campos de texto, denominados first_txt y second_txt. Cuando se selecciona un campo de texto, aparece en el panel Salida la informacin acerca del campo de texto seleccionado y el que ya no est seleccionado.
this.createTextField("first_txt", 1, 10, 10, 300, 20); first_txt.border = true; first_txt.type = "input"; this.createTextField("second_txt", 2, 10, 40, 300, 20); second_txt.border = true; second_txt.type = "input"; first_txt.onKillFocus = function(newFocus:Object) { trace(this._name+" lost focus. New focus changed to: "+newFocus._name); }; first_txt.onSetFocus = function(oldFocus:Object) { trace(this._name+" gained focus. Old focus changed from: "+oldFocus._name); }
Vase tambin
onSetFocus (controlador TextField.onSetFocus)
onScroller (controlador TextField.onScroller)

onScroller = function(scrolledField:TextField) {}
Se invoca cuando cambia una de las propiedades de desplazamiento de un campo de texto. Una referencia a la instancia de campo de texto se pasa como parmetro al controlador onScroller. Se pueden capturar estos datos colocando un parmetro en el mtodo del controlador de eventos. Por ejemplo, el siguiente cdigo utiliza my_txt como parmetro que se pasa al controlador de eventos onScroller. El parmetro se utiliza posteriormente en una sentencia trace() para enviar el nombre de instancia del campo de texto al panel Salida.
myTextField.onScroller = function (my_txt:TextField) { trace (my_txt._name + " scrolled"); };

El controlador de eventos TextField.onScroller se utiliza normalmente para implementar barras de desplazamiento. Las barras de desplazamiento suelen tener un control deslizante u otro indicador que muestra la posicin actual de desplazamiento horizontal o vertical en un campo de texto. Es posible navegar por los campos de texto utilizando el ratn y el teclado, lo que provoca que cambie la posicin de desplazamiento. Es preciso notificar al cdigo de la barra de desplazamiento si la posicin de desplazamiento cambia como resultado de dicha interaccin del usuario; para lo cual se utiliza TextField.onScroller. La llamada a onScroller tiene lugar tanto si la posicin de desplazamiento cambia como resultado de la interaccin del usuario como si lo hace por cambios programticos. El controlador onChanged slo se activa si el cambio se debe a la interaccin del usuario. Las dos opciones son necesarias, ya que es frecuente que un fragmento de cdigo cambie la posicin de desplazamiento y el cdigo de la barra de desplazamiento no est relacionado y desconozca que la posicin de desplazamiento ha cambiado porque no se le ha notificado. Disponibilidad Flash Lite 2.0 Parmetros scrolledField:TextField - Referencia al objeto TextField cuya posicin de desplazamiento ha cambiado. Ejemplo El ejemplo siguiente crea un campo de texto con el nombre my_txt y utiliza dos botones llamados scrollUp_btn y scrollDown_btn para desplazar el contenido del campo de texto. Cuando se llama al controlador de eventos onScroller, se emplea una sentencia trace para mostrar informacin en el panel Salida. Cree dos botones con los nombres de instancia scrollUp_btn y scrollDown_btn, y aada el siguiente cdigo ActionScript al archivo FLA o ActionScript:
this.createTextField("scroll_txt", this.getNextHighestDepth(), 10, 10, 160, 20); this.createTextField("my_txt", this.getNextHighestDepth(), 10, 30, 320, 240); my_txt.multiline = true; my_txt.wordWrap = true; for (var i = 0; i<10; i++) { my_txt.text += "Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam " + "nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat."; } scrollUp_btn.onRelease = function() { my_txt.scroll--; }; scrollDown_btn.onRelease = function() { my_txt.scroll++; }; my_txt.onScroller = function() { trace("onScroller called"); scroll_txt.text = my_txt.scroll+" of "+my_txt.maxscroll; };
Vase tambin
hscroll (propiedad TextField.hscroll), maxhscroll (propiedad TextField.maxhscroll), maxscroll (propiedad TextField.maxscroll)scroll (propiedad TextField.scroll)

onSetFocus (controlador TextField.onSetFocus)

Se invoca cuando un campo de texto se selecciona con el teclado. El parmetro oldFocus es el objeto que deja de estar seleccionado. Por ejemplo, si el usuario presiona la tecla Tabulador para desplazar la seleccin del teclado de un botn a un campo de texto, oldFocus contendr la instancia del botn. Si anteriormente no haba ningn objeto seleccionado con el teclado, oldFocus contendr un valor null (nulo). Disponibilidad Flash Lite 2.0 Parmetros oldFocus:Object - El objeto que deja de estar seleccionado. Ejemplo Consulte el ejemplo de TextField.onKillFocus. Vase tambin
onKillFocus (controlador TextField.onKillFocus)
_parent (propiedad TextField._parent)

Referencia al clip de pelcula u objeto que contiene el campo de texto u objeto actual. El objeto actual es el que contiene el cdigo ActionScript que hace referencia a _parent. Utilice _parent para especificar una ruta de acceso relativa a los clips de pelcula u objetos que se encuentran por encima del campo de texto actual. Puede utilizar _parent para subir mltiples niveles en la lista de visualizacin, como se muestra a continuacin:
_parent._parent._alpha = 20;
Disponibilidad Flash Lite 2.0 Ejemplo El siguiente cdigo ActionScript crea dos campos de texto y devuelve informacin acerca del _parent de cada objeto. El primer campo de texto, first_txt, se crea en la lnea de tiempo principal. El segundo, second_txt, se crea dentro del clip de pelcula holder_mc.
this.createTextField("first_txt", this.getNextHighestDepth(), 10, 10, 160, 22); first_txt.border = true; trace(first_txt._name+"'s _parent is: "+first_txt._parent); this.createEmptyMovieClip("holder_mc", this.getNextHighestDepth()); holder_mc.createTextField("second_txt", holder_mc.getNextHighestDepth(), 10, 40, 160, 22); holder_mc.second_txt.border = true; trace(holder_mc.second_txt._name+"'s _parent is: "+holder_mc.second_txt._parent);
El panel Salida muestra la siguiente informacin:

first_txt'( _parent is: _level0 second_txt's _parent is: _level0.holder_mc
Vase tambin
_parent (propiedad Button._parent), _parent (propiedad MovieClip._parent), _root, propiedad
password (propiedad TextField.password)

public password : Boolean
Especifica si el campo de texto es un campo de texto de contrasea. Si el valor de la contrasea es true, el campo de texto es de contrasea: cuando el usuario ha terminado de escribir la contrasea y hace clic en Aceptar, el campo de texto oculta los caracteres introducidos y los sustituye por asteriscos. Si su valor es false, el campo de texto no es de contrasea. Cuando est activado el modo de contrasea, los comandos Cortar y Copiar y sus correspondientes atajos de teclado no funcionan. Este mecanismo de seguridad impide que un usuario sin escrpulos pueda utilizar los mtodos abreviados para descubrir una contrasea en un equipo en el que no haya nadie presente. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea dos campos de texto: username_txt y password_txt. Se introduce texto en los dos campos de texto; sin embargo, password_txt tiene la propiedad password definida como true. Cuando el usuario hace clic en Aceptar para finalizar la introduccin de la contrasea, los caracteres se muestran como asteriscos y no como caracteres en el campo password_txt.
this.createTextField("username_txt", this.getNextHighestDepth(), 10, 10, 100, 22); username_txt.border = true; username_txt.type = "input"; username_txt.maxChars = 16; username_txt.text = "hello"; this.createTextField("password_txt", this.getNextHighestDepth(), 10, 40, 100, 22); password_txt.border = true; password_txt.type = "input"; password_txt.maxChars = 16; password_tx(.password = true; password_txt.text = "world";
_quality (propiedad TextField._quality)

Propiedad (global); establece o recupera la calidad de representacin utilizada por un archivo SWF. Las fuentes de dispositivo siempre se muestran dentadas y, por consiguiente, no se ven afectadas por la propiedad _quality. Nota: aunque puede especificar esta propiedad para un objeto TextField, se trata en realidad de una propiedad global, por lo que puede especificar su valor simplemente como _quality. Para ms informacin, consulte la propiedad _quality. La propiedad _quality puede configurarse con los siguientes valores:
"LOW" Calidad de representacin baja. No se suavizan ni los grficos ni los mapas de bits.

"MEDIUM" Calidad de representacin media. Los grficos se suavizan empleando una cuadrcula de 2 x 2 pxeles,
pero los mapas de bits no se suavizan. La calidad resulta adecuada para pelculas que no contengan texto.
"HIGH" Calidad de representacin alta. Los grficos se suavizan empleando una cuadrcula de 4 x 4 pxeles, mientras
que los mapas de bits se suavizan si la pelcula es esttica. Esta es la calidad de representacin predeterminada de Flash.
"BEST" Calidad de representacin muy alta. Los grficos se suavizan empleando una cuadrcula de 4 x 4 pxeles y
los mapas de bits se suavizan siempre. Nota: la propiedad no admite fuentes para rabe, hebreo y tailands. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente establece la calidad de representacin como LOW:
my_txt._quality = "LOW";
Vase tambin
_quality, propiedad
removeListener (mtodo TextField.removeListener)

public removeListener(listener:Object) : Boolean
Elimina un objeto detector anteriormente registrado en una instancia de campo de texto con TextField.addListener(). Disponibilidad Flash Lite 2.0 Parmetros listener:Object - Objeto que dejar de recibir notificaciones de TextField.onChanged o TextField.onScroller. Valor devuelto Boolean - Si el listener se ha eliminado correctamente, el mtodo devolver un valor true. Si el listener no se ha eliminado correctamente (por ejemplo, porque listener no se encontraba en la lista de detectores del objeto TextField), el mtodo devolver el valor false. Ejemplo El ejemplo siguiente crea un campo de introduccin de texto llamado my_txt. Cuando el usuario escribe en el campo, aparece informacin sobre el nmero de caracteres del campo de texto en el panel Salida. Cuando el usuario escribe en el campo, la informacin sobre el nmero de caracteres del campo de texto se escribe en el archivo de registro. Si el usuario hace clic en la instancia removeListener_btn, se elimina el detector y deja de mostrarse la informacin. Si el usuario hace clic en la instancia removeListener_btn, se elimina el detector y deja de escribirse en el archivo de registro.

this.createTextField("my_txt", this.getNextHighestDepth(), 10, 10, 160, 20); my_txt.border = true; my_txt.type = "input"; var txtListener:Object = new Object(); txtListener.onChanged = function(textfield_txt:TextField) { trace(textfield_txt+" changed. Current length is: "+textfield_txt.length); }; my_txt.addListener(txtListener); removeListener_btn.onRelease = function() { trace("Removing listener..."); if (!my_txt.removeListener(txtListener)) { trace("Error! Unable to remove listener"); } };
removeTextField (mtodo TextField.removeTextField)

public removeTextField() : Void
Elimina el campo de texto. Esta operacin slo puede realizarse en un campo de texto creado con MovieClip.createTextField(). Al llamar a este mtodo, se elimina el campo de texto. Este mtodo es similar a MovieClip.removeMovieClip(). Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un campo de texto que puede eliminarse del escenario al hacer clic en la instancia remove_btn. Cree un botn y llmelo remove_btn y, a continuacin, aada el siguiente cdigo ActionScript al archivo FLA o ActionScript.
this.createTextField("my_txt", this.getNextHighestDepth(), 10, 10, 300, 22); my_txt.text = new Date().toString(); my_txt.border = true; remove_btn.onRelease = function() { my_txt.removeTextField(); };
replaceSel (mtodo TextField.replaceSel)

public replaceSel(newText:String) : Void
Reemplaza la seleccin actual por el contenido del parmetro newText. El texto se inserta en la posicin de la seleccin actual empleando el formato de carcter predeterminado y el formato de prrafo predeterminado actuales. El texto no se trata como HTML aunque se trate de un campo de texto HTML. Puede utilizar el mtodo replaceSel() para insertar y eliminar texto sin modificar el formato de carcter y de prrafo del resto del texto. Nota: debe utilizar el mtodo Selection.setFocus() para seleccionar el campo antes de llamar al mtodo
replaceSel().

Disponibilidad Flash Lite 2.0 Parmetros newText:String - Una cadena. Ejemplo El ejemplo siguiente crea en el escenario un campo de texto de varias lneas con texto. Cuando selecciona texto y hace clic con el botn derecho del ratn o con la tecla Control presionada, puede seleccionar Enter current date en el men contextual. Esta opcin llama a una funcin que reemplaza el texto seleccionado por la fecha actual.
this.createTextField("my_txt", this.getNextHighestDepth(), 10, 10, 320, 240); my_txt.border = true; my_txt.wordWrap = true; my_txt.multiline = true; my_txt.type = "input"; my_txt.text = "Select some sample text from the text field and then right-click/control click " + "and select 'Enter current date' from the context menu to replace the " + "currently selected text with the current date."; var my_cm:ContextMenu = new ContextMenu(); my_cm.customItems.push(new ContextMenuItem("Enter current date", enterDate)); function enterDate(obj:Object, menuItem:ContextMenuItem) { var today_str:String = new Date().toString(); var date_str:String = today_str.split(" ", 3).join(" "); my_txt.replaceSel(date_str); } my_txt.menu = my_cm;
Vase tambin
replaceText (mtodo TextField.replaceText)

public replaceText(beginIndex:Number, endIndex:Number, newText:String) : Void
Reemplaza el rango de caracteres especificado por los parmetros beginIndex y endIndex del campo de texto indicado por el contenido del parmetro newText. Disponibilidad Flash Lite 2.0 Parmetros beginIndex:Number - El valor de ndice inicial para el rango de sustitucin. endIndex:Number - El valor de ndice final para el rango de sustitucin. newText:String - El texto que va a reemplazar al rango de caracteres especificado.

Ejemplo El ejemplo siguiente crea un campo de texto my_txt y le asigna una cadena de texto dog@house.net. Se utiliza el mtodo indexOf() para encontrar la primera vez que aparece el smbolo especificado (@). Si se encuentra el smbolo, el texto especificado (entre el ndice de 0 y el smbolo) se reemplaza con la cadena bird. Si no se encuentra el smbolo, se muestra un mensaje de error en el panel Salida. Si no se encuentra el smbolo, se escribe un mensaje de error en el archivo de registro.
this.createTextField("my_txt", this.getNextHighestDepth(), 10, 10, 320, 22); my_txt.autoSize = true; my_txt.text = "dog@house.net"; var symbol:String = "@"; var symbolPos:Number = my_txt.text.indexOf(symbol); if (symbolPos>-1) { my_txt.replaceText(0, symbolPos, "bird"); } else { trace("symbol '"+symbol+"' not found."); }
_rotation (propiedad TextField._rotation)

Giro del campo de texto, expresado en grados, con respecto a su orientacin original. Los valores comprendidos entre 0 y 180 representan un giro en el sentido de las agujas del reloj, mientras que los comprendidos entre 0 y -180 representan un giro en sentido contrario al de las agujas del reloj. Los valores situados fuera de este rango se suman o restan de 360 para obtener un valor que s est comprendido en el rango. Por ejemplo, la sentencia my_txt._rotation = 450 es igual que my_txt._rotation = 90. Los valores de giro no se admiten para los campos de texto que utilizan fuentes de dispositivo. Debe utilizar fuentes incorporadas para utilizar _rotation con un campo de texto. Nota: la propiedad no admite fuentes para rabe, hebreo y tailands. Disponibilidad Flash Lite 2.0 Ejemplo En este ejemplo, debe crear un campo de texto dinmico denominado my_txt y utilizar el siguiente cdigo ActionScript para incorporar fuentes y girar el campo de texto. La cadena my font hace referencia a un smbolo de fuente de la biblioteca, con un identificador de vinculacin my font.
var my_fmt:TextFormat = new TextFormat(); my_fmt.font = "my font"; this.createTextField("my_txt", this.getNextHighestDepth(), 10, 10, 160, 120); my_txt.wordWrap = true; my_txt.embedFonts = true; my_txt.text = "Hello world"; my_txt.setTextFormat(my_fmt); my_txt._rotation = 45;
Aplique ms formato al campo de texto utilizando la clase TextFormat class.

Vase tambin
_rotation (propiedad Button._rotation), _rotation (propiedad MovieClip._rotation), getNewTextFormat (mtodo TextField.getNewTextFormat)
scroll (propiedad TextField.scroll)

public scroll : Number
Define la posicin vertical del texto de un campo de texto. La propiedad scroll es til para dirigir a los usuarios a un prrafo especfico en un pasaje largo, o para crear campos de texto con desplazamiento. Esta propiedad puede recuperarse y modificarse. Las unidades de desplazamiento horizontal son pxeles, mientras que las de desplazamiento vertical son lneas. El desplazamiento horizontal se mide en pxeles porque la mayora de las fuentes que utiliza normalmente tienen espaciado proporcional, lo que significa que los caracteres pueden tener anchuras diferentes. Flash realiza el desplazamiento vertical por lneas porque los usuarios normalmente desean ver una lnea de texto ntegramente y no slo parte de ella. Aunque en una lnea se utilicen varias fuentes, la altura de la lnea se ajusta a la de la fuente ms grande. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente establece el valor mximo del campo de texto de desplazamiento my_txt. Cree dos botones, scrollUp_btn y scrollDown_btn, para desplazar el campo de texto. Aada el siguiente cdigo ActionScript al archivo ActionScript o FLA.
this.createTextField("scroll_txt", this.getNextHighestDepth(), 10, 10, 160, 20); this.createTextField("my_txt", this.getNextHighestDepth(), 10, 30, 320, 240); my_txt.multiline = true; my_txt.wordWrap = true; for (var i = 0; i<10; i++) { my_txt.text += "Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy " + "nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat."; } scrollUp_btn.onRelease = function() { my_txt.scroll--; scroll_txt.text = my_txt.scroll+" of "+my_txt.maxscroll; }; scrollDown_btn.onRelease = function() { my_txt.scroll++; scroll_txt.text = my_txt.scroll+" of "+my_txt.maxscroll; };
Vase tambin
hscroll (propiedad TextField.hscroll), maxscroll (propiedad TextField.maxscroll)
selectable (propiedad TextField.selectable)

public selectable : Boolean

Valor booleano que indica si el campo de texto puede seleccionarse. Si el valor es true, el texto puede seleccionarse. La propiedad selectable controla si un campo de texto se puede seleccionar y no si un campo de texto es editable. Un campo dinmico puede seleccionarse aunque no sea editable. Si un campo de texto dinmico no es seleccionable, no se puede seleccionar su texto. Si selectable se establece con el valor false, el texto del campo de texto no responder a los comandos de seleccin del ratn o el teclado y el texto no se podr copiar utilizando el comando Copiar. Si selectable se establece con el valor true, el texto del campo de texto podr seleccionarse utilizando el ratn o el teclado. Puede seleccionar texto de esta forma aunque el campo de texto sea un campo dinmico en lugar de un campo de entrada de texto. Tambin puede copiar el texto utilizando el comando Copiar. Nota: la propiedad no admite fuentes para rabe, hebreo y tailands. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un campo de texto seleccionable que se actualiza constantemente con la fecha y la hora actual.
this.createTextField("date_txt", this.getNextHighestDepth(), 10, 10, 100, 22); date_txt.autoSize = true; date_txt.selectable = true; ( var date_interval:Number = setInterval(updateTime, 500, date_txt); function updateTime(my_txt:TextField) { my_txt.text = new Date().toString(); }
setNewTextFormat (mtodo TextField.setNewTextFormat)

public setNewTextFormat(tf:TextFormat) : Void
Establece el formato de texto nuevo predeterminado de un campo de texto. El nuevo formato de texto predeterminado es el formato que recibe el texto insertado, como, por ejemplo, el texto introducido por un usuario. Cuando se inserta texto, se asigna el formato predeterminado de nuevo texto al nuevo texto insertado. El formato de texto predeterminado se especifica mediante textFormat, que es un objeto TextFormat. Disponibilidad Flash Lite 2.0 Parmetros tf:TextFormat - Objeto TextFormat. Ejemplo En el ejemplo siguiente, se crea un nuevo campo de texto (denominado my_txt) en tiempo de ejecucin y se definen varias propiedades. Se aplica el formato del texto recin insertado.

var my_fmt:TextForma( = new TextFormat(); my_fmt.bold = true; my_fmt.font = "Arial"; my_fmt.color = 0xFF9900; this.createTextField("my_txt", 999, 0, 0, 400, 300); my_txt.wordWrap = true; my_txt.multiline = true; my_txt.border = true; my_txt.type = "input"; my_txt.setNewTextFormat(my_fmt); my_txt.text = "Oranges are a good source of vitamin C";
Vase tambin
getNewTextFormat (mtodo TextField.getNewTextFormat), getTextFormat (mtodo TextField.getTextFormat)setTextFormat (mtodo TextField.setTextFormat)
setTextFormat (mtodo TextField.setTextFormat)

public setTextFormat([beginIndex:Number], [endIndex:Number], textFormat:TextFormat) : Void
Aplica el formato de texto especificado por el parmetro textFormat a una parte o a todo el texto de un campo de texto. textFormat debe ser un objeto TextFormat que especifique los cambios de formato de texto deseados. Slo se aplican al campo de texto las propiedades de textFormat que no tengan valor null. No se aplicar ninguna propiedad de textFormat configurada con el valor null. De manera predeterminada, todas las propiedades del objeto TextFormat de nueva creacin estn configuradas con el valor null. Existen dos tipos de informacin de formato en un objeto TextFormat: formato de nivel de carcter y de nivel de prrafo. Cada carcter de un campo de texto puede tener su propia configuracin de formato de carcter, como nombre de fuente, tamao de fuente, negrita y cursiva. En el caso de los prrafos, se examina el primer carcter del prrafo para identificar la configuracin de formato de prrafo para el prrafo completo. Margen izquierdo, margen derecho y sangra son ejemplos de configuracin de formato de prrafo. El mtodo setTextFormat() cambia el formato de texto aplicado a un carcter individual, a un rango de caracteres o a todo el cuerpo del texto de un campo de texto.
Sintaxis 1:my_textField.setTextFormat(textFormat:TextFormat)
Aplica las propiedades de textFormat a todo el texto del campo de texto.
Sintaxis 2:my_textField.setTextFormat(beginIndex:Number,
textFormat:TextFormat)
Aplica las propiedades de textFormat al carcter situado en la posicin beginIndex.
Sintaxis 3:my_textField.setTextFormat(beginIndex:Number,
textFormat:TextFormat)
endIndex:Number,
Aplica al fragmento de texto las propiedades del parmetro textFormat desde la posicin beginIndex hasta la posicin endIndex. Tenga en cuenta que el texto insertado manualmente por el usuario recibe el formato predeterminado de campo de texto para texto nuevo, no el formato especificado para el punto de insercin del texto. Para definir el formato de texto predeterminado de un campo de texto, utilice TextField.setNewTextFormat().

Disponibilidad Flash Lite 2.0 Parmetros beginIndex:Number [opcional] - Entero que especifica el primer carcter de un fragmento de texto. Si no especifica beginIndex y endIndex, el objeto TextFormat devuelto se aplica al TextField completo. endIndex:Number [opcional] - Entero que especifica el primer carcter despus de un fragmento de texto. Si especifica beginIndex pero no especifica endIndex, TextFormat se aplica al nico carcter que especifica beginIndex. textFormat:TextFormat - Objeto TextFormat que contiene informacin de formato de carcter y de prrafo. Ejemplo El ejemplo siguiente define el formato de texto de dos cadenas de texto diferentes. Se llama al mtodo setTextFormat() y se aplica al campo de texto my_txt.
var format1_fmt:TextFormat = new TextFormat(); format1_fmt.font = "Arial"; var format2_fmt:TextFormat = new TextFormat(); format2_fmt.font = "Courier"; var string1:String = "Sample string number one."+newline; var string2:String = "Sample string number two."+newline; this.createTextField("my_txt", this.getNextHighestDepth(), 0, 0, 300, 200); my_txt.multiline = true; my_txt.wordWrap = true; my_txt.text = string1; var firstIndex:Number = my_txt.length; my_txt.text += string2; var secondIndex:Number = my_txt.length; my_txt.setTextFormat(0, firstIndex, format1_fmt); my_txt.setTextFormat(firstIndex, secondIndex, format2_fmt);
Vase tambin
getNewTextFormat (mtodo TextField.getNewTextFormat), setNewTextFormat (mtodo TextField.setNewTextFormat)
_soundbuftime (propiedad TextField._soundbuftime)

Especifica el nmero de segundos que un sonido debe almacenarse en el bfer antes de que comience a reproducirse sin interrupcin. Nota: aunque puede especificar esta propiedad para un objeto TextField, se trata en realidad de una propiedad global que se aplica a todos los sonidos cargados, por lo que puede especificar su valor simplemente como _soundbuftime.. Al establecer esta propiedad para un objeto TextField, en realidad se define la propiedad global. Para ms informacin y ver un ejemplo, consulte_soundbuftime. Disponibilidad Flash Lite 2.0

Vase tambin
tabEnabled (propiedad TextField.tabEnabled)

Especifica si el campo de texto se incluye en el orden de tabulacin automtico. De manera predeterminada, tiene el valor undefined. Si la propiedad tabEnabled es undefined o true, el objeto se incluir en el orden de tabulacin automtico. Si la propiedad tabIndex tambin est configurada con un valor, el objeto se incluir tambin en el orden de tabulacin personalizado. Si tabEnabled tiene el valor false, el objeto no se incluir en el orden de tabulacin automtico ni en el personalizado aunque se establezca la propiedad tabIndex. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea varios campos de texto, denominados one_txt, two_txt, three_txt y four_txt. El campo three_txt tiene la propiedad tabEnabled definida como false, por lo que se excluye del orden de tabulacin automtico.
this.createTextField("one_txt", this.getNextHighestDepth(), 10, 10, 100, 22); one_txt.border = true; one_txt.type = "input"; this.createTextField("two_txt", this.getNextHighestDepth(), 10, 40, 100, 22); two_txt.border = true; two_txt.type = "input"; this.createTextField("three_txt", this.getNextHighestDepth(), 10, 70, 100, 22); three_txt.border = true; three_txt.type = "input"; this.createTextField("four_txt", this.getNextHighestDepth(), 10, 100, 100, 22); four_txt.border = true; four_txt.type = "input"; three_txt.tabEnabled = false; three_txt.text = "tabEnabled = false;";
Vase tambin
tabEnabled (propiedad Button.tabEnabled), tabEnabled (propiedad MovieClip.tabEnabled)
tabIndex (propiedad TextField.tabIndex)

Permite personalizar el orden de tabulacin de los objetos de un archivo SWF. Puede establecer la propiedad tabIndex de un botn, un clip de pelcula o una instancia de campo de texto; la configuracin predeterminada es undefined (no definido). Si algn objeto mostrado actualmente en el archivo SWF contiene una propiedad tabIndex, se desactivar el orden de tabulacin automtico y el orden de tabulacin se calcular a partir de las propiedades tabIndex de los objetos del archivo SWF. El orden de tabulacin personalizado slo incluye objetos que tienen propiedades tabIndex.

La propiedad tabIndex debe ser un entero positivo. Los objetos se ordenan conforme a lo que indiquen las propiedades tabIndex y en orden ascendente. Un objeto que tenga el valor 1 para tabIndex preceder a otro objeto que tenga el valor 2 para tabIndex. Si dos objetos tienen el mismo valor de tabIndex, su clasificacin en el orden de tabulacin no estar definida (undefined). El orden de tabulacin personalizado definido por la propiedad tabIndex es flat (plano o no jerrquico). Esto significa que no se tienen en cuenta las relaciones jerrquicas entre los objetos del archivo SWF. Todos los objetos del archivo SWF con propiedades tabIndex tendrn su lugar en el orden de tabulacin, que se determinar por el orden de los valores de tabIndex. Si dos objetos tienen el mismo valor de tabIndex, el que va en primer lugar no estar definido ( undefined). No debe utilizar el mismo valor de tabIndex para varios objetos. Disponibilidad Flash Lite 2.0 Ejemplo El siguiente cdigo ActionScript crea de forma dinmica cuatro campos de texto y les asigna un orden de tabulacin personalizado. Aada el siguiente cdigo ActionScript al archivo ActionScript o FLA:
this.createTextField("one_txt", this.getNextHighestDepth(), 10, 10, 100, 22); one_txt.border = true; one_txt.type = "input"; this.createTextField("two_txt", this.getNextHighestDepth(), 10, 40, 100, 22); two_txt.border = true; two_txt.type = "input"; this.createTextField("three_txt", this.getNextHighestDepth(), 10, 70, 100, 22); three_txt.border = true; three_txt.type = "input"; this.createTextField("four_txt", this.getNextHighestDepth(), 10, 100, 100, 22); four_txt.border = true; four_txt.type = "input"; one_txt.tabIndex = 3; two_txt.tabIndex = 1; three_txt.tabIndex = 2; four_txt.tabIndex = 4;
Vase tambin
tabIndex (propiedad Button.tabIndex), tabIndex (propiedad MovieClip.tabIndex)
_target (propiedad TextField._target)

Ruta de destino de la instancia del campo de texto. El destino _self especifica el marco actual de la ventana actual, _blank especifica una ventana nueva, _parent especifica el nivel superior del marco actual y _top especifica el marco del nivel ms alto de la ventana actual. Disponibilidad Flash Lite 2.0 Ejemplo El siguiente cdigo ActionScript crea un campo de texto denominado my_txt y devuelve la ruta de destino del nuevo campo, en notacin con barras y con punto.

this.createTextField("my_txt", this.getNextHighestDepth(), 10, 10, 100, 22); trace(my_txt._target); // output: /my_txt trace(eval(my_txt._target)); // output: _level0.my_txt
text (propiedad TextField.text)

public text : String
Indica el texto actual del campo de texto. Las lneas se separan mediante el carcter de retorno de carro ("\r", ASCII 13). Esta propiedad contiene el texto normal sin formato del campo de texto, sin etiquetas HTML, aunque el campo de texto sea HTML. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un campo de texto HTML llamado my_txt y le asigna una cadena de texto con formato HTML. Al trazar la propiedad htmlText, el panel Salida muestra la cadena en formato HTML. Al trazar el valor de la propiedad text, la cadena sin formato con etiquetas HTML se muestra en el panel Salida. Al trazar el valor de la propiedad text, la cadena sin formato con etiquetas HTML se escribe en el archivo de registro.
this.createTextField("my_txt", this.getNextHighestDepth(), 10, 10, 400, 22); my_txt.html = true; my_txt.htmlText = "Remember to always update the help panel."; trace("htmlText: "+my_txt.htmlText); trace("text: "+my_txt.text); // output: htmlText: Remember to always update your help panel. text: Remember to always update your help panel.
Vase tambin
textColor (propiedad TextField.textColor)

public textColor : Number
Indica el color del texto de un campo de texto. El sistema de colores hexadecimal utiliza seis dgitos para representar los valores de color. Cada dgito tiene diecisis valores o caracteres posibles. El rango de caracteres de 0 a 9 y, seguidamente, de A a F. Negro se representa mediante (#000000) y blanco, situado en el extremo opuesto del sistema de colores, mediante (#FFFFFF). Disponibilidad Flash Lite 2.0 Ejemplo El siguiente cdigo ActionScript crea un campo de texto y cambia su propiedad color a rojo.

this.createTextField("my_txt", 99, 10, 10, 100, 300); my_txt.text = "this will be red text"; my_txt.textColor = 0xFF0000;
textHeight (propiedad TextField.textHeight)

public textHeight : Number
Indica la altura del texto. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un campo de texto y le asigna una cadena de texto. Se utiliza una sentencia trace para mostrar la altura y la anchura del texto en el panel Salida. El mtodo trace() se utiliza para escribir la altura y la anchura del texto en el archivo de registro. Despus, se utiliza la propiedad autoSize para cambiar el tamao del campo de texto y la nueva altura y anchura tambin se muestran en el panel Salida. Despus, se utiliza la propiedad autoSize para cambiar el tamao del campo de texto y la nueva altura y anchura tambin se escriben en el archivo de registro.
this.createTextField("my_txt", 99, 10, 10, 100, 300); my_txt.text = "Sample text"; trace("textHeight: "+my_txt.textHeight+", textWidth: "+my_txt.textWidth); trace("_height: "+my_txt._height+", _width: "+my_txt._width+"\n"); my_txt.autoSize = true; trace("after my_txt.autoSize = true;"); trace("_height: "+my_txt._height+", _width: "+my_txt._width);
Que devuelve la siguiente informacin:

textHeight: 15, textWidth: 56 _height: 300, _width: 100 after my_txt.autoSize = true; _height: 19, _width: 60
Vase tambin
textWidth (propiedad TextField.textWidth)
textWidth (propiedad TextField.textWidth)

public textWidth : Number
Indica la anchura del texto. Disponibilidad Flash Lite 2.0 Ejemplo Consulte el ejemplo de TextField.textHeight. Vase tambin
textHeight (propiedad TextField.textHeight)

type (propiedad TextField.type)

public type : String
Especifica el tipo de campo de texto. Existen dos valores: dynamic, que especifica un campo de texto dinmico que el usuario no puede modificar, e input, que especifica un campo de introduccin de texto. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea dos campos de texto: username_txt y password_txt. Se introduce texto en los dos campos de texto; sin embargo, password_txt tiene la propiedad password definida como true. Por lo tanto, los caracteres se muestran como asteriscos en el campo password_txt.
this.createTextField("username_txt", this.getNextHighestDepth(), 10, 10, 100, 22); username_txt.border = true; username_txt.type = "input"; username_txt.maxChars = 16; username_txt.text = "hello"; this.createTextField("password_txt", this.getNextHighestDepth(), 10, 40, 100, 22); password_txt.border = true; password_txt.type = "input"; password_txt.maxChars = 16; password_txt.password = true; password_txt.text = "world";
_url (propiedad TextField._url)

Recupera el URL del archivo SWF que cre el campo de texto. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente recupera la URL del archivo SWF que cre el campo de texto y el archivo SWF que lo carga en l.
this.createTextField("my_txt", 1, 10, 10, 100, 22); trace(my_txt._url); var mclListener:Object = new Object(); mclListener.onLoadInit = function(target_mc:MovieClip) { trace(target_mc._url); }; var holder_mcl:MovieClipLoader = new MovieClipLoader(); holder_mcl.addListener(mclListener); holder_mcl.loadClip("best_flash_ever.swf", this.createEmptyMovieClip("holder_mc", 2));
Al probar este ejemplo, la URL del archivo SWF que se est probando y el archivo best_flash_ever.swf se muestran en el panel Salida. Al probar este ejemplo, la URL del archivo SWF que se est probando y el archivo best_flash_ever.swf se escriben en el archivo de registro.

variable (propiedad TextField.variable)

public variable : String
Nombre de la variable a la que est asociado el campo de texto. El tipo de esta propiedad es String. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un campo de texto con el nombre my_txt y le asocia la variable today_date. Al cambiar la variable today_date, se actualiza el texto que aparece en my_txt.
this.(reateTextField("my_txt", 1, 10, 10, 200, 22); my_txt.variable = "today_date"; var today_date:Date = new Date(); var date_interval:Number = setInterval(updateDate, 500); function updateDate():Void { today_date = new Date(); }
_visible (propiedad TextField._visible)

Valor booleano que indica si el campo de texto my_txt puede seleccionarse. Los campos de texto no visibles (que tienen la propiedad _visible configurada como false) se desactivan. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un campo de texto llamado my_txt. Un botn llamado visible_btn muestra y oculta my_txt.
this.createTextField("my_txt", 1, 10, 10, 200, 22); my_txt.background = true; my_txt.backgroundColor = 0xDFDFDF; my_txt.border = true; my_txt.type = "input"; visible_btn.onRelease = function() { my_txt._visible = !my_txt._visible; };
Vase tambin
_visible (propiedad Button._visible), _visible (propiedad MovieClip._visible)
_width (propiedad TextField._width)

Anchura del campo de texto, expresada en pxeles.

Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea dos campos de texto que pueden utilizarse para cambiar la anchura y la altura de un tercer campo de texto en el escenario. Aada el siguiente cdigo ActionScript al archivo ActionScript o FLA.
this.createTextField("my_txt", this.getNextHighestDepth(), 10, 40, 160, 120); my_txt.background = true; my_txt.backgroundColor = 0xFF0000; my_txt.border = true; my_txt.multiline = true; my_txt.type = "input"; my_txt.wordWrap = true; this.createTextField("width_txt", this.getNextHighestDepth(), 10, 10, 30, 20); width_txt.border = true; width_txt.maxChars = 3; width_txt.type = "input"; width_txt.text = my_txt._width; width_txt.onChanged = function() { my_txt._width = this.text; } this.createTextField("height_txt", this.getNextHighestDepth(), 70, 10, 30, 20); height_txt.border = true; height_txt.maxChars = 3; height_txt.type = "input"; height_txt.text = my_txt._height; height_txt.onChanged = function() { my_txt._height = this.text; }
Al probar el ejemplo, intente especificar nuevos valores en width_txt y height_txt para cambiar las dimensiones de my_txt. Vase tambin
_height (propiedad TextField._height)
wordWrap (propiedad TextField.wordWrap)

public wordWrap : Boolean
Valor booleano que indica si el campo de texto tiene ajuste de texto. Si el valor de wordWrap es true, el campo de texto tiene ajuste de texto; si el valor es false, el campo de texto no tiene ajuste de texto. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente muestra cmo afecta wordWrap al texto largo en un campo de texto creado en tiempo de ejecucin.

this.createTextField("my_txt", 99, 10, 10, 100, 200); my_txt.text = "This is very long text that will certainly extend beyond the width of this text field"; my_txt.border = true;
Para probar el archivo SWF en Flash Lite Player, seleccione Control > Probar pelcula. A continuacin, vuelva a ActionScript y aada la lnea siguiente al cdigo, y pruebe de nuevo el archivo SWF:
my_txt.wordWrap = true;
_x (TextField._x, propiedad)
public _x : Number
Entero que establece la coordenada x de un campo de texto relativa a las coordenadas locales del clip de pelcula principal. Si un campo de texto se encuentra en la lnea de tiempo principal, su sistema de coordenadas hace referencia a la esquina superior izquierda del escenario como (0, 0). Si el campo de texto est dentro de un clip de pelcula que incluye transformaciones, el campo de texto estar en el sistema de coordenadas local del clip de pelcula en el que est contenido. Por consiguiente, en el caso de un clip de pelcula con un giro de 90 grados en sentido contrario al de las agujas del reloj, el campo de texto contenido hereda un sistema de coordenadas con un giro de 90 grados en sentido contrario al de las agujas del reloj. Las coordenadas del campo de texto hacen referencia a la posicin del punto de registro. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un campo de texto en el punto donde se haga clic con el ratn. Cuando crea un campo de texto, ese campo muestra las coordenadas x e y actuales del campo de texto.
this.createTextField("coords_txt", this.getNextHighestDepth(), 0, 0, 60, 22); coords_txt.autoSize = true; coords_txt.selectable = false; coords_txt.border = true; var mouseListener:Object = new Object(); mouseListener.onMouseDown = function() { coords_txt.text = "X:"+Math.round(_xmouse)+", Y:"+Math.round(_ymouse); coords_txt._x = _xmouse; coords_txt._y = _ymouse; }; Mouse.addListener(mouseListe(er);
Vase tambin
_xscale (propiedad TextField._xscale), _y (propiedad TextField._y), _yscale (propiedad TextField._yscale)
_xmouse (propiedad TextField._xmouse)

Devuelve la coordenada x de la posicin del ratn relativa al campo de texto. Nota: esta propiedad se admite en Flash Lite slo si System.capabilities.hasMouse es true o System.capabilities.hasStylus es true.

Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea tres campos de texto en el escenario. La instancia mouse_txt muestra la posicin actual del ratn en relacin al escenario. La instancia textfield_txt muestra la posicin actual del puntero del ratn en relacin a la instancia my_txt. Aada el siguiente cdigo ActionScript al archivo ActionScript o FLA:
this.createTextField("mouse_txt", this.getNextHighestDepth(), 10, 10, 200, 22); mouse_txt.border = true; this.createTextField("textfield_txt", this.getNextHighestDepth(), 220, 10, 200, 22); textfield_txt.border = true; this.createTextField("my_txt", this.getNextHighestDepth(), 100, 100, 160, 120); my_txt.border = true; var mouseListener:Object = new Object(); mouseListener.onMouseMove = function() { mouse_txt.text = "MOUSE ... X:" + Math.round(_xmouse) + ",\tY:" + Math.round(_ymouse); textfield_txt.text = "TEXTFIELD ... X:" + Math.round(my_txt._xmouse) + ",\tY:" + Math.round(my_txt._ymouse); } Mouse.addListener(mouseListener);
Vase tambin
_ymouse (propiedad TextField._ymouse)
_xscale (propiedad TextField._xscale)

Determina la escala horizontal del campo de texto aplicada desde el punto de registro del campo de texto, expresada como porcentaje. El punto de registro predeterminado es (0,0). Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente cambia la escala de la instancia my_txt cuando hace clic en las instancias scaleUp_btn y scaleDown_btn.

this.createTextField("my_txt", 99, 10, 40, 100, 22); my_txt.autoSize = true; my_txt.border = true; my_txt.selectable = false; my_txt.text = "Sample text goes here."; scaleUp_btn.onRelease = function() { my_txt._xscale = 2; my_txt._yscale = 2; } scaleDown_btn.onRelease = function() { my_txt._xscale /= 2; my_txt._yscale /= 2; }
Vase tambin
_x (TextField._x, propiedad), _y (propiedad TextField._y), _yscale (propiedad TextField._yscale)
_y (propiedad TextField._y)
public _y : Number
Establece la coordenada y de un campo de texto relativa a las coordenadas locales del clip de pelcula principal. Si un campo de texto se encuentra en la lnea de tiempo principal, su sistema de coordenadas hace referencia a la esquina superior izquierda del escenario como (0, 0). Si el campo de texto est dentro de otro clip de pelcula que incluye transformaciones, el campo de texto estar en el sistema de coordenadas local del clip de pelcula en el que est contenido. Por consiguiente, en el caso de un clip de pelcula con un giro de 90 grados en sentido contrario al de las agujas del reloj, el campo de texto contenido hereda un sistema de coordenadas con un giro de 90 grados en sentido contrario al de las agujas del reloj. Las coordenadas del campo de texto hacen referencia a la posicin del punto de registro. Disponibilidad Flash Lite 2.0 Ejemplo Consulte el ejemplo de TextField._x. Vase tambin
_x (TextField._x, propiedad), _xscale (propiedad TextField._xscale), _yscale (propiedad TextField._yscale)
_ymouse (propiedad TextField._ymouse)

Indica la coordenada y de la posicin del ratn relativa al campo de texto. Nota: esta propiedad se admite en Flash Lite slo si System.capabilities.hasMouse es true o System.capabilities.hasStylus es true. Disponibilidad Flash Lite 2.0

Ejemplo Consulte el ejemplo de TextField._xmouse. Vase tambin

_xmouse (propiedad TextField._xmouse)
_yscale (propiedad TextField._yscale)

La escala vertical del campo de texto aplicada desde el punto de registro del campo de texto, expresada como porcentaje. El punto de registro predeterminado es (0,0). Disponibilidad Flash Lite 2.0 Ejemplo Consulte el ejemplo de TextField._xscale. Vase tambin
_x (TextField._x, propiedad), _xscale (propiedad TextField._xscale), _y (propiedad TextField._y)
TextFormat
Object | +-TextFormat public class TextFormat extends Object
La clase TextFormat representa la informacin relativa al formato de los caracteres. Utilice la clase TextFormat para crear formato de texto especfico para los campos de texto. Puede aplicar formato de texto tanto a campos de texto estticos como dinmicos. Algunas propiedades de la clase TextFormat no estn disponibles para fuentes incorporadas y de dispositivo. Disponibilidad Flash Lite 2.0 Vase tambin
setTextFormat (mtodo TextField.setTextFormat), getTextFormat (mtodo TextField.getTextFormat)
Modificadores Propiedad align:String blockIndent:Number bold:Boolean Descripcin Cadena que indica la alineacin del prrafo. Nmero que indica la sangra de bloque en puntos. Valor booleano que especifica si el texto est en negrita.

Modificadores
Propiedad bullet:Boolean
Descripcin Valor booleano que indica que el texto forma parte de una lista con vietas. Nmero que indica el color del texto. Cadena que especifica el nombre de la fuente para el texto. Entero que indica la sangra desde el margen izquierdo hasta el primer carcter del prrafo. Valor booleano que indica si el texto con este formato de texto est en cursiva. Un entero que representa la cantidad de espacio vertical entre lneas (denominado interlineado) expresado en pxeles. Margen izquierdo del prrafo expresado en puntos. Margen derecho del prrafo expresado en puntos. Tamao en puntos del texto con este formato de texto. Especifica las tabulaciones personalizadas como una matriz de enteros no negativos. Indica la ventana de destino en la que se muestra el hipervnculo. Un valor booleano que indica si el texto que utiliza este formato de texto est subrayado (true) o no (false). Indica la URL con la que est vinculado el texto con este formato de texto.
color:Number fuente:String indent:Number
italic:Boolean
leading:Number
leftMargin:Number rightMargin:Number size:Number tabStops:Array
target:String
underline:Boolean
url:String

Firma TextFormat([fuente:String], [size:Number], [color:Number], [bold:Boolean], [italic:Boolean], [underline:Boolean], [url:String], [target:String], [align:String], [leftMargin:Number], [rightMargin:Number], [indent:Number], [leading:Number]) Descripcin Crea un objeto TextFormat con las propiedades especificadas.

Resumen de mtodos
Modificadores Firma getTextExtent(text:Stri ng, [width:Number]) : Object Descripcin Devuelve informacin sobre las medidas del texto para la cadena text en el formato especificado por my_fmt.

align (propiedad TextFormat.align)

public align : String
Cadena que indica la alineacin del prrafo. Puede aplicar esta propiedad a texto esttico y dinmico. En la lista siguiente se muestran los valores que puede tener esta propiedad:
Si es "left", el prrafo est alineado a la izquierda. Si es "center", el prrafo est centrado. Si es "right", el prrafo est alineado a la derecha.
El valor predeterminado es null, que indica que la propiedad no se ha definido. Disponibilidad Flash Lite 2.0 Ejemplo El siguiente ejemplo crea un campo de texto con borde y utiliza TextFormat.align para centrar el texto.
var my_fmt:TextFormat = new TextFormat(); my_fmt.align = "center"; this.createTextField("my_txt", 1, 100, 100, 300, 100); my_txt.multiline = true; my_txt.wordWrap = true; my_txt.border = true; my_txt.text = "this is my first text field object text"; my_txt.setTextFormat(my_fmt);
blockIndent (propiedad TextFormat.blockIndent)

public blockIndent : Number
Nmero que indica la sangra de bloque en puntos. La sangra de bloque se aplica a un bloque de texto completo; es decir, a todas las lneas del texto. Por el contrario, la sangra normal (TextFormat.indent) slo afecta a la primera lnea de cada prrafo. Si esta propiedad tiene el valor null, el objeto TextFormat no especifica la sangra de bloque. Disponibilidad Flash Lite 2.0

Ejemplo En este ejemplo se crea un campo de texto con borde y blockIndent se establece en 20.
this.createTextField("mytext",1,100,100,100,100); mytext.multiline = true; mytext.wordWrap = true; mytext.border = true; var myformat:TextFormat = new TextFormat(); myformat.blockIndent = 20; mytext.text = "This is my first text field object text"; mytext.setTextFormat(myformat);
bold (propiedad TextFormat.bold)

public bold : Boolean
Valor booleano que especifica si el texto est en negrita. El valor predeterminado es null, que indica que la propiedad no se ha definido. Si el valor es true, el texto est en negrita. Nota: para rabe, hebreo y tailands, esta propiedad slo funciona para formato a nivel de prrafo. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se crea un campo de texto que incluye caracteres en negrita.
var my_fmt:TextFormat = new TextFormat(); my_fmt.bold = true; this.createTextField("my_txt", 1, 100, 100, 300, 100); my_txt.multiline = true; my_txt.wordWrap = true; my_txt.border = true; my_txt.text = "This is my text field object text"; my_txt.setTextFormat(my_fmt);
bullet (propiedad TextFormat.bullet)

public bullet : Boolean
Valor booleano que indica que el texto forma parte de una lista con vietas. En una lista con vietas, todos los prrafos de texto estn sangrados. A la izquierda de la primera lnea de cada prrafo se muestra un smbolo de vieta. El valor predeterminado es null. Nota:En Flash Lite, esta propiedad funciona slo en fuentes incorporadas. esta propiedad no admite fuentes para rabe, hebreo y tailands. Disponibilidad Flash Lite 2.0

Ejemplo En el ejemplo siguiente se crea un nuevo campo de texto durante la ejecucin y se introduce una cadena con un salto de lnea en el campo. La clase TextFormat se utiliza para asignar formato a los caracteres aadiendo vietas a cada lnea del campo de texto. Esto se ilustra en el siguiente cdigo ActionScript:
var my_fmt:TextFormat = new TextFormat(); my_fmt.bullet = true; this.createTextField("my_txt", 1, 100, 100, 300, 100); my_txt.multiline = true; my_txt.wordWrap = true; my_txt.border = true; my_txt.text = "this is my text"+newline; my_txt.text += "this is more text"+newline; my_txt.setTextFormat(my_fmt);
color (propiedad TextFormat.color)

public color : Number
Nmero que indica el color del texto. Nmero que contiene tres componentes RGB de 8 bits; por ejemplo, 0xFF0000 es rojo y 0x00FF00, verde. Nota: para rabe, hebreo y tailands, esta propiedad slo funciona para formato a nivel de prrafo. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se crea un campo de texto y el color del texto se establece en rojo.
var my_fmt:TextFormat = new TextFormat(); my_fmt.blockIndent = 20; my_fmt.color = 0xFF0000; // hex value for red this.createTextField("my_txt", 1, 100, 100, 300, 100); my_txt.multiline = true; my_txt.wordWrap = true; my_txt.border = true; my_txt.text = "this is my first text field object text"; my_txt.setTextFormat(my_fmt);
font (propiedad TextFormat.font)

public font : String
Cadena que especifica el nombre de la fuente para el texto. El valor predeterminado es null, que indica que la propiedad no se ha definido. Nota:En Flash Lite, esta propiedad funciona slo en fuentes incorporadas. esta propiedad no admite fuentes para rabe, hebreo y tailands. Disponibilidad Flash Lite 2.0

Ejemplo En el ejemplo siguiente se crea un campo de texto y la fuente se define como Courier.
this.createTextField("mytext",1,100,100,100,100); mytext.multiline = true; mytext.wordWrap = true; mytext.border = true; var myformat:TextFormat = new TextFormat(); myformat.font = "Courier"; mytext.text = "this is my first text field object text"; mytext.setTextFormat(myformat);
getTextExtent (mtodo TextFormat.getTextExtent)

public getTextExtent(text:String, [width:Number]) : Object
Devuelve informacin sobre las medidas del texto para la cadena text en el formato especificado por my_fmt. La cadena de texto se trata como texto normal (que no es HTML). El mtodo devuelve un objeto con seis propiedades: ascent, descent, width, height, textFieldHeight y textFieldWidth. Todas las medidas se expresan en pxeles. Si se especifica un parmetro width, se aplicar ajuste de texto al texto especificado. Esto le permite determinar la altura a la que un cuadro de texto muestra todo el texto especificado. Las medidas ascent (ascendente) y descent (descendente) proporcionan, respectivamente, la distancia por encima y por debajo de la lnea de base de una lnea de texto. La lnea de base de la primera lnea de texto se sita en el origen del campo de texto ms su medida de ascent. Las medidas width y height proporcionan la anchura y la altura de la cadena de texto. Las medidas textFieldHeight y textFieldWidth proporcionan la altura y la anchura necesarias para que un objeto de campo de texto muestre la cadena de texto completa. Los campos de texto tienen alrededor un espacio de 2 pxeles de ancho, por lo que el valor de textFieldHeight es igual al valor de height + 4; de igual forma, el valor de textFieldWidth siempre es igual al valor de width + 4. Si est creando un campo de texto basado en las medidas del texto, utilice textFieldHeight en lugar de height y
textFieldWidth en lugar de width.

En la siguiente figura se ilustran estas medidas:
Al configurar el objeto TextFormat, establezca todos los atributos exactamente de la forma que se establecern para la creacin del campo de texto, incluido el nombre de la fuente, el tamao de la fuente y el espacio interlineal. El valor predeterminado de espacio interlineal (leading) es 2. Disponibilidad Flash Lite 2.0 Parmetros text:String - Una cadena. width:Number [opcional] - Nmero que representa la anchura, en pxeles, a la que debe ajustarse el texto especificado. Valor devuelto Object - Objeto con las propiedades width, height, ascent, descent, textFieldHeight, textFieldWidth. Ejemplo Este ejemplo crea un campo de texto de una lnea lo suficientemente grande para mostrar una cadena de texto con el formato especificado.

var my_str:String = "Small string"; // Create a TextFormat object, // and apply its properties. var my_fmt:TextFormat = new TextFormat(); with (my_fmt) { font = "Arial"; bold = true; } // Obtain metrics information for the text string // with the specified formatting. var metrics:Object = my_fmt.getTextExtent(my_str); // Create a text field just large enough to display the text. this.createTextField("my_txt", this.getNextHighestDepth(), 100, 100, metrics.textFieldWidth, metrics.textFieldHeight); my_txt.border = true; my_txt.wordWrap = true; // Assign the same text string and TextFormat object to the my_txt object. my_txt.text = my_str; my_txt.setTextFormat(my_fmt);
El ejemplo siguiente crea un campo de texto de varias lneas, de 100 pxeles de ancho lo suficientemente alto para mostrar una cadena con el formato especificado.
// Create a TextFormat object. var my_fmt:TextFormat = new TextFormat(); // Specify formatting properties for the TextFormat object: my_fmt.font = "Arial"; my_fmt.bold = true; my_fmt.leading = 4; // The string of text to be displayed var textToDisplay:String = "Adobe Flash Player 7, now with improved text metrics."; // Obtain text measurement information for the string, // wrapped at 100 pixels. var metrics:Object = my_fmt.getTextExtent(textToDisplay, 100); // Create a new TextField object using the metric // information just obtained. this.createTextField("my_txt", this.getNextHighestDepth(), 50, 50-metrics.ascent, 100, metrics.textFieldHeight); my_txt.wordWrap = true; my_txt.border = true; // Assign the text and the TextFormat object to the TextObject: my_txt.text = textToDisplay; my_txt.setTextFormat(my_fmt);
indent (propiedad TextFormat.indent)

public indent : Number
Entero que indica la sangra desde el margen izquierdo hasta el primer carcter del prrafo. El valor predeterminado es null, que indica que la propiedad no se ha definido.

Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se crea un campo de texto y se establece la sangra en 10:
this.createTextField("mytext",1,100,100,100,100); mytext.multiline = true; mytext.wordWrap = true; mytext.border = true; var myformat:TextFormat = new TextFormat(); myformat.indent = 10; mytext.text = "this is my first text field object text"; mytext.setTextFormat(myformat);
Vase tambin
blockIndent (propiedad TextFormat.blockIndent)
italic (propiedad TextFormat.italic)

public italic : Boolean
Valor booleano que indica si el texto con este formato de texto est en cursiva. El valor predeterminado es null, que indica que la propiedad no se ha definido. Nota: para rabe, hebreo y tailands, esta propiedad slo funciona para formato a nivel de prrafo. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se crea un campo de texto y el estilo del texto se define en cursiva.
this.createTextField("mytext",1,100,100,100,100); mytext.multiline = true; mytext.wordWrap = true; mytext.border = true; var myformat:TextFormat = new TextFormat(); myformat.italic = true; mytext.text = "This is my first text field object text"; mytext.setTextFormat(myformat);
leading (propiedad TextFormat.leading)

public leading : Number
Un entero que representa la cantidad de espacio vertical entre lneas (denominado interlineado) expresado en pxeles. El valor predeterminado es null, que indica que la propiedad no se ha definido.

Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se crea un campo de texto y se establece el interlineado en 10.
var my_fmt:TextFormat = new TextFormat(); my_fmt.leading = 10; this.createTextField("my_txt", 1, 100, 100, 100, 100); my_txt.multiline = true; my_txt.wordWrap = true; my_txt.border = true; my_txt.text = "This is my first text field object text"; my_txt.setTextFormat(my_fmt);
leftMargin (propiedad TextFormat.leftMargin)

public leftMargin : Number
Margen izquierdo del prrafo expresado en puntos. El valor predeterminado es null, que indica que la propiedad no se ha definido. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se crea un campo de texto y el margen izquierdo se establece en 20 puntos.
this.createTextField("mytext",1,100,100,100,100); mytext.multiline = true; mytext.wordWrap = true; mytext.border = true; var myformat:TextFormat = new TextFormat(); myformat.leftMargin = 20; mytext.text = "this is my first text field object text"; mytext.setTextFormat(myformat);
rightMargin (propiedad TextFormat.rightMargin)

public rightMargin : Number
Margen derecho del prrafo expresado en puntos. El valor predeterminado es null, que indica que la propiedad no se ha definido. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se crea un campo de texto y el margen derecho se establece en 20 puntos.

this.createTextField("mytext",1,100,100,100,100); mytext.multiline = true; mytext.wordWrap = true; mytext.border = true; var myformat:TextFormat = new TextFormat(); myformat.rightMargin = 20; mytext.text = "this is my first text field object text"; mytext.setTextFormat(myformat);
size (propiedad TextFormat.size)

public size : Number
Tamao en puntos del texto con este formato de texto. El valor predeterminado es null, que indica que la propiedad no se ha definido. Nota: para rabe, hebreo y tailands, esta propiedad slo funciona para formato a nivel de prrafo. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se crea un campo de texto y el tamao del texto se establece en 20 puntos.
this.createTextField("mytext",1,100,100,100,100); mytext.multiline = true; mytext.wordWrap = true; mytext.border = true; var myformat:TextFormat = new TextFormat(); myformat.size = 20; mytext.text = "This is my first text field object text"; mytext.setTextFormat(myformat);
tabStops (propiedad TextFormat.tabStops)

public tabStops : Array
Especifica las tabulaciones personalizadas como una matriz de enteros no negativos. Cada tabulacin se especifica en pxeles. Si no se han especificado tabulaciones personalizadas (null), la tabulacin predeterminada es 4 (la anchura media de los caracteres). Nota:En Flash Lite, esta propiedad funciona slo en fuentes incorporadas. esta propiedad no admite fuentes para rabe, hebreo y tailands. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se crean dos campos de texto, uno con tabulaciones cada 40 pxeles y otro con tabulaciones cada 75 pxeles.

this.createTextField("mytext",1,100,100,400,100); mytext.border = true; var myformat:TextFormat = new TextFormat(); myformat.tabStops = [40,80,120,160]; mytext.text = "A\tB\tC\tD"; // \t is the tab stop character mytext.setTextFormat(myformat); this.createTextField("mytext2",2,100,220,400,100); mytext2.border = true; var myformat2:TextFormat = new TextFormat(); myformat2.tabStops = [75,150,225,300]; mytext2.text ="A\tB\tC\tD"; mytext2.setTextFormat(myformat2);
target (propiedad TextFormat.target)

public target : String
Indica la ventana de destino en la que se muestra el hipervnculo. Si la ventana de destino es una cadena vaca, el texto se muestra en la ventana de destino predeterminada, _self. Puede elegir un nombre personalizado o uno de los cuatro nombres siguientes: La opcin _self especifica el marco actual de la ventana actual, _blank especifica una ventana nueva, _parent especifica el nivel superior del marco actual y _top el marco del nivel ms alto de la ventana actual. Si la propiedad TextFormat.url es una cadena vaca o tiene el valor null, puede obtener o definir esta propiedad, pero sta no tendr ningn efecto. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se crea un campo de texto con un hipervnculo al sitio Web de Adobe. En el ejemplo se utiliza TextFormat.target para mostrar el sitio Web de Adobe en una ventana del navegador nueva.
var myformat:TextFormat = new TextFormat(); myformat.url = "http://www.adobe.com"; myformat.target = "_blank"; this.createTextField("mytext",1,100,100,200,100); mytext.multiline = true; mytext.wordWrap = true; mytext.border = true; mytext.html = true; mytext.text = "Go to Adobe.com"; mytext.setTextFormat(myformat);
Vase tambin
url (propiedad TextFormat.url)
TextFormat, constructor
public TextFormat([font:String], [size:Number], [color:Number], [bold:Boolean], [italic:Boolean], [underline:Boolean], [url:String], [target:String], [align:String], [leftMargin:Number], [rightMargin:Number], [indent:Number], [leading:Number])

Crea un objeto TextFormat con las propiedades especificadas. A continuacin, puede cambiar las propiedades del objeto TextFormat para cambiar el formato de los campos de texto. Cualquier parmetro puede establecerse en null para indicar que no est definido. Todos los parmetros son opcionales; se considerar que los parmetros que se omitan tienen el valor null. Disponibilidad Flash Lite 2.0 Parmetros font:String - [opcional] Nombre de una fuente de texto en forma de cadena. size:Number [opcional] - Entero que indica el tamao en puntos. color:Number [opcional] - El color del texto que utiliza este formato de texto. El nmero contiene tres componentes RGB de 8 bits; por ejemplo, 0xFF0000 es rojo y 0x00FF00, verde. bold:Boolean [opcional] - Valor booleano que indica si el texto est en negrita. italic:Boolean [opcional] - Valor booleano que indica si el texto est en cursiva. underline:Boolean [opcional] - Valor booleano que indica si el texto est subrayado. url:String [opcional] - La URL con la que est vinculado el texto con este formato de texto. Si url es una cadena vaca, el texto no tiene hipervnculo. target:String [opcional] - La ventana de destino en la que se muestra el hipervnculo. Si la ventana de destino es una cadena vaca, el texto se muestra en la ventana de destino predeterminada, _self. Si el parmetro url se define como una cadena vaca o en el valor null, puede obtener o establecer esta propiedad, pero sta no tendr ningn efecto. align:String [opcional] - La alineacin del prrafo representado como una cadena. Si es "left", prrafo est alineado a la izquierda. Si es "center", el prrafo est centrado. Si es "right", prrafo est alineado a la derecha. leftMargin:Number [opcional] - Indica el margen izquierdo del prrafo, expresado en puntos. rightMargin:Number [opcional] - Indica el margen derecho del prrafo, expresado en puntos. indent:Number [opcional] - Entero que indica la sangra desde el margen izquierdo hasta el primer carcter del prrafo. leading:Number [opcional] - Nmero que indica la cantidad de espacio vertical entre las lneas (interlineado). Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se crea un objeto TextFormat, se asigna formato al campo de texto stats_txt y se crea un nuevo campo de texto en el que mostrar el texto:

// Define a TextFormat which is used to format the stats_txt text field. var my_fmt:TextFormat = new TextFormat(); my_fmt.bold = true; my_fmt.font = "Arial"; my_fmt.size = 12; my_fmt.color = 0xFF0000; // Create a text field to display the player's statistics. this.createTextField("stats_txt", 5000, 10, 0, 530, 22); // Apply the TextFormat to the text field. stats_txt.setNewTextFormat(my_fmt); stats_txt.selectable = false; stats_txt.text = "Lorem ipsum dolor sit amet...";
Para ver otro ejemplo, consulte el archivo animations.fla de la carpeta de ejemplos de ActionScript de La pgina de ejemplos de Adobe Flash. Descargue y descomprima el archivo .zip y acceda a la carpeta de su versin de ActionScript para poder ver el ejemplo.
underline (propiedad TextFormat.underline)

public underline : Boolean
Un valor booleano que indica si el texto que utiliza este formato de texto est subrayado (true) o no (false). Este subrayado es similar al que se obtiene mediante la etiqueta , aunque sta ltima no es un subrayado real, ya que no omite los trazos descendentes correctamente. El valor predeterminado es null, que indica que la propiedad no se ha definido. Nota: para rabe, hebreo y tailands, esta propiedad slo funciona para formato a nivel de prrafo. Disponibilidad Flash Lite 2.0 Ejemplo En el ejemplo siguiente se crea un campo de texto y el estilo del texto se define en subrayado.
this.createTextField("mytext",1,100,100,200,100); mytext.multiline = true; mytext.wordWrap = true; mytext.border = true; var myformat:TextFormat = new TextFormat(); myformat.underline = true; mytext.text = "This is my first text field object text"; mytext.setTextFormat(myformat);
url (propiedad TextFormat.url)

public url : String
Indica la URL con la que est vinculado el texto con este formato de texto. Si la propiedad url es una cadena vaca, el texto no tiene hipervnculo. El valor predeterminado es null, que indica que la propiedad no se ha definido. Disponibilidad Flash Lite 2.0

Ejemplo En el ejemplo siguiente se crea un campo de texto con un hipervnculo al sitio Web de Adobe.
var myformat:TextFormat = new TextFormat(); myformat.url = "http://www.adobe.com"; this.createTextField("mytext",1,100,100,200,100); mytext.multiline = true; mytext.wordWrap = true; mytext.border = true; mytext.html = true; mytext.text = "Go to Adobe.com"; mytext.setTextFormat(myformat);
Transform (flash.geom.Transform)
Object | +-flash.geom.transform public class Transform extends Object
La clase Transform recopila datos acerca de las manipulaciones de color y de coordenadas que se aplican a un objeto MovieClip. Un objeto Transform normalmente se consigue obteniendo el valor de la propiedad transform de un objeto MovieClip. Disponibilidad Flash Lite 3.1 Vase tambin
transform (propiedad MovieClip.transform), ColorTransform (flash.geom.ColorTransform), Matrix (flash.geom.Matrix))
Modificadores Propiedad Descripcin
colorTransform:ColorTran Objeto ColorTransform que contiene valores que ajustan sform globalmente los colores en el clip de pelcula. concatenatedColorTransfo Objeto ColorTransform que representa las transformaciones de rm:ColorTransform color aplicadas a este objeto y todas las de sus objetos principales [slo lectura] hasta el nivel de la raz, combinadas. ConcatenatedMatrix:Matr Objeto Matrix que representa las matrices de transformacin ix [slo lectura] aplicadas a este objeto y todas las de sus objetos principales hasta el nivel de la raz, combinadas. matriz:Matrix Objeto Matrix de transformacin que contiene valores que afectan al ajuste de tamao, rotacin y traslacin del clip de pelcula. Objeto Rectangle que define el rectngulo de delimitacin del objeto MovieClip en el escenario.
pixelBounds:Rectngulo

constructor (propiedad Object.constructor), __proto__ (Object.__proto__, propiedad), prototype (propiedad Object.prototype) en la pgina 510, __resolve (Object.__resolve, propiedad)
Firma Transform(mc:MovieClip
)
Descripcin Crea un nuevo objeto Transform asociado al objeto MovieClip especificado.
Resumen de mtodos
addProperty (mtodo Object.addProperty) en la pgina 504, hasOwnProperty (mtodo Object.hasOwnProperty) en la pgina 508, isPropertyEnumerable (mtodo Object.isPropertyEnumerable) en la pgina 508, isPrototypeOf (mtodo Object.isPrototypeOf) en la pgina 509, registerClass (mtodo Object.registerClass) en la pgina 511, toString (mtodo Object.toString) en la pgina 515, unwatch (mtodo Object.unwatch) en la pgina 516, valueOf (mtodo Object.valueOf) en la pgina 517, watch (mtodo Object.watch) en la pgina 518
colorTransform (propiedad Transform.colorTransform)

public colorTransform : ColorTransform
Objeto ColorTransform que contiene valores que ajustan globalmente los colores en el clip de pelcula. Disponibilidad Flash Lite 3.1 Ejemplo El siguiente ejemplo aplica el objeto ColorTransform blueColorTransform al objeto Transform trans. Este objeto ColorTransform cambia el color del objeto MovieClip rect de rojo a azul.

import flash.geom.Transform; import flash.geom.ColorTransform; var rect:MovieClip = createRectangle(20, 80, 0xFF0000); var trans:Transform = new Transform(rect); trace(trans.colorTransform); // (redMultiplier=1, greenMultiplier=1, blueMultiplier=1, alphaMultiplier=1, redOffset=0, greenOffset=0, blueOffset=0, alphaOffset=0) var blueColorTransform:ColorTransform = new ColorTransform(0, 1, 1, 1, 0, 0, 255, 0); rect.onPress = function() { trans.colorTransform = blueColorTransform; trace(trans.colorTransform); // (redMultiplier=0, greenMultiplier=1, blueMultiplier=1, alphaMultiplier=1, redOffset=0, greenOffset=0, blueOffset=255, alphaOffset=0) } function createRectangle(width:Number, height:Number, color:Number, scope:MovieClip):MovieClip { scope = (scope == undefined) ? this : scope; var depth:Number = scope.getNextHighestDepth(); var mc:MovieClip = scope.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }
Vase tambin
ColorTransform (flash.geom.ColorTransform) en la pgina 269
concatenatedColorTransform (propiedad Transform.concatenatedColorTransform)

public concatenatedColorTransform : ColorTransform [read-only]
Objeto ColorTransform que representa las transformaciones de color aplicadas a este objeto y todas las de sus objetos principales hasta el nivel de la raz, combinadas. Si se han aplicado transformaciones de color diferentes en niveles distintos, para esta propiedad se concatenarn todas ellas en un objeto ColorTransform. Disponibilidad Flash Lite 3.1 Ejemplo El siguiente ejemplo aplica dos objetos Transform a un objeto MovieClip principal y secundario. A continuacin, se aplica una variable blueColorTransform al objeto Transform parentTrans, que ajusta el color de los objetos MovieClip principal y secundario a azul. Puede ver qu child.concatenatedColorTransform es una combinacin de parentTrans y childTrans.

import flash.geom.Transform; import flash.geom.ColorTransform; var parentRect:MovieClip = createRectangle(20, 80, 0xFF0000); var childRect:MovieClip = createRectangle(10, 40, 0x00FF00, parentRect); var parentTrans:Transform = new Transform(parentRect); var childTrans:Transform = new Transform(childRect); var blueColorTransform:ColorTransform = new ColorTransform(0, 1, 1, 1, 0, 0, 255, 0); parentTrans.colorTransform = blueColorTransform; trace(childTrans.concatenatedColorTransform); // (redMultiplier=0, greenMultiplier=1, blueMultiplier=1, alphaMultiplier=1, redOffset=0, greenOffset=0, blueOffset=255, alphaOffset=0) trace(childTrans.colorTransform); // (redMultiplier=1, greenMultiplier=1, blueMultiplier=1, alphaMultiplier=1, redOffset=0, greenOffset=0, blueOffset=0, alphaOffset=0) trace(parentTrans.concatenatedColorTransform); // (redMultiplier=0, greenMultiplier=1, blueMultiplier=1, alphaMultiplier=1, redOffset=0, greenOffset=0, blueOffset=255, alphaOffset=0) function createRectangle(width:Number, height:Number, color:Number, scope:MovieClip):MovieClip { scope = (scope == undefined) ? this : scope; var depth:Number = scope.getNextHighestDepth(); var mc:MovieClip = scope.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }
Vase tambin
ColorTransform (flash.geom.ColorTransform) en la pgina 269
concatenatedMatrix (propiedad Transform.concatenatedMatrix)

public concatenatedMatrix : Matrix [read-only]
Objeto Matrix que representa las matrices de transformacin aplicadas a este objeto y todas las de sus objetos principales hasta el nivel de la raz, combinadas. Si se han aplicado matrices de transformacin diferentes en niveles distintos, para esta propiedad se concatenarn todas ellas en un objeto Matrix. Disponibilidad Flash Lite 3.1 Ejemplo El siguiente ejemplo aplica dos objetos Transform a un objeto MovieClip secundario y principal. A continuacin, se aplica scaleMatrix al objeto Transform parentTrans, que cambia la escala de los objetos MovieClip principal y secundario. Puede ver qu child.concatenatedMatrix es una combinacin de parentTrans y childTrans.

import flash.geom.Transform; import flash.geom.Matrix; var parentRect:MovieClip = createRectangle(20, 80, 0xFF0000); var childRect:MovieClip = createRectangle(10, 40, 0x00FF00, parentRect); var parentTrans:Transform = new Transform(parentRect); var childTrans:Transform = new Transform(childRect); var scaleMatrix:Matrix = new Matrix(); scaleMatrix.scale(2, 2); parentTrans.matrix = scaleMatrix; trace(childTrans.concatenatedMatrix); // (a=2, b=0, c=0, d=2, tx=0, ty=0) trace(childTrans.matrix); // (a=1, b=0, c=0, d=1, tx=0, ty=0) trace(parentTrans.concatenatedMatrix); // (a=2, b=0, c=0, d=2, tx=0, ty=0) function createRectangle(width:Number, height:Number, color:Number, scope:MovieClip):MovieClip { scope = (scope == undefined) ? this : scope; var depth:Number = scope.getNextHighestDepth(); var mc:MovieClip = scope.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }
matrix (propiedad Transform.matrix)

public matrix : Matrix
Objeto Matrix de transformacin que contiene valores que afectan al ajuste de tamao, rotacin y traslacin del clip de pelcula. Disponibilidad Flash Lite 3.1 Ejemplo El siguiente ejemplo aplica el objeto Matrix scaleMatrix al objeto Transform trans. Esta matriz cambia la escala del objeto MovieClip rect mediante el factor dos.

import flash.geom.Transform; import flash.geom.Matrix; var rect:MovieClip = createRectangle(20, 80, 0xFF0000); var trans:Transform = new Transform(rect); trace(trans.matrix); // (a=1, b=0, c=0, d=1, tx=0, ty=0) var scaleMatrix:Matrix = new Matrix(); scaleMatrix.scale(2, 2); rect.onPress() = function() { trans.matrix = scaleMatrix; trace(trans.matrix); // (a=2, b=0, c=0, d=2, tx=0, ty=0) } function createRectangle(width:Number, height:Number, color:Number, scope:MovieClip):MovieClip { scope = (scope == undefined) ? this : scope; var depth:Number = scope.getNextHighestDepth(); var mc:MovieClip = scope.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }
Vase tambin
Matrix (flash.geom.Matrix)) en la pgina 370
pixelBounds (propiedad Transform.pixelBounds)

public pixelBounds : Rectangle
Objeto Rectangle que define el rectngulo de delimitacin del objeto MovieClip en el escenario. Disponibilidad Flash Lite 3.1 Ejemplo El siguiente ejemplo crea un objeto Transform trans y muestra su propiedad pixelBounds. Observe que pixelBounds devuelve un recuadro de delimitacin con valores iguales a los mtodos getBounds() y getRect() del objeto MovieClip.

import flash.geom.Transform; var rect:MovieClip = createRectangle(20, 80, 0xFF0000); var trans:Transform = new Transform(rect); trace(trans.pixelBounds); // (x=0, y=0, w=20, h=80) var boundsObj:Object = trace(boundsObj.xMin); trace(boundsObj.yMin); trace(boundsObj.xMax); trace(boundsObj.yMax); var rectObj:Object = trace(rectObj.xMin); trace(rectObj.yMin); trace(rectObj.xMax); trace(rectObj.yMax); rect.getBounds(); // 0 // 0 // 20 // 80
rect.getRect(); // 0 // 0 // 20 // 80
function createRectangle(width:Number, height:Number, color:Number, scope:MovieClip):MovieClip { scope = (scope == undefined) ? this : scope; var depth:Number = scope.getNextHighestDepth(); var mc:MovieClip = scope.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }
Constructor Transform
public Transform(mc:MovieClip)
Crea un nuevo objeto Transform asociado al objeto MovieClip especificado. Cuando se crea un nuevo objeto Transform, es posible recuperarlo obteniendo la propiedad transform del objeto MovieClip especificado. Disponibilidad Flash Lite 3.1 Parmetros mc: MovieClip - Objeto MovieClip al que se aplica el nuevo objeto Transform. Ejemplo El siguiente ejemplo crea el objeto Transform trans y lo aplica al objeto MovieClip. Puede ver que las propiedades trans y rect.transform del objeto Transform no se evalan como iguales, a pesar de que contienen los mismos valores.

import flash.geom.Transform; var rect:MovieClip = createRectangle(20, 80, 0xFF0000); var trans:Transform = new Transform(rect); trace(rect.transform == trans); // false for(var i in trans) { trace(">> " + i + ": " + trans[i]); // >> pixelBounds: (x=0, y=0, w=20, h=80) // >> concatenatedColorTransform: (redMultiplier=1, greenMultiplier=1, blueMultiplier=1, alphaMultiplier=1, redOffset=0, greenOffset=0, blueOffset=0, alphaOffset=0) // >> colorTransform: (redMultiplier=1, greenMultiplier=1, blueMultiplier=1, alphaMultiplier=1, redOffset=0, greenOffset=0, blueOffset=0, alphaOffset=0) // >> concatenatedMatrix: (a=1, b=0, c=0, d=1, tx=0, ty=0) // >> matrix: (a=1, b=0, c=0, d=1, tx=0, ty=0) } for(var i in rect.transform) { trace(">> " + i + ": " + rect.transform[i]); // >> pixelBounds: (x=0, y=0, w=20, h=80) // >> concatenatedColorTransform: (redMultiplier=1, greenMultiplier=1, blueMultiplier=1, alphaMultiplier=1, redOffset=0, greenOffset=0, blueOffset=0, alphaOffset=0) // >> colorTransform: (redMultiplier=1, greenMultiplier=1, blueMultiplier=1, alphaMultiplier=1, redOffset=0, greenOffset=0, blueOffset=0, alphaOffset=0) // >> concatenatedMatrix: (a=1, b=0, c=0, d=1, tx=0, ty=0) // >> matrix: (a=1, b=0, c=0, d=1, tx=0, ty=0) } function createRectangle(width:Number, height:Number, color:Number, scope:MovieClip):MovieClip { scope = (scope == undefined) ? this : scope; var depth:Number = scope.getNextHighestDepth(); var mc:MovieClip = scope.createEmptyMovieClip("mc_" + depth, depth); mc.beginFill(color); mc.lineTo(0, height); mc.lineTo(width, height); mc.lineTo(width, 0); mc.lineTo(0, 0); return mc; }
Video
Object | +-Video public class Video extends Object
La clase Video permite visualizar contenido de vdeo incorporado en el archivo SWF, almacenado localmente en el dispositivo host o transmitido sin interrupcin desde una ubicacin remota.

Nota: en Flash Lite 2.0, el reproductor gestiona el vdeo de forma distinta que en Flash Player 7. A continuacin se detallan las diferencias ms significativas:
Flash Player 7 representa los datos de vdeo directamente (ya sean incorporados o de flujo). En Flash Lite 2.0, el
reproductor no representa los datos de vdeo; los transfiere al dispositivo mvil. En Flash Lite 3.0, el reproductor admite la representacin de Flash Video (FLV) directamente con Flash Lite.
Flash Player 7 admite muchos formatos de vdeo adems de FLV. Flash Lite 2.0 admite la reproduccin de vdeo en
los casos siguientes: vdeo incorporado en un archivo SWF; vdeo que resida en un archivo independiente del dispositivo host y datos de vdeo transferidos a travs de la red (en tiempo real). En Flash Lite 2.0, el reproductor slo admite los formatos de vdeo admitidos por cada dispositivo mvil especfico, mientras que en Flash Lite 3.0, el reproductor admite la representacin de Flash Video (FLV) de forma nativa.
Flash Player 7 permite empaquetar los datos en un archivo SWF o transmitirlos sin interrupcin mediante el objeto
Video y asignar un objeto NetStream o Camera como la fuente de informacin del vdeo. Sin embargo, en Flash Lite 2.0 el reproductor no admite objetos NetStream ni Camera. Flash Lite 2.0 utiliza un nuevo tipo de smbolo de biblioteca llamado Video para incorporar los datos del vdeo y transmitir vdeo de flujo continuo para dispositivos mviles. Dado que Flash Lite 2.0 no admite el objeto NetStream, se pueden utilizar mtodos y propiedades de la clase Video para controlar la reproduccin del vdeo. En Flash Lite 3.0, el reproductor s admite los objetos NetStream y NetConnection, y los mtodos y propiedades de estas clases se utilizan para controlar la reproduccin de FLV. Flash Lite 3.0 tambin admite una nueva propiedad en la clase Video, attachVideo, que especifica que se muestre un flujo de vdeo dentro del objeto Video en el escenario. Flash Lite 3.0 no admite el objeto Camera. Debido a los requisitos de los dispositivos mviles (menor velocidad de procesamiento, restricciones de memoria y formatos de codificacin propios), Flash Lite 2.0 no puede representar la informacin de vdeo directamente. Los formatos de archivo admitidos para el vdeo dependen del fabricante del dispositivo mvil. Para obtener ms informacin sobre los formatos de vdeo compatibles, verifique las plataformas de hardware en las que pretende implementar la aplicacin. Por el contrario, Flash Lite 3.0 no representa Flash Video directamente. Flash Lite 2.0 no admite las siguientes funciones de Flash Player 7:
Flujo de datos de vdeo desde Flash Media Server. Grabacin de vdeo.

Flash Lite 3.0 aade compatibilidad con las siguientes funciones de Flash Player 7:
Representacin de Flash Video directamente por el reproductor utilizando versiones de los cdecs On2 y Sorenson
optimizados para dispositivos mviles.
Flujo de datos de vdeo a travs de una conexin RTMP (protocolo de mensajera en tiempo real) con Flash Media
Server. (No se admiten las conexiones RTMPT (tnel de protocolo de mensajera en tiempo real) ni RTMPS (protocolo seguro de mensajera en tiempo real), ni hay varias conexiones) Flash Lite 3.0 no admite las siguientes funciones de Flash Player 7:
Grabacin de vdeo. Objeto Camera

Disponibilidad Flash Lite 2.0 Resumen de propiedades Propiedades heredadas de la clase Object

Resumen de eventos
Evento onStatus = Descripcin Controlador callback que puede ser invocado por el dispositivo para informar sobre el
function(infoObject estado o posibles errores. :Object) {}
Resumen de mtodos
Modificadores Firma close() : Void Descripcin Detiene la reproduccin del vdeo, libera la memoria asociada al objeto Video y borra el rea de vdeo de la pantalla. Detiene la reproduccin del vdeo y sigue representando el fotograma actual en la pantalla. Al llamar a este mtodo se abre una fuente de vdeo y se inicia la reproduccin. Al llamar a este mtodo se reanuda la reproduccin del vdeo. Detiene la reproduccin del vdeo y sigue representando el fotograma actual en la pantalla.
pause() : Void
play() : Boolean
resume() : Void stop() : Void

attachVideo (mtodo Video.attachVideo)

public attachVideo(source:Object) : Void
Especifica un flujo de vdeo (origen) para que se muestre dentro de los lmites del objeto Video del escenario. El flujo de vdeo es un archivo FLV que se est mostrando mediante el comando NetStream.play(), un objeto Camera o null. Si el origen tiene el valor null, dejar de reproducirse vdeo en el objeto Video. No es preciso que utilice este mtodo si el archivo FLV slo contiene audio; la parte de audio de los archivos FLV se reproduce automticamente cuando se enva el comando NetStream.play(). Si desea controlar el audio asociado a un archivo FLV, puede utilizar MovieClip.attachAudio() para dirigir el audio a un clip de pelcula; posteriormente, podr crear un objeto Sound para controlar algunos aspectos del audio. Para ms informacin, consulte MovieClip.attachAudio(). Disponibilidad Flash Lite 3.0

Ejemplo El siguiente ejemplo reproduce un archivo grabado anteriormente con el nombre video.flv que est almacenado en el mismo directorio que el archivo SWF.
var my_video:Video; // my_video is a Video object on the Stage var my_nc:NetConnection = new NetConnection(); my_nc.connect(null); var my_ns:NetStream = new NetStream(my_nc); my_video.attachVideo(my_ns); my_ns.play("video1.flv");
Vase tambin
play (mtodo Video.play), stop (mtodo Video.stop), resume (mtodo Video.resume)
close (mtodo Video.close)

Detiene la reproduccin del vdeo, libera la memoria asociada al objeto Video y borra el rea de vdeo de la pantalla. Disponibilidad Flash Lite 2.0 Ejemplo El siguiente ejemplo cierra un vdeo que se est reproduciendo en un objeto Video denominado video1.
video1.close()
Vase tambin
play (mtodo Video.play), pause (mtodo Video.pause), resume (mtodo Video.resume)
onStatus (controlador Video.onStatus)

Controlador callback que puede ser invocado por el dispositivo para informar sobre el estado o posibles errores. Disponibilidad Flash Lite 3.0 Parmetros infoObject:Object - El parmetro infoObject tiene dos propiedades:
code:String - Descripcin del error o el estado (especfico del dispositivo). level:Number Cero en caso de error y distinto de cero si es correcto (especfico del dispositivo).
Ejemplo El siguiente ejemplo muestra cmo crear una funcin Video.onStatus() que informe sobre el estado o posibles errores.

var v:Video; // v is a Video object on the stage. v.onStatus = function(o:Object) { if ( o.level ) { trace( "Video Status Msg (" + o.level + "): " + o.code ); } else { trace( "Video Status Error: " + o.code ); } } v.play("a.vid");
pause (mtodo Video.pause)

public pause() : Void
Detiene la reproduccin del vdeo y sigue representando el fotograma actual en la pantalla. Las siguientes llamadas a Video.resume() reanudan la reproduccin desde la posicin actual. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente detiene el vdeo que se est reproduciendo en un objeto Video (denominado my_video) cuando el usuario hace clic en la instancia close_btn.
// video1 is the name of a Video object on Stage video1.pause()
Vase tambin
play (mtodo Video.play), stop (mtodo Video.stop), resume (mtodo Video.resume)
play (mtodo Video.play)

public play() : Boolean
Al llamar a este mtodo se abre una fuente de vdeo y se inicia la reproduccin. Disponibilidad Flash Lite 2.0 Valor devuelto Boolean - Un valor true si el dispositivo mvil puede representar el vdeo; de lo contrario, false. Ejemplo El siguiente ejemplo detiene temporalmente y borra video1.flv, que se est reproduciendo en un objeto Video (llamado video1).
video1.play( "http://www.macromedia.com/samples/videos/clock.3gp" );

Tambin puede utilizar un objeto Video del escenario para reproducir vdeos de dispositivo empaquetados directamente desde la biblioteca. Para hacerlo, empaquete el video de dispositivo en la biblioteca de la aplicacin. Tambin asigne un identificador al smbolo de vdeo para poder hacer referencia a l con ActionScript: puede reproducir un vdeo de dispositivo desde la biblioteca pasando el identificador ActionScript del smbolo al mtodo Video.play(), tal como se muestra en el ejemplo siguiente:
placeHolderVideo.play("symbol://ocean_video");
Para obtener ms informacin sobre la reproduccin de vdeo desde la biblioteca, consulte la seccin "Reproduccin de un vdeo empaquetado directamente desde la biblioteca" en Desarrollo de aplicaciones de Flash Lite 2.x. Vase tambin
stop (mtodo Video.stop), pause (mtodo Video.pause), resume (mtodo Video.resume)
resume (mtodo Video.resume)

public resume() : Void
Al llamar a este mtodo se reanuda la reproduccin del vdeo. Si se ha llamado a Video.pause() previamente, la reproduccin se inicia desde la posicin actual. Si se ha llamado a Video.stop() previamente, la reproduccin se inicia desde el primer fotograma. Disponibilidad Flash Lite 2.0 Ejemplo El siguiente ejemplo reanuda un vdeo que se est reproduciendo en un objeto Video denominado video1.
video1.resume()
Vase tambin
pause (mtodo Video.pause), stop (mtodo Video.stop)
stop (mtodo Video.stop)

public stop() : Void
Detiene la reproduccin del vdeo y sigue representando el fotograma actual en la pantalla. Las siguientes llamadas a Video.resume() reanudan la reproduccin desde el primer fotograma del vdeo. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente detiene el vdeo que se est reproduciendo en un objeto Video (denominado my_video) cuando el usuario hace clic en la instancia close_btn.
// video1 is the name of a Video object on Stage video1.stop();
Vase tambin
play (mtodo Video.play), pause (mtodo Video.pause), resume (mtodo Video.resume)

XML
Object | +-XMLNode | +-XML public class XML extends XMLNode
Utilice los mtodos y propiedades de la clase XML para cargar, analizar, enviar, crear y manipular rboles de documentos XML. Deber utilizar el constructor new XML() para crear un objeto XML antes de llamar a los mtodos de la clase XML. Un documento XML se representa en Flash mediante la clase XML. Cada elemento del documento jerrquico se representa mediante un objeto XMLNode. Para obtener ms informacin sobre los mtodos y propiedades siguientes, consulte la clase XMLNode: appendChild(), attributes, childNodes, cloneNode(), firstChild, hasChildNodes(), insertBefore(), lastChild, nextSibling, nodeName, nodeType, nodeValue, parentNode, previousSibling, removeNode(),
toString()
En versiones anteriores de Referencia del lenguaje ActionScript de Flash, los mtodos y propiedades indicados se incluan en la clase XML. Ahora se describen en la clase XMLNode. Nota: el modelo de los objetos XML y XMLNode sigue la recomendacin W3C DOM Nivel 1: http://www.w3.org/tr/1998/REC-DOM-Level-1-19981001/level-one-core.html. Esta recomendacin especifica una interfaz de nodo y una interfaz de documento. La interfaz de documento hereda de la interfaz de nodo y aade mtodos tales como createElement() y createTextNode(). En ActionScript, los objetos XML y XMLNode estn diseados para dividir la funcionalidad en lneas similares. Disponibilidad Flash Lite 2.0 Vase tambin
appendChild (mtodo XMLNode.appendChild), attributes (propiedad XMLNode.attributes), childNodes (propiedad XMLNode.childNodes), cloneNode (mtodo XMLNode.cloneNode), firstChild (propiedad XMLNode.firstChild)hasChildNodes (mtodo XMLNode.hasChildNodes), insertBefore (mtodo XMLNode.insertBefore)lastChild (propiedad XMLNode.lastChild), nextSibling (propiedad XMLNode.nextSibling)nodeName (propiedad XMLNode.nodeName), nodeType (propiedad XMLNode.nodeType)nodeValue (propiedad XMLNode.nodeValue), parentNode (propiedad XMLNode.parentNode)previousSibling (propiedad XMLNode.previousSibling), removeNode (mtodo XMLNode.removeNode)toString (mtodo XMLNode.toString)

Modificadores Propiedad contentType:String Descripcin Contenido MIME que se enva al servidor cuando se llama al mtodo XML.send() o XML.sendAndLoad(). Especifica informacin sobre la declaracin DOCTYPE del documento XML. El valor predeterminado es false. Indica si el documento XML se ha cargado correctamente. Establece automticamente y devuelve un valor numrico que indica si un documento XML ha sido analizado correctamente en un objeto XML. Cadena que especifica informacin sobre una declaracin XML de un documento.
docTypeDecl:String
ignoreWhite:Boolean loaded:Boolean status:Number
xmlDecl:String
Propiedades heredadas de la clase XMLNode

attributes (propiedad XMLNode.attributes), childNodes (propiedad XMLNode.childNodes)firstChild (propiedad XMLNode.firstChild), lastChild (propiedad XMLNode.lastChild)nextSibling (propiedad XMLNode.nextSibling), nodeName (propiedad XMLNode.nodeName), nodeType (propiedad XMLNode.nodeType), nodeValue (propiedad XMLNode.nodeValue), parentNode (propiedad XMLNode.parentNode)previousSibling (propiedad XMLNode.previousSibling)

Resumen de eventos
Evento onData = function(src:String) {} onLoad =
function(success:Bo olean) {}
Descripcin Invocado cuando se ha descargado completamente el texto XML del servidor o cuando se produce un error mientras se est descargando el texto XML de un servidor.
Lo invoca Flash Lite Player cuando se recibe un documento XML del servidor.
Firma XML(text:String) Descripcin Crea un nuevo objeto XML.

Resumen de mtodos
Modificadores Firma addRequestHeader(head er:Object, headerValue:String) :
Void
Descripcin Aade o cambia los encabezados de peticiones HTTP (como Content-Type o SOAPAction) enviados con las acciones POST.
createElement(name:Stri ng) : XMLNode
Crea un nuevo elemento XML con el nombre especificado en el parmetro.
createTextNode(valor:S Crea un nuevo nodo de texto XML con el texto especificado. tring) : XMLNode getBytesLoaded() : Number getBytesTotal() : Number load(url:String) : Boolean Devuelve el nmero de bytes cargados (sin interrupcin) para el documento XML. Devuelve el tamao en bytes del documento XML.
Carga un documento XML de la URL especificada y sustituye el contenido del objeto XML especificado por los datos XML descargados.
: Void
parseXML(valor:String) Analiza el texto XML especificado en el parmetro value y llena el objeto XML especificado con el rbol XML resultante. send(url:String, [target:String], method:String) : Boolean sendAndLoad(url:Strin g, resultXML:XML) : Codifica el objeto XML especificado en un documento XML y lo enva a la URL especificada con el mtodo POST en un navegador.
Void
Codifica el objeto XML especificado en un documento XML, lo enva a la URL especificada empleando el mtodo POST, descarga la respuesta del servidor y la carga en el resultXMLobject especificado en los parmetros.
Mtodos heredados de la clase XMLNode

appendChild (mtodo XMLNode.appendChild), cloneNode (mtodo XMLNode.cloneNode)hasChildNodes (mtodo XMLNode.hasChildNodes), insertBefore (mtodo XMLNode.insertBefore)removeNode (mtodo XMLNode.removeNode), toString (mtodo XMLNode.toString)

addRequestHeader (mtodo XML.addRequestHeader)

public addRequestHeader(header:Object, headerValue:String) : Void
Aade o cambia los encabezados de peticiones HTTP (como Content-Type o SOAPAction) enviados con las acciones POST. En la primera sintaxis, se pasan dos cadenas (header y headerValue) al mtodo. En la segunda sintaxis, se pasa una matriz de cadenas, alternando los nombres de los encabezados y los valores de los encabezados. Si se realizan mltiples llamadas para establecer el mismo nombre de encabezado, cada valor sucesivo reemplaza al valor establecido en la llamada anterior.

No puede aadir ni cambiar los siguientes encabezados HTTP estndar con este mtodo: Accept-Ranges, Age, Allow, Allowed, Connection, Content-Length, Content-Location, Content-Range, ETag, Host, Last-Modified, Locations, Max-Forwards, Proxy-Authenticate, Proxy-Authorization, Public, Range, Retry-After, Server, TE, Trailer, Transfer-Encoding, Upgrade, URI, Vary, Via, Warning y WWW-Authenticate. Disponibilidad Flash Lite 2.0 Parmetros header:Object - Cadena que representa un nombre de encabezado de solicitud HTTP. headerValue:String - Cadena que representa el valor asociado a header. Ejemplo El ejemplo siguiente aade un encabezado HTTP personalizado denominado SOAPAction con un valor de Foo a un objeto XML con el nombre my_xml:
my_xml.addRequestHeader("SOAPAction", "'Foo'");
El ejemplo siguiente crea una matriz headers que contiene dos encabezados HTTP alternativos y sus valores asociados. La matriz se pasa como un parmetro al mtodo addRequestHeader().
var headers:Array = new Array("Content-Type", "text/plain", "X-ClientAppVersion", "2.0"); my_xml.addRequestHeader(headers);
Vase tambin
addRequestHeader (mtodo LoadVars.addRequestHeader)
contentType (propiedad XML.contentType)

public contentType : String
Contenido MIME que se enva al servidor cuando se llama al mtodo XML.send() o XML.sendAndLoad(). La configuracin predeterminada es application/x-www-form-urlencoded, que es el tipo de contenido MIME estndar empleado para la mayora de los formularios HTML. Disponibilidad Flash Lite 2.0 Ejemplo El siguiente ejemplo crea un nuevo documento XML y comprueba su tipo de contenido predeterminado:
// create a new XML document var doc:XML = new XML(); // trace the default content type trace(doc.contentType); // output: application/x-www-form-urlencoded
El ejemplo siguiente define un paquete XML y establece el tipo de contenido para el objeto XML. A continuacin se envan los datos a un servidor y se muestra un resultado en una ventana de navegador.

var my_xml:XML = new XML("<highscore><name>Ernie</name><score>13045</score> </highscore>"); my_xml.contentType = "text/xml"; my_xml.send("http://www.flash-mx.com/mm/highscore.cfm", "_blank");
Presione F12 para probar este ejemplo en un navegador. Vase tambin

send (mtodo XML.send), sendAndLoad (mtodo XML.sendAndLoad)
createElement (mtodo XML.createElement)

public createElement(name:String) : XMLNode
Crea un nuevo elemento XML con el nombre especificado en el parmetro. El nuevo elemento carece inicialmente de elemento principal, de elementos secundarios o de elementos del mismo nivel. El mtodo devuelve una referencia al objeto XML recin creado que representa al elemento. Este mtodo y XML.createTextNode() son los mtodos constructor para crear nodos para un objeto XML. Disponibilidad Flash Lite 2.0 Parmetros name:String - Nombre de etiqueta del elemento XML que se va a crear. Valor devuelto XMLNode - Objeto XMLNode; elemento XML. Ejemplo El ejemplo siguiente crea tres nodos XML utilizando el mtodo createElement():
// create an XML document var doc:XML = new XML(); // create three XML nodes using createElement() var element1:XMLNode = doc.createElement("element1"); var element2:XMLNode = doc.createElement("element2"); var element3:XMLNode = doc.createElement("element3"); // place the new nodes into the XML tree doc.appendChild(element1); element1.appendChild(element2); element1.appendChild(element3); trace(doc); // output: <element1><element2 /><element3 /></element1>
Vase tambin
createTextNode (mtodo XML.createTextNode)
createTextNode (mtodo XML.createTextNode)

public createTextNode(value:String) : XMLNode

Crea un nuevo nodo de texto XML con el texto especificado. El nuevo nodo carece inicialmente de elemento principal, de elementos secundarios o de elementos del mismo nivel. Este mtodo devuelve una referencia al objeto XML que representa al nuevo nodo de texto. Este mtodo y XML.createElement() son los mtodos constructor para crear nodos para un objeto XML. Disponibilidad Flash Lite 2.0 Parmetros valor:String - Cadena; texto utilizado para crear el nuevo nodo de texto. Valor devuelto XMLNode - Objeto XMLNode. Ejemplo El ejemplo siguiente crea dos nodos de texto XML con el mtodo createTextNode() y los coloca en los nodos XML existentes:
// create an XML document var doc:XML = new XML(); // create three XML nodes using createElement() var element1:XMLNode = doc.createElement("element1"); var element2:XMLNode = doc.createElement("element2"); var element3:XMLNode = doc.createElement("element3"); // place the new nodes into the XML tree doc.appendChild(element1); element1.appendChild(element2); element1.appendChild(element3); // create two XML text nodes using createTextNode() var textNode1:XMLNode = doc.createTextNode("textNode1 String value"); var textNode2:XMLNode = doc.createTextNode("textNode2 String value"); // place the new nodes into the XML tree element2.appendChild(textNode1); element3.appendChild(textNode2); trace(doc); // output (with line breaks added between tags): // <element1> // <element2>textNode1 String value</element2> // <element3>textNode2 String value</element3> // </element1>
Vase tambin
createElement (mtodo XML.createElement)
docTypeDecl (propiedad XML.docTypeDecl)

public docTypeDecl : String

Especifica informacin sobre la declaracin DOCTYPE del documento XML. Una vez que el texto XML se ha analizado en un objeto XML, la propiedad XML.docTypeDecl del objeto XML se define como el texto de la declaracin DOCTYPE del documento XML (por ejemplo, <!DOCTYPEgreeting SYSTEM "hello.dtd">). Esta propiedad se establece utilizando una representacin de cadena de la declaracin DOCTYPE, no un objeto de nodo XML. El analizador XML de ActionScript no es un analizador validador. El analizador lee la declaracin DOCTYPE, que se almacena en la propiedad XML.docTypeDecl, pero no se lleva a cabo ninguna validacin DTD. Si no se ha encontrado ninguna declaracin DOCTYPE durante la operacin de anlisis, la propiedad XML.docTypeDecl se establece en undefined (no definida). El mtodo XML.toString() genera el contenido de XML.docTypeDecl inmediatamente despus de la declaracin XML almacenada en XML.xmlDecl y antes que cualquier otro texto del objeto XML. Si XML.docTypeDecl tiene el valor undefined, no se genera ninguna declaracin DOCTYPE. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente utiliza la propiedad XML.docTypeDecl para establecer la declaracin DOCTYPE para un objeto XML:
my_xml.docTypeDecl = "<!DOCTYPE greeting SYSTEM \"hello.dtd\">";
Vase tambin
xmlDecl (propiedad XML.xmlDecl)
getBytesLoaded (mtodo XML.getBytesLoaded)

Devuelve el nmero de bytes cargados (sin interrupcin) para el documento XML. Puede comparar el valor de getBytesLoaded() con el valor de getBytesTotal() para determinar el porcentaje de un documento XML que se ha cargado. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Entero que indica el nmero de bytes cargados. Ejemplo El ejemplo siguiente muestra cmo utilizar el mtodo XML.getBytesLoaded() con el mtodo XML.getBytesTotal() para seguir el progreso de un comando XML.load(). Debe reemplazar el parmetro URL del comando XML.load() de modo que el parmetro se refiera a un archivo XML vlido utilizando HTTP. Si intenta utilizar este ejemplo para cargar un archivo local que se encuentre en el disco duro, este ejemplo no funcionar correctamente porque, en el modo Probar pelcula, Flash Lite Player carga los archivos locales ntegramente.

// create a new XML document var doc:XML = new XML(); var checkProgress = function(xmlObj:XML) { var bytesLoaded:Number = xmlObj.getBytesLoaded(); var bytesTotal:Number = xmlObj.getBytesTotal(); var percentLoaded:Number = Math.floor((bytesLoaded / bytesTotal ) 100); trace ("milliseconds elapsed: " + getTimer()); trace ("bytesLoaded: " + bytesLoaded); trace ("bytesTotal: " + bytesTotal); trace ("percent loaded: " + percentLoaded); trace ("---------------------------------"); } doc.onLoad = function(success:Boolean) { clearInterval(intervalID); trace("intervalID: " + intervalID); } doc.load("[place a valid URL pointing to an XML file here]"); var intervalID:Number = setInterval(checkProgress, 100, doc);
Vase tambin
getBytesTotal (mtodo XML.getBytesTotal)
getBytesTotal (mtodo XML.getBytesTotal)

Devuelve el tamao en bytes del documento XML. Disponibilidad Flash Lite 2.0 Valor devuelto Number - Un entero. Ejemplo Consulte el ejemplo de XML.getBytesLoaded(). Vase tambin
getBytesLoaded (mtodo XML.getBytesLoaded)
ignoreWhite (propiedad XML.ignoreWhite)

public ignoreWhite : Boolean
El valor predeterminado es false. Cuando se establece con el valor true, los nodos de texto que contienen slo espacio en blanco se descartan durante el proceso de anlisis. Los nodos de texto con espacio en blanco al principio o al final no se ven afectados. Sintaxis 1: Puede establecer la propiedad ignoreWhite para objetos XML individuales, como se muestra en el siguiente cdigo:
my_xml.ignoreWhite = true;

Sintaxis 2: Puede establecer la propiedad ignoreWhite predeterminada para objetos XML, como se muestra en el siguiente cdigo:
XML.prototype.ignoreWhite = true;
Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente carga un archivo XML con un nodo de texto que contiene solamente espacio blanco; la etiqueta foyer incluye catorce espacios. Para ejecutar este ejemplo, cree un archivo de texto llamado flooring.xml y copie en l las siguientes etiquetas:
<house> <kitchen> ceramic tile </kitchen> <bathroom>linoleum</bathroom> <foyer> </foyer> </house>
Cree un nuevo documento Flash con el nombre flooring.fla y gurdelo en el mismo directorio que el archivo XML. Site el siguiente cdigo en la lnea de tiempo principal:
// create a new XML object var flooring:XML = new XML(); // set the ignoreWhite property to true (default value is false) flooring.ignoreWhite = true; // After loading is complete, trace the XML object flooring.onLoad = function(success:Boolean) { trace(flooring); } // load the XML into the flooring object flooring.load("flooring.xml"); // output (line breaks added for clarity): <house> <kitchen> ceramic tile </kitchen> <bathroom>linoleum</bathroom> <foyer /> </house>
Si cambia la definicin de flooring.ignoreWhite a false, o simplemente elimina esa lnea de texto, se conservan los catorce espacios de la etiqueta foyer:

... // set the ignoreWhite property to false (default value) flooring.ignoreWhite = false; ... // output (line breaks added for clarity): <house> <kitchen> ceramic tile </kitchen> <bathroom>linoleum</bathroom> <foyer> </foyer> </house>
Tambin hay un ejemplo en los archivos XML_blogTracker.fla y XML_languagePicker.fla de la carpeta de ejemplos de ActionScript de www.adobe.com/go/learn_fl_samples. Descargue y descomprima el archivo .zip y acceda a la carpeta de su versin de ActionScript para poder ver el ejemplo.
load (mtodo XML.load)

public load(url:String) : Boolean
Carga un documento XML de la URL especificada y sustituye el contenido del objeto XML especificado por los datos XML descargados. La URL es relativa y se llama a ella mediante HTTP. El proceso de carga es asncrono; no finaliza inmediatamente despus de que se ejecute el mtodo load(). En archivos SWF que se ejecuten en una versin del reproductor anterior a Flash Player 7, el parmetro url debe estar en el mismo superdominio que el archivo SWF que emite esta llamada. El superdominio puede obtenerse eliminando el componente situado ms a la izquierda de la URL de un archivo. Por ejemplo, un archivo SWF situado en www.someDomain.com puede cargar datos de fuentes situadas en store.someDomain.com porque ambos archivos se encuentran en el mismo superdominio, denominado someDomain.com. En archivos SWF de cualquier versin que se ejecuten en Flash Player 7 y posterior, url debe estar exactamente en el mismo dominio. 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. Cuando se ejecuta el mtodo load(), la propiedad loaded del objeto XML se establece con el valor false. Cuando terminan de descargarse los datos XML, la propiedad loaded se establece con el valor true y se invoca el controlador de eventos onLoad. Los datos XML no se analizan hasta que terminan de descargarse. Si el objeto XML contena anteriormente rboles XML, estos se descartarn. Puede definir una funcin personalizada que se ejecute cuando se invoque el controlador de eventos onLoad del objeto XML. Disponibilidad Flash Lite 2.0 Parmetros url:String - Cadena que representa la URL donde se encuentra el documento XML que se va a cargar. 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. Valor devuelto Boolean - false si no se pasa ningn parmetro (null); true, en caso contrario. Utilice el controlador de eventos onLoad() para comprobar el estado de un documento XML cargado.

Ejemplo En el ejemplo siguiente se utiliza el mtodo XML.load():

// create a new XML object var flooring:XML = new XML(); // set the ignoreWhite property to true (default value is false) flooring.ignoreWhite = true; // After loading is complete, trace the XML object flooring.onLoad = function(success) { trace(flooring); }; // load the XML into the flooring object flooring.load("flooring.xml");
Para ver el contenido del archivo flooring.xml y la salida que produce, vase el ejemplo de XML.ignoreWhite. Vase tambin
ignoreWhite (propiedad XML.ignoreWhite), loaded (propiedad XML.loaded), onLoad (controlador XML.onLoad)
loaded (propiedad XML.loaded)

public loaded : Boolean
Indica si el documento XML se ha cargado correctamente. Si no hay ningn controlador de eventos onLoad() personalizado definido para el objeto XML, esta propiedad se establece con el valor true cuando el proceso de carga de documento iniciado por la llamada a XML.load() ha finalizado completamente; en caso contrario, el valor es false. No obstante, si define un comportamiento personalizado para el controlador de eventos onLoad() para el objeto XML, asegrese de que establece onload en dicha funcin. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente utiliza la propiedad XML.loaded en un guin simple:
var my_xml:XML = new XML(); my_xml.ignoreWhite = true; my_xml.onLoad = function(success:Boolean) { trace("success: "+success); trace("loaded: "+my_xml.loaded); trace("status: "+my_xml.status); }; my_xml.load("http://www.flash-mx.com/mm/problems/products.xml");
Cuando se invoca el controlador onLoad aparece informacin en el panel Salida. Si la llamada se realiza correctamente, aparece true como estado loaded en el panel Salida.
success: true loaded: true status: 0

Vase tambin
load (mtodo XML.load), onLoad (controlador XML.onLoad)
onData (controlador XML.onData)

Invocado cuando se ha descargado completamente el texto XML del servidor o cuando se produce un error mientras se est descargando el texto XML de un servidor. Este controlador se invoca antes de analizar el XML y puede utilizarse para llamar a una rutina de anlisis personalizada en lugar de utilizar el analizador XML de Flash. El parmetro src es una cadena que contiene texto XML descargado del servidor, a no ser que se produzca un error durante la descarga, en cuyo caso el parmetro src no estar definido (undefined). De forma predeterminada, el controlador de eventos XML.onData llama a XML.onLoad. Puede sustituir el controlador de eventos XML.onData con comportamiento personalizado, pero no se llama a XML.onLoad a menos que lo haga en su implementacin de XML.onData. Disponibilidad Flash Lite 2.0 Parmetros src:String - Cadena o undefined; los datos, normalmente en formato XML, que enva el servidor. Ejemplo El ejemplo siguiente muestra el aspecto predeterminado del controlador de eventos XML.onData:
XML.prototype.onData = function (src:String) { if (src == undefined) { this.onLoad(false); } else { this.parseXML(src); this.loaded = true; this.onLoad(true); } }
Puede sustituir el controlador de eventos XML.onData para interceptar el texto XML sin analizarlo. Vase tambin
onLoad (controlador XML.onLoad)
onLoad (controlador XML.onLoad)

Lo invoca Flash Lite Player cuando se recibe un documento XML del servidor. Si se recibe correctamente el documento XML, el parmetro success tiene el valor true. Si no se ha recibido el documento o si se ha producido un error al recibir la respuesta del servidor, el parmetro success tiene el valor false. En la implementacin predeterminada, este mtodo est desactivado. Para sustituir la implementacin predeterminada, debe asignar una funcin que contenga acciones personalizadas. Disponibilidad Flash Lite 2.0

Parmetros success:Boolean - Un valor booleano que es true si el objeto XML se ha cargado correctamente con una operacin XML.load() o XML.sendAndLoad(); en caso contrario, es false. Ejemplo El ejemplo siguiente incluye cdigo ActionScript para una aplicacin de comercio electrnico sencilla. El mtodo sendAndLoad() transmite un elemento XML que contiene el nombre de usuario y la contrasea, y utiliza un controlador XML.onLoad para procesar la respuesta del servidor.
var login_str:String = "<login username=\""+username_txt.text+"\" password=\""+password_txt.text+"\" />"; var my_xml:XML = new XML(login_str); var myLoginReply_xml:XML = new XML(); myLoginReply_xml.ignoreWhite = true; myLoginReply_xml.onLoad = function(success:Boolean){ if (success) { if ((myLoginReply_xml.firstChild.nodeName == "packet") && (myLoginReply_xml.firstChild.attributes.success == "true")) { gotoAndStop("loggedIn"); } else { gotoAndStop("loginFailed"); } } else { gotoAndStop("connectionFailed"); } }; my_xml.sendAndLoad("http://www.flash-mx.com/mm/login_xml.cfm", myLoginReply_xml);
Vase tambin
load (mtodo XML.load), sendAndLoad (mtodo XML.sendAndLoad)
parseXML (mtodo XML.parseXML)

public parseXML(value:String) : Void
Analiza el texto XML especificado en el parmetro value y llena el objeto XML especificado con el rbol XML resultante. Se descartarn los rboles existentes del objeto XML. Disponibilidad Flash Lite 2.0 Parmetros valor:String - Cadena que representa el texto XML que se va a analizar y pasar al objeto XML especificado. Ejemplo El ejemplo siguiente crea y analiza un objeto XML:

var xml_str:String = "<state name=\"California\"> <city>San Francisco</city></state>" // defining the XML source within the XML constructor: var my1_xml:XML = new XML(xml_str); trace(my1_xml.firstChild.attributes.name); // output: California // defining the XML source using the XML.parseXML method: var my2_xml:XML = new XML(); my2_xml.parseXML(xml_str); trace(my2_xml.firstChild.attributes.name); // output: California
send (mtodo XML.send)

public send(url:String, [target:String], method:String) : Boolean
Codifica el objeto XML especificado en un documento XML y lo enva a la URL especificada con el mtodo POST en un navegador. El entorno de prueba de Flash slo utiliza el mtodo GET. Disponibilidad Flash Lite 2.0 Parmetros url:String - Cadena; URL de destino del objeto XML especificado. target:String [opcional] - Cadena; ventana del navegador para mostrar los datos que devuelve el servidor:
_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.
Si no especifica un parmetro window, es igual que si especifica _self. method:String [opcional] - el mtodo del protocolo HTTP utilizado: GET o POST. En un navegador, el valor predeterminado es POST. En el entorno de prueba de Flash, el valor predeterminado es GET. Valor devuelto Boolean - false si no se especifica ningn parmetro, en los dems casos, true Ejemplo El ejemplo siguiente define un paquete XML y establece el tipo de contenido para el objeto XML. A continuacin se envan los datos a un servidor y se muestra un resultado en una ventana de navegador.
var my_xml:XML = new XML("<highscore><name>Ernie</name> <score>13045</score></highscore>"); my_xml.contentType = "text/xml"; my_xml.send("http://www.flash-mx.com/mm/highscore.cfm", "_blank");
Presione F12 para probar este ejemplo en un navegador. Vase tambin

sendAndLoad (mtodo XML.sendAndLoad)

sendAndLoad (mtodo XML.sendAndLoad)

public sendAndLoad(url:String, resultXML:XML) : Void
Codifica el objeto XML especificado en un documento XML, lo enva a la URL especificada empleando el mtodo POST, descarga la respuesta del servidor y la carga en el resultXMLobject especificado en los parmetros. La respuesta del servidor se carga de la misma forma empleada por el mtodo XML.load(). En archivos SWF que se ejecuten en una versin del reproductor anterior a Flash Player 7, el parmetro url debe estar en el mismo superdominio que el archivo SWF que emite esta llamada. El superdominio puede obtenerse eliminando el componente situado ms a la izquierda de la URL de un archivo. Por ejemplo, un archivo SWF situado en www.someDomain.com puede cargar datos de fuentes situadas en store.someDomain.com porque ambos archivos se encuentran en el mismo superdominio, denominado someDomain.com. En archivos SWF de cualquier versin que se ejecuten en Flash Player 7 y posterior, url debe estar exactamente en el mismo dominio. 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. Cuando se ejecuta sendAndLoad(), la propiedad loaded del objeto XML se establece con el valor false. Cuando terminan de descargarse los datos XML, la propiedad loaded se establece con el valor true, si se han cargado correctamente los datos, y se invoca el controlador de eventos onLoad. Los datos XML no se analizan hasta que terminan de descargarse. Si el objeto XML contena anteriormente rboles XML, estos se descartarn. Disponibilidad Flash Lite 2.0 Parmetros url:String - Cadena; URL de destino del objeto XML especificado. 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. resultXML:XML - Objeto XML de destino creado con el mtodo constructor XML que recibir la informacin devuelta del servidor. Ejemplo El ejemplo siguiente incluye cdigo ActionScript para una aplicacin de comercio electrnico sencilla. El mtodo XML.sendAndLoad() transmite un elemento XML que contiene el nombre de usuario y la contrasea, y utiliza un controlador onLoad para procesar la respuesta del servidor.

var login_str:String = "<login username=\""+username_txt.text+"\" password=\""+password_txt.text+"\" />"; var my_xml:XML = new XML(login_str); var myLoginReply_xml:XML = new XML(); myLoginReply_xml.ignoreWhite = true; myLoginReply_xml.onLoad = myOnLoad; my_xml.sendAndLoad("http://www.flash-mx.com/mm/login_xml.cfm", myLoginReply_xml); function myOnLoad(success:Boolean) { if (success) { if ((myLoginReply_xml.firstChild.nodeName == "packet") && (myLoginReply_xml.firstChild.attributes.success == "true")) { gotoAndStop("loggedIn"); } else { gotoAndStop("loginFailed"); } } else { gotoAndStop("connectionFailed"); } }
Vase tambin
send (mtodo XML.send), load (mtodo XML.load), loaded (propiedad XML.loaded), onLoad (controlador XML.onLoad)
status (propiedad XML.status)

public status : Number
Establece automticamente y devuelve un valor numrico que indica si un documento XML ha sido analizado correctamente en un objeto XML. A continuacin se indican los cdigos de estado numricos con las correspondientes descripciones:
0 No se ha producido ningn error; el anlisis ha finalizado correctamente. -2 Una seccin CDATA (datos de caracteres) no se ha terminado correctamente. -3 La declaracin XML no se ha terminado correctamente. -4 La declaracin DOCTYPE no se ha terminado correctamente. -5 Un comentario no se ha terminado correctamente. -6 Un elemento XML no tiene la forma correcta. -7 Memoria insuficiente. -8 El valor de un atributo no se ha terminado correctamente. -9 Una etiqueta start carece de la correspondiente etiqueta end. -10 Se ha encontrado una etiqueta end sin que exista una etiqueta start.
Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente carga un paquete XML en un archivo SWF. Aparece un mensaje de estado, que indica si el XML se carga y analiza correctamente. Aada el siguiente cdigo ActionScript al archivo FLA o AS:

var my_xml:XML = new XML(); my_xml.onLoad = function(success:Boolean) { if (success) { if (my_xml.status == 0) { trace("XML was loaded and parsed successfully"); } else { trace("XML was loaded successfully, but was unable to be parsed."); } var errorMessage:String; switch (my_xml.status) { case 0 : errorMessage = "No error; parse was completed successfully."; break; case -2 : errorMessage = "A CDATA section was not properly terminated."; break; case -3 : errorMessage = "The XML declaration was not properly terminated."; break; case -4 : errorMessage = "The DOCTYPE declaration was not properly terminated."; break; case -5 : errorMessage = "A comment was not properly terminated."; break; case -6 : errorMessage = "An XML element was malformed."; break; case -7 : errorMessage = "Out of memory."; break; case -8 : errorMessage = "An attribute value was not properly terminated."; break; case -9 : errorMessage = "A start-tag was not matched with an end-tag."; break; case -10 : errorMessage = "An end-tag was encountered without a matching start-tag."; break; default : errorMessage = "An unknown error has occurred."; break; } trace("status: "+my_xml.status+" ("+errorMessage+")"); } else { trace("Unable to load/parse XML. (status: "+my_xml.status+")"); } }; my_xml.load("http://www.helpexamples.com/flash/badxml.xml");
XML, constructor
public XML(text:String)

Crea un nuevo objeto XML. Deber utilizar el constructor para crear un objeto XML antes de llamar a cualquiera de los mtodos de la clase XML. Nota: utilice los mtodos createElement() y createTextNode() para aadir elementos y nodos de texto a un rbol de documentos XML. Disponibilidad Flash Lite 2.0 Parmetros text:String - Cadena; texto XML analizado para crear el nuevo objeto XML. Ejemplo El ejemplo siguiente crea un nuevo objeto XML vaco:
var my_xml:XML = new XML();
El ejemplo siguiente crea un objeto XML analizando el texto XML especificado en el parmetro source y llena el objeto XML creado con el rbol de documentos XML resultante:
var other_xml:XML = new XML("<state name=\"California\"><city>San Francisco</city></state>");
Vase tambin
createElement (mtodo XML.createElement), createTextNode (mtodo XML.createTextNode)
xmlDecl (propiedad XML.xmlDecl)

public xmlDecl : String
Cadena que especifica informacin sobre una declaracin XML de un documento. Una vez que el documento XML se ha analizado e incorporado a un objeto XML, esta propiedad se establece con el texto de la declaracin XML del documento. Esta propiedad se establece utilizando una representacin de cadena de la declaracin XML, no un objeto de nodo XML. Si no se ha encontrado ninguna declaracin XML durante la operacin de anlisis, la propiedad se establece con el valor undefined.XML. El mtodo XML.toString() devuelve el contenido de la propiedad XML.xmlDecl antes que ningn otro texto del objeto XML. Si la propiedad XML.xmlDecl contiene el tipo undefined, no se proporciona ninguna declaracin XML. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un campo de texto con el nombre my_txt con las mismas dimensiones que el escenario. El campo de texto muestra las propiedades del paquete XML que se carga en el archivo SWF. Aparece la declaracin docType en my_txt. Aada el siguiente cdigo ActionScript al archivo FLA o AS:

var my_fmt:TextFormat = new TextFormat(); my_fmt.font = "_typewriter"; my_fmt.size = 12; my_fmt.leftMargin = 10; this.createTextField("my_txt", this.getNextHighestDepth(), 0, 0, Stage.width, Stage.height); my_txt.border = true; my_txt.multiline = true; my_txt.wordWrap = true; my_txt.setNewTextFormat(my_fmt); var my_xml:XML = new XML(); my_xml.ignoreWhite = true; my_xml.onLoad = function(success:Boolean) { var endTime:Number = getTimer(); var elapsedTime:Number = endTime-startTime; if (success) { my_txt.text = "xmlDecl:"+newline+my_xml.xmlDecl+newline+newline; my_txt.text += "contentType:"+newline+my_xml.contentType+newline+newline; my_txt.text += "docTypeDecl:"+newline+my_xml.docTypeDecl+newline+newline; my_txt.text += "packet:"+newline+my_xml.toString()+newline+newline; } else { my_txt.text = "Unable to load remote XML."+newline+newline; } my_txt.text += "loaded in: "+elapsedTime+" ms."; }; my_xml.load("http://www.helpexamples.com/crossdomain.xml"); var startTime:Number = getTimer();
Vase tambin
docTypeDecl (propiedad XML.docTypeDecl)
XMLNode
Object | +-XMLNode public class XMLNode extends Object
Un documento XML se representa en Flash mediante la clase XML. Cada elemento del documento jerrquico se representa mediante un objeto XMLNode. Disponibilidad Flash Lite 2.0 Vase tambin
hasXMLSocket (propiedad capabilities.hasXMLSocket)

Modificadores Propiedad que faltan:Object Descripcin Objeto que contiene todos los atributos de la instancia XML especificada. Matriz de los elementos secundarios del objeto XML especificado. Evala el objeto XML especificado y hace referencia al primer elemento secundario de la lista de elementos secundarios del nodo principal. Valor XMLNode que hace referencia al ltimo elemento secundario de la lista de elementos secundarios del nodo. Valor XMLNode que hace referencia al siguiente elemento secundario de la lista de elementos secundarios del nodo principal. Cadena que representa el nombre del nodo del objeto XML. Valor de nodeType, que puede ser 1 para un elemento XML o 3 para un nodo de texto. Valor de nodo del objeto XML. Valor de XMLNode que hace referencia al nodo principal del objeto XML especificado o devuelve null si el nodo no tiene elemento principal.
childNodes:Array [slo lectura] firstChild:XMLNode [slo lectura]
lastChild:XMLNode [slo lectura] nextSibling:XMLNode [slo lectura]
nodeName:String nodeType:Number [slo lectura] nodeValue:String parentNode:XMLNode [slo lectura]
previousSibling:XMLNode Valor XMLNode que hace referencia al elemento secundario [slo lectura] anterior de la lista de elementos secundarios del nodo principal.

Resumen de mtodos
appendChild(newChild: Aade el nodo especificado a la lista secundaria del objeto XMLNode) : Void XML. cloneNode(deep:Boolea n) : XMLNode hasChildNodes() : Boolean Construye y devuelve un nuevo nodo XML del mismo tipo, nombre, valor y atributos que el objeto XML especificado. Especifica si el objeto XML tiene nodos secundarios.

Modificadores
Firma insertBefore(newChild: XMLNode, insertPoint:XMLNode

) : Void
Descripcin Inserta un nodo newChild en la lista de secundarios del objeto XML, delante del nodo insertPoint.
removeNode() : Void toString() : String
Quita el objeto XML especificado de su elemento principal. Evala el objeto XML especificado, construye una representacin textual de la estructura XML, incluidos el nodo, los elementos secundarios y los atributos, y devuelve el resultado como una cadena.

appendChild (mtodo XMLNode.appendChild)

public appendChild(newChild:XMLNode) : Void
Aade el nodo especificado a la lista secundaria del objeto XML. Este mtodo opera directamente en el nodo al que hace referencia el parmetro childNode; no aade una copia del nodo. Si el nodo que se va a aadir ya existe en otra estructura de rbol, la adicin del nodo a la nueva ubicacin lo eliminar de su ubicacin actual. Si el parmetro childNode hace referencia a un nodo que ya existe en otra estructura de rbol XML, el nodo secundario aadido se sita en la nueva estructura de rbol tras eliminarlo de su nodo principal actual. Disponibilidad Flash Lite 2.0 Parmetros newChild:XMLNode - Un objeto XMLNode que representa el nodo que se va a mover de su ubicacin actual a la lista de elementos secundarios del objeto my_xml. Ejemplo Este ejemplo hace lo que se detalla a continuacin, en el orden indicado:
Crea dos documentos XML vacos: doc1 y doc2. Crea un nuevo nodo mediante el mtodo createElement() y lo anexa, con el mtodo appendChild(), al
documento XML doc1.
Muestra cmo mover un nodo mediante el mtodo appendChild(), moviendo el nodo raz desde doc1 a doc2. Copia el nodo raz de doc2 y lo anexa a doc1. Crea un nuevo nodo y lo anexa al nodo raz del documento XML doc1.

var doc1:XML = new XML(); var doc2:XML = new XML(); // create a root node and add it to doc1 var rootnode:XMLNode = doc1.createElement("root"); doc1.appendChild(rootnode); trace ("doc1: " + doc1); // output: doc1: <root /> trace ("doc2: " + doc2); // output: doc2: // move the root node to doc2 doc2.appendChild(rootnode); trace ("doc1: " + doc1); // output: doc1: trace ("doc2: " + doc2); // output: doc2: <root /> // clone the root node and append it to doc1 var clone:XMLNode = doc2.firstChild.cloneNode(true); doc1.appendChild(clone); trace ("doc1: " + doc1); // output: doc1: <root /> trace ("doc2: " + doc2); // output: doc2: <root /> // create a new node to append to root node (named clone) of doc1 var newNode:XMLNode = doc1.createElement("newbie"); clone.appendChild(newNode); trace ("doc1: " + doc1); // output: doc1: <root><newbie /></root>
attributes (propiedad XMLNode.attributes)

public attributes : Object
Objeto que contiene todos los atributos de la instancia XML especificada. El objeto XML.attributes contiene una variable para cada atributo de la instancia XML. Dado que estas variables se definen como parte del objeto, normalmente se hace referencia a ellas como propiedades del objeto. El valor de cada atributo se almacena en la correspondiente propiedad como una cadena. Por ejemplo, si tiene un atributo denominado color, podr recuperar el valor del atributo especificando color como nombre de propiedad, como se muestra en el siguiente cdigo:
var myColor:String = doc.firstChild.attributes.color
Disponibilidad Flash Lite 2.0 Ejemplo El siguiente ejemplo muestra los nombres de atributos XML:

// create a tag called 'mytag' with // an attribute called 'name' with value 'Val' var doc:XML = new XML("<mytag name=\"Val\"> item </mytag>"); // assign the value of the 'name' attribute to variable y var y:String = doc.firstChild.attributes.name; trace (y); // output: Val // create a new attribute named 'order' with value 'first' doc.firstChild.attributes.order = "first"; // assign the value of the 'order' attribute to variable z var z:String = doc.firstChild.attributes.order trace(z); // output: first
El panel Salida muestra esta informacin:

Val first
childNodes (propiedad XMLNode.childNodes)

public childNodes : Array [read-only]
Matriz de los elementos secundarios del objeto XML especificado. Cada elemento de la matriz es una referencia a un objeto XML que representa un nodo secundario. Esta es una propiedad de slo lectura que no puede utilizarse para manipular nodos secundarios. Utilice los mtodos appendChild(), insertBefore() y removeNode() para manipular nodos secundarios. Esta propiedad no est definida para los nodos de texto (nodeType == 3). Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente muestra cmo utilizar la propiedad XML.childNodes para devolver una matriz de nodos secundarios:

// create a new XML document var doc:XML = new XML(); // create a root node var rootNode:XMLNode = doc.createElement("rootNode"); // create three child nodes var oldest:XMLNode = doc.createElement("oldest"); var middle:XMLNode = doc.createElement("middle"); var youngest:XMLNode = doc.createElement("youngest"); // add the rootNode as the root of the XML document tree doc.appendChild(rootNode); // add each of the child nodes as children of rootNode rootNode.appendChild(oldest); rootNode.appendChild(middle); rootNode.appendChild(youngest); // create an array and use rootNode to populate it var firstArray:Array = doc.childNodes; trace (firstArray); // output: <rootNode><oldest /><middle /><youngest /></rootNode> // create another array and use the child nodes to populate it var secondArray:Array = rootNode.childNodes; trace(secondArray); // output: <oldest />,<middle />,<youngest />
Vase tambin
nodeType (propiedad XMLNode.nodeType), appendChild (mtodo XMLNode.appendChild), insertBefore (mtodo XMLNode.insertBefore)removeNode (mtodo XMLNode.removeNode)
cloneNode (mtodo XMLNode.cloneNode)

public cloneNode(deep:Boolean) : XMLNode
Construye y devuelve un nuevo nodo XML del mismo tipo, nombre, valor y atributos que el objeto XML especificado. Si deep se define como true, todos los elementos secundarios se clonan sucesivamente, lo que da como resultado una copia exacta del rbol de documentos del objeto original. El clon del nodo que se devuelve ya no est asociado al rbol del elemento clonado. En consecuencia, nextSibling, parentNode y previousSibling tendrn el valor null. Si el parmetro deep se define como false, o el nodo my_xml no tiene nodos secundarios, firstChild y lastChild tambin son null. Disponibilidad Flash Lite 2.0 Parmetros deep:Boolean - Un valor booleano; si es true, los elementos secundarios del objeto XML especificado se clonarn sucesivamente. Valor devuelto XMLNode - Objeto XMLNode.

Ejemplo El ejemplo siguiente muestra cmo utilizar el mtodo XML.cloneNode() para crear una copia de un nodo:
// create a new XML document var doc:XML = new XML(); // create a root node var rootNode:XMLNode = doc.createElement("rootNode"); // create three child nodes var oldest:XMLNode = doc.createElement("oldest"); var middle:XMLNode = doc.createElement("middle"); var youngest:XMLNode = doc.createElement("youngest"); // add the rootNode as the root of the XML document tree doc.appendChild(rootNode); // add each of the child nodes as children of rootNode rootNode.appendChild(oldest); rootNode.appendChild(middle); rootNode.appendChild(youngest); // create a copy of the middle node using cloneNode() var middle2:XMLNode = middle.cloneNode(false); // insert the clone node into rootNode between the middle and youngest nodes rootNode.insertBefore(middle2, youngest); trace(rootNode); // output (with line breaks added): // <rootNode> // <oldest /> // <middle /> // <middle /> // <youngest /> // </rootNode> // create a copy of rootNode using cloneNode() to demonstrate a deep copy var rootClone:XMLNode = rootNode.cloneNode(true); // insert the clone, which contains all child nodes, to rootNode rootNode.appendChild(rootClone); trace(rootNode); // output (with line breaks added): // <rootNode> // <oldest /> // <middle /> // <middle /> // <youngest /> // <rootNode> // <oldest /> // <middle /> // <middle /> // <youngest /> // </rootNode> // </rootNode>

firstChild (propiedad XMLNode.firstChild)

public firstChild : XMLNode [read-only]
Evala el objeto XML especificado y hace referencia al primer elemento secundario de la lista de elementos secundarios del nodo principal. Esta propiedad tiene el valor null si el nodo no tiene elementos secundarios. Esta propiedad tiene el valor undefined si el nodo es un nodo de texto. Esta es una propiedad de slo lectura que no puede utilizarse para manipular nodos secundarios; utilice los mtodos appendChild(), insertBefore() y removeNode() para manipular nodos secundarios. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente muestra cmo utilizar XML.firstChild para recorrer los nodos secundarios de un nodo:
// create a new XML document var doc:XML = new XML(); // create a root node var rootNode:XMLNode = doc.createElement("rootNode"); // create three child nodes var oldest:XMLNode = doc.createElement("oldest"); var middle:XMLNode = doc.createElement("middle"); var youngest:XMLNode = doc.createElement("youngest"); // add the rootNode as the root of the XML document tree doc.appendChild(rootNode); // add each of the child nodes as children of rootNode rootNode.appendChild(oldest); rootNode.appendChild(middle); rootNode.appendChild(youngest); // use firstChild to iterate through the child nodes of rootNode for (var aNode:XMLNode = rootNode.firstChild; aNode != null; aNode = aNode.nextSibling) { trace(aNode); } // // // // output: <oldest /> <middle /> <youngest />
El ejemplo siguiente procede del archivo XML_languagePicker.fla del directorio Examples y se puede encontrar en la definicin de funcin de controlador de eventos languageXML.onLoad:
// loop through the strings in each language node // adding each string as a new element in the language array for (var stringNode:XMLNode = childNode.firstChild; stringNode != null; stringNode = stringNode.nextSibling, j++) { masterArray[i][j] = stringNode.firstChild.nodeValue; }

Para ver el guin completo, consulte XML_languagePicker.fla de la carpeta de ejemplos de ActionScript de www.adobe.com/go/learn_fl_samples. Descargue y descomprima el archivo .zip y acceda a la carpeta de su versin de ActionScript para poder ver el ejemplo. Vase tambin
appendChild (mtodo XMLNode.appendChild), insertBefore (mtodo XMLNode.insertBefore), removeNode (mtodo XMLNode.removeNode)
hasChildNodes (mtodo XMLNode.hasChildNodes)

public hasChildNodes() : Boolean
Especifica si el objeto XML tiene nodos secundarios. Disponibilidad Flash Lite 2.0 Valor devuelto Boolean - true si el objeto XMLNode especificado tiene uno o varios nodos secundarios; en caso contrario devuelve false. Ejemplo El ejemplo siguiente crea un nuevo paquete XML. Si el nodo raz tiene nodos secundarios, el cdigo se ejecuta en bucle por todos los nodos secundarios para mostrar el nombre y el valor de cada nodo. Aada el siguiente cdigo ActionScript al archivo FLA o AS:
var my_xml:XML = new XML("hankrudolph"); if (my_xml.firstChild.hasChildNodes()) { // use firstChild to iterate through the child nodes of rootNode for (var aNode:XMLNode = my_xml.firstChild.firstChild; aNode != null; aNode=aNode.nextSibling) { if (aNode.nodeType == 1) { trace(aNode.nodeName+":\t"+aNode.firstChild.nodeValue); } } }
El panel Salida muestra esta informacin:

output: username: hank password: rudolph
insertBefore (mtodo XMLNode.insertBefore)

public insertBefore(newChild:XMLNode, insertPoint:XMLNode) : Void
Inserta un nodo newChild en la lista de secundarios del objeto XML, delante del nodo insertPoint. Si insertPointno es un elemento secundario del objeto XMLNode, se produce un error al insertar. Disponibilidad Flash Lite 2.0

Parmetros newChild:XMLNode - Objeto XMLNode que se va a insertar. insertPoint:XMLNode - Objeto XMLNode que seguir al nodo newChild cuando se invoque el mtodo. Ejemplo El ejemplo siguiente inserta un nuevo nodo XML entre los dos nodos existentes:
var my_xml:XML = new XML("<a>1</a>\n<c>3</c>"); var insertPoint:XMLNode = my_xml.lastChild; var newNode:XML = new XML("2\n"); my_xml.insertBefore(newNode, insertPoint); trace(my_xml);
Vase tambin
hasXMLSocket (propiedad capabilities.hasXMLSocket), cloneNode (mtodo XMLNode.cloneNode)
lastChild (propiedad XMLNode.lastChild)

public lastChild : XMLNode [read-only]
Valor XMLNode que hace referencia al ltimo elemento secundario de la lista de elementos secundarios del nodo. La propiedad XML.lastChild tiene el valor null si el nodo no tiene elementos secundarios. Esta propiedad no puede utilizarse para manipular nodos secundarios; utilice los mtodos appendChild(), insertBefore() y removeNode() para manipular nodos secundarios. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente utiliza la propiedad XML.lastChild para repetir por los nodos secundarios de un nodo XML, empezando por el ltimo elemento de la lista de elementos secundarios del nodo y terminando por el primer elemento secundario de la lista:

// create a new XML document var doc:XML = new XML(); // create a root node var rootNode:XMLNode = doc.createElement("rootNode"); // create three child nodes var oldest:XMLNode = doc.createElement("oldest"); var middle:XMLNode = doc.createElement("middle"); var youngest:XMLNode = doc.createElement("youngest"); // add the rootNode as the root of the XML document tree doc.appendChild(rootNode); // add each of the child nodes as children of rootNode rootNode.appendChild(oldest); rootNode.appendChild(middle); rootNode.appendChild(youngest); // use lastChild to iterate through the child nodes of rootNode for (var aNode:XMLNode = rootNode.lastChild; aNode != null; aNode = aNode.previousSibling) { trace(aNode); } // // // // output: <youngest /> <middle /> <oldest />
El ejemplo siguiente crea un nuevo paquete XML y utiliza la propiedad XML.lastChild para repetir por los nodos secundarios del nodo raz:
// create a new XML document var doc:XML = new XML(""); var rootNode:XMLNode = doc.firstChild; // use lastChild to iterate through the child nodes of rootNode for (var aNode:XMLNode = rootNode.lastChild; aNode != null; aNode=aNode.previousSibling) { trace(aNode); } // // // // output: <youngest /> <middle /> <oldest />
Vase tambin
appendChild (mtodo XMLNode.appendChild), insertBefore (mtodo XMLNode.insertBefore), removeNode (mtodo XMLNode.removeNode), hasXMLSocket (propiedad capabilities.hasXMLSocket)
nextSibling (propiedad XMLNode.nextSibling)

public nextSibling : XMLNode [read-only]

Valor XMLNode que hace referencia al siguiente elemento secundario de la lista de elementos secundarios del nodo principal. Esta propiedad tiene el valor null si el nodo no tiene otro nodo del mismo nivel. Esta propiedad no puede utilizarse para manipular nodos secundarios; utilice los mtodos appendChild(), insertBefore() y removeNode() para manipular nodos secundarios. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente es un extracto del ejemplo de la propiedad XML.firstChild y muestra cmo se puede utilizar la propiedad XML.nextSibling para reproducirse indefinidamente por los nodos secundarios de un nodo XML:
for (var aNode:XMLNode = rootNode.firstChild; aNode != null; aNode = aNode.nextSibling) { trace(aNode); }
Vase tambin
firstChild (propiedad XMLNode.firstChild), appendChild (mtodo XMLNode.appendChild), insertBefore (mtodo XMLNode.insertBefore), removeNode (mtodo XMLNode.removeNode), hasXMLSocket (propiedad capabilities.hasXMLSocket)
nodeName (propiedad XMLNode.nodeName)

public nodeName : String
Cadena que representa el nombre del nodo del objeto XML. Si el objeto XML es un elemento XML (nodeType == 1), nodeName es el nombre de la etiqueta que representa al nodo del archivo XML. Por ejemplo, TITLE es el nombre del nodo (nodeName) de una etiqueta HTML TITLE. Si el objeto XML es un nodo de texto (nodeType == 3), nodeName tiene el valor null. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un nodo de elemento y un nodo de texto, y comprueba el nombre de cada uno:

// create an XML document var doc:XML = new XML(); // create an XML node using createElement() var myNode:XMLNode = doc.createElement("rootNode"); // place the new node into the XML tree doc.appendChild(myNode); // create an XML text node using createTextNode() var myTextNode:XMLNode = doc.createTextNode("textNode"); // place the new node into the XML tree myNode.appendChild(myTextNode); trace(myNode.nodeName); trace(myTextNode.nodeName); // output: // rootNode // null
El ejemplo siguiente crea un nuevo paquete XML. Si el nodo raz tiene nodos secundarios, el cdigo se ejecuta en bucle por todos los nodos secundarios para mostrar el nombre y el valor de cada nodo. Aada el siguiente cdigo ActionScript al archivo FLA o AS:
var my_xml:XML = new XML("hankrudolph"); if (my_xml.firstChild.hasChildNodes()) { // use firstChild to iterate through the child nodes of rootNode for (var aNode:XMLNode = my_xml.firstChild.firstChild; aNode != null; aNode=aNode.nextSibling) { if (aNode.nodeType == 1) { trace(aNode.nodeName+":\t"+aNode.firstChild.nodeValue); } } }
El panel Salida muestra los siguientes nombres de nodos:

output: username: hank password: rudolph
Vase tambin
nodeType (propiedad XMLNode.nodeType)

public nodeType : Number [read-only]
Valor de nodeType, que puede ser 1 para un elemento XML o 3 para un nodo de texto.
nodeType es un valor numrico de la enumeracin NodeType de la recomendacin W3C DOM Nivel 1 en
www.w3.org. En la siguiente tabla se enumeran los valores:

Valor entero 1 2 3 4 5 6 7 8 9 10 11 12
Constante definida ELEMENT_NODE ATTRIBUTE_NODE TEXT_NODE CDATA_SECTION_NODE NTITY_REFERENCE_NODE ENTITY_NODE PROCESSING_INStrUCTION_NODE COMMENT_NODE DOCUMENT_NODE DOCUMENT_TYPE_NODE DOCUMENT_FRAGMENT_NODE NOTATION_NODE
En Flash Lite Player, la clase XML incorporada slo admite 1 (ELEMENT_NODE) y 3 (TEXT_NODE). Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un nodo de elemento y un nodo de texto, y comprueba los tipos de nodos:
// create an XML document var doc:XML = new XML(); // create an XML node using createElement() var myNode:XMLNode = doc.createElement("rootNode"); // place the new node into the XML tree doc.appendChild(myNode); // create an XML text node using createTextNode() var myTextNode:XMLNode = doc.createTextNode("textNode"); // place the new node into the XML tree myNode.appendChild(myTextNode); trace(myNode.nodeType); trace(myTextNode.nodeType); // output: // 1 // 3
Vase tambin
nodeValue (propiedad XMLNode.nodeValue)

nodeValue (propiedad XMLNode.nodeValue)

public nodeValue : String
Valor de nodo del objeto XML. Si el objeto XML es un nodo de texto, nodeType es 3, y nodeValue es el texto del nodo. Si el objeto XML es un elemento XML (nodeType es 1), nodeValue es null y de slo lectura. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un nodo de elemento y un nodo de texto, y comprueba el valor de cada uno:
// create an XML document var doc:XML = new XML(); // create an XML node using createElement() var myNode:XMLNode = doc.createElement("rootNode"); // place the new node into the XML tree doc.appendChild(myNode); // create an XML text node using createTextNode() var myTextNode:XMLNode = doc.createTextNode("textNode"); // place the new node into the XML tree myNode.appendChild(myTextNode); trace(myNode.nodeValue); trace(myTextNode.nodeValue); // output: // null // myTextNode
El ejemplo siguiente crea y analiza un paquete XML. El cdigo se reproduce indefinidamente por cada nodo secundario y muestra el valor del nodo utilizando la propiedad firstChild y firstChild.nodeValue. Cuando utiliza firstChild para mostrar el contenido del nodo, mantiene la entidad &. Sin embargo, si utiliza de forma explcita nodeValue, se convierte al carcter ampersand (&).
var my_xml:XML = new XML("mortongood&evil"); trace("using firstChild:"); for (var i = 0; i<my_xml.firstChild.childNodes.length; i++) { trace("\t"+my_xml.firstChild.childNodes[i].firstChild); } trace(""); trace("using firstChild.nodeValue:"); for (var i = 0; i<my_xml.firstChild.childNodes.length; i++) { trace("\t"+my_xml.firstChild.childNodes[i].firstChild.nodeValue); }
El panel Salida muestra la siguiente informacin:

using firstChild: morton good&evil using firstChild.nodeValue: morton good&evil
Vase tambin
parentNode (propiedad XMLNode.parentNode)

public parentNode : XMLNode [read-only]
Valor de XMLNode que hace referencia al nodo principal del objeto XML especificado o devuelve null si el nodo no tiene elemento principal. Esta es una propiedad de slo lectura que no puede utilizarse para manipular nodos secundarios; utilice los mtodos appendChild(), insertBefore() y removeNode() para manipular nodos secundarios. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un paquete XML y muestra el nodo principal del nodo username en el panel Salida:
var my_xml:XML = new XML("mortongood&evil"); // first child is the <login /> node var rootNode:XMLNode = my_xml.firstChild; // first child of the root is the <username /> node var targetNode:XMLNode = rootNode.firstChild; trace("the parent node of '"+targetNode.nodeName+"' is: "+targetNode.parentNode.nodeName); trace("contents of the parent node are:\n"+targetNode.parentNode); // output (line breaks added for clarity): the parent node of 'username' is: login contents of the parent node are: morton good&evil
Vase tambin
appendChild (mtodo XMLNode.appendChild), insertBefore (mtodo XMLNode.insertBefore), removeNode (mtodo XMLNode.removeNode), hasXMLSocket (propiedad capabilities.hasXMLSocket)
previousSibling (propiedad XMLNode.previousSibling)

public previousSibling : XMLNode [read-only]

Valor XMLNode que hace referencia al elemento secundario anterior de la lista de elementos secundarios del nodo principal. La propiedad tiene el valor null si el nodo no tiene un nodo del mismo nivel que le preceda. Esta propiedad no puede utilizarse para manipular nodos secundarios; utilice los mtodos appendChild(), insertBefore() y removeNode() para manipular nodos secundarios. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente es un extracto del ejemplo de la propiedad XML.lastChild y muestra cmo se puede utilizar la propiedad XML.previousSibling para reproducirse indefinidamente por los nodos secundarios de un nodo XML:
for (var aNode:XMLNode = rootNode.lastChild; aNode != null; aNode = aNode.previousSibling) { trace(aNode); }
Vase tambin
lastChild (propiedad XMLNode.lastChild), appendChild (mtodo XMLNode.appendChild), insertBefore (mtodo XMLNode.insertBefore), removeNode (mtodo XMLNode.removeNode), hasXMLSocket (propiedad capabilities.hasXMLSocket)
removeNode (mtodo XMLNode.removeNode)

public removeNode() : Void
Quita el objeto XML especificado de su elemento principal. Tambin elimina todos los descendientes del nodo. Disponibilidad Flash Lite 2.0 Ejemplo El ejemplo siguiente crea un paquete XML y, a continuacin, elimina el objeto XML especificado y sus nodos descendientes:
var xml_str:String = "<state name=\"California\"><city>San Francisco</city></state>"; var my_xml:XML = new XML(xml_str); var cityNode:XMLNode = my_xml.firstChild.firstChild; trace("before XML.removeNode():\n"+my_xml); cityNode.removeNode(); trace(""); trace("after XML.removeNode():\n"+my_xml); // // // // // // // // // output (line breaks added for clarity): before XML.removeNode(): <state name="California"> <city>San Francisco</city> </state> after XML.removeNode(): <state name="California" />

toString (mtodo XMLNode.toString)

Evala el objeto XML especificado, construye una representacin textual de la estructura XML, incluidos el nodo, los elementos secundarios y los atributos, y devuelve el resultado como una cadena. En el caso de objetos XML de nivel superior (los creados con el constructor), el mtodo XML.toString() genera la declaracin XML del documento (almacenada en la propiedad XML.xmlDecl), seguida de la declaracin DOCTYPE del documento (almacenada en la propiedad XML.docTypeDecl), seguida de la representacin textual de todos los nodos XML del objeto. La declaracin XML no se genera si la propiedad XML.xmlDecl no est definida. La declaracin DOCTYPE no se genera si la propiedad XML.docTypeDecl no est definida (undefined). Disponibilidad Flash Lite 2.0 Valor devuelto String - String. Ejemplo El cdigo siguiente utiliza el mtodo toString() para convertir un objeto XMLNode en una cadena (String) y, a continuacin, utiliza el mtodo toUpperCase() de la clase String:
var xString = "<first>Mary</first>" + "<last>Ng</last>" var my_xml:XML = new XML(xString); var my_node:XMLNode = my_xml.childNodes[1]; trace(my_node.toString().toUpperCase()); // <LAST>NG<
Vase tambin
docTypeDecl (propiedad XML.docTypeDecl), xmlDecl (propiedad XML.xmlDecl)
XMLSocket
Object | +-XMLSocket public class XMLSocket extends Object
La clase XMLSocket implementa sockets de cliente que permiten al dispositivo que ejecuta el reproductor de Flash Lite comunicarse con un host identificado mediante una direccin IP o un nombre de dominio. La clase XMLSocket es til para aplicaciones de servidor que requieran una baja latencia, como los sistemas de chat en tiempo real. Un sistema de chat tradicional basado en HTTP suele sondear el servidor y descargar los mensajes nuevos mediante una solicitud HTTP. Por contraste, una solucin de chat con XMLSocket mantiene una conexin abierta con el servidor, lo que permite que el servidor enve de inmediato los mensajes entrantes sin que se produzca una solicitud del cliente.

Para utilizar la clase XMLSocket, el equipo servidor debe ejecutar un proceso de demonio que entienda el protocolo utilizado por la clase XMLSocket. En la lista siguiente se describe el protocolo:
Los mensajes XML se envan a travs de una conexin de socket ininterrumpida TCP/IP dplex. Cada mensaje XML es un documento XML completo terminado en un byte cero (0). Pueden enviarse y recibirse un nmero ilimitado de mensajes XML a travs de una misma conexin XMLSocket.
Las siguientes restricciones afectan a la forma y el lugar en el que el objeto XMLSocket puede conectarse con el servidor:
Para conectar un objeto XMLSocket a un puerto inferior a 1024, debe cargar primero un archivo de poltica con el
mtodo System.security.loadPolicyFile(), aunque la aplicacin se conecte a su propio dominio exacto.
El mtodo XMLSocket.connect() slo puede conectar con equipos del mismo dominio en el que reside el archivo
SWF. Esta restriccin no afecta a los archivos SWF que se ejecutan en un disco local. (Esta restriccin es idntica a las reglas de seguridad para la funcin loadVariables() y los mtodos XML.sendAndLoad() y XML.load().) Para conectar con un dominio de servidor que se ejecuta en un dominio diferente a aqul en el que reside el archivo SWF, puede crear un archivo de poltica de seguridad en el servidor que permita el acceso desde determinados dominios. La configuracin de un servidor para que se comunique con el objeto XMLSocket puede resultar compleja. Si su aplicacin no requiere interactividad en tiempo real, utilice la funcin loadVariables() o conectividad de servidor XML basada en HTTP de Flash (XML.load(), XML.sendAndLoad(), XML.send()) en lugar de la clase XMLSocket. Para utilizar los mtodos de la clase XMLSocket, primero debe utilizar el constructor, XMLSocket(), para crear un objeto XMLSocket. Disponibilidad Flash Lite 2.1 Vase tambin
loadPolicyFile (mtodo security.loadPolicyFile)
Resumen de propiedades Propiedades heredadas de la clase Object

Resumen de eventos
Evento onClose = function()
{}
Descripcin Slo se invoca cuando el servidor cierra una conexin abierta.
onConnect = function(success:Bool ean) {} onData = function(src:String) {} onXML = function(src:XML) {}
Funcin callback asncrona invocada por el reproductor de Flash Lite cuando una solicitud de conexin iniciada a travs de XMLSocket.connect() ha sido correcta o incorrecta. Se invoca cuando se ha descargado del servidor un mensaje terminado en un byte cero (0).
Lo invoca el reproductor de Flash Player cuando el objeto XML que contiene un documento XML llega a travs de una conexin XMLSocket abierta.

Firma XMLSocket() Descripcin Crea un nuevo objeto XMLSocket.
Resumen de mtodos
Modificadores Firma close() : Void connect(url:String, port:Number) : Boolean Descripcin Cierra la conexin especificada por el objeto XMLSocket. Establece una conexin con el servidor de Internet especificado utilizando el puerto TCP indicado y devuelve true o false, dependiendo de si se ha iniciado correctamente una conexin. Convierte el objeto XML o los datos especificados en el parmetro object en una cadena y la transmite al servidor seguida de un byte cero (0).
send(data:Object) : Void

close (mtodo XMLSocket.close)

Cierra la conexin especificada por el objeto XMLSocket. Disponibilidad Flash Lite 2.1 Ejemplo El ejemplo siguiente crea un objeto XMLSocket, intenta conectarse al servidor y, a continuacin, cierra la conexin.
var socket:XMLSocket = new XMLSocket(); socket.connect(null, 2000); socket.close();
Vase tambin
connect (mtodo XMLSocket.connect)

public connect(url:String, port:Number) : Boolean
Establece una conexin con el servidor de Internet especificado utilizando el puerto TCP indicado y devuelve true o false, dependiendo de si se ha iniciado correctamente una conexin. Si el mtodo XMLSocket.connect() devuelve el valor true, la etapa inicial del proceso de conexin habr sido correcta; posteriormente, se invoca al mtodo XMLSocket.onConnect() para determinar si la conexin final ha sido correcta o incorrecta. Si XMLSocket.connect() devuelve false, ello indicar que no se ha podido establecer una conexin.

Si desconoce el nmero de puerto de su host de Internet, pngase en contacto con el administrador de la red. Para conectar un XMLSocket a un puerto menor a 1024, debe empezar por cargar un archivo de poltica con el mtodo System.security.loadPolicyFile(). Si especifica el valor null para el parmetro host, el servidor con el que se entra en contacto es en el que reside el archivo SWF que llama a XMLSocket.connect(). Por ejemplo, si el archivo SWF se ha descargado de www.example.com, especificar null para el parmetro host equivaldr a introducir la direccin IP de www.example.com. En archivos SWF de cualquier versin que se ejecuten en Flash Player 7 y posterior, host debe estar exactamente en el mismo dominio. Por ejemplo, un archivo SWF situado en www.someDomain.com publicado para Flash Player 5, pero abierto en Flash Player 7 o posterior slo puede cargar variables de archivos SWF que tambin se encuentren en www.someDomain.com. Si desea cargar variables de otro dominio, puede colocar un archivo de poltica para distintos dominios en el servidor en el que se alberga el archivo SWF al que se est accediendo. Nota: El mtodo XMLSocket.connect() devuelve false si System.capabilities.hasXMLSocket es false. Disponibilidad Flash Lite 2.1 Parmetros url:String - Una cadena; un nombre de dominio DNS completo o una direccin IP con el formato aaa.bbb.ccc.ddd. Tambin puede especificar null para conectarse al servidor host en el que se encuentra el archivo SWF. Si el archivo SWF que realiza esta llamada se ejecuta en un navegador Web, el parmetro host debe pertenecer al mismo dominio que el archivo SWF. port:Number - Nmero; el nmero de puerto TCP en el host utilizado para establecer una conexin. Valor devuelto Boolean - Un valor de true si la conexin se realiza correctamente; false en caso contrario. Ejemplo El ejemplo siguiente utiliza el mtodo XMLSocket.connect() para conectarse al host donde reside el archivo SWF y la funcin trace() para obtener el valor que indica si se ha realizado correctamente la conexin:
var socket:XMLSocket = new XMLSocket() socket.onConnect = function (success:Boolean) { if (success) { trace ("Connection succeeded!"); } else { trace ("Connection failed!"); } } if (!socket.connect(null, 2000)) { trace ("Connection failed!"); }
Vase tambin
onConnect (controlador XMLSocket.onConnect), Array, funcin, loadPolicyFile (mtodo security.loadPolicyFile)

onClose (controlador XMLSocket.onClose)

onClose = function() {}
Slo se invoca cuando el servidor cierra una conexin abierta. En la implementacin predeterminada, este mtodo no realiza ninguna accin. Para sustituir la implementacin predeterminada, debe asignar una funcin que contenga acciones personalizadas. Disponibilidad Flash Lite 2.1 Ejemplo El siguiente ejemplo ejecuta una sentencia trace si el servidor cierra una conexin abierta:
var socket:XMLSocket = new XMLSocket(); socket.connect(null, 2000); socket.onClose = function () { trace("Connection to server lost."); }
Vase tambin
onConnect (controlador XMLSocket.onConnect), Array, funcin
onConnect (controlador XMLSocket.onConnect)

onConnect = function(success:Boolean) {}
Funcin callback asncrona invocada por el reproductor de Flash Lite cuando una solicitud de conexin iniciada a travs de XMLSocket.connect() ha sido correcta o incorrecta. Si la conexin es correcta, el parmetro success tiene un valor true; de lo contrario, el parmetro success tiene un valor false. En la implementacin predeterminada, este mtodo no realiza ninguna accin. Para sustituir la implementacin predeterminada, debe asignar una funcin que contenga acciones personalizadas. Disponibilidad Flash Lite 2.1 Parmetros success:Boolean - Valor booleano que indica si la conexin de socket se ha realizado correctamente. Si la conexin ha sido correcta, el parmetro success tiene un valor true; de lo contrario, el parmetro success tiene un valor false. Ejemplo El ejemplo siguiente muestra el proceso necesario para especificar una funcin de sustitucin para el controlador de eventos onConnect() en una aplicacin de chat sencilla. Tras crear el objeto XMLSocket mediante el mtodo constructor, el guin define la funcin personalizada que se va a ejecutar cuando se invoque el controlador de eventos onConnect(). La funcin controla la pantalla que ven los usuarios, dependiendo de si se ha realizado la conexin correctamente. Si la conexin se ha establecido, los usuarios vern la pantalla de chat principal en el fotograma llamado startChat. Si la conexin no se ha establecido, los usuarios vern una pantalla con informacin para resolver problemas en el fotograma llamado connectionFailed.

var socket:XMLSocket = new XMLSocket(); socket.onConnect = function (success) { if (success) { gotoAndPlay("startChat"); } else { gotoAndStop("connectionFailed"); } }
Ahora que se ha definido el controlador onConnect(), se invoca el mtodo connect() para intentar establecer la conexin. Si el mtodo connect() devuelve un valor false, el archivo SWF se enva directamente al fotograma llamado connectionFailed, y nunca se llama a onConnect(). Si el mtodo connect() devuelve true, el archivo SWF salta a un fotograma waitForConnection, que es la pantalla "Please wait" (Espere por favor). El archivo SWF sigue en el fotograma waitForConnection hasta que se llama al controlador onConnect(), lo que ocurre en algn momento posterior segn la latencia de la red.
if (!socket.connect(null, 2000)) { gotoAndStop("connectionFailed"); } else { gotoAndStop("waitForConnection"); }
Vase tambin
connect (mtodo XMLSocket.connect), Array, funcin
onData (controlador XMLSocket.onData)

Se invoca cuando se ha descargado del servidor un mensaje terminado en un byte cero (0). Puede modificar el controlador de eventos XMLSocket.onData para interceptar datos enviados por el servidor sin analizarlos como datos XML. Esta funcin resulta til si se transmiten paquetes de datos con formato arbitrario y se prefiere manipularlos directamente cuando lleguen en lugar de que Flash Lite Player los analice como XML. De manera predeterminada, el mtodo XMLSocket.onData invoca el mtodo XMLSocket.onXML. Si sustituye
XMLSocket.onData por un comportamiento personalizado, no se llamar a XMLSocket.onXML a no ser que efecte la
llamada en su implementacin de XMLSocket.onData. Disponibilidad Flash Lite 2.1 Parmetros src:String - Cadena con datos enviados por el servidor. Ejemplo En este ejemplo, el parmetro src es una cadena que contiene texto XML descargado del servidor. El terminador byte cero (0) no se incluye en la cadena.
XMLSocket.prototype.onData = function (src) { this.onXML(new XML(src)); }

onXML (controlador XMLSocket.onXML)

onXML = function(src:XML) {}
Lo invoca el reproductor de Flash Player cuando el objeto XML que contiene un documento XML llega a travs de una conexin XMLSocket abierta. Una conexin XMLSocket puede utilizarse para transferir un nmero ilimitado de documentos XML entre el cliente y el servidor. Cada documento termina en un byte cero (0). Cuando el reproductor de Flash Lite recibe el byte cero, analiza todos los datos XML recibidos desde el byte cero anterior o desde que se estableci la conexin si ste es el primer mensaje recibido. Cada lote de datos XML analizados se considera como un nico documento XML y se analiza con el mtodo onXML(). En la implementacin predeterminada, este mtodo no realiza ninguna accin. Para sustituir la implementacin predeterminada, deber asignar una funcin que contenga acciones definidas por usted. Disponibilidad Flash Lite 2.1 Parmetros src:XML - Objeto XML que contiene un documento XML analizado recibido de un servidor. Ejemplo La siguiente funcin sustituye la implementacin predeterminada del mtodo onXML() en una aplicacin de chat sencilla. La funcin myOnXML() indica a la aplicacin de chat que reconozca un elemento XML nico, MESSAGE, con el formato siguiente:
<MESSAGE USER="John" TEXT="Hello, my name is John!" /> var socket:XMLSocket = new XMLSocket();
En el siguiente ejemplo, se supone que la funcin siguiente displayMessage() es una funcin definida por el usuario que muestra el mensaje que recibe el usuario:
socket.onXML = function (doc) { var e = doc.firstChild; if (e != null && e.nodeName == "MESSAGE") { displayMessage(e.attributes.user, e.attributes.text); } }
Vase tambin
Array, funcin
send (mtodo XMLSocket.send)

public send(data:Object) : Void
Convierte el objeto XML o los datos especificados en el parmetro object en una cadena y la transmite al servidor seguida de un byte cero (0). Si object es un objeto, la cadena es una representacin textual XML del objeto XML. La operacin de envo (send) es asncrona; se devuelve inmediatamente, pero puede que los datos se transmitan posteriormente. El mtodo XMLSocket.send() no devuelve ningn valor que indique si los datos se han transmitido correctamente. Si el objeto XMLSocket no est conectado al servidor con el mtodo XMLSocket.connect(), el funcionamiento de XMLSocket.send() falla.

Disponibilidad Flash Lite 2.1 Parmetros data:Object - Objeto XML u otros datos que se van a transmitir al servidor. Ejemplo El ejemplo siguiente muestra cmo especificar un nombre de usuario y una contrasea para enviar el objeto XML my_xml al servidor:
var myXMLSocket:XMLSocket = new XMLSocket(); var my_xml:XML = new XML(); var myLogin:XMLNode = my_xml.createElement("login"); myLogin.attributes.username = usernameTextField; myLogin.attributes.password = passwordTextField; my_xml.appendChild(myLogin); myXMLSocket.send(my_xml);
Vase tambin
XMLSocket, constructor
public XMLSocket()
Crea un nuevo objeto XMLSocket. El objeto XMLSocket no est conectado inicialmente a ningn servidor. Debe llamar al mtodo XMLSocket.connect() para conectar el objeto con un servidor. Disponibilidad Flash Lite 2.1 Ejemplo En el ejemplo siguiente se crea un objeto XMLSocket:
var socket:XMLSocket = new XMLSocket();
725
Captulo 3: Cdigo ActionScript desfasado

Debido a la evolucin de ActionScript muchos de los elementos del lenguaje han quedado desfasados. En esta seccin se incluyen los elementos desfasados y, si existen, se sugieren alternativas. Aunque los elementos desfasados an funcionan en Flash Lite 2.0 y versiones posteriores, Adobe recomienda que no se sigan usando en el cdigo. No se garantiza el servicio de soporte para elementos desfasados en el futuro.
Resumen de funciones desfasadas

Modificadore s Nombre de funcin Descripcin
call(frame:Object)
Desfasada desde Flash Player 5. Esta accin est desfasada y en su lugar debe utilizarse la sentenciafunction. Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse String.fromCharCode(). Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse la sintaxis con punto, introducida en Flash Player 5. Desfasada desde Flash Player 5. Adobe recomienda la utilizacin de la propiedad MovieClip._framesloaded.
chr(number:Number)String
getProperty(my_mc:Object, property:Object)Object
ifFrameLoaded([scene:String], frame:Object, statement(s):Object) int(value:Number)Number
Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse Math.round(). 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. Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse el mtodo String.fromCharCode(). Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse la propiedad String.length.
length(expression:String, variable:Object)Number
mbchr(number:Number)
mblength(string:String)Number
mbord(character:String)Number Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse el mtodo String.charCodeAt(). mbsubstring(value:String, index:Number, count:Number)String ord(character:String)Number Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse el mtodo String.substr().
Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar deben utilizarse los mtodos y propiedades de la clase String. Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse Math.random().
random(value:Number)Number

Cdigo ActionScript desfasado
Modificadore s
Nombre de funcin
Descripcin
substring(string:String, index:Number, count:Number)String tellTarget(target:String, statement(s):Object) toggleHighQuality()
Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse String.substr().
Desfasada desde Flash Player 5. Adobe recomienda el uso de notacin de puntos (.) y la sentencia with. Desfasada desde Flash Player 5. Esta funcin est desfasada y en su lugar debe utilizarse _quality.
Resumen de propiedades desfasadas

Modificadore s Nombre de propiedad Descripcin
$version
Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.version. Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.has4WayKeyAS. Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasCompoundSound. Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasEmail. Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasDataLoading. Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasMFi. Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasMIDI. Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasMMS. Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasSMAF. Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasSMS. Desfasada desde Flash Lite Player 2.0. Esta accin est desfasada y en su lugar debe utilizarse la propiedad System.capabilities.hasStreamingAudio.
_cap4WayKeyAS
_capCompoundSound
_capEmail
_capLoadData
_capMFi
_capMIDI
_capMMS
_capSMAF
_capSMS
_capStreamSound

Modificadore s
Nombre de propiedad
Descripcin
Button._highquality
Desfasada desde Flash Player 7. Esta propiedad est desfasada y en su lugar debe utilizarse Button._quality. Desfasada desde Flash Player 7. Esta propiedad est desfasada y en su lugar debe utilizarse MovieClip._quality. Desfasada desde Flash Player 7. Esta propiedad est desfasada y en su lugar debe utilizarse TextField._quality. Desfasada desde Flash Player 5. Esta propiedad est desfasada y en su lugar debe utilizarse _quality. Desfasada desde Flash Player 5. Esta propiedad est desfasada y en su lugar debe utilizarse TextField.maxscroll. Desfasada desde Flash Player 5. Esta propiedad est desfasada y en su lugar debe utilizarse TextField.scroll.
MovieClip._highquality
TextField._highquality
_highquality
maxscroll
scroll
Resumen de operadores desfasados

Operador <> (desigualdad) Descripcin Desfasada desde Flash Player 5. Adobe recomienda que utilice el operador != (desigualdad). Desfasada desde Flash Player 5. Adobe recomienda utilizar el operador de suma (+) cuando cree contenido para Flash Player 5 o versiones posteriores. Nota: en Flash Lite 2.0, tambin el operador agregar est desfasado y en su lugar debe utilizarse el operador (+). and (AND lgico) Desfasada desde Flash Player 5. Adobe recomienda que utilice el operador lgico AND (&&). Desfasada desde Flash Player 5. Este operador est desfasado y en su lugar debe utilizarse el operador == (igualdad). Desfasada desde Flash Player 5. Este operador est desfasado y en su lugar debe utilizarse el operador >= (mayor o igual que). Desfasada desde Flash Player 5. Este operador est desfasado y en su lugar debe utilizarse el operador > (mayor que). Desfasada desde Flash Player 5. Este operador est desfasado en Flash 5 y en su lugar debe utilizarse el operador <= (menor o igual que). Desfasada desde Flash Player 5. Este operador est desfasado y en su lugar debe utilizarse < (menor que).
add (concatenation (strings))
eq (equality (strings))
ge (greater than or equal to (strings))
gt (greater than (strings))
le (less than or equal to (strings))
lt (less than (strings))

Operador ne (not equal (strings))
Descripcin Desfasada desde Flash Player 5. Este operador est desfasado y en su lugar debe utilizarse el operador != (desigualdad). Desfasada desde Flash Player 5. Este operador est desfasado y en su lugar debe utilizarse el operador ! (NOT lgico), operador. Desfasada desde Flash Player 5. Este operador est desfasado y en su lugar debe utilizarse el operador || (OR lgico).
not (logical NOT)
or (OR lgico)
729
Captulo 4: ActionScript no admitido

Las listas siguientes muestran las clases, los mtodos, las propiedades, las funciones globales, los controladores de eventos y las funciones fscommand que se admiten en ActionScript 2.0 pero que no se admiten en ninguna versin de Flash Lite. Para ver una presentacin ms detallada de esta informacin, consulte Clases y elementos de idioma de ActionScript admitidos, parcialmente admitidos y no admitidos en Desarrollo de aplicaciones de Flash Lite 2.x y 3.x de Adobe.
Clases no admitidas
Acessibility, BevelFilter, BitmapFilter, BlurFilter, Camera, ColorMatrixFilter, ContextMenu, ContextMenuItem, ConvolutionFilter, CustomActions, DisplacementMapFilter, DropShadowFilter, FileReference, FileReferenceList, GlowFilter, GradientBevelFilter, GradientGlowFilter, IME, Locale (mx.lang.Locale), Microphone, PrintJob, TextField.StyleSheet, TextRenderer, TextSnapshot, XMLUI
Mtodos no admitidos
BitmapData.applyFilter, BitmapData.generateFilterRect, BitmapData.noise, BitmapData.paletteMap, BitmapData.perlinNoise, BitmapData.pixelDissolve, BitmapData.scroll, BitmapData.threshold, Matrix.createGradientBox, Mouse.hide, Mouse.show, MovieClip.attachAudio, MovieClip.getTextSnapshot, Selection.getBeginIndex, Selection.getCaretIndex, Selection.getEndIndex, System.setClipboard, System.showSettings, TextField.getFontList, Video.clear
Propiedades no admitidas
Button.blendMode, Button.cacheAsBitmap, Button.filters, Button.menu, Button.useHandCursor, System.capabilities.language, System.capabilities.manufacturer, System.capabilities.pixelAspectRatio, System.capabilities.playerType, System.capabilities.screenColor, System.capabilities.screenDPI, System.capabilities.serverString, Key.isToggled, MovieClip.menu, MovieClip.useHandCursor, Stage.showMenu, System.exactSettings, TextField.menu, TextField.mouseWheelEnabled, TextField.restrict, Video._alpha, Video.deblocking, Video._height, Video.height, Video._name, Video._parent, Video._rotation, Video.smoothing, Video._visible, Video._width, Video.width, Video._x, Video._xmouse, Video._xscale, Video._y, Video._ymouse, Video._yscale
Funciones globales no admitidas

asfunction, MMExecute, print, printAsBitmap, printAsBitmapNum, printNum, updateAfterEvent

ActionScript no admitido
Controladores de eventos no admitidos

onUpdate, Mouse.onMouseWheel
Funciones fscommand no admitidas

allowscale, exec, fullscreen, quit, showmenu, trapallkeys
731
ndice
-- operador de decremento 95 - operador de resta 122 Smbolos ^ bitwise XOR operator 91 ^= bitwise XOR assignment operator 92 _cap4WayKeyAS property 59 _capCompoundSound property 59 _capEmail property 60 _capLoadData property 61 _capMFi property 61 _capMIDI property 62 _capMMS property 62 _capSMAF property 63 _capSMS property 63 _capStreamSound property 64 _focusrect, propiedad 65 _forceframerate property 65 _global, propiedad 66 _highquality property 66 _level, propiedad 67 _parent, propiedad 68 _quality, propiedad 68 _root, propiedad 69 _soundbuftime, propiedad 70 , comma operator 93 ! logical NOT operator 110 != inequality operator 103 !== strict inequality operator 120 ?\ conditional operator 95 . operador de punto 97 " string delimiter operator 121 () operador de parntesis 117 {} operador de inicializador de objeto 116 * multiplication operator 114 *= operador de asignacin de multiplicacin 114 / division operator 96 /* operador de delimitador de comentario en bloque 92 // line comment delimiter operator 108 /= division assignment operator 97 \ operador de tipo 123 83, 84, 106, 107 A a, propiedad 374 add concatenation (strings) operator 94 add(), mtodo 522 allowDomain, evento 345 allowInsecureDomain, evento 347 alphaMultiplier, propiedad 271 alphaOffset, propiedad 272 and logical AND operator 109 Array function 12 attachBitmap(), mtodo 403 \ inequality operator 105 \> greater than operator 100 \>= greater than or equal to operator 101 \>> bitwise right shift operator 87 \>>= bitwise right shift and assignment operator 89 \>>> bitwise unsigned right shift operator 89 \>>>= bitwise unsigned right shift and assignment operator 90 & bitwise AND operator 81 && logical AND operator 109 &= bitwise AND assignment operator 82 #endinitclip, directiva 1 #include directive 1 #initclip directive 3 % modulo operator 112 %= modulo assignment operator 113 + addition operator 76 ++ operador de incremento 102 += addition assignment operator 77 = assignment operator 80 -= subtraction assignment operator 122 == equality operator 98 === strict equality operator 118 | bitwise OR operator 86 |= bitwise OR assignment operator 87 || logical OR operator 111 ~ bitwise NOT operator 85 $version property 58 C c, propiedad 375 call, funcin 14 case statement 127 chr function 15 clase distribuida por LocalConnection 345, 347, 353 Clase Matrix 370 Clase Transform 669 class statement 128 clearInterval function 15 clone(), mtodo 204, 375, 522, 532 close(), mtodo 348 ColorTransform alphaMultiplier, propiedad 271 alphaOffset, propiedad 272 B b, propiedad 374 BitmapData clone(), mtodo 204 colorTransform(), mtodo 206 copyChannel(), mtodo 207 copyPixels(), mtodo 208 dispose(), mtodo 209 draw(), mtodo 210 fillRect(), mtodo 211 floodFill(), mtodo 212 getColorBoundsRect(), mtodo 213 getPixel(), mtodo 214 getPixel32(), mtodo 215 height, propiedad 216 hitTest(), mtodo 217 loadBitmap(), mtodo 218 merge(), mtodo 219 rectangle, propiedad 220 setPixel(), mtodo 221 setPixel32(), mtodo 221 transparent, propiedad 221 blueMultiplier, propiedad 273 blueOffset, propiedad 274 Boolean function 13 bottom, propiedad 531 bottomRight, propiedad 531 break statement 126

ndice
blueMultiplier, propiedad 273 blueOffset, propiedad 274 ColorTransform(), constructor 275 concat(), mtodo 276 greenMultiplier, propiedad 277 greenOffset, propiedad 278 redMultiplier, propiedad 279 redOffset, propiedad 280 rgb, propiedad 281 toString(), mtodo 282 ColorTransform, clase 270 colorTransform, propiedad 670 ColorTransform(), constructor 275 colorTransform(), mtodo 206 Comandos fscommand2 164 concat(), mtodo 276, 376 concatenatedColorTransform, propiedad 671 concatenatedMatrix, propiedad 672 connect(), mtodo 349 Constantes 4 constructor BitmapData BitmapData() 203 constructor BitmapData() 203 Constructor NetConnection 483 constructor NetStream 489 NetStream() 489 contains(), mtodo 534 containsPoint(), mtodo 535 containsRectangle(), mtodo 536 ContextMenu 282 continue, sentencia 130 copyChannel(), mtodo 207 copyPixels(), mtodo 208 createBox(), mtodo 377 createGradientBox(), mtodo 378 D d, propiedad 379 default, sentencia 131 delete, sentencia 132 deltaTransformPoint(), mtodo 379 Directivas del compilador 1 dispose(), mtodo 209 distance(), mtodo 522 do..while, sentencia 133 domain(), mtodo 350 draw(), mtodo 210 duplicateMovieClip function 16 dynamic statement 134
E else if, sentencia 136 else, sentencia 135 eq equality (strings) operator 99 equals(), mtodo 523, 536 escape function 17 eval function 17 ExtendBacklightDuration, comando 165 extends, sentencia 136 F false, constante 4 fillRect(), mtodo 211 floodFill(), mtodo 212 for, sentencia 139 for..en la sentencia 140 fscommand function 18 fscommand2 function 19 FullScreen, comando 165 Funciones globales 8 function, sentencia 141 G ge greater than or equal to (strings) operator 101 get, sentencia 142 GetBatteryLevel, comando 166 getColorBoundsRect(), mtodo 213 GetDevice, comando 166 GetDeviceID, comando 167 GetFreePlayerMemory, comando 167 GetMaxBatteryLevel, comando 167 GetMaxSignalLevel, comando 168 GetMaxVolumeLevel, comando 168 GetNetworkConnectionName, comando 169 GetNetworkConnectStatus, comando 169 GetNetworkGeneration, comando 169 GetNetworkName, comando 170 GetNetworkRequestStatus, comando 171 GetNetworkStatus, comando 172 getPixel(), mtodo 214 getPixel32(), mtodo 215 GetPlatform, comando 173 GetPowerSource, comando 174 getProperty function 21 GetSignalLevel, comando 174 GetSoftKeyLocation, comando 175 getTimer function 21 GetTotalPlayerMemory, comando 175
getURL function 22 getVersion function 23 GetVolumeLevel, comando 175 gotoAndPlay function 24 gotoAndStop function 24 greenMultiplier, propiedad 277 greenOffset, propiedad 278 gt greater than (strings) operator 100 H height, propiedad 216, 537 hitTest(), mtodo 217 I identity(), mtodo 380 if, sentencia 143 ifFrameLoaded function 25 implements, sentencia 144 import, sentencia 144 -Infinity, constante 5 Infinity, constante 5 inflate(), mtodo 538 inflatePoint(), mtodo 539 instanceof operator 105 int function 26 interface, sentencia 145 interpolate(), mtodo 524 intersection(), mtodo 539 intersects(), mtodo 540 intrinsic, sentencia 147 invert(), mtodo 382 isEmpty(), mtodo 541 isFinite function 26 isNaN function 26 L le less than or equal to (strings) operator 108 left, propiedad 541 length function 27 length, propiedad 524 loadBitmap(), mtodo 218 loadMovie function 28 loadMovieNum function 29 loadVariables function 30 loadVariablesNum function 32 LocalConnection close(), mtodo 348 connect(), mtodo 349 domain(), mtodo 350

ndice
LocalConnection(), constructor 353 send(), mtodo 354 LocalConnection, clase 343 evento allowDomain 345 evento allowInsecureDomain 347 evento onStatus 353 LocalConnection(), constructor 353 lt less than (strings) operator 106 M Matrix a, propiedad 374 b, propiedad 374 c, propiedad 375 clone(), mtodo 375 concat(), mtodo 376 createBox(), mtodo 377 createGradientBox(), mtodo 378 d, propiedad 379 deltaTransformPoint(), mtodo 379 identity(), mtodo 380 invert(), mtodo 382 Matrix(), constructor 383 rotate(), mtodo 384 scale(), mtodo 386 toString(), mtodo 387 transformPoint(), mtodo 388 translate(), mtodo 389 tx, propiedad 389 ty, propiedad 390 matrix, propiedad 673 Matrix(), constructor 383 maxscroll property 68 mbchr function 33 mblength function 33 mbord function 34 mbsubstring function 34 merge(), mtodo 219 MovieClip attachBitmap(), mtodo 403 propiedad transform 462 N NaN, constante 5 ne, operador distinto de (cadenas) 116 NetConnection NetConnection(), constructor 483 new operator 115 newline, constante 6 nextFrame function 35
nextScene function 35 normalize(), mtodo 524 not logical NOT operator 110 null, constante 6 Number function 36 O Object function 37 offset(), mtodo 525, 542 offsetPoint(), mtodo 542 on handler 38 onClipEvent handler 39 onStatus, evento 353 operador de acceso a matriz 78 Operadores 73 or logical OR operator 112 ord function 40 P parseFloat function 41 parseInt function 41 pixelBounds, propiedad 674 play function 42 Point add(), mtodo 522 clone(), mtodo 522 distance(), mtodo 522 equals(), mtodo 523 interpolate(), mtodo 524 length, propiedad 524 normalize(), mtodo 524 offset(), mtodo 525 Point(), constructor 525 polar(), mtodo 526 subtract(), mtodo 527 toString(), mtodo 527 x, propiedad 528 y, propiedad 528 Point(), constructor 525 polar(), mtodo 526 prevFrame function 43 prevScene function 43 PrintJob, clase 528 private, sentencia 149 Propiedades globales 56 public, sentencia 150 Q Quit, comando 176
R random function 43 Rectangle bottom, propiedad 531 bottomRight, propiedad 531 clone(), mtodo 532 contains(), mtodo 534 containsPoint(), mtodo 535 containsRectangle(), mtodo 536 equals(), mtodo 536 height, propiedad 537 inflate(), mtodo 538 inflatePoint(), mtodo 539 intersection(), mtodo 539 intersects(), mtodo 540 isEmpty(), mtodo 541 left, propiedad 541 offset(), mtodo 542 offsetPoint(), mtodo 542 Rectangle(), constructor 543 right, propiedad 544 setEmpty(), mtodo 544 size, propiedad 545 top, propiedad 545 topLeft, propiedad 546 toString(), mtodo 547 union(), mtodo 547 width, propiedad 548 x, propiedad 549 y, propiedad 549 rectangle, propiedad 220 Rectangle(), constructor 543 redMultiplier, propiedad 279 redOffset, propiedad 280 removeMovieClip function 44 ResetSoftKeys, comando 176 return, sentencia 150 rgb, propiedad 281 right, propiedad 544 rotate(), mtodo 384 S scale(), mtodo 386 scroll property 70 send(), mtodo 354 Sentencias 125 set variable, sentencia 152 set, sentencia 151 setEmpty(), mtodo 544 SetFocusRectColor, comando 177

ndice
SetInputTextType, comando 177 setInterval function 45 setPixel(), mtodo 221 setPixel32(), mtodo 221 setProperty function 47 SetSoftKeys, comando 178 size, propiedad 545 startDrag function 48 StartVibrate, comando 179 static, sentencia 153 stop function 48 stopAllSounds function 49 stopDrag function 50 StopVibrate, comando 180 String function 50 substring function 51 subtract(), mtodo 527 super, sentencia 154 switch, sentencia 155 T targetPath function 51 tellTarget function 52 this, propiedad 71 throw, sentencia 156 toggleHighQuality function 53 top, propiedad 545 topLeft, propiedad 546 toString(), mtodo 282, 387, 527, 547 trace function 53 Transform colorTransform, propiedad 670 concatenatedColorTransform, propiedad 671 concatenatedMatrix, propiedad 672 matrix, propiedad 673 pixelBounds, propiedad 674 Transform(), constructor 675 transform, propiedad 462 Transform(), constructor 675 transformPoint(), mtodo 388 translate(), mtodo 389 transparent, propiedad 221 true, constante 6 try..catch..finally statement 157 tx, propiedad 389 ty, propiedad 390 typeof, operador 124
U undefined, constante 7 unescape function 54 union(), mtodo 547 unloadMovie function 55 unloadMovieNum function 55 V var, sentencia 160 void operator 125 W while, sentencia 161 width, propiedad 548 with, sentencia 162 X x, propiedad 528, 549 Y y, propiedad 528, 549

Flashlite 2.x 3.x Aslr

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Flashlite 2.x 3.x Aslr

Uploaded by

Copyright:

Available Formats

ADOBE FLASH LITE 2.x y 3.

Referencia del lenguaje Adobe ActionScript

2008 Adobe Systems Incorporated. Todos los derechos reservados.

ExtendedKey Function Key LoadVars Math Mouse

Matrix (flash.geom.Matrix)) MovieClip

MovieClipLoader NetConnection NetStream Number Object

Point (flash.geom.Point) Security (System.security) Selection Sonido Stage String SharedObject

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X iv

TextFormat Video XML

Funciones globales no admitidas

Controladores de eventos no admitidos Funciones fscommand no admitidas ndice

Captulo 1: Elementos del lenguaje ActionScript

Directivas del compilador

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 2

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 3

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 4

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 5

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 6

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 7

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 8

El resultado siguiente se muestra en el panel Salida.

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

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 9

isFinite(expression:Objec t) : Boolean isNaN(expression:Object

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 10

loadMovie(url:String, target:Object, [method:String]) loadMovieNum(url:String , level:Number, [method:String]) loadVariables(url:String,

nextFrame() nextScene() Number(expression:Obje

parseFloat(string:String) Convierte una cadena en un nmero de coma flotante.

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 11

parseInt(expression:Stri ng, [radix:Number]) : Number play() prevFrame() prevScene() random(value:Number) :

Convierte una cadena en un entero.

Elimina el clip de pelcula especificado.

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

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

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 12

numElements o la lista de elementos, pero no los dos.

Valor devuelto Array - Una matriz. Ejemplo

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 13

Valor devuelto Boolean - Valor booleano.

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 14

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

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 15

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 16

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 17

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 18

Disponibilidad Flash Lite 1.0 Parmetros

Tambin puede utilizar el cdigo ActionScript siguiente:

Vase tambin Array, set variable, sentencia

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 19

Disponibilidad Flash Lite 1.1 Parmetros

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 20

Funcin global unescape()

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 21

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 22

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

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 23

myBtn_btn.onRelease = function(){ getURL("mailto:you@somedomain.com"); };

La funcin getVersion devuelve la cadena siguiente:

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 24

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 25

especificados. Vase tambin

REFERENCIA DEL LENGUAJE ACTIONSCRIPT DE FLASH LITE 2.X Y 3.X 26

Disponibilidad Flash Lite 1.0 Parmetros