Diccionario de ActionScript

macromedia

Marcas comerciales Afterburner, AppletAce, Attain, Attain Enterprise Learning System, Attain Essentials, Attain Objects for Dreamweaver, Authorware, Authorware Attain, Authorware Interactive Studio, Authorware Star, Authorware Synergy, Backstage, Backstage Designer, Backstage Desktop Studio, Backstage Enterprise Studio, Backstage Internet Studio, Design in Motion, Director, Director Multimedia Studio, Doc Around the Clock, Dreamweaver, Dreamweaver Attain, Drumbeat, Drumbeat 2000, Extreme 3D, Fireworks, Flash, Fontographer, FreeHand, FreeHand Graphics Studio, Generator, Generator Developer's Studio, Generator Dynamic Graphics Server, Knowledge Objects, Knowledge Stream, Knowledge Track, Lingo, Live Effects, Macromedia, Macromedia M Logo & Desing, Macromedia Flash, Macromedia Xres, Macromind, Macromind Action, MAGIC, Mediamaker, Object Authoring, Power Applets, Priority Access, Roundtrip HTML, Scriptlets, SoundEdit, ShockRave, Shockmachine, Shockwave, Shockwave Remote, Shockwave Internet Studio, Showcase, Tools to Power Your Ideas, Universal Media, Virtuoso, Web Design 101, Whirlwind y Xtra son marcas comerciales de Macromedia, Inc. y pueden estar registradas en los Estados Unidos o en otras jurisdicciones, incluidas las internacionales. Otros nombres de productos, logotipos, diseos, ttulos, palabras o frases mencionados en esta publicacin pueden ser marcas comerciales, marcas de servicio o nombres registrados de Macromedia, Inc. o de otras entidades y pueden estar registrados en ciertas jurisdicciones, incluidas las internacionales. Informacin de terceros La tecnologa de compresin y descompresin de voz tiene licencia de Nellymoser, Inc. (www.nellymoser.com). La tecnologa de compresin y descompresin de video Sorenson Spark tiene licencia de Sorenson Media, Inc.

Esta gua contiene vnculos a sitios Web de terceros que no estn bajo el control de Macromedia y, por consiguiente, Macromedia no se hace responsable del contenido de dichos sitios Web. El acceso a uno de los sitios Web de terceros mencionados en esta gua ser a cuenta y riesgo del usuario. Macromedia proporciona estos vnculos nicamente como ayuda y su inclusin no implica que Macromedia se haga responsable del contenido de dichos sitios Web. Limitacin de garantas de Apple APPLE COMPUTER, INC. NO GARANTIZA, DE FORMA EXPRESA NI IMPLCITA, LA COMERCIABILIDAD O IDONEIDAD PARA UN FIN DETERMINADO DEL PAQUETE DE SOFTWARE INFORMTICO INCLUIDO. LA EXCLUSIN DE GARANTAS IMPLCITAS NO EST PERMITIDA EN ALGUNOS ESTADOS. LA RESTRICCIN ANTERIOR PUEDE NO AFECTARLE. ESTA GARANTA LE PROPORCIONA DERECHOS LEGALES ESPECFICOS. PUEDE TENER OTROS DERECHOS QUE VARAN SEGN LA LEGISLACIN LOCAL. Copyright 2002 Macromedia, Inc. Todos los derechos reservados. No se permite la copia, fotocopia, reproduccin, traduccin ni la conversin en formato electrnico o legible por equipos, ya sea de forma total o parcial, sin la autorizacin previa por escrito de Macromedia, Inc. Agradecimientos Director: Erick Vera Productor: Wayne Wieseler Redaccin: Jody Bleyle, JuLee Burdekin, Mary Burger, Dale Crawford, Marcelle Taylor Diseo de las instrucciones: Stephanie Gowin, Barbara Nelson Edicin: Rosana Francescato, Lisa Stanziano, Anne Szabla Produccin y diseo multimedia: Aaron Begley, Benjamin Salles, Noah Zilberberg Produccin y diseo de impresin: Chris Basmajian, Caroline Branch Localizacin: Michael Dominguez, Cristina Guembe, Yoshika Hedberg, Tim Hussey, Masayo "Noppe" Noda, Simone Pux, Yoko Shindo, Yuko Yagi Primera edicin: marzo de 2002 Macromedia, Inc. 600 Townsend St. San Francisco, CA 94103

CONTENIDO

Entrada de muestra para la mayora de los elementos de ActionScript . . . . . . . . . . . . . . 21 Entrada de muestra para objetos y componentes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Contenido del diccionario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 (decremento) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 ++ (incremento) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 ! (NOT lgico) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 != (desigualdad) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 !== (desigualdad estricta) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 % (mdulo). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 %= (asignacin de mdulo). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 & (AND en modo bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 && (AND de cortocircuito) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 &= (asignacin AND en modo bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 () (parntesis) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 (menos) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 * (multiplicacin) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 *= (asignacin de multiplicacin) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 , (coma). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 . (punto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 ?: (condicional) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 / (divisin). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 // (delimitador de comentario) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 /* (delimitador de comentario) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 /= (asignacin de divisin). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 [] (acceso a matriz) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 ^(XOR en modo bit). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 ^= (asignacin XOR en modo bit). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 {} (inicializador de objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 | (OR en modo bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 || (OR lgico) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 |= (asignacin OR en modo bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 ~ (NOT en modo bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 + (suma) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 += (asignacin de suma) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 < (menor que) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 << (desplazamiento a la izquierda en modo bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 <<= (desplazamiento a la izquierda en modo bit y asignacin) . . . . . . . . . . . . . . . . . . . . 67 <= (menor o igual que) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

<> (desigualdad) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 = (asignacin) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 -= (asignacin de resta) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 == (igualdad) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 === (igualdad estricta) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 > (mayor que) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 >= (mayor o igual que) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 >> (desplazamiento a la derecha en modo bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 >>= (desplazamiento a la derecha en modo bit y asignacin) . . . . . . . . . . . . . . . . . . . . . 75 >>> (desplazamiento a la derecha en modo bit sin signo). . . . . . . . . . . . . . . . . . . . . . . . 76 >>>= (desplazamiento a la derecha en modo bit sin signo y asignacin) . . . . . . . . . . . . . 77 Accessibility (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 Accessibility.isActive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 and . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 arguments (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 arguments.callee . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 arguments.caller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 arguments.length. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 Array (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 Array.concat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 Array.join . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Array.length. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Array.pop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 Array.push . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 Array.reverse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 Array.shift . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 Array.slice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 Array.sort. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 Array.sortOn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 Array.splice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 Array.toString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 Array.unshift . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 asfunction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 Boolean (funcin) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 Boolean (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 Boolean.toString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 Boolean.valueOf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 break . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 Button (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 Resumen de eventos del objeto Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 Button._alpha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 Button.enabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 Button._focusrect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 Button.getDepth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 Button._height . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 Button._highquality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 Button._name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 Button.onDragOut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 Button.onDragOver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

Contenido

Button.onKeyDown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 Button.onKeyUp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 Button.onKillFocus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 Button.onPress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 Button.onRelease . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 Button.onReleaseOutside . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 Button.onRollOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 Button.onRollOver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 Button.onSetFocus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 Button._parent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 Button._quality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 Button._rotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 Button._soundbuftime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 Button.tabEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 Button.tabIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 Button._target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 Button.trackAsMenu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 Button._url . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 Button.useHandCursor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 Button._visible . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 Button._width. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 Button._x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 Button._xmouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 Button._xscale. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 Button._y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 Button._ymouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 Button._yscale. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 call function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 case . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 chr. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 clearInterval. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 Color (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 Color.getRGB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 Color.getTransform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 Color.setRGB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 Color.setTransform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 continue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 CustomActions (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 CustomActions.get . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 CustomActions.install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 CustomActions.list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 CustomActions.uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 Date (objeto). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 Date.getDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 Date.getDay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 Date.getFullYear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 Date.getHours. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 Date.getMilliseconds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 Date.getMinutes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

Contenido

Date.getMonth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 Date.getSeconds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 Date.getTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 Date.getTimezoneOffset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 Date.getUTCDate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 Date.getUTCDay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 Date.getUTCFullYear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 Date.getUTCHours . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 Date.getUTCMilliseconds. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 Date.getUTCMinutes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 Date.getUTCMonth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 Date.getUTCSeconds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 Date.getYear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 Date.setDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 Date.setFullYear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 Date.setHours . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 Date.setMilliseconds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 Date.setMinutes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 Date.setMonth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 Date.setSeconds. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 Date.setTime. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 Date.setUTCDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 Date.setUTCFullYear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 Date.setUTCHours . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 Date.setUTCMilliseconds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 Date.setUTCMinutes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 Date.setUTCMonth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 Date.setUTCSeconds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 Date.setYear. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 Date.toString. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 Date.UTC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 default . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 delete. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 do while . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 duplicateMovieClip. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 else . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 else if . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 #endinitclip. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 eq (igual, especfico de cadena) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 escape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 eval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 evaluate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 false . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 FCheckBox (componente). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 FCheckBox.getEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 FCheckBox.getLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 FCheckBox.getValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 FCheckBox.registerSkinElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 FCheckBox.setChangeHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149 FCheckBox.setEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

Contenido

FCheckBox.setLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 FCheckBox.setLabelPlacement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 FCheckBox.setSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 FCheckBox.setStyleProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 FCheckBox.setValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 FComboBox (componente). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 FComboBox.addItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 FComboBox.addItemAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 FComboBox.getEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158 FComboBox.getItemAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158 FComboBox.getLength . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 FComboBox.getRowCount. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 FComboBox.getScrollPosition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160 FComboBox.getSelectedIndex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160 FComboBox.getSelectedItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161 FComboBox.getValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162 FComboBox.registerSkinElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162 FComboBox.removeAll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 FComboBox.removeItemAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 FComboBox.replaceItemAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 FComboBox.setChangeHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165 FComboBox.setDataProvider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 FComboBox.setEditable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 FComboBox.setEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 FComboBox.setItemSymbol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 FComboBox.setRowCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 FComboBox.setSelectedIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170 FComboBox.setSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170 FComboBox.setStyleProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171 FComboBox.setValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171 FComboBox.sortItemsBy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172 FListBox (componente). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 FListBox.addItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 FListBox.addItemAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175 FListBox.getEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176 FListBox.getItemAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176 FListBox.getLength . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177 FListBox.getRowCount. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178 FListBox.getScrollPosition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178 FListBox.getSelectedIndex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 FListBox.getSelectedIndices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 FListBox.getSelectedItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180 FListBox.getSelectedItems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180 FListBox.getSelectMultiple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181 FListBox.getValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 FListBox.registerSkinElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 FListBox.removeAll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183 FListBox.removeItemAt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184 FListBox.replaceItemAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184 FListBox.setAutoHideScrollBar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185

Contenido

FListBox.setChangeHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 FListBox.setDataProvider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 FListBox.setEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188 FListBox.setItemSymbol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189 FListBox.setRowCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189 FListBox.setScrollPosition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190 FListBox.setSelectedIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190 FListBox.setSelectedIndices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191 FListBox.setSelectMultiple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191 FListBox.setSize. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 FListBox.setStyleProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 FListBox.setWidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 FListBox.sortItemsBy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 _focusrect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194 for . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194 for..in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 FPushButton (componente) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 FPushButton.getEnabled. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198 FPushButton.getLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 FPushButton.registerSkinElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 FPushButton.setClickHandler. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 FPushButton.setEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201 FPushButton.setLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202 FPushButton.setSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202 FPushButton.setStyleProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203 FRadioButton (componente). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203 FRadioButton.getData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204 FRadioButton.getEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205 FRadioButton.getLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205 FRadioButton.getState . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206 FRadioButton.getValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206 FRadioButton.registerSkinElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207 FRadioButton.setChangeHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208 FRadioButton.setData. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209 FRadioButton.setEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210 FRadioButton.setGroupName. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210 FRadioButton.setLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211 FRadioButton.setLabelPlacement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212 FRadioButton.setSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212 FRadioButton.setState. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213 FRadioButton.setStyleProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214 FRadioButton.setValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214 FScrollBar (componente). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 FScrollBar.getEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216 FScrollBar.getScrollPosition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217 FScrollBar.registerSkinElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217 FScrollBar.setChangeHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218 FScrollBar.setEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220 FScrollBar.setHorizontal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220 FScrollBar.setLargeScroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221

Contenido

FScrollBar.setScrollContent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221 FScrollBar.setScrollPosition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222 FScrollBar.setScrollProperties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223 FScrollBar.setScrollTarget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223 FScrollBar.setSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224 FScrollBar.setSmallScroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224 FScrollBar.setStyleProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225 FScrollPane (componente). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 FScrollPane.getPaneHeight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227 FScrollPane.getPaneWidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228 FScrollPane.getScrollContent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 FScrollPane.getScrollPosition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 FScrollPane.loadScrollContent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230 FScrollPane.refreshPane. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 FScrollPane.registerSkinElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 FScrollPane.setDragContent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232 FScrollPane.setHScroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233 FScrollPane.setScrollContent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233 FScrollPane.setScrollPosition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234 FScrollPane.setSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234 FScrollPane.setStyleProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 FScrollPane.setVScroll. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236 FStyleFormat (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236 Resumen de propiedades del objeto FStyleFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237 FStyleFormat.addListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 FStyleFormat.applyChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 FStyleFormat.arrow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240 FStyleFormat.background . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241 FStyleFormat.backgroundDisabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241 FStyleFormat.check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242 FStyleFormat.darkshadow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242 FStyleFormat.face . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243 FStyleFormat.foregroundDisabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243 FStyleFormat.highlight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244 FStyleFormat.highlight3D. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244 FStyleFormat.radioDot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245 FStyleFormat.removeListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245 FStyleFormat.scrollTrack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246 FStyleFormat.selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246 FStyleFormat.selectionDisabled. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247 FStyleFormat.selectionUnfocused . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247 FStyleFormat.shadow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248 FStyleFormat.textAlign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248 FStyleFormat.textBold. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 FStyleFormat.textColor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 FStyleFormat.textDisabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250 FStyleFormat.textFont. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250 FStyleFormat.textIndent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250 FStyleFormat.textItalic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251 FStyleFormat.textLeftMargin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251

Contenido

FStyleFormat.textRightMargin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252 FStyleFormat.textSelected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252 FStyleFormat.textSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253 FStyleFormat.textUnderline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253 Function (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254 Function.apply . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254 Function.call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255 Function.prototype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256 fscommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256 function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258 ge (mayor o igual que, especfico de cadena) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259 getProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260 getTimer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260 getURL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 getVersion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262 _global . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262 globalStyleFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263 gotoAndPlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264 gotoAndStop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264 gt (mayor que, especfico de cadena) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265 _highquality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265 if . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265 ifFrameLoaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267 #include . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267 #initclip. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268 instanceof . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269 int . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270 isFinite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270 isNaN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271 Key (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271 Key.addListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273 Key.BACKSPACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273 Key.CAPSLOCK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273 Key.CONTROL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274 Key.DELETEKEY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274 Key.DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274 Key.END . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274 Key.ENTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274 Key.ESCAPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275 Key.getAscii . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275 Key.getCode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275 Key.HOME. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276 Key.INSERT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276 Key.isDown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276 Key.isToggled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277 Key.LEFT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277 Key.onKeyDown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277 Key.onKeyUp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278 Key.PGDN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278 Key.PGUP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278

10

Contenido

Key.removeListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278 Key.RIGHT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279 Key.SHIFT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279 Key.SPACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279 Key.TAB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279 Key.UP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280 le (menor o igual que; especfico para cadenas) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280 length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280 _level. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281 loadMovie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282 loadMovieNum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283 loadVariables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284 loadVariablesNum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285 LoadVars (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286 LoadVars.contentType. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288 LoadVars.getBytesLoaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288 LoadVars.getBytesTotal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288 LoadVars.load . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289 LoadVars.loaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289 LoadVars.onLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289 LoadVars.send . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290 LoadVars.sendAndLoad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291 LoadVars.toString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291 lt (menor que; especfico para cadenas) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292 Math (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293 Math.abs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294 Math.acos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294 Math.asin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295 Math.atan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295 Math.atan2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295 Math.ceil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296 Math.cos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296 Math.E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 Math.exp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 Math.floor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298 Math.log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298 Math.LOG2E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299 Math.LOG10E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299 Math.LN2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299 Math.LN10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300 Math.max . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300 Math.min . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301 Math.PI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301 Math.pow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301 Math.random . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 Math.round. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 Math.sin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303 Math.sqrt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303 Math.SQRT1_2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303 Math.SQRT2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304

Contenido

11

Math.tan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304 maxscroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305 mbchr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305 mblength. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305 mbord . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306 mbsubstring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306 method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307 Mouse (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307 Mouse.addListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308 Mouse.hide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308 Mouse.onMouseDown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309 Mouse.onMouseMove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309 Mouse.onMouseUp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310 Mouse.removeListener. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310 Mouse.show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310 MovieClip (objeto). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311 MovieClip._alpha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315 MovieClip.attachMovie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315 MovieClip.beginFill. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316 MovieClip.beginGradientFill. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317 MovieClip.clear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321 MovieClip.createEmptyMovieClip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321 MovieClip.createTextField. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322 MovieClip._currentframe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323 MovieClip.curveTo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323 MovieClip._droptarget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324 MovieClip.duplicateMovieClip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325 MovieClip.enabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326 MovieClip.endFill . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326 MovieClip.focusEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327 MovieClip._focusrect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327 MovieClip._framesloaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327 MovieClip.getBounds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328 MovieClip.getBytesLoaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328 MovieClip.getBytesTotal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329 MovieClip.getDepth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329 MovieClip.getURL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329 MovieClip.globalToLocal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330 MovieClip.gotoAndPlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331 MovieClip.gotoAndStop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331 MovieClip._height . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332 MovieClip._highquality. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332 MovieClip.hitArea. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332 MovieClip.hitTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333 MovieClip.lineStyle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334 MovieClip.lineTo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335 MovieClip.loadMovie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336 MovieClip.loadVariables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337 MovieClip.localToGlobal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337 MovieClip.moveTo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338

12

Contenido

MovieClip._name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339 MovieClip.nextFrame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339 MovieClip.onData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339 MovieClip.onDragOut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340 MovieClip.onDragOver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340 MovieClip.onEnterFrame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341 MovieClip.onKeyDown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341 MovieClip.onKeyUp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342 MovieClip.onKillFocus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343 MovieClip.onLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343 MovieClip.onMouseDown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344 MovieClip.onMouseMove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344 MovieClip.onMouseUp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345 MovieClip.onPress. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345 MovieClip.onRelease. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346 MovieClip.onReleaseOutside . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346 MovieClip.onRollOut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347 MovieClip.onRollOver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347 MovieClip.onSetFocus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348 MovieClip.onUnload. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348 MovieClip._parent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349 MovieClip.play . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349 MovieClip.prevFrame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349 MovieClip.removeMovieClip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350 MovieClip._rotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350 MovieClip.setMask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350 MovieClip._soundbuftime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351 MovieClip.startDrag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351 MovieClip.stop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352 MovieClip.stopDrag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352 MovieClip.swapDepths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353 MovieClip.tabChildren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353 MovieClip.tabEnabled. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354 MovieClip.tabIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354 MovieClip._target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355 MovieClip._totalframes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355 MovieClip.trackAsMenu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355 MovieClip.unloadMovie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356 MovieClip._url . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356 MovieClip.useHandCursor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356 MovieClip._visible . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 MovieClip._width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 MovieClip._x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358 MovieClip._xmouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358 MovieClip._xscale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358 MovieClip._y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359 MovieClip._ymouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359 MovieClip._yscale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359 NaN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360 ne (no igual; especfico para cadenas). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360

Contenido

13

new . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360 newline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361 nextFrame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362 nextScene . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362 not . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363 null . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363 Number (funcin) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364 Number (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364 Number.MAX_VALUE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366 Number.MIN_VALUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366 Number.NaN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366 Number.NEGATIVE_INFINITY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366 Number.POSITIVE_INFINITY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367 Number.toString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367 Number.valueOf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367 Object (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368 Object.addProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369 Object.__proto__ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370 Object.registerClass . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371 Object.toString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373 Object.unwatch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373 Object.valueOf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374 Object.watch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374 onClipEvent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376 on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378 or . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379 ord . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379 _parent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380 parseFloat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380 parseInt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381 play . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382 prevFrame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382 prevScene . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383 print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384 printAsBitmap. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385 printAsBitmapNum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386 printNum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387 _quality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389 random . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389 removeMovieClip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390 return . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390 _root . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391 scroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392 Selection (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393 Selection.addListener. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394 Selection.getBeginIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394 Selection.getCaretIndex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395 Selection.getEndIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395 Selection.getFocus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395 Selection.onSetFocus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396

14

Contenido

Selection.removeListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396 Selection.setFocus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397 Selection.setSelection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397 set variable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398 setInterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399 setProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401 Sound (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401 Sound.attachSound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403 Sound.duration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403 Sound.getBytesLoaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404 Sound.getBytesTotal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404 Sound.getPan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405 Sound.getTransform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405 Sound.getVolume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406 Sound.loadSound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406 Sound.onLoad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407 Sound.onSoundComplete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407 Sound.position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408 Sound.setPan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408 Sound.setTransform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409 Sound.setVolume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411 Sound.start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412 Sound.stop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412 _soundbuftime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413 Stage (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413 Stage.addListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414 Stage.align . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415 Stage.height. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415 Stage.onResize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415 Stage.removeListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416 Stage.scaleMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416 Stage.width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417 startDrag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417 stop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418 stopAllSounds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418 stopDrag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419 String (funcin). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419 " " (delimitador de cadena) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420 String (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421 String.charAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422 String.charCodeAt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423 String.concat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423 String.fromCharCode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424 String.indexOf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424 String.lastIndexOf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425 String.length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425 String.slice. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425 String.split. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426 String.substr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427 String.substring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427

Contenido

15

String.toLowerCase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428 String.toUpperCase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428 substring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429 super . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429 switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430 System (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431 System.capabilities (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432 System.capabilities.hasAudioEncoder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433 System.capabilities.hasAccessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433 System.capabilities.hasAudio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433 System.capabilities.hasMP3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433 System.capabilities.language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434 System.capabilities.manufacturer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435 System.capabilities.os . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435 System.capabilities.pixelAspectRatio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435 System.capabilities.screenColor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435 System.capabilities.screenDPI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436 System.capabilities.screenResolution.x. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436 System.capabilities.screenResolution.y. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436 System.capabilities.version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436 System.capabilities.hasVideoEncoder. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437 targetPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437 tellTarget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437 TextField (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439 TextField._alpha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441 TextField.addListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442 TextField.autoSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442 TextField.background . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443 TextField.backgroundColor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443 TextField.border . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443 TextField.borderColor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443 TextField.bottomScroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444 TextField.embedFonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444 TextField._focusrect. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444 TextField.getDepth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445 TextField.getFontList. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445 TextField.getNewTextFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445 TextField.getTextFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446 TextField._height. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446 TextField._highquality. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447 TextField.hscroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447 TextField.html. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448 TextField.htmlText . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448 TextField.length. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448 TextField.maxChars. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449 TextField.maxhscroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449 TextField.maxscroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449 TextField.multiline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449 TextField._name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450 TextField.onChanged . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450

16

Contenido

TextField.onKillFocus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450 TextField.onScroller. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451 TextField.onSetFocus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451 TextField._parent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451 TextField.password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452 TextField._quality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452 TextField.removeListener. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453 TextField.removeTextField. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453 TextField.replaceSel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453 TextField.restrict . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454 TextField._rotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455 TextField.scroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455 TextField.selectable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455 TextField.setNewTextFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456 TextField.setTextFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456 TextField._soundbuftime. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457 TextField.tabEnabled. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458 TextField.tabIndex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458 TextField._target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459 TextField.text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459 TextField.textColor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459 TextField.textHeight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459 TextField.textWidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460 TextField.type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460 TextField._url . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460 TextField.variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460 TextField._visible. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461 TextField._width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461 TextField.wordWrap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461 TextField._x. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462 TextField._xmouse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462 TextField._xscale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462 TextField._y. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463 TextField._ymouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463 TextField._yscale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463 TextFormat (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464 TextFormat.align . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466 TextFormat.blockIndent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466 TextFormat.bold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466 TextFormat.bullet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466 TextFormat.color. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467 TextFormat.font . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467 TextFormat.getTextExtent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467 TextFormat.indent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467 TextFormat.italic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468 TextFormat.leading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468 TextFormat.leftMargin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468 TextFormat.rightMargin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468 TextFormat.size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469 TextFormat.tabStops . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469

Contenido

17

TextFormat.target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469 TextFormat.underline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469 TextFormat.url . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470 this . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470 toggleHighQuality. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471 trace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471 true . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472 typeof . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472 undefined . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473 unescape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474 unloadMovie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475 unloadMovieNum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476 updateAfterEvent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476 var . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477 void . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477 while . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478 with. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479 XML (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482 XML.appendChild . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484 XML.attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484 XML.childNodes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485 XML.cloneNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485 XML.contentType. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486 XML.createElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486 XML.createTextNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487 XML.docTypeDecl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487 XML.firstChild . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488 XML.getBytesLoaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488 XML.getBytesTotal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488 XML.hasChildNodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489 XML.ignoreWhite. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489 XML.insertBefore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490 XML.lastChild . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490 XML.load . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490 XML.loaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491 XML.nextSibling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492 XML.nodeName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492 XML.nodeType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492 XML.nodeValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493 XML.onData. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493 XML.onLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494 XML.parentNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495 XML.parseXML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495 XML.previousSibling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495 XML.removeNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496 XML.send . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496 XML.sendAndLoad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497 XML.status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497 XML.toString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498 XML.xmlDecl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498

18

Contenido

XMLSocket (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499 XMLSocket.close. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501 XMLSocket.connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501 XMLSocket.onClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502 XMLSocket.onConnect. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503 XMLSocket.onData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504 XMLSocket.onXML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505 XMLSocket.send . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506

Contenido

19

20

Contenido

Diccionario de ActionScript

En este diccionario se describe la sintaxis y el uso de los elementos de ActionScript en Macromedia Flash MX. Para utilizar los ejemplos de un script, copie el cdigo de ejemplo del Diccionario de ActionScript y pguelo en el panel Acciones en modo Experto. En el diccionario aparece una lista de todos los elementos ActionScript: operadores, palabras clave, sentencias, acciones, propiedades, funciones, objetos, componentes y mtodos. Para ver una introduccin de todas las entradas del diccionario, consulte Contenido del diccionario en la pgina 23; las tablas de esta seccin son un buen punto de partida para buscar operadores simblicos o mtodos cuya clase de objeto o de componente no se conoce. ActionScript sigue el estndar ECMA-262 (especificacin desarrollada por la Asociacin Europea de Fabricantes de Ordenadores, European Computer Manufacturers Association) a no ser que se indique lo contrario. Algunos elementos ActionScript de Flash 5 (y anteriores) se han desestimado y sustituido por nuevos elementos ActionScript que cumplen el estndar ECMA. Es recomendable utilizar los nuevos elementos de Flash MX, aunque Flash Player 5 an admite los elementos desestimados. Existen dos tipos de entradas en este diccionario:

Entradas individuales para operadores, palabras clave, funciones, variables, propiedades,

mtodos y sentencias.

Entradas de objetos y de componentes que proporcionan informacin general acerca de los

objetos y los componentes de Flash incorporados. Utilice esta informacin en las entradas de ejemplo para interpretar la estructura y las convenciones utilizadas en estos dos tipos de entradas.

Entrada de muestra para la mayora de los elementos de ActionScript

En la siguiente entrada de diccionario de muestra se describen las convenciones utilizadas para todos los elementos ActionScript que no son objetos ni componentes. Ttulo de la entrada Todas las entradas aparecen en la lista en orden alfabtico. El orden alfabtico no distingue entre maysculas y minsculas, pasa por alto los signos de subrayado iniciales, etc.

21

Disponibilidad

En esta seccin se indica qu versiones de Flash Player admiten el elemento. No se trata de la versin de Flash utilizada para editar el contenido. Por ejemplo, si utiliza la herramienta de edicin de Flash MX para crear contenido para Flash Player 5, slo puede utilizar elementos ActionScript que estn disponibles para Flash Player 5.
Sintaxis

En esta seccin se proporciona la sintaxis correcta para utilizar el elemento ActionScript en el cdigo. La parte necesaria de la sintaxis se muestra con la fuente para cdigo y el cdigo que debe proporcionar el usuario se muestra con la fuente para cdigo en cursiva. Los corchetes ([]) indican parmetros opcionales.
Parmetros

En esta seccin se describen los parmetros listados en la sintaxis.

Valor devuelto

En esta seccin se identifican los valores que el elemento devuelve, si los hay.
Descripcin

En esta seccin se identifica el tipo de elemento (por ejemplo, operador, mtodo, funcin, etc.) y, a continuacin, se describe cmo utilizarlo.
Ejemplo

En esta seccin aparece un ejemplo de cdigo que muestra cmo utilizar el elemento.
Vase tambin

En esta seccin se muestra una lista de las entradas del diccionario de ActionScript relacionadas.

Entrada de muestra para objetos y componentes

En la siguiente entrada de muestra del diccionario se explican las convenciones utilizadas para los objetos y componentes ActionScript incorporados. Los objetos y los componentes aparecen en una lista en orden alfabtico con todos los dems elementos del diccionario. Los componentes de Flash aparecen como FCheckBox, FComboBox, etc. Ttulo de la entrada El ttulo de la entrada proporciona el nombre del objeto. El nombre del objeto o del componente va seguido por un prrafo que contiene informacin general descriptiva. Tablas de resumen sobre mtodos y propiedades Cada entrada de objeto y componente contiene una tabla que ofrece una lista de los mtodos asociados. Si el objeto o componente tiene propiedades (a menudo constantes), estos elementos se resumen en una tabla adicional. Todos los mtodos y propiedades que aparecen en la lista de estas tablas tambin tienen sus propias entradas en el diccionario, que siguen a la entrada del objeto o componente. Constructor Si un objeto o componente exige que se utilice un constructor para acceder a sus mtodos y propiedades, el constructor se describe en cada entrada de objeto o componente. Esta descripcin tiene todos los elementos estndar (sintaxis, descripcin, etc.) de las otras entradas del diccionario.

22

Listas de mtodos y propiedades Los mtodos y las propiedades de un objeto o componente aparecen en orden alfabtico despus de la entrada del objeto o componente.

Contenido del diccionario

Todas las entradas del diccionario aparecen en la lista en orden alfabtico. Sin embargo, algunos operadores son smbolos y se presentan en orden ASCII. Adems, los mtodos que estn asociados con un objeto o componente aparecen con el nombre del objeto o componente: por ejemplo, el mtodo abs del objeto Math aparece como Math.abs y el mtodo getValue del componente FRadioButton aparece como FRadioButton.getValue. Las dos tablas siguientes le ayudan a localizar estos elementos. En la primera tabla aparece una lista de los operadores simblicos en el orden en el que aparecen en el diccionario. En la segunda tabla aparecen todos los dems elementos ActionScript.
Nota: para ver la prioridad y la asociatividad de los operadores, consulte el Apndice B, Precedencia de operadores y asociatividad en la publicacin Utilizacin de Flash. Operadores simblicos ++ ! != !== % %= & && &= () * *= , . ?: / // /* /= [] ^ (decremento) ++ (incremento) ! (NOT lgico) != (desigualdad) !== (desigualdad estricta) % (mdulo) %= (asignacin de mdulo) & (AND en modo bit) && (AND de cortocircuito) &= (asignacin AND en modo bit) () (parntesis) (menos) * (multiplicacin) *= (asignacin de multiplicacin) , (coma) . (punto) ?: (condicional) / (divisin) // (delimitador de comentario) /* (delimitador de comentario) /= (asignacin de divisin) [] (acceso a matriz) ^(XOR en modo bit)

Diccionario de ActionScript

23

Operadores simblicos ^= {} | || |= ~ + += < << <<= <= <> = -= == === > >= >> >>= >>> >>>= ^= (asignacin XOR en modo bit) {} (inicializador de objeto) | (OR en modo bit) || (OR lgico) |= (asignacin OR en modo bit) ~ (NOT en modo bit) + (suma) += (asignacin de suma) < (menor que) << (desplazamiento a la izquierda en modo bit) <<= (desplazamiento a la izquierda en modo bit y asignacin) <= (menor o igual que) <> (desigualdad) = (asignacin) -= (asignacin de resta) == (igualdad) === (igualdad estricta) > (mayor que) >= (mayor o igual que) >> (desplazamiento a la derecha en modo bit) >>= (desplazamiento a la derecha en modo bit y asignacin) >>> (desplazamiento a la derecha en modo bit sin signo) >>>= (desplazamiento a la derecha en modo bit sin signo y asignacin)

En la tabla siguiente se muestra una lista de todos los elementos de ActionScript que no son operadores simblicos.
Elemento de ActionScript abs acos add addItem addItemAt addListener addProperty and Vase la entrada Math.abs Math.acos add FComboBox.addItem, FListBox.addItem FComboBox.addItemAt, FListBox.addItem FStyleFormat.addListener, Key.addListener, Mouse.addListener, Selection.addListener, Stage.addListener, TextField.addListener Object.addProperty and

24

Elemento de ActionScript align _alpha appendChild apply applyChanges Arguments Array arrow asfunction asin atan atan2 attachMovie attachSound attributes autosize background backgroundColor backgroundDisabled BACKSPACE beginFill beginGradientFill blockIndent bold Boolean border borderColor bottomScroll break bullet Button call call function callee caller capabilities

Vase la entrada Stage.align, TextFormat.align MovieClip._alpha, Button._alpha, TextField._alpha XML.appendChild Function.apply FStyleFormat.applyChanges arguments (objeto) Array (objeto) FStyleFormat.arrow asfunction Math.asin Math.atan Math.atan2 MovieClip.attachMovie Sound.attachSound XML.attributes TextField.autoSize FStyleFormat.background, TextField.background TextField.backgroundColor FStyleFormat.backgroundDisabled Key.BACKSPACE MovieClip.beginFill MovieClip.beginGradientFill TextFormat.blockIndent TextFormat.bold Boolean (funcin), Boolean (objeto) TextField.border TextField.borderColor TextField.bottomScroll break TextFormat.bullet Button (objeto) call, Function.call call function arguments.callee arguments.caller System.capabilities (objeto)

Diccionario de ActionScript

25

Elemento de ActionScript CAPSLOCK case ceil charAt charCodeAt check childNodes chr clear clearInterval cloneNode close Color concat connect constructor

Vase la entrada Key.CAPSLOCK case Math.ceil String.charAt String.charCodeAt FStyleFormat.check XML.childNodes chr MovieClip.clear clearInterval XML.cloneNode XMLSocket.close Color (objeto), TextFormat.color Array.concat, String.concat XMLSocket.connect Array (objeto), Boolean (objeto), Color (objeto), Date (objeto), Number (funcin), Object (objeto), Sound (objeto), String (objeto), XML (objeto), XMLSocket (objeto) LoadVars.contentType, XML.contentType continue Key.CONTROL Math.cos XML.createElement MovieClip.createEmptyMovieClip MovieClip.createTextField XML.createTextNode MovieClip._currentframe MovieClip.curveTo Date (objeto) FStyleFormat.darkshadow default delete Key.DELETEKEY XML.docTypeDecl do while Key.DOWN MovieClip._droptarget

contentType ccntinue CONTROL cos createElement createEmptyMovieClip createTextField createTextNode _currentframe curveTo Date darkshadow default delete DELETEKEY docTypeDecl do while DOWN _droptarget

26

Elemento de ActionScript duplicateMovieClip duration E #endinitclip else else if embedFonts enab led END endFill ENTER eq escape (funcin) ESCAPE (constante) eval evaluate exp face false FCheckBox FComboBox firstChild FListBox floor focusEnabled _focusrect font for for..in foregroundDisabled FPushButton FRadioButton _framesloaded fromCharCode fscommand

Vase la entrada duplicateMovieClip, MovieClip.duplicateMovieClip Sound.duration Math.E #endinitclip else else if TextField.embedFonts Button.enabled, MovieClip.enabled Key.END MovieClip.endFill Key.ENTER eq (igual, especfico de cadena) escape Key.ESCAPE eval evaluate Math.exp FStyleFormat.face false FCheckBox (componente) FListBox (componente) XML.firstChild FListBox (componente) Math.floor MovieClip.focusEnabled _focusrect, Button._focusrect, TextField._focusrect, MovieClip._focusrect TextFormat.font for for..in FStyleFormat.foregroundDisabled FPushButton (componente) FPushButton (componente) MovieClip._framesloaded String.fromCharCode fscommand

Diccionario de ActionScript

27

Elemento de ActionScript FScrollBar FScrollPane FStyleFormat function ge get getAscii getBeginIndex getBounds getBytesLoaded getBytesTotal getCaretIndex getCode getData getDate getDay getDepth getEnabled

Vase la entrada FScrollBar (componente) FScrollPane (componente) FStyleFormat (objeto) function, Function (objeto) ge (mayor o igual que, especfico de cadena) CustomActions.get Key.getAscii Selection.getBeginIndex MovieClip.getBounds LoadVars.getBytesLoaded, MovieClip.getBytesLoaded, Sound.getBytesLoaded, XML.getBytesLoaded LoadVars.getBytesTotal, MovieClip.getBytesTotal, Sound.getBytesTotal, XML.getBytesTotal Selection.getCaretIndex Key.getCode FRadioButton.getData Date.getDate Date.getDay Button.getDepth, MovieClip.getDepth, TextField.getDepth FCheckBox.getEnabled, FComboBox.getEnabled, FListBox.getEnabled, FPushButton.getEnabled, FRadioButton.getEnabled, FScrollBar.getEnabled Selection.getEndIndex Selection.getFocus TextField.getFontList Date.getFullYear Date.getHours FComboBox.getItemAt, FListBox.addItemAt FCheckBox.getLabel, FPushButton.getLabel, FRadioButton.getLabel FComboBox.getLength, FListBox.getLength Date.getMilliseconds Date.getMinutes Date.getMonth TextField.getNewTextFormat Sound.getPan FScrollPane.getPaneHeight FScrollPane.getPaneWidth

getEndIndex getFocus getFontList getFullYear getHours getItemAt getLabel getLength getMilliseconds getMinutes getMonth getNewTextFormet getPan getPaneHeight getPaneWidth

28

Elemento de ActionScript getProperty getRowCount getRGB getScrollContent getScrollPosition getSeconds getSelectedIndex getSelectedIndices getSelectedItem getSelectedItems getSelectMultiple getState getTextExtent getTextFormat getTime getTimer getTimezoneOffset getTransform getURL getUTCDate getUTCDay getUTCFullYear getUTCHours getUTCMilliseconds getUTCMinutes getUTCMonth getUTCSeconds getValue getVersion getVolume getYear _global globalStyleFormat globalToLocal goto

Vase la entrada getProperty FComboBox.getRowCount, FListBox.getRowCount Color.getRGB FScrollPane.getScrollContent FComboBox.getScrollPosition, FListBox.getScrollPosition, FScrollBar.getScrollPosition, FScrollPane.getScrollPosition Date.getSeconds FComboBox.getSelectedIndex, FListBox.getSelectedIndex FListBox.getSelectedIndices FComboBox.getSelectedItem, FListBox.getSelectedItem FListBox.getSelectedItem FListBox.getSelectMultiple FRadioButton.getState TextFormat.getTextExtent TextField.getTextFormat Date.getTime getTimer Date.getTimezoneOffset Color.getTransform, Sound.getTransform getURL, MovieClip.getURL Date.getUTCDate Date.getUTCDay Date.getUTCFullYear Date.getUTCHours Date.getUTCMilliseconds Date.getUTCMinutes Date.getUTCMonth Date.getUTCSeconds FCheckBox.getValue, FComboBox.getValue, FListBox.getValue, FRadioButton.getValue getVersion Sound.getVolume Date.getYear _global globalStyleFormat MovieClip.globalToLocal gotoAndPlay, gotoAndStop

Diccionario de ActionScript

29

Elemento de ActionScript gotoAndPlay gotoAndStop gt hasAccessibility hasAudio hasAudioEncoder hasMP3 hasVideoEncoder hasChildNodes height _height hide highlight highlight3D _highquality hitArea hitTest HOME hscroll html htmlText if ifFrameLoaded ignoreWhite #include indent indexOf #initclip INSERT insertBefore install instanceof int isActive isDown

Vase la entrada gotoAndPlay, MovieClip.gotoAndPlay gotoAndStop, MovieClip.gotoAndStop gt (mayor que, especfico de cadena) System.capabilities.hasAccessibility System.capabilities.hasAudio System.capabilities.hasAudioEncoder System.capabilities.hasMP3 System.capabilities.hasVideoEncoder XML.hasChildNodes Stage.height MovieClip._height, TextField._height, Button._height Mouse.hide FStyleFormat.highlight FStyleFormat.highlight3D _highquality, Button._highquality, MovieClip._highquality, TextField._highquality MovieClip.hitArea MovieClip.hitTest Key.HOME TextField.hscroll TextField.html TextField.htmlText if ifFrameLoaded XML.ignoreWhite #include TextFormat.indent String.indexOf #initclip Key.INSERT XML.insertBefore CustomActions.install instanceof int Accessibility.isActive Key.isDown

30

Elemento de ActionScript isFinite isNaN isToggled italic join Key language lastChild lastIndexOf le leading LEFT leftMargin length level lineStyle lineTo list LN2 LN10 load loaded loadMovie loadMovieNum loadScrollContent loadSound loadVariables loadVariablesNum LoadVars localToGlobal log LOG2E LOG10E lt manufacturer

Vase la entrada isFinite isNaN Key.isToggled TextFormat.italic Array.join Key (objeto) System.capabilities.language XML.lastChild String.lastIndexOf le (menor o igual que; especfico para cadenas) TextFormat.leading Key.LEFT TextFormat.leftMargin arguments.length, Array.length, String.length, Sound.loadSound, TextField.length _level MovieClip.lineStyle MovieClip.lineTo CustomActions.uninstall Math.LN2 Math.LN10 XML.load, LoadVars.load XML.loaded, LoadVars.loaded loadMovie, MovieClip.loadMovie loadMovieNum FScrollPane.loadScrollContent Sound.loadSound loadVariables, MovieClip.loadVariables loadVariablesNum LoadVars (objeto) MovieClip.localToGlobal Math.log Math.LOG2E Math.LOG10E lt (menor que; especfico para cadenas) System.capabilities.manufacturer

Diccionario de ActionScript

31

Elemento de ActionScript Math max maxChars maxhscroll maxscroll MAX_VALUE mbchr mblength mbord mbsubstring method min MIN_VALUE Mouse moveTo MovieClip multiline _name NaN ne NEGATIVE_INFINITY new (operador) newline nextFrame nextScene nextSibling nodeName nodeType nodeValue not null Number Object on onClipEvent onClose

Vase la entrada Math (objeto) Math.max TextField.maxChars TextField.maxhscroll maxscroll, TextField.maxscroll Number.MAX_VALUE mbchr mblength mbord mbsubstring method Math.min Number.MIN_VALUE Mouse (objeto) MovieClip.moveTo MovieClip (objeto) TextField.multiline MovieClip._name, TextField._name, Button._name NaN, Number.NaN ne (no igual; especfico para cadenas) Number.NEGATIVE_INFINITY new newline nextFrame, MovieClip.nextFrame nextScene XML.nextSibling XML.nodeName XML.nodeType XML.nodeValue not null Number (funcin), Number (objeto) Object (objeto) on onClipEvent XMLSocket.onClose

32

Elemento de ActionScript onChanged onConnect onData onDragOut onDragOver onEnterFrame onKeyDown onKeyUp onKillFocus onLoad onMouseDown onMouseMove onMouseUp onPress onRelease onReleaseOutisde onResize onRollOut onRollOver onScroller onSetFocus onSort onSoundComplete onUnload onXML or (OR lgico) ord os _parent parentNode parseFloat parseInt parseXML password PGDN

Vase la entrada TextField.onChanged XMLSocket.onConnect XML.onData, XMLSocket.onData Button.onDragOut, MovieClip.onDragOut Button.onDragOver, MovieClip.onDragOver MovieClip.onEnterFrame Button.onKeyDown, Key.onKeyDown, MovieClip.onKeyDown Button.onKeyUp, Key.onKeyUp, MovieClip.onKeyUp Button.onKillFocus, MovieClip.onKillFocus, TextField.onKillFocus LoadVars.onLoad, MovieClip.onLoad, Sound.onLoad, XML.onLoad Mouse.onMouseDown, MovieClip.onMouseDown Mouse.onMouseMove, MovieClip.onMouseMove Mouse.onMouseUp, MovieClip.onMouseUp Button.onPress, MovieClip.onPress Button.onRelease, MovieClip.onRelease Button.onReleaseOutside, MovieClip.onReleaseOutside Stage.onResize Button.onRollOut Button.onRollOver TextField.onScroller Button.onSetFocus, MovieClip.onSetFocus, Selection.onSetFocus, TextField.onSetFocus Array.pop Sound.onSoundComplete MovieClip.onUnload XMLSocket.onXML or ord System.capabilities.os _parent, Button._parent, MovieClip._parent, TextField._parent XML.parentNode parseFloat parseInt XML.parseXML TextField.password Key.PGDN

Diccionario de ActionScript

33

Elemento de ActionScript PGUP PI pixelAspectRatio play pop position POSITIVE_INFINITY pow prevFrame previousSibling prevScene print printAsBitmap printAsBitmapNum printNum __proto__ push _quality radioDot random refreshPane registerClass registerSkinElement

Vase la entrada Key.PGUP Math.PI System.capabilities.pixelAspectRatio play, MovieClip.play Array.pop Sound.position Number.POSITIVE_INFINITY Math.pow prevFrame, MovieClip.prevFrame XML.previousSibling prevScene print printAsBitmap printAsBitmapNum printNum Object.__proto__ Array.push _quality, TextField._quality, Button._quality FStyleFormat.radioDot random, Math.random FScrollPane.refreshPane Object.registerClass FCheckBox.registerSkinElement, FComboBox.registerSkinElement, FListBox.registerSkinElement, FPushButton.registerSkinElement, FRadioButton.registerSkinElement, FScrollPane.registerSkinElement FComboBox.removeAll, FListBox.removeAll FComboBox.removeItemAt, FListBox.removeItemAt FStyleFormat.removeListener, Key.removeListener, Mouse.removeListener, Selection.removeListener, Stage.removeListener, TextField.removeListener removeMovieClip, MovieClip.removeMovieClip XML.removeNode TextField.removeTextField FComboBox.replaceItemAt, FListBox.replaceItemAt TextField.replaceSel Capabilities.screenResolutionX Capabilities.screenResolutionY

removeAll removeItemAt removeListener

removeMovieClip removeNode removeTextField replaceItemAt replaceSel resolutionX resolutionY

34

Elemento de ActionScript restrict return reverse RIGHT rightMargin _root _rotation round scaleMode screenColor screenDPI screenResolution.x screenResolution.y scroll scrollTrack selectable selection Selection selectionDisabled selectionUnfocused send sendAndLoad set variable setAutoHideScrollBar setChangeHandler

Vase la entrada TextField.restrict return Array.reverse Key.RIGHT TextFormat.rightMargin _root MovieClip._rotation, Button._rotation, TextField._rotation Math.round Stage.scaleMode System.capabilities.screenColor System.capabilities.screenDPI System.capabilities.screenResolution.x System.capabilities.screenResolution.y scroll, TextField.scroll FStyleFormat.scrollTrack TextField.selectable FStyleFormat.selection Selection (objeto) FStyleFormat.selectionDisabled FStyleFormat.selectionUnfocused LoadVars.send, XML.send, XMLSocket.send LoadVars.sendAndLoad, XML.sendAndLoad set variable FListBox.setAutoHideScrollBar FCheckBox.setChangeHandler, FComboBox.setChangeHandler, FListBox.setChangeHandler, FRadioButton.setChangeHandler, FScrollBar.setChangeHandler FPushButton.setClickHandler FRadioButton.setData FComboBox.setDataProvider, FListBox.setDataProvider Date.setDate FScrollPane.setDragContent FComboBox.setEditable FCheckBox.setEnabled,FComboBox.setEnabled, FListBox.setEnabled, FPushButton.setEnabled, FRadioButton.setEnabled, FScrollBar.setEnabled Selection.setFocus

setClickHandler setData setDataProvider setDate setDragContent setEditable setEnabled

setFocus

Diccionario de ActionScript

35

Elemento de ActionScript setFullYear setGroupName setHorizontal setHours setHScroll setInterval setItemSymbol setLabel setLabelPlacement setLargeScroll setMask setMilliseconds setMinutes setMonth setNewTextFormat setPan setProperty setRGB setRowCount setScrollContent setScrollPosition setScrollProperties setScrollTarget setSeconds setSelectedIndex setSelectedIndices setSelection setSelectMultiple setSize setSmallScroll setState setStyleProperty

Vase la entrada Date.setFullYear FRadioButton.setGroupName FScrollBar.setHorizontal Date.setHours FScrollPane.setHScroll setInterval FComboBox.setItemSymbol, FListBox.setItemSymbol FCheckBox.setLabel, FPushButton.setLabel, FRadioButton.setLabel FCheckBox.setLabelPlacement, FRadioButton.setLabelPlacement FScrollBar.setLargeScroll MovieClip.setMask Date.setMilliseconds Date.setMinutes Date.setMonth TextField.setNewTextFormat Sound.setPan setProperty Color.setRGB FComboBox.setRowCount, FListBox.setRowCount FScrollBar.setSize, FScrollPane.setScrollContent FListBox.setScrollPosition, FScrollBar.setScrollPosition, FScrollPane.setScrollPosition FScrollBar.setScrollProperties FScrollBar.setScrollTarget Date.setSeconds FComboBox.setSelectedIndex, FListBox.setSelectedIndex FListBox.setSelectedIndices Selection.setSelection FListBox.setSelectMultiple FCheckBox.setSize, FComboBox.setSize, FListBox.setSize, FPushButton.setSize, FScrollBar.setSize, FScrollPane.setSize FScrollBar.setSmallScroll FRadioButton.setState FCheckBox.setStyleProperty, FComboBox.setStyleProperty, FListBox.setStyleProperty, FPushButton.setStyleProperty, FRadioButton.setStyleProperty, FScrollBar.setStyleProperty, FScrollPane.setStyleProperty TextField.setTextFormat

setTextFormat

36

Elemento de ActionScript setTime setTransform setUTCDate setUTCFullYear setUTCHours setUTCMilliseconds setUTCMinutes setUTCMonth setUTCSeconds setValue setVolume setVScroll setWidth setYear shadow shift (mtodo) SHIFT (constante) show sin size slice sort sortItemsBy Sound _soundbuftime SPACE splice split sqrt SQRT1_2 SQRT2 start startDrag status stop

Vase la entrada Date.setTime Color.setTransform, Sound.setTransform Date.setUTCDate Date.setUTCFullYear Date.setUTCHours Date.setUTCMilliseconds Date.setUTCMinutes Date.setUTCMonth Date.setUTCSeconds FCheckBox.setValue, FComboBox.setValue, FRadioButton.setValue Sound.setVolume FScrollPane.setVScroll FListBox.setWidth Date.setYear FStyleFormat.shadow Array.shift Key.SHIFT Mouse.show Math.sin TextFormat.size Array.slice, String.slice Array.sort FComboBox.sortItemsBy, FListBox.sortItemsBy Sound (objeto) _soundbuftime, TextField._soundbuftime, MovieClip._soundbuftime, Button._soundbuftime Key.SPACE Array.splice String.split Math.sqrt Math.SQRT1_2 Math.SQRT2 Sound.start startDrag, MovieClip.startDrag XML.status stop, MovieClip.stop, Sound.stop

Diccionario de ActionScript

37

Elemento de ActionScript stopAllSounds stopDrag String substr substring super swapDepths switch System TAB tabChildren tabEnabled tabIndex tabStops tan target _target targetPath tellTarget text textAlign textBold textColor textDisabled TextField textFont TextFormat textHeight textIndent textItalic textLeftMargin textRightMargin textSelected textSize textUnderline textWidth

Vase la entrada stopAllSounds stopDrag, MovieClip.stopDrag String (funcin), String (objeto) String.substring substring, String.substring super MovieClip.swapDepths switch System (objeto) Key.TAB MovieClip.tabChildren Button.tabEnabled, TextField.tabEnabled, MovieClip.tabEnabled Button.tabIndex, MovieClip.tabIndex, TextField.tabIndex TextFormat.tabStops Math.tan TextFormat.target Button._target, MovieClip._target, TextField._target targetPath tellTarget TextField.text FStyleFormat.textAlign FStyleFormat.textBold FStyleFormat.textColor, TextField.textColor FStyleFormat.textDisabled TextField (objeto) FStyleFormat.textFont TextFormat (objeto) TextField.textHeight FStyleFormat.textIndent FStyleFormat.textItalic FStyleFormat.textLeftMargin FStyleFormat.textRightMargin FStyleFormat.textSelected FStyleFormat.textSize FStyleFormat.textUnderline TextField.textWidth

38

Elemento de ActionScript this toggleHighQuality toLowerCase toString _totalframes toUpperCase trace trackAsMenu true type typeof undefined underline unescape uninstall unloadMovie unLoadMovieNum unshift unwatch UP updateAfterEvent url _url useHandCursor UTC valueOf var variable version _visible void watch while width _width

Vase la entrada this toggleHighQuality String.toLowerCase Array.toString, Boolean.toString, Date.toString, Number.toString, Object.toString, XML.toString MovieClip._totalframes String.toUpperCase trace Button.trackAsMenu, MovieClip.trackAsMenu true TextField.type typeof undefined TextFormat.underline unescape CustomActions.uninstall unloadMovie, MovieClip.unloadMovie unloadMovieNum Array.unshift Object.unwatch Key.UP updateAfterEvent TextFormat.url MovieClip._url, TextField._url, Button._url Button.useHandCursor, MovieClip.useHandCursor Date.UTC Boolean.valueOf, Number.valueOf, Object.valueOf var TextField.variable System.capabilities.version MovieClip._visible, Button._visible, TextField._visible void Object.watch while Stage.width MovieClip._width, TextField._width, Button._width

Diccionario de ActionScript

39

Elemento de ActionScript with wordwrap _x XML xmlDecl XMLSocket _xmouse _xscale _y _ymouse _yscale

Vase la entrada with TextField.wordWrap Button._x, MovieClip._x, TextField._x XML (objeto) XML.xmlDecl XMLSocket (objeto) Button._xmouse, MovieClip._xmouse, TextField._xmouse Button._xscale, MovieClip._xscale, TextField._xscale Button._y, MovieClip._y, TextField._y Button._ymouse, MovieClip._ymouse, TextField._ymouse Button._yscale, MovieClip._yscale, TextField._yscale

40

 (decremento)
Disponibilidad

Flash Player 4.
Sintaxis

expresin expresin
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Operador (aritmtico); operador unario de decremento previo y decremento posterior que resta 1 a la expresin. La forma de decremento previo del operador (expresin) resta 1 a la expresin y devuelve el resultado. La forma de decremento posterior del operador (expresin) resta 1 a la expresin y devuelve el valor inicial de la expresin (el valor antes de la resta).
Ejemplo

La forma de decremento previo del operador decrementa x a 2 (x - 1 = 2) y devuelve el resultado como y:

x = 3; y = --x; //y es igual a 2

La forma de decremento posterior del operador decrementa x a 2 (x - 1 = 2) y devuelve el valor original de x como resultado y:
x = 3; y = x-//y es igual a 3

++ (incremento)
Disponibilidad

Flash Player 4.
Sintaxis

++expresin expresin++
Parmetros

Ninguno.
Valor devuelto

Ninguno.

Diccionario de ActionScript

41

Descripcin

Operador (aritmtico); operador unario de incremento previo e incremento posterior que suma 1 a la expresin. La expresin puede ser una variable, un elemento de una matriz o una propiedad de un objeto. La forma de incremento previo del operador (++expresin) suma 1 a la expresin y devuelve el resultado. La forma de incremento posterior del operador (expresin++) suma 1 a la expresin y devuelve el valor inicial de la expresin (el valor antes de la suma). La forma de incremento previo del operador incrementa x a 2 (x + 1 = 2) y devuelve el resultado como y:
x = 1; y = ++x //y es igual a 2

La forma de incremento posterior del operador incrementa x a 2 (x + 1 = 2) y devuelve el valor original de x como resultado y:
x = 1; y = x++; //y es igual a 1
Ejemplo

En el ejemplo siguiente se utiliza ++ como operador de incremento posterior para ejecutar cinco veces un bucle while.
i = 0; while(i++ < 5){ trace("sta es la ejecucin " + i); }

En el ejemplo siguiente se utiliza ++ como operador de incremento previo:

var a = []; var i = 0; while (i < 10) { a.push(++i); } trace(a.join());

Este script muestra el resultado siguiente en la ventana Salida:

1,2,3,4,5,6,7,8,9,10

En el ejemplo siguiente se utiliza ++ como operador de incremento posterior:

var a = []; var i = 0; while (i < 10) { a.push(i++); } trace(a.join());

Este script muestra el resultado siguiente en la ventana Salida:

0,1,2,3,4,5,6,7,8,9

! (NOT lgico)
Disponibilidad

Flash Player 4.

42

Sintaxis

!expresin
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Operador (lgico); invierte el valor booleano de una variable o expresin. Si expresin es una variable con el valor absoluto o convertido true, el valor de !expresin es false. Si la expresin x && y da como resultado false, la expresin !(x && y) da como resultado true. En las expresiones siguientes se ilustra el resultado de la utilizacin del operador !:
!true

devuelve false devuelve true

!false

Ejemplo

En el ejemplo siguiente, la variable happy se establece en false. La condicin if comprueba la condicin !happy y si la condicin es true, la accin trace enva una cadena a la ventana Salida.
happy = false; if (!happy) { trace("no te preocupes, s feliz"); }

!= (desigualdad)
Disponibilidad

Flash Player 5.
Sintaxis

expresin1 != expresin2
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Operador (desigualdad); comprueba exactamente lo contrario que el operador ==. Si expresin1 es igual a expresin2, el resultado es false. Al igual que con el operador ==, la definicin de igual depende de los tipos de datos que se comparan.

Los nmeros, cadenas y los valores booleanos se comparan por valor. Las variables, objetos, matrices y funciones se comparan por referencia.
Ejemplo

En el ejemplo siguiente se muestra el resultado del operador !=:

5 != 8 5 != 5

devuelve true devuelve false

Diccionario de ActionScript

43

En este ejemplo se ilustra la utilizacin del operador != en una sentencia if.

a = "David"; b = "Tonto" if (a != b){ trace("David no es tonto"); }
Vase tambin

!== (desigualdad estricta), == (igualdad), === (igualdad estricta)

!== (desigualdad estricta)

Disponibilidad

Flash Player 6.
Sintaxis

expresin1 !== expresin2

Descripcin

Operador; comprueba exactamente lo contrario que el operador ===. El operador de desigualdad estricta realiza las mismas acciones que el operador de desigualdad, salvo que no hay conversin de los tipos de datos. Si expresin1 es igual a expresin2 y sus tipos de datos son iguales, el resultado es false. Al igual que con el operador ===, la definicin de igual depende de los tipos de datos que se comparen.

Los nmeros, cadenas y los valores booleanos se comparan por valor. Las variables, objetos, matrices y funciones se comparan por referencia.
Ejemplo

En el cdigo siguiente se muestra el valor devuelto de las operaciones que utilizan operadores de igualdad, de igualdad estricta y de desigualdad estricta.
s1 = new String("5"); s2 = new String("5"); s3 = new String("Hola"); n = new Number(5); b = new Boolean(true); s1 s1 s1 s1 s1 s1 s1 s1 s1 s1 s1 s1 == == == == === === === === !== !== !== !== s2; // true s3; // false n; // true b; // false s2; // true s3; // false n; // false b; // false s2; // false s3; // true n; // true b; // true

Vase tambin

!= (desigualdad), == (igualdad), === (igualdad estricta)

44

% (mdulo)
Disponibilidad

Flash Player 4. En archivos de Flash 4, el operador % se expande en el archivo SWF como x int(x/y) * y; adems, puede que no sea tan rpido ni preciso en las versiones posteriores de Flash Player.
Sintaxis

expresin1 % expresin2
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Operador (aritmtico); calcula el resto de expresin1 dividida por expresin2. Si cualquiera de los parmetros de expresin no es numrico, el operador mdulo intenta convertirlos en nmeros. La expresin puede ser un nmero o una cadena que se convierte en un valor numrico.
Ejemplo

A continuacin, se muestra un ejemplo numrico en el que se utiliza el operador mdulo (%).

trace (12 % 5); // devuelve 2 trace (4.3 % 2.1); // devuelve aproximadamente 0.1

%= (asignacin de mdulo)
Disponibilidad

Flash Player 4.
Sintaxis

expresin1 %= expresin2
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Operador (asignacin compuesta aritmtica); asigna a expresin1 el valor de expresin1 % expresin2. Por ejemplo, las dos expresiones siguientes son iguales:
x %= y x = x % y

Diccionario de ActionScript

45

Ejemplo

En el ejemplo siguiente se asigna el valor 4 a la variable x.

x = 14; y = 5; trace(x %= y); // devuelve 4
Vase tambin

% (mdulo)

& (AND en modo bit)

Disponibilidad

Flash Player 5. En Flash 4, el operador & se utilizaba para concatenar cadenas. En Flash 5, el operador & es un operador AND en modo bit y deben utilizarse los operadores add y + para concadenar cadenas. Los archivos de Flash 4 que utilizan el operador & se actualizan automticamente de forma que pasen a utilizar add al abrirlos en el entorno de edicin de Flash 5.
Sintaxis

expresin1 & expresin2

Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Operador (en modo bit); convierte expresin1 y expresin2 en nmeros enteros de 32 bits sin signo y realiza una operacin booleana AND en cada bit de los parmetros enteros. El resultado es un nuevo nmero entero de 32 bits sin signo.

&& (AND de cortocircuito)

Disponibilidad

Flash Player 4.
Sintaxis

expresin1 && expresin2

Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Operador (lgico); realiza una operacin booleana en los valores de una o ambas expresiones. Calcula el resultado de expresin1 (la expresin situada a la izquierda del operador) y devuelve false si la expresin da como resultado false. Si expresin1 da como resultado true, el resultado es expresin2 (la expresin situada a la derecha del operador). Si expresin2 da como resultado true, el resultado final es true; si no, es false.

46

Ejemplo

En este ejemplo se utiliza el operador && para realizar una prueba a fin de determinar si un jugador ha ganado el juego. La variable turns y la variable score se actualizan para reflejar los turnos jugados y los puntos que consigue el jugador durante el juego. El script siguiente muestra Ha ganado! en la ventana Salida cuando la puntuacin del jugador alcanza los 75 puntos o ms en 3 turnos o menos.
turns=2; score=77; winner = (turns <= 3) && (score >= 75); if (winner) { trace("Ha ganado!"); } else { trace("Intntelo de nuevo!"); }

&= (asignacin AND en modo bit)

Disponibilidad

Flash Player 5.
Sintaxis

expresin1 &= expresin2

Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Operador (asignacin compuesta en modo bit); asigna a expresin1 el valor de expresin1 & expresin2. Por ejemplo, las dos expresiones siguientes son iguales.
x &= y x = x & y
Ejemplo

En el ejemplo siguiente el valor 9 se asigna a x.

x = 15; y = 9; trace(x &= y); // devuelve 9
Vase tambin

& (AND en modo bit)

Diccionario de ActionScript

47

() (parntesis)
Disponibilidad

Flash Player 4.
Sintaxis

(expresin1, expresin2); funcin(parmetro1,..., parmetroN);

Parmetros

expresin1, expresin2 funcin

Nmeros, cadenas, variables o texto.

Funcin que se va a realizar en el contenido de los parntesis.

parmetro1...parmetroN

Serie de parmetros que deben ejecutarse antes de que los resultados se pasen como parmetros a la funcin de fuera de los parntesis.

Valor devuelto

Ninguno.
Descripcin

Operador; realiza una operacin de agrupacin en uno o ms parmetros o rodea uno o ms parmetros y los pasa como parmetros a una funcin fuera de los parntesis. Sintaxis 1: controla el orden en que se ejecutan los operadores en la expresin. Los parntesis prevalecen sobre el orden de precedencia normal y hacen que las expresiones que contienen se calculen primero. Cuando los parntesis estn anidados, el contenido de los parntesis interiores se calcula antes que el contenido de los exteriores. Sintaxis 2: rodea uno o ms parmetros y los pasa como parmetros a la funcin de fuera de los parntesis.
Ejemplo

Sintaxis 1: en las sentencias siguientes se muestra la utilizacin de los parntesis para controlar el orden de ejecucin de las expresiones. El valor de cada expresin se muestra debajo de cada lnea, de la manera siguiente:
trace((2 + 3) * (4 + 5)); // muestra 45 trace(2 + (3 * (4 + 5))); // muestra 29 trace(2 + (3 * 4) + 5); // muestra 19

Sintaxis 2: en los ejemplos siguientes se muestra la utilizacin de los parntesis con funciones.
getDate(); invoice(item, amount); function traceParameter(param){ trace(param); } traceParameter(2*2);
Vase tambin

with

48

 (menos)
Disponibilidad

Flash Player 4.
Sintaxis

(Negacin) expresin (Resta) expresin1 - expresin2

Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Operador (aritmtico); utilizado para negacin o resta. Sintaxis 1: cuando se utiliza para negar, invierte el signo de la expresin numrica. Sintaxis 2: cuando se utiliza para restar, realiza una resta aritmtica en dos expresiones numricas, de manera que se sustrae expresin2 de expresin1. Cuando ambas expresiones son nmeros enteros, la diferencia es un nmero entero. Cuando una o ambas expresiones son nmeros de coma flotante, la diferencia es un nmero de coma flotante.
Ejemplo

Sintaxis 1: en la sentencia siguiente se invierte el signo de la expresin 2 + 3.

-(2 + 3)

El resultado es -5. Sintaxis 2: en la sentencia siguiente se resta el entero 2 del entero 5.

5 - 2

El resultado es 3, que es un entero. Sintaxis 2: en la sentencia siguiente se resta el nmero de coma flotante 1,5 del nmero de coma flotante 3,25.
3.25 - 1.5

El resultado es 1,75, que es un nmero de coma flotante.

Diccionario de ActionScript

49

* (multiplicacin)
Disponibilidad

Flash Player 4.
Sintaxis

expresin1 * expresin2
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Operador (aritmtico); multiplica dos expresiones numricas. Cuando ambas expresiones son nmeros enteros, el producto es un nmero entero. Cuando una o ambas expresiones son nmeros de coma flotante, el producto es un nmero de coma flotante.
Ejemplo

En la sentencia siguiente se multiplican los enteros 2 y 3:

2 * 3

El resultado es 6, que es un entero.

Ejemplo

En esta sentencia se multiplican los nmeros de coma flotante 2,0 y 3,1416:

2.0 * 3.1416

El resultado es 6,2832, que es un nmero de coma flotante.

*= (asignacin de multiplicacin)
Disponibilidad

Flash Player 4.
Sintaxis

expresin1 *= expresin2
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Operador (asignacin compuesta aritmtica); asigna a expresin1 el valor de expresin1 * expresin2. Por ejemplo, las dos expresiones siguientes son iguales:
x *= y x = x * y

50

Ejemplo

En el ejemplo siguiente se asigna el valor 50 a la variable x.

x = 5; y = 10; trace (x *= y); // devuelve 50
Ejemplo

En las lneas segunda y tercera del ejemplo siguiente se calculan las expresiones situadas a la derecha de los signos igual y se asignan los resultados a x e y.
i = 5; x = 4 - 6; y = i + 2; trace(x *= y); // devuelve -14
Vase tambin

* (multiplicacin)

, (coma)
Disponibilidad

Flash Player 4.
Sintaxis

expresin1, expresin2
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Operador; calcula el resultado de expresin1, despus, el de expresin2 y devuelve el valor de expresin2. Este operador se utiliza principalmente con la sentencia de bucle for.
Ejemplo

El siguiente cdigo de ejemplo utiliza el operador coma:

var a=1, b=2, c=3;

Esto equivale a escribir el cdigo siguiente:

var a=1; var b=2; var c=3;

Diccionario de ActionScript

51

. (punto)
Disponibilidad

Flash Player 4.
Sintaxis

objeto.propiedad_o_mtodo nombre_instancia.variable nombre_instancia.instancia_secundaria.variable

Parmetros

objeto Instancia de un objeto. El objeto puede ser cualquiera de los objetos incorporados de ActionScript o un objeto personalizado. Este parmetro siempre se encuentra a la izquierda del operador punto (.). propiedad_o_mtodo Nombre de una propiedad o mtodo asociado con un objeto. Todos los mtodos y propiedades vlidos de los objetos incorporados se listan en las tablas de resumen de mtodos y propiedades de ese objeto. Este parmetro siempre se encuentra a la derecha del operador punto (.). nombre_instancia

Nombre de instancia de un clip de pelcula. Instancia de clip de pelcula que depende de otro clip de pelcula o

instancia_secundaria

que est anidado en ste.

variable

Variable de la lnea de tiempo del nombre de instancia de clip de pelcula situado a la izquierda del operador (.).

Valor devuelto

Ninguno.
Descripcin

Operador; se utiliza para desplazarse por las jerarquas de clips de pelcula a fin de acceder a clips de pelcula anidados, a variables o a propiedades. El operador punto tambin se utiliza para comprobar o establecer las propiedades de un objeto, ejecutar un mtodo de un objeto o crear una estructura de datos.
Ejemplo

En la sentencia siguiente se identifica el valor actual de la variable hairColor en el clip de pelcula person.
person.hairColor

Esto es equivalente a la sintaxis de Flash 4 que se muestra a continuacin:

/person:hairColor
Ejemplo

En el cdigo siguiente se muestra como el operador punto puede utilizarse para crear una estructura de matriz.
account.name = "Gary Smith"; account.address = "123 Main St"; account.city = "Any Town"; account.state = "CA"; account.zip = "12345";
Vase tambin

[] (acceso a matriz)

52

?: (condicional)
Disponibilidad

Flash Player 4.
Sintaxis

expresin1 ? expresin2
Parmetros

: expresin3

expresin1 Expresin que da como resultado un valor booleano, normalmente una expresin de comparacin, como x < 5. expresin2, expresin3
Valor devuelto

Valores de cualquier tipo.

Ninguno.
Descripcin

Operador; ordena a Flash que calcule el resultado de expresin1 y, si el valor de expresin1 es true, devuelve el valor de expresin2; en caso contrario, devuelve el valor de expresin3.
Ejemplo

En la sentencia siguiente se asigna el valor de la variable x a la variable z porque expresin1 da como resultado true:
x = 5; y = 10; z = (x < 6) ? x: y; trace (z); // devuelve 5

/ (divisin)
Disponibilidad

Flash Player 4.
Sintaxis

expresin1 / expresin2
Parmetros

expresin

Nmero o variable que da como resultado un nmero.

Valor devuelto

Ninguno.
Descripcin

Operador (aritmtico); divide la expresin1 por la expresin2. El resultado de la operacin de divisin es un nmero de coma flotante de doble precisin.
Ejemplo

En la sentencia siguiente se divide el nmero de coma flotante 22,0 por 7,0 y, a continuacin, se muestra el resultado en la ventana Salida:
trace(22.0 / 7.0);

El resultado es 3,1429, que es un nmero de coma flotante.

Diccionario de ActionScript

53

// (delimitador de comentario)
Disponibilidad

Flash 1.
Sintaxis

// comentario
Parmetros

comentario

Cualquier carcter.

Valor devuelto

Ninguno.
Descripcin

Comentario; indica el comienzo de un comentario de script. Cualquier carcter que aparezca entre el delimitador de comentario // y el carcter de final de lnea se interpreta como un comentario y el intrprete de ActionScript lo pasa por alto.
Ejemplo

En este script se utilizan delimitadores de comentario para identificar la primera, la tercera y la sptima lnea como comentarios.
// registra la posicin ballX = ball._x; // registra la posicin ballY = ball._y; // registra la posicin batX = bat._x; // registra la posicin batY = bat._y;
Vase tambin

X del clip de pelcula ball Y del clip de pelcula ball X del clip de pelcula bat Y del clip de pelcula bat

/* (delimitador de comentario)

/* (delimitador de comentario)
Disponibilidad

Flash Player 5.
Sintaxis

/* comentario */ /* comentario comentario */

Parmetros

comentario

Cualquier carcter.

Valor devuelto

Ninguno.

54

Descripcin

Comentario; indica una o ms lneas de comentarios del script. Cualquier carcter que aparezca entre la etiqueta de apertura de comentario /* y la etiqueta de cierre de comentario */ se interpreta como un comentario y el intrprete de ActionScript lo pasa por alto. Utilice el primer tipo de sintaxis para identificar comentarios de una sola lnea. Utilice el segundo tipo de sintaxis para identificar comentarios en varias lneas sucesivas. Si no se especifica la etiqueta de cierre */ cuando se utiliza esta forma de delimitador de comentario, se generar un mensaje de error.
Ejemplo

En este script se utilizan delimitadores de comentario al principio del script.

/* registra las posiciones X e Y de los clips de pelcula de ball y bat */ ballX = ball._x; ballY = ball._y; batX = bat._x; batY = bat._y;
Vase tambin

// (delimitador de comentario)

/= (asignacin de divisin)
Disponibilidad

Flash Player 4.
Sintaxis

expresin1 /= expresin2
Parmetros

expresin1,expresin2
Valor devuelto

Nmero o variable que da como resultado un nmero.

Ninguno.
Descripcin

Operador (asignacin compuesta aritmtica); asigna a expresin1 el valor de expresin1 / expresin2. Por ejemplo, las dos sentencias siguientes son iguales:
x /= y x = x / y
Ejemplo

A continuacin se muestra la utilizacin del operador /= con variables y nmeros:

x = 10; y = 2; x /= y; // x contiene ahora el valor 5

Diccionario de ActionScript

55

[] (acceso a matriz)
Disponibilidad

Flash Player 4.
Sintaxis

myArray = ["a0", a1,...aN]; myMultiDimensionalArray = [["a0",...aN],...["a0",...aN]] myArray[E] = valor myMultiDimensionalArray[E][E] = valor objeto[valor];
Parmetros

myArray

Nombre de una matriz. Elementos de una matriz. Nombre de una matriz multidimensional simulada.

a0, a1,...aN

myMultiDimensionalArray E

Nmero (o ndice) de un elemento de una matriz. Nombre de un objeto.

objeto

valor Cadena o expresin que da como resultado una cadena con el nombre de una propiedad del objeto.
Valor devuelto

Ninguno.
Descripcin

Operador; inicializa una nueva matriz o una matriz multidimensional con los elementos especificados (a0, etc.) o accede a los elementos de una matriz. El operador de acceso a matriz permite establecer y recuperar dinmicamente nombres de instancias, variables y objetos. Tambin permite acceder a propiedades de objetos. Sintaxis 1: una matriz es un objeto cuyas propiedades se denominan elementos, que se identifican individualmente mediante un nmero denominado ndice. Cuando se crea una matriz, los elementos se especifican con el operador de acceso a matriz (o corchetes). Una matriz puede contener elementos de varios tipos. Por ejemplo, la matriz siguiente, denominada employee, dispone de tres elementos; el primero es un nmero y los dos segundos son cadenas (entre comillas).
employee = [15, Begoa, Enrique];

Sintaxis 2: puede anidar corchetes para simular matrices multidimensionales. En el cdigo siguiente se crea una matriz denominada ticTacToe con tres elementos; cada elemento tambin es una matriz que contiene tres elementos.
ticTacToe = [[1,2,3],[4,5,6],[7,8,9]]; // elija Depurar > Mostrar variables en el modo de pelcula de prueba // para ver una lista de elementos de matriz

56

Sintaxis 3: especifique el ndice de cada elemento entre corchetes para acceder a l directamente; puede agregar un nuevo elemento a una matriz o cambiar o recuperar el valor de un elemento existente. El primer elemento de una matriz siempre es el 0:
myArray[0] = 15; myArray[1] = "Hola"; myArray[2] = true;

Puede utilizar corchetes para agregar un cuarto elemento como en el ejemplo siguiente:
myArray[3] = "Jorge";

Sintaxis 4: puede utilizar corchetes para acceder a un elemento de una matriz multidimensional. El primer grupo de corchetes identifica el elemento de la matriz original y el segundo grupo identifica el elemento en la matriz anidada. En la lnea de cdigo siguiente el nmero 6 se enva a la ventana Salida.
ticTacToe = [[1,2,3],[4,5,6],[7,8,9]]; trace(ticTacToe[1][2]); // devuelve 6

Sintaxis 5: puede utilizar el operador de acceso a matriz en lugar de la funcin eval para establecer y recuperar de forma dinmica los valores de nombres de clip o las propiedades de un objeto:
name["mc" + i] = "left_corner";
Ejemplo

Sintaxis 1: en los siguientes ejemplos de cdigo se muestran dos maneras diferentes de crear un nuevo objeto Array vaco; en la primera lnea se utilizan corchetes.
myArray =[]; myArray = new Array();

Sintaxis 1 y 2: en el ejemplo siguiente se crea una matriz denominada employee y se utiliza la accin trace para enviar elementos a la ventana Salida. En la cuarta lnea, se cambia un elemento de la matriz y la lnea quinta enva la matriz recin modificada a la ventana Salida:
employee=["Begoa", "Jorge", "Mara"]; trace(employee); // Begoa, Jorge, Mara employee[2]="Jos"; trace(employee); // Begoa, Jorge, Jos

Sintaxis 3: en el ejemplo siguiente, se calcula el resultado de la expresin entre corchetes ("piece" + i) y el resultado se utiliza como nombre de la variable que debe recuperarse del clip de pelcula mc. En este ejemplo, la variable i debe pertenecer a la misma lnea de tiempo que el botn. Si, por ejemplo, la variable i es igual a 5, el valor de la variable piece5 del clip de pelcula mc se visualizar en la ventana Salida:
on(release){ x = mc["piece"+i]; trace(x); }

Sintaxis 3: en el cdigo que se muestra a continuacin, se calcula el resultado de la expresin entre corchetes y ste se utiliza como nombre de la variable que se va a recuperar del clip de pelcula name:
group["A" + i];

Diccionario de ActionScript

57

Si est familiarizado con la sintaxis de barras de ActionScript de Flash 4, puede utilizar la funcin eval para obtener el mismo resultado:
eval("A" & i);

Sintaxis 3: puede utilizar el operador de acceso a matriz situado a la izquierda de una sentencia de asignacin para establecer dinmicamente nombres de instancias, variables y objetos:
name[index] = "Alberto";
Vase tambin

Array (objeto), Object (objeto), eval

^(XOR en modo bit)

Disponibilidad

Flash Player 5.
Sintaxis

expresin1 ^ expresin2
Parmetros

expresin1,expresin2
Valor devuelto

Nmero.

Ninguno.
Descripcin

Operador (en modo bit); convierte expresin1 y expresin2 en nmeros enteros de 32 bits sin signo y devuelve un 1 en cada posicin de bit donde los bits correspondientes de expresin1 o de expresin2, pero no ambos, son 1.
Ejemplo

En el ejemplo siguiente se utiliza el operador XOR en modo bit en los decimales 15 y 9 y se asigna el resultado a la variable x.
// decimal 15 = binario 1111 // decimal 9 = binario 1001 x = 15 ^ 9 trace(x) // 1111 ^ 1001 = 0110 // devuelve el decimal 6 (= binario 0110)

^= (asignacin XOR en modo bit)

Disponibilidad

Flash Player 5.
Sintaxis

expresin1 ^= expresin2
Parmetros

expresin1,expresin2
Valor devuelto

Enteros y variables.

Ninguno.

58

Descripcin

Operador (asignacin compuesta en modo bit); asigna a expresin1 el valor de expresin1 ^ expresin2. Por ejemplo, las dos sentencias siguientes son iguales:
x ^= y x = x ^ y
Ejemplo

A continuacin se muestra un ejemplo de una operacin ^=.

// decimal x = 15; // decimal y = 9; trace(x ^= //devuelve 15 = binario 1111 9 = binario 1001 y); el decimal 6 (= binario 0110)

Vase tambin

^(XOR en modo bit)

{} (inicializador de objeto)
Disponibilidad

Flash Player 5.
Sintaxis

objeto = {nombre1: valor1, nombre2: valor2,...nombreN: valorN};

Parmetros

objeto

Objeto que debe crearse. Nombres de las propiedades. Valores correspondientes para cada propiedad de nombre.

nombre1,2,...N valor1,2,...N
Valor devuelto

Ninguno.
Descripcin

Operador; crea un nuevo objeto y lo inicializa con los pares de propiedades nombre y valor especificados. Utilizar este operador es lo mismo que utilizar la sintaxis de new Object y asignar los pares de propiedades con el operador de asignacin. El prototipo del objeto recin creado se denomina genricamente objeto Object.
Ejemplo

En la primera lnea del cdigo siguiente se crea un objeto vaco con el operador de inicializador y en la segunda lnea se crea un nuevo objeto con una funcin constructor.
object = {}; object = new Object();

Diccionario de ActionScript

59

En el ejemplo siguiente se crea un objeto account y se inicializan las propiedades name, address, city, state, zip y balance con los valores correspondientes.
account = { name: "Betty Skate", address: "123 Main Street", city: "Blossomville", state: "California", zip: "12345", balance: "1000" };

El ejemplo siguiente muestra como los inicializadores de matriz y de objeto pueden anidarse unos dentro de otros.
person = { name: "Gina Vechio", children: [ "Ruby", "Chickie", "Puppa"] };

En el ejemplo siguiente se utiliza la informacin del ejemplo anterior y se genera el mismo resultado con las funciones constructor.
person = new Person(); person.name = 'Gina Vechio'; person.children = new Array(); person.children[0] = 'Ruby'; person.children[1] = 'Chickie'; person.children[2] = 'Puppa';
Vase tambin

[] (acceso a matriz), new,

Object (objeto)

| (OR en modo bit)

Disponibilidad

Flash Player 5.
Sintaxis

expresin1 | expresin2
Parmetros

expresin1,expresin2
Valor devuelto

Nmero.

Ninguno.
Descripcin

Operador (en modo bit); convierte expresin1 y expresin2 en nmeros enteros de 32 bits sin signo y devuelve un 1 en cada posicin de bit donde los bits correspondientes de expresin1 o expresin2 son 1.
Ejemplo

A continuacin se muestra un ejemplo de una operacin OR en modo bit.

// decimal 15 = binario 1111 x = 15; // decimal 9 = binario 1001 y = 9; trace(x | y); // 1111 | 0011 = 1111 // devuelve el decimal 15 (= binario 1111)

60

|| (OR lgico)
Disponibilidad

Flash Player 4.
Sintaxis

expresin1 || expresin2
Parmetros

expresin1,expresin2
Valor devuelto

Valor booleano o expresin que se convierte en un valor booleano.

Ninguno.
Descripcin

Operador (lgico); calcula el resultado de expresin1 y expresin2. El resultado es true si una o las dos expresiones dan como resultado true; el resultado es false slo si las dos expresiones dan como resultado false. Puede utilizar el operador OR lgico con cualquier nmero de operandos; si algn operando da como resultado true, el resultado es true. Con expresiones no booleanas, el operador lgico OR hace que Flash calcule el resultado de la expresin situada a la izquierda; si puede convertirse en true, el resultado es true. En caso contrario, calcula el valor de la expresin de la derecha y el resultado es el valor de dicha expresin.
Ejemplo

En el ejemplo siguiente se utiliza el operador || en una sentencia if. La segunda expresin da como resultado true, de manera que el resultado final es true:
x = 10 y = 250 start = false if(x > 25 || y > 200 || start){ trace('se ha pasado la prueba de OR lgico'); }
Ejemplo

En este ejemplo se demuestra como una expresin no booleana puede generar un resultado inesperado. Si la expresin situada a la izquierda se convierte en true, ese resultado se devuelve sin convertir la expresin situada a la derecha.
function fx1(){ trace ("se ha llamado a fx1"); returns true; } function fx2(){ trace ("se ha llamado a fx2"); return true; } if (fx1() || fx2()){ trace ("Se ha entrado en la sentencia IF"); } // Lo siguiente se enva a la ventana Salida: // se ha llamado a fx1 // Se ha entrado en la sentencia IF

Diccionario de ActionScript

61

|= (asignacin OR en modo bit)

Disponibilidad

Flash Player 5.
Sintaxis

expresin1 |= expresin2
Parmetros

expresin1,expresin2
Valor devuelto

Nmero o variable.

Ninguno.
Descripcin

Operador (asignacin compuesta en modo bit); asigna a expresin1 el valor de expresin1 | expresin2. Por ejemplo, las dos sentencias siguientes son iguales:
x |= y; x = x | y;
Ejemplo

En el ejemplo siguiente se utiliza el operador |=:

// decimal x = 15; // decimal y = 9; trace(x |= // 1111 |= // devuelve 15 = binario 1111 9 = binario 1001 y); 1001 el decimal 15 (= binario 1111)

Vase tambin

| (OR en modo bit)

~ (NOT en modo bit)

Disponibilidad

Flash Player 5.
Sintaxis

~ expresin
Parmetros

expresin

Nmero.

Valor devuelto

Ninguno.
Descripcin

Operador (en modo bit); convierte la expresin en un nmero entero de 32 bits sin signo y, despus, invierte los bits. Una operacin NOT en modo bit cambia el signo de un nmero y le resta 1.

62

Ejemplo

En el ejemplo siguiente se muestra una operacin NOT en modo bit realizada en una variable.
a = 0; trace ("when a = // cuando a = 0, a = 1; trace ("when a = // cuando a = 0, // por lo tanto, 0, ~a = "+~a); ~a = -1 1, ~a = "+~a); ~a = -2 ~0=-1 y ~1=-2

+ (suma)
Disponibilidad

Flash Player 4; Flash Player 5. En Flash 5, + es un operador numrico o un concatenador de cadenas en funcin del tipo de datos del parmetro. En Flash 4, + slo es un operador numrico. Los archivos de Flash 4 que se abren en un entorno de edicin de Flash 5 sufren un proceso de conversin para mantener la integridad de los tipos de datos. A continuacin se muestra un ejemplo de conversin de un archivo de Flash 4 que contiene una comparacin de calidad numrica: Archivo de Flash 4:
x + y

Archivo de Flash 5 convertido:

Number(x) + Number(y)
Sintaxis

expresin1 + expresin2
Parmetros

expresin1,expresin2
Valor devuelto

Nmero o cadena.

Ninguno.
Descripcin

Operador; agrega 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 nmeros enteros, la suma es un nmero entero; si cualquiera de ellas o ambas expresiones son nmeros de coma flotante, la suma es un nmero de coma flotante.
Ejemplo

En el ejemplo siguiente se concatenan dos cadenas y se muestra el resultado en la ventana Salida.

name = "Carlos"; instrument = "batera"; trace (name + " toca " + instrument);

Diccionario de ActionScript

63

Ejemplo

Las variables asociadas con campos de texto dinmico y de introduccin de texto tienen el tipo de datos String. En el ejemplo siguiente, la variable deposit es un campo de introduccin de texto del escenario. Cuando un usuario introduce un depsito, el script intenta agregar deposit a oldBalance. Sin embargo, como deposit es un tipo de datos String, el script concatena los valores de la variable (los combina para formar una cadena) en lugar de sumarlos.
oldBalance = 1345.23; currentBalance = deposit + oldBalance; trace (currentBalance);

Por ejemplo, si un usuario introduce 475 en el campo de texto deposit, la accin trace enva el valor 4751345,23 a la ventana Salida. Para corregirlo, utilice la funcin Number para convertir la cadena en un nmero, como se muestra a continuacin:
currentBalance = Number(deposit) + oldBalance;
Ejemplo

En esta sentencia se agregan los nmeros enteros 2 y 3 y se muestra el nmero entero 5 resultante en la ventana Salida:
trace (2 + 3);

En esta sentencia se agregan los nmeros de coma flotante 2,5 y 3,25 y se muestra el resultado, 5,75, tambin un nmero de coma flotante, en la ventana Salida:
trace (2.5 + 3.25);
Vase tambin

add

+= (asignacin de suma)
Disponibilidad

Flash Player 4.
Sintaxis

expresin1 += expresin2
Parmetros

expresin1,expresin2
Valor devuelto

Nmero o cadena.

Ninguno.
Descripcin

expresin2. x += y; x = x + y;

Operador (asignacin compuesta aritmtica); asigna a expresin1 el valor de expresin1 + Por ejemplo, las dos sentencias siguientes tienen el mismo resultado:

Este operador tambin realiza la concatenacin de cadenas. Todas las reglas del operador de suma (+) se aplican al operador de asignacin de suma (+=).

64

Ejemplo

En el ejemplo siguiente se muestra una utilizacin numrica del operador +=.

x = 5; y = 10; x += y; trace(x); //x devuelve 15

En este ejemplo se utiliza el operador += con una expresin de cadena y se enva "Me llamo Gerardo" a la ventana Salida.
x = "Me llamo " x += "Gerardo" trace (x)
Vase tambin

+ (suma)

< (menor que)

Disponibilidad

Flash Player 4; Flash Player 5. En Flash 5, el operador < (menor que) es un operador de comparacin que puede manejar diversos tipos de datos. En Flash 4, < es un operador numrico. Los archivos de Flash 4 que se abren en un entorno de edicin de Flash 5 sufren un proceso de conversin para mantener la integridad de los tipos de datos. A continuacin se muestra un ejemplo de conversin de un archivo de Flash 4 que contiene una comparacin numrica. Archivo de Flash 4:
x < y

Archivo de Flash 5 convertido:

Number(x) < Number(y)
Sintaxis

expresin1 < expresin2

Parmetros

expresin1,expresin2
Descripcin

Nmero o cadena.

Operador (comparacin); compara dos expresiones y determina si expresin1 es menor que expresin2; si es as, el operador devuelve true. Si expresin1 es mayor o igual que expresin2, el operador devuelve false. Las expresiones de cadena se comparan en orden alfabtico; las letras maysculas van antes que las minsculas.

Diccionario de ActionScript

65

Ejemplo

En los ejemplos siguientes se muestra cmo se devuelven true y false tanto para comparaciones numricas como de cadenas.
3 < 10; // true 10 < 3; // false "Arturo" < "Jaime"; // true "Jaime" < "Arturo"; // false "11" < "3"; //true "11" < 3; // comparacin numrica // false "C" < "abc"; // false "A" < "a"; // true

<< (desplazamiento a la izquierda en modo bit)

Disponibilidad

Flash Player 5.
Sintaxis

expresin1 << expresin2

Parmetros

expresin1 expresin2

Nmero o expresin que se va a desplazar a la izquierda. Nmero o expresin que se convierte en un entero entre 0 y 31.

Valor devuelto

Ninguno.
Descripcin

Operador (en modo bit); convierte expresin1 y expresin2 en nmeros enteros de 32 bits y desplaza todos los bits de expresin1 hacia la izquierda el nmero de espacios especificado por el nmero entero resultante de la conversin de expresin2. Las posiciones de bits que se han vaciado como resultado de esta operacin se rellenan con 0. Desplazar un valor una posicin hacia la izquierda es equivalente a multiplicarlo por 2.
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. Esto es debido a que 1 decimal es igual a 1 binario, 1 binario desplazado 10 posiciones a la izquierda es 10000000000 binario y 10000000000 binario es 1024 decimal.

66

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. Esto es debido a que 7 decimal es igual a 111 binario, 111 binario desplazado 8 posiciones a la izquierda es 11100000000 binario y 11100000000 binario es 1792 decimal.
Vase tambin

>>= (desplazamiento a la derecha en modo bit y asignacin), >> (desplazamiento a la derecha en modo bit), <<= (desplazamiento a la izquierda en modo bit y asignacin)

<<= (desplazamiento a la izquierda en modo bit y asignacin)

Disponibilidad

Flash Player 5.
Sintaxis

expresin1 <<= expresin2

Parmetros

expresin1 expresin2

Nmero o expresin que se va a desplazar a la izquierda. Nmero o expresin que se convierte en un entero entre 0 y 31.

Valor devuelto

Ninguno.
Descripcin

Operador (asignacin compuesta en modo bit); este operador realiza una operacin de desplazamiento a la izquierda en modo bit y almacena el contenido como resultado en expresin1. Las dos expresiones siguientes son equivalentes.
A <<= B A = (A << B)
Vase tambin

<< (desplazamiento a la izquierda en modo bit), >>= (desplazamiento a la derecha en modo bit y asignacin), >> (desplazamiento a la derecha en modo bit)

<= (menor o igual que)

Disponibilidad

Flash Player 4. Archivo de Flash 4:

x <= y

Archivo de Flash 5 convertido:

Number(x) <= Number(y)
Sintaxis

expresin1 <= expresin2

Diccionario de ActionScript

67

Parmetros

expresin1,expresin2
Valor devuelto

Nmero o cadena.

Ninguno.
Descripcin

Operador (comparacin); compara dos expresiones y determina si expresin1 es menor o igual que expresin2; si lo es, el operador devuelve true. Si expresin1 es mayor que expresin2, el operador devuelve false. Las expresiones de cadena se comparan en orden alfabtico; las letras maysculas van antes que las minsculas. En Flash 5, el operador menor o igual que (<=) es un operador de comparacin que puede manejar varios tipos de datos. En Flash 4, <= slo es un operador numrico. Los archivos de Flash 4 que se abren en un entorno de edicin de Flash 5 sufren un proceso de conversin para mantener la integridad de los tipos de datos. A continuacin se muestra un ejemplo de conversin de un archivo de Flash 4 que contiene una comparacin numrica.
Ejemplo

En los ejemplos siguientes se muestran casos de true y false tanto para comparaciones numricas como de cadenas:
5 <= 10; // true 2 <= 2; // true 10 <= 3; // false "Arturo" <= "Jaime"; // true "Jaime" <= "Arturo"; // false "11" <= "3"; //true "11" <= 3; // comparacin numrica // false "C" <= "abc"; // false "A" <= "a"; // true

68

<> (desigualdad)
Disponibilidad

Flash 2.
Sintaxis

expresin1 <> expresin2

Parmetros

expresin1,expresin2
Valor devuelto

Nmero, cadena, valor booleano, variable, objeto, matriz o funcin.

Ninguno.
Descripcin

Operador (desigualdad); comprueba exactamente lo contrario que el operador ==. Si expresin1 es igual a expresin2, el resultado es false. Al igual que con el operador ==, la definicin de igual depende de los tipos de datos que se comparan.

Los nmeros, cadenas y los valores booleanos se comparan por valor. Las variables, objetos, matrices y funciones se comparan por referencia.
Este operador se ha desestimado en Flash 5 y se recomienda a los usuarios utilizar el operador !=.
Vase tambin

!= (desigualdad)

= (asignacin)
Disponibilidad

Flash Player 4. Archivo de Flash 4:

x = y

Archivo de Flash 5 convertido:

Number(x) == Number(y)
Sintaxis

expresin1 = expresin2
Parmetros

expresin1 expresin2

Variable, elemento de una matriz o propiedad de un objeto. Valor de cualquier tipo.

Valor devuelto

Ninguno.
Descripcin

Operador; asigna el tipo de expresin2 (el parmetro de la derecha) a la variable, elemento de matriz o propiedad de expresin1.

Diccionario de ActionScript

69

En Flash 5, = es un operador de asignacin y el operador == se utiliza para comprobar la igualdad. En Flash 4, = es un operador de igualdad numrico. Los archivos de Flash 4 que se abren en un entorno de edicin de Flash 5 sufren un proceso de conversin para mantener la integridad de los tipos de datos.
Ejemplo

En el ejemplo siguiente se utiliza el operador de asignacin para asignar el tipo de datos Number a la variable x.
x = 5

En el ejemplo siguiente se utiliza el operador de asignacin para asignar el tipo de datos String a la variable x.
x = "hola"
Vase tambin

== (igualdad)

-= (asignacin de resta)
Disponibilidad

Flash Player 4.
Sintaxis

expresin1 -= expresin2
Parmetros

expresin1,expresin2
Valor devuelto

Nmero o expresin que da como resultado un nmero.

Ninguno.
Descripcin

Operador (asignacin compuesta aritmtica); asigna a expresin1 el valor de expresin1 expresin2. Por ejemplo, las dos sentencias siguientes son iguales:
x -= y; x = x - y;

Las expresiones de cadena deben convertirse en nmeros o se devolver NaN.

Ejemplo

En el ejemplo siguiente se utiliza el operador -= para restar 10 de 5 y asignar el resultado a la variable x.

x = 5; y = 10; x -= y trace(x); //devuelve -5

70

Ejemplo

En el ejemplo siguiente se muestra cmo las cadenas se convierten en nmeros.

x = "5"; y = "10"; x -= y; trace(x); // devuelve -5

== (igualdad)
Disponibilidad

Flash Player 5.
Sintaxis

expresin1 == expresin2
Parmetros

expresin1,expresin2
Valor devuelto

Nmero, cadena, valor booleano, variable, objeto, matriz o funcin.

Ninguno.
Descripcin

Operador (de igualdad); comprueba si dos expresiones son iguales. El resultado es true si las expresiones son iguales. La definicin de igual depende del tipo de datos del parmetro:

Los nmeros y los valores booleanos se comparan por valor y se consideran iguales si tienen el
mismo valor.

Las expresiones de cadena son iguales si tienen el mismo nmero de caracteres y los caracteres
son idnticos.

Las variables, objetos, matrices y funciones se comparan por referencia. Dos variables son
iguales si se refieren al mismo objeto, matriz o funcin. Dos matrices independientes nunca se consideran iguales, incluso aunque tengan el mismo nmero de elementos.
Ejemplo

En el ejemplo siguiente se utiliza el operador == con una sentencia if:

a = "David" , b = "David"; if (a == b){ trace("David es David"); }

Diccionario de ActionScript

71

Ejemplo

En estos ejemplos se muestran los resultados de operaciones que comparan tipos mixtos.
x = "5"; y = "5"; trace(x == y); // true x = "5"; y = "66"; trace(x == y); // false x = "Rafael"; y = "Carlos"; trace (x == y); //false
Vase tambin

!= (desigualdad), === (igualdad estricta), !== (desigualdad estricta)

=== (igualdad estricta)

Disponibilidad

Flash Player 6.
Sintaxis

expresin1 === expresin2

Descripcin

Operador; comprueba la igualdad de dos expresiones; el operador de igualdad estricta funciona como el operador de igualdad, salvo que los tipos de datos no se convierten. El resultado es true si las dos expresiones, incluidos los tipos de datos, son iguales. La definicin de igual depende del tipo de datos del parmetro:

Los nmeros y los valores booleanos se comparan por valor y se consideran iguales si tienen el
mismo valor.

Las expresiones de cadena son iguales si tienen el mismo nmero de caracteres y los caracteres
son idnticos.

Las variables, objetos, matrices y funciones se comparan por referencia. Dos variables son
iguales si se refieren al mismo objeto, matriz o funcin. Dos matrices independientes nunca se consideran iguales, incluso aunque tengan el mismo nmero de elementos.

72

Ejemplo

En el cdigo siguiente se muestra el valor devuelto de las operaciones que utilizan operadores de igualdad, de igualdad estricta y de desigualdad estricta.
s1 = new String("5"); s2 = new String("5"); s3 = new String("Hola"); n = new Number(5); b = new Boolean(true); s1 s1 s1 s1 s1 s1 s1 s1 s1 s1 s1 s1 == == == == === === === === !== !== !== !== s2; // true s3; // false n; // true b; // false s2; // true s3; // false n; // false b; // false s2; // false s3; // true n; // true b; // true

Vase tambin

== (igualdad), != (desigualdad), === (igualdad estricta)

> (mayor que)

Disponibilidad

Flash Player 5.
Sintaxis

expresin1 > expresin2

Parmetros

expresin1,expresin2
Valor devuelto

Entero, nmero de coma flotante o cadena.

Ninguno.
Descripcin

Operador (comparacin); compara dos expresiones y determina si expresin1 es mayor que expresin2 (true) o si expresin1 es menor o igual que expresin2 (false).

Diccionario de ActionScript

73

>= (mayor o igual que)

Disponibilidad

Flash Player 4. Archivo de Flash 4:

x > y

Archivo de Flash 5 convertido:

Number(x) > Number(y)
Sintaxis

expresin1 >= expresin2

Parmetros

expresin1, expresin2
Valor devuelto

Cadena, entero o nmero de coma flotante.

Ninguno.
Descripcin

Operador (comparacin); compara dos expresiones y determina si expresin1 es mayor o igual que expresin2 (true) o si expresin1 es menor que expresin2 (false). En Flash 5, mayor o igual que (>=) es un operador de comparacin que puede manejar varios tipos de datos. En Flash 4, > es un operador numrico. Los archivos de Flash 4 que se abren en un entorno de edicin de Flash 5 sufren un proceso de conversin para mantener la integridad de los tipos de datos.

>> (desplazamiento a la derecha en modo bit)

Disponibilidad

Flash Player 5.
Sintaxis

expresin1 >> expresin2

Parmetros

expresin1 expresin2

Nmero, cadena o expresin que se va a desplazar a la derecha. Nmero o expresin que se convierte en un entero entre 0 y 31.

Valor devuelto

Ninguno.
Descripcin

Operador (en modo bit); convierte expresin1 y expresin2 en nmeros enteros de 32 bits y desplaza todos los bits de expresin1 hacia la derecha el nmero de espacios especificado por el nmero entero resultante de la conversin de expresin2. Los bits que se desplazan a la derecha se descartan. Para conservar el signo de la expresin original, los bits situados a la izquierda se rellenan con 0 si el bit ms significativo (el bit ms alejado de la izquierda) de expresin1 es 0 y se rellena con 1 si el bit ms significativo es 1. Desplazar un valor a la derecha una posicin es equivalente a dividirlo entre 2 y descartar el resto.

74

Ejemplo

En el ejemplo siguiente, 65535 se convierte en un nmero entero de 32 bits y se desplaza ocho bits a la derecha.
x = 65535 >> 8

El resultado de la operacin anterior es el siguiente:

x = 255

Esto es debido a que 65535 decimal es igual a 1111111111111111 binario (diecisis unos), 1111111111111111 binario desplazado a la derecha ocho bits es 11111111 binario y 11111111 binario es 255 decimal. El bit ms significativo es 0 debido a que los nmeros enteros son de 32 bits, as que el bit de relleno es 0. En el ejemplo siguiente -1 se convierte en un nmero entero de 32 bits y se desplaza un bit a la derecha.
x = -1 >> 1

El resultado de la operacin anterior es el siguiente:

x = -1

Esto se debe a que -1 decimal es igual a 11111111111111111111111111111111 binario (treinta y dos unos); si se desplaza a la derecha un bit, el bit menos significativo (el ms alejado de la derecha) se descartar y el bit ms significativo se rellenar con 1. El resultado es 11111111111111111111111111111111 (treinta y dos unos) binario, lo que representa el nmero entero -1 de 32 bits.
Vase tambin

>>= (desplazamiento a la derecha en modo bit y asignacin)

>>= (desplazamiento a la derecha en modo bit y asignacin)

Disponibilidad

Flash Player 5.
Sintaxis

expresin1 =>>expresin2
Parmetros

expresin1 expresin2

Nmero o expresin que se va a desplazar a la izquierda. Nmero o expresin que se convierte en un entero entre 0 y 31.

Valor devuelto

Ninguno.
Descripcin

Operador (de asignacin compuesta en modo bit); este operador realiza una operacin de desplazamiento a la derecha en modo bit y almacena el contenido como resultado en expresin1.
Ejemplo

Las dos expresiones siguientes son equivalentes.

A >>= B A = (A >> B)

Diccionario de ActionScript

75

En el cdigo comentado siguiente se utiliza el operador (>>=) en modo bit. Tambin es un ejemplo de la utilizacin de todos los operadores en modo bit.
function convertToBinary(number){ var result = ""; for (var i=0; i<32; i++) { // Extraer el bit menos significativo con AND en modo bit var lsb = number & 1; // Agregar este bit a nuestra cadena de resultado result = (lsb ? "1": "0") + result; // Desplazar el nmero un bit a la derecha para ver el bit siguiente number >>= 1;} return result; } trace(convertToBinary(479)); // Devuelve la cadena 00000000000000000000000111011111 // La cadena anterior es la representacin binaria del nmero decimal // 479
Vase tambin

<< (desplazamiento a la izquierda en modo bit)

>>> (desplazamiento a la derecha en modo bit sin signo)

Disponibilidad

Flash Player 5.
Sintaxis

expresin1 >>> expresin2

Parmetros

expresin1 expresin2

Nmero, cadena o expresin que se va a desplazar a la derecha. Nmero, cadena o expresin que se convierte en un entero entre 0 y 31.

Valor devuelto

Ninguno.
Descripcin

Operador (en modo bit); es lo mismo que el operador de desplazamiento a la derecha en modo bit (>>) excepto en que no conserva el signo de la expresin original debido a que los bits de la izquierda siempre se rellenan con 0.
Ejemplo

En el ejemplo siguiente -1 se convierte en un nmero entero de 32 bits y se desplaza un bit a la derecha.

x = -1 >>> 1

El resultado de la operacin anterior es el siguiente:

x = 2147483647

Esto es debido a que -1 decimal es 11111111111111111111111111111111 binario (treinta y dos unos) y cuando se desplaza a la derecha (sin signo) un bit, el bit menos significativo (el situado ms a la derecha) se descarta y el bit ms significativo (el situado ms a la izquierda) se rellena con un 0. El resultado es 01111111111111111111111111111111 binario, que representa el entero de 32 bits 2147483647.

76

Vase tambin

>>= (desplazamiento a la derecha en modo bit y asignacin)

>>>= (desplazamiento a la derecha en modo bit sin signo y asignacin)

Disponibilidad

Flash Player 5.
Sintaxis

expresin1 >>>= expresin2

Parmetros

expresin1 expresin2

Nmero o expresin que se va a desplazar a la izquierda. Nmero o expresin que se convierte en un entero entre 0 y 31.

Valor devuelto

Ninguno.
Descripcin

Operador (de asignacin compuesta en modo bit); este operador realiza una operacin en modo bit de desplazamiento a la derecha sin signo y almacena el contenido como resultado en expresin1. Las dos expresiones siguientes son equivalentes:
A >>>= B A = (A >>> B)
Vase tambin

>>> (desplazamiento a la derecha en modo bit sin signo), >>= (desplazamiento a la derecha en modo bit y asignacin)

Diccionario de ActionScript

77

Accessibility (objeto)
El objeto Accessibility es un conjunto de mtodos que pueden utilizarse para crear contenido accesible con ActionScript. En Flash MX, slo existe un mtodo. Este objeto est disponible en Flash Player 6. Resumen de los mtodos del objeto Arguments
Propiedad Accessibility.isActive Descripcin Indica si hay activo un programa lector de pantalla.

Accessibility.isActive
Disponibilidad

Flash Player 6.
Sintaxis

Accessibility.isActive()
Parmetros

Ninguno.
Valor devuelto

Valor booleano.
Descripcin

Mtodo; indica si hay activo o no un programa lector de pantalla. Utilice este mtodo cuando desee que la pelcula tenga un comportamiento diferente en presencia de un lector de pantalla.
Vase tambin

System.capabilities.hasAccessibility

add
Disponibilidad

Flash Player 4.
Sintaxis

cadena1 add cadena2

Parmetros

cadena1, cadena2
Valor devuelto

Una cadena.

Ninguno.

78

Descripcin

Operador; concatena (combina) dos o ms cadenas. El operador add sustituye al operador add (&) de Flash 4; los archivos de Flash 4 que utilizan el operador & se convierten de forma automtica a fin de utilizar el operador add para la concatenacin de cadenas cuando se abren en el entorno de edicin de Flash 5. Sin embargo, el operador add no se utiliza en Flash 5 y se recomienda utilizar el operador + cuando se crea contenido para Flash Player 5 o Flash Player 6. Utilice el operador add para concatenar cadenas si est creando contenido para Flash 4 o para versiones anteriores de Flash Player.
Vase tambin

+ (suma)

and
Disponibilidad

Flash Player 4.
Sintaxis

condicin1 and condicin2

Parmetros

condicin1,condicin2
Valor devuelto

Condiciones o expresiones que dan como resultado true o false.

Ninguno.
Descripcin

Operador; realiza una operacin AND lgica en Flash Player 4. Si ambas expresiones dan como resultado true, toda la expresin es true. Este operador se ha desestimado en Flash 5 y se recomienda a los usuarios que utilicen el operador &&.
Vase tambin

&& (AND de cortocircuito)

arguments (objeto)
El objeto Arguments es una matriz que contiene los valores que se han pasado como parmetros a cualquier funcin. Cada vez que se llama a una funcin en ActionScript, se crea de forma automtica un objeto Arguments para esa funcin. Se crea tambin una variable local, arguments, que permite hacer referencia al objeto Arguments. El objeto Arguments est disponible en Flash Player 6. Resumen de las propiedades del objeto Arguments
Propiedad arguments.callee arguments.caller arguments.length Descripcin Hace referencia a la funcin a la que se est llamando. Hace referencia a la funcin que llama. El nmero de parmetros pasados a una funcin.

Diccionario de ActionScript

79

arguments.callee
Disponibilidad

Flash Player 5.
Sintaxis

arguments.callee
Descripcin

Propiedad; hace referencia a la funcin a la que se est llamando en este momento.

Ejemplo

Puede utilizar la propiedad arguments.callee para realizar una funcin annima que es recursiva, como se muestra a continuacin:
factorial = function (x) { if (x <= 1) { return 1; } else { return x * arguments.callee(x-1); } };

A continuacin se muestra una funcin recursiva con nombre:

function factorial (x) { if (x <= 1) { return 1; } else { return x * factorial(x-1); } }

arguments.caller
Disponibilidad

Flash Player 6.
Sintaxis

arguments.caller
Descripcin

Propiedad; hace referencia al objeto Arguments de la funcin que llama.

arguments.length
Disponibilidad

Flash Player 6.
Sintaxis

arguments.length
Descripcin

Propiedad; el nmero de parmetros que se han pasado realmente a una funcin.

80

Array (objeto)
El objeto Array permite acceder a matrices y manipularlas. Una matriz es un objeto cuyas propiedades se identifican con un nmero que representa su posicin en la matriz. Este nmero se denomina ndice. Todas las matrices tienen base cero, lo que quiere decir que el primer elemento de la matriz es [0], el segundo elemento es [1] y as sucesivamente. En el ejemplo siguiente myArray contiene los meses del ao.
myArray[0] myArray[1] myArray[2] myArray[3] = = = = "enero" "febrero" "marzo" "abril"

Para crear un objeto Array, utilice el constructor new Array o el operador de acceso a matriz ([]). Para acceder a los elementos de una matriz, utilice el operador de acceso a matriz ([ ]). En Flash MX, el objeto Array se ha convertido en un objeto nativo. Debido a ello, experimentar una gran mejora en el rendimiento. Resumen de los mtodos del objeto Array
Mtodo Array.concat Array.join Array.pop Array.push Array.reverse Array.shift Array.slice Array.sort Array.sortOn Array.splice Array.toString Array.unshift Descripcin Concatena los parmetros y los devuelve como una matriz nueva. Une todos los elementos de una matriz en una cadena. Elimina el ltimo elemento de una matriz y devuelve su valor. Agrega uno o ms elementos al final de una matriz y devuelve la nueva longitud de la matriz. Invierte la direccin de una matriz. Elimina el primer elemento de una matriz y devuelve su valor. Extrae una seccin de una matriz y la devuelve como una nueva matriz. Ordena una matriz. Ordena una matriz segn un campo de la matriz. Agrega y/o elimina elementos de una matriz. Devuelve un valor de cadena que representa los elementos del objeto Array. Agrega uno o ms elementos al principio de una matriz y devuelve la nueva longitud de la matriz.

Resumen de las propiedades del objeto Array

Propiedad Array.length Descripcin Devuelve la longitud de la matriz.

Constructor del objeto Array

Disponibilidad

Flash Player 5.

Diccionario de ActionScript

81

Sintaxis

new Array() new Array(longitud) new Array(elemento0, elemento1, elemento2,...elementoN)

Parmetros

Nmero entero que especifica el nmero de elementos de la matriz. En el caso de elementos no contiguos, el parmetro longitud especifica el nmero de ndice del ltimo elemento de la matriz ms 1.
longitud elemento0...elementoN Lista de dos o ms valores arbitrarios. Los valores pueden ser nmeros, cadenas, objetos u otras matrices. El primer elemento de una matriz siempre tiene el ndice o posicin 0.
Valor devuelto

Ninguno.
Descripcin

Constructor; 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 no tienen valores, o una matriz cuyos elementos tienen valores especficos. Sintaxis 1: si no especifica parmetros, se crea una matriz con una longitud 0. Sintaxis 2: si slo especifica una longitud, se crea una matriz con longitud como nmero de elementos, sin valores. Sintaxis 3: si utiliza los parmetros elemento para especificar valores, se crea una matriz con valores especficos.
Ejemplo

Sintaxis 1: en el ejemplo siguiente se crea un nuevo objeto Array con una longitud inicial de 0.
myArray = new Array();

Sintaxis 3: en el ejemplo siguiente se crea un nuevo objeto Array go_gos, con una longitud inicial de 5.
go_gos = new Array("Begoa", "Esther", "Ana", "Laura", "Pilar"); trace(go_gos.join(" + "));

Los elementos iniciales de la matriz go_gos se identifican como se muestra a continuacin:

go_gos[0] go_gos[1] go_gos[2] go_gos[3] go_gos[4] = = = = = "Begoa"; "Esther"; "Ana"; "Laura"; "Pilar";

En el cdigo siguiente se agrega un sexto elemento a la matriz go_gos y se cambia el primer elemento:
go_gos[5] = "Isabel"; go_gos[1] = "Julia" trace(go_gos.join(" + "));
Vase tambin

Array.length, [] (acceso a matriz)

82

Array.concat
Disponibilidad

Flash Player 5.
Sintaxis

myArray.concat(valor0,valor1,...valorN)
Parmetros

valor0,...valorN

Nmeros, elementos o cadenas que se van a concatenar en una nueva

matriz.
Valor devuelto

Ninguno.
Descripcin

Mtodo; concatena los elementos especificados en los parmetros, si los hay, con los elementos de myArray y crea una nueva matriz. Si los parmetros valor especifican una matriz, se concatenan los elementos de esa matriz en lugar de la propia matriz. La matriz myArray no cambia.
Ejemplo

En el cdigo siguiente se concatenan dos matrices:

alpha = new Array("a","b","c"); numeric = new Array(1,2,3); alphaNumeric=alpha.concat(numeric); trace(alphaNumeric); // crea la matriz ["a","b","c",1,2,3]

En el cdigo siguiente se concatenan tres matrices:

num1=[1,3,5]; num2=[2,4,6]; num3=[7,8,9]; nums=num1.concat(num2,num3) trace(nums); // crea la matriz [1,3,5,2,4,6,7,8,9]

Las matrices anidadas no se despliegan del mismo modo que las matrices normales. Los elementos de una matriz anidada no se desglosan en elementos independientes de una matriz x, como se muestra en el ejemplo siguiente.
a = new Array ("a","b","c"); n = new Array(1, [2, 3], 4); // 2 y 3 son elementos de una matriz anidada x = a.concat(n); x[0] = "a" x[1] = "b" x[2] = "c" x[3] = 1 x[4] = 2, 3 x[5] = 4

Diccionario de ActionScript

83

Array.join
Disponibilidad

Flash Player 5.
Sintaxis

myArray.join([separador])
Parmetros

separador

Carcter o cadena que separa los elementos de la matriz en la cadena devuelta. Si omite este parmetro, se utiliza la coma como separador predeterminado.

Valor devuelto

Ninguno.
Descripcin

Mtodo; convierte los elementos de una matriz en cadenas, inserta el separador especificado entre los elementos, los concatena y devuelve la cadena resultante. Las matrices anidadas siempre se separan con una coma y no con el separador pasado al mtodo join.
Ejemplo

El ejemplo siguiente crea una matriz, con tres elementos. A continuacin, une la matriz tres veces (con el separador predeterminado, una coma y un espacio y un signo ms) y los muestra en la ventana Salida:
a = new Array("tierra","luna","sol") trace(a.join()); // devuelve tierra, luna, sol trace(a.join(" - ")); // devuelve tierra - luna - sol trace(a.join(" + ")); // devuelve tierra + luna + sol

Array.length
Disponibilidad

Flash Player 5.
Sintaxis

myArray.length
Descripcin

Propiedad; contiene la longitud de la matriz. Esta propiedad se actualiza automticamente cuando se agregan nuevos elementos a la matriz. Cuando se asigna un valor a un elemento de matriz (por ejemplo, myArray[ndice] = valor), si ndice es un nmero e ndice+1 es mayor que la propiedad length, la propiedad length se actualiza a ndice + 1.

84

Ejemplo

En el cdigo siguiente se explica como se actualiza la propiedad length.

// la longitud inicial es 0 myArray = new Array(); myArray[0] = 'a'; // myArray.length se actualiza a 1 myArray[1] = 'b'; // myArray.length se actualiza a 2 myArray[9] = 'c'; // myArray.length se actualiza a 10

Array.pop
Disponibilidad

Flash Player 5.
Sintaxis

myArray.pop()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; elimina el ltimo elemento de una matriz y devuelve el valor de ese elemento.
Ejemplo

En el cdigo siguiente se crea la matriz myPets que contiene cuatro elementos y despus se elimina su ltimo elemento.
myPets = ["gato", "perro", "pjaro", "pez"]; popped = myPets.pop(); trace(popped); // devuelve pez

Array.push
Disponibilidad

Flash Player 5.
Sintaxis

myArray.push(valor,...)
Parmetros

valor

Uno o ms valores que se anexan a la matriz.

Valor devuelto

La longitud de la nueva matriz.

Descripcin

Mtodo; agrega uno o ms elementos al final de una matriz y devuelve la nueva longitud de la matriz.

Diccionario de ActionScript

85

Ejemplo

En el ejemplo siguiente se crea la matriz myPets con dos elementos, gato y perro. En la segunda lnea se agregan dos elementos a la matriz. Despus de llamar al mtodo push, la variable pushed contiene cuatro elementos. Puesto que el mtodo push devuelve la nueva longitud de la matriz, la accin trace de la ltima lnea enva la nueva longitud de myPets (4) a la ventana Salida:
myPets = ["gato", "perro"]; pushed = myPets.push("pjaro", "pez"); trace(pushed);

Array.reverse
Disponibilidad

Flash Player 5.
Sintaxis

myArray.reverse()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; invierte la matriz.

Ejemplo

A continuacin se muestra un ejemplo de la utilizacin del mtodo Array.reverse.

var numbers = [1, 2, 3, 4, 5, 6]; trace(numbers.join()); numbers.reverse(); trace(numbers.join());

Salida:
1,2,3,4,5,6 6,5,4,3,2,1

Array.shift
Disponibilidad

Flash Player 5.
Sintaxis

myArray.shift()
Parmetros

Ninguno.
Valor devuelto

El primer elemento de una matriz.

Descripcin

Mtodo; elimina el primer elemento de una matriz y devuelve ese elemento.

86

Ejemplo

En el cdigo siguiente se crea la matriz myPets y, a continuacin, se elimina el primer elemento de la matriz y se asigna a la variable shifted.
myPets = ["gato", "perro", "pjaro", "pez"]; shifted = myPets.shift(); trace(shifted); // devuelve gato
Vase tambin

Array.pop

Array.slice
Disponibilidad

Flash Player 5.
Sintaxis

myArray.slice(inicio, fin)
Parmetros

inicio final

Nmero que especifica el ndice del punto de inicio de la seccin. Si inicio es un nmero negativo, el punto de inicio comienza al final de la matriz, donde -1 es el ltimo elemento. Nmero que especifica el ndice del punto final de la seccin. Si omite este parmetro, el sector incluir todos los elementos desde el inicio hasta el final de la matriz. Si fin es un nmero negativo, el punto final se especifica desde el final de la matriz, donde -1 es el ltimo elemento.

Valor devuelto

Ninguno.
Descripcin

Mtodo; extrae un sector o una subcadena de la matriz y la devuelve como una nueva matriz sin modificar la matriz original. La matriz devuelta incluye el elemento inicio y todos los elementos hasta el elemento fin, pero sin incluir este ltimo.

Array.sort
Disponibilidad

Flash Player 5.
Sintaxis

myArray.sort([funcinComparacin])
Parmetros

funcinComparacin Funcin de comparacin opcional que se utiliza para determinar el orden de los elementos de una matriz. Dados los elementos A y B, el parmetro funcinOrden puede tener uno de los tres valores siguientes:

-1 si A aparece antes que B en la secuencia de ordenamiento 0 si A = B 1 si A aparece despus que B en la secuencia de ordenamiento

Diccionario de ActionScript

87

Valor devuelto

Ninguno.
Descripcin

Mtodo; ordena la matriz en contexto, sin hacer una copia. Si omite el parmetro funcinComparacin, Flash ordena los elementos en contexto utilizando el operador de comparacin <.
Ejemplo

En el ejemplo siguiente se utiliza Array.sort sin especificar el parmetro funcinComparacin.

var fruits = ["naranjas", "manzanas", "fresas", "pias", "cerezas"]; trace(fruits.join()); fruits.sort(); trace(fruits.join());

Salida:
naranjas,manzanas,fresas,pias,cerezas se muestra cerezas,fresas,manzanas,naranjas,pias

En el ejemplo siguiente se utiliza Array.sort con una funcin de ordenacin especificada.

var passwords = [ "juan:foo", "miguel:bar", "jos:snafu", "enrique:yuck", "daniel:1234" ]; function order (a, b) { // Las entradas que deben ordenarse estn en formato // nombre:contrasea // Se ordena slo utilizando el nombre // como clave. var name1 = a.split(':')[0]; var name2 = b.split(':')[0]; if (name1 < name2) { return -1; } else if (name1 > name2) { return 1; } else { return 0; } } for (var i=0; i< password.length; i++) { trace (passwords.join()); } passwords.sort(order); trace ("Ordenado:"); for (var i=0; i< password.length; i++) { trace (passwords.join()); }

Cuando se ejecuta el cdigo anterior, se muestra el resultado siguiente en la ventana Salida:

daniel:1234 enrigue:yuck jos:snafu juan:foo miguel:bar

88

Array.sortOn
Disponibilidad

Flash Player 6.
Sintaxis

Array.sortOn(nombreCampo)
Parmetros

nombreCampo

Cadena que identifica un campo de un elemento de la matriz que debe utilizarse como valor de ordenacin.

Valor devuelto

Ninguno.
Descripcin

Mtodo; ordena elementos de una matriz segn un campo de sta. Si no se pasa ningn parmetro nombreCampo, la funcin genera un error. Si se pasan varios parmetros nombreCampo, el primer campo se convierte en un valor de cadena y el resto de parmetros se pasan por alto.
nombreCampo, Array.sort.
Ejemplo

Si alguno de los elementos que se comparan no contiene el campo especificado en el parmetro la ordenacin utiliza de forma predeterminada el comportamiento del mtodo

En el ejemplo siguiente se crea una nueva matriz y se ordena segn el campo city:
var recArray = new Array(); recArray.push( { name: "bob", city: "omaha", zip: 68144 } ); recArray.push( { name: "greg", city: "kansas city", zip: 72345 } ); recArray.push( { name: "chris", city: "burlingame", zip: 94010 } ); recArray.sortOn("city"); // el resultado es el siguiente: recArray[0] = name: "chris", city: "burlingame", zip: 94010 recArray[1] = name: "greg", city: "kansas city", zip: 72345 recArray[2] = name: "bob", city: "omaha", zip: 68144
Vase tambin

Array.sort

Array.splice
Disponibilidad

Flash Player 5.
Sintaxis

myArray.splice(inicio, nmeroEliminar, valor0,valor1...valorN)

Parmetros

inicio

ndice del elemento de la matriz donde comienza la insercin y/o el borrado.

nmeroEliminar Nmero de elementos que se van a eliminar. Este nmero incluye el elemento especificado en el parmetro inicio. Si no se especifica un valor para nmeroEliminar, el mtodo elimina todos los valores desde el elemento inicio hasta el ltimo elemento de la matriz. Si el valor es 0, no se elimina ningn elemento.

Diccionario de ActionScript

89

valor Cero o ms valores que se van a insertar en la matriz en el punto de insercin especificado en el parmetro inicio. Este parmetro es opcional.
Valor devuelto

Ninguno.
Descripcin

Mtodo; agrega y elimina elementos de una matriz. Este mtodo modifica la matriz sin hacer una copia.

Array.toString
Disponibilidad

Flash Player 5.
Sintaxis

myArray.toString()
Parmetros

Ninguno.
Valor devuelto

Una cadena.
Descripcin

Mtodo; devuelve un valor de cadena que representa los elementos del objeto Array especificado. Todos los elementos de la matriz, empezando por el ndice 0 y finalizando por el ndice myArray.length-1, se convierten en una cadena concatenada separada por comas.
Ejemplo

En el ejemplo siguiente se crea la matriz myArray, sta se convierte en una cadena y se muestra 1,2,3,4,5 en la ventana Salida.
myArray = new Array(); myArray[0] = 1; myArray[1] = 2; myArray[2] = 3; myArray[3] = 4; myArray[4] = 5; trace(myArray.toString());

Array.unshift
Disponibilidad

Flash Player 5.
Sintaxis

myArray.unshift(valor1,valor2,...valorN)
Parmetros

valor1,...valorN

Uno o ms nmeros, elementos o variables que se deben insertar al

principio de la matriz.

90

Valor devuelto

La nueva longitud de la matriz.

Descripcin

Mtodo; agrega uno o ms elementos al principio de una matriz y devuelve la nueva longitud de la matriz.

asfunction
Disponibilidad

Flash Player 5.
Sintaxis

asfunction:funcin,"parmetro"
Parmetros

funcin parmetro

Identificador de una funcin. Cadena que se pasa a la funcin a la que hace referencia el parmetro funcin.

Valor devuelto

Ninguno.
Descripcin

Protocolo; un protocolo especial para URL en campos de texto HTML. En campos de texto HTML, el texto puede ser un hipervnculo con una etiqueta A HTML. El atributo HREF de la etiqueta A contiene un URL que puede ser de un protocolo estndar como HTTP, HTTPS o FTP. El protocolo asfunction es un protocolo adicional especfico de Flash que hace que el vnculo invoque una funcin de ActionScript.
Ejemplo

En este ejemplo, la funcin MyFunc se define en las tres primeras lneas de cdigo. La variable textField se asocia con un campo de texto HTML. El texto "Haga clic aqu" es un hipervnculo dentro del campo de texto. La funcin MyFunc se llama cuando el usuario hace clic en el hipervnculo:
function MyFunc(arg){ trace ("Ha hecho clic aqu. El argumento es "+arg); } myTextField.text ="<A HREF=\"asfunction:MyFunc,Foo \">Haga clic aqu</A>";

Cuando se hace clic en el hipervnculo, se muestra el resultado siguiente en la ventana Salida:

Ha hecho clic aqu. El argumento es Foo.

Boolean (funcin)
Disponibilidad

Flash Player 5.
Sintaxis

Boolean(expresin)
Parmetros

expresin

Expresin que debe convertirse en un valor booleano.

Diccionario de ActionScript

91

Valor devuelto

Ninguno.
Descripcin

Funcin; convierte el parmetro expresin en un valor booleano y devuelve un valor de acuerdo con lo siguiente:

Si expresin es un valor booleano, el valor devuelto es expresin. Si expresin es un nmero, el valor devuelto es true si el nmero no es cero, o false si es cero. Si expresin es una cadena, se llama al mtodo toNumber y el valor devuelto es true si el
nmero no es cero, o false si es cero.

Si expresin no est definida, el valor devuelto es false. Si expresin es un clip de pelcula o un objeto, el valor devuelto es true. Boolean (objeto)
El objeto Boolean es un objeto envolvente con las mismas funciones que el objeto Boolean de JavaScript estndar. Utilice el objeto Boolean para recuperar el tipo de datos primitivo o la representacin de cadena de un objeto Boolean. En Flash MX, el objeto Boolean se ha convertido en un objeto nativo. Debido a ello, experimentar una gran mejora en el rendimiento. Debe utilizar el constructor new Boolean() para crear una instancia del objeto Boolean antes de llamar a sus mtodos. Resumen de los mtodos del objeto Boolean
Mtodo Boolean.toString Boolean.valueOf Descripcin Devuelve la representacin de la cadena (true) o (false) del objeto Boolean. Devuelve el tipo de valor primitivo del objeto Boolean especificado.

Constructor del objeto Boolean

Disponibilidad

Flash Player 5.
Sintaxis

new Boolean([x])
Parmetros

Cualquier expresin. Este parmetro es opcional.

Valor devuelto

Ninguno.
Descripcin

Constructor; crea una instancia del objeto Boolean. Si omite el parmetro x, el objeto Boolean se inicializa con el valor false. Si especifica un valor para el parmetro x, el mtodo lo obtiene y devuelve el resultado como un valor Boolean segn las reglas de la funcin Boolean (funcin).
Nota: para mantener la compatibilidad con Flash Player 4, el manejo de cadenas por parte del objeto Boolean no cumple el estndar ECMA-262.

92

Ejemplo

En el cdigo siguiente se crea un nuevo objeto Boolean vaco denominado myBoolean.

myBoolean = new Boolean();

Boolean.toString
Disponibilidad

Flash Player 5.
Sintaxis

myBoolean.toString()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; devuelve la representacin de la cadena, true o false del objeto Boolean.

Boolean.valueOf
Disponibilidad

Flash Player 5.
Sintaxis

Boolean.valueOf()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; devuelve el tipo de valor primitivo del objeto Boolean especificado.

break
Disponibilidad

Flash Player 4.
Sintaxis

break
Parmetros

Ninguno.
Valor devuelto

Ninguno.

Diccionario de ActionScript

93

Descripcin

Accin; aparece dentro de un bucle (for, for..in, do while o while) o dentro de un bloque de sentencias asociadas con un bloque "case" concreto dentro de una accin switch. La accin break da instrucciones a Flash para que se salte el resto del cuerpo del bucle, detenga la accin del bucle y ejecute la sentencia que sigue a la sentencia del bucle. Cuando se utiliza la accin break, el intrprete de Flash omite el resto de las sentencias de dicho bloque case y salta a la primera sentencia que sigue a la accin switch que la contiene. Utilice la accin break para romper una serie de bucles anidados.
Ejemplo

En el ejemplo siguiente se utiliza la accin break para salir de un bucle que, si no, es infinito.
i = 0; while (true) { if (i >= 100) { break; } i++; }
Vase tambin

for, for..in, do while, while, switch, case

Button (objeto)
Todos los smbolos de botn de una pelcula Flash son instancias del objeto Button. Puede dar nombre de instancia a un botn en el inspector de propiedades y utilizar los mtodos y las propiedades del objeto Button para manipular botones con ActionScript. Los nombres de instancias de botn se muestran en el Explorador de pelculas y en el cuadro de dilogo Insertar ruta de destino del panel Acciones. El objeto Button proviene del objeto Object. El objeto Button es compatible con Flash Player 6. Resumen de los mtodos del objeto Button
Mtodo Button.getDepth Descripcin Devuelve la profundidad de una instancia de botn.

94

Resumen de las propiedades del objeto Button

Propiedad Button._alpha Button.enabled Button._focusrect Button._height Button._highquality Button._name Button._parent Button._quality Button._rotation Button._soundbuftime Button.tabEnabled Button.tabIndex Button._target Button.trackAsMenu Button._url Button.useHandCursor Button._visible Button._width Button._x Button._xmouse Button._xscale Button._y Button._ymouse Button._yscale Descripcin Valor de transparencia de una instancia de botn. Indica si un botn est activo. Indica si un botn con seleccin est rodeado por un rectngulo amarillo. Altura de una instancia de botn, en pxeles. Indica la calidad de representacin de la pelcula. Nombre de instancia de una instancia de botn. Referencia a la instancia de clip de pelcula de la que depende esta instancia. Indica la calidad de representacin de la pelcula. Grado de rotacin de una instancia de botn. Nmero de segundos que tarda un sonido en precargarse. Indica si un botn se incluye en un orden de tabulacin automtico. Indica el orden de tabulacin de un objeto. Ruta de destino de una instancia de botn. Indica si otros botones pueden recibir eventos al soltar el ratn. URL del archivo SWF que ha creado la instancia de botn. Indica si el cursor con forma de mano aparece cuando el ratn pasa sobre un botn. Valor booleano que determina si una instancia de botn est oculta o visible. Anchura de una instancia de botn, en pxeles. Coordenada x de una instancia de botn. Coordenada x del cursor con relacin a una instancia de botn. Valor que especifica el porcentaje de escala horizontal que se aplica a una instancia de botn. Coordenada y de una instancia de botn. Coordenada y del cursor con relacin a una instancia de botn. Valor que especifica el porcentaje de escala vertical que se aplica a una instancia de botn.

Resumen de eventos del objeto Button

En la tabla siguiente se muestra una lista de los resmenes de eventos del objeto Button.
Mtodo Button.onDragOut Button.onDragOver Descripcin Se invoca mientras el puntero se encuentra fuera del botn, se presiona el botn del ratn y, a continuacin, se desplaza fuera del rea del botn. Se invoca mientras el puntero se encuentra sobre el botn, se ha presionado el botn del ratn, se ha desplazado fuera del botn y ha vuelto a desplazarse sobre el botn. Se invoca cuando se suelta una tecla.

Button.onKeyUp

Diccionario de ActionScript

95

Mtodo Button.onKillFocus Button.onPress Button.onRelease Button.onReleaseOutside Button.onRollOut Button.onRollOver Button.onSetFocus

Descripcin Se invoca cuando se pierde la seleccin de un botn. Se invoca cuando se presiona el ratn mientras el puntero est sobre un botn. Se invoca cuando se suelta el ratn mientras el puntero est sobre un botn. Se invoca cuando se suelta el ratn mientras el puntero est fuera del botn despus de presionar el botn mientras el puntero est dentro del botn. Se invoca cuando el puntero se desplaza fuera del rea de un botn. Se invoca cuando el puntero del ratn se desplaza sobre un botn. Se invoca cuando un botn tiene la seleccin de entrada y se suelta una tecla.

Button._alpha
Disponibilidad

Flash Player 6.
Sintaxis

myButton._alpha
Descripcin

Propiedad; define o recupera la transparencia alfa (valor) del botn especificado por Button. Los valores vlidos van de 0 (completamente transparente) a 100 (completamente opaco). Los objetos de un botn con _alpha establecido en 0 estn activos, aunque no sean visibles.
Ejemplo

En el ejemplo siguiente la propiedad _alpha de un botn denominado star se establece en 30%.

on(release) { star._alpha = 30; }

Button.enabled
Disponibilidad

Flash Player 6.
Sintaxis

myButton.enabled
Descripcin

Propiedad; un valor booleano que especifica si un botn est activado. El valor predeterminado es true.

Button._focusrect
Disponibilidad

Flash Player 6.
Sintaxis

myButton._focusrect

96

Descripcin

Propiedad; un valor booleano que especifica si aparece un rectngulo amarillo alrededor del botn que est resaltado mediante el teclado. Esta propiedad puede prevalecer sobre la propiedad global _focusrect.

Button.getDepth
Disponibilidad

Flash Player 6.
Sintaxis

myButton.getDepth()
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve la profundidad de una instancia de botn.

Button._height
Disponibilidad

Flash Player 6.
Sintaxis

myButton._height
Descripcin

Propiedad; establece y recupera la altura del botn en pxeles.

Ejemplo

En el cdigo de ejemplo siguiente se establece la altura y la anchura de un botn cuando el usuario hace clic con el ratn.
myButton._width = 200; myButton._height = 200;

Button._highquality
Disponibilidad

Flash Player 6.
Sintaxis

myButton._highquality
Descripcin

Propiedad (global); especifica el nivel de suavizado aplicado a la pelcula actual. Especifique 2 (BEST) para aplicar alta calidad con el suavizado de mapa de bits siempre activado. Especifique 1 (alta calidad) para aplicar suavizado; esto suavizar los mapas de bits si la pelcula no contiene animacin. Especifique 0 (baja calidad) para evitar el suavizado.
Ejemplo

_highquality = 1;

Diccionario de ActionScript

97

Vase tambin

_quality, toggleHighQuality

Button._name
Disponibilidad

Flash Player 6.
Sintaxis

myButton._name
Descripcin

Propiedad; devuelve el nombre de instancia del botn especificado por myButton.

Button.onDragOut
Disponibilidad

Flash Player 6.
Sintaxis

myButton.onDragOut
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando se presiona el botn del ratn sobre el botn y, a continuacin, el puntero se desplaza fuera del botn.

Button.onDragOver
Disponibilidad

Flash Player 6.
Sintaxis

myButton.onDragOver
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando el usuario presiona y arrastra el botn del ratn fuera del botn y, a continuacin, sobre ste. Debe definir una funcin que se ejecute cuando se invoque el evento.

98

Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onKeyDown que enva una accin trace a la ventana Salida:
myButton.onDragOver = function () { trace ("se ha llamado al mtodo onDragOver"); };
Vase tambin

Button.onKeyUp

Button.onKeyDown
Disponibilidad

Flash Player 6.
Sintaxis

myButton.onKeyDown
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando un botn se selecciona mediante el teclado y se presiona una tecla. El evento onKeyDown se invoca sin parmetros. Puede utilizar los mtodos Key.getAscii y Key.getCode para determinar la tecla que se ha presionado. Debe definir una funcin que se ejecute cuando se invoque el evento.
Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onKeyDown que enva una accin trace a la ventana Salida:
myButton.onKeyDown = function () { trace ("se ha llamado al mtodo onKeyDown"); };
Vase tambin

Button.onKeyUp

Button.onKeyUp
Disponibilidad

Flash Player 6.
Sintaxis

myButton.onKeyUp
Parmetros

Ninguno.
Valor devuelto

Ninguno.

Diccionario de ActionScript

99

Descripcin

Controlador de eventos; se invoca cuando un botn tiene la seleccin de entrada y se suelta una tecla. El evento onKeyUp se invoca sin parmetros. Puede utilizar los mtodos Key.getAscii y Key.getCode para determinar la tecla que se ha presionado. Debe definir una funcin que se ejecute cuando se invoque el evento.
Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onKeyPress que enva una accin trace a la ventana Salida:
myButton.onKeyUp = function () { trace ("se ha llamado al mtodo onKeyUp"); };

Button.onKillFocus
Disponibilidad

Flash Player 6.
Sintaxis

myButton.onKillFocus = function (nuevaSeleccin) { sentencias;

};
Parmetros

nuevaSeleccin
Valor devuelto

El objeto que pasar a estar seleccionado.

Ninguno.
Descripcin

Controlador de eventos; un evento que se invoca cuando un botn no se selecciona con el teclado. El mtodo onKillFocus recibe un parmetro, nuevaSeleccin, que es un objeto que representa el nuevo objeto seleccionado. Si no hay ningn objeto seleccionado, nuevaSeleccin contiene el valor null.

Button.onPress
Disponibilidad

Flash Player 6.
Sintaxis

myButton.onPress
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando se presiona un botn. Debe definir una funcin que se ejecute cuando se invoque el evento.

100

Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onPress que enva una accin trace a la ventana Salida.
myButton.onPress = function () { trace ("se ha llamado al mtodo onPress"); };

Button.onRelease
Disponibilidad

Flash Player 6.
Sintaxis

myButton.onRelease
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando se suelta un botn. Debe definir una funcin que se ejecute cuando se invoque el evento.
Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onRelease que enva una accin trace a la ventana Salida.
myButton.onRelease = function () { trace ("se ha llamado al mtodo onRelease"); };

Button.onReleaseOutside
Disponibilidad

Flash Player 6.
Sintaxis

myButton.onReleaseOutside
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando se suelta el ratn mientras el puntero est fuera del botn despus de que se haya presionado el botn mientras el puntero estaba dentro del botn. Debe definir una funcin que se ejecute cuando se invoque el evento.

Diccionario de ActionScript

101

Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onReleaseOutside que enva una accin trace a la ventana Salida.
myButton.onReleaseOutside = function () { trace ("se ha llamado al mtodo onReleaseOutside"); };

Button.onRollOut
Disponibilidad

Flash Player 6.
Sintaxis

myButton.onRollOut
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando el puntero se desplaza fuera del rea de un botn. Debe definir una funcin que se ejecute cuando se invoque el evento.
Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onRollOut que enva una accin trace a la ventana Salida.
myButton.onRollOut = function () { trace ("se ha llamado al mtodo onRollOut"); };

Button.onRollOver
Disponibilidad

Flash Player 6.
Sintaxis

myButton.onRollOver
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando el puntero se desplaza sobre el rea de un botn. Debe definir una funcin que se ejecute cuando se invoque el evento.

102

Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onRollOver que enva una accin trace a la ventana Salida.
myButton.onRollOver = function () { trace ("se ha llamado al mtodo onRollOver");

};

Button.onSetFocus
Disponibilidad

Flash Player 6.
Sintaxis

myButton.onSetFocus = function(seleccinAnterior){ sentencias; };

Parmetros

seleccinAnterior
Valor devuelto

Objeto que va a perder la seleccin.

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando un botn se selecciona mediante el teclado. El parmetro seleccinAnterior es el objeto que deja de estar seleccionado. Por ejemplo, si el usuario presiona la tecla Tabulador para mover la seleccin de entrada de un campo de texto a un botn, seleccinAnterior contiene la instancia de campo de texto. Si no hay ningn objeto seleccionado anteriormente, seleccinAnterior contiene un valor null.

Button._parent
Disponibilidad

Flash Player 6.
Sintaxis

_parent.property
Descripcin

Propiedad; especifica o devuelve una referencia al clip de pelcula que contiene el objeto o el clip de pelcula. El objeto actual es el que contiene el cdigo de ActionScript que hace referencia a _parent. Utilice _parent para especificar una ruta relativa a los clips de pelcula u objetos que estn por encima del clip de pelcula u objeto actual. Puede utilizar _parent para subir varios niveles en la lista de visualizacin, como se muestra a continuacin:
_parent._parent._alpha = 20;
Vase tambin

_root, targetPath

Diccionario de ActionScript 103

Button._quality
Disponibilidad

Flash Player 6.
Sintaxis

myButton._quality
Descripcin

Propiedad (global); establece o recupera la calidad de representacin utilizada para una pelcula. Las fuentes de dispositivo siempre son dentadas, de modo que no se ven afectadas por la propiedad _quality. La propiedad _quality puede definirse en los valores siguientes:

"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 utilizando una cuadrcula de pxeles de 2 x 2, pero los mapas de bits no se suavizan. Apropiado para pelculas que no contienen texto.

"HIGH" Calidad de representacin alta. Los grficos se suavizan utilizando una cuadrcula de pxeles de 4 x 4 y los mapas de bits se suavizan si la pelcula es esttica. sta es la configuracin de la calidad de representacin predeterminada utilizada por Flash. "BEST"

Calidad de representacin muy alta. Los grficos se suavizan utilizando una cuadrcula de pxeles de 4 x 4 y los mapas de bits se suavizan siempre.

Ejemplo

En el ejemplo siguiente, se define la calidad de representacin en LOW:

myButton._quality = "LOW";
Vase tambin

_highquality, toggleHighQuality

Button._rotation
Disponibilidad

Flash Player 6.
Sintaxis

myButton._rotation
Descripcin

Propiedad; especifica la rotacin del botn en grados.

Button._soundbuftime
Disponibilidad

Flash Player 6.
Sintaxis

myButton._soundbuftime

104

Descripcin

Propiedad (global); entero que especifica el nmero de segundos que un sonido se almacena previamente en una memoria intermedia antes de que empiece a fluir.

Button.tabEnabled
Disponibilidad

Flash Player 6.
Sintaxis

myButton.tabEnabled
Descripcin

Propiedad; puede establecerse en una instancia de los objetos MovieClip, Button o TextField. El valor predeterminado es undefined. Si la propiedad tabEnabled es undefined o true, el objeto se incluye en el orden de tabulacin automtico. El objeto se incluye en el orden de tabulacin personalizado si la propiedad tabIndex se establece tambin en un valor. Si el valor de tabEnabled es false, el objeto no se incluye en el orden de tabulacin automtico. En el caso de un clip de pelcula, si tabEnabled es false, los valores secundarios del clip de pelcula pueden seguir incluyndose en el orden de tabulacin automtico, a menos que la propiedad tabChildren tambin se establezca en false. Si tabEnabled es undefined o true y si se establece la propiedad tabIndex, el objeto se incluye en el orden de tabulacin personalizado. Si tabEnabled es false, el objeto no se incluye en el orden de tabulacin personalizado, aunque se establezca la propiedad tabIndex. Si tabEnabled se establece en false en un clip de pelcula, los elementos secundarios del clip de pelcula pueden incluirse an en el orden de tabulacin personalizado.
Vase tambin

Button.tabIndex

Button.tabIndex
Disponibilidad

Flash Player 6.
Sintaxis

myButton.tabIndex
Descripcin

Propiedad; permite personalizar el orden de tabulacin de los objetos de una pelcula. Puede establecer la propiedad tabIndex de un botn, un clip de pelcula o una instancia de campo de texto; de manera predeterminada es undefined. Si alguno de los objetos que se muestran en la pelcula Flash contiene una propiedad tabIndex, el orden de tabulacin automtico est desactivado, y el orden de tabulacin se calcula a partir de las propiedades tabIndex de los objetos de la pelcula. 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 de acuerdo con sus propiedades tabIndex, en orden ascendente. Un objeto con una propiedad tabIndex de 1 va antes que un objeto con una propiedad tabIndex 2. Si dos objetos tienen la misma propiedad tabIndex, el que va antes que el otro en el orden de tabulacin es undefined.

Diccionario de ActionScript 105

El orden de tabulacin personalizado definido por la propiedad tabIndex es flat. Esto significa que no se tienen en cuenta las relaciones jerrquicas de los objetos de la pelcula Flash. Todos los objetos de la pelcula Flash con propiedades tabIndex se colocan en el orden de tabulacin, que viene determinado por el orden de los valores tabIndex. Si los dos objetos tienen el mismo valor de tabIndex, el primero ser "undefined". No debe utilizarse el mismo valor de tabIndex para varios objetos.

Button._target
Disponibilidad

Flash Player 6.
Sintaxis

myButton._target
Descripcin

Propiedad (slo lectura); devuelve la ruta de destino de la instancia de botn especificada en el parmetro Button.

Button.trackAsMenu
Disponibilidad

Flash Player 6.
Sintaxis

myButton.trackAsMenu
Descripcin

Propiedad; propiedad booleana que indica si los botones o los clips de pelcula pueden recibir o no eventos al soltar el ratn. Permite crear mens. Puede establecer la propiedad trackAsMenu en cualquiera de los objetos de botn o de clip de pelcula. Si la propiedad trackAsMenu no existe, el comportamiento predeterminado es false. Puede cambiar la propiedad trackAsMenu en cualquier momento; el botn modificado asume el nuevo comportamiento inmediatamente.
Vase tambin

MovieClip.trackAsMenu

Button._url
Disponibilidad

Flash Player 6.
Sintaxis

myButton._url
Descripcin

Propiedad (slo lectura); recupera el URL del archivo SWF que ha creado el botn.

106

Button.useHandCursor
Disponibilidad

Flash Player 6.
Sintaxis

myButton.useHandCursor
Descripcin

Propiedad; un valor booleano que, cuando se establece en true, indica si se visualiza un cursor con forma de mano cuando el usuario desplaza el cursor sobre un botn. El valor predeterminado de useHandCursor es true. Si la propiedad useHandCursor se establece en false, se utiliza el cursor con forma de flecha. Puede cambiar la propiedad useHandCursor en cualquier momento; el botn modificado asume de inmediato el comportamiento del nuevo cursor. La propiedad useHandCursor puede leerse fuera de un objeto prototipo.

Button._visible
Disponibilidad

Flash Player 6.
Sintaxis

myButton._visible
Descripcin

Propiedad; valor booleano que indica si el botn especificado por el parmetro Button est visible. Los botones que no estn visibles (propiedad _visible establecida en false) se desactivan.

Button._width
Disponibilidad

Flash Player 6.
Sintaxis

myButton._width
Descripcin

Propiedad; establece y recupera la anchura del botn, en pxeles.

Ejemplo

En el ejemplo siguiente se establecen las propiedades de altura y anchura de un botn.

myButton._width=200; myButton._height=200;
Vase tambin

MovieClip._width

Button._x
Disponibilidad

Flash Player 6.

Diccionario de ActionScript 107

Sintaxis

myButton._x
Descripcin

Propiedad; entero que establece la coordenada x de un botn con relacin a las coordenadas locales del clip de pelcula principal. Si un botn est 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 se encuentra dentro de un clip de pelcula que tiene transformaciones, el botn pertenece al sistema de coordenadas local del clip de pelcula que lo contiene. Por lo tanto, en el caso de un clip de pelcula girado 90 en sentido contrario a las agujas del reloj, el botn incluido hereda un sistema de coordenadas girado 90 en sentido contrario a las agujas del reloj. Las coordenadas del botn hacen referencia a la posicin del punto de registro.
Vase tambin

Button._xscale, Button._y, Button._yscale

Button._xmouse
Disponibilidad

Flash Player 6.
Sintaxis

myButton._xmouse
Descripcin

Propiedad (slo lectura); devuelve la coordenada x de la posicin del ratn con relacin al botn.
Vase tambin

Button._ymouse

Button._xscale
Disponibilidad

Flash Player 6.
Sintaxis

myButton._xscale
Descripcin

Propiedad; determina la escala horizontal (porcentaje) del botn que se aplica desde el punto de registro del botn. El punto de registro predeterminado es (0,0). Cambiar la escala del sistema de coordenadas local afecta a los valores de las propiedades _x e _y, que se definen en pxeles. Por ejemplo, si se cambia la escala del clip de pelcula principal al 50%, al establecer la propiedad _x se mueve un objeto del botn la mitad del nmero de pxeles que lo hara si la pelcula estuviera al 100%.
Vase tambin

Button._x, Button._y, Button._yscale

108

Button._y
Disponibilidad

Flash Player 6.
Sintaxis

myButton._y
Descripcin

Propiedad; establece la coordenada y del botn con relacin a las coordenadas locales del clip de pelcula principal. Si un botn est 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 se encuentra dentro de otro clip de pelcula que tiene transformaciones, el botn est en el sistema de coordenadas local del clip de pelcula que lo contiene. Por lo tanto, en el caso de un clip de pelcula girado 90 en sentido contrario a las agujas del reloj, el botn incluido hereda un sistema de coordenadas girado 90 en sentido contrario a las agujas del reloj. Las coordenadas del botn hacen referencia a la posicin del punto de registro.
Vase tambin

Button._x, Button._xscale, Button._yscale

Button._ymouse
Disponibilidad

Flash Player 6.
Sintaxis

myButton._ymouse
Descripcin

Propiedad (slo lectura); indica la coordenada y de la posicin del ratn con relacin al botn.
Vase tambin

Button._xmouse

Button._yscale
Disponibilidad

Flash Player 6.
Sintaxis

myButton._yscale
Descripcin

Propiedad; establece la escala vertical (porcentaje) del botn que se aplica desde el punto de registro del botn. El punto de registro predeterminado es (0,0).
Vase tambin

Button._y, Button._x, Button._xscale

Diccionario de ActionScript 109

call
Disponibilidad

Flash Player 4. Esta accin se ha desestimado en Flash 5; en su lugar, se recomienda utilizar la accin function.
Sintaxis

call(fotograma)
Parmetros

fotograma

Etiqueta o nmero de un fotograma en la lnea de tiempo.

Valor devuelto

Ninguno.
Descripcin

Accin; ejecuta el script en el fotograma al que se ha llamado sin mover la cabeza lectora a ese fotograma. Las variables locales no existirn cuando el script termine su ejecucin.
Vase tambin

function

call function
Disponibilidad

Flash Player 6
Sintaxis

objeto.funcin([parmetros])
Parmetros

objeto funcin

Objeto (puede ser un clip de pelcula) en el que se ha definido la funcin. Identificador que especifica una funcin definida por el usuario. Parmetro opcional que indica los parmetros que requiere la funcin.

parmetros

Valor devuelto

Ninguno.
Descripcin

Accin; permite utilizar campos de parmetro para llamar a una funcin definida por el usuario en modo normal en el panel Acciones.

case
Disponibilidad

Flash Player 4.
Sintaxis

case expresin: sentencias

110

Parmetros

expresin sentencias

Cualquier expresin. Cualquier nmero de sentencias.

Valor devuelto

Ninguno.
Descripcin

Palabra clave; define una condicin para la accin switch. Las sentencias del parmetro sentencias se ejecutan si el parmetro expresin que sigue a la palabra clave case es igual al parmetro expresin de la accin switch utilizando la igualdad estricta (===) Si utiliza la accin case fuera de una sentencia switch, se genera un error y el script no se compila.
Vase tambin

switch, default, break, === (igualdad estricta)

chr
Disponibilidad

Flash Player 4. Esta funcin se ha desestimado en Flash 5; se recomienda utilizar el mtodo String.fromCharCode.
Sintaxis

chr(nmero)
Parmetros

nmero

Nmero de cdigo ASCII.

Valor devuelto

Ninguno.
Descripcin

Funcin de cadena; convierte los nmeros de cdigo ASCII en caracteres.

Ejemplo

En el ejemplo siguiente el nmero 65 se convierte en la letra A y se asigna a la variable myVar.

myVar = chr(65);
Vase tambin

String.fromCharCode

clearInterval
Disponibilidad

Flash Player 6.
Sintaxis

clearInterval( IDintervalo )
Parmetros

IDintervalo

Objeto devuelto de una llamada a la funcin setInterval.

Diccionario de ActionScript

111

Valor devuelto

Ninguno.
Descripcin

Accin; cancela una llamada a la funcin setInterval.

Ejemplo

En el ejemplo siguiente se establece, en primer lugar, una llamada de intervalo y, a continuacin, se cancela:
function callback() { trace("intervalo llamado"); } var IDintervalo; IDintervalo = setInterval( callback, 1000 ); // posteriormente clearInterval( IDintervalo );
Vase tambin

setInterval

Color (objeto)
El objeto Color permite establecer el valor de color RGB y de transformacin del color de los clips de pelcula y recuperar esos valores una vez establecidos. Debe utilizar el constructor new Color() para crear una instancia del objeto Color antes de llamar a sus mtodos. El objeto Color se admite en Flash 5 y en versiones posteriores de Flash Player. Resumen de los mtodos del objeto Color
Mtodo Color.getRGB Color.getTransform Color.setRGB Color.setTransform Descripcin Devuelve el valor numrico RGB establecido por la ltima llamada setRGB. Devuelve la informacin de transformacin establecida por la ltima llamada setTransform. Establece la representacin hexadecimal del valor RGB para un objeto Color. Establece la transformacin de color para un objeto Color.

Constructor del objeto Color

Disponibilidad

Flash Player 5.
Sintaxis

new Color(destino)
Parmetros

destino

Nombre de instancia de un clip de pelcula.

Valor devuelto

Ninguno.

112

Descripcin

Constructor; crea una instancia del objeto Color para el clip de pelcula especificado por el parmetro destino. Puede utilizar los mtodos de ese objeto Color para cambiar el color de todo el clip de pelcula de destino.
Ejemplo

En el ejemplo siguiente se crea una instancia del objeto Color denominada myColor para el clip de pelcula myMovieClip y se establece su valor RGB:
myColor = new Color(myMovieClip); myColor.setRGB(0xff9933);

Color.getRGB
Disponibilidad

Flash Player 5.
Sintaxis

myColor.getRGB()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; devuelve los valores numricos establecidos por la ltima llamada setRGB.
Ejemplo

En el cdigo siguiente se recupera el valor RGB de la instancia del objeto Color myColor, se convierte en una cadena hexadecimal y se le asigna una variable value.
value = myColor.getRGB().toString(16);
Vase tambin

Color.setRGB

Color.getTransform
Disponibilidad

Flash Player 5.
Sintaxis

myColor.getTransform()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; devuelve el valor de transformacin establecido por la ltima llamada setTransform.

Diccionario de ActionScript

113

Vase tambin

Color.setTransform

Color.setRGB
Disponibilidad

Flash Player 5.
Sintaxis

myColor.setRGB(0xRRGGBB)
Parmetros

0xRRGGBB Color hexadecimal o RGB que se va a establecer. RR (rojo), GG (verde) y BB (azul) constan de dos dgitos hexadecimales respectivamente que especifican el desplazamiento de cada componente de color. 0x indica al compilador de ActionScript que el nmero es un valor hexadecimal.
Descripcin

Mtodo; especifica un color RGB para una instancia del objeto Color. Si se llama a este mtodo, prevalece sobre cualquier configuracin anterior del mtodo setTransform.
Valor devuelto

Ninguno.
Ejemplo

En este ejemplo se establece el valor de color RGB para el clip de pelcula myMovie. Para ver este cdigo en funcionamiento, coloque un clip de pelcula en el escenario con el nombre de instancia myMovie. A continuacin, coloque el cdigo siguiente en el fotograma 1 de la lnea de tiempo principal y elija Control > Probar pelcula.
myColor = new Color(myMovie); myColor.setRGB(0x993366);
Vase tambin

Color.setTransform

Color.setTransform
Disponibilidad

Flash Player 5.
Sintaxis

myColor.setTransform(objetoTransformacinColor);
Parmetros

Objeto creado con el constructor new Object. Esta instancia del objeto Object debe tener las siguientes propiedades que especifican los valores de transformacin del color: ra, rb, ga, gb, ba, bb, aa, ab. Estas propiedades se explican a continuacin.
objetoTransformacinColor
Valor devuelto

Ninguno.

114

Descripcin

Mtodo; establece la informacin de transformacin del color de una instancia del objeto Color. El parmetro objetoTransformacinColor es un objeto genrico que se crea a partir del constructor new Object. Dispone de parmetros que especifican el porcentaje y los valores de desplazamiento de los componentes, rojo (R), verde (G), azul (B) y transparencia alfa (A) de un color, especificados en formato 0xRRGGBBAA. Los parmetros de un objeto de transformacin del color corresponden a la configuracin del cuadro de dilogo Efecto avanzado y se definen del modo siguiente: ra es el porcentaje del componente rojo (de -100 a 100).

rb ga gb ba bb aa ab

es el desplazamiento del componente rojo (de -255 a 255). es el porcentaje del componente verde (de -100 a 100). es el desplazamiento del componente verde (de -255 a 255). es el porcentaje del componente azul (de -100 a 100). es el desplazamiento del componente azul (de -255 a 255). es el porcentaje de transparencia alfa (de -100 a 100). es el desplazamiento de transparencia alfa (de -255 a 255).

Cree un parmetro objetoTransformacinColor como se muestra a continuacin:

myColorTransform = 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 sintaxis siguiente para crear un parmetro objetoTransformacinColor:

myColorTransform = { ra: 50, rb: 244, ga: 40, gb: 112, ba: 12, bb: 90, aa: 40, ab: 70}
Ejemplo

En este ejemplo se crea una nueva instancia del objeto Color para una pelcula de destino, se crea un objeto genrico denominado myColorTransform con las propiedades definidas anteriormente y se utiliza el mtodo setTransform para pasar el parmetro objetoTransformacinColor a un objeto Color. Para utilizar este cdigo en un documento de Flash (FLA), colquelo en el fotograma 1 de la lnea de tiempo principal y coloque un clip de pelcula en el escenario con el nombre de instancia myMovie, como se indica en el cdigo siguiente:
// Crear un objeto de color denominado myColor para myMovie myColor = new Color(myMovie); // Crear un objeto de transformacin del color denominado myColorTransfrom con // el objeto Object genrico myColorTransform = new Object(); // Establecer los valores de myColorTransform myColorTransform = { ra: '50', rb: '244', ga: '40', gb: '112', ba: '12', bb: '90', aa: '40', ab: '70'}; // Asociar el objeto de transformacin del color con el objeto Color // creado para myMovie myColor.setTransform(myColorTransform);

Diccionario de ActionScript

115

continue
Disponibilidad

Flash Player 4.
Sintaxis

continue
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Accin; aparece dentro de varios tipos de sentencias de bucle; funciona de forma distinta en cada tipo de bucle. En un bucle while, continue hace que el intrprete de Flash omita el resto del cuerpo del bucle y salte al principio del bucle, donde se comprueba la condicin. En un bucle do while, continue hace que el intrprete de Flash omita el resto del cuerpo del bucle y salte al final del bucle, donde se comprueba la condicin. En un bucle for, continue hace que el intrprete de Flash omita el resto del cuerpo del bucle y salte al clculo de la postexpresin del bucle for. En un bucle for..in, continue hace que el intrprete de Flash omita el resto del cuerpo del bucle y salte al principio del bucle, donde se procesa el siguiente valor de la enumeracin.
Vase tambin

do while, for, for..in, while

CustomActions (objeto)
Los mtodos del objeto CustomActions permiten que una pelcula Flash que se reproduzca en la herramienta de edicin de Flash gestione las acciones personalizadas que se registran con la herramienta de edicin. Las pelculas Flash pueden instalar y desinstalar acciones personalizadas, recuperar la definicin XML de una accin personalizada y recuperar la lista de las acciones personalizadas registradas. Puede utilizar estos mtodos para crear pelculas Flash que sean extensiones de la herramienta de edicin de Flash. Este tipo de pelcula podra, por ejemplo, utilizar el protocolo de aplicacin de Flash para navegar por un repositorio UDDI y descargar servicios Web en la caja de herramientas Acciones.

116

Resumen de los mtodos del objeto CustomActions

Mtodo CustomActions.get CustomActions.install CustomActions.list CustomActions.uninstall Descripcin Lee el contenido de un archivo de definicin XML de acciones personalizadas. Instala un archivo de definicin XML de acciones personalizadas nuevo. Devuelve una lista de todas las acciones personalizadas registradas. Elimina un archivo de definicin XML de acciones personalizadas.

CustomActions.get
Disponibilidad

Flash Player 6.
Sintaxis

CustomActions.get(nombreAccionesPersonalizadas)
Parmetros

nombreAccionesPersonalizadas

Nombre de la definicin de la accin personalizada que

debe recuperarse.
Valor devuelto

Ninguno.
Descripcin

Mtodo; lee el contenido del archivo de definicin XML de acciones personalizadas denominado nombreAccionesPersonalizadas. El nombre del archivo de definicin debe ser un nombre simple, sin la extensin .xml y sin separadores de directorio (':', '/' o '\'). Si no se encuentra el archivo de definicin especificado por nombreAccionesPersonalizadas, se devuelve el valor undefined. Si se encuentra la definicin XML de acciones personalizadas especificada por el parmetro nombreAccionesPersonalizadas, se la lee completamente y se devuelve como cadena.

CustomActions.install
Disponibilidad

Flash Player 6.
Sintaxis

CustomActions.install(nombreAccionesPersonalizadas, definicinXMLpersonalizada)
Parmetros

nombreAccionesPersonalizadas

Nombre de la definicin de la accin personalizada que Texto de la definicin XML que debe instalarse.

debe instalarse.
definicinXMLpersonalizada
Valor devuelto

Ninguno.

Diccionario de ActionScript

117

Descripcin

Mtodo; instala una nueva definicin XML de acciones personalizadas indicada por el parmetro nombreAccionesPersonalizadas. El contenido del archivo se especifica mediante la cadena definicinXMLpersonalizada. El nombre del archivo de definicin debe ser un nombre simple, sin la extensin .xml y sin separadores de directorio (':', '/' o '\'). Si ya existe un archivo de acciones personalizadas con el nombre nombreAccionesPersonalizadas, se lo sobrescribir. Si se produce un error durante la instalacin, se devuelve el valor false; de lo contrario, se devuelve el valor true para indicar que la accin personalizada se ha instalado correctamente. Si no existe el directorio Configuration/ActionsPanel/CustomActions cuando se invoca este mtodo, se lo crear.

CustomActions.list
Disponibilidad

Flash Player 6.
Sintaxis

CustomActions.list()
Parmetros

Ninguno.
Valor devuelto

Una matriz.
Descripcin

Mtodo; devuelve un objeto Array que contiene los nombres de todas las acciones personalizadas que se han registrado con la herramienta de edicin de Flash. Los elementos de la matriz son nombres simples, sin la extensin de archivo .xml y sin separadores de directorio (por ejemplo, :, / o \). Si no hay acciones personalizadas registradas, el mtodo list devuelve una matriz de longitud cero. Si se produce un error, el mtodo list devuelve el valor undefined.

CustomActions.uninstall
Disponibilidad

Flash Player 6.
Sintaxis

CustomActions.uninstall(nombreAccionesPersonalizadas)
Parmetros

nombreAccionesPersonalizadas

Nombre de la definicin de la accin personalizada que

debe desinstalarse.
Valor devuelto

Ninguno.

118

Descripcin

Mtodo; elimina el archivo de definicin XML de acciones personalizadas nombreAccionesPersonalizadas. El nombre del archivo de definicin debe ser un nombre simple, sin la extensin .xml y sin separadores de directorio (':', '/' o '\'). Si no se encuentran acciones personalizadas con el nombre nombreAccionesPersonalizadas, se devuelve el valor false. Si se han eliminado correctamente las acciones personalizadas, se devuelve el valor true.

Date (objeto)
El objeto Date permite recuperar valores de fecha y hora relativos a la hora universal (Hora de Greenwich, que ahora se denomina hora universal o UTC) o relativos al sistema operativo en el que se est ejecutando Flash Player. Los mtodos del objeto Date no son estticos, sino que se aplican a la instancia individual del objeto Date especificado cuando se llama al mtodo. El mtodo Date.UTC es una excepcin, ya que es un mtodo esttico. El objeto Date maneja el horario de verano de forma distinta en funcin del sistema operativo y la versin de Flash Player. Flash Player 6 maneja el horario de verano en los sistemas operativos indicados del modo siguiente:

Windows: el objeto Date se ajusta automticamente segn el horario de verano. El objeto Date
detecta si se emplea el horario de verano en el entorno regional actual y, si es as, detecta la fecha y la hora en que se pasa del horario estndar al horario de verano. Sin embargo, si las fechas de transicin que estn en vigor en ese momento se aplican en fechas pasadas o futuras, puede que la diferencia horaria del horario de verano no se calcule correctamente en el caso de fechas pasadas si el entorno regional tiene fechas de transicin diferentes.

Mac OS 8 y 9: el objeto Date utiliza la diferencia horaria del horario de verano actual,
independientemente de la fecha o la hora que se est calculando. Por ejemplo, en la zona horaria del Pacfico de EE.UU. en agosto, cuando se usa el horario de verano (DST), un objeto Date que contenga la fecha 1 de enero de 2001 sigue notificando el horario DST, aunque el horario DST no se utiliza en enero. Este problema no se puede solucionar en Mac OS 8 9 porque no hay disponible una base de datos de informacin de zonas horarias.

Mac OS X: el objeto Date se ajusta de forma automtica para el horario de verano. La base de
datos de informacin de zonas horarias de Mac OS X sirve para determinar si a las fechas y horas pasadas o futuras se les debe aplicar una diferencia horaria debida al horario de verano. Flash Player 5 maneja el horario de verano en estos sistemas operativos del modo siguiente:

Mac OS 8 y 9: el funcionamiento es el mismo que el descrito para Flash Player 6. Windows: se aplica siempre la normativa de EE.UU. para el horario de verano, lo que lleva a
transiciones incorrectas en Europa y otras zonas que tambin tienen un horario de verano, pero que su momento de transicin es distinto al de EE.UU. Flash detecta correctamente si el entorno regional actual utiliza el horario de verano. Para llamar los mtodos del objeto Date, primero debe crear una instancia del objeto Date mediante el constructor del objeto Date. El objeto Date requiere Flash Player 5.

Diccionario de ActionScript

119

Resumen de mtodos del objeto Date

Mtodo Date.getDate Date.getDay Date.getFullYear Date.getHours Date.getMilliseconds Date.getMinutes Date.getMonth Date.getSeconds Date.getTime Date.getTimezoneOffset Date.getUTCDate Date.getUTCDay Date.getUTCFullYear Date.getUTCHours Date.getUTCMilliseconds Date.getUTCMinutes Date.getUTCMonth Date.getUTCSeconds Date.getYear Date.setDate Date.setFullYear Date.setHours Date.setMilliseconds Date.setMinutes Date.setMonth Date.setSeconds Date.setTime Date.setUTCDate Date.setUTCFullYear Descripcin Devuelve el da del mes segn la hora local. Devuelve el da de la semana segn la hora local. Devuelve el ao en formato de cuatro dgitos segn la hora local. Devuelve la hora segn la hora local. Devuelve los milisegundos segn la hora local. Devuelve los minutos segn la hora local. Devuelve el mes segn la hora local. Devuelve los segundos segn la hora local. Devuelve el nmero de milisegundos desde la medianoche del 1 de enero de 1970, hora universal. Devuelve la diferencia, en minutos, entre la hora local del sistema y la hora universal. Devuelve el da (fecha) del mes segn la hora universal. Devuelve el da de la semana segn la hora universal. Devuelve el ao en formato de cuatro dgitos segn la hora universal. Devuelve la hora segn la hora universal. Devuelve los milisegundos segn la hora universal. Devuelve los minutos segn la hora universal. Devuelve el mes segn la hora universal. Devuelve los segundos segn la hora universal. Devuelve el ao segn la hora local. Establece el da del mes segn la hora local. Devuelve la nueva hora en milisegundos. Establece el ao completo segn la hora local. Devuelve la nueva hora en milisegundos. Establece la hora segn la hora local. Devuelve la nueva hora en milisegundos. Establece los milisegundos segn la hora local. Devuelve la nueva hora en milisegundos. Establece los minutos segn la hora local. Devuelve la nueva hora en milisegundos. Establece el mes segn la hora local. Devuelve la nueva hora en milisegundos. Establece los segundos segn la hora local. Devuelve la nueva hora en milisegundos. Establece la fecha en milisegundos. Devuelve la nueva hora en milisegundos. Establece la fecha segn la hora universal. Devuelve la nueva hora en milisegundos. Establece el ao segn la hora universal. Devuelve la nueva hora en milisegundos.

120

Mtodo Date.setUTCHours Date.setUTCMilliseconds Date.setUTCMinutes Date.setUTCMonth Date.setUTCSeconds Date.setYear Date.toString Date.UTC

Descripcin Establece la hora segn la hora universal. Devuelve la nueva hora en milisegundos. Establece los milisegundos segn la hora universal. Devuelve la nueva hora en milisegundos. Establece los minutos segn la hora universal. Devuelve la nueva hora en milisegundos. Establece el mes segn la hora universal. Devuelve la nueva hora en milisegundos. Establece los segundos segn la hora universal. Devuelve la nueva hora en milisegundos. Establece el ao segn la hora local. Devuelve un valor de cadena que representa la fecha y la hora almacenada en el objeto Date especificado. Devuelve el nmero de milisegundos entre la medianoche del 1 de enero de 1970, hora universal, y la hora especificada.

Constructor del objeto Date

Disponibilidad

Flash Player 5.
Sintaxis

new Date() new Date(ao, mes [, fecha [, hora [, minuto [, segundo [, milisegundo ]]]]])
Parmetros

ao Valor de 0 a 99 que indica de 1900 a 1999; de lo contrario, deben especificarse los 4 dgitos del ao. mes fecha hora minuto segundo

Nmero entero de 0 (enero) a 11 (diciembre). Nmero entero de 1 a 31. Este parmetro es opcional. Nmero entero de 0 (medianoche) a 23 (11 PM). Nmero entero de 0 a 59. Este parmetro es opcional. Nmero entero de 0 a 59. Este parmetro es opcional. Nmero entero de 0 a 999. Este parmetro es opcional.

milisegundo
Valor devuelto

Un nmero entero.
Descripcin

Objeto; construye un nuevo objeto Date que contiene la fecha y la hora actual o la fecha especificada.
Ejemplo

El ejemplo siguiente recupera la fecha y la hora actuales.

now = new Date();

Diccionario de ActionScript

121

El ejemplo siguiente crea un nuevo objeto Date para el cumpleaos de Gary, el 7 de agosto de 1974.
gary_birthday = new Date (74, 7, 7);

En el ejemplo siguiente se crea un objeto new Date, se concatenan los valores devueltos de los mtodos del objeto Date getMonth, getDate y getFullYear y se muestran en el campo de texto especificado por la variable dateTextField.
myDate = new Date(); dateTextField = ((myDate.getMonth() + 1) + "/" + myDate.getDate() + "/" + myDate.getFullYear());

Date.getDate
Disponibilidad

Flash Player 5.
Sintaxis

myDate.getDate()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve el da del mes (un nmero entero de 1 a 31) del objeto Date especificado segn la hora local. La hora local la determina el sistema operativo en el que se est ejecutando Flash Player.

Date.getDay
Disponibilidad

Flash Player 5.
Sintaxis

myDate.getDay()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve el da de la semana (0 para el domingo, 1 para el lunes, etc.) del objeto Date especificado segn la hora local. La hora local la determina el sistema operativo en el que se est ejecutando Flash Player.

122

Date.getFullYear
Disponibilidad

Flash Player 5.
Sintaxis

myDate.getFullYear()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve el ao completo (un nmero de cuatro dgitos, por ejemplo, 2000) del objeto Date especificado segn la hora local. La hora local la determina el sistema operativo en el que se est ejecutando Flash Player.
Ejemplo

En el ejemplo siguiente se utiliza el constructor para crear un nuevo objeto Date y enviar el valor devuelto por el mtodo getFullYear a la ventana Salida.
myDate = new Date(); trace(myDate.getFullYear());

Date.getHours
Disponibilidad

Flash Player 5.
Sintaxis

myDate.getHours()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve la hora (un nmero entero de 0 a 23) del objeto Date especificado segn la hora local. La hora local la determina el sistema operativo en el que se est ejecutando Flash Player.

Date.getMilliseconds
Disponibilidad

Flash Player 5.
Sintaxis

myDate.getMilliseconds()
Parmetros

Ninguno.

Diccionario de ActionScript 123

Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve los milisegundos (un nmero entero de 0 a 999) del objeto Date especificado segn la hora local. La hora local la determina el sistema operativo en el que se est ejecutando Flash Player.

Date.getMinutes
Disponibilidad

Flash Player 5.
Sintaxis

myDate.getMinutes()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve los minutos (un nmero entero de 0 a 59) del objeto Date especificado segn la hora local. La hora local la determina el sistema operativo en el que se est ejecutando Flash Player.

Date.getMonth
Disponibilidad

Flash Player 5.
Sintaxis

myDate.getMonth()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve el mes (0 para enero, 1 para febrero, etc.) del objeto Date especificado, segn la hora local. La hora local la determina el sistema operativo en el que se est ejecutando Flash Player.

124

Date.getSeconds
Disponibilidad

Flash Player 5.
Sintaxis

myDate.getSeconds()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve los segundos (un nmero entero de 0 a 59) del objeto Date especificado, segn la hora local. La hora local la determina el sistema operativo en el que se est ejecutando Flash Player.

Date.getTime
Disponibilidad

Flash Player 5.
Sintaxis

myDate.getTime()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve el nmero de milisegundos desde la medianoche del 1 de enero de 1970, hora universal, para el objeto Date especificado. Utilice este mtodo para representar un instante especfico en el tiempo cuando compare dos o ms objetos Date.

Date.getTimezoneOffset
Disponibilidad

Flash Player 5.
Sintaxis

mydate.getTimezoneOffset()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve la diferencia, en minutos, entre la hora local del sistema y la hora universal.

Diccionario de ActionScript 125

Ejemplo

En el ejemplo siguiente se devuelve la diferencia entre el horario de verano local de San Francisco y la hora universal. El horario de verano se aplica al resultado devuelto slo si la fecha definida en el objeto Date est comprendida en el periodo en el que se aplica el horario de verano.
trace(new Date().getTimezoneOffset()); // // // // se visualiza 420 en la ventana Salida (7 horas * 60 minutos/hora = 420 minutos) Este ejemplo es el horario de verano del Pacfico (PDT, GMT-0700). El resultado variar segn el entorno regional y la fecha del ao.

Date.getUTCDate
Disponibilidad

Flash Player 5.
Sintaxis

myDate.getUTCDate()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve el da (fecha) del mes del objeto Date especificado segn la hora universal.

Date.getUTCDay
Disponibilidad

Flash Player 5.
Sintaxis

myDate.getUTCDate()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve el da de la semana del objeto Date especificado segn la hora universal.

126

Date.getUTCFullYear
Disponibilidad

Flash Player 5.
Sintaxis

myDate.getUTCFullYear()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve el ao en cuatro dgitos del objeto Date especificado segn la hora universal.

Date.getUTCHours
Disponibilidad

Flash Player 5.
Sintaxis

myDate.getUTCHours()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve las horas del objeto Date especificado segn la hora universal.

Date.getUTCMilliseconds
Disponibilidad

Flash Player 5.
Sintaxis

myDate.getUTCMilliseconds()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve los milisegundos del objeto Date especificado segn la hora universal.

Diccionario de ActionScript 127

Date.getUTCMinutes
Disponibilidad

Flash Player 5.
Sintaxis

myDate.getUTCMinutes()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve los minutos del objeto Date especificado segn la hora universal.

Date.getUTCMonth
Disponibilidad

Flash Player 5.
Sintaxis

myDate.getUTCMonth()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve el mes del objeto Date especificado segn la hora universal.

Date.getUTCSeconds
Disponibilidad

Flash Player 5.
Sintaxis

myDate.getUTCSeconds()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve los segundos del objeto Date especificado segn la hora universal.

128

Date.getYear
Disponibilidad

Flash Player 5.
Sintaxis

myDate.getYear()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve el ao del objeto Date especificado segn la hora local. La hora local la determina el sistema operativo en el que se est ejecutando Flash Player. El ao es el ao completo menos 1900. Por ejemplo, el ao 2000 se representa como 100.

Date.setDate
Disponibilidad

Flash Player 5.
Sintaxis

myDate.setDate(fecha)
Parmetros

fecha

Nmero entero de 1 a 31.

Valor devuelto

Un nmero entero.
Descripcin

Mtodo; establece el da del mes del objeto Date especificado, segn la hora local, y devuelve la nueva hora en milisegundos. La hora local la determina el sistema operativo en el que se est ejecutando Flash Player.

Date.setFullYear
Disponibilidad

Flash Player 5.
Sintaxis

myDate.setFullYear(ao [, mes [, fecha]] )

Parmetros

ao Nmero de cuatro dgitos que especifica un ao. Los nmeros de dos dgitos no representan aos; por ejemplo, 99 no es el ao 1999, sino el ao 99. mes fecha

Nmero entero de 0 (enero) a 11 (diciembre). Este parmetro es opcional. Nmero de 1 a 31. Este parmetro es opcional.

Diccionario de ActionScript 129

Valor devuelto

Un nmero entero.
Descripcin

Mtodo; establece el ao del objeto Date especificado, segn la hora local, y devuelve la nueva hora en milisegundos. Si se especifican los parmetros mes y fecha, tambin se establecen en la hora local. La hora local la determina el sistema operativo en el que se est ejecutando Flash Player. Llamar a este mtodo no modifica los otros campos del objeto Date especificado, pero los mtodos getUTCDay y getDay pueden dar un nuevo valor si el da de la semana cambia como resultado de la llamada a este mtodo.

Date.setHours
Disponibilidad

Flash Player 5.
Sintaxis

myDate.setHours(hora)
Parmetros

hora

Nmero entero de 0 (medianoche) a 23 (11 PM).

Valor devuelto

Un nmero entero.
Descripcin

Mtodo; establece las horas del objeto Date especificado segn la hora local y devuelve la nueva hora en milisegundos. La hora local la determina el sistema operativo en el que se est ejecutando Flash Player.

Date.setMilliseconds
Disponibilidad

Flash Player 5.
Sintaxis

myDate.setMilliseconds(milisegundo)
Parmetros

milisegundo
Valor devuelto

Nmero entero de 0 a 999.

Un nmero entero.
Descripcin

Mtodo; establece los milisegundos para el objeto Date especificado segn la hora local y devuelve la nueva hora en milisegundos. La hora local la determina el sistema operativo en el que se est ejecutando Flash Player.

130

Date.setMinutes
Disponibilidad

Flash Player 5.
Sintaxis

myDate.setMinutes(minuto)
Parmetros

minuto

Nmero entero de 0 a 59.

Valor devuelto

Un nmero entero.
Descripcin

Mtodo; establece los minutos de un objeto Date especificado segn la hora local y devuelve la nueva hora en milisegundos. La hora local la determina el sistema operativo en el que se est ejecutando Flash Player.

Date.setMonth
Disponibilidad

Flash Player 5.
Sintaxis

myDate.setMonth(mes [, fecha ])
Parmetros

mes fecha

Nmero entero de 0 (enero) a 11 (diciembre). Nmero entero de 1 a 31. Este parmetro es opcional.

Valor devuelto

Un nmero entero.
Descripcin

Mtodo; 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 est ejecutando Flash Player.

Date.setSeconds
Disponibilidad

Flash Player 5.
Sintaxis

myDate.setSeconds(segundo)
Parmetros

segundo

Nmero entero de 0 a 59.

Valor devuelto

Un nmero entero.

Diccionario de ActionScript

131

Descripcin

Mtodo; 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 est ejecutando Flash Player.

Date.setTime
Disponibilidad

Flash Player 5.
Sintaxis

myDate.setTime(milisegundo)
Parmetros

milisegundo
Valor devuelto

Valor entero donde 0 son las 0:00 GMT del 1 de enero de 1970.

Un nmero entero.
Descripcin

Mtodo; establece la fecha del objeto Date especificado en milisegundos desde la medianoche del 1 de enero de 1970 y devuelve la nueva hora en milisegundos.

Date.setUTCDate
Disponibilidad

Flash Player 5.
Sintaxis

myDate.setUTCDate(fecha)
Parmetros

fecha

Nmero entero de 1 a 31.

Valor devuelto

Un nmero entero.
Descripcin

Mtodo; establece la fecha del objeto Date especificado en la hora universal y devuelve la nueva hora en milisegundos. Llamar a este mtodo no modifica los otros campos del objeto Date especificado, pero los mtodos getUTCDay y getDay pueden dar un nuevo valor si el da de la semana cambia como resultado de llamar a este mtodo.

132

Date.setUTCFullYear
Disponibilidad

Flash Player 5.
Sintaxis

myDate.setUTCFullYear(ao [, mes [, fecha]])

Parmetros

ao mes fecha

Ao especificado en formato de cuatro dgitos, por ejemplo, 2000. Nmero entero de 0 (enero) a 11 (diciembre). Este parmetro es opcional. Nmero entero de 1 a 31. Este parmetro es opcional.

Valor devuelto

Un nmero entero.
Descripcin

Mtodo; establece el ao del objeto Date especificado (mydate) en la hora universal y devuelve la nueva hora en milisegundos. De modo opcional, este mtodo tambin puede establecer el mes y la fecha representados por el objeto Date especificado. No se modifican otros campos del objeto Date. Llamar a setUTCFullyear puede hacer que getUTCDay y getDay den como resultado un nuevo valor si el da de la semana cambia como resultado de esta operacin.

Date.setUTCHours
Disponibilidad

Flash Player 5.
Sintaxis

myDate.setUTCHours(hora [, minuto [, segundo [, milisegundo]]])

Parmetros

hora minuto

Nmero entero de 0 (medianoche) a 23 (11 PM). Nmero entero de 0 a 59. Este parmetro es opcional. Nmero entero de 0 a 59. Este parmetro es opcional. Nmero entero de 0 a 999. Este parmetro es opcional.

segundo

milisegundo
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; establece la hora del objeto Date especificado en la hora universal y devuelve la nueva hora en milisegundos.

Diccionario de ActionScript 133

Date.setUTCMilliseconds
Disponibilidad

Flash Player 5.
Sintaxis

myDate.setUTCMilliseconds(milisegundo)
Parmetros

milisegundo
Valor devuelto

Nmero entero de 0 a 999.

Un nmero entero.
Descripcin

Mtodo; establece los milisegundos del objeto Date especificado en la hora universal y devuelve la nueva hora en milisegundos.

Date.setUTCMinutes
Disponibilidad

Flash Player 5.
Sintaxis

myDate.setUTCMinutes(minuto [, segundo [, milisegundo]])

Parmetros

minuto segundo

Nmero entero de 0 a 59. Nmero entero de 0 a 59. Este parmetro es opcional. Nmero entero de 0 a 999. Este parmetro es opcional.

milisegundo
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; establece el minuto del objeto Date especificado en la hora universal y devuelve la nueva hora en milisegundos.

134

Date.setUTCMonth
Disponibilidad

Flash Player 5.
Sintaxis

myDate.setUTCMonth(mes [, fecha])
Parmetros

mes fecha

Nmero entero de 0 (enero) a 11 (diciembre). Nmero entero de 1 a 31. Este parmetro es opcional.

Valor devuelto

Un nmero entero.
Descripcin

Mtodo; establece el mes y, opcionalmente, el da (la fecha) del objeto Date especificado en la hora universal y devuelve la nueva hora en milisegundos. Llamar a este mtodo no modifica los otros campos del objeto Date especificado, pero los mtodos getUTCDay y getDay pueden dar un nuevo valor si el da de la semana cambia como resultado de llamar al parmetro fecha cuando se llama a setUTCMonth.

Date.setUTCSeconds
Disponibilidad

Flash Player 5.
Sintaxis

myDate.setUTCSeconds(segundo [, milisegundo]))
Parmetros

segundo

Nmero entero de 0 a 59. Nmero entero de 0 a 999. Este parmetro es opcional.

milisegundo
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; establece los segundos del objeto Date especificado en la hora universal y devuelve la nueva hora en milisegundos.

Diccionario de ActionScript 135

Date.setYear
Disponibilidad

Flash Player 5.
Sintaxis

myDate.setYear(ao)
Parmetros

ao Si ao es un nmero entero entre 0 y 99, setYear establece el ao en 1900 + ao; de lo contrario, el ao es el valor del parmetro ao.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; 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 est ejecutando Flash Player.

Date.toString
Disponibilidad

Flash Player 5.
Sintaxis

myDate.toString()
Parmetros

Ninguno.
Valor devuelto

Una cadena.
Descripcin

Mtodo; devuelve un valor de cadena del objeto Date especificado en un formato legible y devuelve la nueva hora en milisegundos.
Ejemplo

En el ejemplo siguiente se devuelve la informacin del objeto de fecha dateOfBirth como una cadena.
var dateOfBirth = new Date(74, 7, 7, 18, 15); trace (dateOfBirth.toString());

Salida (para la hora estndar del Pacfico):

Wed Aug 7 18:15:00 GMT-0700 1974

136

Date.UTC
Disponibilidad

Flash Player 5.
Sintaxis

Date.UTC(ao, mes [, fecha [, hora [, minuto [, segundo [, milisegundo ]]]]])

Parmetros

ao mes fecha hora

Nmero de cuatro dgitos, por ejemplo, 2000. Nmero entero de 0 (enero) a 11 (diciembre). Nmero entero de 1 a 31. Este parmetro es opcional. Nmero entero de 0 (medianoche) a 23 (11 PM). Nmero entero de 0 a 59. Este parmetro es opcional. Nmero entero de 0 a 59. Este parmetro es opcional. Nmero entero de 0 a 999. Este parmetro es opcional.

minuto segundo

milisegundo
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve el nmero de milisegundos desde la medianoche del 1 de enero de 1970, hora universal, y la hora especificada en los parmetros. Este es un mtodo esttico que se invoca por medio del constructor del objeto Date, no por medio de un objeto Date especfico. Este mtodo permite crear un objeto Date al que se asigna la hora universal, mientras que al constructor Date se asigna la hora local.
Ejemplo

En el ejemplo siguiente se crea un nuevo objeto Date gary_birthday definido con la hora universal. Esta es la variacin segn la hora universal del ejemplo utilizado para el mtodo constructor newDate.
gary_birthday = new Date(Date.UTC(1974, 7, 8));

default
Disponibilidad

Flash Player 6.
Sintaxis

default: sentencias
Parmetros

sentencias

Cualquier nmero de sentencias.

Valor devuelto

Ninguno.

Diccionario de ActionScript 137

Descripcin

Palabra clave; define el bloque case predeterminado para una accin switch. Las sentencias se ejecutan si el parmetro Expresin de la accin switch no equivale (utilizando la igualdad estricta) a ninguno de los parmetros Expresin que siguen a los bloques case de una accin switch determinada. No es necesario que la accin switch tenga un bloque default. No es necesario que el bloque default sea el ltimo de la lista. La utilizacin de una accin default fuera de una accin switch es un error que hace que el script no se compile.
Ejemplo

En el ejemplo siguiente, la expresin A no equivale a las expresiones B o D, por lo que se ejecuta la sentencia que sigue a la palabra clave default y la accin trace se enva a la ventana Salida.
switch ( A ) { case B: C; break; case D: E; break; default: trace (se ha detectado un caso no especfico); }
Vase tambin

switch, case, break

delete
Disponibilidad

Flash Player 5.
Sintaxis

delete referencia
Parmetros

referencia

Nombre de la variable u objeto que se va a eliminar.

Valor devuelto

Ninguno.
Descripcin

Operador; destruye el objeto o la variable especificada por el parmetro referencia y devuelve true si el objeto se ha eliminado correctamente; de lo contrario, devuelve el valor false. Este operador es til para liberar memoria utilizada por scripts. Aunque delete es un operador, normalmente se utiliza como sentencia, como en el ejemplo siguiente:
delete x;

El operador delete puede fallar y devolver false si la referencia no existe o no puede eliminarse. Los objetos y propiedades predefinidos y las variables declaradas con var no pueden eliminarse. No puede utilizar el operador delete para eliminar clips de pelcula.

138

Ejemplo

En el ejemplo siguiente se crea un objeto, se lo utiliza y despus se elimina cuando ya no es necesario.

account = new Object(); account.name = 'Juan'; account.balance = 10000; delete account;
Ejemplo

El ejemplo siguiente elimina una propiedad de un objeto.

// crear el nuevo objeto "account" account = new Object(); // asignar un nombre de propiedad a la cuenta account.name = 'Juan'; // eliminar la propiedad delete account.name;
Ejemplo

El ejemplo siguiente es otro ejemplo de la eliminacin de una propiedad de un objeto.

// crear una matriz de longitud 0 array = new Array(); // Array.length es 1 ahora array[0] = "abc"; // agregar otro elemento a la matriz,Array.length es 2 ahora array[1] = "def"; // agregar otro elemento a la matriz,Array.length es 3 ahora array[2] = "ghi"; // se elimina array[2] pero Array.length no cambia, delete array[2];

En el ejemplo siguiente se muestra el comportamiento de delete en referencias de objeto.

// crear un nuevo objeto y asignar la variable ref1 // para hacer referencia al objeto ref1 = new Object(); ref1.name = "Jordi"; // copiar la variable de referencia a la nueva variable // y eliminar ref1 ref2 = ref1; delete ref1;

Si ref1 no se hubiera copiado en ref2, el objeto se habra eliminado al eliminar ref1, porque no habra referencias a l. Si elimina ref2, ya no habr referencias al objeto; se destruir y la memoria que utilizaba pasar a estar disponible.
Vase tambin

var

Diccionario de ActionScript 139

do while
Disponibilidad

Flash Player 4.
Sintaxis

do { sentencia(s) } while (condicin)

Parmetros

condicin

Condicin que se comprueba. Sentencia(s) que debe(n) ejecutarse mientras el parmetro condicin tenga el

sentencia(s) valor true.

Valor devuelto

Ninguno.
Descripcin

Accin; ejecuta las sentencias y despus comprueba la condicin de un bucle mientras la condicin sea true.
Vase tambin

break, continue

duplicateMovieClip
Disponibilidad

Flash Player 4.
Sintaxis

duplicateMovieClip(destino, nombrenuevo, profundidad)

Parmetros

destino

Ruta de destino del clip de pelcula que debe duplicarse. Identificador exclusivo para el clip de pelcula duplicado.

nombrenuevo

profundidad Nivel de profundidad exclusivo del clip de pelcula duplicado. El nivel de profundidad es un orden de apilamiento de los clips de pelcula duplicados. Este orden de apilamiento se parece mucho al orden de apilamiento de las capas en la lnea de tiempo; los clips de pelcula con un nivel de profundidad menor permanecen ocultos debajo de los clips con un orden de apilamiento mayor. Debe asignar a cada clip de pelcula duplicado un nivel de profundidad exclusivo para evitar que reemplace pelculas existentes en las profundidades ocupadas.
Valor devuelto

Ninguno.

140

Descripcin

Accin; crea una instancia de un clip de pelcula mientras se reproduce la pelcula. La cabeza lectora de los clips de pelcula duplicados siempre empieza en el fotograma 1, sin tener en cuenta la posicin de la cabeza lectora en el clip de pelcula original (o principal). Las variables del clip de pelcula principal no se copian en el clip de pelcula duplicado. Si se elimina el clip de pelcula principal tambin se elimina el clip de pelcula duplicado. Utilice la accin o el mtodo removeMovieClip para eliminar una instancia de clip de pelcula creada con duplicateMovieClip.
Ejemplo

Esta sentencia copia la instancia de clip de pelcula flower diez veces. La variable i sirve para crear un nuevo nombre de instancia y una profundidad exclusiva para cada clip de pelcula duplicado.
on (release) { amount = 10; while (amount>0) { duplicateMovieClip (_root.flower, "mc"+i, i); setProperty ("mc"+i, _x, random(275)); setProperty ("mc"+i, _y, random(275)); setProperty ("mc"+i, _alpha, random(275)); setProperty ("mc"+i, _xscale, random(50)); setProperty ("mc"+i, _yscale, random(50)); i++; amount--; } }
Vase tambin

MovieClip.duplicateMovieClip, removeMovieClip, MovieClip.removeMovieClip

else
Disponibilidad

Flash Player 4.
Sintaxis

else sentencia else {...sentencia(s)...}

Parmetros

condicin

Una expresin que da como resultado true o false.

sentencia(s) Serie alternativa de sentencias que debe ejecutarse si la condicin especificada en la sentencia if es false.
Valor devuelto

Ninguno.
Descripcin

Accin; especifica las sentencias que deben ejecutarse si la condicin de la sentencia if devuelve el valor false.
Vase tambin

if

Diccionario de ActionScript

141

else if
Disponibilidad

Flash Player 4.
Sintaxis

if (condicin){ sentencia(s); } else if (condicin){ sentencia(s); }

Parmetros

condicin

Una expresin que da como resultado true o false.

sentencia(s) Serie alternativa de sentencias que debe ejecutarse si la condicin especificada en la sentencia if es false.
Valor devuelto

Ninguno.
Descripcin

Accin; calcula el valor de una condicin y especifica las sentencias que deben ejecutarse si la condicin de la sentencia if inicial es false. Si la condicin else if es true, el intrprete de Flash ejecuta las sentencias que van despus de la condicin entre llaves ({}). Si la condicin else if es false, Flash pasa por alto las sentencias entre llaves y ejecuta las sentencias que van despus de las llaves. Utilice la accin else if para definir lgica de ramificacin en los scripts.
Ejemplo

En el ejemplo siguiente se utilizan acciones else if para comprobar si los lados de un objeto se encuentran dentro de un lmite especfico:
// si el objeto sobrepasa los lmites, // devolverlo e invertir su velocidad de desplazamiento if (this._x>rightBound) { this._x = rightBound; xInc = -xInc; } else if (this._x<leftBound) { this._x = leftBound; xInc = -xInc; } else if (this._y>bottomBound) { this._y = bottomBound; yInc = -yInc; } else if (this._y<topBound) { this._y = topBound; yInc = -yInc; }
Vase tambin

if

142

#endinitclip
Disponibilidad

Flash Player 6.
Sintaxis

#endinitclip
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Accin; indica el final de un bloque de acciones de inicializacin de componente.

Ejemplo

#initclip ... aqu se especifican las acciones de inicializacin del componente... #endinitclip
Vase tambin

#initclip

eq (igual, especfico de cadena)

Disponibilidad

Flash Player 4. Esta funcin se ha desestimado en Flash 5; se recomienda utilizar el operador ==

(igualdad).
Sintaxis

expresin1 eq expresin2
Parmetros

expresin1,expresin2
Valor devuelto

Nmeros, cadenas o variables.

Ninguno.
Descripcin

Operador de comparacin; compara si dos expresiones son iguales y devuelve el valor true si la representacin de la cadena expresin1 es igual a la representacin de la cadena expresin2; de lo contrario, la operacin devuelve el valor false.
Vase tambin

== (igualdad)

Diccionario de ActionScript 143

escape
Disponibilidad

Flash Player 5.
Sintaxis

escape(expresin)
Parmetros

expresin

Expresin que se va a convertir en una cadena y que se va a codificar con un formato URL.

Valor devuelto

Ninguno.
Descripcin

Funcin; convierte el parmetro en una cadena y lo codifica en formato URL, en el que todos los caracteres no alfanumricos se convierten en secuencias hexadecimales % de escape.
Ejemplo

La ejecucin del cdigo siguiente da como resultado Hola%7B%5BMundo%5D%7D.

escape("Hola{[Mundo]}");
Vase tambin

unescape

eval
Disponibilidad

Flash Player 5 o posterior para obtener la funcionalidad completa. Puede utilizar la funcin eval cuando realice una exportacin a Flash Player 4, pero debe utilizar la notacin usando barras inclinadas y slo puede acceder a variables y no a propiedades ni objetos.
Sintaxis

eval(expresin);
Parmetros

expresin

Cadena que contiene el nombre de una variable, propiedad, objeto o clip de pelcula que debe recuperarse.

Valor devuelto

Ninguno.
Descripcin

Funcin; accede a variables, propiedades, objetos o clips de pelcula por nombre. Si la expresin es una variable o una propiedad, el valor de la variable o de la propiedad no se devuelve. Si la expresin es un objeto o un clip de pelcula, se devuelve una referencia al objeto o al clip de pelcula. Si el elemento denominado en la expresin no puede encontrarse, se devuelve undefined. En Flash 4, la funcin eval se utilizaba para simular una matriz; en Flash 5 se recomienda utilizar el objeto Array para simular matrices.

144

Tambin puede utilizar la funcin eval para establecer y recuperar dinmicamente el valor de una variable o de un nombre de instancia. Sin embargo, tambin puede llevar esto a cabo con el operador de acceso de matriz ([]).
Nota: la accin eval de ActionScript no es la misma que la funcin eval de JavaScript y no puede utilizarse para evaluar sentencias.

Ejemplo

"piece" + x.

En el ejemplo siguiente se utiliza la funcin eval para determinar el valor de la expresin Puesto que el resultado es un nombre de variable, piece3, la funcin eval devuelve el valor de la variable y lo asigna a y:
piece3 = "peligroso"; x = 3; y = eval("piece" + x); trace(y); // Salida: peligroso
Vase tambin

Array (objeto)

evaluate
Disponibilidad

Flash Player 5.
Sintaxis

sentencia
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Accin; crea una nueva lnea vaca e inserta un punto y coma (;) para escribir sentencias que deben evaluarse en el panel Acciones.

false
Disponibilidad

Flash Player 5.
Sintaxis

true
Descripcin

Valor booleano exclusivo que representa lo contrario de true.

Vase tambin

true

Diccionario de ActionScript 145

FCheckBox (componente)
El componente CheckBox del entorno de edicin de Flash proporciona funciones de arrastrar y soltar para agregar casillas de verificacin a los documentos de Flash, adems de proporcionar una interfaz grfica de usuario para definir parmetros bsicos. Los mtodos del componente FCheckBox permiten controlar casillas de verificacin en tiempo de ejecucin: puede crear casillas de verificacin, controlar casillas de verificacin creadas en el entorno de edicin, definir o sustituir parmetros bsicos y establecer opciones adicionales de tiempo de ejecucin. No es necesario que utilice un constructor para acceder a los mtodos de los componentes. El componente CheckBox se admite en Flash Player 6. Los mtodos del componente no realizan comprobaciones de errores de tipo, como ocurre en otros objetos y acciones nativos de ActionScript, por lo que se recomienda validar los parmetros antes de pasarlos a los mtodos. Para obtener ms informacin sobre la utilizacin del componente CheckBox, la definicin de parmetros durante la edicin y la modificacin del color y del aspecto de los componentes, consulte los apartados Personalizacin de los colores y el texto de los componentes y Personalizacin de aspectos de componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash. Resumen de mtodos del componente FCheckBox
Mtodo FCheckBox.getEnabled FCheckBox.getLabel FCheckBox.getValue FCheckBox.registerSkinElement FCheckBox.setChangeHandler FCheckBox.setEnabled FCheckBox.setLabel FCheckBox.setLabelPlacement FCheckBox.setSize FCheckBox.setStyleProperty FCheckBox.setValue Descripcin Devuelve true si la casilla de verificacin est activada y false si est desactivada. Devuelve la etiqueta aplicada a la casilla de verificacin como una cadena. Devuelve true si la casilla de verificacin est seleccionada y false si no lo est. Registra un elemento de aspecto en una propiedad. Especifica un controlador de cambios que debe activarse cuando cambie el valor de la casilla de verificacin. Determina si la casilla de verificacin est activada o desactivada. Especifica texto para la etiqueta de la casilla de verificacin. Especifica si la etiqueta aparece a la izquierda o a la derecha de la casilla de verificacin. Establece la anchura de la casilla de verificacin, en pxeles y vuelve a dibujarla. Establece una sola propiedad de estilo para un componente. Selecciona o deselecciona la casilla de verificacin y activa la funcin de control de cambios.

146

FCheckBox.getEnabled
Disponibilidad

Flash Player 6.
Sintaxis

myCheckBox.getEnabled()
Parmetros

Ninguno.
Valor devuelto

Un valor booleano que indica si la instancia de la casilla de verificacin est activada (true) o desactivada (false).
Descripcin

Mtodo; indica si la instancia de la casilla de verificacin est activada o desactivada.

Ejemplo

El cdigo siguiente devuelve el estado de activacin de checkBox1 en la ventana Salida.

trace(checkBox1.getEnabled());
Vase tambin

FCheckBox.setValue

FCheckBox.getLabel
Disponibilidad

Flash Player 6.
Sintaxis

myCheckBox.getLabel()
Parmetros

Ninguno.
Valor devuelto

Una cadena de texto.

Descripcin

Mtodo; recupera la etiqueta de la casilla.

Ejemplo

El cdigo siguiente devuelve la etiqueta de checkBox1.

checkBox1.getLabel();
Vase tambin

FCheckBox.setLabel

Diccionario de ActionScript 147

FCheckBox.getValue
Disponibilidad

Flash Player 6.
Sintaxis

myCheckBox.getValue()
Parmetros

Ninguno.
Valor devuelto

Un valor booleano que indica si la casilla de verificacin est seleccionada (true) o no (false).
Descripcin

Mtodo; indica si la casilla de verificacin est seleccionada.

Ejemplo

El cdigo siguiente devuelve el valor seleccionado de KowalczykBox en la ventana Salida.

trace(KowalczykBox.getValue());
Vase tambin

FCheckBox.setValue

FCheckBox.registerSkinElement
Disponibilidad

Flash Player 6.
Sintaxis

myCheckBox.registerSkinElement(elemento, propiedadEstilo)
Parmetros

elemento

Instancia de clip de pelcula. Nombre de una propiedad de FStyleFormat.

propiedadEstilo
Valor devuelto

Ninguno.
Descripcin

Mtodo; registra un elemento de aspecto en una propiedad de estilo. Los elementos de aspecto se registran en las propiedades del primer fotograma de la capa Read Me (Lame) de cada aspecto de la biblioteca. Los componentes estn formados de aspectos, que a su vez se componen de varios elementos de aspecto, cada uno de los cuales puede registrarse en una propiedad del objeto FStyleFormat. El formato de estilo asignado a un componente asigna valores a estas propiedades. De forma predeterminada se asigna el objeto globalStyleFormat a todos los componentes de la interfaz de usuario de Flash, que es una instancia del objeto FStyleFormat. Utilice este mtodo para registrar propiedades y elementos de aspecto personalizados en aspectos de componentes de la interfaz de usuario de Flash o personalizados editando el cdigo del primer fotograma de la capa Read Me (Lame) de un aspecto de la biblioteca.

148

El componente FCheckbox utiliza los aspectos de la carpeta FCheckBox Skins una vez que ha agregado el componente al documento de Flash. Para obtener ms informacin, consulte el apartado Personalizacin de aspectos de componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

El cdigo siguiente registra el elemento de aspecto personalizado customChk_mc en la propiedad check del primer fotograma de la capa Read Me (Lame) del aspecto fcb_check en la carpeta FCheckBox Skins de la biblioteca.
check1.registerSkinElement(customChk_mc, "check");

FCheckBox.setChangeHandler
Disponibilidad

Flash Player 6.
Sintaxis

myCheckBox.setChangeHandler(nombreFuncin, [ubicacin])
Parmetros

nombreFuncin Cadena que especifica el nombre de la funcin del controlador que debe ejecutarse cuando cambie el valor de la casilla de verificacin. Si no se especifica el parmetro ubicacin, esta funcin debe encontrarse en la misma lnea de tiempo que la instancia del componente. ubicacin Referencia de ruta a un objeto de datos, clip de pelcula o lnea de tiempo que contiene la funcin especificada. Este parmetro es opcional y tiene como valor predeterminado la lnea de tiempo principal del componente.
Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica un controlador de cambios que debe activarse cuando cambie el valor de la casilla de verificacin. Puede especificar la misma funcin del controlador de cambios para ms de un componente; la funcin siempre acepta la instancia del componente que ha cambiado como parmetro. Si se llama a este mtodo, ste prevalece sobre el valor del parmetro de controlador de cambios especificado en la edicin. Para obtener ms informacin, consulte el apartado Programacin de funciones del controlador de cambios para componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

El cdigo siguiente especifica myHandler como la funcin a la que se debe llamar cuando cambia el valor de checkBox1. Puesto que no se especifica el parmetro ubicacin, myHandler debe encontrarse en la misma lnea de tiempo que la instancia del componente.

Diccionario de ActionScript 149

El parmetro component de myHandler se rellena automticamente con la instancia de un componente (el componente que ha cambiado como resultado de las especificaciones del usuario y cuyo controlador de cambios es myHandler). Las acciones definidas en myHandler especifican que cuando el usuario seleccione una casilla de verificacin, el nombre del componente y el texto ha sido seleccionado aparecern en la ventana Salida.
checkBox1.setChangeHandler("myHandler"); function myHandler(component){ trace(component._name + " ha sido seleccionado "); }

Si en el ejemplo anterior myHandler es una funcin ubicada en una lnea de tiempo tres niveles por encima de la lnea de tiempo del componente, la primera lnea del cdigo sera similar a la siguiente:
check1.setChangeHandler("myHandler", _parent._parent._parent);

En el cdigo siguiente se crea la funcin myHandler en una instancia de myObject (que es de la clase Object) y, a continuacin, se especifica myHandler como la funcin de check1.
myObject = new Object(); myObject.myHandler = function(component){ trace(component._name + " ha sido seleccionado "); } check1.setChangeHandler("myHandler", myObject);

FCheckBox.setEnabled
Disponibilidad

Flash Player 6.
Sintaxis

myCheckBox.setEnabled(activacin)
Parmetros

activacin Valor booleano que especifica si la casilla de verificacin est activada (true) o desactivada (false).
Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica si la casilla de verificacin est activada (true) o desactivada (false). Si una casilla de verificacin est desactivada, no aceptar la interaccin del usuario mediante el teclado o el ratn. Si omite este parmetro, el mtodo toma como valor predeterminado true.
Ejemplo

En el cdigo siguiente se desactiva checkBox1.

checkBox1.setEnabled(false);

150

FCheckBox.setLabel
Disponibilidad

Flash Player 6.
Sintaxis

myCheckBox.setLabel(etiqueta)
Parmetros

etiqueta

Cadena que especifica la etiqueta de texto de la casilla de verificacin.

Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica la etiqueta de texto de la casilla de verificacin. De forma predeterminada, la etiqueta aparece a la derecha de la casilla de verificacin. Si se llama a este mtodo, se sustituye el parmetro etiqueta especificado durante la edicin.
Ejemplo

En el cdigo siguiente se aplica la etiqueta Enven ms informacin a checkBox1.

checkBox1.setLabel("Enven ms informacin");
Vase tambin

FCheckBox.getLabel, FCheckBox.setLabelPlacement

FCheckBox.setLabelPlacement
Disponibilidad

Flash Player 6.
Sintaxis

myCheckBox.setLabelPlacement(posicinEtiqueta)
Parmetros

posicinEtiqueta
Valor devuelto

Cadena de texto; especifique "left" o "right".

Ninguno.
Descripcin

Mtodo; especifica si la etiqueta aparece a la izquierda o a la derecha de la casilla de verificacin. Si se llama a este mtodo, se sustituye el valor del parmetro de posicin de etiqueta establecido durante la edicin.
Ejemplo

En el cdigo siguiente se coloca la etiqueta de checkBox1 a la izquierda de la casilla de verificacin.

checkBox1.setLabelPlacement("left");
Vase tambin

FCheckBox.setLabel

Diccionario de ActionScript

151

FCheckBox.setSize
Disponibilidad

Flash Player 6.
Sintaxis

myCheckBox.setSize(anchura)
Parmetros

anchura

Entero que especifica la anchura de la casilla de verificacin, en pxeles.

Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica la anchura de la casilla de verificacin y vuelve a dibujarla. No puede establecer la altura de los componentes de la casilla de verificacin. Si se llama a este mtodo, se sustituye la escala de anchura aplicada durante la edicin. Para obtener ms informacin, consulte el apartado Tamao de los componentes CheckBox en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

En el cdigo siguiente se establece la anchura de checkBox1 en 200 pxeles.

checkBox1.setSize(200);

FCheckBox.setStyleProperty
Disponibilidad

Flash Player 6.
Sintaxis

myCheckBox.setStyleProperty(propiedadEstilo, valor)
Parmetros

propiedadEstilo valor

Cadena que especifica una propiedad del objeto FStyleFormat.

Valor que se establece para la propiedad.

Valor devuelto

Ninguno.
Descripcin

Mtodo; establece una propiedad FStyleFormat para una instancia de casilla de verificacin. Si se llama a este mtodo para especificar una propiedad, se sustituye el valor de esta propiedad en el formato de estilo asignado al componente. Si se pasa undefined como valor de una propiedad, se eliminan todos los estilos de la misma. Para establecer FStyleFormat para varios componentes, cree un formato de estilo personalizado. Para obtener ms informacin sobre la creacin de formatos de estilo personalizados, consulte el apartado Personalizacin de los colores y el texto de los componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.

152

Ejemplo

En el cdigo siguiente se establece la propiedad shadow de checkBox1 en 0x000000 (negro).

checkBox1.setStyleProperty("shadow", 0x000000);
Vase tambin

FStyleFormat (objeto)

FCheckBox.setValue
Disponibilidad

Flash Player 6.
Sintaxis

myCheckBox.setValue(seleccin)
Parmetros

seleccin no (false).

Valor booleano que especifica si la casilla de verificacin est seleccionada (true) o

Valor devuelto

Ninguno.
Descripcin

Mtodo; selecciona o deselecciona myCheckBox y desencadena la funcin del controlador de cambios especificada (si la hay) en tiempo de ejecucin. El valor predeterminado es true. Aunque si se llama a este mtodo se sustituye el valor del parmetro de valor inicial especificado durante la edicin, no utilice este mtodo para este fin, puesto que tambin desencadena la funcin del controlador de cambios asociada. Para establecer el parmetro de valor inicial de una casilla de verificacin en tiempo de ejecucin, utilice FCheckBox.setStyleProperty.
Ejemplo

En el cdigo siguiente se selecciona la instancia de checkBox1 y se desencadena la funcin especificada del controlador de cambios.
checkBox1.setValue(true);
Vase tambin

FCheckBox.getValue

Diccionario de ActionScript 153

FComboBox (componente)
El componente ComboBox del entorno de edicin de Flash proporciona funciones de arrastrar y soltar para agregar listas desplegables de seleccin nica a los documentos de Flash, adems de proporcionar una interfaz grfica de usuario para definir parmetros bsicos. Los mtodos del componente FComboBox permiten controlar cuadros combinados en tiempo de ejecucin: puede crear cuadros combinados, controlar cuadros combinados creados durante la edicin, definir o sustituir parmetros bsicos y establecer opciones adicionales de tiempo de ejecucin. No es necesario que utilice un constructor para acceder a los mtodos de los componentes. El componente ComboBox crea cuadros combinados estticos y editables. Un cuadro combinado esttico es una lista desplegable cuyo contenido se puede desplazar y que permite a los usuarios seleccionar elementos. Un cuadro combinado editable es una lista desplegable cuyo contenido se puede desplazar y que cuenta con un campo de texto en la parte superior. Puede permitir a los usuarios especificar texto en el campo de texto para que el cuadro combinado se desplace al elemento deseado, o bien puede utilizar el campo de texto para establecer el texto visualizado en tiempo de ejecucin. Las versiones esttica y editable del componente ComboBox enumeran elementos de arriba a abajo mediante un sistema de ndice basado en cero. Si el nmero de elementos de la lista del cuadro combinado crea una lista desplegable que supera el espacio disponible debajo del componente, la lista se abre hacia arriba en lugar de hacia abajo. Los mtodos del componente no realizan comprobaciones de errores de tipo, como ocurre en otros objetos y acciones nativos de ActionScript, por lo que se recomienda validar los parmetros antes de pasarlos a los mtodos. El componente ComboBox se admite en Flash Player 6 y en versiones posteriores de Flash Player. Para obtener ms informacin sobre la utilizacin del componente ComboBox, la definicin de parmetros durante la edicin y la modificacin del color y el aspecto de los componentes, consulte los apartados Personalizacin de los colores y el texto de los componentes y Personalizacin de aspectos de componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash. Resumen de mtodos del componente FComboBox
Mtodo FComboBox.addItem FComboBox.addItemAt FComboBox.getEnabled FComboBox.getItemAt FComboBox.getLength FComboBox.getRowCount FComboBox.getScrollPosition FComboBox.getSelectedIndex Descripcin Agrega un nuevo elemento al final de la lista del cuadro combinado. Agrega un nuevo elemento a la lista del cuadro combinado en el ndice especificado. Devuelve true si el cuadro combinado est activado, y false si est desactivado. Devuelve el elemento con el ndice especificado como un objeto con las propiedades label y data. Devuelve el nmero de elementos enumerados del cuadro combinado. Devuelve el nmero de filas visibles en el cuadro combinado. Devuelve el ndice del elemento en la primera posicin del cuadro combinado. Devuelve el ndice del elemento seleccionado.

154

Mtodo FComboBox.getSelectedItem FComboBox.getValue

Descripcin Devuelve el elemento seleccionado como un objeto con las propiedades label y data. Devuelve el texto del campo de entrada para cuadros combinados editables; devuelve la etiqueta o los datos del elemento seleccionado para cuadros combinados estticos. Registra un elemento de aspecto en una propiedad. Elimina todos los elementos del cuadro combinado. Elimina el elemento en el ndice especificado. Reemplaza la etiqueta y los datos de un elemento en el ndice especificado. Asigna una funcin para llamarla cada vez que se selecciona un elemento o que un usuario especifica texto en el campo de texto. Registra un objeto externo en el componente como origen de datos. Determina si el cuadro combinado es editable (true) o esttico (false). Especifica si el cuadro combinado est activado (true) o desactivado (false). Registra un identificador de vnculo de smbolo para utilizarlo al visualizar elementos del cuadro combinado. Determina el nmero de elementos que se visualizan en el cuadro combinado sin barra de desplazamiento. Selecciona el elemento en el ndice especificado. Establece la anchura en pxeles del cuadro combinado. Establece una sola propiedad de estilo para una instancia de un componente. Especifica el texto que se visualiza en el campo de texto de la parte superior de un cuadro combinado editable. Clasifica los elementos del cuadro de lista en orden alfabtico o numrico por etiqueta o por datos.

FComboBox.registerSkinElement FComboBox.removeAll FComboBox.removeItemAt FComboBox.replaceItemAt FComboBox.setChangeHandler FComboBox.setDataProvider FComboBox.setEditable FComboBox.setEnabled FComboBox.setItemSymbol FComboBox.setRowCount FComboBox.setSelectedIndex FComboBox.setSize FComboBox.setStyleProperty FComboBox.setValue FComboBox.sortItemsBy

Diccionario de ActionScript 155

FComboBox.addItem
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.addItem(etiqueta [,datos])
Parmetros

etiqueta datos

Cadena de texto que debe visualizarse en la lista del cuadro combinado.

Valor que debe asociarse al elemento de lista. Este parmetro es opcional.

Valor devuelto

Ninguno.
Descripcin

Mtodo; agrega un nuevo elemento con la etiqueta y los datos especificados al final de la lista del cuadro combinado y actualiza la lista. Los datos pueden ser cualquier objeto, cadena, valor booleano, entero o clip de pelcula de Flash. Para obtener un rendimiento y un tiempo de carga ptimos, no agregue ms de 400 elementos en un solo fotograma. Esto se aplica si agrega los elementos tanto en una como en varias listas de cuadro combinado.
Ejemplo

En el cdigo siguiente se agrega el elemento Kenny con un valor asociado Keen al final de la lista en el cuadro combinado teacherList.
teacherList.addItem("Kenny", Keen);

En el cdigo siguiente se agrega el nmero mximo de elementos recomendados en un solo fotograma (400 elementos) en comboBox1:
for (i=0; i<400; i++) { comboBox1.addItem(i); }

En el cdigo siguiente se agrega el nmero mximo de elementos recomendados en un solo fotograma (400 elementos) en listBox1 y comboBox2:
for (i=0; i<200; i++) { listBox1.addItem(i); comboBox2.addItem(i); }
Vase tambin

FComboBox.addItemAt, FComboBox.getItemAt, FComboBox.replaceItemAt, FComboBox.setDataProvider, FComboBox.sortItemsBy

156

FComboBox.addItemAt
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.addItemAt(ndice, etiqueta [,datos])

Parmetros

ndice

Entero que especifica la posicin en la que debe insertarse el elemento. Cadena que identifica el elemento de la lista en el cuadro combinado. Valor que debe asociarse al elemento de lista. Este parmetro es opcional.

etiqueta datos

Valor devuelto

Ninguno.
Descripcin

Mtodo; agrega un nuevo elemento con la etiqueta especificada y los datos opcionales asociados en la lista del cuadro combinado en la posicin de ndice especificada. El parmetro de datos puede ser cualquier objeto, cadena, valor booleano, entero o clip de pelcula de Flash. A medida que se agrega cada elemento, se actualiza la lista y cambia el tamao de la barra de desplazamiento. El componente ComboBox utiliza un ndice basado en cero, en el que el elemento en el ndice 0 se muestra en la primera posicin de la lista. Para obtener un rendimiento y un tiempo de carga ptimos, no agregue ms de 400 elementos en un solo fotograma. Esto se aplica si agrega los elementos tanto en una como en varias listas de cuadro combinado.
Ejemplo

En el cdigo siguiente se agrega el elemento Justin con el valor asociado Ace como quinto elemento de la lista del cuadro combinado Favorites.
Favorites.addItemAt(4, "Justin", Ace);

Para obtener ejemplos de cmo cargar grandes cantidades de elementos, consulte FComboBox.addItem.
Vase tambin

FComboBox.getItemAt, FComboBox.removeItemAt, FComboBox.replaceItemAt, FComboBox.setDataProvider, FComboBox.sortItemsBy

Diccionario de ActionScript 157

FComboBox.getEnabled
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.getEnabled()
Parmetros

Ninguno.
Valor devuelto

Valor booleano que indica si el cuadro combinado est activado (true) o desactivado (false).
Descripcin

Mtodo; indica si el cuadro combinado est activado.

Ejemplo

El cdigo siguiente utiliza getEnabled para determinar si comboBox1 est activado o desactivado y muestra el resultado en la ventana Salida.
trace(comboBox1.getEnabled());
Vase tambin

FComboBox.setEnabled

FComboBox.getItemAt
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.getItemAt(ndice)
Parmetros

ndice

Entero que especifica la posicin de un elemento en el cuadro combinado.

Valor devuelto

Un objeto.
Descripcin

Mtodo; devuelve el elemento en el ndice especificado como un objeto con las propiedades label y data. El componente ComboBox utiliza un ndice basado en cero, en el que el elemento en el ndice 0 se muestra en la primera posicin de la lista.
Ejemplo

En el cdigo siguiente se devuelve la etiqueta del elemento con el ndice 4 en comboBox1 como una cadena.
trace(comboBox1.getItemAt(4).label);

158

En el cdigo siguiente se devuelven los datos asociados al elemento en el ndice 4 de comboBox2. El valor devuelto depende del tipo de datos y puede ser un objeto, una cadena, una referencia de clip de pelcula u otro valor.
trace(comboBox2.getItemAt(4).data);

En el cdigo siguiente se devuelve un objeto que contiene la etiqueta y los datos asociados al elemento en el ndice 4 de comboBox3.
trace(comboBox3.getItemAt(4));
Vase tambin

FComboBox.getSelectedItem

FComboBox.getLength
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.getLength()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve el nmero de elementos en la lista del cuadro combinado.

Ejemplo

En el cdigo siguiente se recupera el nmero de elementos de la lista listMain y se lo almacena en la variable len.
var len = listMain.getLength();
Vase tambin

FComboBox.addItem, FComboBox.addItemAt

FComboBox.getRowCount
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.getRowCount()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve el nmero de filas visibles en el cuadro combinado.

Diccionario de ActionScript 159

Ejemplo

En el cdigo siguiente se devuelve el nmero de filas visible en toyList y se establece el valor en la variable rowCount.
var rowCount = toyList.getRowCount();
Vase tambin

FComboBox.setRowCount

FComboBox.getScrollPosition
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.getScrollPosition()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve la posicin de ndice del elemento que se visualiza actualmente en la primera posicin de la lista del cuadro combinado. El componente ComboBox utiliza un ndice basado en cero, en el que el elemento en el ndice 0 se muestra en la primera posicin de la lista.
Ejemplo

En el cdigo siguiente se recupera el ndice del elemento que se encuentra actualmente en la primera posicin de la lista en toyList y se lo almacena en la variable scrollPos.
var scrollPos = toyList.getScrollPosition();
Vase tambin

FComboBox.setSelectedIndex

FComboBox.getSelectedIndex
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.getSelectedIndex()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero o undefined.

160

Descripcin

Mtodo; devuelve el ndice del elemento seleccionado actualmente en el cuadro combinado o devuelve undefined si no se ha seleccionado ningn elemento. Los elementos se muestran en el cuadro combinado de arriba a abajo mediante un ndice basado en cero.
Ejemplo

En el cdigo siguiente se recupera el ndice del elemento seleccionado actualmente en toyList y se lo almacena en la variable selIndex.
var selIndex = toyList.getSelectedIndex();
Vase tambin

FComboBox.setSelectedIndex

FComboBox.getSelectedItem
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.getSelectedItem()
Parmetros

Ninguno.
Valor devuelto

Un objeto o undefined.
Descripcin

Mtodo; devuelve el elemento seleccionado actualmente como objeto con las propiedades label y data o devuelve undefined si no se ha seleccionado ningn elemento.
Ejemplo

En el cdigo siguiente se recuperan la etiqueta y los datos del elemento seleccionado en comboBox1.
trace(comboBox1.getSelectedItem());

En el cdigo siguiente se recupera la etiqueta del elemento seleccionado en comboBox2.

trace(comboBox2.getSelectedItem().label);

En el cdigo siguiente se recuperan los datos del elemento seleccionado en comboBox3.

trace(comboBox3.getSelectedItem().data);
Vase tambin

FComboBox.setSelectedIndex

Diccionario de ActionScript

161

FComboBox.getValue
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.getValue()
Parmetros

Ninguno.
Valor devuelto

Una cadena de texto.

Descripcin

Mtodo; devuelve el texto del campo en la parte superior del cuadro combinado, si el cuadro combinado es editable. Si el cuadro combinado es esttico (no editable), este mtodo devuelve los datos asociados al elemento seleccionado o la etiqueta del elemento si no hay datos asociados.
Ejemplo

En el cdigo siguiente se devuelven los datos o la etiqueta del elemento seleccionado en menuMain.
trace(menuMain.getValue())
Vase tambin

FComboBox.setValue

FComboBox.registerSkinElement
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.registerSkinElement(elemento, propiedadEstilo)
Parmetros

elemento

Instancia de clip de pelcula. Nombre de una propiedad de FStyleFormat.

propiedadEstilo
Valor devuelto

Ninguno.
Descripcin

Mtodo; registra un elemento de aspecto en una propiedad de estilo. Los elementos de aspecto se registran en las propiedades del primer fotograma de la capa Read Me (Lame) de cada aspecto de la biblioteca. Los componentes estn formados de aspectos, que a su vez se componen de varios elementos de aspecto, cada uno de los cuales puede registrarse en una propiedad del objeto FStyleFormat. El formato de estilo asignado a un componente asigna valores a estas propiedades. De forma predeterminada se asigna el objeto globalStyleFormat, a todos los componentes de la interfaz de usuario de Flash, que es una instancia del objeto FStyleFormat.

162

Utilice este mtodo para registrar propiedades y elementos de aspecto personalizados en aspectos de componentes de la interfaz de usuario de Flash o personalizados editando el cdigo del primer fotograma de la capa Read Me (Lame) de un aspecto de la biblioteca. El componente FComboBox utiliza los aspectos de la carpeta FComboBox Skins una vez que ha agregado el componente al documento Flash. Para obtener ms informacin, consulte el apartado Personalizacin de aspectos de componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

En el cdigo siguiente se registra el elemento de aspecto personalizado boundBox_mc en la propiedad background del primer fotograma de la capa Read Me (Lame) del aspecto FBoundingBox en la carpeta Global Skins.
toysMenu.registerSkinElement(boundBox_mc, "background");

FComboBox.removeAll
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.removeAll()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; elimina todos los elementos de la lista del cuadro combinado, lo actualiza y cambia el tamao de la barra de desplazamiento. Los cuadros combinados sin elementos se muestran sin barra de desplazamiento. Este mtodo no puede utilizarse si el cuadro combinado est desactivado.
Ejemplo

En el cdigo siguiente se eliminan todos los elementos de menuMain.

menuMain.removeAll();
Vase tambin

FComboBox.removeItemAt

Diccionario de ActionScript 163

FComboBox.removeItemAt
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.removeItemAt(ndice)
Parmetros

ndice

Entero que especifica el ndice del elemento que debe eliminarse.

Valor devuelto

Un objeto que contiene el elemento eliminado.

Descripcin

Mtodo; devuelve el elemento eliminado en el ndice especificado y actualiza la lista. Cuando se elimina un elemento de la lista, los ndices de los elementos siguientes se actualizan para mostrar la nueva posicin en la lista. Si no existe ningn elemento en el ndice especificado, este mtodo devuelve undefined. El componente ComboBox utiliza un ndice basado en cero, en el que el elemento en el ndice 0 se muestra en la primera posicin de la lista.
Ejemplo

En el cdigo siguiente se elimina el quinto elemento de la lista en menuMain.

menuMain.removeItemAt(4);
Vase tambin

FComboBox.removeAll

FComboBox.replaceItemAt
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.replaceItemAt(ndice, etiqueta [,datos])

Parmetros

ndice

Entero que especifica la posicin de un elemento de lista. Cadena que especifica una nueva etiqueta para el elemento de lista.

etiqueta datos

Nuevo valor que debe asociarse al elemento de lista. Este parmetro es opcional; si no lo especifica, se mantienen los datos especificados para el elemento.

Valor devuelto

Ninguno.
Descripcin

Mtodo; actualiza el elemento en el ndice especificado con la etiqueta y los datos especificados. Si el elemento del ndice especificado tiene un valor de datos asociado y no se especifica un valor para el parmetro datos, no se cambiar el valor de datos del elemento de lista.

164

El componente ComboBox utiliza un ndice basado en cero, en el que el elemento en el ndice 0 se muestra en la primera posicin de la lista.
Ejemplo

En el cdigo siguiente se actualiza el quinto elemento del cuadro combinado Favorites con la etiqueta Nigel y el valor de datos 7439. Si no se han especificado datos para el elemento de lista, Nigel adquiere el valor de datos del elemento de lista existente.
Favorites.replaceItemAt(4, "Nigel", "7439");
Vase tambin

FComboBox.addItemAt, FComboBox.getItemAt, FComboBox.setDataProvider, FComboBox.sortItemsBy

FComboBox.setChangeHandler
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.setChangeHandler(nombreFuncin, [ubicacin])
Parmetros

Cadena que especifica el nombre de la funcin del controlador que debe ejecutarse cuando cambie el valor del cuadro combinado. Si no se especifica el parmetro ubicacin, esta funcin debe encontrarse en la misma lnea de tiempo que la instancia del componente.
nombreFuncin ubicacin Referencia de ruta a un objeto de datos, clip de pelcula o lnea de tiempo que contiene la funcin especificada. Este parmetro es opcional y tiene como valor predeterminado la lnea de tiempo principal del componente.
Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica un controlador de cambios que debe activarse cuando cambie el valor del cuadro combinado. Puede especificar la misma funcin del controlador de cambios para ms de un componente; la funcin siempre acepta la instancia del componente que ha cambiado como parmetro. Si se llama a este mtodo, se sustituye el valor del parmetro de controlador de cambios especificado en la edicin. Para obtener ms informacin, consulte el apartado Programacin de funciones del controlador de cambios para componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

En el cdigo siguiente se especifica myHandler como la funcin a la que se debe llamar cuando cambia el valor de toyList. Puesto que no se especifica el parmetro ubicacin, myHandler debe encontrarse en la misma lnea de tiempo que la instancia del componente.

Diccionario de ActionScript 165

El parmetro component de myHandler se rellena automticamente con la instancia de un componente (el componente que ha cambiado como resultado de las especificaciones del usuario y cuyo controlador de cambios es myHandler). Las acciones definidas en myHandler especifican que, cuando el usuario selecciona un elemento en la lista, la etiqueta del elemento aparece en la ventana Salida.
toyList.setChangeHandler("myHandler"); function myHandler(component){ trace(toyList.getSelectedItem().label); }

Si en el ejemplo anterior myHandler es una funcin ubicada en una lnea de tiempo tres niveles por encima de la lnea de tiempo del componente, la primera lnea del cdigo sera similar a la siguiente:
toyList.setChangeHandler("myHandler", _parent._parent._parent);

En el cdigo siguiente se crea la funcin myHandler en una instancia de myObject (que es de la clase Object) y, a continuacin, se especifica myHandler como la funcin de toyList1.
myObject = new Object(); myObject.myHandler = function(component){ trace(toyList.getSelectedItem().label); } toyList.setChangeHandler("myHandler", myObject);

FComboBox.setDataProvider
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.setDataProvider(proveedorDatos)
Parmetros

proveedorDatos Matriz de cadenas de texto que muestran los elementos que deben agregarse, instancia del objeto Array que especifica los elementos que deben agregarse o instancia de la clase DataProvider.
Valor devuelto

Ninguno.
Descripcin

Mtodo; registra un objeto externo (proveedorDatos) como origen de datos del componente de cuadro combinado. Si proveedorDatos es una instancia del objeto Array, el objeto puede especificar label, data o ambos, puesto que las propiedades del objeto y el contenido de la matriz pueden copiarse en el cuadro combinado como etiquetas, datos, o ambos. Si proveedorDatos es una instancia de la clase DataProvider, debe implementar la interfaz API de DataProvider definida en el smbolo DataProvider de la carpeta FlashUIComponents/Core Assets/ClassTree de la biblioteca. La interfaz API de DataProvider est destinada slo para usuarios avanzados y programadores; los dems usuarios deben utilizar una matriz o un objeto Array.
Ejemplo

En el cdigo siguiente se especifica el objeto Array peopleList1 como proveedor de datos de comboBox1.
comboBox1.setDataProvider(peopleList1);

166

En el cdigo siguiente se crea la matriz peopleList para visualizar las etiquetas de los elementos mostrados en comboBox1.
peopleList = new Array(); peopleList[0] = "BHall"; peopleList[1] = "CMoock"; peopleList[2] = "MWobensmith"; peopleList[3] = "MShepherd";

En el cdigo siguiente se crea la matriz itemList1, que especifica la etiqueta y los datos para elementos de lista. Este objeto de matriz debe utilizarse como proveedor de datos alternativo de comboBox1.
itemList1 = new Array(); for (i=0; i<10; i++) { // crear un elemento real var myItem = new Object(); myItem.label = "Item" + i; myItem.data = 75; // colocarlo en la matriz itemList1[i] = myItem; }

En el cdigo siguiente se especifica comboData, una instancia de la clase DataProvider, como proveedor de datos de comboBox1.
comboBox1.setDataProvider(comboData);

En el cdigo siguiente se crea una nueva instancia de la clase DataProvider y, a continuacin, se agregan las etiquetas del elemento mediante el mtodo addItem de DataProvider.
Nota: el mtodo addItem slo es un mtodo de la clase DataProvider. Los programadores interesados en utilizar la clase DataProvider deben consultar el smbolo DataProvider en la carpeta FlashUIComponents/CoreAssets/ ClassTree en la biblioteca antes de intentar utilizar los mtodos.

comboData = new DataProviderClass(); comboData.addItem("Devra"); comboData.addItem("Delia"); comboData.addItem("Vashti"); comboData.addItem("Alicia");

Vase tambin

FComboBox.addItem, FComboBox.replaceItemAt, FComboBox.sortItemsBy

FComboBox.setEditable
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.setEditable(editable)
Parmetros

editable (false).

Valor booleano que especifica si el cuadro combinado es editable (true) o esttico

Valor devuelto

Ninguno.

Diccionario de ActionScript 167

Descripcin

Mtodo; determina si el cuadro combinado es editable (true) o esttico (false). Un cuadro combinado editable tiene un campo de texto; cuando el usuario especifica texto, el cuadro combinado se desplaza al elemento con dicho texto. El campo de texto tambin puede utilizarse para visualizar texto mediante FComboBox.setValue. Si se llama a este mtodo, se sustituye el valor del parmetro Editable establecido durante la edicin.
Ejemplo

En el cdigo siguiente se activa un campo de introduccin de texto en la parte superior de menuMain.

menuMain.setEditable(true);
Vase tambin

FComboBox.setValue

FComboBox.setEnabled
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.setEnabled(activacin)
Parmetros

activacin Valor booleano que especifica si el cuadro combinado est activado (true) o desactivado (false).
Valor devuelto

Ninguno.
Descripcin

Mtodo; determina si el cuadro combinado est activado (true) o desactivado (false). Si el cuadro combinado est desactivado, no aceptar la interaccin del usuario mediante el teclado o el ratn. Si omite este parmetro, este mtodo toma como valor predeterminado true.
Ejemplo

En el cdigo siguiente se desactiva menuMain.

menuMain.setEnabled(false);
Vase tambin

FListBox.getEnabled

168

FComboBox.setItemSymbol
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.setItemSymbol(IDsmbolo)
Parmetros

IDsmbolo

Identificador de vnculo de un smbolo grfico para la visualizacin del contenido del cuadro combinado.

Valor devuelto

Ninguno.
Descripcin

Mtodo; registra un smbolo grfico para visualizar los elementos de la lista del cuadro combinado. El valor predeterminado es el smbolo FComboBoxItem de la biblioteca. Este mtodo est destinado a usuarios avanzados y programadores.

FComboBox.setRowCount
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.setRowCount(filas)
Parmetros

filas

Nmero mximo de filas que la lista desplegable puede mostrar sin desplazar su contenido.

Valor devuelto

Ninguno.
Descripcin

Mtodo; establece el nmero de elementos que puede verse en la lista desplegable del cuadro combinado sin desplazar su contenido. El valor mnimo del parmetro filas es 3. Si se llama a este mtodo, se sustituye el valor del parmetro de nmero de filas establecido durante la edicin.
Ejemplo

En el cdigo siguiente se establece el nmero de elementos visualizados en la lista desplegable de menuMain en 4.

menuMain.setRowCount(4);
Vase tambin

FComboBox.setSize

Diccionario de ActionScript 169

FComboBox.setSelectedIndex
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.setSelectedIndex(ndice)
Parmetros

ndice

Entero que especifica el ndice del elemento que debe seleccionarse.

Valor devuelto

Ninguno.
Descripcin

Mtodo; selecciona el elemento especificado y actualiza el cuadro combinado para mostrar el elemento seleccionado. Llamar a este mtodo no afecta el estado abierto o cerrado actual de la lista desplegable. Este mtodo no puede utilizarse si el cuadro combinado est desactivado. El componente ComboBox utiliza un ndice basado en cero, en el que el elemento en el ndice 0 se muestra en la primera posicin de la lista.
Ejemplo

En el cdigo siguiente se selecciona el cuarto elemento en la lista de menuMain.

menuMain.setSelectedIndex(3);
Vase tambin

FComboBox.setRowCount

FComboBox.setSize
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.setSize(anchura)
Parmetros

anchura

Entero que especifica la anchura del cuadro combinado, en pxeles.

Valor devuelto

Ninguno.
Descripcin

Mtodo; cambia el tamao del cuadro combinado por la anchura especificada. (No es posible establecer la altura del componente de cuadro combinado.) Utilice este mtodo para cambiar de forma programada el tamao del cuadro combinado y actualizarlo en tiempo de ejecucin.
Ejemplo

En el cdigo siguiente se define o cambia la anchura de menuMain a 100 pxeles.

menuMain.setSize(100);
Vase tambin

FComboBox.setRowCount

170

FComboBox.setStyleProperty
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.setStyleProperty(propiedadEstilo, valor)
Parmetros

propiedadEstilo valor

Cadena que especifica una propiedad del objeto FStyleFormat.

Valor que se establece para la propiedad.

Valor devuelto

Ninguno.
Descripcin

Mtodo; establece una propiedad FStyleFormat para una instancia de cuadro combinado. Si se llama a este mtodo para especificar una propiedad, se sustituye el valor de esta propiedad en el formato de estilo asignado al componente. Si se pasa undefined como valor de una propiedad, se eliminan todos los estilos de la misma. Para establecer FStyleFormat para varios componentes, cree un formato de estilo personalizado. Para obtener ms informacin sobre la creacin de formatos de estilo personalizados, consulte el apartado Personalizacin de los colores y el texto de los componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

En el cdigo siguiente se establece la propiedad arrow de comboBox1 en 0x000000 (negro).

comboBox1.setStyleProperty("arrow", 0x000000);
Vase tambin

FStyleFormat (objeto)

FComboBox.setValue
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.setValue(textoEditable)
Parmetros

textoEditable Cadena que especifica el texto que debe aparecer en el campo de texto de un cuadro combinado editable.
Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica el texto que aparece en el campo de entrada en la primera posicin de un cuadro combinado editable. Si llama a este mtodo, el usuario sigue pudiendo especificar texto en el campo.

Diccionario de ActionScript

171

Este mtodo puede utilizarse solamente con cuadros combinados editables. Antes de llamar a este mtodo, debe especificar true para el parmetro Editable (que tiene como valor predeterminado false) durante la edicin, o utilizar FComboBox.setEditable para establecer el parmetro en true.
Ejemplo

En el cdigo siguiente se especifica la cadena Gabino en el primer campo del cuadro combinado surnameMenu.
surnameMenu.setValue("Gabino");
Vase tambin

FComboBox.getValue

FComboBox.sortItemsBy
Disponibilidad

Flash Player 6.
Sintaxis

myComboBox.sortItemsBy(nombreCampo, orden)
Parmetros

nombreCampo orden

Cadena que especifica el nombre del campo utilizado para la clasificacin. Este valor normalmente ser "label" o "data". Cadena que especifica si los elementos deben clasificarse en orden ascendente ("ASC") o descendente ("DESC").

Valor devuelto

Ninguno.
Descripcin

Mtodo; clasifica los elementos del cuadro combinado alfabtica o numricamente y en el orden especificado mediante el nombre de campo especificado. Si los elementos de nombreCampo son una combinacin de cadenas de texto y enteros, los enteros aparecen en primer lugar. El parmetro nombreCampo generalmente es label o data, pero puede especificar el valor primitivo que mejor se adapte a sus necesidades.
Ejemplo

En el cdigo siguiente se clasifican los elementos en el cuadro combinado surnameMenu en orden ascendente mediante las etiquetas de los elementos de la lista.
surnameMenu.sortItemsBy("label", "ASC");
Vase tambin

FComboBox.addItemAt, FComboBox.replaceItemAt, FComboBox.setDataProvider

172

FListBox (componente)
El componente ListBox del entorno de edicin de Flash proporciona funciones de arrastrar y soltar para agregar cuadros de lista desplazables de seleccin nica y mltiple a los documentos de Flash, adems de proporcionar una interfaz de usuario para definir parmetros bsicos. Los mtodos del componente FListBox permiten controlar cuadros de lista en tiempo de ejecucin: puede crear cuadros de lista, controlar cuadros de lista creados durante la edicin, definir o sustituir parmetros bsicos y establecer opciones adicionales de tiempo de ejecucin. No es necesario que utilice un constructor para acceder a los mtodos de los componentes. Los mtodos del componente no realizan comprobaciones de errores de tipo, como ocurre en otros objetos y acciones nativos de ActionScript, por lo que se recomienda validar los parmetros antes de pasarlos a los mtodos. El componente ListBox se admite en Flash Player 6 y en versiones posteriores de Flash Player. Para obtener ms informacin sobre la utilizacin del componente ListBox, la definicin de parmetros durante la edicin y la modificacin del color y el aspecto de los componentes, consulte los apartados Personalizacin de los colores y el texto de los componentes y Personalizacin de aspectos de componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash. Resumen de mtodos del componente FListBox
Mtodo FListBox.addItem FListBox.addItemAt FListBox.getEnabled FListBox.getItemAt FListBox.getLength FListBox.getRowCount FListBox.getScrollPosition FListBox.getSelectedIndex FListBox.getSelectedIndices FListBox.getSelectedItem FListBox.getSelectedItems FListBox.getSelectMultiple FListBox.getValue FListBox.registerSkinElement FListBox.removeAll FListBox.removeItemAt FListBox.replaceItemAt Descripcin Agrega un nuevo elemento al final del cuadro de lista. Agrega un nuevo elemento al cuadro de lista en el ndice especificado. Devuelve true si el cuadro de lista est activado, y false si est desactivado. Devuelve la etiqueta y el valor del elemento en el ndice especificado. Devuelve el nmero de elementos del cuadro de lista. Devuelve el nmero de elementos visibles en el cuadro de lista. Devuelve el ndice del elemento en la primera posicin del cuadro de lista. Devuelve el ndice del ltimo elemento seleccionado. Devuelve los ndices de varios elementos seleccionados. Devuelve la etiqueta y el valor del elemento seleccionado. Devuelve la etiqueta y el valor de varios elementos seleccionados. Devuelve true si se permite la seleccin mltiple y false si se permite slo una seleccin. Devuelve la etiqueta del elemento seleccionado o cualquier informacin de datos asociados. Registra un elemento de aspecto en una propiedad. Elimina todos los elementos del cuadro de lista. Elimina el elemento en el ndice especificado. Reemplaza la etiqueta y los datos de un elemento en el ndice especificado por una nueva etiqueta y nuevos datos.

Diccionario de ActionScript 173

Mtodo FListBox.setAutoHideScrollBar

Descripcin Determina si una barra de desplazamiento est oculta (true) o visible (false) cuando el nmero de elementos del cuadro de lista no requiera desplazamiento. Asigna una funcin a la que debe llamarse cada vez que cambie la seleccin. Asocia un objeto externo al cuadro de lista. Especifica si el cuadro de lista est activado (true) o desactivado (false). Registra un identificador de vnculo de smbolos para ver elementos en el cuadro de lista. Determina el nmero de elementos que deben verse en el cuadro de lista. Hace que el cuadro de lista se desplace para que el elemento del ndice especificado se vea en la primera posicin de la lista. Selecciona el elemento en el ndice especificado y actualiza el cuadro de lista. Selecciona los elementos en los ndices especificados y actualiza el cuadro de lista. Determina si el usuario puede seleccionar ms de un elemento de la lista (true) o no (false). Establece la anchura y la altura del cuadro de lista, en pxeles. Establece una sola propiedad de estilo para un componente. Establece la anchura del cuadro de lista, en pxeles. Ordena los elementos del cuadro de lista en orden alfabtico o numrico mediante la etiqueta o los datos.

FListBox.setChangeHandler FListBox.setDataProvider FListBox.setEnabled FListBox.setItemSymbol FListBox.setRowCount FListBox.setScrollPosition FListBox.setSelectedIndex FListBox.setSelectedIndices FListBox.setSelectMultiple FListBox.setSize FListBox.setStyleProperty FListBox.setWidth FListBox.sortItemsBy

FListBox.addItem
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.addItem(etiqueta [, datos])
Parmetros

etiqueta datos

Cadena de texto que especifica el elemento que debe agregarse a la lista.

Valor asociado al elemento de lista. Este parmetro es opcional.

Valor devuelto

Ninguno.
Descripcin

Mtodo; agrega un nuevo elemento con la etiqueta y los datos especificados (opcional) al final del cuadro de lista, actualiza el cuadro de lista y cambia el tamao de la barra de desplazamiento. El parmetro de datos puede ser cualquier objeto, cadena, valor booleano, entero o clip de pelcula de Flash.

174

Para obtener un rendimiento y un resultado de tiempo de carga ptimos, no agregue ms de 400 elementos en un solo fotograma. Esto se aplica cuando agrega los elementos a uno o varios cuadros de lista.
Ejemplo

En el cdigo siguiente se agrega Lyvia a la lista de elementos visualizados en el cuadro de lista coolGirls.
coolGirls.addItem("Lyvia");

En el cdigo siguiente se agrega el nmero mximo de elementos recomendados en un solo fotograma (400 elementos) a listBox1:
for (i=0; i<400; i++) { listBox1.addItem(i); }

En el cdigo siguiente se agrega el nmero mximo de elementos recomendados en un solo fotograma (400 elementos) en listBox1 y comboBox2:
for (i=0; i<200; i++) { listBox1.addItem(i); comboBox2.addItem(i); }
Vase tambin

FListBox.addItemAt, FListBox.getItemAt, FListBox.removeItemAt, FListBox.replaceItemAt, FListBox.sortItemsBy

FListBox.addItemAt
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.addItemAt(ndice, etiqueta [, datos])

Parmetros

ndice

Entero que especifica la posicin de ndice en la que debe agregar el elemento. Cadena de texto que especifica la etiqueta del elemento. Valor asociado al elemento de lista. Este parmetro es opcional.

etiqueta datos

Valor devuelto

Ninguno.
Descripcin

Mtodo; agrega un nuevo elemento con la etiqueta especificada y los datos asociados (opcional) en el ndice especificado y actualiza el cuadro de lista. El parmetro de datos puede ser cualquier objeto, cadena, valor booleano, entero o clip de pelcula de Flash. El componente ListBox utiliza un ndice basado en cero, en el que el elemento en el ndice 0 aparece en la primera posicin de la lista. Para obtener un rendimiento y un tiempo de carga ptimos, no agregue ms de 400 elementos en un solo fotograma. Esto se aplica cuando agrega los elementos a uno o varios cuadros de lista.

Diccionario de ActionScript 175

Ejemplo

En el cdigo siguiente se agrega el elemento Dave con un valor asociado friend como quinto elemento en el cuadro de lista peopleList.
peopleList.addItemAt(4, "Dave", friend);

Para obtener ejemplos de cmo cargar grandes cantidades de elementos, consulte FListBox.addItem.
Vase tambin

FListBox.getSelectedItem, FListBox.removeItemAt, FListBox.replaceItemAt, FListBox.sortItemsBy

FListBox.getEnabled
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.getEnabled()
Parmetros

Ninguno.
Valor devuelto

Valor booleano que indica si el cuadro de lista est activado (true) o desactivado (false).
Descripcin

Mtodo; indica si el cuadro de lista est activado.

Ejemplo

En el cdigo siguiente se utiliza getEnabled para determinar si listMenu est activado o desactivado y muestra el resultado en la ventana Salida.
trace(listMenu.getEnabled());
Vase tambin

FListBox.setEnabled

FListBox.getItemAt
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.getItemAt(ndice)
Parmetros

ndice

Entero que especifica el ndice del elemento que debe recuperarse.

Valor devuelto

Un objeto o undefined.

176

Descripcin

Mtodo; devuelve el elemento en el ndice especificado como un objeto con las propiedades label y data. Si no hay ningn elemento en el ndice especificado, el mtodo devuelve undefined. El componente ListBox utiliza un ndice basado en cero, en el que el elemento en el ndice 0 aparece en la primera posicin de la lista.
Ejemplo

En el cdigo siguiente se devuelve la etiqueta del elemento en el ndice 4 en listMenu1 en la ventana Salida.
trace(listMenu1.getItemAt(4).label);

En el cdigo siguiente se devuelven los datos o el valor asociado al elemento en el ndice 4 en listMenu2 en la ventana Salida.
trace(listMenu2.getItemAt(4).data);

En el cdigo siguiente se devuelve un objeto que contiene la etiqueta y el valor de datos asociado al elemento en el ndice 4 en listMenu3 en la ventana Salida.
trace(listMenu3.getItemAt(4));
Vase tambin

FListBox.getSelectedItem

FListBox.getLength
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.getLength()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve el nmero de elementos en el cuadro de lista.

Ejemplo

En el cdigo siguiente se devuelve el nmero de elementos en phoneList.

phoneList.getLength();
Vase tambin

FListBox.setSize

Diccionario de ActionScript 177

FListBox.getRowCount
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.getRowCount()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve el nmero de filas visibles en el cuadro de lista. Este mtodo es til para determinar cuntas filas se ven en un cuadro de lista con escala en pxeles.
Ejemplo

En el cdigo siguiente se devuelve el nmero de filas visible en toyList y se establece el valor en la variable rowCount.
var rowCount = toyList.getRowCount();
Vase tambin

FListBox.setRowCount, FListBox.setSize

FListBox.getScrollPosition
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.getScrollPosition()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve el ndice del elemento que se encuentra actualmente en la primera posicin de la vista del cuadro de lista.
Ejemplo

En el cdigo siguiente se devuelve el ndice del elemento situado en la primera posicin de staffList.
staffList.getScrollPosition();
Vase tambin

FListBox.setScrollPosition

178

FListBox.getSelectedIndex
Disponibilidad

Flash Player 5
Sintaxis

myListBox.getSelectedIndex()
Parmetros

Ninguno.
Valor devuelto

Un entero o undefined.
Descripcin

Mtodo; devuelve el ndice del elemento seleccionado en un cuadro de lista de seleccin nica, el ltimo elemento seleccionado en un cuadro de lista de seleccin mltiple, o undefined si no se ha seleccionado ningn elemento. Para recuperar los ndices de todos los elementos seleccionados en un cuadro de lista de seleccin mltiple, utilice FListBox.getSelectedIndices.
Ejemplo

En el cdigo siguiente se devuelve el ndice del elemento seleccionado en el cuadro de lista de seleccin nica nationList.
nationList.getSelectedIndex();
Vase tambin

FListBox.setSelectedIndices, FListBox.setSelectMultiple

FListBox.getSelectedIndices
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.getSelectedIndices()
Parmetros

Ninguno.
Valor devuelto

Una matriz o undefined.

Descripcin

Mtodo; devuelve los ndices de los elementos seleccionados en un cuadro de lista de seleccin mltiple como una matriz, o devuelve undefined si no se ha seleccionado ningn elemento.
Ejemplo

En el cdigo siguiente se devuelven los ndices de los elementos seleccionados en el cuadro de lista de seleccin mltiple groceryList como una matriz.
groceryList.getSelectedIndices();
Vase tambin

FListBox.getSelectedIndex, FListBox.setSelectMultiple

Diccionario de ActionScript 179

FListBox.getSelectedItem
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.getSelectedItem()
Parmetros

Ninguno.
Valor devuelto

Un objeto o undefined.
Descripcin

Mtodo; devuelve el elemento seleccionado actualmente como un objeto con las propiedades label y data. Si se ha seleccionado ms de un elemento, el mtodo devuelve el ltimo elemento seleccionado; si no se ha seleccionado ningn elemento, el mtodo devuelve undefined. Para recuperar informacin sobre todos los elementos seleccionados en un cuadro de lista de seleccin mltiple, utilice FListBox.getSelectedItems.
Ejemplo

En el cdigo siguiente se devuelve la etiqueta del elemento seleccionado en listBox1.

trace(listBox1.getSelectedItem().label);

En el cdigo siguiente se devuelven los datos o el valor asociado al elemento seleccionado en listBox2.
trace(listBox2.getSelectedItem().data);

En el cdigo siguiente se devuelve un objeto que contiene la etiqueta y el valor de datos asociados al elemento seleccionado en listBox3.
trace(listBox3.getSelectedItem());
Vase tambin

FListBox.getItemAt

FListBox.getSelectedItems
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.getSelectedItems()
Parmetros

Ninguno.
Valor devuelto

Una matriz o undefined.

180

Descripcin

Mtodo; devuelve los elementos seccionados como una matriz de objetos con las propiedades label y data, o devuelve undefined si no se ha seleccionado ningn elemento. Este mtodo slo puede utilizarse para obtener los elementos seleccionados en un cuadro de lista de seleccin mltiple. Para obtener informacin sobre el elemento seleccionado en un cuadro de lista de seleccin nica, utilice FListBox.getSelectedItem.
Ejemplo

En el cdigo siguiente se recuperan los elementos seleccionados en wishList y se los almacena en la variable myObjArray.
var myObjArray = wishList.getSelectedItems();
Vase tambin

FListBox.getSelectedItem, FListBox.setSelectMultiple

FListBox.getSelectMultiple
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.getSelectMultiple()
Parmetros

Ninguno.
Valor devuelto

Valor booleano.
Descripcin

Mtodo; indica si los usuarios pueden seleccionar varios elementos (true) o slo un elemento (false) en el cuadro de lista.
Ejemplo

En el cdigo siguiente se comprueba si wishList permite la seleccin mltiple.

if (wishList.getSelectMultiple()) { }
Vase tambin

FListBox.setSelectMultiple

Diccionario de ActionScript

181

FListBox.getValue
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.getValue()
Parmetros

Ninguno.
Valor devuelto

La etiqueta o los datos asociados a un elemento seleccionado.

Descripcin

Mtodo; devuelve informacin sobre el elemento seleccionado en el cuadro de lista. Si el elemento no tiene datos especificados, este mtodo devuelve la etiqueta del elemento; si el elemento tiene datos asociados, este mtodo devuelve los datos.
Ejemplo

En el cdigo siguiente se devuelve la etiqueta del elemento seleccionado en nationList.

trace(nationList.getValue());
Vase tambin

FListBox.getItemAt

FListBox.registerSkinElement
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.registerSkinElement(elemento, propiedadEstilo)
Parmetros

elemento

Instancia de clip de pelcula. Nombre de una propiedad de FStyleFormat.

propiedadEstilo
Valor devuelto

Ninguno.
Descripcin

Mtodo; registra un elemento de aspecto en una propiedad de estilo. Los elementos de aspecto se registran en las propiedades del primer fotograma de la capa Read Me (Lame) de cada aspecto de la biblioteca. Los componentes estn formados de aspectos, que a su vez se componen de varios elementos de aspecto, cada uno de los cuales puede registrarse en una propiedad del objeto FStyleFormat. El formato de estilo asignado a un componente asigna valores a estas propiedades. De forma predeterminada se asigna el objeto globalStyleFormat, a todos los componentes de la interfaz de usuario de Flash, que es una instancia del objeto FStyleFormat.

182

Utilice este mtodo para registrar propiedades y elementos de aspecto personalizados en aspectos de componentes de la interfaz de usuario de Flash o personalizados editando el cdigo del primer fotograma de la capa Read Me (Lame) de un aspecto de la biblioteca. El componente FListBox utiliza los aspectos de la carpeta FListBox Skins una vez que ha agregado el componente al documento Flash. Para obtener ms informacin, consulte el apartado Personalizacin de aspectos de componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

En el cdigo siguiente se registra el elemento de aspecto personalizado boundBox_mc en la propiedad background del primer fotograma de la capa Read Me (Lame) del aspecto FBoundingBox en la carpeta Global Skins de la biblioteca.
toysMenu.registerSkinElement(boundBox_mc, "background");
Vase tambin

FStyleFormat (objeto)

FListBox.removeAll
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.removeAll()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; elimina todos los elementos del cuadro de lista, lo actualiza y cambia el tamao de la barra de desplazamiento.
Ejemplo

En el cdigo siguiente se eliminan todos los elementos de wishList.

wishList.removeAll();
Vase tambin

FListBox.removeItemAt

Diccionario de ActionScript 183

FListBox.removeItemAt
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.removeItemAt(ndice)
Parmetros

ndice

Entero que especifica el ndice del elemento que debe eliminarse.

Valor devuelto

Nada o undefined.
Descripcin

Mtodo; elimina el elemento en el ndice especificado, actualiza los ndices de los elementos de lista que van despus del elemento eliminado para mostrar la nueva posicin en la lista y, a continuacin, actualiza el cuadro de lista y cambia el tamao de la barra de desplazamiento. Si no existe ningn elemento en el ndice especificado, este mtodo devuelve undefined. El componente ListBox utiliza un ndice basado en cero, en el que el elemento en el ndice 0 aparece en la primera posicin de la lista.
Ejemplo

En el cdigo siguiente se elimina el quinto elemento de la lista en wishList.

wishList.removeItemAt(4);
Vase tambin

FListBox.addItemAt

FListBox.replaceItemAt
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.replaceItemAt(ndice, etiqueta [,datos])

Parmetros

ndice

Entero que especifica la posicin de un elemento de lista. Cadena que especifica una nueva etiqueta para el elemento de lista.

etiqueta datos

Nuevo valor que debe asociarse al elemento de lista. Este parmetro es opcional; si no lo especifica, se mantienen los datos asociados al elemento.

Valor devuelto

Ninguno.
Descripcin

Mtodo; actualiza el elemento en el ndice especificado con la etiqueta y los datos especificados. Si el elemento del ndice especificado tiene un valor de datos asociado y no especifica un valor para el parmetro de datos, no se cambiar el valor de datos del elemento de lista.

184

El componente ListBox utiliza un ndice basado en cero, en el que el elemento en el ndice 0 aparece en la primera posicin de la lista.
Ejemplo

En el cdigo siguiente se actualiza el quinto elemento del cuadro de lista Favorites con la nueva etiqueta Suerte y el nuevo valor Gato. Si no se especifica el valor de datos Gato y los datos asociados al quinto elemento de lista eran Perro, el valor de datos de Suerte sera Perro (lo que sera incorrecto, puesto que el valor es Gato).
Favorites.replaceItemAt(4, "Suerte", "Gato");
Vase tambin

FListBox.addItemAt, FListBox.getItemAt

FListBox.setAutoHideScrollBar
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.setAutoHideScrollBar(ocultarBarra)
Parmetros

ocultarBarra

Valor booleano que especifica si la barra de desplazamiento est oculta cuando no es necesaria (true) o si siempre se visualiza (false).

Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica si la barra de desplazamiento est oculta cuando el nmero de elementos del cuadro de lista puede visualizarse sin barra de desplazamiento (true) o si siempre se visualiza la barra de desplazamiento (false). Si este mtodo se establece en false y el nmero de elementos no requiere una barra de desplazamiento, la barra de desplazamiento se muestra desactivada (en color ms claro).
Ejemplo

En el cdigo siguiente se oculta la barra de desplazamiento de wishList cuando puede verse el nmero de elementos del cuadro de lista sin desplazar su contenido.
wishList.setAutoHideScrollBar(true);

FListBox.setChangeHandler
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.setChangeHandler(nombreFuncin, [ubicacin])
Parmetros

nombreFuncin Cadena que especifica el nombre de la funcin del controlador que debe ejecutarse cuando cambia la seleccin en el cuadro de lista. Si no se especifica el parmetro ubicacin, esta funcin debe encontrarse en la misma lnea de tiempo que la instancia del componente.

Diccionario de ActionScript 185

ubicacin Referencia de ruta a un objeto de datos, clip de pelcula o lnea de tiempo que contiene la funcin especificada. Este parmetro es opcional y tiene como valor predeterminado la lnea de tiempo principal del componente.
Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica un controlador de cambios al que debe llamarse cuando cambia la seleccin del cuadro de lista. Puede especificar la misma funcin del controlador de cambios para ms de un componente: la funcin siempre acepta como parmetro la instancia del componente que ha cambiado. Si se llama a este mtodo, se sustituye el valor del parmetro de controlador de cambios especificado en la edicin. Para obtener ms informacin, consulte el apartado Programacin de funciones del controlador de cambios para componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

En el cdigo siguiente se especifica myHandler como funcin a la que se llama cuando cambia el valor de listBox1. Puesto que no se especifica el parmetro ubicacin, myHandler debe encontrarse en la misma lnea de tiempo que la instancia del componente. El parmetro component de myHandler se rellena automticamente con la instancia de un componente (el componente que ha cambiado como resultado de las especificaciones del usuario y cuyo controlador de cambios es myHandler). Las acciones definidas en myHandler especifican que, cuando el usuario selecciona un elemento en la lista, la etiqueta del elemento aparece en la ventana Salida.
listBox1.setChangeHandler("myHandler"); function myHandler(component){ trace(listBox1.getSelectedItem().label); }

Si en el ejemplo anterior myHandler es una funcin ubicada en una lnea de tiempo tres niveles por encima de la lnea de tiempo del componente, la primera lnea del cdigo sera similar a la siguiente:
listBox1.setChangeHandler("myHandler", _parent._parent._parent);

En el cdigo siguiente se crea la funcin myHandler en una instancia de myObject (cuya clase es Object) y, a continuacin, se especifica myHandler como funcin de listBox1.
myObject = new Object(); myObject.myHandler = function(component){ trace(listBox1.getSelectedItem().label); } listBox1.setChangeHandler("myHandler", myObject);

186

FListBox.setDataProvider
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.setDataProvider(proveedorDatos)
Parmetros

proveedorDatos Matriz de cadenas de texto que muestran los elementos que deben agregarse, instancia del objeto Array que especifica los elementos que deben agregarse o instancia de la clase DataProvider.
Valor devuelto

Ninguno.
Descripcin

Mtodo; se registra un objeto externo (proveedorDatos) como origen de datos del componente de cuadro de lista. Si proveedorDatos es una instancia del objeto Array, el objeto puede especificar label, data o ambas cosas, puesto que las propiedades del objeto y el contenido de la matriz pueden copiarse en el cuadro de lista como etiquetas, datos o ambas cosas. Si proveedorDatos es una instancia de la clase DataProvider, debe implementar la interfaz API de DataProvider definida en el smbolo de DataProvider de la carpeta FlashUIComponents/CoreAssets/ClassTree en la biblioteca. La interfaz API de DataProvider est destinada slo para usuarios avanzados y programadores; los dems usuarios deben utilizar una matriz o un objeto Array.
Ejemplo

En el cdigo siguiente se especifica el objeto Array writerList como proveedor de datos para listBox1.
listBox1.setDataProvider(writerList);

En el cdigo siguiente se crea la matriz writerList para visualizar las etiquetas de los elementos mostrados en listBox1.
writerList = new Array(); writerList[0] = "Jody"; writerList[1] = "Mary"; writerList[2] = "Marcelle"; writerList[3] = "Dale"; writerList[4] = "Stephanie"; writerList[5] = "Barbara";

En el cdigo siguiente se crea la matriz itemList1, que especifica la etiqueta y los datos para elementos de lista. Este objeto Array puede utilizarse como proveedor de datos alternativo para listBox1.
itemList1 = new Array(); for (i=0; i<10; i++) { // crear un elemento real var myItem = new Object(); myItem.label = "Item" + i; myItem.data = 75; // colocarlo en la matriz itemList1[i] = myItem; }

Diccionario de ActionScript 187

En el cdigo siguiente se especifica editorList, una instancia de la clase DataProvider, como proveedor de datos de listBox1.
listBox1.setDataProvider(editorList);

En el cdigo siguiente se crea una nueva instancia de la clase DataProvider y, a continuacin, se agregan las etiquetas del elemento mediante el mtodo addItem de DataProvider.
Nota: el mtodo addItem slo es un mtodo de la clase DataProvider. Los programadores interesados en utilizar la clase DataProvider deben consultar el smbolo DataProvider en la carpeta FlashUIComponents/CoreAssets/ ClassTree en la biblioteca antes de intentar utilizar los mtodos.

editorList = new DataProviderClass(); editorList.addItem("Anne"); editorList.addItem("Rosana"); editorList.addItem("Lisa"); editorList.addItem("Rebecca");

Vase tambin

FListBox.addItem, FListBox.replaceItemAt, FListBox.sortItemsBy

FListBox.setEnabled
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.setEnabled(activacin)
Parmetros

activacin

Valor booleano que especifica si el cuadro de lista est activado (true) o desactivado (false).

Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica si el cuadro de lista est activado (true) o desactivado (false). Si un cuadro de lista est desactivado, no acepta la interaccin del usuario mediante el teclado o el ratn. Si omite este parmetro, este mtodo toma como valor predeterminado true.
Ejemplo

En el cdigo siguiente se desactiva interestList.

interestList.setEnabled(false);
Vase tambin

FListBox.getEnabled

188

FListBox.setItemSymbol
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.setItemSymbol(IDsmbolo)
Parmetros

IDsmbolo

Identificador de vnculo de un smbolo grfico para visualizar el contenido del cuadro de lista.

Valor devuelto

Ninguno.
Descripcin

Mtodo; registra un smbolo grfico para visualizar los elementos del cuadro de lista. El valor predeterminado es el smbolo FListBoxItem de la biblioteca. Este mtodo est destinado a usuarios avanzados y programadores.

FListBox.setRowCount
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.setRowCount(filas)
Parmetros

filas

Nmero mximo de filas que se visualiza en el cuadro de lista.

Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica el nmero de elementos que se visualiza en el cuadro de lista. Si utiliza este mtodo, use FListBox.setWidth y no FListBox.setSize para establecer la anchura del cuadro de lista. Si se llama a FListBox.setSize, se sustituye el valor del parmetro de nmero de filas establecido durante la edicin. Por lo tanto, si llama a este mtodo despus de llamar a FListBox.setRowCount, la pelcula pasar por alto el valor de rowCount y establecer la altura del cuadro de lista en pxeles.
Ejemplo

En el cdigo siguiente se establece en 4 el nmero de elementos que se visualiza en toyList.

toyList.setRowCount(4);
Vase tambin

FListBox.getRowCount, FListBox.setSize

Diccionario de ActionScript 189

FListBox.setScrollPosition
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.setScrollPosition(ndice)
Parmetros

ndice

Entero que especifica el ndice del elemento que debe visualizarse en la primera posicin del cuadro de lista.

Valor devuelto

Ninguno.
Descripcin

Mtodo; hace que el cuadro de lista se desplace para que el elemento especificado se visualice en la primera posicin. El componente ListBox utiliza un ndice basado en cero, en el que el elemento en el ndice 0 aparece en la primera posicin de la lista.
Ejemplo

En el cdigo siguiente se visualiza el quinto elemento de toyList en la primera posicin de la lista.

toyList.setScrollPosition(4);
Vase tambin

FListBox.getScrollPosition

FListBox.setSelectedIndex
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.setSelectedIndex(ndice)
Parmetros

ndice

Entero que especifica el ndice del elemento que debe seleccionarse en el cuadro de lista.

Valor devuelto

Ninguno.
Descripcin

Mtodo; selecciona el elemento en el ndice especificado y actualiza el cuadro de lista. El componente ListBox utiliza un ndice basado en cero, en el que el elemento en el ndice 0 aparece en la primera posicin de la lista.
Ejemplo

En el cdigo siguiente se selecciona el quinto elemento del cuadro de lista.

toyList.setSelectedIndex(4);

190

Vase tambin

FListBox.getSelectedIndex, FListBox.getSelectedIndices

FListBox.setSelectedIndices
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.setSelectedIndices(matrizndices)
Parmetros

matrizndices
Valor devuelto

Matriz de ndices de los elementos que se seleccionan en el cuadro de lista.

Ninguno.
Descripcin

Mtodo; selecciona los elementos especificados en la matriz de ndices y actualiza el cuadro de lista. El componente ListBox utiliza un ndice basado en cero, en el que el elemento en el ndice 0 aparece en la primera posicin de la lista.
Ejemplo

En el cdigo siguiente se crea una matriz llamada myArray, que especifica los elementos que deben seleccionarse en toyList y, a continuacin, pasa la matriz al mtodo setSelectedIndices.
var myArray = new Array (1,4,5,7); toyList.setSelectedIndices(myArray);
Vase tambin

FListBox.getSelectedIndices

FListBox.setSelectMultiple
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.setSelectMultiple(seleccinMltiple)
Parmetros

seleccinMltiple Valor booleano que especifica el modo de seleccin mltiple (true) o modo de seleccin nica (false).
Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica si los usuarios pueden seleccionar varios elementos (true) o slo un elemento (false) en el cuadro de lista. El valor predeterminado es false. Si se llama a este mtodo, se sustituye el valor del parmetro de seleccin mltiple establecido durante la edicin.

Diccionario de ActionScript

191

Ejemplo

En el cdigo siguiente se activa la seleccin mltiple para toyList.

toyList.setSelectMultiple(true);

FListBox.setSize
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.setSize(anchura, altura)
Parmetros

anchura altura

Entero que especifica la anchura del cuadro de lista, en pxeles. Entero que especifica la altura del cuadro de lista, en pxeles.

Valor devuelto

Ninguno.
Descripcin

Mtodo; cambia el tamao del cuadro de lista en tiempo de ejecucin por la anchura y la altura especificados. Si se llama a este mtodo, se sustituye el valor del parmetro de nmero de filas establecido durante la edicin. Por lo tanto, si llama a este mtodo despus de llamar a FListBox.setRowCount, la pelcula establecer la altura del cuadro de lista en pxeles y pasar por alto el valor de rowCount. Para establecer la anchura de un cuadro de lista cuando utilice setRowCount, use FListBox.setWidth.
Ejemplo

En el cdigo siguiente se cambia el tamao de phoneList para que mida 200 pxeles de ancho y 50 pxeles de alto.
phoneList.setSize(200, 50);
Vase tambin

FListBox.setRowCount, FListBox.setWidth

FListBox.setStyleProperty
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.setStyleProperty(propiedadEstilo, valor)
Parmetros

propiedadEstilo valor

Cadena que especifica una propiedad del objeto FStyleFormat.

Valor que se establece para la propiedad.

Valor devuelto

Ninguno.

192

Descripcin

Mtodo; establece una propiedad FStyleFormat para una instancia de cuadro de lista. Si se llama a este mtodo para especificar una propiedad, se sustituye el valor de esta propiedad en el formato de estilo asignado al componente. Si se pasa undefined como valor de una propiedad, se eliminan todos los estilos de la misma. Para establecer FStyleFormat para varios componentes, cree un formato de estilo personalizado. Para obtener ms informacin sobre la creacin de formatos de estilo personalizados, consulte el apartado Personalizacin de los colores y el texto de los componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

En el cdigo siguiente se establece la propiedad shadow de listBox1 en 0x000000 (negro).

listBox1.setStyleProperty("shadow", 0x000000);
Vase tambin

FStyleFormat (objeto)

FListBox.setWidth
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.setWidth(anchura)
Parmetros

anchura

Entero que especifica la anchura del cuadro de lista, en pxeles.

Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica la anchura del cuadro de lista, en pxeles. Este mtodo es til para establecer la anchura del cuadro de lista cuando se utiliza FListBox.setRowCount para determinar la altura.
Ejemplo

En el cdigo siguiente se establece la anchura del cuadro de lista toyList en 500 pxeles.
toyList.setWidth(500);
Vase tambin

FListBox.setSize

FListBox.sortItemsBy
Disponibilidad

Flash Player 6.
Sintaxis

myListBox.sortItemsBy(nombreCampo, orden)

Diccionario de ActionScript 193

Parmetros

nombreCampo orden

Cadena que especifica el nombre del campo utilizado para la clasificacin. Este valor normalmente ser "label" o "data". Cadena que especifica si los elementos deben clasificarse en orden ascendente ("ASC") o descendente ("DESC").

Valor devuelto

Ninguno.
Descripcin

Mtodo; clasifica los elementos del cuadro de lista alfabtica o numricamente y en el orden especificado mediante el nombre de campo especificado. Si los elementos de nombreCampo son una combinacin de cadenas de texto y enteros, los enteros aparecen en primer lugar. El parmetro nombreCampo suele ser "label" o "data", pero los usuarios avanzados y los programadores pueden especificar un valor primitivo que se adapte a sus necesidades.
Ejemplo

En el cdigo siguiente se ordenan los elementos del cuadro de lista surnameMenu en orden ascendente mediante las etiquetas de los elementos de lista.
surnameMenu.sortItemsBy("label", "ASC");
Vase tambin

FListBox.addItemAt, FListBox.replaceItemAt

_focusrect
Disponibilidad

Flash Player 4.
Sintaxis

_focusrect = booleano;
Descripcin

Propiedad (global); especifica si aparece un rectngulo amarillo alrededor del botn que est resaltado mediante el teclado. El valor predeterminado, true, muestra un rectngulo amarillo alrededor del botn o campo de texto resaltado a medida que el usuario presiona la tecla de tabulacin para desplazarse por los objetos de una pelcula. Especifique false si no desea visualizar el rectngulo amarillo. sta es una propiedad global que puede sustituirse para instancias especficas.
Vase tambin

Button._focusrect

for
Disponibilidad

Flash Player 5.
Sintaxis

for(init; condicin; siguiente) { sentencia(s); }

194

Parmetros

init

Expresin que debe comprobarse antes de que comience la secuencia de bucle, normalmente una expresin de asignacin. Tambin se permite una sentencia var para este parmetro. Una expresin que da como resultado true o false. La condicin se comprueba antes de cada repeticin del bucle; el bucle finaliza cuando la condicin da como resultado false.

condicin siguiente

Expresin que debe comprobarse despus de cada repeticin del bucle; normalmente se trata de una expresin de asignacin que utiliza los operadores ++ (incremento) o -- (decremento).
sentencia(s)
Descripcin

Instruccin o instrucciones que deben ejecutarse en el cuerpo del bucle.

Accin; una construccin de bucle que comprueba la expresin init (inicializar) una vez y despus comienza una secuencia de bucle por medio de la cual, siempre que la condicin equivalga a true, se ejecuta sentencia y se comprueba la siguiente expresin. Las acciones for o for..in no pueden enumerar algunas propiedades. Por ejemplo, los mtodos incorporados del objeto Array (Array.sort y Array.reverse) no se incluyen en la enumeracin de un objeto Array y las propiedades de clip de pelcula, como por ejemplo _x e _y, no se enumeran.
Ejemplo

En el ejemplo siguiente se utiliza for para agregar los elementos en una matriz:
for(i=0; i<10; i++) { array [i] = (i + 5)*10; trace(array[i]); }

Los resultados siguientes se visualizan en la ventana Salida:

50 60 70 80 90 100 110 120 130 140

A continuacin se muestra un ejemplo de la utilizacin de for para realizar la misma accin repetidamente. En el cdigo siguiente, el bucle for agrega los nmeros de 1 a 100:
var sum = 0; for (var i=1; i<=100; i++) { sum = sum + i; }
Vase tambin

++ (incremento), (decremento), for..in, var

Diccionario de ActionScript 195

for..in
Disponibilidad

Flash Player 5.
Sintaxis

for(variableRepeticin in objeto){ sentencia(s); }

Parmetros

variableRepeticin Nombre de una variable que acta como repetidor, haciendo referencia a cada propiedad de un objeto o elemento de una matriz. objeto

Nombre de un objeto que debe repetirse. Instruccin que debe ejecutarse para cada repeticin.

sentencias(s)
Valor devuelto

Ninguno.
Descripcin

Accin; realiza un bucle por las propiedades de un objeto o elemento de una matriz y ejecuta la sentencia para cada propiedad de un objeto. Las acciones for o for..in no pueden enumerar algunas propiedades. Por ejemplo, los mtodos incorporados del objeto Array (Array.sort y Array.reverse) no se incluyen en la enumeracin de un objeto Array y las propiedades de clip de pelcula, como por ejemplo _x e _y, no se enumeran. La construccin for..in se repite en las propiedades de los objetos de la cadena prototipo del objeto repetido. Si el prototipo secundario es principal, repetir las propiedades del secundario con for..in, tambin repetir las propiedades de principal. La accin for..in enumera todos los objetos de la cadena prototipo de un objeto. Primero se enumeran las propiedades del objeto, despus las propiedades del prototipo inmediato, las propiedades del prototipo del prototipo y as sucesivamente. La accin for..in no enumera dos veces el nombre de la misma propiedad. Si el objeto secundario tiene el prototipo principal y ambos contienen la propiedad prop, la accin for..in llamada en secundario enumerar prop en secundario, pero pasar por alto el de principal.
Ejemplo

A continuacin se muestra un ejemplo de la utilizacin de for..in para repetir las propiedades de un objeto:
myObject = { name:'Tara', age:27, city:'San Francisco' }; for (name in myObject) { trace ("myObject." + name + " = " + myObject[name]); }

La salida de este ejemplo es la que se muestra a continuacin:

myObject.name = Tara myObject.age = 27 myObject.city = San Francisco

196

A continuacin se muestra un ejemplo de la utilizacin del operador typeof con for..in para repetir un tipo concreto de secundario:
for (name in myMovieClip) { if (typeof (myMovieClip[name]) = "movieclip") { trace ("Tengo un clip de pelcula secundario llamado " + name); } }

El ejemplo siguiente enumera los elementos secundarios de un clip de pelcula y enva cada uno al fotograma 2 de sus respectivas lneas de tiempo. El clip de pelcula RadioButtonGroup es principal con varios secundarios, _RedRadioButton_, _GreenRadioButton_ y _BlueRadioButton.
for (var name in RadioButtonGroup) { RadioButtonGroup[name].gotoAndStop(2); }

FPushButton (componente)
El componente PushButton del entorno de edicin de Flash proporciona funciones de arrastrar y soltar para agregar botones a los documentos de Flash, adems de proporcionar una interfaz de usuario para definir parmetros bsicos. Los mtodos del componente FPushButton permiten controlar botones en tiempo de ejecucin: puede crear botones, controlar botones creados durante la edicin, definir o sustituir parmetros bsicos y definir opciones adicionales en tiempo de ejecucin. No es necesario que utilice un constructor para acceder a los mtodos de los componentes. El componente PushButton acepta todas las interacciones estndar mediante el teclado o el ratn. Puede utilizar los mtodos de FPushButton para especificar una funcin de controlador para botones de comando, activar o desactivar botones y cambiar el tamao de los botones sin distorsin en tiempo de ejecucin. Los mtodos del componente no realizan comprobaciones de errores de tipo, como ocurre en otros objetos y acciones nativos de ActionScript, por lo que se recomienda validar los parmetros antes de pasarlos a los mtodos. El componente PushButton se admite en Flash Player 6 y en versiones posteriores de Flash Player. Para obtener ms informacin sobre la utilizacin del componente PushButton, la definicin de parmetros durante la edicin y la modificacin del color y el aspecto de los componentes, consulte los apartados Personalizacin de los colores y el texto de los componentes y Personalizacin de aspectos de componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.

Diccionario de ActionScript 197

Resumen de mtodos del componente FPushButton

Mtodo FPushButton.getEnabled FPushButton.getLabel FPushButton.registerSkinElement FPushButton.setClickHandler FPushButton.setEnabled FPushButton.setLabel FPushButton.setSize FPushButton.setStyleProperty Descripcin Devuelve true si el botn est activado y false si est desactivado. Devuelve la etiqueta del botn como una cadena. Registra un elemento de aspecto en una propiedad. Especifica la funcin a la que se llama cuando el usuario suelta el botn. Determina si el botn est activado o desactivado. Establece la etiqueta del botn en tiempo de ejecucin. Establece la altura y la anchura del botn en pxeles. Establece una sola propiedad de estilo para un componente.

FPushButton.getEnabled
Disponibilidad

Flash Player 6.
Sintaxis

myPushButton.getEnabled()
Parmetros

Ninguno.
Valor devuelto

Valor booleano.
Descripcin

Mtodo; devuelve true si la instancia del botn de comando est activada y false si est desactivada.
Ejemplo

En el cdigo siguiente se devuelve el estado de activacin del botn de comando submit en la ventana Salida.
trace(submit.getEnabled());
Vase tambin

FPushButton.setEnabled

198

FPushButton.getLabel
Disponibilidad

Flash Player 6.
Sintaxis

myPushButton.getLabel()
Parmetros

Ninguno.
Valor devuelto

Una cadena.
Descripcin

Mtodo; devuelve la etiqueta de texto en el botn de comando como una cadena.

Ejemplo

En el cdigo siguiente se devuelve la etiqueta del botn de comando buttonPage1 en la ventana Salida.
trace(buttonPage1.getLabel());
Vase tambin

FPushButton.setLabel

FPushButton.registerSkinElement
Disponibilidad

Flash Player 6.
Sintaxis

myPushButton.registerSkinElement(elemento, propiedadEstilo)
Parmetros

elemento

Instancia de clip de pelcula. Nombre de una propiedad de FStyleFormat.

propiedadEstilo
Valor devuelto

Ninguno.
Descripcin

Mtodo; registra un elemento de aspecto en una propiedad de estilo. Los elementos de aspecto se registran en las propiedades del primer fotograma de la capa Read Me (Lame) de cada aspecto de la biblioteca. Los componentes estn formados de aspectos, que a su vez se componen de varios elementos de aspecto, cada uno de los cuales puede registrarse en una propiedad del objeto FStyleFormat. El formato de estilo asignado a un componente asigna valores a estas propiedades. De forma predeterminada se asigna el objeto globalStyleFormat a todos los componentes de la interfaz de usuario de Flash, que es una instancia del objeto FStyleFormat. Utilice este mtodo para registrar propiedades y elementos de aspecto personalizados en aspectos de componentes de la interfaz de usuario de Flash o personalizados editando el cdigo del primer fotograma de la capa Read Me (Lame) de un aspecto de la biblioteca.

Diccionario de ActionScript 199

El componente FPushButton utiliza los aspectos de la carpeta FPushButton Skins y el aspecto FLabel de la carpeta Global Skins una vez que ha agregado el componente en el documento de Flash. Para obtener ms informacin, consulte el apartado Personalizacin de aspectos de componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

En el cdigo siguiente se registra el elemento de aspecto personalizado newFace_mc en la propiedad face del primer fotograma de la capa Read Me (Lame) del aspecto FLabel. El aspecto FLabel se encuentra en la carpeta Component Skins/Global Skins de la biblioteca.
submitButton.registerSkinElement(newFace_mc, "face");
Vase tambin

FStyleFormat (objeto)

FPushButton.setClickHandler
Disponibilidad

Flash Player 6.
Sintaxis

myPushButton.setClickHandler(nombreFuncin, [ubicacin])
Parmetros

nombreFuncin Cadena que especifica la funcin del controlador que debe ejecutarse cuando el usuario suelta el botn. Si no se especifica el parmetro ubicacin, esta funcin debe encontrarse en la misma lnea de tiempo que la instancia del componente. ubicacin Referencia de ruta a un objeto de datos, clip de pelcula o lnea de tiempo que contiene la funcin especificada. Este parmetro es opcional y tiene como valor predeterminado la lnea de tiempo principal del componente.
Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica una funcin del controlador a la que debe llamarse cuando el usuario suelta el botn. Puede especificar la misma funcin del controlador para ms de un componente: la funcin siempre acepta la instancia del componente que ha cambiado como un parmetro. Si se llama a este mtodo, se sustituye el valor del parmetro del controlador de accin del ratn especificado durante la edicin. Para obtener ms informacin, consulte el apartado Programacin de funciones del controlador de cambios para componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.

200

Ejemplo

El cdigo siguiente especifica onClick como funcin a la que se llama cuando cambia el valor de button1. Puesto que no se especifica el parmetro ubicacin, onClick debe encontrarse en la misma lnea de tiempo que la instancia del componente. El parmetro component en onClick se rellena automticamente con la instancia de un componente (el componente que ha cambiado como resultado de la entrada del usuario y que especifica onClick como controlador de cambios). Las acciones definidas en onClick especifican que cuando el usuario suelta un botn, la etiqueta del botn aparece en la ventana Salida.
button1.setClickHandler("onClick"); function onClick(component){ trace(component._name); }

Si en el ejemplo anterior onClick es una funcin ubicada en una lnea de tiempo tres niveles por encima de la lnea de tiempo del componente, la primera lnea del cdigo sera similar a la siguiente:
button1.setChangeHandler("onClick", _parent._parent._parent);

En el cdigo siguiente se crea la funcin onClick en una instancia de myObject (cuya clase es Object) y, a continuacin, se especifica onClick como funcin de button1.
myObject = new Object(); myObject.onClick = function(component){ trace(component._name); } button1.setChangeHandler("onClick", myObject);

FPushButton.setEnabled
Disponibilidad

Flash Player 6.
Sintaxis

myPushButton.setEnabled(activacin)
Parmetros

activacin

Valor booleano que especifica si el botn de comando est activado (true) o desactivado (false).

Valor devuelto

Ninguno.
Descripcin

Mtodo; determina si el botn de comando est activado. Si un botn de comando est desactivado, no acepta la interaccin del usuario mediante el teclado o el ratn y el texto del botn aparece en color ms claro. Omitir el parmetro equivale a pasar true.
Ejemplo

En el cdigo siguiente se desactiva button1.

button1.setEnabled(false);
Vase tambin

FPushButton.getEnabled

Diccionario de ActionScript 201

FPushButton.setLabel
Disponibilidad

Flash Player 6.
Sintaxis

myPushButton.setLabel(etiqueta)
Parmetros

etiqueta

Cadena que contiene el texto que debe aparecer en el botn de comando.

Valor devuelto

Ninguno.
Descripcin

Mtodo; aplica una etiqueta de texto al botn de comando en tiempo de ejecucin. Si se llama a este mtodo, se sustituye el valor del parmetro etiqueta especificado durante la edicin.
Ejemplo

En el cdigo siguiente se aplica la etiqueta Cleveland Rocks! en voteButton.

voteButton.setLabel("Cleveland Rocks!");
Vase tambin

FPushButton.getLabel

FPushButton.setSize
Disponibilidad

Flash Player 6.
Sintaxis

myPushButton.setSize(anchura, altura)
Parmetros

anchura altura

Entero que especifica la anchura del botn, en pxeles. Entero que especifica la altura del botn, en pxeles.

Valor devuelto

Ninguno.
Descripcin

Mtodo; establece la anchura y la altura del botn en tiempo de ejecucin. Si se llama a este mtodo, se sustituyen los cambios de tamao o de escala aplicados durante la edicin. Para obtener ms informacin, consulte el apartado Definicin del tamao de los componentes PushButton en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

En el cdigo siguiente se cambia el tamao de submitButton por 100 x 50 pxeles en tiempo de ejecucin.
submitButton.setSize(100, 50);

202

FPushButton.setStyleProperty
Disponibilidad

Flash Player 6.
Sintaxis

myPushButton.setStyleProperty(propiedadEstilo, valor)
Parmetros

propiedadEstilo valor

Cadena que especifica una propiedad del objeto FStyleFormat.

Valor que se establece para la propiedad.

Valor devuelto

Ninguno.
Descripcin

Mtodo; establece una propiedad FStyleFormat para una instancia de botn de comando determinada. Si se llama a este mtodo para especificar una propiedad, se sustituye el valor de esta propiedad en el formato de estilo asignado al componente. Si se pasa undefined como valor de una propiedad, se eliminan todos los estilos de la misma. Para establecer FStyleFormat para varios componentes, cree un formato de estilo personalizado. Para obtener ms informacin sobre la creacin de formatos de estilo personalizados, consulte el apartado Personalizacin de los colores y el texto de los componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

En el cdigo siguiente se establece la propiedad face de submitButton en 0xffffff (blanco).

submitButton.setStyleProperty("face", 0xffffff);
Vase tambin

FStyleFormat (objeto)

FRadioButton (componente)
Los botones de opcin son grupos de botones seleccionables de los que slo se puede seleccionar uno cada vez. El componente RadioButton del entorno de edicin de Flash proporciona funciones de arrastrar y soltar para agregar grupos de botones de opcin a los documentos de Flash, adems de proporcionar una interfaz de usuario para definir parmetros bsicos. Los mtodos del componente FRadioButton permiten controlar botones de opcin en tiempo de ejecucin: puede crear botones de opcin, controlar botones de opcin creados durante la edicin, definir o sustituir parmetros bsicos y establecer opciones de tiempo de ejecucin. No es necesario que utilice un constructor para acceder a los mtodos de los componentes. El componente RadioButton se admite en Flash Player 6 y en versiones posteriores de Flash Player. Los mtodos del componente no realizan comprobaciones de errores de tipo, como ocurre en otros objetos y acciones nativos de ActionScript, por lo que se recomienda validar los parmetros antes de pasarlos a los mtodos. Para obtener ms informacin sobre la utilizacin del componente RadioButton, la definicin de parmetros durante la edicin y la modificacin del color y el aspecto de los componentes, consulte los apartados Personalizacin de los colores y el texto de los componentes y Personalizacin de aspectos de componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.

Diccionario de ActionScript 203

Resumen de mtodos del componente FRadioButton

Mtodo FRadioButton.getData FRadioButton.getEnabled FRadioButton.getLabel FRadioButton.getState FRadioButton.getValue FRadioButton.registerSkinElement FRadioButton.setChangeHandler FRadioButton.setData FRadioButton.setEnabled FRadioButton.setGroupName Descripcin Devuelve un valor de datos para una instancia de botn de opcin. Devuelve true si el botn de opcin est activado y false si est desactivado. Devuelve la etiqueta del botn de opcin como una cadena. Devuelve el estado seleccionado de una instancia de botn de opcin. Devuelve el valor de datos del botn de opcin seleccionado en un grupo, o devuelve la etiqueta si no se han especificado datos. Registra un elemento de aspecto en una propiedad de estilo. Especifica una funcin a la que se debe llamar cuando cambia la seleccin del botn de opcin. Establece los datos asociados a una instancia de botn de opcin. Determina si el botn de opcin est activado o desactivado. Especifica un nombre de grupo para una instancia de botn de opcin, o establece un nuevo nombre para un grupo de botones de opcin. Aplica una etiqueta para el botn de opcin en tiempo de ejecucin. Especifica si la etiqueta aparece a la izquierda o a la derecha del botn de opcin. Establece la anchura del botn de opcin, en pxeles. Establece el estado seleccionado de la instancia de botn de opcin. Establece una sola propiedad de estilo para una instancia de componente. Selecciona un botn de opcin en un grupo de botones de opcin en tiempo de ejecucin.

FRadioButton.setLabel FRadioButton.setLabelPlacement FRadioButton.setSize FRadioButton.setState FRadioButton.setStyleProperty FRadioButton.setValue

FRadioButton.getData
Disponibilidad

Flash Player 6.
Sintaxis

myRadioButton.getData()
Parmetros

Ninguno.
Valor devuelto

Una cadena.
Descripcin

Mtodo; devuelve los datos asociados a la instancia de botn de opcin especificada. Utilice FRadioButton.getValue para obtener los datos asociados al botn de opcin seleccionado en un grupo de botones de opcin.
Ejemplo

En el cdigo siguiente se devuelven los datos asociados al botn de opcin flashRadio en la ventana Salida.
trace(flashRadio.getData());

204

Vase tambin

FRadioButton.setData

FRadioButton.getEnabled
Disponibilidad

Flash Player 6.
Sintaxis

myRadioButton.getEnabled() myRadioButtonGroup.getEnabled()
Parmetros

Ninguno.
Valor devuelto

Un valor booleano o undefined.

Descripcin

Mtodo; indica si una instancia de botn de opcin o un grupo de botones de opcin estn activados. Sintaxis 1: indica si myRadioButton est activado (true) o desactivado (false). Sintaxis 2: indica si los botones de myRadioButtonGroup estn activados (true) o desactivados (false). Si algunos botones del grupo estn activados y otros estn desactivados, el mtodo devuelve undefined.
Ejemplo

En el cdigo siguiente se devuelve el estado de activacin de radio1 en la ventana Salida.

trace(radio1.getEnabled());
Vase tambin

FRadioButton.setEnabled

FRadioButton.getLabel
Disponibilidad

Flash Player 6.
Sintaxis

myRadioButton.getLabel()
Parmetros

Ninguno.
Valor devuelto

Una cadena.
Descripcin

Mtodo; devuelve la etiqueta del botn de opcin especificado como una cadena. No puede utilizar este mtodo para obtener las etiquetas de un grupo de botones de opcin; la sintaxis radioButtonGroup.getLabel no es vlida.

Diccionario de ActionScript 205

Ejemplo

En el cdigo siguiente se devuelve la etiqueta de la instancia radio2 en la ventana Salida.

trace(radio2.getLabel());
Vase tambin

FRadioButton.setLabel

FRadioButton.getState
Disponibilidad

Flash Player 6.
Sintaxis

myRadioButton.getState()
Parmetros

Ninguno.
Valor devuelto

Un valor booleano que indica el estado seleccionado del botn de opcin.

Descripcin

Mtodo; devuelve un valor booleano que indica si myRadioButton est seleccionado (true) o no (false).
Ejemplo

En el cdigo siguiente se devuelve el estado seleccionado del botn de opcin radio1 en la ventana Salida.
trace(radio1.getState());
Vase tambin

FRadioButton.setState

FRadioButton.getValue
Disponibilidad

Flash Player 6.
Sintaxis

myRadioButtonGroup.getValue()
Parmetros

Ninguno.
Valor devuelto

Una cadena o undefined.

Descripcin

Mtodo; devuelve los datos asociados al botn de opcin seleccionado en myRadioButtonGroup, o la etiqueta del botn de opcin si no se han especificado datos. Si no se ha seleccionado ningn botn, el mtodo devuelve undefined.

206

Ejemplo

En el cdigo siguiente se devuelven los datos asociados al botn de opcin seleccionado del grupo radioGroup1 en la ventana Salida.
trace(radioGroup1.getValue());
Vase tambin

FRadioButton.setValue

FRadioButton.registerSkinElement
Disponibilidad

Flash Player 6.
Sintaxis

myRadioButton.registerSkinElement(elemento, propiedadEstilo)
Parmetros

elemento

Instancia de clip de pelcula. Nombre de una propiedad de FStyleFormat.

propiedadEstilo
Valor devuelto

Ninguno.
Descripcin

Mtodo; registra un elemento de aspecto en una propiedad de estilo. Los elementos de aspecto se registran en las propiedades del primer fotograma de la capa Read Me (Lame) de cada aspecto de la biblioteca. Los componentes estn formados de aspectos, que a su vez se componen de varios elementos de aspecto, cada uno de los cuales puede registrarse en una propiedad del objeto FStyleFormat. El formato de estilo asignado a un componente asigna valores a estas propiedades. De forma predeterminada se asigna el objeto globalStyleFormat, a todos los componentes de la interfaz de usuario de Flash, que es una instancia del objeto FStyleFormat. Utilice este mtodo para registrar propiedades y elementos de aspecto personalizados en aspectos de componentes de la interfaz de usuario de Flash o personalizados editando el cdigo del primer fotograma de la capa Read Me (Lame) de un aspecto de la biblioteca. El componente FRadioButton utiliza los aspectos de la carpeta FRadioButton Skins y el aspecto FLabel de la carpeta Global Skins una vez que ha agregado el componente en el documento de Flash. Para obtener ms informacin, consulte el apartado Personalizacin de aspectos de componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

En el cdigo siguiente se registra el elemento de aspecto personalizado myDot_mc en la propiedad FStyleFormat radioDot en el archivo ReadMe del aspecto frb_dot, situado en la carpeta FRadioButton Skins de la biblioteca.
radio1.registerSkinElement(myDot_mc, "radioDot");
Vase tambin

FStyleFormat (objeto)

Diccionario de ActionScript 207

FRadioButton.setChangeHandler
Disponibilidad

Flash Player 6.
Sintaxis

myRadioButton.setChangeHandler(nombreFuncin, [ubicacin]) myRadioButtonGroup.setChangeHandler(nombreFuncin, [ubicacin])

Parmetros

Cadena que especifica el nombre de la funcin del controlador que debe ejecutarse cuando cambia el valor de un botn de opcin. Si no se especifica el parmetro ubicacin, esta funcin debe encontrarse en la misma lnea de tiempo que la instancia del componente.
nombreFuncin ubicacin Referencia a un objeto de datos, un clip de pelcula o una lnea de tiempo que contiene la funcin especificada. Este parmetro es opcional y tiene como valor predeterminado la lnea de tiempo principal del componente.
Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica una funcin del controlador de cambios a la que debe llamarse cuando cambia la seleccin del botn de opcin. Puede especificar la misma funcin del controlador de cambios para ms de un componente; la funcin siempre acepta la instancia del componente que ha cambiado como parmetro. Si se llama a este mtodo, se sustituye el valor del parmetro de controlador de cambios especificado en la edicin. Sintaxis 1: especifica la funcin a la que se debe llamar si la instancia de botn de opcin myRadioButton est seleccionada o deseleccionada. Sintaxis 2: especifica la funcin a la que se debe llamar si cambia el botn de opcin seleccionado en el grupo radioButtonGroup. Especificar una funcin para un grupo de botones de opcin equivale a especificar la misma funcin para todos los botones de opcin del grupo por separado con myRadioButton.setChangeHandler. Para obtener ms informacin, consulte el apartado Programacin de funciones del controlador de cambios para componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

Sintaxis 1: en el cdigo siguiente se especifica myHandler como funcin a la que se llama cuando se selecciona radio1.
radio1.setChangeHandler("myHandler");

Sintaxis 2: en el cdigo siguiente se especifica onChange como funcin a la que se llama cuando se selecciona un botn de opcin del grupo radioGroup1.
radioGroup1.setChangeHandler("onChange");

208

En el cdigo siguiente se especifica onChange como funcin a la que se debe llamar cuando el usuario selecciona un botn de opcin de radioGroup1. Puesto que no se especifica el parmetro ubicacin, onChange debe encontrarse en la misma lnea de tiempo que la instancia del componente. El parmetro component de onChange se establece automticamente con el componente (el componente que ha cambiado como resultado de la entrada del usuario y que especifica onChange como controlador de cambios), que en este caso se trata de un botn de opcin del grupo. Las acciones definidas en onChange especifican que cuando el usuario selecciona un botn de opcin, el nombre de instancia aparece en la ventana Salida.
radioGroup1.setChangeHandler("onChange"); function onChange(component){ trace(component._name); }

Si en el ejemplo anterior onChange es una funcin ubicada en una lnea de tiempo tres niveles por encima de la lnea de tiempo del componente, la primera lnea del cdigo sera similar a la siguiente:
radioGroup1.setChangeHandler("onChange", _parent._parent._parent);

En el cdigo siguiente se crea la funcin onChange en una instancia de myObject (cuya clase es Object) y, a continuacin, se especifica onChange como funcin de radioGroup1.
myObject = new Object(); myObject.onChange = function(component){ trace(component._name); } radioGroup1.setChangeHandler("onChange", myObject);

FRadioButton.setData
Disponibilidad

Flash Player 6.
Sintaxis

myRadioButton.setData("datos")
Parmetros

datos

Datos que desea asociar a la instancia de botn de opcin.

Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica los datos que deben asociarse a la instancia de botn de opcin. Si se llama a este mtodo, se sustituye el valor del parmetro de datos establecido durante la edicin.
Ejemplo

En el cdigo siguiente se especifican los datos ActionScript para la instancia de botn de opcin flashRadio.
flashRadio.setData("ActionScript");
Vase tambin

FRadioButton.getData, FRadioButton.setValue

Diccionario de ActionScript 209

FRadioButton.setEnabled
Disponibilidad

Flash Player 6.
Sintaxis

myRadioButton.setEnabled(activacin) myRadioButtonGroup.setEnabled(activacin)
Parmetros

activacin Valor booleano que especifica si un botn de opcin determinado o todos los botones de un grupo estn activados (true) o desactivados (false).
Valor devuelto

Ninguno.
Descripcin

Mtodo; activa y desactiva botones de opcin en tiempo de ejecucin. Sintaxis 1: especifica si myRadioButton est activado (true) o desactivado (false). Sintaxis 2: especifica si todos los botones de opcin con el nombre de grupo radioButtonGroup estn activados (true) o desactivados (false). Llamar a este mtodo sin pasar ningn parmetro equivale a pasar el parmetro true.
Ejemplo

Sintaxis 1: en el cdigo siguiente se desactiva un botn de opcin radio1 sin desactivar los dems botones del grupo.
radio1.setEnabled(false);

Sintaxis 2: en el cdigo siguiente se desactivan todos los botones de opcin del grupo radioGroup1.
radioGroup1.setEnabled(false);
Vase tambin

FRadioButton.getEnabled

FRadioButton.setGroupName
Disponibilidad

Flash Player 6.
Sintaxis

myRadioButton.setGroupName(nombreGrupo) myRadioButtonGroup.setGroupName(nombreGrupo)
Parmetros

nombreGrupo

Cadena que especifica el nombre de un grupo de botones de opcin.

Valor devuelto

Ninguno.

210

Descripcin

Mtodo; aplica un nombre de grupo a una instancia de botn de opcin o a un grupo de botones de opcin en tiempo de ejecucin. Si se llama a este mtodo, se sustituye el valor del parmetro de nombre de grupo establecido durante la edicin. Sintaxis 1: especifica myRadioButton como miembro del grupo de botones de opcin nombreGrupo. Sintaxis 2: especifica un nuevo nombre de grupo para todos los botones de opcin de
myRadioButtonGroup.
Ejemplo

Sintaxis 1: en el cdigo siguiente se especifica Colores como nombre de grupo para la instancia de botn de opcin radioRed.
radioRed.setGroupName("Colores");

Sintaxis 2: en el cdigo siguiente se especifica grupoBotonesJuegos como nuevo nombre de grupo para todos los botones de opcin de radioGroupGames.
radioGroupGames.setGroupName("grupoBotonesJuegos");

FRadioButton.setLabel
Disponibilidad

Flash Player 6.
Sintaxis

myRadioButton.setLabel(etiqueta)
Parmetros

etiqueta

Cadena de texto que especifica la etiqueta que aparece a la derecha del botn de

opcin.
Valor devuelto

Ninguno.
Descripcin

Mtodo; aplica una etiqueta a la instancia de botn de opcin myRadioButton en tiempo de ejecucin. Si se llama a este mtodo, se sustituye el valor del parmetro etiqueta especificado durante la edicin. No puede utilizar este mtodo para definir etiquetas para grupos de botones de opcin; la sintaxis radioButtonGroup.setLabel no es vlida.
Ejemplo

En el cdigo siguiente se aplica la etiqueta Ojos castaos a radio1.

radio1.setLabel("Ojos castaos");
Vase tambin

FRadioButton.getLabel

Diccionario de ActionScript

211

FRadioButton.setLabelPlacement
Disponibilidad

Flash Player 6.
Sintaxis

myRadioButton.setLabelPlacement(posicinEtiqueta) myRadioButtonGroup.setLabelPlacement(posicinEtiqueta)
Parmetros

posicinEtiqueta
Descripcin

Cadena de texto; especifique "left" o "right".

Mtodo; especifica si la etiqueta aparece a la derecha o a la izquierda del botn de opcin. Si se llama a este mtodo, se sustituye el valor del parmetro de posicin de etiqueta establecido durante la edicin. Sintaxis 1: especifica la posicin de la etiqueta para un solo botn de opcin. Sintaxis 2: especifica la posicin de las etiquetas para todos los botones de opcin de un grupo.
Ejemplo

Sintaxis 1: en el cdigo siguiente se coloca la etiqueta de radio1 a la izquierda del botn de opcin.
radio1.setLabelPlacement("left");

Sintaxis 2: en el cdigo siguiente se colocan las etiquetas de los botones de opcin del grupo Colors a la derecha de los botones.
Colors.setLabelPlacement("right");
Vase tambin

FRadioButton.setLabel, FRadioButton.setLabelPlacement

FRadioButton.setSize
Disponibilidad

Flash Player 6.
Sintaxis

myRadioButton.setSize(anchura) myRadioButtonGroup.setSize(anchura)
Parmetros

anchura

Entero que especifica el tamao del botn de opcin, en pxeles.

Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica la anchura del botn de opcin en pxeles y vuelve a dibujarlo. (No es posible establecer la altura de los componentes de botn de opcin.) Si se llama a este mtodo, se sustituye el cambio de escala de anchura aplicado durante la edicin. Sintaxis 1: establece el tamao de un botn de opcin determinado.

212

Sintaxis 2: establece el tamao de todos los botones de opcin de un grupo. Para obtener ms informacin, consulte el apartado Definicin del tamao de los componentes RadioButton en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

En el cdigo siguiente se establece la anchura de radio1 en 200 pxeles.

radio1.setSize(200);

FRadioButton.setState
Disponibilidad

Flash Player 6.
Sintaxis

myRadioButton.setState("seleccin")
Parmetros

seleccin

Valor booleano que indica si el botn de opcin est seleccionado (true) o no

(false).
Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica si myRadioButton est seleccionado (true) o deseleccionado (false). En un grupo de botones de opcin (todos con el mismo parmetro Nombre del grupo), slo uno puede tener el estado inicial true (seleccionado). Si ms de un botn de opcin tiene especificado true para este parmetro, se seleccionar el ltimo botn de opcin con el parmetro de estado inicial true. El valor predeterminado de este parmetro es false. Si se llama a este mtodo, se sustituye el valor del parmetro de estado inicial establecido durante la edicin. Si llama a este mtodo y tambin llama a FRadioButton.setValue para seleccionar un botn de opcin en tiempo de ejecucin y los botones de opcin pertenecen al mismo grupo, se seleccionar el botn de opcin especificado en el ltimo mtodo llamado.
Ejemplo

En el cdigo siguiente se selecciona el botn de opcin radio1 en tiempo de ejecucin.

radio1.setState(true));
Vase tambin

FRadioButton.getState, FRadioButton.getValue, FRadioButton.setValue

Diccionario de ActionScript 213

FRadioButton.setStyleProperty
Disponibilidad

Flash Player 6.
Sintaxis

myRadioButton.setStyleProperty(propiedadEstilo, valor) myRadioButtonGroup.setStyleProperty(propiedadEstilo, valor)

Parmetros

propiedadEstilo valor

Cadena que especifica una propiedad del objeto FStyleFormat.

Valor que se establece para la propiedad.

Valor devuelto

Ninguno.
Descripcin

Mtodo; establece una propiedad FStyleFormat para una instancia de botn de opcin determinada. Si se llama a este mtodo para especificar una propiedad, se sustituye el valor de esta propiedad en el formato de estilo asignado al componente. Si se pasa undefined como valor de una propiedad, se eliminan todos los estilos de la misma. Para establecer FStyleFormat para varios componentes, cree un formato de estilo personalizado. Para obtener ms informacin sobre la creacin de formatos de estilo personalizados, consulte el apartado Personalizacin de colores y texto de componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

En el cdigo siguiente se establece la propiedad radioDot para radioButton1 en 0xFF12AC (rosa).

radioButton1.setStyleProperty("radioDot", 0xFF12AC);

En el cdigo siguiente se establece la propiedad radioDot para todos los botones de radioGroup1 en 0xFF12AC (rosa).
radioGroup1.setStyleProperty("radioDot", 0xFF12AC);
Vase tambin

FStyleFormat (objeto)

FRadioButton.setValue
Disponibilidad

Flash Player 6.
Sintaxis

myRadioButtonGroup.setValue("datos")
Parmetros

datos

Datos asociados al botn de opcin que se selecciona.

Valor devuelto

Ninguno.
Descripcin

Mtodo; selecciona el botn de opcin asociado a los datos especificados y deselecciona el botn seleccionado actualmente en el mismo grupo.

214

Si se llama a este mtodo, se sustituye el valor del parmetro de valor inicial establecido durante la edicin. Si llama a este mtodo y tambin llama a FRadioButton.setState para seleccionar un botn de opcin en tiempo de ejecucin y los botones de opcin pertenecen al mismo grupo, se seleccionar el botn de opcin especificado en el ltimo mtodo llamado.
Ejemplo

En el cdigo siguiente se selecciona el botn de opcin con los datos asociados rojo en el grupo de botones de opcin denominado Colors.
Colors.setValue("rojo");
Vase tambin

FRadioButton.getData, FRadioButton.getValue, FRadioButton.setState

FScrollBar (componente)
El componente FScrollBar del entorno de edicin de Flash proporciona funciones de arrastrar y soltar para agregar barras de desplazamiento para campos dinmicos y de introduccin de texto en documentos de Flash, adems de proporcionar una interfaz de usuario para establecer parmetros bsicos. Los mtodos del componente FScrollBar permiten controlar barras de desplazamiento en tiempo de ejecucin: puede crear barras de desplazamiento, controlar barras de desplazamiento creadas durante la edicin, definir o sustituir parmetros bsicos y establecer opciones adicionales en tiempo de ejecucin. No es necesario que utilice un constructor para acceder a los mtodos de los componentes. No se recomienda utilizar algunos de los mtodos del componente FScrollBar con barras de desplazamiento asociadas a campos de texto. Consulte las entradas de los diferentes mtodos para obtener ms informacin. Los usuarios avanzados y los programadores pueden utilizar el componente ScrollBar con otros elementos de Flash para crear interfaces de usuario personalizadas. Los mtodos del componente no realizan comprobaciones de errores de tipo, como ocurre en otros objetos y acciones nativos de ActionScript, por lo que se recomienda validar los parmetros antes de pasarlos a los mtodos. El componente ScrollBar se admite en Flash Player 6 y en versiones posteriores de Flash Player. Para obtener ms informacin sobre la utilizacin del componente ScrollBar, la definicin de parmetros durante la edicin y la modificacin del color y el aspecto de los componentes, consulte los apartados Personalizacin de los colores y el texto de los componentes y Personalizacin de aspectos de componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash. Resumen de mtodos del componente FScrollBar
Mtodo FScrollBar.getEnabled FScrollBar.getScrollPosition FScrollBar.registerSkinElement Descripcin Devuelve true si la barra de desplazamiento est activada y false si est desactivada. Devuelve un entero que representa la posicin actual del cuadro de desplazamiento (deslizador). Registra un elemento de aspecto en una propiedad definida para un aspecto en la capa Read Me (Lame) situada en el fotograma 1 de un clip de pelcula de aspecto de la biblioteca. Especifica la funcin a la que se debe llamar cada vez que cambia la posicin de desplazamiento. (No se puede utilizar este mtodo con campos de texto.) Especifica si la barra de desplazamiento est activada (true) o desactivada (false).

FScrollBar.setChangeHandler

FScrollBar.setEnabled

Diccionario de ActionScript 215

Mtodo FScrollBar.setHorizontal FScrollBar.setLargeScroll FScrollBar.setScrollContent FScrollBar.setScrollPosition FScrollBar.setScrollProperties

Descripcin Especifica si la barra de desplazamiento es horizontal (true) o vertical (false). Especifica el nmero de posiciones desplazadas cuando el usuario hace clic en la gua de desplazamiento. Especifica la instancia del campo de texto a la que se aplica la barra de desplazamiento. Establece la posicin del cuadro de desplazamiento como un entero entre posMn y posMx. Establece las propiedades tamaoPgina, posMn y posMx para la barra de desplazamiento. (No se puede utilizar este mtodo con campos de texto.) Especifica un campo de texto como destino para la barra de desplazamiento. Establece la longitud de la barra de desplazamiento, en pxeles. Especifica el nmero de posiciones desplazadas cuando el usuario hace clic en la flecha de desplazamiento. Establece una sola propiedad de estilo para un componente.

FScrollBar.setScrollTarget FScrollBar.setSize FScrollBar.setSmallScroll FScrollBar.setStyleProperty

FScrollBar.getEnabled
Disponibilidad

Flash Player 6.
Sintaxis

myScrollBar.getEnabled()
Parmetros

Ninguno.
Valor devuelto

Valor booleano.
Descripcin

Mtodo; indica si la barra de desplazamiento est activada (true) o desactivada (false).

Ejemplo

En el cdigo siguiente se devuelve un valor en la ventana Salida que indica si scroll1 est activada (true) o desactivada (false).
trace(scroll1.getEnabled());
Vase tambin

FScrollBar.setEnabled

216

FScrollBar.getScrollPosition
Disponibilidad

Flash Player 6.
Sintaxis

myScrollBar.getScrollPosition()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve un entero que especifica la posicin del cuadro de desplazamiento (deslizador). El valor devuelto se encuentra dentro del intervalo definido por las propiedades posMn y posMx que determinan los lmites de desplazamiento de la barra de desplazamiento. Para establecer los parmetros posMn y posMx, utilice FScrollBar.setScrollProperties.
Ejemplo

En el cdigo siguiente se devuelve la posicin actual del cuadro de desplazamiento para la barra de desplazamiento scroll2 en la ventana Salida. Si scroll2 tiene el valor 2 en posMn y el valor 25 en posMx, el valor devuelto 12 indica que el cuadro de desplazamiento se encuentra en la parte central de la barra de desplazamiento.
trace(scroll2.getPosition());

Consulte FScrollBar.setChangeHandler para ver otro ejemplo en el que se utiliza este mtodo.
Vase tambin

FScrollBar.setChangeHandler, FScrollBar.setScrollPosition

FScrollBar.registerSkinElement
Disponibilidad

Flash Player 6.
Sintaxis

myScrollBar.registerSkinElement(elemento, propiedadEstilo)
Parmetros

elemento

Instancia de clip de pelcula. Cadena que especifica una propiedad FStyleFormat.

propiedadEstilo
Valor devuelto

Ninguno.
Descripcin

Mtodo; registra un elemento de aspecto en una propiedad de estilo. Los elementos de aspecto se registran en las propiedades del primer fotograma de la capa Read Me (Lame) de cada aspecto de la biblioteca.

Diccionario de ActionScript 217

Los componentes estn formados de aspectos, que a su vez se componen de varios elementos de aspecto, cada uno de los cuales puede registrarse en una propiedad del objeto FStyleFormat. El formato de estilo asignado a un componente asigna valores a estas propiedades. De forma predeterminada se asigna el objeto globalStyleFormat a todos los componentes de la interfaz de usuario de Flash, que es una instancia del objeto FStyleFormat. Utilice este mtodo para registrar propiedades y elementos de aspecto personalizados en aspectos de componentes de la interfaz de usuario de Flash o personalizados editando el cdigo del primer fotograma de la capa Read Me (Lame) de un aspecto de la biblioteca. El componente FScrollBar utiliza los aspectos de la carpeta FScrollBar Skins y el aspecto FLabel de la carpeta Global Skins una vez que ha agregado el componente en el documento de Flash. La edicin de los aspectos de la carpeta FScrollBar Skins afecta a todos los componentes que utilizan barras de desplazamiento (ComboBox, ListBox, ScrollBar y ScrollPane). Para obtener ms informacin, consulte el apartado Personalizacin de aspectos de componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

En el cdigo siguiente se registra el elemento de aspecto personalizado NewArrow_mc en la propiedad arrow del primer fotograma de la capa Read Me (Lame) del aspecto fsb_downArrow en la carpeta FScrollBar Skins de la biblioteca.
Scroll1.registerSkinElement(NewArrow_mc, "arrow");
Vase tambin

FStyleFormat (objeto)

FScrollBar.setChangeHandler
Disponibilidad

Flash Player 6.
Sintaxis

myScrollBar.setChangeHandler(nombreFuncin, [ubicacin])
Parmetros

Cadena que especifica el nombre de la funcin del controlador que debe ejecutarse cuando el usuario mueve el cuadro de desplazamiento. Si no se especifica el parmetro ubicacin, esta funcin debe encontrarse en la misma lnea de tiempo que la instancia del componente.
nombreFuncin ubicacin Referencia de ruta a un objeto de datos, clip de pelcula o lnea de tiempo que contiene la funcin especificada. Este parmetro es opcional y tiene como valor predeterminado la lnea de tiempo principal del componente.
Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica un controlador de cambios al que debe llamarse cuando el usuario mueve el cuadro de desplazamiento (deslizador) de la barra de desplazamiento. Puede especificar la misma funcin del controlador de cambios para ms de un componente; la funcin siempre acepta la instancia del componente que ha cambiado como parmetro. Si se llama a este mtodo, se sustituye el valor del parmetro de controlador de cambios especificado en la edicin.

218

Este mtodo es para usuarios avanzados y programadores que crean aplicaciones y componentes personalizados mediante el componente ScrollBar de la interfaz de usuario de Flash; el mtodo no puede utilizarse con barras de desplazamiento asociadas a campos de texto.
Ejemplo

En el cdigo siguiente se crea un cuadro rellenado en el escenario y, a continuacin, se aplica una barra de desplazamiento horizontal, se establecen las propiedades de desplazamiento y se especifica la funcin mover como controlador de cambios. El controlador de cambios mover utiliza la posicin de desplazamiento de la barra de desplazamiento para cambiar la posicin _x del clip de pelcula a un valor entre 50 y 250.
root.createEmptyMovieClip("square", 1); _root.square._x = 50; _root.square._y = 50; with (_root.square) { moveTo(0, 0); beginFill(0x0066CC); lineTo(20, 0); lineTo(20, 20); lineTo(0, 20); lineTo(0, 0); endFill(); } scrollBar._x = 50; scrollBar.setHorizontal (true); scrollBar.setScrollProperties (1, 50, 250); scrollBar.setChangeHandler ("mover"); function mover () { _root.square._x = scrollBar.getScrollPosition(); }

En el cdigo siguiente se especifica una funcin de controlador de cambios para una instancia del componente de barra de desplazamiento asociado a un componente de cuadro de lista personalizado. El controlador de cambios establece scroll1 para obtener la posicin de desplazamiento actual mediante FScrollBar.getScrollPosition y, a continuacin, customListBox utiliza FScrollBar.setScrollPosition para restablecer la posicin de desplazamiento, de modo que el elemento en la posicin de desplazamiento actual aparezca en la primera posicin del cuadro de lista personalizado. El parmetro component se rellena automticamente con la instancia de un componente (el componente que ha cambiado como resultado de la entrada del usuario y que especifica myHandler como controlador de cambios).
scroll1.setChangeHandler("myHandler"); function myHandler(component) { customListBox.setScrollPosition(component.getScrollPosition()); }

Si en el ejemplo anterior myHandler es una funcin ubicada en una lnea de tiempo tres niveles por encima de la lnea de tiempo del componente, la primera lnea del cdigo sera similar a la siguiente:
scroll1.setChangeHandler("myHandler", _parent._parent._parent);

Diccionario de ActionScript 219

En el cdigo siguiente se crea la funcin myHandler en una instancia de myObject (cuya clase es Object) y, a continuacin, se especifica myHandler como funcin de scroll1.
myObject = new Object(); myObject.myHandler = function(component){ customListBox.setScrollPosition(component.getScrollPosition()); } scroll1.setChangeHandler("myHandler", myObject);
Vase tambin

FScrollBar.getScrollPosition, FScrollBar.setScrollPosition, FScrollBar.setScrollProperties

FScrollBar.setEnabled
Disponibilidad

Flash Player 6.
Sintaxis

myScrollBar.setEnabled(activacin)
Parmetros

activacin

Valor booleano que especifica si la barra de desplazamiento est activada (true) o desactivada (false).

Valor devuelto

Ninguno.
Descripcin

Mtodo; determina si la barra de desplazamiento est activada (true) o desactivada (false). Si una barra de desplazamiento est desactivada, no aceptar la interaccin del usuario mediante el teclado o el ratn y aparecer de color ms claro (no estar disponible para el usuario). Llamar a este mtodo sin pasar ningn parmetro equivale a pasar el parmetro true.
Ejemplo

En el cdigo siguiente se desactiva la barra de desplazamiento scroll2.

scroll2.setEnabled(false);
Vase tambin

FScrollBar.getEnabled

FScrollBar.setHorizontal
Disponibilidad

Flash Player 6.
Sintaxis

myScrollBar.setHorizontal(desplazamientoHorizontal)
Parmetros

desplazamientoHorizontal Valor horizontal (true) o vertical (false).

Valor devuelto

booleano que especifica si la barra de desplazamiento es

Ninguno.

220

Descripcin

Mtodo; especifica si la barra de desplazamiento se aplica al objetivo horizontal (true) o verticalmente (false). El valor predeterminado de este mtodo es false.
Ejemplo

En el cdigo siguiente se especifica que la barra de desplazamiento scrollText se aplique horizontalmente a este objetivo.
scrollText.setHorizontal(true);
Vase tambin

FScrollBar.setSize

FScrollBar.setLargeScroll
Disponibilidad

Flash Player 6.
Sintaxis

myScrollBar.setLargeScroll(desplazamientoLargo)
Parmetros

desplazamientoLargo

Entero que especifica el nmero de posiciones de desplazamiento cuando el usuario hace clic una vez en la gua de desplazamiento. El valor predeterminado es el valor definido para tamaoPgina con FScrollBar.setScrollProperties.

Valor devuelto

Ninguno.
Descripcin

Mtodo; establece la propiedad desplazamientoLargo de la instancia de barra de desplazamiento en tiempo de ejecucin. Cuando el usuario hace clic una vez en la gua de desplazamiento, el cuadro de desplazamiento (deslizador) se desplaza la distancia especificada para una posicin desplazamientoLargo.
Ejemplo

En el cdigo siguiente se especifica que cuando el usuario haga clic en la gua de desplazamiento, scrollText1 se desplace 20 posiciones.
scrollText1.setLargeScroll(20);
Vase tambin

FScrollBar.setSmallScroll

FScrollBar.setScrollContent
Disponibilidad

Flash Player 6.
Sintaxis

myScrollBar.setScrollContent(destino)
Parmetros

destino

Referencia al campo de texto de la barra de desplazamiento.

Diccionario de ActionScript 221

Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica la instancia de campo de texto a la que se aplica la barra de desplazamiento. Esta instancia debe definirse en la misma lnea de tiempo y en el mismo nivel que la barra de desplazamiento. Si se llama a este mtodo, se sustituye el valor del parmetro de campo de texto de destino establecido durante la edicin. Si se pasa undefined para el parmetro destino, se elimina la asociacin de la barra de desplazamiento con el campo de texto.
Ejemplo

En el cdigo siguiente se asocia scrollText1 al campo de texto con el nombre de instancia textField1.
scrollText1.setScrollContent("textField1");

FScrollBar.setScrollPosition
Disponibilidad

Flash Player 6.
Sintaxis

myScrollBar.setScrollPosition(posicin)
Parmetros

posicin Entero comprendido entre los valores de posMn y posMx de la barra de desplazamiento. Consulte FScrollBar.setScrollProperties para obtener ms informacin sobre cmo establecer las propiedades posMn y posMx.
Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica la posicin del cuadro de desplazamiento (deslizador) de la barra de desplazamiento y ejecuta la funcin del controlador de cambios especificada con FScrollBar.setChangeHandler.
Ejemplo

En el cdigo siguiente se establece en 5 la posicin del cuadro de desplazamiento para scrollText1.

scrollText1.setScrollPosition(5);

Consulte FScrollBar.setChangeHandler para ver otro ejemplo en el que se utiliza este mtodo.
Vase tambin

FScrollBar.setChangeHandler, FScrollBar.setScrollProperties

222

FScrollBar.setScrollProperties
Disponibilidad

Flash Player 6.
Sintaxis

myScrollBar.setScrollProperties(tamaoPgina, posMn, posMx)

Parmetros

tamaoPgina

Entero que representa el nmero de posiciones que se visualiza en la vista de

pgina.
posMn posMx

Entero que representa la posicin mnima desplazada. Entero que representa la posicin mxima desplazada.

Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica las propiedades tamaoPgina, posMn y posMx de la barra de desplazamiento y establece el tamao adecuado del cuadro de desplazamiento (deslizador) de la barra de desplazamiento. Este mtodo est dirigido a usuarios avanzados y programadores que crean componentes personalizados; no puede utilizarse con barras de desplazamiento asociadas a campos de texto. Cuando una barra de desplazamiento se asocia a un campo de texto, las propiedades de desplazamiento se establecen automticamente de acuerdo con las propiedades del campo de texto; llamar a este mtodo hace que la barra de desplazamiento se trunque en el campo de texto.
Ejemplo

En el cdigo siguiente se establecen las propiedades tamaoPgina, posMn y posMx para una barra de desplazamiento asociada a un componente de cuadro de lista personalizado. El cuadro de lista tiene 5 filas visibles y un total de 20 elementos en la lista. Puesto que el cuadro tiene los ndices de 0 a 19, la propiedad posMx es el nmero total de elementos del cuadro menos el nmero de elementos visibles.
scrollBar.setScrollProperties(5, 0, 15);
Vase tambin

FScrollBar.setScrollPosition

FScrollBar.setScrollTarget
Disponibilidad

Flash Player 6.
Sintaxis

myScrollBar.setScrollTarget(destino)
Parmetros

destino

Referencia al campo de texto de la barra de desplazamiento.

Valor devuelto

Ninguno.

Diccionario de ActionScript 223

Descripcin

Mtodo; especifica la instancia de campo de texto a la que se aplica la barra de desplazamiento. Esta instancia debe definirse en la misma lnea de tiempo y en el mismo nivel que la barra de desplazamiento. Si se llama a este mtodo, se sustituye el valor del parmetro de campo de texto de destino establecido durante la edicin. Si se pasa undefined para el parmetro destino, se elimina la asociacin de la barra de desplazamiento con el campo de texto.
Ejemplo

En el cdigo siguiente se asocia scrollText1 al campo de texto con el nombre de instancia textField1.
scrollText1.setScrollTarget("textField1");

FScrollBar.setSize
Disponibilidad

Flash Player 6.
Sintaxis

myScrollBar.setSize(longitud)
Parmetros

longitud

Entero que especifica la longitud de la barra de desplazamiento en pxeles.

Valor devuelto

Ninguno.
Descripcin

Mtodo; establece la longitud, en pxeles, de la barra de desplazamiento en tiempo de ejecucin. No puede establecer la anchura de los componentes de la barra de desplazamiento. Si se llama a este mtodo, se sustituyen las especificaciones de escala y de tamao aplicadas durante la edicin. Este mtodo no debe utilizarse con barras de desplazamiento asociadas a campos de texto; la barra de desplazamiento se ajusta automticamente al tamao del campo de texto durante la edicin. Para obtener ms informacin, consulte el apartado Definicin del tamao de los componentes ScrollBar en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

En el cdigo siguiente se establece la longitud de scrollText1 en 200 pxeles.

scrollText1.setSize(200);

FScrollBar.setSmallScroll
Disponibilidad

Flash Player 6.
Sintaxis

myScrollBar.setSmallScroll(desplazamientoCorto)
Parmetros

desplazamientoCorto

Entero que especifica el nmero de posiciones de desplazamiento cuando el usuario hace clic en la flecha de desplazamiento. El valor predeterminado es 1.

224

Valor devuelto

Ninguno.
Descripcin

Mtodo; establece la propiedad desplazamientoCorto de la instancia de barra de desplazamiento en tiempo de ejecucin, si el campo de texto est resaltado. Cuando el usuario hace clic en las flechas de la barra de desplazamiento o cuando pulsa una tecla de flecha del teclado, el cuadro de desplazamiento (deslizador) se desplaza en una posicin de desplazamientoCorto.
Ejemplo

En el cdigo siguiente se especifica que cuando el usuario haga clic en una flecha de desplazamiento, scrollText1 se desplace 5 posiciones.
scrollText1.setSmallScroll(5);
Vase tambin

FScrollBar.setLargeScroll

FScrollBar.setStyleProperty
Disponibilidad

Flash Player 6.
Sintaxis

myScrollBar.setStyleProperty(propiedadEstilo, valor)
Parmetros

propiedadEstilo valor

Cadena que especifica una propiedad del objeto FStyleFormat.

Valor que se establece para la propiedad.

Valor devuelto

Ninguno.
Descripcin

Mtodo; establece una propiedad FStyleFormat para una determinada instancia de barra de desplazamiento. Si se llama a este mtodo para especificar una propiedad, se sustituye el valor de esta propiedad en el formato de estilo asignado al componente. Si se pasa undefined como valor de una propiedad, se eliminan todos los estilos de la misma. Para establecer FStyleFormat para varios componentes, cree un formato de estilo personalizado. Para obtener ms informacin sobre la creacin de formatos de estilo personalizados, consulte el apartado Personalizacin de los colores y el texto de los componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

En el cdigo siguiente se establece la propiedad de la flecha de scrollBar1 en 0x000000 (negro).

scrollBar1.setStyleProperty("arrow", 0x000000);
Vase tambin

FStyleFormat (objeto)

Diccionario de ActionScript 225

FScrollPane (componente)
El componente ScrollPane del entorno de edicin de Flash proporciona funciones de arrastrar y soltar para agregar paneles de desplazamiento para visualizar clips de pelcula en documentos de Flash, adems de proporcionar una interfaz de usuario para establecer parmetros bsicos. Los mtodos del componente FScrollPane permiten controlar los paneles de desplazamiento en tiempo de ejecucin: puede crear paneles de desplazamiento, controlar paneles de desplazamiento creados durante la edicin, definir o sustituir parmetros bsicos y definir opciones adicionales en tiempo de ejecucin. No es necesario que utilice un constructor para acceder a los mtodos de los componentes. El componente ScrollPane proporciona barras de desplazamiento verticales y horizontales para visualizar clips de pelcula de grandes dimensiones sin ocupar demasiado espacio del escenario. Se incorporan controles estndar de ratn y teclado.
Nota: el componente ScrollPane slo muestra clips de pelcula; para agregar barras de desplazamiento en campos de introduccin de texto y dinmicos, utilice el componente ScrollBar. El componente ScrollPane no puede mostrar ningn contenido que utilice fuentes de dispositivo.

Los mtodos del componente no realizan comprobaciones de errores de tipo, como ocurre en otros objetos y acciones nativos de ActionScript, por lo que se recomienda validar los parmetros antes de pasarlos a los mtodos. El componente ScrollPane se admite en Flash Player 6 y en versiones posteriores de Flash Player. Para obtener ms informacin sobre la utilizacin del componente ScrollPane, la definicin de parmetros durante la edicin y la modificacin del color y el aspecto de los componentes, consulte los apartados Personalizacin de los colores y el texto de los componentes y Personalizacin de aspectos de componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.

226

Resumen de mtodos del componente FScrollPane

Mtodo FScrollPane.getPaneHeight FScrollPane.getPaneWidth FScrollPane.getScrollContent FScrollPane.getScrollPosition FScrollPane.loadScrollContent FScrollPane.refreshPane FScrollPane.registerSkinElement Descripcin Devuelve la altura del panel de desplazamiento. Devuelve la anchura del panel de desplazamiento. Devuelve una instancia del contenido que se visualiza en el panel de desplazamiento. Devuelve las coordenadas x e y de la posicin de desplazamiento actual. Carga un archivo SWF o JPEG en el panel de desplazamiento. Cambia el tamao de las barras de desplazamiento del panel de desplazamiento cuando cambia el tamao del contenido. Registra un elemento de aspecto en una propiedad definida para un aspecto en la capa Read Me (Lame) situada en el fotograma 1 de un clip de pelcula de aspecto de la biblioteca. Establece que el contenido del panel de desplazamiento puede arrastrarse. Establece el estilo de desplazamiento horizontal para el panel de desplazamiento. Establece un clip de pelcula como objetivo del panel de desplazamiento. Hace que el panel se desplace a las coordenadas x, y especificadas. Establece la anchura y la altura del panel de desplazamiento, en pxeles. Establece una sola propiedad de estilo para un componente. Establece el estilo de desplazamiento vertical del panel de desplazamiento.

FScrollPane.setDragContent FScrollPane.setHScroll FScrollPane.setScrollContent FScrollPane.setScrollPosition FScrollPane.setSize FScrollPane.setStyleProperty FScrollPane.setVScroll

FScrollPane.getPaneHeight
Disponibilidad

Flash Player 6.
Sintaxis

myScrollPane.getPaneHeight()
Parmetros

Ninguno.
Valor devuelto

Entero que especifica la altura de la vista del panel de desplazamiento.

Diccionario de ActionScript 227

Descripcin

Mtodo; devuelve la altura de la vista del panel de desplazamiento. Slo puede utilizar este mtodo para obtener la altura de un panel de desplazamiento cuyo tamao se ha definido con FScrollPane.setSize. Este mtodo funciona slo si se ha definido el tamao del panel de desplazamiento con FScrollPane.setSize y no si lo ha definido mediante las propiedades _width y _height.
Ejemplo

En el cdigo siguiente se obtiene la altura y la anchura del panel de desplazamiento display1 y se utilizan los valores devueltos para cambiar el tamao del panel de desplazamiento con FScrollPane.setSize.
var h = display1.getPaneHeight(); var w = display1.getPaneWidth(); display1.setSize(w+10, h+10);
Vase tambin

FScrollPane.getPaneWidth, FScrollPane.setSize

FScrollPane.getPaneWidth
Disponibilidad

Flash Player 6.
Sintaxis

myScrollPane.getPaneWidth()
Parmetros

Ninguno.
Valor devuelto

Entero que especifica la anchura de la vista del panel de desplazamiento.

Descripcin

Mtodo; devuelve la anchura de la vista del panel de desplazamiento. Slo puede utilizar este mtodo para obtener la anchura de un panel de desplazamiento cuyo tamao se ha definido con FScrollPane.setSize. Este mtodo funciona slo si se ha definido el tamao del panel de desplazamiento con FScrollPane.setSize y no si lo ha definido mediante las propiedades _width y _height.
Ejemplo

En el cdigo siguiente se obtiene la altura y la anchura del panel de desplazamiento display1 y se utilizan los valores devueltos para cambiar el tamao del panel de desplazamiento con FScrollPane.setSize.
var h = display1.getPaneHeight(); var w = disply1.getPaneWidth(); display1.setSize(w+10, h+10);
Vase tambin

FScrollPane.getPaneHeight, FScrollPane.setSize

228

FScrollPane.getScrollContent
Disponibilidad

Flash Player 6.
Sintaxis

myScrollPane.getScrollContent()
Parmetros

Ninguno.
Valor devuelto

Una referencia al clip de pelcula en el panel de desplazamiento.

Descripcin

Mtodo; devuelve una instancia del contenido visualizado en el panel de desplazamiento.

Ejemplo

En el cdigo siguiente se recupera una referencia al clip de pelcula dentro de display1, se almacena en una variable y, a continuacin, se indica al clip de pelcula que pase al fotograma 4.
var content = display1.getScrollContent(); content.gotoAndStop(4);
Vase tambin

FScrollPane.setScrollContent

FScrollPane.getScrollPosition
Disponibilidad

Flash Player 6.
Sintaxis

myScrollPane.getScrollPosition()
Parmetros

Ninguno.
Valor devuelto

Un objeto.
Descripcin

Mtodo; devuelve un objeto con los campos .x o .y que especifica la posicin de desplazamiento vertical u horizontal actual de la vista del panel de desplazamiento.
Ejemplo

En el cdigo siguiente se devuelve la posicin de desplazamiento actual del panel de desplazamiento scroll2 en la ventana Salida.
trace(scroll2.getScrollPosition());
Vase tambin

FScrollPane.setScrollPosition

Diccionario de ActionScript 229

FScrollPane.loadScrollContent
Disponibilidad

Flash Player 6.
Sintaxis

myScrollPane.loadScrollContent(URL [, nombreFuncin, ubicacin])

Parmetros

URL

Cadena que especifica la direccin URL de un archivo SWF o JPEG que debe cargarse en el panel de desplazamiento.

nombreFuncin Cadena que especifica el nombre de la funcin del controlador que debe ejecutarse cuando se carga el contenido del panel de desplazamiento. Si no se especifica el parmetro ubicacin, esta funcin debe encontrarse en la misma lnea de tiempo que la instancia del componente. ubicacin Referencia de ruta a un objeto de datos, clip de pelcula o lnea de tiempo que contiene la funcin especificada. Este parmetro es opcional y tiene como valor predeterminado la lnea de tiempo principal del componente.
Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica la direccin URL de un archivo SWF o JPEG que se visualizar en el panel de desplazamiento. Los parmetros opcionales nombreFuncin y ubicacin permiten especificar una funcin de controlador de cambios a la que se debe llamar cuando se carga el contenido. La direccin URL debe estar en el mismo subdominio que el URL donde reside actualmente la pelcula Flash. Para utilizar archivos SWF o JPEG en Flash Player, o probar la pelcula en el entorno de edicin de Flash, debe almacenar todos los archivos SWF o JPEG en la misma carpeta y los nombres de archivo no pueden incluir especificaciones sobre carpetas o unidades de disco. Si se llama a este mtodo, se sustituye el valor del parmetro de desplazamiento de contenido establecido durante la edicin. Consulte FScrollBar.setChangeHandler para obtener ms informacin y ejemplos sobre la utilizacin de funciones del controlador de cambios.
Ejemplo

En el cdigo siguiente, display1 se carga en un archivo JPEG ubicado en un servidor.

display1.loadScrollContent("http://www.YourWebServer.com/Nice.jpg");

En el cdigo siguiente se carga un archivo JPEG ubicado en un servidor y se especifica la funcin de controlador de cambios load de la lnea de tiempo situada dos niveles por encima del componente display1.
display1.loadScrollContent("http://www.YourWebServer.com/Nice.jpg" , "load" , _parent._parent); function load(component){ //Se carga el contenido component.setScrollPostion(10,10); }

230

Vase tambin

FScrollPane.getPaneHeight, FScrollPane.setScrollContent

FScrollPane.refreshPane
Disponibilidad

Flash Player 6.
Sintaxis

myScrollPane.refreshPane()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; cambia el tamao de las barras de desplazamiento del panel de desplazamiento cuando cambia el contenido del panel de desplazamiento. Puede llamar a este mtodo si cambia el tamao del contenido de la ventana del panel de desplazamiento mediante _width o _height.
Ejemplo

En el cdigo siguiente se actualizan las barras de desplazamiento de moviePane despus de aumentar el tamao del clip de pelcula myContent en el panel de desplazamiento.
var myContent = moviePane.getScrollContent(); myContent._width = 400; moviePane.refreshPane();
Vase tambin

FScrollPane.getScrollContent

FScrollPane.registerSkinElement
Disponibilidad

Flash Player 6.
Sintaxis

myScrollPane.registerSkinElement(elemento, propiedadEstilo)
Parmetros

elemento

Instancia de clip de pelcula. Nombre de una propiedad de FStyleFormat.

propiedadEstilo
Valor devuelto

Ninguno.
Descripcin

Mtodo; registra un elemento de aspecto en una propiedad de estilo. Los elementos de aspecto se registran en las propiedades del primer fotograma de la capa Read Me (Lame) de cada aspecto de la biblioteca.

Diccionario de ActionScript 231

Los componentes estn formados de aspectos, que a su vez se componen de varios elementos de aspecto, cada uno de los cuales puede registrarse en una propiedad del objeto FStyleFormat. El formato de estilo asignado a un componente asigna valores a estas propiedades. De forma predeterminada se asigna el objeto globalStyleFormat, a todos los componentes de la interfaz de usuario de Flash, que es una instancia del objeto FStyleFormat. Utilice este mtodo para registrar propiedades y elementos de aspecto personalizados en aspectos de componentes de la interfaz de usuario de Flash o personalizados editando el cdigo del primer fotograma de la capa Read Me (Lame) de un aspecto de la biblioteca. El componente FScrollPane utiliza los aspectos de la carpeta FScrollBar Skins y el aspecto FLabel de la carpeta Global Skins una vez que ha agregado el componente al documento de Flash. La edicin de los aspectos de la carpeta FScrollBar Skins afecta a todos los componentes que utilizan barras de desplazamiento (ComboBox, ListBox, ScrollBar y ScrollPane). Para obtener ms informacin, consulte el apartado Personalizacin de aspectos de componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

En el cdigo siguiente se registra el elemento de aspecto personalizado NewArrow_mc en la propiedad arrow del primer fotograma de la capa Read Me (Lame) del aspecto fsb_downArrow en la carpeta FScrollBar Skins de la biblioteca.
Pane1.registerSkinElement(NewArrow_mc, "arrow");
Vase tambin

FStyleFormat (objeto)

FScrollPane.setDragContent
Disponibilidad

Flash Player 6.
Sintaxis

myScrollPane.setDragContent(arrastrar)
Parmetros

arrastrar

Valor booleano; true especifica que el usuario puede cambiar la vista arrastrando el contenido en el panel de desplazamiento; false especifica que el usuario slo puede cambiar la vista mediante las barras de desplazamiento.

Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica si el usuario puede cambiar la vista del panel de desplazamiento arrastrando el contenido adems de utilizar las barras de desplazamiento. Si se llama a este mtodo, se sustituye el valor del parmetro para arrastar contenido establecido durante la edicin.
Ejemplo

En el ejemplo siguiente se especifica que el contenido del panel de desplazamiento display1 puede arrastrarse.
display1.setDragContent(true);

232

FScrollPane.setHScroll
Disponibilidad

Flash Player 6.
Sintaxis

myScrollPane.setHScroll(visualizacin)
Parmetros

visualizacin Valor booleano que especifica si la barra de desplazamiento se visualiza siempre (true) o nunca (false), o bien una cadena que especifica que la barra de desplazamiento se visualiza slo cuando es necesario ("auto").

Si se llama a este mtodo, se sustituye el valor del parmetro de desplazamiento horizontal establecido durante la edicin.
Valor devuelto

Ninguno.
Descripcin

Mtodo; determina si una barra de desplazamiento horizontal se visualiza siempre (true), nunca (false), o si slo se visualiza cuando es necesario ("auto"). El valor predeterminado es auto.
Ejemplo

En el cdigo siguiente se oculta la barra de desplazamiento horizontal para display1.

display1.setHScroll(false);
Vase tambin

FScrollPane.setVScroll

FScrollPane.setScrollContent
Disponibilidad

Flash Player 6.
Sintaxis

myScrollPane.setScrollContent(destino)
Parmetros

destino Cadena de texto que especifica el identificador de vnculo de smbolos de un clip de pelcula en la biblioteca o en una instancia de un clip de pelcula.
Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica un clip de pelcula que debe visualizarse en el panel de desplazamiento. Si se llama a este mtodo, se sustituye el valor del parmetro de desplazamiento por el contenido establecido durante la edicin.

Diccionario de ActionScript 233

Ejemplo

En el ejemplo siguiente se especifica la instancia de clip de pelcula BetsyTacy como destino de display1.
display1.setScrollContent("BetsyTacy");
Vase tambin

FScrollPane.getPaneHeight, FScrollPane.loadScrollContent

FScrollPane.setScrollPosition
Disponibilidad

Flash Player 6.
Sintaxis

myScrollPane.setScrollPosition(x, y)
Parmetros

x y

Entero que especifica el nmero de pxeles (a partir de 0) de desplazamiento hacia la derecha. Entero que especifica el nmero de pxeles (a partir de 0) de desplazamiento hacia abajo.

Valor devuelto

Ninguno.
Descripcin

Mtodo; establece la posicin de desplazamiento para las coordenadas x, y especificadas.

Ejemplo

En el ejemplo siguiente, el contenido de display1 se desplaza 14 pxeles hacia abajo y 40 pxeles hacia la derecha.
display1.setScrollPosition(14,40);
Vase tambin

FScrollPane.getScrollPosition

FScrollPane.setSize
Disponibilidad

Flash Player 6.
Sintaxis

myScrollPane.setSize(anchura, altura)
Parmetros

anchura altura

Entero que especifica la anchura del panel de desplazamiento, en pxeles. Entero que especifica la altura del panel de desplazamiento, en pxeles.

Valor devuelto

Ninguno.
Descripcin

Mtodo; establece la anchura y la altura, en pxeles, de la vista del panel de desplazamiento en tiempo de ejecucin. Si se llama a este mtodo, se sustituye el tamao aplicado durante la edicin.

234

Para obtener ms informacin, consulte el apartado Personalizacin de aspectos de componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

En el cdigo siguiente se establecen la anchura y la altura de display1 en 500 x 300 pxeles.

display1.setSize(500, 300);
Vase tambin

FScrollPane.getPaneHeight, FScrollPane.getPaneWidth

FScrollPane.setStyleProperty
Disponibilidad

Flash Player 6.
Sintaxis

myScrollPane.setStyleProperty(propiedadEstilo, valor)
Parmetros

propiedadEstilo valor

Cadena que especifica una propiedad del objeto FStyleFormat.

Valor que se establece para la propiedad.

Valor devuelto

Ninguno.
Descripcin

Mtodo; establece una propiedad de formato FStyleFormat para una determinada instancia de panel de desplazamiento. Si se llama a este mtodo para especificar una propiedad, se sustituye el valor de esta propiedad en el formato de estilo asignado al componente. Si se pasa undefined como valor de una propiedad, se eliminan todos los estilos de la misma. Para establecer FStyleFormat para varios componentes, cree un formato de estilo personalizado. Para obtener ms informacin sobre la creacin de formatos de estilo personalizados, consulte el apartado Personalizacin de los colores y el texto de los componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

En el cdigo siguiente se establece la propiedad arrow de ScrollPane2 en 0x000000 (negro).

ScrollPane2.setStyleProperty("arrow", 0x000000);
Vase tambin

FStyleFormat (objeto)

Diccionario de ActionScript 235

FScrollPane.setVScroll
Disponibilidad

Flash Player 6.
Sintaxis

myScrollBar.setVScroll(visualizacin)
Parmetros

visualizacin Valor booleano que especifica si una barra de desplazamiento vertical se visualiza siempre (true) o nunca (false), o bien una cadena que especifica que la barra de desplazamiento aparece slo cuando es necesario ("auto").
Valor devuelto

Ninguno.
Descripcin

Mtodo; determina si una barra de desplazamiento vertical se visualiza siempre (true), nunca (false) o slo cuando es necesario ("auto"). El valor predeterminado es auto. Si se llama a este mtodo, se sustituye el valor del parmetro de desplazamiento vertical establecido durante la edicin.
Ejemplo

En el cdigo siguiente se especifica que la barra de desplazamiento vertical de display1 se visualice siempre.
display1.setVScroll(true);
Vase tambin

FScrollPane.setHScroll

FStyleFormat (objeto)
El objeto FStyleFormat permite establecer o cambiar propiedades del formato de estilo global asignado a todos los componentes de la interfaz de usuario Flash de forma predeterminada, o crear nuevos formatos de estilo personalizados para utilizarlos con componentes de la interfaz de usuario Flash o componentes personalizados creados o de otras fuentes. El formato de estilo global, u objeto globalStyleFormat, es una instancia del objeto FStyleFormat que define las propiedades de color y formato del texto utilizadas para visualizar todos los componentes de la interfaz de usuario Flash. Para crear un nuevo formato de estilo personalizado, cree una nueva instancia del objeto FStyleFormat mediante el constructor new FStyleFormat(), establezca las propiedades de FStyleFormat que desee incluir en el formato de estilo y, a continuacin, utilice el mtodo FStyleFormat.addListener para registrar instancias de componente en el nuevo formato de estilo. Una instancia de componente puede detectar ms de un formato de estilo, pero slo puede tomar el valor de un formato de estilo para una propiedad especfica. Si agrega un componente como detector a un formato de estilo, se utilizar el nuevo formato de estilo para las propiedades especificadas en el formato y se usar el formato de estilo anterior para las dems propiedades. No es necesario utilizar el constructor FStyleFormat para agregar o eliminar detectores ni establecer o modificar propiedades en el formato de estilo global, puesto que ya habr un objeto globalStyleFormat cuando se coloque un componente de la interfaz de usuario Flash en el escenario.

236

Puede establecer cualquiera de las propiedades de FStyleFormat para una sola instancia de un componente mediante el mtodo setStyleProperty disponible en todos los componentes de la interfaz de usuario Flash. Si utiliza setStyleProperty puede establecer una propiedad para un componente sin crear una instancia del objeto FStyleFormat. Si utiliza setStyleProperty, se sustituir el valor de una propiedad de formato de estilo especfico asignada al componente sin cambiar los dems valores de propiedad. Para obtener ms informacin, consulte las entradas de setStyleProperty para los diferentes componentes. Cuando asigne un valor de color a una propiedad FStyleFormat, especifique un color RGB con el formato 0xRRGGBB. Para obtener ms informacin sobre el formato de estilo global y la creacin de formatos de estilo personalizados, consulte el apartado Personalizacin de los colores y el texto de los componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash. Resumen de mtodos del objeto FStyleFormat
Mtodo FStyleFormat.addListener FStyleFormat.applyChanges FStyleFormat.removeListener Descripcin Registra un componente en un formato de estilo. Aplica los cambios realizados en valores de propiedades de un formato de estilo. Elimina un componente como detector en un formato de estilo.

Resumen de propiedades del objeto FStyleFormat

En las tablas siguientes se muestran los resmenes de propiedades del objeto FStyleFormat.
Propiedad FStyleFormat.arrow FStyleFormat.background FStyleFormat.backgroundDisabled FStyleFormat.check FStyleFormat.darkshadow FStyleFormat.face FStyleFormat.foregroundDisabled FStyleFormat.highlight FStyleFormat.highlight3D FStyleFormat.radioDot FStyleFormat.scrollTrack FStyleFormat.selection FStyleFormat.selectionDisabled Descripcin Color de la flecha utilizada en barras de desplazamiento y listas desplegables. Color de la parte del fondo de un componente. Color de la parte del fondo de un componente desactivado. Color de la marca de verificacin en una casilla de verificacin seleccionada. Color del borde interior o la parte ms oscura del sombreado de un componente. Color principal del componente. Color de primer plano de un componente desactivado. Color del borde interior o la parte ms oscura del sombreado de un componente cuando est seleccionado. Color del borde exterior o parte ms clara del sombreado de un componente cuando est seleccionado. Color del punto en un botn de opcin seleccionado. Color de la gua de desplazamiento en una barra de desplazamiento. Color de la barra de seleccin cuando resalta un elemento de lista en un componente. Color de la barra de seleccin cuando resalta un elemento de lista en un componente desactivado.

Diccionario de ActionScript 237

Propiedad FStyleFormat.selectionUnfocused FStyleFormat.shadow FStyleFormat.textAlign FStyleFormat.textBold FStyleFormat.textColor FStyleFormat.textDisabled FStyleFormat.textFont FStyleFormat.textIndent FStyleFormat.textItalic FStyleFormat.textLeftMargin FStyleFormat.textRightMargin FStyleFormat.textSelected FStyleFormat.textSize FStyleFormat.textUnderline

Descripcin Color de la barra de seleccin cuando el componente no est resaltado mediante el teclado. Color del borde exterior o parte ms clara del sombreado de un componente. Alineacin (izquierda, derecha o centro) del texto que se visualiza en un componente. Especifica si el texto est en negrita (true) o no (false). Color predeterminado del texto en todos los componentes asignados al formato de estilo. Color del texto en un componente desactivado. Nombre de la fuente en la que se ve el texto. Sangra del texto desde el margen izquierdo al primer carcter del texto, en pxeles. Especifica si el texto es en cursiva (true) o no (false). Margen izquierdo del prrafo de texto, en pxeles. Margen derecho del prrafo de texto, en pxeles. Color de un elemento de lista seleccionado en un componente. Tamao del texto, en puntos. Especifica si el texto est subrayado (true) o no (false).

Constructor del objeto FStyleFormat

Disponibilidad

Flash Player 6.
Sintaxis

new FStyleFormat()
Parmetros

Ninguno.
Valor devuelto

Una instancia del objeto FStyleFormat.

Descripcin

Mtodo; crea un nuevo objeto FStyleFormat. Puede crear nuevos objetos FStyleFormat para definir propiedades de texto y color para formatos de estilo personalizados utilizados con componentes personalizados o con los componentes de la interfaz de usuario Flash. Todos los componentes de la interfaz de usuario Flash se asignan de forma predeterminada a globalStyleFormat, que es una instancia del objeto FStyleFormat. No es necesario que cree una nueva instancia del objeto FStyleFormat para cambiar propiedades en el formato de estilo global, puesto que ya existe. Tambin puede utilizar setStyleProperty para cambiar propiedades para instancias de componente especficas sin la ayuda de un constructor.

238

Para obtener ms informacin, consulte el mtodo setStyleProperty disponible para cada componente (FCheckBox.setStyleProperty, FComboBox.setStyleProperty, etc.). Consulte tambin el apartado Personalizacin de los colores y el texto de los componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

En el ejemplo siguiente se crea el nuevo formato de estilo formStyleFormat.

formStyleFormat = new StyleFormat();

FStyleFormat.addListener
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.addListener(componente1 [, componente2, ...componenteN])

Parmetros

componente1 ... componenteN

Valor devuelto

Instancias de componente que se registran en myStyleFormat.

Ninguno.
Descripcin

Mtodo; registra los componentes especificados en myStyleFormat. Utilice este mtodo para registrar instancias de componentes de la interfaz de usuario Flash o componentes personalizados en un formato de estilo personalizado. Tambin puede utilizar este mtodo con la sintaxis siguiente para registrar un componente personalizado en el formato de estilo global que utilizan todos los componentes de interfaz de usuario Flash de forma predeterminada:
globalStyleFormat.addListener(componentePersonalizado);
Ejemplo

En el cdigo siguiente se registra formStyleFormat en los componentes myListBox, myComboBox y myScrollBar.

formStyleFormat.addListener(myListBox, myComboBox, myScrollBar);
Vase tambin

FStyleFormat.applyChanges, FStyleFormat.removeListener

FStyleFormat.applyChanges
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.applyChanges([nombrePropiedad1, ...nombrePropiedadN]) myStyleFormat.applyChanges()

Parmetros

nombrePropiedad1...nombrePropiedadN Serie de cadenas de texto que especifica las propiedades que deben actualizarse para todos los componentes asignados a myStyleFormat.

Diccionario de ActionScript 239

Valor devuelto

Ninguno.
Descripcin

Mtodo; actualiza la instancia de objeto de formato de estilo especificado y aplica los cambios a todos los componentes asignados al formato. Debe llamar a este mtodo cuando agregue o elimine detectores y cuando defina o modifique propiedades. Cuando actualice propiedades, se recomienda que utilice el primer modelo de sintaxis para actualizar slo las propiedades para las que especifica un nuevo valor. Sintaxis 1: actualiza slo las propiedades especificadas en los parmetros. Sintaxis 2: actualiza toda la informacin del formato de estilo (es decir, los componentes asignados y las propiedades), hayan cambiado o no.
Ejemplo

Sintaxis 1: en el ejemplo siguiente se actualizan las propiedades arrow y background, pero no las propiedades check y highlight, de formStyleFormat.
formStyleFormat.arrow = 0x00ffaa; formStyleFormat.background = 0xaabbcc; formStyleFormat.check = 0x000000; formStyleFormat.highlight = 0xffffff; formStyleFormat.applyChanges("arrow", "background");

Sintaxis 2: en el ejemplo siguiente se actualizan todas las propiedades de formStyleFormat: arrow, background, check y highlight.
formStyleFormat.arrow = 0x00ffaa; formStyleFormat.background = 0xaabbcc; formStyleFormat.check = 0x000000; formStyleFormat.highlight = 0xffffff; formStyleFormat.applyChanges();
Vase tambin

FStyleFormat.addListener, FStyleFormat.removeListener

FStyleFormat.arrow
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.arrow
Descripcin

Propiedad; el valor de color RGB de la propiedad arrow utilizada en barras de desplazamiento y listas desplegables en componentes tales como barras de desplazamiento, cuadros de lista y cuadros combinados. El valor de color debe tener el formato 0xRRGGBB. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se asigna el valor 0x800080 a la propiedad arrow de formStyleFormat, lo que generar una flecha de color violeta.
formStyleFormat.arrow = 0x800080;

240

FStyleFormat.background
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.background
Descripcin

Propiedad; el valor del color RGB de la parte del fondo de un componente. Por ejemplo, en un botn de opcin o en una casilla de verificacin, la parte del fondo es el espacio dentro del rea de seleccin; en un cuadro de lista o en un cuadro combinado, la parte del fondo ser el rea de visualizacin. El valor de color debe tener el formato 0xRRGGBB. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se asigna el valor 0xFFE4E1 a la propiedad background de formStyleFormat, lo que generar un fondo rosa claro cuando el componente est activado.
formStyleFormat.background = 0xFFE4E1;
Vase tambin

FStyleFormat.face

FStyleFormat.backgroundDisabled
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.backgroundDisabled
Descripcin

Propiedad; el valor del color RGB de la parte del fondo de un componente desactivado. El color de fondo de los elementos desactivados de la interfaz de usuario suele ser gris claro. El valor de color debe tener el formato 0xRRGGBB. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se asigna el valor 0x808080 a la propiedad backgroundDisabled de formStyleFormat, lo que generar un fondo de color gris cuando el componente est desactivado.
formStyleFormat.backgroundDisabled = 0x808080;
Vase tambin

FStyleFormat.foregroundDisabled

Diccionario de ActionScript 241

FStyleFormat.check
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.check
Descripcin

Propiedad; el valor de color RGB de la marca de seleccin en un cuadro de seleccin seleccionado. El valor de color debe tener el formato 0xRRGGBB. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se asigna el valor 0x228B22 a la propiedad check de formStyleFormat, lo que generar una flecha de color verde oscuro.
formStyleFormat.check = 0x228B22;

FStyleFormat.darkshadow
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.darkshadow
Descripcin

Propiedad; el valor de color RGB del borde interior o la parte ms oscura del sombreado de un componente; por ejemplo, el borde interior del crculo de un botn de opcin deseleccionado o una casilla de verificacin deseleccionada. El valor de color debe tener el formato 0xRRGGBB. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se asigna el valor 0x0000CD a la propiedad darkshadow de formStyleFormat, lo que generar un borde interior de color azul.
formStyleFormat.darkshadow = 0x0000CD;
Vase tambin

FStyleFormat.highlight, FStyleFormat.shadow

242

FStyleFormat.face
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.face
Descripcin

Propiedad; el valor de color RGB del color principal de un componente, como por ejemplo, el gris utilizado para el componente PushButton o ScrollBar. El valor de color debe tener el formato 0xRRGGBB. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se asigna el valor 0x32CD32 a la propiedad face de formStyleFormat, lo que generar botones de comando y barras de desplazamiento de color verde lima.
formStyleFormat.face = 0x32CD32;

FStyleFormat.foregroundDisabled
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.foregroundDisabled
Descripcin

Propiedad; el valor del color RGB del fondo de un componente desactivado. El color de fondo de los elementos desactivados de la interfaz de usuario suele ser gris. El valor de color debe tener el formato 0xRRGGBB. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se asigna el valor 0x708090 a la propiedad foregroundDisabled de formStyleFormat, lo que generar un fondo gris para los componentes desactivados.
formStyleFormat.foregroundDisabled = 0x708090;
Vase tambin

FStyleFormat.backgroundDisabled

Diccionario de ActionScript 243

FStyleFormat.highlight
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.highlight
Descripcin

Propiedad; el valor de color RGB del borde interior o la parte ms oscura del sombreado de un componente cuando se selecciona, como por ejemplo, borde interior del crculo de un botn de opcin o de una casilla de verificacin. El valor de color debe tener el formato 0xRRGGBB. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se asigna el valor 0xFF00FF a la propiedad highlight de formStyleFormat, lo que generar un borde interior de color amarillo intenso cuando el componente est seleccionado.
formStyleFormat.highlight = 0xFF00FF;
Vase tambin

FStyleFormat.darkshadow

FStyleFormat.highlight3D
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.highlight3D
Descripcin

Propiedad; el valor de color RGB del borde exterior o la parte ms clara del sombreado de un componente cuando est seleccionado; por ejemplo, el borde exterior del crculo de un botn de opcin o de una casilla de verificacin. El valor de color debe tener el formato 0xRRGGBB. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se asigna el valor 0x40E0D0 a la propiedad highlight3D de formStyleFormat, lo que generar un borde exterior de color turquesa intenso cuando el componente est seleccionado.
formStyleFormat.highlight3D = 0x40E0D0;
Vase tambin

FStyleFormat.shadow

244

FStyleFormat.radioDot
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.radioDot
Descripcin

Propiedad; el valor de color RGB del punto de seleccin de un botn de opcin en un componente. El valor de color debe tener el formato 0xRRGGBB. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se asigna el valor 0xFF12AC a la propiedad radioDot de formStyleFormat, lo que generar un punto de seleccin de color rosa.
formStyleFormat.radioDot = 0xFF12AC;

FStyleFormat.removeListener
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.removeListener(componente)
Parmetros

componente
Descripcin

Componente que se eliminar del formato de estilo.

Mtodo; elimina un componente asignado al formato de estilo.

Si elimina un componente de interfaz de usuario Flash como detector del formato de estilo
global y no lo asigna (lo agrega como detector) a un formato de estilo personalizado, los clips de pelcula del elemento de aspecto se visualizarn como si se hubieran editado originalmente con un diseador de componentes sin un valor de propiedad asignado.

Si elimina un componente de interfaz de usuario Flash como detector del formato de estilo
personalizado, el componente ya no utilizar los valores de propiedad del formato de estilo personalizado y, en su lugar, utilizar los valores especificados en las propiedades del objeto de formato de estilo global.

Si elimina un componente personalizado como detector de un formato de estilo personalizado

sin agregarlo a un nuevo formato de estilo personalizado, el componente utilizar los valores establecidos para las propiedades en el formato de estilo global siempre que sea posible; de lo contrario, mostrar los elementos de aspecto sin ningn valor de propiedad.
Ejemplo

En el ejemplo siguiente se elimina el componente check1 de globalStyleFormat.

globalStyleFormat.removeListener(check1);
Vase tambin

FStyleFormat.addListener, FStyleFormat.applyChanges

Diccionario de ActionScript 245

FStyleFormat.scrollTrack
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.scrollTrack
Descripcin

Propiedad; valor de color RGB de la parte de gua de desplazamiento de una barra de desplazamiento. Los componentes ScrollPane, ListBox y ComboBox utilizan el componente ScrollBar. Si se cambia el valor de la propiedad scrollTrack en el formato de estilo global, se cambiar el color de la gua de desplazamiento en todos los componentes que utilicen barras de desplazamiento. El valor de color debe tener el formato 0xRRGGBB. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se asigna el valor 0xA0522D a la propiedad scrollTrack de formStyleFormat, lo que generar una gua de desplazamiento de color castao.
formStyleFormat.scrollTrack = 0xA0522D;

FStyleFormat.selection
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.selection
Descripcin

Propiedad; el valor de color RGB de la barra utilizada para resaltar el elemento seleccionado en una lista del componente. Esta propiedad se combina con la propiedad FStyleFormat.textSelected para mostrar elementos seleccionados. Debe coordinar los colores para facilitar la lectura. Por ejemplo, el formato de estilo global asigna un valor de color azul a la propiedad selection utilizada para visualizar la barra de seleccin de los componentes ListBox y ComboBox, y asigna un valor de color blanco a la propiedad textSelected; esta combinacin de color permite al usuario visualizar fcilmente el texto seleccionado. El valor de color debe tener el formato 0xRRGGBB. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se asigna el valor 0x87CEEB a la propiedad selection de formStyleFormat, lo que generar una barra de seleccin de color celeste.
formStyleFormat.selection = 0x87CEEB;
Vase tambin

FStyleFormat.textSelected

246

FStyleFormat.selectionDisabled
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.selectionDisabled
Descripcin

Propiedad; el valor de color RGB de la barra de seleccin utilizada para resaltar un elemento de lista en un componente desactivado. El valor de color debe tener el formato 0xRRGGBB. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se asigna el valor 0x708090 a la propiedad selectionDisabled de formStyleFormat, lo que generar una barra de seleccin de color gris pizarra cuando el componente est desactivado.
formStyleFormat.selectionDisabled = 0x708090;
Vase tambin

FStyleFormat.selection

FStyleFormat.selectionUnfocused
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.selectionUnfocused
Descripcin

Propiedad; el valor de color RGB de la barra de seleccin (resaltado) en la lista de un componente cuando el componente no se resalta mediante el teclado. El valor de color debe tener el formato 0xRRGGBB. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se asigna el valor 0xaabbcc a la propiedad selectionUnfocused de formStyleFormat.

formStyleFormat.selectionUnfocused = 0xaabbcc;
Vase tambin

FStyleFormat.selection

Diccionario de ActionScript 247

FStyleFormat.shadow
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.shadow
Descripcin

Propiedad; el valor de color RGB del borde exterior o la parte ms clara del sombreado de un componente; por ejemplo, el borde exterior del crculo de un botn de opcin deseleccionado o de una casilla de verificacin deseleccionada. El valor de color debe tener el formato 0xRRGGBB. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se asigna el valor 0x008080 a la propiedad shadow de formStyleFormat, lo que generar un borde exterior de color verde grisceo para los componentes no seleccionados de botn de opcin y de casilla de seleccin.
formStyleFormat.shadow = 0x008080;
Vase tambin

FStyleFormat.check

FStyleFormat.textAlign
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.textAlign
Descripcin

Propiedad; cadena de texto que especifica la alineacin a la derecha, a la izquierda o al centro del texto visualizado en todos los componentes asignados al formato de estilo. El valor predeterminado es left (izquierda). Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se alinea a la derecha todo el texto de los componentes mediante formStyleFormat.
formStyleFormat.textAlign = "right";
Vase tambin

FStyleFormat.textIndent, FStyleFormat.textLeftMargin, FStyleFormat.textRightMargin

248

FStyleFormat.textBold
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.textBold
Descripcin

Propiedad; un valor booleano que especifica si todo el texto visualizado en componentes mediante el formato de estilo est en negrita (true) o no (false). El valor predeterminado es false. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se especifica que todo el texto visualizado en componentes asignados a formStyleFormat est en negrita.
formStyleFormat.textBold = true;
Vase tambin

FStyleFormat.textItalic, FStyleFormat.textUnderline

FStyleFormat.textColor
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.textColor
Descripcin

Propiedad; el valor de color RGB del color de texto predeterminado en todos los componentes asignados al formato de estilo. El valor de color debe tener el formato 0xRRGGBB. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se asigna el valor 0x000000 a la propiedad textColor de formStyleFormat, lo que generar un texto de color negro.
formStyleFormat.textColor = 0x000000;
Vase tambin

FStyleFormat.textDisabled, FStyleFormat.textSelected

Diccionario de ActionScript 249

FStyleFormat.textDisabled
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.textDisabled
Descripcin

Propiedad; el valor de color RGB del color del texto predeterminado utilizado para visualizar texto en componentes desactivados asignados al formato de estilo. El valor de color debe tener el formato 0xRRGGBB. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se asigna el valor 0xCOCOC0 a la propiedad textDisabled de formStyleFormat, lo que generar un texto de color plateado cuando el componente est desactivado.
formStyleFormat.textDisabled = 0xCOCOC0;
Vase tambin

FStyleFormat.textAlign, FStyleFormat.textSelected

FStyleFormat.textFont
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.textFont
Descripcin

Propiedad; cadena de texto que especifica la fuente utilizada para visualizar el texto en todos los componentes asignados al formato de estilo. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se asigna el valor Arial a la propiedad textFont de formStyleFormat.

formStyleFormat.textFont = "Arial";

FStyleFormat.textIndent
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.textIndent
Descripcin

Propiedad; entero que especifica la sangra, en pxeles, desde el margen izquierdo al primer carcter del texto de todo el texto visualizado mediante el formato de estilo.

250

Ejemplo

En el cdigo siguiente se aplica una sangra de 5 pxeles en todo el texto visualizado mediante formStyleFormat.
formStyleFormat.textIndent = 5;
Vase tambin

FStyleFormat.textAlign, FStyleFormat.textLeftMargin

FStyleFormat.textItalic
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.textItalic
Descripcin

Propiedad; valor booleano que especifica si todo el texto visualizado en los componentes mediante el formato de estilo est en cursiva (true) o no (false). El valor predeterminado es false. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se especifica que todo el texto visualizado en componentes asignados en formStyleFormat est en cursiva.
formStyleFormat.textItalic = true;
Vase tambin

FStyleFormat.textBold

FStyleFormat.textLeftMargin
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.textLeftMargin
Descripcin

Propiedad; un entero que especifica el margen izquierdo del prrafo, en pxeles, de todo el texto visualizado en componentes asignados al formato de estilo. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se especifica un valor de 4 pxeles para la propiedad textLeftMargin de formStyleFormat.

formStyleFormat.textLeftMargin = 4;
Vase tambin

FStyleFormat.textRightMargin

Diccionario de ActionScript 251

FStyleFormat.textRightMargin
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.textRightMargin

Propiedad; un entero que especifica el margen derecho del prrafo, en pxeles, de todo el texto visualizado en componentes asignados al formato de estilo. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se especifica un valor de 4 pxeles para la propiedad textRightMargin de formStyleFormat.

formStyleFormat.textRightMargin = 4;
Vase tambin

FStyleFormat.textLeftMargin

FStyleFormat.textSelected
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.textSelected
Descripcin

Propiedad; un valor de color RGB que especifica el color del texto seleccionado en componentes asignados al formato de estilo. Esta propiedad se combina con la propiedad FStyleFormat.selection para visualizar los elementos de lista seleccionados. Debe coordinar los colores para facilitar la lectura. Por ejemplo, el formato de estilo global asigna un valor de color azul a la propiedad selection utilizada para visualizar la barra de seleccin de los componentes ListBox y ComboBox, y asigna un valor de color blanco a la propiedad textSelected; esta combinacin de color permite al usuario visualizar fcilmente el texto seleccionado. El valor de color debe tener el formato 0xRRGGBB. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se asigna el valor 0xffffff a la propiedad textSelected de formStyleFormat, lo que generar un texto de color blanco cuando el componente est seleccionado.
formStyleFormat.textSelected = 0xffffff;
Vase tambin

FStyleFormat.selection, FStyleFormat.textDisabled

252

FStyleFormat.textSize
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.textSize
Descripcin

Propiedad; un entero que especifica el tamao en puntos del texto visualizado en componentes asignados al formato de estilo. El ajuste predeterminado de esta propiedad es texto de 12 puntos. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se especifica texto de 10 puntos para todos los componentes asignados a formStyleFormat.
formStyleFormat.textSize = 10;
Vase tambin

FStyleFormat.textFont

FStyleFormat.textUnderline
Disponibilidad

Flash Player 6.
Sintaxis

myStyleFormat.textUnderline
Descripcin

Propiedad; especifica si el texto visualizado en los componentes mediante el formato de estilo especificado est subrayado (true) o no (false). El valor predeterminado es false. Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo

En el cdigo siguiente se especifica que todo el texto visualizado en componentes asignados a formStyleFormat est subrayado.
formStyleFormat.textUnderline = true;
Vase tambin

FStyleFormat.textBold, FStyleFormat.textItalic

Diccionario de ActionScript 253

Function (objeto)
El objeto Function est disponible en Flash MX. Resumen de propiedades del objeto Function
Mtodo Function.prototype Descripcin Hace referencia a un objeto que es el prototipo de una clase.

Resumen de mtodos del objeto Function

Mtodo Function.apply Function.call Descripcin Activa el cdigo ActionScript para llamar a una funcin. Invoca la funcin representada por un objeto Function.

Function.apply
Disponibilidad

Flash Player 6.
Sintaxis

myFunction.apply(objeto, argumentosObjeto)
Parmetros

objeto

Objeto al que se aplica myFunction. Matriz de elementos que se pasan a myFunction como parmetros.

argumentosObjeto
Valor devuelto

El valor que especifique la funcin llamada.

Descripcin

Mtodo; especifica el valor de this que debe utilizarse con la funcin a la que llama ActionScript. Este mtodo tambin especifica parmetros que deben pasarse a la funcin llamada. Puesto que apply es un mtodo del objeto Function, tambin es un mtodo para cada objeto de funcin de ActionScript. Los parmetros se especifican como un objeto Array. Suele ser til cuando no se conoce el nmero de parmetros hasta que se ejecuta el script.
Ejemplo

Las llamadas de funcin siguientes son equivalentes:

Math.atan2(1, 0) Math.atan2.apply(null, [1, 0])

Puede crear una pelcula Flash que contenga campos de entrada que permitan al usuario especificar el nombre de una funcin a la que se debe llamar, y cero o ms parmetros que se pasarn a la funcin. Si se presiona el botn Llamar se utilizar el mtodo apply para llamar a la funcin especificando los parmetros.

254

En este ejemplo, el usuario especifica un nombre de funcin en un campo de introduccin de texto denominado nombreFuncin. El nmero de parmetros se especifica en un campo de introduccin de texto denominado nmParmetros. Se especifican hasta 10 parmetros en campos de texto denominados parmetro1, parmetro2, hasta parmetro10.
on (release) { callTheFunction(); } ... function callTheFunction() { var theFunction = eval(nombreFuncin.text); var n = Number(nmParmetros); var parameters = []; for (var i = 0; i < n; i++) { parameters.push(eval("parameter" + i)); } theFunction.apply(null, parameters); }

Function.call
Disponibilidad

Flash Player 6.
Sintaxis

myFunction.call(objeto, parmetro1, ..., parmetroN)

Parmetros

objeto

Especifica el valor de this en el cuerpo de la funcin. Parmero que se pasa a myFunction. Puede especificar cero o ms parmetros.

parmetro1 parmetroN

Valor devuelto

Ninguno.
Descripcin

Mtodo; invoca la funcin representada por un objeto Function. Cada funcin de ActionScript se representa mediante un objeto Function, de modo que todas las funciones dan soporte al mtodo call. En casi todos los casos, puede utilizarse el operador de llamada de funcin (()) en lugar del mtodo call. El operador de llamada de funcin hace que el cdigo sea conciso y legible. El mtodo call es de gran utilidad cuando debe controlarse explcitamente el parmetro this o la llamada de funcin. Normalmente, si se invoca una funcin como mtodo de un objeto, this se establece en myObject como el caso siguiente dentro del cuerpo de la funcin:
myObject.myMethod(1, 2, 3);

En algunas situaciones, es posible que desee que this 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 un mtodo de dicho objeto.
myObject.myMethod.call(myOtherObject, 1, 2, 3);

Diccionario de ActionScript 255

Puede pasar el valor null para el parmetro objeto 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)

Ejemplo En este ejemplo se utiliza el mtodo call para hacer que una funcin se comporte como mtodo de otro objeto, sin almacenar la funcin en el objeto.
function MyObject() { } function MyMethod(obj) { trace("this == obj? " + (this == obj)); } var obj = new MyObject(); MyMethod.call(obj, obj);

La accin trace enva el cdigo siguiente a la ventana Salida:

this == obj? true

Function.prototype
Disponibilidad

Flash Player 6.
Sintaxis

myFunction.prototype
Descripcin

Propiedad; en una funcin de constructor, la propiedad prototype hace referencia a un objeto que es el prototipo de la clase construida. Cada instancia de la clase que crea la funcin constructor hereda todas las propiedades y los mtodos del objeto prototipo.

fscommand
Disponibilidad

Flash Player 3.
Sintaxis

fscommand("comando", "parmetros")
Parmetros

comando

Cadena pasada a la aplicacin host para cualquier uso, o comando pasado a Flash Player. Cadena pasada a la aplicacin host para cualquier uso, o valor pasado a Flash Player.

parmetros

Valor devuelto

Ninguno.
Descripcin

Accin; permite a la pelcula Flash comunicarse con Flash Player o el programa que aloja Flash Player, como por ejemplo, el navegador Web. Tambin puede utilizar la accin fscommand para pasar mensajes a Macromedia Director o a Visual Basic, Visual C++ y otros programas que pueden aceptar controles de ActiveX.

256

Sintaxis 1: para enviar un mensaje a Flash Player, debe utilizar comandos y parmetros predefinidos. La tabla siguiente muestra los valores que puede especificar para los parmetros comando y parmetros de la accin fscommand para controlar una pelcula que se ejecuta en Flash Player (incluidos los proyectores):
Comando quit fullscreen Parmetros Ninguno true o false Propsito Cierra el proyector. Especificar true establece Flash Player en el modo de pantalla completa. Especificar false devuelve el reproductor a la vista de men normal. Si se especifica false el reproductor se establece para que la pelcula se dibuje siempre a su tamao original y nunca se cambie su escala. Si se especifica true obliga a la pelcula a cambiar su escala al 100% del reproductor. Especificar true habilita el conjunto completo de elementos de men de contexto. Si se especifica false se atenan todos los elementos de men de contexto excepto Acerca de Flash Player. Ejecuta una aplicacin desde el interior del proyector.

allowscale

true o false

showmenu

true o false

exec

Ruta de acceso a la aplicacin true o false

trapallkeys

Especificar true enva todos los eventos de teclas, incluidas teclas aceleradoras, al controlador onClipEvent(keyDown/keyUp) en Flash Player.

Sintaxis 2: para utilizar la opcin fscommand y enviar un mensaje en un lenguaje de creacin de scripts, como por ejemplo JavaScript en un navegador Web, puede pasar dos parmetros que desee en los parmetros comando y parmetros. Estos argumentos pueden ser cadenas o expresiones y se utilizan en una funcin de JavaScript que captura o controla la accin fscommand. En un navegador Web, la accin fscommand llama a la funcin JavaScript nombrePelcula_DoFScommand en la pgina HTML que contiene la pelcula Flash. En nombrePelcula se incluye el nombre de Flash Player asignado mediante el atributo NAME del cdigo EMBED de la propiedad ID del cdigo OBJECT. Si asigna a Flash Player el nombre myMovie, la funcin de JavaScript invocada es myMovie_DoFSCommand. Sintaxis 3: la accin fscommand puede enviar mensajes a Macromedia Director que son interpretados por Lingo como cadenas, eventos o cdigo Lingo ejecutable. Si el mensaje es una cadena o un evento, debe escribir el cdigo Lingo para recibir el mensaje de la accin fscommand y llevar a cabo una accin en Director. Sintaxis 4: en Visual Basic, Visual C++, y otros programas que pueden aceptar controles ActiveX, fscommand enva un evento VB con dos cadenas que pueden controlarse en el lenguaje de programacin del entorno. Para obtener ms informacin, utilice las palabras clave Flash method para buscar elCentro de Soporte Flash.
Ejemplo

Sintaxis 1: en el ejemplo siguiente, la accin fscommand hace que Flash Player ajuste la escala de la pelcula en pantalla completa al soltar el botn.
on(release){ fscommand("fullscreen", true); }

Diccionario de ActionScript 257

Sintaxis 2: en el ejemplo siguiente se utiliza la accin fscommand aplicada a un botn en Flash para abrir un cuadro de mensaje JavaScript en una pgina HTML. El mensaje se enva a JavaScript como parmetro fscommand. Debe agregar una funcin a la pgina HTML que contiene la pelcula Flash. Esta funcin, myMovie_DoFSCommand se establece en la pgina HTML y espera una accin fscommand en Flash. Cuando se activa fscommand en Flash (por ejemplo, cuando un usuario presiona el botn), se pasan las cadenas comando y parmetro a la funcin myMovie_DoFSCommand. Puede utilizar las cadenas pasadas en el cdigo JavaScript o VBScript como desee. En este ejemplo, la funcin contiene una sentencia condicional if que comprueba si la cadena de comando es messagebox. Si lo es, se abrir un cuadro de aviso de JavaScript (o messagebox) y se mostrar el contenido de la cadena de parmetros.
function myMovie_DoFSCommand(command, args) { if (command == "messagebox") { alert(args); }

} En el documento Flash, agregue la accin fscommand a un botn:

fscommand("messagebox", "Es un cuadro de mensajes invocado desde Flash.")

Tambin puede utilizar expresiones para la accin fscommand y parmetros, como en el ejemplo siguiente:
fscommand("messagebox", "Hola, " + name + ", bienvenido/a a nuestra pgina Web.")

Para comprobar la pelcula, elija Archivo > Previsualizacin de publicacin > HTML.
Nota: si publica su pelcula utilizando Flash con la plantilla FSCommand en Configuracin de publicacin en HTML, la funcin myMovie_DoFSCommand se inserta automticamente. Los atributos NAME y ID de la pelcula sern el nombre del archivo. Por ejemplo, para el archivo myMovie.fla, los atributos se estableceran en myMovie.

function
Disponibilidad

Flash Player 5.
Sintaxis

function nombrefuncin ([parmetro0, parmetro1,...parmetroN]){ sentencia(s) } function ([parmetro0, parmetro1,...parmetroN]){ sentencia(s) }

Parmetros

nombrefuncin parmetro

El nombre de la nueva funcin.

Identificador que representa un parmetro que debe pasarse a la funcin. Estos parmetros son opcionales. Instruccin de ActionScript definida para el cuerpo de la funcin.

sentencia(s)
Valor devuelto

Ninguno.

258

Descripcin

Accin; un conjunto de sentencias que define para realizar una determinada tarea. Puede declarar o definir una funcin en una ubicacin y llamarla, o invocarla, desde diferentes scripts de una pelcula. Cuando defina una funcin, tambin puede especificar sus parmetros. Los parmetros son marcadores de posicin para valores en los que opera la funcin. Puede pasar diferentes parmetros en una funcin cada vez que la llama. Esto permite volver a utilizar una funcin en muchas situaciones diferentes. Utilice la accin return en las sentencias de una funcin para hacer que la funcin devuelva o genere un valor. Sintaxis 1: declara una funcin con los valores especificados de nombrefuncin, parmetros y sentencia(s). Cuando se llama a una funcin, se invoca la declaracin de funcin. Se permite la referencia hacia delante; dentro de la misma lista de Acciones, puede declararse una funcin despus de que ha sido llamada. Una declaracin de funcin sustituye a cualquier declaracin anterior de la misma funcin. Puede utilizar esta sintaxis siempre que est permitido un argumento. Sintaxis 2: crea una funcin annima y la devuelve. Esta sintaxis se utiliza en expresiones y es muy til para instalar mtodos en objetos.
Ejemplo

Sintaxis 1: en el ejemplo siguiente se define la funcin sqr, que acepta un parmetro y devuelve el valor square(x*x) del parmetro. Observe que la funcin se declara y utiliza en el mismo script, la declaracin de funcin puede aparecer tras la utilizacin de la funcin.
y=sqr(3); function sqr(x) { return x*x; }

Sintaxis 2: en la funcin siguiente se define un objeto de crculo (Circle):

function Circle(radius) { this.radius = radius; }

En la sentencia siguiente se define una funcin annima que calcula el rea de un crculo y la asocia al objeto Circle como un mtodo:
Circle.prototype.area = function () {return Math.PI * this.radius * this.radius}

ge (mayor o igual que, especfico de cadena)

Disponibilidad

Flash Player 4. Esta funcin se ha desestimado en Flash 5; se recomienda utilizar el operador >= (mayor o igual que).
Sintaxis

expresin1 ge expresin2
Parmetros

expresin1, expresin2
Valor devuelto

Nmeros, cadenas o variables.

Ninguno.

Diccionario de ActionScript 259

Descripcin

Operador (comparacin); compara la representacin de cadena de expresin1 con la representacin de cadena de expresin2 y devuelve true si expresin1 es mayor o igual que expresin2; de lo contrario, devuelve false.
Vase tambin

>= (mayor o igual que)

getProperty
Disponibilidad

Flash Player 4.
Sintaxis

getProperty(nombreinstancia , propiedad)
Parmetros

nombreinstancia

Nombre de instancia de un clip de pelcula para el que se recupera la

propiedad.
propiedad

Propiedad de un clip de pelcula.

Valor devuelto

Ninguno.
Descripcin

Funcin; devuelve el valor de la propiedad para el clip de pelcula nombreinstancia.

Ejemplo

En el ejemplo siguiente se recupera la coordenada de eje horizontal (_x) del clip de pelcula myMovie y se lo asigna a la variable myMovieX:
myMovieX = getProperty(_root.myMovie, _x);

getTimer
Disponibilidad

Flash Player 4.
Sintaxis

getTimer()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Funcin; devuelve el nmero de milisegundos que han transcurrido desde que la pelcula comenz a reproducirse.

260

getURL
Disponibilidad

Flash 2. Las opciones GET y POST estn disponibles solamente en Flash Player 4 y versiones posteriores.
Sintaxis

getURL(url [, ventana [, "variables"]])

Parmetros

url

La direccin URL de la que se obtiene el documento.

ventana Argumento opcional que especifica la ventana o el fotograma HTML en el que debera cargarse el documento. Puede especificar el nombre de una ventana especfica o seleccionar uno de los nombres de destino reservados siguientes:

_self

especifica el fotograma actual de la ventana vigente. especifica una nueva ventana. especifica el padre del fotograma actual.

_blank

_parent _top

especifica el fotograma de nivel superior de la ventana actual.

Mtodo GET o POST para el envo de variables. Si no hay variables, omita este parmetro. El mtodo GET adjunta las variables al final de la direccin URL y sirve para pequeas cantidades de variables. El mtodo POST enva las variables en un encabezado HTTP separado y se usa para el envo de cadenas largas de variables.
variables
Valor devuelto

Ninguno.
Descripcin

Accin; carga un documento desde un URL especfico en una ventana o pasa variables a otra aplicacin en un URL definido. Para probar esta accin, asegrese de que el archivo que se va a cargar se encuentra en la ubicacin especificada. Para utilizar una direccin URL absoluta (por ejemplo, http://www.myserver.com), necesita una conexin de red.
Ejemplo

En este ejemplo se carga un nuevo URL en una ventana del navegador vaca. La accin getURL destina la variable incomingAd como el parmetro url para que pueda cambiar el URL cargado sin tener que editar la pelcula Flash. El valor de la variable incomingAd se pasa antes a Flash en la pelcula utilizando una accin loadVariables.
on(release) { getURL(incomingAd, "_blank"); }
Vase tambin

loadVariables, XML.send, XML.sendAndLoad, XMLSocket.send

Diccionario de ActionScript 261

getVersion
Disponibilidad

Flash Player 5.
Sintaxis

getVersion()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Funcin, devuelve una cadena que contiene la informacin de la versin de Flash Player y de la plataforma. La funcin getVersion slo devuelve informacin para Flash Player 5 o versiones posteriores.
Ejemplo

A continuacin se muestra un ejemplo de una cadena devuelta por la funcin getVersion:

WIN 5,0,17,0

sta indica que la plataforma es Windows y el nmero de la versin de Flash Player es versin mayor 5, versin menor 17 (50r17).

_global
Disponibilidad

Flash Player 6.
Sintaxis

_global.identifier
Parmetros

Ninguno.
Valor devuelto

Referencia al objeto global que contiene las clases bsicas de ActionScript, como por ejemplo, String, Object, Math y Array.
Descripcin

Identificador; crea objetos, clases o variables globales. Por ejemplo, puede crear una biblioteca que se presente como objeto global de ActionScript, del mismo modo que un objeto Math o Date. A diferencia de las variables y las funciones declaradas en la lnea de tiempo o declaradas localmente, las variables y las funciones globales estn visibles para cada lnea de tiempo y mbito en la pelcula Flash, siempre que no haya identificadores con los mismos nombres en mbitos interiores que los anulen.

262

Ejemplo

En el ejemplo siguiente se crea una funcin de nivel superior factorial, disponible en cada lnea de tiempo y mbito de una pelcula Flash:
_global.factorial = function (n) { if (n <= 1) { return 1; } else { return n * factorial(n-1); } }
Vase tambin

var, set variable

globalStyleFormat
Disponibilidad

Flash Player 6.
Sintaxis

globalStyleFormat.propiedadEstilo
Parmetros

propiedadEstilo
Valor devuelto

Propiedad del objeto FStyleFormat.

Ninguno.
Descripcin

Instancia de objeto; instancia del objeto FStyleFormat que define las propiedades de formato de estilo para componentes de la interfaz de usuario Flash. La instancia de globalStyleFormat est disponible una vez que se coloca un componente de interfaz de usuario Flash en el escenario. Puede definir o modificar propiedades de formato de estilo para componentes de la interfaz de usuario Flash editando las propiedades de la instancia del objeto globalStyleFormat. Para obtener ms informacin, consulte el apartado Personalizacin de los colores y el texto de los componentes en el captulo Utilizacin de componentes de la publicacin Utilizacin de Flash.
Ejemplo

En el cdigo siguiente se establece la propiedad arrow de FStyleFormat para la instancia globalStyleFormat.

globalStyleFormat.arrow = 0x800080;
Vase tambin

FStyleFormat (objeto)

Diccionario de ActionScript 263

gotoAndPlay
Disponibilidad

Flash 2.
Sintaxis

gotoAndPlay(escena, fotograma)
Parmetros

escena

El nombre de la escena a la que se enva la cabeza lectora. Nmero o etiqueta de fotograma al que se enva la cabeza lectora.

fotograma

Valor devuelto

Ninguno.
Descripcin

Accin; enva la cabeza lectora al fotograma especificado en una escena y reproduce a partir de ese fotograma. Si no se especifica escena, la cabeza lectora va el fotograma especificado en la escena actual.
Ejemplo

Cuando el usuario hace clic en un botn al que est asignada la accin gotoAndPlay, la cabeza lectora se enva al fotograma 16 y empieza la reproduccin.
on(release) { gotoAndPlay(16); }

gotoAndStop
Disponibilidad

Flash 2.
Sintaxis

gotoAndStop(escena, fotograma)
Parmetros

escena

El nombre de la escena a la que se enva la cabeza lectora. Nmero o etiqueta de fotograma al que se enva la cabeza lectora.

fotograma

Valor devuelto

Ninguno.
Descripcin

Accin; enva la cabeza lectora al fotograma especificado en una escena y lo detiene. Si no se especifica ninguna escena, la cabeza lectora se enva al fotograma en la escena actual.
Ejemplo

Cuando el usuario hace clic sobre un botn, se asigna la accin gotoAndStop, se enva la cabeza lectora al fotograma 5 y deja de reproducirse la pelcula.
on(release) { gotoAndStop(5); }

264

gt (mayor que, especfico de cadena)

Disponibilidad

Flash Player 4. Este operador se ha desestimado en Flash 5; se recomienda utilizar el nuevo operador > (mayor que).
Sintaxis

expresin1 gt expresin2
Parmetros

expresin1,expresin2
Descripcin

Nmeros, cadenas o variables.

Operador (comparacin); compara la representacin de cadena de expresin1 con la representacin de cadena de expresin2 y devuelve true si expresin1 es mayor que expresin2; de lo contrario, devuelve false.
Vase tambin

> (mayor que)

_highquality
Disponibilidad

Flash Player 4.
Sintaxis

_highquality
Descripcin

Propiedad (global); especifica el nivel de suavizado aplicado a la pelcula actual. Especifique 2 (BEST) para aplicar alta calidad con el suavizado de mapa de bits siempre activado. Especifique 1 (alta calidad) para aplicar suavizado; esto suavizar los mapas de bits si la pelcula no contiene animacin. Especifique 0 (baja calidad) para evitar el suavizado.
Ejemplo

_highquality = 1;
Vase tambin

_quality, toggleHighQuality

if
Disponibilidad

Flash Player 4.
Sintaxis

if(condicin) { sentencia(s); }
Parmetros

condicin

Una expresin que da como resultado true o false. Las instrucciones que se deben ejecutar si o cuando la condicin da como resultado

sentencia(s) true.

Diccionario de ActionScript 265

Valor devuelto

Ninguno.
Descripcin

Accin; calcula el resultado de una condicin para determinar la siguiente accin en una pelcula. Si la condicin es true, Flash ejecuta las sentencias entre llaves ({}) que van a continuacin de la condicin. Si la condicin es false, Flash omite las sentencias entre llaves y ejecuta las sentencias que siguen a dichas llaves. Utilice la accin if para crear lgica de ramas en sus scripts.
Ejemplo

En el ejemplo siguiente, la condicin entre parntesis comprueba si la variable name contiene el valor literal Erica. Si es as, se ejecuta la accin play encerrada entre llaves.
if(name == "Erica"){ play(); }
Ejemplo

El siguiente ejemplo utiliza una accin if para comprobar si el usuario suelta en la pelcula un objeto arrastrable. Si el objeto se suelta antes de que transcurran 300 milisegundos tras arrastrarlo, la condicin da como resultado true y se ejecutan las sentencias entre llaves. Estas sentencias definen variables para almacenar la nueva ubicacin del objeto y para determinar con qu fuerza se solt y la velocidad a la que se solt. Tambin se restablece la variable timePressed. Si el objeto se suelta una vez transcurridos 300 milisegundos tras arrastrarlo, la condicin da como resultado false y no se ejecuta ninguna sentencia.
if (getTimer()<timePressed+300) { // si la condicin es verdadera, // el objeto se ha soltado. // cul es la nueva ubicacin de este objeto? xNewLoc = this._x; yNewLoc = this._y; // con qu fuerza se solt? xTravel = xNewLoc-xLoc; yTravel = yNewLoc-yLoc; // definicin de la velocidad del objeto en funcin de // la distancia que ha recorrido xInc = xTravel/2; yInc = yTravel/2; timePressed = 0; }
Vase tambin

else

266

ifFrameLoaded
Disponibilidad

Flash Player 3. La accin ifFrameLoaded se ha desestimado en Flash 5; se recomienda utilizar la accin MovieClip._framesloaded.
Sintaxis

ifFrameLoaded(escena, fotograma) { sentencia; } ifFrameLoaded(fotograma) { sentencia; }

Parmetros

escena

La escena que debe cargarse.

fotograma

El nmero de fotograma o la etiqueta de fotograma que debe cargarse antes de ejecutar la sentencia siguiente.

sentencia(s)

Las instrucciones que se deben ejecutar si se carga la escena especificada o la escena y el fotograma indicados.

Valor devuelto

Ninguno.
Descripcin

Accin; comprueba si el contenido de un fotograma especfico est disponible localmente. Utilice ifFrameLoaded para empezar a reproducir una animacin sencilla mientras se descarga el resto de la pelcula en el sistema local. La diferencia entre utilizar _framesloaded y ifFrameLoaded es que _framesloaded le permite agregar sus propias sentencias if o else.
Vase tambin

MovieClip._framesloaded

#include
Disponibilidad

N/A
Sintaxis

#include "archivo.as"
Parmetros

archivo.as

El nombre de archivo que el script debe agregar al panel Acciones; .as es la extensin de archivo recomendada.

Valor devuelto

Ninguno.
Descripcin

Accin; incluye el contenido del archivo especificado en el parmetro cuando se prueba, se publica o se exporta una pelcula. La accin #include se invoca al probar, publicar o exportar la pelcula. La accin #include se comprueba al realizar una comprobacin de sintaxis.

Diccionario de ActionScript 267

#initclip
Disponibilidad

Flash Player 6.
Sintaxis

#initclip orden
Parmetros

orden Un nmero entero #initclip. Este parmetro

Descripcin

que especifica el orden de ejecucin de los bloques del cdigo es opcional.

Accin; indica el inicio de un bloque de acciones de inicializacin de componentes. Si se inicializan varios clips al mismo tiempo, se puede utilizar el parmetro orden para especificar cul es la inicializacin que se llevar a cabo en primer lugar. Las acciones de inicializacin de componentes se ejecutan cuando se define un smbolo de clip de pelcula. Si el clip de pelcula es un smbolo exportado, las acciones de inicializacin de componentes se ejecutarn antes que las acciones del fotograma 1 del archivo SWF. En caso contrario, se ejecutarn inmediatamente antes de las acciones del fotograma que contiene la primera sentencia del smbolo de clip de pelcula asociado. Las acciones de inicializacin de componentes slo se ejecutan una vez durante la reproduccin de una pelcula y deben utilizarse para las inicializaciones que tienen lugar una vez, como por ejemplo, la definicin de clase y el registro.
Ejemplo

El cdigo de ejemplo siguiente se asigna al primer fotograma de una pelcula que es un componente de tipo casilla de verificacin. Las acciones #initclip y #endinitclip designan el bloque de sentencias que incluyen como acciones de inicializacin de componentes. Las sentencias incluidas registran la clase y almacenan los mtodos en un objeto prototipo.
#initclip if (typeof(CheckBox) == "undefined") { // Definir el constructor para (y, con ello, definir) la clase CheckBox function CheckBox() { // Definir las vinculaciones de datos this.watch ('value', function (id, oldval, newval) { ... }; this.watch ('label', function (id, oldval, newval) { ... }; } // Definir la cadena prototipo CheckBox que se debe heredar de MovieClip CheckBox.prototype = new MovieClip(); // Registrar CheckBox como la clase para el smbolo "Check Box" Object.registerClass("Check Box", CheckBox); // Definir algunos mtodos CheckBox.prototype.enable = function () { ... }; CheckBox.prototype.show = function () { ... }; CheckBox.prototype.hide = function () { ... }; // Definir una funcin de ayuda para crear instancias de // casillas de verificacin CheckBox.create = function (parentMovieClip, instanceName, depth) { parentMovieClip.attachMovie("CheckBox", instanceName, depth); }; } #endinitclip
Nota: si copia y pega este cdigo en el panel Acciones, se generar un error al compilar el script debido a las funciones no definidas ({...})

Vase tambin

#endinitclip

268

instanceof
Disponibilidad

Flash Player 6.
Sintaxis

objeto instanceof clase

Parmetros

objeto clase

Un objeto de ActionScript. Una referencia a una funcin constructor de ActionScript, como String o Date.

Valor devuelto

Si objeto es una instancia de clase, instanceof devuelve true; de lo contrario, instanceof devuelve false.
Descripcin

Operador; determina si un objeto pertenece a una clase especfica. Comprueba si el objeto es una instancia de clase. Un objeto de ActionScript es una instancia de una clase si el objeto prototipo de la funcin constructor est en la cadena prototipo del objeto de ActionScript. El operador instanceof no convierte los tipos primitivos en objetos envolventes. Por ejemplo, el cdigo siguiente devuelve true:
new String("Hola") instanceof String

Mientras que el cdigo siguiente devuelve false:

"Hola" instanceof String
Ejemplo

Para ilustrar el algoritmo del operador instanceof, el ejemplo siguiente muestra qu aspecto tendra el operador instanceof si se hubiera codificado como una funcin de ActionScript.
function instanceof (theObject, theClass){ while ((theObject = theObject.__proto__) != null) { if (theObject == theClass.prototype) { return true; } } return false; }
Vase tambin

typeof

Diccionario de ActionScript 269

int
Disponibilidad

Flash Player 4. Esta funcin se ha desestimado en Flash 5; se recomienda utilizar el mtodo Math.round.
Sintaxis

int(valor)
Parmetros

valor

Un nmero que se va a redondear en un nmero entero.

Valor devuelto

Ninguno.
Descripcin

Funcin; convierte un nmero decimal en el valor del nmero entero ms cercano.

Vase tambin

Math.floor

isFinite
Disponibilidad

Flash Player 5.
Sintaxis

isFinite(expresin)
Parmetros

expresin

Un booleano, una variable u otra expresin cuyo resultado se debe calcular.

Valor devuelto

Ninguno.
Descripcin

Funcin de nivel superior; calcula el resultado de la expresin y devuelve true si es un nmero finito y false si es infinito o infinito negativo. La presencia de infinito o de infinito negativo indica una condicin de error matemtico como una divisin por 0.
Ejemplo

A continuacin se muestran ejemplos de los valores devueltos por isFinite:

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

270

isNaN
Disponibilidad

Flash Player 5.
Sintaxis

isNaN(expresin)
Parmetros

expresin

Un booleano, una variable u otra expresin cuyo resultado se debe calcular.

Valor devuelto

Ninguno.
Descripcin

Funcin de nivel superior; calcula el resultado del parmetro y devuelve true si el valor no es un nmero (NaN), lo que indica la presencia de errores matemticos.
Ejemplo

El cdigo siguiente muestra los valores de retorno de la funcin isNan.

isNan("Tree") // devuelve true isNan(56) // devuelve false isNaN(Number.POSITIVE_INFINITY) // devuelve false

Key (objeto)
El objeto Key es un objeto de nivel superior al que puede acceder sin utilizar un constructor. Utilice los mtodos del objeto Key para crear una interfaz que pueda ser controlada por cualquier usuario con un teclado estndar. Las propiedades del objeto Key son constantes que representan las teclas que se utilizan con mayor frecuencia para controlar juegos. Para obtener la relacin completa de valores de cdigos de tecla, consulte el apndice Teclas del teclado y valores de cdigos de tecla de la publicacin Utilizacin de Flash.
Ejemplo

El script siguiente utiliza el objeto Key para identificar las teclas de cualquier teclado para que el usuario pueda controlar un clip de pelcula.
onClipEvent (enterFrame) { if(Key.isDown(Key.RIGHT)) { this._x=_x+10; } else if (Key.isDown(Key.DOWN)) { this._y=_y+10; } }

Diccionario de ActionScript 271

Resumen de los mtodos del objeto Key

Mtodo Key.addListener Key.getAscii Key.getCode Key.isDown Key.isToggled Key.removeListener Descripcin Registra un objeto para que reciba una notificacin cuando se invoquen los mtodos onKeyDown y onKeyUp. Devuelve el valor ASCII de la ltima tecla presionada. Devuelve el cdigo de tecla virtual de la ltima tecla presionada. Devuelve true si se presiona la tecla especificada en el parmetro. Devuelve true si est activada la tecla Bloq Num o Bloq Mays. Elimina un objeto registrado previamente con addListener.

Resumen de las propiedades del objeto Key Todas las propiedades del objeto Key son constantes.
Propiedad Key.BACKSPACE Key.CAPSLOCK Key.CONTROL Key.DELETEKEY Key.DOWN Key.END Key.ENTER Key.ESCAPE Key.HOME Key.INSERT Key.LEFT Key.PGDN Key.PGUP Key.RIGHT Key.SHIFT Key.SPACE Key.TAB Key.UP Descripcin Constante asociada con el valor del cdigo de tecla para la tecla Retroceso (8). Constante asociada con el valor del cdigo de tecla para la tecla Bloq Mays (20). Constante asociada con el valor del cdigo de tecla para la tecla Control (17). Constante asociada con el valor del cdigo de tecla para la tecla Supr (46). Constante asociada con el valor del cdigo de tecla para la tecla Flecha abajo (40). Constante asociada con el valor del cdigo de tecla para la tecla Fin (35). Constante asociada con el valor del cdigo de tecla para la tecla Intro (13). Constante asociada con el valor del cdigo de tecla para la tecla Escape (27). Constante asociada con el valor del cdigo de tecla para la tecla Inicio (36). Constante asociada con el valor del cdigo de tecla para la tecla Insert (45). Constante asociada con el valor del cdigo de tecla para la tecla Flecha izquierda (37). Constante asociada con el valor del cdigo de tecla para la tecla Av Pg (34). Constante asociada con el valor del cdigo de tecla para la tecla Re Pg (33). Constante asociada con el valor del cdigo de tecla para la tecla Flecha derecha (39). Constante asociada con el valor del cdigo de tecla para la tecla Mays (16). Constante asociada con el valor del cdigo de tecla para la Barra espaciadora (32). Constante asociada con el valor del cdigo de tecla para la tecla Tabulador (9). Constante asociada con el valor del cdigo de tecla para la tecla Flecha arriba (38).

Resumen de los detectores del objeto Key

Mtodo Key.onKeyDown Key.onKeyUp Descripcin Recibe notificacin cuando se presiona una tecla. Recibe notificacin cuando se suelta una tecla.

272

Key.addListener
Disponibilidad

Flash Player 6.
Sintaxis

Key.addListener (nuevoDetector)
Parmetros

nuevoDetector
Valor devuelto

Un objeto con los mtodos onKeyDown y onKeyUp.

Ninguno.
Descripcin

Mtodo; registra un objeto para que reciba una notificacin de onKeyDown y onKeyUp. Al presionar o soltar una tecla, sin tener en cuenta la seleccin de entrada, se invoca el mtodo onKeyDown u onKeyUp de todos los objetos de deteccin registrados con addListener. Varios objetos pueden detectar notificaciones de teclado. Si el detector nuevoDetector ya est registrado, no se produce ningn cambio.
Ejemplo

Este ejemplo crea un nuevo objeto detector y define una funcin para onKeyDown y onKeyUp. La ltima lnea utiliza el mtodo addListener para registrar el detector con el objeto Key para que pueda recibir notificacin de los eventos presionar tecla y soltar tecla.
myListener = new Object(); myListener.onKeyDown = function () { trace ("Ha presionado una tecla."); } myListener.onKeyUp = function () { trace ("Ha soltado una tecla."); } Key.addListener(myListener);

Key.BACKSPACE
Disponibilidad

Flash Player 5.
Sintaxis

Key.BACKSPACE
Descripcin

Propiedad; constante asociada con el valor del cdigo de tecla para la tecla Retroceso (8).

Key.CAPSLOCK
Disponibilidad

Flash Player 5.
Sintaxis

Key.CAPSLOCK
Descripcin

Propiedad; constante asociada con el valor del cdigo de tecla para la tecla Bloq Mays (20).

Diccionario de ActionScript 273

Key.CONTROL
Disponibilidad

Flash Player 5.
Sintaxis

Key.CONTROL
Descripcin

Propiedad; constante asociada con el valor del cdigo de tecla para la tecla Control (17).

Key.DELETEKEY
Disponibilidad

Flash Player 5.
Sintaxis

Key.DELETEKEY
Descripcin

Propiedad; constante asociada con el valor del cdigo de tecla para la tecla Supr (46).

Key.DOWN
Disponibilidad

Flash Player 5.
Sintaxis

Key.DOWN
Descripcin

Propiedad; constante asociada con el valor del cdigo de tecla para la tecla Flecha abajo (40).

Key.END
Disponibilidad

Flash Player 5.
Sintaxis

Key.END
Descripcin

Propiedad; constante asociada con el valor del cdigo de tecla para la tecla Fin (35).

Key.ENTER
Disponibilidad

Flash Player 5.
Sintaxis

Key.ENTER
Descripcin

Propiedad; constante asociada con el valor del cdigo de tecla para la tecla Intro (13).

274

Key.ESCAPE
Disponibilidad

Flash Player 5.
Sintaxis

Key.ESCAPE
Descripcin

Propiedad; constante asociada con el valor del cdigo de tecla para la tecla Escape (27).

Key.getAscii
Disponibilidad

Flash Player 5.
Sintaxis

Key.getAscii();
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; devuelve el cdigo ASCII de la ltima tecla presionada o soltada. Los valores ASCII devueltos son valores del teclado ingls. Por ejemplo, si presiona Mays+2, Key.getAscii devuelve @ en un teclado japons, igual que en un teclado ingls.

Key.getCode
Disponibilidad

Flash Player 5.
Sintaxis

Key.getCode();
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; devuelve el cdigo de tecla virtual de la ltima tecla presionada. Para que el valor de cdigo de tecla devuelto coincida con la tecla virtual de un teclado estndar, utilice la informacin que se proporciona en el Apndice C, Teclas del teclado y valores de cdigos de tecla, de la publicacin Utilizacin de Flash.

Diccionario de ActionScript 275

Key.HOME
Disponibilidad

Flash Player 5.
Sintaxis

Key.HOME
Descripcin

Propiedad; constante asociada con el valor del cdigo de tecla para la tecla Inicio (36).

Key.INSERT
Disponibilidad

Flash Player 5.
Sintaxis

Key.INSERT
Descripcin

Propiedad; constante asociada con el valor del cdigo de tecla para la tecla Insert (45).

Key.isDown
Disponibilidad

Flash Player 5.
Sintaxis

Key.isDown(cdigotecla);
Parmetros

cdigotecla

El valor de cdigo de tecla asignado a una tecla especfica o a una propiedad de objeto Key asociada con una tecla especfica. Para obtener una lista de los cdigos de tecla asociados con las teclas de un teclado estndar, consulte el apndice C, Teclas del teclado y valores de cdigos de tecla, de la publicacin Utilizacin de Flash.

Valor devuelto

Ninguno.
Descripcin

Mtodo; devuelve true si se presiona la tecla especificada en cdigotecla. En Macintosh, los valores de cdigo de tecla para las teclas Bloq Mays y Bloq Num son idnticos.

276

Key.isToggled
Disponibilidad

Flash Player 5.
Sintaxis

Key.isToggled(cdigotecla)
Parmetros

cdigotecla
Valor devuelto

El cdigo de tecla de Bloq Mays (20) o Bloq Num (144).

Ninguno.
Descripcin

Mtodo; devuelve true si est activada la tecla Bloq Num o Bloq Mays. En Macintosh, los valores de cdigo de tecla para estas teclas son idnticos.

Key.LEFT
Disponibilidad

Flash Player 5.
Sintaxis

Key.LEFT
Descripcin

Propiedad; constante asociada con el valor del cdigo de tecla para la tecla Flecha izquierda (37).

Key.onKeyDown
Disponibilidad

Flash Player 6.
Sintaxis

someListener.onKeyDown
Descripcin

Detector, se notifica cuando se presiona una tecla. Para utilizar onKeyDown, debe crear un objeto detector. A continuacin, puede definir una funcin para onKeyDown y utilizar el mtodo addListener para registrar el detector con el objeto Key, como en el caso siguiente:
someListener = new Object(); someListener.onKeyDown = function () { ... }; Key.addListener(someListener);

Los detectores permiten que varios fragmentos de cdigo cooperen, ya que varios detectores pueden recibir notificaciones sobre un mismo evento.
Vase tambin

Key.addListener

Diccionario de ActionScript 277

Key.onKeyUp
Disponibilidad

Flash Player 6.
Sintaxis

someListener.onKeyUp
Descripcin

Detector, recibe notificacin cuando se suelta una tecla. Para utilizar onKeyUp debe crear un objeto detector. A continuacin, puede definir una funcin para onKeyUp y utilizar el mtodo addListener para registrar el detector con el objeto Key, como en el caso siguiente:
someListener = new Object(); someListener.onKeyUp = function () { ... }; Key.addListener(someListener);

Los detectores permiten que varios fragmentos de cdigo cooperen, ya que varios detectores pueden recibir notificaciones sobre un mismo evento.
Vase tambin

Key.addListener

Key.PGDN
Disponibilidad

Flash Player 5.
Sintaxis

Key.PGDN
Descripcin

Propiedad; constante asociada con el valor del cdigo de tecla para la tecla Av Pg (34).

Key.PGUP
Disponibilidad

Flash Player 5.
Sintaxis

Key.PGUP
Descripcin

Propiedad; constante asociada con el valor del cdigo de tecla para la tecla Re Pg (33).

Key.removeListener
Disponibilidad

Flash Player 6.
Sintaxis

Key.removeListener (detector)
Parmetros

detector

Un objeto.

278

Valor devuelto

Si el detector se ha eliminado correctamente, el mtodo devuelve true. Si el detector no se ha eliminado correctamente, por ejemplo, si el detector no se encontraba en la lista de detectores del objeto Key, el mtodo devuelve false.
Descripcin

Mtodo; elimina un objeto previamente registrado con el mtodo addListener.

Key.RIGHT
Disponibilidad

Flash Player 5.
Sintaxis

Key.RIGHT
Descripcin

Propiedad; constante asociada con el valor del cdigo de tecla para la tecla Flecha derecha (39).

Key.SHIFT
Disponibilidad

Flash Player 5.
Sintaxis

Key.SHIFT
Descripcin

Propiedad; constante asociada con el valor del cdigo de tecla para la tecla Mays (16).

Key.SPACE
Disponibilidad

Flash Player 5.
Sintaxis

Key.SPACE
Descripcin

Propiedad; constante asociada con el valor del cdigo de tecla de la Barra espaciadora (32).

Key.TAB
Disponibilidad

Flash Player 5.
Sintaxis

Key.TAB
Descripcin

Propiedad; constante asociada con el valor del cdigo de tecla de la tecla Tabulador (9).

Diccionario de ActionScript 279

Key.UP
Disponibilidad

Flash Player 5.
Sintaxis

Key.UP
Descripcin

Propiedad; constante asociada con el valor del cdigo de tecla de la tecla Flecha arriba (38).

le (menor o igual que; especfico para cadenas)

Disponibilidad

Flash Player 4. Este operador se ha desestimado en Flash 5; se recomienda utilizar el operador <= (menor o igual que).
Sintaxis

expresin1 le expresin2
Parmetros

expresin1,expresin2
Valor devuelto

Nmeros, cadenas o variables.

Ninguno.
Descripcin

Operador (de comparacin); compara expresin1 con expresin2 y devuelve un valor true si expresin1 es menor o igual que expresin2; en caso contrario, devuelve un valor false.
Vase tambin

<= (menor o igual que)

length
Disponibilidad

Flash Player 4. Esta funcin, junto con todas las funciones de cadena, se ha desestimado en Flash 5. Se recomienda utilizar los mtodos y la propiedad length del objeto String para realizar las mismas operaciones.
Sintaxis

length(expresin) length(variable)
Parmetros

expresin variable

Una cadena. El nombre de una variable.

Valor devuelto

Ninguno.
Descripcin

Funcin de cadena; devuelve la longitud de la cadena o nombre de variable especificado.

280

Ejemplo

El ejemplo siguiente devuelve el valor de la cadena "Hola".

length("Hola");

El resultado es 4.
Vase tambin

" " (delimitador de cadena), String.length

_level
Disponibilidad

Flash Player 4.
Sintaxis

_levelN
Descripcin

Propiedad; una referencia a la lnea de tiempo de la pelcula raz _levelN. Debe utilizar la accin loadMovieNum para cargar pelculas en Flash Player antes de usar la propiedad _level para especificar el destino de las mismas. Tambin puede utilizar _levelN para especificar el destino de una pelcula cargada en el nivel asignado por N. La pelcula inicial cargada en una instancia de Flash Player se carga automticamente en _level0. La pelcula de _level0 establece la velocidad y tamao de los fotogramas y el color de fondo para todas las dems pelculas cargadas posteriormente. stas se apilan en niveles superiores al de la pelcula de _level0. Debe asignar un nivel a cada pelcula que cargue en Flash Player mediante la accin loadMovieNum. Puede asignar niveles en cualquier orden. Si asigna un nivel que ya contiene un archivo SWF (incluido _level0), la pelcula de ese nivel se descargar y se sustituir por la nueva pelcula.
Ejemplo

El ejemplo siguiente detiene la cabeza lectora de la lnea de tiempo principal de la pelcula de _level9.
_level9.stop();

El ejemplo siguiente enva la cabeza lectora de la lnea de tiempo principal de la pelcula de _level4 al fotograma 5. La pelcula de _level4 debe haberse cargado previamente con una accin loadMovieNum.
_level4.gotoAndStop(5);
Vase tambin

loadMovie, MovieClip.swapDepths

Diccionario de ActionScript 281

loadMovie
Disponibilidad

Flash Player 3.
Sintaxis

loadMovie("url",nivel/destino[, variables])
Parmetros

url El URL absoluto o relativo del archivo SWF o JPEG que se debe cargar. Una ruta relativa debe ser relativa respecto al archivo SWF del nivel 0. El URL debe pertenecer al mismo subdominio que el URL donde reside actualmente la pelcula. Todos los archivos SWF, ya sea que se utilicen en Flash Player o para realizar pruebas en el modo de prueba en la aplicacin de edicin de Flash, tienen que guardarse en la misma carpeta y los nombres de archivo no pueden incluir especificaciones de carpeta ni de unidad de disco. destino Una ruta de acceso a un clip de pelcula de destino. El clip de pelcula de destino se sustituir por la imagen o pelcula cargada. Debe especificar un clip de pelcula de estino o un nivel de una pelcula de destino; no se pueden especificar ambos valores.

Un nmero entero que especifica el nivel de Flash Player en el que se cargar la pelcula. Al cargar una pelcula o una imagen en un nivel, la accin loadMovie del panel Acciones en modo Normal cambia a loadMovieNum; en modo Experto, debe especificar la accin loadMovieNum o seleccionarla de la caja de herramientas Acciones.
nivel

Un parmetro opcional que especifica un mtodo HTTP para enviar variables. El parmetro debe ser la cadena GET o POST. Si no hay ninguna variable para enviar, no incluya este parmetro. El mtodo GET adjunta las variables al final del URL y se utiliza para un nmero pequeo de variables. El mtodo POST enva las variables en un encabezado HTTP distinto y se usa para cadenas largas de variables.
variables
Valor devuelto

Ninguno.
Descripcin

Accin; carga un archivo SWF o JPEG en Flash Player mientras se reproduce la pelcula original. La accin loadMovie permite ver varias pelculas al mismo tiempo o pasar de una pelcula a otra sin cargar otro documento HTML. Sin la accin loadMovie, Flash Player muestra una sola pelcula (archivo SWF) y despus se cierra. Si utiliza la accin loadMovie, debe especificar un nivel en Flash Player o un clip de pelcula de destino en el que se cargar la pelcula. Si especifica un nivel, la accin cambiar a loadMovieNum. Si una pelcula se carga en un clip de pelcula de destino, puede utilizar la ruta de destino de dicho clip de pelcula para especificar el destino de la pelcula cargada. Una pelcula o imagen cargada 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 pelcula cargada se alinea con el punto de registro del clip de pelcula de destino. Como alternativa, si el destino es la lnea de tiempo _root, la esquina superior izquierda de la imagen o pelcula se alinear con la esquina superior izquierda del escenario. Utilice la accin unloadMovie para eliminar pelculas cargadas con la accin loadMovie.

282

Ejemplo

La sentencia loadMovie siguiente est asociada al botn de navegacin con la etiqueta Productos. Hay un clip de pelcula invisible en el escenario con el nombre de instancia dropZone. La accin loadMovie utiliza este clip de pelcula como parmetro de destino para cargar los productos del archivo SWF en la posicin correcta del escenario.
on(release) { loadMovie("products.swf",_root.dropZone); }

El ejemplo siguiente carga una imagen JPEG que se encuentra en el mismo directorio del archivo SWF que llama a la accin loadMovie:
loadMovie("image45.jpeg", "ourMovieClip");
Vase tambin

loadMovieNum, unloadMovie, unloadMovieNum, _level

loadMovieNum
Disponibilidad

Flash Player 4. Los archivos de Flash 4 que se abran en Flash 5 se convertirn para utilizar la sintaxis correcta.
Sintaxis

loadMovieNum("url",nivel[, variables])
Parmetros

url El URL absoluto o relativo del archivo SWF o JPEG que se debe cargar. Una ruta relativa debe ser relativa respecto al archivo SWF del nivel 0. El URL debe pertenecer al mismo subdominio que el URL donde reside actualmente la pelcula. Todos los archivos SWF, ya sea para utilizarlos en Flash Player o para realizar pruebas en el modo de prueba de pelcula en la aplicacin de edicin de Flash, deben almacenarse en la misma carpeta, y los nombres de archivo no pueden incluir especificaciones de carpeta ni de unidad de disco. nivel

Un nmero entero que especifica el nivel de Flash Player en el que se cargar la pelcula.

Un parmetro opcional que especifica un mtodo HTTP para enviar variables. El parmetro debe ser la cadena GET o POST. Si no hay ninguna variable para enviar, no incluya este parmetro. El mtodo GET adjunta las variables al final del URL y se utiliza para un nmero pequeo de variables. El mtodo POST enva las variables en un encabezado HTTP distinto y se usa para cadenas largas de variables.
variables
Valor devuelto

Ninguno.
Descripcin

Accin; carga un archivo SWF o JPEG en un nivel de Flash Player mientras se reproduce la pelcula original cargada. Al cargar una pelcula en un nivel en lugar de un destino, la accin loadMovie del panel Acciones en modo Normal cambia a loadMovieNum; en modo Experto, debe especificar la accin loadMovieNum o seleccionarla de la caja de herramientas Acciones. Por lo general, Flash Player muestra una sola pelcula (archivo SWF) y despus se cierra. La accin loadMovieNum permite ver varias pelculas al mismo tiempo y cambiar entre pelculas sin cargar otro documento HTML.

Diccionario de ActionScript 283

Flash Player tiene un orden de apilamiento de niveles que empieza por el nivel 0. Estos niveles son como capas de acetato, es decir, son transparentes excepto para los objetos de cada nivel. Si utiliza la accin loadMovieNum, debe especificar el nivel de Flash Player en el que se cargar la pelcula. Una vez que se ha cargado la pelcula en un nivel, puede utilizar la sintaxis _levelN, siendo N el nmero de nivel, para especificar el destino de la pelcula. Al cargar una pelcula, puede especificar cualquier nmero de nivel y puede cargar las pelculas en un nivel en el que ya se haya cargado un archivo SWF. Al hacerlo, la nueva pelcula sustituye al archivo SWF existente. Si carga una nueva pelcula en el nivel 0, todos los dems niveles se descargan y la pelcula del nivel 0 se sustituye por el nuevo archivo. La pelcula del nivel 0 establece la velocidad y tamao de los fotogramas y el color de fondo para todas las dems pelculas cargadas. La accin loadMovieNum tambin permite cargar archivos JPEG en una pelcula durante su reproduccin. Tanto en las imgenes como en los archivos SWF, la esquina superior izquierda de la imagen se alinea con la esquina superior izquierda del escenario al cargar el archivo. Tambin en ambos casos, el archivo cargado hereda las propiedades de rotacin y escala, y el contenido original se sobrescribe. Utilice la accin unloadMovieNum para eliminar pelculas o imgenes cargadas con la accin loadMovieNum.
Ejemplo

En este ejemplo se carga la imagen JPEG image45.jpg en el nivel 2 de Flash Player.

loadMovieNum("http://www.blag.com/image45.jpg", 2); //
Vase tambin

loadMovie, unloadMovie, unloadMovieNum, _level

loadVariables
Disponibilidad

Flash Player 4.
Sintaxis

loadVariables ("url" ,nivel/"destino" [, variables])

Parmetros

url Un URL absoluto o relativo donde estn ubicadas las variables. Si accede a la pelcula a travs de un navegador Web, el host del URL debe estar en el mismo subdominio que la pelcula.

Un nmero entero que especifica el nivel de Flash Player para recibir las variables. Si carga variables en un nivel, la accin del panel Acciones en modo Normal cambia a loadVariablesNum; en modo Experto, debe especificar la accin loadVariablesNum o seleccionarla de la caja de herramientas Acciones.
nivel destino La ruta de destino a un clip de pelcula que recibe las variables cargadas. Debe especificar un clip de pelcula de destino o un nivel de Flash Player; no puede especificar ambos valores.

Un parmetro opcional que especifica un mtodo HTTP para enviar variables. El parmetro debe ser la cadena GET o POST. Si no hay ninguna variable para enviar, no incluya este parmetro. El mtodo GET adjunta las variables al final del URL y se utiliza para un nmero pequeo de variables. El mtodo POST enva las variables en un encabezado HTTP distinto y se usa para cadenas largas de variables.
variables

284

Valor devuelto

Ninguno.
Descripcin

Accin; lee los datos de un archivo externo, como un archivo de texto o texto generado por un script CGI, Active Server Pages (ASP) o Personal Home Page (PHP), o un script Perl, y establece los valores para las variables de un nivel de Flash Player o un clip de pelcula de destino. Esta accin tambin puede utilizarse para actualizar variables en la pelcula activa con nuevos valores. El texto del URL especificado debe tener el formato MIME estndar application/x-www-formurlencoded (formato estndar que se utiliza en los scripts CGI). La pelcula y las variables que se van a cargar deben residir en el mismo subdominio. Se puede especificar cualquier nmero de variables. Por ejemplo, la siguiente frase define varias variables:
empresa=Macromedia&direccin=600+Townsend&ciudad=San+Francisco&zip=94103

La primera pelcula que se va a abrir en una instancia de Flash Player se carga en el nivel inferior (identificado por el cdigo _level0). Cuando utilice la accin loadMovie o loadMovieNum para cargar las siguientes pelculas en Flash Player, debe asignar un nmero de nivel de Flash Player o un clip de pelcula de destino en el que se cargar cada pelcula. Cuando utilice la accin loadVariables, debe especificar el nivel de Flash Player o un clip de pelcula de destino en el que se cargarn las variables.
Ejemplo

Este ejemplo carga informacin de un archivo de texto en los campos de texto del clip de pelcula varTarget de la lnea de tiempo principal. Los nombres de variables de los campos de texto deben coincidir con los nombres de variables del archivo data.txt.
on(release) { loadVariables("data.txt", "_root.varTarget"); }
Vase tambin

loadVariablesNum, loadMovie, loadMovieNum, getURL, MovieClip.loadMovie, MovieClip.loadVariables

loadVariablesNum
Disponibilidad

Flash Player 4. Los archivos de Flash 4 que se abran en Flash 5 se convertirn para utilizar la sintaxis correcta.
Sintaxis

loadVariables ("url" ,nivel [, variables])

Parmetros

url Un URL absoluto o relativo donde estn ubicadas las variables. Si accede a la pelcula a travs de un navegador Web, el host del URL debe estar en el mismo subdominio que la pelcula. nivel

Un nmero entero que especifica el nivel de Flash Player para recibir las variables.

Un parmetro opcional que especifica un mtodo HTTP para enviar variables. El parmetro debe ser la cadena GET o POST. Si no hay ninguna variable para enviar, no incluya este parmetro. El mtodo GET adjunta las variables al final del URL y se utiliza para un nmero pequeo de variables. El mtodo POST enva las variables en un encabezado HTTP distinto y se usa para cadenas largas de variables.
variables

Diccionario de ActionScript 285

Valor devuelto

Ninguno.
Descripcin

Accin; lee los datos de un archivo externo, como un archivo de texto o texto generado por un script CGI, Active Server Pages (ASP) o Personal Home Page (PHP), o un script Perl, y establece los valores para las variables de un nivel de Flash Player. Esta accin tambin puede utilizarse para actualizar variables en la pelcula activa con nuevos valores. Si carga variables en un nivel, la accin del panel Acciones en modo Normal cambia a loadVariablesNum; en modo Experto, debe especificar la accin loadVariablesNum o seleccionarla de la caja de herramientas Acciones. El texto del URL especificado debe tener el formato MIME estndar application/x-www-formurlencoded (formato estndar que se utiliza en los scripts CGI). La pelcula y las variables que se van a cargar deben residir en el mismo subdominio. Se puede especificar cualquier nmero de variables. Por ejemplo, la siguiente frase define varias variables:
empresa=Macromedia&direccin=600+Townsend&ciudad=San+Francisco&zip=94103

La primera pelcula que se va a abrir en una instancia de Flash Player se carga en el nivel inferior (identificado por el cdigo _level0). Cuando utilice la accin loadMovie o loadMovieNum para cargar las siguientes pelculas en Flash Player, debe asignar un nmero de nivel de Flash Player o un clip de pelcula de destino en el que se cargar cada pelcula. Cuando utilice la accin loadVariablesNum, debe especificar un nivel de Flash Player en el que se cargarn las variables.
Ejemplo

Este ejemplo carga informacin de un archivo de texto en los campos de texto de la lnea de tiempo principal de la pelcula en el nivel 0 de Flash Player. Los nombres de variables de los campos de texto deben coincidir con los nombres de variables del archivo data.txt.
on(release) { loadVariablesNum("data.txt", 0); }
Vase tambin

getURL, loadMovie, loadMovieNum, loadVariables, MovieClip.loadMovie, MovieClip.loadVariables

LoadVars (objeto)
El objeto LoadVars es una alternativa a la accin loadVariables para transferir variables entre una pelcula Flash y un servidor. Puede utilizar el objeto LoadVars para obtener informacin sobre errores, indicaciones de progreso y datos de flujo mientras se descarga. El objeto LoadVars funciona como el objeto XML; utiliza los mtodos load, send y sendAndLoad para comunicarse con el servidor. La diferencia principal entre el objeto LoadVars y el objeto XML consiste en que LoadVars transfiere pares de nombre y valor de ActionScript, en lugar de un rbol XML DOM almacenado en el objeto XML. El objeto LoadVars sigue las mismas restricciones de seguridad que el objeto XML. Debe utilizar el constructor new LoadVars() para crear una instancia del objeto LoadVars para poder llamar a sus mtodos. El objeto LoadVars se admite en Flash Player 6 y versiones posteriores.

286

Resumen de los mtodos del objeto LoadVars

Mtodo LoadVars.load LoadVars.getBytesTotal LoadVars.getBytesTotal LoadVars.send LoadVars.sendAndLoad LoadVars.toString Descripcin Descarga variables de un URL especificado. Devuelve el nmero de bytes cargados de un mtodo load o sendAndLoad. Devuelve el nmero total de bytes que se descargarn mediante el mtodo load o sendAndLoad. Publica variables de un objeto LoadVars en un URL. Publica variables de un objeto LoadVars en un URL y descarga la respuesta del servidor en un objeto de destino. Devuelve una cadena codificada de URL que contiene todas las variables enumerables del objeto LoadVars.

Resumen de las propiedades del objeto LoadVars Todas las propiedades del objeto Key son constantes.
Propiedad Descripcin

LoadVars.contentType Indica el tipo MIME de los datos. LoadVars.load Valor booleano que indica si se ha realizado una operacin load o sendAndLoad.

Resumen de eventos del objeto LoadVars

Mtodo LoadVars.onLoad Descripcin Se invoca cuando se ha realizado una operacin load o sendAndLoad.

Constructor del objeto LoadVars

Disponibilidad

Flash Player 6.
Sintaxis

new LoadVars()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Constructor; crea una instancia del objeto LoadVars. A continuacin, puede utilizar los mtodos del objeto LoadVars para enviar y cargar datos.
Ejemplo

En el ejemplo siguiente se crea una instancia del objeto LoadVars denominada myLoadVars:
myLoadVars = new LoadVars();

Diccionario de ActionScript 287

LoadVars.contentType
Disponibilidad

Flash Player 6.
Sintaxis

myLoadVars.contentType
Descripcin

Propiedad; el tipo MIME que se enva al servidor al llamar al mtodo LoadVars.send o LoadVars.sendAndLoad. El valor predeterminado es application/x-www-urlform encoded.
Vase tambin

LoadVars.send, LoadVars.sendAndLoad

LoadVars.getBytesLoaded
Disponibilidad

Flash Player 6.
Sintaxis

myLoadVars.getBytesLoaded()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve el nmero de bytes descargados por un mtodo load o sendAndLoad. El mtodo getBytesLoaded devuelve undefined si no hay ninguna operacin load en curso o si todava no se ha iniciado la operacin load.

LoadVars.getBytesTotal
Disponibilidad

Flash Player 6.
Sintaxis

myLoadVars.getBytesTotal()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve el nmero total de bytes descargados por una operacin load o sendAndLoad. El mtodo getBytesTotal devuelve undefined si no hay ninguna operacin load en curso o si todava no se ha iniciado la operacin load. El mtodo getBytesTotal tambin devuelve undefined si no se puede determinar el nmero total de bytes; por ejemplo, si la descarga se ha iniciado pero el servidor no ha transmitido ningn comando content-length de HTTP.

288

LoadVars.load
Disponibilidad

Flash Player 6.
Sintaxis

myLoadVars.load(url)
Parmetros

url

La direccin URL desde la que se descargan las variables.

Valor devuelto

Una cadena.
Descripcin

Mtodo; descarga variables del URL especificado, analiza los datos de las variables y coloca las variables resultantes en loadVarsObject. Se sobrescriben todas las propiedades de loadVarsObject que tengan los mismos nombres que las variables descargadas. Las propiedades de loadVarsObject que posean nombres distintos a los de las variables descargadas no se eliminan. Se trata de una accin asncrona. Los datos descargados deben estar en el tipo de contenido MIME application/x-www-urlformencoded. Es el mismo formato que utiliza la accin loadVariables. Este mtodo es parecido al mtodo XML.load del objeto XML.

LoadVars.loaded
Disponibilidad

Flash Player 6.
Sintaxis

myLoadVars.loaded
Descripcin

Propiedad; el valor predeterminado es undefined. Al iniciar una operacin load o sendAndLoad, la propiedad loaded se establece en false. Al finalizar la operacin load o sendAndLoad, la propiedad loaded se establece en true. Si la operacin todava no se ha iniciado o se produce un error, la propiedad loaded permanece con el valor false. La propiedad LoadVars.loaded es parecida a la propiedad XML.loaded del objeto XML.

LoadVars.onLoad
Disponibilidad

Flash Player 6.
Sintaxis

myLoadVars.onLoad(correcto)
Parmetros

correcto

Este parmetro indica si la operacin de carga se ha realizado correctamente (true) o

no (false).

Diccionario de ActionScript 289

Valor devuelto

Valor booleano.
Descripcin

Controlador de eventos; se invoca cuando finaliza una operacin load o sendAndLoad. Si la operacin se realiz correctamente, loadVarsObject se rellena con las variables descargadas por la operacin load o sendAndLoad y dichas variables estn disponibles cuando se invoca onLoad. Este mtodo es undefined de forma predeterminada; puede definirlo mediante la asignacin de una funcin callback. Este mtodo es parecido al mtodo XML.onLoad del objeto XML.

LoadVars.send
Disponibilidad

Flash Player 6.
Sintaxis

loadVarsObject.send(url [,destino, mtodo])

Parmetros

loadVarsObject url

El objeto LoadVars desde el que se deben cargar las variables.

El URL desde el que se deben cargar las variables. La ventana del fotograma del navegador en el que se visualizar cualquier respuesta. El mtodo "GET" o "POST" del protocolo HTTP.

destino mtodo

Valor devuelto

Una cadena.
Descripcin

Mtodo; enva las variables del objeto myLoadVars al URL especificado. Todas las variables enumerables del objeto myLoadVars se concatenan en una cadena en formato application/x-wwwurlform-encoded de forma predeterminada y dicha cadena se publica en el URL mediante el mtodo HTTP POST. Es el mismo formato que utiliza la accin loadVariables. El tipo de contenido MIME que se enva en los encabezados de la solicitud HTTP es el valor de myLoadVars.contentType o el valor predeterminado application/x-www-urlform-encoded. Se utiliza el mtodo "POST" a menos que se especifique "GET". Si se especifica el parmetro destino, la respuesta del servidor aparece en la ventana del fotograma del navegador denominada destino. Si se omite el parmetro destino, se descarta la respuesta del servidor. Este mtodo es parecido al mtodo XML.send del objeto XML.

290

LoadVars.sendAndLoad
Disponibilidad

Flash Player 6.
Sintaxis

myLoadVars.sendAndLoad(url, objetoDestino[,mtodo])
Parmetros

loadVarsObject url

El objeto LoadVars desde el que se deben cargar las variables. El objeto LoadVars que recibe las variables descargadas.

El URL desde el que se deben cargar las variables. El mtodo "GET" o "POST" del protocolo HTTP.

objetoDestino mtodo

Valor devuelto

Una cadena.
Descripcin

Mtodo; publica las variables del objeto myLoadVars en el URL especificado. La respuesta del servidor se descarga y se analiza como datos de variable; las variables resultantes se colocan en el objetoDestino. Las variables se publican del mismo modo que LoadVars.send. Las variables se descargan en el objetoDestino del mismo modo que LoadVars.load. Este mtodo es parecido al mtodo XML.sendAndLoad del objeto XML.

LoadVars.toString
Disponibilidad

Flash Player 6.
Sintaxis

loadVarsObject.toString()
Parmetros

Ninguno.
Valor devuelto

Una cadena.
Descripcin

Mtodo; devuelve una cadena que contiene todas las variables enumerables del objeto LoadVars en la codificacin de contenido MIME application/x-www-urlform-encoded.
Ejemplo

var myVars = new LoadVars(); myVars.name = Gary; myVars.age = 26; trace (myVars.toString()); would output name=Gary&age=26

Diccionario de ActionScript 291

lt (menor que; especfico para cadenas)

Disponibilidad

Flash Player 4. Este operador se ha desestimado en Flash 5; se recomienda utilizar el nuevo operador < (menor que).
Sintaxis

expresin1 lt expresin2
Parmetros

expresin1, expresin2
Descripcin

Nmeros, cadenas o variables.

Operador (de comparacin); compara la expresin1 con la expresin2 y devuelve true si la expresin1 es menor que la expresin2; en caso contrario, devuelve false.
Vase tambin

< (menor que)

292

Math (objeto)
El objeto Math es un objeto de nivel superior al que puede acceder sin utilizar un constructor. Utilice los mtodos y propiedades de este objeto para acceder y manipular constantes y funciones matemticas. Todas las propiedades y mtodos del objeto Math son estticos y deben llamarse utilizando la sintaxis Math.method(parmetro) o Math.constant. En ActionScript, las constantes se definen con la mxima precisin de nmeros con coma flotante IEEE-754 de doble precisin. Algunos de los mtodos del objeto Math utilizan radianes de un ngulo como parmetro. Puede utilizar la ecuacin siguiente para calcular valores en radianes, o sencillamente pasar la ecuacin (introduciendo un valor para grados) para el parmetro en radianes. Para calcular un valor en radianes, utilice esta frmula:
radin = Math.PI/180 * grado

A continuacin, se muestra un ejemplo para pasar una ecuacin como parmetro para calcular el seno de un ngulo de 45 grados:
Math.SIN(Math.PI/180 * 45)

es lo mismo que Math.SIN(.7854)

El objeto Math est totalmente integrado en Flash Player 5. En Flash Player 4, puede utilizar los mtodos del objeto Math, pero se emulan con el uso de aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que admite Flash Player 5. Resumen de los mtodos del objeto Math
Mtodo Math.abs Math.acos Math.asin Math.atan Math.atan2 Math.ceil Math.cos Math.exp Math.floor Math.log Math.max Math.min Math.pow Math.random Math.round Math.sin Math.sqrt Math.tan Descripcin Calcula un valor absoluto. Calcula un arco coseno. Calcula un arco seno. Calcula un arco tangente. Calcula un ngulo desde el eje x hasta el punto. Redondea un nmero al entero ms cercano hacia arriba. Calcula un coseno. Calcula un valor exponencial. Redondea un nmero al entero ms cercano hacia abajo. Calcula un logaritmo natural. Devuelve el mayor de dos nmeros enteros. Devuelve el menor de dos nmeros enteros. Calcula x elevado a la potencia de y. Devuelve un nmero seudoaleatorio ente 0,0 y 1,1. Redondea al nmero entero ms cercano. Calcula un seno. Calcula una raz cuadrada. Calcula una tangente.

Diccionario de ActionScript 293

Resumen de las propiedades del objeto Math Todas las propiedades del objeto Math son constantes.
Propiedad Math.E Math.LN2 Math.LOG2E Math.LN10 Math.LOG10E Math.PI Math.SQRT1_2 Math.SQRT2 Descripcin La constante de Euler y la base de los logaritmos naturales (aproximadamente 2,718). El logaritmo natural de 2 (aproximadamente 0,693). El logaritmo en base 2 de e (aproximadamente 1,442). El logaritmo natural de 10 (aproximadamente 2,302). El logaritmo en base 10 de e (aproximadamente 0,434). La relacin entre la circunferencia de un crculo y su dimetro (aproximadamente 3,14159). El recproco de la raz cuadrada de 1/2 (aproximadamente 0,707). La raz cuadrada de 2 (aproximadamente 1,414).

Math.abs
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.abs(x)
Parmetros

Un nmero.

Valor devuelto

Un nmero.
Descripcin

Mtodo; calcula y devuelve el valor absoluto del nmero especificado por el parmetro x.

Math.acos
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.acos(x)
Parmetros

Un nmero de -1,0 a 1,0.

Valor devuelto

Ninguno.
Descripcin

Mtodo; calcula y devuelve el arco coseno del nmero especificado en el parmetro x, en radianes.

294

Math.asin
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.asin(x);
Parmetros

Un nmero de -1,0 a 1,0.

Valor devuelto

Un nmero.
Descripcin

Mtodo; calcula y devuelve el arco seno del nmero especificado en el parmetro x, en radianes.

Math.atan
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.atan(x)
Parmetros

Un nmero.

Valor devuelto

Un nmero.
Descripcin

Mtodo; calcula y devuelve el arco tangente del nmero especificado en el parmetro x. El valor devuelto est entre pi negativo dividido por 2 y pi positivo dividido por 2.

Math.atan2
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.atan2(y, x)
Parmetros

x y

Un nmero que especifica la coordenada x del punto. Un nmero que especifica la coordenada y del punto.

Diccionario de ActionScript 295

Valor devuelto

Un nmero.
Descripcin

Mtodo; calcula y devuelve el arco tangente de y/x en radianes. El valor devuelto representa el ngulo contrario al ngulo opuesto de un tringulo rectngulo, donde x es la longitud del cateto adyacente e y es la longitud de la hipotenusa.

Math.ceil
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.ceil(x)
Parmetros

Un nmero o expresin.

Valor devuelto

Un nmero.
Descripcin

Mtodo; devuelve el lmite del nmero o expresin especificados. El lmite de un nmero es el nmero entero ms cercano que es mayor o igual que el nmero.

Math.cos
Sintaxis

Math.cos(x)
Parmetros

Un ngulo medido en radianes.

Valor devuelto

Un nmero.
Descripcin

Mtodo; devuelve el coseno (un valor de -1,0 a 1,0) del ngulo especificado por el parmetro x. El ngulo x debe especificarse en radianes. Utilice la informacin que se explic en la introduccin del objeto Math para calcular un radin.

296

Math.E
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.E
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Constante; una constante matemtica para la base de los logaritmos naturales, expresada como e. El valor aproximado de e es 2,71828.
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.

Math.exp
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.exp(x)
Parmetros

El exponente; un nmero o expresin.

Valor devuelto

Un nmero.
Descripcin

Mtodo; devuelve el valor de la base del logaritmo natural (e) elevado a la potencia del exponente especificado en el parmetro x. La constante Math.E proporciona el valor de e.

Diccionario de ActionScript 297

Math.floor
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.floor(x)
Parmetros

Un nmero o expresin.

Valor devuelto

Un nmero.
Descripcin

Mtodo; devuelve el lmite inferior del nmero o expresin especificada en el parmetro x. Este valor es el nmero entero ms cercano que es menor o igual que el nmero o expresin especificada.
Ejemplo

El cdigo siguiente devuelve el valor 12.

Math.floor(12.5);

Math.log
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.log(x)
Parmetros

Un nmero o expresin con un valor mayor que 0.

Valor devuelto

Un nmero.
Descripcin

Mtodo; devuelve el logaritmo natural del parmetro x.

298

Math.LOG2E
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.LOG2E
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Constante; una constante matemtica para el logaritmo en base 2 de la constante e (Math.E), expresada como loge2, con un valor aproximado de 1,442695040888963387.

Math.LOG10E
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.LOG10E
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Constante; una constante matemtica para el logaritmo en base 10 de la constante e (Math.E), expresada como log10e, con un valor aproximado de 0,43429448190325181667.

Math.LN2
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.LN2
Parmetros

Ninguno.

Diccionario de ActionScript 299

Valor devuelto

Ninguno.
Descripcin

Constante; una constante matemtica para el logaritmo natural en base 2, expresada como loge2, con un valor aproximado de 0,69314718055994528623.

Math.LN10
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.LN10
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Constante; una constante matemtica para el logaritmo natural en base 10, expresada como loge10, con un valor aproximado de 2,3025850929940459011.

Math.max
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.max(x , y)
Parmetros

x y

Un nmero o expresin. Un nmero o expresin.

Valor devuelto

Un nmero.
Descripcin

Mtodo; calcula el resultado de x e y y devuelve el valor mayor.

300

Math.min
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.min(x , y)
Parmetros

x y

Un nmero o expresin. Un nmero o expresin.

Valor devuelto

Ninguno.
Descripcin

Mtodo; calcula el resultado de x e y y devuelve el valor menor.

Math.PI
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.PI
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Constante; una constante matemtica que expresa la relacin entre la circunferencia de un crculo y su dimetro, expresada como pi, con el valor 3,14159265358979.

Math.pow
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.pow(x , y)
Parmetros

Un nmero que se va a elevar a una potencia.

Diccionario de ActionScript 301

Un nmero que especifica una potencia a la que se eleva el parmetro x.

Valor devuelto

Un nmero.
Descripcin

Mtodo; calcula y devuelve x elevado a la potencia y, xy.

Math.random
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.random()
Parmetros

Ninguno.
Valor devuelto

Un nmero.
Descripcin

Mtodo; devuelve n, donde 0 <= n < 1.

Vase tambin

random

Math.round
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.round(x)
Parmetros

Un nmero.

Valor devuelto

Un nmero.
Descripcin

Mtodo; redondea el valor del parmetro x por exceso o por defecto al nmero entero ms cercano y devuelve el valor.

302

Math.sin
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y las propiedades del objeto Math por medio de aproximaciones, y puede que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.sin(x)
Parmetros

Un ngulo medido en radianes.

Valor devuelto

Ninguno.
Descripcin

Mtodo; calcula y devuelve el seno del ngulo especificado en radianes. Utilice la informacin que se explic en la introduccin del objeto Math para calcular un radin.

Math.sqrt
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.sqrt(x)
Parmetros

Un nmero o expresin mayor o igual que 0.

Valor devuelto

Un nmero.
Descripcin

Mtodo; calcula y devuelve la raz cuadrada del nmero especificado.

Math.SQRT1_2
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.SQRT1_2
Parmetros

Ninguno.

Diccionario de ActionScript 303

Valor devuelto

Ninguno.
Descripcin

Constante; una constante matemtica para el recproco de la raz cuadrada de un medio (1/2), con un valor aproximado de 0,707106781186.

Math.SQRT2
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.SQRT2
Parmetros

Ninguno.
Descripcin

Constante; una constante matemtica para la raz cuadrada de 2, con un valor aproximado de 1,414213562373.

Math.tan
Disponibilidad

Flash Player 5. En Flash Player 4, se emulan los mtodos y propiedades del objeto Math usando aproximaciones y es posible que no sean tan precisos como las funciones matemticas no emuladas que incluye Flash Player 5.
Sintaxis

Math.tan(x)
Parmetros

Un ngulo medido en radianes.

Valor devuelto

Un nmero.
Descripcin

Mtodo; calcula y devuelve la tangente del ngulo especificado. Para calcular los radianes, utilice la informacin que se explic en la introduccin del objeto Math (objeto).

304

maxscroll
Disponibilidad

Flash Player 4.
Sintaxis

nombre_variable.maxscroll
Descripcin

Propiedad (slo lectura); propiedad desestimada que indica el nmero de la lnea de texto superior 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 la forma de mostrar informacin en un campo de texto. Este propiedad puede recuperarse, pero no modificarse.
Vase tambin

TextField.maxscroll, TextField.scroll

mbchr
Disponibilidad

Flash Player 4. Esta funcin se ha desestimado; se recomienda utilizar el mtodo String.fromCharCode.

Sintaxis

mbchr(nmero)
Parmetros

nmero

El nmero que se convierte en carcter multibyte.

Valor devuelto

Una cadena.
Descripcin

Funcin de cadena; convierte un nmero de cdigo ASCII en un carcter multibyte.

Vase tambin

String.fromCharCode

mblength
Disponibilidad

Flash Player 4. Esta funcin se ha desestimado; se recomienda utilizar String (objeto).

Sintaxis

mblength(cadena)
Parmetros

cadena

Una cadena.

Valor devuelto

Un nmero.
Descripcin

Funcin de cadena; devuelve la longitud de la cadena de caracteres multibyte.

Diccionario de ActionScript 305

mbord
Disponibilidad

Flash Player 4. Esta funcin se ha desestimado en Flash 5; se recomienda utilizar el mtodo String.charCodeAt.
Sintaxis

mbord(carcter)
Parmetros

carcter

El carcter que se convierte en un nmero multibyte.

Valor devuelto

Un nmero.
Descripcin

Funcin de cadena; convierte el carcter especificado en un nmero multibyte.

Vase tambin

String.fromCharCode

mbsubstring
Disponibilidad

Flash Player 4. Esta funcin se ha desestimado en Flash 5; se recomienda utilizar el mtodo String.substr.
Sintaxis

mbsubstring(valor, ndice, conteo)

Parmetros

valor ndice conteo

La cadena multibyte de la que se debe extraer una nueva cadena multibyte. Nmero del primer carcter que se va a extraer. Nmero de caracteres que se van a incluir en la cadena extrada, sin incluir el carcter de

ndice.
Valor devuelto

Una cadena.
Descripcin

Funcin de cadena; extrae una nueva cadena de caracteres multibyte de una cadena de caracteres multibyte.
Vase tambin

String.substr

306

method
Disponibilidad

Flash Player 6.
Sintaxis

objeto.mtodo = function ([parmetros]) { ...cuerpo de la funcin... };

Parmetros

objeto mtodo

Un identificador de un objeto. Un identificador de un mtodo. Parmetros para pasar a la funcin. Parmetro opcional.

parmetros

Valor devuelto

Ninguno.
Descripcin

Accin (slo modo Normal); permite definir mtodos para objetos a travs del panel Acciones en modo Normal. Para obtener ms informacin sobre cmo definir mtodos para objetos, consulte la publicacin Utilizacin de Flash.

Mouse (objeto)
El objeto Mouse es un objeto de nivel superior al que puede acceder sin utilizar un constructor. Puede utilizar los mtodos del objeto Mouse para ocultar y mostrar el cursor en la pelcula. El puntero del ratn est visible de forma predeterminada, pero puede ocultarlo e implementar un puntero personalizado creado con un clip de pelcula. Resumen de los mtodos de Mouse
Mtodo Mouse.addListener Mouse.hide Mouse.removeListener Mouse.show Descripcin Registra un objeto para que reciba las notificaciones onMouseDown, onMouseMove y onMouseUp. Oculta el puntero del ratn en la pelcula. Elimina un objeto registrado con el mtodo addListener. Muestra el puntero del ratn en la pelcula.

Resumen de los detectores del objeto Mouse

Mtodo MovieClip.onMouseDown MovieClip.onMouseMove MovieClip.onMouseUp Descripcin Recibe notificacin cuando se presiona el botn del ratn. Recibe notificacin cuando se mueve el botn del ratn. Recibe notificacin cuando se suelta el botn del ratn.

Diccionario de ActionScript 307

Mouse.addListener
Disponibilidad

Flash Player 6.
Sintaxis

Mouse.addListener (nuevoDetector)
Parmetros

nuevoDetector
Valor devuelto

Un objeto.

Ninguno.
Descripcin

Mtodo; registra un objeto para que reciba notificaciones de los controladores callback onMouseDown, onMouseMove y onMouseUp. El parmetro nuevoDetector debe contener onMouseDown, onMouseMove y onMouseUp. un objeto con mtodos definidos para los eventos

Al presionar, mover o soltar el ratn, independientemente de la seleccin de entrada, se invoca el mtodo onMouseDown, onMouseMove o onMouseUp de todos los objetos de deteccin registrados con el mtodo addListener. Varios objetos pueden detectar notificaciones de teclado. Si el detector nuevoDetector ya est registrado, no se produce ningn cambio.

Mouse.hide
Disponibilidad

Flash Player 5.
Sintaxis

Mouse.hide()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; oculta el cursor en una pelcula. El cursor es visible de modo predeterminado.

Ejemplo

El cdigo siguiente, asociado a un clip de pelcula en la lnea de tiempo principal, oculta el cursor estndar y establece las posiciones de x e y de la instancia del clip de pelcula customCursor en las posiciones de ratn x e y en la lnea de tiempo principal.
onClipEvent(enterFrame){ Mouse.hide(); customCursorMC._x = _root._xmouse; customCursorMC._y = _root._ymouse; }

308

Vase tambin

Mouse.show, MovieClip._xmouse, MovieClip._ymouse

Mouse.onMouseDown
Disponibilidad

Flash Player 6.
Sintaxis

someListener.onMouseDown
Descripcin

Detector; recibe notificacin cuando se presiona el ratn. Para utilizar el detector onMouseDown, debe crear un objeto detector. A continuacin, puede definir una funcin para onMouseDown y utilizar el mtodo addListener para registrar el detector en el objeto Mouse, como en el caso siguiente:
someListener = new Object(); someListener.onMouseDown = function () { ... }; Mouse.addListener(someListener);

Los detectores permiten que varios fragmentos de cdigo cooperen, ya que varios detectores pueden recibir notificaciones sobre un mismo evento.
Vase tambin

Mouse.addListener

Mouse.onMouseMove
Disponibilidad

Flash Player 6.
Sintaxis

someListener.onMouseMove
Descripcin

Detector; recibe notificacin cuando se mueve el ratn. Para utilizar el detector onMouseMove, debe crear un objeto detector. A continuacin, puede definir una funcin para onMouseMove y utilizar el mtodo addListener para registrar el detector en el objeto Mouse, como en el caso siguiente:
someListener = new Object(); someListener.onMouseMove = function () { ... }; Mouse.addListener(someListener);

Los detectores permiten que varios fragmentos de cdigo cooperen, ya que varios detectores pueden recibir notificaciones sobre un mismo evento.
Vase tambin

Mouse.addListener

Diccionario de ActionScript 309

Mouse.onMouseUp
Disponibilidad

Flash Player 6.
Sintaxis

someListener.onMouseUp
Descripcin

Detector; recibe notificacin cuando se suelta el ratn. Para utilizar el detector onMouseUp, debe crear un objeto detector. A continuacin, puede definir una funcin para onMouseUp y utilizar el mtodo addListener para registrar el detector en el objeto Mouse, como en el caso siguiente:
someListener = new Object(); someListener.onMouseUp = function () { ... }; Mouse.addListener(someListener);

Los detectores permiten que varios fragmentos de cdigo cooperen, ya que varios detectores pueden recibir notificaciones sobre un mismo evento.
Vase tambin

Mouse.addListener

Mouse.removeListener
Disponibilidad

Flash Player 6.
Sintaxis

Mouse.removeListener (detector)
Parmetros

detector

Un objeto.

Valor devuelto

Si el objeto detector se ha eliminado correctamente, el mtodo devuelve el valor true; si el detector no se ha eliminado correctamente (por ejemplo, si el detector no se encontraba en la lista de detectores del objeto Mouse), el mtodo devuelve el valor false.
Descripcin

Mtodo; elimina un objeto registrado previamente con el mtodo addListener.

Mouse.show
Disponibilidad

Flash Player 5.
Sintaxis

Mouse.show()
Parmetros

Ninguno.
Valor devuelto

Ninguno.

310

Descripcin

Mtodo; muestra el cursor en una pelcula. El cursor es visible de modo predeterminado.

Vase tambin

Mouse.show, MovieClip._xmouse, MovieClip._ymouse

MovieClip (objeto)
Los mtodos del objeto MovieClip proporcionan la misma funcionalidad que las acciones que seleccionan clips de pelcula como destino. Tambin existen mtodos adicionales que no tienen acciones equivalentes en la caja de herramientas Acciones del panel Acciones. No es necesario utilizar un mtodo constructor para poder llamar a los mtodos del objeto MovieClip; en lugar de eso, haga referencia a las instancias de clip de pelcula por nombre, mediante la sintaxis siguiente:
myMovieClip.play(); myMovieClip.gotoAndPlay(3);

Diccionario de ActionScript

311

Resumen de los mtodos del objeto MovieClip

Mtodo MovieClip.attachMovie MovieClip.createEmptyMovieClip MovieClip.createTextField MovieClip.duplicateMovieClip MovieClip.getBounds MovieClip.getBytesLoaded MovieClip.getBytesTotal MovieClip.getDepth MovieClip.getURL MovieClip.globalToLocal MovieClip.gotoAndPlay MovieClip.gotoAndStop MovieClip.hitTest Descripcin Asocia una pelcula de la biblioteca. Crea un clip de pelcula vaco. Crea un campo de texto vaco. Duplica el clip de pelcula especificado. Devuelve el mximo y el mnimo de las coordenadas x e y de una pelcula en un espacio de coordenadas especificado. Devuelve el nmero de bytes cargados para el clip de pelcula especificado. Devuelve el tamao del clip de pelcula en bytes. Devuelve la profundidad de un clip de pelcula. Recupera un documento de un URL. Convierte el objeto punto de las coordenadas del escenario a las coordenadas locales del clip de pelcula especificado. Enva la cabeza lectora a un fotograma especfico en el clip de pelcula y reproduce la pelcula. Enva la cabeza lectora a un fotograma especfico en el clip de pelcula y detiene la pelcula. Devuelve true si el recuadro de delimitacin del clip de pelcula especificado se cruza con el recuadro de delimitacin del clip de pelcula de destino. Carga la pelcula especificada en el clip de pelcula. Carga variables de un URL u otra ubicacin en el clip de pelcula. Convierte un objeto Point de las coordenadas locales del clip de pelcula a las coordenadas del escenario global. Enva la cabeza lectora al fotograma siguiente del clip de pelcula. Reproduce el clip de pelcula especificado. Enva la cabeza lectora al fotograma anterior del clip de pelcula. Elimina el clip de pelcula de la lnea de tiempo, si se ha creado con una accin o mtodo duplicateMovieClip o con el mtodo attachMovie. Especifica un clip de pelcula como una mscara para otro clip de pelcula. Especifica un clip de pelcula como arrastrable y comienza a arrastrar el clip de pelcula. Detiene la pelcula que se est reproduciendo actualmente. Detiene el arrastrado de cualquier pelcula que se est arrastrando. Intercambia el nivel de profundidad de dos pelculas. Elimina una pelcula que se ha cargado con la accin loadMovie.

MovieClip.loadMovie MovieClip.loadVariables MovieClip.localToGlobal MovieClip.nextFrame MovieClip.play MovieClip.prevFrame MovieClip.removeMovieClip MovieClip.setMask MovieClip.startDrag MovieClip.stop MovieClip.stopDrag MovieClip.swapDepths MovieClip.unloadMovie

312

Resumen de los mtodos de dibujo del objeto MovieClip

Mtodo MovieClip.beginFill MovieClip.beginGradientFill MovieClip.clear MovieClip.curveTo MovieClip.endFill MovieClip.lineStyle MovieClip.lineTo MovieClip.moveTo Descripcin Empieza a dibujar un relleno en el escenario. Empieza a dibujar un relleno en degradado en el escenario. Elimina todos los comandos de dibujo asociados con una instancia de clip de pelcula. Dibuja una curva con el ltimo estilo de lnea. Finaliza el relleno especificado mediante beginFill o beginGradientFill. Define el trazo de las lneas creadas con los mtodos lineTo y curveTo. Dibuja una lnea con el estilo de lnea actual. Mueve la posicin actual del dibujo a las coordenadas especificadas.

Resumen de las propiedades del objeto MovieClip

Propiedad MovieClip._alpha MovieClip._currentframe MovieClip._droptarget MovieClip.enabled MovieClip.focusEnabled MovieClip._focusrect MovieClip._framesloaded MovieClip._height MovieClip.hitArea MovieClip._highquality MovieClip._name MovieClip._parent MovieClip._rotation MovieClip._soundbuftime MovieClip.tabChildren MovieClip.tabEnabled MovieClip.tabIndex MovieClip._target MovieClip._totalframes MovieClip.trackAsMenu Descripcin Valor de transparencia de una instancia de clip de pelcula. Nmero de fotograma en el que se encuentra la cabeza lectora. Ruta absoluta en notacin de sintaxis con barras de la instancia de clip de pelcula en el que se solt un clip de pelcula que se puede arrastrar. Indica si el clip de pelcula de botn est activado. Permite que un clip de pelcula puede seleccionarse. Indica si un clip de pelcula seleccionado tiene un rectngulo amarillo a su alrededor. Nmero de fotogramas que se han cargado de una pelcula. Altura de una instancia de clip de pelcula en pxeles. Designa otro clip de pelcula que sirve como el rea activa para un clip de pelcula de botn. Establece la calidad de representacin de una pelcula. Nombre de instancia de una instancia de clip de pelcula. Referencia al clip de pelcula que incluye el clip de pelcula. Grado de rotacin de una instancia de clip de pelcula. Nmero de segundos antes de que empiece el sonido. Indica si los elementos secundarios de un clip de pelcula se incluyen en el orden de tabulacin automtico. Indica si un clip de pelcula se incluye en el orden de tabulacin. Indica el orden de tabulacin de un objeto. Ruta de destino de una instancia de clip de pelcula. Nmero total de fotogramas en una instancia de clip de pelcula. Indica si otros botones pueden recibir eventos al soltar el ratn.

Diccionario de ActionScript 313

Propiedad MovieClip._url MovieClip.useHandCursor MovieClip._visible MovieClip._width MovieClip._x MovieClip._xmouse MovieClip._xscale MovieClip._y MovieClip._ymouse MovieClip._yscale

Descripcin El URL del archivo SWF del que se ha descargado un clip de pelcula. Determina si la mano aparece cuando un usuario se sita sobre un clip de pelcula de botn. Valor booleano que determina si una instancia de clip de pelcula est oculta o visible. Anchura de una instancia de clip de pelcula en pxeles. Coordenada x de una instancia de clip de pelcula. Coordenada x del cursor dentro de una instancia de clip de pelcula. Valor que especifica el porcentaje de una escala horizontal de un clip de pelcula. Coordenada y de una instancia de clip de pelcula. Coordenada y del cursor dentro de una instancia de clip de pelcula. Valor que especifica el porcentaje de escala vertical de un clip de pelcula.

Resumen del controlador de eventos del objeto MovieClip

Propiedad MovieClip.onData MovieClip.onDragOut Descripcin Se invoca cuando todos los datos se han cargado en un clip de pelcula. Se invoca mientras el puntero se encuentra fuera del botn; el botn del ratn se presiona dentro y, a continuacin, se desplaza fuera del rea del botn. Se invoca mientras el puntero se encuentra sobre el botn; se ha presionado el botn del ratn, se ha desplazado fuera del botn y, a continuacin, se ha vuelto a desplazar sobre el botn. Se invoca de forma continua a la velocidad de los fotogramas de la pelcula. Las acciones asociadas con el evento de clip enterFrame se procesan antes que cualquiera de las acciones de fotogramas asociadas a los fotogramas afectados. Se invoca cuando se presiona una tecla. Utilice los mtodos Key.getCode y Key.getAscii para recuperar informacin sobre la ltima tecla presionada. Se invoca cuando se suelta una tecla. Se invoca cuando se pierde la seleccin de un botn. Se invoca cuando se crea una instancia del clip de pelcula y aparece en la lnea de tiempo. Se invoca cuando se presiona el botn izquierdo del ratn. Se invoca cada vez que se mueve el ratn. Se invoca cuando se suelta el botn izquierdo del ratn. Se invoca cuando se presiona el ratn mientras el puntero est sobre un botn. Se invoca cuando se suelta el ratn mientras el puntero est sobre un botn. Se invoca cuando se suelta el ratn mientras el puntero est fuera del botn despus de presionar el botn mientras el puntero est dentro del botn.

MovieClip.onDragOver

MovieClip.onEnterFrame

MovieClip.onKeyDown

MovieClip.onKeyUp MovieClip.onKillFocus MovieClip.onLoad MovieClip.onMouseDown MovieClip.onMouseMove MovieClip.onMouseUp MovieClip.onPress MovieClip.onRelease MovieClip.onReleaseOutside

314

Propiedad MovieClip.onRollOut MovieClip.onRollOver MovieClip.onSetFocus MovieClip.onUnload

Descripcin Se invoca cuando el puntero se desplaza fuera del rea de un botn. Se invoca cuando el puntero del ratn se desplaza sobre un botn. Se invoca cuando un botn tiene la seleccin de entrada y se suelta una tecla. Se invoca 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 que se asocien acciones al fotograma afectado.

MovieClip._alpha
Disponibilidad

Flash Player 4.
Sintaxis

myMovieClip._alpha
Descripcin

Propiedad; define o recupera la transparencia alfa (valor) del clip de pelcula especificado por MovieClip. Los valores vlidos van de 0 (completamente transparente) a 100 (completamente opaco). Los objetos de un clip de pelcula con _alpha establecido en 0 estn activos, aunque sean invisibles. Por ejemplo, incluso puede hacer clic en un botn de un clip de pelcula con la propiedad _alpha establecida en 0.
Ejemplo

Las sentencias siguientes establecen la propiedad _alpha de un clip de pelcula llamado star en un 30% al hacer clic en el botn:
on(release) { star._alpha = 30; }

MovieClip.attachMovie
Disponibilidad

Flash Player 5.
Sintaxis

myMovieClip.attachMovie( idNombre, nuevoNombre, profundidad [, objetoInicial] )

Parmetros

idNombre

El nombre de vnculo de un smbolo de clip de pelcula de la biblioteca para asociarlo a un clip de pelcula del escenario. Este es el nombre introducido en el campo Identificador en el cuadro de dilogo Propiedades de vnculos de smbolos. Un nombre de instancia exclusivo para el clip de pelcula que se asocia al clip de Un nmero entero que especifica el nivel de profundidad en el que se encuentra

nuevoNombre

pelcula.
profundidad

la pelcula.

Diccionario de ActionScript 315

objetoInicial Un objeto que contiene las propiedades con las que se debe rellenar el clip de pelcula recin asociado. Este parmetro permite que los clips de pelcula creados de forma dinmica puedan recibir parmetros de clip. Si el parmetro objetoInicial no es un objeto, se pasar por alto. Todas las propiedades de objetoInicial se copian en una instancia nueva. Las propiedades especificadas con objetoInicial estn disponibles para la funcin constructor. Este parmetro es opcional.
Valor devuelto

Ninguno.
Descripcin

Mtodo; selecciona un smbolo de la biblioteca y lo asocia a la pelcula del escenario especificado por MovieClip. Utilice la accin o el mtodo removeMovieClip o unloadMovie para eliminar una pelcula asociada con attachMovie.
Ejemplo

En el ejemplo siguiente se asocia el smbolo con el identificador de vnculo circle a la instancia de clip de pelcula, que se encuentra en el escenario de la pelcula.
on (release) { thing.attachMovie( "circle", "circle1", 2 ); }
Vase tambin

MovieClip.removeMovieClip, MovieClip.unloadMovie, Object.registerClass, removeMovieClip

MovieClip.beginFill
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.beginFill ([rgb[, alfa]])

Parmetro

rgb Un valor de color hexadecimal (por ejemplo, rojo es 0xFF0000, azul es 0x0000FF, etc.). Si este valor no se proporciona o no est definido, no se crea un relleno. alfa

Un nmero entero entre 0 y 100 que especifica el valor alfa del relleno. Si no se proporciona este valor, se utiliza el valor 100 (slido). Si el valor es inferior a 0, Flash utiliza el valor 0. Si el valor es superior a 100, Flash utiliza el valor 100.

Valor devuelto

Ninguno.
Descripcin

Mtodo; indica el comienzo de un nuevo trazado de dibujo. Si hay un trazado abierto (es decir, si la posicin actual del dibujo no es la misma que la posicin anterior especificada en un mtodo moveTo) y ste tiene un relleno asociado, el trazado se cierra con una lnea y, a continuacin, se rellena. Es parecido a lo que sucede cuando se llama al mtodo endFill.
Vase tambin

MovieClip.beginGradientFill, MovieClip.endFill

316

MovieClip.beginGradientFill
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.beginGradientFill (tipoRelleno, colores, alfas, relaciones, matriz)

Parmetro

tipoRelleno

La cadena "linear" o la cadena "radial".

colores Una matriz de valores de color hexadecimales RGB que debe utilizarse en el degradado (por ejemplo, rojo es 0xFF0000, azul es 0x0000FF, etc.). alfas

Una matriz de valores alfa para los colores correspondientes en la matriz colores. Los valores vlidos van de 0 a 100. Si el valor es inferior a 0, Flash utiliza el valor 0. Si el valor es superior a 100, Flash utiliza el valor 100.

relaciones Una matriz de relaciones de distribucin de colores. Los valores vlidos van de 0 a 255. Este valor define el porcentaje de la anchura en la que el color se muestrea al cien por cien. matriz Una matriz de transformacin que es un objeto con uno de los dos siguientes conjuntos de propiedades.

a, b, c, d, e, f, g, h, i pueden utilizarse para describir una matriz de 3 x 3 del modo siguiente:

a b c d e f g h i

En el ejemplo siguiente se utiliza el mtodo beginGradientFill con un parmetro matriz que es un objeto con estas propiedades.
_root.createEmptyMovieClip( "grad", 1 ); with ( _root.grad ) { colors = [ 0xFF0000, 0x0000FF ]; 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( "linear", colors, alphas, ratios, matrix ); moveto(100,100); lineto(100,300); lineto(300,300); lineto(300,100); lineto(100,100); endFill(); }

Diccionario de ActionScript 317

Si no existe una propiedad tipoMatriz, todos los dems parmetros son necesarios; la funcin falla si falta alguno de estos parmetros. Esta matriz cambia la escala, transforma, gira y sesga el degradado de la unidad definida en (-1,-1) y (1,1).<

tipoMatriz, x, y, w, h, r.

Estas propiedades indican lo siguiente: tipoMatrix es la cadena "box", x es la posicin horizontal relativa al punto de registro del clip principal para la esquina superior izquierda del degradado, y es la posicin vertical relativa al punto de registro del clip principal para la esquina superior izquierda del degradado, w es la anchura del degradado, h es la altura del degradado y r es la rotacin en radianes del degradado. En el ejemplo siguiente se utiliza el mtodo beginGradientFill con un parmetro matriz que es un objeto con estas propiedades.
_root.createEmptyMovieClip( "grad", 1 ); with ( _root.grad ) { colors = [ 0xFF0000, 0x0000FF ]; alphas = [ 100, 100 ]; ratios = [ 0, 0xFF ]; matrix = { matrixType:"box", x:100, y:100, w:200, h:200, r:(45/ 180)*Math.PI }; beginGradientFill( "linear", colors, alphas, ratios, matrix ); moveto(100,100); lineto(100,300); lineto(300,300); lineto(300,100); lineto(100,100); endFill(); }

318

Si existe una propiedad tipoMatriz, debe ser igual a "box" y todos los dems parmetros son obligatorios. La funcin falla si no se cumple alguna de estas condiciones.

Valor devuelto

Ninguno.
Descripcin

Mtodo; indica el comienzo de un nuevo trazado de dibujo. Si el primer parmetro tiene el valor undefined, o si no se pasa ningn parmetro, el trazado no tiene relleno. Si hay un trazado abierto (es decir, si la posicin actual del dibujo no es la misma que la posicin anterior especificada en un mtodo moveTo) y ste tiene un relleno asociado, el trazado se cierra con una lnea y, a continuacin, se rellena. Es parecido a lo que sucede cuando se llama al mtodo endFill. Este mtodo falla si se produce alguna de las condiciones siguientes:

El nmero de elementos de los parmetros colors, alphas y ratios no coincide. El parmetro tipoRelleno no es linear o radial. Alguno de los campos del objeto para el parmetro matriz no es vlido o falta.

Diccionario de ActionScript 319

Ejemplo

El cdigo siguiente utiliza ambos mtodos para dibujar dos rectngulos apilados con un relleno en degradado rojo-azul y un trazo de 5 puntos de color verde slido.
_root.createEmptyMovieClip("goober",1); with ( _root.goober ) { colors = [ 0xFF0000, 0x0000FF ]; alphas = [ 100, 100 ]; ratios = [ 0, 0xFF ]; lineStyle( 5, 0x00ff00 ); matrix = { a:500,b:0,c:0,d:0,e:200,f:0,g:350,h:200,i:1}; beginGradientFill( "linear", colors, alphas, ratios, matrix ); moveto(100,100); lineto(100,300); lineto(600,300); lineto(600,100); lineto(100,100); endFill(); matrix = { matrixType:"box", x:100, y:310, w:500, h:200, r:(0/180)*Math.PI }; beginGradientFill( "linear", colors, alphas, ratios, matrix ); moveto(100,310); lineto(100,510); lineto(600,510); lineto(600,310); lineto(100,310); endFill(); }

Vase tambin

MovieClip.beginFill, MovieClip.endFill, MovieClip.lineStyle, MovieClip.lineTo, MovieClip.moveTo

320

MovieClip.clear
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.clear()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; elimina todos los comandos de dibujo asociados con un clip de pelcula. No afecta a las formas y lneas que se dibujan con las herramientas de dibujo de Flash. Si se llama al mtodo clear, tambin se elimina el estilo de lnea actual.
Vase tambin

MovieClip.lineStyle

MovieClip.createEmptyMovieClip
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.createEmptyMovieClip (nombreInstancia, profundidad)

Parmetro

nombreInstancia profundidad
Valor devuelto

Una cadena que identifica el nombre de instancia del clip de pelcula nuevo.

Un nmero entero que especifica la profundidad del clip de pelcula nuevo.

Ninguno.
Descripcin

Mtodo; crea un clip de pelcula vaco como un elemento secundario de un clip de pelcula existente. Este mtodo se comporta de forma parecida al mtodo attachMovie, pero no es necesario proporcionar un nombre de vnculo externo para el nuevo clip de pelcula. El punto de registro para un clip de pelcula vaco recin creado es la esquina superior izquierda. Este mtodo falla si falta alguno de estos parmetros.
Vase tambin

MovieClip.attachMovie

Diccionario de ActionScript 321

MovieClip.createTextField
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.createTextField (nombreInstancia, profundidad, x, y, anchura, altura)

Parmetros

nombreInstancia profundidad x y

Una cadena que identifica el nombre de instancia del campo de texto nuevo.

Un nmero entero positivo que especifica la profundidad del campo de texto nuevo.

Un nmero entero que especifica la coordenada x del campo de texto nuevo. Un nmero entero que especifica la coordenada y del campo de texto nuevo. Un nmero entero positivo que especifica la anchura del campo de texto nuevo. Un nmero entero positivo que especifica la altura del campo de texto nuevo.

anchura altura

Valor devuelto

Ninguno.
Descripcin

Mtodo; crea un nuevo campo de texto vaco como elemento secundario del clip de pelcula especificado por el parmetro MovieClip. Puede utilizar el mtodo createTextField para crear campos de texto mientras se reproduce una pelcula. El campo de texto se sita en (x, y) con las dimensiones anchura por altura. Los parmetros x e y se refieren al clip de pelcula contenedor; estos parmetros corresponden a las propiedades _x e _y del campo de texto. Los parmetros anchura y altura 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, variable = null, maxChars = null

Un campo de texto creado con createTextField recibe el siguiente objeto TextFormat predeterminado:
font = "Times New Roman" size = 12 ctextColor = 0x000000 bold = false italic = false, underline = false url = "" target = "" align = "left" leftMargin = 0 rightMargin = 0 indent = 0 leading = 0 bullet = false tabStops = [] (empty array)

322

Ejemplo

En el ejemplo siguiente se crea un campo de texto cuya anchura es 300, la altura es 100, la coordenada x es 100, la coordenada y es 100, sin borde, texto de color rojo y subrayado.
_root.createTextField("mytext",1,100,100,300,100); mytext.multiline = true; mytext.wordWrap = true; mytext.border = false; myformat = new TextFormat(); myformat.color = 0xff0000; myformat.bullet = false; myformat.underline = true; mytext.text = "este es mi primer texto de objeto de campo de prueba"; mytext.setTextFormat(myformat);
Vase tambin

TextFormat (objeto)

MovieClip._currentframe
Disponibilidad

Flash Player 4.
Sintaxis

myMovieClip._currentframe
Descripcin

Propiedad (slo lectura); devuelve el nmero del fotograma en el que se encuentra la cabeza lectora en la lnea de tiempo especificada por MovieClip.
Ejemplo

En el ejemplo siguiente se utiliza la propiedad _currentframe para que la cabeza lectora del clip de pelcula actionClip avance cinco fotogramas respecto a su ubicacin actual.
actionClip.gotoAndStop(_currentframe + 5);

MovieClip.curveTo
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.curveTo (controlX, controlY, anclaX, anclaY)

Parmetros

controlX controlY

Un nmero entero que especifica una posicin horizontal relativa al punto de registro del clip de pelcula principal del punto de control. Un nmero entero que especifica una posicin vertical relativa al punto de registro del clip de pelcula principal del punto de control.

anclaX Un nmero entero que especifica una posicin horizontal relativa al punto de registro del clip de pelcula principal del siguiente punto de anclaje.

Diccionario de ActionScript 323

anclaY Un nmero entero que especifica una posicin vertical relativa al punto de registro del clip de pelcula principal del siguiente punto de anclaje.
Valor devuelto

Ninguno.
Descripcin

Mtodos; dibuja una curva con el estilo de lnea actual desde la posicin actual del dibujo hasta (anclaX, anclaY) y utiliza el punto de control especificado por (controlX, controlY). La posicin actual del dibujo se establece en (anclaX, anclaY). Si el clip de pelcula que est dibujando contiene un contenido creado con las herramientas de dibujo de Flash, las llamadas a curveTo se dibujan por debajo de este contenido. Si llama a curveTo antes de que se llame a moveTo, la posicin actual del dibujo se establece de forma predeterminada en (0, 0). Si falta alguno de estos parmetros, el mtodo falla y la posicin del dibujo no se cambia.
Ejemplo

En el ejemplo siguiente se dibuja un crculo con una lnea de color azul slido muy fina y un relleno de color rojo slido.
_root.createEmptyMovieClip( "circle", 1 ); with ( _root.circle ) { lineStyle( 0, 0x0000FF, 100 ); beginFill( 0xFF0000 ); moveTo( 500, 500 ); curveTo( 600, 500, 600, 400 ); curveTo( 600, 300, 500, 300 ); curveTo( 400, 300, 400, 400 ); curveTo( 400, 500, 500, 500 ); endFill(); }
Vase tambin

MovieClip.beginFill, MovieClip.createEmptyMovieClip, MovieClip.endFill, MovieClip.lineStyle, MovieClip.lineTo, MovieClip.moveTo

MovieClip._droptarget
Disponibilidad

Flash Player 4.
Sintaxis

myMovieClip._droptarget
Descripcin

Propiedad (slo lectura); devuelve la ruta absoluta en notacin de sintaxis con barras de la instancia de clip de pelcula en el que MovieClip se solt. 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 en sintaxis con barras a una referencia en sintaxis con puntos.

324

Ejemplo

En el ejemplo siguiente se obtiene el valor de la propiedad _droptarget de la instancia de clip de pelcula garbage y se utiliza eval para convertirlo de sintaxis con barras a referencia de sintaxis con puntos. A continuacin, la referencia garbage se compara con la referencia a la instancia de clip de pelcula trash. Si las dos referencias son equivalentes, la visibilidad de garbage se establece en false. Si no son equivalentes, la instancia garbage se restablece a su posicin original.
if (eval(garbage._droptarget) == _root.trash) { garbage._visible = false; } else { garbage._x = x_pos; garbage._y = y_pos; }

Las variables x_pos e y_pos se establecen en el fotograma 1 de la pelcula con el script siguiente:
x_pos = garbage._x; y_pos = garbage._y;
Vase tambin

startDrag

MovieClip.duplicateMovieClip
Disponibilidad

Flash Player 5.
Sintaxis

myMovieClip.duplicateMovieClip(nuevoNombre, profundidad [,objetoInicial])

Parmetros

nuevoNombre profundidad

Un identificador nico para el clip de pelcula duplicado.

Un nmero nico que especifica la profundidad a la que debe colocarse la pelcula especificada.

objetoInicial Un objeto que contiene las propiedades con las que se debe rellenar el clip de pelcula duplicado. Este parmetro permite que los clips de pelcula creados de forma dinmica puedan recibir parmetros de clip. Si el parmetro objetoInicial no es un objeto, se pasar por alto. Todas las propiedades de objetoInicial se copian en una instancia nueva. Las propiedades especificadas con objetoInicial estn disponibles para la funcin constructor. Este parmetro es opcional.
Valor devuelto

Ninguno.
Descripcin

Mtodo; crea una instancia del clip de pelcula especificado mientras se reproduce la pelcula. Los clips de pelcula duplicados siempre empiezan a reproducirse en el fotograma 1, sin tener en cuenta en qu fotograma est el clip de pelcula original cuando se llama al mtodo duplicateMovieClip. Las variables del clip de pelcula principal no se copian en el clip de pelcula duplicado. Los clips de pelcula creados con el mtodo duplicateMovieClip no se duplican si se llama a duplicateMovieMethod en su clip de pelcula principal. Si se elimina el clip de pelcula principal tambin se elimina el clip de pelcula duplicado. Los clips de pelcula agregados con duplicateMovieClip pueden eliminarse con la accin o el mtodo removeMovieClip.
Vase tambin

duplicateMovieClip, MovieClip.removeMovieClip, removeMovieClip

Diccionario de ActionScript 325

MovieClip.enabled
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.enabled
Descripcin

Propiedad; un valor booleano que indica si un clip de pelcula de botn est activado. El valor predeterminado de enabled es true. Si enabled se establece en false, los mtodos y los eventos de accin on y los mtodos de callback del clip de pelcula de botn ya no se invocan y los fotogramas Sobre, Presionado y Reposo se desactivan. La propiedad enabled no afecta a la lnea de tiempo del clip de pelcula de botn; si se est reproduciendo un clip de pelcula, ste contina reproducindose. El clip de pelcula sigue recibiendo eventos de clip de pelcula (por ejemplo, mouseDown, mouseUp, keyDown y keyUp). La propiedad enabled slo controla las propiedades de tipo botn de un clip de pelcula de botn. Puede cambiar la propiedad enabled en cualquier momento; el clip de pelcula de botn modificado se activa o desactiva inmediatamente. La propiedad enabled puede leerse fuera de un objeto prototipo. Si enabled se establece en false, el objeto no se incluye en el orden de tabulacin automtico.

MovieClip.endFill
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.endFill()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; aplica un relleno a las lneas y curvas agregadas desde la ltima llamada al mtodo beginFill o beginGradientFill. Flash utiliza el relleno que se especific en la llamada anterior a beginFill o beginGradientFill. Si la posicin actual del dibujo no es la misma que la posicin anterior especificada en el mtodo moveTo y se define un relleno, el trazado se cierra con una lnea y se rellena.

326

MovieClip.focusEnabled
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.focusEnabled
Descripcin

Propiedad; si el valor es undefined o false, un clip de pelcula no puede recibir una seleccin de entrada a menos que sea un clip de pelcula de botn. Si el valor de la propiedad focusEnabled es true, un clip de pelcula puede recibir una seleccin de entrada aunque no sea un clip de pelcula de botn.

MovieClip._focusrect
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip._focusrect
Descripcin

Propiedad; un valor booleano que especifica si un clip de pelcula est rodeado por un rectngulo amarillo cuando se selecciona mediante el teclado. Esta propiedad puede prevalecer sobre la propiedad global _focusrect.

MovieClip._framesloaded
Disponibilidad

Flash Player 4.
Sintaxis

myMovieClip._framesloaded
Descripcin

Propiedad (slo lectura); el nmero de fotogramas que se han cargado de una pelcula. Esta propiedad es til para determinar si el contenido de un fotograma especfico y todos los fotogramas anteriores a l se han cargado y estn disponibles localmente en el navegador. Esta propiedad es til para controlar el proceso de descarga de pelculas grandes. Por ejemplo, puede que desee mostrar un mensaje a los usuarios indicando que la pelcula se est cargando hasta que se acabe de cargar un fotograma especificado de la pelcula.
Ejemplo

En el ejemplo siguiente se utiliza la propiedad _framesloaded para iniciar una pelcula una vez cargados todos los fotogramas. Si no se han cargado todos los fotogramas, la propiedad _xscale de la instancia de clip de pelcula loader aumenta proporcionalmente para crear una barra de progreso.
if (_framesloaded >= _totalframes) { gotoAndPlay ("Scene 1", "start"); } else { _root.loader._xscale = (_framesloaded/_totalframes)*100); }

Diccionario de ActionScript 327

MovieClip.getBounds
Disponibilidad

Flash Player 5.
Sintaxis

myMovieClip.getBounds(espacioCoordenadaDestino)
Parmetros

espacioCoordenadaDestino

La ruta de destino de la lnea de tiempo cuyo sistema de coordenadas desea utilizar como punto de referencia.

Valor devuelto

Un objeto con las propiedades xMin, xMax, yMin e yMax.

Descripcin

Mtodo; devuelve las propiedades que son los valores mximo y mnimo de las coordenadas x e y de la instancia especificada por MovieClip para el parmetro espacioCoordenadaDestino.
Nota: utilice los mtodos localToGlobal y globalToLocal del objeto MovieClip para convertir las coordenadas locales del clip de pelcula en las coordenadas del escenario, o para convertir las coordenadas del escenario en las coordenadas locales.

Ejemplo

En el ejemplo siguiente, el objeto que devuelve el mtodo getBounds se asigna al identificador clipBounds. Puede acceder a los valores de cada propiedad y utilizarlos en un script. En este script, se coloca otra instancia de clip de pelcula, clip2, junto a clip.
clipBounds = clip.getBounds(_root); clip2._x = clipBounds.xMax;
Vase tambin

MovieClip.globalToLocal, MovieClip.localToGlobal

MovieClip.getBytesLoaded
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.getBytesLoaded()
Parmetros

Ninguno.
Valor devuelto

Entero que indica el nmero de bytes cargados.

Descripcin

Mtodo; devuelve el nmero de bytes cargados (en flujo) para el objeto MovieClip especificado. Puede comparar el valor del mtodo getBytesLoaded con el valor del mtodo getBytesTotal para determinar el porcentaje que se ha cargado de un clip de pelcula.
Vase tambin

MovieClip.getBytesTotal

328

MovieClip.getBytesTotal
Disponibilidad

Flash Player 5.
Sintaxis

myMovieClip.getBytesTotal()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero que indica el tamao total, en bytes, del objeto MovieClip especificado.
Descripcin

Mtodo; devuelve el tamao, en bytes, del objeto MovieClip especificado. Para clips de pelcula que son externos (la pelcula raz o un clip de pelcula que se est cargando en un destino o en un nivel), el valor devuelto es el tamao del archivo SWF.
Vase tambin

MovieClip.getBytesLoaded

MovieClip.getDepth
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.getDepth
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve la profundidad de una instancia de clip de pelcula.

MovieClip.getURL
Disponibilidad

Flash Player 5.
Sintaxis

myMovieClip.getURL(URL [,ventana, variables])

Parmetros

URL

El URL del que se debe obtener el documento.

Diccionario de ActionScript 329

ventana Un parmetro opcional que especifica el nombre, el fotograma o la expresin que indica la ventana o el fotograma HTML en el que se carga el documento. Tambin puede utilizar uno de los siguientes nombres de destino reservados: _self especifica el fotograma actual de la ventana activa, _blank especifica una nueva ventana, _parent especifica el elemento principal del fotograma actual, _top especifica el fotograma de nivel superior de la ventana actual. variables Un parmetro opcional que especifica un mtodo para enviar variables asociadas con la pelcula que se va a cargar. Si no hay variables, no incluya este parmetro; en caso contrario, especifique si deben cargarse con los mtodos GET o POST. GET adjunta las variables al final del URL y se utiliza para un nmero pequeo de variables. POST enva las variables en un encabezado HTTP y se usa para cadenas largas de variables.
Valor devuelto

Ninguno.
Descripcin

Mtodo; carga un documento del URL especificado en la ventana especificada. El mtodo getURL tambin puede utilizarse para pasar variables a otra aplicacin definida en el URL mediante un mtodo GET o POST.
Vase tambin

getURL

MovieClip.globalToLocal
Disponibilidad

Flash Player 5.
Sintaxis

myMovieClip.globalToLocal(punto)
Parmetros

punto

El nombre o el identificador de un objeto creado con el objeto genrico Object que especifica las coordenadas x e y como propiedades.

Valor devuelto

Ninguno.
Descripcin

Mtodo; convierte el objeto punto de las coordenadas (globales) del escenario a las coordenadas (locales) del clip de pelcula.
Ejemplo

En el ejemplo siguiente se convierten las coordenadas globales x e y del objeto point a las coordenadas locales del clip de pelcula.
onClipEvent(mouseMove) { point = new object(); point.x = _root._xmouse; point.y = _root._ymouse; globalToLocal(point); trace(_root._xmouse + " " + _root._ymouse); trace(point.x + " " + point.y); updateAfterEvent(); }
Vase tambin

MovieClip.getBounds, MovieClip.localToGlobal

330

MovieClip.gotoAndPlay
Disponibilidad

Flash Player 5.
Sintaxis

myMovieClip.gotoAndPlay(fotograma)
Parmetros

fotograma

El nmero de fotograma al que se enva la cabeza lectora.

Valor devuelto

Ninguno.
Descripcin

Mtodo; comienza a reproducir la pelcula en el fotograma especificado.

Vase tambin

gotoAndPlay

MovieClip.gotoAndStop
Disponibilidad

Flash Player 5.
Sintaxis

myMovieClip.gotoAndStop(fotograma)
Parmetros

fotograma

El nmero de fotograma al que se enva la cabeza lectora.

Valor devuelto

Ninguno.
Descripcin

Mtodo; coloca la cabeza lectora en el fotograma especificado de este clip de pelcula y la detiene en ese punto.
Vase tambin

gotoAndStop

Diccionario de ActionScript 331

MovieClip._height
Disponibilidad

Flash Player 4.
Sintaxis

myMovieClip._height
Descripcin

Propiedad; establece y recupera la altura del clip de pelcula en pxeles.

Ejemplo

El cdigo de ejemplo siguiente establece la altura y la anchura de un clip de pelcula cuando el usuario hace clic sobre un botn.
onClipEvent(mouseDown) { _width=200; _height=200; }

MovieClip._highquality
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip._highquality
Descripcin

Propiedad (global); especifica el nivel de suavizado aplicado a la pelcula actual. Especifique 2 (BEST) para aplicar alta calidad con el suavizado de mapa de bits siempre activado. Especifique 1 (alta calidad) para aplicar suavizado; esto suavizar los mapas de bits si la pelcula no contiene animacin. Especifique 0 (baja calidad) para evitar el suavizado. Esta propiedad prevalece sobre la propiedad global _highquality.
Ejemplo

myMovieClip._highquality = 1;
Vase tambin

_quality, toggleHighQuality

MovieClip.hitArea
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.hitArea
Valor devuelto

Una referencia a un clip de pelcula.

332

Descripcin

Propiedad; designa otro clip de pelcula que sirve como el rea activa para un clip de pelcula de botn. Si la propiedad hitArea no existe o tiene el valor null o undefined, se utilizar el propio clip de pelcula de botn 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 de botn modificado asume de inmediato el comportamiento de la nueva rea activa. No es necesario que el clip de pelcula designado como rea activa sea visible; se comprueba la presencia de clics en su forma grfica, aunque no sea visible. La propiedad hitArea puede leerse fuera de un objeto prototipo.

MovieClip.hitTest
Disponibilidad

Flash Player 5.
Sintaxis

myMovieClip.hitTest(x, y, indicadorForma) myMovieClip.hitTest(destino)

Parmetros

x y

La coordenada x del rea activa del escenario. La coordenada y del rea activa del escenario.

Las coordenadas x e y se definen en el espacio de coordenadas global.

destino La ruta de destino del rea activa que puede cruzarse o solaparse con la instancia especificada por MovieClip. El parmetro destino normalmente representa un botn o un campo de introduccin de texto. indicadorForma Un valor booleano que especifica si se tiene en cuenta toda la forma de la instancia especificada (true) o solamente el recuadro de delimitacin (false). Este parmetro slo puede especificarse si el rea activa se ha identificado con los parmetros de coordenadas x e y.
Valor devuelto

Ninguno.
Descripcin

Mtodo; obtiene la instancia especificada por MovieClip para ver si se solapa o cruza con el rea activa identificada por el parmetro destino o los parmetros de coordenadas x e y. Sintaxis 1: compara las coordenadas x e y con la forma o el recuadro de delimitacin de la instancia especificada, segn el valor de indicadorForma. Si indicadorForma est establecido en true, slo se tiene en cuenta el rea que ocupa actualmente la instancia en el escenario; si x e y se solapan en algn punto, se devuelve el valor true. Esto es muy til para determinar si el clip de pelcula se encuentra dentro del rea activa especificada. Sintaxis 2: obtiene los recuadros de delimitacin de destino y de la instancia especificada y devuelve el valor true si se solapan o se cruzan en algn punto.
Ejemplo

En el ejemplo siguiente se utiliza hitTest con las propiedades x_mouse e y_mouse para determinar si el ratn se encuentra sobre el recuadro de delimitacin del destino:
if (hitTest( _root._xmouse, _root._ymouse, false));

Diccionario de ActionScript 333

En el ejemplo siguiente se utiliza hitTest para determinar si un clip de pelcula ball se solapa o se cruza con el clip de pelcula square:
if(_root.ball, hittest(_root.square)){ trace("ball se cruza con square"); }
Vase tambin

MovieClip.getBounds, MovieClip.globalToLocal, MovieClip.localToGlobal

MovieClip.lineStyle
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.lineStyle ([grosor[, rgb[, alfa]]])

Parmetros

grosor Un nmero entero que indica el grosor de la lnea en puntos. Los valores vlidos van de 0 a 255. Si no hay ningn nmero especificado, o si el parmetro tiene el valor undefined, no se dibujar la lnea. Si se especifica un valor inferior a 0, Flash utiliza 0. El valor 0 indica el grosor mnimo; el grosor mximo es 255. Si se especifica un valor superior a 255, el intrprete de Flash utiliza 255. rgb Un valor de color hexadecimal de la lnea (por ejemplo, rojo es 0xFF0000, azul es 0x0000FF, etc.). Si no se indica ningn valor, Flash utiliza el valor 0x000000 (negro). alfa Un nmero entero que indica el valor alfa del color de la lnea. Los valores vlidos van de 0 a 100. Si no se indica ningn valor, Flash utiliza 100 (slido). Si el valor es inferior a 0, Flash utiliza 0; si el valor es superior a 100, Flash utiliza 100.
Valor devuelto

Ninguno.
Descripcin

Mtodo; especifica un estilo de lnea que Flash utiliza para las siguientes llamadas a los mtodos lineTo y curveTo hasta que se llame a lineStyle con parmetros distintos. Puede llamar al mtodo lineStyle mientras dibuja un trazado para especificar diferentes estilos para distintos segmentos de lnea de un trazado.
Nota: las llamadas a clear restablecen el mtodo lineStyle en undefined.

Ejemplo

El cdigo siguiente dibuja un tringulo con una lnea de color magenta slido de 5 puntos sin relleno.
_root.createEmptyMovieClip( "triangle", 1 ); with ( _root.triangle ) { lineStyle( 5, 0xff00ff, 100 ); moveTo( 200, 200 ); lineTo( 300,300 ); lineTo( 100, 300 ); lineTo( 200, 200 ); }
Vase tambin

MovieClip.beginFill, MovieClip.beginGradientFill, MovieClip.clear, MovieClip.curveTo, MovieClip.lineTo, MovieClip.moveTo,

334

MovieClip.lineTo
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.lineTo (x, y)
Parmetros

x y

Un nmero entero que indica la posicin horizontal relativa al punto de registro del clip de pelcula principal.

Un nmero entero que indica la posicin vertical relativa al punto de registro del clip de pelcula principal.

Valor devuelto

Ninguno.
Descripcin

Mtodo; dibuja una lnea con el estilo de lnea actual desde la posicin del dibujo hasta (x, y); la posicin del dibujo se establece en (x, y). Si el clip de pelcula que est dibujando contiene un contenido creado con las herramientas de dibujo de Flash, las llamadas a lineTo se dibujan debajo del contenido. Si llama al mtodo lineTo antes de llamar al mtodo moveTo, la posicin del dibujo se establece de forma predeterminada en (0, 0). Si falta alguno de estos parmetros, el mtodo falla y la posicin del dibujo no se cambia.
Ejemplo

En el ejemplo siguiente se dibuja un tringulo sin lneas y con un relleno azul parcialmente transparente.
_root.createEmptyMovieClip ("triangle", 1); with (_root.triangle){ beginFill (0x0000FF, 50); lineStyle (5, 0xFF00FF, 100); moveTo (200, 200); lineTo (300, 300); lineTo (100, 300); lineTo (200, 200); endFill(); }
Vase tambin

MovieClip.beginFill, MovieClip.createEmptyMovieClip, MovieClip.endFill, MovieClip.lineStyle, MovieClip.moveTo

Diccionario de ActionScript 335

MovieClip.loadMovie
Disponibilidad

Flash Player 5.
Sintaxis

myMovieClip.loadMovie("url" [,variables])
Parmetros

url Un URL absoluto o relativo del archivo SWF o JPEG que se debe cargar. Una ruta relativa debe ser relativa respecto al archivo SWF de _level0. El URL debe pertenecer al mismo subdominio que el URL donde reside actualmente la pelcula. Para poder utilizarlos en Flash Player o para realizar pruebas en el modo de prueba en la aplicacin de edicin de Flash, todos los archivos SWF tienen que guardarse en la misma carpeta y los nombres de archivo no pueden incluir especificaciones de carpeta ni de unidad de disco.

Un parmetro opcional que especifica un mtodo HTTP para enviar o cargar variables. El parmetro debe ser la cadena GET o POST. Si no hay ninguna variable para enviar, no incluya este parmetro. El mtodo GET adjunta las variables al final del URL y se utiliza para un nmero pequeo de variables. El mtodo POST enva las variables en un encabezado HTTP distinto y se usa para cadenas largas de variables.
variables
Valor devuelto

Ninguno.
Descripcin

Mtodo; carga archivos SWF o JPEG en un clip de pelcula de Flash Player mientras se reproduce la pelcula original. Sin el mtodo loadMovie, Flash Player muestra una sola pelcula (archivo SWF) y despus se cierra. El mtodo loadMovie permite ver varias pelculas al mismo tiempo y pasar de una pelcula a otra sin cargar otro documento HTML. Una pelcula o imagen cargada en un clip de pelcula hereda las propiedades de posicin, rotacin y escala del clip de pelcula. Puede utilizar el ruta de destino del clip de pelcula para especificar el destino de la pelcula cargada. Utilice el mtodo unloadMovie para eliminar pelculas o imgenes cargadas con el mtodo loadMovie. Utilice el mtodo loadVariables para mantener la pelcula activa y actualizar las variables con nuevos valores.
Vase tambin

loadMovie, loadMovieNum, MovieClip.loadVariables, MovieClip.unloadMovie, unloadMovie, unloadMovieNum

336

MovieClip.loadVariables
Disponibilidad

Flash Player 5.
Sintaxis

myMovieClip.loadVariables("url", variables)
Parmetros

url El URL absoluto o relativo del archivo externo que contiene las variables que se van a cargar. El host del URL debe estar en el mismo subdominio que el clip de pelcula.

Un parmetro opcional que especifica un mtodo HTTP para enviar variables. El parmetro debe ser la cadena GET o POST. Si no hay ninguna variable para enviar, no incluya este parmetro. El mtodo GET adjunta las variables al final del URL y se utiliza para un nmero pequeo de variables. El mtodo POST enva las variables en un encabezado HTTP distinto y se usa para cadenas largas de variables.
variables
Valor devuelto

Ninguno.
Descripcin

Mtodo; lee los datos de un archivo externo y establece los valores de las variables en MovieClip. El archivo externo puede ser un archivo de texto generado por un script CGI, Active Server Page (ASP), o un script PHP y puede contener cualquier nmero de variables. Este mtodo tambin puede utilizarse para actualizar las variables del clip de pelcula activa con nuevos valores. Este mtodo requiere que el texto del URL est en el formato MIME estndar application/xwww-form-urlencoded (formato de script CGI).
Vase tambin

loadMovie, loadVariables, loadVariablesNum, MovieClip.unloadMovie

MovieClip.localToGlobal
Disponibilidad

Flash Player 5.
Sintaxis

myMovieClip.localToGlobal(punto)
Parmetros

punto

El nombre o identificador de un objeto creado con el objeto Object que especifica las coordenadas x e y como propiedades.

Valor devuelto

Ninguno.
Descripcin

Mtodo; convierte el objeto punto de las coordenadas (locales) del clip de pelcula a las coordenadas (globales) del escenario.

Diccionario de ActionScript 337

Ejemplo

En el ejemplo siguiente se convierten las coordenadas x e y del objeto punto (point) de las coordenadas (locales) del clip de pelcula a las coordenadas (globales) del escenario. Las coordenadas locales x e y se especifican con las propiedades _xmouse e _ymouse para recuperar las coordenadas x e y de la posicin del ratn.
onClipEvent(mouseMove) { point = new object(); point.x = _xmouse; point.y = _ymouse; _root.out3 = point.x + " === " + point.y; _root.out = _root._xmouse + " === " + _root._ymouse; localToGlobal(point); _root.out2 = point.x + " === " + point.y; updateAfterEvent(); }
Vase tambin

MovieClip.globalToLocal

MovieClip.moveTo
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.moveTo (x, y)
Parmetros

x y

Un nmero entero que indica la posicin horizontal relativa al punto de registro del clip de pelcula principal.

Un nmero entero que indica la posicin vertical relativa al punto de registro del clip de pelcula principal.

Valor devuelto

Ninguno.
Descripcin

Mtodo; mueve la posicin actual del dibujo a (x, y). Si falta alguno de estos parmetros, el mtodo falla y la posicin del dibujo no se cambia.
Ejemplo

En este ejemplo se dibuja un tringulo con una lnea de color magenta de 5 puntos sin relleno. La primera lnea crea un clip de pelcula vaco con el que se dibuja. En la sentencia with, se define un tipo de lnea y, a continuacin, el mtodo moveTo indica la posicin inicial de dibujo.
_root.createEmptyMovieClip( "triangle", 1 ); with ( _root.triangle ) { lineStyle( 5, 0xff00ff, 100 ); moveTo( 200, 200 ); lineTo( 300,300 ); lineTo( 100, 300 ); lineTo( 200, 200 ); }
Vase tambin

MovieClip.createEmptyMovieClip, MovieClip.lineStyle, MovieClip.lineTo

338

MovieClip._name
Disponibilidad

Flash Player 4.
Sintaxis

myMovieClip._name
Descripcin

Propiedad; devuelve el nombre de instancia del clip de pelcula especificado por MovieClip.

MovieClip.nextFrame
Disponibilidad

Flash Player 5.
Sintaxis

myMovieClip.nextFrame()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; enva la cabeza lectora al fotograma siguiente y la detiene.

Vase tambin

nextFrame

MovieClip.onData
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.onData
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando un clip de pelcula recibe datos de una llamada loadVariables o loadMovie. Debe definir una funcin que se ejecute cuando se invoque el evento.

Diccionario de ActionScript 339

Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onData que enva una accin trace a la ventana Salida.
myMovieClip.onData = function () { trace ("se ha llamado al mtodo onData"); };

MovieClip.onDragOut
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.onDragOver
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando se presiona el puntero, se desplaza fuera y despus se sita sobre el clip de pelcula. Debe definir una funcin que se ejecute cuando se invoque el evento.
Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onDragOut que enva una accin trace a la ventana Salida.
myMovieClip.onDragOut = function () { trace ("se ha llamado al mtodo onDragOut"); };
Vase tambin

MovieClip.onDragOver

MovieClip.onDragOver
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.onDragOver
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando se presiona el puntero, se desplaza fuera y despus se sita sobre el clip de pelcula.

340

Debe definir una funcin que se ejecute cuando se invoque el evento.

Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onDragOut que enva una accin trace a la ventana Salida.
myMovieClip.onDragOver = function () { trace ("se ha llamado al mtodo onDragOver"); };
Vase tambin

MovieClip.onDragOut

MovieClip.onEnterFrame
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.onEnterFrame
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca de forma continua a la velocidad de los fotogramas de la pelcula. Las acciones asociadas con el evento de clip enterFrame se procesan antes que cualquiera de las acciones de fotogramas asociadas a los fotogramas afectados. Debe definir una funcin que se ejecute cuando se invoque el evento.
Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onEnterFrame que enva una accin trace a la ventana Salida.
myMovieClip.onEnterFrame = function () { trace ("se ha llamado al mtodo onEnterFrame"); };

MovieClip.onKeyDown
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.onKeyDown
Parmetros

Ninguno.
Valor devuelto

Ninguno.

Diccionario de ActionScript 341

Descripcin

Controlador de eventos; se invoca cuando un clip de pelcula dispone de una seleccin de entrada y se presiona una tecla. El evento onKeyDown se invoca sin parmetros. Puede utilizar los mtodos Key.getAscii y Key.getCode para determinar la tecla que se ha presionado. Debe definir una funcin que se ejecute cuando se invoque el evento.
Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onKeyDown que enva una accin trace a la ventana Salida:
myMovieClip.onKeyDown = function () { trace ("se ha llamado al mtodo onKeyDown"); };
Vase tambin

MovieClip.onKeyUp

MovieClip.onKeyUp
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.onKeyUp
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Evento; se invoca cuando se suelta una tecla. El evento onKeyUp se invoca sin parmetros. Puede utilizar los mtodos Key.getAscii y Key.getCode para determinar la tecla que se ha presionado. Debe definir una funcin que se ejecute cuando se invoque el evento.
Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onKeyPress que enva una accin trace a la ventana Salida.
myMovieClip.onKeyUp = function () { trace ("se ha llamado al mtodo onKeyUp"); };

342

MovieClip.onKillFocus
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.onKillFocus = function (nuevaSeleccin) { sentencias;

};
Parmetros

nuevaSeleccin
Valor devuelto

Objeto que se selecciona mediante el teclado.

Ninguno.
Descripcin

Controlador de eventos; un evento que se invoca cuando un clip de pelcula ya no se selecciona mediante el teclado. El mtodo onKillFocus recibe un parmetro, nuevaSeleccin, que es un objeto que representa el nuevo objeto seleccionado. Si no hay ningn objeto seleccionado, nuevaSeleccin contiene el valor null.

MovieClip.onLoad
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.onLoad
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando se crea la instancia del clip de pelcula y aparece en la lnea de tiempo. Debe definir una funcin que se ejecute cuando se invoque el evento.
Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onLoad que enva una accin trace a la ventana Salida:
myMovieClip.onLoad = function () { trace ("se ha llamado al mtodo onLoad"); };

Diccionario de ActionScript 343

MovieClip.onMouseDown
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.onMouseDown
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando se presiona el botn del ratn. Debe definir una funcin que se ejecute cuando se invoque el evento.
Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onMouseDown que enva una accin trace a la ventana Salida:
myMovieClip.onMouseDown = function () { trace ("se ha llamado al mtodo onMouseDown"); }

MovieClip.onMouseMove
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.onMouseMove
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando se mueve el ratn. Debe definir una funcin que se ejecute cuando se invoque el evento.
Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onMouseMove que enva una accin trace a la ventana Salida.
myMovieClip.onMouseMove = function () { trace ("se ha llamado al mtodo onMouseMove"); };

344

MovieClip.onMouseUp
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.onMouseUp
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando se suelta el ratn. Debe definir una funcin que se ejecute cuando se invoque el evento.
Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onMouseUp que enva una accin trace a la ventana Salida.
myMovieClip.onMouseUp = function () { trace ("se ha llamado al mtodo onMouseUp");

};

MovieClip.onPress
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.onPress
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando se hace clic con el puntero del ratn sobre un clip de pelcula. Debe definir una funcin que se ejecute cuando se invoque el evento.
Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onPress que enva una accin trace a la ventana Salida.
myMovieClip.onPress = function () { trace ("se ha llamado al mtodo onPress"); };

Diccionario de ActionScript 345

MovieClip.onRelease
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.onRelease
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando se suelta un clip de pelcula de botn. Debe definir una funcin que se ejecute cuando se invoque el evento.
Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onPress que enva una accin trace a la ventana Salida.
myMovieClip.onRelease = function () { trace ("se ha llamado al mtodo onRelease"); };

MovieClip.onReleaseOutside
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.onReleaseOutside
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando se suelta el ratn mientras el puntero est fuera del clip de pelcula despus de presionar el botn del ratn dentro del clip de pelcula. Debe definir una funcin que se ejecute cuando se invoque el evento.
Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onReleaseOutside que enva una accin trace a la ventana Salida.
myMovieClip.onReleaseOutside = function () { trace ("se ha llamado al mtodo onReleaseOutside"); };

346

MovieClip.onRollOut
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.onRollOut
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando el puntero se desplaza fuera del rea de un clip de pelcula. Debe definir una funcin que se ejecute cuando se invoque el evento.
Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onRollOut que enva una accin trace a la ventana Salida.
myMovieClip.onRollOut = function () { trace ("se ha llamado al mtodo onRollOut"); };

MovieClip.onRollOver
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.onRollOver
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando el puntero se desplaza sobre el rea de un clip de pelcula. Debe definir una funcin que se ejecute cuando se invoque el evento.
Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onRollOver que enva una accin trace a la ventana Salida.
myMovieClip.onRollOver = function () { trace ("se ha llamado al mtodo onRollOver"); };

Diccionario de ActionScript 347

MovieClip.onSetFocus
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.onSetFocus = function(seleccinAnterior){ sentencias; };

Parmetros

seleccinAnterior
Valor devuelto

El objeto que dejar de estar seleccionado.

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando un clip de pelcula recibe la seleccin de teclado. El parmetro seleccinAnterior es el objeto que deja de estar seleccionado. Por ejemplo, si el usuario presiona la tecla Tabulador para mover la seleccin de entrada de un clip de pelcula a un campo de texto, seleccinAnterior contiene la instancia del clip de pelcula. Si no hay ningn objeto seleccionado anteriormente, seleccinAnterior contiene un valor null.

MovieClip.onUnload
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.onUnload
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca en el primer fotograma despus de eliminar el clip de pelcula de la lnea de tiempo. Las acciones asociadas con el evento onUnload se procesan antes de que se asocien acciones al fotograma afectado. Debe definir la funcin que se ejecuta cuando se invoca el evento.
Ejemplo

En el ejemplo siguiente se define una funcin para el mtodo onUnload que enva una accin trace a la ventana Salida.
myMovieClip.onUnload = function () { trace ("se ha llamado al mtodo onUnload"); };

348

MovieClip._parent
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip._parent.property _parent._parent.property
Descripcin

Propiedad; especifica o devuelve una referencia al clip de pelcula que contiene el objeto o el clip de pelcula. El objeto actual es el objeto que contiene el cdigo de ActionScript que hace referencia a _parent. Utilice la propiedad _parent para especificar una ruta relativa a los clips de pelcula u objetos que estn por encima del clip de pelcula u objeto actual.
Vase tambin

_root, targetPath

MovieClip.play
Disponibilidad

Flash Player 5.
Sintaxis

myMovieClip.play()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; mueve la cabeza lectora de la lnea de tiempo del clip de pelcula.

Vase tambin

play

MovieClip.prevFrame
Disponibilidad

Flash Player 5.
Sintaxis

myMovieClip.prevFrame()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; enva la cabeza lectora al fotograma anterior y la detiene.

Vase tambin

prevFrame

Diccionario de ActionScript 349

MovieClip.removeMovieClip
Disponibilidad

Flash Player 5.
Sintaxis

myMovieClip.removeMovieClip()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; elimina una instancia de clip de pelcula creada con la accin duplicateMovieclip o los mtodos duplicateMovieClip o attachMovie del objeto MovieClip.
Vase tambin

MovieClip.attachMovie, MovieClip.attachMovie, removeMovieClip, MovieClip.attachMovie

MovieClip._rotation
Disponibilidad

Flash Player 4.
Sintaxis

myMovieClip._rotation
Descripcin

Propiedad; especifica la rotacin del clip de pelcula en grados.

MovieClip.setMask
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.setMask (clipMscara)
Parmetros

myMovieClip clipMscara
Valor devuelto

El nombre de instancia de un clip de pelcula que se va a enmascarar. El nombre de instancia de un clip de pelcula que debe ser una mscara.

Ninguno.
Descripcin

Mtodo; convierte el clip de pelcula del parmetro clipMscara en una mscara que muestra el clip de pelcula especificado por el parmetro myMovieClip.

350

El mtodo setMask permite que los clips de pelcula con varios fotogramas que poseen un contenido complejo y con distintas capas acten como mscaras. Puede activar o desactivar las mscaras en tiempo de ejecucin. Sin embargo, no puede utilizar la misma mscara para varios elementos con mscara (lo cual es posible con el uso de capas de mscara). Si dispone de fuentes de dispositivo en un clip de pelcula con mscara, dichas fuentes se dibujarn pero no se enmascararn. No es posible definir que un clip de pelcula sea su propia mscara, por ejemplo mc.setMask(mc). Si crea una capa de mscara que contiene un clip de pelcula y, a continuacin, le aplica el mtodo setMask, la llamada a setMask tiene prioridad y, por lo tanto, no es reversible. Por ejemplo, puede tener un clip de pelcula en una capa de mscara denominada UIMask que enmascara otra capa que contiene un clip de pelcula denominado UIMaskee. Si, durante la reproduccin de la pelcula, llama a UIMask.setMask(UIMaskee), a partir de ese momento, UIMask estar enmascarado por UIMaskee. Para cancelar una mscara creada con ActionScript, pase el valor null al mtodo setMask. El cdigo siguiente cancela la mscara sin que afecte a la capa de mscara de la lnea de tiempo.
UIMask.setMask(null)
Ejemplo

En el cdigo de muestra siguiente se utiliza el clip de pelcula circleMask para enmascarar el clip de pelcula theMaskee.
theMaskee.setMask(circleMask);

MovieClip._soundbuftime
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip._soundbuftime
Descripcin

Propiedad (global); entero que especifica el nmero de segundos que un sonido se almacena previamente en una memoria intermedia antes de que empiece a fluir.

MovieClip.startDrag
Disponibilidad

Flash Player 5.
Sintaxis

myMovieClip.startDrag([bloquear, [izquierda, superior, derecha, inferior]])

Parmetros

bloquear

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 en el que el usuario hizo clic por primera vez en el clip de pelcula (false). Este parmetro es opcional. Valores relativos a las coordenadas del elemento principal del clip de pelcula que especifican un rectngulo de limitacin para el clip de pelcula. Estos parmetros son opcionales.

izquierda, superior, derecha, inferior

Diccionario de ActionScript 351

Valor devuelto

Ninguno.
Descripcin

Mtodo; permite al usuario arrastrar el clip de pelcula especificado. Un clip de pelcula puede arrastrarse hasta que se detiene explcitamente por la llamada del mtodo stopDrag, o hasta que otro clip de pelcula se convierte en arrastrable. Slo puede arrastrarse un clip de pelcula cada vez.
Vase tambin

MovieClip._droptarget, MovieClip.startDrag, MovieClip.stopDrag

MovieClip.stop
Disponibilidad

Flash Player 5.
Sintaxis

myMovieClip.stop()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; detiene el clip de pelcula que se est reproduciendo actualmente.

Vase tambin

stop

MovieClip.stopDrag
Disponibilidad

Flash Player 5.
Sintaxis

myMovieClip.stopDrag()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; finaliza un mtodo startDrag. Una pelcula que se convirti en arrastrable con el mtodo startDrag contina siendo arrastrable hasta que se agrega un mtodo stopDrag o hasta que otra pelcula se convierte en arrastrable. Slo puede arrastrarse un clip de pelcula cada vez.
Vase tambin

MovieClip._droptarget, MovieClip.startDrag, stopDrag

352

MovieClip.swapDepths
Disponibilidad

Flash Player 5.
Sintaxis

myMovieClip.swapDepths(profundidad) myMovieClip.swapDepths(destino)
Parmetros

destino La instancia del clip de pelcula cuya profundidad se intercambia con la instancia especificada en myMovieClip. Ambas instancias deben tener el mismo clip de pelcula principal. profundidad
Valor devuelto

Un nmero que especifica el nivel de profundidad donde se va a colocar MovieClip.

Ninguno.
Descripcin

Mtodo; intercambia el apilado, o el orden z (nivel de profundidad), de la instancia especificada (MovieClip) con la pelcula especificada por el parmetro destino o con la pelcula que actualmente ocupa el nivel de profundidad especificado en el parmetro profundidad. Ambas pelculas deben tener el mismo clip de pelcula principal. Al intercambiar el nivel de profundidad de los clips de pelcula se mueve una pelcula frente o detrs de la otra. Si la pelcula se est interpolando cuando se llama a este mtodo, se detiene la interpolacin.
Vase tambin

_level

MovieClip.tabChildren
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.tabChildren
Descripcin

Propiedad; el valor predeterminado es undefined. Si tabChildren tiene el valor undefined o true, los elementos secundarios de un clip de pelcula se incluyen en el orden de tabulacin automtico. Si el valor de tabChildren es false, los elementos secundarios de un clip de pelcula no se incluyen en el orden de tabulacin automtico.
Ejemplo

Un objeto de interfaz de cuadro de lista creado como clip de pelcula contiene varios elementos. Puede hacer clic en cada elemento para seleccionarlo, de modo que cada elemento es un botn. Sin embargo, nicamente el cuadro de lista puede ser una tabulacin. Los elementos que contiene el cuadro de lista deben excluirse del orden de tabulacin. Para ello, la propiedad tabChildren del cuadro de lista debe estar establecida en false. La propiedad tabChildren no tiene ningn efecto si se utiliza la propiedad tabIndex; slo afecta al orden de tabulacin automtico.
Vase tambin

Button.tabIndex, TextField.tabIndex

Diccionario de ActionScript 353

MovieClip.tabEnabled
Disponibilidad

Flash Player 6.
Sintaxis

MovieClip.tabEnabled
Descripcin

Propiedad; puede establecerse en una instancia de los objetos MovieClip, Button o TextField. El valor predeterminado es undefined. Si la propiedad tabEnabled es undefined o true, el objeto se incluye en el orden de tabulacin automtico. Si la propiedad tabIndex tambin se establece en un valor, el objeto se incluye en el orden de tabulacin personalizado. Si el valor de tabEnabled es false, el objeto no se incluye en el orden de tabulacin automtico. En el caso de un clip de pelcula, si tabEnabled es false, los valores secundarios del clip de pelcula pueden seguir incluyndose en el orden de tabulacin automtico, a menos que la propiedad tabChildren tambin se establezca en false.
Vase tambin

MovieClip.tabChildren, MovieClip.tabIndex

MovieClip.tabIndex
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.tabIndex
Descripcin

Propiedad; permite personalizar el orden de tabulacin de los objetos de una pelcula. El valor predeterminado de la propiedad tabIndex es undefined. Puede establecer tabIndex en un botn, un clip de pelcula o una instancia de campo de texto. Si un objeto de una pelcula Flash contiene una propiedad tabIndex, el orden de tabulacin automtico est desactivado y el orden de tabulacin se calcula a partir de las propiedades tabIndex de los objetos de la pelcula. El orden de tabulacin personalizado slo incluye objetos que tienen propiedades tabIndex. La propiedad tabIndex debe ser un entero positivo. Los objetos se ordenan de acuerdo con sus propiedades tabIndex, en orden ascendente. Un objeto con una propiedad tabIndex establecida en 1 va antes que un objeto con una propiedad tabIndex establecida en 2. El orden de tabulacin personalizado no tiene en cuenta las relaciones jerrquicas de los objetos de una pelcula Flash. Todos los objetos de la pelcula Flash con las propiedades tabIndex se colocan segn el orden de tabulacin. No debe utilizarse el mismo valor de tabIndex para varios objetos.

354

MovieClip._target
Disponibilidad

Flash Player 4.
Sintaxis

myMovieClip._target
Descripcin

Propiedad (slo lectura); devuelve la ruta de destino de la instancia de clip de pelcula especificada en el parmetro MovieClip.

MovieClip._totalframes
Disponibilidad

Flash Player 4.
Sintaxis

myMovieClip._totalframes
Descripcin

Propiedad (slo lectura); devuelve el nmero total de fotogramas de la instancia de clip de pelcula especificada en el parmetro MovieClip.

MovieClip.trackAsMenu
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.trackAsMenu
Descripcin

Propiedad; propiedad booleana que indica si los botones o los clips de pelcula pueden recibir o no eventos al soltar el ratn. Permite crear mens. Puede establecer la propiedad trackAsMenu en cualquiera de los objetos de botn o de clip de pelcula. Si la propiedad trackAsMenu no existe, el comportamiento predeterminado es false. Puede cambiar la propiedad trackAsMenu en cualquier momento; el clip de pelcula de botn modificado asume de inmediato el nuevo comportamiento.
Vase tambin

Button.trackAsMenu

Diccionario de ActionScript 355

MovieClip.unloadMovie
Disponibilidad

Flash Player 5.
Sintaxis

myMovieClip.unloadMovie()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; elimina un clip de pelcula cargado con los mtodos loadMovie o attachMovie de MovieClip.
Vase tambin

MovieClip.attachMovie, MovieClip.loadMovie, unloadMovie, unloadMovieNum

MovieClip._url
Disponibilidad

Flash Player 4.
Sintaxis

myMovieClip._url
Descripcin

Propiedad (slo lectura); recupera el URL del archivo SWF del que se descarg el clip de pelcula.

MovieClip.useHandCursor
Disponibilidad

Flash Player 6.
Sintaxis

myMovieClip.useHandCursor
Descripcin

Propiedad; valor booleano que indica si el cursor con forma de mano se visualiza cuando un usuario se sita sobre un clip de pelcula de botn. El valor predeterminado de useHandCursor es true. Si useHandCursor se establece en true, el cursor estndar con forma de mano utilizado para los botones se visualiza cuando un usuario se sita sobre un clip de pelcula de botn. En cambio, si useHandCursor es false, se utiliza el cursor con forma de flecha. Puede cambiar la propiedad useHandCursor en cualquier momento; el clip de pelcula de botn modificado asume de inmediato el comportamiento del nuevo cursor. La propiedad useHandCursor puede leerse fuera de un objeto prototipo.

356

MovieClip._visible
Disponibilidad

Flash Player 4.
Sintaxis

myMovieClip._visible
Descripcin

Propiedad; valor booleano que indica si la pelcula especificada por el parmetro MovieClip es visible. Los clips de pelcula que no son visibles (propiedad _visible establecida en false) estn desactivados. Por ejemplo, no es posible hacer clic en un botn de un clip de pelcula con la propiedad _visible establecida en false.

MovieClip._width
Disponibilidad

Flash Player 4 como propiedad de slo lectura.

Sintaxis

myMovieClip._width
Descripcin

Propiedad; establece y recupera la anchura del clip de pelcula en pxeles.

Ejemplo

En el ejemplo siguiente se establecen las propiedades de altura y anchura de un clip de pelcula cuando el usuario hace clic con el ratn.
onclipEvent(mouseDown) { _width=200; _height=200; }
Vase tambin

MovieClip._height

Diccionario de ActionScript 357

MovieClip._x
Disponibilidad

Flash Player 3.
Sintaxis

myMovieClip._x
Descripcin

Propiedad; nmero entero que establece la coordenada x de una pelcula en relacin a las coordenadas locales del clip de pelcula principal. Si un clip de pelcula est 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 se encuentra dentro de otro clip de pelcula que tiene transformaciones, el clip de pelcula est en el sistema de coordenadas local del clip de pelcula que lo contiene. As, para un clip de pelcula girado 90 en sentido contrario a las agujas del reloj, el clip de pelcula secundario hereda un sistema de coordenadas que est girado 90 en sentido contrario a las agujas del reloj. Las coordenadas del clip de pelcula hacen referencia a la posicin del punto de registro.
Vase tambin

MovieClip._xscale, MovieClip._y, MovieClip._yscale

MovieClip._xmouse
Disponibilidad

Flash Player 5.
Sintaxis

myMovieClip._xmouse
Descripcin

Propiedad (slo lectura); devuelve la coordenada x de la posicin del ratn.

Vase tambin

Mouse (objeto), MovieClip._ymouse

MovieClip._xscale
Disponibilidad

Flash Player 4.
Sintaxis

myMovieClip._xscale
Descripcin

Propiedad; determina la escala horizontal (porcentaje) del clip de pelcula que se aplica desde el punto de registro del clip de pelcula. El punto de registro predeterminado es (0,0). Cambiar la escala del sistema de coordenadas local afecta a la configuracin de las propiedades _x e _y, que se definen en pxeles. Por ejemplo, si se cambia la escala del clip de pelcula principal al 50%, al establecer la propiedad _x se mueve un objeto en el clip de pelcula la mitad del nmero de pxeles que lo hara si la pelcula estuviera al 100%.
Vase tambin

MovieClip._x, MovieClip._y, MovieClip._yscale

358

MovieClip._y
Disponibilidad

Flash Player 3.
Sintaxis

myMovieClip._y
Descripcin

Propiedad; establece la coordenada y de la pelcula en relacin a las coordenadas locales del clip de pelcula principal. Si un clip de pelcula est 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 se encuentra dentro de otro clip de pelcula que tiene transformaciones, el clip de pelcula est en el sistema de coordenadas local del clip de pelcula que lo contiene. As, para un clip de pelcula girado 90 en sentido contrario a las agujas del reloj, el clip de pelcula secundario hereda un sistema de coordenadas que est girado 90 en sentido contrario a las agujas del reloj. Las coordenadas del clip de pelcula hacen referencia a la posicin del punto de registro.
Vase tambin

MovieClip._x, MovieClip._xscale, MovieClip._yscale

MovieClip._ymouse
Disponibilidad

Flash Player 5.
Sintaxis

myMovieClip._ymouse
Descripcin

Propiedad (slo lectura); indica la coordenada y de la posicin del ratn.

Vase tambin

Mouse (objeto), MovieClip._xmouse

MovieClip._yscale
Disponibilidad

Flash Player 4.
Sintaxis

myMovieClip._yscale
Descripcin

Propiedad; establece la escala vertical (porcentaje) del clip de pelcula que se aplica desde el punto de registro del clip de pelcula. El punto de registro predeterminado es (0,0). Cambiar la escala del sistema de coordenadas local afecta a la configuracin de las propiedades _x e _y, que se definen en pxeles. Por ejemplo, si se cambia la escala del clip de pelcula principal al 50%, al establecer la propiedad _x se mueve un objeto en el clip de pelcula la mitad del nmero de pxeles que lo hara si la pelcula estuviera al 100%.
Vase tambin

MovieClip._x, MovieClip._xscale, MovieClip._y

Diccionario de ActionScript 359

NaN
Disponibilidad

Flash Player 5.
Sintaxis

NaN
Descripcin

Variable; una variable predefinida con el valor IEEE-754 para NaN (No es un Nmero, Not a Number).

ne (no igual; especfico para cadenas)

Disponibilidad

Flash Player 4. Este operador se ha desestimado; se recomienda utilizar el operador !=

(desigualdad).
Sintaxis

expresin1 ne expresin2
Parmetros

expresin1,expresin2
Valor devuelto

Nmeros, cadenas o variables.

Ninguno.
Descripcin

Operador (de comparacin); compara expresin1 con expresin2 y devuelve true si expresin1 no es igual a expresin2; en caso contrario, devuelve false.
Vase tambin

!= (desigualdad)

new
Disponibilidad

Flash Player 5.
Sintaxis

new constructor()
Parmetros

constructor

Una funcin seguida de cualquiera de los parmetros opcionales entre parntesis. La funcin es habitualmente el nombre del tipo de objeto (por ejemplo, Array, Math, Number u Object) que se va a construir.

Valor devuelto

Ninguno.

360

Descripcin

Operador; crea un nuevo objeto, inicialmente annimo, y llama a la funcin identificada por el parmetro constructor. El operador new pasa a la funcin los parmetros opcionales entre parntesis, as como el objeto recin creado, al que se hace referencia con la palabra clave this. De este modo, la funcin constructor puede utilizar la palabra this para establecer las variables del objeto. La propiedad prototype de la funcin constructor se copia en la propiedad __proto__ del nuevo objeto. Como resultado, el nuevo objeto admite todos los mtodos y propiedades especificados en la funcin constructor del objeto Prototype.
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("La conjura de los necios", 19.95); book2 = new Book("La opera flotante", 10.95);
Ejemplo

En el ejemplo siguiente se utiliza el operador new para crear una instancia de un objeto Array con 18 elementos:
golfCourse = new Array(18);
Vase tambin

[] (acceso a matriz), {} (inicializador de objeto)

La seccin del mtodo constructor dentro de cada entrada de objeto.

newline
Disponibilidad

Flash Player 4.
Sintaxis

newline
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Constante; inserta un carcter de retorno de carro () que inserta una lnea vaca en el cdigo ActionScript. Utilice newline para crear espacio para la informacin que se recupera mediante una funcin o una accin del cdigo.

Diccionario de ActionScript 361

nextFrame
Disponibilidad

Flash 2.
Sintaxis

nextFrame()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Accin; enva la cabeza lectora al fotograma siguiente y la detiene.

Ejemplo

En este ejemplo, cuando el usuario hace clic en el botn, la cabeza lectora pasa al siguiente fotograma y se detiene.
on (release) { nextFrame(); }

nextScene
Disponibilidad

Flash 2.
Sintaxis

nextScene()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Accin; enva la cabeza lectora al fotograma 1 de la escena siguiente y la detiene.

Ejemplo

En este ejemplo, cuando un usuario suelta el botn, la cabeza lectora se enva al fotograma 1 de la escena siguiente.
on(release) { nextScene(); }
Vase tambin

prevScene

362

not
Disponibilidad

Flash Player 4. Este operador se ha desestimado; se recomienda utilizar el operador ! (NOT lgico).
Sintaxis

not expresin
Parmetros

expresin
Descripcin

Cualquier variable o expresin que puede convertirse a un valor booleano.

Operador; realiza una operacin NOT lgica en Flash Player 4.

Vase tambin

! (NOT lgico)

null
Disponibilidad

Flash Player 5.
Sintaxis

null
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Palabra clave; un valor especial que puede asignarse a variables o puede ser devuelto por una funcin si no se han proporcionado datos. Puede utilizar null para representar valores que faltan o que no tienen un tipo de datos definido.
Ejemplo

En un contexto numrico, null da como resultado 0. Se pueden realizar comprobaciones de igualdad con null. En esta sentencia, un nodo de rbol binario no tiene nivel secundario a la izquierda, de modo que el campo de su nivel secundario a la izquierda podra establecerse como null.
if (tree.left == null) { tree.left = new TreeNode(); }

Diccionario de ActionScript 363

Number (funcin)
Disponibilidad

Flash Player 4.
Sintaxis

Number(expresin)
Parmetros

expresin

Expresin que debe convertirse en un nmero.

Valor devuelto

Ninguno.
Descripcin

Funcin; convierte el parmetro expresin en un nmero y devuelve un valor de acuerdo con lo siguiente: Si expresin es un nmero, el valor devuelto es expresin. Si expresin es un valor expresin es false. booleano, el valor devuelto es 1 si expresin es true, o bien 0 si

Si expresin es una cadena, la funcin intenta analizar expresin como un nmero decimal con un exponente final opcional, es decir, 1.57505e-3. Si expresinx es undefined, el valor devuelto es 0. Esta funcin se utiliza para convertir los archivos de Flash 4 que contienen operadores desestimados que se importan al entorno de edicin de Flash 5. Consulte el operador & para obtener ms informacin.
Vase tambin

Number (objeto)

Number (objeto)
El objeto Number es un objeto envolvente sencillo para el tipo de datos Number, lo que quiere decir que puede manipular valores numricos primitivos utilizando los mtodos y propiedades asociadas con el objeto Number. Este objeto es idntico al objeto Number de JavaScript. En Flash MX, el objeto Number se ha convertido en un objeto nativo. Debido a ello, experimentar una gran mejora en el rendimiento. Debe utilizar un constructor al llamar a los mtodos del objeto Number, pero no es necesario utilizar el constructor cuando llame a las propiedades del objeto Number. El ejemplo siguiente especifica la sintaxis para llamar a los mtodos y propiedades del objeto Number. El ejemplo siguiente llama al mtodo toString del objeto Number, que devuelve la cadena 1234.
myNumber = new Number(1234); myNumber.toString();

Este ejemplo llama a la propiedad MIN_VALUE (tambin denominada constante) del objeto Number:
smallest = Number.MIN_VALUE

364

Resumen de los mtodos del objeto Number

Mtodo Number.toString Number.valueOf Descripcin Devuelve la representacin de cadena de un objeto Number. Devuelve el valor primitivo del objeto Number.

Resumen de las propiedades del objeto Number

Propiedad Number.MAX_VALUE Descripcin Constante que representa el nmero mayor que se puede representar (IEEE-754 de doble precisin). Este nmero es aproximadamente 1.7976931348623158e+308. Constante que representa el nmero menor que se puede representar (IEEE-754 de doble precisin). Este nmero es aproximadamente 5e-324. Constante que representa el valor de Not a Number (NaN). Constante que representa el valor de infinito negativo. Constante que representa el valor de infinito positivo. Este valor es el mismo que la variable global Infinity.

Number.MIN_VALUE Number.NaN Number.NEGATIVE_INFINITY Number.POSITIVE_INFINITY

Constructor del objeto Number.

Disponibilidad

Flash Player 5.
Sintaxis

myNumber = new Number(valor)

Parmetros

valor

El valor numrico del objeto Number que se est creando o un valor que se va a convertir en un nmero.

Valor devuelto

Ninguno.
Descripcin

Constructor; crea un nuevo objeto Number. Debe utilizar el constructor Number cuando utilice los mtodos toString y valueOf del objeto Number. No se usa un constructor cuando se utilizan las propiedades del objeto Number. El constructor new Number se utiliza principalmente como marcador de posicin. Una instancia del objeto Number no es lo mismo que la funcin Number que convierte un parmetro en un valor primitivo.
Ejemplo

El cdigo siguiente construye nuevos objetos Number.

n1 = new Number(3.4); n2 = new Number(-10);
Vase tambin

Number (funcin)

Diccionario de ActionScript 365

Number.MAX_VALUE
Disponibilidad

Flash Player 5.
Sintaxis

Number.MAX_VALUE
Descripcin

Propiedad; el nmero mayor que se puede representar (IEEE-754 de doble precisin). Este nmero es aproximadamente 1.79E+308.

Number.MIN_VALUE
Disponibilidad

Flash Player 5.
Sintaxis

Number.MIN_VALUE
Descripcin

Propiedad; el nmero menor que se puede representar (IEEE-754 de doble precisin). Este nmero es aproximadamente 5e-324.

Number.NaN
Disponibilidad

Flash Player 5.
Sintaxis

Number.NaN
Descripcin

Propiedad; el valor IEEE-754 que representa Not A Number (NaN).

Number.NEGATIVE_INFINITY
Disponibilidad

Flash Player 5.
Sintaxis

Number.NEGATIVE_INFINITY
Descripcin

Propiedad; devuelve el valor IEEE-754 que representa infinito negativo. El infinito negativo es un valor numrico especial que se devuelve cuando una operacin o funcin matemtica devuelve un valor negativo mayor de lo que se puede representar.

366

Number.POSITIVE_INFINITY
Disponibilidad

Flash Player 5.
Sintaxis

Number.POSITIVE_INFINITY
Descripcin

Propiedad; devuelve el valor IEEE-754 que representa infinito positivo. Este valor es el mismo que la variable global Infinity. El infinito positivo es un valor numrico especial que se devuelve cuando una operacin o funcin matemtica devuelve un valor mayor de lo que se puede representar.

Number.toString
Disponibilidad

Flash Player 5.
Sintaxis

myNumber.toString(base)
Parmetros

base

Especifica la base numrica (de 2 a 36) que se utiliza en la conversin de nmero a cadena. Si no especifica el parmetro base, el valor predeterminado es 10.

Valor devuelto

Ninguno.
Descripcin

Mtodo; devuelve la representacin de la cadena del objeto Number especificado (myNumber).

Ejemplo

El ejemplo siguiente utiliza el mtodo Number.toString, especificando 2 para el parmetro base y devuelve una cadena que contiene la representacin binaria del nmero 1000.
myNumber = new Number (1000); myNumber.toString(2);

Number.valueOf
Disponibilidad

Flash Player 5.
Sintaxis

myNumber.valueOf()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; devuelve el tipo de valor primitivo del objeto Number especificado.

Diccionario de ActionScript 367

Object (objeto)
El objeto genrico Object se encuentra en la raz de la jerarqua de clases de ActionScript. El objeto genrico Object de ActionScript contiene un pequeo subconjunto de las funciones que proporciona el objeto Object de JavaScript. En Flash MX, el objeto Object se ha convertido en un objeto nativo. Debido a ello, experimentar una gran mejora en el rendimiento. El objeto genrico Object se admite en Flash Player 5. Resumen de los mtodos del objeto Object
Mtodo Object.addProperty Object.registerClass Object.toString Object.unwatch Object.valueOf Object.watch Descripcin Crea una propiedad del captador/definidor de un objeto. Asigna una clase de ActionScript a una instancia de clip de pelcula. Convierte el objeto especificado en una cadena y la devuelve. Elimina el registro creado con el mtodo Object.watch. Devuelve el valor primitivo de un objeto Object. Registra la funcin callback que se debe invocar cuando cambia una propiedad especfica de un objeto de ActionScript.

Resumen de las propiedades del objeto Object

Propiedad Object.__proto__ Descripcin Referencia a la propiedad prototype de la funcin constructor del objeto.

Constructor del objeto Object.

Disponibilidad

Flash Player 5.
Sintaxis

new Object([valor])
Parmetros

valor

Un nmero, valor booleano o cadena que se va a convertir en un objeto. Este parmetro es opcional. Si no especifica el parmetro valor, el constructor crea un nuevo objeto sin propiedades definidas.

Descripcin

Constructor; crea un nuevo objeto Object.

368

Object.addProperty
Disponibilidad

Flash Player 6.
Sintaxis

myObject.addProperty( prop, funcinGet, funcinSet )

Parmetros

prop

Nombre de la propiedad de objeto que se debe crear.

funcinGet Funcin que se invoca para recuperar el valor de la propiedad; este parmetro es un objeto de funcin. funcinSet

Funcin que se invoca para definir el valor de la propiedad; este parmetro es un objeto de funcin. Si pasa el valor null en este parmetro, la propiedad es de slo lectura.

Valor devuelto

Devuelve el valor true si la propiedad se crea correctamente; en caso contrario, devuelve false.
Descripcin

Mtodo; crea una propiedad del captador/definidor. Cuando Flash lee una propiedad del captador/definidor, invoca la funcin get y el valor devuelto de la funcin se convierte en un valor de prop. Cuando Flash escribe una propiedad del captador/definidor, invoca la funcin set y le pasa el nuevo valor como un parmetro. Si existe una propiedad con un nombre concreto, la nueva propiedad lo sobrescribe. La funcin get es una funcin que no tiene 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 de tipo nmero. El valor devuelto de la funcin definidor se ignora. Puede agregar propiedades del captador/definidor a los objetos prototipo. Si agrega una propiedad del captador/definidor a un objeto prototipo, todas las instancias del objeto que heredan el objeto prototipo heredarn la propiedad del captador/definidor. Esto hace posible agregar una propiedad del captador/definidor 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 del captador/definidor de un objeto prototipo heredado, la referencia que se pasa a la funcin get/set ser el objeto referenciado originalmente, no el objeto prototipo. Si no se invoca correctamente, Object.addProperty puede generar un error. En la tabla siguiente se describen los errores que pueden producirse:
Condicin de error prop no es un nombre de propiedad vlido; por ejemplo, una cadena vaca. funcinGet no es un objeto de funcin vlido. funcinSet no es un objeto de funcin vlido. Qu sucede Devuelve false y no se agrega la propiedad. Devuelve false y no se agrega la propiedad. Devuelve false y no se agrega la propiedad.

Diccionario de ActionScript 369

Ejemplo

Sintaxis 1: las propiedades incorporadas TextField.scroll y TextField.maxscroll son propiedades de captador/definidor. El objeto TextField tiene los mtodos internos getScroll, setScroll y getMaxScroll. El constructor TextField crea las propiedades de captador/definidor y las dirige a los mtodos internos get/set, tal como se muestra a continuacin:
this.addProperty("scroll", this.getScroll, this.setScroll); this.addProperty("maxscroll", this.getMaxScroll, null);

Cuando un script recupera el valor de myTextField.scroll, el intrprete de ActionScript invoca automticamente myTextField.getScroll. Cuando un script modifica el valor de myTextField.scroll, el intrprete invoca myTextField.setScroll. La propiedad maxscroll no tiene especificada una funcin set, de modo que los intentos de modificar maxscroll se pasan por alto. Sintaxis 2: el ejemplo anterior de TextField.scroll y TextField.maxscroll funciona, pero las propiedades scroll y maxscroll se agregan a todas las instancias del objeto TextField. Lo que significa que el costo de tener estas propiedades es que hayan dos lugares de propiedades para cada instancia del objeto. Si hay muchas propiedades como scroll y maxscroll en una clase, es posible que requieran gran cantidad de memoria. En su lugar, puede agregar las propiedades scroll y maxscroll a TextField.prototype:
TextField.prototype.addProperty("scroll", this.getScroll, this.setScroll); TextField.prototype.addProperty("maxscroll", this.getMaxScroll, null);

Ahora, las propiedades scroll y maxscroll slo existen en un lugar: el objeto TextField.prototype. Sin embargo, el efecto es el mismo que el cdigo anterior, en el que las propiedades scroll y maxscroll se agregaban directamente a cada instancia. Si se accede a scroll o maxscroll desde una instancia TextField, se asciende en la cadena de prototipos y se encuentra la propiedad del captador/definidor de TextField.prototype.

Object.__proto__
Disponibilidad

Flash Player 5.
Sintaxis

myObject.__proto__
Parmetros

Ninguno.
Descripcin

Propiedad; se refiere a la propiedad prototype de la funcin constructor que ha creado myObject. La propiedad __proto__ se asigna automticamente a todos los objetos al crearlos. El intrprete de ActionScript utiliza la propiedad __proto__ para acceder a la propiedad prototype de la funcin constructor del objeto a fin de averiguar las propiedades y los mtodos que el objeto hereda de su clase.

370

Object.registerClass
Disponibilidad

Flash Player 6
Sintaxis

Object.registerClass(IDsmbolo, laClase)
Parmetros

IDsmbolo

El identificador de vnculo del smbolo de clip de pelcula, o el identificador de cadena de la clase de ActionScript.

laClase Referencia a la funcin constructor de la clase de ActionScript, o null para no registrar el smbolo.
Valor devuelto

Si el registro de clase tiene xito, se devuelve el valor true; en caso contrario, se devuelve false.
Descripcin

Mtodo; asocia un smbolo de clip de pelcula con una clase de objeto de ActionScript. Si no hay ningn smbolo, Flash crea una asociacin entre un identificador de cadena y una clase de objeto. Cuando la lnea de tiempo coloca una instancia del smbolo de clip de pelcula especificado, la instancia se registra en la clase especificada por el parmetro laClase en lugar de en la clase MovieClip. Cuando se crea una instancia del smbolo de clip de pelcula especificado mediante el mtodo attachMovie o duplicateMovieClip, la instancia se registra en la clase especificada por el parmetro laClase en lugar de la clase MovieClip. Si el parmetro laClase es null, Object.registerClass elimina cualquier definicin de clase de ActionScript asociada con el smbolo de clip de pelcula especificado o el identificador de clase. Para los smbolos de clip de pelcula, todas las instancias existentes del clip de pelcula permanecen iguales; sin embargo, las nuevas instancias del smbolo se asocian con la clase predeterminada MovieClip. Si un smbolo ya se ha registrado en una clase, el mtodo Object.registerClass lo sustituye por el nuevo registro. Cuando la lnea de tiempo coloca una instancia de clip de pelcula, o cuando sta se crea con el mtodo attachMovie o duplicateMovieClip, ActionScript invoca el constructor para la clase adecuada con la palabra clave this dirigida al objeto. La funcin constructor se invoca sin parmetros. Si se utiliza l mtodo Object.registerClass para registrar un clip de pelcula con una clase de ActionScript que no sea MovieClip, el smbolo de clip de pelcula no hereda los mtodos, propiedades y eventos de la clase incorporada MovieClip a menos que se incluya la clase MovieClip en la cadena prototipo de la clase nueva. El cdigo siguiente crea una clase ActionScript nueva denominada laClase que hereda las propiedades de la clase MovieClip:
theClass.prototype = new MovieClip();
Ejemplo

En este ejemplo se crea un componente para un objeto de interfaz de casilla de verificacin estndar.

Diccionario de ActionScript 371

Primero, debe crear un smbolo de clip de pelcula, denominado Check Box, en la biblioteca. A continuacin, debe crear una clase CheckBox en ActionScript que representar la casilla de verificacin.
// Definir el constructor para (y, con ello, definir) la clase CheckBox function CheckBox() { ... } // Establecer la cadena prototipo de CheckBox que se debe heredar de MovieClip CheckBox.prototype = new MovieClip(); // Definir los mtodos para la clase CheckBox CheckBox.prototype.setLabel this.label = newLabel; ... }; CheckBox.prototype.setValue this.value = value; ... }; CheckBox.prototype.getValue return this.value; }; CheckBox.prototype.getLabel return this.label; }; = function (newLabel) {

= function (newValue) {

= function () { = function () {

Ahora, debe asociar la clase CheckBox con el smbolo de clip de pelcula Check Box. Primero, es preciso que pueda identificar el smbolo de clip de pelcula Check Box en ActionScript. Para ello, introduzca un identificador en el cuadro de dilogo Vinculacin de la biblioteca y seleccione Exportar para ActionScript. A continuacin, escriba un cdigo en ActionScript para asociar la clase CheckBox con el smbolo CheckBox:
Object.registerClass("CheckBox" /*ID de smbolo*/, CheckBox /*la clase*/ );

Sintaxis 1 (ubicacin de la lnea de tiempo): ahora puede colocar las instancias de CheckBox en el escenario de la herramienta de edicin y, en tiempo de ejecucin, las instancias recibirn automticamente la clase CheckBox de ActionScript. Si coloca dos instancias, myCheckBox1 y myCheckBox2, puede controlarlas mediante la invocacin de mtodos, como se muestra a continuacin:
myCheckBox1.setValue(true); myCheckBox2.setValue(false); myCheckBox2.setLabel("nueva etiqueta para n 2");

372

Sintaxis 2 (instancias dinmicas): puede utilizar el mtodo attachMovie para crear una nueva instancia de la casilla de verificacin en el escenario mientras se reproduce la pelcula. Puesto que el smbolo CheckBox est registrado en la clase CheckBox de ActionScript, la nueva instancia dinmica recibir automticamente dicha clase.
// createCheckBox es una funcin de ayuda que // crea casillas de verificacin de forma dinmica function createCheckBox(name, depth) { attachMovie("CheckBox", name, depth); } createCheckBox("myCheckBox3", 100); myCheckBox3.setValue(false); myCheckBox3.setLabel("nueva etiqueta para n 3");
Vase tambin

MovieClip.attachMovie, MovieClip.duplicateMovieClip

Object.toString
Disponibilidad

Flash Player 5.
Sintaxis

myObject.toString()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; convierte el objeto especificado en una cadena y la devuelve.

Object.unwatch
Disponibilidad

Flash Player 6.
Sintaxis

myObject.unwatch (prop)
Parmetros

prop

Nombre de la propiedad de objeto que ya no debe observarse, como una cadena.

Valor devuelto

Un valor booleano.
Descripcin

Mtodo; elimina un punto de observacin creado por el mtodo Object.watch. Este mtodo devuelve el valor true si el punto de observacin se ha eliminado correctamente; en caso contrario, devuelve el valor false.

Diccionario de ActionScript 373

Object.valueOf
Disponibilidad

Flash Player 5.
Sintaxis

myObject.valueOf()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; devuelve el valor primitivo del objeto especificado. Si el objeto no tiene un valor primitivo, se devuelve el propio objeto.

Object.watch
Disponibilidad

Flash Player 6.
Sintaxis

myObject.watch( prop, callback [, datosUsuario] )

Parmetros

prop

Cadena que indica el nombre de la propiedad de objeto que se debe observar.

La funcin que se invoca cuando cambia la propiedad observada. Este parmetro es un objeto de funcin, no es un nombre de funcin en formato de cadena. La forma de callback es callback(prop, valorAnterior, valorNuevo, datosUsuario).
callback datosUsuario Datos de ActionScript arbitrarios que se pasan al mtodo callback. Si se omite el parmetro datosUsuario, se pasa el valor undefined al mtodo callback. Este parmetro es

opcional.
Valor devuelto

El valor true si el punto de observacin se ha creado correctamente; en caso contrario, devuelve el valor false.
Descripcin

Mtodo; registra una funcin callback que se debe invocar cuando cambia una propiedad especfica de un objeto de ActionScript. Si la propiedad cambia, la funcin callback se invoca con myObject como el objeto que la contiene. Un punto de observacin puede filtrar (o anular) la asignacin del valor, mediante la devolucin de un valorNuevo (o valorAnterior) modificado. Si elimina una propiedad para la que se ha establecido un punto de observacin, dicho punto no desaparece. Si, posteriormente, vuelve a crear dicha propiedad, el punto de observacin todava funcionar. Para eliminar un punto de observacin, utilice el mtodo Object.unwatch.
Object.watch

Slo se puede registrar un punto de observacin en una propiedad. Las posteriores llamadas a en la misma propiedad sustituirn el punto de observacin original.

374

El mtodo Object.watch se comporta de forma parecida a la funcin Object.watch en Netscape JavaScript 1.2 y posteriores. La principal diferencia se encuentra en el parmetro datosUsuario; se trata de una adicin de Flash a Object.watch que Netscape Navigator no admite. Puede pasar el parmetro datosUsuario a la funcin callback y utilizarlo en dicha funcin. El mtodo Object.watch no puede observar las propiedades del captador/definidor. Las propiedades del captador/definidor funcionan segn un clculo diferido, es decir, el valor de la propiedad no se determina hasta que se consulta la propiedad. A menudo, el clculo diferido es ms eficiente puesto que la propiedad no se actualiza constantemente, sino que se calcula cuando es necesario. Sin embargo, Object.watch necesita calcular el valor de una propiedad para poder activar puntos de observacin establecidos en la misma. Para trabajar con una propiedad de captador/definidor, Object.watch necesita calcular constantemente la propiedad, lo cual no es eficiente. Normalmente, las propiedades predefinidas de ActionScript, tales como _x, _y, _width y _height, son propiedades de captador/definidor y, por consiguiente, no pueden observarse mediante Object.watch.
Ejemplo

En este ejemplo se muestra un componente CheckBox con mtodos que definen la etiqueta o el valor de cada instancia de casilla de verificacin:
myCheckBox1.setValue(true); myCheckBox1.setLabel("nueva etiqueta"); ...

Es preferible pensar en el valor y la etiqueta de una casilla de verificacin como propiedades. Puede utilizar Object.watch para que el acceso al valor y la etiqueta sea parecido al acceso de propiedades en lugar de la invocacin de mtodo, como se muestra a continuacin:
// Definir el constructor para (y, con ello, definir) la clase CheckBox function CheckBox() { ... this.watch ('value', function (id, oldval, newval)) { ... } this.watch ('label', function (id, oldval, newval)) { ... } }

Si se modifica el valor o la etiqueta de la propiedad, la funcin especificada por el componente se invoca para que realice las tareas necesarias para actualizar el aspecto y el estado del componente de modo que refleje los nuevos parmetros. Por lo tanto, la sentencia de asignacin siguiente utiliza un controlador Object.watch para notificar al componente que la variable ha cambiado y, por consiguiente, se debe actualizar su representacin grfica.
myCheckBox1.value = false;

Esta sintaxis es ms concisa que la sintaxis anterior:

myCheckBox1.setValue(false);
Vase tambin

Object.addProperty, Object.unwatch

Diccionario de ActionScript 375

onClipEvent
Disponibilidad

Flash Player 5.
Sintaxis

onClipEvent(eventoPelcula){ sentencia(s); }
Parmetros

Un eventoPelcula es un desencadenante denominado evento. Cuando el evento tiene lugar, se ejecutan las sentencias entre llaves que van a continuacin del mismo. Puede especificarse cualquiera de los valores siguientes para el parmetro eventoPelcula:

load

La accin se inicia en cuanto se crea una instancia del clip de pelcula y aparece en la lnea de tiempo. 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 que se asocien acciones al fotograma afectado.

unload

enterFrame La accin se desencadena de forma continua a la velocidad de los fotogramas de la pelcula. Las acciones asociadas con el evento de clip enterFrame se procesan antes que cualquiera de las acciones de fotogramas asociadas a los fotogramas afectados. mouseMove La accin se inicia cada vez que se mueve el ratn. Utilice _xmouse y _ymouse para determinar la posicin actual del ratn. mouseDown mouseUp keyDown keyUp

las propiedades

La accin se inicia cada vez que se presiona el botn izquierdo del ratn. La accin se inicia cada vez que se suelta el botn izquierdo del ratn.

La accin se inicia cuando se presiona una tecla. Utilice el mtodo Key.getCode para recuperar informacin sobre la ltima tecla presionada. 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. Cuando se especifica con una accin loadVariables, el evento data slo se produce una vez, cuando se carga la ltima variable. Cuando se especifica con una accin loadMovie, el evento data se produce repetidamente, segn se recupera cada seccin de datos.

sentencia(s)
Descripcin

Las instrucciones que se van a ejecutar cuando tiene lugar eventoRatn.

Controlador de eventos; desencadena acciones definidas para una instancia especfica de un clip de pelcula.
Ejemplo

La sentencia siguiente incluye el script de un archivo externo cuando se exporta la pelcula; las acciones del script incluido se ejecutan cuando se carga el clip de pelcula al que estn asociadas:
onClipEvent(load) { #include "myScript.as" }

376

El ejemplo siguiente utiliza onClipEvent con el evento de pelcula keyDown. El evento de pelcula keyDown se utiliza habitualmente junto con uno o ms mtodos y propiedades asociadas con el objeto Key. En el script siguiente se utiliza el mtodo Key.getCode para averiguar qu tecla ha presionado el usuario: si la tecla presionada coincide con la propiedad Key.RIGHT, la pelcula se enva al fotograma siguiente; si la tecla presionada coincide con la propiedad Key.LEFT, la pelcula se enva al fotograma anterior.
onClipEvent(keyDown) { if (Key.getCode() == Key.RIGHT) { _parent.nextFrame(); } else if (Key.getCode() == Key.LEFT){ _parent.prevFrame(); } }

El ejemplo siguiente utiliza onClipEvent con el evento de pelcula mouseMove. Las propiedades _xmouse e _ymouse realizan un seguimiento de la posicin del ratn cada vez que se mueve.
onClipEvent(mouseMove) { stageX=_root.xmouse; stageY=_root.ymouse; }
Vase tambin

Key (objeto), MovieClip._xmouse, MovieClip._ymouse, on

Diccionario de ActionScript 377

on
Disponibilidad

Flash 2. No todos los eventos se admiten en Flash 2.

Sintaxis

on(eventoRatn) { sentencia(s); }
Parmetros

sentencia(s)

Las instrucciones que se van a ejecutar cuando tiene lugar eventoRatn.

Un eventoRatn es un desencadenante denominado evento. Cuando el evento tiene lugar, se ejecutan las sentencias entre llaves que van a continuacin del mismo. Puede especificarse cualquiera de los valores siguientes para el parmetro eventoRatn:

press release

Se presiona el botn del ratn mientras el puntero se encuentra sobre el botn. Se suelta el botn del ratn mientras el puntero se encuentra sobre el botn.

releaseOutside Se suelta el botn del ratn mientras el puntero est fuera del botn despus de haber presionado el botn mientras el puntero estaba dentro del botn. rollOut rollOver dragOut

El puntero se desplaza fuera del rea del botn. El puntero del ratn se desplaza sobre el botn.

Mientras el puntero se encuentra sobre el botn, se presiona el botn del ratn y despus se desplaza fuera del rea del botn.

dragOver Mientras el puntero se encuentra sobre el botn, se ha presionado el botn del ratn, se ha desplazado fuera del botn y, a continuacin, se ha vuelto a desplazar sobre el botn. keyPress (tecla)

Se presiona la tecla especificada. La parte tecla del parmetro se especifica mediante cualquiera de los cdigos de tecla que se enumeran en el apndice C, Teclas del teclado y valores de cdigos de tecla, de la publicacin Utilizacin de Flash o cualquiera de las constantes de tecla que se enumeran en el Resumen de las propiedades del objeto Key.

Descripcin

Controlador de eventos; especifica el evento de ratn o las teclas que desencadenan una accin.
Ejemplo

En el script siguiente, la accin startDrag se ejecuta cuando se presiona el ratn y el script condicional se ejecuta cuando se suelta el ratn y el objeto.
on(press) { startDrag("rabbit"); } on(release) { trace(_root.rabbit._y); trace(_root.rabbit._x); stopDrag(); }
Vase tambin

onClipEvent

378

or
Disponibilidad

Flash 4. Este operador se ha desestimado; se recomienda utilizar el operador || (OR lgico).

Sintaxis

condicin1 or condicin2
Parmetros

condicin1,2
Valor devuelto

Una expresin que da como resultado true o false.

Ninguno.
Descripcin

Operador; calcula el resultado de condicin1 y condicin2 y si cualquiera de las condiciones es true, toda la expresin ser true.
Vase tambin

|| (OR lgico), | (OR en modo bit)

ord
Disponibilidad

Flash Player 4. Esta funcin se ha desestimado; se recomienda utilizar los mtodos y las propiedades de String (objeto).
Sintaxis

ord(carcter)
Parmetros

carcter

El carcter que se convierte en un nmero de cdigo ASCII.

Valor devuelto

Ninguno.
Descripcin

Funcin de cadena; convierte los caracteres en nmeros de cdigo ASCII.

Vase tambin

String (objeto)

Diccionario de ActionScript 379

_parent
Disponibilidad

Flash Player 4.
Sintaxis

_parent.property _parent._parent.property
Descripcin

Propiedad; especifica o devuelve una referencia al clip de pelcula que contiene el objeto o el clip de pelcula. El objeto actual es el objeto que contiene el cdigo de ActionScript que hace referencia a _parent. Utilice _parent para especificar una ruta relativa a los clips de pelcula u objetos que estn por encima del clip de pelcula u objeto actual.
Ejemplo

En el ejemplo siguiente, el clip de pelcula desk es un elemento secundario del clip de pelcula classroom. Cuando el script siguiente se ejecuta dentro del clip de pelcula desk, la cabeza lectora saltar al fotograma 10 de la lnea de tiempo del clip de pelcula classroom.
_parent.gotoAndStop(10);
Vase tambin

_root, targetPath

parseFloat
Disponibilidad

Flash Player 5.
Sintaxis

parseFloat(cadena)
Parmetros

cadena

La cadena que debe leerse y convertirse en un nmero de coma flotante.

Valor devuelto

Ninguno.
Descripcin

Funcin; convierte una cadena en un nmero de coma flotante. La funcin lee, o analiza, y devuelve los nmeros de una cadena, hasta que encuentra un carcter que no es parte del nmero inicial. Si la cadena no empieza por un nmero que puede analizarse, parseFloat devuelve NaN. El espacio en blanco que precede a los nmeros enteros vlidos se ignora, al igual que los caracteres no numricos finales.

380

Ejemplo

El ejemplo siguiente utiliza la funcin parseFloat para calcular el valor de varios tipos de nmeros.
parseFloat("-2")

devuelve -2 devuelve 2.5 devuelve 3.5e6, o 3500000 devuelve NaN devuelve 3.75 devuelve 0

parseFloat("2.5")

parseFloat("3.5e6")

parseFloat("foobar") parseFloat(" 5.1")

devuelve 5.1

parseFloat("3.75math") parseFloat("0garbage")

parseInt
Disponibilidad

Flash Player 5.
Sintaxis

parseInt(expresin, [base])
Parmetros

expresin base

Una cadena que se convierte en un nmero entero.

Un nmero entero que representa la base del nmero que se va a analizar. Los valores vlidos van de 2 a 36. Este parmetro es opcional.

Valor devuelto

Ninguno.
Descripcin

Funcin; convierte una cadena en un nmero entero. Si la cadena especificada en los parmetros no puede convertirse en un nmero, la funcin devuelve NaN. Los nmeros enteros que empiezan por 0 o que especifican una base 8 se interpretan como nmeros octales. Las cadenas que empiezan por 0x se interpretan como nmeros hexadecimales. El espacio en blanco que precede a los nmeros enteros vlidos se ignora, al igual que los caracteres no numricos finales.
Ejemplo

El ejemplo siguiente utiliza la funcin parseInt para calcular el valor de varios tipos de nmeros.
parseInt("3.5") // devuelve 3.5 parseInt("bar") // devuelve NaN parseInt("4foo") // devuelve 4

A continuacin, se muestran ejemplos de conversiones hexadecimales:

parseInt("0x3F8") // devuelve 1016 parseInt("3E8", 16) // devuelve 1000

Diccionario de ActionScript 381

A continuacin, se muestran ejemplos de una conversin binaria:

parseInt("1010", 2) // devuelve 10 (la representacin decimal del binario 1010)

A continuacin, se muestra un ejemplo de anlisis de nmeros octales (en este caso el nmero octal se identifica por la base, 8):
parseInt("777", 8) // devuelve 511 (la presentacin decimal del octal 777)

play
Disponibilidad

Flash 2.
Sintaxis

play()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Accin; desplaza la cabeza lectora hacia delante en la lnea de tiempo.

Ejemplo

El cdigo siguiente utiliza la sentencia if para comprobar el valor de un nombre que introduce el usuario. Si el usuario introduce Alberto, se llama a la accin play y la cabeza lectora avanza en la lnea de tiempo. Si el usuario introduce un valor distinto a Alberto, la pelcula no se reproduce y aparece un campo de texto con el nombre de variable alert.
stop(); if (name == "Alberto") { play(); } else { alert="Usted no es Alberto!"; }

prevFrame
Disponibilidad

Flash 2.
Sintaxis

prevFrame()
Parmetros

Ninguno.
Valor devuelto

Ninguno.

382

Descripcin

Accin; enva la cabeza lectora al fotograma anterior y la detiene. Si el fotograma actual es 1, la cabeza lectora no se mueve.
Ejemplo

Cuando el usuario hace clic en un botn que tiene asociado el controlador siguiente, la cabeza lectora se enva al fotograma anterior.
on(release) { prevFrame(); }
Vase tambin

MovieClip.prevFrame

prevScene
Disponibilidad

Flash 2.
Sintaxis

prevScene()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Accin; enva la cabeza lectora al fotograma 1 de la escena anterior y la detiene.

Vase tambin

nextScene

Diccionario de ActionScript 383

print
Disponibilidad

Flash Player 4.20.

Sintaxis

print (nivel) print (nivel, "Recuadro de delimitacin") print ("destino") print ("destino", "Recuadro de delimitacin") printAsBitmap (nivel) printAsBitmap (nivel, "Recuadro de delimitacin") printAsBitmap ("destino") printAsBitmap ("destino", "Recuadro de delimitacin")
Parmetros

print En modo Normal en el panel Acciones, seleccione Como vectores para imprimir los fotogramas que no contienen imgenes de mapas de bits o para utilizar la transparencia (alfa) o efectos de color; seleccione Como mapa de bits para imprimir los fotogramas que contienen imgenes de mapas de bits, transparencias o efectos de color. Si selecciona el parmetro Print Como mapa de bits, la sintaxis AsBitmap se adjunta a la accin print del panel Acciones. nivel Nivel de Flash Player que se imprimir. En el panel Acciones en modo Normal, si selecciona un nivel, la accin print cambia a printNum o printAsBitmapNum; en modo Experto, debe especificar printNum o printAsBitmapNum. De forma predeterminada, se imprimen todos los fotogramas del nivel. Si desea imprimir determinados fotogramas del nivel, asigne una etiqueta de fotograma #p a dichos fotogramas. destino El nombre de instancia de un clip de pelcula que se va a imprimir. De forma predeterminada, se imprimen todos los fotogramas de la instancia de destino. Si desea imprimir determinados fotogramas del clip de pelcula, asigne una etiqueta de fotograma #p a dichos fotogramas. Recuadro de delimitacin

Modificador que define el rea de impresin de la pelcula. Este parmetro es opcional. Puede elegir uno de los parmetros siguientes: Designa el recuadro de delimitacin de un fotograma especfico de una pelcula como el rea de impresin para todos los fotogramas imprimibles de la pelcula. Asigne una etiqueta de fotograma #b al fotograma cuyo recuadro de delimitacin desee utilizar como rea de impresin.
bmovie bmax

Designa como rea de impresin un compuesto de todos los recuadros de delimitacin de todos los fotogramas imprimibles. Especifique el parmetro bmax cuando los fotogramas imprimibles de la pelcula varen de tamao.

bframe Designa que se utilice el recuadro de delimitacin de cada fotograma imprimible como rea de impresin para ese fotograma. Esto cambia el rea de impresin para cada fotograma y modifica la escala de los objetos para que quepan en el rea de impresin. Utilice bframe si tiene objetos de diferentes tamaos en cada fotograma y desea que cada objeto rellene la pgina impresa.

Valor devuelto

Ninguno.

384

Descripcin

Accin; imprime el clip de pelcula de destino segn los lmites especificados en el parmetro (bmovie, bmax o bframe). Si desea imprimir determinados fotogramas de la pelcula de destino, adjunte una etiqueta de fotograma #P a dichos fotogramas. Aunque la accin print produce impresiones de ms alta calidad que la accin printAsBitmap, no puede utilizarse para imprimir pelculas que utilizan transparencias alfa o efectos especiales de color. Si no especifica el parmetro para el lmite de impresin, el rea de impresin se determina de modo predeterminado por el tamao del escenario de la pelcula cargada. La pelcula no hereda el tamao del escenario de la pelcula principal. Puede controlar el rea de impresin especificando los parmetros bmovie, bmax o bframe. Todos los elementos imprimibles de una pelcula deben estar cargados por completo antes de que pueda comenzar la impresin. La funcin de impresin de Flash Player admite impresoras PostScript y no PostScript. Las impresoras no PostScript convierten vectores en mapas de bits.
Ejemplo

En el ejemplo siguiente se imprimen todos los fotogramas imprimibles del clip de pelcula myMovie con el rea de impresin definida por el recuadro de delimitacin del fotograma con la etiqueta de fotograma #b adjuntada:
print("myMovie","bmovie");

El ejemplo siguiente imprimir todos los fotogramas imprimibles de myMovie con el rea de impresin definida por el recuadro de delimitacin de cada fotograma:
print("myMovie","bframe");
Vase tambin

printNum, printAsBitmap, printAsBitmapNum

printAsBitmap
Disponibilidad

Flash Player 4.20.

Sintaxis

printAsBitmap(destino, "Recuadro de delimitacin")

Parmetros

destino El nombre de instancia del clip de pelcula que se va a imprimir. De modo predeterminado, se imprimen todos los fotogramas de la pelcula. Si desea imprimir determinados fotogramas de la pelcula, adjunte una etiqueta de fotograma #P a dichos fotogramas. Recuadro de delimitacin Modificador que define el rea de impresin de la pelcula. Puede elegir uno de los parmetros siguientes:

Designa el recuadro de delimitacin de un fotograma especfico de una pelcula como el rea de impresin para todos los fotogramas imprimibles de la pelcula. Asigne una etiqueta de fotograma #b al fotograma cuyo recuadro de delimitacin desee utilizar como rea de impresin.
bmovie bmax

Designa como rea de impresin un compuesto de todos los recuadros de delimitacin de todos los fotogramas imprimibles. Especifique el parmetro bmax cuando los fotogramas imprimibles de la pelcula varen de tamao.

Diccionario de ActionScript 385

bframe Designa que se utilice el recuadro de delimitacin de cada fotograma imprimible como rea de impresin para ese fotograma. Esto cambia el rea de impresin para cada fotograma y modifica la escala de los objetos para que quepan en el rea de impresin. Utilice bframe si tiene objetos de diferentes tamaos en cada fotograma y desea que cada objeto rellene la pgina impresa.

Valor devuelto

Ninguno.
Descripcin

Accin; imprime el clip de pelcula de destino como un mapa de bits. Utilice la accin printAsBitmap para imprimir pelculas que contienen fotogramas con objetos que utilizan transparencias o efectos de color. La accin printAsBitmap imprime con la ms alta resolucin disponible para mantener la mayor calidad y definicin.
print

Si su pelcula no contiene transparencias alfa o efectos de color, se recomienda que utilice la accin para obtener una mejor calidad.

De modo predeterminado, el rea de impresin est determinada por el tamao del escenario de la pelcula cargada. La pelcula no hereda el tamao del escenario de la pelcula principal. Puede controlar el rea de impresin especificando los parmetros bmovie, bmax o bframe. Todos los elementos imprimibles de una pelcula deben estar cargados por completo antes de que pueda comenzar la impresin. La funcin de impresin de Flash Player admite impresoras PostScript y no PostScript. Las impresoras no PostScript convierten vectores en mapas de bits.
Vase tambin

print, printAsBitmapNum, printNum

printAsBitmapNum
Disponibilidad

Flash Player 5.
Sintaxis

printAsBitmapNum(nivel) printAsBitmapNum(nivel, "Recuadro de delimitacin")

Parmetros

nivel

Nivel de Flash Player que se imprimir. De forma predeterminada, se imprimen todos los fotogramas del nivel. Si desea imprimir determinados fotogramas del nivel, asigne una etiqueta de fotograma #p a dichos fotogramas. Modificador que define el rea de impresin de la pelcula. Este parmetro es opcional. Puede elegir uno de los parmetros siguientes: Designa el recuadro de delimitacin de un fotograma especfico de una pelcula como el rea de impresin para todos los fotogramas imprimibles de la pelcula. Asigne una etiqueta de fotograma #b al fotograma cuyo recuadro de delimitacin desee utilizar como rea de impresin.
bmovie bmax

Recuadro de delimitacin

Designa como rea de impresin un compuesto de todos los recuadros de delimitacin de todos los fotogramas imprimibles. Especifique el parmetro bmax cuando los fotogramas imprimibles de la pelcula varen de tamao.

386

bframe Designa que se utilice el recuadro de delimitacin de cada fotograma imprimible como rea de impresin para ese fotograma. Esto cambia el rea de impresin para cada fotograma y modifica la escala de los objetos para que quepan en el rea de impresin. Utilice bframe si tiene objetos de diferentes tamaos en cada fotograma y desea que cada objeto rellene la pgina impresa.

Valor devuelto

Ninguno.
Descripcin

Accin; imprime un nivel de Flash Player como mapa de bits. Utilice la accin printAsBitmapNum para imprimir pelculas que contienen fotogramas con objetos que utilizan transparencias o efectos de color. La accin printAsBitmapNum imprime con la ms alta resolucin disponible para mantener la mayor calidad y definicin. Para calcular el tamao de archivo imprimible de un fotograma designado para impresin como un mapa de bits, multiplique la anchura en pxeles por la altura en pxeles por la resolucin de la impresora. Si su pelcula no contiene transparencias alfa o efectos de color, se recomienda que utilice la accin printNum para obtener una mejor calidad. De modo predeterminado, el rea de impresin est determinada por el tamao del escenario de la pelcula cargada. La pelcula no hereda el tamao del escenario de la pelcula principal. Puede controlar el rea de impresin especificando los parmetros bmovie, bmax o bframe. Todos los elementos imprimibles de una pelcula deben estar cargados por completo antes de que pueda comenzar la impresin. La funcin de impresin de Flash Player admite impresoras PostScript y no PostScript. Las impresoras no PostScript convierten vectores en mapas de bits.
Vase tambin

print, printAsBitmap, printNum

printNum
Disponibilidad

Flash Player 5.
Sintaxis

printNum (nivel, "Recuadro de delimitacin")

Parmetros

nivel

Nivel de Flash Player que se imprimir. De forma predeterminada, se imprimen todos los fotogramas del nivel. Si desea imprimir determinados fotogramas del nivel, asigne una etiqueta de fotograma #p a dichos fotogramas.

Recuadro de delimitacin Modificador que define el rea de impresin de la pelcula. Puede elegir uno de los parmetros siguientes:

bmovie

Designa el recuadro de delimitacin de un fotograma especfico de una pelcula como el rea de impresin para todos los fotogramas imprimibles de la pelcula. Asigne una etiqueta de fotograma #b al fotograma cuyo recuadro de delimitacin desee utilizar como rea de impresin.

Diccionario de ActionScript 387

bmax

Designa como rea de impresin un compuesto de todos los recuadros de delimitacin de todos los fotogramas imprimibles. Especifique el parmetro bmax cuando los fotogramas imprimibles de la pelcula varen de tamao.

bframe Designa que se utilice el recuadro de delimitacin de cada fotograma imprimible como rea de impresin para ese fotograma. Esto cambia el rea de impresin para cada fotograma y modifica la escala de los objetos para que quepan en el rea de impresin. Utilice bframe si tiene objetos de diferentes tamaos en cada fotograma y desea que cada objeto rellene la pgina impresa.

Valor devuelto

Ninguno.
Descripcin

Accin; imprime el nivel de Flash Player de acuerdo con los lmites especificados en el parmetro Recuadro de delimitacin ("bmovie", "bmax", "bframe"). Si desea imprimir determinados fotogramas de la pelcula de destino, adjunte una etiqueta de fotograma #P a dichos fotogramas. Aunque con la accin printNum se obtienen impresiones de mayor calidad que con la accin printAsBitmapNum, no se puede utilizar la accin printNum para imprimir pelculas con transparencias alfa o efectos de color especiales. Si no especifica el parmetro para el lmite de impresin, el rea de impresin se determina de modo predeterminado por el tamao del escenario de la pelcula cargada. La pelcula no hereda el tamao del escenario de la pelcula principal. Puede controlar el rea de impresin especificando los parmetros bmovie, bmax o bframe. Todos los elementos imprimibles de una pelcula deben estar cargados por completo antes de que pueda comenzar la impresin. La funcin de impresin de Flash Player admite impresoras PostScript y no PostScript. Las impresoras no PostScript convierten vectores en mapas de bits.
Vase tambin

print, printAsBitmap, printAsBitmapNum

388

_quality
Disponibilidad

Flash Player 5.
Sintaxis

_quality
Descripcin

Propiedad (global); establece o recupera la calidad de representacin utilizada para una pelcula. Las fuentes de dispositivo siempre son dentadas, de modo que no se ven afectadas por la propiedad _quality. La propiedad _quality puede definirse en los valores siguientes:

"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 con una cuadrcula de 2x2, en pxeles, pero los mapas de bits no se suavizan. Apropiado para pelculas que no contienen texto. Calidad de representacin alta. Los grficos se suavizan con una cuadrcula de 4x4, en pxeles, y los mapas de bits se suavizan si la pelcula es esttica. Esta es la configuracin de la calidad de representacin predeterminada utilizada por Flash.

"HIGH"

"BEST"

Calidad de representacin muy alta. Los grficos se suavizan con una cuadrcula de 4x4, en pxeles, y los mapas de bits se suavizan siempre.

Ejemplo

En el ejemplo siguiente, se define la calidad de representacin en LOW:

_quality = "LOW";
Vase tambin

_highquality, toggleHighQuality

random
Disponibilidad

Flash Player 4. Esta funcin se ha desestimado en Flash 5; se recomienda la utilizacin del mtodo Math.random.
Sintaxis

random(valor)
Parmetros

valor

Un nmero entero.

Valor devuelto

Un nmero entero.
Descripcin

Funcin; devuelve un entero aleatorio entre 0 y un nmero menos que el entero especificado en el parmetro valor.

Diccionario de ActionScript 389

Ejemplo

La utilizacin de la funcin random que se muestra a continuacin devuelve el valor 0, 1, 2, 3 4.

random(5);
Vase tambin

Math.random

removeMovieClip
Disponibilidad

Flash Player 4.
Sintaxis

removeMovieClip(destino)
Parmetros

destino Ruta de destino de una instancia de clip de pelcula creada con la accin duplicateMovieClip, o nombre de instancia de un clip de pelcula creado con los mtodos attachMovie o duplicateMovieClip del objeto MovieClip.
Valor devuelto

Ninguno.
Descripcin

Accin; elimina una instancia de clip de pelcula creada con los mtodos attachMovie o duplicateMovieClip del objeto MovieClip o con la accin duplicateMovieClip.
Vase tambin

duplicateMovieClip, MovieClip.duplicateMovieClip, MovieClip.attachMovie, MovieClip.removeMovieClip

return
Disponibilidad

Flash Player 5.
Sintaxis

return[expresin] return
Parmetros

expresin

Nmero, cadena, matriz u objeto cuyo valor se debe calcular y devolver como valor de la funcin. Este parmetro es opcional.

Valor devuelto

El parmetro expresin calculado, si se proporciona.

Descripcin

Accin; especifica el valor devuelto por una funcin. La accin return calcula el valor del parmetro expresin y devuelve el resultado como valor de la funcin en que se ejecuta. La accin return hace que la funcin deje de ejecutarse y la reemplaza por el valor devuelto. Si la sentencia return se utiliza sola, devuelve null.

390

Ejemplo

En el ejemplo siguiente se utiliza la accin return dentro del cuerpo de la funcin sum para devolver el valor agregado de los tres parmetros. La lnea de cdigo siguiente llama a la funcin sum y asigna el valor devuelto a la variable newValue:
function sum(a, b, c){ return a + b + c; } newValue = sum(4, 32, 78); trace(newValue); // enva 114 a la ventana Salida
Vase tambin

function

_root
Disponibilidad

Flash Player 4.
Sintaxis

_root.clipPelcula _root.accin _root.propiedad

Parmetros

clipPelcula accin

Nombre de instancia de un clip de pelcula.

Una accin o un mtodo. Una propiedad del objeto MovieClip.

propiedad
Descripcin

Propiedad; especifica o devuelve una referencia a la lnea de tiempo de la pelcula raz. Si una pelcula tiene varios niveles, la lnea de tiempo de la pelcula raz est en el nivel que contiene el script que se est ejecutando. Por ejemplo, si un script del nivel 1 consulta el valor de _root, se devuelve _level1. Especificar _root es lo mismo que utilizar la notacin con barras (/) para especificar una ruta absoluta dentro del nivel actual.
Ejemplo

El ejemplo siguiente detiene la lnea de tiempo del nivel que contiene el script que se est ejecutando:
_root.stop();

El ejemplo siguiente enva la lnea de tiempo del nivel actual al fotograma 3.

_root.gotoAndStop(3);
Vase tambin

_parent, targetPath

391

scroll
Disponibilidad

Flash Player 4.
Sintaxis

textFieldVariableName.scroll = x
Descripcin

Propiedad; propiedad desestimada que controla la visualizacin de la informacin en un campo de texto asociado con una variable. La propiedad scroll define dnde comienza a visualizarse el contenido en el campo de texto; una vez que se ha establecido esta propiedad, Flash Player lo 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.
Ejemplo

El cdigo siguiente est asociado a un botn Arriba que desplaza el contenido del campo de texto myText:
on (release) { myText.scroll = myText.scroll + 1; }
Vase tambin

TextField.maxscroll, TextField.scroll

392

Selection (objeto)
El objeto Selection permite definir y controlar en qu campo de texto se encuentra el cursor en una pelcula Flash. El campo de texto seleccionado es el campo en el que est el cursor. Los ndices de espacio de seleccin tienen base cero (por ejemplo, la primera posicin es 0, la segunda 1, etc.). No existe ningn mtodo constructor para el objeto Selection, ya que slo puede haber un campo seleccionado al mismo tiempo. Resumen de los mtodos del objeto Selection
Mtodo Selection.addListener Selection.getBeginIndex Selection.getCaretIndex Descripcin Registra un objeto para que reciba una notificacin cuando se invoque el mtodo onSetFocus. Devuelve el ndice al principio del espacio de seleccin. Devuelve 1 si no hay ndice o campo seleccionado actualmente. Devuelve la posicin de intercalacin actual en el espacio de seleccin actualmente seleccionado. Devuelve 1 si no hay posicin de intercalacin o espacio de seleccin seleccionado. Devuelve el ndice al final del espacio de seleccin. Devuelve 1 si no hay ndice o campo seleccionado actualmente. Devuelve el nombre de la variable para el campo de texto seleccionado. Devuelve el valor null si no hay ningn campo de texto seleccionado. Elimina un objeto registrado con addListener. Selecciona el campo de texto asociado con la variable especificada en el parmetro. Establece los ndices de inicio y fin del espacio de seleccin.

Selection.getEndIndex Selection.getFocus Selection.removeListener Selection.setFocus Selection.setSelection

Resumen de los detectores para el objeto Selection

Mtodo Selection.onSetFocus Descripcin Recibe notificacin cuando cambia la seleccin de entrada.

393

Selection.addListener
Disponibilidad

Flash Player 6.
Sintaxis

Selection.addListener(nuevoDetector)
Parmetros

nuevoDetector
Valor devuelto

Un objeto con un mtodo onSetFocus.

Ninguno.
Descripcin

Mtodo; registra un objeto para que reciba notificaciones de cambio de seleccin de teclado. Cuando cambia la seleccin (por ejemplo, siempre que se invoca el mtodo Selection.SetFocus), todos los objetos de deteccin registrados con addListener tienen su mtodo onSetFocus invocado. Varios objetos pueden detectar notificaciones de cambio de la seleccin. Si el detector nuevoDetector ya est registrado, no se produce ningn cambio.

Selection.getBeginIndex
Disponibilidad

Flash Player 5.
Sintaxis

Selection.getBeginIndex()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve el ndice al principio del espacio de seleccin. Si no existe ningn ndice o no hay ningn campo de texto seleccionado, el mtodo devuelve -1. Los ndices de espacio de seleccin tienen base cero (por ejemplo, la primera posicin es 0, la segunda 1, etc.).

394

Selection.getCaretIndex
Disponibilidad

Flash Player 5.
Sintaxis

Selection.getCaretIndex()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve el ndice de la posicin del cursor que parpadea. Si no aparece ningn cursor parpadeando, el mtodo devuelve -1. Los ndices de espacio de seleccin tienen base cero (por ejemplo, la primera posicin es 0, la segunda 1, etc.).

Selection.getEndIndex
Disponibilidad

Flash Player 5.
Sintaxis

Selection.getEndIndex()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve el ndice al final del espacio de seleccin actualmente seleccionado. Si no existe ningn ndice o no hay ningn espacio de seleccin seleccionado, el mtodo devuelve -1. Los ndices de espacio de seleccin tienen base cero (por ejemplo, la primera posicin es 0, la segunda 1, etc.).

Selection.getFocus
Disponibilidad

Flash Player 5. Los nombres de instancia para los botones y los campos de texto funcionan en Flash Player 6.
Sintaxis

Selection.getFocus()
Parmetros

Ninguno.
Valor devuelto

Ninguno.

395

Descripcin

Mtodo; devuelve el nombre de variable del campo de texto que est seleccionado. Si no hay ningn campo de texto seleccionado, el mtodo devuelve el valor null. Si el elemento seleccionado corresponde a un botn que es una instancia del objeto Button, getFocus devuelve la ruta de destino como cadena. Si el elemento seleccionado corresponde a un campo de texto que es una instancia del objeto TextField, getFocus devuelve la ruta de destino como cadena. Si el botn seleccionado actualmente es un botn de clip de pelcula, Selection.getFocus devuelve la ruta de destino del botn de clip de pelcula. Si el elemento seleccionado es un campo de texto con un nombre de instancia, Selection.getFocus devuelve la ruta de destino del objeto TextField. De lo contrario, devuelve el nombre de la variable de campo de texto.

Selection.onSetFocus
Disponibilidad

Flash Player 6.
Sintaxis

someListener.onSetFocus = function(seleccinAntigua, seleccinNueva){ sentencias; }

Descripcin

Detector; recibe notificacin cuando cambia la seleccin de entrada. Para utilizar onSetFocus, debe crear un objeto detector. A continuacin, puede definir una funcin para onSetFocus y utilizar el mtodo addListener para registrar el detector con el objeto Selection, como en el caso siguiente:
someListener = new Object(); someListener.onSetFocus = function () { ... }; Selection.addListener(someListener);

Los detectores permiten que varios fragmentos de cdigo cooperen, ya que varios detectores pueden recibir notificaciones sobre un mismo evento.
Vase tambin

Selection.addListener

Selection.removeListener
Disponibilidad

Flash Player 6.
Sintaxis

Selection.removeListener(detector)
Parmetros

detector

Objeto que ya no recibir notificaciones sobre el elemento seleccionado.

Valor devuelto

Si el detector se ha eliminado correctamente, el mtodo devuelve un valor true. Si el detector no se ha eliminado correctamente, por ejemplo, si el detector no se encontraba en la lista de detectores del objeto Selection, el mtodo devuelve el valor false.
Descripcin

Mtodo; elimina un objeto previamente registrado con addListener.

396

Selection.setFocus
Disponibilidad

Flash Player 5. Los nombres de instancia para los botones y los campos de texto slo funcionan en Flash Player 6.
Sintaxis

Selection.setFocus(rutaVariable)
Parmetros

rutaVariable

Cadena que especifica la ruta para el nombre de una variable asociada con un

campo de texto.
Valor devuelto

Un evento.
Descripcin

Mtodo; selecciona el campo de texto editable asociado con la variable especificada por rutaVariable. El parmetro rutaVariable debe ser un literal de cadena de la ruta a dicha variable. Para especificar la ruta, puede utilizar notacin con puntos o con barras. Adems, puede utilizar una ruta relativa o absoluta. Si se pasa una ruta de destino de una instancia de botn como parmetro rutaVariable, se selecciona dicho botn. Si se pasa un ruta de destino de una instancia de campo de texto como parmetro rutaVariable, se selecciona dicho campo de texto. Si se pasa el valor null, el elemento seleccionado se elimina. Si se pasa un botn de clip de pelcula a Selection.setFocus, el botn se selecciona. Si se especifica un objeto TextField, ste se selecciona. Si se especifica un objeto Button, ste pasa a ser el botn seleccionado.
Ejemplo

En el ejemplo siguiente, el elemento seleccionado es un campo de texto de la lnea de tiempo principal asociada con la variable myVar. El parmetro rutaVariable es una ruta absoluta, de modo que puede llamar la accin desde cualquier lnea de tiempo.
Selection.setFocus("_root.myVar");

En el ejemplo siguiente, el campo de texto asociado con myVar se encuentra en un clip de pelcula llamado myClip en la lnea de tiempo principal. Para establecer el elemento seleccionado, puede utilizar cualquiera de las dos rutas siguientes; la primera es relativa, y la segunda, absoluta.
Selection.setFocus("myClip.myVar"); Selection.setFocus("_root.myClip.myVar");

Selection.setSelection
Disponibilidad

Flash Player 5.
Sintaxis

Selection.setSelection(inicio, final)
Parmetros

inicio final

ndice de inicio del espacio de seleccin. ndice de final del espacio de seleccin.

397

Valor devuelto

Ninguno.
Descripcin

Mtodo; establece el espacio de seleccin del campo de texto seleccionado actualmente. El nuevo espacio de seleccin comenzar en el ndice especificado en el parmetro inicio y finalizar en el ndice especificado en el parmetro final. Los ndices de espacio de seleccin tienen base cero (por ejemplo, la primera posicin es 0, la segunda 1, etc.). Este mtodo no tiene efecto si no existe campo de texto seleccionado actualmente.

set variable
Disponibilidad

Flash Player 4.
Sintaxis

set(variable, expresin)
Parmetros

variable expresin

Identificador que alberga el valor del parmetro expresin. Valor asignado a la variable.

Valor devuelto

Ninguno.
Descripcin

Accin; asigna un valor a una variable. Una variable es un contenedor que almacena informacin. El contenedor en s es siempre el mismo, pero el contenido puede cambiar. La modificacin del valor de una variable a medida que se reproduce la pelcula permite registrar y guardar informacin sobre las acciones del usuario, registrar valores que se modifican conforme se reproduce la pelcula o comprobar si una determinada condicin es true o false. Las variables pueden albergar cualquier tipo de datos (por ejemplo, cadenas, nmeros, valores booleanos, objetos o clips de pelcula). La lnea de tiempo de cada pelcula y cada clip de pelcula tiene su propio juego de variables, y cada variable tiene su propio valor independiente de variables en otras lneas de tiempo. ActionScript es un lenguaje que asigna el tipo de las variables de forma dinmica. Cada variable tiene un tipo. El tipo se asigna en tiempo de ejecucin y puede cambiar durante la ejecucin. Esto no ocurre en el caso de lenguajes que asignan el tipo de las variables de forma esttica, como Java o C++, en los que el tipo se asigna en tiempo de compilacin y no puede cambiar durante el tiempo de ejecucin.

398

Ejemplo

Este ejemplo establece una variable llamada orig_x_pos que almacena la posicin original del eje x del clip de pelcula barco para poder restablecer el barco a su posicin de inicio ms adelante en la pelcula.
on(release) { set(orig_x_pos, getProperty ("barco", _x )); }

El cdigo anterior produce el mismo resultado que el cdigo siguiente:

on(release) { orig_x_pos = barco._x; }
Vase tambin

var, call

setInterval
Disponibilidad

Flash Player 6.
Sintaxis

setInterval( funcin, intervalo[, arg1, arg2, ..., argn] ) setInterval( objeto, nombreMtodo, intervalo[, arg1, arg2, ..., argn] )
Parmetros

funcin objeto

Nombre de funcin o referencia a una funcin annima. Objeto derivado del objeto Object. Nombre del mtodo al que debe llamarse en el parmetro objeto.

nombreMtodo intervalo

Tiempo entre llamada y llamada al parmetro funcin o nombreMtodo, expresado en milisegundos. Parmetros opcionales pasados al parmetro funcin o

arg1, arg2, ..., argn nombreMtodo.

Valor devuelto

Identificador de intervalo que se puede pasar a clearInterval para cancelar el intervalo.

Descripcin

Accin; llama a una funcin, a un mtodo o a un objeto con una periodicidad determinada mientras se reproduce la pelcula. Puede utilizar una funcin de intervalo para actualizar variables desde una base de datos o actualizar una visualizacin de tiempo. Si el intervalo es menor que la velocidad de fotogramas de la pelcula (por ejemplo, 10 fotogramas por segundo (fps) equivalen a 100 milisegundos), se llama a la funcin de intervalo tan cerca del intervalo como sea posible. Debe utilizar la funcin updateAfterEvent para asegurarse de que la pantalla se actualiza con suficiente frecuencia. Si el intervalo es mayor que la velocidad de fotogramas de la pelcula, slo se llama a la funcin de intervalo cada vez que la cabeza lectora accede a un fotograma para minimizar el impacto cuando se actualiza la pantalla. El primer ejemplo de sintaxis que aparece arriba es la sintaxis predeterminada para la funcin setInterval del panel Acciones en modo Normal. Para utilizar el segundo ejemplo de sintaxis, debe utilizar el panel Acciones en el modo Experto.

399

Ejemplo

Sintaxis 1: en el ejemplo siguiente se llama a una funcin annima cada 1.000 milisegundos (cada 1 segundo).
setInterval( function(){ trace("intervalo llamado"); }, 1000 );

Sintaxis 2: en el ejemplo siguiente se definen dos funciones callback y se llama a cada una de ellas. Ambas llamadas a la funcin setInterval envan la cadena "intervalo llamado" a la ventana Salida cada 1.000 milisegundos. La primera llamada a setInterval llama a la funcin callback1, que contiene una accin trace. La segunda llamada a setInterval pasa la cadena "intervalo llamado" a la funcin callback2 como parmetro.
function callback1() { trace("intervalo llamado"); } function callback2(arg) { trace(arg); } setInterval( callback1, 1000 ); setInterval( callback2, 1000, "intervalo llamado" );

Sintaxis 3: en este ejemplo se utiliza un mtodo de un objeto. Si desea llamar a un mtodo definido para un objeto, debe utilizar esta sintaxis. Esta sintaxis slo se puede utilizar en modo Experto.
obj = new Object(); obj.interval = function() { trace("funcin de intervalo llamada"); } setInterval( obj, "intervalo", 1000 ); obj2 = new Object(); obj2.interval = function(s) { trace(s); } setInterval( obj2, "intervalo", 1000, "funcin de intervalo llamada" );

Para llamar a un mtodo de un objeto, debe utilizar la segunda forma de la sintaxis de setInterval, tal como se indica a continuacin:
setInterval( obj2, "intervalo", 1000, "funcin de intervalo llamada" );
Vase tambin

clearInterval, updateAfterEvent

400

setProperty
Disponibilidad

Flash Player 4.
Sintaxis

setProperty("destino", propiedad, valor/expresin)

Parmetros

destino propiedad valor

Ruta al nombre de instancia del clip de pelcula cuya propiedad debe establecerse. Propiedad que debe establecerse. Ecuacin que da como resultado el nuevo valor de la propiedad. Nuevo valor literal de la propiedad.

expresin

Valor devuelto

Ninguno.
Descripcin

Accin; cambia un valor de propiedad de un clip de pelcula a medida que se reproduce la pelcula.
Ejemplo

Esta sentencia establece la propiedad _alpha de un clip de pelcula llamado estrella en el 30% cuando se hace clic en el botn.
on(release) { setProperty("estrella", _alpha, "30"); }
Vase tambin

getProperty

Sound (objeto)
El objeto Sound permite controlar el sonido de una pelcula. Puede agregar sonidos a un clip de pelcula desde la biblioteca mientras se reproduce la pelcula y controlar estos sonidos. Si no especifica un destino al crear un nuevo objeto Sound, puede utilizar los mtodos para controlar el sonido de toda la pelcula. Debe utilizar el constructor new Sound para crear una instancia del objeto Sound antes de llamar a los mtodos del objeto Sound. El objeto Sound se admite en Flash Player 5 y Flash Player 6. Resumen de los mtodos del objeto Sound
Mtodo Sound.attachSound Sound.getBytesLoaded Sound.getBytesTotal Sound.getPan Sound.getTransform Descripcin Asocia el sonido especificado en el parmetro. Devuelve el nmero de bytes cargados para el sonido especificado. Devuelve el tamao del sonido en bytes. Devuelve el valor de la llamada setPan anterior. Devuelve el valor de la llamada setTransform anterior.

401

Mtodo Sound.getVolume Sound.loadSound Sound.setPan Sound.setTransform Sound.setVolume Sound.start Sound.stop

Descripcin Devuelve el valor de la llamada setVolume anterior. Carga un archivo MP3 en Flash Player. Establece el balance izquierda/derecha del sonido. Establece el valor de cada canal, izquierdo y derecho, que debe reproducirse en cada altavoz. Establece el nivel de volumen de un sonido. Comienza a reproducir un sonido desde el principio u opcionalmente desde un punto de desplazamiento establecido en el parmetro. Detiene el sonido especificado o todos los sonidos que se estn reproduciendo actualmente.

Resumen de las propiedades del objeto Sound

Mtodo Sound.duration Sound.position Descripcin Duracin de un sonido en milisegundos. Nmero de milisegundos durante los que se ha reproducido el sonido.

Resumen del controlador de eventos del objeto Sound

Mtodo Sound.onLoad Sound.onSoundComp lete Descripcin Se invoca cuando se carga un sonido. Se invoca cuando se detiene la reproduccin de un sonido.

Constructor del objeto Sound

Disponibilidad

Flash Player 5.
Sintaxis

new Sound([destino])
Parmetros

destino

Instancia de clip de pelcula en la que opera el objeto Sound. Este parmetro es

opcional.
Valor devuelto

Ninguno.
Descripcin

Constructor; crea un nuevo objeto Sound para un clip de pelcula especificado. Si no se especifica una instancia de destino, el objeto Sound controla todos los sonidos de la pelcula.

402

Ejemplo

En el ejemplo siguiente se crea una nueva instancia del objeto Sound denominada GlobalSound. La segunda lnea llama al mtodo setVolume y ajusta el volumen de todos los sonidos de la pelcula a un 50%.
globalsound = new Sound(); globalsound.setVolume(50);

En el ejemplo siguiente se crea una nueva instancia del objeto Sound, se le pasa el clip de pelcula de destino myMovie y se llama al mtodo start, que inicia cualquier sonido en myMovie.
moviesound = new Sound(myMovie); moviesound.start();

Sound.attachSound
Disponibilidad

Flash Player 5.
Sintaxis

mySound.attachSound("idNombre")
Parmetros

idNombre

Identificador de un sonido exportado en la biblioteca. El identificador se encuentra en el cuadro de dilogo Propiedades de vnculos de smbolos.

Valor devuelto

Ninguno.
Descripcin

Mtodo; asocia el sonido especificado en el parmetro idNombre al objeto Sound especificado. El sonido debe estar en la biblioteca de la pelcula actual y debe estar especificado para la exportacin en el cuadro de dilogo Propiedades de vnculos de smbolos. Debe llamar a Sound.start para comenzar a reproducir el sonido.
Vase tambin

Sound.start

Sound.duration
Disponibilidad

Flash Player 6.
Sintaxis

mySound.duration
Descripcin

Propiedad (slo lectura); duracin de un sonido en milisegundos.

403

Sound.getBytesLoaded
Disponibilidad

Flash Player 6.
Sintaxis

Sound.getBytesLoaded()
Parmetros

Ninguno.
Valor devuelto

Entero que indica el nmero de bytes cargados.

Descripcin

Mtodo; devuelve el nmero de bytes cargados (en flujo) para el objeto Sound especificado. Puede comparar el valor de getBytesLoaded con el de getBytesTotal para determinar el porcentaje que se ha cargado de un sonido.
Vase tambin

Sound.getBytesTotal

Sound.getBytesTotal
Disponibilidad

Flash Player 6.
Sintaxis

Sound.getBytesTotal()
Parmetros

Ninguno.
Valor devuelto

Entero que indica el tamao total, en bytes, del objeto Sound especificado.
Descripcin

Mtodo; devuelve el tamao, en bytes, del objeto Sound especificado.

Vase tambin

Sound.getBytesLoaded

404

Sound.getPan
Disponibilidad

Flash Player 5.
Sintaxis

mySound.getPan();
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; devuelve el nivel de panormica establecido en la ltima llamada setPan como un entero entre -100 (izquierda) y 100 (derecha). El valor 0 establece los canales izquierdo y derecho en el mismo valor. La configuracin de panormica controla el balance izquierda-derecha de los sonidos actuales y futuros de una pelcula. Este mtodo es acumulativo con los mtodos setVolume o setTransform.
Vase tambin

Sound.setPan

Sound.getTransform
Disponibilidad

Flash Player 5.
Sintaxis

mySound.getTransform();
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; devuelve la informacin de transformacin de sonido para el objeto Sound especificado con la ltima llamada setTransform.
Vase tambin

Sound.setTransform

405

Sound.getVolume
Disponibilidad

Flash Player 5.
Sintaxis

mySound.getVolume()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; devuelve el nivel de volumen de sonido como un nmero entero de 0 a 100, donde 0 es apagado y 100 es a todo volumen. El valor predeterminado es 100.
Vase tambin

Sound.setVolume

Sound.loadSound
Disponibilidad

Flash Player 6.
Sintaxis

mySound.loadSound("url", deFlujo)
Parmetros

url

Ubicacin de un archivo de sonido MP3 en un servidor. Valor booleano que indica si el sonido es de flujo o de evento.

deFlujo

Valor devuelto

Ninguno.
Descripcin

Mtodo; carga un archivo MP3 en una instancia del objeto Sound. Puede utilizar el parmetro deFlujo para indicar si el sonido es de evento o de flujo. Los sonidos de evento se cargan completamente antes de reproducirse. Los gestiona el objeto Sound de ActionScript y responden a todos los mtodos y propiedades de este objeto. Los sonidos de flujo se reproducen mientras se descargan. La reproduccin empieza cuando se han recibido suficientes datos para iniciar el descompresor. Al igual que los sonidos de evento, los sonidos de flujo slo existen en una memoria virtual; no se descargan en el disco duro.
Ejemplo

En el ejemplo siguiente se carga un sonido de evento:

s.loadSound( "http://rutaservidor:puerto/nombrearchivomp3", false);

En el ejemplo siguiente se carga un sonido de flujo:

loadSound( "http://rutaservidor:puerto/nombrearchivomp3", true);

406

Sound.onLoad
Disponibilidad

Flash Player 6.
Sintaxis

mySoundObject.onLoad = funcinCallback
Parmetros

mySoundObject funcinCallback
Valor devuelto

Un objeto Sound. Una funcin.

Ninguno.
Descripcin

Controlador de eventos; se invoca automticamente cuando se carga un sonido. Debe crear una funcin que se ejecute cuando se invoque el evento onLoad. Puede utilizar una funcin annima o una funcin con nombre.
Vase tambin

Sound.onSoundComplete

Sound.onSoundComplete
Disponibilidad

Flash Player 6.
Sintaxis

mySoundObject.onSoundComplete = funcinCallback
Parmetros

mySoundObject funcinCallback
Valor devuelto

Un objeto Sound. Una funcin.

Ninguno.
Descripcin

Evento; se invoca automticamente cuando finaliza la reproduccin de un sonido. Puede utilizar el evento onSoundComplete para desencadenar eventos de una pelcula basndose en la finalizacin de un sonido. Debe crear una funcin que se ejecute cuando se invoque el evento onSoundComplete. Puede utilizar una funcin annima o una funcin con nombre.
Ejemplo

Sintaxis 1: en el ejemplo siguiente se utiliza una funcin annima:

s = new Sound(); s.attachSound("mySound"); s.onSoundComplete = function() { trace("mySound finalizado"); }; s.start();

407

Sintaxis 2: en el ejemplo siguiente se utiliza una funcin con nombre:

function callback1() { trace("mySound finalizado"); } s = new Sound(); s.attachSound("mySound"); s.onSoundComplete = callback1; s.start();

Sound.position
Disponibilidad

Flash Player 6.
Sintaxis

mySound.position
Parmetros

Ninguno.
Valor devuelto

Nmero de milisegundos durante los que se ha reproducido el sonido.

Descripcin

Propiedad (slo lectura); devuelve el nmero de milisegundos durante el que se ha reproducido un sonido. Si el sonido se repite, la posicin se restablecer en 0 al principio de cada repeticin.

Sound.setPan
Disponibilidad

Flash Player 5.
Sintaxis

mySound.setPan(panormica);
Parmetros

panormica Nmero entero que especifica el balance izquierda-derecha de un sonido. Los valores vlidos deben estar comprendidos entre -100 y 100, donde -100 utiliza solamente el canal izquierdo, 100 utiliza solamente el canal derecho y 0 establece un balance de sonido uniforme entre los dos canales.
Valor devuelto

Ninguno.
Descripcin

Mtodo; determina como se reproduce el sonido en los canales izquierdo y derecho (altavoces). Para los sonidos mono, panormica determina a travs de qu altavoz (izquierdo o derecho) se reproduce el sonido.

408

Ejemplo

En el ejemplo siguiente se crea una instancia del objeto Sound s y se asocia un sonido con el identificador L7 de la biblioteca. Tambin llama a los mtodos setVolume y setPan para controlar el sonido L7.
onClipEvent(mouseDown) { // crea un objeto Sound s = new Sound(this); // asocia un sonido de la biblioteca s.attachSound("L7"); //establecer el volumen al 50% s.setVolume(50); //desactivar el sonido en el canal derecho s.setPan(-100); //empezar 30 segundos despus del inicio del sonido y reproducirlo 5 veces s.start(30, 5);
Vase tambin

Sound.attachSound, Sound.setPan, Sound.setTransform, Sound.setVolume, Sound.start

Sound.setTransform
Disponibilidad

Flash Player 5.
Sintaxis

mySound.setTransform(soundTransformObject)
Parmetros

soundTransformObject
Valor devuelto

Objeto creado con el constructor del objeto Object genrico.

Ninguno.
Descripcin

Mtodo; establece la informacin de transformacin, o de "balance", de sonido para un objeto Sound. El parmetro soundTransformObject es un objeto que se crea utilizando el mtodo constructor del objeto Object genrico con parmetros que especifican cmo se distribuye el sonido en los canales izquierdo y derecho (altavoces). Los sonidos necesitan una cantidad considerable de espacio en la unidad de disco y en la memoria. Debido a que los sonidos estreo utilizan el doble de datos que los sonidos mono, normalmente es mejor utilizar sonidos mono de 6 bits a 22 KHz. Puede utilizar el mtodo setTransform para reproducir sonidos mono como sonidos estreo, reproducir sonidos estreo como sonidos mono y agregar efectos interesantes a los sonidos. Los parmetros de soundTransformObject son los siguientes: ll Porcentaje que especifica qu cantidad de la entrada izquierda se reproduce en el altavoz izquierdo (de 0 a 100). lr Porcentaje que especifica qu cantidad de la entrada derecha se reproduce en el altavoz izquierdo (de 0 a 100).

409

rr Porcentaje que especifica qu cantidad de la entrada derecha se reproduce en el altavoz derecho (de 0 a 100).
rl Porcentaje que especifica qu cantidad de la entrada izquierda se reproduce en el altavoz derecho (de 0 a 100).

El resultado neto de los parmetros se representa mediante la frmula siguiente:

leftOutput = left_input * ll + right_input * lr rightOutput = right_input * rr + left_input * rl

Los valores de left_input y right_input se determinan segn el tipo del sonido (estreo o mono) de la pelcula. Los sonidos estreo dividen la entrada del sonido uniformemente entre los altavoces izquierdo y derecho y de forma predeterminada tienen la configuracin de transformacin siguiente:
ll lr rr rl = = = = 100 0 100 0

Los sonidos mono reproducen toda la entrada de sonido en el altavoz izquierdo y de forma predeterminada tienen la configuracin de transformacin siguiente:
ll lr rr rl = = = = 100 100 0 0

Ejemplo

En el ejemplo siguiente se ilustra una configuracin que se puede conseguir con el mtodo setTransform, pero no con los mtodos setVolume o setPan, ni siquiera combinndolos. El cdigo siguiente crea un nuevo objeto soundTransformObject y establece sus propiedades de modo que el sonido de ambos canales se reproduzca slo en el canal izquierdo.
mySoundTransformObject = new Object; mySoundTransformObject.ll = 100; mySoundTransformObject.lr = 100; mySoundTransformObject.rr = 0; mySoundTransformObject.rl = 0;

Para aplicar el objeto soundTransformObject a un objeto Sound, debe pasar el objeto al objeto Sound utilizando el mtodo setTransform del modo siguiente:
mySound.setTransform(mySoundTransformObject);

En el ejemplo siguiente se reproduce un sonido estreo como sonido mono; soundTransformObjectMono tiene los parmetros siguientes.
mySoundTransformObjectMono = new Object; mySoundTransformObjectMono.ll = 50; mySoundTransformObjectMono.lr = 50; mySoundTransformObjectMono.rr = 50; mySoundTransformObjectMono.rl = 50; mySound.setTransform(soundTransformObjectMono);

410

Este ejemplo reproduce el canal izquierdo a media capacidad y agrega el resto del canal izquierdo al canal derecho; soundTransformObjectHalf tiene los parmetros siguientes.
mySoundTransformObjectHalf = new Object; mySoundTransformObjectHalf.ll = 50; mySoundTransformObjectHalf.lr = 0; mySoundTransformObjectHalf.rr = 100; mySoundTransformObjectHalf.rl = 50; setTransform(soundTransformObjectHalf);
Vase tambin

Constructor del objeto Object.

Sound.setVolume
Disponibilidad

Flash Player 5.
Sintaxis

mySound.setVolume(volumen)
Parmetros

volumen Nmero de 0 a 100 que representa un nivel de volumen.100 es a todo volumen y 0 es sin volumen. El valor predeterminado es 100.
Valor devuelto

Ninguno.
Descripcin

Mtodo; establece el volumen para el objeto Sound.

Ejemplo

En el ejemplo siguiente se establece el volumen al 50% y se transfiere el sonido a lo largo del tiempo desde el altavoz izquierdo al altavoz derecho.
onClipEvent (load) { i = -100; s = new Sound(); s.setVolume(50); } onClipEvent (enterFrame) { if (i <= 100) { S.setPan(i++); } }
Vase tambin

Sound.setPan, Sound.setTransform

411

Sound.start
Disponibilidad

Flash Player 5.
Sintaxis

mySound.start([desplazamientoSegundos, bucle])
Parmetros

Parmetro opcional que permite iniciar la reproduccin del sonido en un momento especfico. Por ejemplo, si tiene un sonido de 30 segundos y desea que el sonido comience a reproducirse a la mitad, especifique 15 en el parmetro desplazamientoSegundos. El sonido no se retrasa 15 segundos, sino que comienza a reproducirse en la marca de 15 segundos.
desplazamientoSegundos bucle

Parmetro opcional que permite especificar el nmero de veces que debe reproducirse el sonido de manera consecutiva.

Valor devuelto

Ninguno.
Descripcin

Mtodo; comienza a reproducir el ltimo sonido asociado desde el principio, si no se especifican parmetros, o desde un punto determinado del sonido especificado por el parmetro desplazamientoSegundos.
Vase tambin

Sound.stop

Sound.stop
Disponibilidad

Flash Player 5.
Sintaxis

mySound.stop(["idNombre"])
Parmetros

idNombre

Parmetro opcional que especifica que se detenga la reproduccin de un sonido concreto. El parmetro idNombre debe escribirse entre comillas (" ").

Valor devuelto

Ninguno.
Descripcin

Mtodo; detiene todos los sonidos que se estn reproduciendo actualmente, si no se especifican parmetros, o solamente el sonido especificado en el parmetro idNombre.
Vase tambin

Sound.start

412

_soundbuftime
Disponibilidad

Flash Player 4.
Sintaxis

_soundbuftime = entero
Parmetros

entero

Nmero de segundos antes de que empiece el flujo de la pelcula.

Descripcin

Propiedad (global); establece el nmero de segundos de sonido que va a almacenarse previamente en una memoria intermedia. El valor predeterminado es 5 segundos.

Stage (objeto)
El objeto Stage es un objeto de nivel superior al que puede acceder sin utilizar un constructor. Mediante los mtodos y las propiedades de este objeto podr acceder a informacin sobre los lmites de una pelcula Flash y manipularla. El objeto Stage est disponible en Flash Player 6 y versiones posteriores. Resumen de los mtodos del objeto Stage
Mtodo Stage.addListener Stage.removeListener Descripcin Agrega un objeto detector al objeto Stage. Elimina un objeto detector del objeto Stage.

Resumen de las propiedades del objeto Stage

Mtodo Stage.align Stage.height Stage.width Stage.scaleMode Descripcin Alineacin de la pelcula Flash en el navegador. Altura del escenario, en pxeles. Anchura del escenario, en pxeles. La escala actual de la pelcula Flash.

Resumen del controlador de eventos del objeto Stage

Mtodo Stage.onResize Descripcin Indica que se ha cambiado el tamao de la pelcula.

413

Stage.addListener
Disponibilidad

Flash Player 6.
Sintaxis

Stage.addListener(myListener)
Parmetros

myListener

Objeto que detecta una notificacin de callback del evento onResize.

Valor devuelto

Ninguno.
Descripcin

Mtodo; detecta cundo se cambia el tamao de una pelcula Flash si Stage.scaleMode = "noScale". El mtodo addListener no funciona con el valor predeterminado de escala de pelcula ("showAll") ni con otros valores de escala ("exactFit" y "noBorder"). Para utilizar addListener, primero debe crear un objeto detector. Un objeto detector es un objeto que recibe notificacin de un evento cuando ste se desencadena en una pelcula. Los objetos detectores del objeto Stage reciben notificacin de Stage.onResize.
Ejemplo

Este ejemplo crea un nuevo objeto detector denominado myListener. A continuacin, utiliza myListener para llamar al evento onResize y definir una funcin a la que se llamar cuando se desencadene el evento onResize. Finalmente, el cdigo agrega el objeto myListener a la lista de callbacks del objeto Stage. Los objetos detectores permiten que varios objetos detecten notificaciones de cambio de tamao.
myListener = new Object(); myListener.onResize = function () { ... } Stage.addListener(myListener);

414

Stage.align
Disponibilidad

Flash Player 6.
Sintaxis

Stage.align
Descripcin

Propiedad; indica la alineacin actual de la pelcula Flash dentro del escenario. La tabla siguiente muestra los valores de la propiedad align. Los valores que no aparecen en esta tabla centran la pelcula en el rea del escenario.
Valor "T" "B" "L" "R" "TL" "TR" "BL" "BR" Vertical superior inferior centro centro superior superior inferior inferior Horizontal centro centro izquierda derecha izquierda derecha izquierda derecha

Stage.height
Disponibilidad

Flash Player 6.
Sintaxis

Stage.height
Descripcin

Propiedad (slo lectura); indica la altura actual, en pxeles, del escenario de la pelcula Flash. Cuando la propiedad Stage.noScale tiene el valor true, height representa la altura de Flash Player. Cuando el valor de Stage.noScale es false (la escala de la pelcula cambia cuando se modifica el tamao de la ventana del reproductor), height representa la altura de la pelcula Flash.

Stage.onResize
Disponibilidad

Flash Player 6.
Sintaxis

Stage.onResize() = function() {...}

Parmetros

Ninguno.
Valor devuelto

Ninguno.

415

Descripcin

Mtodo callback; indica que se ha modificado el tamao de la pelcula Flash. Puede utilizar este evento para escribir una funcin que disponga los objetos en el escenario cuando se modifica el tamao de una pelcula.

Stage.removeListener
Disponibilidad

Flash Player 6.
Sintaxis

Stage.removeListener(myListener)
Parmetros

myListener

Objeto agregado a la lista de callbacks de un objeto con el mtodo addListener.

Valor devuelto

Ninguno.
Descripcin

Mtodo; elimina un objeto detector creado con addListener.

Vase tambin

Stage.addListener

Stage.scaleMode
Disponibilidad

Flash Player 6.
Sintaxis

Stage.scaleMode = "valor"
Descripcin

Propiedad; indica la escala actual de la pelcula Flash en el escenario. La propiedad scaleMode hace que se aplique un determinado modo de escala a la pelcula. De forma predeterminada, la pelcula 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". Con cualquier otro valor, la propiedad scaleMode se establece en el valor predeterminado "showAll".

416

Stage.width
Disponibilidad

Flash Player 6.
Sintaxis

Stage.width
Descripcin

Propiedad (slo lectura); indica la anchura actual, en pxeles, del escenario de la pelcula Flash. Cuando el valor de Stage.noScale es true, la propiedad width representa la anchura del reproductor. Cuando el valor de Stage.noScale es false (la escala de la pelcula cambia cuando se modifica el tamao de la ventana del reproductor), width representa la anchura de la pelcula Flash.

startDrag
Disponibilidad

Flash Player 4.
Sintaxis

startDrag(destino,[bloquear ,izquierda , superior , derecha , inferior])

Parmetros

destino bloquear

Ruta de destino del clip de pelcula que desea arrastrar.

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 en el que el usuario hizo clic por primera vez en el clip de pelcula (false). Este parmetro es opcional. Valores relativos a las coordenadas del elemento principal del clip de pelcula que especifican un rectngulo de limitacin para el clip de pelcula. Estos parmetros son opcionales.

izquierda, superior, derecha, inferior

Valor devuelto

Ninguno.
Descripcin

Accin; hace que el clip de pelcula de destino se pueda arrastrar mientras se reproduce la pelcula. Slo un clip de pelcula puede arrastrarse al mismo tiempo. Una vez que se ha ejecutado una operacin startDrag, el clip de pelcula se puede seguir arrastrando hasta que se detiene especficamente mediante una accin stopDrag, o hasta que se llame a una accin startDrag de otro clip de pelcula.
Ejemplo

Para crear un clip de pelcula que los usuarios puedan colocar en cualquier ubicacin, asocie las acciones startDrag y stopDrag a un botn dentro del clip de pelcula.
on(press) { startDrag (this, true); } on(release) { stopDrag(); }
Vase tambin

MovieClip._droptarget, stopDrag

417

stop
Disponibilidad

Flash 2.
Sintaxis

stop
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Accin; detiene el clip de pelcula que se est reproduciendo actualmente. La utilizacin ms corriente de esta accin es para controlar los clips de pelcula con botones.

stopAllSounds
Disponibilidad

Flash Player 3.
Sintaxis

stopAllSounds()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Accin; detiene todos los sonidos que se estn reproduciendo actualmente sin detener la cabeza lectora. Los sonidos establecidos en flujo reanudarn la reproduccin cuando la cabeza lectora se mueva sobre los fotogramas en los que se encuentran.
Ejemplo

El cdigo siguiente podra aplicarse a un botn que, cuando se hace clic sobre l, detiene todos los sonidos de la pelcula.
on(release) { stopAllSounds(); }
Vase tambin

Sound (objeto)

418

stopDrag
Disponibilidad

Flash Player 4.
Sintaxis

stopDrag()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Accin; detiene la operacin de arrastre actual.

Ejemplo

Esta sentencia detiene la accin de arrastre de la instancia mc cuando el usuario suelta el botn del ratn.
on(press) { startDrag("mc"); } on(release) { stopdrag(); }
Vase tambin

MovieClip.stopDrag, MovieClip._droptarget, startDrag,

String (funcin)
Disponibilidad

Flash Player 4.
Sintaxis

String(expresin)
Parmetros

expresin

Expresin que debe convertirse en una cadena.

Valor devuelto

Ninguno.
Descripcin

Funcin; devuelve una representacin de cadena del parmetro especificado como se muestra a continuacin: Si expresin es un valor booleano, la cadena devuelta es true o false. Si expresin es un nmero, la cadena devuelta es una representacin textual del nmero. Si expresin es una cadena, la cadena devuelta es expresin.

419

Si expresin es un objeto, el valor devuelto es una representacin de cadena del objeto generada por la llamada a la propiedad string del objeto o por la llamada a Object.toString, si no existe dicha propiedad. Si expresin es un clip de pelcula, el valor devuelto es la ruta de destino del clip de pelcula en notacin con barras (/). Si el valor expresin es undefined, el valor devuelto es una cadena vaca ("").
Vase tambin

Number.toString, Object.toString,

String (objeto), " " (delimitador de cadena)

" " (delimitador de cadena)

Disponibilidad

Flash Player 4.
Sintaxis

"texto"
Parmetros

texto

Un carcter.

Valor devuelto

Ninguno.
Descripcin

Delimitador de cadena; cuando se utilizan delante y detrs de caracteres, las comillas indican que los caracteres tienen un valor literal y se consideran una cadena, no una variable, valor numrico ni ningn otro elemento de ActionScript.
Ejemplo

En este ejemplo se utilizan comillas para indicar que el valor de la variable yourGuess es la cadena literal string Isla Prncipe Eduardo y no el nombre de una variable. El valor de province es una variable, no un literal; para determinar el valor de province, debe localizarse el valor de yourGuess.
yourGuess = "Isla Prncipe Eduardo"; on(release){ province = yourGuess trace(province); } // muestra Isla Prncipe Eduardo en la ventana Salida
Vase tambin

String (objeto), String (funcin)

420

String (objeto)
El objeto String es un envolvente para el tipo de datos primitivo de cadena, que permite utilizar los mtodos y las propiedades del objeto String para manipular tipos de datos primitivos de una cadena. Puede convertir el valor de cualquier objeto en una cadena mediante la funcin String(). En Flash MX, el objeto String se ha convertido en un objeto nativo. Debido a ello, experimentar una gran mejora en el rendimiento. Todos los mtodos del objeto String, excepto concat, fromCharCode, slice y substr, son genricos. Esto quiere decir que los propios mtodos llaman a this.toString antes de realizar sus operaciones; puede utilizar estos mtodos con otros objetos que no sean String. Puesto que todos los ndices de cadena tienen base cero, el ndice del ltimo carcter de cualquier cadena x es el siguiente:
x.length - 1

Puede llamar a cualquiera de los mtodos del objeto String utilizando el mtodo constructor newString o un 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 despus descarta el objeto String temporal. Puede utilizar la propiedad String.length con un literal de cadena. Es importante que no confunda un literal de cadena con una instancia del objeto String. En el ejemplo siguiente, la primera lnea de cdigo crea el literal de cadena s1 y la segunda lnea de cdigo crea una instancia s2 del objeto String.
s1 = "foo" s2 = new String("foo")

Utilice literales de cadena a menos que necesite utilizar especficamente un objeto String. Resumen de mtodos del objeto String
Mtodo String.charAt String.charCodeAt String.concat Descripcin Devuelve el carcter que se encuentra en una ubicacin especfica de una cadena. Devuelve el valor del carcter en el ndice dado como un nmero entero de 16 bits entre 0 y 65535. Combina el texto de dos cadenas y devuelve una nueva cadena.

String.fromCharCode Devuelve una cadena formada por los caracteres especificados en los parmetros. String.indexOf Busca la cadena y devuelve el ndice de la subcadena especificada en los parmetros. Si un valor aparece ms de una vez, se devuelve el ndice de la primera ocurrencia. Si no se encuentra valor, se devuelve 1. Devuelve el ndice de la ltima subcadena de la cadena que aparece antes de la posicin de inicio especificada en el parmetro, o 1 si no se encuentra. Extrae una seccin de una cadena y devuelve una nueva cadena. Divide un objeto String en una matriz de cadenas dividiendo las cadenas en subcadenas. Devuelve un nmero especificado de caracteres en una cadena comenzando en la ubicacin especificada en el parmetro. Devuelve los caracteres entre dos ndices, especificados en los parmetros como una cadena.

String.lastIndexOf String.slice String.split String.substr String.substring

421

Mtodo String.toLowerCase String.toUpperCase

Descripcin Convierte la cadena a minsculas y devuelve el resultado; no cambia el contenido del objeto original. Convierte la cadena a maysculas y devuelve el resultado; no cambia el contenido del objeto original.

Resumen de las propiedades del objeto String

Propiedad String.length Descripcin Devuelve la longitud de la cadena.

Constructor del objeto String.

Disponibilidad

Flash Player 5.
Sintaxis

new String(valor)
Parmetros

valor

Valor inicial del nuevo objeto String.

Valor devuelto

Ninguno.
Descripcin

Constructor; crea un nuevo objeto String.

Vase tambin

String (funcin), " " (delimitador de cadena)

String.charAt
Disponibilidad

Flash Player 5.
Sintaxis

myString.charAt(ndice)
Parmetros

ndice

Nmero del carcter en la cadena que se va a devolver.

Valor devuelto

Ninguno.
Descripcin

Mtodo; devuelve el carcter que se encuentra en la posicin especificada por el ndice del parmetro. El ndice del primer carcter de una cadena es 0. Si ndice no es un nmero entre 0 y string.length - 1, se devuelve una cadena vaca.

422

String.charCodeAt
Disponibilidad

Flash Player 5.
Sintaxis

myString.charCodeAt(ndice)
Parmetros

ndice Nmero entero que especifica la posicin de un carcter en la cadena. El primer carcter se indica con 0, y el ltimo, con myString.length-1.
Valor devuelto

Ninguno.
Descripcin

Mtodo; devuelve un entero de 16 bits entre 0 y 65535 que representa el carcter especificado por ndice. Este mtodo es parecido al mtodo string.charAt, pero el valor devuelto en este caso es un cdigo de carcter entero de 16 bits, no un carcter.
Ejemplo

En el ejemplo siguiente, se llama al mtodo charCodeAt en la primera letra de la cadena Carlos.

s = new String(Carlos); i = s.charCodeAt(0); // i = 67

String.concat
Disponibilidad

Flash Player 5.
Sintaxis

myString.concat(valor1,...valorN)
Parmetros

valor1,...valorN
Valor devuelto

Cero o ms valores que deben concatenarse.

Ninguno.
Descripcin

Mtodo; combina el valor del objeto String con los parmetros y devuelve la cadena nueva; el valor original, myString, se mantiene inalterado.

423

String.fromCharCode
Disponibilidad

Flash Player 5.
Sintaxis

String.fromCharCode(c1,c2,...cN)
Parmetros

c1,c2,...cN
Valor devuelto

Enteros decimales que representan valores ASCII.

Ninguno.
Descripcin

Mtodo; devuelve una cadena formada por los caracteres representados por los valores ASCII de los parmetros.
Ejemplo

En este ejemplo se utiliza el mtodo fromCharCode para insertar un carcter @ en la direccin de correo electrnico.
address = "perro" + String.fromCharCode(64) + "casa.net"; trace(address); // salida: perro@casa.net

String.indexOf
Disponibilidad

Flash Player 5.
Sintaxis

myString.indexOf(subcadena, [iniciondice])
Parmetros

subcadena myString.

Nmero entero o cadena que especifica la subcadena que se debe buscar dentro de

iniciondice Nmero entero que especifica el punto de myString en el que debe iniciarse la bsqueda de la subcadena. Este parmetro es opcional.
Valor devuelto

Ninguno.
Descripcin

Mtodo; busca en la cadena y devuelve la posicin de la primera aparicin de la subcadena especificada. Si no se encuentra el valor, el mtodo devuelve -1.

424

String.lastIndexOf
Disponibilidad

Flash Player 5.
Sintaxis

myString.lastIndexOf(subcadena, [iniciondice])
Parmetros

subcadena

Nmero entero o cadena que especifica la cadena en la que se va a buscar. Nmero entero que especifica el punto en el que debe iniciarse la bsqueda de la parmetro es opcional.

iniciondice subcadena. Este

Valor devuelto

Ninguno.
Descripcin

Mtodo; busca en la cadena de derecha a izquierda y devuelve el ndice de la ltima aparicin de la subcadena que se encuentra antes de iniciondice dentro de la cadena de llamada. Si no se encuentra ninguna subcadena, el mtodo devuelve -1.

String.length
Disponibilidad

Flash Player 5.
Sintaxis

string.length
Parmetros

Ninguno.
Descripcin

Propiedad; devuelve el nmero de caracteres del objeto String especificado.

String.slice
Disponibilidad

Flash Player 5.
Sintaxis

myString.slice(inicio, [final])
Parmetros

inicio

Nmero que especifica el ndice del punto de inicio de la seccin. Si inicio es un nmero negativo, el punto de inicio se determina desde el final de la cadena, donde -1 es el ltimo carcter.

final Nmero que especifica el ndice del punto final de la seccin. Si no se especifica el final, la seccin incluye todos los caracteres del inicio al final de la cadena. Si final es un nmero negativo, el punto final se determina desde el final de la cadena, donde -1 es el ltimo carcter.
Valor devuelto

Ninguno.

425

Descripcin

Mtodo; extrae una seccin o subcadena del objeto String especificado y despus la devuelve como una nueva cadena sin modificar el objeto String original. La cadena devuelta incluye el carcter inicial y todos los caracteres hasta el carcter final, pero sin incluirlo.
Ejemplo

En el ejemplo siguiente se define una variable, text, se crea una instancia del objeto String, s, y se le pasa la variable text. El mtodo slice extrae una seccin de la cadena que contiene la variable y la accin trace la enva a la ventana Salida.
text = "lexington"; s = new String( text ); trace(s.slice( 1, 3 )); trace(s);

En la ventana Salida se muestra ex. El cdigo siguiente produce el mismo resultado, pero el parmetro pasado a la funcin String es una cadena en lugar de una variable.
s = new String( "lexington" ); trace(s.slice( 1, 3 )); trace(s);

En la ventana Salida se muestra ex.

String.split
Disponibilidad

Flash Player 5.
Sintaxis

myString.split("delimitador", [lmite])
Parmetros

delimitador lmite

Carcter o cadena por donde se divide myString. Si el parmetro delimitador no est definido, toda la cadena se coloca en el primer elemento de la matriz. Nmero de elementos que deben colocarse en la matriz. Este parmetro es opcional.

Valor devuelto

Una matriz que contiene las subcadenas de myString.

Descripcin

Mtodo; divide un objeto String en subcadenas separndolo en el punto donde aparece el parmetro delimitador especificado y devuelve las subcadenas en una matriz. Si se utiliza una cadena vaca ("") como delimitador, cada carcter de la cadena se coloca como un elemento en la matriz, tal como se muestra en el cdigo siguiente.
myString = "Joe"; i = myString.split(""); trace (i);

La ventana Salida muestra lo siguiente:

J, O, E

Si el parmetro delimitador no est definido, toda la cadena se coloca en el primer elemento de la matriz devuelta.

426

Ejemplo

En el ejemplo siguiente se devuelve una matriz con cinco elementos.

myString = "P, A, T, S, Y"; myString.split(",");

Este ejemplo devuelve una matriz con dos elementos.

myString.split(",", 2);

String.substr
Disponibilidad

Flash Player 5.
Sintaxis

myString.substr(inicio, [longitud])
Parmetros

inicio Nmero entero que indica la posicin del primer carcter de myString que debe utilizarse para crear la subcadena. Si inicio es un nmero negativo, el punto inicial se determina desde el final de la cadena, donde -1 es el ltimo carcter. longitud longitud,

Nmero de caracteres en la subcadena que se est creando. Si no se especifica la la subcadena incluye todos los caracteres desde el inicio hasta el final de la cadena.

Valor devuelto

Ninguno.
Descripcin

Mtodo; devuelve los caracteres de una cadena desde el ndice especificado en el parmetro inicio, hasta el nmero de caracteres especificados en el parmetro longitud. El mtodo substr no modifica la cadena especificada por myString, sino que devuelve una nueva cadena.

String.substring
Disponibilidad

Flash Player 5.
Sintaxis

myString.substring(desde, hasta)
Parmetros

desde Nmero entero que indica la posicin del primer carcter de myString utilizado para crear la subcadena. Los valores vlidos para desde van de 0 a string.length - 1. Si desde es un valor negativo, se utiliza 0.

Nmero entero que es 1+ el ndice del ltimo carcter de myString que debe extraerse. Los valores vlidos para hasta van de 1 a string.length. El carcter indexado por el parmetro hasta no se incluye en la cadena extrada. Si el parmetro se omite, se utiliza string.length. Si este parmetro es un valor negativo, se utiliza 0.
hasta
Valor devuelto

Ninguno.

427

Descripcin

Mtodo; devuelve una cadena formada por los caracteres situados entre los puntos especificados por los parmetros desde y hasta. Si no se especifica el parmetro hasta, el final de la subcadena es el final de la cadena. Si el valor de desde es igual al de hasta, el mtodo devuelve una cadena vaca. Si el valor de desde es mayor que el valor de hasta, los parmetros se intercambian automticamente antes de que la funcin se ejecute y el valor original permanece inalterado.

String.toLowerCase
Disponibilidad

Flash Player 5.
Sintaxis

myString.toLowerCase()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; devuelve una copia del objeto String, con todos los caracteres en maysculas convertidos en minsculas. El valor original permanece inalterado.

String.toUpperCase
Disponibilidad

Flash Player 5.
Sintaxis

myString.toUpperCase()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; devuelve una copia del objeto String, con todos los caracteres en minsculas convertidos en maysculas. El valor original permanece inalterado.

428

substring
Disponibilidad

Flash Player 4. Esta funcin se ha desestimado en favor de String.substr.

Sintaxis

substring("cadena", ndice, conteo)

Parmetros

cadena ndice conteo

Cadena a partir de la que se va a extraer la nueva cadena. Nmero del primer carcter que se va a extraer. Nmero de caracteres que se van a incluir en la cadena extrada, sin incluir el carcter de

ndice.
Valor devuelto

Ninguno.
Descripcin

Funcin de cadena; extrae parte de una cadena. Esta funcin tiene base 1, mientras que los mtodos del objeto String tienen base 0.
Vase tambin

String.substr

super
Disponibilidad

Flash Player 6.
Sintaxis

super.mtodo([arg1, ..., argN]) super([arg1, ..., argN])

Parmetros

mtodo

Mtodo que se invoca en la superclase.

arg1 Parmetros opcionales que se pasan a la versin de superclase del mtodo (sintaxis 1) o a la funcin constructor de la superclase (sintaxis 2).
Valor devuelto

Ambas formas invocan una funcin. La funcin puede devolver cualquier valor.
Descripcin

Operador: el primer estilo de sintaxis puede utilizarse dentro del cuerpo de un mtodo de objeto para invocar la versin de superclase de un mtodo y puede pasar parmetros (arg1 ... argN) de forma opcional al mtodo de superclase. Esto resulta til para crear mtodos de subclase que agregan un comportamiento adicional a los mtodos de superclase, pero tambin invocan los mtodos de superclase para realizar su comportamiento original. El segundo estilo de sintaxis puede utilizarse dentro del cuerpo de una funcin constructor para invocar la versin de superclase de la funcin constructor y, opcionalmente, puede pasarle parmetros. Esto resulta til para crear una subclase que realice una inicializacin adicional, pero que tambin invoque el constructor de superclase para llevar a cabo una inicializacin de superclase.

429

Ejemplo

En el ejemplo siguiente se crean dos clases, ParentClass y ChildClass, y se define un mtodo llamado method para cada clase. Cada definicin de mtodo tiene una accin trace que enva un mensaje a la ventana Salida. La penltima lnea de cdigo crea una instancia ChildClass y llama a su mtodo method:
function ParentClass() { } ParentClass.prototype.method = function () { trace("Implementacin del mtodo de ParentClass"); }; function ChildClass() { } ChildClass.prototype = new ParentClass(); ChildClass.prototype.method = function () { trace("Implementacin del mtodo de ChildClass"); super.method(); }; x = new ChildClass(); x.method();

La ventana Salida muestra lo siguiente:

Implementacin del mtodo de ChildClass Implementacin del mtodo de ParentClass

En el ejemplo siguiente se pasan parmetros al constructor de la superclase:

function SuperClass(arg){ trace("Se ha pasado " + arg + " al constructor de SuperClass."); } function SubClass(arg){ super(arg); trace("Constructor de SubClass"); }

switch
Disponibilidad

Flash Player 4.
Sintaxis

switch (expresin){ clusulaCase: [clusulaDefault:] }

Parmetros

expresin

Cualquier expresin.

clusulaCase Una palabra clave case seguida por una expresin, dos puntos y un grupo de sentencias que se deben ejecutar si la expresin coincide con el parmetro expresin de switch utilizando la igualdad estricta (===).

Una palabra clave default seguida de sentencias que se deben ejecutar si ninguna de las expresiones case coincide con el parmetro expresin de switch segn la igualdad estricta (===).
clusulaDefault
Valor devuelto

Ninguno.

430

Descripcin

Accin; crea una estructura ramificada para sentencias de ActionScript. Al igual que la accin if, la accin switch prueba una condicin que ejecuta sentencias si la condicin devuelve el valor true.
Ejemplo

En el ejemplo siguiente, si el parmetro number da como resultado 1, se ejecuta la accin trace que sigue a case 1; si el parmetro number da como resultado 2, se ejecuta la accin trace que sigue a case 2, y as sucesivamente. Si ninguna expresin case coincide con el parmetro number, se ejecuta la accin trace que sigue a la palabra clave default.
switch (number) { case 1: trace ("case 1 break; case 2: trace ("case 2 break; case 3: trace ("case 3 break; default: trace ("ningn } es verdadero"); es verdadero"); es verdadero"); case es verdadero");

En el ejemplo siguiente, no hay ninguna sentencia break en el grupo del primer caso, de modo que si el parmetro number es 1, tanto A como B se envan a la ventana Salida:
switch (number) { case 1: trace ("A"); case 2: trace ("B"); break; default trace ("D") }
Vase tambin

=== (igualdad estricta), break, case, default, if

System (objeto)
Se trata de un objeto de nivel superior que contiene el objeto Capabilities. Para utilizar el objeto Capabilities y sus propiedades, debe utilizar el objeto System. Por ejemplo, el cdigo siguiente comprueba si un sistema tiene capacidades de audio.
System.capabilites.hasAudio

431

System.capabilities (objeto)
Puede utilizar el objeto System.capabilites para determinar las capacidades del sistema y el reproductor que albergan una pelcula Flash. Esto le permite personalizar contenido para distintos formatos. Por ejemplo, la pantalla de un telfono mvil (en blanco y negro, de 100 pxeles cuadrados) es distinta a la pantalla de un PC en color de 1.000 pxeles cuadrados. Para proporcionar el contenido adecuado a todos los usuarios posibles, puede utilizar el objeto Capabilities para determinar el tipo de dispositivo que tiene un usuario. A continuacin, puede especificar al servidor que enve distintos archivos SWF segn las capacidades del dispositivo, o indicar a la pelcula Flash que modifique su presentacin en funcin de las capacidades del dispositivo. Puede enviar informacin sobre las capacidades utilizando un mtodo HTTP GET o POST. A continuacin se muestra un ejemplo de una cadena de servidor para un dispositivo no compatible con MP3 y con una pantalla de 400 x 200 pxeles (8 x 4 centmetros):
"A=t&MP3=f&AE=gsm&VE=h11&ACC=f&V=WIN%206%2C0%2C0%2C129&M=Macromedia%WINDOWS&R= 400x200&DP=72&COL=color&AR=1.0&OS=WINDOWS%2000&L=en-US"

El objeto Capabilities est disponible en Flash Player 6. Para acceder a cualquier propiedad del objeto Capabilities, debe hacerlo a travs del objeto System.capabilities. Resumen de las propiedades del objeto Capabilities
Propiedad System.capabilities.hasAudioEncoder System.capabilities.hasAccessibility System.capabilities.hasAudio System.capabilities.hasMP3 System.capabilities.language System.capabilities.manufacturer System.capabilities.os System.capabilities.pixelAspectRatio System.capabilities.screenColor System.capabilities.screenDPI Descripcin Indica los codificadores de audio compatibles. Indica si el dispositivo cumple los estndares de accesibilidad. Indica si el dispositivo tiene capacidades de audio. Indica si el dispositivo tiene un decodificador MP3. Indica el idioma de Flash Player. Indica el fabricante de Flash Player. Indica el sistema operativo que alberga Flash Player. Indica la relacin de aspecto de los pxeles de la pantalla. Indica si la pantalla es en color, en blanco y negro o en escala de grises. Indica los puntos por pulgada de la pantalla.

System.capabilities.screenResolution.x Indica la dimensin horizontal de la pantalla. System.capabilities.screenResolution.y Indica la dimensin vertical de la pantalla. System.capabilities.version System.capabilities.hasVideoEncoder Indica la versin mnima de Flash Player compatible. Indica los codificadores de video compatibles.

432

System.capabilities.hasAudioEncoder
Disponibilidad

Flash Player 6.
Sintaxis

System.capabilities.hasAudioEncoder
Descripcin

Propiedad; una matriz de decodificadores de audio. La cadena del servidor es AE.

System.capabilities.hasAccessibility
Disponibilidad

Flash Player 6.
Sintaxis

System.capabilities.hasAccessibility
Descripcin

Propiedad; un valor booleano que indica si el dispositivo es compatible o no con la comunicacin entre Flash Player y las ayudas de accesibilidad. El valor predeterminado es false. La cadena del servidor es ACC.

System.capabilities.hasAudio
Disponibilidad

Flash Player 6.
Sintaxis

System.capabilities.hasAudio
Descripcin

Propiedad; un valor booleano que indica si el reproductor tiene capacidades de audio o no. El valor predeterminado es true. La cadena del servidor es A.

System.capabilities.hasMP3
Disponibilidad

Flash Player 6.
Sintaxis

System.capabilities.hasMP3
Descripcin

Propiedad; un valor booleano que indica si el reproductor tiene un decodificador MP3 o no. El valor predeterminado es true. La cadena del servidor es MP3.

433

System.capabilities.language
Disponibilidad

Flash Player 6.
Sintaxis

System.capabilities.language
Descripcin

Propiedad; un cdigo de idioma formado por dos letras minsculas segn ISO 639-1 y una subetiqueta de cdigo de pas formada por dos letras maysculas segn ISO 3166. Los propios idiomas se denominan con las etiquetas. Por ejemplo, es es el idioma del documento que est leyendo. La cadena del servidor es LAN. Flash es compatible con el siguiente subconjunto de etiquetas de idiomas:
Idioma Ingls Francs Coreano Japons Sueco Alemn Espaol Italiano Chino simplificado Chino tradicional Portugus Polaco Hngaro Checo Turco Finlands Dans Noruego Holands Ruso Otro/desconocido Etiqueta en fr ko ja sv de es it zh zh pt pl hu cs tr fi da no nl ru xu China (chino simplificado) = CN Taiwn (chino tradicional) = TW Etiquetas y pases compatibles Estados Unidos = US, Reino Unido = UK

434

System.capabilities.manufacturer
Disponibilidad

Flash Player 6.
Sintaxis

System.capabilities.manufacturer
Descripcin

Propiedad; una cadena que indica el fabricante de Flash Player. El valor predeterminado es "Macromedia Nombre SO" (Nombre SO puede ser "Windows","Macintosh" o bien "Other OS Name"). La cadena del servidor es M.

System.capabilities.os
Disponibilidad

Flash Player 6.
Sintaxis

System.capabilities.os
Descripcin

Propiedad; una cadena que indica el fabricante de Flash Player. El valor predeterminado es una cadena vaca (""). La propiedad os puede devolver las cadenas siguientes: "Windows XP", "Windows 2000", "Windows NT", "Windows 98/ME", "Windows 95", "Windows CE" (disponible slo en kit de desarrollo de software, no en versin de escritorio) y "MacOS". La cadena del servidor es OS.

System.capabilities.pixelAspectRatio
Disponibilidad

Flash Player 6.
Sintaxis

System.capabilities.hasVideoEncoder
Descripcin

Propiedad; un entero que indica la relacin de aspecto de los pxeles de la pantalla. El valor predeterminado es 1.0. La cadena del servidor es PAR.

System.capabilities.screenColor
Disponibilidad

Flash Player 6.
Sintaxis

System.capabilities.screenColor
Descripcin

Propiedad; indica el color de la pantalla: en color (color), en escala de grises (gray) o en blanco y negro (bw). El valor predeterminado es color. La cadena del servidor es SC.

435

System.capabilities.screenDPI
Disponibilidad

Flash Player 6.
Sintaxis

System.capabilities.screenDPI
Descripcin

Propiedad; indica los puntos por pulgada (ppp) de la pantalla, en pxeles. El valor predeterminado es 72. La cadena del servidor es DPI.

System.capabilities.screenResolution.x
Disponibilidad

Flash Player 6.
Sintaxis

System.capabilities.screenResolution.x
Descripcin

Propiedad; un entero que indica la resolucin horizontal mxima de la pantalla. El valor predeterminado es 800 (pxeles). La cadena del servidor es SRX.

System.capabilities.screenResolution.y
Disponibilidad

Flash Player 6.
Sintaxis

System.capabilities.screenResolution.y
Descripcin

Propiedad; un entero que indica la resolucin vertical mxima de la pantalla. El valor predeterminado es 600 (pxeles). La cadena del servidor es SRY.

System.capabilities.version
Disponibilidad

Flash Player 6.
Sintaxis

System.capabilities.version
Descripcin

Propiedad; un entero que especifica la versin de Flash Player compatible. La versin predeterminada es 6.0. La cadena del servidor es VER.

436

System.capabilities.hasVideoEncoder
Disponibilidad

Flash Player 6.
Sintaxis

System.capabilities.hasVideoEncoder
Descripcin

Propiedad; una matriz de codificadores de video. La cadena del servidor es VE.

targetPath
Disponibilidad

Flash Player 5.
Sintaxis

targetpath(objetoClipPelcula)
Parmetros

objetoClipPelcula Referencia (por ejemplo, _root o _parent) al clip de pelcula del que se est recuperando la ruta de destino.
Valor devuelto

Ninguno.
Descripcin

Funcin; devuelve una cadena que contiene la ruta de destino de objetoClipPelcula. La ruta de destino se devuelve en notacin con puntos. Para recuperar la ruta de destino en notacin con barras, utilice la propiedad _target.
Ejemplo

Este ejemplo muestra la ruta de destino de un clip de pelcula en cuanto se carga.

onClipEvent(load){ trace(targetPath(this)); }
Vase tambin

eval

tellTarget
Disponibilidad

Flash Player 3. (Desestimada en Flash 5; se recomienda utilizar notacin con puntos y la accin with.)
Sintaxis

tellTarget("destino") { sentencia(s); }
Parmetros

destino

Cadena que especifica la ruta de destino de la lnea de tiempo que debe controlarse. Instrucciones que deben ejecutarse si la condicin tiene el valor true.

sentencia(s)

437

Valor devuelto

Ninguno.
Descripcin

Accin; aplica las instrucciones especificadas en el parmetro sentencias a la lnea de tiempo especificada en el parmetro destino. La accin tellTarget es til para controles de navegacin. Asigne tellTarget a botones que detienen o inician los clips de pelcula en otras partes del escenario. Tambin puede hacer que los clips de pelcula vayan a un fotograma concreto de dicho clip. Por ejemplo, podra asignar tellTarget a botones que detienen o inician los clips de pelcula en el escenario, o hacer que los clips de pelcula salten a un fotograma concreto. En Flash 5, puede utilizar notacin con puntos en lugar de la accin tellTarget. Puede utilizar la accin with para especificar varias acciones en la misma lnea de tiempo. Puede utilizar la accin with para especificar el destino de cualquier objeto, mientras que con la accin tellTarget slo puede especificar destinos de clips de pelculas.
Ejemplo

La sentencia tellTarget controla la instancia de clip de pelcula ball en la lnea de tiempo principal. El fotograma 1 de la instancia ball est vaco y tiene una accin stop, de modo que es invisible en el escenario. Al hacer clic en el botn de la accin siguiente, tellTarget indica a la cabeza lectora de ball que vaya al fotograma 2, en el que empieza la animacin.
on(release) { tellTarget("ball") { gotoAndPlay(2); } }

En el ejemplo siguiente se utiliza la notacin con puntos para obtener el mismo resultado.
on(release) { ball.gotoAndPlay(2); }

Si necesita especificar varios comandos en la instancia ball, puede utilizar la accin with, tal como se muestra a continuacin.
on(release) { with(ball) { gotoAndPlay(2); _alpha = 15; _xscale = 50; _yscale = 50; } }
Vase tambin

with

438

TextField (objeto)
Todos los campos de texto dinmico y de introduccin de texto de una pelcula Flash son instancias del objeto TextField. Puede asignar un nombre de instancia a un campo de texto en el inspector de propiedades y utilizar los mtodos y las propiedades del objeto TextField para manipularlo con ActionScript. Los nombres de instancia del objeto TextField se muestran en el Explorador de pelculas y en el cuadro de dilogo Insertar ruta de destino del panel Acciones. El objeto TextField es descendiente del objeto Object. Para crear un campo de texto de forma dinmica, puede utilizar el mtodo MovieClip.createTextField. El objeto TextField se admite en Flash Player 6 y en versiones posteriores de Flash Player. Resumen de los mtodos del objeto TextField
Mtodo TextField.addListener TextField.getDepth TextField.getNewTextFormat TextField.removeListener TextField.removeTextField TextField.setNewTextFormat TextField.replaceSel TextField.setTextFormat Descripcin Registra un objeto para que reciba una notificacin cuando se invoquen los eventos onChanged y onScroller. Devuelve la profundidad de un campo de texto. Obtiene el formato de texto predeterminado asignado al texto que se acaba de insertar. Elimina un objeto detector. Elimina un campo de texto creado con el mtodo MovieClip.createTextField. Establece un objeto de formato de texto para el texto insertado por un usuario o por un mtodo. Reemplaza la seleccin actual. Establece el formato de texto predeterminado asignado al texto que se acaba de insertar.

Resumen de las propiedades del objeto TextField

Propiedad TextField._alpha TextField.autoSize TextField.background TextField.backgroundColor TextField.border TextField.borderColor TextField.bottomScroll TextField.embedFonts TextField._highquality Descripcin Valor de transparencia de una instancia de campo de texto. Controla la alineacin automtica y la modificacin del tamao de un campo de texto. Indica si el campo de texto tiene un relleno de fondo. Indica el color del relleno de fondo. Indica si el campo de texto tiene un borde. Indica el color del borde. Lnea visible situada ms abajo en un campo de texto. Indica si el campo de texto utiliza contornos de fuentes incorporadas o fuentes de dispositivo. Indica la calidad de representacin de la pelcula.

439

Propiedad TextField._height

Descripcin Altura de una instancia de campo de texto en pxeles. Slo afecta al recuadro de delimitacin del campo de texto, no al grosor del borde ni al tamao de fuente del texto. Indica el valor de desplazamiento horizontal de un campo de texto. Indica la posicin de desplazamiento mxima de un campo de texto. Contiene la representacin HTML del contenido de un campo de texto. Nmero de caracteres de un campo de texto. Nmero mximo de caracteres que puede contener un campo de texto. Valor mximo de TextField.hscroll. Valor mximo de TextField.scroll. Indica si el campo de texto contiene varias lneas. Nombre de instancia de una instancia de campo de texto. Referencia a la instancia principal de esta instancia; ya sea de tipo Button o MovieClip. Indica si un campo de texto debe ocultar los caracteres introducidos. Indica la calidad de representacin de la pelcula. Conjunto de caracteres que puede introducir un usuario en un campo de texto. Grado de rotacin de una instancia de campo de texto. Indica la posicin de desplazamiento actual de un campo de texto. Indica si un campo de texto se puede seleccionar. Tiempo durante el cual un sonido debe almacenarse previamente en una memoria intermedia antes de empezar a fluir. Indica si se incluye un clip de pelcula en el orden de tabulacin automtico. Indica el orden de tabulacin de un objeto. Texto actual del campo de texto. Color del texto en el campo de texto. Altura del recuadro de delimitacin del campo de texto. Anchura del recuadro de delimitacin del campo de texto. Indica si un campo de texto es un campo de introduccin de texto o un campo de texto dinmico. URL del archivo SWF que ha creado la instancia de campo de texto. Nombre de variable asociado con el campo de texto. Valor booleano que determina si una instancia de campo de texto est oculta o visible. Anchura de una instancia de campo de texto en pxeles. Slo afecta al recuadro de delimitacin del campo de texto, no al grosor del borde ni al tamao de fuente del texto. Indica si el texto de un campo de texto se ajusta. Coordenada x de una instancia de campo de texto.

TextField.hscroll TextField.html TextField.htmlText TextField.length TextField.maxChars TextField.maxhscroll TextField.maxscroll TextField.multiline TextField._name TextField._parent TextField.password TextField._quality TextField.restrict TextField._rotation TextField.scroll TextField.selectable TextField._soundbuftime TextField.tabEnabled TextField.tabIndex TextField.text TextField.textColor TextField.textHeight TextField.textWidth TextField.type TextField._url TextField.variable TextField._visible TextField._width

TextField.wordWrap TextField._x

440

Propiedad TextField._xmouse TextField._xscale TextField._y TextField._ymouse TextField._yscale

Descripcin Coordenada x del cursor con relacin a una instancia de campo de texto. Valor que especifica el porcentaje de escala horizontal que se aplicar a una instancia de campo de texto. Coordenada y de una instancia de campo de texto. Coordenada y del cursor con relacin a una instancia de campo de texto. Valor que especifica el porcentaje de escala vertical que se aplicar a una instancia de campo de texto.

Resumen del controlador de eventos del objeto TextField

Mtodo TextField.onChanged TextField.onKillFocus TextField.onScroller TextField.onSetFocus Descripcin Se invoca cuando se cambia el campo de texto. Se invoca cuando el campo de texto deja de estar seleccionado. Se invoca cuando cambia la propiedad scroll, maxscroll, hscroll, maxhscroll o bottomscroll de un campo de texto. Se invoca cuando el campo de texto pasa a estar seleccionado.

Resumen de los detectores del objeto TextField

Mtodo TextField.onChanged TextField.onScroller Descripcin Se notifica cuando cambia el campo de texto. Se notifica cuando cambia la propiedad scroll o maxscroll de un campo de texto.

TextField._alpha
Disponibilidad

Flash Player 6.
Sintaxis

TextField._alpha
Descripcin

Propiedad; establece o recupera la transparencia alfa (valor) del campo de texto especificado por TextField. Los valores vlidos van de 0 (completamente transparente) a 100 (completamente opaco).
Ejemplo

Las sentencias siguientes establecen la propiedad _alpha de un campo de texto denominado text1 al 30%.
on(release) { text1._alpha = 30; }

441

TextField.addListener
Disponibilidad

Flash Player 6.
Sintaxis

TextField.addListener(nuevoDetector)
Parmetros

nuevoDetector
Valor devuelto

Objeto con las notificaciones de los eventos onChanged y onScroller.

Ninguno.
Descripcin

Mtodo; registra un objeto para que reciba notificaciones de eventos. Cuando se produce el evento onChanged o onScroller, se invocan los eventos TextField.onChanged y TextField.onScroller, seguidos de los mtodos onChanged y onScroller de los objetos de deteccin registrados con addListener. Varios objetos pueden detectar notificaciones de cambio. Si el detector nuevoDetector ya est registrado, no se produce ningn cambio.

TextField.autoSize
Disponibilidad

Flash Player 6.
Sintaxis

TextField.autoSize
Descripcin

Propiedad; controla la alineacin y el cambio de tamao automticos de los campos de texto. Si el valor de autosize es "none", el campo de texto se comporta con normalidad y no se alinea ni cambia de tamao de forma automtica para ajustarse al texto. Si el valor es "left", el campo de texto se expande o se contrae por sus lados izquierdo e inferior para que quepa todo el texto que contiene. Los lados izquierdo y superior no cambian. Si el valor de autosize es "center", el tamao del texto cambia automticamente, pero el centro horizontal del campo de texto permanece anclado en la posicin central horizontal que el campo de texto tena originalmente. El lado inferior se mueve para que quepa todo el texto. Si el valor de autosize es "right", el tamao del texto cambia automticamente, pero los lados que se expanden o se contraen son el izquierdo y el inferior. Los lados superior y derecho permanecen en las mismas posiciones. Cuando se establece la propiedad autoSize, true es un sinnimo de "left" y false es un sinnimo de "none".
Ejemplo

El texto siguiente establece la propiedad autosize del campo de texto textField2 en "center".
textField2.autosize = "center";

442

TextField.background
Disponibilidad

Flash Player 6.
Sintaxis

TextField.background
Descripcin

Propiedad; si su valor es true, el campo de texto tiene un relleno de fondo. Si su valor es false, el campo de texto no tiene relleno de fondo.

TextField.backgroundColor
Disponibilidad

Flash Player 6.
Sintaxis

TextField.backgroundColor
Descripcin

Propiedad; color del fondo del campo de texto. El valor predeterminado es 0xFFFFFF (blanco). Esta propiedad puede recuperarse o establecerse, incluso si no hay ningn color de fondo y el color slo es visible si el campo de texto tiene un borde.
Vase tambin

TextField.background

TextField.border
Disponibilidad

Flash Player 6.
Sintaxis

TextField.border
Descripcin

Propiedad; si su valor es true, el campo de texto tiene un borde. Si su valor es false, el campo de texto no tiene borde.

TextField.borderColor
Disponibilidad

Flash Player 6.
Sintaxis

TextField.borderColor
Descripcin

Propiedad; color del borde del campo de texto; el valor predeterminado es 0x000000 (negro). Esta propiedad se puede recuperar o establecer, incluso si no hay ningn borde.
Vase tambin

TextField.border

443

TextField.bottomScroll
Disponibilidad

Flash Player 6.
Sintaxis

TextField.bottomScroll
Descripcin

Propiedad (slo lectura); nmero entero (ndice con base 1) que indica la lnea situada ms abajo visible en TextField. Imagine que el campo de texto es como una ventana en un bloque de texto. La propiedad Textfield.scroll es el ndice con base 1 de la lnea visible situada ms arriba en la ventana. Todo el texto entre las lneas TextField.scroll y TextField.bottomScroll se ve en el campo de texto.

TextField.embedFonts
Disponibilidad

Flash Player 6.
Sintaxis

TextField.embedFonts
Descripcin

Propiedad; valor booleano que, cuando es true, genera el campo de texto utilizando contornos de fuentes incorporadas. Si es false, genera el campo de texto utilizando fuentes de dispositivo.

TextField._focusrect
Disponibilidad

Flash Player 6.
Sintaxis

TextField._focusrect
Descripcin

Propiedad; valor booleano que especifica si un campo de texto est rodeado por un rectngulo amarillo cuando est seleccionado.

444

TextField.getDepth
Disponibilidad

Flash Player 6.
Sintaxis

TextField.getDepth
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.
Descripcin

Mtodo; devuelve la profundidad de un campo de texto.

TextField.getFontList
Disponibilidad

Flash Player 6.
Sintaxis

TextField.getFontList
Parmetros

Ninguno.
Valor devuelto

Una matriz.
Descripcin

Mtodo; devuelve un objeto Array cuyos elementos son los nombres de todas las fuentes del sistema host de Flash Player, incluidas las fuentes del archivo SWF y todos los archivos SWF de elementos cargados. Los nombres son de tipo cadena.

TextField.getNewTextFormat
Disponibilidad

Flash Player 6.
Sintaxis

TextField.getNewTextFormat()
Parmetros

Ninguno.
Valor devuelto

Un objeto TextFormat.
Descripcin

Mtodo; 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, por ejemplo, con el mtodo replaceSel o por un usuario. Cuando se invoca getNewTextFormat, el objeto TextFormat devuelto tiene todas sus propiedades definidas. Ninguna propiedad tiene el valor null.

445

TextField.getTextFormat
Disponibilidad

Flash Player 6.
Sintaxis

TextField.getTextFormat() TextField.getTextFormat (ndice) TextField.getTextFormat (iniciarndice, terminarndice)

Parmetros

ndice

Nmero entero que especifica un carcter de una cadena.

Valor devuelto

Un objeto.
Descripcin

Mtodo; (sintaxis 1) devuelve un objeto TextFormat que contiene informacin sobre el formato de todo el texto de un campo de texto. En el objeto TextFormat, slo se establecen las propiedades comunes a todo el texto del campo de texto. El valor de las propiedades mezcladas, aquellas que tienen distintos valores en diferentes puntos del texto, se establece en null. Sintaxis 2: devuelve un objeto TextFormat que contiene un copia del formato de texto del parmetro ndice del campo de texto. Sintaxis 3: devuelve un objeto TextFormat que contiene informacin sobre el formato del espacio del texto desde iniciarndice hasta terminarndice.
Vase tambin

TextField.getNewTextFormat, TextField.setNewTextFormat, TextField.setTextFormat

TextField._height
Disponibilidad

Flash Player 6.
Sintaxis

TextField._height
Descripcin

Propiedad; establece y recupera la altura del campo de texto, en pxeles.

Ejemplo

El ejemplo de cdigo siguiente establece la altura y la anchura de un campo de texto.

myTextField._width = 200; myTextField._height = 200;

446

TextField._highquality
Disponibilidad

Flash Player 6.
Sintaxis

TextField._highquality
Descripcin

Propiedad (global); especifica el nivel de suavizado aplicado a la pelcula actual. Especifique 2 (BEST) para aplicar alta calidad con el suavizado de mapa de bits siempre activado. Especifique 1 (alta calidad) para aplicar suavizado; esto suavizar los mapas de bits si la pelcula no contiene animacin. Especifique 0 (baja calidad) para evitar el suavizado.
Ejemplo

_highquality = 1;
Vase tambin

_quality, toggleHighQuality

TextField.hscroll
Disponibilidad

Flash Player 6.
Sintaxis

TextField.hscroll
Valor devuelto

Un nmero entero.
Descripcin

Propiedad; indica la posicin actual de desplazamiento horizontal. Si la propiedad hscroll es 0, el texto no se desplaza horizontalmente.
Ejemplo

En el ejemplo siguiente se desplaza el texto horizontalmente.

on (release) { myTextField.hscroll += 1; }
Vase tambin

TextField.maxhscroll, TextField.scroll

447

TextField.html
Disponibilidad

Flash Player 6.
Sintaxis

TextField.html
Descripcin

Propiedad; etiqueta que indica 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 un campo de texto HTML.
Vase tambin

TextField.htmlText

TextField.htmlText
Disponibilidad

Flash Player 6.
Sintaxis

TextField.htmlText
Descripcin

Propiedad; 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 HTML, se comporta exactamente igual que la propiedad text. Puede indicar que un campo de texto es un campo de texto HTML en el inspector de propiedades, o bien estableciendo la propiedad html del campo de texto en true.
Ejemplo

En el ejemplo siguiente, el texto del campo de texto text2 aparece en negrita.

text2.html = true; text2.htmlText = "<b> texto en negrita </b>";

TextField.length
Disponibilidad

Flash Player 6.
Sintaxis

TextField.length
Descripcin

Propiedad (slo lectura); indica el nmero de caracteres de un campo de texto. Esta propiedad devuelve el mismo valor que text.length, pero es ms rpida. El carcter de tabulacin (\t) se cuenta como un carcter.

448

TextField.maxChars
Disponibilidad

Flash Player 6.
Sintaxis

TextField.maxChars
Descripcin

Propiedad; indica el nmero mximo de caracteres que puede contener el campo de texto. Un script puede insertar ms texto del que permite maxChars; la propiedad maxChars slo indica cunto texto puede introducir un usuario. Si el valor de esta propiedad es null, no hay lmite en cuanto a la cantidad de texto que puede introducir un usuario.

TextField.maxhscroll
Disponibilidad

Flash Player 6.
Sintaxis

TextField.maxhscroll
Descripcin

Propiedad (slo lectura); indica el valor mximo de TextField.hscroll.

Vase tambin

TextField.hscroll

TextField.maxscroll
Disponibilidad

Flash Player 6.
Sintaxis

TextField.maxscroll
Descripcin

Propiedad (slo lectura); indica el valor mximo de TextField.scroll.

Vase tambin

TextField.scroll

TextField.multiline
Disponibilidad

Flash Player 6.
Sintaxis

TextField.multiline
Descripcin

Propiedad; indica si el campo de texto contiene varias lneas. Si el valor es true, el campo de texto tiene varias lneas; si el valor es false, el campo de texto slo tiene una lnea.

449

TextField._name
Disponibilidad

Flash Player 6.
Sintaxis

TextField._name
Descripcin

Propiedad; devuelve el nombre de instancia del campo de texto especificado por TextField.

TextField.onChanged
Disponibilidad

Flash Player 6.
Sintaxis

TextField.onChanged
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando cambia el contenido de un campo de texto. De forma predeterminada, no est definido; puede definirlo en un script.

TextField.onKillFocus
Disponibilidad

Flash Player 6.
Sintaxis

TextField.onKillFocus = function (nuevaSeleccin) { sentencias; };

Parmetros

nuevaSeleccin
Valor devuelto

El objeto que pasar a estar seleccionado.

Ninguno.
Descripcin

Controlador de eventos; un evento que se invoca cuando un campo de texto ya no se selecciona con el teclado. El mtodo onKillFocus recibe un parmetro, nuevaSeleccin, que es un objeto que representa el nuevo objeto seleccionado. Si no hay ningn objeto seleccionado, nuevaSeleccin contiene el valor null.

450

TextField.onScroller
Disponibilidad

Flash Player 6.
Sintaxis

TextField.onScroller
Descripcin

Controlador de eventos; un evento que se invoca cuando cambia una de las propiedades de desplazamiento del campo de texto.
Vase tambin

TextField.hscroll, TextField.maxhscroll, TextField.maxscroll, TextField.scroll

TextField.onSetFocus
Disponibilidad

Flash Player 6.
Sintaxis

TextField.onSetFocus = function(seleccinAnterior){ sentencias; };

Parmetros

seleccinAnterior
Valor devuelto

El objeto que dejar de estar seleccionado.

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando un campo de texto se selecciona mediante el teclado. El parmetro seleccinAnterior es el objeto que deja de estar seleccionado. Por ejemplo, si el usuario presiona el tabulador para mover la seleccin de entrada de un botn a un campo de texto, seleccinAnterior contiene la instancia de campo de texto. Si no hay ningn objeto seleccionado anteriormente, seleccinAnterior contiene un valor null.

TextField._parent
Disponibilidad

Flash Player 6.
Sintaxis

_parent.property _parent._parent.property
Descripcin

Propiedad; especifica o devuelve una referencia al clip de pelcula que contiene el objeto o el clip de pelcula. El objeto actual es el objeto que contiene el cdigo de ActionScript que hace referencia a _parent. Utilice _parent para especificar una ruta relativa a los clips de pelcula u objetos que estn por encima del clip de pelcula u objeto actual.
Vase tambin

_root, targetPath

451

TextField.password
Disponibilidad

Flash Player 6.
Sintaxis

TextField.password
Descripcin

Propiedad; si el valor de password es true, el campo de texto es un campo de texto de contrasea y oculta los caracteres de entrada. Si su valor es false, el campo de texto no es de contrasea.

TextField._quality
Disponibilidad

Flash Player 6.
Sintaxis

TextField._quality
Descripcin

Propiedad (global); establece o recupera la calidad de representacin utilizada para una pelcula. Las fuentes de dispositivo siempre son dentadas, de modo que no se ven afectadas por la propiedad _quality. La propiedad _quality puede definirse en los valores siguientes:

"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 con una cuadrcula de 2x2, en pxeles, pero los mapas de bits no se suavizan. Apropiado para pelculas que no contienen texto. Calidad de representacin alta. Los grficos se suavizan con una cuadrcula de 4x4, en pxeles, y los mapas de bits se suavizan si la pelcula es esttica. Esta es la configuracin de la calidad de representacin predeterminada utilizada por Flash.

"HIGH"

"BEST"

Calidad de representacin muy alta. Los grficos se suavizan con una cuadrcula de 4x4, en pxeles, y los mapas de bits se suavizan siempre.

Ejemplo

En el ejemplo siguiente, se define la calidad de representacin en LOW:

textfield._quality = "LOW";
Vase tambin

_highquality, toggleHighQuality

452

TextField.removeListener
Disponibilidad

Flash Player 6.
Sintaxis

Selection.removeListener(detector)
Parmetros

detector

Objeto que ya no recibir notificaciones sobre el elemento seleccionado.

Valor devuelto

Si el detector se ha eliminado correctamente, el mtodo devuelve un valor true. Si el detector no se ha eliminado correctamente (por ejemplo, si el detector no se encontraba en la lista de detectores del objeto TextField), el mtodo devuelve el valor false.
Descripcin

Mtodo; elimina un objeto detector previamente registrado en una instancia de campo de texto con addListener.

TextField.removeTextField
Disponibilidad

Flash Player 6.
Sintaxis

TextField.removeTextField()
Descripcin

Mtodo; elimina el campo de texto especificado por TextField. Esta operacin slo se puede realizar en un campo de texto creado con el mtodo createTextField del objeto MovieClip. No funcionar en campos de texto colocados por la lnea de tiempo. Cuando se llama a este mtodo, el campo de texto recibe la orden de eliminarse a s mismo. Es parecido al mtodo MovieClip.removeMovieClip.
Vase tambin

MovieClip.createTextField

TextField.replaceSel
Disponibilidad

Flash Player 6.
Sintaxis

TextField.replaceSel(texto)
Parmetros

texto

Una cadena.

Valor devuelto

Ninguno.

453

Descripcin

Mtodo; reemplaza el elemento seleccionado por el contenido del parmetro texto. El texto se inserta en la posicin de la seleccin, con el formato de carcter y prrafo predeterminados. El texto no se trata como si fuera HTML, ni siquiera cuando el campo de texto es HTML. Puede utilizar el mtodo replaceSel para insertar y eliminar texto sin que el formato de carcter y de prrafo del resto del texto se vea afectado.

TextField.restrict
Disponibilidad

Flash Player 6.
Sintaxis

TextField.restrict
Descripcin

Propiedad; indica el conjunto de caracteres que los usuarios pueden introducir en el campo de texto. Si el valor de la propiedad restrict es null, se puede introducir cualquier carcter. Si el valor de la propiedad restrict es una cadena vaca, no se puede introducir ningn carcter. Si el valor de la propiedad restrict es una cadena de caracteres, slo puede introducir los caracteres de la cadena en el campo de texto. La cadena se explora de izquierda a derecha. Puede especificarse un intervalo utilizando un guin (-). De este modo slo se limita la interaccin del usuario; un script puede introducir cualquier texto en el campo de texto. Esta propiedad no se sincroniza con las casillas de verificacin de Incorporar contornos de fuentes del inspector de propiedades. Si la cadena empieza por ^, inicialmente se aceptan todos los caracteres y los caracteres posteriores de la cadena se excluyen del conjunto de caracteres aceptados. Si la cadena no empieza por ^, inicialmente no se acepta ningn carcter y los caracteres posteriores de la cadena se incluyen en el conjunto de caracteres aceptados.
Ejemplo

En el ejemplo siguiente slo se pueden introducir caracteres en maysculas, espacios y nmeros en los campos de texto:
my_txt.restrict = "A-Z 0-9";

En el ejemplo siguiente se incluyen todos los caracteres, pero se excluyen las letras minsculas:
my_txt.restrict = "^a-z";

Para introducir los caracteres ^ o -, utilice una barra inversa. Las secuencias aceptadas con barra inversa son \-, \^ y \\. La barra inversa debe ser un carcter real de la cadena, de modo que cuando se especifique en ActionScript, deben utilizarse dos. Por ejemplo, el cdigo siguiente incluye slo el guin (-) y el carcter de intercalacin (^):
my_txt.restrict = "\\-\\^";

El ^ puede utilizarse en cualquier posicin de la cadena para alternar la inclusin y la exclusin de caracteres. El cdigo siguiente incluye slo letras maysculas, pero excluye la letra mayscula Q:
my_txt.restrict = "A-Z^Q";

Puede utilizar la secuencia de escape \u para crear cadenas restrict. El cdigo siguiente incluye slo los caracteres comprendidos entre ASCII 32 (espacio) y ASCII 126 (tilde).
my_txt.restrict = "\u0020-\u007E";

454

TextField._rotation
Disponibilidad

Flash Player 6.
Sintaxis

TextField._rotation
Descripcin

Propiedad; especifica la rotacin del campo de texto en grados.

TextField.scroll
Disponibilidad

Flash Player 6.
Sintaxis

TextField.scroll
Descripcin

Propiedad; 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.
Ejemplo

El cdigo siguiente est asociado a un botn Arriba que desplaza el contenido del campo de texto myText.
on (release) { myText.scroll = myText.scroll + 1; }
Vase tambin

TextField.maxscroll, TextField.scroll

TextField.selectable
Disponibilidad

Flash Player 6.
Sintaxis

TextField.selectable
Descripcin

Propiedad; un valor booleano que indica si el campo de texto se puede seleccionar. El valor true indica que el texto se puede seleccionar.

455

TextField.setNewTextFormat
Disponibilidad

Flash Player 6.
Sintaxis

TextField.setNewTextFormat(textFormat)
Parmetros

textFormat

Instancia del objeto TextFormat.

Valor devuelto

Ninguno.
Descripcin

Mtodo; establece un objeto TextFormat para el texto recin insertado, por ejemplo, texto insertado con el mtodo replaceSel o texto introducido por un usuario en un campo de texto. Cada campo de texto tiene un nuevo formato de texto. Cuando se inserta el texto, se asigna el nuevo formato de texto al nuevo texto. El formato de texto se establece en una nueva instancia del objeto TextFormat. Contiene informacin de formato de carcter y de prrafo. La informacin de formato de carcter describe el aspecto de cada carcter, como por ejemplo, el nombre de la fuente, el tamao en puntos, el color y el URL asociado. La informacin de formato de prrafo describe el aspecto de un prrafo, como por ejemplo, el margen izquierdo, el margen derecho, la sangra de la primera lnea y la alineacin a la izquierda, a la derecha o centrada.
Vase tambin

TextField.getNewTextFormat, TextField.getTextFormat, TextField.setTextFormat

TextField.setTextFormat
Disponibilidad

Flash Player 6.
Sintaxis

TextField.setTextFormat (textFormat) TextField.setTextFormat (ndice, textFormat) TextField.setTextFormat (iniciarndice, terminarndice, textFormat)

Parmetros

iniciarndice terminarndice

Un nmero entero. Un nmero entero que especifica el primer carcter despus del espacio de

texto deseado.
textFormat Instancia del objeto TextFormat. Un objeto TextFormat contiene informacin de formato de carcter y de prrafo.
Valor devuelto

Ninguno.

456

Descripcin

Mtodo; establece un objeto de formato de texto para una parte especificada del texto de un campo de texto. Puede asignar un formato de texto a cada carcter de un campo de texto. El formato de texto del primer carcter de un prrafo se examina para asignar formato de prrafo a todo el prrafo. El mtodo setTextFormat cambia el formato de texto aplicado a caracteres individuales, de modo que pasa a aplicarlo a grupos de caracteres, o a todo el cuerpo del texto de un campo de texto. El formato de texto se establece en una nueva instancia del objeto TextFormat. Contiene informacin de formato de carcter y de prrafo. La informacin de formato de carcter describe el aspecto de cada carcter, por ejemplo, el nombre de fuente, el tamao en puntos, el color y el URL asociado. La informacin de formato de prrafo describe el aspecto de un prrafo, por ejemplo, el margen izquierdo, el margen derecho, la sangra de la primera lnea y la alineacin a la izquierda, a la derecha o centrada. Sintaxis 1: aplica las propiedades de textFormat a todo el texto del campo de texto. Sintaxis 2: aplica las propiedades de textFormat al carcter situado en la posicin ndice. Sintaxis 3: aplica las propiedades del parmetro textFormat al espacio de texto desde el parmetro iniciarndice hasta el parmetro terminarndice.
Ejemplo

Este ejemplo crea un nuevo objeto TextFormat llamado myTextFormat y establece su propiedad bold en true. A continuacin, llama al mtodo setTextFormat y aplica el nuevo formato de texto al campo de texto myTextField.
myTextFormat = new TextFormat(); myTextFormat.bold = true; myTextField.setTextFormat(myTextFormat);
Vase tambin

TextFormat (objeto)

TextField._soundbuftime
Disponibilidad

Flash Player 6.
Sintaxis

TextField._soundbuftime
Descripcin

Propiedad (global); entero que especifica el nmero de segundos que un sonido se almacena previamente en una memoria intermedia antes de que empiece a fluir.

457

TextField.tabEnabled
Disponibilidad

Flash Player 6.
Sintaxis

TextField.tabEnabled
Descripcin

Propiedad; puede establecerse en una instancia de los objetos MovieClip, Button o TextField. El valor predeterminado es undefined. Si el valor de la propiedad tabEnabled es undefined o true, el objeto se incluye en el orden de tabulacin automtico; si la propiedad tabIndex se establece tambin en un valor, el objeto se incluye en el orden de tabulacin personalizado. Si el valor de tabEnabled es false, el objeto no se incluye en el orden de tabulacin automtico. En el caso de un clip de pelcula, si tabEnabled es false, los valores secundarios del clip de pelcula pueden seguir incluyndose en el orden de tabulacin automtico, a menos que la propiedad tabChildren tambin se establezca en false. Si tabEnabled es undefined o true, el objeto se incluye en el orden de tabulacin personalizado si se ha establecido la propiedad tabIndex. Si tabEnabled es false, el objeto no se incluye en el orden de tabulacin personalizado, aunque se establezca la propiedad tabIndex. Si tabEnabled se establece en false en un clip de pelcula, los valores secundarios del clip de pelcula pueden seguir incluyndose en el orden de tabulacin personalizado.

TextField.tabIndex
Disponibilidad

Flash Player 6.
Sintaxis

TextField.tabIndex
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Propiedad; permite personalizar el orden de tabulacin de los objetos de una pelcula. Puede establecer la propiedad tabIndex de un botn, un clip de pelcula o una instancia de campo de texto; de manera predeterminada es undefined. Si alguno de los objetos que se muestran en la pelcula Flash contiene una propiedad tabIndex, el orden de tabulacin automtico est desactivado, y el orden de tabulacin se calcula a partir de las propiedades tabIndex de los objetos de la pelcula. El orden de tabulacin personalizado slo incluye objetos que tienen propiedades tabIndex. La propiedad tabIndex debe ser un entero positivo. Los objetos se ordenan de acuerdo con sus propiedades tabIndex, en orden ascendente. Un objeto con una propiedad tabIndex de 1 va antes que un objeto con una propiedad tabIndex 2. Si dos objetos tienen la misma propiedad tabIndex, el que precede en el orden de tabulacin es undefined.

458

El orden de tabulacin personalizado definido por la propiedad tabIndex es flat. Esto significa que no se tienen en cuenta las relaciones jerrquicas de los objetos de la pelcula Flash. Todos los objetos de la pelcula Flash con propiedades tabIndex se colocan en el orden de tabulacin, que viene determinado por el orden de los valores tabIndex. Si dos valores tienen el mismo valor de tabIndex, el precedente ser undefined. No debe utilizarse el mismo valor de tabIndex para varios objetos.

TextField._target
Disponibilidad

Flash Player 6.
Sintaxis

TextField._target
Descripcin

Propiedad (slo lectura); devuelve la ruta de destino de la instancia de campo de texto especificada en el parmetro TextField.

TextField.text
Disponibilidad

Flash Player 6.
Sintaxis

TextField.text
Descripcin

Propiedad; indica el texto actual en el 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.
Vase tambin

TextField.htmlText

TextField.textColor
Disponibilidad

Flash Player 6.
Sintaxis

TextField.textColor
Descripcin

Propiedad; indica el color del texto de un campo de texto.

TextField.textHeight
Disponibilidad

Flash Player 6.
Sintaxis

TextField.textHeight
Descripcin

Propiedad; indica la altura del texto.

459

TextField.textWidth
Disponibilidad

Flash Player 6.
Sintaxis

TextField.textWidth
Descripcin

Propiedad; indica la anchura del texto.

TextField.type
Disponibilidad

Flash Player 6.
Sintaxis

TextField.type
Descripcin

Propiedad; especifica el tipo de campo de texto. Hay dos valores: "dynamic", que especifica un campo de texto dinmico (no puede editarlo el usuario) e "input", que especifica un campo de introduccin de texto.
Ejemplo

TextField.type = "dynamic";

TextField._url
Disponibilidad

Flash Player 6.
Sintaxis

TextField._url
Descripcin

Propiedad (slo lectura); recupera el URL del archivo SWF que ha creado el campo de texto.

TextField.variable
Disponibilidad

Flash Player 6.
Sintaxis

TextField._variable
Descripcin

Propiedad; nombre de la variable con la que est asociado el campo de texto. El tipo de esta propiedad es String.

460

TextField._visible
Disponibilidad

Flash Player 6.
Sintaxis

TextField._visible
Descripcin

Propiedad; valor booleano que indica si el campo de texto especificado por el parmetro TextField est visible. Los campos de texto que no estn visibles (con la propiedad _visible establecida en false) estn desactivados.

TextField._width
Disponibilidad

Flash Player 6.
Sintaxis

TextField._width
Descripcin

Propiedad; establece y recupera la anchura del campo de texto, en pxeles.

Ejemplo

En el ejemplo siguiente se establecen las propiedades de altura y anchura de un campo de texto:

myTextField._width=200; myTextField._height=200;
Vase tambin

MovieClip._height

TextField.wordWrap
Disponibilidad

Flash Player 6.
Sintaxis

TextField.wordWrap
Descripcin

Propiedad; valor booleano que indica si el campo de texto tiene un ajuste de texto. Si el valor de wordWrap es true, significa que el campo de texto tiene un ajuste de texto; si el valor es false, el campo de texto no tiene ningn ajuste de texto.

461

TextField._x
Disponibilidad

Flash Player 6.
Sintaxis

TextField._x
Descripcin

Propiedad; nmero entero que establece la coordenada x de un campo de texto en relacin con las coordenadas locales del clip de pelcula principal. Si un campo de texto est 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 se encuentra dentro de un clip de pelcula que tiene transformaciones, el campo de texto est en el sistema de coordenadas local del clip de pelcula que lo contiene. Por lo tanto, en el caso de un clip de pelcula girado 90 en el sentido contrario a las agujas del reloj, el campo de texto incluido hereda un sistema de coordenadas que gira 90 en el sentido contrario a las agujas del reloj. Las coordenadas del campo de texto hacen referencia a la posicin del punto de registro.
Vase tambin

TextField._xscale, TextField._y, TextField._yscale

TextField._xmouse
Disponibilidad

Flash Player 6.
Sintaxis

TextField._xmouse
Descripcin

Propiedad (slo lectura); devuelve la coordenada x de la posicin del ratn respecto al campo de texto.
Vase tambin

TextField._ymouse

TextField._xscale
Disponibilidad

Flash Player 6.
Sintaxis

TextField._xscale
Descripcin

Propiedad; determina la escala horizontal (porcentaje) del campo de texto que se aplica desde el punto de registro del campo de texto. El punto de registro predeterminado es (0,0).
Vase tambin

TextField._x, TextField._y, TextField._yscale

462

TextField._y
Disponibilidad

Flash Player 6.
Sintaxis

TextField._y
Descripcin

Propiedad; establece la coordenada y de un campo de texto en relacin con las coordenadas locales del clip de pelcula principal. Si un campo de texto est 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 se encuentra dentro de un clip de pelcula que tiene transformaciones, el campo de texto est en el sistema de coordenadas local del clip de pelcula que lo contiene. Por lo tanto, en el caso de un clip de pelcula girado 90 en el sentido contrario a las agujas del reloj, el campo de texto incluido hereda un sistema de coordenadas que gira 90 en el sentido contrario a las agujas del reloj. Las coordenadas del campo de texto hacen referencia a la posicin del punto de registro.
Vase tambin

TextField._x, TextField._xscale, TextField._yscale

TextField._ymouse
Disponibilidad

Flash Player 6.
Sintaxis

TextField._ymouse
Descripcin

Propiedad (slo lectura); indica la coordenada y de la posicin del ratn en relacin con el campo de texto.
Vase tambin

TextField._xmouse

TextField._yscale
Disponibilidad

Flash Player 6.
Sintaxis

TextField._yscale
Descripcin

Propiedad; establece la escala vertical (porcentaje) del campo de texto que se aplica desde el punto de registro del campo de texto. El punto de registro predeterminado es (0,0).
Vase tambin

TextField._x, TextField._xscale, TextField._y

463

TextFormat (objeto)
El objeto TextFormat representa informacin de formato de carcter. Debe utilizar el constructor new TextFormat para crear una instancia del objeto TextFormat antes de llamar a sus mtodos. Puede establecer los parmetros TextFormat en null para indicar que no estn definidos. Al aplicar un objeto TextFormat a un campo de texto con el mtodo setTextFormat, slo se aplican sus propiedades definidas, como ocurre en el ejemplo siguiente:
myTextFormat = new TextFormat(); myTextFormat.bold = true; myTextField.setTextFormat(myTextFormat);

Primero, este cdigo crea un objeto TextFormat vaco con todas sus propiedades sin definir; a continuacin, establece la propiedad bold en un valor definido. El cdigo myTextField.setTextFormat(myTextFormat) slo cambia la propiedad bold del formato de texto predeterminado del campo de texto, ya que la propiedad bold es la nica definida de myTextFormat. Todos los dems aspectos del formato de texto predeterminado del campo de texto permanecen iguales. Cuando se invoca getTextFormat, se devuelve un objeto TextFormat con todas sus propiedades definidas; ninguna propiedad tiene el valor null. Resumen de los mtodos del objeto TextFormat
Mtodo TextFormat.getTextExtent Descripcin Devuelve un objeto con dos propiedades, width y height, que indican el tamao del texto de un campo de texto.

Resumen de las propiedades del objeto TextFormat

Propiedad TextFormat.align TextFormat.blockIndent TextFormat.bold TextFormat.bullet TextFormat.color TextFormat.font TextFormat.indent TextFormat.italic TextFormat.leading TextFormat.leftMargin TextFormat.rightMargin TextFormat.tabStops TextFormat.target TextFormat.size Descripcin Indica la alineacin de un prrafo. Indica la sangra de bloque en puntos. Indica si el texto est en negrita. Indica si el texto forma parte de una lista con vietas. Indica el color del texto. Indica el nombre de fuente del texto con un formato de texto. Indica la sangra desde el margen izquierdo al primer carcter del prrafo. Indica si el texto est en cursiva. Indica la cantidad de espacio vertical entre lneas. Indica el margen izquierdo del prrafo, en puntos. Indica el margen derecho del prrafo, en puntos. Especifica tabulaciones personalizadas. Indica la ventana de un navegador en la que aparece un hipervnculo. Indica el tamao del texto en puntos.

464

Propiedad TextFormat.underline TextFormat.url

Descripcin Indica si el texto est subrayado. Indica el URL al que el texto se vincula.

Constructor del objeto TextFormat

Sintaxis

new TextFormat([fuente, [tamao, [color, [negrita, [cursiva, [subrayado, [url, [destino, [alineacin, [margenIzquierdo, [margenDerecho, [sangra, [espacio]]]]]]]]]]]]])
Parmetros

fuente tamao color

Nombre de una fuente para el texto en forma de cadena. Nmero entero que indica el tamao en puntos.

Color de texto que utiliza este formato de texto. Nmero que contiene tres componentes RGB de 8 bits; por ejemplo, 0xFF0000 es rojo y 0x00FF00 es verde. Valor booleano que indica si el texto est en negrita. Valor booleano que indica si el texto est en cursiva. Valor booleano que indica si el texto est subrayado.

negrita cursiva subrayado url

URL para el que el texto de este formato acta como hipervnculo. Si url es una cadena vaca, el texto no tiene hipervnculo.

destino 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 _self. Si la propiedad TextFormat.url se establece en una cadena vaca o en el valor null, esta propiedad puede obtenerse o establecerse pero no tiene ningn efecto. alineacin Alineacin del prrafo, representado como una cadena. Si su valor es "left", el prrafo se alinea a la izquierda. Si su valor es "center", el prrafo se centra. Si su valor es "right", el prrafo se alinea a la derecha. margenIzquierdo margenDerecho sangra

Indica el margen izquierdo del prrafo, en puntos. Indica el margen derecho del prrafo, en puntos.

Nmero entero que indica la sangra desde el margen izquierdo al primer carcter del Nmero que indica la cantidad de espacio vertical entre lneas.

prrafo.
espacio
Descripcin

Constructor; crea una instancia del 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 el valor null para indicar que no est definido. Todos los parmetros son opcionales; todos los parmetros omitidos se tratarn como si tuvieran el valor null.
Disponibilidad

Flash Player 6.

465

TextFormat.align
Disponibilidad

Flash Player 6.
Sintaxis

TextFormat.align
Descripcin

Propiedad; indica la alineacin del prrafo, que se representa como una cadena. Alineacin del prrafo, que se representa como una cadena. Si su valor es "left", el prrafo se alinea a la izquierda. Si su valor es "center", el prrafo se centra. Si su valor es "right", el prrafo se alinea a la derecha. El valor predeterminado es null e indica que la propiedad no est definida.

TextFormat.blockIndent
Disponibilidad

Flash Player 6.
Sintaxis

TextFormat.blockIndent
Descripcin

Propiedad; nmero que indica la sangra de bloque en puntos. La sangra de bloque se aplica a todo un bloque de texto; es decir, a todas las lneas del texto. En cambio, la sangra normal (TextFormat.indent) slo afecta a la primera lnea de cada prrafo. Si el valor de esta propiedad es null, el objeto TextFormat no especifica sangra de bloque.

TextFormat.bold
Disponibilidad

Flash Player 6.
Sintaxis

TextFormat.bold
Descripcin

Propiedad; valor booleano que indica si el texto est en negrita. El valor predeterminado es null, que indica que la propiedad no est definida.

TextFormat.bullet
Disponibilidad

TextFormat.bullet
Descripcin

Propiedad; valor booleano que indica que el texto forma parte de una lista con vietas. En una lista con vietas, todos los prrafos del texto tienen sangra. A la izquierda de la primera lnea de cada prrafo, aparece un smbolo de vieta. Si el valor de la propiedad es null, el objeto TextFormat no especifica si el texto tiene vietas o no.

466

TextFormat.color
Disponibilidad

Flash Player 6.
Sintaxis

TextFormat.color
Descripcin

Propiedad; indica el color del texto. Nmero que contiene tres componentes RGB de 8 bits; por ejemplo, 0xFF0000 es rojo y 0x00FF00 es verde.

TextFormat.font
Disponibilidad

Flash Player 6.
Sintaxis

TextFormat.font
Descripcin

Propiedad; nombre de la fuente para el texto de este formato de texto, en forma de cadena. El valor predeterminado es null e indica que la propiedad no est definida.

TextFormat.getTextExtent
Disponibilidad

Flash Player 6.
Sintaxis

TextFormat.getTextExtent (texto)
Parmetros

texto

Una cadena.

Valor devuelto

Un objeto con las propiedades width y height.

Descripcin

Mtodo; devuelve el tamao de la cadena de texto especificada en el parmetro texto de este formato de carcter. El valor devuelto es un objeto de clase Object con dos propiedades: width y height. El texto se trata como texto simple (no como texto HTML). El texto es una nica lnea de texto; los saltos y avances de lnea se ignoran y no se aplica ningn ajuste de texto.

TextFormat.indent
Disponibilidad

Flash Player 6.
Sintaxis

TextFormat.indent
Descripcin

Propiedad; nmero entero que indica la sangra desde el margen izquierdo al primer carcter del prrafo. El valor predeterminado es null, que indica que la propiedad no est definida.

467

TextFormat.italic
Disponibilidad

Flash Player 6.
Sintaxis

TextFormat.italic
Descripcin

Propiedad; valor booleano que indica si el texto del formato de texto est en cursiva. El valor predeterminado es null, que indica que la propiedad no est definida.

TextFormat.leading
Disponibilidad

Flash Player 6.
Sintaxis

TextFormat.leading
Descripcin

Propiedad; cantidad de espacio vertical entre lneas. El valor predeterminado es null, que indica que la propiedad no est definida.

TextFormat.leftMargin
Disponibilidad

Flash Player 6.
Sintaxis

TextFormat.leftMargin
Descripcin

Propiedad; margen derecho del prrafo, en puntos. El valor predeterminado es null, que indica que la propiedad no est definida.

TextFormat.rightMargin
Disponibilidad

Flash Player 6.
Sintaxis

TextFormat.rightMargin
Descripcin

Propiedad; margen derecho del prrafo, en puntos. El valor predeterminado es null, que indica que la propiedad no est definida.

468

TextFormat.size
Disponibilidad

Flash Player 6.
Sintaxis

TextFormat.size
Descripcin

Propiedad; tamao en puntos del texto de este formato de texto. El valor predeterminado es null, que indica que la propiedad no est definida.

TextFormat.tabStops
Disponibilidad

Flash Player 6.
Sintaxis

TextFormat.tabStops
Descripcin

Propiedad; especifica tabulaciones personalizadas en forma de matriz de nmeros enteros no negativos. Cada tabulacin se especifica en puntos. Si no se especifican tabulaciones personalizadas (null), la tabulacin predeterminada es 4 (promedio de anchura de carcter).

TextFormat.target
Disponibilidad

Flash Player 6.
Sintaxis

TextFormat.target
Descripcin

Propiedad; 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 _self. Si la propiedad TextFormat.url se establece en una cadena vaca o en el valor null, esta propiedad puede obtenerse o establecerse pero no tiene ningn efecto.

TextFormat.underline
Disponibilidad

Flash Player 6.
Sintaxis

TextFormat.underline
Descripcin

Propiedad; valor booleano que indica si el texto que utiliza este objeto TextFormat est subrayado. Si el valor de underline es true, el texto de este formato de texto aparece subrayado. Si es false, el texto no est subrayado. Este es el mismo subrayado que se obtiene con la etiqueta <U>, que no es un subrayado "verdadero", ya que no se salta los trazos descendentes de los caracteres correctamente. El valor predeterminado es null, que indica que la propiedad no est definida.

469

TextFormat.url
Disponibilidad

Flash Player 6.
Sintaxis

TextFormat.url
Descripcin

Propiedad; indica el URL para el que el texto de este formato acta como hipervnculo. Si la propiedad url es una cadena vaca, el texto no tiene hipervnculo. El valor predeterminado es null, que indica que la propiedad no est definida.

this
Disponibilidad

Flash Player 5.
Sintaxis

this
Descripcin

Palabra clave; hace referencia a una instancia de objeto o de clip de pelcula. Cuando se ejecuta un script, this hace referencia a la instancia de clip de pelcula que contiene el script. Cuando se llama a un mtodo, this contiene una referencia al objeto que contiene el mtodo llamado. Dentro de una accin de controlador de eventos on asociada a un botn, this se refiere a la lnea de tiempo que contiene el botn. Dentro de una accin de controlador de eventos onClipEvent asociada a un clip de pelcula, this se refiere a la lnea de tiempo del propio clip de pelcula.
Ejemplo

En el ejemplo siguiente, la palabra clave this hace referencia al objeto Circle.

function Circle(radius) { this.radius = radius; this.area = Math.PI * radius * radius; }

En la sentencia siguiente asignada a un fotograma, la palabra clave this hace referencia al clip de pelcula actual.
// establece la propiedad alfa del clip de pelcula actual en 20 this._alpha = 20;

En la sentencia siguiente dentro de un controlador onClipEvent, la palabra clave this hace referencia al clip de pelcula actual.
// cuando se carga el clip de pelcula, se inicia una operacin startDrag // para el clip de pelcula actual. onClipEvent (load) { startDrag (this, true); }
Vase tambin

new

470

toggleHighQuality
Disponibilidad

Flash 2.
Sintaxis

toggleHighQuality()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Accin; activa y desactiva el suavizado (antialiasing) en Flash Player. El suavizado suaviza los bordes de los objetos y hace ms lenta la reproduccin de la pelcula. La accin toggleHighQuality afecta a todas las pelculas de Flash Player.
Ejemplo

El cdigo siguiente podra aplicarse a un botn que, cuando se hace clic en l, activa o desactiva el suavizado:
on(release) { toggleHighQuality(); }
Vase tambin

_quality, _highquality

trace
Disponibilidad

Flash Player 4.
Sintaxis

trace(expresin)
Parmetros

Expresin cuyo valor debe comprobarse. Cuando se abre un archivo SWF en la herramienta de edicin de Flash (mediante el comando Probar pelcula), el valor del parmetro expresin se muestra en la ventana Salida.
expresin
Valor devuelto

Ninguno.
Descripcin

Accin; comprueba el valor de la expresin y muestra el resultado en la ventana Salida en modo de prueba. La accin trace sirve para grabar notas de programacin o para ver mensajes en la ventana Salida mientras se prueba una pelcula. El parmetro expresin sirve para comprobar si existe una condicin o para ver valores en la ventana Salida. La accin trace es similar a la funcin alert de JavaScript. Puede utilizar el comando Omitir acciones de seguimiento de Configuracin de publicacin para eliminar acciones trace del archivo SWF exportado.

471

Ejemplo

Este ejemplo corresponde a un juego en el que una instancia de clip de pelcula arrastrable llamada rabbi debe soltarse en un destino especfico. Una sentencia condicional comprueba el valor de la propiedad _droptarget y ejecuta diferentes acciones dependiendo de donde se suelta la instancia de clip de pelcula rabbi. La accin trace se utiliza al final del script para comprobar el valor de la ubicacin del clip de pelcula rabbi y mostrar el resultado en la ventana Salida. Si rabbi no se comporta como se esperaba (por ejemplo, si encaja en el destino incorrecto), los valores enviados a la ventana Salida por la accin trace le ayudarn a determinar el problema del script.
on(press) { rabbi.startDrag(); } on(release) { if(eval(_droptarget) != target) { rabbi._x = rabbi_x; rabbi._y = rabbi_y; } else { rabbi_x = rabbi._x; rabbi_y = rabbi._y; target = "_root.pasture"; } trace("rabbi_y = " + rabbi_y); trace("rabbi_x = " + rabbi_x); stopDrag(); }

true
Disponibilidad

Flash Player 5.
Sintaxis

true
Descripcin

Valor booleano nico que representa lo contrario de false.

Vase tambin

false

typeof
Disponibilidad

Flash Player 5.
Sintaxis

typeof expresin
Parmetros

expresin

Cadena, clip de pelcula, botn, objeto o funcin.

472

Descripcin

Operador; operador unario situado antes de un solo parmetro. El operador typeof hace que el intrprete de Flash compruebe el valor del parmetro expresin; el resultado es una cadena que especifica si la expresin es una cadena, un clip de pelcula, un objeto o una funcin. En la tabla siguiente se muestran los resultados del operador typeof en cada tipo de expresin:
Parmetro Cadena ClipPelcula Botn Campo de texto Nmero Booleano Objeto Funcin Resultado string movieclip object object number boolean object function

undefined
Disponibilidad

Flash Player 5.
Sintaxis

undefined
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Valor especial que normalmente se utiliza para indicar que an no se ha asignado ningn valor a una variable. Una referencia a un valor sin definir devuelve el valor especial undefined. El cdigo de ActionScript typeof(undefined) devuelve la cadena "undefined". El nico valor de tipo undefined es undefined. Cuando el valor undefined se convierte en una cadena, se convierte en la cadena vaca. El valor undefined es similar al valor especial null. Si se comparan los valores null y undefined con el operador de igualdad, ver que son iguales.

473

Ejemplo

En este ejemplo, la variable x no se ha declarado y, por lo tanto, tiene el valor undefined. En la primera parte del cdigo, el operador de igualdad (==) compara el valor de x con el valor undefined y el resultado se enva a la ventana Salida. En la segunda parte del cdigo, el operador de igualdad compara los valores null y undefined.
// x an no se ha declarado trace ("El valor de x es " + x); if (x == undefined) { trace ("x es undefined"); } else { trace ("x no es undefined"); } trace ("typeof (x) es " + typeof (x)); if (null == undefined) { trace ("null y undefined son iguales"); } else { trace ("null y undefined no son iguales"); }

Se muestra el resultado siguiente en la ventana Salida:

El valor de x es x es undefined typeof (x) es undefined null y undefined son iguales
Nota: en la especificacin ECMA-262, undefined se convierte en la cadena undefined, no en la cadena vaca. sta es una de las diferencias entre ActionScript y la especificacin ECMA-262.

unescape
Disponibilidad

Flash Player 5.
Sintaxis

unescape(x)
Parmetros

Cadena con secuencias hexadecimales de escape.

Valor devuelto

Ninguno.
Descripcin

Funcin de nivel superior; obtiene una cadena como valor del argumento x, decodifica la cadena a partir de un formato URL codificado (convirtiendo todas las secuencias hexadecimales en caracteres ASCII) y devuelve la cadena.

474

Ejemplo

En el ejemplo siguiente se ilustra el proceso de conversin de caracteres de escape a caracteres que no son de escape.
escape("Hola{[Mundo]}");

El resultado con caracteres de escape es el que se muestra a continuacin:

("Hola%7B%5BMundo%5D%7D");

La funcin unescape sirve para volver al formato original:

unescape("Hola%7B%5BMundo%5D%7D")

El resultado es el que se muestra a continuacin:

Hola{[Mundo]}

unloadMovie
Disponibilidad

Flash Player 3.
Sintaxis

unloadMovie[Num](nivel/"destino")
Parmetros

nivel Nivel (_levelN) de una pelcula cargada. Cuando se descarga una pelcula de un nivel, la accin unloadMovie del panel Acciones en modo Normal cambia a unloadMovieNum; en modo Experto, debe especificar unloadMovieNum o elegirla de la caja de herramientas Acciones. destino

Ruta de destino de un clip de pelcula.

Valor devuelto

Ninguno.
Descripcin

Accin; elimina una pelcula cargada o un clip de pelcula de Flash Player. Para descargar una pelcula que se ha cargado en un nivel en Flash Player, utilice el parmetro nivel. Para descargar un clip de pelcula cargado, utilice el parmetro destino.
Ejemplo

En el ejemplo siguiente se descarga el clip de pelcula draggable en la lnea de tiempo principal y se carga la pelcula movie.swf en el nivel 4.
on (press) { unloadMovie ("_root.draggable"); loadMovieNum ("movie.swf", 4); }

En el ejemplo siguiente se descarga la pelcula cargada en el nivel 4:

on (press) { unloadMovieNum (4); }
Vase tambin

loadMovie, loadMovieNum, unloadMovieNum

475

unloadMovieNum
Disponibilidad

Flash Player 3.
Sintaxis

unloadMovieNum(nivel)
Parmetros

nivel

Nivel (_levelN) de una pelcula cargada.

Valor devuelto

Ninguno.
Descripcin

Accin; elimina una pelcula cargada de Flash Player.

Vase tambin

loadMovie, loadMovieNum

updateAfterEvent
Disponibilidad

Flash Player 5.
Sintaxis

updateAfterEvent()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Accin; actualiza la visualizacin (independientemente de los fotogramas por segundo establecidos para la pelcula) cuando el usuario la llama en un controlador onClipEvent o como parte de una funcin o un mtodo que el usuario pasa a setInterval. Flash ignora las llamadas a updateAfterEvent que no se encuentran en un controlador onClipEvent o que no forman parte de una funcin o un mtodo pasado a setInterval.
Vase tambin

onClipEvent, setInterval

476

var
Disponibilidad

Flash Player 5.
Sintaxis

var nombreVariable1 [= valor1] [...,nombreVariableN [=valorN]]

Parmetros

nombreVariable valor

Un identificador.

Valor asignado a la variable.

Valor devuelto

Ninguno.
Descripcin

Accin; se utiliza para declarar variables locales. Si declara variables locales dentro de una funcin, las variables se definen para la funcin y expiran al final de la llamada a la funcin. Si las variables no se declaran dentro de un bloque ({}), pero la lista de acciones se ejecut con una accin call, las variables son locales y expiran al final de la lista actual. Si las variables no se declaran dentro de un bloque y la lista de acciones actual no se ejecut con la accin call, las variables no son locales.
Ejemplo

En los ejemplos siguientes, se utiliza la accin var para declarar y asignar variables:
var var var var x; y = 1; z = 3, w = 4; s, t, u = z;

void
Disponibilidad

Flash Player 5.
Sintaxis

void (expresin)
Descripcin

Operador; operador unario que descarta el valor expresin y devuelve un valor sin definir. El operador void se utiliza a menudo en comparaciones con el operador == para comprobar valores sin definir.

477

while
Disponibilidad

Flash Player 4.
Sintaxis

while(condicin) { sentencia(s); }
Parmetros

condicin Expresin cuyo valor se vuelve a comprobar cada vez que se ejecuta la accin while. Si el valor de la sentencia es true, se ejecuta(n) la(s)sentencia(s). sentencia(s)
Valor devuelto

Cdigo que debe ejecutarse si el valor de la condicin es true.

Ninguno.
Descripcin

Accin; comprueba el valor de una expresin y ejecuta una sentencia o una serie de sentencias varias veces en un bucle, siempre que el valor de la expresin sea true. Antes de que se ejecute el bloque de sentencia, se comprueba la condicin; si se obtiene como resultado el valor true, se ejecuta el bloque de sentencia. Si la condicin es false, el bloque de sentencia se omite y se ejecuta la primera sentencia despus de ejecutar el bloque de sentencia de la accin while. Los bucles se utilizan con frecuencia para realizar una accin mientras que una variable de contador es menor que un valor especificado. Al final de cada bucle, el contador se incrementa hasta que se alcanza el valor especificado. En ese momento, la condicin deja de ser true y el bucle termina. La sentencia while efecta la siguiente serie de pasos. Cada repeticin de los pasos 1 al 4 se denomina una repeticin del bucle. Al principio de cada repeticin, se vuelve a comprobar el valor de la condicin, tal como se describe en los pasos siguientes:
1 2

Se comprueba el valor de la expresin condicin. Siga con el paso 3 si el valor de la condicin es true o un valor que convierte al valor booleano true, como por ejemplo, cualquier nmero distinto de cero. En caso contrario, la sentencia while finaliza y la ejecucin se reanuda en la siguiente sentencia tras el bucle while.

3 4

Ejecute el bloque de sentencia sentencia(s). Vaya al paso 1.

478

Ejemplo

Este ejemplo duplica cinco clips de pelcula en el escenario, cada uno con una posicin x e y generadas aleatoriamente, xscale, yscale y la propiedad _alpha para conseguir un efecto de dispersin. La variable foo se inicializa con el valor 0. El parmetro condicin se establece de modo que el bucle while se ejecute cinco veces o siempre que la variable foo sea menor que 5. Dentro del bucle while, se duplica un clip de pelcula y se utiliza setProperty para ajustar las diferentes propiedades del clip de pelcula duplicado. La ltima sentencia del bucle incrementa la variable foo de modo que cuando el valor llega a 5, el valor del parmetro condicin es false y el bucle no se ejecuta.
on(release) { foo = 0; while(foo < 5) { duplicateMovieClip("_root.flower", "mc" + foo, foo); setProperty("mc" + foo, _x, random(275)); setProperty("mc" + foo, _y, random(275)); setProperty("mc" + foo, _alpha, random(275)); setProperty("mc" + foo, _xscale, random(200)); setProperty("mc" + foo, _yscale, random(200)); foo++; } }
Vase tambin

do while, continue, for, for..in

with
Disponibilidad

Flash Player 5.
Sintaxis

with (objeto) { sentencia(s); }

Parmetros

objeto

Instancia de un objeto o clip de pelcula de ActionScript. Accin o grupo de acciones entre llaves.

sentencia(s)
Valor devuelto

Ninguno.
Descripcin

Accin; permite especificar un objeto (por ejemplo, un clip de pelcula) con el parmetro objeto y comprobar el valor de expresiones y acciones dentro de un objeto con el parmetro sentencia(s). Esto evita que tenga que escribir el nombre del objeto o la ruta al objeto continuamente. El parmetro objeto pasa a ser el contexto en el que se leen las propiedades, variables y funciones en el parmetro sentencia(s). Por ejemplo, si el objeto es myArray y dos de las propiedades especificadas son length y concat, dichas propiedades se leen automticamente como myArray.length y myArray.concat. En otro ejemplo, si el objeto es state.california, se llama a las acciones y sentencias de la accin with desde la instancia california.

479

Para averiguar el valor de un identificador del parmetro sentencia(s), ActionScript se inicia al principio de la cadena de mbito especificada por el objeto y busca el identificador en cada nivel de la cadena de mbito, en un orden especfico. La cadena de mbito utilizada por la accin with para resolver identificadores comienza con el primer elemento de la lista siguiente y contina hasta el ltimo:

El objeto especificado en el parmetro objeto de la accin with ms interior. El objeto especificado en el parmetro object de la accin with ms exterior. El objeto Activation (objeto temporal que se crea automticamente cuando se llama a una
funcin que contiene las variables locales a las que se ha llamado en la funcin).

El clip de pelcula contiene el script que se ejecuta. El objeto Global (objetos incorporados, como Math y String).
Para establecer una variable dentro de una accin with, la variable debe haber sido declarada fuera de la accin with o debe introducir la ruta de acceso completa a la lnea de tiempo en la que desea que resida la variable. Si establece una variable en una accin with sin haberla declarado, la accin with buscar el valor segn la cadena de mbito. Si la variable todava no existe, el nuevo valor se establecer en la lnea de tiempo desde la que se llam a la accin with. En Flash 5, la accin with reemplaza a la accin tellTarget desestimada. Se recomienda utilizar with en lugar de tellTarget debido a que es una extensin estndar de ActionScript del estndar ECMA-262. La diferencia principal entre las acciones with y tellTarget es que with toma una referencia a un clip de pelcula o a otro objeto como parmetro, mientras que tellTarget toma una cadena de ruta de destino que identifica un clip de pelcula como su parmetro y no se puede utilizar para especificar el destino de objetos.
Ejemplo

En el ejemplo siguiente se establecen las propiedades x e y de la instancia someOtherMovieClip y despus se ordena a someOtherMovieClip que vaya al fotograma 3 y se detenga.
with (someOtherMovieClip) { _x = 50; _y = 100; gotoAndStop(3); }

El siguiente fragmento de cdigo muestra cmo escribir el cdigo anterior sin utilizar una accin with.
someOtherMovieClip._x = 50; someOtherMovieClip._y = 100; someOtherMovieClip.gotoAndStop(3);

Tambin podra escribir este cdigo mediante la accin tellTarget. Sin embargo, si someOtherMovieClip no fuera un clip de pelcula, sino un objeto, no podra utilizar la accin with.
tellTarget ("someOtherMovieClip") { _x = 50; _y = 100; gotoAndStop(3); }

480

La accin with es til para acceder a varios elementos de una lista de cadena de mbito simultneamente. En el ejemplo siguiente, el objeto incorporado Math se sita al frente de la cadena de mbito. Si se establece Math como valor predeterminado, el objeto resuelve los identificadores cos, sin y PI en los valores Math.cos, Math.sin y Math.PI, respectivamente. Los identificadores a, x, y y r no son mtodos ni propiedades del objeto Math, pero como existen en el mbito de activacin de objeto de la funcin polar, se resuelven en las variables locales correspondientes.
function polar(r) { var a, x, y; with (Math) { a = PI * r * r; x = r * cos(PI); y = r * sin(PI/2); } trace("rea = " +a); trace("x = " + x); trace("y = " + y); }

Puede utilizar acciones with anidadas para acceder a la informacin en varios mbitos. En el ejemplo siguiente, la instancia fresno y la instancia salinas son instancias secundarias de la instancia california. La sentencia establece los valores _alpha de fresno y salinas sin cambiar el valor _alpha de california.
with (california){ with (fresno){ _alpha = 20; } with (salinas){ _alpha = 40; } }
Vase tambin

tellTarget

481

XML (objeto)
Utilice los mtodos y propiedades del objeto XML para cargar, analizar, enviar, construir y manipular rboles de documentos XML. En Flash MX, el objeto XML ha pasado a ser un objeto nativo. Debido a ello, experimentar una gran mejora en el rendimiento. Debe utilizar el constructor new XML() para crear una instancia del objeto XML antes de llamar a los mtodos del objeto XML. XML se admite en Flash Player 5 y Flash Player 6. Resumen de los mtodos del objeto XML
Mtodo XML.appendChild XML.cloneNode XML.createElement XML.createTextNode XML.getBytesLoaded XML.getBytesTotal XML.hasChildNodes XML.insertBefore XML.load XML.parseXML XML.removeNode XML.send XML.sendAndLoad XML.toString Descripcin Anexa un nodo al final de la lista del objeto secundario especificado. Duplica el nodo especificado y, como opcin, duplica repetidamente todos los nodos secundarios. Crea un nuevo elemento XML. Crea un nuevo nodo de texto XML. Devuelve el nmero de bytes cargados para el documento XML especificado. Devuelve el tamao del documento XML en bytes. Devuelve true si el nodo especificado tiene nodos secundarios; de lo contrario, devuelve false. Inserta un nodo delante de un nodo existente en la lista de nodos secundarios especificada. Carga un documento (especificado por el objeto XML) de un URL. Analiza un documento XML en el rbol de objeto XML especificado. Elimina el nodo especificado de su principal. Enva el objeto XML especificado a un URL. Enva el objeto XML especificado a un URL y carga la respuesta del servidor en otro objeto XML. Convierte el nodo especificado y cualquiera de sus secundarios en texto XML.

Resumen de las propiedades del objeto XML

Propiedad XML.contentType XML.docTypeDecl XML.firstChild XML.ignoreWhite XML.lastChild XML.load XML.nextSibling Descripcin Indica el tipo MIME transmitido al servidor. Establece y devuelve informacin sobre la declaracin DOCTYPE de un documento XML. Hace referencia al primer nodo secundario de la lista del nodo especificado. Cuando se establecen en true, los nodos de texto que slo contienen espacios en blanco se descartan durante el proceso de anlisis. Hace referencia al ltimo nodo secundario de la lista del nodo especificado. Comprueba si se ha cargado el objeto XML especificado. Hace referencia al siguiente valor colateral en la lista de nodos secundarios del nodo principal.

482

Propiedad XML.nodeName XML.nodeType XML.nodeValue XML.parentNode XML.previousSibling XML.status XML.xmlDecl

Descripcin Devuelve el nombre de etiqueta de un elemento XML. Devuelve el tipo del nodo especificado (nodo de texto o elemento XML). Devuelve el texto del nodo especificado si el nodo es un nodo de texto. Hace referencia al nodo principal del nodo especificado. Hace referencia al valor colateral anterior en la lista de nodos secundarios del nodo principal. Devuelve el cdigo de estado numrico que indica el xito o el fracaso de una operacin de anlisis de un documento XML. Establece y devuelve la informacin sobre la declaracin de un documento XML.

Resumen de los mtodos del objeto XML

Mtodo XML.attributes XML.childNodes Descripcin Devuelve una matriz asociativa que contiene todos los atributos del nodo especificado. Devuelve una matriz que contiene la referencia a los nodos secundarios del nodo especificado.

Resumen del controlador de eventos del objeto XML

Mtodo XML.onData XML.onLoad Descripcin Funcin callback que se invoca cuando el texto XML se ha descargado completamente del servidor o cuando se produce un error al descargar texto XML de un servidor. Funcin callback para load y sendAndLoad.

Constructor del objeto XML.

Disponibilidad

Flash Player 5.
Sintaxis

new XML([origen])
Parmetros

origen

El documento XML que se va a analizar para crear un nuevo objeto XML.

Valor devuelto

Ninguno.
Descripcin

Constructor; crea un nuevo objeto XML. Debe utilizar el mtodo constructor para crear una instancia del objeto XML antes de llamar a cualquiera de los mtodos del objeto XML.
Nota: los mtodos createElement y createTextNode son los mtodos constructor para crear los elementos y los nodos de texto en un rbol de documento XML.

483

Ejemplo

Sintaxis 1: en el ejemplo siguiente se crea un nuevo objeto XML vaco.

myXML = new XML();

Sintaxis 2: en el ejemplo siguiente se crea un objeto XML analizando el texto XML especificado en el parmetro origen y se rellena el objeto XML recin creado con el rbol del documento XML resultante.
anyOtherXML = new XML("<state>California<city>San Francisco</city></state>");
Vase tambin

XML.createElement, XML.createTextNode

XML.appendChild
Disponibilidad

Flash Player 5.
Sintaxis

myXML.appendChild(nodoSecundario)
Parmetros

nodoSecundario Nodo secundario que debe agregarse a la lista de nodos secundarios del objeto XML que se ha especificado.
Valor devuelto

Ninguno.
Descripcin

Mtodo; anexa el nodo secundario especificado a la lista de nodos secundarios del objeto XML. El nodo anexado se ubica en la estructura del rbol una vez que se ha eliminado de su nodo principal existente, si lo hay.
Ejemplo

En el ejemplo siguiente se duplica el ltimo nodo de doc1 y lo adjunta a doc2.

doc1 = new XML(src1); doc2 = new XML(); node = doc1.lastChild.cloneNode(true); doc2.appendChild(node);

XML.attributes
Disponibilidad

Flash Player 5.
Sintaxis

myXML.attributes
Parmetros

Ninguno.
Valor devuelto

Ninguno.

484

Descripcin

Coleccin (de lectura-escritura); devuelve una matriz asociativa que contiene todos los atributos del objeto XML especificado.
Ejemplo

En el ejemplo siguiente se muestran los nombres de los atributos XML en la ventana Salida.
str = "<mytag name=\"Val\"> intem </mytag>"; doc = new XML(str); y = doc.firstChild.attributes.name; trace (y); doc.firstChild.attributes.order = "first"; z = doc.firstChild.attributes.order trace(z);

Lo que se muestra a continuacin es lo que aparece en la ventana Salida.

Val first

XML.childNodes
Disponibilidad

Flash Player 5.
Sintaxis

myXML.childNodes
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Coleccin (slo lectura); devuelve una matriz de los nodos 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 y no puede utilizarse para manipular nodos secundarios. Los mtodos appendChild, insertBefore y removeNode sirven para manipular nodos secundarios. Esta coleccin no est definida para nodos de texto (nodeType == 3).
Vase tambin

XML.nodeType

XML.cloneNode
Disponibilidad

Flash Player 5.
Sintaxis

myXML.cloneNode(prof)
Parmetros

prof

Valor booleano que especifica si los valores secundarios del objeto XML especificado se duplican repetidamente.

485

Valor devuelto

Ninguno.
Descripcin

Mtodo; construye y devuelve un nuevo nodo XML del mismo tipo, nombre, valor y atributos que el objeto XML especificado. Si prof est establecido en true, todos los nodos secundarios se duplican repetidamente, lo que da como resultado una copia exacta del rbol de documento del objeto original. El duplicado del nodo que se devuelve deja de estar asociado con el rbol del elemento duplicado. En consecuencia, nextSibling, parentNode y previousSibling tienen el valor null. Si no se efecta una copia de clip, firstChild y lastChild tambin son null.

XML.contentType
Disponibilidad

Flash Player 6.
Sintaxis

myXML.contentType
Descripcin

Propiedad; tipo MIME que se enva al servidor cuando se llama al mtodo XML.send o XML.sendAndLoad. El valor predeterminado es application/x-www-form-urlencoded.
Vase tambin

XML.send, XML.sendAndLoad

XML.createElement
Disponibilidad

Flash Player 5.
Sintaxis

myXML.createElement(nombre)
Parmetros

nombre

Nombre de etiqueta del elemento XML que se est creando.

Valor devuelto

Ninguno.
Descripcin

Mtodo; crea un nuevo elemento XML con el nombre especificado en el parmetro. Inicialmente, el nuevo elemento no tiene ningn elemento principal, secundario ni colateral. El mtodo devuelve una referencia al objeto XML recin creado que representa el elemento. Este mtodo y createTextNode son los mtodos constructor para crear nodos para un objeto XML.

486

XML.createTextNode
Disponibilidad

Flash Player 5.
Sintaxis

myXML.createTextNode(texto)
Parmetros

texto

Texto utilizado para crear el nuevo nodo de texto.

Valor devuelto

Ninguno.
Descripcin

Mtodo; crea un nuevo nodo de texto XML con el texto especificado. Inicialmente, el nuevo nodo no tiene nodo principal y los nodos de texto no pueden tener nodos secundarios ni colaterales. Este mtodo devuelve una referencia al objeto XML que representa el nuevo nodo de texto. Este mtodo y createElement son los mtodos constructor para crear nodos para un objeto XML.

XML.docTypeDecl
Disponibilidad

Flash Player 5.
Sintaxis

myXML.XMLdocTypeDecl
Descripcin

Propiedad; establece y devuelve informacin sobre la declaracin DOCTYPE del documento XML. Una vez analizado el texto XML de un objeto XML, la propiedad XML.docTypeDecl del objeto XML se establece en el texto de la declaracin DOCTYPE del documento XML. Por ejemplo, <!DOCTYPE greeting 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 una analizador de validacin. El analizador lee la declaracin DOCTYPE que, a continuacin, se almacena en la propiedad docTypeDecl, pero no se realiza ninguna validacin DTD. Si no se ha encontrado ninguna declaracin DOCTYPE durante una operacin de anlisis, XML.docTypeDecl se establece en undefined. XML.toString produce la salida del contenido de XML.docTypeDecl inmediatamente despus de la declaracin XML almacenada en XML.xmlDecl y antes de cualquier otro texto del objeto XML. Si la propiedad XML.docTypeDecl no est definida, no obtiene ninguna declaracin DOCTYPE.
Ejemplo

En el ejemplo siguiente se utiliza XML.docTypeDecl para establecer la declaracin DOCTYPE de un objeto XML:
myXML.docTypeDecl = "<!DOCTYPE greeting SYSTEM \"hello.dtd\">";
Vase tambin

XML.toString, XML.xmlDecl

487

XML.firstChild
Disponibilidad

Flash Player 5.
Sintaxis

myXML.firstChild
Descripcin

Propiedad (slo lectura); evala el objeto XML especificado y hace referencia al primer nodo secundario en la lista de nodos secundarios del nodo principal. Esta propiedad tiene el valor null si el nodo no tiene nodos secundarios. Esta propiedad est sin definir si el nodo es un nodo de texto. Esta es una propiedad de slo lectura y no puede utilizarse para manipular nodos secundarios; utilice los mtodos appendChild, insertBefore y removeNode para manipular nodos secundarios.
Vase tambin

XML.appendChild, XML.insertBefore, XML.removeNode

XML.getBytesLoaded
Disponibilidad

Flash Player 6.
Sintaxis

XML.getBytesLoaded()
Parmetros

Ninguno.
Valor devuelto

Entero que indica el nmero de bytes cargados.

Descripcin

Mtodo; devuelve el nmero de bytes cargados (en flujo) para el documento XML. Puede comparar el valor de getBytesLoaded con el valor de getBytesTotal para determinar el porcentaje que se ha cargado de un documento XML.
Vase tambin

XML.getBytesTotal

XML.getBytesTotal
Disponibilidad

Flash Player 6.
Sintaxis

XML.getBytesTotal()
Parmetros

Ninguno.
Valor devuelto

Un nmero entero.

488

Descripcin

Mtodo; devuelve el tamao, en bytes, del documento XML.

Vase tambin

XML.getBytesLoaded

XML.hasChildNodes
Disponibilidad

Flash Player 5.
Sintaxis

myXML.hasChildNodes()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; devuelve el valor true si el objeto XML especificado tiene nodos secundarios; en caso contrario, devuelve el valor false.
Ejemplo

En el ejemplo siguiente se utiliza la informacin del objeto XML en una funcin definida por el usuario.
if (rootNode.hasChildNodes()) { myfunc (rootNode.firstChild); }

XML.ignoreWhite
Disponibilidad

Flash Player 5.
Sintaxis

myXML.ignoreWhite = booleano XML.prototype.ignoreWhite = booleano

Parmetros

booleano

Valor booleano (true o false).

Descripcin

Propiedad; el valor predeterminado es false. Cuando se establecen en true, los nodos de texto que slo contienen espacios 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 cdigo siguiente:
myXML.ignoreWhite = true

489

XML.insertBefore
Disponibilidad

Flash Player 5.
Sintaxis

myXML.insertBefore(nodoSecundario, nodoAnterior)
Parmetros

nodoSecundario nodoAnterior
Valor devuelto

Nodo que se va a insertar. Nodo situado delante del punto de insercin de nodoSecundario.

Ninguno.
Descripcin

Mtodo; inserta un nuevo nodo secundario en la lista de nodos secundarios del objeto XML, antes de nodoAnterior. Si el parmetro nodoAnterior no est definido o tiene el valor null, el nodo se agrega con el mtodo appendChild. Si nodoAnterior no es un nodo secundario de myXML, la insercin no se realiza.

XML.lastChild
Disponibilidad

Flash Player 5.
Sintaxis

myXML.lastChild
Descripcin

Propiedad (slo lectura); evala el objeto XML y hace referencia al ltimo nodo secundario en la lista de nodos secundarios del nodo principal. Este mtodo devuelve el valor null si el nodo no tiene nodos secundarios. Esta es una propiedad de slo lectura y no puede utilizarse para manipular nodos secundarios; utilice los mtodos appendChild, insertBefore y removeNode para manipular nodos secundarios.
Vase tambin

XML.appendChild, XML.insertBefore, XML.removeNode

XML.load
Disponibilidad

Flash Player 5.
Sintaxis

myXML.load(url)
Parmetros

url URL en el que se encuentra el documento XML que debe cargarse. El URL debe pertenecer al mismo subdominio que el URL donde reside actualmente la pelcula.

490

Valor devuelto

Ninguno.
Descripcin

Mtodo; carga un documento XML del URL especificado y reemplaza el contenido del objeto XML especificado con los datos XML descargados. El proceso de carga es asncrono; no finaliza inmediatamente despus de que se ejecute el mtodo load. Cuando se ejecuta el mtodo load, la propiedad del objeto XML loaded se establece en false. Cuando finaliza la descarga de los datos XML, la propiedad loaded se establece en true y se invoca el mtodo onLoad. Los datos XML no se analizan hasta que no se han descargado por completo. Si el objeto XML contena anteriormente cualquiera de los rboles XML, se descartan. Puede especificar su propia funcin callback en lugar del mtodo onLoad.
Ejemplo

A continuacin, se muestra un ejemplo simple que utiliza XML.load:

doc = new XML(); doc.load ("theFile.xml");
Vase tambin

XML.loaded, XML.onLoad

XML.loaded
Disponibilidad

Flash Player 5.
Sintaxis

myXML.loaded
Descripcin

Propiedad (slo lectura); determina si el proceso de carga del documento iniciado por la llamada XML.load se ha completado. Si el proceso se completa correctamente, el mtodo devuelve el valor true; en caso contrario, devuelve el valor false.
Ejemplo

En el ejemplo siguiente se utiliza XML.loaded en un script sencillo.

if (doc.loaded) { gotoAndPlay(4); }

491

XML.nextSibling
Disponibilidad

Flash Player 5.
Sintaxis

myXML.nextSibling
Descripcin

Propiedad (slo lectura); evala el objeto XML y hace referencia al siguiente valor colateral en la lista de nodos secundarios del nodo principal. Este mtodo devuelve el valor null si el nodo no tiene un nodo de valor colateral siguiente. Esta es una propiedad de slo lectura y no puede utilizarse para manipular nodos secundarios. Los mtodos appendChild, insertBefore y removeNode sirven para manipular nodos secundarios.
Vase tambin

XML.appendChild, XML.insertBefore, XML.removeNode

XML.nodeName
Disponibilidad

Flash Player 5.
Sintaxis

myXML.nodeName
Descripcin

Propiedad; toma o devuelve el nombre de nodo del objeto XML. Si el objeto XML es un elemento XML (nodeType == 1), nodeName es el nombre de la etiqueta que representa el nodo en el archivo XML. Por ejemplo, TITLE es el nodeName de una etiqueta TITLE HTML. Si el objeto XML es un nodo de texto (nodeType == 3), el valor de nodeName es null.
Vase tambin

XML.nodeType

XML.nodeType
Disponibilidad

Flash Player 5.
Sintaxis

myXML.nodeType
Descripcin

Propiedad (slo lectura); toma o devuelve un valor nodeType, donde 1 es un elemento XML y 3 es un nodo de texto.
Vase tambin

XML.nodeValue

492

XML.nodeValue
Disponibilidad

Flash Player 5.
Sintaxis

myXML.nodeValue
Descripcin

Propiedad; devuelve el 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 (el tipo de nodo es 1), nodeValue tendr el valor null y ser de slo lectura.
Vase tambin

XML.nodeType

XML.onData
Disponibilidad

Flash Player 5
Sintaxis

myXML.onData()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando el texto XML se ha descargado completamente del servidor o cuando se produce un error al descargar texto XML de un servidor. Este controlador se invoca antes de que se analice el texto XML y, por lo tanto, puede utilizarse para llamar a una rutina de anlisis en lugar de utilizar el analizador de XML de Flash. El mtodo XML.onData devuelve el valor undefined o bien una cadena que contiene texto XML descargado de un servidor. Si el valor devuelto es undefined, significa que se ha producido un error al descargar el texto XML del servidor. De forma predeterminada, el mtodo XML.onData invoca el mtodo XML.onLoad. Puede sustituir el mtodo XML.onData por el comportamiento que desee, pero ya no se llamar al mtodo XML.onLoad a menos que lo haga en su implementacin de XML.onData.
Ejemplo

En el ejemplo siguiente se muestra el aspecto que tiene el mtodo onData de forma predeterminada:
XML.prototype.onData = function (src) { if (src == undefined) { this.onLoad(false); } else { this.parseXML(src); this.loaded = true; this.onLoad(true); } }

El mtodo XML.onData puede sustituirse para interceptar el texto XML sin analizarlo.

493

XML.onLoad
Disponibilidad

Flash Player 5.
Sintaxis

myXML.onLoad(correcto)
Parmetros

correcto

Valor booleano que indica si el objeto XML se ha cargado correctamente con una operacin XML.load o XML.sendAndLoad.

Valor devuelto

Ninguno.
Descripcin

Mtodo; invocado por Flash Player cuando se recibe del servidor un documento XML. Si el documento XML se recibe correctamente, el parmetro correcto tiene el valor true. Si el documento no se ha recibido o se ha producido un error al recibir la respuesta del servidor, el parmetro correcto es false. La implementacin predeterminada de este mtodo no est activa. Para sustituir la implementacin predeterminada, debe asignar una funcin que contenga las acciones que desea.
Ejemplo

En el ejemplo siguiente se crea una pelcula de Flash sencilla para una aplicacin de escaparate de tienda de comercio electrnico sencilla. El mtodo sendAndLoad transmite un elemento XML que contiene el nombre y la contrasea del usuario e instala un controlador onLoad para controlar la respuesta del servidor.
function myOnLoad(success) { if (success) { if (e.firstChild.nodeName == "LOGINREPLY" && e.firstChild.attributes.status == "OK") { gotoAndPlay("loggedIn") } else { gotoAndStop("loginFailed") } } else { gotoAndStop("connectionFailed") } } var myLoginReply = new XML(); myLoginReply.onLoad = myOnLoad; myXML.sendAndLoad("http://www.samplestore.com/login.cgi", myLoginReply);
Vase tambin

function, XML.load, XML.sendAndLoad

494

XML.parentNode
Disponibilidad

Flash Player 5.
Sintaxis

myXML.parentNode
Descripcin

Propiedad (slo lectura); hace referencia al nodo principal del objeto XML especificado o devuelve el valor null si el nodo no tiene nodo principal. Esta es una propiedad de slo lectura y no puede utilizarse para manipular nodos secundarios; utilice los mtodos appendChild, insertBefore y removeNode para manipular nodos secundarios.

XML.parseXML
Disponibilidad

Flash Player 5.
Sintaxis

myXML.parseXML(origen)
Parmetros

origen

El texto XML debe analizarse y pasarse al objeto XML especificado.

Valor devuelto

Ninguno.
Descripcin

Mtodo; analiza el texto XML especificado en el parmetro origen y rellena el objeto XML especificado con el rbol XML resultante. Se descartan cualquiera de los rboles existentes del objeto XML.

XML.previousSibling
Disponibilidad

Flash Player 5.
Sintaxis

myXML.previousSibling
Descripcin

Propiedad (slo lectura); devuelve una referencia al nodo colateral anterior de la lista de nodos secundarios del nodo principal. Devuelve el valor null si el nodo no tiene un nodo colateral anterior. Esta es una propiedad de slo lectura y no puede utilizarse para manipular nodos secundarios; utilice los mtodos appendChild, insertBefore y removeNode para manipular nodos secundarios.

495

XML.removeNode
Disponibilidad

Flash Player 5.
Sintaxis

myXML.childNodes[1].removeNode()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; elimina el objeto XML especificado de su principal. Todos los descendientes del nodo tambin se eliminan.

XML.send
Disponibilidad

Flash Player 5.
Sintaxis

myXML.send(url, [ventana])
Parmetros

url

URL de destino para el objeto XML especificado.

Ventana del navegador donde se muestran los datos devueltos por el servidor: _self especifica el fotograma actual en la ventana activa, _blank especifica una nueva ventana, _parent especifica la ventana principal del fotograma actual y _top especifica el fotograma de nivel superior en la ventana activa. Este parmetro es opcional. No especificar ningn parmetro ventana equivale a especificar _self.
ventana
Valor devuelto

Ninguno.
Descripcin

Mtodo; codifica el objeto XML especificado en un documento XML y lo enva al URL especificado mediante el mtodo POST.

496

XML.sendAndLoad
Disponibilidad

Flash Player 5.
Sintaxis

myXML.sendAndLoad(url,objetoXMLdestino)
Parmetros

url URL de destino para el objeto XML especificado. El URL debe pertenecer al mismo subdominio que el URL de donde se descarg la pelcula. objetoXMLdestino Objeto XML creado con el mtodo constructor XML que recibir la informacin devuelta del servidor.
Valor devuelto

Ninguno.
Descripcin

Mtodo; codifica el objeto XML especificado en un documento XML, lo enva al URL especificado utilizando el mtodo POST, descarga la respuesta del servidor y despus la carga en el objetoXMLdestino especificado en los parmetros. La respuesta del servidor se carga del mismo modo utilizado por el mtodo load.
Vase tambin

XML.load

XML.status
Disponibilidad

Flash Player 5.
Sintaxis

myXML.status
Descripcin

Propiedad; establece y devuelve automticamente un valor numrico que indica si se ha analizado correctamente un documento XML en un objeto XML. Se muestra la siguiente lista con los cdigos de estado numricos y una descripcin de cada uno:

0 Sin errores; el anlisis se complet correctamente. -2 Una seccin de CDATA no se finaliz correctamente. -3 La declaracin XML no se finaliz correctamente. -4 La declaracin DOCTYPE no se finaliz correctamente. -5 Un comentario no se finaliz correctamente. -6 Un elemento XML estaba mal formado. -7 Memoria insuficiente. -8 Un valor de atributo no se finaliz correctamente. -9 Una etiqueta de inicio no coincida con una etiqueta final. -10 Se ha encontrado una etiqueta final que no coincide con una etiqueta de inicio.

497

XML.toString
Disponibilidad

Flash Player 5.
Sintaxis

myXML.toString()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; comprueba el valor del objeto XML especificado, construye una representacin textual de la estructura XML que incluye el nodo principal, los nodos secundarios y los atributos, y devuelve el resultado en forma de cadena. Para objetos XML de nivel superior (los creados con el constructor), XML.toString produce la salida de la declaracin XML del documento (almacenada en XML.xmlDecl), seguida de la declaracin DOCTYPE del documento (almacenada en XML.docTypeDecl), seguida de la representacin textual de todos los nodos XML del objeto. Si XML.xmlDecl est sin definir, no se realiza la salida de declaracin XML. Si XML.docTypeDecl est sin definir, no se realiza la salida de la declaracin DOCTYPE.
Ejemplo

El cdigo siguiente es un ejemplo del mtodo XML.toString que enva <h1>prueba</h1> a la ventana Salida.
node = new XML("<h1>prueba</h1>"); trace(node.toString());
Vase tambin

XML.docTypeDecl, XML.xmlDecl

XML.xmlDecl
Disponibilidad

Flash Player 5.
Sintaxis

myXML.xmlDecl
Descripcin

Propiedad; establece y devuelve informacin sobre la declaracin XML de un documento. Una vez analizado el documento XML en un objeto XML, esta propiedad se establece en el texto de la declaracin XML del documento. Esta propiedad se establece utilizando una representacin de cadena de la declaracin XML, no un nodo de objeto XML. Si no se ha encontrado ninguna declaracin XML durante una operacin de anlisis, la propiedad se establece en undefined. XML. El mtodo toString produce la salida del contenido de XML.xmlDecl antes que cualquier otro texto del objeto XML. Si XML.xmlDecl contiene el tipo undefined, no se genera la salida de ninguna declaracin XML.

498

Ejemplo

En el ejemplo siguiente se utiliza XML.xmlDecl para establecer la declaracin de documento XML de un objeto XML.
myXML.xmlDecl = "<?xml version=\"1.0\" ?>";

A continuacin se muestra un ejemplo de declaracin XML:

<?xml version="1.0" ?>
Vase tambin

XML.docTypeDecl, XML.toString

XMLSocket (objeto)
El objeto XMLSocket implementa sockets cliente que permiten que el equipo que ejecuta Flash Player se comunique con el equipo servidor identificado por una direccin IP o un nombre de dominio. Utilizacin del objeto XMLSocket Para utilizar el objeto XMLSocket, el equipo servidor debe ejecutar un daemon que comprenda el protocolo utilizado por el objeto XMLSocket. El protocolo es el que se muestra a continuacin:

Los mensajes XML se envan por una conexin socket en flujo TCP/IP de dplex completo. Cada mensaje XML es un documento XML completo, finalizado en un byte cero. Se pueden enviar y recibir un nmero ilimitado de mensajes XML por una sola conexin
XMLSocket. El objeto XMLSocket es til para las aplicaciones cliente-servidor que requieren un estado latente bajo, como los sistemas de chat en tiempo real. Una solucin de chat basada en HTTP tradicional consulta frecuentemente al servidor y descarga los nuevos mensajes utilizando una solicitud HTTP. Por el contrario, una solucin de chat XMLSocket mantiene una conexin abierta con el servidor, lo que permite a ste enviar inmediatamente los mensajes entrantes sin una solicitud del cliente. Puede suponer un reto establecer un servidor para que se comunique con el objeto XMLSocket. Si su aplicacin no requiere interactividad en tiempo real, utilice la accin loadVariables o las funciones de conectividad de servidor XML basada en HTTP de Flash (XML.load, XML.sendAndLoad, XML.send), en lugar del objeto XMLSocket.
mewXMLSocket,

Para utilizar los mtodos del objeto XMLSocket, primero debe utilizar el constructor, para crear un nuevo objeto XMLSocket.

XMLSocket y la seguridad Debido a que el objeto XMLSocket establece y mantiene una conexin abierta con el servidor, se han puesto las restricciones siguientes al objeto XMLSocket por razones de seguridad:

El mtodo XMLSocket.connect slo puede conectarse a puertos TCP con un nmero superior
o igual a 1.024. Como consecuencia de esta restriccin, los daemons del servidor que se comunican con el objeto XMLSocket tambin deben asignarse a puertos con un nmero igual o superior a 1.024. Los puertos con nmeros inferiores a 1.024 suelen utilizarlos servicios del sistema, como FTP, Telnet y HTTP, lo que bloquea el objeto XMLSocket en estos puertos por motivos de seguridad. La restriccin de nmero de puerto limita la posibilidad de que se acceda y se usen estos recursos de modo inapropiado.

499

 El mtodo XMLSocket.connect puede conectarse solamente con equipos ubicados en el

mismo subdominio donde reside el archivo SWF (pelcula). Esta restriccin no se aplica a las pelculas que se ejecutan fuera de un disco local. Esta restriccin es idntica a las normas de seguridad de loadVariables, XML.sendAndLoad y XML.load. Resumen de los mtodos del objeto XMLSocket
Mtodo XMLSocket.close XMLSocket.connect XMLSocket.send Descripcin Cierra una conexin de socket abierta. Establece una conexin con el servidor especificado. Enva un objeto XML al servidor.

Resumen del controlador de eventos del objeto XMLSocket

Mtodo XMLSocket.onClose XMLSocket.onConnect XMLSocket.onData XMLSocket.onXML Descripcin Funcin callback invocada cuando se cierra una conexin XMLSocket. Funcin callback invocada cuando se establece una conexin XMLSocket. Funcin callback invocada cuando se descarga un mensaje XML del servidor. Funcin callback invocada cuando llega un objeto XML del servidor.

Constructor del objeto XMLSocket

Disponibilidad

Flash Player 5.
Sintaxis

new XMLSocket()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Constructor; crea un nuevo objeto XMLSocket. El objeto XMLSocket no est conectado inicialmente con ningn servidor. Debe llamar al mtodo XMLSocket.connect para conectar el objeto con un servidor.
Ejemplo

myXMLSocket = new XMLSocket();

Vase tambin

XMLSocket.connect

500

XMLSocket.close
Disponibilidad

Flash Player 5.
Sintaxis

myXMLSocket.close()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; cierra la conexin especificada por el objeto XMLSocket.

Vase tambin

XMLSocket.connect

XMLSocket.connect
Disponibilidad

Flash Player 5.
Sintaxis

myXMLSocket.connect(host, puerto)
Parmetros

host Nombre de dominio DNS calificado o direccin IP con el formato aaa.bbb.ccc.ddd. Tambin puede especificar el valor null para conectarse al servidor host en el que reside la pelcula. puerto Nmero de puerto TCP en el host utilizado para establecer una conexin. El nmero de puerto debe ser 1024 o superior.
Valor devuelto

Ninguno.
Descripcin

Mtodo; establece una conexin con el host de Internet especificado utilizando el puerto TCP indicado (debe ser 1.024 o superior) y devuelve true o false dependiendo de si la conexin se ha establecido correctamente. Si no conoce el nmero de puerto de su equipo de Internet anfitrin, pngase en contacto con su administrador de red. Si se est utilizando la conexin Flash Netscape o el control ActiveX, el host especificado en el parmetro debe tener el mismo subdominio que el host de donde se descarg la pelcula. Si se especifica el valor null para el parmetro host, el host con el que se establecer contacto ser el host en el que reside la pelcula que llama a XMLSocket.connect. Por ejemplo, si la pelcula se descarg de http://www.yoursite.com, especificar null para el parmetro host es lo mismo que introducir la direccin IP de www.yoursite.com.

501

Si XMLSocket.connect devuelve el valor true, la fase inicial del proceso de conexin se realiza correctamente; ms tarde, se invoca el mtodo XMLSocket.onConnect para determinar si la conexin final se realiz correctamente o no. Si XMLSocket.connect devuelve el valor false, significa que no se ha podido establecer la conexin.
Ejemplo

En el ejemplo siguiente se utiliza XMLSocket.connect para conectar con el host donde reside la pelcula y se utiliza trace para mostrar el valor devuelto que indica que la conexin se ha realizado correctamente o no se ha realizado.
function myOnConnect(success) { if (success) { trace ("Conexin establecida") } else { trace ("Conexin no establecida") } } socket = new XMLSocket() socket.onConnect = myOnConnect if (!socket.connect(null, 2000)) { trace ("Conexin no establecida") }
Vase tambin

function, XMLSocket.onConnect

XMLSocket.onClose
Disponibilidad

Flash Player 5.
Sintaxis

myXMLSocket.onClose()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Mtodo; una funcin callback que se invoca solamente cuando el servidor cierra una conexin abierta. La implementacin predeterminada de este mtodo no realiza acciones. Para sustituir la implementacin predeterminada, debe asignar una funcin que contenga las acciones que desea.
Vase tambin

function, XMLSocket.onConnect

502

XMLSocket.onConnect
Disponibilidad

Flash Player 5.
Sintaxis

myXMLSocket.onConnect(correcto)
Parmetros

correcto Valor (true o false).

Valor devuelto

booleano que indica si una conexin de socket se ha establecido correctamente

Ninguno.
Descripcin

Mtodo; funcin callback que invoca Flash Player cuando una conexin cuya solicitud se ha iniciado con el mtodo XMLSocket.connect se ha realizado correctamente o no. Si la conexin se ha realizado correctamente, el parmetro correcto es true; de lo contrario, el parmetro correcto es false. La implementacin predeterminada de este mtodo no realiza acciones. Para sustituir la implementacin predeterminada, debe asignar una funcin que contenga las acciones que desea.
Ejemplo

En el ejemplo siguiente se muestra cmo especificar una funcin de sustitucin para el mtodo onConnect en una aplicacin de chat sencilla. La funcin controla a qu pantalla se lleva a los usuarios, dependiendo de si se ha establecido correctamente una conexin. Si la conexin se ha establecido correctamente, se lleva a los usuarios a la pantalla principal de chat en el fotograma con la etiqueta startChat. Si la conexin no se establece, los usuarios van a una pantalla con informacin para solucionar problemas en el fotograma con la etiqueta connectionFailed.
function myOnConnect(success) { if (success) { gotoAndPlay("startChat") } else { gotoAndStop("connectionFailed") } }

Despus de crear el objeto XMLSocket utilizando el mtodo constructor, el script instala el mtodo onConnect utilizando el operador de asignacin:
socket = new XMLSocket() socket.onConnect = myOnConnect

503

Finalmente, la conexin se inicia. Si connect devuelve el valor false, la pelcula se enva directamente al fotograma con la etiqueta connectionFailed y onConnect no se llega a invocar. Si connect devuelve el valor true, la pelcula salta al fotograma con la etiqueta waitForConnection, que es la pantalla Espere, por favor. La pelcula permanece en el fotograma waitForConnection hasta que se invoca al controlador onConnect (la velocidad depende de la latencia de la red).
if (!socket.connect(null, 2000)) { gotoAndStop("connectionFailed") } else { gotoAndStop("waitForConnection") }
Vase tambin

function, XMLSocket.connect

XMLSocket.onData
Disponibilidad

Flash Player 5.
Sintaxis

XMLSocket.onData()
Parmetros

Ninguno.
Valor devuelto

Ninguno.
Descripcin

Controlador de eventos; se invoca cuando se ha descargado un mensaje XML del servidor, terminado en un byte cero. De forma predeterminada, el mtodo XMLSocket.onData invoca el mtodo XMLSocket.onXML. Si sustituye el mtodo XMLSocket.onData por el comportamiento que desea, ya no se llamar al mtodo XMLSocket.onXML a menos que lo haga en su implementacin de XMLSocket.onData.
XMLSocket.prototype.onData = function (src) { this.onXML(new XML(src)); }

En el ejemplo anterior, el parmetro src es una cadena que contiene el texto XML descargado del servidor. El byte cero de terminacin no se incluye en la cadena.
XMLSocket.onData

puede sustituirse para interceptar el texto XML sin analizarlo.

504

XMLSocket.onXML
Disponibilidad

Flash Player 5.
Sintaxis

myXMLSocket.onXML(objeto)
Parmetro

objeto

Instancia del objeto XML que contiene un documento XML analizado recibido de un

servidor.
Valor devuelto

Ninguno.
Descripcin

Mtodo; una funcin callback invocada por Flash Player cuando el objeto XML especificado que contiene un documento XML llega por 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 0 (cero). Cuando Flash Player recibe el byte 0, analiza todos los XML recibidos desde el byte cero anterior o desde que se estableci la conexin si ste es el primer mensaje que se recibe. Cada lote de XML analizado se trata como un solo documento XML y se pasa al mtodo onXML. La implementacin predeterminada de este mtodo no realiza acciones. Para sustituir la implementacin predeterminada, debe asignar una funcin que contenga las acciones que desea.
Ejemplo

La funcin siguiente sustituye la implementacin predeterminada del mtodo onXML en una aplicacin de chat sencilla. La funcin myOnXML da instrucciones a la aplicacin de chat para que reconozca un solo elemento XML, MESSAGE, con el formato siguiente:
<MESSAGE USER="Juan" TEXT="Hola, me llamo Juan." />.

El controlador onXML debe instalarse primero en el objeto XMLSocket como se muestra a continuacin:
socket.onXML = myOnXML;

Se presupone que la funcin displayMessage es una funcin definida por el usuario que muestra el mensaje recibido por el usuario.
function myOnXML(doc) { var e = doc.firstChild; if (e != null && e.nodeName == "MESSAGE") { displayMessage(e.attributes.user, e.attributes.text); } }
Vase tambin

function

505

XMLSocket.send
Disponibilidad

Flash Player 5.
Sintaxis

myXMLSocket.send(objeto)
Parmetros

objeto

Objeto XML u otros datos que se van a transmitir al servidor.

Valor devuelto

Ninguno.
Descripcin

Mtodo; convierte el objeto XML o los datos especificados en el argumento objeto en una cadena y la transmite al servidor, seguida de un byte cero. Si objeto es un objeto XML, la cadena es la representacin textual XML del objeto XML. La operacin de envo es asncrona, vuelve inmediatamente, pero los datos pueden transmitirse ms tarde. El mtodo XMLSocket.send no devuelve un valor que indica si los datos se han transmitido correctamente. Si el objeto myXMLSocket se conecta al XMLSocket.send no se podr realizar.
Ejemplo

servidor (mediante XMLSocket.connect), la operacin

En el ejemplo siguiente se muestra como podra especificar un nombre de usuario y una contrasea para enviar el objeto myXML al servidor:
var myXML = new XML(); var myLogin = myXML.createElement("login"); myLogin.attributes.username = usernameTextField; myLogin.attributes.password = passwordTextField; myXML.appendChild(myLogin); myXMLSocket.send(myXML);
Vase tambin

XMLSocket.connect

506