Diccionario de ActionScript

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, diseños, títulos, palabras o
frases mencionados en esta publicación 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.
Información de terceros
La tecnología de compresión y descompresión de voz tiene licencia de Nellymoser, Inc. (www.nellymoser.com).
La tecnología de compresión y descompresión de video Sorenson™ Spark™ tiene licencia de
Sorenson Media, Inc.
Esta guía contiene vínculos a sitios Web de terceros que no están 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 guía
será a cuenta y riesgo del usuario. Macromedia proporciona estos vínculos únicamente como ayuda y su inclusión no implica que
Macromedia se haga responsable del contenido de dichos sitios Web.
Limitación de garantías de Apple
APPLE COMPUTER, INC. NO GARANTIZA, DE FORMA EXPRESA NI IMPLÍCITA, LA COMERCIABILIDAD O
IDONEIDAD PARA UN FIN DETERMINADO DEL PAQUETE DE SOFTWARE INFORMÁTICO INCLUIDO. LA
EXCLUSIÓN DE GARANTÍAS IMPLÍCITAS NO ESTÁ PERMITIDA EN ALGUNOS ESTADOS. LA RESTRICCIÓN
ANTERIOR PUEDE NO AFECTARLE. ESTA GARANTÍA LE PROPORCIONA DERECHOS LEGALES ESPECÍFICOS. PUEDE TENER OTROS DERECHOS QUE VARÍAN SEGÚN LA LEGISLACIÓN LOCAL.
Copyright © 2002 Macromedia, Inc. Todos los derechos reservados. No se permite la copia, fotocopia, reproducción,
traducción ni la conversión en formato electrónico o legible por equipos, ya sea de forma total o parcial, sin la autorización
previa por escrito de Macromedia, Inc.
Agradecimientos
Director: Erick Vera
Productor: Wayne Wieseler
Redacción: Jody Bleyle, JuLee Burdekin, Mary Burger, Dale Crawford, Marcelle Taylor
Diseño de las instrucciones: Stephanie Gowin, Barbara Nelson
Edición: Rosana Francescato, Lisa Stanziano, Anne Szabla
Producción y diseño multimedia: Aaron Begley, Benjamin Salles, Noah Zilberberg
Producción y diseño de impresión: Chris Basmajian, Caroline Branch
Localización: Michael Dominguez, Cristina Guembe, Yoshika Hedberg, Tim Hussey, Masayo "Noppe" Noda, Simone Pux, Yoko
Shindo, Yuko Yagi
Primera edición: marzo de 2002
Macromedia, Inc.
600 Townsend St.
San Francisco, CA 94103
CONTENIDO
Entrada de muestra para la mayoría de los elementos de ActionScript . . . . . . . . . . . . . . 21
Entrada de muestra para objetos y componentes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Contenido del diccionario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
–– (decremento) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
++ (incremento) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
! (NOT lógico) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
!= (desigualdad) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
!== (desigualdad estricta) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
% (módulo). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
%= (asignación de módulo). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
& (AND en modo bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
&& (AND de cortocircuito) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
&= (asignación AND en modo bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
() (paréntesis) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
– (menos) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
* (multiplicación) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
*= (asignación de multiplicación) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
, (coma). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
. (punto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
?: (condicional) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
/ (división). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
// (delimitador de comentario) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
/* (delimitador de comentario) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
/= (asignación de división). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
[] (acceso a matriz) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
^(XOR en modo bit). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
^= (asignación XOR en modo bit). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
{} (inicializador de objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
| (OR en modo bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
|| (OR lógico) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
|= (asignación OR en modo bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
~ (NOT en modo bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
+ (suma) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
+= (asignación de suma) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
< (menor que) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
<< (desplazamiento a la izquierda en modo bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
<<= (desplazamiento a la izquierda en modo bit y asignación) . . . . . . . . . . . . . . . . . . . . 67
<= (menor o igual que) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
3
<> (desigualdad) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
= (asignación) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
-= (asignación 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 asignación) . . . . . . . . . . . . . . . . . . . . . 75
>>> (desplazamiento a la derecha en modo bit sin signo). . . . . . . . . . . . . . . . . . . . . . . . 76
>>>= (desplazamiento a la derecha en modo bit sin signo y asignación) . . . . . . . . . . . . . 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 (función) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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
4
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
5
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, específico 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
6
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
7
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
8
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
9
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, específico de cadena) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
getProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
getTimer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
getURL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
getVersion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
_global . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
globalStyleFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
gotoAndPlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
gotoAndStop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
gt (mayor que, específico 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; específico 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; específico 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; específico para cadenas). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
Contenido
13
new . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
newline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
nextFrame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
nextScene . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
not . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
null . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
Number (función) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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 (función). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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 código de ejemplo del
Diccionario de ActionScript y péguelo 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 métodos. Para ver una
introducción de todas las entradas del diccionario, consulte “Contenido del diccionario” en la
página 23; las tablas de esta sección son un buen punto de partida para buscar operadores
simbólicos o métodos cuya clase de objeto o de componente no se conoce.
ActionScript sigue el estándar ECMA-262 (especificación desarrollada por la Asociación 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 estándar ECMA. Es
recomendable utilizar los nuevos elementos de Flash MX, aunque Flash Player 5 aún admite los
elementos desestimados.
Existen dos tipos de entradas en este diccionario:
• Entradas individuales para operadores, palabras clave, funciones, variables, propiedades,
métodos y sentencias.
• Entradas de objetos y de componentes que proporcionan información general acerca de los
objetos y los componentes de Flash incorporados.
Utilice esta información en las entradas de ejemplo para interpretar la estructura y las
convenciones utilizadas en estos dos tipos de entradas.
Entrada de muestra para la mayoría 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.
Título de la entrada
Todas las entradas aparecen en la lista en orden alfabético. El orden alfabético no distingue entre
mayúsculas y minúsculas, pasa por alto los signos de subrayado iniciales, etc.
21
Disponibilidad
En esta sección se indica qué versiones de Flash Player admiten el elemento. No se trata de la
versión de Flash utilizada para editar el contenido. Por ejemplo, si utiliza la herramienta de
edición de Flash MX para crear contenido para Flash Player 5, sólo puede utilizar elementos
ActionScript que están disponibles para Flash Player 5.
Sintaxis
En esta sección se proporciona la sintaxis correcta para utilizar el elemento ActionScript en el
código. La parte necesaria de la sintaxis se muestra con la fuente para código y el código que
debe proporcionar el usuario se muestra con la fuente para código en cursiva. Los corchetes
([]) indican parámetros opcionales.
Parámetros
En esta sección se describen los parámetros listados en la sintaxis.
Valor devuelto
En esta sección se identifican los valores que el elemento devuelve, si los hay.
Descripción
En esta sección se identifica el tipo de elemento (por ejemplo, operador, método, función, etc.) y,
a continuación, se describe cómo utilizarlo.
Ejemplo
En esta sección aparece un ejemplo de código que muestra cómo utilizar el elemento.
Véase también
En esta sección 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 alfabético con todos los demás elementos del diccionario. Los componentes de
Flash aparecen como FCheckBox, FComboBox, etc.
Título de la entrada
El título de la entrada proporciona el nombre del objeto. El nombre del objeto o del componente
va seguido por un párrafo que contiene información general descriptiva.
Tablas de resumen sobre métodos y propiedades
Cada entrada de objeto y componente contiene una tabla que ofrece una lista de los métodos
asociados. Si el objeto o componente tiene propiedades (a menudo constantes), estos elementos se
resumen en una tabla adicional. Todos los métodos y propiedades que aparecen en la lista de estas
tablas también 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 métodos y
propiedades, el constructor se describe en cada entrada de objeto o componente. Esta descripción
tiene todos los elementos estándar (sintaxis, descripción, etc.) de las otras entradas del diccionario.
22
Listas de métodos y propiedades
Los métodos y las propiedades de un objeto o componente aparecen en orden alfabético después
de la entrada del objeto o componente.
Contenido del diccionario
Todas las entradas del diccionario aparecen en la lista en orden alfabético. Sin embargo, algunos
operadores son símbolos y se presentan en orden ASCII. Además, los métodos que están asociados
con un objeto o componente aparecen con el nombre del objeto o componente: por ejemplo, el
método abs del objeto Math aparece como Math.abs y el método 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 simbólicos en el orden en el que aparecen en el diccionario. En la segunda
tabla aparecen todos los demás elementos ActionScript.
Nota: para ver la prioridad y la asociatividad de los operadores, consulte el Apéndice B, “Precedencia de
operadores y asociatividad” en la publicación “Utilización de Flash”.
Operadores simbólicos
––
–– (decremento)
++
++ (incremento)
!
! (NOT lógico)
!=
!= (desigualdad)
!==
!== (desigualdad estricta)
%
% (módulo)
%=
%= (asignación de módulo)
&
& (AND en modo bit)
&&
&& (AND de cortocircuito)
&=
&= (asignación AND en modo bit)
()
() (paréntesis)
–
– (menos)
*
* (multiplicación)
*=
*= (asignación de multiplicación)
,
, (coma)
.
. (punto)
?:
?: (condicional)
/
/ (división)
//
// (delimitador de comentario)
/*
/* (delimitador de comentario)
/=
/= (asignación de división)
[]
[] (acceso a matriz)
^
^(XOR en modo bit)
Diccionario de ActionScript
23
Operadores simbólicos
^=
^= (asignación XOR en modo bit)
{}
{} (inicializador de objeto)
|
| (OR en modo bit)
||
|| (OR lógico)
|=
|= (asignación OR en modo bit)
~
~ (NOT en modo bit)
+
+ (suma)
+=
+= (asignación de suma)
<
< (menor que)
<<
<< (desplazamiento a la izquierda en modo bit)
<<=
<<= (desplazamiento a la izquierda en modo bit y asignación)
<=
<= (menor o igual que)
<>
<> (desigualdad)
=
= (asignación)
-=
-= (asignación 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 asignación)
>>>
>>> (desplazamiento a la derecha en modo bit sin signo)
>>>=
>>>= (desplazamiento a la derecha en modo bit sin signo y
asignación)
En la tabla siguiente se muestra una lista de todos los elementos de ActionScript que no son
operadores simbólicos.
24
Elemento de ActionScript
Véase la entrada
abs
Math.abs
acos
Math.acos
add
add
addItem
FComboBox.addItem, FListBox.addItem
addItemAt
FComboBox.addItemAt, FListBox.addItem
addListener
FStyleFormat.addListener, Key.addListener, Mouse.addListener,
Selection.addListener, Stage.addListener, TextField.addListener
addProperty
Object.addProperty
and
and
Elemento de ActionScript
Véase la entrada
align
Stage.align, TextFormat.align
_alpha
MovieClip._alpha, Button._alpha, TextField._alpha
appendChild
XML.appendChild
apply
Function.apply
applyChanges
FStyleFormat.applyChanges
Arguments
arguments (objeto)
Array
Array (objeto)
arrow
FStyleFormat.arrow
asfunction
asfunction
asin
Math.asin
atan
Math.atan
atan2
Math.atan2
attachMovie
MovieClip.attachMovie
attachSound
Sound.attachSound
attributes
XML.attributes
autosize
TextField.autoSize
background
FStyleFormat.background, TextField.background
backgroundColor
TextField.backgroundColor
backgroundDisabled
FStyleFormat.backgroundDisabled
BACKSPACE
Key.BACKSPACE
beginFill
MovieClip.beginFill
beginGradientFill
MovieClip.beginGradientFill
blockIndent
TextFormat.blockIndent
bold
TextFormat.bold
Boolean
Boolean (función), Boolean (objeto)
border
TextField.border
borderColor
TextField.borderColor
bottomScroll
TextField.bottomScroll
break
break
bullet
TextFormat.bullet
Button
Button (objeto)
call
call, Function.call
call function
call function
callee
arguments.callee
caller
arguments.caller
capabilities
System.capabilities (objeto)
Diccionario de ActionScript
25
26
Elemento de ActionScript
Véase la entrada
CAPSLOCK
Key.CAPSLOCK
case
case
ceil
Math.ceil
charAt
String.charAt
charCodeAt
String.charCodeAt
check
FStyleFormat.check
childNodes
XML.childNodes
chr
chr
clear
MovieClip.clear
clearInterval
clearInterval
cloneNode
XML.cloneNode
close
XMLSocket.close
Color
Color (objeto), TextFormat.color
concat
Array.concat, String.concat
connect
XMLSocket.connect
constructor
Array (objeto), Boolean (objeto), Color (objeto), Date
(objeto), Number (función), Object (objeto), Sound (objeto),
String (objeto), XML (objeto), XMLSocket (objeto)
contentType
LoadVars.contentType, XML.contentType
ccntinue
continue
CONTROL
Key.CONTROL
cos
Math.cos
createElement
XML.createElement
createEmptyMovieClip
MovieClip.createEmptyMovieClip
createTextField
MovieClip.createTextField
createTextNode
XML.createTextNode
_currentframe
MovieClip._currentframe
curveTo
MovieClip.curveTo
Date
Date (objeto)
darkshadow
FStyleFormat.darkshadow
default
default
delete
delete
DELETEKEY
Key.DELETEKEY
docTypeDecl
XML.docTypeDecl
do while
do while
DOWN
Key.DOWN
_droptarget
MovieClip._droptarget
Elemento de ActionScript
Véase la entrada
duplicateMovieClip
duplicateMovieClip, MovieClip.duplicateMovieClip
duration
Sound.duration
E
Math.E
#endinitclip
#endinitclip
else
else
else if
else if
embedFonts
TextField.embedFonts
enab led
Button.enabled, MovieClip.enabled
END
Key.END
endFill
MovieClip.endFill
ENTER
Key.ENTER
eq
eq (igual, específico de cadena)
escape (función)
escape
ESCAPE (constante)
Key.ESCAPE
eval
eval
evaluate
evaluate
exp
Math.exp
face
FStyleFormat.face
false
false
FCheckBox
FCheckBox (componente)
FComboBox
FListBox (componente)
firstChild
XML.firstChild
FListBox
FListBox (componente)
floor
Math.floor
focusEnabled
MovieClip.focusEnabled
_focusrect
_focusrect, Button._focusrect, TextField._focusrect,
MovieClip._focusrect
font
TextFormat.font
for
for
for..in
for..in
foregroundDisabled
FStyleFormat.foregroundDisabled
FPushButton
FPushButton (componente)
FRadioButton
FPushButton (componente)
_framesloaded
MovieClip._framesloaded
fromCharCode
String.fromCharCode
fscommand
fscommand
Diccionario de ActionScript
27
28
Elemento de ActionScript
Véase la entrada
FScrollBar
FScrollBar (componente)
FScrollPane
FScrollPane (componente)
FStyleFormat
FStyleFormat (objeto)
function
function, Function (objeto)
ge
ge (mayor o igual que, específico de cadena)
get
CustomActions.get
getAscii
Key.getAscii
getBeginIndex
Selection.getBeginIndex
getBounds
MovieClip.getBounds
getBytesLoaded
LoadVars.getBytesLoaded, MovieClip.getBytesLoaded,
Sound.getBytesLoaded, XML.getBytesLoaded
getBytesTotal
LoadVars.getBytesTotal, MovieClip.getBytesTotal,
Sound.getBytesTotal, XML.getBytesTotal
getCaretIndex
Selection.getCaretIndex
getCode
Key.getCode
getData
FRadioButton.getData
getDate
Date.getDate
getDay
Date.getDay
getDepth
Button.getDepth, MovieClip.getDepth, TextField.getDepth
getEnabled
FCheckBox.getEnabled, FComboBox.getEnabled,
FListBox.getEnabled, FPushButton.getEnabled,
FRadioButton.getEnabled, FScrollBar.getEnabled
getEndIndex
Selection.getEndIndex
getFocus
Selection.getFocus
getFontList
TextField.getFontList
getFullYear
Date.getFullYear
getHours
Date.getHours
getItemAt
FComboBox.getItemAt, FListBox.addItemAt
getLabel
FCheckBox.getLabel, FPushButton.getLabel, FRadioButton.getLabel
getLength
FComboBox.getLength, FListBox.getLength
getMilliseconds
Date.getMilliseconds
getMinutes
Date.getMinutes
getMonth
Date.getMonth
getNewTextFormet
TextField.getNewTextFormat
getPan
Sound.getPan
getPaneHeight
FScrollPane.getPaneHeight
getPaneWidth
FScrollPane.getPaneWidth
Elemento de ActionScript
Véase la entrada
getProperty
getProperty
getRowCount
FComboBox.getRowCount, FListBox.getRowCount
getRGB
Color.getRGB
getScrollContent
FScrollPane.getScrollContent
getScrollPosition
FComboBox.getScrollPosition, FListBox.getScrollPosition,
FScrollBar.getScrollPosition, FScrollPane.getScrollPosition
getSeconds
Date.getSeconds
getSelectedIndex
FComboBox.getSelectedIndex, FListBox.getSelectedIndex
getSelectedIndices
FListBox.getSelectedIndices
getSelectedItem
FComboBox.getSelectedItem, FListBox.getSelectedItem
getSelectedItems
FListBox.getSelectedItem
getSelectMultiple
FListBox.getSelectMultiple
getState
FRadioButton.getState
getTextExtent
TextFormat.getTextExtent
getTextFormat
TextField.getTextFormat
getTime
Date.getTime
getTimer
getTimer
getTimezoneOffset
Date.getTimezoneOffset
getTransform
Color.getTransform, Sound.getTransform
getURL
getURL, MovieClip.getURL
getUTCDate
Date.getUTCDate
getUTCDay
Date.getUTCDay
getUTCFullYear
Date.getUTCFullYear
getUTCHours
Date.getUTCHours
getUTCMilliseconds
Date.getUTCMilliseconds
getUTCMinutes
Date.getUTCMinutes
getUTCMonth
Date.getUTCMonth
getUTCSeconds
Date.getUTCSeconds
getValue
FCheckBox.getValue, FComboBox.getValue, FListBox.getValue,
FRadioButton.getValue
getVersion
getVersion
getVolume
Sound.getVolume
getYear
Date.getYear
_global
_global
globalStyleFormat
globalStyleFormat
globalToLocal
MovieClip.globalToLocal
goto
gotoAndPlay, gotoAndStop
Diccionario de ActionScript
29
30
Elemento de ActionScript
Véase la entrada
gotoAndPlay
gotoAndPlay, MovieClip.gotoAndPlay
gotoAndStop
gotoAndStop, MovieClip.gotoAndStop
gt
gt (mayor que, específico de cadena)
hasAccessibility
System.capabilities.hasAccessibility
hasAudio
System.capabilities.hasAudio
hasAudioEncoder
System.capabilities.hasAudioEncoder
hasMP3
System.capabilities.hasMP3
hasVideoEncoder
System.capabilities.hasVideoEncoder
hasChildNodes
XML.hasChildNodes
height
Stage.height
_height
MovieClip._height, TextField._height, Button._height
hide
Mouse.hide
highlight
FStyleFormat.highlight
highlight3D
FStyleFormat.highlight3D
_highquality
_highquality, Button._highquality, MovieClip._highquality,
TextField._highquality
hitArea
MovieClip.hitArea
hitTest
MovieClip.hitTest
HOME
Key.HOME
hscroll
TextField.hscroll
html
TextField.html
htmlText
TextField.htmlText
if
if
ifFrameLoaded
ifFrameLoaded
ignoreWhite
XML.ignoreWhite
#include
#include
indent
TextFormat.indent
indexOf
String.indexOf
#initclip
#initclip
INSERT
Key.INSERT
insertBefore
XML.insertBefore
install
CustomActions.install
instanceof
instanceof
int
int
isActive
Accessibility.isActive
isDown
Key.isDown
Elemento de ActionScript
Véase la entrada
isFinite
isFinite
isNaN
isNaN
isToggled
Key.isToggled
italic
TextFormat.italic
join
Array.join
Key
Key (objeto)
language
System.capabilities.language
lastChild
XML.lastChild
lastIndexOf
String.lastIndexOf
le
le (menor o igual que; específico para cadenas)
leading
TextFormat.leading
LEFT
Key.LEFT
leftMargin
TextFormat.leftMargin
length
arguments.length, Array.length, String.length, Sound.loadSound,
TextField.length
level
_level
lineStyle
MovieClip.lineStyle
lineTo
MovieClip.lineTo
list
CustomActions.uninstall
LN2
Math.LN2
LN10
Math.LN10
load
XML.load, LoadVars.load
loaded
XML.loaded, LoadVars.loaded
loadMovie
loadMovie, MovieClip.loadMovie
loadMovieNum
loadMovieNum
loadScrollContent
FScrollPane.loadScrollContent
loadSound
Sound.loadSound
loadVariables
loadVariables, MovieClip.loadVariables
loadVariablesNum
loadVariablesNum
LoadVars
LoadVars (objeto)
localToGlobal
MovieClip.localToGlobal
log
Math.log
LOG2E
Math.LOG2E
LOG10E
Math.LOG10E
lt
lt (menor que; específico para cadenas)
manufacturer
System.capabilities.manufacturer
Diccionario de ActionScript
31
Elemento de ActionScript
32
Véase la entrada
Math
Math (objeto)
max
Math.max
maxChars
TextField.maxChars
maxhscroll
TextField.maxhscroll
maxscroll
maxscroll, TextField.maxscroll
MAX_VALUE
Number.MAX_VALUE
mbchr
mbchr
mblength
mblength
mbord
mbord
mbsubstring
mbsubstring
method
method
min
Math.min
MIN_VALUE
Number.MIN_VALUE
Mouse
Mouse (objeto)
moveTo
MovieClip.moveTo
MovieClip
MovieClip (objeto)
multiline
TextField.multiline
_name
MovieClip._name, TextField._name, Button._name
NaN
NaN, Number.NaN
ne
ne (no igual; específico para cadenas)
NEGATIVE_INFINITY
Number.NEGATIVE_INFINITY
new (operador)
new
newline
newline
nextFrame
nextFrame, MovieClip.nextFrame
nextScene
nextScene
nextSibling
XML.nextSibling
nodeName
XML.nodeName
nodeType
XML.nodeType
nodeValue
XML.nodeValue
not
not
null
null
Number
Number (función), Number (objeto)
Object
Object (objeto)
on
on
onClipEvent
onClipEvent
onClose
XMLSocket.onClose
Elemento de ActionScript
Véase la entrada
onChanged
TextField.onChanged
onConnect
XMLSocket.onConnect
onData
XML.onData, XMLSocket.onData
onDragOut
Button.onDragOut, MovieClip.onDragOut
onDragOver
Button.onDragOver, MovieClip.onDragOver
onEnterFrame
MovieClip.onEnterFrame
onKeyDown
Button.onKeyDown, Key.onKeyDown, MovieClip.onKeyDown
onKeyUp
Button.onKeyUp, Key.onKeyUp, MovieClip.onKeyUp
onKillFocus
Button.onKillFocus, MovieClip.onKillFocus,
TextField.onKillFocus
onLoad
LoadVars.onLoad, MovieClip.onLoad, Sound.onLoad, XML.onLoad
onMouseDown
Mouse.onMouseDown, MovieClip.onMouseDown
onMouseMove
Mouse.onMouseMove, MovieClip.onMouseMove
onMouseUp
Mouse.onMouseUp, MovieClip.onMouseUp
onPress
Button.onPress, MovieClip.onPress
onRelease
Button.onRelease, MovieClip.onRelease
onReleaseOutisde
Button.onReleaseOutside, MovieClip.onReleaseOutside
onResize
Stage.onResize
onRollOut
Button.onRollOut
onRollOver
Button.onRollOver
onScroller
TextField.onScroller
onSetFocus
Button.onSetFocus, MovieClip.onSetFocus, Selection.onSetFocus,
TextField.onSetFocus
onSort
Array.pop
onSoundComplete
Sound.onSoundComplete
onUnload
MovieClip.onUnload
onXML
XMLSocket.onXML
or (OR lógico)
or
ord
ord
os
System.capabilities.os
_parent
_parent, Button._parent, MovieClip._parent, TextField._parent
parentNode
XML.parentNode
parseFloat
parseFloat
parseInt
parseInt
parseXML
XML.parseXML
password
TextField.password
PGDN
Key.PGDN
Diccionario de ActionScript
33
34
Elemento de ActionScript
Véase la entrada
PGUP
Key.PGUP
PI
Math.PI
pixelAspectRatio
System.capabilities.pixelAspectRatio
play
play, MovieClip.play
pop
Array.pop
position
Sound.position
POSITIVE_INFINITY
Number.POSITIVE_INFINITY
pow
Math.pow
prevFrame
prevFrame, MovieClip.prevFrame
previousSibling
XML.previousSibling
prevScene
prevScene
print
print
printAsBitmap
printAsBitmap
printAsBitmapNum
printAsBitmapNum
printNum
printNum
__proto__
Object.__proto__
push
Array.push
_quality
_quality, TextField._quality, Button._quality
radioDot
FStyleFormat.radioDot
random
random, Math.random
refreshPane
FScrollPane.refreshPane
registerClass
Object.registerClass
registerSkinElement
FCheckBox.registerSkinElement, FComboBox.registerSkinElement,
FListBox.registerSkinElement, FPushButton.registerSkinElement,
FRadioButton.registerSkinElement, FScrollPane.registerSkinElement
removeAll
FComboBox.removeAll, FListBox.removeAll
removeItemAt
FComboBox.removeItemAt, FListBox.removeItemAt
removeListener
FStyleFormat.removeListener, Key.removeListener,
Mouse.removeListener, Selection.removeListener,
Stage.removeListener, TextField.removeListener
removeMovieClip
removeMovieClip, MovieClip.removeMovieClip
removeNode
XML.removeNode
removeTextField
TextField.removeTextField
replaceItemAt
FComboBox.replaceItemAt, FListBox.replaceItemAt
replaceSel
TextField.replaceSel
resolutionX
Capabilities.screenResolutionX
resolutionY
Capabilities.screenResolutionY
Elemento de ActionScript
Véase la entrada
restrict
TextField.restrict
return
return
reverse
Array.reverse
RIGHT
Key.RIGHT
rightMargin
TextFormat.rightMargin
_root
_root
_rotation
MovieClip._rotation, Button._rotation, TextField._rotation
round
Math.round
scaleMode
Stage.scaleMode
screenColor
System.capabilities.screenColor
screenDPI
System.capabilities.screenDPI
screenResolution.x
System.capabilities.screenResolution.x
screenResolution.y
System.capabilities.screenResolution.y
scroll
scroll, TextField.scroll
scrollTrack
FStyleFormat.scrollTrack
selectable
TextField.selectable
selection
FStyleFormat.selection
Selection
Selection (objeto)
selectionDisabled
FStyleFormat.selectionDisabled
selectionUnfocused
FStyleFormat.selectionUnfocused
send
LoadVars.send, XML.send, XMLSocket.send
sendAndLoad
LoadVars.sendAndLoad, XML.sendAndLoad
set variable
set variable
setAutoHideScrollBar
FListBox.setAutoHideScrollBar
setChangeHandler
FCheckBox.setChangeHandler, FComboBox.setChangeHandler,
FListBox.setChangeHandler, FRadioButton.setChangeHandler,
FScrollBar.setChangeHandler
setClickHandler
FPushButton.setClickHandler
setData
FRadioButton.setData
setDataProvider
FComboBox.setDataProvider, FListBox.setDataProvider
setDate
Date.setDate
setDragContent
FScrollPane.setDragContent
setEditable
FComboBox.setEditable
setEnabled
FCheckBox.setEnabled,FComboBox.setEnabled,
FListBox.setEnabled, FPushButton.setEnabled,
FRadioButton.setEnabled, FScrollBar.setEnabled
setFocus
Selection.setFocus
Diccionario de ActionScript
35
Elemento de ActionScript
36
Véase la entrada
setFullYear
Date.setFullYear
setGroupName
FRadioButton.setGroupName
setHorizontal
FScrollBar.setHorizontal
setHours
Date.setHours
setHScroll
FScrollPane.setHScroll
setInterval
setInterval
setItemSymbol
FComboBox.setItemSymbol, FListBox.setItemSymbol
setLabel
FCheckBox.setLabel, FPushButton.setLabel, FRadioButton.setLabel
setLabelPlacement
FCheckBox.setLabelPlacement, FRadioButton.setLabelPlacement
setLargeScroll
FScrollBar.setLargeScroll
setMask
MovieClip.setMask
setMilliseconds
Date.setMilliseconds
setMinutes
Date.setMinutes
setMonth
Date.setMonth
setNewTextFormat
TextField.setNewTextFormat
setPan
Sound.setPan
setProperty
setProperty
setRGB
Color.setRGB
setRowCount
FComboBox.setRowCount, FListBox.setRowCount
setScrollContent
FScrollBar.setSize, FScrollPane.setScrollContent
setScrollPosition
FListBox.setScrollPosition, FScrollBar.setScrollPosition,
FScrollPane.setScrollPosition
setScrollProperties
FScrollBar.setScrollProperties
setScrollTarget
FScrollBar.setScrollTarget
setSeconds
Date.setSeconds
setSelectedIndex
FComboBox.setSelectedIndex, FListBox.setSelectedIndex
setSelectedIndices
FListBox.setSelectedIndices
setSelection
Selection.setSelection
setSelectMultiple
FListBox.setSelectMultiple
setSize
FCheckBox.setSize, FComboBox.setSize, FListBox.setSize,
FPushButton.setSize, FScrollBar.setSize, FScrollPane.setSize
setSmallScroll
FScrollBar.setSmallScroll
setState
FRadioButton.setState
setStyleProperty
FCheckBox.setStyleProperty, FComboBox.setStyleProperty,
FListBox.setStyleProperty, FPushButton.setStyleProperty,
FRadioButton.setStyleProperty, FScrollBar.setStyleProperty,
FScrollPane.setStyleProperty
setTextFormat
TextField.setTextFormat
Elemento de ActionScript
Véase la entrada
setTime
Date.setTime
setTransform
Color.setTransform, Sound.setTransform
setUTCDate
Date.setUTCDate
setUTCFullYear
Date.setUTCFullYear
setUTCHours
Date.setUTCHours
setUTCMilliseconds
Date.setUTCMilliseconds
setUTCMinutes
Date.setUTCMinutes
setUTCMonth
Date.setUTCMonth
setUTCSeconds
Date.setUTCSeconds
setValue
FCheckBox.setValue, FComboBox.setValue, FRadioButton.setValue
setVolume
Sound.setVolume
setVScroll
FScrollPane.setVScroll
setWidth
FListBox.setWidth
setYear
Date.setYear
shadow
FStyleFormat.shadow
shift (método)
Array.shift
SHIFT (constante)
Key.SHIFT
show
Mouse.show
sin
Math.sin
size
TextFormat.size
slice
Array.slice, String.slice
sort
Array.sort
sortItemsBy
FComboBox.sortItemsBy, FListBox.sortItemsBy
Sound
Sound (objeto)
_soundbuftime
_soundbuftime, TextField._soundbuftime, MovieClip._soundbuftime,
Button._soundbuftime
SPACE
Key.SPACE
splice
Array.splice
split
String.split
sqrt
Math.sqrt
SQRT1_2
Math.SQRT1_2
SQRT2
Math.SQRT2
start
Sound.start
startDrag
startDrag, MovieClip.startDrag
status
XML.status
stop
stop, MovieClip.stop, Sound.stop
Diccionario de ActionScript
37
38
Elemento de ActionScript
Véase la entrada
stopAllSounds
stopAllSounds
stopDrag
stopDrag, MovieClip.stopDrag
String
String (función), String (objeto)
substr
String.substring
substring
substring, String.substring
super
super
swapDepths
MovieClip.swapDepths
switch
switch
System
System (objeto)
TAB
Key.TAB
tabChildren
MovieClip.tabChildren
tabEnabled
Button.tabEnabled, TextField.tabEnabled, MovieClip.tabEnabled
tabIndex
Button.tabIndex, MovieClip.tabIndex, TextField.tabIndex
tabStops
TextFormat.tabStops
tan
Math.tan
target
TextFormat.target
_target
Button._target, MovieClip._target, TextField._target
targetPath
targetPath
tellTarget
tellTarget
text
TextField.text
textAlign
FStyleFormat.textAlign
textBold
FStyleFormat.textBold
textColor
FStyleFormat.textColor, TextField.textColor
textDisabled
FStyleFormat.textDisabled
TextField
TextField (objeto)
textFont
FStyleFormat.textFont
TextFormat
TextFormat (objeto)
textHeight
TextField.textHeight
textIndent
FStyleFormat.textIndent
textItalic
FStyleFormat.textItalic
textLeftMargin
FStyleFormat.textLeftMargin
textRightMargin
FStyleFormat.textRightMargin
textSelected
FStyleFormat.textSelected
textSize
FStyleFormat.textSize
textUnderline
FStyleFormat.textUnderline
textWidth
TextField.textWidth
Elemento de ActionScript
Véase la entrada
this
this
toggleHighQuality
toggleHighQuality
toLowerCase
String.toLowerCase
toString
Array.toString, Boolean.toString, Date.toString,
Number.toString, Object.toString, XML.toString
_totalframes
MovieClip._totalframes
toUpperCase
String.toUpperCase
trace
trace
trackAsMenu
Button.trackAsMenu, MovieClip.trackAsMenu
true
true
type
TextField.type
typeof
typeof
undefined
undefined
underline
TextFormat.underline
unescape
unescape
uninstall
CustomActions.uninstall
unloadMovie
unloadMovie, MovieClip.unloadMovie
unLoadMovieNum
unloadMovieNum
unshift
Array.unshift
unwatch
Object.unwatch
UP
Key.UP
updateAfterEvent
updateAfterEvent
url
TextFormat.url
_url
MovieClip._url, TextField._url, Button._url
useHandCursor
Button.useHandCursor, MovieClip.useHandCursor
UTC
Date.UTC
valueOf
Boolean.valueOf, Number.valueOf, Object.valueOf
var
var
variable
TextField.variable
version
System.capabilities.version
_visible
MovieClip._visible, Button._visible, TextField._visible
void
void
watch
Object.watch
while
while
width
Stage.width
_width
MovieClip._width, TextField._width, Button._width
Diccionario de ActionScript
39
Elemento de ActionScript
40
Véase la entrada
with
with
wordwrap
TextField.wordWrap
_x
Button._x, MovieClip._x, TextField._x
XML
XML (objeto)
xmlDecl
XML.xmlDecl
XMLSocket
XMLSocket (objeto)
_xmouse
Button._xmouse, MovieClip._xmouse, TextField._xmouse
_xscale
Button._xscale, MovieClip._xscale, TextField._xscale
_y
Button._y, MovieClip._y, TextField._y
_ymouse
Button._ymouse, MovieClip._ymouse, TextField._ymouse
_yscale
Button._yscale, MovieClip._yscale, TextField._yscale
–– (decremento)
Disponibilidad
Flash Player 4.
Sintaxis
––expresión
expresión––
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Operador (aritmético); operador unario de decremento previo y decremento posterior que resta 1 a
la expresión. La forma de decremento previo del operador (––expresión) resta 1 a la expresión
y devuelve el resultado. La forma de decremento posterior del operador (expresión––) resta 1 a la
expresión y devuelve el valor inicial de la expresión (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
++expresión
expresión++
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Diccionario de ActionScript
41
Descripción
Operador (aritmético); operador unario de incremento previo e incremento posterior que suma 1 a
la expresión. La expresión puede ser una variable, un elemento de una matriz o una propiedad
de un objeto. La forma de incremento previo del operador (++expresión) suma 1 a la expresión
y devuelve el resultado. La forma de incremento posterior del operador (expresión++) suma 1 a la
expresión y devuelve el valor inicial de la expresión (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 ejecución " + 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 lógico)
Disponibilidad
Flash Player 4.
42
Sintaxis
!expresión
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Operador (lógico); invierte el valor booleano de una variable o expresión. Si expresión es una
variable con el valor absoluto o convertido true, el valor de !expresión es false. Si la expresión
x && y da como resultado false, la expresión !(x && y) da como resultado true.
En las expresiones siguientes se ilustra el resultado de la utilización del operador !:
!true
devuelve false
!false
devuelve true
Ejemplo
En el ejemplo siguiente, la variable happy se establece en false. La condición if comprueba la
condición !happy y si la condición es true, la acción trace envía una cadena a la ventana Salida.
happy = false;
if (!happy) {
trace("no te preocupes, sé feliz");
}
!= (desigualdad)
Disponibilidad
Flash Player 5.
Sintaxis
expresión1 != expresión2
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Operador (desigualdad); comprueba exactamente lo contrario que el operador ==. Si expresión1
es igual a expresión2, el resultado es false. Al igual que con el operador ==, la definición de
igual depende de los tipos de datos que se comparan.
• Los números, 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
devuelve true
5 != 5
devuelve false
Diccionario de ActionScript
43
En este ejemplo se ilustra la utilización del operador != en una sentencia if.
a = "David";
b = "Tonto"
if (a != b){
trace("David no es tonto");
}
Véase también
!== (desigualdad estricta), == (igualdad), === (igualdad estricta)
!== (desigualdad estricta)
Disponibilidad
Flash Player 6.
Sintaxis
expresión1 !== expresión2
Descripción
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 conversión de
los tipos de datos. Si expresión1 es igual a expresión2 y sus tipos de datos son iguales, el
resultado es false. Al igual que con el operador ===, la definición de igual depende de los tipos
de datos que se comparen.
• Los números, cadenas y los valores booleanos se comparan por valor.
• Las variables, objetos, matrices y funciones se comparan por referencia.
Ejemplo
En el código 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
==
==
==
==
s2; // true
s3; // false
n; // true
b; // false
s1
s1
s1
s1
===
===
===
===
s2; // true
s3; // false
n; // false
b; // false
s1
s1
s1
s1
!==
!==
!==
!==
s2; // false
s3; // true
n; // true
b; // true
Véase también
!= (desigualdad), == (igualdad), === (igualdad estricta)
44
% (módulo)
Disponibilidad
Flash Player 4. En archivos de Flash 4, el operador % se expande en el archivo SWF como x int(x/y) * y; además, puede que no sea tan rápido ni preciso en las versiones posteriores de
Flash Player.
Sintaxis
expresión1 % expresión2
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Operador (aritmético); calcula el resto de expresión1 dividida por expresión2. Si cualquiera de
los parámetros de expresión no es numérico, el operador módulo intenta convertirlos en números.
La expresión puede ser un número o una cadena que se convierte en un valor numérico.
Ejemplo
A continuación, se muestra un ejemplo numérico en el que se utiliza el operador módulo (%).
trace (12 % 5);
// devuelve 2
trace (4.3 % 2.1);
// devuelve aproximadamente 0.1
%= (asignación de módulo)
Disponibilidad
Flash Player 4.
Sintaxis
expresión1 %= expresión2
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Operador (asignación compuesta aritmética); asigna a expresión1 el valor de expresión1 %
expresión2. 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
Véase también
% (módulo)
& (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
automáticamente de forma que pasen a utilizar add al abrirlos en el entorno de edición de Flash 5.
Sintaxis
expresión1 & expresión2
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Operador (en modo bit); convierte expresión1 y expresión2 en números enteros de 32 bits sin
signo y realiza una operación booleana AND en cada bit de los parámetros enteros. El resultado es
un nuevo número entero de 32 bits sin signo.
&& (AND de cortocircuito)
Disponibilidad
Flash Player 4.
Sintaxis
expresión1 && expresión2
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Operador (lógico); realiza una operación booleana en los valores de una o ambas expresiones.
Calcula el resultado de expresión1 (la expresión situada a la izquierda del operador) y devuelve
false si la expresión da como resultado false. Si expresión1 da como resultado true, el
resultado es expresión2 (la expresión situada a la derecha del operador). Si expresión2 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 puntuación del jugador alcanza los 75 puntos o más en
3 turnos o menos.
turns=2;
score=77;
winner = (turns <= 3) && (score >= 75);
if (winner) {
trace("¡Ha ganado!");
} else {
trace("¡Inténtelo de nuevo!");
}
&= (asignación AND en modo bit)
Disponibilidad
Flash Player 5.
Sintaxis
expresión1 &= expresión2
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Operador (asignación compuesta en modo bit); asigna a expresión1 el valor de expresión1 &
expresión2. 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
Véase también
& (AND en modo bit)
Diccionario de ActionScript
47
() (paréntesis)
Disponibilidad
Flash Player 4.
Sintaxis
(expresión1, expresión2);
función(parámetro1,..., parámetroN);
Parámetros
expresión1, expresión2
función
Números, cadenas, variables o texto.
Función que se va a realizar en el contenido de los paréntesis.
Serie de parámetros que deben ejecutarse antes de que los
resultados se pasen como parámetros a la función de fuera de los paréntesis.
parámetro1...parámetroN
Valor devuelto
Ninguno.
Descripción
Operador; realiza una operación de agrupación en uno o más parámetros o rodea uno o más
parámetros y los pasa como parámetros a una función fuera de los paréntesis.
Sintaxis 1: controla el orden en que se ejecutan los operadores en la expresión. Los paréntesis
prevalecen sobre el orden de precedencia normal y hacen que las expresiones que contienen se
calculen primero. Cuando los paréntesis están anidados, el contenido de los paréntesis interiores
se calcula antes que el contenido de los exteriores.
Sintaxis 2: rodea uno o más parámetros y los pasa como parámetros a la función de fuera de los
paréntesis.
Ejemplo
Sintaxis 1: en las sentencias siguientes se muestra la utilización de los paréntesis para controlar el
orden de ejecución de las expresiones. El valor de cada expresión se muestra debajo de cada línea,
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 utilización de los paréntesis con funciones.
getDate();
invoice(item, amount);
function traceParameter(param){
trace(param);
}
traceParameter(2*2);
Véase también
with
48
– (menos)
Disponibilidad
Flash Player 4.
Sintaxis
(Negación) –expresión
(Resta) expresión1 - expresión2
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Operador (aritmético); utilizado para negación o resta.
Sintaxis 1: cuando se utiliza para negar, invierte el signo de la expresión numérica.
Sintaxis 2: cuando se utiliza para restar, realiza una resta aritmética en dos expresiones numéricas,
de manera que se sustrae expresión2 de expresión1. Cuando ambas expresiones son números
enteros, la diferencia es un número entero. Cuando una o ambas expresiones son números de
coma flotante, la diferencia es un número de coma flotante.
Ejemplo
Sintaxis 1: en la sentencia siguiente se invierte el signo de la expresión 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 número de coma flotante 1,5 del número de coma
flotante 3,25.
3.25 - 1.5
El resultado es 1,75, que es un número de coma flotante.
Diccionario de ActionScript
49
* (multiplicación)
Disponibilidad
Flash Player 4.
Sintaxis
expresión1 * expresión2
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Operador (aritmético); multiplica dos expresiones numéricas. Cuando ambas expresiones son
números enteros, el producto es un número entero. Cuando una o ambas expresiones son
números de coma flotante, el producto es un número 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 números de coma flotante 2,0 y 3,1416:
2.0 * 3.1416
El resultado es 6,2832, que es un número de coma flotante.
*= (asignación de multiplicación)
Disponibilidad
Flash Player 4.
Sintaxis
expresión1 *= expresión2
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Operador (asignación compuesta aritmética); asigna a expresión1 el valor de expresión1 *
expresión2. 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 líneas 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
Véase también
* (multiplicación)
, (coma)
Disponibilidad
Flash Player 4.
Sintaxis
expresión1, expresión2
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Operador; calcula el resultado de expresión1, después, el de expresión2 y devuelve el valor de
expresión2. Este operador se utiliza principalmente con la sentencia de bucle for.
Ejemplo
El siguiente código de ejemplo utiliza el operador coma:
var a=1, b=2, c=3;
Esto equivale a escribir el código siguiente:
var a=1;
var b=2;
var c=3;
Diccionario de ActionScript
51
. (punto)
Disponibilidad
Flash Player 4.
Sintaxis
objeto.propiedad_o_método
nombre_instancia.variable
nombre_instancia.instancia_secundaria.variable
Parámetros
objeto Instancia de un objeto. El objeto puede ser cualquiera de los objetos incorporados de
ActionScript o un objeto personalizado. Este parámetro siempre se encuentra a la izquierda del
operador punto (.).
propiedad_o_método Nombre de una propiedad o método asociado con un objeto. Todos los
métodos y propiedades válidos de los objetos incorporados se listan en las tablas de resumen de métodos
y propiedades de ese objeto. Este parámetro siempre se encuentra a la derecha del operador punto (.).
nombre_instancia
Nombre de instancia de un clip de película.
instancia_secundaria
Instancia de clip de película que depende de otro clip de película o
que está anidado en éste.
Variable de la línea de tiempo del nombre de instancia de clip de película situado a la
izquierda del operador (.).
variable
Valor devuelto
Ninguno.
Descripción
Operador; se utiliza para desplazarse por las jerarquías de clips de película a fin de acceder a clips de
película anidados, a variables o a propiedades. El operador punto también se utiliza para comprobar o
establecer las propiedades de un objeto, ejecutar un método 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 película
person.
person.hairColor
Esto es equivalente a la sintaxis de Flash 4 que se muestra a continuación:
/person:hairColor
Ejemplo
En el código 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";
Véase también
[] (acceso a matriz)
52
?: (condicional)
Disponibilidad
Flash Player 4.
Sintaxis
expresión1 ? expresión2
: expresión3
Parámetros
expresión1 Expresión que da como resultado un valor booleano, normalmente una expresión
de comparación, como x < 5.
expresión2, expresión3
Valores de cualquier tipo.
Valor devuelto
Ninguno.
Descripción
Operador; ordena a Flash que calcule el resultado de expresión1 y, si el valor de expresión1 es
true, devuelve el valor de expresión2; en caso contrario, devuelve el valor de expresión3.
Ejemplo
En la sentencia siguiente se asigna el valor de la variable x a la variable z porque expresión1 da
como resultado true:
x = 5;
y = 10;
z = (x < 6) ? x: y;
trace (z);
// devuelve 5
/ (división)
Disponibilidad
Flash Player 4.
Sintaxis
expresión1 / expresión2
Parámetros
expresión
Número o variable que da como resultado un número.
Valor devuelto
Ninguno.
Descripción
Operador (aritmético); divide la expresión1 por la expresión2. El resultado de la operación de
división es un número de coma flotante de doble precisión.
Ejemplo
En la sentencia siguiente se divide el número de coma flotante 22,0 por 7,0 y, a continuación, se
muestra el resultado en la ventana Salida:
trace(22.0 / 7.0);
El resultado es 3,1429, que es un número de coma flotante.
Diccionario de ActionScript
53
// (delimitador de comentario)
Disponibilidad
Flash 1.
Sintaxis
// comentario
Parámetros
comentario
Cualquier carácter.
Valor devuelto
Ninguno.
Descripción
Comentario; indica el comienzo de un comentario de script. Cualquier carácter que aparezca
entre el delimitador de comentario // y el carácter de final de línea se interpreta como un
comentario y el intérprete de ActionScript lo pasa por alto.
Ejemplo
En este script se utilizan delimitadores de comentario para identificar la primera, la tercera y la
séptima línea como comentarios.
// registra la posición
ballX = ball._x;
// registra la posición
ballY = ball._y;
// registra la posición
batX = bat._x;
// registra la posición
batY = bat._y;
X del clip de película ball
Y del clip de película ball
X del clip de película bat
Y del clip de película bat
Véase también
/* (delimitador de comentario)
/* (delimitador de comentario)
Disponibilidad
Flash Player 5.
Sintaxis
/* comentario */
/*
comentario
comentario
*/
Parámetros
comentario
Cualquier carácter.
Valor devuelto
Ninguno.
54
Descripción
Comentario; indica una o más líneas de comentarios del script. Cualquier carácter que aparezca
entre la etiqueta de apertura de comentario /* y la etiqueta de cierre de comentario */ se
interpreta como un comentario y el intérprete de ActionScript lo pasa por alto. Utilice el primer
tipo de sintaxis para identificar comentarios de una sola línea. Utilice el segundo tipo de sintaxis
para identificar comentarios en varias líneas 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 película de
ball y bat
*/
ballX = ball._x;
ballY = ball._y;
batX = bat._x;
batY = bat._y;
Véase también
// (delimitador de comentario)
/= (asignación de división)
Disponibilidad
Flash Player 4.
Sintaxis
expresión1 /= expresión2
Parámetros
expresión1,expresión2
Número o variable que da como resultado un número.
Valor devuelto
Ninguno.
Descripción
Operador (asignación compuesta aritmética); asigna a expresión1 el valor de expresión1 /
expresión2. Por ejemplo, las dos sentencias siguientes son iguales:
x /= y
x = x / y
Ejemplo
A continuación se muestra la utilización del operador /= con variables y números:
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”];
Parámetros
myArray
Nombre de una matriz.
a0, a1,...aN
Elementos de una matriz.
myMultiDimensionalArray
E
Nombre de una matriz multidimensional simulada.
Número (o índice) de un elemento de una matriz.
objeto
Nombre de un objeto.
valor Cadena o expresión que da como resultado una cadena con el nombre de una propiedad
del objeto.
Valor devuelto
Ninguno.
Descripción
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 dinámicamente nombres de instancias, variables y objetos.
También permite acceder a propiedades de objetos.
Sintaxis 1: una matriz es un objeto cuyas propiedades se denominan elementos, que se identifican
individualmente mediante un número 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 número y los dos segundos son cadenas (entre comillas).
employee = [15, “Begoña”, “Enrique”];
Sintaxis 2: puede anidar corchetes para simular matrices multidimensionales. En el código
siguiente se crea una matriz denominada ticTacToe con tres elementos; cada elemento también
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 película 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 línea de código siguiente el número 6 se envía 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 función eval para establecer y
recuperar de forma dinámica 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 código se muestran dos maneras diferentes de crear un
nuevo objeto Array vacío; en la primera línea 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
acción trace para enviar elementos a la ventana Salida. En la cuarta línea, se cambia un elemento
de la matriz y la línea quinta envía la matriz recién modificada a la ventana Salida:
employee=["Begoña", "Jorge", "María"];
trace(employee);
// Begoña, Jorge, María
employee[2]="José";
trace(employee);
// Begoña, Jorge, José
Sintaxis 3: en el ejemplo siguiente, se calcula el resultado de la expresión entre corchetes ("piece"
+ i) y el resultado se utiliza como nombre de la variable que debe recuperarse del clip de película
mc. En este ejemplo, la variable i debe pertenecer a la misma línea de tiempo que el botón. Si, por
ejemplo, la variable i es igual a 5, el valor de la variable piece5 del clip de película mc se
visualizará en la ventana Salida:
on(release){
x = mc["piece"+i];
trace(x);
}
Sintaxis 3: en el código que se muestra a continuación, se calcula el resultado de la expresión entre
corchetes y éste se utiliza como nombre de la variable que se va a recuperar del clip de película name:
group["A" + i];
Diccionario de ActionScript
57
Si está familiarizado con la sintaxis de barras de ActionScript de Flash 4, puede utilizar la función
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
asignación para establecer dinámicamente nombres de instancias, variables y objetos:
name[index] = "Alberto";
Véase también
Array (objeto), Object (objeto), eval
^(XOR en modo bit)
Disponibilidad
Flash Player 5.
Sintaxis
expresión1 ^ expresión2
Parámetros
expresión1,expresión2
Número.
Valor devuelto
Ninguno.
Descripción
Operador (en modo bit); convierte expresión1 y expresión2 en números enteros de 32 bits sin
signo y devuelve un 1 en cada posición de bit donde los bits correspondientes de expresión1 o de
expresión2, 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)
^= (asignación XOR en modo bit)
Disponibilidad
Flash Player 5.
Sintaxis
expresión1 ^= expresión2
Parámetros
expresión1,expresión2
Valor devuelto
Ninguno.
58
Enteros y variables.
Descripción
Operador (asignación compuesta en modo bit); asigna a expresión1 el valor de expresión1 ^
expresión2. Por ejemplo, las dos sentencias siguientes son iguales:
x ^= y
x = x ^ y
Ejemplo
A continuación se muestra un ejemplo de una operación ^=.
// decimal
x = 15;
// decimal
y = 9;
trace(x ^=
//devuelve
15 = binario 1111
9 = binario 1001
y);
el decimal 6 (= binario 0110)
Véase también
^(XOR en modo bit)
{} (inicializador de objeto)
Disponibilidad
Flash Player 5.
Sintaxis
objeto = {nombre1: valor1, nombre2: valor2,...nombreN: valorN};
Parámetros
objeto
Objeto que debe crearse.
nombre1,2,...N
valor1,2,...N
Nombres de las propiedades.
Valores correspondientes para cada propiedad de nombre.
Valor devuelto
Ninguno.
Descripción
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 asignación. El prototipo del objeto recién creado se
denomina genéricamente objeto Object.
Ejemplo
En la primera línea del código siguiente se crea un objeto vacío con el operador de inicializador y
en la segunda línea se crea un nuevo objeto con una función 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 información 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';
Véase también
[] (acceso a matriz), new,
Object (objeto)
| (OR en modo bit)
Disponibilidad
Flash Player 5.
Sintaxis
expresión1 | expresión2
Parámetros
expresión1,expresión2
Número.
Valor devuelto
Ninguno.
Descripción
Operador (en modo bit); convierte expresión1 y expresión2 en números enteros de 32 bits sin
signo y devuelve un 1 en cada posición de bit donde los bits correspondientes de expresión1 o
expresión2 son 1.
Ejemplo
A continuación se muestra un ejemplo de una operación 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 lógico)
Disponibilidad
Flash Player 4.
Sintaxis
expresión1 || expresión2
Parámetros
expresión1,expresión2
Valor booleano o expresión que se convierte en un valor booleano.
Valor devuelto
Ninguno.
Descripción
Operador (lógico); calcula el resultado de expresión1 y expresión2. El resultado es true si una
o las dos expresiones dan como resultado true; el resultado es false sólo si las dos expresiones
dan como resultado false. Puede utilizar el operador OR lógico con cualquier número de
operandos; si algún operando da como resultado true, el resultado es true.
Con expresiones no booleanas, el operador lógico OR hace que Flash calcule el resultado de la
expresión situada a la izquierda; si puede convertirse en true, el resultado es true. En caso
contrario, calcula el valor de la expresión de la derecha y el resultado es el valor de dicha expresión.
Ejemplo
En el ejemplo siguiente se utiliza el operador || en una sentencia if. La segunda expresión 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 lógico');
}
Ejemplo
En este ejemplo se demuestra como una expresión no booleana puede generar un resultado
inesperado. Si la expresión situada a la izquierda se convierte en true, ese resultado se devuelve sin
convertir la expresión 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 envía a la ventana Salida:
// se ha llamado a fx1
// Se ha entrado en la sentencia IF
Diccionario de ActionScript
61
|= (asignación OR en modo bit)
Disponibilidad
Flash Player 5.
Sintaxis
expresión1 |= expresión2
Parámetros
expresión1,expresión2
Número o variable.
Valor devuelto
Ninguno.
Descripción
Operador (asignación compuesta en modo bit); asigna a expresión1 el valor de expresión1 |
expresión2. 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)
Véase también
| (OR en modo bit)
~ (NOT en modo bit)
Disponibilidad
Flash Player 5.
Sintaxis
~ expresión
Parámetros
expresión
Número.
Valor devuelto
Ninguno.
Descripción
Operador (en modo bit); convierte la expresión en un número entero de 32 bits sin signo y,
después, invierte los bits. Una operación NOT en modo bit cambia el signo de un número y le
resta 1.
62
Ejemplo
En el ejemplo siguiente se muestra una operación 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 numérico o un concatenador de cadenas
en función del tipo de datos del parámetro. En Flash 4, + sólo es un operador numérico. Los archivos
de Flash 4 que se abren en un entorno de edición de Flash 5 sufren un proceso de conversión para
mantener la integridad de los tipos de datos. A continuación se muestra un ejemplo de conversión de
un archivo de Flash 4 que contiene una comparación de calidad numérica:
Archivo de Flash 4:
x + y
Archivo de Flash 5 convertido:
Number(x) + Number(y)
Sintaxis
expresión1 + expresión2
Parámetros
expresión1,expresión2
Número o cadena.
Valor devuelto
Ninguno.
Descripción
Operador; agrega expresiones numéricas o concatena (combina) cadenas. Si una expresión es una
cadena, todas las demás expresiones se convierten en cadenas y se concatenan.
Si ambas expresiones son números enteros, la suma es un número entero; si cualquiera de ellas o
ambas expresiones son números de coma flotante, la suma es un número de coma flotante.
Ejemplo
En el ejemplo siguiente se concatenan dos cadenas y se muestra el resultado en la ventana Salida.
name = "Carlos";
instrument = "batería";
trace (name + " toca " + instrument);
Diccionario de ActionScript
63
Ejemplo
Las variables asociadas con campos de texto dinámico y de introducción de texto tienen el tipo de
datos String. En el ejemplo siguiente, la variable deposit es un campo de introducción de texto
del escenario. Cuando un usuario introduce un depósito, 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 acción trace envía el
valor 4751345,23 a la ventana Salida.
Para corregirlo, utilice la función Number para convertir la cadena en un número, como se
muestra a continuación:
currentBalance = Number(deposit) + oldBalance;
Ejemplo
En esta sentencia se agregan los números enteros 2 y 3 y se muestra el número entero 5 resultante
en la ventana Salida:
trace (2 + 3);
En esta sentencia se agregan los números de coma flotante 2,5 y 3,25 y se muestra el resultado,
5,75, también un número de coma flotante, en la ventana Salida:
trace (2.5 + 3.25);
Véase también
add
+= (asignación de suma)
Disponibilidad
Flash Player 4.
Sintaxis
expresión1 += expresión2
Parámetros
expresión1,expresión2
Número o cadena.
Valor devuelto
Ninguno.
Descripción
Operador (asignación compuesta aritmética); asigna a expresión1 el valor de expresión1 +
Por ejemplo, las dos sentencias siguientes tienen el mismo resultado:
expresión2.
x += y;
x = x + y;
Este operador también realiza la concatenación de cadenas. Todas las reglas del operador de suma
(+) se aplican al operador de asignación de suma (+=).
64
Ejemplo
En el ejemplo siguiente se muestra una utilización numérica del operador +=.
x = 5;
y = 10;
x += y;
trace(x);
//x devuelve 15
En este ejemplo se utiliza el operador += con una expresión de cadena y se envía "Me llamo
Gerardo" a la ventana Salida.
x = "Me llamo "
x += "Gerardo"
trace (x)
Véase también
+ (suma)
< (menor que)
Disponibilidad
Flash Player 4; Flash Player 5. En Flash 5, el operador < (menor que) es un operador de
comparación que puede manejar diversos tipos de datos. En Flash 4, < es un operador numérico.
Los archivos de Flash 4 que se abren en un entorno de edición de Flash 5 sufren un proceso de
conversión para mantener la integridad de los tipos de datos. A continuación se muestra un
ejemplo de conversión de un archivo de Flash 4 que contiene una comparación numérica.
Archivo de Flash 4:
x < y
Archivo de Flash 5 convertido:
Number(x) < Number(y)
Sintaxis
expresión1 < expresión2
Parámetros
expresión1,expresión2
Número o cadena.
Descripción
Operador (comparación); compara dos expresiones y determina si expresión1 es menor que
expresión2; si es así, el operador devuelve true. Si expresión1 es mayor o igual que
expresión2, el operador devuelve false. Las expresiones de cadena se comparan en orden
alfabético; las letras mayúsculas van antes que las minúsculas.
Diccionario de ActionScript
65
Ejemplo
En los ejemplos siguientes se muestra cómo se devuelven true y false tanto para comparaciones
numéricas como de cadenas.
3 < 10;
// true
10 < 3;
// false
"Arturo" < "Jaime";
// true
"Jaime" < "Arturo";
// false
"11" < "3";
//true
"11" < 3;
// comparación numérica
// false
"C" < "abc";
// false
"A" < "a";
// true
<< (desplazamiento a la izquierda en modo bit)
Disponibilidad
Flash Player 5.
Sintaxis
expresión1 << expresión2
Parámetros
expresión1
Número o expresión que se va a desplazar a la izquierda.
expresión2
Número o expresión que se convierte en un entero entre 0 y 31.
Valor devuelto
Ninguno.
Descripción
Operador (en modo bit); convierte expresión1 y expresión2 en números enteros de 32 bits y
desplaza todos los bits de expresión1 hacia la izquierda el número de espacios especificado por el
número entero resultante de la conversión de expresión2. Las posiciones de bits que se han
vaciado como resultado de esta operación se rellenan con 0. Desplazar un valor una posición 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 operación 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 operación 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.
Véase también
>>= (desplazamiento a la derecha en modo bit y asignación), >> (desplazamiento a
la derecha en modo bit), <<= (desplazamiento a la izquierda en modo bit y
asignación)
<<= (desplazamiento a la izquierda en modo bit y asignación)
Disponibilidad
Flash Player 5.
Sintaxis
expresión1 <<= expresión2
Parámetros
expresión1
Número o expresión que se va a desplazar a la izquierda.
expresión2
Número o expresión que se convierte en un entero entre 0 y 31.
Valor devuelto
Ninguno.
Descripción
Operador (asignación compuesta en modo bit); este operador realiza una operación de
desplazamiento a la izquierda en modo bit y almacena el contenido como resultado en
expresión1. Las dos expresiones siguientes son equivalentes.
A <<= B
A = (A << B)
Véase también
<< (desplazamiento a la izquierda en modo bit), >>= (desplazamiento a la derecha
en modo bit y asignación), >> (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
expresión1 <= expresión2
Diccionario de ActionScript
67
Parámetros
expresión1,expresión2
Número o cadena.
Valor devuelto
Ninguno.
Descripción
Operador (comparación); compara dos expresiones y determina si expresión1 es menor o igual
que expresión2; si lo es, el operador devuelve true. Si expresión1 es mayor que expresión2,
el operador devuelve false. Las expresiones de cadena se comparan en orden alfabético; las letras
mayúsculas van antes que las minúsculas.
En Flash 5, el operador menor o igual que (<=) es un operador de comparación que puede manejar
varios tipos de datos. En Flash 4, <= sólo es un operador numérico. Los archivos de Flash 4 que se
abren en un entorno de edición de Flash 5 sufren un proceso de conversión para mantener la
integridad de los tipos de datos. A continuación se muestra un ejemplo de conversión de un archivo
de Flash 4 que contiene una comparación numérica.
Ejemplo
En los ejemplos siguientes se muestran casos de true y false tanto para comparaciones
numéricas como de cadenas:
5 <= 10;
// true
2 <= 2;
// true
10 <= 3;
// false
"Arturo" <= "Jaime";
// true
"Jaime" <= "Arturo";
// false
"11" <= "3";
//true
"11" <= 3;
// comparación numérica
// false
"C" <= "abc";
// false
"A" <= "a";
// true
68
<> (desigualdad)
Disponibilidad
Flash 2.
Sintaxis
expresión1 <> expresión2
Parámetros
expresión1,expresión2
Número, cadena, valor booleano, variable, objeto, matriz o función.
Valor devuelto
Ninguno.
Descripción
Operador (desigualdad); comprueba exactamente lo contrario que el operador ==. Si expresión1
es igual a expresión2, el resultado es false. Al igual que con el operador ==, la definición de
igual depende de los tipos de datos que se comparan.
• Los números, 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 !=.
Véase también
!= (desigualdad)
= (asignación)
Disponibilidad
Flash Player 4.
Archivo de Flash 4:
x = y
Archivo de Flash 5 convertido:
Number(x) == Number(y)
Sintaxis
expresión1 = expresión2
Parámetros
expresión1
Variable, elemento de una matriz o propiedad de un objeto.
expresión2
Valor de cualquier tipo.
Valor devuelto
Ninguno.
Descripción
Operador; asigna el tipo de expresión2 (el parámetro de la derecha) a la variable, elemento de
matriz o propiedad de expresión1.
Diccionario de ActionScript
69
En Flash 5, = es un operador de asignación y el operador == se utiliza para comprobar la igualdad.
En Flash 4, = es un operador de igualdad numérico. Los archivos de Flash 4 que se abren en un
entorno de edición de Flash 5 sufren un proceso de conversión para mantener la integridad de los
tipos de datos.
Ejemplo
En el ejemplo siguiente se utiliza el operador de asignación para asignar el tipo de datos Number a
la variable x.
x = 5
En el ejemplo siguiente se utiliza el operador de asignación para asignar el tipo de datos String a la
variable x.
x = "hola"
Véase también
== (igualdad)
-= (asignación de resta)
Disponibilidad
Flash Player 4.
Sintaxis
expresión1 -= expresión2
Parámetros
expresión1,expresión2
Número o expresión que da como resultado un número.
Valor devuelto
Ninguno.
Descripción
Operador (asignación compuesta aritmética); asigna a expresión1 el valor de expresión1 expresión2. Por ejemplo, las dos sentencias siguientes son iguales:
x -= y;
x = x - y;
Las expresiones de cadena deben convertirse en números 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 cómo las cadenas se convierten en números.
x = "5";
y = "10";
x -= y;
trace(x);
// devuelve -5
== (igualdad)
Disponibilidad
Flash Player 5.
Sintaxis
expresión1 == expresión2
Parámetros
expresión1,expresión2
Número, cadena, valor booleano, variable, objeto, matriz o función.
Valor devuelto
Ninguno.
Descripción
Operador (de igualdad); comprueba si dos expresiones son iguales. El resultado es true si las
expresiones son iguales.
La definición de igual depende del tipo de datos del parámetro:
• Los números 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 número de caracteres y los caracteres
son idénticos.
• Las variables, objetos, matrices y funciones se comparan por referencia. Dos variables son
iguales si se refieren al mismo objeto, matriz o función. Dos matrices independientes nunca se
consideran iguales, incluso aunque tengan el mismo número 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
Véase también
!= (desigualdad), === (igualdad estricta), !== (desigualdad estricta)
=== (igualdad estricta)
Disponibilidad
Flash Player 6.
Sintaxis
expresión1 === expresión2
Descripción
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 definición de igual depende del tipo de datos del parámetro:
• Los números 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 número de caracteres y los caracteres
son idénticos.
• Las variables, objetos, matrices y funciones se comparan por referencia. Dos variables son
iguales si se refieren al mismo objeto, matriz o función. Dos matrices independientes nunca se
consideran iguales, incluso aunque tengan el mismo número de elementos.
72
Ejemplo
En el código 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
==
==
==
==
s2; // true
s3; // false
n; // true
b; // false
s1
s1
s1
s1
===
===
===
===
s2; // true
s3; // false
n; // false
b; // false
s1
s1
s1
s1
!==
!==
!==
!==
s2; // false
s3; // true
n; // true
b; // true
Véase también
== (igualdad), != (desigualdad), === (igualdad estricta)
> (mayor que)
Disponibilidad
Flash Player 5.
Sintaxis
expresión1 > expresión2
Parámetros
expresión1,expresión2
Entero, número de coma flotante o cadena.
Valor devuelto
Ninguno.
Descripción
Operador (comparación); compara dos expresiones y determina si expresión1 es mayor que
expresión2 (true) o si expresión1 es menor o igual que expresión2 (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
expresión1 >= expresión2
Parámetros
expresión1, expresión2
Cadena, entero o número de coma flotante.
Valor devuelto
Ninguno.
Descripción
Operador (comparación); compara dos expresiones y determina si expresión1 es mayor o igual
que expresión2 (true) o si expresión1 es menor que expresión2 (false).
En Flash 5, mayor o igual que (>=) es un operador de comparación que puede manejar varios
tipos de datos. En Flash 4, > es un operador numérico. Los archivos de Flash 4 que se abren en un
entorno de edición de Flash 5 sufren un proceso de conversión para mantener la integridad de los
tipos de datos.
>> (desplazamiento a la derecha en modo bit)
Disponibilidad
Flash Player 5.
Sintaxis
expresión1 >> expresión2
Parámetros
expresión1
Número, cadena o expresión que se va a desplazar a la derecha.
expresión2
Número o expresión que se convierte en un entero entre 0 y 31.
Valor devuelto
Ninguno.
Descripción
Operador (en modo bit); convierte expresión1 y expresión2 en números enteros de 32 bits y
desplaza todos los bits de expresión1 hacia la derecha el número de espacios especificado por el
número entero resultante de la conversión de expresión2. Los bits que se desplazan a la derecha
se descartan. Para conservar el signo de la expresión original, los bits situados a la izquierda se
rellenan con 0 si el bit más significativo (el bit más alejado de la izquierda) de expresión1 es 0 y
se rellena con 1 si el bit más significativo es 1. Desplazar un valor a la derecha una posición es
equivalente a dividirlo entre 2 y descartar el resto.
74
Ejemplo
En el ejemplo siguiente, 65535 se convierte en un número entero de 32 bits y se desplaza ocho
bits a la derecha.
x = 65535 >> 8
El resultado de la operación anterior es el siguiente:
x = 255
Esto es debido a que 65535 decimal es igual a 1111111111111111 binario (dieciséis unos),
1111111111111111 binario desplazado a la derecha ocho bits es 11111111 binario y 11111111
binario es 255 decimal. El bit más significativo es 0 debido a que los números enteros son de 32
bits, así que el bit de relleno es 0.
En el ejemplo siguiente -1 se convierte en un número entero de 32 bits y se desplaza un bit a la derecha.
x = -1 >> 1
El resultado de la operación 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 más alejado de la
derecha) se descartará y el bit más significativo se rellenará con 1. El resultado es
11111111111111111111111111111111 (treinta y dos unos) binario, lo que representa el
número entero -1 de 32 bits.
Véase también
>>= (desplazamiento a la derecha en modo bit y asignación)
>>= (desplazamiento a la derecha en modo bit y asignación)
Disponibilidad
Flash Player 5.
Sintaxis
expresión1 =>>expresión2
Parámetros
expresión1
Número o expresión que se va a desplazar a la izquierda.
expresión2
Número o expresión que se convierte en un entero entre 0 y 31.
Valor devuelto
Ninguno.
Descripción
Operador (de asignación compuesta en modo bit); este operador realiza una operación de
desplazamiento a la derecha en modo bit y almacena el contenido como resultado en
expresión1.
Ejemplo
Las dos expresiones siguientes son equivalentes.
A >>= B
A = (A >> B)
Diccionario de ActionScript
75
En el código comentado siguiente se utiliza el operador (>>=) en modo bit. También es un
ejemplo de la utilización 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 número 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 representación binaria del número decimal
// 479
Véase también
<< (desplazamiento a la izquierda en modo bit)
>>> (desplazamiento a la derecha en modo bit sin signo)
Disponibilidad
Flash Player 5.
Sintaxis
expresión1 >>> expresión2
Parámetros
expresión1
Número, cadena o expresión que se va a desplazar a la derecha.
expresión2
Número, cadena o expresión que se convierte en un entero entre 0 y 31.
Valor devuelto
Ninguno.
Descripción
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 expresión original debido a que los bits de la
izquierda siempre se rellenan con 0.
Ejemplo
En el ejemplo siguiente -1 se convierte en un número entero de 32 bits y se desplaza un bit a la
derecha.
x = -1 >>> 1
El resultado de la operación 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
más a la derecha) se descarta y el bit más significativo (el situado más a la izquierda) se rellena con
un 0. El resultado es 01111111111111111111111111111111 binario, que representa el entero
de 32 bits 2147483647.
76
Véase también
>>= (desplazamiento a la derecha en modo bit y asignación)
>>>= (desplazamiento a la derecha en modo bit sin signo y asignación)
Disponibilidad
Flash Player 5.
Sintaxis
expresión1 >>>= expresión2
Parámetros
expresión1
Número o expresión que se va a desplazar a la izquierda.
expresión2
Número o expresión que se convierte en un entero entre 0 y 31.
Valor devuelto
Ninguno.
Descripción
Operador (de asignación compuesta en modo bit); este operador realiza una operación en modo
bit de desplazamiento a la derecha sin signo y almacena el contenido como resultado en
expresión1. Las dos expresiones siguientes son equivalentes:
A >>>= B
A = (A >>> B)
Véase también
>>> (desplazamiento a la derecha en modo bit sin signo), >>= (desplazamiento a
la derecha en modo bit y asignación)
Diccionario de ActionScript
77
Accessibility (objeto)
El objeto Accessibility es un conjunto de métodos que pueden utilizarse para crear contenido
accesible con ActionScript. En Flash MX, sólo existe un método.
Este objeto está disponible en Flash Player 6.
Resumen de los métodos del objeto Arguments
Propiedad
Descripción
Accessibility.isActive
Indica si hay activo un programa lector de pantalla.
Accessibility.isActive
Disponibilidad
Flash Player 6.
Sintaxis
Accessibility.isActive()
Parámetros
Ninguno.
Valor devuelto
Valor booleano.
Descripción
Método; indica si hay activo o no un programa lector de pantalla. Utilice este método cuando
desee que la película tenga un comportamiento diferente en presencia de un lector de pantalla.
Véase también
System.capabilities.hasAccessibility
add
Disponibilidad
Flash Player 4.
Sintaxis
cadena1 add cadena2
Parámetros
cadena1, cadena2
Valor devuelto
Ninguno.
78
Una cadena.
Descripción
Operador; concatena (combina) dos o más cadenas. El operador add sustituye al operador add (&) de
Flash 4; los archivos de Flash 4 que utilizan el operador & se convierten de forma automática a fin de
utilizar el operador add para la concatenación de cadenas cuando se abren en el entorno de edición
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.
Véase también
+ (suma)
and
Disponibilidad
Flash Player 4.
Sintaxis
condición1 and condición2
Parámetros
condición1,condición2
Condiciones o expresiones que dan como resultado true o false.
Valor devuelto
Ninguno.
Descripción
Operador; realiza una operación AND lógica en Flash Player 4. Si ambas expresiones dan como
resultado true, toda la expresión es true. Este operador se ha desestimado en Flash 5 y se
recomienda a los usuarios que utilicen el operador &&.
Véase también
&& (AND de cortocircuito)
arguments (objeto)
El objeto Arguments es una matriz que contiene los valores que se han pasado como parámetros a
cualquier función. Cada vez que se llama a una función en ActionScript, se crea de forma automática
un objeto Arguments para esa función. Se crea también 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
Descripción
arguments.callee
Hace referencia a la función a la que se está llamando.
arguments.caller
Hace referencia a la función que llama.
arguments.length
El número de parámetros pasados a una función.
Diccionario de ActionScript
79
arguments.callee
Disponibilidad
Flash Player 5.
Sintaxis
arguments.callee
Descripción
Propiedad; hace referencia a la función a la que se está llamando en este momento.
Ejemplo
Puede utilizar la propiedad arguments.callee para realizar una función anónima que es
recursiva, como se muestra a continuación:
factorial = function (x) {
if (x <= 1) {
return 1;
} else {
return x * arguments.callee(x-1);
}
};
A continuación se muestra una función 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
Descripción
Propiedad; hace referencia al objeto Arguments de la función que llama.
arguments.length
Disponibilidad
Flash Player 6.
Sintaxis
arguments.length
Descripción
Propiedad; el número de parámetros que se han pasado realmente a una función.
80
Array (objeto)
El objeto Array permite acceder a matrices y manipularlas. Una matriz es un objeto cuyas
propiedades se identifican con un número que representa su posición en la matriz. Este número 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 año.
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 métodos del objeto Array
Método
Descripción
Array.concat
Concatena los parámetros y los devuelve como una matriz nueva.
Array.join
Une todos los elementos de una matriz en una cadena.
Array.pop
Elimina el último elemento de una matriz y devuelve su valor.
Array.push
Agrega uno o más elementos al final de una matriz y devuelve la nueva longitud de la
matriz.
Array.reverse
Invierte la dirección de una matriz.
Array.shift
Elimina el primer elemento de una matriz y devuelve su valor.
Array.slice
Extrae una sección de una matriz y la devuelve como una nueva matriz.
Array.sort
Ordena una matriz.
Array.sortOn
Ordena una matriz según un campo de la matriz.
Array.splice
Agrega y/o elimina elementos de una matriz.
Array.toString
Devuelve un valor de cadena que representa los elementos del objeto Array.
Array.unshift
Agrega uno o más elementos al principio de una matriz y devuelve la nueva longitud de la
matriz.
Resumen de las propiedades del objeto Array
Propiedad
Descripción
Array.length
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)
Parámetros
Número entero que especifica el número de elementos de la matriz. En el caso de
elementos no contiguos, el parámetro longitud especifica el número de índice del último
elemento de la matriz más 1.
longitud
elemento0...elementoN Lista de dos o más valores arbitrarios. Los valores pueden ser
números, cadenas, objetos u otras matrices. El primer elemento de una matriz siempre tiene el
índice o posición 0.
Valor devuelto
Ninguno.
Descripción
Constructor; permite crear una matriz. Puede utilizar el constructor para crear diferentes tipos de
matrices: una matriz vacía, una matriz con una longitud específica pero cuyos elementos no
tienen valores, o una matriz cuyos elementos tienen valores específicos.
Sintaxis 1: si no especifica parámetros, se crea una matriz con una longitud 0.
Sintaxis 2: si sólo especifica una longitud, se crea una matriz con longitud como número de
elementos, sin valores.
Sintaxis 3: si utiliza los parámetros elemento para especificar valores, se crea una matriz con
valores específicos.
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("Begoña", "Esther", "Ana", "Laura", "Pilar");
trace(go_gos.join(" + "));
Los elementos iniciales de la matriz go_gos se identifican como se muestra a continuación:
go_gos[0]
go_gos[1]
go_gos[2]
go_gos[3]
go_gos[4]
=
=
=
=
=
"Begoña";
"Esther";
"Ana";
"Laura";
"Pilar";
En el código 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(" + "));
Véase también
Array.length, [] (acceso a matriz)
82
Array.concat
Disponibilidad
Flash Player 5.
Sintaxis
myArray.concat(valor0,valor1,...valorN)
Parámetros
valor0,...valorN
Números, elementos o cadenas que se van a concatenar en una nueva
matriz.
Valor devuelto
Ninguno.
Descripción
Método; concatena los elementos especificados en los parámetros, si los hay, con los elementos de
myArray y crea una nueva matriz. Si los parámetros 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 código 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 código 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])
Parámetros
Carácter o cadena que separa los elementos de la matriz en la cadena devuelta. Si
omite este parámetro, se utiliza la coma como separador predeterminado.
separador
Valor devuelto
Ninguno.
Descripción
Método; 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 método join.
Ejemplo
El ejemplo siguiente crea una matriz, con tres elementos. A continuación, une la matriz tres veces
(con el separador predeterminado, una coma y un espacio y un signo más) 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
Descripción
Propiedad; contiene la longitud de la matriz. Esta propiedad se actualiza automáticamente 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 número e índice+1 es mayor que la
propiedad length, la propiedad length se actualiza a índice + 1.
84
Ejemplo
En el código 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()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; elimina el último elemento de una matriz y devuelve el valor de ese elemento.
Ejemplo
En el código siguiente se crea la matriz myPets que contiene cuatro elementos y después se
elimina su último elemento.
myPets = ["gato", "perro", "pájaro", "pez"];
popped = myPets.pop();
trace(popped);
// devuelve pez
Array.push
Disponibilidad
Flash Player 5.
Sintaxis
myArray.push(valor,...)
Parámetros
valor
Uno o más valores que se anexan a la matriz.
Valor devuelto
La longitud de la nueva matriz.
Descripción
Método; agrega uno o más 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
línea se agregan dos elementos a la matriz. Después de llamar al método push, la variable pushed
contiene cuatro elementos. Puesto que el método push devuelve la nueva longitud de la matriz, la
acción trace de la última línea envía la nueva longitud de myPets (4) a la ventana Salida:
myPets = ["gato", "perro"];
pushed = myPets.push("pájaro", "pez");
trace(pushed);
Array.reverse
Disponibilidad
Flash Player 5.
Sintaxis
myArray.reverse()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; invierte la matriz.
Ejemplo
A continuación se muestra un ejemplo de la utilización del método 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()
Parámetros
Ninguno.
Valor devuelto
El primer elemento de una matriz.
Descripción
Método; elimina el primer elemento de una matriz y devuelve ese elemento.
86
Ejemplo
En el código siguiente se crea la matriz myPets y, a continuación, se elimina el primer elemento de
la matriz y se asigna a la variable shifted.
myPets = ["gato", "perro", "pájaro", "pez"];
shifted = myPets.shift();
trace(shifted);
// devuelve gato
Véase también
Array.pop
Array.slice
Disponibilidad
Flash Player 5.
Sintaxis
myArray.slice(inicio, fin)
Parámetros
Número que especifica el índice del punto de inicio de la sección. Si inicio es un
número negativo, el punto de inicio comienza al final de la matriz, donde -1 es el último elemento.
inicio
Número que especifica el índice del punto final de la sección. Si omite este parámetro, el
sector incluirá todos los elementos desde el inicio hasta el final de la matriz. Si fin es un número
negativo, el punto final se especifica desde el final de la matriz, donde -1 es el último elemento.
final
Valor devuelto
Ninguno.
Descripción
Método; 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([funciónComparación])
Parámetros
funciónComparación Función de comparación opcional que se utiliza para determinar el
orden de los elementos de una matriz. Dados los elementos A y B, el parámetro funciónOrden
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 después que B en la secuencia de ordenamiento
Diccionario de ActionScript
87
Valor devuelto
Ninguno.
Descripción
Método; ordena la matriz en contexto, sin hacer una copia. Si omite el parámetro
funciónComparación, Flash ordena los elementos en contexto utilizando el operador de
comparación <.
Ejemplo
En el ejemplo siguiente se utiliza Array.sort sin especificar el parámetro funciónComparación.
var fruits = ["naranjas", "manzanas", "fresas", "piñas", "cerezas"];
trace(fruits.join());
fruits.sort();
trace(fruits.join());
Salida:
naranjas,manzanas,fresas,piñas,cerezas
se muestra cerezas,fresas,manzanas,naranjas,piñas
En el ejemplo siguiente se utiliza Array.sort con una función de ordenación especificada.
var passwords = [
"juan:foo",
"miguel:bar",
"josé:snafu",
"enrique:yuck",
"daniel:1234"
];
function order (a, b) {
// Las entradas que deben ordenarse están en formato
// nombre:contraseña
// Se ordena sólo 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 código 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)
Parámetros
Cadena que identifica un campo de un elemento de la matriz que debe utilizarse
como valor de ordenación.
nombreCampo
Valor devuelto
Ninguno.
Descripción
Método; ordena elementos de una matriz según un campo de ésta. Si no se pasa ningún
parámetro nombreCampo, la función genera un error. Si se pasan varios parámetros nombreCampo,
el primer campo se convierte en un valor de cadena y el resto de parámetros se pasan por alto.
Si alguno de los elementos que se comparan no contiene el campo especificado en el parámetro
la ordenación utiliza de forma predeterminada el comportamiento del método
nombreCampo,
Array.sort.
Ejemplo
En el ejemplo siguiente se crea una nueva matriz y se ordena según 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
Véase también
Array.sort
Array.splice
Disponibilidad
Flash Player 5.
Sintaxis
myArray.splice(inicio, númeroEliminar, valor0,valor1...valorN)
Parámetros
inicio
Índice del elemento de la matriz donde comienza la inserción y/o el borrado.
númeroEliminar Número de elementos que se van a eliminar. Este número incluye el elemento
especificado en el parámetro inicio. Si no se especifica un valor para númeroEliminar, el
método elimina todos los valores desde el elemento inicio hasta el último elemento de la matriz.
Si el valor es 0, no se elimina ningún elemento.
Diccionario de ActionScript
89
valor Cero o más valores que se van a insertar en la matriz en el punto de inserción
especificado en el parámetro inicio. Este parámetro es opcional.
Valor devuelto
Ninguno.
Descripción
Método; agrega y elimina elementos de una matriz. Este método modifica la matriz sin hacer una
copia.
Array.toString
Disponibilidad
Flash Player 5.
Sintaxis
myArray.toString()
Parámetros
Ninguno.
Valor devuelto
Una cadena.
Descripción
Método; 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)
Parámetros
valor1,...valorN
principio de la matriz.
90
Uno o más números, elementos o variables que se deben insertar al
Valor devuelto
La nueva longitud de la matriz.
Descripción
Método; agrega uno o más elementos al principio de una matriz y devuelve la nueva longitud de
la matriz.
asfunction
Disponibilidad
Flash Player 5.
Sintaxis
asfunction:función,"parámetro"
Parámetros
función
Identificador de una función.
parámetro
Cadena que se pasa a la función a la que hace referencia el parámetro función.
Valor devuelto
Ninguno.
Descripción
Protocolo; un protocolo especial para URL en campos de texto HTML. En campos de texto
HTML, el texto puede ser un hipervínculo con una etiqueta A HTML. El atributo HREF de la
etiqueta A contiene un URL que puede ser de un protocolo estándar como HTTP, HTTPS o
FTP. El protocolo asfunction es un protocolo adicional específico de Flash que hace que el
vínculo invoque una función de ActionScript.
Ejemplo
En este ejemplo, la función MyFunc se define en las tres primeras líneas de código. La variable
textField se asocia con un campo de texto HTML. El texto "Haga clic aquí" es un hipervínculo
dentro del campo de texto. La función MyFunc se llama cuando el usuario hace clic en el hipervínculo:
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 hipervínculo, se muestra el resultado siguiente en la ventana Salida:
Ha hecho clic aquí. El argumento es Foo.
Boolean (función)
Disponibilidad
Flash Player 5.
Sintaxis
Boolean(expresión)
Parámetros
expresión
Expresión que debe convertirse en un valor booleano.
Diccionario de ActionScript
91
Valor devuelto
Ninguno.
Descripción
Función; convierte el parámetro expresión en un valor booleano y devuelve un valor de acuerdo
con lo siguiente:
• Si expresión es un valor booleano, el valor devuelto es expresión.
• Si expresión es un número, el valor devuelto es true si el número no es cero, o false si es cero.
• Si expresión es una cadena, se llama al método toNumber y el valor devuelto es true si el
número no es cero, o false si es cero.
• Si expresión no está definida, el valor devuelto es false.
• Si expresión es un clip de película 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 estándar. Utilice el objeto Boolean para recuperar el tipo de datos primitivo o la
representación 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 métodos.
Resumen de los métodos del objeto Boolean
Método
Descripción
Boolean.toString
Devuelve la representación de la cadena (true) o (false) del objeto Boolean.
Boolean.valueOf
Devuelve el tipo de valor primitivo del objeto Boolean especificado.
Constructor del objeto Boolean
Disponibilidad
Flash Player 5.
Sintaxis
new Boolean([x])
Parámetros
x
Cualquier expresión. Este parámetro es opcional.
Valor devuelto
Ninguno.
Descripción
Constructor; crea una instancia del objeto Boolean. Si omite el parámetro x, el objeto Boolean se
inicializa con el valor false. Si especifica un valor para el parámetro x, el método lo obtiene y
devuelve el resultado como un valor Boolean según las reglas de la función Boolean (función).
Nota: para mantener la compatibilidad con Flash Player 4, el manejo de cadenas por parte del objeto Boolean no
cumple el estándar ECMA-262.
92
Ejemplo
En el código siguiente se crea un nuevo objeto Boolean vacío denominado myBoolean.
myBoolean = new Boolean();
Boolean.toString
Disponibilidad
Flash Player 5.
Sintaxis
myBoolean.toString()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; devuelve la representación de la cadena, true o false del objeto Boolean.
Boolean.valueOf
Disponibilidad
Flash Player 5.
Sintaxis
Boolean.valueOf()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; devuelve el tipo de valor primitivo del objeto Boolean especificado.
break
Disponibilidad
Flash Player 4.
Sintaxis
break
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Diccionario de ActionScript
93
Descripción
Acción; 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 acción switch. La acción break da
instrucciones a Flash para que se salte el resto del cuerpo del bucle, detenga la acción del bucle y
ejecute la sentencia que sigue a la sentencia del bucle. Cuando se utiliza la acción break, el intérprete
de Flash omite el resto de las sentencias de dicho bloque case y salta a la primera sentencia que sigue
a la acción switch que la contiene. Utilice la acción break para romper una serie de bucles anidados.
Ejemplo
En el ejemplo siguiente se utiliza la acción break para salir de un bucle que, si no, es infinito.
i = 0;
while (true) {
if (i >= 100) {
break;
}
i++;
}
Véase también
for, for..in, do while, while, switch, case
Button (objeto)
Todos los símbolos de botón de una película Flash son instancias del objeto Button. Puede dar
nombre de instancia a un botón en el inspector de propiedades y utilizar los métodos y las
propiedades del objeto Button para manipular botones con ActionScript. Los nombres de
instancias de botón se muestran en el Explorador de películas y en el cuadro de diálogo 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 métodos del objeto Button
94
Método
Descripción
Button.getDepth
Devuelve la profundidad de una instancia de botón.
Resumen de las propiedades del objeto Button
Propiedad
Descripción
Button._alpha
Valor de transparencia de una instancia de botón.
Button.enabled
Indica si un botón está activo.
Button._focusrect
Indica si un botón con selección está rodeado por un rectángulo amarillo.
Button._height
Altura de una instancia de botón, en píxeles.
Button._highquality
Indica la calidad de representación de la película.
Button._name
Nombre de instancia de una instancia de botón.
Button._parent
Referencia a la instancia de clip de película de la que depende esta instancia.
Button._quality
Indica la calidad de representación de la película.
Button._rotation
Grado de rotación de una instancia de botón.
Button._soundbuftime
Número de segundos que tarda un sonido en precargarse.
Button.tabEnabled
Indica si un botón se incluye en un orden de tabulación automático.
Button.tabIndex
Indica el orden de tabulación de un objeto.
Button._target
Ruta de destino de una instancia de botón.
Button.trackAsMenu
Indica si otros botones pueden recibir eventos al soltar el ratón.
Button._url
URL del archivo SWF que ha creado la instancia de botón.
Button.useHandCursor
Indica si el cursor con forma de mano aparece cuando el ratón pasa sobre un
botón.
Button._visible
Valor booleano que determina si una instancia de botón está oculta o visible.
Button._width
Anchura de una instancia de botón, en píxeles.
Button._x
Coordenada x de una instancia de botón.
Button._xmouse
Coordenada x del cursor con relación a una instancia de botón.
Button._xscale
Valor que especifica el porcentaje de escala horizontal que se aplica a una
instancia de botón.
Button._y
Coordenada y de una instancia de botón.
Button._ymouse
Coordenada y del cursor con relación a una instancia de botón.
Button._yscale
Valor que especifica el porcentaje de escala vertical que se aplica a una instancia
de botón.
Resumen de eventos del objeto Button
En la tabla siguiente se muestra una lista de los resúmenes de eventos del objeto Button.
Método
Descripción
Button.onDragOut
Se invoca mientras el puntero se encuentra fuera del botón, se presiona el
botón del ratón y, a continuación, se desplaza fuera del área del botón.
Button.onDragOver
Se invoca mientras el puntero se encuentra sobre el botón, se ha presionado
el botón del ratón, se ha desplazado fuera del botón y ha vuelto a
desplazarse sobre el botón.
Button.onKeyUp
Se invoca cuando se suelta una tecla.
Diccionario de ActionScript
95
Método
Descripción
Button.onKillFocus
Se invoca cuando se pierde la selección de un botón.
Button.onPress
Se invoca cuando se presiona el ratón mientras el puntero está sobre un
botón.
Button.onRelease
Se invoca cuando se suelta el ratón mientras el puntero está sobre un botón.
Button.onReleaseOutside
Se invoca cuando se suelta el ratón mientras el puntero está fuera del botón
después de presionar el botón mientras el puntero está dentro del botón.
Button.onRollOut
Se invoca cuando el puntero se desplaza fuera del área de un botón.
Button.onRollOver
Se invoca cuando el puntero del ratón se desplaza sobre un botón.
Button.onSetFocus
Se invoca cuando un botón tiene la selección de entrada y se suelta una tecla.
Button._alpha
Disponibilidad
Flash Player 6.
Sintaxis
myButton._alpha
Descripción
Propiedad; define o recupera la transparencia alfa (valor) del botón especificado por Button. Los
valores válidos van de 0 (completamente transparente) a 100 (completamente opaco). Los objetos
de un botón con _alpha establecido en 0 están activos, aunque no sean visibles.
Ejemplo
En el ejemplo siguiente la propiedad _alpha de un botón denominado star se establece en 30%.
on(release) {
star._alpha = 30;
}
Button.enabled
Disponibilidad
Flash Player 6.
Sintaxis
myButton.enabled
Descripción
Propiedad; un valor booleano que especifica si un botón está activado. El valor predeterminado es
true.
Button._focusrect
Disponibilidad
Flash Player 6.
Sintaxis
myButton._focusrect
96
Descripción
Propiedad; un valor booleano que especifica si aparece un rectángulo amarillo alrededor del botón
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 número entero.
Descripción
Método; devuelve la profundidad de una instancia de botón.
Button._height
Disponibilidad
Flash Player 6.
Sintaxis
myButton._height
Descripción
Propiedad; establece y recupera la altura del botón en píxeles.
Ejemplo
En el código de ejemplo siguiente se establece la altura y la anchura de un botón cuando el usuario
hace clic con el ratón.
myButton._width = 200;
myButton._height = 200;
Button._highquality
Disponibilidad
Flash Player 6.
Sintaxis
myButton._highquality
Descripción
Propiedad (global); especifica el nivel de suavizado aplicado a la película 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 película no contiene
animación. Especifique 0 (baja calidad) para evitar el suavizado.
Ejemplo
_highquality = 1;
Diccionario de ActionScript
97
Véase también
_quality, toggleHighQuality
Button._name
Disponibilidad
Flash Player 6.
Sintaxis
myButton._name
Descripción
Propiedad; devuelve el nombre de instancia del botón especificado por myButton.
Button.onDragOut
Disponibilidad
Flash Player 6.
Sintaxis
myButton.onDragOut
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando se presiona el botón del ratón sobre el botón y, a
continuación, el puntero se desplaza fuera del botón.
Button.onDragOver
Disponibilidad
Flash Player 6.
Sintaxis
myButton.onDragOver
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando el usuario presiona y arrastra el botón del ratón fuera
del botón y, a continuación, sobre éste.
Debe definir una función que se ejecute cuando se invoque el evento.
98
Ejemplo
En el ejemplo siguiente se define una función para el método onKeyDown que envía una acción
trace a la ventana Salida:
myButton.onDragOver = function () {
trace ("se ha llamado al método onDragOver");
};
Véase también
Button.onKeyUp
Button.onKeyDown
Disponibilidad
Flash Player 6.
Sintaxis
myButton.onKeyDown
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando un botón se selecciona mediante el teclado y se
presiona una tecla. El evento onKeyDown se invoca sin parámetros. Puede utilizar los métodos
Key.getAscii y Key.getCode para determinar la tecla que se ha presionado.
Debe definir una función que se ejecute cuando se invoque el evento.
Ejemplo
En el ejemplo siguiente se define una función para el método onKeyDown que envía una acción
trace a la ventana Salida:
myButton.onKeyDown = function () {
trace ("se ha llamado al método onKeyDown");
};
Véase también
Button.onKeyUp
Button.onKeyUp
Disponibilidad
Flash Player 6.
Sintaxis
myButton.onKeyUp
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Diccionario de ActionScript
99
Descripción
Controlador de eventos; se invoca cuando un botón tiene la selección de entrada y se suelta una
tecla. El evento onKeyUp se invoca sin parámetros. Puede utilizar los métodos Key.getAscii y
Key.getCode para determinar la tecla que se ha presionado.
Debe definir una función que se ejecute cuando se invoque el evento.
Ejemplo
En el ejemplo siguiente se define una función para el método onKeyPress que envía una acción
trace a la ventana Salida:
myButton.onKeyUp = function () {
trace ("se ha llamado al método onKeyUp");
};
Button.onKillFocus
Disponibilidad
Flash Player 6.
Sintaxis
myButton.onKillFocus = function (nuevaSelección) {
sentencias;
};
Parámetros
nuevaSelección
El objeto que pasará a estar seleccionado.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; un evento que se invoca cuando un botón no se selecciona con el teclado.
El método onKillFocus recibe un parámetro, nuevaSelección, que es un objeto que representa
el nuevo objeto seleccionado. Si no hay ningún objeto seleccionado, nuevaSelección contiene el
valor null.
Button.onPress
Disponibilidad
Flash Player 6.
Sintaxis
myButton.onPress
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando se presiona un botón. Debe definir una función que se
ejecute cuando se invoque el evento.
100
Ejemplo
En el ejemplo siguiente se define una función para el método onPress que envía una acción
trace a la ventana Salida.
myButton.onPress = function () {
trace ("se ha llamado al método onPress");
};
Button.onRelease
Disponibilidad
Flash Player 6.
Sintaxis
myButton.onRelease
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando se suelta un botón.
Debe definir una función que se ejecute cuando se invoque el evento.
Ejemplo
En el ejemplo siguiente se define una función para el método onRelease que envía una acción
trace a la ventana Salida.
myButton.onRelease = function () {
trace ("se ha llamado al método onRelease");
};
Button.onReleaseOutside
Disponibilidad
Flash Player 6.
Sintaxis
myButton.onReleaseOutside
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando se suelta el ratón mientras el puntero está fuera del
botón después de que se haya presionado el botón mientras el puntero estaba dentro del botón.
Debe definir una función que se ejecute cuando se invoque el evento.
Diccionario de ActionScript
101
Ejemplo
En el ejemplo siguiente se define una función para el método onReleaseOutside que envía una
acción trace a la ventana Salida.
myButton.onReleaseOutside = function () {
trace ("se ha llamado al método onReleaseOutside");
};
Button.onRollOut
Disponibilidad
Flash Player 6.
Sintaxis
myButton.onRollOut
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando el puntero se desplaza fuera del área de un botón.
Debe definir una función que se ejecute cuando se invoque el evento.
Ejemplo
En el ejemplo siguiente se define una función para el método onRollOut que envía una acción
trace a la ventana Salida.
myButton.onRollOut = function () {
trace ("se ha llamado al método onRollOut");
};
Button.onRollOver
Disponibilidad
Flash Player 6.
Sintaxis
myButton.onRollOver
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando el puntero se desplaza sobre el área de un botón.
Debe definir una función que se ejecute cuando se invoque el evento.
102
Ejemplo
En el ejemplo siguiente se define una función para el método onRollOver que envía una acción
trace a la ventana Salida.
myButton.onRollOver = function () {
trace ("se ha llamado al método onRollOver");
};
Button.onSetFocus
Disponibilidad
Flash Player 6.
Sintaxis
myButton.onSetFocus = function(selecciónAnterior){
sentencias;
};
Parámetros
selecciónAnterior
Objeto que va a perder la selección.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando un botón se selecciona mediante el teclado. El
parámetro selecciónAnterior es el objeto que deja de estar seleccionado. Por ejemplo, si el
usuario presiona la tecla Tabulador para mover la selección de entrada de un campo de texto a un
botón, selecciónAnterior contiene la instancia de campo de texto.
Si no hay ningún objeto seleccionado anteriormente, selecciónAnterior contiene un valor null.
Button._parent
Disponibilidad
Flash Player 6.
Sintaxis
_parent.property
Descripción
Propiedad; especifica o devuelve una referencia al clip de película que contiene el objeto o el clip
de película. El objeto actual es el que contiene el código de ActionScript que hace referencia a
_parent. Utilice _parent para especificar una ruta relativa a los clips de película u objetos que
están por encima del clip de película u objeto actual. Puede utilizar _parent para subir varios
niveles en la lista de visualización, como se muestra a continuación:
_parent._parent._alpha = 20;
Véase también
_root, targetPath
Diccionario de ActionScript 103
Button._quality
Disponibilidad
Flash Player 6.
Sintaxis
myButton._quality
Descripción
Propiedad (global); establece o recupera la calidad de representación utilizada para una película.
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"
•
"HIGH" Calidad de representación alta. Los gráficos se suavizan utilizando una cuadrícula de
píxeles de 4 x 4 y los mapas de bits se suavizan si la película es estática. Ésta es la configuración
de la calidad de representación predeterminada utilizada por Flash.
•
"BEST"
Calidad de representación baja. No se suavizan ni los gráficos ni los mapas de bits.
Calidad de representación media. Los gráficos se suavizan utilizando una
cuadrícula de píxeles de 2 x 2, pero los mapas de bits no se suavizan. Apropiado para películas
que no contienen texto.
"MEDIUM"
Calidad de representación muy alta. Los gráficos se suavizan utilizando una
cuadrícula de píxeles de 4 x 4 y los mapas de bits se suavizan siempre.
Ejemplo
En el ejemplo siguiente, se define la calidad de representación en LOW:
myButton._quality = "LOW";
Véase también
_highquality, toggleHighQuality
Button._rotation
Disponibilidad
Flash Player 6.
Sintaxis
myButton._rotation
Descripción
Propiedad; especifica la rotación del botón en grados.
Button._soundbuftime
Disponibilidad
Flash Player 6.
Sintaxis
myButton._soundbuftime
104
Descripción
Propiedad (global); entero que especifica el número 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
Descripción
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 tabulación
automático. El objeto se incluye en el orden de tabulación personalizado si la propiedad tabIndex
se establece también en un valor. Si el valor de tabEnabled es false, el objeto no se incluye en el
orden de tabulación automático. En el caso de un clip de película, si tabEnabled es false, los
valores secundarios del clip de película pueden seguir incluyéndose en el orden de tabulación
automático, a menos que la propiedad tabChildren también 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 tabulación personalizado. Si tabEnabled es false, el objeto no se incluye en el
orden de tabulación personalizado, aunque se establezca la propiedad tabIndex. Si tabEnabled
se establece en false en un clip de película, los elementos secundarios del clip de película pueden
incluirse aún en el orden de tabulación personalizado.
Véase también
Button.tabIndex
Button.tabIndex
Disponibilidad
Flash Player 6.
Sintaxis
myButton.tabIndex
Descripción
Propiedad; permite personalizar el orden de tabulación de los objetos de una película. Puede
establecer la propiedad tabIndex de un botón, un clip de película o una instancia de campo de
texto; de manera predeterminada es undefined.
Si alguno de los objetos que se muestran en la película Flash contiene una propiedad tabIndex, el
orden de tabulación automático está desactivado, y el orden de tabulación se calcula a partir de las
propiedades tabIndex de los objetos de la película. El orden de tabulación personalizado sólo
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 tabulación es undefined.
Diccionario de ActionScript 105
El orden de tabulación personalizado definido por la propiedad tabIndex es flat. Esto significa
que no se tienen en cuenta las relaciones jerárquicas de los objetos de la película Flash. Todos los
objetos de la película Flash con propiedades tabIndex se colocan en el orden de tabulación, 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
Descripción
Propiedad (sólo lectura); devuelve la ruta de destino de la instancia de botón especificada en el
parámetro Button.
Button.trackAsMenu
Disponibilidad
Flash Player 6.
Sintaxis
myButton.trackAsMenu
Descripción
Propiedad; propiedad booleana que indica si los botones o los clips de película pueden recibir o
no eventos al soltar el ratón. Permite crear menús. Puede establecer la propiedad trackAsMenu en
cualquiera de los objetos de botón o de clip de película. Si la propiedad trackAsMenu no existe, el
comportamiento predeterminado es false.
Puede cambiar la propiedad trackAsMenu en cualquier momento; el botón modificado asume el
nuevo comportamiento inmediatamente.
Véase también
MovieClip.trackAsMenu
Button._url
Disponibilidad
Flash Player 6.
Sintaxis
myButton._url
Descripción
Propiedad (sólo lectura); recupera el URL del archivo SWF que ha creado el botón.
106
Button.useHandCursor
Disponibilidad
Flash Player 6.
Sintaxis
myButton.useHandCursor
Descripción
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 botón. 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 botón 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
Descripción
Propiedad; valor booleano que indica si el botón especificado por el parámetro Button está visible.
Los botones que no están visibles (propiedad _visible establecida en false) se desactivan.
Button._width
Disponibilidad
Flash Player 6.
Sintaxis
myButton._width
Descripción
Propiedad; establece y recupera la anchura del botón, en píxeles.
Ejemplo
En el ejemplo siguiente se establecen las propiedades de altura y anchura de un botón.
myButton._width=200;
myButton._height=200;
Véase también
MovieClip._width
Button._x
Disponibilidad
Flash Player 6.
Diccionario de ActionScript 107
Sintaxis
myButton._x
Descripción
Propiedad; entero que establece la coordenada x de un botón con relación a las coordenadas
locales del clip de película principal. Si un botón está en la línea de tiempo principal, su sistema de
coordenadas hace referencia a la esquina superior izquierda del escenario como (0, 0). Si el botón
se encuentra dentro de un clip de película que tiene transformaciones, el botón pertenece al
sistema de coordenadas local del clip de película que lo contiene. Por lo tanto, en el caso de un
clip de película girado 90º en sentido contrario a las agujas del reloj, el botón incluido hereda un
sistema de coordenadas girado 90° en sentido contrario a las agujas del reloj. Las coordenadas del
botón hacen referencia a la posición del punto de registro.
Véase también
Button._xscale, Button._y, Button._yscale
Button._xmouse
Disponibilidad
Flash Player 6.
Sintaxis
myButton._xmouse
Descripción
Propiedad (sólo lectura); devuelve la coordenada x de la posición del ratón con relación al botón.
Véase también
Button._ymouse
Button._xscale
Disponibilidad
Flash Player 6.
Sintaxis
myButton._xscale
Descripción
Propiedad; determina la escala horizontal (porcentaje) del botón que se aplica desde el punto de
registro del botón. 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 píxeles. Por ejemplo, si se cambia la escala del clip de película principal al 50%,
al establecer la propiedad _x se mueve un objeto del botón la mitad del número de píxeles que lo
haría si la película estuviera al 100%.
Véase también
Button._x, Button._y, Button._yscale
108
Button._y
Disponibilidad
Flash Player 6.
Sintaxis
myButton._y
Descripción
Propiedad; establece la coordenada y del botón con relación a las coordenadas locales del clip de película
principal. Si un botón está en la línea de tiempo principal, su sistema de coordenadas hace referencia a
la esquina superior izquierda del escenario como (0, 0). Si el botón se encuentra dentro de otro clip de
película que tiene transformaciones, el botón está en el sistema de coordenadas local del clip de película
que lo contiene. Por lo tanto, en el caso de un clip de película girado 90º en sentido contrario a las
agujas del reloj, el botón incluido hereda un sistema de coordenadas girado 90° en sentido contrario a
las agujas del reloj. Las coordenadas del botón hacen referencia a la posición del punto de registro.
Véase también
Button._x, Button._xscale, Button._yscale
Button._ymouse
Disponibilidad
Flash Player 6.
Sintaxis
myButton._ymouse
Descripción
Propiedad (sólo lectura); indica la coordenada y de la posición del ratón con relación al botón.
Véase también
Button._xmouse
Button._yscale
Disponibilidad
Flash Player 6.
Sintaxis
myButton._yscale
Descripción
Propiedad; establece la escala vertical (porcentaje) del botón que se aplica desde el punto de
registro del botón. El punto de registro predeterminado es (0,0).
Véase también
Button._y, Button._x, Button._xscale
Diccionario de ActionScript 109
call
Disponibilidad
Flash Player 4. Esta acción se ha desestimado en Flash 5; en su lugar, se recomienda utilizar la
acción function.
Sintaxis
call(fotograma)
Parámetros
Etiqueta o número de un fotograma en la línea de tiempo.
fotograma
Valor devuelto
Ninguno.
Descripción
Acción; ejecuta el script en el fotograma al que se ha llamado sin mover la cabeza lectora a ese
fotograma. Las variables locales no existirán cuando el script termine su ejecución.
Véase también
function
call function
Disponibilidad
Flash Player 6
Sintaxis
objeto.función([parámetros])
Parámetros
objeto
función
Objeto (puede ser un clip de película) en el que se ha definido la función.
Identificador que especifica una función definida por el usuario.
parámetros
Parámetro opcional que indica los parámetros que requiere la función.
Valor devuelto
Ninguno.
Descripción
Acción; permite utilizar campos de parámetro para llamar a una función definida por el usuario
en modo normal en el panel Acciones.
case
Disponibilidad
Flash Player 4.
Sintaxis
case expresión: sentencias
110
Parámetros
expresión
Cualquier expresión.
sentencias
Cualquier número de sentencias.
Valor devuelto
Ninguno.
Descripción
Palabra clave; define una condición para la acción switch. Las sentencias del parámetro
sentencias se ejecutan si el parámetro expresión que sigue a la palabra clave case es igual al
parámetro expresión de la acción switch utilizando la igualdad estricta (===)
Si utiliza la acción case fuera de una sentencia switch, se genera un error y el script no se
compila.
Véase también
switch, default, break, === (igualdad estricta)
chr
Disponibilidad
Flash Player 4. Esta función se ha desestimado en Flash 5; se recomienda utilizar el método
String.fromCharCode.
Sintaxis
chr(número)
Parámetros
número
Número de código ASCII.
Valor devuelto
Ninguno.
Descripción
Función de cadena; convierte los números de código ASCII en caracteres.
Ejemplo
En el ejemplo siguiente el número 65 se convierte en la letra A y se asigna a la variable myVar.
myVar = chr(65);
Véase también
String.fromCharCode
clearInterval
Disponibilidad
Flash Player 6.
Sintaxis
clearInterval( IDintervalo )
Parámetros
IDintervalo
Objeto devuelto de una llamada a la función setInterval.
Diccionario de ActionScript
111
Valor devuelto
Ninguno.
Descripción
Acción; cancela una llamada a la función setInterval.
Ejemplo
En el ejemplo siguiente se establece, en primer lugar, una llamada de intervalo y, a continuación,
se cancela:
function callback() {
trace("intervalo llamado");
}
var IDintervalo;
IDintervalo = setInterval( callback, 1000 );
// posteriormente
clearInterval( IDintervalo );
Véase también
setInterval
Color (objeto)
El objeto Color permite establecer el valor de color RGB y de transformación del color de los clips
de película 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 métodos.
El objeto Color se admite en Flash 5 y en versiones posteriores de Flash Player.
Resumen de los métodos del objeto Color
Método
Descripción
Color.getRGB
Devuelve el valor numérico RGB establecido por la última llamada setRGB.
Color.getTransform
Devuelve la información de transformación establecida por la última llamada
setTransform.
Color.setRGB
Establece la representación hexadecimal del valor RGB para un objeto Color.
Color.setTransform
Establece la transformación de color para un objeto Color.
Constructor del objeto Color
Disponibilidad
Flash Player 5.
Sintaxis
new Color(destino)
Parámetros
destino
Nombre de instancia de un clip de película.
Valor devuelto
Ninguno.
112
Descripción
Constructor; crea una instancia del objeto Color para el clip de película especificado por el
parámetro destino. Puede utilizar los métodos de ese objeto Color para cambiar el color de todo
el clip de película de destino.
Ejemplo
En el ejemplo siguiente se crea una instancia del objeto Color denominada myColor para el clip
de película myMovieClip y se establece su valor RGB:
myColor = new Color(myMovieClip);
myColor.setRGB(0xff9933);
Color.getRGB
Disponibilidad
Flash Player 5.
Sintaxis
myColor.getRGB()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; devuelve los valores numéricos establecidos por la última llamada setRGB.
Ejemplo
En el código 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);
Véase también
Color.setRGB
Color.getTransform
Disponibilidad
Flash Player 5.
Sintaxis
myColor.getTransform()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; devuelve el valor de transformación establecido por la última llamada setTransform.
Diccionario de ActionScript
113
Véase también
Color.setTransform
Color.setRGB
Disponibilidad
Flash Player 5.
Sintaxis
myColor.setRGB(0xRRGGBB)
Parámetros
0xRRGGBB Color hexadecimal o RGB que se va a establecer. RR (rojo), GG (verde) y BB (azul)
constan de dos dígitos hexadecimales respectivamente que especifican el desplazamiento de cada
componente de color. 0x indica al compilador de ActionScript que el número es un valor
hexadecimal.
Descripción
Método; especifica un color RGB para una instancia del objeto Color. Si se llama a este método,
prevalece sobre cualquier configuración anterior del método setTransform.
Valor devuelto
Ninguno.
Ejemplo
En este ejemplo se establece el valor de color RGB para el clip de película myMovie. Para ver este
código en funcionamiento, coloque un clip de película en el escenario con el nombre de instancia
myMovie. A continuación, coloque el código siguiente en el fotograma 1 de la línea de tiempo
principal y elija Control > Probar película.
myColor = new Color(myMovie);
myColor.setRGB(0x993366);
Véase también
Color.setTransform
Color.setTransform
Disponibilidad
Flash Player 5.
Sintaxis
myColor.setTransform(objetoTransformaciónColor);
Parámetros
Objeto creado con el constructor new Object. Esta instancia
del objeto Object debe tener las siguientes propiedades que especifican los valores de
transformación del color: ra, rb, ga, gb, ba, bb, aa, ab. Estas propiedades se explican a
continuación.
objetoTransformaciónColor
Valor devuelto
Ninguno.
114
Descripción
Método; establece la información de transformación del color de una instancia del objeto Color.
El parámetro objetoTransformaciónColor es un objeto genérico que se crea a partir del
constructor new Object. Dispone de parámetros 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 parámetros de un objeto de transformación del color corresponden a la configuración del
cuadro de diálogo Efecto avanzado y se definen del modo siguiente:
• ra es el porcentaje del componente rojo (de -100 a 100).
•
•
•
•
•
•
•
rb
es el desplazamiento del componente rojo (de -255 a 255).
ga
es el porcentaje del componente verde (de -100 a 100).
gb
es el desplazamiento del componente verde (de -255 a 255).
ba
es el porcentaje del componente azul (de -100 a 100).
bb
es el desplazamiento del componente azul (de -255 a 255).
aa
es el porcentaje de transparencia alfa (de -100 a 100).
ab
es el desplazamiento de transparencia alfa (de -255 a 255).
Cree un parámetro objetoTransformaciónColor como se muestra a continuación:
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;
También puede utilizar la sintaxis siguiente para crear un parámetro
objetoTransformaciónColor:
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 película de destino, se crea
un objeto genérico denominado myColorTransform con las propiedades definidas anteriormente
y se utiliza el método setTransform para pasar el parámetro objetoTransformaciónColor a un
objeto Color. Para utilizar este código en un documento de Flash (FLA), colóquelo en el
fotograma 1 de la línea de tiempo principal y coloque un clip de película en el escenario con el
nombre de instancia myMovie, como se indica en el código siguiente:
// Crear un objeto de color denominado myColor para myMovie
myColor = new Color(myMovie);
// Crear un objeto de transformación del color denominado myColorTransfrom con
// el objeto Object genérico
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 transformación del color con el objeto Color
// creado para myMovie
myColor.setTransform(myColorTransform);
Diccionario de ActionScript
115
continue
Disponibilidad
Flash Player 4.
Sintaxis
continue
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Acción; 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 intérprete de Flash omita el resto del cuerpo del bucle y
salte al principio del bucle, donde se comprueba la condición.
En un bucle do while, continue hace que el intérprete de Flash omita el resto del cuerpo del
bucle y salte al final del bucle, donde se comprueba la condición.
En un bucle for, continue hace que el intérprete de Flash omita el resto del cuerpo del bucle y
salte al cálculo de la postexpresión del bucle for.
En un bucle for..in, continue hace que el intérprete de Flash omita el resto del cuerpo del
bucle y salte al principio del bucle, donde se procesa el siguiente valor de la enumeración.
Véase también
do while, for, for..in, while
CustomActions (objeto)
Los métodos del objeto CustomActions permiten que una película Flash que se reproduzca en la
herramienta de edición de Flash gestione las acciones personalizadas que se registran con la
herramienta de edición. Las películas Flash pueden instalar y desinstalar acciones personalizadas,
recuperar la definición XML de una acción personalizada y recuperar la lista de las acciones
personalizadas registradas.
Puede utilizar estos métodos para crear películas Flash que sean extensiones de la herramienta de
edición de Flash. Este tipo de película podría, por ejemplo, utilizar el protocolo de aplicación de
Flash para navegar por un repositorio UDDI y descargar servicios Web en la caja de herramientas
Acciones.
116
Resumen de los métodos del objeto CustomActions
Método
Descripción
CustomActions.get
Lee el contenido de un archivo de definición XML de acciones personalizadas.
CustomActions.install
Instala un archivo de definición XML de acciones personalizadas nuevo.
CustomActions.list
Devuelve una lista de todas las acciones personalizadas registradas.
CustomActions.uninstall
Elimina un archivo de definición XML de acciones personalizadas.
CustomActions.get
Disponibilidad
Flash Player 6.
Sintaxis
CustomActions.get(nombreAccionesPersonalizadas)
Parámetros
nombreAccionesPersonalizadas
Nombre de la definición de la acción personalizada que
debe recuperarse.
Valor devuelto
Ninguno.
Descripción
Método; lee el contenido del archivo de definición XML de acciones personalizadas denominado
nombreAccionesPersonalizadas.
El nombre del archivo de definición debe ser un nombre simple, sin la extensión .xml y sin
separadores de directorio (':', '/' o '\').
Si no se encuentra el archivo de definición especificado por nombreAccionesPersonalizadas, se
devuelve el valor undefined. Si se encuentra la definición XML de acciones personalizadas
especificada por el parámetro nombreAccionesPersonalizadas, se la lee completamente y se
devuelve como cadena.
CustomActions.install
Disponibilidad
Flash Player 6.
Sintaxis
CustomActions.install(nombreAccionesPersonalizadas, definiciónXMLpersonalizada)
Parámetros
nombreAccionesPersonalizadas
Nombre de la definición de la acción personalizada que
debe instalarse.
definiciónXMLpersonalizada
Texto de la definición XML que debe instalarse.
Valor devuelto
Ninguno.
Diccionario de ActionScript
117
Descripción
Método; instala una nueva definición XML de acciones personalizadas indicada por el parámetro
nombreAccionesPersonalizadas. El contenido del archivo se especifica mediante la cadena
definiciónXMLpersonalizada.
El nombre del archivo de definición debe ser un nombre simple, sin la extensión .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 instalación, se devuelve el valor false; de lo contrario, se
devuelve el valor true para indicar que la acción personalizada se ha instalado correctamente.
Si no existe el directorio Configuration/ActionsPanel/CustomActions cuando se invoca este
método, se lo creará.
CustomActions.list
Disponibilidad
Flash Player 6.
Sintaxis
CustomActions.list()
Parámetros
Ninguno.
Valor devuelto
Una matriz.
Descripción
Método; devuelve un objeto Array que contiene los nombres de todas las acciones personalizadas
que se han registrado con la herramienta de edición de Flash. Los elementos de la matriz son
nombres simples, sin la extensión de archivo .xml y sin separadores de directorio (por ejemplo,
“:”, “/” o “\”). Si no hay acciones personalizadas registradas, el método list devuelve una matriz
de longitud cero. Si se produce un error, el método list devuelve el valor undefined.
CustomActions.uninstall
Disponibilidad
Flash Player 6.
Sintaxis
CustomActions.uninstall(nombreAccionesPersonalizadas)
Parámetros
nombreAccionesPersonalizadas
debe desinstalarse.
Valor devuelto
Ninguno.
118
Nombre de la definición de la acción personalizada que
Descripción
Método; elimina el archivo de definición XML de acciones personalizadas
nombreAccionesPersonalizadas.
El nombre del archivo de definición debe ser un nombre simple, sin la extensión .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 métodos del objeto Date no son estáticos, sino que se
aplican a la instancia individual del objeto Date especificado cuando se llama al método. El
método Date.UTC es una excepción, ya que es un método estático.
El objeto Date maneja el horario de verano de forma distinta en función del sistema operativo y la
versión 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 automáticamente según 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 estándar al horario de verano. Sin embargo, si las
fechas de transición que están 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 transición 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 Pacífico 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 información de zonas horarias.
• Mac OS X: el objeto Date se ajusta de forma automática para el horario de verano. La base de
datos de información 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 también tienen un horario de verano, pero
que su momento de transición es distinto al de EE.UU. Flash detecta correctamente si el
entorno regional actual utiliza el horario de verano.
Para llamar los métodos 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 métodos del objeto Date
120
Método
Descripción
Date.getDate
Devuelve el día del mes según la hora local.
Date.getDay
Devuelve el día de la semana según la hora local.
Date.getFullYear
Devuelve el año en formato de cuatro dígitos según la hora local.
Date.getHours
Devuelve la hora según la hora local.
Date.getMilliseconds
Devuelve los milisegundos según la hora local.
Date.getMinutes
Devuelve los minutos según la hora local.
Date.getMonth
Devuelve el mes según la hora local.
Date.getSeconds
Devuelve los segundos según la hora local.
Date.getTime
Devuelve el número de milisegundos desde la medianoche del 1 de enero de 1970,
hora universal.
Date.getTimezoneOffset
Devuelve la diferencia, en minutos, entre la hora local del sistema y la hora
universal.
Date.getUTCDate
Devuelve el día (fecha) del mes según la hora universal.
Date.getUTCDay
Devuelve el día de la semana según la hora universal.
Date.getUTCFullYear
Devuelve el año en formato de cuatro dígitos según la hora universal.
Date.getUTCHours
Devuelve la hora según la hora universal.
Date.getUTCMilliseconds
Devuelve los milisegundos según la hora universal.
Date.getUTCMinutes
Devuelve los minutos según la hora universal.
Date.getUTCMonth
Devuelve el mes según la hora universal.
Date.getUTCSeconds
Devuelve los segundos según la hora universal.
Date.getYear
Devuelve el año según la hora local.
Date.setDate
Establece el día del mes según la hora local. Devuelve la nueva hora en
milisegundos.
Date.setFullYear
Establece el año completo según la hora local. Devuelve la nueva hora en
milisegundos.
Date.setHours
Establece la hora según la hora local. Devuelve la nueva hora en milisegundos.
Date.setMilliseconds
Establece los milisegundos según la hora local. Devuelve la nueva hora en
milisegundos.
Date.setMinutes
Establece los minutos según la hora local. Devuelve la nueva hora en
milisegundos.
Date.setMonth
Establece el mes según la hora local. Devuelve la nueva hora en milisegundos.
Date.setSeconds
Establece los segundos según la hora local. Devuelve la nueva hora en
milisegundos.
Date.setTime
Establece la fecha en milisegundos. Devuelve la nueva hora en milisegundos.
Date.setUTCDate
Establece la fecha según la hora universal. Devuelve la nueva hora en
milisegundos.
Date.setUTCFullYear
Establece el año según la hora universal. Devuelve la nueva hora en milisegundos.
Método
Descripción
Date.setUTCHours
Establece la hora según la hora universal. Devuelve la nueva hora en
milisegundos.
Date.setUTCMilliseconds
Establece los milisegundos según la hora universal. Devuelve la nueva hora en
milisegundos.
Date.setUTCMinutes
Establece los minutos según la hora universal. Devuelve la nueva hora en
milisegundos.
Date.setUTCMonth
Establece el mes según la hora universal. Devuelve la nueva hora en
milisegundos.
Date.setUTCSeconds
Establece los segundos según la hora universal. Devuelve la nueva hora en
milisegundos.
Date.setYear
Establece el año según la hora local.
Date.toString
Devuelve un valor de cadena que representa la fecha y la hora almacenada en el
objeto Date especificado.
Date.UTC
Devuelve el número 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(año, mes [, fecha [, hora [, minuto [, segundo [, milisegundo ]]]]])
Parámetros
año Valor de 0 a 99 que indica de 1900 a 1999; de lo contrario, deben especificarse los 4 dígitos
del año.
mes
Número entero de 0 (enero) a 11 (diciembre).
Número entero de 1 a 31. Este parámetro es opcional.
fecha
hora
Número entero de 0 (medianoche) a 23 (11 PM).
minuto
segundo
Número entero de 0 a 59. Este parámetro es opcional.
Número entero de 0 a 59. Este parámetro es opcional.
milisegundo
Número entero de 0 a 999. Este parámetro es opcional.
Valor devuelto
Un número entero.
Descripción
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 cumpleaños 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
métodos 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()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve el día del mes (un número entero de 1 a 31) del objeto Date especificado según 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()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve el día de la semana (0 para el domingo, 1 para el lunes, etc.) del objeto Date
especificado según 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()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve el año completo (un número de cuatro dígitos, por ejemplo, 2000) del objeto
Date especificado según 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 método getFullYear a la ventana Salida.
myDate = new Date();
trace(myDate.getFullYear());
Date.getHours
Disponibilidad
Flash Player 5.
Sintaxis
myDate.getHours()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve la hora (un número entero de 0 a 23) del objeto Date especificado según 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()
Parámetros
Ninguno.
Diccionario de ActionScript 123
Valor devuelto
Un número entero.
Descripción
Método; devuelve los milisegundos (un número entero de 0 a 999) del objeto Date especificado
según 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()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve los minutos (un número entero de 0 a 59) del objeto Date especificado según 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()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve el mes (0 para enero, 1 para febrero, etc.) del objeto Date especificado, según 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()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve los segundos (un número entero de 0 a 59) del objeto Date especificado, según 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()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve el número de milisegundos desde la medianoche del 1 de enero de 1970, hora
universal, para el objeto Date especificado. Utilice este método para representar un instante
específico en el tiempo cuando compare dos o más objetos Date.
Date.getTimezoneOffset
Disponibilidad
Flash Player 5.
Sintaxis
mydate.getTimezoneOffset()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; 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 sólo 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 Pacífico (PDT, GMT-0700).
El resultado variará según el entorno regional y la fecha del año.
Date.getUTCDate
Disponibilidad
Flash Player 5.
Sintaxis
myDate.getUTCDate()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve el día (fecha) del mes del objeto Date especificado según la hora universal.
Date.getUTCDay
Disponibilidad
Flash Player 5.
Sintaxis
myDate.getUTCDate()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve el día de la semana del objeto Date especificado según la hora universal.
126
Date.getUTCFullYear
Disponibilidad
Flash Player 5.
Sintaxis
myDate.getUTCFullYear()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve el año en cuatro dígitos del objeto Date especificado según la hora universal.
Date.getUTCHours
Disponibilidad
Flash Player 5.
Sintaxis
myDate.getUTCHours()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve las horas del objeto Date especificado según la hora universal.
Date.getUTCMilliseconds
Disponibilidad
Flash Player 5.
Sintaxis
myDate.getUTCMilliseconds()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve los milisegundos del objeto Date especificado según la hora universal.
Diccionario de ActionScript 127
Date.getUTCMinutes
Disponibilidad
Flash Player 5.
Sintaxis
myDate.getUTCMinutes()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve los minutos del objeto Date especificado según la hora universal.
Date.getUTCMonth
Disponibilidad
Flash Player 5.
Sintaxis
myDate.getUTCMonth()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve el mes del objeto Date especificado según la hora universal.
Date.getUTCSeconds
Disponibilidad
Flash Player 5.
Sintaxis
myDate.getUTCSeconds()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve los segundos del objeto Date especificado según la hora universal.
128
Date.getYear
Disponibilidad
Flash Player 5.
Sintaxis
myDate.getYear()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve el año del objeto Date especificado según la hora local. La hora local la
determina el sistema operativo en el que se esté ejecutando Flash Player. El año es el año completo
menos 1900. Por ejemplo, el año 2000 se representa como 100.
Date.setDate
Disponibilidad
Flash Player 5.
Sintaxis
myDate.setDate(fecha)
Parámetros
fecha
Número entero de 1 a 31.
Valor devuelto
Un número entero.
Descripción
Método; establece el día del mes del objeto Date especificado, según 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(año [, mes [, fecha]] )
Parámetros
año Número de cuatro dígitos que especifica un año. Los números de dos dígitos no
representan años; por ejemplo, 99 no es el año 1999, sino el año 99.
mes
fecha
Número entero de 0 (enero) a 11 (diciembre). Este parámetro es opcional.
Número de 1 a 31. Este parámetro es opcional.
Diccionario de ActionScript 129
Valor devuelto
Un número entero.
Descripción
Método; establece el año del objeto Date especificado, según la hora local, y devuelve la nueva hora
en milisegundos. Si se especifican los parámetros mes y fecha, también 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 método no modifica los otros campos del objeto Date especificado, pero los
métodos getUTCDay y getDay pueden dar un nuevo valor si el día de la semana cambia como
resultado de la llamada a este método.
Date.setHours
Disponibilidad
Flash Player 5.
Sintaxis
myDate.setHours(hora)
Parámetros
hora
Número entero de 0 (medianoche) a 23 (11 PM).
Valor devuelto
Un número entero.
Descripción
Método; establece las horas del objeto Date especificado según 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)
Parámetros
milisegundo
Número entero de 0 a 999.
Valor devuelto
Un número entero.
Descripción
Método; establece los milisegundos para el objeto Date especificado según 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)
Parámetros
Número entero de 0 a 59.
minuto
Valor devuelto
Un número entero.
Descripción
Método; establece los minutos de un objeto Date especificado según 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 ])
Parámetros
mes
Número entero de 0 (enero) a 11 (diciembre).
fecha
Número entero de 1 a 31. Este parámetro es opcional.
Valor devuelto
Un número entero.
Descripción
Método; 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)
Parámetros
segundo
Número entero de 0 a 59.
Valor devuelto
Un número entero.
Diccionario de ActionScript
131
Descripción
Método; 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)
Parámetros
milisegundo
Valor entero donde 0 son las 0:00 GMT del 1 de enero de 1970.
Valor devuelto
Un número entero.
Descripción
Método; 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)
Parámetros
fecha
Número entero de 1 a 31.
Valor devuelto
Un número entero.
Descripción
Método; establece la fecha del objeto Date especificado en la hora universal y devuelve la nueva
hora en milisegundos. Llamar a este método no modifica los otros campos del objeto Date
especificado, pero los métodos getUTCDay y getDay pueden dar un nuevo valor si el día de la
semana cambia como resultado de llamar a este método.
132
Date.setUTCFullYear
Disponibilidad
Flash Player 5.
Sintaxis
myDate.setUTCFullYear(año [, mes [, fecha]])
Parámetros
año
Año especificado en formato de cuatro dígitos, por ejemplo, 2000.
mes
Número entero de 0 (enero) a 11 (diciembre). Este parámetro es opcional.
Número entero de 1 a 31. Este parámetro es opcional.
fecha
Valor devuelto
Un número entero.
Descripción
Método; establece el año del objeto Date especificado (mydate) en la hora universal y devuelve la
nueva hora en milisegundos.
De modo opcional, este método también 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 día de la semana
cambia como resultado de esta operación.
Date.setUTCHours
Disponibilidad
Flash Player 5.
Sintaxis
myDate.setUTCHours(hora [, minuto [, segundo [, milisegundo]]])
Parámetros
hora
Número entero de 0 (medianoche) a 23 (11 PM).
minuto
segundo
Número entero de 0 a 59. Este parámetro es opcional.
Número entero de 0 a 59. Este parámetro es opcional.
milisegundo
Número entero de 0 a 999. Este parámetro es opcional.
Valor devuelto
Un número entero.
Descripción
Método; 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)
Parámetros
milisegundo
Número entero de 0 a 999.
Valor devuelto
Un número entero.
Descripción
Método; 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]])
Parámetros
minuto
segundo
Número entero de 0 a 59.
Número entero de 0 a 59. Este parámetro es opcional.
milisegundo
Número entero de 0 a 999. Este parámetro es opcional.
Valor devuelto
Un número entero.
Descripción
Método; 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])
Parámetros
mes
Número entero de 0 (enero) a 11 (diciembre).
fecha
Número entero de 1 a 31. Este parámetro es opcional.
Valor devuelto
Un número entero.
Descripción
Método; establece el mes y, opcionalmente, el día (la fecha) del objeto Date especificado en la
hora universal y devuelve la nueva hora en milisegundos. Llamar a este método no modifica los
otros campos del objeto Date especificado, pero los métodos getUTCDay y getDay pueden dar un
nuevo valor si el día de la semana cambia como resultado de llamar al parámetro fecha cuando se
llama a setUTCMonth.
Date.setUTCSeconds
Disponibilidad
Flash Player 5.
Sintaxis
myDate.setUTCSeconds(segundo [, milisegundo]))
Parámetros
segundo
Número entero de 0 a 59.
milisegundo
Número entero de 0 a 999. Este parámetro es opcional.
Valor devuelto
Un número entero.
Descripción
Método; 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(año)
Parámetros
año Si año es un número entero entre 0 y 99, setYear establece el año en 1900 + año; de lo
contrario, el año es el valor del parámetro año.
Valor devuelto
Un número entero.
Descripción
Método; establece el año 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()
Parámetros
Ninguno.
Valor devuelto
Una cadena.
Descripción
Método; 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 información del objeto de fecha dateOfBirth como una
cadena.
var dateOfBirth = new Date(74, 7, 7, 18, 15);
trace (dateOfBirth.toString());
Salida (para la hora estándar del Pacífico):
Wed Aug 7 18:15:00 GMT-0700 1974
136
Date.UTC
Disponibilidad
Flash Player 5.
Sintaxis
Date.UTC(año, mes [, fecha [, hora [, minuto [, segundo [, milisegundo ]]]]])
Parámetros
año
Número de cuatro dígitos, por ejemplo, 2000.
mes
Número entero de 0 (enero) a 11 (diciembre).
Número entero de 1 a 31. Este parámetro es opcional.
fecha
hora
Número entero de 0 (medianoche) a 23 (11 PM).
minuto
segundo
Número entero de 0 a 59. Este parámetro es opcional.
Número entero de 0 a 59. Este parámetro es opcional.
Número entero de 0 a 999. Este parámetro es opcional.
milisegundo
Valor devuelto
Un número entero.
Descripción
Método; devuelve el número de milisegundos desde la medianoche del 1 de enero de 1970, hora
universal, y la hora especificada en los parámetros. Este es un método estático que se invoca por
medio del constructor del objeto Date, no por medio de un objeto Date específico. Este método
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 variación según la hora universal del ejemplo utilizado para el método constructor newDate.
gary_birthday = new Date(Date.UTC(1974, 7, 8));
default
Disponibilidad
Flash Player 6.
Sintaxis
default: sentencias
Parámetros
sentencias
Cualquier número de sentencias.
Valor devuelto
Ninguno.
Diccionario de ActionScript 137
Descripción
Palabra clave; define el bloque case predeterminado para una acción switch. Las sentencias se
ejecutan si el parámetro Expresión de la acción switch no equivale (utilizando la igualdad
estricta) a ninguno de los parámetros Expresión que siguen a los bloques case de una acción
switch determinada.
No es necesario que la acción switch tenga un bloque default. No es necesario que el bloque
default sea el último de la lista. La utilización de una acción default fuera de una acción
switch es un error que hace que el script no se compile.
Ejemplo
En el ejemplo siguiente, la expresión 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 acción trace se envía a la ventana Salida.
switch ( A ) {
case B:
C;
break;
case D:
E;
break;
default:
trace (“se ha detectado un caso no específico”);
}
Véase también
switch, case, break
delete
Disponibilidad
Flash Player 5.
Sintaxis
delete referencia
Parámetros
referencia
Nombre de la variable u objeto que se va a eliminar.
Valor devuelto
Ninguno.
Descripción
Operador; destruye el objeto o la variable especificada por el parámetro 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 película.
138
Ejemplo
En el ejemplo siguiente se crea un objeto, se lo utiliza y después 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 eliminación 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 habría eliminado al eliminar ref1, porque no
habría referencias a él. Si elimina ref2, ya no habrá referencias al objeto; se destruirá y la memoria
que utilizaba pasará a estar disponible.
Véase también
var
Diccionario de ActionScript 139
do while
Disponibilidad
Flash Player 4.
Sintaxis
do {
sentencia(s)
} while (condición)
Parámetros
Condición que se comprueba.
condición
Sentencia(s) que debe(n) ejecutarse mientras el parámetro condición tenga el
sentencia(s)
valor true.
Valor devuelto
Ninguno.
Descripción
Acción; ejecuta las sentencias y después comprueba la condición de un bucle mientras la
condición sea true.
Véase también
break, continue
duplicateMovieClip
Disponibilidad
Flash Player 4.
Sintaxis
duplicateMovieClip(destino, nombrenuevo, profundidad)
Parámetros
destino
Ruta de destino del clip de película que debe duplicarse.
nombrenuevo
Identificador exclusivo para el clip de película duplicado.
profundidad Nivel de profundidad exclusivo del clip de película duplicado. El nivel de
profundidad es un orden de apilamiento de los clips de película duplicados. Este orden de
apilamiento se parece mucho al orden de apilamiento de las capas en la línea de tiempo; los clips de
película con un nivel de profundidad menor permanecen ocultos debajo de los clips con un orden
de apilamiento mayor. Debe asignar a cada clip de película duplicado un nivel de profundidad
exclusivo para evitar que reemplace películas existentes en las profundidades ocupadas.
Valor devuelto
Ninguno.
140
Descripción
Acción; crea una instancia de un clip de película mientras se reproduce la película. La cabeza lectora
de los clips de película duplicados siempre empieza en el fotograma 1, sin tener en cuenta la posición
de la cabeza lectora en el clip de película original (o principal). Las variables del clip de película
principal no se copian en el clip de película duplicado. Si se elimina el clip de película principal
también se elimina el clip de película duplicado. Utilice la acción o el método removeMovieClip
para eliminar una instancia de clip de película creada con duplicateMovieClip.
Ejemplo
Esta sentencia copia la instancia de clip de película flower diez veces. La variable i sirve para crear
un nuevo nombre de instancia y una profundidad exclusiva para cada clip de película 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--;
}
}
Véase también
MovieClip.duplicateMovieClip, removeMovieClip, MovieClip.removeMovieClip
else
Disponibilidad
Flash Player 4.
Sintaxis
else sentencia
else {...sentencia(s)...}
Parámetros
condición
Una expresión que da como resultado true o false.
sentencia(s) Serie alternativa de sentencias que debe ejecutarse si la condición especificada en
la sentencia if es false.
Valor devuelto
Ninguno.
Descripción
Acción; especifica las sentencias que deben ejecutarse si la condición de la sentencia if devuelve el
valor false.
Véase también
if
Diccionario de ActionScript
141
else if
Disponibilidad
Flash Player 4.
Sintaxis
if (condición){
sentencia(s);
} else if (condición){
sentencia(s);
}
Parámetros
condición
Una expresión que da como resultado true o false.
sentencia(s) Serie alternativa de sentencias que debe ejecutarse si la condición especificada en
la sentencia if es false.
Valor devuelto
Ninguno.
Descripción
Acción; calcula el valor de una condición y especifica las sentencias que deben ejecutarse si la
condición de la sentencia if inicial es false. Si la condición else if es true, el intérprete de
Flash ejecuta las sentencias que van después de la condición entre llaves ({}). Si la condición else
if es false, Flash pasa por alto las sentencias entre llaves y ejecuta las sentencias que van después
de las llaves. Utilice la acción else if para definir lógica de ramificación 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 límite específico:
// si el objeto sobrepasa los límites,
// 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;
}
Véase también
if
142
#endinitclip
Disponibilidad
Flash Player 6.
Sintaxis
#endinitclip
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Acción; indica el final de un bloque de acciones de inicialización de componente.
Ejemplo
#initclip
... aquí se especifican las acciones de inicialización del componente...
#endinitclip
Véase también
#initclip
eq (igual, específico de cadena)
Disponibilidad
Flash Player 4. Esta función se ha desestimado en Flash 5; se recomienda utilizar el operador ==
(igualdad).
Sintaxis
expresión1 eq expresión2
Parámetros
expresión1,expresión2
Números, cadenas o variables.
Valor devuelto
Ninguno.
Descripción
Operador de comparación; compara si dos expresiones son iguales y devuelve el valor true si la
representación de la cadena expresión1 es igual a la representación de la cadena expresión2; de
lo contrario, la operación devuelve el valor false.
Véase también
== (igualdad)
Diccionario de ActionScript 143
escape
Disponibilidad
Flash Player 5.
Sintaxis
escape(expresión)
Parámetros
Expresión que se va a convertir en una cadena y que se va a codificar con un
formato URL.
expresión
Valor devuelto
Ninguno.
Descripción
Función; convierte el parámetro en una cadena y lo codifica en formato URL, en el que todos los
caracteres no alfanuméricos se convierten en secuencias hexadecimales % de escape.
Ejemplo
La ejecución del código siguiente da como resultado Hola%7B%5BMundo%5D%7D.
escape("Hola{[Mundo]}");
Véase también
unescape
eval
Disponibilidad
Flash Player 5 o posterior para obtener la funcionalidad completa. Puede utilizar la función eval
cuando realice una exportación a Flash Player 4, pero debe utilizar la notación usando barras
inclinadas y sólo puede acceder a variables y no a propiedades ni objetos.
Sintaxis
eval(expresión);
Parámetros
Cadena que contiene el nombre de una variable, propiedad, objeto o clip de película
que debe recuperarse.
expresión
Valor devuelto
Ninguno.
Descripción
Función; accede a variables, propiedades, objetos o clips de película por nombre. Si la expresión
es una variable o una propiedad, el valor de la variable o de la propiedad no se devuelve. Si la
expresión es un objeto o un clip de película, se devuelve una referencia al objeto o al clip de
película. Si el elemento denominado en la expresión no puede encontrarse, se devuelve
undefined.
En Flash 4, la función eval se utilizaba para simular una matriz; en Flash 5 se recomienda utilizar
el objeto Array para simular matrices.
144
También puede utilizar la función eval para establecer y recuperar dinámicamente el valor de una
variable o de un nombre de instancia. Sin embargo, también puede llevar esto a cabo con el
operador de acceso de matriz ([]).
Nota: la acción eval de ActionScript no es la misma que la función eval de JavaScript y no puede utilizarse para
evaluar sentencias.
Ejemplo
En el ejemplo siguiente se utiliza la función eval para determinar el valor de la expresión
Puesto que el resultado es un nombre de variable, piece3, la función eval
devuelve el valor de la variable y lo asigna a y:
"piece" + x.
piece3 = "peligroso";
x = 3;
y = eval("piece" + x);
trace(y);
// Salida: peligroso
Véase también
Array (objeto)
evaluate
Disponibilidad
Flash Player 5.
Sintaxis
sentencia
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Acción; crea una nueva línea vacía e inserta un punto y coma (;) para escribir sentencias que
deben evaluarse en el panel Acciones.
false
Disponibilidad
Flash Player 5.
Sintaxis
true
Descripción
Valor booleano exclusivo que representa lo contrario de true.
Véase también
true
Diccionario de ActionScript 145
FCheckBox (componente)
El componente CheckBox del entorno de edición de Flash proporciona funciones de arrastrar y
soltar para agregar casillas de verificación a los documentos de Flash, además de proporcionar una
interfaz gráfica de usuario para definir parámetros básicos. Los métodos del componente
FCheckBox permiten controlar casillas de verificación en tiempo de ejecución: puede crear casillas
de verificación, controlar casillas de verificación creadas en el entorno de edición, definir o
sustituir parámetros básicos y establecer opciones adicionales de tiempo de ejecución. No es
necesario que utilice un constructor para acceder a los métodos de los componentes.
El componente CheckBox se admite en Flash Player 6.
Los métodos 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 parámetros
antes de pasarlos a los métodos.
Para obtener más información sobre la utilización del componente CheckBox, la definición de
parámetros durante la edición y la modificación del color y del aspecto de los componentes,
consulte los apartados “Personalización de los colores y el texto de los componentes” y
“Personalización de aspectos de componentes” en el capítulo “Utilización de componentes” de la
publicación Utilización de Flash.
Resumen de métodos del componente FCheckBox
146
Método
Descripción
FCheckBox.getEnabled
Devuelve true si la casilla de verificación está activada y false si está
desactivada.
FCheckBox.getLabel
Devuelve la etiqueta aplicada a la casilla de verificación como una
cadena.
FCheckBox.getValue
Devuelve true si la casilla de verificación está seleccionada y false si
no lo está.
FCheckBox.registerSkinElement
Registra un elemento de aspecto en una propiedad.
FCheckBox.setChangeHandler
Especifica un controlador de cambios que debe activarse cuando
cambie el valor de la casilla de verificación.
FCheckBox.setEnabled
Determina si la casilla de verificación está activada o desactivada.
FCheckBox.setLabel
Especifica texto para la etiqueta de la casilla de verificación.
FCheckBox.setLabelPlacement
Especifica si la etiqueta aparece a la izquierda o a la derecha de la
casilla de verificación.
FCheckBox.setSize
Establece la anchura de la casilla de verificación, en píxeles y vuelve a
dibujarla.
FCheckBox.setStyleProperty
Establece una sola propiedad de estilo para un componente.
FCheckBox.setValue
Selecciona o deselecciona la casilla de verificación y activa la función
de control de cambios.
FCheckBox.getEnabled
Disponibilidad
Flash Player 6.
Sintaxis
myCheckBox.getEnabled()
Parámetros
Ninguno.
Valor devuelto
Un valor booleano que indica si la instancia de la casilla de verificación está activada (true) o
desactivada (false).
Descripción
Método; indica si la instancia de la casilla de verificación está activada o desactivada.
Ejemplo
El código siguiente devuelve el estado de activación de checkBox1 en la ventana Salida.
trace(checkBox1.getEnabled());
Véase también
FCheckBox.setValue
FCheckBox.getLabel
Disponibilidad
Flash Player 6.
Sintaxis
myCheckBox.getLabel()
Parámetros
Ninguno.
Valor devuelto
Una cadena de texto.
Descripción
Método; recupera la etiqueta de la casilla.
Ejemplo
El código siguiente devuelve la etiqueta de checkBox1.
checkBox1.getLabel();
Véase también
FCheckBox.setLabel
Diccionario de ActionScript 147
FCheckBox.getValue
Disponibilidad
Flash Player 6.
Sintaxis
myCheckBox.getValue()
Parámetros
Ninguno.
Valor devuelto
Un valor booleano que indica si la casilla de verificación está seleccionada (true) o no (false).
Descripción
Método; indica si la casilla de verificación está seleccionada.
Ejemplo
El código siguiente devuelve el valor seleccionado de KowalczykBox en la ventana Salida.
trace(KowalczykBox.getValue());
Véase también
FCheckBox.setValue
FCheckBox.registerSkinElement
Disponibilidad
Flash Player 6.
Sintaxis
myCheckBox.registerSkinElement(elemento, propiedadEstilo)
Parámetros
elemento
Instancia de clip de película.
propiedadEstilo
Nombre de una propiedad de FStyleFormat.
Valor devuelto
Ninguno.
Descripción
Método; 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 (Léame) de cada aspecto de
la biblioteca.
Los componentes están 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 método para registrar propiedades y elementos de aspecto personalizados en aspectos
de componentes de la interfaz de usuario de Flash o personalizados editando el código del primer
fotograma de la capa Read Me (Léame) 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 más información, consulte el apartado “Personalización de aspectos de
componentes” en el capítulo “Utilización de componentes” de la publicación Utilización de Flash.
Ejemplo
El código siguiente registra el elemento de aspecto personalizado customChk_mc en la propiedad
check del primer fotograma de la capa Read Me (Léame) 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(nombreFunción, [ubicación])
Parámetros
nombreFunción Cadena que especifica el nombre de la función del controlador que debe
ejecutarse cuando cambie el valor de la casilla de verificación. Si no se especifica el parámetro
ubicación, esta función debe encontrarse en la misma línea de tiempo que la instancia del
componente.
ubicación Referencia de ruta a un objeto de datos, clip de película o línea de tiempo que
contiene la función especificada. Este parámetro es opcional y tiene como valor predeterminado la
línea de tiempo principal del componente.
Valor devuelto
Ninguno.
Descripción
Método; especifica un controlador de cambios que debe activarse cuando cambie el valor de la
casilla de verificación. Puede especificar la misma función del controlador de cambios para más de
un componente; la función siempre acepta la instancia del componente que ha cambiado como
parámetro. Si se llama a este método, éste prevalece sobre el valor del parámetro de controlador de
cambios especificado en la edición.
Para obtener más información, consulte el apartado “Programación de funciones del controlador
de cambios para componentes” en el capítulo “Utilización de componentes” de la publicación
Utilización de Flash.
Ejemplo
El código siguiente especifica myHandler como la función a la que se debe llamar cuando cambia
el valor de checkBox1. Puesto que no se especifica el parámetro ubicación, myHandler debe
encontrarse en la misma línea de tiempo que la instancia del componente.
Diccionario de ActionScript 149
El parámetro component de myHandler se rellena automáticamente 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 verificación, el nombre del componente y el texto
“ha sido seleccionado” aparecerán en la ventana Salida.
checkBox1.setChangeHandler("myHandler");
function myHandler(component){
trace(component._name + " ha sido seleccionado ");
}
Si en el ejemplo anterior myHandler es una función ubicada en una línea de tiempo tres niveles
por encima de la línea de tiempo del componente, la primera línea del código sería similar a la
siguiente:
check1.setChangeHandler("myHandler", _parent._parent._parent);
En el código siguiente se crea la función myHandler en una instancia de myObject (que es de la
clase Object) y, a continuación, se especifica myHandler como la función 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(activación)
Parámetros
activación Valor booleano que especifica si la casilla de verificación está activada (true) o
desactivada (false).
Valor devuelto
Ninguno.
Descripción
Método; especifica si la casilla de verificación está activada (true) o desactivada (false). Si una
casilla de verificación está desactivada, no aceptará la interacción del usuario mediante el teclado o
el ratón. Si omite este parámetro, el método toma como valor predeterminado true.
Ejemplo
En el código siguiente se desactiva checkBox1.
checkBox1.setEnabled(false);
150
FCheckBox.setLabel
Disponibilidad
Flash Player 6.
Sintaxis
myCheckBox.setLabel(etiqueta)
Parámetros
etiqueta
Cadena que especifica la etiqueta de texto de la casilla de verificación.
Valor devuelto
Ninguno.
Descripción
Método; especifica la etiqueta de texto de la casilla de verificación. De forma predeterminada, la
etiqueta aparece a la derecha de la casilla de verificación. Si se llama a este método, se sustituye el
parámetro etiqueta especificado durante la edición.
Ejemplo
En el código siguiente se aplica la etiqueta “Envíen más información” a checkBox1.
checkBox1.setLabel("Envíen más información");
Véase también
FCheckBox.getLabel, FCheckBox.setLabelPlacement
FCheckBox.setLabelPlacement
Disponibilidad
Flash Player 6.
Sintaxis
myCheckBox.setLabelPlacement(posiciónEtiqueta)
Parámetros
posiciónEtiqueta
Cadena de texto; especifique "left" o "right".
Valor devuelto
Ninguno.
Descripción
Método; especifica si la etiqueta aparece a la izquierda o a la derecha de la casilla de verificación. Si
se llama a este método, se sustituye el valor del parámetro de posición de etiqueta establecido
durante la edición.
Ejemplo
En el código siguiente se coloca la etiqueta de checkBox1 a la izquierda de la casilla de verificación.
checkBox1.setLabelPlacement("left");
Véase también
FCheckBox.setLabel
Diccionario de ActionScript
151
FCheckBox.setSize
Disponibilidad
Flash Player 6.
Sintaxis
myCheckBox.setSize(anchura)
Parámetros
anchura
Entero que especifica la anchura de la casilla de verificación, en píxeles.
Valor devuelto
Ninguno.
Descripción
Método; especifica la anchura de la casilla de verificación y vuelve a dibujarla. No puede establecer
la altura de los componentes de la casilla de verificación. Si se llama a este método, se sustituye la
escala de anchura aplicada durante la edición.
Para obtener más información, consulte el apartado “Tamaño de los componentes CheckBox” en
el capítulo “Utilización de componentes” de la publicación Utilización de Flash.
Ejemplo
En el código siguiente se establece la anchura de checkBox1 en 200 píxeles.
checkBox1.setSize(200);
FCheckBox.setStyleProperty
Disponibilidad
Flash Player 6.
Sintaxis
myCheckBox.setStyleProperty(propiedadEstilo, valor)
Parámetros
propiedadEstilo
valor
Cadena que especifica una propiedad del objeto FStyleFormat.
Valor que se establece para la propiedad.
Valor devuelto
Ninguno.
Descripción
Método; establece una propiedad FStyleFormat para una instancia de casilla de verificación. Si se
llama a este método 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 más información sobre la creación de formatos de estilo personalizados, consulte el
apartado “Personalización de los colores y el texto de los componentes” en el capítulo “Utilización
de componentes” de la publicación Utilización de Flash.
152
Ejemplo
En el código siguiente se establece la propiedad shadow de checkBox1 en 0x000000 (negro).
checkBox1.setStyleProperty("shadow", 0x000000);
Véase también
FStyleFormat (objeto)
FCheckBox.setValue
Disponibilidad
Flash Player 6.
Sintaxis
myCheckBox.setValue(selección)
Parámetros
selección
no (false).
Valor booleano que especifica si la casilla de verificación está seleccionada (true) o
Valor devuelto
Ninguno.
Descripción
Método; selecciona o deselecciona myCheckBox y desencadena la función del controlador de
cambios especificada (si la hay) en tiempo de ejecución. El valor predeterminado es true.
Aunque si se llama a este método se sustituye el valor del parámetro de valor inicial especificado
durante la edición, no utilice este método para este fin, puesto que también desencadena la
función del controlador de cambios asociada. Para establecer el parámetro de valor inicial de una
casilla de verificación en tiempo de ejecución, utilice FCheckBox.setStyleProperty.
Ejemplo
En el código siguiente se selecciona la instancia de checkBox1 y se desencadena la función
especificada del controlador de cambios.
checkBox1.setValue(true);
Véase también
FCheckBox.getValue
Diccionario de ActionScript 153
FComboBox (componente)
El componente ComboBox del entorno de edición de Flash proporciona funciones de arrastrar y
soltar para agregar listas desplegables de selección única a los documentos de Flash, además de
proporcionar una interfaz gráfica de usuario para definir parámetros básicos. Los métodos del
componente FComboBox permiten controlar cuadros combinados en tiempo de ejecución:
puede crear cuadros combinados, controlar cuadros combinados creados durante la edición,
definir o sustituir parámetros básicos y establecer opciones adicionales de tiempo de ejecución.
No es necesario que utilice un constructor para acceder a los métodos de los componentes.
El componente ComboBox crea cuadros combinados estáticos y editables. Un cuadro combinado
estático 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 ejecución.
Las versiones estática y editable del componente ComboBox enumeran elementos de arriba a
abajo mediante un sistema de índice basado en cero. Si el número 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 métodos 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 parámetros
antes de pasarlos a los métodos.
El componente ComboBox se admite en Flash Player 6 y en versiones posteriores de Flash Player.
Para obtener más información sobre la utilización del componente ComboBox, la definición de
parámetros durante la edición y la modificación del color y el aspecto de los componentes,
consulte los apartados “Personalización de los colores y el texto de los componentes” y
“Personalización de aspectos de componentes” en el capítulo “Utilización de componentes” de la
publicación Utilización de Flash.
Resumen de métodos del componente FComboBox
154
Método
Descripción
FComboBox.addItem
Agrega un nuevo elemento al final de la lista del cuadro combinado.
FComboBox.addItemAt
Agrega un nuevo elemento a la lista del cuadro combinado en el
índice especificado.
FComboBox.getEnabled
Devuelve true si el cuadro combinado está activado, y false si está
desactivado.
FComboBox.getItemAt
Devuelve el elemento con el índice especificado como un objeto con
las propiedades label y data.
FComboBox.getLength
Devuelve el número de elementos enumerados del cuadro
combinado.
FComboBox.getRowCount
Devuelve el número de filas visibles en el cuadro combinado.
FComboBox.getScrollPosition
Devuelve el índice del elemento en la primera posición del cuadro
combinado.
FComboBox.getSelectedIndex
Devuelve el índice del elemento seleccionado.
Método
Descripción
FComboBox.getSelectedItem
Devuelve el elemento seleccionado como un objeto con las
propiedades label y data.
FComboBox.getValue
Devuelve el texto del campo de entrada para cuadros combinados
editables; devuelve la etiqueta o los datos del elemento seleccionado
para cuadros combinados estáticos.
FComboBox.registerSkinElement
Registra un elemento de aspecto en una propiedad.
FComboBox.removeAll
Elimina todos los elementos del cuadro combinado.
FComboBox.removeItemAt
Elimina el elemento en el índice especificado.
FComboBox.replaceItemAt
Reemplaza la etiqueta y los datos de un elemento en el índice
especificado.
FComboBox.setChangeHandler
Asigna una función para llamarla cada vez que se selecciona un
elemento o que un usuario especifica texto en el campo de texto.
FComboBox.setDataProvider
Registra un objeto externo en el componente como origen de datos.
FComboBox.setEditable
Determina si el cuadro combinado es editable (true) o estático
(false).
FComboBox.setEnabled
Especifica si el cuadro combinado está activado (true) o desactivado
(false).
FComboBox.setItemSymbol
Registra un identificador de vínculo de símbolo para utilizarlo al
visualizar elementos del cuadro combinado.
FComboBox.setRowCount
Determina el número de elementos que se visualizan en el cuadro
combinado sin barra de desplazamiento.
FComboBox.setSelectedIndex
Selecciona el elemento en el índice especificado.
FComboBox.setSize
Establece la anchura en píxeles del cuadro combinado.
FComboBox.setStyleProperty
Establece una sola propiedad de estilo para una instancia de un
componente.
FComboBox.setValue
Especifica el texto que se visualiza en el campo de texto de la parte
superior de un cuadro combinado editable.
FComboBox.sortItemsBy
Clasifica los elementos del cuadro de lista en orden alfabético o
numérico por etiqueta o por datos.
Diccionario de ActionScript 155
FComboBox.addItem
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.addItem(etiqueta [,datos])
Parámetros
etiqueta
datos
Cadena de texto que debe visualizarse en la lista del cuadro combinado.
Valor que debe asociarse al elemento de lista. Este parámetro es opcional.
Valor devuelto
Ninguno.
Descripción
Método; 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 película de Flash.
Para obtener un rendimiento y un tiempo de carga óptimos, no agregue más 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 código 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 código siguiente se agrega el número máximo de elementos recomendados en un solo
fotograma (400 elementos) en comboBox1:
for (i=0; i<400; i++) {
comboBox1.addItem(i);
}
En el código siguiente se agrega el número máximo 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);
}
Véase también
FComboBox.addItemAt, FComboBox.getItemAt, FComboBox.replaceItemAt,
FComboBox.setDataProvider, FComboBox.sortItemsBy
156
FComboBox.addItemAt
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.addItemAt(índice, etiqueta [,datos])
Parámetros
Entero que especifica la posición en la que debe insertarse el elemento.
índice
etiqueta
datos
Cadena que identifica el elemento de la lista en el cuadro combinado.
Valor que debe asociarse al elemento de lista. Este parámetro es opcional.
Valor devuelto
Ninguno.
Descripción
Método; agrega un nuevo elemento con la etiqueta especificada y los datos opcionales asociados
en la lista del cuadro combinado en la posición de índice especificada. El parámetro de datos
puede ser cualquier objeto, cadena, valor booleano, entero o clip de película de Flash. A medida
que se agrega cada elemento, se actualiza la lista y cambia el tamaño 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 posición de la lista.
Para obtener un rendimiento y un tiempo de carga óptimos, no agregue más 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 código 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 cómo cargar grandes cantidades de elementos, consulte
FComboBox.addItem.
Véase también
FComboBox.getItemAt, FComboBox.removeItemAt, FComboBox.replaceItemAt,
FComboBox.setDataProvider, FComboBox.sortItemsBy
Diccionario de ActionScript 157
FComboBox.getEnabled
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.getEnabled()
Parámetros
Ninguno.
Valor devuelto
Valor booleano que indica si el cuadro combinado está activado (true) o desactivado (false).
Descripción
Método; indica si el cuadro combinado está activado.
Ejemplo
El código siguiente utiliza getEnabled para determinar si comboBox1 está activado o desactivado
y muestra el resultado en la ventana Salida.
trace(comboBox1.getEnabled());
Véase también
FComboBox.setEnabled
FComboBox.getItemAt
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.getItemAt(índice)
Parámetros
índice
Entero que especifica la posición de un elemento en el cuadro combinado.
Valor devuelto
Un objeto.
Descripción
Método; 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 posición de la lista.
Ejemplo
En el código siguiente se devuelve la etiqueta del elemento con el índice 4 en comboBox1 como
una cadena.
trace(comboBox1.getItemAt(4).label);
158
En el código 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 película u otro valor.
trace(comboBox2.getItemAt(4).data);
En el código 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));
Véase también
FComboBox.getSelectedItem
FComboBox.getLength
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.getLength()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve el número de elementos en la lista del cuadro combinado.
Ejemplo
En el código siguiente se recupera el número de elementos de la lista listMain y se lo almacena
en la variable len.
var len = listMain.getLength();
Véase también
FComboBox.addItem, FComboBox.addItemAt
FComboBox.getRowCount
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.getRowCount()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve el número de filas visibles en el cuadro combinado.
Diccionario de ActionScript 159
Ejemplo
En el código siguiente se devuelve el número de filas visible en toyList y se establece el valor en
la variable rowCount.
var rowCount = toyList.getRowCount();
Véase también
FComboBox.setRowCount
FComboBox.getScrollPosition
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.getScrollPosition()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve la posición de índice del elemento que se visualiza actualmente en la primera
posición 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 posición de la lista.
Ejemplo
En el código siguiente se recupera el índice del elemento que se encuentra actualmente en la
primera posición de la lista en toyList y se lo almacena en la variable scrollPos.
var scrollPos = toyList.getScrollPosition();
Véase también
FComboBox.setSelectedIndex
FComboBox.getSelectedIndex
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.getSelectedIndex()
Parámetros
Ninguno.
Valor devuelto
Un número entero o undefined.
160
Descripción
Método; devuelve el índice del elemento seleccionado actualmente en el cuadro combinado o
devuelve undefined si no se ha seleccionado ningún elemento.
Los elementos se muestran en el cuadro combinado de arriba a abajo mediante un índice basado
en cero.
Ejemplo
En el código siguiente se recupera el índice del elemento seleccionado actualmente en toyList y
se lo almacena en la variable selIndex.
var selIndex = toyList.getSelectedIndex();
Véase también
FComboBox.setSelectedIndex
FComboBox.getSelectedItem
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.getSelectedItem()
Parámetros
Ninguno.
Valor devuelto
Un objeto o undefined.
Descripción
Método; devuelve el elemento seleccionado actualmente como objeto con las propiedades label
y data o devuelve undefined si no se ha seleccionado ningún elemento.
Ejemplo
En el código siguiente se recuperan la etiqueta y los datos del elemento seleccionado en
comboBox1.
trace(comboBox1.getSelectedItem());
En el código siguiente se recupera la etiqueta del elemento seleccionado en comboBox2.
trace(comboBox2.getSelectedItem().label);
En el código siguiente se recuperan los datos del elemento seleccionado en comboBox3.
trace(comboBox3.getSelectedItem().data);
Véase también
FComboBox.setSelectedIndex
Diccionario de ActionScript
161
FComboBox.getValue
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.getValue()
Parámetros
Ninguno.
Valor devuelto
Una cadena de texto.
Descripción
Método; devuelve el texto del campo en la parte superior del cuadro combinado, si el cuadro
combinado es editable. Si el cuadro combinado es estático (no editable), este método devuelve los
datos asociados al elemento seleccionado o la etiqueta del elemento si no hay datos asociados.
Ejemplo
En el código siguiente se devuelven los datos o la etiqueta del elemento seleccionado en
menuMain.
trace(menuMain.getValue())
Véase también
FComboBox.setValue
FComboBox.registerSkinElement
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.registerSkinElement(elemento, propiedadEstilo)
Parámetros
elemento
Instancia de clip de película.
propiedadEstilo
Nombre de una propiedad de FStyleFormat.
Valor devuelto
Ninguno.
Descripción
Método; 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 (Léame) de cada aspecto de
la biblioteca.
Los componentes están 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 método para registrar propiedades y elementos de aspecto personalizados en aspectos
de componentes de la interfaz de usuario de Flash o personalizados editando el código del primer
fotograma de la capa Read Me (Léame) 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 más información, consulte el apartado “Personalización de aspectos de
componentes” en el capítulo “Utilización de componentes” de la publicación Utilización de Flash.
Ejemplo
En el código siguiente se registra el elemento de aspecto personalizado boundBox_mc en la
propiedad background del primer fotograma de la capa Read Me (Léame) del aspecto
FBoundingBox en la carpeta Global Skins.
toysMenu.registerSkinElement(boundBox_mc, "background");
FComboBox.removeAll
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.removeAll()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; elimina todos los elementos de la lista del cuadro combinado, lo actualiza y cambia el
tamaño de la barra de desplazamiento. Los cuadros combinados sin elementos se muestran sin barra
de desplazamiento. Este método no puede utilizarse si el cuadro combinado está desactivado.
Ejemplo
En el código siguiente se eliminan todos los elementos de menuMain.
menuMain.removeAll();
Véase también
FComboBox.removeItemAt
Diccionario de ActionScript 163
FComboBox.removeItemAt
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.removeItemAt(índice)
Parámetros
índice
Entero que especifica el índice del elemento que debe eliminarse.
Valor devuelto
Un objeto que contiene el elemento eliminado.
Descripción
Método; 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 posición en la lista. Si no existe ningún elemento en el índice especificado, este método
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 posición de la lista.
Ejemplo
En el código siguiente se elimina el quinto elemento de la lista en menuMain.
menuMain.removeItemAt(4);
Véase también
FComboBox.removeAll
FComboBox.replaceItemAt
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.replaceItemAt(índice, etiqueta [,datos])
Parámetros
índice
Entero que especifica la posición de un elemento de lista.
etiqueta
Cadena que especifica una nueva etiqueta para el elemento de lista.
Nuevo valor que debe asociarse al elemento de lista. Este parámetro es opcional; si no lo
especifica, se mantienen los datos especificados para el elemento.
datos
Valor devuelto
Ninguno.
Descripción
Método; 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 parámetro 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 posición de la lista.
Ejemplo
En el código 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");
Véase también
FComboBox.addItemAt, FComboBox.getItemAt, FComboBox.setDataProvider,
FComboBox.sortItemsBy
FComboBox.setChangeHandler
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.setChangeHandler(nombreFunción, [ubicación])
Parámetros
Cadena que especifica el nombre de la función del controlador que debe ejecutarse
cuando cambie el valor del cuadro combinado. Si no se especifica el parámetro ubicación, esta
función debe encontrarse en la misma línea de tiempo que la instancia del componente.
nombreFunción
ubicación Referencia de ruta a un objeto de datos, clip de película o línea de tiempo que
contiene la función especificada. Este parámetro es opcional y tiene como valor predeterminado la
línea de tiempo principal del componente.
Valor devuelto
Ninguno.
Descripción
Método; especifica un controlador de cambios que debe activarse cuando cambie el valor del
cuadro combinado. Puede especificar la misma función del controlador de cambios para más de
un componente; la función siempre acepta la instancia del componente que ha cambiado como
parámetro. Si se llama a este método, se sustituye el valor del parámetro de controlador de
cambios especificado en la edición.
Para obtener más información, consulte el apartado “Programación de funciones del controlador
de cambios para componentes” en el capítulo “Utilización de componentes” de la publicación
Utilización de Flash.
Ejemplo
En el código siguiente se especifica myHandler como la función a la que se debe llamar cuando
cambia el valor de toyList. Puesto que no se especifica el parámetro ubicación, myHandler
debe encontrarse en la misma línea de tiempo que la instancia del componente.
Diccionario de ActionScript 165
El parámetro component de myHandler se rellena automáticamente 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 función ubicada en una línea de tiempo tres niveles por
encima de la línea de tiempo del componente, la primera línea del código sería similar a la siguiente:
toyList.setChangeHandler("myHandler", _parent._parent._parent);
En el código siguiente se crea la función myHandler en una instancia de myObject (que es de la
clase Object) y, a continuación, se especifica myHandler como la función 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)
Parámetros
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.
Descripción
Método; 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 símbolo DataProvider de la carpeta FlashUIComponents/Core Assets/ClassTree de la
biblioteca. La interfaz API de DataProvider está destinada sólo para usuarios avanzados y
programadores; los demás usuarios deben utilizar una matriz o un objeto Array.
Ejemplo
En el código siguiente se especifica el objeto Array peopleList1 como proveedor de datos de
comboBox1.
comboBox1.setDataProvider(peopleList1);
166
En el código 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 código 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 código siguiente se especifica comboData, una instancia de la clase DataProvider, como
proveedor de datos de comboBox1.
comboBox1.setDataProvider(comboData);
En el código siguiente se crea una nueva instancia de la clase DataProvider y, a continuación, se
agregan las etiquetas del elemento mediante el método addItem de DataProvider.
Nota: el método addItem sólo es un método de la clase DataProvider. Los programadores interesados en utilizar la
clase DataProvider deben consultar el símbolo DataProvider en la carpeta FlashUIComponents/CoreAssets/
ClassTree en la biblioteca antes de intentar utilizar los métodos.
comboData = new DataProviderClass();
comboData.addItem("Devra");
comboData.addItem("Delia");
comboData.addItem("Vashti");
comboData.addItem("Alicia");
Véase también
FComboBox.addItem, FComboBox.replaceItemAt, FComboBox.sortItemsBy
FComboBox.setEditable
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.setEditable(editable)
Parámetros
editable
(false).
Valor booleano que especifica si el cuadro combinado es editable (true) o estático
Valor devuelto
Ninguno.
Diccionario de ActionScript 167
Descripción
Método; determina si el cuadro combinado es editable (true) o estático (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 también puede utilizarse
para visualizar texto mediante FComboBox.setValue. Si se llama a este método, se sustituye el
valor del parámetro Editable establecido durante la edición.
Ejemplo
En el código siguiente se activa un campo de introducción de texto en la parte superior de
menuMain.
menuMain.setEditable(true);
Véase también
FComboBox.setValue
FComboBox.setEnabled
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.setEnabled(activación)
Parámetros
activación Valor booleano que especifica si el cuadro combinado está activado (true) o
desactivado (false).
Valor devuelto
Ninguno.
Descripción
Método; determina si el cuadro combinado está activado (true) o desactivado (false). Si el
cuadro combinado está desactivado, no aceptará la interacción del usuario mediante el teclado o el
ratón. Si omite este parámetro, este método toma como valor predeterminado true.
Ejemplo
En el código siguiente se desactiva menuMain.
menuMain.setEnabled(false);
Véase también
FListBox.getEnabled
168
FComboBox.setItemSymbol
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.setItemSymbol(IDsímbolo)
Parámetros
Identificador de vínculo de un símbolo gráfico para la visualización del contenido
del cuadro combinado.
IDsímbolo
Valor devuelto
Ninguno.
Descripción
Método; registra un símbolo gráfico para visualizar los elementos de la lista del cuadro
combinado. El valor predeterminado es el símbolo FComboBoxItem de la biblioteca. Este
método está destinado a usuarios avanzados y programadores.
FComboBox.setRowCount
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.setRowCount(filas)
Parámetros
filas
Número máximo de filas que la lista desplegable puede mostrar sin desplazar su contenido.
Valor devuelto
Ninguno.
Descripción
Método; establece el número de elementos que puede verse en la lista desplegable del cuadro
combinado sin desplazar su contenido. El valor mínimo del parámetro filas es 3. Si se llama a
este método, se sustituye el valor del parámetro de número de filas establecido durante la edición.
Ejemplo
En el código siguiente se establece el número de elementos visualizados en la lista desplegable de
menuMain en 4.
menuMain.setRowCount(4);
Véase también
FComboBox.setSize
Diccionario de ActionScript 169
FComboBox.setSelectedIndex
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.setSelectedIndex(índice)
Parámetros
índice
Entero que especifica el índice del elemento que debe seleccionarse.
Valor devuelto
Ninguno.
Descripción
Método; selecciona el elemento especificado y actualiza el cuadro combinado para mostrar el
elemento seleccionado. Llamar a este método no afecta el estado abierto o cerrado actual de la lista
desplegable. Este método 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 posición de la lista.
Ejemplo
En el código siguiente se selecciona el cuarto elemento en la lista de menuMain.
menuMain.setSelectedIndex(3);
Véase también
FComboBox.setRowCount
FComboBox.setSize
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.setSize(anchura)
Parámetros
anchura
Entero que especifica la anchura del cuadro combinado, en píxeles.
Valor devuelto
Ninguno.
Descripción
Método; cambia el tamaño del cuadro combinado por la anchura especificada. (No es posible
establecer la altura del componente de cuadro combinado.) Utilice este método para cambiar de
forma programada el tamaño del cuadro combinado y actualizarlo en tiempo de ejecución.
Ejemplo
En el código siguiente se define o cambia la anchura de menuMain a 100 píxeles.
menuMain.setSize(100);
Véase también
FComboBox.setRowCount
170
FComboBox.setStyleProperty
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.setStyleProperty(propiedadEstilo, valor)
Parámetros
propiedadEstilo
valor
Cadena que especifica una propiedad del objeto FStyleFormat.
Valor que se establece para la propiedad.
Valor devuelto
Ninguno.
Descripción
Método; establece una propiedad FStyleFormat para una instancia de cuadro combinado. Si se
llama a este método 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 más información sobre la creación de formatos de estilo personalizados, consulte el
apartado “Personalización de los colores y el texto de los componentes” en el capítulo “Utilización
de componentes” de la publicación Utilización de Flash.
Ejemplo
En el código siguiente se establece la propiedad arrow de comboBox1 en 0x000000 (negro).
comboBox1.setStyleProperty("arrow", 0x000000);
Véase también
FStyleFormat (objeto)
FComboBox.setValue
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.setValue(textoEditable)
Parámetros
textoEditable Cadena que especifica el texto que debe aparecer en el campo de texto de un
cuadro combinado editable.
Valor devuelto
Ninguno.
Descripción
Método; especifica el texto que aparece en el campo de entrada en la primera posición de un cuadro
combinado editable. Si llama a este método, el usuario sigue pudiendo especificar texto en el campo.
Diccionario de ActionScript
171
Este método puede utilizarse solamente con cuadros combinados editables. Antes de llamar a este
método, debe especificar true para el parámetro Editable (que tiene como valor predeterminado
false) durante la edición, o utilizar FComboBox.setEditable para establecer el parámetro en true.
Ejemplo
En el código siguiente se especifica la cadena Gabino en el primer campo del cuadro combinado
surnameMenu.
surnameMenu.setValue("Gabino");
Véase también
FComboBox.getValue
FComboBox.sortItemsBy
Disponibilidad
Flash Player 6.
Sintaxis
myComboBox.sortItemsBy(nombreCampo, orden)
Parámetros
Cadena que especifica el nombre del campo utilizado para la clasificación. Este
valor normalmente será "label" o "data".
nombreCampo
Cadena que especifica si los elementos deben clasificarse en orden ascendente ("ASC") o
descendente ("DESC").
orden
Valor devuelto
Ninguno.
Descripción
Método; clasifica los elementos del cuadro combinado alfabética o numéricamente y en el orden
especificado mediante el nombre de campo especificado. Si los elementos de nombreCampo son
una combinación de cadenas de texto y enteros, los enteros aparecen en primer lugar. El
parámetro nombreCampo generalmente es label o data, pero puede especificar el valor primitivo
que mejor se adapte a sus necesidades.
Ejemplo
En el código 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");
Véase también
FComboBox.addItemAt, FComboBox.replaceItemAt, FComboBox.setDataProvider
172
FListBox (componente)
El componente ListBox del entorno de edición de Flash proporciona funciones de arrastrar y
soltar para agregar cuadros de lista desplazables de selección única y múltiple a los documentos de
Flash, además de proporcionar una interfaz de usuario para definir parámetros básicos. Los
métodos del componente FListBox permiten controlar cuadros de lista en tiempo de ejecución:
puede crear cuadros de lista, controlar cuadros de lista creados durante la edición, definir o
sustituir parámetros básicos y establecer opciones adicionales de tiempo de ejecución. No es
necesario que utilice un constructor para acceder a los métodos de los componentes.
Los métodos 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 parámetros
antes de pasarlos a los métodos.
El componente ListBox se admite en Flash Player 6 y en versiones posteriores de Flash Player.
Para obtener más información sobre la utilización del componente ListBox, la definición de
parámetros durante la edición y la modificación del color y el aspecto de los componentes,
consulte los apartados “Personalización de los colores y el texto de los componentes” y
“Personalización de aspectos de componentes” en el capítulo “Utilización de componentes” de la
publicación Utilización de Flash.
Resumen de métodos del componente FListBox
Método
Descripción
FListBox.addItem
Agrega un nuevo elemento al final del cuadro de lista.
FListBox.addItemAt
Agrega un nuevo elemento al cuadro de lista en el índice especificado.
FListBox.getEnabled
Devuelve true si el cuadro de lista está activado, y false si está
desactivado.
FListBox.getItemAt
Devuelve la etiqueta y el valor del elemento en el índice especificado.
FListBox.getLength
Devuelve el número de elementos del cuadro de lista.
FListBox.getRowCount
Devuelve el número de elementos visibles en el cuadro de lista.
FListBox.getScrollPosition
Devuelve el índice del elemento en la primera posición del cuadro de
lista.
FListBox.getSelectedIndex
Devuelve el índice del último elemento seleccionado.
FListBox.getSelectedIndices
Devuelve los índices de varios elementos seleccionados.
FListBox.getSelectedItem
Devuelve la etiqueta y el valor del elemento seleccionado.
FListBox.getSelectedItems
Devuelve la etiqueta y el valor de varios elementos seleccionados.
FListBox.getSelectMultiple
Devuelve true si se permite la selección múltiple y false si se permite
sólo una selección.
FListBox.getValue
Devuelve la etiqueta del elemento seleccionado o cualquier
información de datos asociados.
FListBox.registerSkinElement
Registra un elemento de aspecto en una propiedad.
FListBox.removeAll
Elimina todos los elementos del cuadro de lista.
FListBox.removeItemAt
Elimina el elemento en el índice especificado.
FListBox.replaceItemAt
Reemplaza la etiqueta y los datos de un elemento en el índice
especificado por una nueva etiqueta y nuevos datos.
Diccionario de ActionScript 173
Método
Descripción
FListBox.setAutoHideScrollBar
Determina si una barra de desplazamiento está oculta (true) o visible
(false) cuando el número de elementos del cuadro de lista no requiera
desplazamiento.
FListBox.setChangeHandler
Asigna una función a la que debe llamarse cada vez que cambie la
selección.
FListBox.setDataProvider
Asocia un objeto externo al cuadro de lista.
FListBox.setEnabled
Especifica si el cuadro de lista está activado (true) o desactivado
(false).
FListBox.setItemSymbol
Registra un identificador de vínculo de símbolos para ver elementos en
el cuadro de lista.
FListBox.setRowCount
Determina el número de elementos que deben verse en el cuadro de
lista.
FListBox.setScrollPosition
Hace que el cuadro de lista se desplace para que el elemento del índice
especificado se vea en la primera posición de la lista.
FListBox.setSelectedIndex
Selecciona el elemento en el índice especificado y actualiza el cuadro
de lista.
FListBox.setSelectedIndices
Selecciona los elementos en los índices especificados y actualiza el
cuadro de lista.
FListBox.setSelectMultiple
Determina si el usuario puede seleccionar más de un elemento de la
lista (true) o no (false).
FListBox.setSize
Establece la anchura y la altura del cuadro de lista, en píxeles.
FListBox.setStyleProperty
Establece una sola propiedad de estilo para un componente.
FListBox.setWidth
Establece la anchura del cuadro de lista, en píxeles.
FListBox.sortItemsBy
Ordena los elementos del cuadro de lista en orden alfabético o
numérico mediante la etiqueta o los datos.
FListBox.addItem
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.addItem(etiqueta [, datos])
Parámetros
etiqueta
datos
Cadena de texto que especifica el elemento que debe agregarse a la lista.
Valor asociado al elemento de lista. Este parámetro es opcional.
Valor devuelto
Ninguno.
Descripción
Método; 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 tamaño de la barra de desplazamiento. El
parámetro de datos puede ser cualquier objeto, cadena, valor booleano, entero o clip de película
de Flash.
174
Para obtener un rendimiento y un resultado de tiempo de carga óptimos, no agregue más de 400
elementos en un solo fotograma. Esto se aplica cuando agrega los elementos a uno o varios
cuadros de lista.
Ejemplo
En el código siguiente se agrega Lyvia a la lista de elementos visualizados en el cuadro de lista
coolGirls.
coolGirls.addItem("Lyvia");
En el código siguiente se agrega el número máximo de elementos recomendados en un solo
fotograma (400 elementos) a listBox1:
for (i=0; i<400; i++) {
listBox1.addItem(i);
}
En el código siguiente se agrega el número máximo 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);
}
Véase también
FListBox.addItemAt, FListBox.getItemAt, FListBox.removeItemAt,
FListBox.replaceItemAt, FListBox.sortItemsBy
FListBox.addItemAt
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.addItemAt(índice, etiqueta [, datos])
Parámetros
índice
Entero que especifica la posición de índice en la que debe agregar el elemento.
etiqueta
datos
Cadena de texto que especifica la etiqueta del elemento.
Valor asociado al elemento de lista. Este parámetro es opcional.
Valor devuelto
Ninguno.
Descripción
Método; agrega un nuevo elemento con la etiqueta especificada y los datos asociados (opcional)
en el índice especificado y actualiza el cuadro de lista. El parámetro de datos puede ser cualquier
objeto, cadena, valor booleano, entero o clip de película de Flash.
El componente ListBox utiliza un índice basado en cero, en el que el elemento en el índice 0
aparece en la primera posición de la lista.
Para obtener un rendimiento y un tiempo de carga óptimos, no agregue más 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 código 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 cómo cargar grandes cantidades de elementos, consulte
FListBox.addItem.
Véase también
FListBox.getSelectedItem, FListBox.removeItemAt, FListBox.replaceItemAt,
FListBox.sortItemsBy
FListBox.getEnabled
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.getEnabled()
Parámetros
Ninguno.
Valor devuelto
Valor booleano que indica si el cuadro de lista está activado (true) o desactivado (false).
Descripción
Método; indica si el cuadro de lista está activado.
Ejemplo
En el código siguiente se utiliza getEnabled para determinar si listMenu está activado o
desactivado y muestra el resultado en la ventana Salida.
trace(listMenu.getEnabled());
Véase también
FListBox.setEnabled
FListBox.getItemAt
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.getItemAt(índice)
Parámetros
índice
Entero que especifica el índice del elemento que debe recuperarse.
Valor devuelto
Un objeto o undefined.
176
Descripción
Método; devuelve el elemento en el índice especificado como un objeto con las propiedades
label y data. Si no hay ningún elemento en el índice especificado, el método devuelve
undefined.
El componente ListBox utiliza un índice basado en cero, en el que el elemento en el índice 0
aparece en la primera posición de la lista.
Ejemplo
En el código siguiente se devuelve la etiqueta del elemento en el índice 4 en listMenu1 en la
ventana Salida.
trace(listMenu1.getItemAt(4).label);
En el código 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 código 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));
Véase también
FListBox.getSelectedItem
FListBox.getLength
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.getLength()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve el número de elementos en el cuadro de lista.
Ejemplo
En el código siguiente se devuelve el número de elementos en phoneList.
phoneList.getLength();
Véase también
FListBox.setSize
Diccionario de ActionScript 177
FListBox.getRowCount
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.getRowCount()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve el número de filas visibles en el cuadro de lista. Este método es útil para
determinar cuántas filas se ven en un cuadro de lista con escala en píxeles.
Ejemplo
En el código siguiente se devuelve el número de filas visible en toyList y se establece el valor en
la variable rowCount.
var rowCount = toyList.getRowCount();
Véase también
FListBox.setRowCount, FListBox.setSize
FListBox.getScrollPosition
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.getScrollPosition()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve el índice del elemento que se encuentra actualmente en la primera posición de
la vista del cuadro de lista.
Ejemplo
En el código siguiente se devuelve el índice del elemento situado en la primera posición de
staffList.
staffList.getScrollPosition();
Véase también
FListBox.setScrollPosition
178
FListBox.getSelectedIndex
Disponibilidad
Flash Player 5
Sintaxis
myListBox.getSelectedIndex()
Parámetros
Ninguno.
Valor devuelto
Un entero o undefined.
Descripción
Método; devuelve el índice del elemento seleccionado en un cuadro de lista de selección única, el
último elemento seleccionado en un cuadro de lista de selección múltiple, o undefined si no se
ha seleccionado ningún elemento. Para recuperar los índices de todos los elementos seleccionados
en un cuadro de lista de selección múltiple, utilice FListBox.getSelectedIndices.
Ejemplo
En el código siguiente se devuelve el índice del elemento seleccionado en el cuadro de lista de
selección única nationList.
nationList.getSelectedIndex();
Véase también
FListBox.setSelectedIndices, FListBox.setSelectMultiple
FListBox.getSelectedIndices
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.getSelectedIndices()
Parámetros
Ninguno.
Valor devuelto
Una matriz o undefined.
Descripción
Método; devuelve los índices de los elementos seleccionados en un cuadro de lista de selección
múltiple como una matriz, o devuelve undefined si no se ha seleccionado ningún elemento.
Ejemplo
En el código siguiente se devuelven los índices de los elementos seleccionados en el cuadro de lista
de selección múltiple groceryList como una matriz.
groceryList.getSelectedIndices();
Véase también
FListBox.getSelectedIndex, FListBox.setSelectMultiple
Diccionario de ActionScript 179
FListBox.getSelectedItem
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.getSelectedItem()
Parámetros
Ninguno.
Valor devuelto
Un objeto o undefined.
Descripción
Método; devuelve el elemento seleccionado actualmente como un objeto con las propiedades
label y data. Si se ha seleccionado más de un elemento, el método devuelve el último elemento
seleccionado; si no se ha seleccionado ningún elemento, el método devuelve undefined. Para
recuperar información sobre todos los elementos seleccionados en un cuadro de lista de selección
múltiple, utilice FListBox.getSelectedItems.
Ejemplo
En el código siguiente se devuelve la etiqueta del elemento seleccionado en listBox1.
trace(listBox1.getSelectedItem().label);
En el código siguiente se devuelven los datos o el valor asociado al elemento seleccionado en
listBox2.
trace(listBox2.getSelectedItem().data);
En el código siguiente se devuelve un objeto que contiene la etiqueta y el valor de datos asociados
al elemento seleccionado en listBox3.
trace(listBox3.getSelectedItem());
Véase también
FListBox.getItemAt
FListBox.getSelectedItems
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.getSelectedItems()
Parámetros
Ninguno.
Valor devuelto
Una matriz o undefined.
180
Descripción
Método; devuelve los elementos seccionados como una matriz de objetos con las propiedades
label y data, o devuelve undefined si no se ha seleccionado ningún elemento. Este método sólo
puede utilizarse para obtener los elementos seleccionados en un cuadro de lista de selección
múltiple. Para obtener información sobre el elemento seleccionado en un cuadro de lista de
selección única, utilice FListBox.getSelectedItem.
Ejemplo
En el código siguiente se recuperan los elementos seleccionados en wishList y se los almacena en
la variable myObjArray.
var myObjArray = wishList.getSelectedItems();
Véase también
FListBox.getSelectedItem, FListBox.setSelectMultiple
FListBox.getSelectMultiple
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.getSelectMultiple()
Parámetros
Ninguno.
Valor devuelto
Valor booleano.
Descripción
Método; indica si los usuarios pueden seleccionar varios elementos (true) o sólo un elemento
(false) en el cuadro de lista.
Ejemplo
En el código siguiente se comprueba si wishList permite la selección múltiple.
if (wishList.getSelectMultiple()) {
}
Véase también
FListBox.setSelectMultiple
Diccionario de ActionScript
181
FListBox.getValue
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.getValue()
Parámetros
Ninguno.
Valor devuelto
La etiqueta o los datos asociados a un elemento seleccionado.
Descripción
Método; devuelve información sobre el elemento seleccionado en el cuadro de lista. Si el elemento
no tiene datos especificados, este método devuelve la etiqueta del elemento; si el elemento tiene
datos asociados, este método devuelve los datos.
Ejemplo
En el código siguiente se devuelve la etiqueta del elemento seleccionado en nationList.
trace(nationList.getValue());
Véase también
FListBox.getItemAt
FListBox.registerSkinElement
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.registerSkinElement(elemento, propiedadEstilo)
Parámetros
elemento
Instancia de clip de película.
propiedadEstilo
Nombre de una propiedad de FStyleFormat.
Valor devuelto
Ninguno.
Descripción
Método; 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 (Léame) de cada aspecto de
la biblioteca.
Los componentes están 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 método para registrar propiedades y elementos de aspecto personalizados en aspectos
de componentes de la interfaz de usuario de Flash o personalizados editando el código del primer
fotograma de la capa Read Me (Léame) 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 más información, consulte el apartado “Personalización de aspectos de
componentes” en el capítulo “Utilización de componentes” de la publicación Utilización de Flash.
Ejemplo
En el código siguiente se registra el elemento de aspecto personalizado boundBox_mc en la
propiedad background del primer fotograma de la capa Read Me (Léame) del aspecto
FBoundingBox en la carpeta Global Skins de la biblioteca.
toysMenu.registerSkinElement(boundBox_mc, "background");
Véase también
FStyleFormat (objeto)
FListBox.removeAll
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.removeAll()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; elimina todos los elementos del cuadro de lista, lo actualiza y cambia el tamaño de la
barra de desplazamiento.
Ejemplo
En el código siguiente se eliminan todos los elementos de wishList.
wishList.removeAll();
Véase también
FListBox.removeItemAt
Diccionario de ActionScript 183
FListBox.removeItemAt
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.removeItemAt(índice)
Parámetros
índice
Entero que especifica el índice del elemento que debe eliminarse.
Valor devuelto
Nada o undefined.
Descripción
Método; elimina el elemento en el índice especificado, actualiza los índices de los elementos de
lista que van después del elemento eliminado para mostrar la nueva posición en la lista y, a
continuación, actualiza el cuadro de lista y cambia el tamaño de la barra de desplazamiento. Si no
existe ningún elemento en el índice especificado, este método devuelve undefined.
El componente ListBox utiliza un índice basado en cero, en el que el elemento en el índice 0
aparece en la primera posición de la lista.
Ejemplo
En el código siguiente se elimina el quinto elemento de la lista en wishList.
wishList.removeItemAt(4);
Véase también
FListBox.addItemAt
FListBox.replaceItemAt
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.replaceItemAt(índice, etiqueta [,datos])
Parámetros
índice
Entero que especifica la posición de un elemento de lista.
etiqueta
Cadena que especifica una nueva etiqueta para el elemento de lista.
Nuevo valor que debe asociarse al elemento de lista. Este parámetro es opcional; si no lo
especifica, se mantienen los datos asociados al elemento.
datos
Valor devuelto
Ninguno.
Descripción
Método; 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
parámetro 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 posición de la lista.
Ejemplo
En el código 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 sería Perro (lo que
sería incorrecto, puesto que el valor es Gato).
Favorites.replaceItemAt(4, "Suerte", "Gato");
Véase también
FListBox.addItemAt, FListBox.getItemAt
FListBox.setAutoHideScrollBar
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.setAutoHideScrollBar(ocultarBarra)
Parámetros
Valor booleano que especifica si la barra de desplazamiento está oculta cuando
no es necesaria (true) o si siempre se visualiza (false).
ocultarBarra
Valor devuelto
Ninguno.
Descripción
Método; especifica si la barra de desplazamiento está oculta cuando el número 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 método se establece en false y el número de elementos no requiere
una barra de desplazamiento, la barra de desplazamiento se muestra desactivada (en color más claro).
Ejemplo
En el código siguiente se oculta la barra de desplazamiento de wishList cuando puede verse el
número de elementos del cuadro de lista sin desplazar su contenido.
wishList.setAutoHideScrollBar(true);
FListBox.setChangeHandler
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.setChangeHandler(nombreFunción, [ubicación])
Parámetros
nombreFunción Cadena que especifica el nombre de la función del controlador que debe
ejecutarse cuando cambia la selección en el cuadro de lista. Si no se especifica el parámetro
ubicación, esta función debe encontrarse en la misma línea de tiempo que la instancia del
componente.
Diccionario de ActionScript 185
ubicación Referencia de ruta a un objeto de datos, clip de película o línea de tiempo que
contiene la función especificada. Este parámetro es opcional y tiene como valor predeterminado la
línea de tiempo principal del componente.
Valor devuelto
Ninguno.
Descripción
Método; especifica un controlador de cambios al que debe llamarse cuando cambia la selección
del cuadro de lista. Puede especificar la misma función del controlador de cambios para más de un
componente: la función siempre acepta como parámetro la instancia del componente que ha
cambiado. Si se llama a este método, se sustituye el valor del parámetro de controlador de cambios
especificado en la edición.
Para obtener más información, consulte el apartado “Programación de funciones del controlador
de cambios para componentes” en el capítulo “Utilización de componentes” de la publicación
Utilización de Flash.
Ejemplo
En el código siguiente se especifica myHandler como función a la que se llama cuando cambia el
valor de listBox1. Puesto que no se especifica el parámetro ubicación, myHandler debe
encontrarse en la misma línea de tiempo que la instancia del componente.
El parámetro component de myHandler se rellena automáticamente 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 función ubicada en una línea de tiempo tres niveles
por encima de la línea de tiempo del componente, la primera línea del código sería similar a la
siguiente:
listBox1.setChangeHandler("myHandler", _parent._parent._parent);
En el código siguiente se crea la función myHandler en una instancia de myObject (cuya clase es
Object) y, a continuación, se especifica myHandler como función 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)
Parámetros
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.
Descripción
Método; 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 símbolo de DataProvider de la carpeta FlashUIComponents/CoreAssets/ClassTree en la
biblioteca. La interfaz API de DataProvider está destinada sólo para usuarios avanzados y
programadores; los demás usuarios deben utilizar una matriz o un objeto Array.
Ejemplo
En el código siguiente se especifica el objeto Array writerList como proveedor de datos para
listBox1.
listBox1.setDataProvider(writerList);
En el código 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 código 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 código siguiente se especifica editorList, una instancia de la clase DataProvider, como
proveedor de datos de listBox1.
listBox1.setDataProvider(editorList);
En el código siguiente se crea una nueva instancia de la clase DataProvider y, a continuación, se
agregan las etiquetas del elemento mediante el método addItem de DataProvider.
Nota: el método addItem sólo es un método de la clase DataProvider. Los programadores interesados en utilizar la
clase DataProvider deben consultar el símbolo DataProvider en la carpeta FlashUIComponents/CoreAssets/
ClassTree en la biblioteca antes de intentar utilizar los métodos.
editorList = new DataProviderClass();
editorList.addItem("Anne");
editorList.addItem("Rosana");
editorList.addItem("Lisa");
editorList.addItem("Rebecca");
Véase también
FListBox.addItem, FListBox.replaceItemAt, FListBox.sortItemsBy
FListBox.setEnabled
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.setEnabled(activación)
Parámetros
Valor booleano que especifica si el cuadro de lista está activado (true) o
desactivado (false).
activación
Valor devuelto
Ninguno.
Descripción
Método; especifica si el cuadro de lista está activado (true) o desactivado (false). Si un cuadro
de lista está desactivado, no acepta la interacción del usuario mediante el teclado o el ratón. Si
omite este parámetro, este método toma como valor predeterminado true.
Ejemplo
En el código siguiente se desactiva interestList.
interestList.setEnabled(false);
Véase también
FListBox.getEnabled
188
FListBox.setItemSymbol
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.setItemSymbol(IDsímbolo)
Parámetros
Identificador de vínculo de un símbolo gráfico para visualizar el contenido del
cuadro de lista.
IDsímbolo
Valor devuelto
Ninguno.
Descripción
Método; registra un símbolo gráfico para visualizar los elementos del cuadro de lista. El valor
predeterminado es el símbolo FListBoxItem de la biblioteca. Este método está destinado a
usuarios avanzados y programadores.
FListBox.setRowCount
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.setRowCount(filas)
Parámetros
filas
Número máximo de filas que se visualiza en el cuadro de lista.
Valor devuelto
Ninguno.
Descripción
Método; especifica el número de elementos que se visualiza en el cuadro de lista. Si utiliza este
método, 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 parámetro de número de filas
establecido durante la edición. Por lo tanto, si llama a este método después de llamar a
FListBox.setRowCount, la película pasará por alto el valor de rowCount y establecerá la altura
del cuadro de lista en píxeles.
Ejemplo
En el código siguiente se establece en 4 el número de elementos que se visualiza en toyList.
toyList.setRowCount(4);
Véase también
FListBox.getRowCount, FListBox.setSize
Diccionario de ActionScript 189
FListBox.setScrollPosition
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.setScrollPosition(índice)
Parámetros
Entero que especifica el índice del elemento que debe visualizarse en la primera posición
del cuadro de lista.
índice
Valor devuelto
Ninguno.
Descripción
Método; hace que el cuadro de lista se desplace para que el elemento especificado se visualice en la
primera posición.
El componente ListBox utiliza un índice basado en cero, en el que el elemento en el índice 0
aparece en la primera posición de la lista.
Ejemplo
En el código siguiente se visualiza el quinto elemento de toyList en la primera posición de la
lista.
toyList.setScrollPosition(4);
Véase también
FListBox.getScrollPosition
FListBox.setSelectedIndex
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.setSelectedIndex(índice)
Parámetros
índice
Entero que especifica el índice del elemento que debe seleccionarse en el cuadro de lista.
Valor devuelto
Ninguno.
Descripción
Método; 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 posición de la lista.
Ejemplo
En el código siguiente se selecciona el quinto elemento del cuadro de lista.
toyList.setSelectedIndex(4);
190
Véase también
FListBox.getSelectedIndex, FListBox.getSelectedIndices
FListBox.setSelectedIndices
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.setSelectedIndices(matrizÍndices)
Parámetros
matrizÍndices
Matriz de índices de los elementos que se seleccionan en el cuadro de lista.
Valor devuelto
Ninguno.
Descripción
Método; 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 posición de la lista.
Ejemplo
En el código siguiente se crea una matriz llamada myArray, que especifica los elementos que
deben seleccionarse en toyList y, a continuación, pasa la matriz al método
setSelectedIndices.
var myArray = new Array (1,4,5,7);
toyList.setSelectedIndices(myArray);
Véase también
FListBox.getSelectedIndices
FListBox.setSelectMultiple
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.setSelectMultiple(selecciónMúltiple)
Parámetros
selecciónMúltiple Valor booleano que especifica el modo de selección múltiple (true) o
modo de selección única (false).
Valor devuelto
Ninguno.
Descripción
Método; especifica si los usuarios pueden seleccionar varios elementos (true) o sólo un elemento
(false) en el cuadro de lista. El valor predeterminado es false. Si se llama a este método, se
sustituye el valor del parámetro de selección múltiple establecido durante la edición.
Diccionario de ActionScript
191
Ejemplo
En el código siguiente se activa la selección múltiple para toyList.
toyList.setSelectMultiple(true);
FListBox.setSize
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.setSize(anchura, altura)
Parámetros
Entero que especifica la anchura del cuadro de lista, en píxeles.
anchura
Entero que especifica la altura del cuadro de lista, en píxeles.
altura
Valor devuelto
Ninguno.
Descripción
Método; cambia el tamaño del cuadro de lista en tiempo de ejecución por la anchura y la altura
especificados. Si se llama a este método, se sustituye el valor del parámetro de número de filas
establecido durante la edición. Por lo tanto, si llama a este método después de llamar a
FListBox.setRowCount, la película establecerá la altura del cuadro de lista en píxeles 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 código siguiente se cambia el tamaño de phoneList para que mida 200 píxeles de ancho y
50 píxeles de alto.
phoneList.setSize(200, 50);
Véase también
FListBox.setRowCount, FListBox.setWidth
FListBox.setStyleProperty
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.setStyleProperty(propiedadEstilo, valor)
Parámetros
propiedadEstilo
valor
Valor que se establece para la propiedad.
Valor devuelto
Ninguno.
192
Cadena que especifica una propiedad del objeto FStyleFormat.
Descripción
Método; establece una propiedad FStyleFormat para una instancia de cuadro de lista. Si se llama a
este método 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 más información sobre la creación de formatos de estilo personalizados, consulte el
apartado “Personalización de los colores y el texto de los componentes” en el capítulo “Utilización
de componentes” de la publicación Utilización de Flash.
Ejemplo
En el código siguiente se establece la propiedad shadow de listBox1 en 0x000000 (negro).
listBox1.setStyleProperty("shadow", 0x000000);
Véase también
FStyleFormat (objeto)
FListBox.setWidth
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.setWidth(anchura)
Parámetros
anchura
Entero que especifica la anchura del cuadro de lista, en píxeles.
Valor devuelto
Ninguno.
Descripción
Método; especifica la anchura del cuadro de lista, en píxeles. Este método es útil para establecer la
anchura del cuadro de lista cuando se utiliza FListBox.setRowCount para determinar la altura.
Ejemplo
En el código siguiente se establece la anchura del cuadro de lista toyList en 500 píxeles.
toyList.setWidth(500);
Véase también
FListBox.setSize
FListBox.sortItemsBy
Disponibilidad
Flash Player 6.
Sintaxis
myListBox.sortItemsBy(nombreCampo, orden)
Diccionario de ActionScript 193
Parámetros
Cadena que especifica el nombre del campo utilizado para la clasificación. Este
valor normalmente será "label" o "data".
nombreCampo
Cadena que especifica si los elementos deben clasificarse en orden ascendente ("ASC") o
descendente ("DESC").
orden
Valor devuelto
Ninguno.
Descripción
Método; clasifica los elementos del cuadro de lista alfabética o numéricamente y en el orden
especificado mediante el nombre de campo especificado. Si los elementos de nombreCampo son
una combinación de cadenas de texto y enteros, los enteros aparecen en primer lugar. El
parámetro 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 código 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");
Véase también
FListBox.addItemAt, FListBox.replaceItemAt
_focusrect
Disponibilidad
Flash Player 4.
Sintaxis
_focusrect = booleano;
Descripción
Propiedad (global); especifica si aparece un rectángulo amarillo alrededor del botón que está
resaltado mediante el teclado. El valor predeterminado, true, muestra un rectángulo amarillo
alrededor del botón o campo de texto resaltado a medida que el usuario presiona la tecla de
tabulación para desplazarse por los objetos de una película. Especifique false si no desea visualizar
el rectángulo amarillo. Ésta es una propiedad global que puede sustituirse para instancias específicas.
Véase también
Button._focusrect
for
Disponibilidad
Flash Player 5.
Sintaxis
for(init; condición; siguiente) {
sentencia(s);
}
194
Parámetros
Expresión que debe comprobarse antes de que comience la secuencia de bucle, normalmente
una expresión de asignación. También se permite una sentencia var para este parámetro.
init
Una expresión que da como resultado true o false. La condición se comprueba
antes de cada repetición del bucle; el bucle finaliza cuando la condición da como resultado false.
condición
Expresión que debe comprobarse después de cada repetición del bucle;
normalmente se trata de una expresión de asignación que utiliza los operadores ++ (incremento) o
-- (decremento).
siguiente
sentencia(s)
Instrucción o instrucciones que deben ejecutarse en el cuerpo del bucle.
Descripción
Acción; una construcción de bucle que comprueba la expresión init (inicializar) una vez y
después comienza una secuencia de bucle por medio de la cual, siempre que la condición
equivalga a true, se ejecuta sentencia y se comprueba la siguiente expresión.
Las acciones for o for..in no pueden enumerar algunas propiedades. Por ejemplo, los métodos
incorporados del objeto Array (Array.sort y Array.reverse) no se incluyen en la enumeración
de un objeto Array y las propiedades de clip de película, 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 continuación se muestra un ejemplo de la utilización de for para realizar la misma acción
repetidamente. En el código siguiente, el bucle for agrega los números de 1 a 100:
var sum = 0;
for (var i=1; i<=100; i++) {
sum = sum + i;
}
Véase también
++ (incremento), –– (decremento), for..in, var
Diccionario de ActionScript 195
for..in
Disponibilidad
Flash Player 5.
Sintaxis
for(variableRepetición in objeto){
sentencia(s);
}
Parámetros
variableRepetición Nombre de una variable que actúa como repetidor, haciendo referencia a
cada propiedad de un objeto o elemento de una matriz.
objeto
Nombre de un objeto que debe repetirse.
sentencias(s)
Instrucción que debe ejecutarse para cada repetición.
Valor devuelto
Ninguno.
Descripción
Acción; 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 métodos
incorporados del objeto Array (Array.sort y Array.reverse) no se incluyen en la enumeración
de un objeto Array y las propiedades de clip de película, como por ejemplo _x e _y, no se enumeran.
La construcción 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, también repetirá las propiedades de principal.
La acción for..in enumera todos los objetos de la cadena prototipo de un objeto. Primero se
enumeran las propiedades del objeto, después las propiedades del prototipo inmediato, las
propiedades del prototipo del prototipo y así sucesivamente. La acción 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 acción for..in llamada en secundario enumerará prop
en secundario, pero pasará por alto el de principal.
Ejemplo
A continuación se muestra un ejemplo de la utilización 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 continuación:
myObject.name = Tara
myObject.age = 27
myObject.city = San Francisco
196
A continuación se muestra un ejemplo de la utilización 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 película secundario llamado " + name);
}
}
El ejemplo siguiente enumera los elementos secundarios de un clip de película y envía cada uno al
fotograma 2 de sus respectivas líneas de tiempo. El clip de película 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 edición de Flash proporciona funciones de arrastrar y
soltar para agregar botones a los documentos de Flash, además de proporcionar una interfaz de
usuario para definir parámetros básicos. Los métodos del componente FPushButton permiten
controlar botones en tiempo de ejecución: puede crear botones, controlar botones creados durante la
edición, definir o sustituir parámetros básicos y definir opciones adicionales en tiempo de ejecución.
No es necesario que utilice un constructor para acceder a los métodos de los componentes.
El componente PushButton acepta todas las interacciones estándar mediante el teclado o el ratón.
Puede utilizar los métodos de FPushButton para especificar una función de controlador para
botones de comando, activar o desactivar botones y cambiar el tamaño de los botones sin
distorsión en tiempo de ejecución.
Los métodos 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 parámetros
antes de pasarlos a los métodos.
El componente PushButton se admite en Flash Player 6 y en versiones posteriores de Flash Player.
Para obtener más información sobre la utilización del componente PushButton, la definición de
parámetros durante la edición y la modificación del color y el aspecto de los componentes,
consulte los apartados “Personalización de los colores y el texto de los componentes” y
“Personalización de aspectos de componentes” en el capítulo “Utilización de componentes” de la
publicación Utilización de Flash.
Diccionario de ActionScript 197
Resumen de métodos del componente FPushButton
Método
Descripción
FPushButton.getEnabled
Devuelve true si el botón está activado y false si está desactivado.
FPushButton.getLabel
Devuelve la etiqueta del botón como una cadena.
FPushButton.registerSkinElement
Registra un elemento de aspecto en una propiedad.
FPushButton.setClickHandler
Especifica la función a la que se llama cuando el usuario suelta el botón.
FPushButton.setEnabled
Determina si el botón está activado o desactivado.
FPushButton.setLabel
Establece la etiqueta del botón en tiempo de ejecución.
FPushButton.setSize
Establece la altura y la anchura del botón en píxeles.
FPushButton.setStyleProperty
Establece una sola propiedad de estilo para un componente.
FPushButton.getEnabled
Disponibilidad
Flash Player 6.
Sintaxis
myPushButton.getEnabled()
Parámetros
Ninguno.
Valor devuelto
Valor booleano.
Descripción
Método; devuelve true si la instancia del botón de comando está activada y false si está desactivada.
Ejemplo
En el código siguiente se devuelve el estado de activación del botón de comando submit en la
ventana Salida.
trace(submit.getEnabled());
Véase también
FPushButton.setEnabled
198
FPushButton.getLabel
Disponibilidad
Flash Player 6.
Sintaxis
myPushButton.getLabel()
Parámetros
Ninguno.
Valor devuelto
Una cadena.
Descripción
Método; devuelve la etiqueta de texto en el botón de comando como una cadena.
Ejemplo
En el código siguiente se devuelve la etiqueta del botón de comando buttonPage1 en la ventana
Salida.
trace(buttonPage1.getLabel());
Véase también
FPushButton.setLabel
FPushButton.registerSkinElement
Disponibilidad
Flash Player 6.
Sintaxis
myPushButton.registerSkinElement(elemento, propiedadEstilo)
Parámetros
elemento
Instancia de clip de película.
propiedadEstilo
Nombre de una propiedad de FStyleFormat.
Valor devuelto
Ninguno.
Descripción
Método; 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 (Léame) de cada aspecto de
la biblioteca.
Los componentes están 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 método para registrar propiedades y elementos de aspecto personalizados en aspectos
de componentes de la interfaz de usuario de Flash o personalizados editando el código del primer
fotograma de la capa Read Me (Léame) 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 más información, consulte el apartado “Personalización de aspectos de
componentes” en el capítulo “Utilización de componentes” de la publicación Utilización de Flash.
Ejemplo
En el código siguiente se registra el elemento de aspecto personalizado newFace_mc en la
propiedad face del primer fotograma de la capa Read Me (Léame) del aspecto FLabel. El aspecto
FLabel se encuentra en la carpeta Component Skins/Global Skins de la biblioteca.
submitButton.registerSkinElement(newFace_mc, "face");
Véase también
FStyleFormat (objeto)
FPushButton.setClickHandler
Disponibilidad
Flash Player 6.
Sintaxis
myPushButton.setClickHandler(nombreFunción, [ubicación])
Parámetros
nombreFunción Cadena que especifica la función del controlador que debe ejecutarse cuando el
usuario suelta el botón. Si no se especifica el parámetro ubicación, esta función debe encontrarse
en la misma línea de tiempo que la instancia del componente.
ubicación Referencia de ruta a un objeto de datos, clip de película o línea de tiempo que
contiene la función especificada. Este parámetro es opcional y tiene como valor predeterminado la
línea de tiempo principal del componente.
Valor devuelto
Ninguno.
Descripción
Método; especifica una función del controlador a la que debe llamarse cuando el usuario suelta el
botón. Puede especificar la misma función del controlador para más de un componente: la
función siempre acepta la instancia del componente que ha cambiado como un parámetro. Si se
llama a este método, se sustituye el valor del parámetro del controlador de acción del ratón
especificado durante la edición.
Para obtener más información, consulte el apartado “Programación de funciones del controlador
de cambios para componentes” en el capítulo “Utilización de componentes” de la publicación
Utilización de Flash.
200
Ejemplo
El código siguiente especifica onClick como función a la que se llama cuando cambia el valor de
button1. Puesto que no se especifica el parámetro ubicación, onClick debe encontrarse en la
misma línea de tiempo que la instancia del componente. El parámetro component en onClick se
rellena automáticamente 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 botón, la etiqueta
del botón aparece en la ventana Salida.
button1.setClickHandler("onClick");
function onClick(component){
trace(component._name);
}
Si en el ejemplo anterior onClick es una función ubicada en una línea de tiempo tres niveles por
encima de la línea de tiempo del componente, la primera línea del código sería similar a la siguiente:
button1.setChangeHandler("onClick", _parent._parent._parent);
En el código siguiente se crea la función onClick en una instancia de myObject (cuya clase es
Object) y, a continuación, se especifica onClick como función 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(activación)
Parámetros
Valor booleano que especifica si el botón de comando está activado (true) o
desactivado (false).
activación
Valor devuelto
Ninguno.
Descripción
Método; determina si el botón de comando está activado. Si un botón de comando está
desactivado, no acepta la interacción del usuario mediante el teclado o el ratón y el texto del
botón aparece en color más claro. Omitir el parámetro equivale a pasar true.
Ejemplo
En el código siguiente se desactiva button1.
button1.setEnabled(false);
Véase también
FPushButton.getEnabled
Diccionario de ActionScript 201
FPushButton.setLabel
Disponibilidad
Flash Player 6.
Sintaxis
myPushButton.setLabel(etiqueta)
Parámetros
etiqueta
Cadena que contiene el texto que debe aparecer en el botón de comando.
Valor devuelto
Ninguno.
Descripción
Método; aplica una etiqueta de texto al botón de comando en tiempo de ejecución. Si se llama a
este método, se sustituye el valor del parámetro etiqueta especificado durante la edición.
Ejemplo
En el código siguiente se aplica la etiqueta Cleveland Rocks! en voteButton.
voteButton.setLabel("Cleveland Rocks!");
Véase también
FPushButton.getLabel
FPushButton.setSize
Disponibilidad
Flash Player 6.
Sintaxis
myPushButton.setSize(anchura, altura)
Parámetros
Entero que especifica la anchura del botón, en píxeles.
anchura
altura
Entero que especifica la altura del botón, en píxeles.
Valor devuelto
Ninguno.
Descripción
Método; establece la anchura y la altura del botón en tiempo de ejecución. Si se llama a este
método, se sustituyen los cambios de tamaño o de escala aplicados durante la edición. Para
obtener más información, consulte el apartado “Definición del tamaño de los componentes
PushButton” en el capítulo “Utilización de componentes” de la publicación Utilización de Flash.
Ejemplo
En el código siguiente se cambia el tamaño de submitButton por 100 x 50 píxeles en tiempo de
ejecución.
submitButton.setSize(100, 50);
202
FPushButton.setStyleProperty
Disponibilidad
Flash Player 6.
Sintaxis
myPushButton.setStyleProperty(propiedadEstilo, valor)
Parámetros
propiedadEstilo
valor
Cadena que especifica una propiedad del objeto FStyleFormat.
Valor que se establece para la propiedad.
Valor devuelto
Ninguno.
Descripción
Método; establece una propiedad FStyleFormat para una instancia de botón de comando
determinada. Si se llama a este método 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 más información sobre la creación de formatos de estilo personalizados, consulte el
apartado “Personalización de los colores y el texto de los componentes” en el capítulo “Utilización
de componentes” de la publicación Utilización de Flash.
Ejemplo
En el código siguiente se establece la propiedad face de submitButton en 0xffffff (blanco).
submitButton.setStyleProperty("face", 0xffffff);
Véase también
FStyleFormat (objeto)
FRadioButton (componente)
Los botones de opción son grupos de botones seleccionables de los que sólo se puede seleccionar
uno cada vez. El componente RadioButton del entorno de edición de Flash proporciona
funciones de arrastrar y soltar para agregar grupos de botones de opción a los documentos de
Flash, además de proporcionar una interfaz de usuario para definir parámetros básicos. Los
métodos del componente FRadioButton permiten controlar botones de opción en tiempo de
ejecución: puede crear botones de opción, controlar botones de opción creados durante la
edición, definir o sustituir parámetros básicos y establecer opciones de tiempo de ejecución. No es
necesario que utilice un constructor para acceder a los métodos de los componentes.
El componente RadioButton se admite en Flash Player 6 y en versiones posteriores de Flash Player.
Los métodos 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 parámetros
antes de pasarlos a los métodos.
Para obtener más información sobre la utilización del componente RadioButton, la definición de
parámetros durante la edición y la modificación del color y el aspecto de los componentes,
consulte los apartados “Personalización de los colores y el texto de los componentes” y
“Personalización de aspectos de componentes” en el capítulo “Utilización de componentes” de la
publicación Utilización de Flash.
Diccionario de ActionScript 203
Resumen de métodos del componente FRadioButton
Método
Descripción
FRadioButton.getData
Devuelve un valor de datos para una instancia de botón de opción.
FRadioButton.getEnabled
Devuelve true si el botón de opción está activado y false si está
desactivado.
FRadioButton.getLabel
Devuelve la etiqueta del botón de opción como una cadena.
FRadioButton.getState
Devuelve el estado seleccionado de una instancia de botón de opción.
FRadioButton.getValue
Devuelve el valor de datos del botón de opción seleccionado en un
grupo, o devuelve la etiqueta si no se han especificado datos.
FRadioButton.registerSkinElement
Registra un elemento de aspecto en una propiedad de estilo.
FRadioButton.setChangeHandler
Especifica una función a la que se debe llamar cuando cambia la
selección del botón de opción.
FRadioButton.setData
Establece los datos asociados a una instancia de botón de opción.
FRadioButton.setEnabled
Determina si el botón de opción está activado o desactivado.
FRadioButton.setGroupName
Especifica un nombre de grupo para una instancia de botón de
opción, o establece un nuevo nombre para un grupo de botones de
opción.
FRadioButton.setLabel
Aplica una etiqueta para el botón de opción en tiempo de ejecución.
FRadioButton.setLabelPlacement
Especifica si la etiqueta aparece a la izquierda o a la derecha del
botón de opción.
FRadioButton.setSize
Establece la anchura del botón de opción, en píxeles.
FRadioButton.setState
Establece el estado seleccionado de la instancia de botón de opción.
FRadioButton.setStyleProperty
Establece una sola propiedad de estilo para una instancia de
componente.
FRadioButton.setValue
Selecciona un botón de opción en un grupo de botones de opción
en tiempo de ejecución.
FRadioButton.getData
Disponibilidad
Flash Player 6.
Sintaxis
myRadioButton.getData()
Parámetros
Ninguno.
Valor devuelto
Una cadena.
Descripción
Método; devuelve los datos asociados a la instancia de botón de opción especificada. Utilice
FRadioButton.getValue para obtener los datos asociados al botón de opción seleccionado en un
grupo de botones de opción.
Ejemplo
En el código siguiente se devuelven los datos asociados al botón de opción flashRadio en la
ventana Salida.
trace(flashRadio.getData());
204
Véase también
FRadioButton.setData
FRadioButton.getEnabled
Disponibilidad
Flash Player 6.
Sintaxis
myRadioButton.getEnabled()
myRadioButtonGroup.getEnabled()
Parámetros
Ninguno.
Valor devuelto
Un valor booleano o undefined.
Descripción
Método; indica si una instancia de botón de opción o un grupo de botones de opción están activados.
Sintaxis 1: indica si myRadioButton está activado (true) o desactivado (false).
Sintaxis 2: indica si los botones de myRadioButtonGroup están activados (true) o desactivados
(false). Si algunos botones del grupo están activados y otros están desactivados, el método
devuelve undefined.
Ejemplo
En el código siguiente se devuelve el estado de activación de radio1 en la ventana Salida.
trace(radio1.getEnabled());
Véase también
FRadioButton.setEnabled
FRadioButton.getLabel
Disponibilidad
Flash Player 6.
Sintaxis
myRadioButton.getLabel()
Parámetros
Ninguno.
Valor devuelto
Una cadena.
Descripción
Método; devuelve la etiqueta del botón de opción especificado como una cadena. No puede
utilizar este método para obtener las etiquetas de un grupo de botones de opción; la sintaxis
radioButtonGroup.getLabel no es válida.
Diccionario de ActionScript 205
Ejemplo
En el código siguiente se devuelve la etiqueta de la instancia radio2 en la ventana Salida.
trace(radio2.getLabel());
Véase también
FRadioButton.setLabel
FRadioButton.getState
Disponibilidad
Flash Player 6.
Sintaxis
myRadioButton.getState()
Parámetros
Ninguno.
Valor devuelto
Un valor booleano que indica el estado seleccionado del botón de opción.
Descripción
Método; devuelve un valor booleano que indica si myRadioButton está seleccionado (true) o no
(false).
Ejemplo
En el código siguiente se devuelve el estado seleccionado del botón de opción radio1 en la
ventana Salida.
trace(radio1.getState());
Véase también
FRadioButton.setState
FRadioButton.getValue
Disponibilidad
Flash Player 6.
Sintaxis
myRadioButtonGroup.getValue()
Parámetros
Ninguno.
Valor devuelto
Una cadena o undefined.
Descripción
Método; devuelve los datos asociados al botón de opción seleccionado en myRadioButtonGroup,
o la etiqueta del botón de opción si no se han especificado datos. Si no se ha seleccionado ningún
botón, el método devuelve undefined.
206
Ejemplo
En el código siguiente se devuelven los datos asociados al botón de opción seleccionado del grupo
radioGroup1 en la ventana Salida.
trace(radioGroup1.getValue());
Véase también
FRadioButton.setValue
FRadioButton.registerSkinElement
Disponibilidad
Flash Player 6.
Sintaxis
myRadioButton.registerSkinElement(elemento, propiedadEstilo)
Parámetros
elemento
Instancia de clip de película.
propiedadEstilo
Nombre de una propiedad de FStyleFormat.
Valor devuelto
Ninguno.
Descripción
Método; 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 (Léame) de cada aspecto de
la biblioteca.
Los componentes están 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 método para registrar propiedades y elementos de aspecto personalizados en aspectos
de componentes de la interfaz de usuario de Flash o personalizados editando el código del primer
fotograma de la capa Read Me (Léame) 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 más información, consulte el apartado “Personalización de aspectos de
componentes” en el capítulo “Utilización de componentes” de la publicación Utilización de Flash.
Ejemplo
En el código 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");
Véase también
FStyleFormat (objeto)
Diccionario de ActionScript 207
FRadioButton.setChangeHandler
Disponibilidad
Flash Player 6.
Sintaxis
myRadioButton.setChangeHandler(nombreFunción, [ubicación])
myRadioButtonGroup.setChangeHandler(nombreFunción, [ubicación])
Parámetros
Cadena que especifica el nombre de la función del controlador que debe ejecutarse
cuando cambia el valor de un botón de opción. Si no se especifica el parámetro ubicación, esta
función debe encontrarse en la misma línea de tiempo que la instancia del componente.
nombreFunción
ubicación Referencia a un objeto de datos, un clip de película o una línea de tiempo que
contiene la función especificada. Este parámetro es opcional y tiene como valor predeterminado la
línea de tiempo principal del componente.
Valor devuelto
Ninguno.
Descripción
Método; especifica una función del controlador de cambios a la que debe llamarse cuando cambia
la selección del botón de opción. Puede especificar la misma función del controlador de cambios
para más de un componente; la función siempre acepta la instancia del componente que ha
cambiado como parámetro. Si se llama a este método, se sustituye el valor del parámetro de
controlador de cambios especificado en la edición.
Sintaxis 1: especifica la función a la que se debe llamar si la instancia de botón de opción
myRadioButton está seleccionada o deseleccionada.
Sintaxis 2: especifica la función a la que se debe llamar si cambia el botón de opción seleccionado
en el grupo radioButtonGroup. Especificar una función para un grupo de botones de opción
equivale a especificar la misma función para todos los botones de opción del grupo por separado
con myRadioButton.setChangeHandler.
Para obtener más información, consulte el apartado “Programación de funciones del controlador
de cambios para componentes” en el capítulo “Utilización de componentes” de la publicación
Utilización de Flash.
Ejemplo
Sintaxis 1: en el código siguiente se especifica myHandler como función a la que se llama cuando
se selecciona radio1.
radio1.setChangeHandler("myHandler");
Sintaxis 2: en el código siguiente se especifica onChange como función a la que se llama cuando se
selecciona un botón de opción del grupo radioGroup1.
radioGroup1.setChangeHandler("onChange");
208
En el código siguiente se especifica onChange como función a la que se debe llamar cuando el
usuario selecciona un botón de opción de radioGroup1. Puesto que no se especifica el parámetro
ubicación, onChange debe encontrarse en la misma línea de tiempo que la instancia del
componente. El parámetro component de onChange se establece automáticamente 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 botón de
opción del grupo. Las acciones definidas en onChange especifican que cuando el usuario
selecciona un botón de opción, 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 función ubicada en una línea de tiempo tres niveles por
encima de la línea de tiempo del componente, la primera línea del código sería similar a la siguiente:
radioGroup1.setChangeHandler("onChange", _parent._parent._parent);
En el código siguiente se crea la función onChange en una instancia de myObject (cuya clase es
Object) y, a continuación, se especifica onChange como función 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")
Parámetros
datos
Datos que desea asociar a la instancia de botón de opción.
Valor devuelto
Ninguno.
Descripción
Método; especifica los datos que deben asociarse a la instancia de botón de opción. Si se llama a
este método, se sustituye el valor del parámetro de datos establecido durante la edición.
Ejemplo
En el código siguiente se especifican los datos ActionScript para la instancia de botón de opción
flashRadio.
flashRadio.setData("ActionScript");
Véase también
FRadioButton.getData, FRadioButton.setValue
Diccionario de ActionScript 209
FRadioButton.setEnabled
Disponibilidad
Flash Player 6.
Sintaxis
myRadioButton.setEnabled(activación)
myRadioButtonGroup.setEnabled(activación)
Parámetros
activación Valor booleano que especifica si un botón de opción determinado o todos los
botones de un grupo están activados (true) o desactivados (false).
Valor devuelto
Ninguno.
Descripción
Método; activa y desactiva botones de opción en tiempo de ejecución.
Sintaxis 1: especifica si myRadioButton está activado (true) o desactivado (false).
Sintaxis 2: especifica si todos los botones de opción con el nombre de grupo radioButtonGroup
están activados (true) o desactivados (false). Llamar a este método sin pasar ningún parámetro
equivale a pasar el parámetro true.
Ejemplo
Sintaxis 1: en el código siguiente se desactiva un botón de opción radio1 sin desactivar los demás
botones del grupo.
radio1.setEnabled(false);
Sintaxis 2: en el código siguiente se desactivan todos los botones de opción del grupo
radioGroup1.
radioGroup1.setEnabled(false);
Véase también
FRadioButton.getEnabled
FRadioButton.setGroupName
Disponibilidad
Flash Player 6.
Sintaxis
myRadioButton.setGroupName(nombreGrupo)
myRadioButtonGroup.setGroupName(nombreGrupo)
Parámetros
nombreGrupo
Cadena que especifica el nombre de un grupo de botones de opción.
Valor devuelto
Ninguno.
210
Descripción
Método; aplica un nombre de grupo a una instancia de botón de opción o a un grupo de botones
de opción en tiempo de ejecución. Si se llama a este método, se sustituye el valor del parámetro de
nombre de grupo establecido durante la edición.
Sintaxis 1: especifica myRadioButton como miembro del grupo de botones de opción
nombreGrupo.
Sintaxis 2: especifica un nuevo nombre de grupo para todos los botones de opción de
myRadioButtonGroup.
Ejemplo
Sintaxis 1: en el código siguiente se especifica Colores como nombre de grupo para la instancia
de botón de opción radioRed.
radioRed.setGroupName("Colores");
Sintaxis 2: en el código siguiente se especifica grupoBotonesJuegos como nuevo nombre de
grupo para todos los botones de opción de radioGroupGames.
radioGroupGames.setGroupName("grupoBotonesJuegos");
FRadioButton.setLabel
Disponibilidad
Flash Player 6.
Sintaxis
myRadioButton.setLabel(etiqueta)
Parámetros
etiqueta
Cadena de texto que especifica la etiqueta que aparece a la derecha del botón de
opción.
Valor devuelto
Ninguno.
Descripción
Método; aplica una etiqueta a la instancia de botón de opción myRadioButton en tiempo de
ejecución. Si se llama a este método, se sustituye el valor del parámetro etiqueta especificado
durante la edición. No puede utilizar este método para definir etiquetas para grupos de botones de
opción; la sintaxis radioButtonGroup.setLabel no es válida.
Ejemplo
En el código siguiente se aplica la etiqueta Ojos castaños a radio1.
radio1.setLabel("Ojos castaños");
Véase también
FRadioButton.getLabel
Diccionario de ActionScript
211
FRadioButton.setLabelPlacement
Disponibilidad
Flash Player 6.
Sintaxis
myRadioButton.setLabelPlacement(posiciónEtiqueta)
myRadioButtonGroup.setLabelPlacement(posiciónEtiqueta)
Parámetros
posiciónEtiqueta
Cadena de texto; especifique "left" o "right".
Descripción
Método; especifica si la etiqueta aparece a la derecha o a la izquierda del botón de opción. Si se
llama a este método, se sustituye el valor del parámetro de posición de etiqueta establecido
durante la edición.
Sintaxis 1: especifica la posición de la etiqueta para un solo botón de opción.
Sintaxis 2: especifica la posición de las etiquetas para todos los botones de opción de un grupo.
Ejemplo
Sintaxis 1: en el código siguiente se coloca la etiqueta de radio1 a la izquierda del botón de opción.
radio1.setLabelPlacement("left");
Sintaxis 2: en el código siguiente se colocan las etiquetas de los botones de opción del grupo
Colors a la derecha de los botones.
Colors.setLabelPlacement("right");
Véase también
FRadioButton.setLabel, FRadioButton.setLabelPlacement
FRadioButton.setSize
Disponibilidad
Flash Player 6.
Sintaxis
myRadioButton.setSize(anchura)
myRadioButtonGroup.setSize(anchura)
Parámetros
anchura
Entero que especifica el tamaño del botón de opción, en píxeles.
Valor devuelto
Ninguno.
Descripción
Método; especifica la anchura del botón de opción en píxeles y vuelve a dibujarlo. (No es posible
establecer la altura de los componentes de botón de opción.) Si se llama a este método, se
sustituye el cambio de escala de anchura aplicado durante la edición.
Sintaxis 1: establece el tamaño de un botón de opción determinado.
212
Sintaxis 2: establece el tamaño de todos los botones de opción de un grupo.
Para obtener más información, consulte el apartado “Definición del tamaño de los componentes
RadioButton” en el capítulo “Utilización de componentes” de la publicación Utilización de Flash.
Ejemplo
En el código siguiente se establece la anchura de radio1 en 200 píxeles.
radio1.setSize(200);
FRadioButton.setState
Disponibilidad
Flash Player 6.
Sintaxis
myRadioButton.setState("selección")
Parámetros
selección
Valor booleano que indica si el botón de opción está seleccionado (true) o no
(false).
Valor devuelto
Ninguno.
Descripción
Método; especifica si myRadioButton está seleccionado (true) o deseleccionado (false). En un
grupo de botones de opción (todos con el mismo parámetro Nombre del grupo), sólo uno puede
tener el estado inicial true (seleccionado). Si más de un botón de opción tiene especificado true
para este parámetro, se seleccionará el último botón de opción con el parámetro de estado inicial
true. El valor predeterminado de este parámetro es false.
Si se llama a este método, se sustituye el valor del parámetro de estado inicial establecido durante
la edición. Si llama a este método y también llama a FRadioButton.setValue para seleccionar un
botón de opción en tiempo de ejecución y los botones de opción pertenecen al mismo grupo, se
seleccionará el botón de opción especificado en el último método llamado.
Ejemplo
En el código siguiente se selecciona el botón de opción radio1 en tiempo de ejecución.
radio1.setState(true));
Véase también
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)
Parámetros
propiedadEstilo
valor
Cadena que especifica una propiedad del objeto FStyleFormat.
Valor que se establece para la propiedad.
Valor devuelto
Ninguno.
Descripción
Método; establece una propiedad FStyleFormat para una instancia de botón de opción
determinada. Si se llama a este método 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 más información sobre la creación de formatos de estilo personalizados, consulte el
apartado “Personalización de colores y texto de componentes” en el capítulo “Utilización de
componentes” de la publicación Utilización de Flash.
Ejemplo
En el código siguiente se establece la propiedad radioDot para radioButton1 en 0xFF12AC (rosa).
radioButton1.setStyleProperty("radioDot", 0xFF12AC);
En el código siguiente se establece la propiedad radioDot para todos los botones de radioGroup1
en 0xFF12AC (rosa).
radioGroup1.setStyleProperty("radioDot", 0xFF12AC);
Véase también
FStyleFormat (objeto)
FRadioButton.setValue
Disponibilidad
Flash Player 6.
Sintaxis
myRadioButtonGroup.setValue("datos")
Parámetros
datos
Datos asociados al botón de opción que se selecciona.
Valor devuelto
Ninguno.
Descripción
Método; selecciona el botón de opción asociado a los datos especificados y deselecciona el botón
seleccionado actualmente en el mismo grupo.
214
Si se llama a este método, se sustituye el valor del parámetro de valor inicial establecido durante la
edición. Si llama a este método y también llama a FRadioButton.setState para seleccionar un
botón de opción en tiempo de ejecución y los botones de opción pertenecen al mismo grupo, se
seleccionará el botón de opción especificado en el último método llamado.
Ejemplo
En el código siguiente se selecciona el botón de opción con los datos asociados rojo en el grupo
de botones de opción denominado Colors.
Colors.setValue("rojo");
Véase también
FRadioButton.getData, FRadioButton.getValue, FRadioButton.setState
FScrollBar (componente)
El componente FScrollBar del entorno de edición de Flash proporciona funciones de arrastrar y
soltar para agregar barras de desplazamiento para campos dinámicos y de introducción de texto en
documentos de Flash, además de proporcionar una interfaz de usuario para establecer parámetros
básicos. Los métodos del componente FScrollBar permiten controlar barras de desplazamiento en
tiempo de ejecución: puede crear barras de desplazamiento, controlar barras de desplazamiento
creadas durante la edición, definir o sustituir parámetros básicos y establecer opciones adicionales
en tiempo de ejecución. No es necesario que utilice un constructor para acceder a los métodos de
los componentes. No se recomienda utilizar algunos de los métodos del componente FScrollBar
con barras de desplazamiento asociadas a campos de texto. Consulte las entradas de los diferentes
métodos para obtener más información.
Los usuarios avanzados y los programadores pueden utilizar el componente ScrollBar con otros
elementos de Flash para crear interfaces de usuario personalizadas.
Los métodos 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 parámetros
antes de pasarlos a los métodos.
El componente ScrollBar se admite en Flash Player 6 y en versiones posteriores de Flash Player.
Para obtener más información sobre la utilización del componente ScrollBar, la definición de
parámetros durante la edición y la modificación del color y el aspecto de los componentes,
consulte los apartados “Personalización de los colores y el texto de los componentes” y
“Personalización de aspectos de componentes” en el capítulo “Utilización de componentes” de la
publicación Utilización de Flash.
Resumen de métodos del componente FScrollBar
Método
Descripción
FScrollBar.getEnabled
Devuelve true si la barra de desplazamiento está activada y false si
está desactivada.
FScrollBar.getScrollPosition
Devuelve un entero que representa la posición actual del cuadro de
desplazamiento (deslizador).
FScrollBar.registerSkinElement
Registra un elemento de aspecto en una propiedad definida para un
aspecto en la capa Read Me (Léame) situada en el fotograma 1 de un
clip de película de aspecto de la biblioteca.
FScrollBar.setChangeHandler
Especifica la función a la que se debe llamar cada vez que cambia la
posición de desplazamiento. (No se puede utilizar este método con
campos de texto.)
FScrollBar.setEnabled
Especifica si la barra de desplazamiento está activada (true) o
desactivada (false).
Diccionario de ActionScript 215
Método
Descripción
FScrollBar.setHorizontal
Especifica si la barra de desplazamiento es horizontal (true) o
vertical (false).
FScrollBar.setLargeScroll
Especifica el número de posiciones desplazadas cuando el usuario
hace clic en la guía de desplazamiento.
FScrollBar.setScrollContent
Especifica la instancia del campo de texto a la que se aplica la barra
de desplazamiento.
FScrollBar.setScrollPosition
Establece la posición del cuadro de desplazamiento como un entero
entre posMín y posMáx.
FScrollBar.setScrollProperties
Establece las propiedades tamañoPágina, posMín y posMáx para la
barra de desplazamiento. (No se puede utilizar este método con
campos de texto.)
FScrollBar.setScrollTarget
Especifica un campo de texto como destino para la barra de
desplazamiento.
FScrollBar.setSize
Establece la longitud de la barra de desplazamiento, en píxeles.
FScrollBar.setSmallScroll
Especifica el número de posiciones desplazadas cuando el usuario
hace clic en la flecha de desplazamiento.
FScrollBar.setStyleProperty
Establece una sola propiedad de estilo para un componente.
FScrollBar.getEnabled
Disponibilidad
Flash Player 6.
Sintaxis
myScrollBar.getEnabled()
Parámetros
Ninguno.
Valor devuelto
Valor booleano.
Descripción
Método; indica si la barra de desplazamiento está activada (true) o desactivada (false).
Ejemplo
En el código siguiente se devuelve un valor en la ventana Salida que indica si scroll1 está
activada (true) o desactivada (false).
trace(scroll1.getEnabled());
Véase también
FScrollBar.setEnabled
216
FScrollBar.getScrollPosition
Disponibilidad
Flash Player 6.
Sintaxis
myScrollBar.getScrollPosition()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve un entero que especifica la posición del cuadro de desplazamiento (deslizador).
El valor devuelto se encuentra dentro del intervalo definido por las propiedades posMín y posMáx
que determinan los límites de desplazamiento de la barra de desplazamiento. Para establecer los
parámetros posMín y posMáx, utilice FScrollBar.setScrollProperties.
Ejemplo
En el código siguiente se devuelve la posición actual del cuadro de desplazamiento para la barra de
desplazamiento scroll2 en la ventana Salida. Si scroll2 tiene el valor 2 en posMín y el valor 25
en posMáx, 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 método.
Véase también
FScrollBar.setChangeHandler, FScrollBar.setScrollPosition
FScrollBar.registerSkinElement
Disponibilidad
Flash Player 6.
Sintaxis
myScrollBar.registerSkinElement(elemento, propiedadEstilo)
Parámetros
elemento
Instancia de clip de película.
propiedadEstilo
Cadena que especifica una propiedad FStyleFormat.
Valor devuelto
Ninguno.
Descripción
Método; 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 (Léame) de cada aspecto de
la biblioteca.
Diccionario de ActionScript 217
Los componentes están 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 método para registrar propiedades y elementos de aspecto personalizados en aspectos
de componentes de la interfaz de usuario de Flash o personalizados editando el código del primer
fotograma de la capa Read Me (Léame) 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
edición 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 más información, consulte el apartado “Personalización de aspectos de
componentes” en el capítulo “Utilización de componentes” de la publicación Utilización de Flash.
Ejemplo
En el código siguiente se registra el elemento de aspecto personalizado NewArrow_mc en la
propiedad arrow del primer fotograma de la capa Read Me (Léame) del aspecto fsb_downArrow
en la carpeta FScrollBar Skins de la biblioteca.
Scroll1.registerSkinElement(NewArrow_mc, "arrow");
Véase también
FStyleFormat (objeto)
FScrollBar.setChangeHandler
Disponibilidad
Flash Player 6.
Sintaxis
myScrollBar.setChangeHandler(nombreFunción, [ubicación])
Parámetros
Cadena que especifica el nombre de la función del controlador que debe ejecutarse
cuando el usuario mueve el cuadro de desplazamiento. Si no se especifica el parámetro ubicación,
esta función debe encontrarse en la misma línea de tiempo que la instancia del componente.
nombreFunción
ubicación Referencia de ruta a un objeto de datos, clip de película o línea de tiempo que
contiene la función especificada. Este parámetro es opcional y tiene como valor predeterminado la
línea de tiempo principal del componente.
Valor devuelto
Ninguno.
Descripción
Método; 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
función del controlador de cambios para más de un componente; la función siempre acepta la
instancia del componente que ha cambiado como parámetro. Si se llama a este método, se
sustituye el valor del parámetro de controlador de cambios especificado en la edición.
218
Este método es para usuarios avanzados y programadores que crean aplicaciones y componentes
personalizados mediante el componente ScrollBar de la interfaz de usuario de Flash; el método no
puede utilizarse con barras de desplazamiento asociadas a campos de texto.
Ejemplo
En el código siguiente se crea un cuadro rellenado en el escenario y, a continuación, se aplica una
barra de desplazamiento horizontal, se establecen las propiedades de desplazamiento y se especifica la
función mover como controlador de cambios. El controlador de cambios mover utiliza la posición
de desplazamiento de la barra de desplazamiento para cambiar la posición _x del clip de película 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 código siguiente se especifica una función 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 posición de
desplazamiento actual mediante FScrollBar.getScrollPosition y, a continuación,
customListBox utiliza FScrollBar.setScrollPosition para restablecer la posición de
desplazamiento, de modo que el elemento en la posición de desplazamiento actual aparezca en la
primera posición del cuadro de lista personalizado. El parámetro component se rellena
automáticamente 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 función ubicada en una línea de tiempo tres niveles por
encima de la línea de tiempo del componente, la primera línea del código sería similar a la siguiente:
scroll1.setChangeHandler("myHandler", _parent._parent._parent);
Diccionario de ActionScript 219
En el código siguiente se crea la función myHandler en una instancia de myObject (cuya clase es
Object) y, a continuación, se especifica myHandler como función de scroll1.
myObject = new Object();
myObject.myHandler = function(component){
customListBox.setScrollPosition(component.getScrollPosition());
}
scroll1.setChangeHandler("myHandler", myObject);
Véase también
FScrollBar.getScrollPosition, FScrollBar.setScrollPosition, FScrollBar.setScrollProperties
FScrollBar.setEnabled
Disponibilidad
Flash Player 6.
Sintaxis
myScrollBar.setEnabled(activación)
Parámetros
Valor booleano que especifica si la barra de desplazamiento está activada (true) o
desactivada (false).
activación
Valor devuelto
Ninguno.
Descripción
Método; determina si la barra de desplazamiento está activada (true) o desactivada (false). Si
una barra de desplazamiento está desactivada, no aceptará la interacción del usuario mediante el
teclado o el ratón y aparecerá de color más claro (no estará disponible para el usuario). Llamar a
este método sin pasar ningún parámetro equivale a pasar el parámetro true.
Ejemplo
En el código siguiente se desactiva la barra de desplazamiento scroll2.
scroll2.setEnabled(false);
Véase también
FScrollBar.getEnabled
FScrollBar.setHorizontal
Disponibilidad
Flash Player 6.
Sintaxis
myScrollBar.setHorizontal(desplazamientoHorizontal)
Parámetros
desplazamientoHorizontal Valor
horizontal (true) o vertical (false).
Valor devuelto
Ninguno.
220
booleano que especifica si la barra de desplazamiento es
Descripción
Método; especifica si la barra de desplazamiento se aplica al objetivo horizontal (true) o
verticalmente (false). El valor predeterminado de este método es false.
Ejemplo
En el código siguiente se especifica que la barra de desplazamiento scrollText se aplique
horizontalmente a este objetivo.
scrollText.setHorizontal(true);
Véase también
FScrollBar.setSize
FScrollBar.setLargeScroll
Disponibilidad
Flash Player 6.
Sintaxis
myScrollBar.setLargeScroll(desplazamientoLargo)
Parámetros
Entero que especifica el número de posiciones de desplazamiento
cuando el usuario hace clic una vez en la guía de desplazamiento. El valor predeterminado es el
valor definido para tamañoPágina con FScrollBar.setScrollProperties.
desplazamientoLargo
Valor devuelto
Ninguno.
Descripción
Método; establece la propiedad desplazamientoLargo de la instancia de barra de
desplazamiento en tiempo de ejecución. Cuando el usuario hace clic una vez en la guía de
desplazamiento, el cuadro de desplazamiento (deslizador) se desplaza la distancia especificada para
una posición desplazamientoLargo.
Ejemplo
En el código siguiente se especifica que cuando el usuario haga clic en la guía de desplazamiento,
scrollText1 se desplace 20 posiciones.
scrollText1.setLargeScroll(20);
Véase también
FScrollBar.setSmallScroll
FScrollBar.setScrollContent
Disponibilidad
Flash Player 6.
Sintaxis
myScrollBar.setScrollContent(destino)
Parámetros
destino
Referencia al campo de texto de la barra de desplazamiento.
Diccionario de ActionScript 221
Valor devuelto
Ninguno.
Descripción
Método; especifica la instancia de campo de texto a la que se aplica la barra de desplazamiento.
Esta instancia debe definirse en la misma línea de tiempo y en el mismo nivel que la barra de
desplazamiento. Si se llama a este método, se sustituye el valor del parámetro de campo de texto
de destino establecido durante la edición. Si se pasa undefined para el parámetro destino, se
elimina la asociación de la barra de desplazamiento con el campo de texto.
Ejemplo
En el código 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(posición)
Parámetros
posición Entero comprendido entre los valores de posMín y posMáx de la barra de
desplazamiento. Consulte FScrollBar.setScrollProperties para obtener más información
sobre cómo establecer las propiedades posMín y posMáx.
Valor devuelto
Ninguno.
Descripción
Método; especifica la posición del cuadro de desplazamiento (deslizador) de la barra de
desplazamiento y ejecuta la función del controlador de cambios especificada con
FScrollBar.setChangeHandler.
Ejemplo
En el código siguiente se establece en 5 la posición del cuadro de desplazamiento para scrollText1.
scrollText1.setScrollPosition(5);
Consulte FScrollBar.setChangeHandler para ver otro ejemplo en el que se utiliza este método.
Véase también
FScrollBar.setChangeHandler, FScrollBar.setScrollProperties
222
FScrollBar.setScrollProperties
Disponibilidad
Flash Player 6.
Sintaxis
myScrollBar.setScrollProperties(tamañoPágina, posMín, posMáx)
Parámetros
tamañoPágina
Entero que representa el número de posiciones que se visualiza en la vista de
página.
posMín
Entero que representa la posición mínima desplazada.
posMáx
Entero que representa la posición máxima desplazada.
Valor devuelto
Ninguno.
Descripción
Método; especifica las propiedades tamañoPágina, posMín y posMáx de la barra de
desplazamiento y establece el tamaño adecuado del cuadro de desplazamiento (deslizador) de la
barra de desplazamiento.
Este método 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 automáticamente de acuerdo con las propiedades del campo de
texto; llamar a este método hace que la barra de desplazamiento se trunque en el campo de texto.
Ejemplo
En el código siguiente se establecen las propiedades tamañoPágina, posMín y posMáx 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 posMáx es el número total de elementos del cuadro menos el
número de elementos visibles.
scrollBar.setScrollProperties(5, 0, 15);
Véase también
FScrollBar.setScrollPosition
FScrollBar.setScrollTarget
Disponibilidad
Flash Player 6.
Sintaxis
myScrollBar.setScrollTarget(destino)
Parámetros
destino
Referencia al campo de texto de la barra de desplazamiento.
Valor devuelto
Ninguno.
Diccionario de ActionScript 223
Descripción
Método; especifica la instancia de campo de texto a la que se aplica la barra de desplazamiento.
Esta instancia debe definirse en la misma línea de tiempo y en el mismo nivel que la barra de
desplazamiento. Si se llama a este método, se sustituye el valor del parámetro de campo de texto
de destino establecido durante la edición. Si se pasa undefined para el parámetro destino, se
elimina la asociación de la barra de desplazamiento con el campo de texto.
Ejemplo
En el código 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)
Parámetros
longitud
Entero que especifica la longitud de la barra de desplazamiento en píxeles.
Valor devuelto
Ninguno.
Descripción
Método; establece la longitud, en píxeles, de la barra de desplazamiento en tiempo de ejecución.
No puede establecer la anchura de los componentes de la barra de desplazamiento. Si se llama a
este método, se sustituyen las especificaciones de escala y de tamaño aplicadas durante la edición.
Este método no debe utilizarse con barras de desplazamiento asociadas a campos de texto; la barra
de desplazamiento se ajusta automáticamente al tamaño del campo de texto durante la edición.
Para obtener más información, consulte el apartado “Definición del tamaño de los componentes
ScrollBar” en el capítulo “Utilización de componentes” de la publicación Utilización de Flash.
Ejemplo
En el código siguiente se establece la longitud de scrollText1 en 200 píxeles.
scrollText1.setSize(200);
FScrollBar.setSmallScroll
Disponibilidad
Flash Player 6.
Sintaxis
myScrollBar.setSmallScroll(desplazamientoCorto)
Parámetros
Entero que especifica el número de posiciones de desplazamiento
cuando el usuario hace clic en la flecha de desplazamiento. El valor predeterminado es 1.
desplazamientoCorto
224
Valor devuelto
Ninguno.
Descripción
Método; establece la propiedad desplazamientoCorto de la instancia de barra de desplazamiento
en tiempo de ejecución, 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 posición de desplazamientoCorto.
Ejemplo
En el código siguiente se especifica que cuando el usuario haga clic en una flecha de
desplazamiento, scrollText1 se desplace 5 posiciones.
scrollText1.setSmallScroll(5);
Véase también
FScrollBar.setLargeScroll
FScrollBar.setStyleProperty
Disponibilidad
Flash Player 6.
Sintaxis
myScrollBar.setStyleProperty(propiedadEstilo, valor)
Parámetros
propiedadEstilo
valor
Cadena que especifica una propiedad del objeto FStyleFormat.
Valor que se establece para la propiedad.
Valor devuelto
Ninguno.
Descripción
Método; establece una propiedad FStyleFormat para una determinada instancia de barra de
desplazamiento. Si se llama a este método 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 más información sobre la creación de formatos de estilo personalizados, consulte el
apartado “Personalización de los colores y el texto de los componentes” en el capítulo “Utilización
de componentes” de la publicación Utilización de Flash.
Ejemplo
En el código siguiente se establece la propiedad de la flecha de scrollBar1 en 0x000000 (negro).
scrollBar1.setStyleProperty("arrow", 0x000000);
Véase también
FStyleFormat (objeto)
Diccionario de ActionScript 225
FScrollPane (componente)
El componente ScrollPane del entorno de edición de Flash proporciona funciones de arrastrar y
soltar para agregar paneles de desplazamiento para visualizar clips de película en documentos de
Flash, además de proporcionar una interfaz de usuario para establecer parámetros básicos. Los
métodos del componente FScrollPane permiten controlar los paneles de desplazamiento en tiempo
de ejecución: puede crear paneles de desplazamiento, controlar paneles de desplazamiento creados
durante la edición, definir o sustituir parámetros básicos y definir opciones adicionales en tiempo de
ejecución. No es necesario que utilice un constructor para acceder a los métodos de los componentes.
El componente ScrollPane proporciona barras de desplazamiento verticales y horizontales para
visualizar clips de película de grandes dimensiones sin ocupar demasiado espacio del escenario. Se
incorporan controles estándar de ratón y teclado.
Nota: el componente ScrollPane sólo muestra clips de película; para agregar barras de desplazamiento en campos
de introducción de texto y dinámicos, utilice el componente ScrollBar. El componente ScrollPane no puede mostrar
ningún contenido que utilice fuentes de dispositivo.
Los métodos 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 parámetros
antes de pasarlos a los métodos.
El componente ScrollPane se admite en Flash Player 6 y en versiones posteriores de Flash Player.
Para obtener más información sobre la utilización del componente ScrollPane, la definición de
parámetros durante la edición y la modificación del color y el aspecto de los componentes,
consulte los apartados “Personalización de los colores y el texto de los componentes” y
“Personalización de aspectos de componentes” en el capítulo “Utilización de componentes” de la
publicación Utilización de Flash.
226
Resumen de métodos del componente FScrollPane
Método
Descripción
FScrollPane.getPaneHeight
Devuelve la altura del panel de desplazamiento.
FScrollPane.getPaneWidth
Devuelve la anchura del panel de desplazamiento.
FScrollPane.getScrollContent
Devuelve una instancia del contenido que se visualiza en el
panel de desplazamiento.
FScrollPane.getScrollPosition
Devuelve las coordenadas x e y de la posición de
desplazamiento actual.
FScrollPane.loadScrollContent
Carga un archivo SWF o JPEG en el panel de
desplazamiento.
FScrollPane.refreshPane
Cambia el tamaño de las barras de desplazamiento del panel
de desplazamiento cuando cambia el tamaño del contenido.
FScrollPane.registerSkinElement
Registra un elemento de aspecto en una propiedad definida
para un aspecto en la capa Read Me (Léame) situada en el
fotograma 1 de un clip de película de aspecto de la biblioteca.
FScrollPane.setDragContent
Establece que el contenido del panel de desplazamiento
puede arrastrarse.
FScrollPane.setHScroll
Establece el estilo de desplazamiento horizontal para el
panel de desplazamiento.
FScrollPane.setScrollContent
Establece un clip de película como objetivo del panel de
desplazamiento.
FScrollPane.setScrollPosition
Hace que el panel se desplace a las coordenadas x, y
especificadas.
FScrollPane.setSize
Establece la anchura y la altura del panel de desplazamiento,
en píxeles.
FScrollPane.setStyleProperty
Establece una sola propiedad de estilo para un componente.
FScrollPane.setVScroll
Establece el estilo de desplazamiento vertical del panel de
desplazamiento.
FScrollPane.getPaneHeight
Disponibilidad
Flash Player 6.
Sintaxis
myScrollPane.getPaneHeight()
Parámetros
Ninguno.
Valor devuelto
Entero que especifica la altura de la vista del panel de desplazamiento.
Diccionario de ActionScript 227
Descripción
Método; devuelve la altura de la vista del panel de desplazamiento. Sólo puede utilizar este
método para obtener la altura de un panel de desplazamiento cuyo tamaño se ha definido con
FScrollPane.setSize. Este método funciona sólo si se ha definido el tamaño del panel de
desplazamiento con FScrollPane.setSize y no si lo ha definido mediante las propiedades
_width y _height.
Ejemplo
En el código siguiente se obtiene la altura y la anchura del panel de desplazamiento display1 y se
utilizan los valores devueltos para cambiar el tamaño del panel de desplazamiento con
FScrollPane.setSize.
var h = display1.getPaneHeight();
var w = display1.getPaneWidth();
display1.setSize(w+10, h+10);
Véase también
FScrollPane.getPaneWidth, FScrollPane.setSize
FScrollPane.getPaneWidth
Disponibilidad
Flash Player 6.
Sintaxis
myScrollPane.getPaneWidth()
Parámetros
Ninguno.
Valor devuelto
Entero que especifica la anchura de la vista del panel de desplazamiento.
Descripción
Método; devuelve la anchura de la vista del panel de desplazamiento. Sólo puede utilizar este
método para obtener la anchura de un panel de desplazamiento cuyo tamaño se ha definido con
FScrollPane.setSize. Este método funciona sólo si se ha definido el tamaño del panel de
desplazamiento con FScrollPane.setSize y no si lo ha definido mediante las propiedades
_width y _height.
Ejemplo
En el código siguiente se obtiene la altura y la anchura del panel de desplazamiento display1 y se
utilizan los valores devueltos para cambiar el tamaño del panel de desplazamiento con
FScrollPane.setSize.
var h = display1.getPaneHeight();
var w = disply1.getPaneWidth();
display1.setSize(w+10, h+10);
Véase también
FScrollPane.getPaneHeight, FScrollPane.setSize
228
FScrollPane.getScrollContent
Disponibilidad
Flash Player 6.
Sintaxis
myScrollPane.getScrollContent()
Parámetros
Ninguno.
Valor devuelto
Una referencia al clip de película en el panel de desplazamiento.
Descripción
Método; devuelve una instancia del contenido visualizado en el panel de desplazamiento.
Ejemplo
En el código siguiente se recupera una referencia al clip de película dentro de display1, se
almacena en una variable y, a continuación, se indica al clip de película que pase al fotograma 4.
var content = display1.getScrollContent();
content.gotoAndStop(4);
Véase también
FScrollPane.setScrollContent
FScrollPane.getScrollPosition
Disponibilidad
Flash Player 6.
Sintaxis
myScrollPane.getScrollPosition()
Parámetros
Ninguno.
Valor devuelto
Un objeto.
Descripción
Método; devuelve un objeto con los campos .x o .y que especifica la posición de desplazamiento
vertical u horizontal actual de la vista del panel de desplazamiento.
Ejemplo
En el código siguiente se devuelve la posición de desplazamiento actual del panel de
desplazamiento scroll2 en la ventana Salida.
trace(scroll2.getScrollPosition());
Véase también
FScrollPane.setScrollPosition
Diccionario de ActionScript 229
FScrollPane.loadScrollContent
Disponibilidad
Flash Player 6.
Sintaxis
myScrollPane.loadScrollContent(URL [, nombreFunción, ubicación])
Parámetros
Cadena que especifica la dirección URL de un archivo SWF o JPEG que debe cargarse en el
panel de desplazamiento.
URL
nombreFunción Cadena que especifica el nombre de la función del controlador que debe
ejecutarse cuando se carga el contenido del panel de desplazamiento. Si no se especifica el
parámetro ubicación, esta función debe encontrarse en la misma línea de tiempo que la instancia
del componente.
ubicación Referencia de ruta a un objeto de datos, clip de película o línea de tiempo que
contiene la función especificada. Este parámetro es opcional y tiene como valor predeterminado la
línea de tiempo principal del componente.
Valor devuelto
Ninguno.
Descripción
Método; especifica la dirección URL de un archivo SWF o JPEG que se visualizará en el panel de
desplazamiento. Los parámetros opcionales nombreFunción y ubicación permiten especificar
una función de controlador de cambios a la que se debe llamar cuando se carga el contenido.
La dirección URL debe estar en el mismo subdominio que el URL donde reside actualmente la
película Flash. Para utilizar archivos SWF o JPEG en Flash Player, o probar la película en el
entorno de edición 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 método, se sustituye el valor del parámetro de desplazamiento de contenido
establecido durante la edición.
Consulte FScrollBar.setChangeHandler para obtener más información y ejemplos sobre la
utilización de funciones del controlador de cambios.
Ejemplo
En el código siguiente, display1 se carga en un archivo JPEG ubicado en un servidor.
display1.loadScrollContent("http://www.YourWebServer.com/Nice.jpg");
En el código siguiente se carga un archivo JPEG ubicado en un servidor y se especifica la función
de controlador de cambios load de la línea 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
Véase también
FScrollPane.getPaneHeight, FScrollPane.setScrollContent
FScrollPane.refreshPane
Disponibilidad
Flash Player 6.
Sintaxis
myScrollPane.refreshPane()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; cambia el tamaño de las barras de desplazamiento del panel de desplazamiento cuando
cambia el contenido del panel de desplazamiento. Puede llamar a este método si cambia el tamaño
del contenido de la ventana del panel de desplazamiento mediante _width o _height.
Ejemplo
En el código siguiente se actualizan las barras de desplazamiento de moviePane después de
aumentar el tamaño del clip de película myContent en el panel de desplazamiento.
var myContent = moviePane.getScrollContent();
myContent._width = 400;
moviePane.refreshPane();
Véase también
FScrollPane.getScrollContent
FScrollPane.registerSkinElement
Disponibilidad
Flash Player 6.
Sintaxis
myScrollPane.registerSkinElement(elemento, propiedadEstilo)
Parámetros
elemento
Instancia de clip de película.
propiedadEstilo
Nombre de una propiedad de FStyleFormat.
Valor devuelto
Ninguno.
Descripción
Método; 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 (Léame) de cada aspecto de
la biblioteca.
Diccionario de ActionScript 231
Los componentes están 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 método para registrar propiedades y elementos de aspecto personalizados en aspectos
de componentes de la interfaz de usuario de Flash o personalizados editando el código del primer
fotograma de la capa Read Me (Léame) 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
edición 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 más información, consulte el apartado “Personalización de aspectos de
componentes” en el capítulo “Utilización de componentes” de la publicación Utilización de Flash.
Ejemplo
En el código siguiente se registra el elemento de aspecto personalizado NewArrow_mc en la
propiedad arrow del primer fotograma de la capa Read Me (Léame) del aspecto fsb_downArrow
en la carpeta FScrollBar Skins de la biblioteca.
Pane1.registerSkinElement(NewArrow_mc, "arrow");
Véase también
FStyleFormat (objeto)
FScrollPane.setDragContent
Disponibilidad
Flash Player 6.
Sintaxis
myScrollPane.setDragContent(arrastrar)
Parámetros
Valor booleano; true especifica que el usuario puede cambiar la vista arrastrando el
contenido en el panel de desplazamiento; false especifica que el usuario sólo puede cambiar la
vista mediante las barras de desplazamiento.
arrastrar
Valor devuelto
Ninguno.
Descripción
Método; especifica si el usuario puede cambiar la vista del panel de desplazamiento arrastrando el
contenido además de utilizar las barras de desplazamiento. Si se llama a este método, se sustituye
el valor del parámetro para arrastar contenido establecido durante la edición.
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(visualización)
Parámetros
visualización 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 sólo cuando es necesario ("auto").
Si se llama a este método, se sustituye el valor del parámetro de desplazamiento horizontal
establecido durante la edición.
Valor devuelto
Ninguno.
Descripción
Método; determina si una barra de desplazamiento horizontal se visualiza siempre (true), nunca
(false), o si sólo se visualiza cuando es necesario ("auto"). El valor predeterminado es auto.
Ejemplo
En el código siguiente se oculta la barra de desplazamiento horizontal para display1.
display1.setHScroll(false);
Véase también
FScrollPane.setVScroll
FScrollPane.setScrollContent
Disponibilidad
Flash Player 6.
Sintaxis
myScrollPane.setScrollContent(destino)
Parámetros
destino Cadena de texto que especifica el identificador de vínculo de símbolos de un clip de
película en la biblioteca o en una instancia de un clip de película.
Valor devuelto
Ninguno.
Descripción
Método; especifica un clip de película que debe visualizarse en el panel de desplazamiento. Si se
llama a este método, se sustituye el valor del parámetro de desplazamiento por el contenido
establecido durante la edición.
Diccionario de ActionScript 233
Ejemplo
En el ejemplo siguiente se especifica la instancia de clip de película BetsyTacy como destino de
display1.
display1.setScrollContent("BetsyTacy");
Véase también
FScrollPane.getPaneHeight, FScrollPane.loadScrollContent
FScrollPane.setScrollPosition
Disponibilidad
Flash Player 6.
Sintaxis
myScrollPane.setScrollPosition(x, y)
Parámetros
x
Entero que especifica el número de píxeles (a partir de 0) de desplazamiento hacia la derecha.
y
Entero que especifica el número de píxeles (a partir de 0) de desplazamiento hacia abajo.
Valor devuelto
Ninguno.
Descripción
Método; establece la posición de desplazamiento para las coordenadas x, y especificadas.
Ejemplo
En el ejemplo siguiente, el contenido de display1 se desplaza 14 píxeles hacia abajo y 40 píxeles
hacia la derecha.
display1.setScrollPosition(14,40);
Véase también
FScrollPane.getScrollPosition
FScrollPane.setSize
Disponibilidad
Flash Player 6.
Sintaxis
myScrollPane.setSize(anchura, altura)
Parámetros
anchura
altura
Entero que especifica la anchura del panel de desplazamiento, en píxeles.
Entero que especifica la altura del panel de desplazamiento, en píxeles.
Valor devuelto
Ninguno.
Descripción
Método; establece la anchura y la altura, en píxeles, de la vista del panel de desplazamiento en
tiempo de ejecución. Si se llama a este método, se sustituye el tamaño aplicado durante la edición.
234
Para obtener más información, consulte el apartado “Personalización de aspectos de
componentes” en el capítulo “Utilización de componentes” de la publicación Utilización de Flash.
Ejemplo
En el código siguiente se establecen la anchura y la altura de display1 en 500 x 300 píxeles.
display1.setSize(500, 300);
Véase también
FScrollPane.getPaneHeight, FScrollPane.getPaneWidth
FScrollPane.setStyleProperty
Disponibilidad
Flash Player 6.
Sintaxis
myScrollPane.setStyleProperty(propiedadEstilo, valor)
Parámetros
propiedadEstilo
valor
Cadena que especifica una propiedad del objeto FStyleFormat.
Valor que se establece para la propiedad.
Valor devuelto
Ninguno.
Descripción
Método; establece una propiedad de formato FStyleFormat para una determinada instancia de
panel de desplazamiento. Si se llama a este método 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 más información sobre la creación de formatos de estilo personalizados, consulte el
apartado “Personalización de los colores y el texto de los componentes” en el capítulo “Utilización
de componentes” de la publicación Utilización de Flash.
Ejemplo
En el código siguiente se establece la propiedad arrow de ScrollPane2 en 0x000000 (negro).
ScrollPane2.setStyleProperty("arrow", 0x000000);
Véase también
FStyleFormat (objeto)
Diccionario de ActionScript 235
FScrollPane.setVScroll
Disponibilidad
Flash Player 6.
Sintaxis
myScrollBar.setVScroll(visualización)
Parámetros
visualización 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 sólo cuando es necesario ("auto").
Valor devuelto
Ninguno.
Descripción
Método; determina si una barra de desplazamiento vertical se visualiza siempre (true), nunca
(false) o sólo cuando es necesario ("auto"). El valor predeterminado es auto.
Si se llama a este método, se sustituye el valor del parámetro de desplazamiento vertical
establecido durante la edición.
Ejemplo
En el código siguiente se especifica que la barra de desplazamiento vertical de display1 se
visualice siempre.
display1.setVScroll(true);
Véase también
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 continuación, utilice el método
FStyleFormat.addListener para registrar instancias de componente en el nuevo formato de
estilo. Una instancia de componente puede detectar más de un formato de estilo, pero sólo puede
tomar el valor de un formato de estilo para una propiedad específica. 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 demás 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 método 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 específico asignada al componente sin
cambiar los demás valores de propiedad. Para obtener más información, 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 más información sobre el formato de estilo global y la creación de formatos de estilo
personalizados, consulte el apartado “Personalización de los colores y el texto de los componentes”
en el capítulo “Utilización de componentes” de la publicación Utilización de Flash.
Resumen de métodos del objeto FStyleFormat
Método
Descripción
FStyleFormat.addListener
Registra un componente en un formato de estilo.
FStyleFormat.applyChanges
Aplica los cambios realizados en valores de propiedades de un formato
de estilo.
FStyleFormat.removeListener
Elimina un componente como detector en un formato de estilo.
Resumen de propiedades del objeto FStyleFormat
En las tablas siguientes se muestran los resúmenes de propiedades del objeto FStyleFormat.
Propiedad
Descripción
FStyleFormat.arrow
Color de la flecha utilizada en barras de desplazamiento y listas
desplegables.
FStyleFormat.background
Color de la parte del fondo de un componente.
FStyleFormat.backgroundDisabled
Color de la parte del fondo de un componente desactivado.
FStyleFormat.check
Color de la marca de verificación en una casilla de verificación
seleccionada.
FStyleFormat.darkshadow
Color del borde interior o la parte más oscura del sombreado de un
componente.
FStyleFormat.face
Color principal del componente.
FStyleFormat.foregroundDisabled
Color de primer plano de un componente desactivado.
FStyleFormat.highlight
Color del borde interior o la parte más oscura del sombreado de un
componente cuando está seleccionado.
FStyleFormat.highlight3D
Color del borde exterior o parte más clara del sombreado de un
componente cuando está seleccionado.
FStyleFormat.radioDot
Color del punto en un botón de opción seleccionado.
FStyleFormat.scrollTrack
Color de la guía de desplazamiento en una barra de desplazamiento.
FStyleFormat.selection
Color de la barra de selección cuando resalta un elemento de lista en un
componente.
FStyleFormat.selectionDisabled
Color de la barra de selección cuando resalta un elemento de lista en un
componente desactivado.
Diccionario de ActionScript 237
Propiedad
Descripción
FStyleFormat.selectionUnfocused
Color de la barra de selección cuando el componente no está resaltado
mediante el teclado.
FStyleFormat.shadow
Color del borde exterior o parte más clara del sombreado de un
componente.
FStyleFormat.textAlign
Alineación (izquierda, derecha o centro) del texto que se visualiza en un
componente.
FStyleFormat.textBold
Especifica si el texto está en negrita (true) o no (false).
FStyleFormat.textColor
Color predeterminado del texto en todos los componentes asignados
al formato de estilo.
FStyleFormat.textDisabled
Color del texto en un componente desactivado.
FStyleFormat.textFont
Nombre de la fuente en la que se ve el texto.
FStyleFormat.textIndent
Sangría del texto desde el margen izquierdo al primer carácter del
texto, en píxeles.
FStyleFormat.textItalic
Especifica si el texto es en cursiva (true) o no (false).
FStyleFormat.textLeftMargin
Margen izquierdo del párrafo de texto, en píxeles.
FStyleFormat.textRightMargin
Margen derecho del párrafo de texto, en píxeles.
FStyleFormat.textSelected
Color de un elemento de lista seleccionado en un componente.
FStyleFormat.textSize
Tamaño del texto, en puntos.
FStyleFormat.textUnderline
Especifica si el texto está subrayado (true) o no (false).
Constructor del objeto FStyleFormat
Disponibilidad
Flash Player 6.
Sintaxis
new FStyleFormat()
Parámetros
Ninguno.
Valor devuelto
Una instancia del objeto FStyleFormat.
Descripción
Método; 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. También
puede utilizar setStyleProperty para cambiar propiedades para instancias de componente
específicas sin la ayuda de un constructor.
238
Para obtener más información, consulte el método setStyleProperty disponible para cada
componente (FCheckBox.setStyleProperty, FComboBox.setStyleProperty, etc.). Consulte
también el apartado “Personalización de los colores y el texto de los componentes” en el capítulo
“Utilización de componentes” de la publicación Utilización 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])
Parámetros
componente1 ... componenteN
Instancias de componente que se registran en myStyleFormat.
Valor devuelto
Ninguno.
Descripción
Método; registra los componentes especificados en myStyleFormat. Utilice este método para
registrar instancias de componentes de la interfaz de usuario Flash o componentes personalizados
en un formato de estilo personalizado. También puede utilizar este método 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 código siguiente se registra formStyleFormat en los componentes myListBox, myComboBox
y myScrollBar.
formStyleFormat.addListener(myListBox, myComboBox, myScrollBar);
Véase también
FStyleFormat.applyChanges, FStyleFormat.removeListener
FStyleFormat.applyChanges
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.applyChanges([nombrePropiedad1, ...nombrePropiedadN])
myStyleFormat.applyChanges()
Parámetros
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.
Descripción
Método; 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 método 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 sólo las propiedades para las
que especifica un nuevo valor.
Sintaxis 1: actualiza sólo las propiedades especificadas en los parámetros.
Sintaxis 2: actualiza toda la información 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();
Véase también
FStyleFormat.addListener, FStyleFormat.removeListener
FStyleFormat.arrow
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.arrow
Descripción
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 código 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
Descripción
Propiedad; el valor del color RGB de la parte del fondo de un componente. Por ejemplo, en un
botón de opción o en una casilla de verificación, la parte del fondo es el espacio dentro del área de
selección; en un cuadro de lista o en un cuadro combinado, la parte del fondo será el área de
visualización. El valor de color debe tener el formato 0xRRGGBB.
Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo
En el código 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;
Véase también
FStyleFormat.face
FStyleFormat.backgroundDisabled
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.backgroundDisabled
Descripción
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 código 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;
Véase también
FStyleFormat.foregroundDisabled
Diccionario de ActionScript 241
FStyleFormat.check
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.check
Descripción
Propiedad; el valor de color RGB de la marca de selección en un cuadro de selección 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 código 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
Descripción
Propiedad; el valor de color RGB del borde interior o la parte más oscura del sombreado de un
componente; por ejemplo, el borde interior del círculo de un botón de opción deseleccionado o
una casilla de verificación 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 código siguiente se asigna el valor 0x0000CD a la propiedad darkshadow de
formStyleFormat, lo que generará un borde interior de color azul.
formStyleFormat.darkshadow = 0x0000CD;
Véase también
FStyleFormat.highlight, FStyleFormat.shadow
242
FStyleFormat.face
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.face
Descripción
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 código 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
Descripción
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 código 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;
Véase también
FStyleFormat.backgroundDisabled
Diccionario de ActionScript 243
FStyleFormat.highlight
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.highlight
Descripción
Propiedad; el valor de color RGB del borde interior o la parte más oscura del sombreado de un
componente cuando se selecciona, como por ejemplo, borde interior del círculo de un botón de
opción o de una casilla de verificación. El valor de color debe tener el formato 0xRRGGBB.
Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo
En el código 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;
Véase también
FStyleFormat.darkshadow
FStyleFormat.highlight3D
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.highlight3D
Descripción
Propiedad; el valor de color RGB del borde exterior o la parte más clara del sombreado de un
componente cuando está seleccionado; por ejemplo, el borde exterior del círculo de un botón de
opción o de una casilla de verificación. El valor de color debe tener el formato 0xRRGGBB.
Debe utilizar FStyleFormat.applyChanges cuando actualice las propiedades con un nuevo valor.
Ejemplo
En el código 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;
Véase también
FStyleFormat.shadow
244
FStyleFormat.radioDot
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.radioDot
Descripción
Propiedad; el valor de color RGB del punto de selección de un botón de opción 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 código siguiente se asigna el valor 0xFF12AC a la propiedad radioDot de
formStyleFormat, lo que generará un punto de selección de color rosa.
formStyleFormat.radioDot = 0xFF12AC;
FStyleFormat.removeListener
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.removeListener(componente)
Parámetros
componente
Componente que se eliminará del formato de estilo.
Descripción
Método; 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 película del elemento de aspecto se visualizarán como si se hubieran editado originalmente
con un diseñador 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 ningún valor de propiedad.
Ejemplo
En el ejemplo siguiente se elimina el componente check1 de globalStyleFormat.
globalStyleFormat.removeListener(check1);
Véase también
FStyleFormat.addListener, FStyleFormat.applyChanges
Diccionario de ActionScript 245
FStyleFormat.scrollTrack
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.scrollTrack
Descripción
Propiedad; valor de color RGB de la parte de guía 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 guía 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 código siguiente se asigna el valor 0xA0522D a la propiedad scrollTrack de
formStyleFormat, lo que generará una guía de desplazamiento de color castaño.
formStyleFormat.scrollTrack = 0xA0522D;
FStyleFormat.selection
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.selection
Descripción
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 selección de los componentes ListBox y
ComboBox, y asigna un valor de color blanco a la propiedad textSelected; esta combinación de
color permite al usuario visualizar fácilmente 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 código siguiente se asigna el valor 0x87CEEB a la propiedad selection de
formStyleFormat, lo que generará una barra de selección de color celeste.
formStyleFormat.selection = 0x87CEEB;
Véase también
FStyleFormat.textSelected
246
FStyleFormat.selectionDisabled
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.selectionDisabled
Descripción
Propiedad; el valor de color RGB de la barra de selección 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 código siguiente se asigna el valor 0x708090 a la propiedad selectionDisabled de
formStyleFormat, lo que generará una barra de selección de color gris pizarra cuando el
componente esté desactivado.
formStyleFormat.selectionDisabled = 0x708090;
Véase también
FStyleFormat.selection
FStyleFormat.selectionUnfocused
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.selectionUnfocused
Descripción
Propiedad; el valor de color RGB de la barra de selección (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 código siguiente se asigna el valor 0xaabbcc a la propiedad selectionUnfocused de
formStyleFormat.
formStyleFormat.selectionUnfocused = 0xaabbcc;
Véase también
FStyleFormat.selection
Diccionario de ActionScript 247
FStyleFormat.shadow
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.shadow
Descripción
Propiedad; el valor de color RGB del borde exterior o la parte más clara del sombreado de un
componente; por ejemplo, el borde exterior del círculo de un botón de opción deseleccionado o
de una casilla de verificación 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 código siguiente se asigna el valor 0x008080 a la propiedad shadow de formStyleFormat,
lo que generará un borde exterior de color verde grisáceo para los componentes no seleccionados
de botón de opción y de casilla de selección.
formStyleFormat.shadow = 0x008080;
Véase también
FStyleFormat.check
FStyleFormat.textAlign
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.textAlign
Descripción
Propiedad; cadena de texto que especifica la alineación 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 código siguiente se alinea a la derecha todo el texto de los componentes mediante
formStyleFormat.
formStyleFormat.textAlign = "right";
Véase también
FStyleFormat.textIndent, FStyleFormat.textLeftMargin,
FStyleFormat.textRightMargin
248
FStyleFormat.textBold
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.textBold
Descripción
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 código siguiente se especifica que todo el texto visualizado en componentes asignados a
formStyleFormat esté en negrita.
formStyleFormat.textBold = true;
Véase también
FStyleFormat.textItalic, FStyleFormat.textUnderline
FStyleFormat.textColor
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.textColor
Descripción
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 código siguiente se asigna el valor 0x000000 a la propiedad textColor de
formStyleFormat, lo que generará un texto de color negro.
formStyleFormat.textColor = 0x000000;
Véase también
FStyleFormat.textDisabled, FStyleFormat.textSelected
Diccionario de ActionScript 249
FStyleFormat.textDisabled
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.textDisabled
Descripción
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 código 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;
Véase también
FStyleFormat.textAlign, FStyleFormat.textSelected
FStyleFormat.textFont
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.textFont
Descripción
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 código siguiente se asigna el valor Arial a la propiedad textFont de formStyleFormat.
formStyleFormat.textFont = "Arial";
FStyleFormat.textIndent
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.textIndent
Descripción
Propiedad; entero que especifica la sangría, en píxeles, desde el margen izquierdo al primer
carácter del texto de todo el texto visualizado mediante el formato de estilo.
250
Ejemplo
En el código siguiente se aplica una sangría de 5 píxeles en todo el texto visualizado mediante
formStyleFormat.
formStyleFormat.textIndent = 5;
Véase también
FStyleFormat.textAlign, FStyleFormat.textLeftMargin
FStyleFormat.textItalic
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.textItalic
Descripción
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 código siguiente se especifica que todo el texto visualizado en componentes asignados en
formStyleFormat esté en cursiva.
formStyleFormat.textItalic = true;
Véase también
FStyleFormat.textBold
FStyleFormat.textLeftMargin
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.textLeftMargin
Descripción
Propiedad; un entero que especifica el margen izquierdo del párrafo, en píxeles, 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 código siguiente se especifica un valor de 4 píxeles para la propiedad textLeftMargin de
formStyleFormat.
formStyleFormat.textLeftMargin = 4;
Véase también
FStyleFormat.textRightMargin
Diccionario de ActionScript 251
FStyleFormat.textRightMargin
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.textRightMargin
Propiedad; un entero que especifica el margen derecho del párrafo, en píxeles, 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 código siguiente se especifica un valor de 4 píxeles para la propiedad textRightMargin de
formStyleFormat.
formStyleFormat.textRightMargin = 4;
Véase también
FStyleFormat.textLeftMargin
FStyleFormat.textSelected
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.textSelected
Descripción
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 selección de los componentes
ListBox y ComboBox, y asigna un valor de color blanco a la propiedad textSelected; esta
combinación de color permite al usuario visualizar fácilmente 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 código 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;
Véase también
FStyleFormat.selection, FStyleFormat.textDisabled
252
FStyleFormat.textSize
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.textSize
Descripción
Propiedad; un entero que especifica el tamaño 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 código siguiente se especifica texto de 10 puntos para todos los componentes asignados a
formStyleFormat.
formStyleFormat.textSize = 10;
Véase también
FStyleFormat.textFont
FStyleFormat.textUnderline
Disponibilidad
Flash Player 6.
Sintaxis
myStyleFormat.textUnderline
Descripción
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 código siguiente se especifica que todo el texto visualizado en componentes asignados a
formStyleFormat esté subrayado.
formStyleFormat.textUnderline = true;
Véase también
FStyleFormat.textBold, FStyleFormat.textItalic
Diccionario de ActionScript 253
Function (objeto)
El objeto Function está disponible en Flash MX.
Resumen de propiedades del objeto Function
Método
Descripción
Function.prototype
Hace referencia a un objeto que es el prototipo de una clase.
Resumen de métodos del objeto Function
Método
Descripción
Function.apply
Activa el código ActionScript para llamar a una función.
Function.call
Invoca la función representada por un objeto Function.
Function.apply
Disponibilidad
Flash Player 6.
Sintaxis
myFunction.apply(objeto, argumentosObjeto)
Parámetros
objeto
Objeto al que se aplica myFunction.
argumentosObjeto
Matriz de elementos que se pasan a myFunction como parámetros.
Valor devuelto
El valor que especifique la función llamada.
Descripción
Método; especifica el valor de this que debe utilizarse con la función a la que llama ActionScript.
Este método también especifica parámetros que deben pasarse a la función llamada. Puesto que
apply es un método del objeto Function, también es un método para cada objeto de función de
ActionScript.
Los parámetros se especifican como un objeto Array. Suele ser útil cuando no se conoce el número
de parámetros hasta que se ejecuta el script.
Ejemplo
Las llamadas de función siguientes son equivalentes:
Math.atan2(1, 0)
Math.atan2.apply(null, [1, 0])
Puede crear una película Flash que contenga campos de entrada que permitan al usuario especificar
el nombre de una función a la que se debe llamar, y cero o más parámetros que se pasarán a la
función. Si se presiona el botón “Llamar” se utilizará el método apply para llamar a la función
especificando los parámetros.
254
En este ejemplo, el usuario especifica un nombre de función en un campo de introducción de
texto denominado nombreFunción. El número de parámetros se especifica en un campo de
introducción de texto denominado númParámetros. Se especifican hasta 10 parámetros en
campos de texto denominados parámetro1, parámetro2, hasta parámetro10.
on (release) {
callTheFunction();
}
...
function callTheFunction()
{
var theFunction = eval(nombreFunción.text);
var n = Number(númParámetros);
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, parámetro1, ..., parámetroN)
Parámetros
objeto
Especifica el valor de this en el cuerpo de la función.
parámetro1
Parámero que se pasa a myFunction. Puede especificar cero o más parámetros.
parámetroN
Valor devuelto
Ninguno.
Descripción
Método; invoca la función representada por un objeto Function. Cada función de ActionScript se
representa mediante un objeto Function, de modo que todas las funciones dan soporte al método
call.
En casi todos los casos, puede utilizarse el operador de llamada de función (()) en lugar del
método call. El operador de llamada de función hace que el código sea conciso y legible. El
método call es de gran utilidad cuando debe controlarse explícitamente el parámetro this o la
llamada de función. Normalmente, si se invoca una función como método de un objeto, this se
establece en myObject como el caso siguiente dentro del cuerpo de la función:
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 función como un método de un objeto, pero en realidad no se
almacena como un método de dicho objeto.
myObject.myMethod.call(myOtherObject, 1, 2, 3);
Diccionario de ActionScript 255
Puede pasar el valor null para el parámetro objeto para invocar una función como función regular
y no como un método de un objeto. Por ejemplo, las llamadas de función siguientes son equivalentes:
Math.sin(Math.PI / 4)
Math.sin.call(null, Math.PI / 4)
Ejemplo
En este ejemplo se utiliza el método call para hacer que una función se comporte como método
de otro objeto, sin almacenar la función en el objeto.
function MyObject() {
}
function MyMethod(obj) {
trace("this == obj? " + (this == obj));
}
var obj = new MyObject();
MyMethod.call(obj, obj);
La acción trace envía el código siguiente a la ventana Salida:
this == obj? true
Function.prototype
Disponibilidad
Flash Player 6.
Sintaxis
myFunction.prototype
Descripción
Propiedad; en una función 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 función
constructor hereda todas las propiedades y los métodos del objeto prototipo.
fscommand
Disponibilidad
Flash Player 3.
Sintaxis
fscommand("comando", "parámetros")
Parámetros
comando
Cadena pasada a la aplicación host para cualquier uso, o comando pasado a Flash Player.
parámetros
Cadena pasada a la aplicación host para cualquier uso, o valor pasado a Flash Player.
Valor devuelto
Ninguno.
Descripción
Acción; permite a la película Flash comunicarse con Flash Player o el programa que aloja Flash
Player, como por ejemplo, el navegador Web. También puede utilizar la acción 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 parámetros
predefinidos. La tabla siguiente muestra los valores que puede especificar para los parámetros
comando y parámetros de la acción fscommand para controlar una película que se ejecuta en
Flash Player (incluidos los proyectores):
Comando
Parámetros
Propósito
quit
Ninguno
Cierra el proyector.
fullscreen
true o false
Especificar true establece Flash Player en el modo de pantalla
completa. Especificar false devuelve el reproductor a la vista de menú
normal.
allowscale
true o false
Si se especifica false el reproductor se establece para que la película se
dibuje siempre a su tamaño original y nunca se cambie su escala. Si se
especifica true obliga a la película a cambiar su escala al 100% del
reproductor.
showmenu
true o false
Especificar true habilita el conjunto completo de elementos de menú de
contexto. Si se especifica false se atenúan todos los elementos de
menú de contexto excepto Acerca de Flash Player.
exec
Ruta de acceso
a la
aplicación
Ejecuta una aplicación desde el interior del proyector.
trapallkeys
true o false
Especificar true envía todos los eventos de teclas, incluidas teclas
aceleradoras, al controlador onClipEvent(keyDown/keyUp) en Flash
Player.
Sintaxis 2: para utilizar la opción fscommand y enviar un mensaje en un lenguaje de creación de
scripts, como por ejemplo JavaScript en un navegador Web, puede pasar dos parámetros que desee
en los parámetros comando y parámetros. Estos argumentos pueden ser cadenas o expresiones y
se utilizan en una función de JavaScript que “captura” o controla la acción fscommand.
En un navegador Web, la acción fscommand llama a la función JavaScript
nombrePelícula_DoFScommand en la página HTML que contiene la película Flash. En
nombrePelícula se incluye el nombre de Flash Player asignado mediante el atributo NAME del
código EMBED de la propiedad ID del código OBJECT. Si asigna a Flash Player el nombre myMovie,
la función de JavaScript invocada es myMovie_DoFSCommand.
Sintaxis 3: la acción fscommand puede enviar mensajes a Macromedia Director que son
interpretados por Lingo como cadenas, eventos o código Lingo ejecutable. Si el mensaje es una
cadena o un evento, debe escribir el código Lingo para recibir el mensaje de la acción fscommand
y llevar a cabo una acción en Director.
Sintaxis 4: en Visual Basic, Visual C++, y otros programas que pueden aceptar controles ActiveX,
fscommand envía un evento VB con dos cadenas que pueden controlarse en el lenguaje de
programación del entorno. Para obtener más información, utilice las palabras clave Flash method
para buscar elCentro de Soporte Flash.
Ejemplo
Sintaxis 1: en el ejemplo siguiente, la acción fscommand hace que Flash Player ajuste la escala de la
película en pantalla completa al soltar el botón.
on(release){
fscommand("fullscreen", true);
}
Diccionario de ActionScript 257
Sintaxis 2: en el ejemplo siguiente se utiliza la acción fscommand aplicada a un botón en Flash
para abrir un cuadro de mensaje JavaScript en una página HTML. El mensaje se envía a
JavaScript como parámetro fscommand.
Debe agregar una función a la página HTML que contiene la película Flash. Esta función,
myMovie_DoFSCommand se establece en la página HTML y espera una acción fscommand en Flash.
Cuando se activa fscommand en Flash (por ejemplo, cuando un usuario presiona el botón), se
pasan las cadenas comando y parámetro a la función myMovie_DoFSCommand. Puede utilizar las
cadenas pasadas en el código JavaScript o VBScript como desee. En este ejemplo, la función
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 parámetros.
function myMovie_DoFSCommand(command, args) {
if (command == "messagebox") {
alert(args);
}
}
En el documento Flash, agregue la acción fscommand a un botón:
fscommand("messagebox", "Es un cuadro de mensajes invocado desde Flash.")
También puede utilizar expresiones para la acción fscommand y parámetros, como en el ejemplo
siguiente:
fscommand("messagebox", "Hola, " + name + ", bienvenido/a a nuestra página Web.")
Para comprobar la película, elija Archivo > Previsualización de publicación > HTML.
Nota: si publica su película utilizando Flash con la plantilla FSCommand en Configuración de publicación en HTML,
la función myMovie_DoFSCommand se inserta automáticamente. Los atributos NAME y ID de la película serán el
nombre del archivo. Por ejemplo, para el archivo myMovie.fla, los atributos se establecerían en myMovie.
function
Disponibilidad
Flash Player 5.
Sintaxis
function nombrefunción ([parámetro0, parámetro1,...parámetroN]){
sentencia(s)
}
function ([parámetro0, parámetro1,...parámetroN]){
sentencia(s)
}
Parámetros
nombrefunción
El nombre de la nueva función.
Identificador que representa un parámetro que debe pasarse a la función. Estos
parámetros son opcionales.
parámetro
sentencia(s)
Valor devuelto
Ninguno.
258
Instrucción de ActionScript definida para el cuerpo de la función.
Descripción
Acción; un conjunto de sentencias que define para realizar una determinada tarea. Puede declarar
o definir una función en una ubicación y llamarla, o invocarla, desde diferentes scripts de una
película. Cuando defina una función, también puede especificar sus parámetros. Los parámetros
son marcadores de posición para valores en los que opera la función. Puede pasar diferentes
parámetros en una función cada vez que la llama. Esto permite volver a utilizar una función en
muchas situaciones diferentes.
Utilice la acción return en las sentencias de una función para hacer que la función devuelva o
genere un valor.
Sintaxis 1: declara una función con los valores especificados de nombrefunción, parámetros y
sentencia(s). Cuando se llama a una función, se invoca la declaración de función. Se permite la
referencia hacia delante; dentro de la misma lista de Acciones, puede declararse una función después
de que ha sido llamada. Una declaración de función sustituye a cualquier declaración anterior de la
misma función. Puede utilizar esta sintaxis siempre que esté permitido un argumento.
Sintaxis 2: crea una función anónima y la devuelve. Esta sintaxis se utiliza en expresiones y es muy
útil para instalar métodos en objetos.
Ejemplo
Sintaxis 1: en el ejemplo siguiente se define la función sqr, que acepta un parámetro y devuelve el
valor square(x*x) del parámetro. Observe que la función se declara y utiliza en el mismo script,
la declaración de función puede aparecer tras la utilización de la función.
y=sqr(3);
function sqr(x) {
return x*x;
}
Sintaxis 2: en la función siguiente se define un objeto de círculo (Circle):
function Circle(radius) {
this.radius = radius;
}
En la sentencia siguiente se define una función anónima que calcula el área de un círculo y la
asocia al objeto Circle como un método:
Circle.prototype.area = function () {return Math.PI * this.radius *
this.radius}
ge (mayor o igual que, específico de cadena)
Disponibilidad
Flash Player 4. Esta función se ha desestimado en Flash 5; se recomienda utilizar el operador >=
(mayor o igual que).
Sintaxis
expresión1 ge expresión2
Parámetros
expresión1, expresión2
Números, cadenas o variables.
Valor devuelto
Ninguno.
Diccionario de ActionScript 259
Descripción
Operador (comparación); compara la representación de cadena de expresión1 con la
representación de cadena de expresión2 y devuelve true si expresión1 es mayor o igual que
expresión2; de lo contrario, devuelve false.
Véase también
>= (mayor o igual que)
getProperty
Disponibilidad
Flash Player 4.
Sintaxis
getProperty(nombreinstancia , propiedad)
Parámetros
nombreinstancia
Nombre de instancia de un clip de película para el que se recupera la
propiedad.
propiedad
Propiedad de un clip de película.
Valor devuelto
Ninguno.
Descripción
Función; devuelve el valor de la propiedad para el clip de película nombreinstancia.
Ejemplo
En el ejemplo siguiente se recupera la coordenada de eje horizontal (_x) del clip de película
myMovie y se lo asigna a la variable myMovieX:
myMovieX = getProperty(_root.myMovie, _x);
getTimer
Disponibilidad
Flash Player 4.
Sintaxis
getTimer()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Función; devuelve el número de milisegundos que han transcurrido desde que la película
comenzó a reproducirse.
260
getURL
Disponibilidad
Flash 2. Las opciones GET y POST están disponibles solamente en Flash Player 4 y versiones
posteriores.
Sintaxis
getURL(url [, ventana [, "variables"]])
Parámetros
url
La dirección URL de la que se obtiene el documento.
ventana Argumento opcional que especifica la ventana o el fotograma HTML en el que debería
cargarse el documento. Puede especificar el nombre de una ventana específica o seleccionar uno
de los nombres de destino reservados siguientes:
•
•
•
•
_self
especifica el fotograma actual de la ventana vigente.
_blank
especifica una nueva ventana.
_parent
_top
especifica el padre del fotograma actual.
especifica el fotograma de nivel superior de la ventana actual.
Método GET o POST para el envío de variables. Si no hay variables, omita este
parámetro. El método GET adjunta las variables al final de la dirección URL y sirve para pequeñas
cantidades de variables. El método POST envía las variables en un encabezado HTTP separado y se
usa para el envío de cadenas largas de variables.
variables
Valor devuelto
Ninguno.
Descripción
Acción; carga un documento desde un URL específico en una ventana o pasa variables a otra
aplicación en un URL definido. Para probar esta acción, asegúrese de que el archivo que se va a
cargar se encuentra en la ubicación especificada. Para utilizar una dirección URL absoluta (por
ejemplo, http://www.myserver.com), necesita una conexión de red.
Ejemplo
En este ejemplo se carga un nuevo URL en una ventana del navegador vacía. La acción getURL
destina la variable incomingAd como el parámetro url para que pueda cambiar el URL cargado
sin tener que editar la película Flash. El valor de la variable incomingAd se pasa antes a Flash en la
película utilizando una acción loadVariables.
on(release) {
getURL(incomingAd, "_blank");
}
Véase también
loadVariables, XML.send, XML.sendAndLoad, XMLSocket.send
Diccionario de ActionScript 261
getVersion
Disponibilidad
Flash Player 5.
Sintaxis
getVersion()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Función, devuelve una cadena que contiene la información de la versión de Flash Player y de la
plataforma.
La función getVersion sólo devuelve información para Flash Player 5 o versiones posteriores.
Ejemplo
A continuación se muestra un ejemplo de una cadena devuelta por la función getVersion:
WIN 5,0,17,0
Ésta indica que la plataforma es Windows y el número de la versión de Flash Player es versión
mayor 5, versión menor 17 (50r17).
_global
Disponibilidad
Flash Player 6.
Sintaxis
_global.identifier
Parámetros
Ninguno.
Valor devuelto
Referencia al objeto global que contiene las clases básicas de ActionScript, como por ejemplo,
String, Object, Math y Array.
Descripción
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 línea de tiempo o declaradas localmente, las
variables y las funciones globales están visibles para cada línea de tiempo y ámbito en la película 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 función de nivel superior factorial, disponible en cada línea
de tiempo y ámbito de una película Flash:
_global.factorial = function (n) {
if (n <= 1) {
return 1;
} else {
return n * factorial(n-1);
}
}
Véase también
var, set variable
globalStyleFormat
Disponibilidad
Flash Player 6.
Sintaxis
globalStyleFormat.propiedadEstilo
Parámetros
propiedadEstilo
Propiedad del objeto FStyleFormat.
Valor devuelto
Ninguno.
Descripción
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 más información, consulte el apartado “Personalización de los colores y el texto de los
componentes” en el capítulo “Utilización de componentes” de la publicación Utilización de Flash.
Ejemplo
En el código siguiente se establece la propiedad arrow de FStyleFormat para la instancia
globalStyleFormat.
globalStyleFormat.arrow = 0x800080;
Véase también
FStyleFormat (objeto)
Diccionario de ActionScript 263
gotoAndPlay
Disponibilidad
Flash 2.
Sintaxis
gotoAndPlay(escena, fotograma)
Parámetros
escena
El nombre de la escena a la que se envía la cabeza lectora.
fotograma
Número o etiqueta de fotograma al que se envía la cabeza lectora.
Valor devuelto
Ninguno.
Descripción
Acción; envía 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 botón al que está asignada la acción gotoAndPlay, la cabeza
lectora se envía al fotograma 16 y empieza la reproducción.
on(release) {
gotoAndPlay(16);
}
gotoAndStop
Disponibilidad
Flash 2.
Sintaxis
gotoAndStop(escena, fotograma)
Parámetros
escena
El nombre de la escena a la que se envía la cabeza lectora.
fotograma
Número o etiqueta de fotograma al que se envía la cabeza lectora.
Valor devuelto
Ninguno.
Descripción
Acción; envía la cabeza lectora al fotograma especificado en una escena y lo detiene. Si no se
especifica ninguna escena, la cabeza lectora se envía al fotograma en la escena actual.
Ejemplo
Cuando el usuario hace clic sobre un botón, se asigna la acción gotoAndStop, se envía la cabeza
lectora al fotograma 5 y deja de reproducirse la película.
on(release) {
gotoAndStop(5);
}
264
gt (mayor que, específico de cadena)
Disponibilidad
Flash Player 4. Este operador se ha desestimado en Flash 5; se recomienda utilizar el nuevo
operador > (mayor que).
Sintaxis
expresión1 gt expresión2
Parámetros
expresión1,expresión2
Números, cadenas o variables.
Descripción
Operador (comparación); compara la representación de cadena de expresión1 con la
representación de cadena de expresión2 y devuelve true si expresión1 es mayor que
expresión2; de lo contrario, devuelve false.
Véase también
> (mayor que)
_highquality
Disponibilidad
Flash Player 4.
Sintaxis
_highquality
Descripción
Propiedad (global); especifica el nivel de suavizado aplicado a la película 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 película no contiene
animación. Especifique 0 (baja calidad) para evitar el suavizado.
Ejemplo
_highquality = 1;
Véase también
_quality, toggleHighQuality
if
Disponibilidad
Flash Player 4.
Sintaxis
if(condición) {
sentencia(s);
}
Parámetros
condición
Una expresión que da como resultado true o false.
sentencia(s)
true.
Las instrucciones que se deben ejecutar si o cuando la condición da como resultado
Diccionario de ActionScript 265
Valor devuelto
Ninguno.
Descripción
Acción; calcula el resultado de una condición para determinar la siguiente acción en una película.
Si la condición es true, Flash ejecuta las sentencias entre llaves ({}) que van a continuación de la
condición. Si la condición es false, Flash omite las sentencias entre llaves y ejecuta las sentencias
que siguen a dichas llaves. Utilice la acción if para crear lógica de ramas en sus scripts.
Ejemplo
En el ejemplo siguiente, la condición entre paréntesis comprueba si la variable name contiene el
valor literal “Erica”. Si es así, se ejecuta la acción play encerrada entre llaves.
if(name == "Erica"){
play();
}
Ejemplo
El siguiente ejemplo utiliza una acción if para comprobar si el usuario suelta en la película un
objeto arrastrable. Si el objeto se suelta antes de que transcurran 300 milisegundos tras arrastrarlo,
la condición da como resultado true y se ejecutan las sentencias entre llaves. Estas sentencias
definen variables para almacenar la nueva ubicación del objeto y para determinar con qué fuerza
se soltó y la velocidad a la que se soltó. También se restablece la variable timePressed. Si el objeto
se suelta una vez transcurridos 300 milisegundos tras arrastrarlo, la condición da como resultado
false y no se ejecuta ninguna sentencia.
if (getTimer()<timePressed+300) {
// si la condición es verdadera,
// el objeto se ha soltado.
// ¿cuál es la nueva ubicación de este objeto?
xNewLoc = this._x;
yNewLoc = this._y;
// ¿con qué fuerza se soltó?
xTravel = xNewLoc-xLoc;
yTravel = yNewLoc-yLoc;
// definición de la velocidad del objeto en función de
// la distancia que ha recorrido
xInc = xTravel/2;
yInc = yTravel/2;
timePressed = 0;
}
Véase también
else
266
ifFrameLoaded
Disponibilidad
Flash Player 3. La acción ifFrameLoaded se ha desestimado en Flash 5; se recomienda utilizar la
acción MovieClip._framesloaded.
Sintaxis
ifFrameLoaded(escena, fotograma) {
sentencia;
}
ifFrameLoaded(fotograma) {
sentencia;
}
Parámetros
escena
La escena que debe cargarse.
El número de fotograma o la etiqueta de fotograma que debe cargarse antes de
ejecutar la sentencia siguiente.
fotograma
Las instrucciones que se deben ejecutar si se carga la escena especificada o la
escena y el fotograma indicados.
sentencia(s)
Valor devuelto
Ninguno.
Descripción
Acción; comprueba si el contenido de un fotograma específico está disponible localmente. Utilice
ifFrameLoaded para empezar a reproducir una animación sencilla mientras se descarga el resto de
la película en el sistema local. La diferencia entre utilizar _framesloaded y ifFrameLoaded es
que _framesloaded le permite agregar sus propias sentencias if o else.
Véase también
MovieClip._framesloaded
#include
Disponibilidad
N/A
Sintaxis
#include "archivo.as"
Parámetros
El nombre de archivo que el script debe agregar al panel Acciones; .as es la
extensión de archivo recomendada.
archivo.as
Valor devuelto
Ninguno.
Descripción
Acción; incluye el contenido del archivo especificado en el parámetro cuando se prueba, se
publica o se exporta una película. La acción #include se invoca al probar, publicar o exportar la
película. La acción #include se comprueba al realizar una comprobación de sintaxis.
Diccionario de ActionScript 267
#initclip
Disponibilidad
Flash Player 6.
Sintaxis
#initclip orden
Parámetros
orden Un número entero
#initclip. Este parámetro
que especifica el orden de ejecución de los bloques del código
es opcional.
Descripción
Acción; indica el inicio de un bloque de acciones de inicialización de componentes. Si se inicializan
varios clips al mismo tiempo, se puede utilizar el parámetro orden para especificar cuál es la
inicialización que se llevará a cabo en primer lugar. Las acciones de inicialización de componentes se
ejecutan cuando se define un símbolo de clip de película. Si el clip de película es un símbolo
exportado, las acciones de inicialización de componentes se ejecutarán antes que las acciones del
fotograma 1 del archivo SWF. En caso contrario, se ejecutarán inmediatamente antes de las acciones
del fotograma que contiene la primera sentencia del símbolo de clip de película asociado.
Las acciones de inicialización de componentes sólo se ejecutan una vez durante la reproducción de
una película y deben utilizarse para las inicializaciones que tienen lugar una vez, como por
ejemplo, la definición de clase y el registro.
Ejemplo
El código de ejemplo siguiente se asigna al primer fotograma de una película que es un
componente de tipo casilla de verificación. Las acciones #initclip y #endinitclip designan el
bloque de sentencias que incluyen como acciones de inicialización de componentes. Las
sentencias incluidas registran la clase y almacenan los métodos 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 símbolo "Check Box"
Object.registerClass("Check Box", CheckBox);
// Definir algunos métodos
CheckBox.prototype.enable = function () { ... };
CheckBox.prototype.show = function () { ... };
CheckBox.prototype.hide = function () { ... };
// Definir una función de ayuda para crear instancias de
// casillas de verificación
CheckBox.create = function (parentMovieClip, instanceName, depth) {
parentMovieClip.attachMovie("CheckBox", instanceName, depth);
};
}
#endinitclip
Nota: si copia y pega este código en el panel Acciones, se generará un error al compilar el script debido a las
funciones no definidas ({...})
Véase también
#endinitclip
268
instanceof
Disponibilidad
Flash Player 6.
Sintaxis
objeto instanceof clase
Parámetros
objeto
clase
Un objeto de ActionScript.
Una referencia a una función 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.
Descripción
Operador; determina si un objeto pertenece a una clase específica. 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 función
constructor está en la cadena prototipo del objeto de ActionScript.
El operador instanceof no convierte los tipos primitivos en objetos envolventes. Por ejemplo, el
código siguiente devuelve true:
new String("Hola") instanceof String
Mientras que el código siguiente devuelve false:
"Hola" instanceof String
Ejemplo
Para ilustrar el algoritmo del operador instanceof, el ejemplo siguiente muestra qué aspecto
tendría el operador instanceof si se hubiera codificado como una función de ActionScript.
function instanceof (theObject, theClass){
while ((theObject = theObject.__proto__) != null) {
if (theObject == theClass.prototype) {
return true;
}
}
return false;
}
Véase también
typeof
Diccionario de ActionScript 269
int
Disponibilidad
Flash Player 4. Esta función se ha desestimado en Flash 5; se recomienda utilizar el método
Math.round.
Sintaxis
int(valor)
Parámetros
valor
Un número que se va a redondear en un número entero.
Valor devuelto
Ninguno.
Descripción
Función; convierte un número decimal en el valor del número entero más cercano.
Véase también
Math.floor
isFinite
Disponibilidad
Flash Player 5.
Sintaxis
isFinite(expresión)
Parámetros
expresión
Un booleano, una variable u otra expresión cuyo resultado se debe calcular.
Valor devuelto
Ninguno.
Descripción
Función de nivel superior; calcula el resultado de la expresión y devuelve true si es un número
finito y false si es infinito o infinito negativo. La presencia de infinito o de infinito negativo
indica una condición de error matemático como una división por 0.
Ejemplo
A continuación 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(expresión)
Parámetros
expresión
Un booleano, una variable u otra expresión cuyo resultado se debe calcular.
Valor devuelto
Ninguno.
Descripción
Función de nivel superior; calcula el resultado del parámetro y devuelve true si el valor no es un
número (NaN), lo que indica la presencia de errores matemáticos.
Ejemplo
El código siguiente muestra los valores de retorno de la función 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 métodos del objeto Key para crear una interfaz que pueda ser controlada por cualquier
usuario con un teclado estándar. Las propiedades del objeto Key son constantes que representan
las teclas que se utilizan con mayor frecuencia para controlar juegos. Para obtener la relación
completa de valores de códigos de tecla, consulte el apéndice “Teclas del teclado y valores de
códigos de tecla” de la publicación Utilización 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 película.
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 métodos del objeto Key
Método
Descripción
Key.addListener
Registra un objeto para que reciba una notificación cuando se invoquen los métodos
onKeyDown y onKeyUp.
Key.getAscii
Devuelve el valor ASCII de la última tecla presionada.
Key.getCode
Devuelve el código de tecla virtual de la última tecla presionada.
Key.isDown
Devuelve true si se presiona la tecla especificada en el parámetro.
Key.isToggled
Devuelve true si está activada la tecla Bloq Num o Bloq Mayús.
Key.removeListener
Elimina un objeto registrado previamente con addListener.
Resumen de las propiedades del objeto Key
Todas las propiedades del objeto Key son constantes.
Propiedad
Descripción
Key.BACKSPACE
Constante asociada con el valor del código de tecla para la tecla Retroceso (8).
Key.CAPSLOCK
Constante asociada con el valor del código de tecla para la tecla Bloq Mayús (20).
Key.CONTROL
Constante asociada con el valor del código de tecla para la tecla Control (17).
Key.DELETEKEY
Constante asociada con el valor del código de tecla para la tecla Supr (46).
Key.DOWN
Constante asociada con el valor del código de tecla para la tecla Flecha abajo (40).
Key.END
Constante asociada con el valor del código de tecla para la tecla Fin (35).
Key.ENTER
Constante asociada con el valor del código de tecla para la tecla Intro (13).
Key.ESCAPE
Constante asociada con el valor del código de tecla para la tecla Escape (27).
Key.HOME
Constante asociada con el valor del código de tecla para la tecla Inicio (36).
Key.INSERT
Constante asociada con el valor del código de tecla para la tecla Insert (45).
Key.LEFT
Constante asociada con el valor del código de tecla para la tecla Flecha izquierda (37).
Key.PGDN
Constante asociada con el valor del código de tecla para la tecla Av Pág (34).
Key.PGUP
Constante asociada con el valor del código de tecla para la tecla Re Pág (33).
Key.RIGHT
Constante asociada con el valor del código de tecla para la tecla Flecha derecha (39).
Key.SHIFT
Constante asociada con el valor del código de tecla para la tecla Mayús (16).
Key.SPACE
Constante asociada con el valor del código de tecla para la Barra espaciadora (32).
Key.TAB
Constante asociada con el valor del código de tecla para la tecla Tabulador (9).
Key.UP
Constante asociada con el valor del código de tecla para la tecla Flecha arriba (38).
Resumen de los detectores del objeto Key
272
Método
Descripción
Key.onKeyDown
Recibe notificación cuando se presiona una tecla.
Key.onKeyUp
Recibe notificación cuando se suelta una tecla.
Key.addListener
Disponibilidad
Flash Player 6.
Sintaxis
Key.addListener (nuevoDetector)
Parámetros
nuevoDetector
Un objeto con los métodos onKeyDown y onKeyUp.
Valor devuelto
Ninguno.
Descripción
Método; registra un objeto para que reciba una notificación de onKeyDown y onKeyUp. Al
presionar o soltar una tecla, sin tener en cuenta la selección de entrada, se invoca el método
onKeyDown u onKeyUp de todos los objetos de detección registrados con addListener. Varios
objetos pueden detectar notificaciones de teclado. Si el detector nuevoDetector ya está
registrado, no se produce ningún cambio.
Ejemplo
Este ejemplo crea un nuevo objeto detector y define una función para onKeyDown y onKeyUp. La
última línea utiliza el método addListener para registrar el detector con el objeto Key para que
pueda recibir notificación 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
Descripción
Propiedad; constante asociada con el valor del código de tecla para la tecla Retroceso (8).
Key.CAPSLOCK
Disponibilidad
Flash Player 5.
Sintaxis
Key.CAPSLOCK
Descripción
Propiedad; constante asociada con el valor del código de tecla para la tecla Bloq Mayús (20).
Diccionario de ActionScript 273
Key.CONTROL
Disponibilidad
Flash Player 5.
Sintaxis
Key.CONTROL
Descripción
Propiedad; constante asociada con el valor del código de tecla para la tecla Control (17).
Key.DELETEKEY
Disponibilidad
Flash Player 5.
Sintaxis
Key.DELETEKEY
Descripción
Propiedad; constante asociada con el valor del código de tecla para la tecla Supr (46).
Key.DOWN
Disponibilidad
Flash Player 5.
Sintaxis
Key.DOWN
Descripción
Propiedad; constante asociada con el valor del código de tecla para la tecla Flecha abajo (40).
Key.END
Disponibilidad
Flash Player 5.
Sintaxis
Key.END
Descripción
Propiedad; constante asociada con el valor del código de tecla para la tecla Fin (35).
Key.ENTER
Disponibilidad
Flash Player 5.
Sintaxis
Key.ENTER
Descripción
Propiedad; constante asociada con el valor del código de tecla para la tecla Intro (13).
274
Key.ESCAPE
Disponibilidad
Flash Player 5.
Sintaxis
Key.ESCAPE
Descripción
Propiedad; constante asociada con el valor del código de tecla para la tecla Escape (27).
Key.getAscii
Disponibilidad
Flash Player 5.
Sintaxis
Key.getAscii();
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; devuelve el código ASCII de la última tecla presionada o soltada. Los valores ASCII
devueltos son valores del teclado inglés. Por ejemplo, si presiona Mayús+2, Key.getAscii
devuelve @ en un teclado japonés, igual que en un teclado inglés.
Key.getCode
Disponibilidad
Flash Player 5.
Sintaxis
Key.getCode();
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; devuelve el código de tecla virtual de la última tecla presionada. Para que el valor de
código de tecla devuelto coincida con la tecla virtual de un teclado estándar, utilice la información
que se proporciona en el Apéndice C, “Teclas del teclado y valores de códigos de tecla”, de la
publicación Utilización de Flash.
Diccionario de ActionScript 275
Key.HOME
Disponibilidad
Flash Player 5.
Sintaxis
Key.HOME
Descripción
Propiedad; constante asociada con el valor del código de tecla para la tecla Inicio (36).
Key.INSERT
Disponibilidad
Flash Player 5.
Sintaxis
Key.INSERT
Descripción
Propiedad; constante asociada con el valor del código de tecla para la tecla Insert (45).
Key.isDown
Disponibilidad
Flash Player 5.
Sintaxis
Key.isDown(códigotecla);
Parámetros
El valor de código de tecla asignado a una tecla específica o a una propiedad de
objeto Key asociada con una tecla específica. Para obtener una lista de los códigos de tecla
asociados con las teclas de un teclado estándar, consulte el apéndice C, “Teclas del teclado y
valores de códigos de tecla”, de la publicación Utilización de Flash.
códigotecla
Valor devuelto
Ninguno.
Descripción
Método; devuelve true si se presiona la tecla especificada en códigotecla. En Macintosh, los
valores de código de tecla para las teclas Bloq Mayús y Bloq Num son idénticos.
276
Key.isToggled
Disponibilidad
Flash Player 5.
Sintaxis
Key.isToggled(códigotecla)
Parámetros
códigotecla
El código de tecla de Bloq Mayús (20) o Bloq Num (144).
Valor devuelto
Ninguno.
Descripción
Método; devuelve true si está activada la tecla Bloq Num o Bloq Mayús. En Macintosh, los
valores de código de tecla para estas teclas son idénticos.
Key.LEFT
Disponibilidad
Flash Player 5.
Sintaxis
Key.LEFT
Descripción
Propiedad; constante asociada con el valor del código de tecla para la tecla Flecha izquierda (37).
Key.onKeyDown
Disponibilidad
Flash Player 6.
Sintaxis
someListener.onKeyDown
Descripción
Detector, se notifica cuando se presiona una tecla. Para utilizar onKeyDown, debe crear un objeto
detector. A continuación, puede definir una función para onKeyDown y utilizar el método
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 código cooperen, ya que varios detectores
pueden recibir notificaciones sobre un mismo evento.
Véase también
Key.addListener
Diccionario de ActionScript 277
Key.onKeyUp
Disponibilidad
Flash Player 6.
Sintaxis
someListener.onKeyUp
Descripción
Detector, recibe notificación cuando se suelta una tecla. Para utilizar onKeyUp debe crear un
objeto detector. A continuación, puede definir una función para onKeyUp y utilizar el método
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 código cooperen, ya que varios detectores
pueden recibir notificaciones sobre un mismo evento.
Véase también
Key.addListener
Key.PGDN
Disponibilidad
Flash Player 5.
Sintaxis
Key.PGDN
Descripción
Propiedad; constante asociada con el valor del código de tecla para la tecla Av Pág (34).
Key.PGUP
Disponibilidad
Flash Player 5.
Sintaxis
Key.PGUP
Descripción
Propiedad; constante asociada con el valor del código de tecla para la tecla Re Pág (33).
Key.removeListener
Disponibilidad
Flash Player 6.
Sintaxis
Key.removeListener (detector)
Parámetros
detector
278
Un objeto.
Valor devuelto
Si el detector se ha eliminado correctamente, el método 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 método devuelve false.
Descripción
Método; elimina un objeto previamente registrado con el método addListener.
Key.RIGHT
Disponibilidad
Flash Player 5.
Sintaxis
Key.RIGHT
Descripción
Propiedad; constante asociada con el valor del código de tecla para la tecla Flecha derecha (39).
Key.SHIFT
Disponibilidad
Flash Player 5.
Sintaxis
Key.SHIFT
Descripción
Propiedad; constante asociada con el valor del código de tecla para la tecla Mayús (16).
Key.SPACE
Disponibilidad
Flash Player 5.
Sintaxis
Key.SPACE
Descripción
Propiedad; constante asociada con el valor del código de tecla de la Barra espaciadora (32).
Key.TAB
Disponibilidad
Flash Player 5.
Sintaxis
Key.TAB
Descripción
Propiedad; constante asociada con el valor del código de tecla de la tecla Tabulador (9).
Diccionario de ActionScript 279
Key.UP
Disponibilidad
Flash Player 5.
Sintaxis
Key.UP
Descripción
Propiedad; constante asociada con el valor del código de tecla de la tecla Flecha arriba (38).
le (menor o igual que; específico para cadenas)
Disponibilidad
Flash Player 4. Este operador se ha desestimado en Flash 5; se recomienda utilizar el operador <=
(menor o igual que).
Sintaxis
expresión1 le expresión2
Parámetros
expresión1,expresión2
Números, cadenas o variables.
Valor devuelto
Ninguno.
Descripción
Operador (de comparación); compara expresión1 con expresión2 y devuelve un valor true si
expresión1 es menor o igual que expresión2; en caso contrario, devuelve un valor false.
Véase también
<= (menor o igual que)
length
Disponibilidad
Flash Player 4. Esta función, junto con todas las funciones de cadena, se ha desestimado en Flash 5.
Se recomienda utilizar los métodos y la propiedad length del objeto String para realizar las mismas
operaciones.
Sintaxis
length(expresión)
length(variable)
Parámetros
expresión
variable
Una cadena.
El nombre de una variable.
Valor devuelto
Ninguno.
Descripción
Función 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.
Véase también
" " (delimitador de cadena), String.length
_level
Disponibilidad
Flash Player 4.
Sintaxis
_levelN
Descripción
Propiedad; una referencia a la línea de tiempo de la película raíz _levelN. Debe utilizar la acción
loadMovieNum para cargar películas en Flash Player antes de usar la propiedad _level para
especificar el destino de las mismas. También puede utilizar _levelN para especificar el destino de
una película cargada en el nivel asignado por N.
La película inicial cargada en una instancia de Flash Player se carga automáticamente en _level0.
La película de _level0 establece la velocidad y tamaño de los fotogramas y el color de fondo para
todas las demás películas cargadas posteriormente. Éstas se apilan en niveles superiores al de la
película de _level0.
Debe asignar un nivel a cada película que cargue en Flash Player mediante la acción loadMovieNum.
Puede asignar niveles en cualquier orden. Si asigna un nivel que ya contiene un archivo SWF
(incluido _level0), la película de ese nivel se descargará y se sustituirá por la nueva película.
Ejemplo
El ejemplo siguiente detiene la cabeza lectora de la línea de tiempo principal de la película de
_level9.
_level9.stop();
El ejemplo siguiente envía la cabeza lectora de la línea de tiempo principal de la película de
_level4 al fotograma 5. La película de _level4 debe haberse cargado previamente con una
acción loadMovieNum.
_level4.gotoAndStop(5);
Véase también
loadMovie, MovieClip.swapDepths
Diccionario de ActionScript 281
loadMovie
Disponibilidad
Flash Player 3.
Sintaxis
loadMovie("url",nivel/destino[, variables])
Parámetros
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 película. Todos los archivos SWF, ya sea que
se utilicen en Flash Player o para realizar pruebas en el modo de prueba en la aplicación de edición
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 película de destino. El clip de película de destino se
sustituirá por la imagen o película cargada. Debe especificar un clip de película de estino o un
nivel de una película de destino; no se pueden especificar ambos valores.
Un número entero que especifica el nivel de Flash Player en el que se cargará la película.
Al cargar una película o una imagen en un nivel, la acción loadMovie del panel Acciones en
modo Normal cambia a loadMovieNum; en modo Experto, debe especificar la acción
loadMovieNum o seleccionarla de la caja de herramientas Acciones.
nivel
Un parámetro opcional que especifica un método HTTP para enviar variables. El
parámetro debe ser la cadena GET o POST. Si no hay ninguna variable para enviar, no incluya este
parámetro. El método GET adjunta las variables al final del URL y se utiliza para un número
pequeño de variables. El método POST envía las variables en un encabezado HTTP distinto y se
usa para cadenas largas de variables.
variables
Valor devuelto
Ninguno.
Descripción
Acción; carga un archivo SWF o JPEG en Flash Player mientras se reproduce la película original.
La acción loadMovie permite ver varias películas al mismo tiempo o pasar de una película a otra
sin cargar otro documento HTML. Sin la acción loadMovie, Flash Player muestra una sola
película (archivo SWF) y después se cierra.
Si utiliza la acción loadMovie, debe especificar un nivel en Flash Player o un clip de película de
destino en el que se cargará la película. Si especifica un nivel, la acción cambiará a loadMovieNum.
Si una película se carga en un clip de película de destino, puede utilizar la ruta de destino de dicho
clip de película para especificar el destino de la película cargada.
Una película o imagen cargada en un destino hereda las propiedades de posición, rotación y escala
del clip de película de destino. La esquina superior izquierda de la imagen o película cargada se
alinea con el punto de registro del clip de película de destino. Como alternativa, si el destino es la
línea de tiempo _root, la esquina superior izquierda de la imagen o película se alineará con la
esquina superior izquierda del escenario.
Utilice la acción unloadMovie para eliminar películas cargadas con la acción loadMovie.
282
Ejemplo
La sentencia loadMovie siguiente está asociada al botón de navegación con la etiqueta Productos.
Hay un clip de película invisible en el escenario con el nombre de instancia dropZone. La acción
loadMovie utiliza este clip de película como parámetro de destino para cargar los productos del
archivo SWF en la posición 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 acción loadMovie:
loadMovie("image45.jpeg", "ourMovieClip");
Véase también
loadMovieNum, unloadMovie, unloadMovieNum, _level
loadMovieNum
Disponibilidad
Flash Player 4. Los archivos de Flash 4 que se abran en Flash 5 se convertirán para utilizar la
sintaxis correcta.
Sintaxis
loadMovieNum("url",nivel[, variables])
Parámetros
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 película. Todos los archivos SWF, ya sea para
utilizarlos en Flash Player o para realizar pruebas en el modo de prueba de película en la aplicación
de edición 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 número entero que especifica el nivel de Flash Player en el que se cargará la película.
Un parámetro opcional que especifica un método HTTP para enviar variables. El
parámetro debe ser la cadena GET o POST. Si no hay ninguna variable para enviar, no incluya este
parámetro. El método GET adjunta las variables al final del URL y se utiliza para un número
pequeño de variables. El método POST envía las variables en un encabezado HTTP distinto y se
usa para cadenas largas de variables.
variables
Valor devuelto
Ninguno.
Descripción
Acción; carga un archivo SWF o JPEG en un nivel de Flash Player mientras se reproduce la
película original cargada. Al cargar una película en un nivel en lugar de un destino, la acción
loadMovie del panel Acciones en modo Normal cambia a loadMovieNum; en modo Experto,
debe especificar la acción loadMovieNum o seleccionarla de la caja de herramientas Acciones. Por
lo general, Flash Player muestra una sola película (archivo SWF) y después se cierra. La acción
loadMovieNum permite ver varias películas al mismo tiempo y cambiar entre películas 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 acción loadMovieNum, debe especificar el nivel de Flash Player en el que se cargará la película.
Una vez que se ha cargado la película en un nivel, puede utilizar la sintaxis _levelN, siendo N el
número de nivel, para especificar el destino de la película.
Al cargar una película, puede especificar cualquier número de nivel y puede cargar las películas en
un nivel en el que ya se haya cargado un archivo SWF. Al hacerlo, la nueva película sustituye al
archivo SWF existente. Si carga una nueva película en el nivel 0, todos los demás niveles se
descargan y la película del nivel 0 se sustituye por el nuevo archivo. La película del nivel 0
establece la velocidad y tamaño de los fotogramas y el color de fondo para todas las demás
películas cargadas.
La acción loadMovieNum también permite cargar archivos JPEG en una película durante su
reproducción. Tanto en las imágenes 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. También en
ambos casos, el archivo cargado hereda las propiedades de rotación y escala, y el contenido
original se sobrescribe.
Utilice la acción unloadMovieNum para eliminar películas o imágenes cargadas con la acción
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); //
Véase también
loadMovie, unloadMovie, unloadMovieNum, _level
loadVariables
Disponibilidad
Flash Player 4.
Sintaxis
loadVariables ("url" ,nivel/"destino" [, variables])
Parámetros
url Un URL absoluto o relativo donde están ubicadas las variables. Si accede a la película a
través de un navegador Web, el host del URL debe estar en el mismo subdominio que la película.
Un número entero que especifica el nivel de Flash Player para recibir las variables. Si
carga variables en un nivel, la acción del panel Acciones en modo Normal cambia a
loadVariablesNum; en modo Experto, debe especificar la acción loadVariablesNum o
seleccionarla de la caja de herramientas Acciones.
nivel
destino La ruta de destino a un clip de película que recibe las variables cargadas. Debe especificar
un clip de película de destino o un nivel de Flash Player; no puede especificar ambos valores.
Un parámetro opcional que especifica un método HTTP para enviar variables. El
parámetro debe ser la cadena GET o POST. Si no hay ninguna variable para enviar, no incluya este
parámetro. El método GET adjunta las variables al final del URL y se utiliza para un número
pequeño de variables. El método POST envía las variables en un encabezado HTTP distinto y se
usa para cadenas largas de variables.
variables
284
Valor devuelto
Ninguno.
Descripción
Acción; 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 película de destino. Esta
acción también puede utilizarse para actualizar variables en la película activa con nuevos valores.
El texto del URL especificado debe tener el formato MIME estándar application/x-www-formurlencoded (formato estándar que se utiliza en los scripts CGI). La película y las variables que se
van a cargar deben residir en el mismo subdominio. Se puede especificar cualquier número de
variables. Por ejemplo, la siguiente frase define varias variables:
empresa=Macromedia&dirección=600+Townsend&ciudad=San+Francisco&zip=94103
La primera película que se va a abrir en una instancia de Flash Player se carga en el nivel inferior
(identificado por el código _level0). Cuando utilice la acción loadMovie o loadMovieNum para
cargar las siguientes películas en Flash Player, debe asignar un número de nivel de Flash Player o
un clip de película de destino en el que se cargará cada película. Cuando utilice la acción
loadVariables, debe especificar el nivel de Flash Player o un clip de película de destino en el que
se cargarán las variables.
Ejemplo
Este ejemplo carga información de un archivo de texto en los campos de texto del clip de película
varTarget de la línea 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");
}
Véase también
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 convertirán para utilizar la
sintaxis correcta.
Sintaxis
loadVariables ("url" ,nivel [, variables])
Parámetros
url Un URL absoluto o relativo donde están ubicadas las variables. Si accede a la película a
través de un navegador Web, el host del URL debe estar en el mismo subdominio que la película.
nivel
Un número entero que especifica el nivel de Flash Player para recibir las variables.
Un parámetro opcional que especifica un método HTTP para enviar variables. El
parámetro debe ser la cadena GET o POST. Si no hay ninguna variable para enviar, no incluya este
parámetro. El método GET adjunta las variables al final del URL y se utiliza para un número
pequeño de variables. El método POST envía las variables en un encabezado HTTP distinto y se
usa para cadenas largas de variables.
variables
Diccionario de ActionScript 285
Valor devuelto
Ninguno.
Descripción
Acción; 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 acción también puede utilizarse para
actualizar variables en la película activa con nuevos valores. Si carga variables en un nivel, la acción
del panel Acciones en modo Normal cambia a loadVariablesNum; en modo Experto, debe
especificar la acción loadVariablesNum o seleccionarla de la caja de herramientas Acciones.
El texto del URL especificado debe tener el formato MIME estándar application/x-www-formurlencoded (formato estándar que se utiliza en los scripts CGI). La película y las variables que se
van a cargar deben residir en el mismo subdominio. Se puede especificar cualquier número de
variables. Por ejemplo, la siguiente frase define varias variables:
empresa=Macromedia&dirección=600+Townsend&ciudad=San+Francisco&zip=94103
La primera película que se va a abrir en una instancia de Flash Player se carga en el nivel inferior
(identificado por el código _level0). Cuando utilice la acción loadMovie o loadMovieNum para
cargar las siguientes películas en Flash Player, debe asignar un número de nivel de Flash Player o
un clip de película de destino en el que se cargará cada película. Cuando utilice la acción
loadVariablesNum, debe especificar un nivel de Flash Player en el que se cargarán las variables.
Ejemplo
Este ejemplo carga información de un archivo de texto en los campos de texto de la línea de
tiempo principal de la película 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);
}
Véase también
getURL, loadMovie, loadMovieNum, loadVariables, MovieClip.loadMovie,
MovieClip.loadVariables
LoadVars (objeto)
El objeto LoadVars es una alternativa a la acción loadVariables para transferir variables entre
una película Flash y un servidor.
Puede utilizar el objeto LoadVars para obtener información sobre errores, indicaciones de
progreso y datos de flujo mientras se descarga. El objeto LoadVars funciona como el objeto XML;
utiliza los métodos 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 métodos.
El objeto LoadVars se admite en Flash Player 6 y versiones posteriores.
286
Resumen de los métodos del objeto LoadVars
Método
Descripción
LoadVars.load
Descarga variables de un URL especificado.
LoadVars.getBytesTotal
Devuelve el número de bytes cargados de un método load o sendAndLoad.
LoadVars.getBytesTotal
Devuelve el número total de bytes que se descargarán mediante el método load
o sendAndLoad.
LoadVars.send
Publica variables de un objeto LoadVars en un URL.
LoadVars.sendAndLoad
Publica variables de un objeto LoadVars en un URL y descarga la respuesta del
servidor en un objeto de destino.
LoadVars.toString
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
Descripción
LoadVars.contentType Indica el tipo MIME de los datos.
LoadVars.load
Valor booleano que indica si se ha realizado una operación load o
sendAndLoad.
Resumen de eventos del objeto LoadVars
Método
Descripción
LoadVars.onLoad
Se invoca cuando se ha realizado una operación load o sendAndLoad.
Constructor del objeto LoadVars
Disponibilidad
Flash Player 6.
Sintaxis
new LoadVars()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Constructor; crea una instancia del objeto LoadVars. A continuación, puede utilizar los métodos
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
Descripción
Propiedad; el tipo MIME que se envía al servidor al llamar al método LoadVars.send o
LoadVars.sendAndLoad. El valor predeterminado es application/x-www-urlform encoded.
Véase también
LoadVars.send, LoadVars.sendAndLoad
LoadVars.getBytesLoaded
Disponibilidad
Flash Player 6.
Sintaxis
myLoadVars.getBytesLoaded()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve el número de bytes descargados por un método load o sendAndLoad. El
método getBytesLoaded devuelve undefined si no hay ninguna operación load en curso o si
todavía no se ha iniciado la operación load.
LoadVars.getBytesTotal
Disponibilidad
Flash Player 6.
Sintaxis
myLoadVars.getBytesTotal()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve el número total de bytes descargados por una operación load o sendAndLoad.
El método getBytesTotal devuelve undefined si no hay ninguna operación load en curso o si
todavía no se ha iniciado la operación load. El método getBytesTotal también devuelve
undefined si no se puede determinar el número total de bytes; por ejemplo, si la descarga se ha
iniciado pero el servidor no ha transmitido ningún comando content-length de HTTP.
288
LoadVars.load
Disponibilidad
Flash Player 6.
Sintaxis
myLoadVars.load(url)
Parámetros
url
La dirección URL desde la que se descargan las variables.
Valor devuelto
Una cadena.
Descripción
Método; 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 acción asíncrona.
Los datos descargados deben estar en el tipo de contenido MIME application/x-www-urlformencoded. Es el mismo formato que utiliza la acción loadVariables.
Este método es parecido al método XML.load del objeto XML.
LoadVars.loaded
Disponibilidad
Flash Player 6.
Sintaxis
myLoadVars.loaded
Descripción
Propiedad; el valor predeterminado es undefined. Al iniciar una operación load o sendAndLoad,
la propiedad loaded se establece en false. Al finalizar la operación load o sendAndLoad, la
propiedad loaded se establece en true. Si la operación todavía 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)
Parámetros
correcto
Este parámetro indica si la operación de carga se ha realizado correctamente (true) o
no (false).
Diccionario de ActionScript 289
Valor devuelto
Valor booleano.
Descripción
Controlador de eventos; se invoca cuando finaliza una operación load o sendAndLoad. Si la
operación se realizó correctamente, loadVarsObject se rellena con las variables descargadas por
la operación load o sendAndLoad y dichas variables están disponibles cuando se invoca onLoad.
Este método es undefined de forma predeterminada; puede definirlo mediante la asignación de
una función callback.
Este método es parecido al método XML.onLoad del objeto XML.
LoadVars.send
Disponibilidad
Flash Player 6.
Sintaxis
loadVarsObject.send(url [,destino, método])
Parámetros
loadVarsObject
url
El objeto LoadVars desde el que se deben cargar las variables.
El URL desde el que se deben cargar las variables.
destino
método
La ventana del fotograma del navegador en el que se visualizará cualquier respuesta.
El método "GET" o "POST" del protocolo HTTP.
Valor devuelto
Una cadena.
Descripción
Método; envía 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
método HTTP POST. Es el mismo formato que utiliza la acción loadVariables. El tipo de
contenido MIME que se envía 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 método "POST" a menos que se especifique "GET".
Si se especifica el parámetro destino, la respuesta del servidor aparece en la ventana del
fotograma del navegador denominada destino. Si se omite el parámetro destino, se descarta la
respuesta del servidor.
Este método es parecido al método XML.send del objeto XML.
290
LoadVars.sendAndLoad
Disponibilidad
Flash Player 6.
Sintaxis
myLoadVars.sendAndLoad(url, objetoDestino[,método])
Parámetros
loadVarsObject
url
El objeto LoadVars desde el que se deben cargar las variables.
El URL desde el que se deben cargar las variables.
objetoDestino
método
El objeto LoadVars que recibe las variables descargadas.
El método "GET" o "POST" del protocolo HTTP.
Valor devuelto
Una cadena.
Descripción
Método; 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 método es parecido al método XML.sendAndLoad del objeto XML.
LoadVars.toString
Disponibilidad
Flash Player 6.
Sintaxis
loadVarsObject.toString()
Parámetros
Ninguno.
Valor devuelto
Una cadena.
Descripción
Método; devuelve una cadena que contiene todas las variables enumerables del objeto LoadVars
en la codificación 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; específico para cadenas)
Disponibilidad
Flash Player 4. Este operador se ha desestimado en Flash 5; se recomienda utilizar el nuevo
operador < (menor que).
Sintaxis
expresión1 lt expresión2
Parámetros
expresión1, expresión2
Números, cadenas o variables.
Descripción
Operador (de comparación); compara la expresión1 con la expresión2 y devuelve true si la
expresión1 es menor que la expresión2; en caso contrario, devuelve false.
Véase también
< (menor que)
292
Math (objeto)
El objeto Math es un objeto de nivel superior al que puede acceder sin utilizar un constructor.
Utilice los métodos y propiedades de este objeto para acceder y manipular constantes y funciones
matemáticas. Todas las propiedades y métodos del objeto Math son estáticos y deben llamarse
utilizando la sintaxis Math.method(parámetro) o Math.constant. En ActionScript, las constantes
se definen con la máxima precisión de números con coma flotante IEEE-754 de doble precisión.
Algunos de los métodos del objeto Math utilizan radianes de un ángulo como parámetro. Puede
utilizar la ecuación siguiente para calcular valores en radianes, o sencillamente pasar la ecuación
(introduciendo un valor para grados) para el parámetro en radianes.
Para calcular un valor en radianes, utilice esta fórmula:
radián = Math.PI/180 * grado
A continuación, se muestra un ejemplo para pasar una ecuación como parámetro 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
métodos del objeto Math, pero se emulan con el uso de aproximaciones y es posible que no sean
tan precisos como las funciones matemáticas no emuladas que admite Flash Player 5.
Resumen de los métodos del objeto Math
Método
Descripción
Math.abs
Calcula un valor absoluto.
Math.acos
Calcula un arco coseno.
Math.asin
Calcula un arco seno.
Math.atan
Calcula un arco tangente.
Math.atan2
Calcula un ángulo desde el eje x hasta el punto.
Math.ceil
Redondea un número al entero más cercano hacia arriba.
Math.cos
Calcula un coseno.
Math.exp
Calcula un valor exponencial.
Math.floor
Redondea un número al entero más cercano hacia abajo.
Math.log
Calcula un logaritmo natural.
Math.max
Devuelve el mayor de dos números enteros.
Math.min
Devuelve el menor de dos números enteros.
Math.pow
Calcula x elevado a la potencia de y.
Math.random
Devuelve un número seudoaleatorio ente 0,0 y 1,1.
Math.round
Redondea al número entero más cercano.
Math.sin
Calcula un seno.
Math.sqrt
Calcula una raíz cuadrada.
Math.tan
Calcula una tangente.
Diccionario de ActionScript 293
Resumen de las propiedades del objeto Math
Todas las propiedades del objeto Math son constantes.
Propiedad
Descripción
Math.E
La constante de Euler y la base de los logaritmos naturales (aproximadamente 2,718).
Math.LN2
El logaritmo natural de 2 (aproximadamente 0,693).
Math.LOG2E
El logaritmo en base 2 de e (aproximadamente 1,442).
Math.LN10
El logaritmo natural de 10 (aproximadamente 2,302).
Math.LOG10E
El logaritmo en base 10 de e (aproximadamente 0,434).
Math.PI
La relación entre la circunferencia de un círculo y su diámetro (aproximadamente 3,14159).
Math.SQRT1_2
El recíproco de la raíz cuadrada de 1/2 (aproximadamente 0,707).
Math.SQRT2
La raíz cuadrada de 2 (aproximadamente 1,414).
Math.abs
Disponibilidad
Flash Player 5. En Flash Player 4, se emulan los métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.abs(x)
Parámetros
x
Un número.
Valor devuelto
Un número.
Descripción
Método; calcula y devuelve el valor absoluto del número especificado por el parámetro x.
Math.acos
Disponibilidad
Flash Player 5. En Flash Player 4, se emulan los métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.acos(x)
Parámetros
x
Un número de -1,0 a 1,0.
Valor devuelto
Ninguno.
Descripción
Método; calcula y devuelve el arco coseno del número especificado en el parámetro x, en radianes.
294
Math.asin
Disponibilidad
Flash Player 5. En Flash Player 4, se emulan los métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.asin(x);
Parámetros
x
Un número de -1,0 a 1,0.
Valor devuelto
Un número.
Descripción
Método; calcula y devuelve el arco seno del número especificado en el parámetro x, en radianes.
Math.atan
Disponibilidad
Flash Player 5. En Flash Player 4, se emulan los métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.atan(x)
Parámetros
x
Un número.
Valor devuelto
Un número.
Descripción
Método; calcula y devuelve el arco tangente del número especificado en el parámetro 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 métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.atan2(y, x)
Parámetros
x
Un número que especifica la coordenada x del punto.
y
Un número que especifica la coordenada y del punto.
Diccionario de ActionScript 295
Valor devuelto
Un número.
Descripción
Método; calcula y devuelve el arco tangente de y/x en radianes. El valor devuelto representa el
ángulo contrario al ángulo opuesto de un triángulo rectángulo, 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 métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.ceil(x)
Parámetros
x
Un número o expresión.
Valor devuelto
Un número.
Descripción
Método; devuelve el límite del número o expresión especificados. El límite de un número es el
número entero más cercano que es mayor o igual que el número.
Math.cos
Sintaxis
Math.cos(x)
Parámetros
x
Un ángulo medido en radianes.
Valor devuelto
Un número.
Descripción
Método; devuelve el coseno (un valor de -1,0 a 1,0) del ángulo especificado por el parámetro x. El
ángulo x debe especificarse en radianes. Utilice la información que se explicó en la introducción
del objeto Math para calcular un radián.
296
Math.E
Disponibilidad
Flash Player 5. En Flash Player 4, se emulan los métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.E
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Constante; una constante matemática 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 métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Math.exp
Disponibilidad
Flash Player 5. En Flash Player 4, se emulan los métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.exp(x)
Parámetros
x
El exponente; un número o expresión.
Valor devuelto
Un número.
Descripción
Método; devuelve el valor de la base del logaritmo natural (e) elevado a la potencia del exponente
especificado en el parámetro 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 métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.floor(x)
Parámetros
x
Un número o expresión.
Valor devuelto
Un número.
Descripción
Método; devuelve el límite inferior del número o expresión especificada en el parámetro x. Este
valor es el número entero más cercano que es menor o igual que el número o expresión
especificada.
Ejemplo
El código siguiente devuelve el valor 12.
Math.floor(12.5);
Math.log
Disponibilidad
Flash Player 5. En Flash Player 4, se emulan los métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.log(x)
Parámetros
x
Un número o expresión con un valor mayor que 0.
Valor devuelto
Un número.
Descripción
Método; devuelve el logaritmo natural del parámetro x.
298
Math.LOG2E
Disponibilidad
Flash Player 5. En Flash Player 4, se emulan los métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.LOG2E
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Constante; una constante matemática 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 métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.LOG10E
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Constante; una constante matemática 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 métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.LN2
Parámetros
Ninguno.
Diccionario de ActionScript 299
Valor devuelto
Ninguno.
Descripción
Constante; una constante matemática 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 métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.LN10
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Constante; una constante matemática 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 métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.max(x , y)
Parámetros
x
Un número o expresión.
y
Un número o expresión.
Valor devuelto
Un número.
Descripción
Método; 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 métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.min(x , y)
Parámetros
x
Un número o expresión.
y
Un número o expresión.
Valor devuelto
Ninguno.
Descripción
Método; 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 métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.PI
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Constante; una constante matemática que expresa la relación entre la circunferencia de un círculo
y su diámetro, expresada como pi, con el valor 3,14159265358979.
Math.pow
Disponibilidad
Flash Player 5. En Flash Player 4, se emulan los métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.pow(x , y)
Parámetros
x
Un número que se va a elevar a una potencia.
Diccionario de ActionScript 301
y
Un número que especifica una potencia a la que se eleva el parámetro x.
Valor devuelto
Un número.
Descripción
Método; calcula y devuelve x elevado a la potencia y, xy.
Math.random
Disponibilidad
Flash Player 5. En Flash Player 4, se emulan los métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.random()
Parámetros
Ninguno.
Valor devuelto
Un número.
Descripción
Método; devuelve n, donde 0 <= n < 1.
Véase también
random
Math.round
Disponibilidad
Flash Player 5. En Flash Player 4, se emulan los métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.round(x)
Parámetros
x
Un número.
Valor devuelto
Un número.
Descripción
Método; redondea el valor del parámetro x por exceso o por defecto al número entero más
cercano y devuelve el valor.
302
Math.sin
Disponibilidad
Flash Player 5. En Flash Player 4, se emulan los métodos y las propiedades del objeto Math por
medio de aproximaciones, y puede que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.sin(x)
Parámetros
x
Un ángulo medido en radianes.
Valor devuelto
Ninguno.
Descripción
Método; calcula y devuelve el seno del ángulo especificado en radianes. Utilice la información que
se explicó en la introducción del objeto Math para calcular un radián.
Math.sqrt
Disponibilidad
Flash Player 5. En Flash Player 4, se emulan los métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.sqrt(x)
Parámetros
x
Un número o expresión mayor o igual que 0.
Valor devuelto
Un número.
Descripción
Método; calcula y devuelve la raíz cuadrada del número especificado.
Math.SQRT1_2
Disponibilidad
Flash Player 5. En Flash Player 4, se emulan los métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.SQRT1_2
Parámetros
Ninguno.
Diccionario de ActionScript 303
Valor devuelto
Ninguno.
Descripción
Constante; una constante matemática para el recíproco de la raíz 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 métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.SQRT2
Parámetros
Ninguno.
Descripción
Constante; una constante matemática para la raíz cuadrada de 2, con un valor aproximado de
1,414213562373.
Math.tan
Disponibilidad
Flash Player 5. En Flash Player 4, se emulan los métodos y propiedades del objeto Math usando
aproximaciones y es posible que no sean tan precisos como las funciones matemáticas no
emuladas que incluye Flash Player 5.
Sintaxis
Math.tan(x)
Parámetros
x
Un ángulo medido en radianes.
Valor devuelto
Un número.
Descripción
Método; calcula y devuelve la tangente del ángulo especificado. Para calcular los radianes, utilice
la información que se explicó en la introducción del objeto Math (objeto).
304
maxscroll
Disponibilidad
Flash Player 4.
Sintaxis
nombre_variable.maxscroll
Descripción
Propiedad (sólo lectura); propiedad desestimada que indica el número de la línea de texto superior
visible en un campo de texto cuando la línea inferior del campo también está visible. La propiedad
maxscroll funciona con la propiedad scroll para controlar la forma de mostrar información en
un campo de texto. Este propiedad puede recuperarse, pero no modificarse.
Véase también
TextField.maxscroll, TextField.scroll
mbchr
Disponibilidad
Flash Player 4. Esta función se ha desestimado; se recomienda utilizar el método
String.fromCharCode.
Sintaxis
mbchr(número)
Parámetros
número
El número que se convierte en carácter multibyte.
Valor devuelto
Una cadena.
Descripción
Función de cadena; convierte un número de código ASCII en un carácter multibyte.
Véase también
String.fromCharCode
mblength
Disponibilidad
Flash Player 4. Esta función se ha desestimado; se recomienda utilizar String (objeto).
Sintaxis
mblength(cadena)
Parámetros
cadena
Una cadena.
Valor devuelto
Un número.
Descripción
Función de cadena; devuelve la longitud de la cadena de caracteres multibyte.
Diccionario de ActionScript 305
mbord
Disponibilidad
Flash Player 4. Esta función se ha desestimado en Flash 5; se recomienda utilizar el método
String.charCodeAt.
Sintaxis
mbord(carácter)
Parámetros
El carácter que se convierte en un número multibyte.
carácter
Valor devuelto
Un número.
Descripción
Función de cadena; convierte el carácter especificado en un número multibyte.
Véase también
String.fromCharCode
mbsubstring
Disponibilidad
Flash Player 4. Esta función se ha desestimado en Flash 5; se recomienda utilizar el método
String.substr.
Sintaxis
mbsubstring(valor, índice, conteo)
Parámetros
valor
La cadena multibyte de la que se debe extraer una nueva cadena multibyte.
índice
Número del primer carácter que se va a extraer.
conteo
Número de caracteres que se van a incluir en la cadena extraída, sin incluir el carácter de
índice.
Valor devuelto
Una cadena.
Descripción
Función de cadena; extrae una nueva cadena de caracteres multibyte de una cadena de caracteres
multibyte.
Véase también
String.substr
306
method
Disponibilidad
Flash Player 6.
Sintaxis
objeto.método = function ([parámetros]) {
...cuerpo de la función...
};
Parámetros
objeto
Un identificador de un objeto.
método
Un identificador de un método.
parámetros
Parámetros para pasar a la función. Parámetro opcional.
Valor devuelto
Ninguno.
Descripción
Acción (sólo modo Normal); permite definir métodos para objetos a través del panel Acciones en
modo Normal. Para obtener más información sobre cómo definir métodos para objetos, consulte
la publicación Utilización de Flash.
Mouse (objeto)
El objeto Mouse es un objeto de nivel superior al que puede acceder sin utilizar un constructor.
Puede utilizar los métodos del objeto Mouse para ocultar y mostrar el cursor en la película. El
puntero del ratón está visible de forma predeterminada, pero puede ocultarlo e implementar un
puntero personalizado creado con un clip de película.
Resumen de los métodos de Mouse
Método
Descripción
Mouse.addListener
Registra un objeto para que reciba las notificaciones onMouseDown,
onMouseMove y onMouseUp.
Mouse.hide
Oculta el puntero del ratón en la película.
Mouse.removeListener
Elimina un objeto registrado con el método addListener.
Mouse.show
Muestra el puntero del ratón en la película.
Resumen de los detectores del objeto Mouse
Método
Descripción
MovieClip.onMouseDown
Recibe notificación cuando se presiona el botón del ratón.
MovieClip.onMouseMove
Recibe notificación cuando se mueve el botón del ratón.
MovieClip.onMouseUp
Recibe notificación cuando se suelta el botón del ratón.
Diccionario de ActionScript 307
Mouse.addListener
Disponibilidad
Flash Player 6.
Sintaxis
Mouse.addListener (nuevoDetector)
Parámetros
nuevoDetector
Un objeto.
Valor devuelto
Ninguno.
Descripción
Método; registra un objeto para que reciba notificaciones de los controladores callback
onMouseDown, onMouseMove y onMouseUp.
El parámetro nuevoDetector debe contener
onMouseDown, onMouseMove y onMouseUp.
un objeto con métodos definidos para los eventos
Al presionar, mover o soltar el ratón, independientemente de la selección de entrada, se invoca el
método onMouseDown, onMouseMove o onMouseUp de todos los objetos de detección registrados
con el método addListener. Varios objetos pueden detectar notificaciones de teclado. Si el
detector nuevoDetector ya está registrado, no se produce ningún cambio.
Mouse.hide
Disponibilidad
Flash Player 5.
Sintaxis
Mouse.hide()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; oculta el cursor en una película. El cursor es visible de modo predeterminado.
Ejemplo
El código siguiente, asociado a un clip de película en la línea de tiempo principal, oculta el cursor
estándar y establece las posiciones de x e y de la instancia del clip de película customCursor en las
posiciones de ratón x e y en la línea de tiempo principal.
onClipEvent(enterFrame){
Mouse.hide();
customCursorMC._x = _root._xmouse;
customCursorMC._y = _root._ymouse;
}
308
Véase también
Mouse.show, MovieClip._xmouse, MovieClip._ymouse
Mouse.onMouseDown
Disponibilidad
Flash Player 6.
Sintaxis
someListener.onMouseDown
Descripción
Detector; recibe notificación cuando se presiona el ratón. Para utilizar el detector onMouseDown,
debe crear un objeto detector. A continuación, puede definir una función para onMouseDown y
utilizar el método 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 código cooperen, ya que varios detectores
pueden recibir notificaciones sobre un mismo evento.
Véase también
Mouse.addListener
Mouse.onMouseMove
Disponibilidad
Flash Player 6.
Sintaxis
someListener.onMouseMove
Descripción
Detector; recibe notificación cuando se mueve el ratón. Para utilizar el detector onMouseMove,
debe crear un objeto detector. A continuación, puede definir una función para onMouseMove y
utilizar el método 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 código cooperen, ya que varios detectores
pueden recibir notificaciones sobre un mismo evento.
Véase también
Mouse.addListener
Diccionario de ActionScript 309
Mouse.onMouseUp
Disponibilidad
Flash Player 6.
Sintaxis
someListener.onMouseUp
Descripción
Detector; recibe notificación cuando se suelta el ratón. Para utilizar el detector onMouseUp, debe
crear un objeto detector. A continuación, puede definir una función para onMouseUp y utilizar el
método 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 código cooperen, ya que varios detectores
pueden recibir notificaciones sobre un mismo evento.
Véase también
Mouse.addListener
Mouse.removeListener
Disponibilidad
Flash Player 6.
Sintaxis
Mouse.removeListener (detector)
Parámetros
detector
Un objeto.
Valor devuelto
Si el objeto detector se ha eliminado correctamente, el método 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 método devuelve el valor false.
Descripción
Método; elimina un objeto registrado previamente con el método addListener.
Mouse.show
Disponibilidad
Flash Player 5.
Sintaxis
Mouse.show()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
310
Descripción
Método; muestra el cursor en una película. El cursor es visible de modo predeterminado.
Véase también
Mouse.show, MovieClip._xmouse, MovieClip._ymouse
MovieClip (objeto)
Los métodos del objeto MovieClip proporcionan la misma funcionalidad que las acciones que
seleccionan clips de película como destino. También existen métodos adicionales que no tienen
acciones equivalentes en la caja de herramientas Acciones del panel Acciones.
No es necesario utilizar un método constructor para poder llamar a los métodos del objeto
MovieClip; en lugar de eso, haga referencia a las instancias de clip de película por nombre,
mediante la sintaxis siguiente:
myMovieClip.play();
myMovieClip.gotoAndPlay(3);
Diccionario de ActionScript
311
Resumen de los métodos del objeto MovieClip
312
Método
Descripción
MovieClip.attachMovie
Asocia una película de la biblioteca.
MovieClip.createEmptyMovieClip
Crea un clip de película vacío.
MovieClip.createTextField
Crea un campo de texto vacío.
MovieClip.duplicateMovieClip
Duplica el clip de película especificado.
MovieClip.getBounds
Devuelve el máximo y el mínimo de las coordenadas x e y de una película
en un espacio de coordenadas especificado.
MovieClip.getBytesLoaded
Devuelve el número de bytes cargados para el clip de película
especificado.
MovieClip.getBytesTotal
Devuelve el tamaño del clip de película en bytes.
MovieClip.getDepth
Devuelve la profundidad de un clip de película.
MovieClip.getURL
Recupera un documento de un URL.
MovieClip.globalToLocal
Convierte el objeto punto de las coordenadas del escenario a las
coordenadas locales del clip de película especificado.
MovieClip.gotoAndPlay
Envía la cabeza lectora a un fotograma específico en el clip de película y
reproduce la película.
MovieClip.gotoAndStop
Envía la cabeza lectora a un fotograma específico en el clip de película y
detiene la película.
MovieClip.hitTest
Devuelve true si el recuadro de delimitación del clip de película
especificado se cruza con el recuadro de delimitación del clip de película
de destino.
MovieClip.loadMovie
Carga la película especificada en el clip de película.
MovieClip.loadVariables
Carga variables de un URL u otra ubicación en el clip de película.
MovieClip.localToGlobal
Convierte un objeto Point de las coordenadas locales del clip de película
a las coordenadas del escenario global.
MovieClip.nextFrame
Envía la cabeza lectora al fotograma siguiente del clip de película.
MovieClip.play
Reproduce el clip de película especificado.
MovieClip.prevFrame
Envía la cabeza lectora al fotograma anterior del clip de película.
MovieClip.removeMovieClip
Elimina el clip de película de la línea de tiempo, si se ha creado con una
acción o método duplicateMovieClip o con el método attachMovie.
MovieClip.setMask
Especifica un clip de película como una máscara para otro clip de
película.
MovieClip.startDrag
Especifica un clip de película como arrastrable y comienza a arrastrar el
clip de película.
MovieClip.stop
Detiene la película que se está reproduciendo actualmente.
MovieClip.stopDrag
Detiene el arrastrado de cualquier película que se esté arrastrando.
MovieClip.swapDepths
Intercambia el nivel de profundidad de dos películas.
MovieClip.unloadMovie
Elimina una película que se ha cargado con la acción loadMovie.
Resumen de los métodos de dibujo del objeto MovieClip
Método
Descripción
MovieClip.beginFill
Empieza a dibujar un relleno en el escenario.
MovieClip.beginGradientFill
Empieza a dibujar un relleno en degradado en el escenario.
MovieClip.clear
Elimina todos los comandos de dibujo asociados con una instancia de
clip de película.
MovieClip.curveTo
Dibuja una curva con el último estilo de línea.
MovieClip.endFill
Finaliza el relleno especificado mediante beginFill o
beginGradientFill.
MovieClip.lineStyle
Define el trazo de las líneas creadas con los métodos lineTo y
curveTo.
MovieClip.lineTo
Dibuja una línea con el estilo de línea actual.
MovieClip.moveTo
Mueve la posición actual del dibujo a las coordenadas especificadas.
Resumen de las propiedades del objeto MovieClip
Propiedad
Descripción
MovieClip._alpha
Valor de transparencia de una instancia de clip de película.
MovieClip._currentframe
Número de fotograma en el que se encuentra la cabeza lectora.
MovieClip._droptarget
Ruta absoluta en notación de sintaxis con barras de la instancia de clip
de película en el que se soltó un clip de película que se puede arrastrar.
MovieClip.enabled
Indica si el clip de película de botón está activado.
MovieClip.focusEnabled
Permite que un clip de película puede seleccionarse.
MovieClip._focusrect
Indica si un clip de película seleccionado tiene un rectángulo amarillo a
su alrededor.
MovieClip._framesloaded
Número de fotogramas que se han cargado de una película.
MovieClip._height
Altura de una instancia de clip de película en píxeles.
MovieClip.hitArea
Designa otro clip de película que sirve como el área activa para un clip de
película de botón.
MovieClip._highquality
Establece la calidad de representación de una película.
MovieClip._name
Nombre de instancia de una instancia de clip de película.
MovieClip._parent
Referencia al clip de película que incluye el clip de película.
MovieClip._rotation
Grado de rotación de una instancia de clip de película.
MovieClip._soundbuftime
Número de segundos antes de que empiece el sonido.
MovieClip.tabChildren
Indica si los elementos secundarios de un clip de película se incluyen en
el orden de tabulación automático.
MovieClip.tabEnabled
Indica si un clip de película se incluye en el orden de tabulación.
MovieClip.tabIndex
Indica el orden de tabulación de un objeto.
MovieClip._target
Ruta de destino de una instancia de clip de película.
MovieClip._totalframes
Número total de fotogramas en una instancia de clip de película.
MovieClip.trackAsMenu
Indica si otros botones pueden recibir eventos al soltar el ratón.
Diccionario de ActionScript 313
Propiedad
Descripción
MovieClip._url
El URL del archivo SWF del que se ha descargado un clip de película.
MovieClip.useHandCursor
Determina si la mano aparece cuando un usuario se sitúa sobre un clip
de película de botón.
MovieClip._visible
Valor booleano que determina si una instancia de clip de película está
oculta o visible.
MovieClip._width
Anchura de una instancia de clip de película en píxeles.
MovieClip._x
Coordenada x de una instancia de clip de película.
MovieClip._xmouse
Coordenada x del cursor dentro de una instancia de clip de película.
MovieClip._xscale
Valor que especifica el porcentaje de una escala horizontal de un clip de
película.
MovieClip._y
Coordenada y de una instancia de clip de película.
MovieClip._ymouse
Coordenada y del cursor dentro de una instancia de clip de película.
MovieClip._yscale
Valor que especifica el porcentaje de escala vertical de un clip de película.
Resumen del controlador de eventos del objeto MovieClip
314
Propiedad
Descripción
MovieClip.onData
Se invoca cuando todos los datos se han cargado en un clip de película.
MovieClip.onDragOut
Se invoca mientras el puntero se encuentra fuera del botón; el botón del
ratón se presiona dentro y, a continuación, se desplaza fuera del área del
botón.
MovieClip.onDragOver
Se invoca mientras el puntero se encuentra sobre el botón; se ha
presionado el botón del ratón, se ha desplazado fuera del botón y, a
continuación, se ha vuelto a desplazar sobre el botón.
MovieClip.onEnterFrame
Se invoca de forma continua a la velocidad de los fotogramas de la
película. Las acciones asociadas con el evento de clip enterFrame se
procesan antes que cualquiera de las acciones de fotogramas asociadas
a los fotogramas afectados.
MovieClip.onKeyDown
Se invoca cuando se presiona una tecla. Utilice los métodos
Key.getCode y Key.getAscii para recuperar información sobre la
última tecla presionada.
MovieClip.onKeyUp
Se invoca cuando se suelta una tecla.
MovieClip.onKillFocus
Se invoca cuando se pierde la selección de un botón.
MovieClip.onLoad
Se invoca cuando se crea una instancia del clip de película y aparece en
la línea de tiempo.
MovieClip.onMouseDown
Se invoca cuando se presiona el botón izquierdo del ratón.
MovieClip.onMouseMove
Se invoca cada vez que se mueve el ratón.
MovieClip.onMouseUp
Se invoca cuando se suelta el botón izquierdo del ratón.
MovieClip.onPress
Se invoca cuando se presiona el ratón mientras el puntero está sobre un
botón.
MovieClip.onRelease
Se invoca cuando se suelta el ratón mientras el puntero está sobre un
botón.
MovieClip.onReleaseOutside
Se invoca cuando se suelta el ratón mientras el puntero está fuera del
botón después de presionar el botón mientras el puntero está dentro del
botón.
Propiedad
Descripción
MovieClip.onRollOut
Se invoca cuando el puntero se desplaza fuera del área de un botón.
MovieClip.onRollOver
Se invoca cuando el puntero del ratón se desplaza sobre un botón.
MovieClip.onSetFocus
Se invoca cuando un botón tiene la selección de entrada y se suelta una
tecla.
MovieClip.onUnload
Se invoca en el primer fotograma después de eliminar el clip de película
de la línea de tiempo. Las acciones asociadas con el evento de clip de
película Unload se procesan antes de que se asocien acciones al
fotograma afectado.
MovieClip._alpha
Disponibilidad
Flash Player 4.
Sintaxis
myMovieClip._alpha
Descripción
Propiedad; define o recupera la transparencia alfa (valor) del clip de película especificado por
MovieClip. Los valores válidos van de 0 (completamente transparente) a 100 (completamente
opaco). Los objetos de un clip de película con _alpha establecido en 0 están activos, aunque sean
invisibles. Por ejemplo, incluso puede hacer clic en un botón de un clip de película con la
propiedad _alpha establecida en 0.
Ejemplo
Las sentencias siguientes establecen la propiedad _alpha de un clip de película llamado star en
un 30% al hacer clic en el botón:
on(release) {
star._alpha = 30;
}
MovieClip.attachMovie
Disponibilidad
Flash Player 5.
Sintaxis
myMovieClip.attachMovie( idNombre, nuevoNombre, profundidad [, objetoInicial]
)
Parámetros
El nombre de vínculo de un símbolo de clip de película de la biblioteca para asociarlo
a un clip de película del escenario. Este es el nombre introducido en el campo Identificador en el
cuadro de diálogo Propiedades de vínculos de símbolos.
idNombre
nuevoNombre
Un nombre de instancia exclusivo para el clip de película que se asocia al clip de
película.
profundidad
Un número entero que especifica el nivel de profundidad en el que se encuentra
la película.
Diccionario de ActionScript 315
objetoInicial Un objeto que contiene las propiedades con las que se debe rellenar el clip de
película recién asociado. Este parámetro permite que los clips de película creados de forma
dinámica puedan recibir parámetros de clip. Si el parámetro 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 están disponibles para la función constructor. Este
parámetro es opcional.
Valor devuelto
Ninguno.
Descripción
Método; selecciona un símbolo de la biblioteca y lo asocia a la película del escenario especificado
por MovieClip. Utilice la acción o el método removeMovieClip o unloadMovie para eliminar
una película asociada con attachMovie.
Ejemplo
En el ejemplo siguiente se asocia el símbolo con el identificador de vínculo “circle” a la instancia
de clip de película, que se encuentra en el escenario de la película.
on (release) {
thing.attachMovie( "circle", "circle1", 2 );
}
Véase también
MovieClip.removeMovieClip, MovieClip.unloadMovie, Object.registerClass,
removeMovieClip
MovieClip.beginFill
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.beginFill ([rgb[, alfa]])
Parámetro
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.
Un número entero entre 0 y 100 que especifica el valor alfa del relleno. Si no se
proporciona este valor, se utiliza el valor 100 (sólido). Si el valor es inferior a 0, Flash utiliza el
valor 0. Si el valor es superior a 100, Flash utiliza el valor 100.
alfa
Valor devuelto
Ninguno.
Descripción
Método; indica el comienzo de un nuevo trazado de dibujo. Si hay un trazado abierto (es decir, si
la posición actual del dibujo no es la misma que la posición anterior especificada en un método
moveTo) y éste tiene un relleno asociado, el trazado se cierra con una línea y, a continuación, se
rellena. Es parecido a lo que sucede cuando se llama al método endFill.
Véase también
MovieClip.beginGradientFill, MovieClip.endFill
316
MovieClip.beginGradientFill
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.beginGradientFill (tipoRelleno, colores, alfas, relaciones,
matriz)
Parámetro
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.).
Una matriz de valores alfa para los colores correspondientes en la matriz colores. Los
valores válidos 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.
alfas
relaciones Una matriz de relaciones de distribución de colores. Los valores válidos 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 transformación 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 método beginGradientFill con un parámetro 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 demás parámetros son necesarios; la función
falla si falta alguno de estos parámetros. 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 posición
horizontal relativa al punto de registro del clip principal para la esquina superior izquierda del
degradado, y es la posición 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 rotación en radianes del degradado.
En el ejemplo siguiente se utiliza el método beginGradientFill con un parámetro 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 demás parámetros son
obligatorios. La función falla si no se cumple alguna de estas condiciones.
Valor devuelto
Ninguno.
Descripción
Método; indica el comienzo de un nuevo trazado de dibujo. Si el primer parámetro tiene el valor
undefined, o si no se pasa ningún parámetro, el trazado no tiene relleno. Si hay un trazado
abierto (es decir, si la posición actual del dibujo no es la misma que la posición anterior
especificada en un método moveTo) y éste tiene un relleno asociado, el trazado se cierra con una
línea y, a continuación, se rellena. Es parecido a lo que sucede cuando se llama al método
endFill.
Este método falla si se produce alguna de las condiciones siguientes:
• El número de elementos de los parámetros colors, alphas y ratios no coincide.
• El parámetro tipoRelleno no es “linear” o “radial”.
• Alguno de los campos del objeto para el parámetro matriz no es válido o falta.
Diccionario de ActionScript 319
Ejemplo
El código siguiente utiliza ambos métodos para dibujar dos rectángulos apilados con un relleno en
degradado rojo-azul y un trazo de 5 puntos de color verde sólido.
_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();
}
Véase también
MovieClip.beginFill, MovieClip.endFill, MovieClip.lineStyle, MovieClip.lineTo,
MovieClip.moveTo
320
MovieClip.clear
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.clear()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; elimina todos los comandos de dibujo asociados con un clip de película. No afecta a las
formas y líneas que se dibujan con las herramientas de dibujo de Flash. Si se llama al método
clear, también se elimina el estilo de línea actual.
Véase también
MovieClip.lineStyle
MovieClip.createEmptyMovieClip
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.createEmptyMovieClip (nombreInstancia, profundidad)
Parámetro
nombreInstancia
profundidad
Una cadena que identifica el nombre de instancia del clip de película nuevo.
Un número entero que especifica la profundidad del clip de película nuevo.
Valor devuelto
Ninguno.
Descripción
Método; crea un clip de película vacío como un elemento secundario de un clip de película
existente. Este método se comporta de forma parecida al método attachMovie, pero no es
necesario proporcionar un nombre de vínculo externo para el nuevo clip de película. El punto de
registro para un clip de película vacío recién creado es la esquina superior izquierda. Este método
falla si falta alguno de estos parámetros.
Véase también
MovieClip.attachMovie
Diccionario de ActionScript 321
MovieClip.createTextField
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.createTextField (nombreInstancia, profundidad, x, y, anchura,
altura)
Parámetros
nombreInstancia
profundidad
Una cadena que identifica el nombre de instancia del campo de texto nuevo.
Un número entero positivo que especifica la profundidad del campo de texto nuevo.
x
Un número entero que especifica la coordenada x del campo de texto nuevo.
y
Un número entero que especifica la coordenada y del campo de texto nuevo.
anchura
altura
Un número entero positivo que especifica la anchura del campo de texto nuevo.
Un número entero positivo que especifica la altura del campo de texto nuevo.
Valor devuelto
Ninguno.
Descripción
Método; crea un nuevo campo de texto vacío como elemento secundario del clip de película
especificado por el parámetro MovieClip. Puede utilizar el método createTextField para crear
campos de texto mientras se reproduce una película. El campo de texto se sitúa en (x, y) con las
dimensiones anchura por altura. Los parámetros x e y se refieren al clip de película contenedor;
estos parámetros corresponden a las propiedades _x e _y del campo de texto. Los parámetros
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);
Véase también
TextFormat (objeto)
MovieClip._currentframe
Disponibilidad
Flash Player 4.
Sintaxis
myMovieClip._currentframe
Descripción
Propiedad (sólo lectura); devuelve el número del fotograma en el que se encuentra la cabeza
lectora en la línea de tiempo especificada por MovieClip.
Ejemplo
En el ejemplo siguiente se utiliza la propiedad _currentframe para que la cabeza lectora del clip
de película actionClip avance cinco fotogramas respecto a su ubicación actual.
actionClip.gotoAndStop(_currentframe + 5);
MovieClip.curveTo
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.curveTo (controlX, controlY, anclaX, anclaY)
Parámetros
Un número entero que especifica una posición horizontal relativa al punto de registro
del clip de película principal del punto de control.
controlX
Un número entero que especifica una posición vertical relativa al punto de registro
del clip de película principal del punto de control.
controlY
anclaX Un número entero que especifica una posición horizontal relativa al punto de registro
del clip de película principal del siguiente punto de anclaje.
Diccionario de ActionScript 323
anclaY Un número entero que especifica una posición vertical relativa al punto de registro del
clip de película principal del siguiente punto de anclaje.
Valor devuelto
Ninguno.
Descripción
Métodos; dibuja una curva con el estilo de línea actual desde la posición actual del dibujo hasta
(anclaX, anclaY) y utiliza el punto de control especificado por (controlX, controlY). La
posición actual del dibujo se establece en (anclaX, anclaY). Si el clip de película 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 posición actual del dibujo se establece de forma predeterminada en (0, 0). Si falta
alguno de estos parámetros, el método falla y la posición del dibujo no se cambia.
Ejemplo
En el ejemplo siguiente se dibuja un círculo con una línea de color azul sólido muy fina y un
relleno de color rojo sólido.
_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();
}
Véase también
MovieClip.beginFill, MovieClip.createEmptyMovieClip, MovieClip.endFill,
MovieClip.lineStyle, MovieClip.lineTo, MovieClip.moveTo
MovieClip._droptarget
Disponibilidad
Flash Player 4.
Sintaxis
myMovieClip._droptarget
Descripción
Propiedad (sólo lectura); devuelve la ruta absoluta en notación de sintaxis con barras de la
instancia de clip de película 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 función 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
película garbage y se utiliza eval para convertirlo de sintaxis con barras a referencia de sintaxis
con puntos. A continuación, la referencia garbage se compara con la referencia a la instancia de
clip de película 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 posición 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 película con el script siguiente:
x_pos = garbage._x;
y_pos = garbage._y;
Véase también
startDrag
MovieClip.duplicateMovieClip
Disponibilidad
Flash Player 5.
Sintaxis
myMovieClip.duplicateMovieClip(nuevoNombre, profundidad [,objetoInicial])
Parámetros
nuevoNombre
Un identificador único para el clip de película duplicado.
Un número único que especifica la profundidad a la que debe colocarse la
película especificada.
profundidad
objetoInicial Un objeto que contiene las propiedades con las que se debe rellenar el clip de
película duplicado. Este parámetro permite que los clips de película creados de forma dinámica puedan
recibir parámetros de clip. Si el parámetro 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 están disponibles para la función constructor. Este parámetro es opcional.
Valor devuelto
Ninguno.
Descripción
Método; crea una instancia del clip de película especificado mientras se reproduce la película. Los
clips de película duplicados siempre empiezan a reproducirse en el fotograma 1, sin tener en cuenta
en qué fotograma está el clip de película original cuando se llama al método duplicateMovieClip.
Las variables del clip de película principal no se copian en el clip de película duplicado. Los clips de
película creados con el método duplicateMovieClip no se duplican si se llama a
duplicateMovieMethod en su clip de película principal. Si se elimina el clip de película principal
también se elimina el clip de película duplicado. Los clips de película agregados con
duplicateMovieClip pueden eliminarse con la acción o el método removeMovieClip.
Véase también
duplicateMovieClip, MovieClip.removeMovieClip, removeMovieClip
Diccionario de ActionScript 325
MovieClip.enabled
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.enabled
Descripción
Propiedad; un valor booleano que indica si un clip de película de botón está activado. El valor
predeterminado de enabled es true. Si enabled se establece en false, los métodos y los eventos
de acción on y los métodos de callback del clip de película de botón ya no se invocan y los
fotogramas Sobre, Presionado y Reposo se desactivan. La propiedad enabled no afecta a la línea
de tiempo del clip de película de botón; si se está reproduciendo un clip de película, éste continúa
reproduciéndose. El clip de película sigue recibiendo eventos de clip de película (por ejemplo,
mouseDown, mouseUp, keyDown y keyUp).
La propiedad enabled sólo controla las propiedades de tipo botón de un clip de película de
botón. Puede cambiar la propiedad enabled en cualquier momento; el clip de película de botón
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
tabulación automático.
MovieClip.endFill
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.endFill()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; aplica un relleno a las líneas y curvas agregadas desde la última llamada al método
beginFill o beginGradientFill. Flash utiliza el relleno que se especificó en la llamada anterior
a beginFill o beginGradientFill. Si la posición actual del dibujo no es la misma que la
posición anterior especificada en el método moveTo y se define un relleno, el trazado se cierra con
una línea y se rellena.
326
MovieClip.focusEnabled
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.focusEnabled
Descripción
Propiedad; si el valor es undefined o false, un clip de película no puede recibir una selección de
entrada a menos que sea un clip de película de botón. Si el valor de la propiedad focusEnabled es
true, un clip de película puede recibir una selección de entrada aunque no sea un clip de película
de botón.
MovieClip._focusrect
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip._focusrect
Descripción
Propiedad; un valor booleano que especifica si un clip de película está rodeado por un rectángulo
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
Descripción
Propiedad (sólo lectura); el número de fotogramas que se han cargado de una película. Esta
propiedad es útil para determinar si el contenido de un fotograma específico y todos los
fotogramas anteriores a él se han cargado y están disponibles localmente en el navegador. Esta
propiedad es útil para controlar el proceso de descarga de películas grandes. Por ejemplo, puede
que desee mostrar un mensaje a los usuarios indicando que la película se está cargando hasta que
se acabe de cargar un fotograma especificado de la película.
Ejemplo
En el ejemplo siguiente se utiliza la propiedad _framesloaded para iniciar una película una vez
cargados todos los fotogramas. Si no se han cargado todos los fotogramas, la propiedad _xscale de
la instancia de clip de película 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)
Parámetros
La ruta de destino de la línea de tiempo cuyo sistema de
coordenadas desea utilizar como punto de referencia.
espacioCoordenadaDestino
Valor devuelto
Un objeto con las propiedades xMin, xMax, yMin e yMax.
Descripción
Método; devuelve las propiedades que son los valores máximo y mínimo de las coordenadas x e y
de la instancia especificada por MovieClip para el parámetro espacioCoordenadaDestino.
Nota: utilice los métodos localToGlobal y globalToLocal del objeto MovieClip para convertir las coordenadas
locales del clip de película 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 método 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 película, clip2, junto a clip.
clipBounds = clip.getBounds(_root);
clip2._x = clipBounds.xMax;
Véase también
MovieClip.globalToLocal, MovieClip.localToGlobal
MovieClip.getBytesLoaded
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.getBytesLoaded()
Parámetros
Ninguno.
Valor devuelto
Entero que indica el número de bytes cargados.
Descripción
Método; devuelve el número de bytes cargados (en flujo) para el objeto MovieClip especificado.
Puede comparar el valor del método getBytesLoaded con el valor del método getBytesTotal
para determinar el porcentaje que se ha cargado de un clip de película.
Véase también
MovieClip.getBytesTotal
328
MovieClip.getBytesTotal
Disponibilidad
Flash Player 5.
Sintaxis
myMovieClip.getBytesTotal()
Parámetros
Ninguno.
Valor devuelto
Un número entero que indica el tamaño total, en bytes, del objeto MovieClip especificado.
Descripción
Método; devuelve el tamaño, en bytes, del objeto MovieClip especificado. Para clips de película
que son externos (la película raíz o un clip de película que se está cargando en un destino o en un
nivel), el valor devuelto es el tamaño del archivo SWF.
Véase también
MovieClip.getBytesLoaded
MovieClip.getDepth
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.getDepth
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve la profundidad de una instancia de clip de película.
MovieClip.getURL
Disponibilidad
Flash Player 5.
Sintaxis
myMovieClip.getURL(URL [,ventana, variables])
Parámetros
URL
El URL del que se debe obtener el documento.
Diccionario de ActionScript 329
ventana Un parámetro opcional que especifica el nombre, el fotograma o la expresión que
indica la ventana o el fotograma HTML en el que se carga el documento. También 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 parámetro opcional que especifica un método para enviar variables asociadas
con la película que se va a cargar. Si no hay variables, no incluya este parámetro; en caso contrario,
especifique si deben cargarse con los métodos GET o POST. GET adjunta las variables al final del
URL y se utiliza para un número pequeño de variables. POST envía las variables en un encabezado
HTTP y se usa para cadenas largas de variables.
Valor devuelto
Ninguno.
Descripción
Método; carga un documento del URL especificado en la ventana especificada. El método getURL
también puede utilizarse para pasar variables a otra aplicación definida en el URL mediante un
método GET o POST.
Véase también
getURL
MovieClip.globalToLocal
Disponibilidad
Flash Player 5.
Sintaxis
myMovieClip.globalToLocal(punto)
Parámetros
El nombre o el identificador de un objeto creado con el objeto genérico Object que
especifica las coordenadas x e y como propiedades.
punto
Valor devuelto
Ninguno.
Descripción
Método; convierte el objeto punto de las coordenadas (globales) del escenario a las coordenadas
(locales) del clip de película.
Ejemplo
En el ejemplo siguiente se convierten las coordenadas globales x e y del objeto point a las
coordenadas locales del clip de película.
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();
}
Véase también
MovieClip.getBounds, MovieClip.localToGlobal
330
MovieClip.gotoAndPlay
Disponibilidad
Flash Player 5.
Sintaxis
myMovieClip.gotoAndPlay(fotograma)
Parámetros
fotograma
El número de fotograma al que se envía la cabeza lectora.
Valor devuelto
Ninguno.
Descripción
Método; comienza a reproducir la película en el fotograma especificado.
Véase también
gotoAndPlay
MovieClip.gotoAndStop
Disponibilidad
Flash Player 5.
Sintaxis
myMovieClip.gotoAndStop(fotograma)
Parámetros
fotograma
El número de fotograma al que se envía la cabeza lectora.
Valor devuelto
Ninguno.
Descripción
Método; coloca la cabeza lectora en el fotograma especificado de este clip de película y la detiene
en ese punto.
Véase también
gotoAndStop
Diccionario de ActionScript 331
MovieClip._height
Disponibilidad
Flash Player 4.
Sintaxis
myMovieClip._height
Descripción
Propiedad; establece y recupera la altura del clip de película en píxeles.
Ejemplo
El código de ejemplo siguiente establece la altura y la anchura de un clip de película cuando el
usuario hace clic sobre un botón.
onClipEvent(mouseDown) {
_width=200;
_height=200;
}
MovieClip._highquality
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip._highquality
Descripción
Propiedad (global); especifica el nivel de suavizado aplicado a la película 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 película no contiene
animación. Especifique 0 (baja calidad) para evitar el suavizado. Esta propiedad prevalece sobre la
propiedad global _highquality.
Ejemplo
myMovieClip._highquality = 1;
Véase también
_quality, toggleHighQuality
MovieClip.hitArea
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.hitArea
Valor devuelto
Una referencia a un clip de película.
332
Descripción
Propiedad; designa otro clip de película que sirve como el área activa para un clip de película de
botón. Si la propiedad hitArea no existe o tiene el valor null o undefined, se utilizará el propio
clip de película de botón como área activa. El valor de la propiedad hitArea puede ser una
referencia a un objeto de clip de película.
Puede cambiar la propiedad hitArea en cualquier momento; el clip de película de botón
modificado asume de inmediato el comportamiento de la nueva área activa. No es necesario que el
clip de película designado como área activa sea visible; se comprueba la presencia de clics en su forma
gráfica, 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)
Parámetros
x
La coordenada x del área activa del escenario.
y
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 parámetro destino normalmente representa un botón o un
campo de introducción 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 delimitación (false). Este parámetro sólo
puede especificarse si el área activa se ha identificado con los parámetros de coordenadas x e y.
Valor devuelto
Ninguno.
Descripción
Método; obtiene la instancia especificada por MovieClip para ver si se solapa o cruza con el área
activa identificada por el parámetro destino o los parámetros de coordenadas x e y.
Sintaxis 1: compara las coordenadas x e y con la forma o el recuadro de delimitación de la
instancia especificada, según el valor de indicadorForma. Si indicadorForma está establecido en
true, sólo se tiene en cuenta el área que ocupa actualmente la instancia en el escenario; si x e y se
solapan en algún punto, se devuelve el valor true. Esto es muy útil para determinar si el clip de
película se encuentra dentro del área activa especificada.
Sintaxis 2: obtiene los recuadros de delimitación de destino y de la instancia especificada y
devuelve el valor true si se solapan o se cruzan en algún punto.
Ejemplo
En el ejemplo siguiente se utiliza hitTest con las propiedades x_mouse e y_mouse para
determinar si el ratón se encuentra sobre el recuadro de delimitación 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 película ball se solapa o
se cruza con el clip de película square:
if(_root.ball, hittest(_root.square)){
trace("ball se cruza con square");
}
Véase también
MovieClip.getBounds, MovieClip.globalToLocal, MovieClip.localToGlobal
MovieClip.lineStyle
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.lineStyle ([grosor[, rgb[, alfa]]])
Parámetros
grosor Un número entero que indica el grosor de la línea en puntos. Los valores válidos van de
0 a 255. Si no hay ningún número especificado, o si el parámetro tiene el valor undefined, no se
dibujará la línea. Si se especifica un valor inferior a 0, Flash utiliza 0. El valor 0 indica el grosor
mínimo; el grosor máximo es 255. Si se especifica un valor superior a 255, el intérprete de Flash
utiliza 255.
rgb Un valor de color hexadecimal de la línea (por ejemplo, rojo es 0xFF0000, azul es
0x0000FF, etc.). Si no se indica ningún valor, Flash utiliza el valor 0x000000 (negro).
alfa Un número entero que indica el valor alfa del color de la línea. Los valores válidos van de
0 a 100. Si no se indica ningún valor, Flash utiliza 100 (sólido). Si el valor es inferior a 0, Flash
utiliza 0; si el valor es superior a 100, Flash utiliza 100.
Valor devuelto
Ninguno.
Descripción
Método; especifica un estilo de línea que Flash utiliza para las siguientes llamadas a los métodos
lineTo y curveTo hasta que se llame a lineStyle con parámetros distintos. Puede llamar al
método lineStyle mientras dibuja un trazado para especificar diferentes estilos para distintos
segmentos de línea de un trazado.
Nota: las llamadas a clear restablecen el método lineStyle en undefined.
Ejemplo
El código siguiente dibuja un triángulo con una línea de color magenta sólido 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 );
}
Véase también
MovieClip.beginFill, MovieClip.beginGradientFill, MovieClip.clear,
MovieClip.curveTo, MovieClip.lineTo, MovieClip.moveTo,
334
MovieClip.lineTo
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.lineTo (x, y)
Parámetros
Un número entero que indica la posición horizontal relativa al punto de registro del clip de
película principal.
x
Un número entero que indica la posición vertical relativa al punto de registro del clip de
película principal.
y
Valor devuelto
Ninguno.
Descripción
Método; dibuja una línea con el estilo de línea actual desde la posición del dibujo hasta (x, y); la
posición del dibujo se establece en (x, y). Si el clip de película 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 método lineTo antes de llamar al método moveTo, la posición
del dibujo se establece de forma predeterminada en (0, 0). Si falta alguno de estos parámetros, el
método falla y la posición del dibujo no se cambia.
Ejemplo
En el ejemplo siguiente se dibuja un triángulo sin líneas 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();
}
Véase también
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])
Parámetros
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 película. Para poder utilizarlos en Flash
Player o para realizar pruebas en el modo de prueba en la aplicación de edición 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 parámetro opcional que especifica un método HTTP para enviar o cargar
variables. El parámetro debe ser la cadena GET o POST. Si no hay ninguna variable para enviar, no
incluya este parámetro. El método GET adjunta las variables al final del URL y se utiliza para un
número pequeño de variables. El método POST envía las variables en un encabezado HTTP
distinto y se usa para cadenas largas de variables.
variables
Valor devuelto
Ninguno.
Descripción
Método; carga archivos SWF o JPEG en un clip de película de Flash Player mientras se reproduce
la película original. Sin el método loadMovie, Flash Player muestra una sola película (archivo
SWF) y después se cierra. El método loadMovie permite ver varias películas al mismo tiempo y
pasar de una película a otra sin cargar otro documento HTML.
Una película o imagen cargada en un clip de película hereda las propiedades de posición, rotación
y escala del clip de película. Puede utilizar el ruta de destino del clip de película para especificar el
destino de la película cargada.
Utilice el método unloadMovie para eliminar películas o imágenes cargadas con el método
loadMovie. Utilice el método loadVariables para mantener la película activa y actualizar las
variables con nuevos valores.
Véase también
loadMovie, loadMovieNum, MovieClip.loadVariables, MovieClip.unloadMovie,
unloadMovie, unloadMovieNum
336
MovieClip.loadVariables
Disponibilidad
Flash Player 5.
Sintaxis
myMovieClip.loadVariables("url", variables)
Parámetros
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 película.
Un parámetro opcional que especifica un método HTTP para enviar variables. El
parámetro debe ser la cadena GET o POST. Si no hay ninguna variable para enviar, no incluya este
parámetro. El método GET adjunta las variables al final del URL y se utiliza para un número
pequeño de variables. El método POST envía las variables en un encabezado HTTP distinto y se
usa para cadenas largas de variables.
variables
Valor devuelto
Ninguno.
Descripción
Método; 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 número de variables.
Este método también puede utilizarse para actualizar las variables del clip de película activa con
nuevos valores.
Este método requiere que el texto del URL esté en el formato MIME estándar application/xwww-form-urlencoded (formato de script CGI).
Véase también
loadMovie, loadVariables, loadVariablesNum, MovieClip.unloadMovie
MovieClip.localToGlobal
Disponibilidad
Flash Player 5.
Sintaxis
myMovieClip.localToGlobal(punto)
Parámetros
El nombre o identificador de un objeto creado con el objeto Object que especifica las
coordenadas x e y como propiedades.
punto
Valor devuelto
Ninguno.
Descripción
Método; convierte el objeto punto de las coordenadas (locales) del clip de película 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 película 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 posición del ratón.
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();
}
Véase también
MovieClip.globalToLocal
MovieClip.moveTo
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.moveTo (x, y)
Parámetros
Un número entero que indica la posición horizontal relativa al punto de registro del clip de
película principal.
x
Un número entero que indica la posición vertical relativa al punto de registro del clip de
película principal.
y
Valor devuelto
Ninguno.
Descripción
Método; mueve la posición actual del dibujo a (x, y). Si falta alguno de estos parámetros, el
método falla y la posición del dibujo no se cambia.
Ejemplo
En este ejemplo se dibuja un triángulo con una línea de color magenta de 5 puntos sin relleno. La
primera línea crea un clip de película vacío con el que se dibuja. En la sentencia with, se define un
tipo de línea y, a continuación, el método moveTo indica la posición 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 );
}
Véase también
MovieClip.createEmptyMovieClip, MovieClip.lineStyle, MovieClip.lineTo
338
MovieClip._name
Disponibilidad
Flash Player 4.
Sintaxis
myMovieClip._name
Descripción
Propiedad; devuelve el nombre de instancia del clip de película especificado por MovieClip.
MovieClip.nextFrame
Disponibilidad
Flash Player 5.
Sintaxis
myMovieClip.nextFrame()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; envía la cabeza lectora al fotograma siguiente y la detiene.
Véase también
nextFrame
MovieClip.onData
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.onData
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando un clip de película recibe datos de una llamada
loadVariables o loadMovie.
Debe definir una función que se ejecute cuando se invoque el evento.
Diccionario de ActionScript 339
Ejemplo
En el ejemplo siguiente se define una función para el método onData que envía una acción trace
a la ventana Salida.
myMovieClip.onData = function () {
trace ("se ha llamado al método onData");
};
MovieClip.onDragOut
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.onDragOver
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando se presiona el puntero, se desplaza fuera y después se
sitúa sobre el clip de película.
Debe definir una función que se ejecute cuando se invoque el evento.
Ejemplo
En el ejemplo siguiente se define una función para el método onDragOut que envía una acción
trace a la ventana Salida.
myMovieClip.onDragOut = function () {
trace ("se ha llamado al método onDragOut");
};
Véase también
MovieClip.onDragOver
MovieClip.onDragOver
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.onDragOver
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando se presiona el puntero, se desplaza fuera y después se
sitúa sobre el clip de película.
340
Debe definir una función que se ejecute cuando se invoque el evento.
Ejemplo
En el ejemplo siguiente se define una función para el método onDragOut que envía una acción
trace a la ventana Salida.
myMovieClip.onDragOver = function () {
trace ("se ha llamado al método onDragOver");
};
Véase también
MovieClip.onDragOut
MovieClip.onEnterFrame
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.onEnterFrame
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca de forma continua a la velocidad de los fotogramas de la
película. 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 función que se ejecute cuando se invoque el evento.
Ejemplo
En el ejemplo siguiente se define una función para el método onEnterFrame que envía una
acción trace a la ventana Salida.
myMovieClip.onEnterFrame = function () {
trace ("se ha llamado al método onEnterFrame");
};
MovieClip.onKeyDown
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.onKeyDown
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Diccionario de ActionScript 341
Descripción
Controlador de eventos; se invoca cuando un clip de película dispone de una selección de entrada
y se presiona una tecla. El evento onKeyDown se invoca sin parámetros. Puede utilizar los métodos
Key.getAscii y Key.getCode para determinar la tecla que se ha presionado.
Debe definir una función que se ejecute cuando se invoque el evento.
Ejemplo
En el ejemplo siguiente se define una función para el método onKeyDown que envía una acción
trace a la ventana Salida:
myMovieClip.onKeyDown = function () {
trace ("se ha llamado al método onKeyDown");
};
Véase también
MovieClip.onKeyUp
MovieClip.onKeyUp
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.onKeyUp
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Evento; se invoca cuando se suelta una tecla. El evento onKeyUp se invoca sin parámetros. Puede
utilizar los métodos Key.getAscii y Key.getCode para determinar la tecla que se ha presionado.
Debe definir una función que se ejecute cuando se invoque el evento.
Ejemplo
En el ejemplo siguiente se define una función para el método onKeyPress que envía una acción
trace a la ventana Salida.
myMovieClip.onKeyUp = function () {
trace ("se ha llamado al método onKeyUp");
};
342
MovieClip.onKillFocus
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.onKillFocus = function (nuevaSelección) {
sentencias;
};
Parámetros
nuevaSelección
Objeto que se selecciona mediante el teclado.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; un evento que se invoca cuando un clip de película ya no se selecciona
mediante el teclado. El método onKillFocus recibe un parámetro, nuevaSelección, que es un
objeto que representa el nuevo objeto seleccionado. Si no hay ningún objeto seleccionado,
nuevaSelección contiene el valor null.
MovieClip.onLoad
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.onLoad
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando se crea la instancia del clip de película y aparece en la
línea de tiempo.
Debe definir una función que se ejecute cuando se invoque el evento.
Ejemplo
En el ejemplo siguiente se define una función para el método onLoad que envía una acción trace
a la ventana Salida:
myMovieClip.onLoad = function () {
trace ("se ha llamado al método onLoad");
};
Diccionario de ActionScript 343
MovieClip.onMouseDown
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.onMouseDown
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando se presiona el botón del ratón.
Debe definir una función que se ejecute cuando se invoque el evento.
Ejemplo
En el ejemplo siguiente se define una función para el método onMouseDown que envía una acción
trace a la ventana Salida:
myMovieClip.onMouseDown = function () {
trace ("se ha llamado al método onMouseDown");
}
MovieClip.onMouseMove
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.onMouseMove
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando se mueve el ratón.
Debe definir una función que se ejecute cuando se invoque el evento.
Ejemplo
En el ejemplo siguiente se define una función para el método onMouseMove que envía una acción
trace a la ventana Salida.
myMovieClip.onMouseMove = function () {
trace ("se ha llamado al método onMouseMove");
};
344
MovieClip.onMouseUp
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.onMouseUp
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando se suelta el ratón.
Debe definir una función que se ejecute cuando se invoque el evento.
Ejemplo
En el ejemplo siguiente se define una función para el método onMouseUp que envía una acción
trace a la ventana Salida.
myMovieClip.onMouseUp = function () {
trace ("se ha llamado al método onMouseUp");
};
MovieClip.onPress
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.onPress
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando se hace clic con el puntero del ratón sobre un clip de
película.
Debe definir una función que se ejecute cuando se invoque el evento.
Ejemplo
En el ejemplo siguiente se define una función para el método onPress que envía una acción
trace a la ventana Salida.
myMovieClip.onPress = function () {
trace ("se ha llamado al método onPress");
};
Diccionario de ActionScript 345
MovieClip.onRelease
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.onRelease
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando se suelta un clip de película de botón.
Debe definir una función que se ejecute cuando se invoque el evento.
Ejemplo
En el ejemplo siguiente se define una función para el método onPress que envía una acción
trace a la ventana Salida.
myMovieClip.onRelease = function () {
trace ("se ha llamado al método onRelease");
};
MovieClip.onReleaseOutside
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.onReleaseOutside
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando se suelta el ratón mientras el puntero está fuera del clip
de película después de presionar el botón del ratón dentro del clip de película.
Debe definir una función que se ejecute cuando se invoque el evento.
Ejemplo
En el ejemplo siguiente se define una función para el método onReleaseOutside que envía una
acción trace a la ventana Salida.
myMovieClip.onReleaseOutside = function () {
trace ("se ha llamado al método onReleaseOutside");
};
346
MovieClip.onRollOut
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.onRollOut
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando el puntero se desplaza fuera del área de un clip de película.
Debe definir una función que se ejecute cuando se invoque el evento.
Ejemplo
En el ejemplo siguiente se define una función para el método onRollOut que envía una acción
trace a la ventana Salida.
myMovieClip.onRollOut = function () {
trace ("se ha llamado al método onRollOut");
};
MovieClip.onRollOver
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.onRollOver
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando el puntero se desplaza sobre el área de un clip de película.
Debe definir una función que se ejecute cuando se invoque el evento.
Ejemplo
En el ejemplo siguiente se define una función para el método onRollOver que envía una acción
trace a la ventana Salida.
myMovieClip.onRollOver = function () {
trace ("se ha llamado al método onRollOver");
};
Diccionario de ActionScript 347
MovieClip.onSetFocus
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.onSetFocus = function(selecciónAnterior){
sentencias;
};
Parámetros
selecciónAnterior
El objeto que dejará de estar seleccionado.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando un clip de película recibe la selección de teclado. El
parámetro selecciónAnterior es el objeto que deja de estar seleccionado. Por ejemplo, si el
usuario presiona la tecla Tabulador para mover la selección de entrada de un clip de película a un
campo de texto, selecciónAnterior contiene la instancia del clip de película.
Si no hay ningún objeto seleccionado anteriormente, selecciónAnterior contiene un valor null.
MovieClip.onUnload
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.onUnload
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca en el primer fotograma después de eliminar el clip de película de la
línea de tiempo. Las acciones asociadas con el evento onUnload se procesan antes de que se asocien
acciones al fotograma afectado. Debe definir la función que se ejecuta cuando se invoca el evento.
Ejemplo
En el ejemplo siguiente se define una función para el método onUnload que envía una acción
trace a la ventana Salida.
myMovieClip.onUnload = function () {
trace ("se ha llamado al método onUnload");
};
348
MovieClip._parent
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip._parent.property
_parent._parent.property
Descripción
Propiedad; especifica o devuelve una referencia al clip de película que contiene el objeto o el clip
de película. El objeto actual es el objeto que contiene el código de ActionScript que hace
referencia a _parent. Utilice la propiedad _parent para especificar una ruta relativa a los clips de
película u objetos que están por encima del clip de película u objeto actual.
Véase también
_root, targetPath
MovieClip.play
Disponibilidad
Flash Player 5.
Sintaxis
myMovieClip.play()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; mueve la cabeza lectora de la línea de tiempo del clip de película.
Véase también
play
MovieClip.prevFrame
Disponibilidad
Flash Player 5.
Sintaxis
myMovieClip.prevFrame()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; envía la cabeza lectora al fotograma anterior y la detiene.
Véase también
prevFrame
Diccionario de ActionScript 349
MovieClip.removeMovieClip
Disponibilidad
Flash Player 5.
Sintaxis
myMovieClip.removeMovieClip()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; elimina una instancia de clip de película creada con la acción duplicateMovieclip o
los métodos duplicateMovieClip o attachMovie del objeto MovieClip.
Véase también
MovieClip.attachMovie, MovieClip.attachMovie, removeMovieClip,
MovieClip.attachMovie
MovieClip._rotation
Disponibilidad
Flash Player 4.
Sintaxis
myMovieClip._rotation
Descripción
Propiedad; especifica la rotación del clip de película en grados.
MovieClip.setMask
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.setMask (clipMáscara)
Parámetros
myMovieClip
El nombre de instancia de un clip de película que se va a enmascarar.
clipMáscara
El nombre de instancia de un clip de película que debe ser una máscara.
Valor devuelto
Ninguno.
Descripción
Método; convierte el clip de película del parámetro clipMáscara en una máscara que muestra el
clip de película especificado por el parámetro myMovieClip.
350
El método setMask permite que los clips de película con varios fotogramas que poseen un
contenido complejo y con distintas capas actúen como máscaras. Puede activar o desactivar las
máscaras en tiempo de ejecución. Sin embargo, no puede utilizar la misma máscara para varios
elementos con máscara (lo cual es posible con el uso de capas de máscara). Si dispone de fuentes
de dispositivo en un clip de película con máscara, dichas fuentes se dibujarán pero no se
enmascararán. No es posible definir que un clip de película sea su propia máscara, por ejemplo
mc.setMask(mc).
Si crea una capa de máscara que contiene un clip de película y, a continuación, le aplica el método
setMask, la llamada a setMask tiene prioridad y, por lo tanto, no es reversible. Por ejemplo,
puede tener un clip de película en una capa de máscara denominada UIMask que enmascara otra
capa que contiene un clip de película denominado UIMaskee. Si, durante la reproducción de la
película, llama a UIMask.setMask(UIMaskee), a partir de ese momento, UIMask estará
enmascarado por UIMaskee.
Para cancelar una máscara creada con ActionScript, pase el valor null al método setMask. El
código siguiente cancela la máscara sin que afecte a la capa de máscara de la línea de tiempo.
UIMask.setMask(null)
Ejemplo
En el código de muestra siguiente se utiliza el clip de película circleMask para enmascarar el clip
de película theMaskee.
theMaskee.setMask(circleMask);
MovieClip._soundbuftime
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip._soundbuftime
Descripción
Propiedad (global); entero que especifica el número 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]])
Parámetros
Valor booleano que especifica si el clip de película arrastrable está bloqueado en el
centro de la posición del ratón (true) o en el punto en el que el usuario hizo clic por primera vez
en el clip de película (false). Este parámetro es opcional.
bloquear
izquierda, superior, derecha, inferior
Valores relativos a las coordenadas del elemento
principal del clip de película que especifican un rectángulo de limitación para el clip de película.
Estos parámetros son opcionales.
Diccionario de ActionScript 351
Valor devuelto
Ninguno.
Descripción
Método; permite al usuario arrastrar el clip de película especificado. Un clip de película puede
arrastrarse hasta que se detiene explícitamente por la llamada del método stopDrag, o hasta que
otro clip de película se convierte en arrastrable. Sólo puede arrastrarse un clip de película cada vez.
Véase también
MovieClip._droptarget, MovieClip.startDrag, MovieClip.stopDrag
MovieClip.stop
Disponibilidad
Flash Player 5.
Sintaxis
myMovieClip.stop()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; detiene el clip de película que se está reproduciendo actualmente.
Véase también
stop
MovieClip.stopDrag
Disponibilidad
Flash Player 5.
Sintaxis
myMovieClip.stopDrag()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; finaliza un método startDrag. Una película que se convirtió en arrastrable con el
método startDrag continúa siendo arrastrable hasta que se agrega un método stopDrag o hasta
que otra película se convierte en arrastrable. Sólo puede arrastrarse un clip de película cada vez.
Véase también
MovieClip._droptarget, MovieClip.startDrag, stopDrag
352
MovieClip.swapDepths
Disponibilidad
Flash Player 5.
Sintaxis
myMovieClip.swapDepths(profundidad)
myMovieClip.swapDepths(destino)
Parámetros
destino La instancia del clip de película cuya profundidad se intercambia con la instancia
especificada en myMovieClip. Ambas instancias deben tener el mismo clip de película principal.
profundidad
Un número que especifica el nivel de profundidad donde se va a colocar MovieClip.
Valor devuelto
Ninguno.
Descripción
Método; intercambia el apilado, o el orden z (nivel de profundidad), de la instancia especificada
(MovieClip) con la película especificada por el parámetro destino o con la película que
actualmente ocupa el nivel de profundidad especificado en el parámetro profundidad. Ambas
películas deben tener el mismo clip de película principal. Al intercambiar el nivel de profundidad
de los clips de película se mueve una película frente o detrás de la otra. Si la película se está
interpolando cuando se llama a este método, se detiene la interpolación.
Véase también
_level
MovieClip.tabChildren
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.tabChildren
Descripción
Propiedad; el valor predeterminado es undefined. Si tabChildren tiene el valor undefined o
true, los elementos secundarios de un clip de película se incluyen en el orden de tabulación
automático. Si el valor de tabChildren es false, los elementos secundarios de un clip de película
no se incluyen en el orden de tabulación automático.
Ejemplo
Un objeto de interfaz de cuadro de lista creado como clip de película contiene varios elementos.
Puede hacer clic en cada elemento para seleccionarlo, de modo que cada elemento es un botón.
Sin embargo, únicamente el cuadro de lista puede ser una tabulación. Los elementos que contiene
el cuadro de lista deben excluirse del orden de tabulación. Para ello, la propiedad tabChildren
del cuadro de lista debe estar establecida en false.
La propiedad tabChildren no tiene ningún efecto si se utiliza la propiedad tabIndex; sólo afecta
al orden de tabulación automático.
Véase también
Button.tabIndex, TextField.tabIndex
Diccionario de ActionScript 353
MovieClip.tabEnabled
Disponibilidad
Flash Player 6.
Sintaxis
MovieClip.tabEnabled
Descripción
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 tabulación
automático. Si la propiedad tabIndex también se establece en un valor, el objeto se incluye en el
orden de tabulación personalizado. Si el valor de tabEnabled es false, el objeto no se incluye en
el orden de tabulación automático. En el caso de un clip de película, si tabEnabled es false, los
valores secundarios del clip de película pueden seguir incluyéndose en el orden de tabulación
automático, a menos que la propiedad tabChildren también se establezca en false.
Véase también
MovieClip.tabChildren, MovieClip.tabIndex
MovieClip.tabIndex
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.tabIndex
Descripción
Propiedad; permite personalizar el orden de tabulación de los objetos de una película. El valor
predeterminado de la propiedad tabIndex es undefined. Puede establecer tabIndex en un
botón, un clip de película o una instancia de campo de texto.
Si un objeto de una película Flash contiene una propiedad tabIndex, el orden de tabulación
automático está desactivado y el orden de tabulación se calcula a partir de las propiedades
tabIndex de los objetos de la película. El orden de tabulación personalizado sólo 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 tabulación
personalizado no tiene en cuenta las relaciones jerárquicas de los objetos de una película Flash.
Todos los objetos de la película Flash con las propiedades tabIndex se colocan según el orden de
tabulación. No debe utilizarse el mismo valor de tabIndex para varios objetos.
354
MovieClip._target
Disponibilidad
Flash Player 4.
Sintaxis
myMovieClip._target
Descripción
Propiedad (sólo lectura); devuelve la ruta de destino de la instancia de clip de película especificada
en el parámetro MovieClip.
MovieClip._totalframes
Disponibilidad
Flash Player 4.
Sintaxis
myMovieClip._totalframes
Descripción
Propiedad (sólo lectura); devuelve el número total de fotogramas de la instancia de clip de película
especificada en el parámetro MovieClip.
MovieClip.trackAsMenu
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.trackAsMenu
Descripción
Propiedad; propiedad booleana que indica si los botones o los clips de película pueden recibir o
no eventos al soltar el ratón. Permite crear menús. Puede establecer la propiedad trackAsMenu en
cualquiera de los objetos de botón o de clip de película. Si la propiedad trackAsMenu no existe, el
comportamiento predeterminado es false.
Puede cambiar la propiedad trackAsMenu en cualquier momento; el clip de película de botón
modificado asume de inmediato el nuevo comportamiento.
Véase también
Button.trackAsMenu
Diccionario de ActionScript 355
MovieClip.unloadMovie
Disponibilidad
Flash Player 5.
Sintaxis
myMovieClip.unloadMovie()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; elimina un clip de película cargado con los métodos loadMovie o attachMovie de
MovieClip.
Véase también
MovieClip.attachMovie, MovieClip.loadMovie, unloadMovie, unloadMovieNum
MovieClip._url
Disponibilidad
Flash Player 4.
Sintaxis
myMovieClip._url
Descripción
Propiedad (sólo lectura); recupera el URL del archivo SWF del que se descargó el clip de película.
MovieClip.useHandCursor
Disponibilidad
Flash Player 6.
Sintaxis
myMovieClip.useHandCursor
Descripción
Propiedad; valor booleano que indica si el cursor con forma de mano se visualiza cuando un
usuario se sitúa sobre un clip de película de botón. El valor predeterminado de useHandCursor es
true. Si useHandCursor se establece en true, el cursor estándar con forma de mano utilizado
para los botones se visualiza cuando un usuario se sitúa sobre un clip de película de botón. 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 película de botón
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
Descripción
Propiedad; valor booleano que indica si la película especificada por el parámetro MovieClip es
visible. Los clips de película que no son visibles (propiedad _visible establecida en false) están
desactivados. Por ejemplo, no es posible hacer clic en un botón de un clip de película con la
propiedad _visible establecida en false.
MovieClip._width
Disponibilidad
Flash Player 4 como propiedad de sólo lectura.
Sintaxis
myMovieClip._width
Descripción
Propiedad; establece y recupera la anchura del clip de película en píxeles.
Ejemplo
En el ejemplo siguiente se establecen las propiedades de altura y anchura de un clip de película
cuando el usuario hace clic con el ratón.
onclipEvent(mouseDown) {
_width=200;
_height=200;
}
Véase también
MovieClip._height
Diccionario de ActionScript 357
MovieClip._x
Disponibilidad
Flash Player 3.
Sintaxis
myMovieClip._x
Descripción
Propiedad; número entero que establece la coordenada x de una película en relación a las
coordenadas locales del clip de película principal. Si un clip de película está en la línea de tiempo
principal, su sistema de coordenadas hace referencia a la esquina superior izquierda del escenario
como (0, 0). Si el clip de película se encuentra dentro de otro clip de película que tiene
transformaciones, el clip de película está en el sistema de coordenadas local del clip de película que
lo contiene. Así, para un clip de película girado 90° en sentido contrario a las agujas del reloj, el
clip de película secundario hereda un sistema de coordenadas que está girado 90° en sentido
contrario a las agujas del reloj. Las coordenadas del clip de película hacen referencia a la posición
del punto de registro.
Véase también
MovieClip._xscale, MovieClip._y, MovieClip._yscale
MovieClip._xmouse
Disponibilidad
Flash Player 5.
Sintaxis
myMovieClip._xmouse
Descripción
Propiedad (sólo lectura); devuelve la coordenada x de la posición del ratón.
Véase también
Mouse (objeto), MovieClip._ymouse
MovieClip._xscale
Disponibilidad
Flash Player 4.
Sintaxis
myMovieClip._xscale
Descripción
Propiedad; determina la escala horizontal (porcentaje) del clip de película que se aplica desde el
punto de registro del clip de película. El punto de registro predeterminado es (0,0).
Cambiar la escala del sistema de coordenadas local afecta a la configuración de las propiedades _x
e _y, que se definen en píxeles. Por ejemplo, si se cambia la escala del clip de película principal al
50%, al establecer la propiedad _x se mueve un objeto en el clip de película la mitad del número
de píxeles que lo haría si la película estuviera al 100%.
Véase también
MovieClip._x, MovieClip._y, MovieClip._yscale
358
MovieClip._y
Disponibilidad
Flash Player 3.
Sintaxis
myMovieClip._y
Descripción
Propiedad; establece la coordenada y de la película en relación a las coordenadas locales del clip de
película principal. Si un clip de película está en la línea de tiempo principal, su sistema de
coordenadas hace referencia a la esquina superior izquierda del escenario como (0, 0). Si el clip de
película se encuentra dentro de otro clip de película que tiene transformaciones, el clip de película
está en el sistema de coordenadas local del clip de película que lo contiene. Así, para un clip de
película girado 90° en sentido contrario a las agujas del reloj, el clip de película secundario hereda
un sistema de coordenadas que está girado 90° en sentido contrario a las agujas del reloj. Las
coordenadas del clip de película hacen referencia a la posición del punto de registro.
Véase también
MovieClip._x, MovieClip._xscale, MovieClip._yscale
MovieClip._ymouse
Disponibilidad
Flash Player 5.
Sintaxis
myMovieClip._ymouse
Descripción
Propiedad (sólo lectura); indica la coordenada y de la posición del ratón.
Véase también
Mouse (objeto), MovieClip._xmouse
MovieClip._yscale
Disponibilidad
Flash Player 4.
Sintaxis
myMovieClip._yscale
Descripción
Propiedad; establece la escala vertical (porcentaje) del clip de película que se aplica desde el
punto de registro del clip de película. El punto de registro predeterminado es (0,0).
Cambiar la escala del sistema de coordenadas local afecta a la configuración de las propiedades _x
e _y, que se definen en píxeles. Por ejemplo, si se cambia la escala del clip de película principal al
50%, al establecer la propiedad _x se mueve un objeto en el clip de película la mitad del número
de píxeles que lo haría si la película estuviera al 100%.
Véase también
MovieClip._x, MovieClip._xscale, MovieClip._y
Diccionario de ActionScript 359
NaN
Disponibilidad
Flash Player 5.
Sintaxis
NaN
Descripción
Variable; una variable predefinida con el valor IEEE-754 para NaN (No es un Número, Not a
Number).
ne (no igual; específico para cadenas)
Disponibilidad
Flash Player 4. Este operador se ha desestimado; se recomienda utilizar el operador !=
(desigualdad).
Sintaxis
expresión1 ne expresión2
Parámetros
expresión1,expresión2
Números, cadenas o variables.
Valor devuelto
Ninguno.
Descripción
Operador (de comparación); compara expresión1 con expresión2 y devuelve true si
expresión1 no es igual a expresión2; en caso contrario, devuelve false.
Véase también
!= (desigualdad)
new
Disponibilidad
Flash Player 5.
Sintaxis
new constructor()
Parámetros
Una función seguida de cualquiera de los parámetros opcionales entre paréntesis.
La función es habitualmente el nombre del tipo de objeto (por ejemplo, Array, Math, Number u
Object) que se va a construir.
constructor
Valor devuelto
Ninguno.
360
Descripción
Operador; crea un nuevo objeto, inicialmente anónimo, y llama a la función identificada por el
parámetro constructor. El operador new pasa a la función los parámetros opcionales entre
paréntesis, así como el objeto recién creado, al que se hace referencia con la palabra clave this. De este
modo, la función constructor puede utilizar la palabra this para establecer las variables del objeto.
La propiedad prototype de la función constructor se copia en la propiedad __proto__ del nuevo
objeto. Como resultado, el nuevo objeto admite todos los métodos y propiedades especificados en
la función constructor del objeto Prototype.
Ejemplo
El ejemplo siguiente crea la función Book y, a continuación, 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);
Véase también
[] (acceso a matriz), {} (inicializador de objeto)
La sección del método constructor dentro de cada entrada de objeto.
newline
Disponibilidad
Flash Player 4.
Sintaxis
newline
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Constante; inserta un carácter de retorno de carro () que inserta una línea vacía en el código
ActionScript. Utilice newline para crear espacio para la información que se recupera mediante
una función o una acción del código.
Diccionario de ActionScript 361
nextFrame
Disponibilidad
Flash 2.
Sintaxis
nextFrame()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Acción; envía la cabeza lectora al fotograma siguiente y la detiene.
Ejemplo
En este ejemplo, cuando el usuario hace clic en el botón, la cabeza lectora pasa al siguiente
fotograma y se detiene.
on (release) {
nextFrame();
}
nextScene
Disponibilidad
Flash 2.
Sintaxis
nextScene()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Acción; envía la cabeza lectora al fotograma 1 de la escena siguiente y la detiene.
Ejemplo
En este ejemplo, cuando un usuario suelta el botón, la cabeza lectora se envía al fotograma 1 de la
escena siguiente.
on(release) {
nextScene();
}
Véase también
prevScene
362
not
Disponibilidad
Flash Player 4. Este operador se ha desestimado; se recomienda utilizar el operador ! (NOT
lógico).
Sintaxis
not expresión
Parámetros
expresión
Cualquier variable o expresión que puede convertirse a un valor booleano.
Descripción
Operador; realiza una operación NOT lógica en Flash Player 4.
Véase también
! (NOT lógico)
null
Disponibilidad
Flash Player 5.
Sintaxis
null
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Palabra clave; un valor especial que puede asignarse a variables o puede ser devuelto por una
función 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 numérico, 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 podría establecerse como null.
if (tree.left == null) {
tree.left = new TreeNode();
}
Diccionario de ActionScript 363
Number (función)
Disponibilidad
Flash Player 4.
Sintaxis
Number(expresión)
Parámetros
expresión
Expresión que debe convertirse en un número.
Valor devuelto
Ninguno.
Descripción
Función; convierte el parámetro expresión en un número y devuelve un valor de acuerdo con lo
siguiente:
Si expresión es un número, el valor devuelto es expresión.
Si expresión es un valor
expresión es false.
booleano, el valor devuelto es 1 si expresión es true, o bien 0 si
Si expresión es una cadena, la función intenta analizar expresión como un número decimal
con un exponente final opcional, es decir, 1.57505e-3.
Si expresiónx es undefined, el valor devuelto es 0.
Esta función se utiliza para convertir los archivos de Flash 4 que contienen operadores
desestimados que se importan al entorno de edición de Flash 5. Consulte el operador & para
obtener más información.
Véase también
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 numéricos primitivos utilizando los métodos y propiedades
asociadas con el objeto Number. Este objeto es idéntico 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 métodos 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 métodos y propiedades del objeto Number.
El ejemplo siguiente llama al método toString del objeto Number, que devuelve la cadena “1234”.
myNumber = new Number(1234);
myNumber.toString();
Este ejemplo llama a la propiedad MIN_VALUE (también denominada constante) del objeto Number:
smallest = Number.MIN_VALUE
364
Resumen de los métodos del objeto Number
Método
Descripción
Number.toString
Devuelve la representación de cadena de un objeto Number.
Number.valueOf
Devuelve el valor primitivo del objeto Number.
Resumen de las propiedades del objeto Number
Propiedad
Descripción
Number.MAX_VALUE
Constante que representa el número mayor que se puede representar
(IEEE-754 de doble precisión). Este número es aproximadamente
1.7976931348623158e+308.
Number.MIN_VALUE
Constante que representa el número menor que se puede representar
(IEEE-754 de doble precisión). Este número es aproximadamente 5e-324.
Number.NaN
Constante que representa el valor de Not a Number (NaN).
Number.NEGATIVE_INFINITY
Constante que representa el valor de infinito negativo.
Number.POSITIVE_INFINITY
Constante que representa el valor de infinito positivo. Este valor es el mismo
que la variable global Infinity.
Constructor del objeto Number.
Disponibilidad
Flash Player 5.
Sintaxis
myNumber = new Number(valor)
Parámetros
El valor numérico del objeto Number que se está creando o un valor que se va a convertir
en un número.
valor
Valor devuelto
Ninguno.
Descripción
Constructor; crea un nuevo objeto Number. Debe utilizar el constructor Number cuando utilice
los métodos 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 posición. Una instancia del objeto Number no es lo mismo que la función
Number que convierte un parámetro en un valor primitivo.
Ejemplo
El código siguiente construye nuevos objetos Number.
n1 = new Number(3.4);
n2 = new Number(-10);
Véase también
Number (función)
Diccionario de ActionScript 365
Number.MAX_VALUE
Disponibilidad
Flash Player 5.
Sintaxis
Number.MAX_VALUE
Descripción
Propiedad; el número mayor que se puede representar (IEEE-754 de doble precisión). Este
número es aproximadamente 1.79E+308.
Number.MIN_VALUE
Disponibilidad
Flash Player 5.
Sintaxis
Number.MIN_VALUE
Descripción
Propiedad; el número menor que se puede representar (IEEE-754 de doble precisión). Este
número es aproximadamente 5e-324.
Number.NaN
Disponibilidad
Flash Player 5.
Sintaxis
Number.NaN
Descripción
Propiedad; el valor IEEE-754 que representa Not A Number (NaN).
Number.NEGATIVE_INFINITY
Disponibilidad
Flash Player 5.
Sintaxis
Number.NEGATIVE_INFINITY
Descripción
Propiedad; devuelve el valor IEEE-754 que representa infinito negativo.
El infinito negativo es un valor numérico especial que se devuelve cuando una operación o
función matemática devuelve un valor negativo mayor de lo que se puede representar.
366
Number.POSITIVE_INFINITY
Disponibilidad
Flash Player 5.
Sintaxis
Number.POSITIVE_INFINITY
Descripción
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 numérico especial que se devuelve cuando una operación o función
matemática devuelve un valor mayor de lo que se puede representar.
Number.toString
Disponibilidad
Flash Player 5.
Sintaxis
myNumber.toString(base)
Parámetros
Especifica la base numérica (de 2 a 36) que se utiliza en la conversión de número a cadena.
Si no especifica el parámetro base, el valor predeterminado es 10.
base
Valor devuelto
Ninguno.
Descripción
Método; devuelve la representación de la cadena del objeto Number especificado (myNumber).
Ejemplo
El ejemplo siguiente utiliza el método Number.toString, especificando 2 para el parámetro base
y devuelve una cadena que contiene la representación binaria del número 1000.
myNumber = new Number (1000);
myNumber.toString(2);
Number.valueOf
Disponibilidad
Flash Player 5.
Sintaxis
myNumber.valueOf()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; devuelve el tipo de valor primitivo del objeto Number especificado.
Diccionario de ActionScript 367
Object (objeto)
El objeto genérico Object se encuentra en la raíz de la jerarquía de clases de ActionScript. El
objeto genérico Object de ActionScript contiene un pequeño 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 genérico Object se admite en Flash Player 5.
Resumen de los métodos del objeto Object
Método
Descripción
Object.addProperty
Crea una propiedad del captador/definidor de un objeto.
Object.registerClass
Asigna una clase de ActionScript a una instancia de clip de película.
Object.toString
Convierte el objeto especificado en una cadena y la devuelve.
Object.unwatch
Elimina el registro creado con el método Object.watch.
Object.valueOf
Devuelve el valor primitivo de un objeto Object.
Object.watch
Registra la función callback que se debe invocar cuando cambia una propiedad
específica de un objeto de ActionScript.
Resumen de las propiedades del objeto Object
Propiedad
Descripción
Object.__proto__
Referencia a la propiedad prototype de la función constructor del objeto.
Constructor del objeto Object.
Disponibilidad
Flash Player 5.
Sintaxis
new Object([valor])
Parámetros
Un número, valor booleano o cadena que se va a convertir en un objeto. Este parámetro
es opcional. Si no especifica el parámetro valor, el constructor crea un nuevo objeto sin
propiedades definidas.
valor
Descripción
Constructor; crea un nuevo objeto Object.
368
Object.addProperty
Disponibilidad
Flash Player 6.
Sintaxis
myObject.addProperty( prop, funciónGet, funciónSet )
Parámetros
prop
Nombre de la propiedad de objeto que se debe crear.
funciónGet Función que se invoca para recuperar el valor de la propiedad; este parámetro es un
objeto de función.
Función que se invoca para definir el valor de la propiedad; este parámetro es un
objeto de función. Si pasa el valor null en este parámetro, la propiedad es de sólo lectura.
funciónSet
Valor devuelto
Devuelve el valor true si la propiedad se crea correctamente; en caso contrario, devuelve false.
Descripción
Método; crea una propiedad del captador/definidor. Cuando Flash lee una propiedad del
captador/definidor, invoca la función get y el valor devuelto de la función se convierte en un valor
de prop. Cuando Flash escribe una propiedad del captador/definidor, invoca la función set y le
pasa el nuevo valor como un parámetro. Si existe una propiedad con un nombre concreto, la
nueva propiedad lo sobrescribe.
La función get es una función que no tiene parámetros. El valor devuelto puede ser de cualquier
tipo. El tipo de valor puede cambiar según la invocación. El valor devuelto se trata como el valor
actual de la propiedad.
La función set es una función que acepta un parámetro: el nuevo valor de la propiedad. Por
ejemplo, si la propiedad x se asigna mediante la sentencia x = 1, la función set recibirá el
parámetro 1 de tipo número. El valor devuelto de la función 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 heredarán la propiedad del captador/definidor. Esto hace posible agregar una propiedad
del captador/definidor a una ubicación, el objeto prototipo, y aplicarla a todas las instancias de
una clase (como si se agregaran métodos a objetos prototipo). Si se invoca una función get/set
para una propiedad del captador/definidor de un objeto prototipo heredado, la referencia que se
pasa a la función 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:
Condición de error
Qué sucede
prop no es un nombre de propiedad válido; por
ejemplo, una cadena vacía.
Devuelve false y no se agrega la propiedad.
funciónGet no es un objeto de función válido.
Devuelve false y no se agrega la propiedad.
funciónSet no es un objeto de función válido.
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 métodos internos getScroll,
setScroll y getMaxScroll. El constructor TextField crea las propiedades de captador/definidor
y las dirige a los métodos internos get/set, tal como se muestra a continuación:
this.addProperty("scroll", this.getScroll, this.setScroll);
this.addProperty("maxscroll", this.getMaxScroll, null);
Cuando un script recupera el valor de myTextField.scroll, el intérprete de ActionScript invoca
automáticamente myTextField.getScroll. Cuando un script modifica el valor de
myTextField.scroll, el intérprete invoca myTextField.setScroll. La propiedad maxscroll
no tiene especificada una función 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 sólo existen en un lugar: el objeto
TextField.prototype. Sin embargo, el efecto es el mismo que el código 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__
Parámetros
Ninguno.
Descripción
Propiedad; se refiere a la propiedad prototype de la función constructor que ha creado
myObject. La propiedad __proto__ se asigna automáticamente a todos los objetos al crearlos. El
intérprete de ActionScript utiliza la propiedad __proto__ para acceder a la propiedad prototype
de la función constructor del objeto a fin de averiguar las propiedades y los métodos que el objeto
hereda de su clase.
370
Object.registerClass
Disponibilidad
Flash Player 6
Sintaxis
Object.registerClass(IDsímbolo, laClase)
Parámetros
El identificador de vínculo del símbolo de clip de película, o el identificador de
cadena de la clase de ActionScript.
IDsímbolo
laClase Referencia a la función constructor de la clase de ActionScript, o null para no
registrar el símbolo.
Valor devuelto
Si el registro de clase tiene éxito, se devuelve el valor true; en caso contrario, se devuelve false.
Descripción
Método; asocia un símbolo de clip de película con una clase de objeto de ActionScript. Si no hay
ningún símbolo, Flash crea una asociación entre un identificador de cadena y una clase de objeto.
Cuando la línea de tiempo coloca una instancia del símbolo de clip de película especificado, la
instancia se registra en la clase especificada por el parámetro laClase en lugar de en la clase
MovieClip.
Cuando se crea una instancia del símbolo de clip de película especificado mediante el método
attachMovie o duplicateMovieClip, la instancia se registra en la clase especificada por el
parámetro laClase en lugar de la clase MovieClip.
Si el parámetro laClase es null, Object.registerClass elimina cualquier definición de clase
de ActionScript asociada con el símbolo de clip de película especificado o el identificador de clase.
Para los símbolos de clip de película, todas las instancias existentes del clip de película permanecen
iguales; sin embargo, las nuevas instancias del símbolo se asocian con la clase predeterminada
MovieClip.
Si un símbolo ya se ha registrado en una clase, el método Object.registerClass lo sustituye
por el nuevo registro.
Cuando la línea de tiempo coloca una instancia de clip de película, o cuando ésta se crea con el
método attachMovie o duplicateMovieClip, ActionScript invoca el constructor para la clase
adecuada con la palabra clave this dirigida al objeto. La función constructor se invoca sin
parámetros.
Si se utiliza él método Object.registerClass para registrar un clip de película con una clase de
ActionScript que no sea MovieClip, el símbolo de clip de película no hereda los métodos,
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 código 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 verificación estándar.
Diccionario de ActionScript 371
Primero, debe crear un símbolo de clip de película, denominado Check Box, en la biblioteca. A
continuación, debe crear una clase CheckBox en ActionScript que representará la casilla de
verificación.
// 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 métodos 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 símbolo de clip de película Check Box. Primero, es
preciso que pueda identificar el símbolo de clip de película Check Box en ActionScript. Para ello,
introduzca un identificador en el cuadro de diálogo Vinculación de la biblioteca y seleccione
Exportar para ActionScript.
A continuación, escriba un código en ActionScript para asociar la clase CheckBox con el símbolo
CheckBox:
Object.registerClass("CheckBox" /*ID de símbolo*/, CheckBox /*la clase*/ );
Sintaxis 1 (ubicación de la línea de tiempo): ahora puede colocar las instancias de CheckBox en el
escenario de la herramienta de edición y, en tiempo de ejecución, las instancias recibirán
automáticamente la clase CheckBox de ActionScript. Si coloca dos instancias, myCheckBox1 y
myCheckBox2, puede controlarlas mediante la invocación de métodos, como se muestra a
continuación:
myCheckBox1.setValue(true);
myCheckBox2.setValue(false);
myCheckBox2.setLabel("nueva etiqueta para nº 2");
372
Sintaxis 2 (instancias dinámicas): puede utilizar el método attachMovie para crear una nueva
instancia de la casilla de verificación en el escenario mientras se reproduce la película. Puesto que
el símbolo CheckBox está registrado en la clase CheckBox de ActionScript, la nueva instancia
dinámica recibirá automáticamente dicha clase.
// createCheckBox es una función de ayuda que
// crea casillas de verificación de forma dinámica
function createCheckBox(name, depth) {
attachMovie("CheckBox", name, depth);
}
createCheckBox("myCheckBox3", 100);
myCheckBox3.setValue(false);
myCheckBox3.setLabel("nueva etiqueta para nº 3");
Véase también
MovieClip.attachMovie, MovieClip.duplicateMovieClip
Object.toString
Disponibilidad
Flash Player 5.
Sintaxis
myObject.toString()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; convierte el objeto especificado en una cadena y la devuelve.
Object.unwatch
Disponibilidad
Flash Player 6.
Sintaxis
myObject.unwatch (prop)
Parámetros
prop
Nombre de la propiedad de objeto que ya no debe observarse, como una cadena.
Valor devuelto
Un valor booleano.
Descripción
Método; elimina un punto de observación creado por el método Object.watch. Este método
devuelve el valor true si el punto de observación se ha eliminado correctamente; en caso
contrario, devuelve el valor false.
Diccionario de ActionScript 373
Object.valueOf
Disponibilidad
Flash Player 5.
Sintaxis
myObject.valueOf()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; 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] )
Parámetros
prop
Cadena que indica el nombre de la propiedad de objeto que se debe observar.
La función que se invoca cuando cambia la propiedad observada. Este parámetro es
un objeto de función, no es un nombre de función en formato de cadena. La forma de callback
es callback(prop, valorAnterior, valorNuevo, datosUsuario).
callback
datosUsuario Datos de ActionScript arbitrarios que se pasan al método callback. Si se omite
el parámetro datosUsuario, se pasa el valor undefined al método callback. Este parámetro es
opcional.
Valor devuelto
El valor true si el punto de observación se ha creado correctamente; en caso contrario, devuelve el
valor false.
Descripción
Método; registra una función callback que se debe invocar cuando cambia una propiedad
específica de un objeto de ActionScript. Si la propiedad cambia, la función callback se invoca con
myObject como el objeto que la contiene.
Un punto de observación puede filtrar (o anular) la asignación del valor, mediante la devolución
de un valorNuevo (o valorAnterior) modificado. Si elimina una propiedad para la que se ha
establecido un punto de observación, dicho punto no desaparece. Si, posteriormente, vuelve a
crear dicha propiedad, el punto de observación todavía funcionará. Para eliminar un punto de
observación, utilice el método Object.unwatch.
Sólo se puede registrar un punto de observación en una propiedad. Las posteriores llamadas a
en la misma propiedad sustituirán el punto de observación original.
Object.watch
374
El método Object.watch se comporta de forma parecida a la función Object.watch en Netscape
JavaScript 1.2 y posteriores. La principal diferencia se encuentra en el parámetro datosUsuario; se
trata de una adición de Flash a Object.watch que Netscape Navigator no admite. Puede pasar el
parámetro datosUsuario a la función callback y utilizarlo en dicha función.
El método Object.watch no puede observar las propiedades del captador/definidor. Las
propiedades del captador/definidor funcionan según un “cálculo diferido”, es decir, el valor de la
propiedad no se determina hasta que se consulta la propiedad. A menudo, el “cálculo diferido” es
más 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 observación 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 métodos que definen la etiqueta o el
valor de cada instancia de casilla de verificación:
myCheckBox1.setValue(true);
myCheckBox1.setLabel("nueva etiqueta");
...
Es preferible pensar en el valor y la etiqueta de una casilla de verificación 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 invocación de método, como se muestra a continuación:
// 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 función 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 parámetros. Por lo tanto, la sentencia de asignación siguiente
utiliza un controlador Object.watch para notificar al componente que la variable ha cambiado y,
por consiguiente, se debe actualizar su representación gráfica.
myCheckBox1.value = false;
Esta sintaxis es más concisa que la sintaxis anterior:
myCheckBox1.setValue(false);
Véase también
Object.addProperty, Object.unwatch
Diccionario de ActionScript 375
onClipEvent
Disponibilidad
Flash Player 5.
Sintaxis
onClipEvent(eventoPelícula){
sentencia(s);
}
Parámetros
Un eventoPelícula es un desencadenante denominado evento. Cuando el evento tiene lugar, se
ejecutan las sentencias entre llaves que van a continuación del mismo. Puede especificarse
cualquiera de los valores siguientes para el parámetro eventoPelícula:
•
load
•
unload
•
enterFrame La acción se desencadena de forma continua a la velocidad de los fotogramas de
la película. 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 acción se inicia cada vez que se mueve el ratón. Utilice
_xmouse y _ymouse para determinar la posición actual del ratón.
•
•
•
mouseDown
•
keyUp
•
data La acción se inicia cuando se reciben datos en una acción loadVariables o loadMovie.
Cuando se especifica con una acción loadVariables, el evento data sólo se produce una vez,
cuando se carga la última variable. Cuando se especifica con una acción loadMovie, el evento
data se produce repetidamente, según se recupera cada sección de datos.
La acción se inicia en cuanto se crea una instancia del clip de película y aparece en la
línea de tiempo.
La acción se inicia en el primer fotograma después de eliminar el clip de película de
la línea de tiempo. Las acciones asociadas con el evento de clip de película Unload se procesan
antes de que se asocien acciones al fotograma afectado.
mouseUp
las propiedades
La acción se inicia cada vez que se presiona el botón izquierdo del ratón.
La acción se inicia cada vez que se suelta el botón izquierdo del ratón.
La acción se inicia cuando se presiona una tecla. Utilice el método Key.getCode
para recuperar información sobre la última tecla presionada.
keyDown
La acción se inicia cuando se suelta una tecla. Utilice el método Key.getCode para
recuperar información sobre la última tecla presionada.
sentencia(s)
Las instrucciones que se van a ejecutar cuando tiene lugar eventoRatón.
Descripción
Controlador de eventos; desencadena acciones definidas para una instancia específica de un clip
de película.
Ejemplo
La sentencia siguiente incluye el script de un archivo externo cuando se exporta la película; las
acciones del script incluido se ejecutan cuando se carga el clip de película al que están asociadas:
onClipEvent(load) {
#include "myScript.as"
}
376
El ejemplo siguiente utiliza onClipEvent con el evento de película keyDown. El evento de película
keyDown se utiliza habitualmente junto con uno o más métodos y propiedades asociadas con el
objeto Key. En el script siguiente se utiliza el método Key.getCode para averiguar qué tecla ha
presionado el usuario: si la tecla presionada coincide con la propiedad Key.RIGHT, la película se
envía al fotograma siguiente; si la tecla presionada coincide con la propiedad Key.LEFT, la película
se envía 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 película mouseMove. Las propiedades
_xmouse e _ymouse realizan un seguimiento de la posición del ratón cada vez que se mueve.
onClipEvent(mouseMove) {
stageX=_root.xmouse;
stageY=_root.ymouse;
}
Véase también
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(eventoRatón) {
sentencia(s);
}
Parámetros
Las instrucciones que se van a ejecutar cuando tiene lugar eventoRatón.
sentencia(s)
Un eventoRatón es un desencadenante denominado “evento”. Cuando el evento tiene lugar, se
ejecutan las sentencias entre llaves que van a continuación del mismo. Puede especificarse
cualquiera de los valores siguientes para el parámetro eventoRatón:
•
•
•
press
Se presiona el botón del ratón mientras el puntero se encuentra sobre el botón.
release
Se suelta el botón del ratón mientras el puntero se encuentra sobre el botón.
releaseOutside Se suelta el botón del ratón mientras el puntero está fuera del botón
después de haber presionado el botón mientras el puntero estaba dentro del botón.
•
•
•
rollOut
•
dragOver Mientras el puntero se encuentra sobre el botón, se ha presionado el botón del
ratón, se ha desplazado fuera del botón y, a continuación, se ha vuelto a desplazar sobre el
botón.
•
keyPress (“tecla”)
rollOver
El puntero se desplaza fuera del área del botón.
El puntero del ratón se desplaza sobre el botón.
Mientras el puntero se encuentra sobre el botón, se presiona el botón del ratón y
después se desplaza fuera del área del botón.
dragOut
Se presiona la tecla especificada. La parte tecla del parámetro se
especifica mediante cualquiera de los códigos de tecla que se enumeran en el apéndice C,
“Teclas del teclado y valores de códigos de tecla”, de la publicación Utilización de Flash o
cualquiera de las constantes de tecla que se enumeran en el Resumen de las propiedades del
objeto Key.
Descripción
Controlador de eventos; especifica el evento de ratón o las teclas que desencadenan una acción.
Ejemplo
En el script siguiente, la acción startDrag se ejecuta cuando se presiona el ratón y el script
condicional se ejecuta cuando se suelta el ratón y el objeto.
on(press) {
startDrag("rabbit");
}
on(release) {
trace(_root.rabbit._y);
trace(_root.rabbit._x);
stopDrag();
}
Véase también
onClipEvent
378
or
Disponibilidad
Flash 4. Este operador se ha desestimado; se recomienda utilizar el operador || (OR lógico).
Sintaxis
condición1 or condición2
Parámetros
condición1,2
Una expresión que da como resultado true o false.
Valor devuelto
Ninguno.
Descripción
Operador; calcula el resultado de condición1 y condición2 y si cualquiera de las condiciones es
true, toda la expresión será true.
Véase también
|| (OR lógico), | (OR en modo bit)
ord
Disponibilidad
Flash Player 4. Esta función se ha desestimado; se recomienda utilizar los métodos y las
propiedades de String (objeto).
Sintaxis
ord(carácter)
Parámetros
carácter
El carácter que se convierte en un número de código ASCII.
Valor devuelto
Ninguno.
Descripción
Función de cadena; convierte los caracteres en números de código ASCII.
Véase también
String (objeto)
Diccionario de ActionScript 379
_parent
Disponibilidad
Flash Player 4.
Sintaxis
_parent.property
_parent._parent.property
Descripción
Propiedad; especifica o devuelve una referencia al clip de película que contiene el objeto o el clip
de película. El objeto actual es el objeto que contiene el código de ActionScript que hace
referencia a _parent. Utilice _parent para especificar una ruta relativa a los clips de película u
objetos que están por encima del clip de película u objeto actual.
Ejemplo
En el ejemplo siguiente, el clip de película desk es un elemento secundario del clip de película
classroom. Cuando el script siguiente se ejecuta dentro del clip de película desk, la cabeza
lectora saltará al fotograma 10 de la línea de tiempo del clip de película classroom.
_parent.gotoAndStop(10);
Véase también
_root, targetPath
parseFloat
Disponibilidad
Flash Player 5.
Sintaxis
parseFloat(cadena)
Parámetros
cadena
La cadena que debe leerse y convertirse en un número de coma flotante.
Valor devuelto
Ninguno.
Descripción
Función; convierte una cadena en un número de coma flotante. La función lee, o analiza, y
devuelve los números de una cadena, hasta que encuentra un carácter que no es parte del número
inicial. Si la cadena no empieza por un número que puede analizarse, parseFloat devuelve NaN.
El espacio en blanco que precede a los números enteros válidos se ignora, al igual que los
caracteres no numéricos finales.
380
Ejemplo
El ejemplo siguiente utiliza la función parseFloat para calcular el valor de varios tipos de números.
parseFloat("-2")
devuelve -2
parseFloat("2.5")
devuelve 2.5
parseFloat("3.5e6")
devuelve 3.5e6, o 3500000
parseFloat("foobar")
parseFloat(" 5.1")
devuelve NaN
devuelve 5.1
parseFloat("3.75math")
devuelve 3.75
parseFloat("0garbage")
devuelve 0
parseInt
Disponibilidad
Flash Player 5.
Sintaxis
parseInt(expresión, [base])
Parámetros
expresión
Una cadena que se convierte en un número entero.
Un número entero que representa la base del número que se va a analizar. Los valores
válidos van de 2 a 36. Este parámetro es opcional.
base
Valor devuelto
Ninguno.
Descripción
Función; convierte una cadena en un número entero. Si la cadena especificada en los parámetros
no puede convertirse en un número, la función devuelve NaN. Los números enteros que empiezan
por 0 o que especifican una base 8 se interpretan como números octales. Las cadenas que
empiezan por 0x se interpretan como números hexadecimales. El espacio en blanco que precede a
los números enteros válidos se ignora, al igual que los caracteres no numéricos finales.
Ejemplo
El ejemplo siguiente utiliza la función parseInt para calcular el valor de varios tipos de números.
parseInt("3.5")
// devuelve 3.5
parseInt("bar")
// devuelve NaN
parseInt("4foo")
// devuelve 4
A continuación, se muestran ejemplos de conversiones hexadecimales:
parseInt("0x3F8")
// devuelve 1016
parseInt("3E8", 16)
// devuelve 1000
Diccionario de ActionScript 381
A continuación, se muestran ejemplos de una conversión binaria:
parseInt("1010", 2)
// devuelve 10 (la representación decimal del binario 1010)
A continuación, se muestra un ejemplo de análisis de números octales (en este caso el número
octal se identifica por la base, 8):
parseInt("777", 8)
// devuelve 511 (la presentación decimal del octal 777)
play
Disponibilidad
Flash 2.
Sintaxis
play()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Acción; desplaza la cabeza lectora hacia delante en la línea de tiempo.
Ejemplo
El código 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 acción play y la cabeza lectora avanza en la
línea de tiempo. Si el usuario introduce un valor distinto a Alberto, la película 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()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
382
Descripción
Acción; envía 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 botón que tiene asociado el controlador siguiente, la cabeza
lectora se envía al fotograma anterior.
on(release) {
prevFrame();
}
Véase también
MovieClip.prevFrame
prevScene
Disponibilidad
Flash 2.
Sintaxis
prevScene()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Acción; envía la cabeza lectora al fotograma 1 de la escena anterior y la detiene.
Véase también
nextScene
Diccionario de ActionScript 383
print
Disponibilidad
Flash Player 4.20.
Sintaxis
print (nivel)
print (nivel, "Recuadro de delimitación")
print ("destino")
print ("destino", "Recuadro de delimitación")
printAsBitmap (nivel)
printAsBitmap (nivel, "Recuadro de delimitación")
printAsBitmap ("destino")
printAsBitmap ("destino", "Recuadro de delimitación")
Parámetros
print En modo Normal en el panel Acciones, seleccione Como vectores para imprimir los
fotogramas que no contienen imágenes 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
imágenes de mapas de bits, transparencias o efectos de color. Si selecciona el parámetro Print Como
mapa de bits, la sintaxis AsBitmap se adjunta a la acción print del panel Acciones.
nivel Nivel de Flash Player que se imprimirá. En el panel Acciones en modo Normal, si
selecciona un nivel, la acción 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 película 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 película, asigne una etiqueta de fotograma #p a dichos
fotogramas.
Modificador que define el área de impresión de la película. Este
parámetro es opcional. Puede elegir uno de los parámetros siguientes:
Recuadro de delimitación
•
Designa el recuadro de delimitación de un fotograma específico de una película
como el área de impresión para todos los fotogramas imprimibles de la película. Asigne una
etiqueta de fotograma #b al fotograma cuyo recuadro de delimitación desee utilizar como área
de impresión.
•
bmax
•
bframe Designa que se utilice el recuadro de delimitación de cada fotograma imprimible
como área de impresión para ese fotograma. Esto cambia el área de impresión para cada
fotograma y modifica la escala de los objetos para que quepan en el área de impresión. Utilice
bframe si tiene objetos de diferentes tamaños en cada fotograma y desea que cada objeto
rellene la página impresa.
bmovie
Designa como área de impresión un compuesto de todos los recuadros de delimitación
de todos los fotogramas imprimibles. Especifique el parámetro bmax cuando los fotogramas
imprimibles de la película varíen de tamaño.
Valor devuelto
Ninguno.
384
Descripción
Acción; imprime el clip de película de destino según los límites especificados en el parámetro
(bmovie, bmax o bframe). Si desea imprimir determinados fotogramas de la película de destino,
adjunte una etiqueta de fotograma #P a dichos fotogramas. Aunque la acción print produce
impresiones de más alta calidad que la acción printAsBitmap, no puede utilizarse para imprimir
películas que utilizan transparencias alfa o efectos especiales de color.
Si no especifica el parámetro para el límite de impresión, el área de impresión se determina de
modo predeterminado por el tamaño del escenario de la película cargada. La película no hereda el
tamaño del escenario de la película principal. Puede controlar el área de impresión especificando
los parámetros bmovie, bmax o bframe.
Todos los elementos imprimibles de una película deben estar cargados por completo antes de que
pueda comenzar la impresión.
La función de impresión 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 película
myMovie con el área de impresión definida por el recuadro de delimitación 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
impresión definida por el recuadro de delimitación de cada fotograma:
print("myMovie","bframe");
Véase también
printNum, printAsBitmap, printAsBitmapNum
printAsBitmap
Disponibilidad
Flash Player 4.20.
Sintaxis
printAsBitmap(destino, "Recuadro de delimitación")
Parámetros
destino El nombre de instancia del clip de película que se va a imprimir. De modo
predeterminado, se imprimen todos los fotogramas de la película. Si desea imprimir determinados
fotogramas de la película, adjunte una etiqueta de fotograma #P a dichos fotogramas.
Recuadro de delimitación Modificador que define el área de impresión de la película. Puede
elegir uno de los parámetros siguientes:
•
Designa el recuadro de delimitación de un fotograma específico de una película
como el área de impresión para todos los fotogramas imprimibles de la película. Asigne una
etiqueta de fotograma #b al fotograma cuyo recuadro de delimitación desee utilizar como área
de impresión.
•
bmax
bmovie
Designa como área de impresión un compuesto de todos los recuadros de delimitación
de todos los fotogramas imprimibles. Especifique el parámetro bmax cuando los fotogramas
imprimibles de la película varíen de tamaño.
Diccionario de ActionScript 385
•
bframe Designa que se utilice el recuadro de delimitación de cada fotograma imprimible
como área de impresión para ese fotograma. Esto cambia el área de impresión para cada
fotograma y modifica la escala de los objetos para que quepan en el área de impresión. Utilice
bframe si tiene objetos de diferentes tamaños en cada fotograma y desea que cada objeto
rellene la página impresa.
Valor devuelto
Ninguno.
Descripción
Acción; imprime el clip de película de destino como un mapa de bits. Utilice la acción
printAsBitmap para imprimir películas que contienen fotogramas con objetos que utilizan
transparencias o efectos de color. La acción printAsBitmap imprime con la más alta resolución
disponible para mantener la mayor calidad y definición.
Si su película no contiene transparencias alfa o efectos de color, se recomienda que utilice la acción
para obtener una mejor calidad.
print
De modo predeterminado, el área de impresión está determinada por el tamaño del escenario de
la película cargada. La película no hereda el tamaño del escenario de la película principal. Puede
controlar el área de impresión especificando los parámetros bmovie, bmax o bframe.
Todos los elementos imprimibles de una película deben estar cargados por completo antes de que
pueda comenzar la impresión.
La función de impresión de Flash Player admite impresoras PostScript y no PostScript. Las
impresoras no PostScript convierten vectores en mapas de bits.
Véase también
print, printAsBitmapNum, printNum
printAsBitmapNum
Disponibilidad
Flash Player 5.
Sintaxis
printAsBitmapNum(nivel)
printAsBitmapNum(nivel, "Recuadro de delimitación")
Parámetros
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.
nivel
Modificador que define el área de impresión de la película. Este
parámetro es opcional. Puede elegir uno de los parámetros siguientes:
Recuadro de delimitación
386
•
Designa el recuadro de delimitación de un fotograma específico de una película
como el área de impresión para todos los fotogramas imprimibles de la película. Asigne una
etiqueta de fotograma #b al fotograma cuyo recuadro de delimitación desee utilizar como área
de impresión.
•
bmax
bmovie
Designa como área de impresión un compuesto de todos los recuadros de delimitación
de todos los fotogramas imprimibles. Especifique el parámetro bmax cuando los fotogramas
imprimibles de la película varíen de tamaño.
•
bframe Designa que se utilice el recuadro de delimitación de cada fotograma imprimible
como área de impresión para ese fotograma. Esto cambia el área de impresión para cada
fotograma y modifica la escala de los objetos para que quepan en el área de impresión. Utilice
bframe si tiene objetos de diferentes tamaños en cada fotograma y desea que cada objeto
rellene la página impresa.
Valor devuelto
Ninguno.
Descripción
Acción; imprime un nivel de Flash Player como mapa de bits. Utilice la acción
printAsBitmapNum para imprimir películas que contienen fotogramas con objetos que utilizan
transparencias o efectos de color. La acción printAsBitmapNum imprime con la más alta
resolución disponible para mantener la mayor calidad y definición. Para calcular el tamaño de
archivo imprimible de un fotograma designado para impresión como un mapa de bits,
multiplique la anchura en píxeles por la altura en píxeles por la resolución de la impresora.
Si su película no contiene transparencias alfa o efectos de color, se recomienda que utilice la acción
printNum para obtener una mejor calidad.
De modo predeterminado, el área de impresión está determinada por el tamaño del escenario de
la película cargada. La película no hereda el tamaño del escenario de la película principal. Puede
controlar el área de impresión especificando los parámetros bmovie, bmax o bframe.
Todos los elementos imprimibles de una película deben estar cargados por completo antes de que
pueda comenzar la impresión.
La función de impresión de Flash Player admite impresoras PostScript y no PostScript. Las
impresoras no PostScript convierten vectores en mapas de bits.
Véase también
print, printAsBitmap, printNum
printNum
Disponibilidad
Flash Player 5.
Sintaxis
printNum (nivel, "Recuadro de delimitación")
Parámetros
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.
nivel
Recuadro de delimitación Modificador que define el área de impresión de la película. Puede
elegir uno de los parámetros siguientes:
•
Designa el recuadro de delimitación de un fotograma específico de una película como
el área de impresión para todos los fotogramas imprimibles de la película. Asigne una etiqueta de
fotograma #b al fotograma cuyo recuadro de delimitación desee utilizar como área de impresión.
bmovie
Diccionario de ActionScript 387
•
bmax
•
bframe Designa que se utilice el recuadro de delimitación de cada fotograma imprimible
como área de impresión para ese fotograma. Esto cambia el área de impresión para cada
fotograma y modifica la escala de los objetos para que quepan en el área de impresión. Utilice
bframe si tiene objetos de diferentes tamaños en cada fotograma y desea que cada objeto
rellene la página impresa.
Designa como área de impresión un compuesto de todos los recuadros de delimitación
de todos los fotogramas imprimibles. Especifique el parámetro bmax cuando los fotogramas
imprimibles de la película varíen de tamaño.
Valor devuelto
Ninguno.
Descripción
Acción; imprime el nivel de Flash Player de acuerdo con los límites especificados en el parámetro
Recuadro de delimitación ("bmovie", "bmax", "bframe"). Si desea imprimir determinados
fotogramas de la película de destino, adjunte una etiqueta de fotograma #P a dichos fotogramas.
Aunque con la acción printNum se obtienen impresiones de mayor calidad que con la acción
printAsBitmapNum, no se puede utilizar la acción printNum para imprimir películas con
transparencias alfa o efectos de color especiales.
Si no especifica el parámetro para el límite de impresión, el área de impresión se determina de
modo predeterminado por el tamaño del escenario de la película cargada. La película no hereda el
tamaño del escenario de la película principal. Puede controlar el área de impresión especificando
los parámetros bmovie, bmax o bframe.
Todos los elementos imprimibles de una película deben estar cargados por completo antes de que
pueda comenzar la impresión.
La función de impresión de Flash Player admite impresoras PostScript y no PostScript. Las
impresoras no PostScript convierten vectores en mapas de bits.
Véase también
print, printAsBitmap, printAsBitmapNum
388
_quality
Disponibilidad
Flash Player 5.
Sintaxis
_quality
Descripción
Propiedad (global); establece o recupera la calidad de representación utilizada para una película.
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"
•
"HIGH"
•
"BEST"
Calidad de representación baja. No se suavizan ni los gráficos ni los mapas de bits.
Calidad de representación media. Los gráficos se suavizan con una cuadrícula de
2x2, en píxeles, pero los mapas de bits no se suavizan. Apropiado para películas que no
contienen texto.
"MEDIUM"
Calidad de representación alta. Los gráficos se suavizan con una cuadrícula de 4x4,
en píxeles, y los mapas de bits se suavizan si la película es estática. Esta es la configuración de la
calidad de representación predeterminada utilizada por Flash.
Calidad de representación muy alta. Los gráficos se suavizan con una cuadrícula de
4x4, en píxeles, y los mapas de bits se suavizan siempre.
Ejemplo
En el ejemplo siguiente, se define la calidad de representación en LOW:
_quality = "LOW";
Véase también
_highquality, toggleHighQuality
random
Disponibilidad
Flash Player 4. Esta función se ha desestimado en Flash 5; se recomienda la utilización del método
Math.random.
Sintaxis
random(valor)
Parámetros
valor
Un número entero.
Valor devuelto
Un número entero.
Descripción
Función; devuelve un entero aleatorio entre 0 y un número menos que el entero especificado en el
parámetro valor.
Diccionario de ActionScript 389
Ejemplo
La utilización de la función random que se muestra a continuación devuelve el valor 0, 1, 2, 3 ó 4.
random(5);
Véase también
Math.random
removeMovieClip
Disponibilidad
Flash Player 4.
Sintaxis
removeMovieClip(destino)
Parámetros
destino Ruta de destino de una instancia de clip de película creada con la acción
duplicateMovieClip, o nombre de instancia de un clip de película creado con los métodos
attachMovie o duplicateMovieClip del objeto MovieClip.
Valor devuelto
Ninguno.
Descripción
Acción; elimina una instancia de clip de película creada con los métodos attachMovie o
duplicateMovieClip del objeto MovieClip o con la acción duplicateMovieClip.
Véase también
duplicateMovieClip, MovieClip.duplicateMovieClip, MovieClip.attachMovie,
MovieClip.removeMovieClip
return
Disponibilidad
Flash Player 5.
Sintaxis
return[expresión]
return
Parámetros
Número, cadena, matriz u objeto cuyo valor se debe calcular y devolver como valor
de la función. Este parámetro es opcional.
expresión
Valor devuelto
El parámetro expresión calculado, si se proporciona.
Descripción
Acción; especifica el valor devuelto por una función. La acción return calcula el valor del
parámetro expresión y devuelve el resultado como valor de la función en que se ejecuta. La
acción return hace que la función 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 acción return dentro del cuerpo de la función sum para
devolver el valor agregado de los tres parámetros. La línea de código siguiente llama a la función
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);
// envía 114 a la ventana Salida
Véase también
function
_root
Disponibilidad
Flash Player 4.
Sintaxis
_root.clipPelícula
_root.acción
_root.propiedad
Parámetros
clipPelícula
acción
Nombre de instancia de un clip de película.
Una acción o un método.
propiedad
Una propiedad del objeto MovieClip.
Descripción
Propiedad; especifica o devuelve una referencia a la línea de tiempo de la película raíz. Si una
película tiene varios niveles, la línea de tiempo de la película raíz 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 notación con barras (/) para especificar una ruta
absoluta dentro del nivel actual.
Ejemplo
El ejemplo siguiente detiene la línea de tiempo del nivel que contiene el script que se está ejecutando:
_root.stop();
El ejemplo siguiente envía la línea de tiempo del nivel actual al fotograma 3.
_root.gotoAndStop(3);
Véase también
_parent, targetPath
391
scroll
Disponibilidad
Flash Player 4.
Sintaxis
textFieldVariableName.scroll = x
Descripción
Propiedad; propiedad desestimada que controla la visualización de la información en un campo
de texto asociado con una variable. La propiedad scroll define dónde 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 párrafo específico en un pasaje largo, o para crear campos de texto
con desplazamiento. Esta propiedad puede recuperarse y modificarse.
Ejemplo
El código siguiente está asociado a un botón Arriba que desplaza el contenido del campo de texto
myText:
on (release) {
myText.scroll = myText.scroll + 1;
}
Véase también
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 película Flash. El campo de texto seleccionado es el campo en el que está el cursor. Los índices
de espacio de selección tienen base cero (por ejemplo, la primera posición es 0, la segunda 1, etc.).
No existe ningún método constructor para el objeto Selection, ya que sólo puede haber un campo
seleccionado al mismo tiempo.
Resumen de los métodos del objeto Selection
Método
Descripción
Selection.addListener
Registra un objeto para que reciba una notificación cuando se invoque el método
onSetFocus.
Selection.getBeginIndex
Devuelve el índice al principio del espacio de selección. Devuelve –1 si no hay
índice o campo seleccionado actualmente.
Selection.getCaretIndex
Devuelve la posición de intercalación actual en el espacio de selección
actualmente seleccionado. Devuelve –1 si no hay posición de intercalación o
espacio de selección seleccionado.
Selection.getEndIndex
Devuelve el índice al final del espacio de selección. Devuelve –1 si no hay índice o
campo seleccionado actualmente.
Selection.getFocus
Devuelve el nombre de la variable para el campo de texto seleccionado.
Devuelve el valor null si no hay ningún campo de texto seleccionado.
Selection.removeListener
Elimina un objeto registrado con addListener.
Selection.setFocus
Selecciona el campo de texto asociado con la variable especificada en el
parámetro.
Selection.setSelection
Establece los índices de inicio y fin del espacio de selección.
Resumen de los detectores para el objeto Selection
Método
Descripción
Selection.onSetFocus
Recibe notificación cuando cambia la selección de entrada.
393
Selection.addListener
Disponibilidad
Flash Player 6.
Sintaxis
Selection.addListener(nuevoDetector)
Parámetros
nuevoDetector
Un objeto con un método onSetFocus.
Valor devuelto
Ninguno.
Descripción
Método; registra un objeto para que reciba notificaciones de cambio de selección de teclado.
Cuando cambia la selección (por ejemplo, siempre que se invoca el método
Selection.SetFocus), todos los objetos de detección registrados con addListener tienen su
método onSetFocus invocado. Varios objetos pueden detectar notificaciones de cambio de la
selección. Si el detector nuevoDetector ya está registrado, no se produce ningún cambio.
Selection.getBeginIndex
Disponibilidad
Flash Player 5.
Sintaxis
Selection.getBeginIndex()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve el índice al principio del espacio de selección. Si no existe ningún índice o no
hay ningún campo de texto seleccionado, el método devuelve -1. Los índices de espacio de
selección tienen base cero (por ejemplo, la primera posición es 0, la segunda 1, etc.).
394
Selection.getCaretIndex
Disponibilidad
Flash Player 5.
Sintaxis
Selection.getCaretIndex()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve el índice de la posición del cursor que parpadea. Si no aparece ningún cursor
parpadeando, el método devuelve -1. Los índices de espacio de selección tienen base cero (por
ejemplo, la primera posición es 0, la segunda 1, etc.).
Selection.getEndIndex
Disponibilidad
Flash Player 5.
Sintaxis
Selection.getEndIndex()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve el índice al final del espacio de selección actualmente seleccionado. Si no existe
ningún índice o no hay ningún espacio de selección seleccionado, el método devuelve -1. Los
índices de espacio de selección tienen base cero (por ejemplo, la primera posición 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()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
395
Descripción
Método; devuelve el nombre de variable del campo de texto que está seleccionado. Si no hay
ningún campo de texto seleccionado, el método devuelve el valor null. Si el elemento
seleccionado corresponde a un botón 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 botón seleccionado actualmente es un botón de clip de película, Selection.getFocus
devuelve la ruta de destino del botón de clip de película. 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(selecciónAntigua, selecciónNueva){
sentencias;
}
Descripción
Detector; recibe notificación cuando cambia la selección de entrada. Para utilizar onSetFocus,
debe crear un objeto detector. A continuación, puede definir una función para onSetFocus y
utilizar el método 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 código cooperen, ya que varios detectores
pueden recibir notificaciones sobre un mismo evento.
Véase también
Selection.addListener
Selection.removeListener
Disponibilidad
Flash Player 6.
Sintaxis
Selection.removeListener(detector)
Parámetros
detector
Objeto que ya no recibirá notificaciones sobre el elemento seleccionado.
Valor devuelto
Si el detector se ha eliminado correctamente, el método 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 método devuelve el valor false.
Descripción
Método; 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 sólo funcionan en
Flash Player 6.
Sintaxis
Selection.setFocus(“rutaVariable”)
Parámetros
rutaVariable
Cadena que especifica la ruta para el nombre de una variable asociada con un
campo de texto.
Valor devuelto
Un evento.
Descripción
Método; selecciona el campo de texto editable asociado con la variable especificada por
rutaVariable. El parámetro rutaVariable debe ser un literal de cadena de la ruta a dicha
variable. Para especificar la ruta, puede utilizar notación con puntos o con barras. Además, puede
utilizar una ruta relativa o absoluta.
Si se pasa una ruta de destino de una instancia de botón como parámetro rutaVariable, se
selecciona dicho botón. Si se pasa un ruta de destino de una instancia de campo de texto como
parámetro rutaVariable, se selecciona dicho campo de texto. Si se pasa el valor null, el
elemento seleccionado se elimina.
Si se pasa un botón de clip de película a Selection.setFocus, el botón se selecciona. Si se
especifica un objeto TextField, éste se selecciona. Si se especifica un objeto Button, éste pasa a ser
el botón seleccionado.
Ejemplo
En el ejemplo siguiente, el elemento seleccionado es un campo de texto de la línea de tiempo
principal asociada con la variable myVar. El parámetro rutaVariable es una ruta absoluta, de
modo que puede llamar la acción desde cualquier línea de tiempo.
Selection.setFocus("_root.myVar");
En el ejemplo siguiente, el campo de texto asociado con myVar se encuentra en un clip de película
llamado myClip en la línea 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)
Parámetros
inicio
final
Índice de inicio del espacio de selección.
Índice de final del espacio de selección.
397
Valor devuelto
Ninguno.
Descripción
Método; establece el espacio de selección del campo de texto seleccionado actualmente. El nuevo
espacio de selección comenzará en el índice especificado en el parámetro inicio y finalizará en el
índice especificado en el parámetro final. Los índices de espacio de selección tienen base cero
(por ejemplo, la primera posición es 0, la segunda 1, etc.). Este método no tiene efecto si no existe
campo de texto seleccionado actualmente.
set variable
Disponibilidad
Flash Player 4.
Sintaxis
set(variable, expresión)
Parámetros
variable
Identificador que alberga el valor del parámetro expresión.
expresión
Valor asignado a la variable.
Valor devuelto
Ninguno.
Descripción
Acción; asigna un valor a una variable. Una variable es un contenedor que almacena información.
El contenedor en sí es siempre el mismo, pero el contenido puede cambiar. La modificación del
valor de una variable a medida que se reproduce la película permite registrar y guardar
información sobre las acciones del usuario, registrar valores que se modifican conforme se
reproduce la película o comprobar si una determinada condición es true o false.
Las variables pueden albergar cualquier tipo de datos (por ejemplo, cadenas, números, valores
booleanos, objetos o clips de película). La línea de tiempo de cada película y cada clip de película
tiene su propio juego de variables, y cada variable tiene su propio valor independiente de variables
en otras líneas de tiempo.
ActionScript es un lenguaje que asigna el tipo de las variables de forma dinámica. Cada variable
tiene un tipo. El tipo se asigna en tiempo de ejecución y puede cambiar durante la ejecución. Esto
no ocurre en el caso de lenguajes que asignan el tipo de las variables de forma estática, como Java
o C++, en los que el tipo se asigna en tiempo de compilación y no puede cambiar durante el
tiempo de ejecución.
398
Ejemplo
Este ejemplo establece una variable llamada orig_x_pos que almacena la posición original del eje
x del clip de película barco para poder restablecer el barco a su posición de inicio más adelante en
la película.
on(release) {
set(orig_x_pos, getProperty ("barco", _x ));
}
El código anterior produce el mismo resultado que el código siguiente:
on(release) {
orig_x_pos = barco._x;
}
Véase también
var, call
setInterval
Disponibilidad
Flash Player 6.
Sintaxis
setInterval( función, intervalo[, arg1, arg2, ..., argn] )
setInterval( objeto, nombreMétodo, intervalo[, arg1, arg2, ..., argn] )
Parámetros
Nombre de función o referencia a una función anónima.
función
objeto
Objeto derivado del objeto Object.
nombreMétodo
Nombre del método al que debe llamarse en el parámetro objeto.
Tiempo entre llamada y llamada al parámetro función o nombreMétodo, expresado
en milisegundos.
intervalo
arg1, arg2, ..., argn
nombreMétodo.
Parámetros opcionales pasados al parámetro función o
Valor devuelto
Identificador de intervalo que se puede pasar a clearInterval para cancelar el intervalo.
Descripción
Acción; llama a una función, a un método o a un objeto con una periodicidad determinada
mientras se reproduce la película. Puede utilizar una función de intervalo para actualizar variables
desde una base de datos o actualizar una visualización de tiempo.
Si el intervalo es menor que la velocidad de fotogramas de la película (por ejemplo, 10 fotogramas
por segundo (fps) equivalen a 100 milisegundos), se llama a la función de intervalo tan cerca del
intervalo como sea posible. Debe utilizar la función updateAfterEvent para asegurarse de que la
pantalla se actualiza con suficiente frecuencia. Si el intervalo es mayor que la velocidad de
fotogramas de la película, sólo se llama a la función 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 función
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 función anónima 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 función setInterval envían la cadena "intervalo llamado" a la ventana
Salida cada 1.000 milisegundos. La primera llamada a setInterval llama a la función
callback1, que contiene una acción trace. La segunda llamada a setInterval pasa la cadena
"intervalo llamado" a la función callback2 como parámetro.
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 método de un objeto. Si desea llamar a un método
definido para un objeto, debe utilizar esta sintaxis. Esta sintaxis sólo se puede utilizar en modo
Experto.
obj = new Object();
obj.interval = function() {
trace("función de intervalo llamada");
}
setInterval( obj, "intervalo", 1000 );
obj2 = new Object();
obj2.interval = function(s) {
trace(s);
}
setInterval( obj2, "intervalo", 1000, "función de intervalo llamada" );
Para llamar a un método de un objeto, debe utilizar la segunda forma de la sintaxis de
setInterval, tal como se indica a continuación:
setInterval( obj2, "intervalo", 1000, "función de intervalo llamada" );
Véase también
clearInterval, updateAfterEvent
400
setProperty
Disponibilidad
Flash Player 4.
Sintaxis
setProperty("destino", propiedad, valor/expresión)
Parámetros
Ruta al nombre de instancia del clip de película cuya propiedad debe establecerse.
destino
propiedad
valor
Propiedad que debe establecerse.
Nuevo valor literal de la propiedad.
expresión
Ecuación que da como resultado el nuevo valor de la propiedad.
Valor devuelto
Ninguno.
Descripción
Acción; cambia un valor de propiedad de un clip de película a medida que se reproduce la
película.
Ejemplo
Esta sentencia establece la propiedad _alpha de un clip de película llamado estrella en el 30%
cuando se hace clic en el botón.
on(release) {
setProperty("estrella", _alpha, "30");
}
Véase también
getProperty
Sound (objeto)
El objeto Sound permite controlar el sonido de una película. Puede agregar sonidos a un clip de
película desde la biblioteca mientras se reproduce la película y controlar estos sonidos. Si no
especifica un destino al crear un nuevo objeto Sound, puede utilizar los métodos para controlar
el sonido de toda la película. Debe utilizar el constructor new Sound para crear una instancia del
objeto Sound antes de llamar a los métodos del objeto Sound.
El objeto Sound se admite en Flash Player 5 y Flash Player 6.
Resumen de los métodos del objeto Sound
Método
Descripción
Sound.attachSound
Asocia el sonido especificado en el parámetro.
Sound.getBytesLoaded
Devuelve el número de bytes cargados para el sonido especificado.
Sound.getBytesTotal
Devuelve el tamaño del sonido en bytes.
Sound.getPan
Devuelve el valor de la llamada setPan anterior.
Sound.getTransform
Devuelve el valor de la llamada setTransform anterior.
401
Método
Descripción
Sound.getVolume
Devuelve el valor de la llamada setVolume anterior.
Sound.loadSound
Carga un archivo MP3 en Flash Player.
Sound.setPan
Establece el balance izquierda/derecha del sonido.
Sound.setTransform
Establece el valor de cada canal, izquierdo y derecho, que debe reproducirse en
cada altavoz.
Sound.setVolume
Establece el nivel de volumen de un sonido.
Sound.start
Comienza a reproducir un sonido desde el principio u opcionalmente desde un
punto de desplazamiento establecido en el parámetro.
Sound.stop
Detiene el sonido especificado o todos los sonidos que se están reproduciendo
actualmente.
Resumen de las propiedades del objeto Sound
Método
Descripción
Sound.duration
Duración de un sonido en milisegundos.
Sound.position
Número de milisegundos durante los que se ha reproducido el sonido.
Resumen del controlador de eventos del objeto Sound
Método
Descripción
Sound.onLoad
Se invoca cuando se carga un sonido.
Sound.onSoundComp
lete
Se invoca cuando se detiene la reproducción de un sonido.
Constructor del objeto Sound
Disponibilidad
Flash Player 5.
Sintaxis
new Sound([destino])
Parámetros
destino
Instancia de clip de película en la que opera el objeto Sound. Este parámetro es
opcional.
Valor devuelto
Ninguno.
Descripción
Constructor; crea un nuevo objeto Sound para un clip de película especificado. Si no se especifica
una instancia de destino, el objeto Sound controla todos los sonidos de la película.
402
Ejemplo
En el ejemplo siguiente se crea una nueva instancia del objeto Sound denominada GlobalSound.
La segunda línea llama al método setVolume y ajusta el volumen de todos los sonidos de la
película 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 película
de destino myMovie y se llama al método start, que inicia cualquier sonido en myMovie.
moviesound = new Sound(myMovie);
moviesound.start();
Sound.attachSound
Disponibilidad
Flash Player 5.
Sintaxis
mySound.attachSound("idNombre")
Parámetros
Identificador de un sonido exportado en la biblioteca. El identificador se encuentra
en el cuadro de diálogo Propiedades de vínculos de símbolos.
idNombre
Valor devuelto
Ninguno.
Descripción
Método; asocia el sonido especificado en el parámetro idNombre al objeto Sound especificado. El
sonido debe estar en la biblioteca de la película actual y debe estar especificado para la exportación
en el cuadro de diálogo Propiedades de vínculos de símbolos. Debe llamar a Sound.start para
comenzar a reproducir el sonido.
Véase también
Sound.start
Sound.duration
Disponibilidad
Flash Player 6.
Sintaxis
mySound.duration
Descripción
Propiedad (sólo lectura); duración de un sonido en milisegundos.
403
Sound.getBytesLoaded
Disponibilidad
Flash Player 6.
Sintaxis
Sound.getBytesLoaded()
Parámetros
Ninguno.
Valor devuelto
Entero que indica el número de bytes cargados.
Descripción
Método; devuelve el número 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.
Véase también
Sound.getBytesTotal
Sound.getBytesTotal
Disponibilidad
Flash Player 6.
Sintaxis
Sound.getBytesTotal()
Parámetros
Ninguno.
Valor devuelto
Entero que indica el tamaño total, en bytes, del objeto Sound especificado.
Descripción
Método; devuelve el tamaño, en bytes, del objeto Sound especificado.
Véase también
Sound.getBytesLoaded
404
Sound.getPan
Disponibilidad
Flash Player 5.
Sintaxis
mySound.getPan();
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; devuelve el nivel de panorámica 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 configuración de panorámica controla el balance izquierda-derecha de los
sonidos actuales y futuros de una película.
Este método es acumulativo con los métodos setVolume o setTransform.
Véase también
Sound.setPan
Sound.getTransform
Disponibilidad
Flash Player 5.
Sintaxis
mySound.getTransform();
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; devuelve la información de transformación de sonido para el objeto Sound especificado
con la última llamada setTransform.
Véase también
Sound.setTransform
405
Sound.getVolume
Disponibilidad
Flash Player 5.
Sintaxis
mySound.getVolume()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; devuelve el nivel de volumen de sonido como un número entero de 0 a 100, donde 0 es
apagado y 100 es a todo volumen. El valor predeterminado es 100.
Véase también
Sound.setVolume
Sound.loadSound
Disponibilidad
Flash Player 6.
Sintaxis
mySound.loadSound("url", deFlujo)
Parámetros
url
Ubicación de un archivo de sonido MP3 en un servidor.
deFlujo
Valor booleano que indica si el sonido es de flujo o de evento.
Valor devuelto
Ninguno.
Descripción
Método; carga un archivo MP3 en una instancia del objeto Sound. Puede utilizar el parámetro
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 métodos y propiedades de este objeto.
Los sonidos de flujo se reproducen mientras se descargan. La reproducción empieza cuando se
han recibido suficientes datos para iniciar el descompresor. Al igual que los sonidos de evento, los
sonidos de flujo sólo 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 = funciónCallback
Parámetros
mySoundObject
funciónCallback
Un objeto Sound.
Una función.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca automáticamente cuando se carga un sonido. Debe crear una
función que se ejecute cuando se invoque el evento onLoad. Puede utilizar una función anónima o
una función con nombre.
Véase también
Sound.onSoundComplete
Sound.onSoundComplete
Disponibilidad
Flash Player 6.
Sintaxis
mySoundObject.onSoundComplete = funciónCallback
Parámetros
mySoundObject
funciónCallback
Un objeto Sound.
Una función.
Valor devuelto
Ninguno.
Descripción
Evento; se invoca automáticamente cuando finaliza la reproducción de un sonido. Puede utilizar
el evento onSoundComplete para desencadenar eventos de una película basándose en la
finalización de un sonido.
Debe crear una función que se ejecute cuando se invoque el evento onSoundComplete. Puede
utilizar una función anónima o una función con nombre.
Ejemplo
Sintaxis 1: en el ejemplo siguiente se utiliza una función anónima:
s = new Sound();
s.attachSound("mySound");
s.onSoundComplete = function() { trace("mySound finalizado"); };
s.start();
407
Sintaxis 2: en el ejemplo siguiente se utiliza una función 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
Parámetros
Ninguno.
Valor devuelto
Número de milisegundos durante los que se ha reproducido el sonido.
Descripción
Propiedad (sólo lectura); devuelve el número de milisegundos durante el que se ha reproducido
un sonido. Si el sonido se repite, la posición se restablecerá en 0 al principio de cada repetición.
Sound.setPan
Disponibilidad
Flash Player 5.
Sintaxis
mySound.setPan(panorámica);
Parámetros
panorámica Número entero que especifica el balance izquierda-derecha de un sonido. Los
valores válidos 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.
Descripción
Método; determina como se reproduce el sonido en los canales izquierdo y derecho (altavoces).
Para los sonidos mono, panorámica determina a través 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. También llama a los métodos 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 después del inicio del sonido y reproducirlo 5 veces
s.start(30, 5);
Véase también
Sound.attachSound, Sound.setPan, Sound.setTransform, Sound.setVolume, Sound.start
Sound.setTransform
Disponibilidad
Flash Player 5.
Sintaxis
mySound.setTransform(soundTransformObject)
Parámetros
soundTransformObject
Objeto creado con el constructor del objeto Object genérico.
Valor devuelto
Ninguno.
Descripción
Método; establece la información de transformación, o de "balance", de sonido para un objeto
Sound.
El parámetro soundTransformObject es un objeto que se crea utilizando el método constructor
del objeto Object genérico con parámetros que especifican cómo 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 estéreo utilizan el doble de datos que los sonidos mono,
normalmente es mejor utilizar sonidos mono de 6 bits a 22 KHz. Puede utilizar el método
setTransform para reproducir sonidos mono como sonidos estéreo, reproducir sonidos estéreo
como sonidos mono y agregar efectos interesantes a los sonidos.
Los parámetros 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 parámetros se representa mediante la fórmula 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 según el tipo del sonido (estéreo o
mono) de la película.
Los sonidos estéreo dividen la entrada del sonido uniformemente entre los altavoces izquierdo y
derecho y de forma predeterminada tienen la configuración de transformación 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 configuración de transformación siguiente:
ll
lr
rr
rl
=
=
=
=
100
100
0
0
Ejemplo
En el ejemplo siguiente se ilustra una configuración que se puede conseguir con el método
setTransform, pero no con los métodos setVolume o setPan, ni siquiera combinándolos.
El código siguiente crea un nuevo objeto soundTransformObject y establece sus propiedades de
modo que el sonido de ambos canales se reproduzca sólo 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 método setTransform del modo siguiente:
mySound.setTransform(mySoundTransformObject);
En el ejemplo siguiente se reproduce un sonido estéreo como sonido mono;
soundTransformObjectMono tiene los parámetros 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 parámetros siguientes.
mySoundTransformObjectHalf = new Object;
mySoundTransformObjectHalf.ll = 50;
mySoundTransformObjectHalf.lr = 0;
mySoundTransformObjectHalf.rr = 100;
mySoundTransformObjectHalf.rl = 50;
setTransform(soundTransformObjectHalf);
Véase también
Constructor del objeto Object.
Sound.setVolume
Disponibilidad
Flash Player 5.
Sintaxis
mySound.setVolume(volumen)
Parámetros
volumen Número 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.
Descripción
Método; 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++);
}
}
Véase también
Sound.setPan, Sound.setTransform
411
Sound.start
Disponibilidad
Flash Player 5.
Sintaxis
mySound.start([desplazamientoSegundos, bucle])
Parámetros
Parámetro opcional que permite iniciar la reproducción del sonido en
un momento específico. Por ejemplo, si tiene un sonido de 30 segundos y desea que el sonido
comience a reproducirse a la mitad, especifique 15 en el parámetro desplazamientoSegundos. El
sonido no se retrasa 15 segundos, sino que comienza a reproducirse en la marca de 15 segundos.
desplazamientoSegundos
Parámetro opcional que permite especificar el número de veces que debe reproducirse el
sonido de manera consecutiva.
bucle
Valor devuelto
Ninguno.
Descripción
Método; comienza a reproducir el último sonido asociado desde el principio, si no se
especifican parámetros, o desde un punto determinado del sonido especificado por el parámetro
desplazamientoSegundos.
Véase también
Sound.stop
Sound.stop
Disponibilidad
Flash Player 5.
Sintaxis
mySound.stop(["idNombre"])
Parámetros
Parámetro opcional que especifica que se detenga la reproducción de un sonido
concreto. El parámetro idNombre debe escribirse entre comillas (" ").
idNombre
Valor devuelto
Ninguno.
Descripción
Método; detiene todos los sonidos que se están reproduciendo actualmente, si no se especifican
parámetros, o solamente el sonido especificado en el parámetro idNombre.
Véase también
Sound.start
412
_soundbuftime
Disponibilidad
Flash Player 4.
Sintaxis
_soundbuftime = entero
Parámetros
entero
Número de segundos antes de que empiece el flujo de la película.
Descripción
Propiedad (global); establece el número 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 métodos y las propiedades de este objeto podrá acceder a información sobre los
límites de una película Flash y manipularla.
El objeto Stage está disponible en Flash Player 6 y versiones posteriores.
Resumen de los métodos del objeto Stage
Método
Descripción
Stage.addListener
Agrega un objeto detector al objeto Stage.
Stage.removeListener
Elimina un objeto detector del objeto Stage.
Resumen de las propiedades del objeto Stage
Método
Descripción
Stage.align
Alineación de la película Flash en el navegador.
Stage.height
Altura del escenario, en píxeles.
Stage.width
Anchura del escenario, en píxeles.
Stage.scaleMode
La escala actual de la película Flash.
Resumen del controlador de eventos del objeto Stage
Método
Descripción
Stage.onResize
Indica que se ha cambiado el tamaño de la película.
413
Stage.addListener
Disponibilidad
Flash Player 6.
Sintaxis
Stage.addListener(myListener)
Parámetros
myListener
Objeto que detecta una notificación de callback del evento onResize.
Valor devuelto
Ninguno.
Descripción
Método; detecta cuándo se cambia el tamaño de una película Flash si Stage.scaleMode =
"noScale". El método addListener no funciona con el valor predeterminado de escala de
película ("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 notificación de un evento cuando éste se desencadena en una película. Los objetos
detectores del objeto Stage reciben notificación de Stage.onResize.
Ejemplo
Este ejemplo crea un nuevo objeto detector denominado myListener. A continuación, utiliza
myListener para llamar al evento onResize y definir una función a la que se llamará cuando se
desencadene el evento onResize. Finalmente, el código agrega el objeto myListener a la lista de
callbacks del objeto Stage. Los objetos detectores permiten que varios objetos detecten
notificaciones de cambio de tamaño.
myListener = new Object();
myListener.onResize = function () { ... }
Stage.addListener(myListener);
414
Stage.align
Disponibilidad
Flash Player 6.
Sintaxis
Stage.align
Descripción
Propiedad; indica la alineación actual de la película Flash dentro del escenario.
La tabla siguiente muestra los valores de la propiedad align. Los valores que no aparecen en esta
tabla centran la película en el área del escenario.
Valor
Vertical
Horizontal
"T"
superior
centro
"B"
inferior
centro
"L"
centro
izquierda
"R"
centro
derecha
"TL"
superior
izquierda
"TR"
superior
derecha
"BL"
inferior
izquierda
"BR"
inferior
derecha
Stage.height
Disponibilidad
Flash Player 6.
Sintaxis
Stage.height
Descripción
Propiedad (sólo lectura); indica la altura actual, en píxeles, del escenario de la película 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 película cambia cuando se
modifica el tamaño de la ventana del reproductor), height representa la altura de la película Flash.
Stage.onResize
Disponibilidad
Flash Player 6.
Sintaxis
Stage.onResize() = function() {...}
Parámetros
Ninguno.
Valor devuelto
Ninguno.
415
Descripción
Método callback; indica que se ha modificado el tamaño de la película Flash. Puede utilizar este
evento para escribir una función que disponga los objetos en el escenario cuando se modifica el
tamaño de una película.
Stage.removeListener
Disponibilidad
Flash Player 6.
Sintaxis
Stage.removeListener(myListener)
Parámetros
myListener
Objeto agregado a la lista de callbacks de un objeto con el método addListener.
Valor devuelto
Ninguno.
Descripción
Método; elimina un objeto detector creado con addListener.
Véase también
Stage.addListener
Stage.scaleMode
Disponibilidad
Flash Player 6.
Sintaxis
Stage.scaleMode = "valor"
Descripción
Propiedad; indica la escala actual de la película Flash en el escenario. La propiedad scaleMode
hace que se aplique un determinado modo de escala a la película. De forma predeterminada, la
película utiliza los parámetros HTML establecidos en el cuadro de diálogo Configuración de
publicación.
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
Descripción
Propiedad (sólo lectura); indica la anchura actual, en píxeles, del escenario de la película 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 película cambia cuando se
modifica el tamaño de la ventana del reproductor), width representa la anchura de la película Flash.
startDrag
Disponibilidad
Flash Player 4.
Sintaxis
startDrag(destino,[bloquear ,izquierda , superior , derecha , inferior])
Parámetros
destino
Ruta de destino del clip de película que desea arrastrar.
Valor booleano que especifica si el clip de película arrastrable está bloqueado en el
centro de la posición del ratón (true) o en el punto en el que el usuario hizo clic por primera vez
en el clip de película (false). Este parámetro es opcional.
bloquear
izquierda, superior, derecha, inferior
Valores relativos a las coordenadas del elemento
principal del clip de película que especifican un rectángulo de limitación para el clip de película.
Estos parámetros son opcionales.
Valor devuelto
Ninguno.
Descripción
Acción; hace que el clip de película de destino se pueda arrastrar mientras se reproduce la
película. Sólo un clip de película puede arrastrarse al mismo tiempo. Una vez que se ha ejecutado
una operación startDrag, el clip de película se puede seguir arrastrando hasta que se detiene
específicamente mediante una acción stopDrag, o hasta que se llame a una acción startDrag de
otro clip de película.
Ejemplo
Para crear un clip de película que los usuarios puedan colocar en cualquier ubicación, asocie las
acciones startDrag y stopDrag a un botón dentro del clip de película.
on(press) {
startDrag (this, true);
}
on(release) {
stopDrag();
}
Véase también
MovieClip._droptarget, stopDrag
417
stop
Disponibilidad
Flash 2.
Sintaxis
stop
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Acción; detiene el clip de película que se está reproduciendo actualmente. La utilización más
corriente de esta acción es para controlar los clips de película con botones.
stopAllSounds
Disponibilidad
Flash Player 3.
Sintaxis
stopAllSounds()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Acción; detiene todos los sonidos que se están reproduciendo actualmente sin detener la cabeza
lectora. Los sonidos establecidos en flujo reanudarán la reproducción cuando la cabeza lectora se
mueva sobre los fotogramas en los que se encuentran.
Ejemplo
El código siguiente podría aplicarse a un botón que, cuando se hace clic sobre él, detiene todos los
sonidos de la película.
on(release) {
stopAllSounds();
}
Véase también
Sound (objeto)
418
stopDrag
Disponibilidad
Flash Player 4.
Sintaxis
stopDrag()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Acción; detiene la operación de arrastre actual.
Ejemplo
Esta sentencia detiene la acción de arrastre de la instancia mc cuando el usuario suelta el botón del
ratón.
on(press) {
startDrag("mc");
}
on(release) {
stopdrag();
}
Véase también
MovieClip.stopDrag, MovieClip._droptarget, startDrag,
String (función)
Disponibilidad
Flash Player 4.
Sintaxis
String(expresión)
Parámetros
expresión
Expresión que debe convertirse en una cadena.
Valor devuelto
Ninguno.
Descripción
Función; devuelve una representación de cadena del parámetro especificado como se muestra a
continuación:
Si expresión es un valor booleano, la cadena devuelta es true o false.
Si expresión es un número, la cadena devuelta es una representación textual del número.
Si expresión es una cadena, la cadena devuelta es expresión.
419
Si expresión es un objeto, el valor devuelto es una representación 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 expresión es un clip de película, el valor devuelto es la ruta de destino del clip de película en
notación con barras (/).
Si el valor expresión es undefined, el valor devuelto es una cadena vacía ("").
Véase también
Number.toString, Object.toString,
String (objeto), " " (delimitador de cadena)
" " (delimitador de cadena)
Disponibilidad
Flash Player 4.
Sintaxis
"texto"
Parámetros
texto
Un carácter.
Valor devuelto
Ninguno.
Descripción
Delimitador de cadena; cuando se utilizan delante y detrás de caracteres, las comillas indican que
los caracteres tienen un valor literal y se consideran una cadena, no una variable, valor numérico ni
ningún 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 Príncipe 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 Príncipe Eduardo";
on(release){
province = yourGuess
trace(province);
}
// muestra Isla Príncipe Eduardo en la ventana Salida
Véase también
String (objeto), String (función)
420
String (objeto)
El objeto String es un envolvente para el tipo de datos primitivo de cadena, que permite utilizar
los métodos 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 función
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 métodos del objeto String, excepto concat, fromCharCode, slice y substr, son
genéricos. Esto quiere decir que los propios métodos llaman a this.toString antes de realizar
sus operaciones; puede utilizar estos métodos con otros objetos que no sean String.
Puesto que todos los índices de cadena tienen base cero, el índice del último carácter de cualquier
cadena x es el siguiente:
x.length - 1
Puede llamar a cualquiera de los métodos del objeto String utilizando el método constructor
newString o un valor de literal de cadena. Si especifica un literal de cadena, el intérprete de
ActionScript lo convierte automáticamente en un objeto String temporal, llama al método y
después 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 línea de código crea el literal de cadena s1 y la segunda línea de
código crea una instancia s2 del objeto String.
s1 = "foo"
s2 = new String("foo")
Utilice literales de cadena a menos que necesite utilizar específicamente un objeto String.
Resumen de métodos del objeto String
Método
Descripción
String.charAt
Devuelve el carácter que se encuentra en una ubicación específica de una cadena.
String.charCodeAt
Devuelve el valor del carácter en el índice dado como un número entero de 16 bits entre
0 y 65535.
String.concat
Combina el texto de dos cadenas y devuelve una nueva cadena.
String.fromCharCode Devuelve una cadena formada por los caracteres especificados en los parámetros.
String.indexOf
Busca la cadena y devuelve el índice de la subcadena especificada en los parámetros.
Si un valor aparece más de una vez, se devuelve el índice de la primera ocurrencia. Si no
se encuentra valor, se devuelve –1.
String.lastIndexOf
Devuelve el índice de la última subcadena de la cadena que aparece antes de la
posición de inicio especificada en el parámetro, o –1 si no se encuentra.
String.slice
Extrae una sección de una cadena y devuelve una nueva cadena.
String.split
Divide un objeto String en una matriz de cadenas dividiendo las cadenas en subcadenas.
String.substr
Devuelve un número especificado de caracteres en una cadena comenzando en la
ubicación especificada en el parámetro.
String.substring
Devuelve los caracteres entre dos índices, especificados en los parámetros como una
cadena.
421
Método
Descripción
String.toLowerCase
Convierte la cadena a minúsculas y devuelve el resultado; no cambia el contenido del
objeto original.
String.toUpperCase
Convierte la cadena a mayúsculas y devuelve el resultado; no cambia el contenido del
objeto original.
Resumen de las propiedades del objeto String
Propiedad
Descripción
String.length
Devuelve la longitud de la cadena.
Constructor del objeto String.
Disponibilidad
Flash Player 5.
Sintaxis
new String(valor)
Parámetros
valor
Valor inicial del nuevo objeto String.
Valor devuelto
Ninguno.
Descripción
Constructor; crea un nuevo objeto String.
Véase también
String (función), " " (delimitador de cadena)
String.charAt
Disponibilidad
Flash Player 5.
Sintaxis
myString.charAt(índice)
Parámetros
índice
Número del carácter en la cadena que se va a devolver.
Valor devuelto
Ninguno.
Descripción
Método; devuelve el carácter que se encuentra en la posición especificada por el índice del
parámetro. El índice del primer carácter de una cadena es 0. Si índice no es un número entre 0 y
string.length - 1, se devuelve una cadena vacía.
422
String.charCodeAt
Disponibilidad
Flash Player 5.
Sintaxis
myString.charCodeAt(índice)
Parámetros
índice Número entero que especifica la posición de un carácter en la cadena. El primer
carácter se indica con 0, y el último, con myString.length-1.
Valor devuelto
Ninguno.
Descripción
Método; devuelve un entero de 16 bits entre 0 y 65535 que representa el carácter especificado por
índice.
Este método es parecido al método string.charAt, pero el valor devuelto en este caso es un
código de carácter entero de 16 bits, no un carácter.
Ejemplo
En el ejemplo siguiente, se llama al método 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)
Parámetros
valor1,...valorN
Cero o más valores que deben concatenarse.
Valor devuelto
Ninguno.
Descripción
Método; combina el valor del objeto String con los parámetros 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)
Parámetros
Enteros decimales que representan valores ASCII.
c1,c2,...cN
Valor devuelto
Ninguno.
Descripción
Método; devuelve una cadena formada por los caracteres representados por los valores ASCII de
los parámetros.
Ejemplo
En este ejemplo se utiliza el método fromCharCode para insertar un carácter “@” en la dirección
de correo electrónico.
address = "perro" + String.fromCharCode(64) + "casa.net";
trace(address);
// salida: [email protected]
String.indexOf
Disponibilidad
Flash Player 5.
Sintaxis
myString.indexOf(subcadena, [inicioÍndice])
Parámetros
subcadena
myString.
Número entero o cadena que especifica la subcadena que se debe buscar dentro de
inicioÍndice Número entero que especifica el punto de myString en el que debe iniciarse la
búsqueda de la subcadena. Este parámetro es opcional.
Valor devuelto
Ninguno.
Descripción
Método; busca en la cadena y devuelve la posición de la primera aparición de la subcadena
especificada. Si no se encuentra el valor, el método devuelve -1.
424
String.lastIndexOf
Disponibilidad
Flash Player 5.
Sintaxis
myString.lastIndexOf(subcadena, [inicioÍndice])
Parámetros
subcadena
Número entero o cadena que especifica la cadena en la que se va a buscar.
inicioÍndice
subcadena. Este
Número entero que especifica el punto en el que debe iniciarse la búsqueda de la
parámetro es opcional.
Valor devuelto
Ninguno.
Descripción
Método; busca en la cadena de derecha a izquierda y devuelve el índice de la última aparición de la
subcadena que se encuentra antes de inicioÍndice dentro de la cadena de llamada. Si no se
encuentra ninguna subcadena, el método devuelve -1.
String.length
Disponibilidad
Flash Player 5.
Sintaxis
string.length
Parámetros
Ninguno.
Descripción
Propiedad; devuelve el número de caracteres del objeto String especificado.
String.slice
Disponibilidad
Flash Player 5.
Sintaxis
myString.slice(inicio, [final])
Parámetros
Número que especifica el índice del punto de inicio de la sección. Si inicio es un número
negativo, el punto de inicio se determina desde el final de la cadena, donde -1 es el último carácter.
inicio
final Número que especifica el índice del punto final de la sección. Si no se especifica el final,
la sección incluye todos los caracteres del inicio al final de la cadena. Si final es un número
negativo, el punto final se determina desde el final de la cadena, donde -1 es el último carácter.
Valor devuelto
Ninguno.
425
Descripción
Método; extrae una sección o subcadena del objeto String especificado y después la
devuelve como una nueva cadena sin modificar el objeto String original. La cadena devuelta
incluye el carácter inicial y todos los caracteres hasta el carácter 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 método slice extrae una sección de la cadena que contiene la variable
y la acción trace la envía 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 código siguiente produce el mismo resultado, pero el parámetro pasado a la función 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", [límite])
Parámetros
Carácter o cadena por donde se divide myString. Si el parámetro delimitador
no está definido, toda la cadena se coloca en el primer elemento de la matriz.
delimitador
límite
Número de elementos que deben colocarse en la matriz. Este parámetro es opcional.
Valor devuelto
Una matriz que contiene las subcadenas de myString.
Descripción
Método; divide un objeto String en subcadenas separándolo en el punto donde aparece el
parámetro delimitador especificado y devuelve las subcadenas en una matriz. Si se utiliza una
cadena vacía ("") como delimitador, cada carácter de la cadena se coloca como un elemento en la
matriz, tal como se muestra en el código siguiente.
myString = "Joe";
i = myString.split("");
trace (i);
La ventana Salida muestra lo siguiente:
J, O, E
Si el parámetro 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])
Parámetros
inicio Número entero que indica la posición del primer carácter de myString que debe
utilizarse para crear la subcadena. Si inicio es un número negativo, el punto inicial se determina
desde el final de la cadena, donde -1 es el último carácter.
longitud
longitud,
Número 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.
Descripción
Método; devuelve los caracteres de una cadena desde el índice especificado en el parámetro
inicio, hasta el número de caracteres especificados en el parámetro longitud. El método
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)
Parámetros
desde Número entero que indica la posición del primer carácter de myString utilizado para
crear la subcadena. Los valores válidos para desde van de 0 a string.length - 1. Si desde es un
valor negativo, se utiliza 0.
Número entero que es 1+ el índice del último carácter de myString que debe extraerse.
Los valores válidos para hasta van de 1 a string.length. El carácter indexado por el parámetro
hasta no se incluye en la cadena extraída. Si el parámetro se omite, se utiliza string.length. Si
este parámetro es un valor negativo, se utiliza 0.
hasta
Valor devuelto
Ninguno.
427
Descripción
Método; devuelve una cadena formada por los caracteres situados entre los puntos especificados
por los parámetros desde y hasta. Si no se especifica el parámetro hasta, el final de la subcadena
es el final de la cadena. Si el valor de desde es igual al de hasta, el método devuelve una cadena
vacía. Si el valor de desde es mayor que el valor de hasta, los parámetros se intercambian
automáticamente antes de que la función se ejecute y el valor original permanece inalterado.
String.toLowerCase
Disponibilidad
Flash Player 5.
Sintaxis
myString.toLowerCase()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; devuelve una copia del objeto String, con todos los caracteres en mayúsculas convertidos
en minúsculas. El valor original permanece inalterado.
String.toUpperCase
Disponibilidad
Flash Player 5.
Sintaxis
myString.toUpperCase()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; devuelve una copia del objeto String, con todos los caracteres en minúsculas convertidos
en mayúsculas. El valor original permanece inalterado.
428
substring
Disponibilidad
Flash Player 4. Esta función se ha desestimado en favor de String.substr.
Sintaxis
substring("cadena", índice, conteo)
Parámetros
cadena
Cadena a partir de la que se va a extraer la nueva cadena.
índice
Número del primer carácter que se va a extraer.
conteo
Número de caracteres que se van a incluir en la cadena extraída, sin incluir el carácter de
índice.
Valor devuelto
Ninguno.
Descripción
Función de cadena; extrae parte de una cadena. Esta función tiene base 1, mientras que los
métodos del objeto String tienen base 0.
Véase también
String.substr
super
Disponibilidad
Flash Player 6.
Sintaxis
super.método([arg1, ..., argN])
super([arg1, ..., argN])
Parámetros
método
Método que se invoca en la superclase.
arg1 Parámetros opcionales que se pasan a la versión de superclase del método (sintaxis 1) o a la
función constructor de la superclase (sintaxis 2).
Valor devuelto
Ambas formas invocan una función. La función puede devolver cualquier valor.
Descripción
Operador: el primer estilo de sintaxis puede utilizarse dentro del cuerpo de un método de objeto
para invocar la versión de superclase de un método y puede pasar parámetros (arg1 ... argN) de
forma opcional al método de superclase. Esto resulta útil para crear métodos de subclase que
agregan un comportamiento adicional a los métodos de superclase, pero también invocan los
métodos de superclase para realizar su comportamiento original.
El segundo estilo de sintaxis puede utilizarse dentro del cuerpo de una función constructor para
invocar la versión de superclase de la función constructor y, opcionalmente, puede pasarle
parámetros. Esto resulta útil para crear una subclase que realice una inicialización adicional, pero que
también invoque el constructor de superclase para llevar a cabo una inicialización de superclase.
429
Ejemplo
En el ejemplo siguiente se crean dos clases, ParentClass y ChildClass, y se define un método
llamado method para cada clase. Cada definición de método tiene una acción trace que envía un
mensaje a la ventana Salida. La penúltima línea de código crea una instancia ChildClass y llama a
su método method:
function ParentClass() {
}
ParentClass.prototype.method = function () {
trace("Implementación del método de ParentClass");
};
function ChildClass() {
}
ChildClass.prototype = new ParentClass();
ChildClass.prototype.method = function () {
trace("Implementación del método de ChildClass");
super.method();
};
x = new ChildClass();
x.method();
La ventana Salida muestra lo siguiente:
Implementación del método de ChildClass
Implementación del método de ParentClass
En el ejemplo siguiente se pasan parámetros 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 (expresión){
cláusulaCase:
[cláusulaDefault:]
}
Parámetros
expresión
Cualquier expresión.
cláusulaCase Una palabra clave case seguida por una expresión, dos puntos y un grupo de
sentencias que se deben ejecutar si la expresión coincide con el parámetro expresión 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 parámetro expresión de switch según la igualdad
estricta (===).
cláusulaDefault
Valor devuelto
Ninguno.
430
Descripción
Acción; crea una estructura ramificada para sentencias de ActionScript. Al igual que la acción if,
la acción switch prueba una condición que ejecuta sentencias si la condición devuelve el valor
true.
Ejemplo
En el ejemplo siguiente, si el parámetro number da como resultado 1, se ejecuta la acción trace
que sigue a case 1; si el parámetro number da como resultado 2, se ejecuta la acción trace que
sigue a case 2, y así sucesivamente. Si ninguna expresión case coincide con el parámetro
number, se ejecuta la acción 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 ("ningún
}
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 parámetro number es 1, tanto A como B se envían a la ventana Salida:
switch (number) {
case 1:
trace ("A");
case 2:
trace ("B");
break;
default
trace ("D")
}
Véase también
=== (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 código 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 película Flash. Esto le permite personalizar contenido para distintos
formatos. Por ejemplo, la pantalla de un teléfono móvil (en blanco y negro, de 100 píxeles
cuadrados) es distinta a la pantalla de un PC en color de 1.000 píxeles 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 continuación, puede especificar al servidor
que envíe distintos archivos SWF según las capacidades del dispositivo, o indicar a la película Flash
que modifique su presentación en función de las capacidades del dispositivo.
Puede enviar información sobre las capacidades utilizando un método HTTP GET o POST. A
continuación se muestra un ejemplo de una cadena de servidor para un dispositivo no compatible
con MP3 y con una pantalla de 400 x 200 píxeles (8 x 4 centímetros):
"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 través del objeto
System.capabilities.
Resumen de las propiedades del objeto Capabilities
Propiedad
Descripción
System.capabilities.hasAudioEncoder
Indica los codificadores de audio compatibles.
System.capabilities.hasAccessibility
Indica si el dispositivo cumple los estándares de accesibilidad.
System.capabilities.hasAudio
Indica si el dispositivo tiene capacidades de audio.
System.capabilities.hasMP3
Indica si el dispositivo tiene un decodificador MP3.
System.capabilities.language
Indica el idioma de Flash Player.
System.capabilities.manufacturer
Indica el fabricante de Flash Player.
System.capabilities.os
Indica el sistema operativo que alberga Flash Player.
System.capabilities.pixelAspectRatio
Indica la relación de aspecto de los píxeles de la pantalla.
System.capabilities.screenColor
Indica si la pantalla es en color, en blanco y negro o en escala
de grises.
System.capabilities.screenDPI
Indica los puntos por pulgada de la pantalla.
System.capabilities.screenResolution.x Indica la dimensión horizontal de la pantalla.
System.capabilities.screenResolution.y Indica la dimensión vertical de la pantalla.
432
System.capabilities.version
Indica la versión mínima de Flash Player compatible.
System.capabilities.hasVideoEncoder
Indica los codificadores de video compatibles.
System.capabilities.hasAudioEncoder
Disponibilidad
Flash Player 6.
Sintaxis
System.capabilities.hasAudioEncoder
Descripción
Propiedad; una matriz de decodificadores de audio. La cadena del servidor es AE.
System.capabilities.hasAccessibility
Disponibilidad
Flash Player 6.
Sintaxis
System.capabilities.hasAccessibility
Descripción
Propiedad; un valor booleano que indica si el dispositivo es compatible o no con la comunicación
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
Descripción
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
Descripción
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
Descripción
Propiedad; un código de idioma formado por dos letras minúsculas según ISO 639-1 y una
subetiqueta de código de país formada por dos letras mayúsculas según 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:
434
Idioma
Etiqueta
Etiquetas y países compatibles
Inglés
en
Estados Unidos = US, Reino Unido = UK
Francés
fr
Coreano
ko
Japonés
ja
Sueco
sv
Alemán
de
Español
es
Italiano
it
Chino simplificado
zh
China (chino simplificado) = CN
Chino tradicional
zh
Taiwán (chino tradicional) = TW
Portugués
pt
Polaco
pl
Húngaro
hu
Checo
cs
Turco
tr
Finlandés
fi
Danés
da
Noruego
no
Holandés
nl
Ruso
ru
Otro/desconocido
xu
System.capabilities.manufacturer
Disponibilidad
Flash Player 6.
Sintaxis
System.capabilities.manufacturer
Descripción
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
Descripción
Propiedad; una cadena que indica el fabricante de Flash Player. El valor predeterminado es una
cadena vacía (""). La propiedad os puede devolver las cadenas siguientes: "Windows XP",
"Windows 2000", "Windows NT", "Windows 98/ME", "Windows 95", "Windows CE" (disponible
sólo en kit de desarrollo de software, no en versión de escritorio) y "MacOS". La cadena del
servidor es OS.
System.capabilities.pixelAspectRatio
Disponibilidad
Flash Player 6.
Sintaxis
System.capabilities.hasVideoEncoder
Descripción
Propiedad; un entero que indica la relación de aspecto de los píxeles 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
Descripción
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
Descripción
Propiedad; indica los puntos por pulgada (ppp) de la pantalla, en píxeles. El valor predeterminado
es 72. La cadena del servidor es DPI.
System.capabilities.screenResolution.x
Disponibilidad
Flash Player 6.
Sintaxis
System.capabilities.screenResolution.x
Descripción
Propiedad; un entero que indica la resolución horizontal máxima de la pantalla. El valor
predeterminado es 800 (píxeles). La cadena del servidor es SRX.
System.capabilities.screenResolution.y
Disponibilidad
Flash Player 6.
Sintaxis
System.capabilities.screenResolution.y
Descripción
Propiedad; un entero que indica la resolución vertical máxima de la pantalla. El valor
predeterminado es 600 (píxeles). La cadena del servidor es SRY.
System.capabilities.version
Disponibilidad
Flash Player 6.
Sintaxis
System.capabilities.version
Descripción
Propiedad; un entero que especifica la versión de Flash Player compatible. La versión
predeterminada es 6.0. La cadena del servidor es VER.
436
System.capabilities.hasVideoEncoder
Disponibilidad
Flash Player 6.
Sintaxis
System.capabilities.hasVideoEncoder
Descripción
Propiedad; una matriz de codificadores de video. La cadena del servidor es VE.
targetPath
Disponibilidad
Flash Player 5.
Sintaxis
targetpath(objetoClipPelícula)
Parámetros
objetoClipPelícula Referencia (por ejemplo, _root o _parent) al clip de película del que se
está recuperando la ruta de destino.
Valor devuelto
Ninguno.
Descripción
Función; devuelve una cadena que contiene la ruta de destino de objetoClipPelícula. La ruta
de destino se devuelve en notación con puntos. Para recuperar la ruta de destino en notación con
barras, utilice la propiedad _target.
Ejemplo
Este ejemplo muestra la ruta de destino de un clip de película en cuanto se carga.
onClipEvent(load){
trace(targetPath(this));
}
Véase también
eval
tellTarget
Disponibilidad
Flash Player 3. (Desestimada en Flash 5; se recomienda utilizar notación con puntos y la acción with.)
Sintaxis
tellTarget("destino") {
sentencia(s);
}
Parámetros
destino
Cadena que especifica la ruta de destino de la línea de tiempo que debe controlarse.
sentencia(s)
Instrucciones que deben ejecutarse si la condición tiene el valor true.
437
Valor devuelto
Ninguno.
Descripción
Acción; aplica las instrucciones especificadas en el parámetro sentencias a la línea de tiempo
especificada en el parámetro destino. La acción tellTarget es útil para controles de navegación.
Asigne tellTarget a botones que detienen o inician los clips de película en otras partes del
escenario. También puede hacer que los clips de película vayan a un fotograma concreto de dicho
clip. Por ejemplo, podría asignar tellTarget a botones que detienen o inician los clips de
película en el escenario, o hacer que los clips de película salten a un fotograma concreto.
En Flash 5, puede utilizar notación con puntos en lugar de la acción tellTarget. Puede utilizar
la acción with para especificar varias acciones en la misma línea de tiempo. Puede utilizar la
acción with para especificar el destino de cualquier objeto, mientras que con la acción
tellTarget sólo puede especificar destinos de clips de películas.
Ejemplo
La sentencia tellTarget controla la instancia de clip de película ball en la línea de tiempo
principal. El fotograma 1 de la instancia ball está vacío y tiene una acción stop, de modo que es
invisible en el escenario. Al hacer clic en el botón de la acción siguiente, tellTarget indica a la
cabeza lectora de ball que vaya al fotograma 2, en el que empieza la animación.
on(release) {
tellTarget("ball") {
gotoAndPlay(2);
}
}
En el ejemplo siguiente se utiliza la notación con puntos para obtener el mismo resultado.
on(release) {
ball.gotoAndPlay(2);
}
Si necesita especificar varios comandos en la instancia ball, puede utilizar la acción with, tal
como se muestra a continuación.
on(release) {
with(ball) {
gotoAndPlay(2);
_alpha = 15;
_xscale = 50;
_yscale = 50;
}
}
Véase también
with
438
TextField (objeto)
Todos los campos de texto dinámico y de introducción de texto de una película 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 métodos y las propiedades del objeto TextField para
manipularlo con ActionScript. Los nombres de instancia del objeto TextField se muestran en el
Explorador de películas y en el cuadro de diálogo Insertar ruta de destino del panel Acciones.
El objeto TextField es descendiente del objeto Object.
Para crear un campo de texto de forma dinámica, puede utilizar el método
MovieClip.createTextField.
El objeto TextField se admite en Flash Player 6 y en versiones posteriores de Flash Player.
Resumen de los métodos del objeto TextField
Método
Descripción
TextField.addListener
Registra un objeto para que reciba una notificación cuando se invoquen los
eventos onChanged y onScroller.
TextField.getDepth
Devuelve la profundidad de un campo de texto.
TextField.getNewTextFormat
Obtiene el formato de texto predeterminado asignado al texto que se acaba
de insertar.
TextField.removeListener
Elimina un objeto detector.
TextField.removeTextField
Elimina un campo de texto creado con el método
MovieClip.createTextField.
TextField.setNewTextFormat
Establece un objeto de formato de texto para el texto insertado por un usuario
o por un método.
TextField.replaceSel
Reemplaza la selección actual.
TextField.setTextFormat
Establece el formato de texto predeterminado asignado al texto que se acaba
de insertar.
Resumen de las propiedades del objeto TextField
Propiedad
Descripción
TextField._alpha
Valor de transparencia de una instancia de campo de texto.
TextField.autoSize
Controla la alineación automática y la modificación del tamaño de un campo
de texto.
TextField.background
Indica si el campo de texto tiene un relleno de fondo.
TextField.backgroundColor
Indica el color del relleno de fondo.
TextField.border
Indica si el campo de texto tiene un borde.
TextField.borderColor
Indica el color del borde.
TextField.bottomScroll
Línea visible situada más abajo en un campo de texto.
TextField.embedFonts
Indica si el campo de texto utiliza contornos de fuentes incorporadas o
fuentes de dispositivo.
TextField._highquality
Indica la calidad de representación de la película.
439
440
Propiedad
Descripción
TextField._height
Altura de una instancia de campo de texto en píxeles. Sólo afecta al
recuadro de delimitación del campo de texto, no al grosor del borde ni al
tamaño de fuente del texto.
TextField.hscroll
Indica el valor de desplazamiento horizontal de un campo de texto.
TextField.html
Indica la posición de desplazamiento máxima de un campo de texto.
TextField.htmlText
Contiene la representación HTML del contenido de un campo de texto.
TextField.length
Número de caracteres de un campo de texto.
TextField.maxChars
Número máximo de caracteres que puede contener un campo de texto.
TextField.maxhscroll
Valor máximo de TextField.hscroll.
TextField.maxscroll
Valor máximo de TextField.scroll.
TextField.multiline
Indica si el campo de texto contiene varias líneas.
TextField._name
Nombre de instancia de una instancia de campo de texto.
TextField._parent
Referencia a la instancia principal de esta instancia; ya sea de tipo Button o
MovieClip.
TextField.password
Indica si un campo de texto debe ocultar los caracteres introducidos.
TextField._quality
Indica la calidad de representación de la película.
TextField.restrict
Conjunto de caracteres que puede introducir un usuario en un campo de
texto.
TextField._rotation
Grado de rotación de una instancia de campo de texto.
TextField.scroll
Indica la posición de desplazamiento actual de un campo de texto.
TextField.selectable
Indica si un campo de texto se puede seleccionar.
TextField._soundbuftime
Tiempo durante el cual un sonido debe almacenarse previamente en una
memoria intermedia antes de empezar a fluir.
TextField.tabEnabled
Indica si se incluye un clip de película en el orden de tabulación automático.
TextField.tabIndex
Indica el orden de tabulación de un objeto.
TextField.text
Texto actual del campo de texto.
TextField.textColor
Color del texto en el campo de texto.
TextField.textHeight
Altura del recuadro de delimitación del campo de texto.
TextField.textWidth
Anchura del recuadro de delimitación del campo de texto.
TextField.type
Indica si un campo de texto es un campo de introducción de texto o un
campo de texto dinámico.
TextField._url
URL del archivo SWF que ha creado la instancia de campo de texto.
TextField.variable
Nombre de variable asociado con el campo de texto.
TextField._visible
Valor booleano que determina si una instancia de campo de texto está oculta
o visible.
TextField._width
Anchura de una instancia de campo de texto en píxeles. Sólo afecta al
recuadro de delimitación del campo de texto, no al grosor del borde ni al
tamaño de fuente del texto.
TextField.wordWrap
Indica si el texto de un campo de texto se ajusta.
TextField._x
Coordenada x de una instancia de campo de texto.
Propiedad
Descripción
TextField._xmouse
Coordenada x del cursor con relación a una instancia de campo de texto.
TextField._xscale
Valor que especifica el porcentaje de escala horizontal que se aplicará a una
instancia de campo de texto.
TextField._y
Coordenada y de una instancia de campo de texto.
TextField._ymouse
Coordenada y del cursor con relación a una instancia de campo de texto.
TextField._yscale
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
Método
Descripción
TextField.onChanged
Se invoca cuando se cambia el campo de texto.
TextField.onKillFocus
Se invoca cuando el campo de texto deja de estar seleccionado.
TextField.onScroller
Se invoca cuando cambia la propiedad scroll, maxscroll, hscroll,
maxhscroll o bottomscroll de un campo de texto.
TextField.onSetFocus
Se invoca cuando el campo de texto pasa a estar seleccionado.
Resumen de los detectores del objeto TextField
Método
Descripción
TextField.onChanged
Se notifica cuando cambia el campo de texto.
TextField.onScroller
Se notifica cuando cambia la propiedad scroll o maxscroll de un campo
de texto.
TextField._alpha
Disponibilidad
Flash Player 6.
Sintaxis
TextField._alpha
Descripción
Propiedad; establece o recupera la transparencia alfa (valor) del campo de texto especificado por
TextField. Los valores válidos 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)
Parámetros
nuevoDetector
Objeto con las notificaciones de los eventos onChanged y onScroller.
Valor devuelto
Ninguno.
Descripción
Método; 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 métodos onChanged y onScroller de los objetos de
detección registrados con addListener. Varios objetos pueden detectar notificaciones de cambio.
Si el detector nuevoDetector ya está registrado, no se produce ningún cambio.
TextField.autoSize
Disponibilidad
Flash Player 6.
Sintaxis
TextField.autoSize
Descripción
Propiedad; controla la alineación y el cambio de tamaño automáticos 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 tamaño de forma automática 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 tamaño
del texto cambia automáticamente, pero el centro horizontal del campo de texto permanece
anclado en la posición central horizontal que el campo de texto tenía originalmente. El lado
inferior se mueve para que quepa todo el texto. Si el valor de autosize es "right", el tamaño del
texto cambia automáticamente, 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 sinónimo de "left" y false es un sinónimo 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
Descripción
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
Descripción
Propiedad; color del fondo del campo de texto. El valor predeterminado es 0xFFFFFF (blanco).
Esta propiedad puede recuperarse o establecerse, incluso si no hay ningún color de fondo y el
color sólo es visible si el campo de texto tiene un borde.
Véase también
TextField.background
TextField.border
Disponibilidad
Flash Player 6.
Sintaxis
TextField.border
Descripción
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
Descripción
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 ningún borde.
Véase también
TextField.border
443
TextField.bottomScroll
Disponibilidad
Flash Player 6.
Sintaxis
TextField.bottomScroll
Descripción
Propiedad (sólo lectura); número entero (índice con base 1) que indica la línea situada más 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 línea visible situada más
arriba en la ventana.
Todo el texto entre las líneas TextField.scroll y TextField.bottomScroll se ve en el campo
de texto.
TextField.embedFonts
Disponibilidad
Flash Player 6.
Sintaxis
TextField.embedFonts
Descripción
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
Descripción
Propiedad; valor booleano que especifica si un campo de texto está rodeado por un rectángulo
amarillo cuando está seleccionado.
444
TextField.getDepth
Disponibilidad
Flash Player 6.
Sintaxis
TextField.getDepth
Parámetros
Ninguno.
Valor devuelto
Un número entero.
Descripción
Método; devuelve la profundidad de un campo de texto.
TextField.getFontList
Disponibilidad
Flash Player 6.
Sintaxis
TextField.getFontList
Parámetros
Ninguno.
Valor devuelto
Una matriz.
Descripción
Método; 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()
Parámetros
Ninguno.
Valor devuelto
Un objeto TextFormat.
Descripción
Método; 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 recién
insertado, por ejemplo, con el método 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 (iniciarÍndice, terminarÍndice)
Parámetros
índice
Número entero que especifica un carácter de una cadena.
Valor devuelto
Un objeto.
Descripción
Método; (sintaxis 1) devuelve un objeto TextFormat que contiene información sobre el formato
de todo el texto de un campo de texto. En el objeto TextFormat, sólo 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
parámetro índice del campo de texto.
Sintaxis 3: devuelve un objeto TextFormat que contiene información sobre el formato del espacio
del texto desde iniciarÍndice hasta terminarÍndice.
Véase también
TextField.getNewTextFormat, TextField.setNewTextFormat, TextField.setTextFormat
TextField._height
Disponibilidad
Flash Player 6.
Sintaxis
TextField._height
Descripción
Propiedad; establece y recupera la altura del campo de texto, en píxeles.
Ejemplo
El ejemplo de código 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
Descripción
Propiedad (global); especifica el nivel de suavizado aplicado a la película 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 película no contiene animación.
Especifique 0 (baja calidad) para evitar el suavizado.
Ejemplo
_highquality = 1;
Véase también
_quality, toggleHighQuality
TextField.hscroll
Disponibilidad
Flash Player 6.
Sintaxis
TextField.hscroll
Valor devuelto
Un número entero.
Descripción
Propiedad; indica la posición 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;
}
Véase también
TextField.maxhscroll, TextField.scroll
447
TextField.html
Disponibilidad
Flash Player 6.
Sintaxis
TextField.html
Descripción
Propiedad; etiqueta que indica si el campo de texto contiene una representación 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.
Véase también
TextField.htmlText
TextField.htmlText
Disponibilidad
Flash Player 6.
Sintaxis
TextField.htmlText
Descripción
Propiedad; si el campo de texto es HTML, esta propiedad contiene la representación 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
Descripción
Propiedad (sólo lectura); indica el número de caracteres de un campo de texto. Esta propiedad
devuelve el mismo valor que text.length, pero es más rápida. El carácter de tabulación (“\t”) se
cuenta como un carácter.
448
TextField.maxChars
Disponibilidad
Flash Player 6.
Sintaxis
TextField.maxChars
Descripción
Propiedad; indica el número máximo de caracteres que puede contener el campo de texto. Un
script puede insertar más texto del que permite maxChars; la propiedad maxChars sólo indica
cuánto texto puede introducir un usuario. Si el valor de esta propiedad es null, no hay límite en
cuanto a la cantidad de texto que puede introducir un usuario.
TextField.maxhscroll
Disponibilidad
Flash Player 6.
Sintaxis
TextField.maxhscroll
Descripción
Propiedad (sólo lectura); indica el valor máximo de TextField.hscroll.
Véase también
TextField.hscroll
TextField.maxscroll
Disponibilidad
Flash Player 6.
Sintaxis
TextField.maxscroll
Descripción
Propiedad (sólo lectura); indica el valor máximo de TextField.scroll.
Véase también
TextField.scroll
TextField.multiline
Disponibilidad
Flash Player 6.
Sintaxis
TextField.multiline
Descripción
Propiedad; indica si el campo de texto contiene varias líneas. Si el valor es true, el campo de texto
tiene varias líneas; si el valor es false, el campo de texto sólo tiene una línea.
449
TextField._name
Disponibilidad
Flash Player 6.
Sintaxis
TextField._name
Descripción
Propiedad; devuelve el nombre de instancia del campo de texto especificado por TextField.
TextField.onChanged
Disponibilidad
Flash Player 6.
Sintaxis
TextField.onChanged
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
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 (nuevaSelección) {
sentencias;
};
Parámetros
nuevaSelección
El objeto que pasará a estar seleccionado.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; un evento que se invoca cuando un campo de texto ya no se selecciona
con el teclado. El método onKillFocus recibe un parámetro, nuevaSelección, que es un objeto
que representa el nuevo objeto seleccionado. Si no hay ningún objeto seleccionado,
nuevaSelección contiene el valor null.
450
TextField.onScroller
Disponibilidad
Flash Player 6.
Sintaxis
TextField.onScroller
Descripción
Controlador de eventos; un evento que se invoca cuando cambia una de las propiedades de
desplazamiento del campo de texto.
Véase también
TextField.hscroll, TextField.maxhscroll, TextField.maxscroll, TextField.scroll
TextField.onSetFocus
Disponibilidad
Flash Player 6.
Sintaxis
TextField.onSetFocus = function(selecciónAnterior){
sentencias;
};
Parámetros
selecciónAnterior
El objeto que dejará de estar seleccionado.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando un campo de texto se selecciona mediante el teclado. El
parámetro selecciónAnterior es el objeto que deja de estar seleccionado. Por ejemplo, si el
usuario presiona el tabulador para mover la selección de entrada de un botón a un campo de
texto, selecciónAnterior contiene la instancia de campo de texto.
Si no hay ningún objeto seleccionado anteriormente, selecciónAnterior contiene un valor null.
TextField._parent
Disponibilidad
Flash Player 6.
Sintaxis
_parent.property
_parent._parent.property
Descripción
Propiedad; especifica o devuelve una referencia al clip de película que contiene el objeto o el clip de
película. El objeto actual es el objeto que contiene el código de ActionScript que hace referencia a
_parent. Utilice _parent para especificar una ruta relativa a los clips de película u objetos que están
por encima del clip de película u objeto actual.
Véase también
_root, targetPath
451
TextField.password
Disponibilidad
Flash Player 6.
Sintaxis
TextField.password
Descripción
Propiedad; si el valor de password es true, el campo de texto es un campo de texto de contraseña
y oculta los caracteres de entrada. Si su valor es false, el campo de texto no es de contraseña.
TextField._quality
Disponibilidad
Flash Player 6.
Sintaxis
TextField._quality
Descripción
Propiedad (global); establece o recupera la calidad de representación utilizada para una película.
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"
•
"HIGH"
•
"BEST"
Calidad de representación baja. No se suavizan ni los gráficos ni los mapas de bits.
Calidad de representación media. Los gráficos se suavizan con una cuadrícula de
2x2, en píxeles, pero los mapas de bits no se suavizan. Apropiado para películas que no
contienen texto.
"MEDIUM"
Calidad de representación alta. Los gráficos se suavizan con una cuadrícula de 4x4,
en píxeles, y los mapas de bits se suavizan si la película es estática. Esta es la configuración de la
calidad de representación predeterminada utilizada por Flash.
Calidad de representación muy alta. Los gráficos se suavizan con una cuadrícula de
4x4, en píxeles, y los mapas de bits se suavizan siempre.
Ejemplo
En el ejemplo siguiente, se define la calidad de representación en LOW:
textfield._quality = "LOW";
Véase también
_highquality, toggleHighQuality
452
TextField.removeListener
Disponibilidad
Flash Player 6.
Sintaxis
Selection.removeListener(detector)
Parámetros
detector
Objeto que ya no recibirá notificaciones sobre el elemento seleccionado.
Valor devuelto
Si el detector se ha eliminado correctamente, el método 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 método devuelve el valor false.
Descripción
Método; elimina un objeto detector previamente registrado en una instancia de campo de texto
con addListener.
TextField.removeTextField
Disponibilidad
Flash Player 6.
Sintaxis
TextField.removeTextField()
Descripción
Método; elimina el campo de texto especificado por TextField. Esta operación sólo se puede
realizar en un campo de texto creado con el método createTextField del objeto MovieClip. No
funcionará en campos de texto colocados por la línea de tiempo. Cuando se llama a este método,
el campo de texto recibe la orden de eliminarse a sí mismo. Es parecido al método
MovieClip.removeMovieClip.
Véase también
MovieClip.createTextField
TextField.replaceSel
Disponibilidad
Flash Player 6.
Sintaxis
TextField.replaceSel(texto)
Parámetros
texto
Una cadena.
Valor devuelto
Ninguno.
453
Descripción
Método; reemplaza el elemento seleccionado por el contenido del parámetro texto. El texto se
inserta en la posición de la selección, con el formato de carácter y párrafo predeterminados. El
texto no se trata como si fuera HTML, ni siquiera cuando el campo de texto es HTML.
Puede utilizar el método replaceSel para insertar y eliminar texto sin que el formato de carácter
y de párrafo del resto del texto se vea afectado.
TextField.restrict
Disponibilidad
Flash Player 6.
Sintaxis
TextField.restrict
Descripción
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 carácter. Si el
valor de la propiedad restrict es una cadena vacía, no se puede introducir ningún carácter. Si el
valor de la propiedad restrict es una cadena de caracteres, sólo 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 guión (-). De este modo sólo se limita la interacción del usuario; un
script puede introducir cualquier texto en el campo de texto. Esta propiedad no se sincroniza con
las casillas de verificación 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 ningún carácter y los caracteres posteriores de la cadena se incluyen en el
conjunto de caracteres aceptados.
Ejemplo
En el ejemplo siguiente sólo se pueden introducir caracteres en mayúsculas, espacios y números 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 minúsculas:
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 carácter real de la cadena, de modo que cuando
se especifique en ActionScript, deben utilizarse dos. Por ejemplo, el código siguiente incluye sólo
el guión (-) y el carácter de intercalación (^):
my_txt.restrict = "\\-\\^";
El ^ puede utilizarse en cualquier posición de la cadena para alternar la inclusión y la exclusión de
caracteres. El código siguiente incluye sólo letras mayúsculas, pero excluye la letra mayúscula Q:
my_txt.restrict = "A-Z^Q";
Puede utilizar la secuencia de escape \u para crear cadenas restrict. El código siguiente incluye
sólo 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
Descripción
Propiedad; especifica la rotación del campo de texto en grados.
TextField.scroll
Disponibilidad
Flash Player 6.
Sintaxis
TextField.scroll
Descripción
Propiedad; define la posición vertical del texto de un campo de texto. La propiedad scroll es útil
para dirigir a los usuarios a un párrafo específico en un pasaje largo, o para crear campos de texto
con desplazamiento. Esta propiedad puede recuperarse y modificarse.
Ejemplo
El código siguiente está asociado a un botón Arriba que desplaza el contenido del campo de texto
myText.
on (release) {
myText.scroll = myText.scroll + 1;
}
Véase también
TextField.maxscroll, TextField.scroll
TextField.selectable
Disponibilidad
Flash Player 6.
Sintaxis
TextField.selectable
Descripción
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)
Parámetros
textFormat
Instancia del objeto TextFormat.
Valor devuelto
Ninguno.
Descripción
Método; establece un objeto TextFormat para el texto recién insertado, por ejemplo, texto
insertado con el método 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
información de formato de carácter y de párrafo. La información de formato de carácter describe
el aspecto de cada carácter, como por ejemplo, el nombre de la fuente, el tamaño en puntos, el
color y el URL asociado. La información de formato de párrafo describe el aspecto de un párrafo,
como por ejemplo, el margen izquierdo, el margen derecho, la sangría de la primera línea y la
alineación a la izquierda, a la derecha o centrada.
Véase también
TextField.getNewTextFormat, TextField.getTextFormat, TextField.setTextFormat
TextField.setTextFormat
Disponibilidad
Flash Player 6.
Sintaxis
TextField.setTextFormat (textFormat)
TextField.setTextFormat (índice, textFormat)
TextField.setTextFormat (iniciarÍndice, terminarÍndice, textFormat)
Parámetros
iniciarÍndice
terminarÍndice
Un número entero.
Un número entero que especifica el primer carácter después del espacio de
texto deseado.
textFormat Instancia del objeto TextFormat. Un objeto TextFormat contiene información de
formato de carácter y de párrafo.
Valor devuelto
Ninguno.
456
Descripción
Método; 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 carácter de un campo de texto. El
formato de texto del primer carácter de un párrafo se examina para asignar formato de párrafo a
todo el párrafo. El método 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
información de formato de carácter y de párrafo. La información de formato de carácter describe
el aspecto de cada carácter, por ejemplo, el nombre de fuente, el tamaño en puntos, el color y el
URL asociado. La información de formato de párrafo describe el aspecto de un párrafo, por
ejemplo, el margen izquierdo, el margen derecho, la sangría de la primera línea y la alineación 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 carácter situado en la posición índice.
Sintaxis 3: aplica las propiedades del parámetro textFormat al espacio de texto desde el
parámetro iniciarÍndice hasta el parámetro terminarÍndice.
Ejemplo
Este ejemplo crea un nuevo objeto TextFormat llamado myTextFormat y establece su propiedad
bold en true. A continuación, llama al método setTextFormat y aplica el nuevo formato de
texto al campo de texto myTextField.
myTextFormat = new TextFormat();
myTextFormat.bold = true;
myTextField.setTextFormat(myTextFormat);
Véase también
TextFormat (objeto)
TextField._soundbuftime
Disponibilidad
Flash Player 6.
Sintaxis
TextField._soundbuftime
Descripción
Propiedad (global); entero que especifica el número 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
Descripción
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
tabulación automático; si la propiedad tabIndex se establece también en un valor, el objeto se
incluye en el orden de tabulación personalizado. Si el valor de tabEnabled es false, el objeto no
se incluye en el orden de tabulación automático. En el caso de un clip de película, si tabEnabled
es false, los valores secundarios del clip de película pueden seguir incluyéndose en el orden de
tabulación automático, a menos que la propiedad tabChildren también se establezca en false.
Si tabEnabled es undefined o true, el objeto se incluye en el orden de tabulación personalizado
si se ha establecido la propiedad tabIndex. Si tabEnabled es false, el objeto no se incluye en el
orden de tabulación personalizado, aunque se establezca la propiedad tabIndex. Si tabEnabled
se establece en false en un clip de película, los valores secundarios del clip de película pueden
seguir incluyéndose en el orden de tabulación personalizado.
TextField.tabIndex
Disponibilidad
Flash Player 6.
Sintaxis
TextField.tabIndex
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Propiedad; permite personalizar el orden de tabulación de los objetos de una película. Puede
establecer la propiedad tabIndex de un botón, un clip de película o una instancia de campo de
texto; de manera predeterminada es undefined.
Si alguno de los objetos que se muestran en la película Flash contiene una propiedad tabIndex, el
orden de tabulación automático está desactivado, y el orden de tabulación se calcula a partir de las
propiedades tabIndex de los objetos de la película. El orden de tabulación personalizado sólo
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 tabulación es undefined.
458
El orden de tabulación personalizado definido por la propiedad tabIndex es flat. Esto significa que
no se tienen en cuenta las relaciones jerárquicas de los objetos de la película Flash. Todos los objetos
de la película Flash con propiedades tabIndex se colocan en el orden de tabulación, 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
Descripción
Propiedad (sólo lectura); devuelve la ruta de destino de la instancia de campo de texto especificada
en el parámetro TextField.
TextField.text
Disponibilidad
Flash Player 6.
Sintaxis
TextField.text
Descripción
Propiedad; indica el texto actual en el campo de texto. Las líneas se separan mediante el carácter
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.
Véase también
TextField.htmlText
TextField.textColor
Disponibilidad
Flash Player 6.
Sintaxis
TextField.textColor
Descripción
Propiedad; indica el color del texto de un campo de texto.
TextField.textHeight
Disponibilidad
Flash Player 6.
Sintaxis
TextField.textHeight
Descripción
Propiedad; indica la altura del texto.
459
TextField.textWidth
Disponibilidad
Flash Player 6.
Sintaxis
TextField.textWidth
Descripción
Propiedad; indica la anchura del texto.
TextField.type
Disponibilidad
Flash Player 6.
Sintaxis
TextField.type
Descripción
Propiedad; especifica el tipo de campo de texto. Hay dos valores: "dynamic", que especifica un
campo de texto dinámico (no puede editarlo el usuario) e "input", que especifica un campo de
introducción de texto.
Ejemplo
TextField.type = "dynamic";
TextField._url
Disponibilidad
Flash Player 6.
Sintaxis
TextField._url
Descripción
Propiedad (sólo lectura); recupera el URL del archivo SWF que ha creado el campo de texto.
TextField.variable
Disponibilidad
Flash Player 6.
Sintaxis
TextField._variable
Descripción
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
Descripción
Propiedad; valor booleano que indica si el campo de texto especificado por el parámetro
TextField está visible. Los campos de texto que no están visibles (con la propiedad _visible
establecida en false) están desactivados.
TextField._width
Disponibilidad
Flash Player 6.
Sintaxis
TextField._width
Descripción
Propiedad; establece y recupera la anchura del campo de texto, en píxeles.
Ejemplo
En el ejemplo siguiente se establecen las propiedades de altura y anchura de un campo de texto:
myTextField._width=200;
myTextField._height=200;
Véase también
MovieClip._height
TextField.wordWrap
Disponibilidad
Flash Player 6.
Sintaxis
TextField.wordWrap
Descripción
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 ningún ajuste de texto.
461
TextField._x
Disponibilidad
Flash Player 6.
Sintaxis
TextField._x
Descripción
Propiedad; número entero que establece la coordenada x de un campo de texto en relación con las
coordenadas locales del clip de película principal. Si un campo de texto está en la línea 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 película que tiene transformaciones, el
campo de texto está en el sistema de coordenadas local del clip de película que lo contiene. Por lo
tanto, en el caso de un clip de película 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 posición del punto de registro.
Véase también
TextField._xscale, TextField._y, TextField._yscale
TextField._xmouse
Disponibilidad
Flash Player 6.
Sintaxis
TextField._xmouse
Descripción
Propiedad (sólo lectura); devuelve la coordenada x de la posición del ratón respecto al campo de
texto.
Véase también
TextField._ymouse
TextField._xscale
Disponibilidad
Flash Player 6.
Sintaxis
TextField._xscale
Descripción
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).
Véase también
TextField._x, TextField._y, TextField._yscale
462
TextField._y
Disponibilidad
Flash Player 6.
Sintaxis
TextField._y
Descripción
Propiedad; establece la coordenada y de un campo de texto en relación con las coordenadas locales
del clip de película principal. Si un campo de texto está en la línea 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 película que tiene transformaciones, el campo de texto está
en el sistema de coordenadas local del clip de película que lo contiene. Por lo tanto, en el caso de un
clip de película 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 posición del punto de registro.
Véase también
TextField._x, TextField._xscale, TextField._yscale
TextField._ymouse
Disponibilidad
Flash Player 6.
Sintaxis
TextField._ymouse
Descripción
Propiedad (sólo lectura); indica la coordenada y de la posición del ratón en relación con el campo
de texto.
Véase también
TextField._xmouse
TextField._yscale
Disponibilidad
Flash Player 6.
Sintaxis
TextField._yscale
Descripción
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).
Véase también
TextField._x, TextField._xscale, TextField._y
463
TextFormat (objeto)
El objeto TextFormat representa información de formato de carácter.
Debe utilizar el constructor new TextFormat para crear una instancia del objeto TextFormat
antes de llamar a sus métodos.
Puede establecer los parámetros TextFormat en null para indicar que no están definidos. Al
aplicar un objeto TextFormat a un campo de texto con el método setTextFormat, sólo se aplican
sus propiedades definidas, como ocurre en el ejemplo siguiente:
myTextFormat = new TextFormat();
myTextFormat.bold = true;
myTextField.setTextFormat(myTextFormat);
Primero, este código crea un objeto TextFormat vacío con todas sus propiedades sin definir; a
continuación, establece la propiedad bold en un valor definido.
El código myTextField.setTextFormat(myTextFormat) sólo 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 demás 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 métodos del objeto TextFormat
Método
Descripción
TextFormat.getTextExtent
Devuelve un objeto con dos propiedades, width y height, que indican el
tamaño del texto de un campo de texto.
Resumen de las propiedades del objeto TextFormat
464
Propiedad
Descripción
TextFormat.align
Indica la alineación de un párrafo.
TextFormat.blockIndent
Indica la sangría de bloque en puntos.
TextFormat.bold
Indica si el texto está en negrita.
TextFormat.bullet
Indica si el texto forma parte de una lista con viñetas.
TextFormat.color
Indica el color del texto.
TextFormat.font
Indica el nombre de fuente del texto con un formato de texto.
TextFormat.indent
Indica la sangría desde el margen izquierdo al primer carácter del párrafo.
TextFormat.italic
Indica si el texto está en cursiva.
TextFormat.leading
Indica la cantidad de espacio vertical entre líneas.
TextFormat.leftMargin
Indica el margen izquierdo del párrafo, en puntos.
TextFormat.rightMargin
Indica el margen derecho del párrafo, en puntos.
TextFormat.tabStops
Especifica tabulaciones personalizadas.
TextFormat.target
Indica la ventana de un navegador en la que aparece un hipervínculo.
TextFormat.size
Indica el tamaño del texto en puntos.
Propiedad
Descripción
TextFormat.underline
Indica si el texto está subrayado.
TextFormat.url
Indica el URL al que el texto se vincula.
Constructor del objeto TextFormat
Sintaxis
new TextFormat([fuente, [tamaño, [color, [negrita, [cursiva, [subrayado, [url,
[destino, [alineación, [margenIzquierdo, [margenDerecho, [sangría,
[espacio]]]]]]]]]]]]])
Parámetros
fuente
Nombre de una fuente para el texto en forma de cadena.
tamaño
Número entero que indica el tamaño en puntos.
Color de texto que utiliza este formato de texto. Número que contiene tres componentes
RGB de 8 bits; por ejemplo, 0xFF0000 es rojo y 0x00FF00 es verde.
color
negrita
Valor booleano que indica si el texto está en negrita.
cursiva
Valor booleano que indica si el texto está en cursiva.
Valor booleano que indica si el texto está subrayado.
subrayado
URL para el que el texto de este formato actúa como hipervínculo. Si url es una cadena
vacía, el texto no tiene hipervínculo.
url
destino Ventana de destino en la que se muestra el hipervínculo. Si la ventana de destino es
una cadena vacía, el texto se muestra en la ventana de destino _self. Si la propiedad
TextFormat.url se establece en una cadena vacía o en el valor null, esta propiedad puede
obtenerse o establecerse pero no tiene ningún efecto.
alineación Alineación del párrafo, representado como una cadena. Si su valor es "left", el
párrafo se alinea a la izquierda. Si su valor es "center", el párrafo se centra. Si su valor es
"right", el párrafo se alinea a la derecha.
margenIzquierdo
margenDerecho
sangría
Indica el margen izquierdo del párrafo, en puntos.
Indica el margen derecho del párrafo, en puntos.
Número entero que indica la sangría desde el margen izquierdo al primer carácter del
párrafo.
espacio
Número que indica la cantidad de espacio vertical entre líneas.
Descripción
Constructor; crea una instancia del objeto TextFormat con las propiedades especificadas. A
continuación, puede cambiar las propiedades del objeto TextFormat para cambiar el formato de
los campos de texto.
Cualquier parámetro puede establecerse en el valor null para indicar que no está definido. Todos
los parámetros son opcionales; todos los parámetros omitidos se tratarán como si tuvieran el valor
null.
Disponibilidad
Flash Player 6.
465
TextFormat.align
Disponibilidad
Flash Player 6.
Sintaxis
TextFormat.align
Descripción
Propiedad; indica la alineación del párrafo, que se representa como una cadena. Alineación del
párrafo, que se representa como una cadena. Si su valor es "left", el párrafo se alinea a la
izquierda. Si su valor es "center", el párrafo se centra. Si su valor es "right", el párrafo 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
Descripción
Propiedad; número que indica la sangría de bloque en puntos. La sangría de bloque se aplica a
todo un bloque de texto; es decir, a todas las líneas del texto. En cambio, la sangría normal
(TextFormat.indent) sólo afecta a la primera línea de cada párrafo. Si el valor de esta propiedad
es null, el objeto TextFormat no especifica sangría de bloque.
TextFormat.bold
Disponibilidad
Flash Player 6.
Sintaxis
TextFormat.bold
Descripción
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
Descripción
Propiedad; valor booleano que indica que el texto forma parte de una lista con viñetas. En una
lista con viñetas, todos los párrafos del texto tienen sangría. A la izquierda de la primera línea de
cada párrafo, aparece un símbolo de viñeta. Si el valor de la propiedad es null, el objeto
TextFormat no especifica si el texto tiene viñetas o no.
466
TextFormat.color
Disponibilidad
Flash Player 6.
Sintaxis
TextFormat.color
Descripción
Propiedad; indica el color del texto. Número 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
Descripción
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)
Parámetros
texto
Una cadena.
Valor devuelto
Un objeto con las propiedades width y height.
Descripción
Método; devuelve el tamaño de la cadena de texto especificada en el parámetro texto de este
formato de carácter. 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
línea de texto; los saltos y avances de línea se ignoran y no se aplica ningún ajuste de texto.
TextFormat.indent
Disponibilidad
Flash Player 6.
Sintaxis
TextFormat.indent
Descripción
Propiedad; número entero que indica la sangría desde el margen izquierdo al primer carácter del
párrafo. El valor predeterminado es null, que indica que la propiedad no está definida.
467
TextFormat.italic
Disponibilidad
Flash Player 6.
Sintaxis
TextFormat.italic
Descripción
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
Descripción
Propiedad; cantidad de espacio vertical entre líneas. El valor predeterminado es null, que indica
que la propiedad no está definida.
TextFormat.leftMargin
Disponibilidad
Flash Player 6.
Sintaxis
TextFormat.leftMargin
Descripción
Propiedad; margen derecho del párrafo, en puntos. El valor predeterminado es null, que indica
que la propiedad no está definida.
TextFormat.rightMargin
Disponibilidad
Flash Player 6.
Sintaxis
TextFormat.rightMargin
Descripción
Propiedad; margen derecho del párrafo, 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
Descripción
Propiedad; tamaño 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
Descripción
Propiedad; especifica tabulaciones personalizadas en forma de matriz de números enteros no
negativos. Cada tabulación se especifica en puntos. Si no se especifican tabulaciones
personalizadas (null), la tabulación predeterminada es 4 (promedio de anchura de carácter).
TextFormat.target
Disponibilidad
Flash Player 6.
Sintaxis
TextFormat.target
Descripción
Propiedad; indica la ventana de destino en la que se muestra el hipervínculo. Si la ventana de
destino es una cadena vacía, el texto se muestra en la ventana de destino _self. Si la propiedad
TextFormat.url se establece en una cadena vacía o en el valor null, esta propiedad puede
obtenerse o establecerse pero no tiene ningún efecto.
TextFormat.underline
Disponibilidad
Flash Player 6.
Sintaxis
TextFormat.underline
Descripción
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
Descripción
Propiedad; indica el URL para el que el texto de este formato actúa como hipervínculo. Si la
propiedad url es una cadena vacía, el texto no tiene hipervínculo. El valor predeterminado es
null, que indica que la propiedad no está definida.
this
Disponibilidad
Flash Player 5.
Sintaxis
this
Descripción
Palabra clave; hace referencia a una instancia de objeto o de clip de película. Cuando se ejecuta un
script, this hace referencia a la instancia de clip de película que contiene el script. Cuando se
llama a un método, this contiene una referencia al objeto que contiene el método llamado.
Dentro de una acción de controlador de eventos on asociada a un botón, this se refiere a la línea
de tiempo que contiene el botón. Dentro de una acción de controlador de eventos onClipEvent
asociada a un clip de película, this se refiere a la línea de tiempo del propio clip de película.
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
película actual.
// establece la propiedad alfa del clip de película actual en 20
this._alpha = 20;
En la sentencia siguiente dentro de un controlador onClipEvent, la palabra clave this hace
referencia al clip de película actual.
// cuando se carga el clip de película, se inicia una operación startDrag
// para el clip de película actual.
onClipEvent (load) {
startDrag (this, true);
}
Véase también
new
470
toggleHighQuality
Disponibilidad
Flash 2.
Sintaxis
toggleHighQuality()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Acción; activa y desactiva el suavizado (antialiasing) en Flash Player. El suavizado suaviza los
bordes de los objetos y hace más lenta la reproducción de la película. La acción
toggleHighQuality afecta a todas las películas de Flash Player.
Ejemplo
El código siguiente podría aplicarse a un botón que, cuando se hace clic en él, activa o desactiva el
suavizado:
on(release) {
toggleHighQuality();
}
Véase también
_quality, _highquality
trace
Disponibilidad
Flash Player 4.
Sintaxis
trace(expresión)
Parámetros
Expresión cuyo valor debe comprobarse. Cuando se abre un archivo SWF en la
herramienta de edición de Flash (mediante el comando Probar película), el valor del parámetro
expresión se muestra en la ventana Salida.
expresión
Valor devuelto
Ninguno.
Descripción
Acción; comprueba el valor de la expresión y muestra el resultado en la ventana Salida en modo
de prueba.
La acción trace sirve para grabar notas de programación o para ver mensajes en la ventana Salida
mientras se prueba una película. El parámetro expresión sirve para comprobar si existe una condición
o para ver valores en la ventana Salida. La acción trace es similar a la función alert de JavaScript.
Puede utilizar el comando Omitir acciones de seguimiento de Configuración de publicación para
eliminar acciones trace del archivo SWF exportado.
471
Ejemplo
Este ejemplo corresponde a un juego en el que una instancia de clip de película arrastrable llamada
rabbi debe soltarse en un destino específico. Una sentencia condicional comprueba el valor de la
propiedad _droptarget y ejecuta diferentes acciones dependiendo de donde se suelta la instancia
de clip de película rabbi. La acción trace se utiliza al final del script para comprobar el valor de la
ubicación del clip de película 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 acción trace le ayudarán 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
Descripción
Valor booleano único que representa lo contrario de false.
Véase también
false
typeof
Disponibilidad
Flash Player 5.
Sintaxis
typeof expresión
Parámetros
expresión
472
Cadena, clip de película, botón, objeto o función.
Descripción
Operador; operador unario situado antes de un solo parámetro. El operador typeof hace que el
intérprete de Flash compruebe el valor del parámetro expresión; el resultado es una cadena que
especifica si la expresión es una cadena, un clip de película, un objeto o una función. En la tabla
siguiente se muestran los resultados del operador typeof en cada tipo de expresión:
Parámetro
Resultado
Cadena
string
ClipPelícula
movieclip
Botón
object
Campo de texto
object
Número
number
Booleano
boolean
Objeto
object
Función
function
undefined
Disponibilidad
Flash Player 5.
Sintaxis
undefined
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Valor especial que normalmente se utiliza para indicar que aún no se ha asignado ningún valor a
una variable. Una referencia a un valor sin definir devuelve el valor especial undefined. El código
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 vacía.
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 código, el operador de igualdad (==) compara el valor de x con el valor
undefined y el resultado se envía a la ventana Salida. En la segunda parte del código, el operador
de igualdad compara los valores null y undefined.
// x aún 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 especificación ECMA-262, undefined se convierte en la cadena “undefined”, no en la cadena vacía.
Ésta es una de las diferencias entre ActionScript y la especificación ECMA-262.
unescape
Disponibilidad
Flash Player 5.
Sintaxis
unescape(x)
Parámetros
x
Cadena con secuencias hexadecimales de escape.
Valor devuelto
Ninguno.
Descripción
Función 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 conversión 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 continuación:
("Hola%7B%5BMundo%5D%7D");
La función unescape sirve para volver al formato original:
unescape("Hola%7B%5BMundo%5D%7D")
El resultado es el que se muestra a continuación:
Hola{[Mundo]}
unloadMovie
Disponibilidad
Flash Player 3.
Sintaxis
unloadMovie[Num](nivel/"destino")
Parámetros
nivel Nivel (_levelN) de una película cargada. Cuando se descarga una película de un nivel, la
acción 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 película.
Valor devuelto
Ninguno.
Descripción
Acción; elimina una película cargada o un clip de película de Flash Player. Para descargar una
película que se ha cargado en un nivel en Flash Player, utilice el parámetro nivel. Para descargar
un clip de película cargado, utilice el parámetro destino.
Ejemplo
En el ejemplo siguiente se descarga el clip de película draggable en la línea de tiempo principal y
se carga la película movie.swf en el nivel 4.
on (press) {
unloadMovie ("_root.draggable");
loadMovieNum ("movie.swf", 4);
}
En el ejemplo siguiente se descarga la película cargada en el nivel 4:
on (press) {
unloadMovieNum (4);
}
Véase también
loadMovie, loadMovieNum, unloadMovieNum
475
unloadMovieNum
Disponibilidad
Flash Player 3.
Sintaxis
unloadMovieNum(nivel)
Parámetros
nivel
Nivel (_levelN) de una película cargada.
Valor devuelto
Ninguno.
Descripción
Acción; elimina una película cargada de Flash Player.
Véase también
loadMovie, loadMovieNum
updateAfterEvent
Disponibilidad
Flash Player 5.
Sintaxis
updateAfterEvent()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Acción; actualiza la visualización (independientemente de los fotogramas por segundo
establecidos para la película) cuando el usuario la llama en un controlador onClipEvent o como
parte de una función o un método 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 función o un método pasado a setInterval.
Véase también
onClipEvent, setInterval
476
var
Disponibilidad
Flash Player 5.
Sintaxis
var nombreVariable1 [= valor1] [...,nombreVariableN [=valorN]]
Parámetros
nombreVariable
valor
Un identificador.
Valor asignado a la variable.
Valor devuelto
Ninguno.
Descripción
Acción; se utiliza para declarar variables locales. Si declara variables locales dentro de una función,
las variables se definen para la función y expiran al final de la llamada a la función. Si las variables
no se declaran dentro de un bloque ({}), pero la lista de acciones se ejecutó con una acción 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 acción call, las variables no son locales.
Ejemplo
En los ejemplos siguientes, se utiliza la acción 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 (expresión)
Descripción
Operador; operador unario que descarta el valor expresión 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(condición) {
sentencia(s);
}
Parámetros
condición Expresión cuyo valor se vuelve a comprobar cada vez que se ejecuta la acción while.
Si el valor de la sentencia es true, se ejecuta(n) la(s)sentencia(s).
sentencia(s)
Código que debe ejecutarse si el valor de la condición es true.
Valor devuelto
Ninguno.
Descripción
Acción; comprueba el valor de una expresión y ejecuta una sentencia o una serie de sentencias
varias veces en un bucle, siempre que el valor de la expresión sea true.
Antes de que se ejecute el bloque de sentencia, se comprueba la condición; si se obtiene como
resultado el valor true, se ejecuta el bloque de sentencia. Si la condición es false, el bloque de
sentencia se omite y se ejecuta la primera sentencia después de ejecutar el bloque de sentencia de
la acción while.
Los bucles se utilizan con frecuencia para realizar una acción 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 condición deja de ser true y el
bucle termina.
La sentencia while efectúa la siguiente serie de pasos. Cada repetición de los pasos 1 al 4 se
denomina una repetición del bucle. Al principio de cada repetición, se vuelve a comprobar el valor
de la condición, tal como se describe en los pasos siguientes:
1
Se comprueba el valor de la expresión condición.
2
Siga con el paso 3 si el valor de la condición es true o un valor que convierte al valor
booleano true, como por ejemplo, cualquier número distinto de cero.
En caso contrario, la sentencia while finaliza y la ejecución se reanuda en la siguiente sentencia
tras el bucle while.
478
3
Ejecute el bloque de sentencia sentencia(s).
4
Vaya al paso 1.
Ejemplo
Este ejemplo duplica cinco clips de película en el escenario, cada uno con una posición x e y generadas
aleatoriamente, xscale, yscale y la propiedad _alpha para conseguir un efecto de dispersión. La
variable foo se inicializa con el valor 0. El parámetro condición 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 película y se utiliza setProperty para ajustar las diferentes propiedades del clip
de película duplicado. La última sentencia del bucle incrementa la variable foo de modo que cuando
el valor llega a 5, el valor del parámetro condición 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++;
}
}
Véase también
do while, continue, for, for..in
with
Disponibilidad
Flash Player 5.
Sintaxis
with (objeto) {
sentencia(s);
}
Parámetros
objeto
Instancia de un objeto o clip de película de ActionScript.
sentencia(s)
Acción o grupo de acciones entre llaves.
Valor devuelto
Ninguno.
Descripción
Acción; permite especificar un objeto (por ejemplo, un clip de película) con el parámetro objeto y
comprobar el valor de expresiones y acciones dentro de un objeto con el parámetro sentencia(s).
Esto evita que tenga que escribir el nombre del objeto o la ruta al objeto continuamente.
El parámetro objeto pasa a ser el contexto en el que se leen las propiedades, variables y
funciones en el parámetro sentencia(s). Por ejemplo, si el objeto es myArray y dos de las
propiedades especificadas son length y concat, dichas propiedades se leen automáticamente
como myArray.length y myArray.concat. En otro ejemplo, si el objeto es state.california,
se llama a las acciones y sentencias de la acción with desde la instancia california.
479
Para averiguar el valor de un identificador del parámetro 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 específico.
La cadena de ámbito utilizada por la acción with para resolver identificadores comienza con el
primer elemento de la lista siguiente y continúa hasta el último:
• El objeto especificado en el parámetro objeto de la acción with más interior.
• El objeto especificado en el parámetro object de la acción with más exterior.
• El objeto Activation (objeto temporal que se crea automáticamente cuando se llama a una
función que contiene las variables locales a las que se ha llamado en la función).
• El clip de película contiene el script que se ejecuta.
• El objeto Global (objetos incorporados, como Math y String).
Para establecer una variable dentro de una acción with, la variable debe haber sido declarada fuera
de la acción with o debe introducir la ruta de acceso completa a la línea de tiempo en la que desea
que resida la variable. Si establece una variable en una acción with sin haberla declarado, la acción
with buscará el valor según la cadena de ámbito. Si la variable todavía no existe, el nuevo valor se
establecerá en la línea de tiempo desde la que se llamó a la acción with.
En Flash 5, la acción with reemplaza a la acción tellTarget desestimada. Se recomienda utilizar
with en lugar de tellTarget debido a que es una extensión estándar de ActionScript del
estándar ECMA-262. La diferencia principal entre las acciones with y tellTarget es que with
toma una referencia a un clip de película o a otro objeto como parámetro, mientras que
tellTarget toma una cadena de ruta de destino que identifica un clip de película como su
parámetro 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
después se ordena a someOtherMovieClip que vaya al fotograma 3 y se detenga.
with (someOtherMovieClip) {
_x = 50;
_y = 100;
gotoAndStop(3);
}
El siguiente fragmento de código muestra cómo escribir el código anterior sin utilizar una acción
with.
someOtherMovieClip._x = 50;
someOtherMovieClip._y = 100;
someOtherMovieClip.gotoAndStop(3);
También podría escribir este código mediante la acción tellTarget. Sin embargo, si
someOtherMovieClip no fuera un clip de película, sino un objeto, no podría utilizar la acción
with.
tellTarget ("someOtherMovieClip") {
_x = 50;
_y = 100;
gotoAndStop(3);
}
480
La acción with es útil para acceder a varios elementos de una lista de cadena de ámbito
simultáneamente. En el ejemplo siguiente, el objeto incorporado Math se sitúa 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 métodos ni propiedades del objeto Math, pero como existen en el
ámbito de activación de objeto de la función 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 información 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;
}
}
Véase también
tellTarget
481
XML (objeto)
Utilice los métodos 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 métodos del objeto XML.
XML se admite en Flash Player 5 y Flash Player 6.
Resumen de los métodos del objeto XML
Método
Descripción
XML.appendChild
Anexa un nodo al final de la lista del objeto secundario especificado.
XML.cloneNode
Duplica el nodo especificado y, como opción, duplica repetidamente todos los nodos
secundarios.
XML.createElement
Crea un nuevo elemento XML.
XML.createTextNode
Crea un nuevo nodo de texto XML.
XML.getBytesLoaded
Devuelve el número de bytes cargados para el documento XML especificado.
XML.getBytesTotal
Devuelve el tamaño del documento XML en bytes.
XML.hasChildNodes
Devuelve true si el nodo especificado tiene nodos secundarios; de lo contrario,
devuelve false.
XML.insertBefore
Inserta un nodo delante de un nodo existente en la lista de nodos secundarios
especificada.
XML.load
Carga un documento (especificado por el objeto XML) de un URL.
XML.parseXML
Analiza un documento XML en el árbol de objeto XML especificado.
XML.removeNode
Elimina el nodo especificado de su principal.
XML.send
Envía el objeto XML especificado a un URL.
XML.sendAndLoad
Envía el objeto XML especificado a un URL y carga la respuesta del servidor en otro
objeto XML.
XML.toString
Convierte el nodo especificado y cualquiera de sus secundarios en texto XML.
Resumen de las propiedades del objeto XML
482
Propiedad
Descripción
XML.contentType
Indica el tipo MIME transmitido al servidor.
XML.docTypeDecl
Establece y devuelve información sobre la declaración DOCTYPE de un documento
XML.
XML.firstChild
Hace referencia al primer nodo secundario de la lista del nodo especificado.
XML.ignoreWhite
Cuando se establecen en true, los nodos de texto que sólo contienen espacios en
blanco se descartan durante el proceso de análisis.
XML.lastChild
Hace referencia al último nodo secundario de la lista del nodo especificado.
XML.load
Comprueba si se ha cargado el objeto XML especificado.
XML.nextSibling
Hace referencia al siguiente valor colateral en la lista de nodos secundarios del nodo
principal.
Propiedad
Descripción
XML.nodeName
Devuelve el nombre de etiqueta de un elemento XML.
XML.nodeType
Devuelve el tipo del nodo especificado (nodo de texto o elemento XML).
XML.nodeValue
Devuelve el texto del nodo especificado si el nodo es un nodo de texto.
XML.parentNode
Hace referencia al nodo principal del nodo especificado.
XML.previousSibling
Hace referencia al valor colateral anterior en la lista de nodos secundarios del nodo
principal.
XML.status
Devuelve el código de estado numérico que indica el éxito o el fracaso de una
operación de análisis de un documento XML.
XML.xmlDecl
Establece y devuelve la información sobre la declaración de un documento XML.
Resumen de los métodos del objeto XML
Método
Descripción
XML.attributes
Devuelve una matriz asociativa que contiene todos los atributos del nodo
especificado.
XML.childNodes
Devuelve una matriz que contiene la referencia a los nodos secundarios del nodo
especificado.
Resumen del controlador de eventos del objeto XML
Método
Descripción
XML.onData
Función 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.
XML.onLoad
Función callback para load y sendAndLoad.
Constructor del objeto XML.
Disponibilidad
Flash Player 5.
Sintaxis
new XML([origen])
Parámetros
origen
El documento XML que se va a analizar para crear un nuevo objeto XML.
Valor devuelto
Ninguno.
Descripción
Constructor; crea un nuevo objeto XML. Debe utilizar el método constructor para crear una
instancia del objeto XML antes de llamar a cualquiera de los métodos del objeto XML.
Nota: los métodos createElement y createTextNode son los métodos ‘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 vacío.
myXML = new XML();
Sintaxis 2: en el ejemplo siguiente se crea un objeto XML analizando el texto XML especificado
en el parámetro origen y se rellena el objeto XML recién creado con el árbol del documento
XML resultante.
anyOtherXML = new XML("<state>California<city>San Francisco</city></state>");
Véase también
XML.createElement, XML.createTextNode
XML.appendChild
Disponibilidad
Flash Player 5.
Sintaxis
myXML.appendChild(nodoSecundario)
Parámetros
nodoSecundario Nodo secundario que debe agregarse a la lista de nodos secundarios del objeto
XML que se ha especificado.
Valor devuelto
Ninguno.
Descripción
Método; 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
Parámetros
Ninguno.
Valor devuelto
Ninguno.
484
Descripción
Colección (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 continuación es lo que aparece en la ventana Salida.
Val
first
XML.childNodes
Disponibilidad
Flash Player 5.
Sintaxis
myXML.childNodes
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Colección (sólo 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 sólo lectura y no puede utilizarse para manipular
nodos secundarios. Los métodos appendChild, insertBefore y removeNode sirven para
manipular nodos secundarios.
Esta colección no está definida para nodos de texto (nodeType == 3).
Véase también
XML.nodeType
XML.cloneNode
Disponibilidad
Flash Player 5.
Sintaxis
myXML.cloneNode(prof)
Parámetros
Valor booleano que especifica si los valores secundarios del objeto XML especificado se
duplican repetidamente.
prof
485
Valor devuelto
Ninguno.
Descripción
Método; 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 efectúa
una copia de clip, firstChild y lastChild también son null.
XML.contentType
Disponibilidad
Flash Player 6.
Sintaxis
myXML.contentType
Descripción
Propiedad; tipo MIME que se envía al servidor cuando se llama al método XML.send o
XML.sendAndLoad. El valor predeterminado es application/x-www-form-urlencoded.
Véase también
XML.send, XML.sendAndLoad
XML.createElement
Disponibilidad
Flash Player 5.
Sintaxis
myXML.createElement(nombre)
Parámetros
nombre
Nombre de etiqueta del elemento XML que se está creando.
Valor devuelto
Ninguno.
Descripción
Método; crea un nuevo elemento XML con el nombre especificado en el parámetro. Inicialmente,
el nuevo elemento no tiene ningún elemento principal, secundario ni colateral. El método
devuelve una referencia al objeto XML recién creado que representa el elemento. Este método y
createTextNode son los métodos constructor para crear nodos para un objeto XML.
486
XML.createTextNode
Disponibilidad
Flash Player 5.
Sintaxis
myXML.createTextNode(texto)
Parámetros
texto
Texto utilizado para crear el nuevo nodo de texto.
Valor devuelto
Ninguno.
Descripción
Método; 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
método devuelve una referencia al objeto XML que representa el nuevo nodo de texto. Este
método y createElement son los métodos constructor para crear nodos para un objeto XML.
XML.docTypeDecl
Disponibilidad
Flash Player 5.
Sintaxis
myXML.XMLdocTypeDecl
Descripción
Propiedad; establece y devuelve información sobre la declaración 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 declaración DOCTYPE del documento XML. Por ejemplo,
<!DOCTYPE greeting SYSTEM "hello.dtd">. Esta propiedad se establece utilizando una
representación de cadena de la declaración DOCTYPE, no un objeto de nodo XML.
El analizador XML de ActionScript no es una analizador de validación. El analizador lee la
declaración DOCTYPE que, a continuación, se almacena en la propiedad docTypeDecl, pero no se
realiza ninguna validación DTD.
Si no se ha encontrado ninguna declaración DOCTYPE durante una operación de análisis,
XML.docTypeDecl se establece en undefined. XML.toString produce la salida del contenido
de XML.docTypeDecl inmediatamente después de la declaración 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 declaración DOCTYPE.
Ejemplo
En el ejemplo siguiente se utiliza XML.docTypeDecl para establecer la declaración DOCTYPE de un
objeto XML:
myXML.docTypeDecl = "<!DOCTYPE greeting SYSTEM \"hello.dtd\">";
Véase también
XML.toString, XML.xmlDecl
487
XML.firstChild
Disponibilidad
Flash Player 5.
Sintaxis
myXML.firstChild
Descripción
Propiedad (sólo lectura); evalúa 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 sólo lectura y no puede utilizarse para manipular nodos
secundarios; utilice los métodos appendChild, insertBefore y removeNode para manipular
nodos secundarios.
Véase también
XML.appendChild, XML.insertBefore, XML.removeNode
XML.getBytesLoaded
Disponibilidad
Flash Player 6.
Sintaxis
XML.getBytesLoaded()
Parámetros
Ninguno.
Valor devuelto
Entero que indica el número de bytes cargados.
Descripción
Método; devuelve el número 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.
Véase también
XML.getBytesTotal
XML.getBytesTotal
Disponibilidad
Flash Player 6.
Sintaxis
XML.getBytesTotal()
Parámetros
Ninguno.
Valor devuelto
Un número entero.
488
Descripción
Método; devuelve el tamaño, en bytes, del documento XML.
Véase también
XML.getBytesLoaded
XML.hasChildNodes
Disponibilidad
Flash Player 5.
Sintaxis
myXML.hasChildNodes()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; 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 información del objeto XML en una función definida por el
usuario.
if (rootNode.hasChildNodes()) {
myfunc (rootNode.firstChild);
}
XML.ignoreWhite
Disponibilidad
Flash Player 5.
Sintaxis
myXML.ignoreWhite = booleano
XML.prototype.ignoreWhite = booleano
Parámetros
booleano
Valor booleano (true o false).
Descripción
Propiedad; el valor predeterminado es false. Cuando se establecen en true, los nodos de texto
que sólo contienen espacios en blanco se descartan durante el proceso de análisis. 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 código siguiente:
myXML.ignoreWhite = true
489
XML.insertBefore
Disponibilidad
Flash Player 5.
Sintaxis
myXML.insertBefore(nodoSecundario, nodoAnterior)
Parámetros
Nodo que se va a insertar.
nodoSecundario
nodoAnterior
Nodo situado delante del punto de inserción de nodoSecundario.
Valor devuelto
Ninguno.
Descripción
Método; inserta un nuevo nodo secundario en la lista de nodos secundarios del objeto XML,
antes de nodoAnterior. Si el parámetro nodoAnterior no está definido o tiene el valor null, el
nodo se agrega con el método appendChild. Si nodoAnterior no es un nodo secundario de
myXML, la inserción no se realiza.
XML.lastChild
Disponibilidad
Flash Player 5.
Sintaxis
myXML.lastChild
Descripción
Propiedad (sólo lectura); evalúa el objeto XML y hace referencia al último nodo secundario en la
lista de nodos secundarios del nodo principal. Este método devuelve el valor null si el nodo no
tiene nodos secundarios. Esta es una propiedad de sólo lectura y no puede utilizarse para
manipular nodos secundarios; utilice los métodos appendChild, insertBefore y removeNode
para manipular nodos secundarios.
Véase también
XML.appendChild, XML.insertBefore, XML.removeNode
XML.load
Disponibilidad
Flash Player 5.
Sintaxis
myXML.load(url)
Parámetros
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 película.
490
Valor devuelto
Ninguno.
Descripción
Método; 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 asíncrono; no finaliza
inmediatamente después de que se ejecute el método load. Cuando se ejecuta el método 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 método onLoad. Los datos XML no
se analizan hasta que no se han descargado por completo. Si el objeto XML contenía
anteriormente cualquiera de los árboles XML, se descartan.
Puede especificar su propia función callback en lugar del método onLoad.
Ejemplo
A continuación, se muestra un ejemplo simple que utiliza XML.load:
doc = new XML();
doc.load ("theFile.xml");
Véase también
XML.loaded, XML.onLoad
XML.loaded
Disponibilidad
Flash Player 5.
Sintaxis
myXML.loaded
Descripción
Propiedad (sólo 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 método 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
Descripción
Propiedad (sólo lectura); evalúa el objeto XML y hace referencia al siguiente valor colateral en la
lista de nodos secundarios del nodo principal. Este método devuelve el valor null si el nodo no
tiene un nodo de valor colateral siguiente. Esta es una propiedad de sólo lectura y no puede
utilizarse para manipular nodos secundarios. Los métodos appendChild, insertBefore y
removeNode sirven para manipular nodos secundarios.
Véase también
XML.appendChild, XML.insertBefore, XML.removeNode
XML.nodeName
Disponibilidad
Flash Player 5.
Sintaxis
myXML.nodeName
Descripción
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.
Véase también
XML.nodeType
XML.nodeType
Disponibilidad
Flash Player 5.
Sintaxis
myXML.nodeType
Descripción
Propiedad (sólo lectura); toma o devuelve un valor nodeType, donde 1 es un elemento XML y 3
es un nodo de texto.
Véase también
XML.nodeValue
492
XML.nodeValue
Disponibilidad
Flash Player 5.
Sintaxis
myXML.nodeValue
Descripción
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 sólo lectura.
Véase también
XML.nodeType
XML.onData
Disponibilidad
Flash Player 5
Sintaxis
myXML.onData()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
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 análisis en
lugar de utilizar el analizador de XML de Flash. El método 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 método XML.onData invoca el método XML.onLoad. Puede sustituir
el método XML.onData por el comportamiento que desee, pero ya no se llamará al método
XML.onLoad a menos que lo haga en su implementación de XML.onData.
Ejemplo
En el ejemplo siguiente se muestra el aspecto que tiene el método 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 método XML.onData puede sustituirse para interceptar el texto XML sin analizarlo.
493
XML.onLoad
Disponibilidad
Flash Player 5.
Sintaxis
myXML.onLoad(correcto)
Parámetros
Valor booleano que indica si el objeto XML se ha cargado correctamente con una
operación XML.load o XML.sendAndLoad.
correcto
Valor devuelto
Ninguno.
Descripción
Método; invocado por Flash Player cuando se recibe del servidor un documento XML. Si el
documento XML se recibe correctamente, el parámetro 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
parámetro correcto es false. La implementación predeterminada de este método no está activa.
Para sustituir la implementación predeterminada, debe asignar una función que contenga las
acciones que desea.
Ejemplo
En el ejemplo siguiente se crea una película de Flash sencilla para una aplicación de escaparate de
tienda de comercio electrónico sencilla. El método sendAndLoad transmite un elemento XML
que contiene el nombre y la contraseña 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);
Véase también
function, XML.load, XML.sendAndLoad
494
XML.parentNode
Disponibilidad
Flash Player 5.
Sintaxis
myXML.parentNode
Descripción
Propiedad (sólo 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 sólo lectura y
no puede utilizarse para manipular nodos secundarios; utilice los métodos appendChild,
insertBefore y removeNode para manipular nodos secundarios.
XML.parseXML
Disponibilidad
Flash Player 5.
Sintaxis
myXML.parseXML(origen)
Parámetros
origen
El texto XML debe analizarse y pasarse al objeto XML especificado.
Valor devuelto
Ninguno.
Descripción
Método; analiza el texto XML especificado en el parámetro 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
Descripción
Propiedad (sólo 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 sólo lectura y no puede utilizarse para manipular nodos secundarios; utilice
los métodos appendChild, insertBefore y removeNode para manipular nodos secundarios.
495
XML.removeNode
Disponibilidad
Flash Player 5.
Sintaxis
myXML.childNodes[1].removeNode()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; elimina el objeto XML especificado de su principal. Todos los descendientes del nodo
también se eliminan.
XML.send
Disponibilidad
Flash Player 5.
Sintaxis
myXML.send(url, [ventana])
Parámetros
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 parámetro es opcional. No especificar ningún parámetro
ventana equivale a especificar _self.
ventana
Valor devuelto
Ninguno.
Descripción
Método; codifica el objeto XML especificado en un documento XML y lo envía al URL
especificado mediante el método POST.
496
XML.sendAndLoad
Disponibilidad
Flash Player 5.
Sintaxis
myXML.sendAndLoad(url,objetoXMLdestino)
Parámetros
url URL de destino para el objeto XML especificado. El URL debe pertenecer al mismo
subdominio que el URL de donde se descargó la película.
objetoXMLdestino Objeto XML creado con el método constructor XML que recibirá la
información devuelta del servidor.
Valor devuelto
Ninguno.
Descripción
Método; codifica el objeto XML especificado en un documento XML, lo envía al URL
especificado utilizando el método POST, descarga la respuesta del servidor y después la carga en el
objetoXMLdestino especificado en los parámetros. La respuesta del servidor se carga del mismo
modo utilizado por el método load.
Véase también
XML.load
XML.status
Disponibilidad
Flash Player 5.
Sintaxis
myXML.status
Descripción
Propiedad; establece y devuelve automáticamente un valor numérico que indica si se ha analizado
correctamente un documento XML en un objeto XML. Se muestra la siguiente lista con los
códigos de estado numéricos y una descripción de cada uno:
•
•
•
•
•
•
•
•
•
•
0 Sin errores; el análisis se completó correctamente.
-2 Una sección de CDATA no se finalizó correctamente.
-3 La declaración XML no se finalizó correctamente.
-4 La declaración 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 coincidía 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()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; comprueba el valor del objeto XML especificado, construye una representación 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 declaración XML del documento (almacenada en XML.xmlDecl), seguida de la
declaración DOCTYPE del documento (almacenada en XML.docTypeDecl), seguida de la
representación textual de todos los nodos XML del objeto. Si XML.xmlDecl está sin definir, no se
realiza la salida de declaración XML. Si XML.docTypeDecl está sin definir, no se realiza la salida
de la declaración DOCTYPE.
Ejemplo
El código siguiente es un ejemplo del método XML.toString que envía <h1>prueba</h1> a la
ventana Salida.
node = new XML("<h1>prueba</h1>");
trace(node.toString());
Véase también
XML.docTypeDecl, XML.xmlDecl
XML.xmlDecl
Disponibilidad
Flash Player 5.
Sintaxis
myXML.xmlDecl
Descripción
Propiedad; establece y devuelve información sobre la declaración XML de un documento. Una
vez analizado el documento XML en un objeto XML, esta propiedad se establece en el texto de la
declaración XML del documento. Esta propiedad se establece utilizando una representación de
cadena de la declaración XML, no un nodo de objeto XML. Si no se ha encontrado ninguna
declaración XML durante una operación de análisis, la propiedad se establece en undefined. XML.
El método 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 declaración XML.
498
Ejemplo
En el ejemplo siguiente se utiliza XML.xmlDecl para establecer la declaración de documento XML
de un objeto XML.
myXML.xmlDecl = "<?xml version=\"1.0\" ?>";
A continuación se muestra un ejemplo de declaración XML:
<?xml version="1.0" ?>
Véase también
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 dirección IP o un nombre de
dominio.
Utilización 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 continuación:
• Los mensajes XML se envían por una conexión socket en flujo TCP/IP de dúplex completo.
• Cada mensaje XML es un documento XML completo, finalizado en un byte cero.
• Se pueden enviar y recibir un número ilimitado de mensajes XML por una sola conexión
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 solución de chat basada en HTTP tradicional
consulta frecuentemente al servidor y descarga los nuevos mensajes utilizando una solicitud HTTP.
Por el contrario, una solución de chat XMLSocket mantiene una conexión 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 aplicación no requiere interactividad en tiempo real, utilice la acción 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.
Para utilizar los métodos del objeto XMLSocket, primero debe utilizar el constructor,
para crear un nuevo objeto XMLSocket.
mewXMLSocket,
XMLSocket y la seguridad
Debido a que el objeto XMLSocket establece y mantiene una conexión abierta con el servidor, se
han puesto las restricciones siguientes al objeto XMLSocket por razones de seguridad:
• El método XMLSocket.connect sólo puede conectarse a puertos TCP con un número superior
o igual a 1.024. Como consecuencia de esta restricción, los daemons del servidor que se
comunican con el objeto XMLSocket también deben asignarse a puertos con un número igual
o superior a 1.024. Los puertos con números 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 restricción de número de puerto limita la posibilidad de que se acceda
y se usen estos recursos de modo inapropiado.
499
• El método XMLSocket.connect puede conectarse solamente con equipos ubicados en el
mismo subdominio donde reside el archivo SWF (película). Esta restricción no se aplica a las
películas que se ejecutan fuera de un disco local. Esta restricción es idéntica a las normas de
seguridad de loadVariables, XML.sendAndLoad y XML.load.
Resumen de los métodos del objeto XMLSocket
Método
Descripción
XMLSocket.close
Cierra una conexión de socket abierta.
XMLSocket.connect
Establece una conexión con el servidor especificado.
XMLSocket.send
Envía un objeto XML al servidor.
Resumen del controlador de eventos del objeto XMLSocket
Método
Descripción
XMLSocket.onClose
Función callback invocada cuando se cierra una conexión XMLSocket.
XMLSocket.onConnect
Función callback invocada cuando se establece una conexión XMLSocket.
XMLSocket.onData
Función callback invocada cuando se descarga un mensaje XML del servidor.
XMLSocket.onXML
Función callback invocada cuando llega un objeto XML del servidor.
Constructor del objeto XMLSocket
Disponibilidad
Flash Player 5.
Sintaxis
new XMLSocket()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Constructor; crea un nuevo objeto XMLSocket. El objeto XMLSocket no está conectado
inicialmente con ningún servidor. Debe llamar al método XMLSocket.connect para conectar el
objeto con un servidor.
Ejemplo
myXMLSocket = new XMLSocket();
Véase también
XMLSocket.connect
500
XMLSocket.close
Disponibilidad
Flash Player 5.
Sintaxis
myXMLSocket.close()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; cierra la conexión especificada por el objeto XMLSocket.
Véase también
XMLSocket.connect
XMLSocket.connect
Disponibilidad
Flash Player 5.
Sintaxis
myXMLSocket.connect(host, puerto)
Parámetros
host Nombre de dominio DNS calificado o dirección IP con el formato aaa.bbb.ccc.ddd.
También puede especificar el valor null para conectarse al servidor host en el que reside la
película.
puerto Número de puerto TCP en el host utilizado para establecer una conexión. El número
de puerto debe ser 1024 o superior.
Valor devuelto
Ninguno.
Descripción
Método; establece una conexión 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 conexión se ha
establecido correctamente. Si no conoce el número de puerto de su equipo de Internet anfitrión,
póngase en contacto con su administrador de red. Si se está utilizando la conexión Flash Netscape
o el control ActiveX, el host especificado en el parámetro debe tener el mismo subdominio que el
host de donde se descargó la película.
Si se especifica el valor null para el parámetro host, el host con el que se establecerá contacto será
el host en el que reside la película que llama a XMLSocket.connect. Por ejemplo, si la película se
descargó de http://www.yoursite.com, especificar null para el parámetro host es lo mismo que
introducir la dirección IP de www.yoursite.com.
501
Si XMLSocket.connect devuelve el valor true, la fase inicial del proceso de conexión se realiza
correctamente; más tarde, se invoca el método XMLSocket.onConnect para determinar si la
conexión final se realizó correctamente o no. Si XMLSocket.connect devuelve el valor false,
significa que no se ha podido establecer la conexión.
Ejemplo
En el ejemplo siguiente se utiliza XMLSocket.connect para conectar con el host donde reside la
película y se utiliza trace para mostrar el valor devuelto que indica que la conexión se ha
realizado correctamente o no se ha realizado.
function myOnConnect(success) {
if (success) {
trace ("Conexión establecida")
} else {
trace ("Conexión no establecida")
}
}
socket = new XMLSocket()
socket.onConnect = myOnConnect
if (!socket.connect(null, 2000)) {
trace ("Conexión no establecida")
}
Véase también
function, XMLSocket.onConnect
XMLSocket.onClose
Disponibilidad
Flash Player 5.
Sintaxis
myXMLSocket.onClose()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; una función callback que se invoca solamente cuando el servidor cierra una conexión
abierta. La implementación predeterminada de este método no realiza acciones. Para sustituir la
implementación predeterminada, debe asignar una función que contenga las acciones que desea.
Véase también
function, XMLSocket.onConnect
502
XMLSocket.onConnect
Disponibilidad
Flash Player 5.
Sintaxis
myXMLSocket.onConnect(correcto)
Parámetros
correcto Valor
(true o false).
booleano que indica si una conexión de socket se ha establecido correctamente
Valor devuelto
Ninguno.
Descripción
Método; función callback que invoca Flash Player cuando una conexión cuya solicitud se ha iniciado
con el método XMLSocket.connect se ha realizado correctamente o no. Si la conexión se ha realizado
correctamente, el parámetro correcto es true; de lo contrario, el parámetro correcto es false.
La implementación predeterminada de este método no realiza acciones. Para sustituir la
implementación predeterminada, debe asignar una función que contenga las acciones que desea.
Ejemplo
En el ejemplo siguiente se muestra cómo especificar una función de sustitución para el método
onConnect en una aplicación de chat sencilla.
La función controla a qué pantalla se lleva a los usuarios, dependiendo de si se ha establecido
correctamente una conexión. Si la conexión se ha establecido correctamente, se lleva a los usuarios
a la pantalla principal de chat en el fotograma con la etiqueta startChat. Si la conexión no se
establece, los usuarios van a una pantalla con información para solucionar problemas en el
fotograma con la etiqueta connectionFailed.
function myOnConnect(success) {
if (success) {
gotoAndPlay("startChat")
} else {
gotoAndStop("connectionFailed")
}
}
Después de crear el objeto XMLSocket utilizando el método constructor, el script instala el
método onConnect utilizando el operador de asignación:
socket = new XMLSocket()
socket.onConnect = myOnConnect
503
Finalmente, la conexión se inicia. Si connect devuelve el valor false, la película se envía
directamente al fotograma con la etiqueta connectionFailed y onConnect no se llega a invocar.
Si connect devuelve el valor true, la película salta al fotograma con la etiqueta
waitForConnection, que es la pantalla “Espere, por favor”. La película 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")
}
Véase también
function, XMLSocket.connect
XMLSocket.onData
Disponibilidad
Flash Player 5.
Sintaxis
XMLSocket.onData()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Controlador de eventos; se invoca cuando se ha descargado un mensaje XML del servidor,
terminado en un byte cero.
De forma predeterminada, el método XMLSocket.onData invoca el método XMLSocket.onXML.
Si sustituye el método XMLSocket.onData por el comportamiento que desea, ya no se llamará al
método XMLSocket.onXML a menos que lo haga en su implementación de XMLSocket.onData.
XMLSocket.prototype.onData = function (src) {
this.onXML(new XML(src));
}
En el ejemplo anterior, el parámetro src es una cadena que contiene el texto XML descargado del
servidor. El byte cero de terminación no se incluye en la cadena.
XMLSocket.onData
504
puede sustituirse para interceptar el texto XML sin analizarlo.
XMLSocket.onXML
Disponibilidad
Flash Player 5.
Sintaxis
myXMLSocket.onXML(objeto)
Parámetro
objeto
Instancia del objeto XML que contiene un documento XML analizado recibido de un
servidor.
Valor devuelto
Ninguno.
Descripción
Método; una función callback invocada por Flash Player cuando el objeto XML especificado que
contiene un documento XML llega por una conexión XMLSocket abierta. Una conexión
XMLSocket puede utilizarse para transferir un número 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
conexión 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 método onXML.
La implementación predeterminada de este método no realiza acciones. Para sustituir la
implementación predeterminada, debe asignar una función que contenga las acciones que desea.
Ejemplo
La función siguiente sustituye la implementación predeterminada del método onXML en una
aplicación de chat sencilla. La función myOnXML da instrucciones a la aplicación 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
continuación:
socket.onXML = myOnXML;
Se presupone que la función displayMessage es una función 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);
}
}
Véase también
function
505
XMLSocket.send
Disponibilidad
Flash Player 5.
Sintaxis
myXMLSocket.send(objeto)
Parámetros
objeto
Objeto XML u otros datos que se van a transmitir al servidor.
Valor devuelto
Ninguno.
Descripción
Método; 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 representación textual XML del objeto XML. La operación de envío es asíncrona, vuelve
inmediatamente, pero los datos pueden transmitirse más tarde. El método 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.
servidor (mediante XMLSocket.connect), la operación
Ejemplo
En el ejemplo siguiente se muestra como podría especificar un nombre de usuario y una
contraseña 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);
Véase también
XMLSocket.connect
506