Dicionrio ActionScript

macromedia

Marcas comerciais
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 & Design, 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 e Xtra so marcas comerciais da Macromedia, Inc. e podem estar registradas nos EUA ou em outras
jurisdies, inclusive internacionalmente. Outros nomes de produtos, logotipos, designs, ttulos, palavras ou frases mencionados
nesta publicao podem ser marcas comerciais, marcas de servio ou nomes comerciais da Macromedia, Inc. ou de outras
entidades e podem estar registrados em certas jurisdies, inclusive internacionais.
Informaes de terceiros
Tecnologia de compactao e descompactao de voz licenciada da Nellymoser, Inc. (www.nellymoser.com).
Tecnologia Sorenson Spark de compactao e descompactao de vdeo licenciada da
Sorenson Media, Inc.

Este guia contm links para sites da Web de terceiros que no esto sob o controle da Macromedia. Neste caso, a Macromedia no
responsvel pelo contedo de nenhum site vinculado. Se voc acessar um dos sites da Web de terceiros mencionados neste guia,
estar assumindo os riscos inerentes. A Macromedia oferece esses links apenas como uma convenincia, e a incluso de um link
no significa que a Macromedia apia ou aceita qualquer responsabilidade pelo contedo apresentado nos sites de terceiros.
Iseno de responsabilidade da Apple
A APPLE COMPUTER, INC. NO CONCEDE GARANTIA ALGUMA, NEM EXPLCITA NEM IMPLCITA, RELATIVA AO PACOTE DE SOFTWARES PARA COMPUTADORES EM ANEXO, A SUA COMERCIALIZAO OU SUA
ADEQUAO A QUALQUER FINALIDADE ESPECFICA. A EXCLUSO DE GARANTIAS IMPLCITAS NO
PERMITIDA EM CERTOS ESTADOS. A EXCLUSO ACIMA PODE NO SE APLICAR NO SEU CASO. ESTA
GARANTIA LHE CONCEDE DIREITOS LEGAIS ESPECFICOS. VOC PODE TER OUTROS DIREITOS QUE
VARIAM CONFORME O ESTADO.
Copyright 2000 Macromedia, Inc. Todos os direitos reservados. Este manual no pode ser copiado, fotocopiado,
reproduzido, traduzido ou convertido em nenhum formato eletrnico ou que possa ser lido por mquina, por inteiro ou em
parte, sem o consentimento prvio por escrito da Macromedia, Inc.
Agradecimentos
Direo: Erick Vera
Produo: Wayne Wieseler
Redao: Jody Bleyle, JuLee Burdekin, Mary Burger, Dale Crawford, Marcelle Taylor
Design instrucional: Stephanie Gowin, Barbara Nelson
Edio: Rosana Francescato, Lisa Stanziano, Anne Szabla
Design e produo de multimdia: Aaron Begley, Benjamin Salles, Noah Zilberberg
Design e produo de impresso: Chris Basmajian, Caroline Branch
Localizao: Michael Dominguez, Cristina Guembe, Yoshika Hedberg, Tim Hussey, Masayo "Noppe" Noda, Simone Pux, Yoko
Shindo, Yuko Yagi
Primeira edio: maro de 2002
Macromedia, Inc.
600 Townsend St.
San Francisco, CA 94103

NDICE

Exemplo de entrada para a maioria dos elementos do ActionScript . . . . . . . . . . . . . . . . 21

Exemplo de entrada para objetos e componentes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Contedo do dicionrio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
(decremento) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
++ (incremento) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
! (NOT lgico) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
!= (diferena) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
!== (diferena estrita). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
% (mdulo). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
%= (Atribuio de mdulo). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
& (AND bit a bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
&& (AND de curto-circuito) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
&= (atribuio AND bit a bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
() (parnteses) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
(subtrao) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
* (multiplicao) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
*= (atribuio de multiplicao). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
, (vrgula). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
. (ponto).. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
?: (condicional) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
/ (diviso) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
// (delimitador de comentrio) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
/* (delimitador de comentrio) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
/= (atribuio de diviso) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
[] (acesso de matriz). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
^(XOR bit a bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
^= (atribuio XOR bit a bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
{} (inicializador de objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
| (OR bit a bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
|| (OR lgico) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
|= (atribuio OR bit a bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
~ (NOT bit a bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
+ (adio) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
+= (atribuio de adio) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
< (menor que) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
<< (deslocamento para a esquerda bit a bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
<<= (deslocamento para a esquerda bit a bit e atribuio) . . . . . . . . . . . . . . . . . . . . . . . 64
<= (menor ou igual a) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

<> (diferena) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
= (atribuio). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
-= (atribuio de subtrao) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
== (igualdade) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
=== (igualdade estrita) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
> (maior que) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
>= (maior ou igual a) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
>> (deslocamento para a direita bit a bit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
>>= (deslocamento para a direita bit a bit e atribuio) . . . . . . . . . . . . . . . . . . . . . . . . . 72
>>> (deslocamento para a direita no assinado bit a bit) . . . . . . . . . . . . . . . . . . . . . . . . 73
>>>= (deslocamento para a direita no assinado bit a bit e atribuio) . . . . . . . . . . . . . . 73
Accessibility (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Accessibility.isActive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
and . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
arguments (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
arguments.callee . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
arguments.caller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
arguments.length. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Array (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Array.concat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Array.join . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Array.length. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Array.pop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Array.push . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Array.reverse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Array.shift . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Array.slice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Array.sort. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Array.sortOn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Array.splice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Array.toString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Array.unshift . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
asfunction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Boolean (funo) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Boolean (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Boolean.toString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Boolean.valueOf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
break . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Button (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Resumo de eventos do objeto Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Button._alpha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Button.enabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Button._focusrect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Button.getDepth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Button._height . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Button._highquality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Button._name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Button.onDragOut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Button.onDragOver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

ndice

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

ndice

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

ndice

FCheckBox.setLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
FCheckBox.setLabelPlacement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
FCheckBox.setSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
FCheckBox.setStyleProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
FCheckBox.setValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
FComboBox (component) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
FComboBox.addItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
FComboBox.addItemAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
FComboBox.getEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
FComboBox.getItemAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
FComboBox.getLength . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
FComboBox.getRowCount. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
FComboBox.getScrollPosition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
FComboBox.getSelectedIndex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
FComboBox.getSelectedItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
FComboBox.getValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
FComboBox.registerSkinElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
FComboBox.removeAll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
FComboBox.removeItemAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
FComboBox.replaceItemAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
FComboBox.setChangeHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
FComboBox.setDataProvider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
FComboBox.setEditable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
FComboBox.setEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
FComboBox.setItemSymbol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
FComboBox.setRowCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
FComboBox.setSelectedIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
FComboBox.setSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
FComboBox.setStyleProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
FComboBox.setValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
FComboBox.sortItemsBy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
FListBox (component) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
FListBox.addItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
FListBox.addItemAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
FListBox.getEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
FListBox.getItemAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
FListBox.getLength . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
FListBox.getRowCount. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
FListBox.getScrollPosition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
FListBox.getSelectedIndex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
FListBox.getSelectedIndices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
FListBox.getSelectedItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
FListBox.getSelectedItems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
FListBox.getSelectMultiple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
FListBox.getValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
FListBox.registerSkinElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
FListBox.removeAll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
FListBox.removeItemAt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
FListBox.replaceItemAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
FListBox.setAutoHideScrollBar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177

ndice

FListBox.setChangeHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
FListBox.setDataProvider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
FListBox.setEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
FListBox.setItemSymbol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
FListBox.setRowCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
FListBox.setScrollPosition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
FListBox.setSelectedIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
FListBox.setSelectedIndices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
FListBox.setSelectMultiple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
FListBox.setSize. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
FListBox.setStyleProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
FListBox.setWidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
FListBox.sortItemsBy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
_focusrect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
for . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
for..in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
FPushButton (component) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
FPushButton.getEnabled. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
FPushButton.getLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
FPushButton.registerSkinElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
FPushButton.setClickHandler. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
FPushButton.setEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
FPushButton.setLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
FPushButton.setSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
FPushButton.setStyleProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
FRadioButton (component) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
FRadioButton.getData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
FRadioButton.getEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
FRadioButton.getLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
FRadioButton.getState . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
FRadioButton.getValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
FRadioButton.registerSkinElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
FRadioButton.setChangeHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
FRadioButton.setData. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
FRadioButton.setEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
FRadioButton.setGroupName. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
FRadioButton.setLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
FRadioButton.setLabelPlacement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
FRadioButton.setSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
FRadioButton.setState. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
FRadioButton.setStyleProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
FRadioButton.setValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
FScrollBar (component) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
FScrollBar.getEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
FScrollBar.getScrollPosition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
FScrollBar.registerSkinElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
FScrollBar.setChangeHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
FScrollBar.setEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
FScrollBar.setHorizontal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
FScrollBar.setLargeScroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

ndice

FScrollBar.setScrollContent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
FScrollBar.setScrollPosition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
FScrollBar.setScrollProperties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
FScrollBar.setScrollTarget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
FScrollBar.setSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
FScrollBar.setSmallScroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
FScrollBar.setStyleProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
FScrollPane (component) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
FScrollPane.getPaneHeight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
FScrollPane.getPaneWidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
FScrollPane.getScrollContent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
FScrollPane.getScrollPosition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
FScrollPane.loadScrollContent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
FScrollPane.refreshPane. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
FScrollPane.registerSkinElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
FScrollPane.setDragContent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
FScrollPane.setHScroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
FScrollPane.setScrollContent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
FScrollPane.setScrollPosition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
FScrollPane.setSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
FScrollPane.setStyleProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
FScrollPane.setVScroll. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
FStyleFormat (object) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Resumo das propriedades do objeto FStyleFormat. . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
FStyleFormat.addListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
FStyleFormat.applyChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
FStyleFormat.arrow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
FStyleFormat.background . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
FStyleFormat.backgroundDisabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
FStyleFormat.check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
FStyleFormat.darkshadow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
FStyleFormat.face . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
FStyleFormat.foregroundDisabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
FStyleFormat.highlight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
FStyleFormat.highlight3D. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
FStyleFormat.radioDot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
FStyleFormat.removeListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
FStyleFormat.scrollTrack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
FStyleFormat.selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
FStyleFormat.selectionDisabled. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
FStyleFormat.selectionUnfocused . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
FStyleFormat.shadow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
FStyleFormat.textAlign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
FStyleFormat.textBold. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
FStyleFormat.textColor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
FStyleFormat.textDisabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
FStyleFormat.textFont. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
FStyleFormat.textIndent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
FStyleFormat.textItalic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
FStyleFormat.textLeftMargin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242

ndice

FStyleFormat.textRightMargin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
FStyleFormat.textSelected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
FStyleFormat.textSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
FStyleFormat.textUnderline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Function (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
Function.apply . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
Function.call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
Function.prototype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
fscommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
ge (maior ou igual a especfico de seqncias de caracteres). . . . . . . . . . . . . . . . . . . 251
getProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
getTimer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
getURL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
getVersion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
_global . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
globalStyleFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
gotoAndPlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
gotoAndStop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
gt (maior que especfico de seqncias de caracteres) . . . . . . . . . . . . . . . . . . . . . . . 256
_highquality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
if . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
ifFrameLoaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
#include . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
#initclip. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
instanceof . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
int . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
isFinite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
isNaN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
Key (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
Key.addListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Key.BACKSPACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Key.CAPSLOCK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Key.CONTROL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Key.DELETEKEY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Key.DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Key.END . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Key.ENTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Key.ESCAPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Key.getAscii . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Key.getCode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Key.HOME. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Key.INSERT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Key.isDown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Key.isToggled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Key.LEFT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
Key.onKeyDown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
Key.onKeyUp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
Key.PGDN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Key.PGUP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269

10

ndice

Key.removeListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Key.RIGHT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Key.SHIFT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Key.SPACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Key.TAB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Key.UP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
le (menor que ou igual a especfico da seqncia de caracteres) . . . . . . . . . . . . . . . . 271
length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
_level. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
loadMovie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
loadMovieNum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
loadVariables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
loadVariablesNum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
LoadVars (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
LoadVars.contentType. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
LoadVars.getBytesLoaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
LoadVars.getBytesTotal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
LoadVars.load . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
LoadVars.loaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
LoadVars.onLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
LoadVars.send . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
LoadVars.sendAndLoad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
LoadVars.toString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
lt (menor que seqncia de caracteres especfica) . . . . . . . . . . . . . . . . . . . . . . . . . . 283
Math (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
Math.abs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
Math.acos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
Math.asin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
Math.atan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
Math.atan2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
Math.ceil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
Math.cos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
Math.E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
Math.exp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
Math.floor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
Math.log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
Math.LOG2E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
Math.LOG10E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
Math.LN2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
Math.LN10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
Math.max . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
Math.min . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
Math.PI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
Math.pow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
Math.random . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
Math.round. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
Math.sin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
Math.sqrt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
Math.SQRT1_2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Math.SQRT2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294

ndice

11

Math.tan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
maxscroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
mbchr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
mblength. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
mbord . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
mbsubstring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
mtodo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
Mouse (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
Mouse.addListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
Mouse.hide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
Mouse.onMouseDown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
Mouse.onMouseMove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
Mouse.onMouseUp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
Mouse.removeListener. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
Mouse.show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
MovieClip (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
MovieClip._alpha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
MovieClip.attachMovie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
MovieClip.beginFill. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
MovieClip.beginGradientFill. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
MovieClip.clear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
MovieClip.createEmptyMovieClip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
MovieClip.createTextField. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
MovieClip._currentframe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
MovieClip.curveTo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
MovieClip._droptarget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
MovieClip.duplicateMovieClip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
MovieClip.enabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
MovieClip.endFill . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
MovieClip.focusEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
MovieClip._focusrect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
MovieClip._framesloaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
MovieClip.getBounds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
MovieClip.getBytesLoaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
MovieClip.getBytesTotal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
MovieClip.getDepth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
MovieClip.getURL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
MovieClip.globalToLocal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
MovieClip.gotoAndPlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
MovieClip.gotoAndStop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
MovieClip._height . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
MovieClip._highquality. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
MovieClip.hitArea. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
MovieClip.hitTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
MovieClip.lineStyle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
MovieClip.lineTo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
MovieClip.loadMovie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
MovieClip.loadVariables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
MovieClip.localToGlobal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
MovieClip.moveTo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328

12

ndice

MovieClip._name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
MovieClip.nextFrame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
MovieClip.onData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
MovieClip.onDragOut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
MovieClip.onDragOver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
MovieClip.onEnterFrame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
MovieClip.onKeyDown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
MovieClip.onKeyUp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
MovieClip.onKillFocus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
MovieClip.onLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
MovieClip.onMouseDown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
MovieClip.onMouseMove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
MovieClip.onMouseUp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
MovieClip.onPress. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
MovieClip.onRelease. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
MovieClip.onReleaseOutside . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
MovieClip.onRollOut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
MovieClip.onRollOver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
MovieClip.onSetFocus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
MovieClip.onUnload. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
MovieClip._parent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
MovieClip.play . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
MovieClip.prevFrame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
MovieClip.removeMovieClip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
MovieClip._rotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
MovieClip.setMask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
MovieClip._soundbuftime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
MovieClip.startDrag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
MovieClip.stop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342
MovieClip.stopDrag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342
MovieClip.swapDepths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342
MovieClip.tabChildren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343
MovieClip.tabEnabled. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
MovieClip.tabIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
MovieClip._target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
MovieClip._totalframes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
MovieClip.trackAsMenu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
MovieClip.unloadMovie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
MovieClip._url . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
MovieClip.useHandCursor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
MovieClip._visible . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
MovieClip._width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
MovieClip._x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
MovieClip._xmouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
MovieClip._xscale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
MovieClip._y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
MovieClip._ymouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
MovieClip._yscale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
NaN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
ne (diferente especfico de seqncia de caracteres) . . . . . . . . . . . . . . . . . . . . . . . . . 350

ndice

13

new . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
newline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
nextFrame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
nextScene . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
not . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
null . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
Number (funo). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
Number (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
Number.MAX_VALUE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
Number.MIN_VALUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
Number.NaN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
Number.NEGATIVE_INFINITY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
Number.POSITIVE_INFINITY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
Number.toString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
Number.valueOf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
Object (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
Object.addProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
Object.__proto__ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
Object.registerClass . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
Object.toString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
Object.unwatch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
Object.valueOf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
Object.watch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
onClipEvent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
or . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
ord . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
_parent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
parseFloat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
parseInt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
play . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
prevFrame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
prevScene . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373
printAsBitmap. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374
printAsBitmapNum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
printNum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
_quality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377
random . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
removeMovieClip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
return . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
_root . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
scroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
Selection (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
Selection.addListener. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381
Selection.getBeginIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
Selection.getCaretIndex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
Selection.getEndIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
Selection.getFocus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383
Selection.onSetFocus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383

14

ndice

Selection.removeListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384
Selection.setFocus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384
Selection.setSelection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
set variable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
setInterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
setProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
Sound (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
Sound.attachSound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
Sound.duration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
Sound.getBytesLoaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
Sound.getBytesTotal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
Sound.getPan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
Sound.getTransform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
Sound.getVolume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
Sound.loadSound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393
Sound.onLoad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393
Sound.onSoundComplete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394
Sound.position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394
Sound.setPan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
Sound.setTransform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
Sound.setVolume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
Sound.start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
Sound.stop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
_soundbuftime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
Stage (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
Stage.addListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
Stage.align . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
Stage.height. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
Stage.onResize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
Stage.removeListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
Stage.scaleMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
Stage.width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
startDrag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
stop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
stopAllSounds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
stopDrag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
String (funo) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
" " (delimitador de seqncia de caracteres) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406
String (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406
String.charAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408
String.charCodeAt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408
String.concat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409
String.fromCharCode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409
String.indexOf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
String.lastIndexOf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
String.length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
String.slice. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
String.split. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412
String.substr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
String.substring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413

ndice

15

String.toLowerCase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
String.toUpperCase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
substring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
super . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
System (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417
System.capabilities (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417
System.capabilities.hasAudioEncoder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418
System.capabilities.hasAccessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
System.capabilities.hasAudio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
System.capabilities.hasMP3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
System.capabilities.language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
System.capabilities.manufacturer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
System.capabilities.os . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
System.capabilities.pixelAspectRatio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
System.capabilities.screenColor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
System.capabilities.screenDPI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
System.capabilities.screenResolution.x. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
System.capabilities.screenResolution.y. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
System.capabilities.version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
System.capabilities.hasVideoEncoder. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
targetPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
tellTarget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
TextField (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
TextField._alpha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
TextField.addListener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
TextField.autoSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428
TextField.background . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428
TextField.backgroundColor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
TextField.border . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
TextField.borderColor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
TextField.bottomScroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
TextField.embedFonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
TextField._focusrect. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
TextField.getDepth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
TextField.getFontList. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
TextField.getNewTextFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
TextField.getTextFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
TextField._height. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
TextField._highquality. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
TextField.hscroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
TextField.html. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
TextField.htmlText . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
TextField.length. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
TextField.maxChars. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
TextField.maxhscroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
TextField.maxscroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
TextField.multiline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
TextField._name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
TextField.onChanged . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436

16

ndice

TextField.onKillFocus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
TextField.onScroller. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
TextField.onSetFocus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
TextField._parent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
TextField.password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
TextField._quality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
TextField.removeListener. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
TextField.removeTextField. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
TextField.replaceSel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
TextField.restrict . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440
TextField._rotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
TextField.scroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
TextField.selectable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
TextField.setNewTextFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
TextField.setTextFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
TextField._soundbuftime. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
TextField.tabEnabled. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
TextField.tabIndex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
TextField._target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
TextField.text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
TextField.textColor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
TextField.textHeight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
TextField.textWidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
TextField.type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
TextField._url . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
TextField.variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
TextField._visible. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447
TextField._width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447
TextField.wordWrap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447
TextField._x. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448
TextField._xmouse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448
TextField._xscale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448
TextField._y. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
TextField._ymouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
TextField._yscale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
TextFormat (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450
TextFormat.align . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
TextFormat.blockIndent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
TextFormat.bold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
TextFormat.bullet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
TextFormat.color. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
TextFormat.font . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
TextFormat.getTextExtent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
TextFormat.indent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454
TextFormat.italic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454
TextFormat.leading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454
TextFormat.leftMargin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454
TextFormat.rightMargin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455
TextFormat.size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455
TextFormat.tabStops . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455

ndice

17

TextFormat.target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455
TextFormat.underline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
TextFormat.url . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
this . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
toggleHighQuality. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457
trace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
true . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
typeof . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
undefined . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460
unescape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
unloadMovie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
unloadMovieNum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
updateAfterEvent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
var . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463
void . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463
while . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
with. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
XML (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467
XML.appendChild . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469
XML.attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470
XML.childNodes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470
XML.cloneNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
XML.contentType. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
XML.createElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472
XML.createTextNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472
XML.docTypeDecl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473
XML.firstChild . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473
XML.getBytesLoaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474
XML.getBytesTotal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474
XML.hasChildNodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474
XML.ignoreWhite. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475
XML.insertBefore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475
XML.lastChild . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476
XML.load . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476
XML.loaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477
XML.nextSibling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477
XML.nodeName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477
XML.nodeType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478
XML.nodeValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478
XML.onData. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478
XML.onLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479
XML.parentNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480
XML.parseXML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480
XML.previousSibling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481
XML.removeNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481
XML.send . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481
XML.sendAndLoad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482
XML.status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482
XML.toString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483
XML.xmlDecl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483

18

ndice

XMLSocket (objeto) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484

XMLSocket.close. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486
XMLSocket.connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486
XMLSocket.onClose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487
XMLSocket.onConnect. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488
XMLSocket.onData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489
XMLSocket.onXML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489
XMLSocket.send . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490

ndice

19

20

ndice

Dicionrio ActionScript

Este dicionrio descreve a sintaxe e o uso de elementos do ActionScript no Macromedia Flash

MX. Para usar os exemplos em um script, copie o cdigo de exemplo do dicionrio ActionScript e
cole-o no painel Aes no modo Especialista.
O dicionrio lista todos os elementos do ActionScript operadores, palavras-chave, comandos,
aes, propriedades, funes, objetos, componentes e mtodos. Para obter uma viso geral de
todas as entradas do dicionrio, consulte Contedo do dicionrio, na pgina 23; as tabelas desta
seo representam um bom comeo para verificar os operadores simblicos e mtodos cuja classe
de objeto ou componente seja desconhecida.
O ActionScript segue o padro ECMA-262 (a especificao escrita pela Associao Europia de
Fabricantes de Computadores), salvo indicao em contrrio. Alguns elementos do ActionScript
do Flash 5 (e anteriores) ficaram obsoletos e foram substitudos por novos elementos do
ActionScript que correspondem ao padro ECMA. Recomenda-se usar os novos elementos do
Flash MX, embora o Flash Player 5 ainda oferea suporte para alguns elementos obsoletos.
H dois tipos de entradas neste dicionrio:

Entradas individuais para operadores, palavras-chave, funes, variveis, propriedades,

mtodos e comandos;

Entradas de objeto e de componente oferecem informaes gerais sobre os objetos internos e

componentes do Flash
Use as informaes nas entradas de exemplo para interpretar a estrutura e as convenes usadas
nesses dois tipos de entradas.

Exemplo de entrada para a maioria dos elementos do ActionScript

O exemplo de entrada do dicionrio a seguir explica as convenes usadas para todos os elementos
do ActionScript que no sejam objetos ou componentes.
Ttulo da entrada
Todas as entradas so listadas em ordem alfabtica. A ordem ignora maisculas e minsculas,
sublinhados no incio e assim por diante.
Disponibilidade

Esta seo informa quais as verses do Flash Player que oferecem suporte ao elemento. Isso no
o mesmo que a verso do Flash usada para criar o contedo. Por exemplo, se a ferramenta de
criao Flash MX for usada para criar um contedo para o Flash Player 5, use apenas os elementos
do ActionScript disponveis para o Flash Player 5.

21

Uso

Esta seo fornece a sintaxe correta para usar o elemento do ActionScript em seu cdigo. A parte
necessria da sintaxe est em fonte de cdigo e o cdigo fornecido pelo usurio est em fonte
de cdigo em itlico. Os colchetes ([]) indicam parmetros opcionais.
Parmetros

Esta seo descreve qualquer parmetro listado na sintaxe.

Retorna

Se houver valores, esta seo identifica qual ser retornado pelo elemento.
Descrio

Esta seo identifica o tipo de elemento (por exemplo, um operador, um mtodo, uma funo
etc.) e, em seguida, descreve como usar o elemento.
Exemplo

Esta seo fornece um exemplo de cdigo que demonstra como usar o elemento.
Consulte tambm

Esta seo lista entradas do dicionrio ActionScript relacionadas.

Exemplo de entrada para objetos e componentes

O exemplo de entrada do dicionrio a seguir explica as convenes usadas para objetos e
componentes ActionScript internos. Os objetos e componentes so listados em ordem alfabtica
com todos os outros elementos do dicionrio. Os componentes do Flash so listados como
FCheckBox, FComboBox e assim por diante.
Ttulo da entrada
O ttulo da entrada fornece o nome do objeto ou do componente, que seguido de um pargrafo
com informaes descritivas gerais.
Tabelas de resumo de mtodo e propriedade
Cada entrada de objeto e de componente contm uma tabela com todos os mtodos associados.
Se o objeto ou componente tiver propriedades (normalmente constantes), esses elementos sero
resumidos em uma tabela complementar. Todos os mtodos e propriedades listados nessas tabelas
tambm tm suas prprias entradas do dicionrio, que seguem a entrada do objeto e do
componente.
Construtor
Se um objeto ou componente necessitar do uso de um construtor para acessar mtodos e
propriedades, o construtor ser descrito em cada entrada do objeto ou do componente. Essa
descrio tem todos os elementos padres (sintaxe, descrio etc.) das outras entradas do
dicionrio.
Listagens de mtodos e propriedades
Os mtodos e as propriedades de um objeto ou componente so listados em ordem alfabtica
depois da entrada do objeto ou do componente.

Dicionrio ActionScript

22

Contedo do dicionrio
Todas as entradas do dicionrio so listadas em ordem alfabtica. Contudo, alguns operadores so
smbolos e so apresentados na ordem ASCII. Alm disso, os mtodos associados a um objeto ou
componente so listados junto com o nome do objeto ou componentepor exemplo, o
mtodo abs do objeto Math listado como Math.abs e o mtodo getValue do componente
FRadioButton listado como FRadioButton.getValue.
As duas tabelas a seguir o ajudaro a localizar esses elementos. A primeira lista os operadores
simblicos na ordem em que ocorrem no dicionrio. A segunda lista todos os outros elementos do
ActionScript.
Observao: Para precedncia e associatividade de operadores, consulte o apndice A, Associatividade e
precedncia de operadores, no manual Usando o Flash.
Operadores simblicos

23

(decremento)

++

++ (incremento)

! (NOT lgico)

!=

!= (diferena)

!==

!== (diferena estrita)

% (mdulo)

%=

%= (Atribuio de mdulo)

&

& (AND bit a bit)

&&

&& (AND de curto-circuito)

&=

&= (atribuio AND bit a bit)

()

() (parnteses)

(subtrao)

* (multiplicao)

*=

*= (atribuio de multiplicao)

, (vrgula)

. (ponto).

?:

?: (condicional)

/ (diviso)

//

// (delimitador de comentrio)

/*

/* (delimitador de comentrio)

/=

/= (atribuio de diviso)

[]

[] (acesso de matriz)

^(XOR bit a bit)

^=

^= (atribuio XOR bit a bit)

{}

{} (inicializador de objeto)

| (OR bit a bit)

Operadores simblicos
||

|| (OR lgico)

|=

|= (atribuio OR bit a bit)

~ (NOT bit a bit)

+ (adio)

+=

+= (atribuio de adio)

<

< (menor que)

<<

<< (deslocamento para a esquerda bit a bit)

<<=

<<= (deslocamento para a esquerda bit a bit e atribuio)

<=

<= (menor ou igual a)

<>

<> (diferena)

= (atribuio)

-=

-= (atribuio de subtrao)

==

== (igualdade)

===

=== (igualdade estrita)

>

> (maior que)

>=

>= (maior ou igual a)

>>

>> (deslocamento para a direita bit a bit)

>>=

>>= (deslocamento para a direita bit a bit e atribuio)

>>>

>>> (deslocamento para a direita no assinado bit a bit)

>>>=

>>>= (deslocamento para a direita no assinado bit a bit e

atribuio)

A tabela a seguir lista todos os elementos do ActionScript que no so operadores simblicos.

Elemento do ActionScript

Consulte a entrada

abs

Math.abs

acos

Math.acos

add

add

addItem

FComboBox.addItem, FListBox.addItem

addItemAt

FComboBox.addItemAt, FListBox.addItem

addListener

FStyleFormat.addListenerFStyleFormat.addListener,
Key.addListener, Mouse.addListener, Selection.addListener,
Stage.addListenerStage.addListener, TextField.addListener

addProperty

Object.addProperty

and

and

align

Stage.align, TextFormat.align

_alpha

MovieClip._alpha, Button._alpha, TextField._alpha

appendChild

XML.appendChild

apply

Function.apply

applyChanges

FStyleFormat.applyChangesFStyleFormat.applyChanges

Dicionrio ActionScript

24

25

Elemento do ActionScript

Consulte a entrada

Argumentos

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

Booleano

Boolean (funo), 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

chamar funo

callee

arguments.callee

caller

arguments.caller

capabilities

System.capabilities (objeto)

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

Elemento do ActionScript

Consulte a entrada

cloneNode

XML.cloneNode

close

XMLSocket.close

Cor

Color (objeto), TextFormat.color

concat

Array.concat, String.concat

connect

XMLSocket.connect

constructor

Array (objeto), Boolean (objeto), Color (objeto), Date

(objeto), Number (funo), 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

defaultdefault

delete

delete

DELETEKEY

Key.DELETEKEY

docTypeDecl

XML.docTypeDecl

do while

do while

DOWN

Key.DOWN

_droptarget

MovieClip._droptarget

duplicateMovieClip

duplicateMovieClip, MovieClip.duplicateMovieClip

duration

Sound.duration

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 especfico de seqncia de caracteres)

escape (funo)

escape

ESCAPE (constante)

Key.ESCAPE

eval

eval

Dicionrio ActionScript

26

27

Elemento do ActionScript

Consulte a entrada

evaluate

evaluate

exp

Math.exp

face

FStyleFormat.face

false

false

FCheckBox

FCheckBox (componente)

FComboBox

FListBox (component)

firstChild

XML.firstChild

FListBox

FListBox (component)

floor

Math.floor

focusEnabled

MovieClip.focusEnabled

_focusrect

_focusrect, Button._focusrect, TextField._focusrect,

MovieClip._focusrect

fonte

TextFormat.font

for

for

for..in

for..in

foregroundDisabled

FStyleFormat.foregroundDisabled

FPushButton

FPushButton (component)

FRadioButton

FPushButton (component)

_framesloaded

MovieClip._framesloaded

fromCharCode

String.fromCharCode

fscommand

fscommand

FScrollBar

FScrollBar (component)

FScrollPane

FScrollPane (component)

FStyleFormat

FStyleFormat (object)

function

function, Function (objeto)

ge

ge (maior ou igual a especfico de seqncias de

caracteres)

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

Elemento do ActionScript

Consulte a entrada

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

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

Dicionrio ActionScript

28

29

Elemento do ActionScript

Consulte a entrada

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

gotoAndPlay

gotoAndPlay, MovieClip.gotoAndPlay

gotoAndStop

gotoAndStop, MovieClip.gotoAndStop

gt

gt (maior que especfico de seqncias de caracteres)

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

Elemento do ActionScript

Consulte a entrada

install

CustomActions.install

instanceof

instanceof

int

int

isActive

Accessibility.isActive

isDown

Key.isDown

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 que ou igual a especfico da seqncia de

caracteres)

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 seqncia de caracteres especfica)

manufacturer

System.capabilities.manufacturer

Dicionrio ActionScript

30

31

Elemento do ActionScript

Consulte a 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

mtodo

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 (diferente especfico de seqncia de caracteres)

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 (funo), Number (objeto)

Object

Object (objeto)

on

on

onClipEvent

onClipEvent

onClose

XMLSocket.onClose

onChanged

TextField.onChanged

onConnect

XMLSocket.onConnect

onData

XML.onData, XMLSocket.onData

onDragOut

Button.onDragOut, MovieClip.onDragOut

onDragOver

Button.onDragOver, MovieClip.onDragOver

Elemento do ActionScript

Consulte a entrada

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 (logical OR)

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

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

Dicionrio ActionScript

32

33

Elemento do ActionScript

Consulte a entrada

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,
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

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

Elemento do ActionScript

Consulte a entrada

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

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

Dicionrio ActionScript

34

35

Elemento do ActionScript

Consulte a entrada

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

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 (method)

Array.shift

SHIFT (constant)

Key.SHIFT

show

Mouse.show

sin

Math.sin

size

TextFormat.size

slice

Array.slice, String.slice

sort

Array.sort

sortItemsBy

FComboBox.sortItemsBy, FListBox.sortItemsBy

Elemento do ActionScript

Consulte a entrada

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

stopAllSounds

stopAllSounds

stopDrag

stopDrag, MovieClip.stopDrag

String

String (funo), 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

Dicionrio ActionScript

36

37

Elemento do ActionScript

Consulte a entrada

textIndent

FStyleFormat.textIndent

textItalic

FStyleFormat.textItalic

textLeftMargin

FStyleFormat.textLeftMargin

textRightMargin

FStyleFormat.textRightMargin

textSelected

FStyleFormat.textSelected

textSize

FStyleFormat.textSize

textUnderline

FStyleFormat.textUnderline

textWidth

TextField.textWidth

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

Elemento do ActionScript

Consulte a entrada

width

Stage.width

_width

MovieClip._width, TextField._width, Button._width

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)
Disponibilidade

Flash Player 4.
Uso

expresso
expresso
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Operador (aritmtico); um operador unitrio pr-decremento e ps-decremento que subtrai 1 da

expresso. A forma pr-decremento do operador (expresso) subtrai 1 da expresso e
retorna o resultado. A forma ps-decremento do operador (expresso) subtrai 1 da
expresso e retorna o valor inicial da expresso (o resultado anterior subtrao).
Exemplo

A forma pr-decremento do operador decrementa x para 2 (x - 1 = 2) e retorna o resultado

como y:
x = 3;
y = --x;
//y igual a 2

A forma ps-decremento do operador decrementa x para 2 (x - 1 = 2) e retorna o valor original

de x como o resultado y:
x = 3;
y = x-//y igual a 3

Dicionrio ActionScript

38

++ (incremento)
Disponibilidade

Flash Player 4.
Uso

++expresso
expresso++
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Operador (aritmtico); um operador unrio pr-incremento e ps-incremento que adiciona 1

expresso. A expresso pode ser uma varivel, um elemento em uma matriz ou uma
propriedade de um objeto. A forma pr-incremento do operador (++expresso) adiciona 1
expresso e retorna o resultado. A forma ps-incremento do operador (expresso++) adiciona
1 expresso e retorna o valor inicial da expresso (o resultado anterior adio).
A forma pr-incremento do operador incrementa x para 2 (x +1 = 2) e retorna o resultado como
y:
x = 1;
y = ++x
//y igual a 2

A forma ps-incremento do operador incrementa x para 2 (x + 1 = 2) e retorna o valor original

de x como o resultado y:
x = 1;
y = x++;
//y igual a 1
Exemplo

O exemplo a seguir usa ++ como operador ps-incremento para fazer com que um loop while
seja executado cinco vezes.
i = 0;
while(i++ < 5){
trace("isto execuo " + i);
}

Este exemplo usa ++ como operador pr-incremento:

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

Este script exibe o seguinte resultado na janela Sada:

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

39

O exemplo a seguir usa ++ como operador ps-incremento:

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

Este script exibe o seguinte resultado na janela Sada:

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

! (NOT lgico)
Disponibilidade

Flash Player 4.
Uso

!expresso
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Operador (lgico); inverte o valor booleano de uma varivel ou expresso. Se expresso for uma
varivel com o valor absoluto ou convertido true, o valor de !expresso ser false. Se a
expresso x && y for avaliada como false, a expresso !(x && y) ser avaliada como true.
As expresses a seguir ilustram o resultado do uso do operador !:
! true

retorna false

! false

retorna true

Exemplo

No exemplo a seguir, a varivel happy definida como false. A condio if avalia a condio
!happy e, se a condio for true, a ao trace enviar uma seqncia de caracteres para a janela
Sada.
happy = false;
if (!happy){
trace("dont worry be happy");
}

Dicionrio ActionScript

40

!= (diferena)
Disponibilidade

Flash Player 5.
Uso

expresso1 != expresso2
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Operador (diferena); testa o oposto exato do operador ==. Se expresso1 for igual a
expresso2, o resultado ser false. Como com o operador ==, a definio de igual depende dos
tipos de dados comparados.

Nmeros, seqncias de caracteres e valores booleanos so comparados por valor.

Variveis, objetos, matrizes e funes so comparadas por referncia.
Exemplo

O exemplo a seguir ilustra o resultado do operador !=:

5 != 8

retorna true

5 != 5

retorna false

Este exemplo ilustra o uso do operador != em um comando if.

a = "David";
b = "Fool"
if (a != b){
trace("David is not a fool");
}
Consulte tambm

!== (diferena estrita), == (igualdade), === (igualdade estrita)

!== (diferena estrita)

Disponibilidade

Flash Player 6.
Uso

expresso1 !== expresso2

Descrio

Operador; testa o oposto exato do operador ===. O operador diferena estrita executa a mesma
operao que o operador diferena, exceto a converso dos tipos de dados. Se expresso1 for
igual a expresso2 e os tipos de dados forem iguais, o resultado ser false. Da mesma forma
que o operador ===, a definio de igual depende dos tipos de dados comparados.

Nmeros, seqncias de caracteres e valores booleanos so comparados por valor.

Variveis, objetos, matrizes e funes so comparados por referncia.
41

Exemplo

O cdigo a seguir exibe o valor retornado de operaes que usam os operadores de igualdade,
igualdade estrita e diferena estrita.
s1 = new String("5");
s2 = new String("5");
s3 = new String("Hello");
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

Consulte tambm

!= (diferena), == (igualdade), === (igualdade estrita)

% (mdulo)
Disponibilidade

Flash Player 4. Nos arquivos do Flash 4, o operador % expandido no arquivo SWF como x int(x/y) * y e pode no ser to rpido ou preciso quanto nas verses posteriores do Flash
Player.
Uso

expresso1 % expresso2
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Operador (aritmtico); calcula o resto da expresso1 dividida por expresso2. Se um dos

parmetros expresso no for numrico, o operador mdulo tentar convert-lo(s) em nmeros.
A expresso pode ser um nmero ou uma seqncia de caracteres convertida em um valor
numrico.
Exemplo

A seguir apresentado um exemplo numrico que usa o operador mdulo (%).

trace (12 % 5);
// retorna 2
trace (4,3 % 2,1);
// retorna aproximadamente 0,1

Dicionrio ActionScript

42

%= (Atribuio de mdulo)
Disponibilidade

Flash Player 4.
Uso

expresso1 %= expresso2
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Operador (atribuio composta aritmtica); atribui a expresso1 o valor de expresso1 %

expresso2. Por exemplo, as duas expresses a seguir so idnticas:
x %= y
x = x % y
Exemplo

O exemplo a seguir atribui o valor 4 varivel x.

x = 14;
y = 5;
trace(x %= y);
// retorna 4
Consulte tambm

% (mdulo)

& (AND bit a bit)

Disponibilidade

Flash Player 5. No Flash 4, o operador & era usado para concatenar seqncias de caracteres. No
Flash 5, o operador & um AND bit a bit e os operadores add e + so usados para concatenar
seqncias de caracteres. Os arquivos do Flash 4 que usam o operador & so atualizados
automaticamente para usarem add quando trazidos para o ambiente de criao Flash 5.
Uso

expresso1 & expresso2

Parmetros

Nenhum.
Retorna

Nada.
Descrio

Operador (bit a bit); converte expresso1 e expresso2 em inteiros no assinados de 32 bits e

executa uma operao AND booleana em cada bit dos parmetros inteiros. O resultado um
novo inteiro no assinado de 32 bits.

43

&& (AND de curto-circuito)

Disponibilidade

Flash Player 4.
Uso

expresso1 && expresso2

Parmetros

Nenhum.
Retorna

Nada.
Descrio

Operador (lgico); executa uma operao booleana nos valores de uma ou de ambas as expresses.
Avalia expresso1 (a expresso do lado esquerdo do operador) e retorna false se a expresso for
avaliada como false. Se expresso1 for avaliada como true, expresso2 (a expresso do lado
direito do operador) ser avaliada. Se expresso2 for avaliada como true, o resultado final ser
true; caso contrrio, ser false.
Exemplo

Este exemplo usa o operador && para realizar um teste e determinar se um jogador venceu o jogo.
As variveis turns e score so atualizadas quando for a vez de um jogador ou quando esse marcar
um ponto durante o jogo. O script Voc venceu o jogo! ser exibido na janela Sada quando a
pontuao do jogador atingir 75, ou mais, em 3 voltas, ou menos.
turns=2;
score=77;
winner = (turns <= 3) && (score >= 75);
if (winner) {
trace("Voc venceu o jogo!");
else {
trace("Tente novamente!");
}

&= (atribuio AND bit a bit)

Disponibilidade

Flash Player 5.
Uso

expresso1 &= expresso2

Parmetros

Nenhum.
Retorna

Nada.

Dicionrio ActionScript

44

Descrio

Operador (atribuio composta bit a bit); atribui a expresso1 o valor da expresso1 &
Por exemplo, as duas expresses a seguir so idnticas.

expresso2.
x &= y
x = x & y
Exemplo

O exemplo a seguir atribui o valor 9 a x.

x = 15;
y = 9;
trace(x &= y);
// retorna 9
Consulte tambm

& (AND bit a bit)

() (parnteses)
Disponibilidade

Flash Player 4.
Uso

(expresso1, expresso2);
funo(parmetro1,..., parmetroN);
Parmetros

expresso1, expresso2
funo

Nmeros, seqncias de caracteres, variveis ou texto.

A funo a ser executada no contedo entre parnteses.

Uma srie de parmetros que devem ser executados antes de os

resultados serem transferidos como parmetros para a funo fora dos parnteses.

parmetro1...parmetroN

Retorna

Nada.
Descrio

Operador; executa uma operao de agrupamento em um ou mais parmetros, ou envolve um ou

mais parmetros e os passa como parmetros para uma funo fora dos parnteses.
Uso 1: Controla a ordem de execuo dos operadores na expresso. Os parnteses substituem a
ordem de precedncia normal e fazem com que as expresses neles inseridas sejam avaliadas em
primeiro lugar. Quando os parnteses esto aninhados, o contedo dos parnteses mais internos
avaliado antes do contedo dos mais externos.
Uso 2: Envolve um ou mais parmetros e os passa como parmetros para a funo fora dos
parnteses.

45

Exemplo

Uso 1: Os comandos a seguir ilustram o uso de parnteses para controlar a ordem de execuo das
expresses. O valor de cada expresso exibido abaixo de cada linha da seguinte maneira:
trace((2 + 3) * (4 + 5));
// exibido 45
trace(2 + (3 * (4 + 5)));
// exibido 29
trace(2 + (3 * 4) + 5);
// exibido 19

Uso 2: Os exemplos a seguir ilustram o uso de parnteses com funes.

getDate();
invoice(item, amount);
function traceParameter(param){
trace(param);
}
traceParameter(2*2);
Consulte tambm

with

(subtrao)
Disponibilidade

Flash Player 4.
Uso

(Negao) expresso
(Subtrao) expresso1 - expresso2
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Operador (aritmtico); usado para negao ou subtrao.

Uso 1: Quando usado para negao, reverte o sinal da expresso numrica.
Uso 2: Quando usado para subtrao, executa uma subtrao aritmtica em duas expresses
numricas, subtraindo expresso2 de expresso1. Quando ambas as expresses so inteiras, a
diferena um inteiro. Quando uma ou ambas as expresses so nmeros de ponto flutuante, a
diferena um nmero de ponto flutuante.
Exemplo

Uso 1: O comando a seguir reverte o sinal da expresso 2 + 3.

-(2 + 3)

O resultado -5.

Dicionrio ActionScript

46

Uso 2: O comando a seguir subtrai o inteiro 2 do inteiro 5.

5 - 2

O resultado 3, que um inteiro.

Uso 2: O comando a seguir subtrai o nmero de ponto flutuante 1,5 do nmero de ponto
flutuante 3,25.
3,25 - 1,5

O resultado 1,75, que um nmero de ponto flutuante.

* (multiplicao)
Disponibilidade

Flash Player 4.
Uso

expresso1 * expresso2
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Operador (aritmtico); multiplica duas expresses numricas. Se ambas as expresses forem

inteiras, o produto ser um inteiro. Se uma ou ambas as expresses forem nmeros de ponto
flutuante, o produto ser um nmero de ponto flutuante.
Exemplo

O comando a seguir multiplica os inteiros 2 e 3:

2 * 3

O resultado 6, que um inteiro.

Exemplo

Este comando multiplica os nmeros de ponto flutuante 2,0 e 3,1416.

2,0 * 3,1416

O resultado 6,2832, que um nmero de ponto flutuante.

*= (atribuio de multiplicao)
Disponibilidade

Flash Player 4.
Uso

expresso1 *= expresso2
Parmetros

Nenhum.

47

Retorna

Nada.
Descrio

Operador (atribuio composta aritmtica); atribui a expresso1 o valor da expresso1 *

expresso2. Por exemplo, as duas expresses a seguir so idnticas:
x *= y
x = x * y
Exemplo

O exemplo a seguir atribui o valor 50 varivel x.

x = 5;
y = 10;
trace (x *= y);
// retorna 50
Exemplo

A segunda e a terceira linhas do exemplo a seguir calculam as expresses do lado direito do sinal de
igual e atribuem os resultados a x e y.
i = 5;
x = 4 - 6;
y = i + 2;
trace(x *= y);
// retorna -14
Consulte tambm

* (multiplicao)

, (vrgula)
Disponibilidade

Flash Player 4.
Uso

expresso1, expresso2
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Operador; avalia expresso1, depois expresso2 e retorna o valor de expresso2. Esse

operador principalmente usado com o comando de loop for.
Exemplo

O exemplo de cdigo a seguir usa um operador vrgula:

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

Isso equivalente a escrever o seguinte cdigo:

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

Dicionrio ActionScript

48

. (ponto).
Disponibilidade

Flash Player 4.
Uso

objeto.propriedade_ou_metodo
nome_da_instancia.variavel
nome_da_intancia.instancia_filha.variavel
Parmetros

objeto Uma instncia de um objeto. O objeto pode ser qualquer objeto ActionScript interno
ou um objeto personalizado. Esse parmetro est sempre esquerda do operador ponto (.).
propriedade_ou_mtodo O nome de uma propriedade ou de um mtodo associado ao objeto.
Todos os mtodos e as propriedades vlidos dos objetos internos esto listados nas tabelas de
resumo Mtodo e Propriedade de cada objeto. Esse parmetro sempre est direita do operador
ponto (.).
instancename

O nome da instncia de um clipe de filme.

childinstance Uma instncia do clipe de filme que seja filha do clipe do filme principal, ou
que esteja nele aninhada.

Uma varivel na Linha do tempo do nome da instncia do clipe de filme esquerda

do operador ponto (.).

varivel

Retorna

Nada.
Descrio

Operador; usado para navegar por hierarquias de clipes de filmes, para acessar clipes de filmes,
variveis ou propriedades (filha) aninhados. O operador ponto usado tambm para testar ou
definir as propriedades de um objeto, executar um mtodo de um objeto ou criar uma estrutura
de dados.
Exemplo

O comando a seguir identifica o valor atual da varivel hairColor no clipe de filme person.
person.hairColor

Isso equivale seguinte sintaxe do Flash 4:

/person:hairColor
Exemplo

O cdigo a seguir ilustra como o operador ponto pode ser usado para criar a estrutura de uma
matriz:
account.name = "Gary Smith";
account.address = "123 Main St";
account.city = "Any Town";
account.state = "CA";
account.zip = "12345";
Consulte tambm

[] (acesso de matriz)

49

?: (condicional)
Disponibilidade

Flash Player 4.
Uso

expresso1 ? expresso2 : expresso3

Parmetros

expresso1 Uma expresso que avaliada para um valor booleano, normalmente uma
expresso de comparao como x < 5.
expresso2, expresso3

Valores de qualquer tipo.

Retorna

Nada.
Descrio

Operador; instrui o Flash a avaliar expresso1 e, se o valor de expresso1 for true, ele
retornar o valor de expresso2; caso contrrio, retornar o valor de expresso3.
Exemplo

O comando a seguir atribui o valor de varivel x a varivel z, pois expresso1 foi avaliada como
true:
x = 5;
y = 10;
z = (x < 6) ? x: y;
trace (z);
// retorna 5

/ (diviso)
Disponibilidade

Flash Player 4.
Uso

expresso1 / expresso2
Parmetros

expresso

Um nmero ou uma varivel que avalia um nmero.

Retorna

Nada.
Descrio

Operador (aritmtico); divide expresso1 por expresso2. O resultado da operao de diviso

um nmero de dupla preciso e ponto flutuante.
Exemplo

O comando a seguir divide o nmero de ponto flutuante 22,0 por 7,0 e exibe o resultado na
janela Sada.
trace(22,0 / 7,0);

O resultado 3,1429, que um nmero de ponto flutuante.

Dicionrio ActionScript

50

// (delimitador de comentrio)
Disponibilidade

Flash 1.
Uso

// comentrio
Parmetros

comentrio

Qualquer caractere.

Retorna

Nada.
Descrio

Comentrio; indica o incio de um comentrio de script. Qualquer caractere que aparea entre o
delimitador de comentrio // e o caractere de fim de linha ser interpretado como comentrio e
ignorado pelo interpretador ActionScript.
Exemplo

Este script usa delimitadores de comentrio para identificar a primeira, terceira, quinta e stima
linhas como comentrios.
// registra a posio
ballX = ball._x;
// registra a posio
ballY = ball._y;
// registra a posio
batX = bat._x;
// registra a posio
batY = bat._y;

X do clipe de filme ball

Y do clipe de filme ball
X do clipe de filme bat
Y do clipe de filme bat

Consulte tambm

/* (delimitador de comentrio)

/* (delimitador de comentrio)
Disponibilidade

Flash Player 5.
Uso

/* comentrio */
/*
comentrio
comentrio
*/
Parmetros

comentrio
Retorna

Nada.

51

Qualquer caractere.

Descrio

Comentrio; indica uma ou mais linhas de comentrios de script. Qualquer caractere que aparea
entre a marca de comeo de comentrio /* e a marca de fechamento de comentrio */
interpretado como comentrio e ignorado pelo interpretador ActionScript. Use o primeiro tipo de
sintaxe para identificar comentrios de uma linha. Use o segundo tipo de sintaxe para identificar
comentrios de vrias linhas sucessivas. Se a marca de fechamento */ no for usada com essa
forma de delimitador de comentrio, ser retornada uma mensagem de erro.
Exemplo

Este script usa delimitadores de comentrio no incio do script.

/* grava as posies X e Y dos
clipes de filme ball e bat
*/
ballX = ball._x;
ballY = ball._y;
batX = bat._x;
batY = bat._y;
Consulte tambm

// (delimitador de comentrio)

/= (atribuio de diviso)
Disponibilidade

Flash Player 4.
Uso

expresso1 /= expresso2
Parmetros

expresso1,expresso2

Um nmero ou uma varivel que avaliada para um nmero.

Retorna

Nada.
Descrio

Operador (atribuio composta aritmtica); atribui a expresso1 o valor da expresso1 /

expresso2. Por exemplo, os dois comandos a seguir so equivalentes:
x /= y
x = x / y
Exemplo

O cdigo a seguir ilustra o uso do operador /= com variveis e nmeros.

x = 10;
y = 2;
x /= y;
// x agora contm o valor 5

Dicionrio ActionScript

52

[] (acesso de matriz)
Disponibilidade

Flash Player 4.
Uso

myArray = ["a0", a1,...aN];

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

myArray

O nome de uma matriz.

a0, a1,...aN

Elementos em uma matriz.

myMultiDimensionalArray
E

O nome de uma matriz multidimensional simulada.

O nmero (ou ndice) de um elemento em uma matriz.

objeto
valor

O nome de um objeto.
Uma seqncia de caracteres ou expresso que d nome a uma propriedade do objeto.

Retorna

Nada.
Descrio

Operador; inicializa uma nova matriz ou uma matriz multidimensional com os elementos
especificados (a0, e assim por diante), ou acessa elementos em uma matriz. O operador de acesso
de matriz permite definir e recuperar dinamicamente nomes de instncia, de varivel e de objeto.
Alm disso, permite o acesso s propriedades de objeto.
Uso 1: Uma matriz um objeto cujas propriedades so denominadas elementos, que so
identificados individualmente por um nmero chamado de ndice. Na criao de uma matriz, os
elementos ficam entre o operador de acesso de matriz (ou colchetes). Uma matriz pode conter
elementos de vrios tipos. Por exemplo, a matriz a seguir, denominada funcionrio, possui trs
elementos; o primeiro um nmero e os outros dois so seqncias de caracteres (dentro de
aspas).
funcionrio = [15, Brbara, Erick];

Uso 2: Para simular matrizes multidimensionais, possvel aninhar os colchetes. O cdigo a seguir
cria uma matriz denominada ticTacToe com trs elementos; cada um deles tambm uma
matriz com trs elementos.
ticTacToe = [[1,2,3],[4,5,6],[7,8,9]];
// escolha Depurar > Listar Variveis no modo Testar filme
// para visualizar uma lista dos elementos de matriz

53

Uso 3: Coloque o ndice de cada elemento entre colchetes para acess-lo diretamente; possvel
adicionar um novo elemento a uma matriz, alterar ou recuperar o valor de um elemento existente.
O primeiro elemento de uma matriz sempre 0:
myArray[0] = 15;
myArray[1] = "Ol";
myArray[2] = true;

Use colchetes para adicionar um quarto elemento, como no exemplo a seguir:

myArray[3] = "George";

Uso 4: Para acessar um elemento em uma matriz multidimensional, use colchetes. O primeiro
conjunto de colchetes identifica o elemento na matriz original, e o segundo conjunto identifica o
elemento na matriz aninhada. A linha de cdigo a seguir envia o nmero 6 para a janela Sada.
ticTacToe = [[1,2,3],[4,5,6],[7,8,9]];
trace(ticTacToe[1][2]);
// retorna 6

Uso 5: possvel usar o operador de acesso de matriz em vez da funo eval para definir e
recuperar dinamicamente valores de nomes de clipes de filme ou qualquer propriedade de um
objeto:
name["mc" + i] = "canto_esquerdo";
Exemplo

Uso 1: Os exemplos de cdigo a seguir mostram duas maneiras diferentes de criar um novo objeto
Array vazio; a primeira linha usa colchetes.
myArray =[];
myArray = new Array();

Uso 1 e 2: O exemplo a seguir cria uma matriz denominada funcionrio e usa a ao trace para
enviar os elementos para a janela Sada. Na quarta linha, alterado um elemento da matriz e a
quinta linha envia a matriz recentemente modificada para a janela Sada:
funcionrio=["Brbara", "George", "Maria"];
trace(funcionrio);
// Brbara, George, Maria
funcionrio[2]="Sam";
trace(funcionrio);
// Brbara, George, Sam

Uso 3: No exemplo a seguir, a expresso dentro dos colchetes ("pedao" + i) avaliada e o

resultado usado como nome da varivel a ser recuperada no clipe de filme mc. Neste exemplo, a
varivel i deve estar na mesma Linha de tempo que o boto. Se a varivel i for igual a 5, por
exemplo, o valor da varivel piece5 no clipe de filme mc ser exibido na janela Sada:
on(release){
x = mc["pedao"+i];
trace(x);
}

Uso 3: No cdigo a seguir, a expresso dentro dos colchetes avaliada e o resultado da avaliao
usado como o nome da varivel a ser recuperada do nome do clipe de filme:
group["A" + i];

Dicionrio ActionScript

54

Caso conhea a sintaxe de barra do ActionScript do Flash 4, use a funo eval para obter o
mesmo resultado:
eval("A" & i);

Uso 3: Tambm possvel usar o operador de acesso de matriz do lado esquerdo de um comando
de atribuio para definir dinamicamente a instncia, a varivel e os nomes de objeto:
name[index] = "Gary";
Consulte tambm

Array (objeto), Object (objeto), eval

^(XOR bit a bit)

Disponibilidade

Flash Player 5.
Uso

expresso1 ^ expresso2
Parmetros

expresso1,expresso2

Um nmero.

Retorna

Nenhum.
Descrio

Operador (bit a bit); converte expresso1 e expresso2 em inteiros no assinados de 32 bits e

retorna um 1 em cada posio de bit onde os bits correspondentes na expresso1 ou
expresso2, mas no em ambas, sejam 1.
Exemplo

O exemplo a seguir usa o operador XOR bit a bit nos decimais 15 e 9 e atribui o resultado
varivel x.
// 15 decimal = 1111 binrio
// 9 decimal = 1001 binrio
x = 15 ^ 9
trace(x)
// 1111 ^ 1001 = 0110
// retorna 6 decimal( = 0110 binrio)

^= (atribuio XOR bit a bit)

Disponibilidade

Flash Player 5.
Uso

expresso1 ^=expresso2
Parmetros

expresso1,expresso2
Retorna

Nenhum.

55

Inteiros e variveis.

Descrio

Operador (atribuio composta bit a bit); atribui a expresso1 o valor de expresso1 ^

expresso2. Por exemplo, os dois comandos a seguir so equivalentes:
x ^= y
x = x ^ y
Exemplo

A seguir, h o exemplo de uma operao ^=.

// 15 decimal = 1111 binrio
x = 15;
// 9 decimal = 1001 binrio
y = 9;
trace(x ^= y);
//retorna 6 decimal ( = 0110 binrio)
Consulte tambm

^(XOR bit a bit)

{} (inicializador de objeto)
Disponibilidade

Flash Player 5.
Uso

objeto = {nome1: valor1, nome2: valor2,...nomeN: valorN};

Parmetros

objeto

O objeto a ser criado.

nome1,2,...N
valor1,2,...N

Os nomes das propriedades.

Os valores correspondentes de cada propriedade nome.

Retorna

Nenhum.
Descrio

Operador; cria um novo objeto e o inicializa com os pares de propriedades nome e valor
especificados. Usar este operador o mesmo que usar a sintaxe new Object e preencher os pares
de propriedades com o operador de atribuio. O prottipo do objeto recm-criado
genericamente denominado como objeto Object.
Exemplo

A primeira linha do cdigo a seguir cria um objeto vazio usando o operador de inicializao do
objeto; a segunda cria um novo objeto usando uma funo construtora.
object = {};
object = new Object();

Dicionrio ActionScript

56

O exemplo a seguir cria um objeto account e inicializa as propriedades nome, endereo, cidade,
estado, cep e saldo com os respectivos valores.
account = { nome: "Betty Skate",
endereo: "123 Main Street",
cidade: "Blossomville",
estado: "Califrnia",
CEP: "12345",
saldo: "1000" };

O exemplo a seguir mostra como inicializadores de matriz e de objeto podem ser aninhados um
no outro.
person = { nome: "Gina Vechio",
children: [ "Ruby", "Chickie", "Puppa"] };

O exemplo a seguir usa as informaes do exemplo anterior e apresenta o mesmo resultado

usando as funes construtoras.
person = new Person();
person.name = 'Gina Vechio';
person.children = new Array();
person.children[0] = 'Ruby';
person.children[1] = 'Chickie';
person.children[2] = 'Puppa';
Consulte tambm

[] (acesso de matriz), new,

Object (objeto)

| (OR bit a bit)

Disponibilidade

Flash Player 5.
Uso

expresso1 | expresso2
Parmetros

expresso1,expresso2

Um nmero.

Retorna

Nenhum.
Descrio

Operador (bit a bit); converte expresso1 e expresso2 em inteiros no assinados de 32 bits e

retorna um 1 em cada posio de bit onde os bits correspondentes na expresso1 ou
expresso2 sejam 1.
Exemplo

A seguir, h o exemplo de uma operao OR bit a bit.

// 15 decimal = 1111 binrio
x = 15;
// 9 decimal = 1001 binrio
y = 9;
trace(x | y);
// 1111 | 0011 = 1111
// retorna 15 decimal (= 1111 binrio)

57

|| (OR lgico)
Disponibilidade

Flash Player 4.
Uso

expresso1 || expresso2
Parmetros

expresso1,expresso2

Um valor ou uma expresso booleana convertida em um valor

booleano.
Retorna

Nenhum.
Descrio

Operador (lgico); avalia a expresso1 e a expresso2. O resultado ser (true) se uma ou

ambas as expresses forem avaliadas como true; o resultado ser (false) apenas se ambas as
expresses forem avaliadas como false. possvel usar o operador OR lgico com qualquer
nmero de operandos; se algum operando for avaliado como true, o resultado ser true.
Com expresses no-booleanas , o operador lgico OR faz com que o Flash avalie a expresso da
esquerda; se ela puder ser convertida em true, o resultado ser true. Caso contrrio, ele avaliar a
expresso da direita e o resultado ser o valor dessa expresso.
Exemplo

O exemplo a seguir usa o operador || em um comando if: A segunda expresso avaliada como
true para que o resultado final seja true:
x = 10
y = 250
start = false
if(x > 25 || y > 200 || start){
trace('o teste de OR lgico passou');
}
Exemplo

Este exemplo demonstra como uma expresso no-booleana pode apresentar um resultado
inesperado. Se a expresso da esquerda for convertida em true, esse resultado ser retornado sem
converter a expresso da direita.
function fx1(){
trace ("fx1 chamado");
retorna true;
}
function fx2(){
trace ("fx2 chamado");
return true;
}
if (fx1() || fx2()){
trace ("comando IF inserido");
}
//O que se segue enviado para a janela Sada:
// fx1 chamado
// comando IF inserido

Dicionrio ActionScript

58

|= (atribuio OR bit a bit)

Disponibilidade

Flash Player 5.
Uso

expresso1

|= expresso2

Parmetros

expresso1,expresso2

Um nmero ou uma varivel.

Retorna

Nenhum.
Descrio

Operador (atribuio bit a bit); atribui a expresso1 o valor de expresso1 | expresso2. Por
exemplo, os dois comandos a seguir so equivalentes:
x |= y;
x = x | y;
Exemplo

O exemplo a seguir usa o operador |=:

// 15 decimal = 1111 binrio
x = 15;
// 9 decimal = 1001 binrio
y = 9;
trace(x |= y);
// 1111 |= 1001
// retorna 15 decimal (= 1111 binrio)
Consulte tambm

| (OR bit a bit)

~ (NOT bit a bit)

Disponibilidade

Flash Player 5.
Uso

~ expresso
Parmetros

expresso

Um nmero.

Retorna

Nenhum.
Descrio

Operador (bit a bit); converte a expresso em um inteiro no assinado de 32 bits, depois inverte
os bits. Uma operao NOT bit a bit altera o sinal de um nmero e subtrai 1.

59

Exemplo

O exemplo a seguir mostra uma operao NOT bit a bit executada em uma varivel.
a = 0;
trace ("quando a = 0, ~a = "+~a);
// quando a = 0, ~a = -1
a = 1;
trace ("quando a = 1, ~a = "+~a);
// quando a = 0, ~a = -2
// portanto, ~0=-1 e ~1=-2

+ (adio)
Disponibilidade

Flash Player 4; Flash Player 5. No Flash 5, + um operador numrico ou um concatenador de

seqncias de caracteres, dependendo do tipo de dado do parmetro. No Flash 4, + somente um
operador numrico. Os arquivos do Flash 4 trazidos para o ambiente de criao Flash 5 passam
por um processo de converso para manter a integridade dos tipos de dados. O exemplo a seguir
ilustra a converso de um arquivo do Flash 4 que contm uma comparao do tipo numrica.
Arquivo do Flash 4:
x + y

Arquivo do Flash 5 convertido:

Number(x) + Number(y)
Uso

expresso1 + expresso2
Parmetros

expresso1,expresso2

Nmeros ou seqncias de caracteres.

Retorna

Nenhum.
Descrio

Operador; adiciona expresses numricas ou concatena (combina) seqncias de caracteres. Se

uma expresso for uma seqncia de caracteres, todas as outras expresses so convertidas em
seqncias de caracteres e concatenadas.
Se ambas as expresses forem inteiras, a soma ser um inteiro; se uma ou ambas as expresses
forem nmeros de ponto flutuante, a soma ser um nmero de ponto flutuante.
Exemplo

O exemplo a seguir concatena duas seqncias de caracteres e exibe o resultado na janela Sada.
nome = "Cola";
instrumento = "Baterias";
trace (nome + " toca " + instrumento);

Dicionrio ActionScript

60

Exemplo

As variveis associadas a campos de texto dinmico e de entrada tm a seqncia de caracteres

como tipo de dado. No exemplo a seguir, o depsito da varivel um campo de texto de entrada
no Palco. Depois que um usurio inserir um valor, o script tenta adicionar o depsito a
oldBalance. Contudo, como depsito um tipo de dado de seqncia de caracteres, o script
concatena (combina os dados para formar uma seqncia de caracteres) os valores da varivel em
vez de som-los.
oldBalance = 1345,23;
currentBalance = deposit + oldBalance;
trace (currentBalance);

Por exemplo, se um usurio inserir 475 no campo de texto de depsito, a ao trace envia o valor
4751345,23 para a janela Sada.
Para corrigir isso, use a funo Number para converter a seqncia de caracteres em um nmero,
como no exemplo a seguir:
currentBalance = Number(deposit) + oldBalance;
Exemplo

Este comando adiciona os inteiros 2 e 3, e exibe o inteiro resultante, 5, na janela Sada:

trace (2 + 3);

Este comando adiciona os nmeros de ponto flutuante 2,5 e 3,25 e exibe o resultado, 5,75, que
um nmero de ponto flutuante, na janela Sada:
trace (2,5 + 3,25);
Consulte tambm

add

+= (atribuio de adio)
Disponibilidade

Flash Player 4.
Uso

expresso1

+= expresso2

Parmetros

expresso1,expresso2

Nmeros ou seqncias de caracteres.

Retorna

Nada.
Descrio

Operador (atribuio composta aritmtica); atribui a expresso1 o valor de expresso1 +

Por exemplo, os dois comandos a seguir tm o mesmo resultado:

expresso2.
x += y;
x = x + y;

Este operador tambm executa concatenao de seqncias de caracteres. Todas as regras do

operador de adio (+) so aplicadas ao operador de atribuio de adio (+=).

61

Exemplo

O exemplo a seguir mostra um uso numrico do operador +=.

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

Este exemplo usa o operador += com uma expresso de seqncia de caracteres e envia "Meu
nome Gilberto" para a janela Sada.
x = "Meu nome "
x += "Gilberto"
trace (x)
Consulte tambm

+ (adio)

< (menor que)

Disponibilidade

Flash Player 4; Flash Player 5. No Flash 5, < (menor que) um operador de comparao que pode
gerenciar vrios tipos de dados. No Flash 4, < um operador numrico. Os arquivos do Flash 4
trazidos para o ambiente de criao Flash 5 passam por um processo de converso para manter a
integridade dos tipos de dados. O exemplo a seguir ilustra a converso de um arquivo do Flash 4
que contm uma comparao do tipo numrica.
Arquivo do Flash 4:
x < y

Arquivo do Flash 5 convertido:

Number(x) < Number(y)
Uso

expresso1 < expresso2

Parmetros

expresso1,expresso2

Nmeros ou seqncias de caracteres.

Descrio

Operador (comparao); compara duas expresses e determina se expresso1 menor que

expresso2; em caso positivo, o operador retorna true. Se expresso1 for maior ou igual a
expresso2, o operador retorna false. As expresses de seqncia de caracteres so avaliadas em
ordem alfabtica; todas as letras maisculas vm antes das minsculas.

Dicionrio ActionScript

62

Exemplo

Os exemplos a seguir ilustram retornos true e false para comparaes numricas e de seqncias
de caracteres:
3 < 10;
// true
10 < 3;
// false
"Allen" < "Jack";
// true
"Jack" < "Allen";
// false
"11" < "3";
//true
"11" < 3;
// comparao numrica
// false
"C" < "abc";
// false
"A" < "a";
// true

<< (deslocamento para a esquerda bit a bit)

Disponibilidade

Flash Player 5.
Uso

expresso1 << expresso2

Parmetros

expresso1

Nmero ou expresso a ser deslocada para a esquerda.

expresso2

Um nmero ou expresso que converte em um inteiro de 0 a 31.

Retorna

Nada.
Descrio

Operador (bit a bit); converte expresso1 e expresso2 em inteiros de 32 bits e desloca todos
os bits em expresso1 para a esquerda de acordo com o nmero de casas especificado pelo inteiro
que resulta da converso de expresso2. As posies de bit que estiverem vazias como resultado
dessa operao so preenchidas com 0. O deslocamento de um valor em uma posio para a
esquerda o equivalente a multiplic-lo por 2.
Exemplo

No exemplo a seguir, o inteiro 1 deslocado 10 bits para a esquerda.

x = 1 << 10

63

O resultado dessa operao x = 1024. Isso porque 1 decimal igual a 1 binrio, 1 binrio
deslocado 10 para a esquerda 10000000000 binrio e 10000000000 binrio 1024 decimal.
No exemplo a seguir, o inteiro 7 deslocado 8 bits para a esquerda.
x = 7 << 8

O resultado dessa operao x = 1792. Isso porque 7 decimal igual a 111 binrio, 111 binrio
deslocado 8 bits para a esquerda 11100000000 binrio e 11100000000 binrio 1792 decimal.
Consulte tambm

>>= (deslocamento para a direita bit a bit e atribuio), >> (deslocamento para
a direita bit a bit), <<= (deslocamento para a esquerda bit a bit e atribuio)

<<= (deslocamento para a esquerda bit a bit e atribuio)

Disponibilidade

Flash Player 5.
Uso

expresso1 <<= expresso2

Parmetros

expresso1

Nmero ou expresso a ser deslocada para a esquerda.

expresso2

Um nmero ou expresso que converte em um inteiro de 0 a 31.

Retorna

Nada.
Descrio

Operador (atribuio composta bit a bit); esse operador executa uma operao de deslocamento
para esquerda bit a bit e armazena o contedo como um resultado na expresso1. As duas
expresses a seguir so equivalentes.
A <<= B
A = (A << B)
Consulte tambm

<< (deslocamento para a esquerda bit a bit), >>= (deslocamento para a direita
bit a bit e atribuio), >> (deslocamento para a direita bit a bit)

<= (menor ou igual a)

Disponibilidade

Flash Player 4.
Arquivo do Flash 4:
x <= y

Arquivo do Flash 5 convertido:

Number(x) <= Number(y)
Uso

expresso1 <= expresso2

Dicionrio ActionScript

64

Parmetros

expresso1,expresso2

Nmeros ou seqncias de caracteres.

Retorna

Nada.
Descrio

Operador (comparao); compara duas expresses e determina se expresso1 menor ou igual

aexpresso2 ; em caso positivo, o operador retorna true. Se expresso1 for maior que
expresso2, o operador retorna false. As expresses de seqncia de caracteres so avaliadas em
ordem alfabtica; todas as letras maisculas vm antes das minsculas.
No Flash 5, o operador menor ou igual a (<=) um operador de comparao, com capacidade
para gerenciar vrios tipos de dados. No Flash 4, <= um operador numrico. Os arquivos do
Flash 4 trazidos para o ambiente de criao Flash 5 passam por um processo de converso para
manter a integridade dos tipos de dados. O exemplo a seguir ilustra a converso de um arquivo do
Flash 4 que contm uma comparao do tipo numrica.
Exemplo

Os exemplos a seguir ilustram resultados true e false para comparaes numricas e de

seqncias de caracteres:
5 <= 10;
// true
2 <= 2;
// true
10 <= 3;
// false
"Allen" <= "Jack";
// true
"Jack" <= "Allen";
// false
"11" <= "3";
//true
"11" <= 3;
// comparao numrica
// false
"C" <= "abc";
// false
"A" <= "a";
// true

65

<> (diferena)
Disponibilidade

Flash 2.
Uso

expresso1 <> expresso2

Parmetros

expresso1,expresso2

Nmero, seqncia de dados, valor booleano, varivel, objeto, matriz

ou funo.
Retorna

Nada.
Descrio

Operador (diferena); testa o oposto exato do operador ==. Se expresso1 for igual a
expresso2, o resultado ser false. Assim como o operador ==, a definio de igual depende
dos tipos de dados comparados.

Nmeros, seqncias de caracteres e valores booleanos so comparados por valor.

Variveis, objetos, matrizes e funes so comparadas por referncia.
Este operador est obsoleto no Flash 5 e os usurios so encorajados a usar o novo operador !=.
Consulte tambm

!= (diferena)

= (atribuio)
Disponibilidade

Flash Player 4.
Arquivo do Flash 4:
x = y

Arquivo do Flash 5 convertido:

Number(x) == Number(y)
Uso

expresso1

= expresso2

Parmetros

expresso1

Varivel, elemento de uma matriz ou propriedade de um objeto.

expresso2

Valor de qualquer tipo.

Retorna

Nada.
Descrio

Operador; atribui o tipo de expresso2 (o parmetro da direita) varivel, ao elemento da

matriz ou propriedade em expresso1.

Dicionrio ActionScript

66

No Flash 5, = um operador de atribuio e o operador == usado para avaliar a igualdade. No

Flash 4, = um operador de igualdade numrico. Os arquivos do Flash 4 trazidos para o ambiente de
criao Flash 5 passam por um processo de converso para manter a integridade dos tipos de dados.
Exemplo

O exemplo a seguir usa o operador de atribuio para atribuir o tipo de dado numrico varivel x.
x = 5

O exemplo a seguir usa o operador de atribuio para atribuir o tipo de dado de seqncia de
caracteres varivel x.
x = "hello"
Consulte tambm

== (igualdade)

-= (atribuio de subtrao)
Disponibilidade

Flash Player 4.
Uso

expresso1 -= expresso2
Parmetros

expresso1,expresso2

Nmero ou expresso que avalie um nmero.

Retorna

Nada.
Descrio

Operador (atribuio composta aritmtica); atribui a expresso1 o valor de expresso1Por exemplo, os dois comandos a seguir so equivalentes:

expresso2.
x -= y;
x = x - y;

As expresses de seqncia de caracteres devem ser convertidas em nmeros ou ser retornado

NaN.
Exemplo

O exemplo a seguir usa o operador -= para subtrair 10 de 5 e atribui o resultado varivel x.

x = 5;
y = 10;
x -= y
trace(x);
//retorna -5
Exemplo

O exemplo a seguir mostra como converter seqncias de caracteres em nmeros.

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

67

== (igualdade)
Disponibilidade

Flash Player 5.
Uso

expresso1 == expresso2
Parmetros

expresso1,expresso2

Nmero, seqncia de caracteres, valor Booleano, varivel, objeto,

matriz ou funo.
Retorna

Nada.
Descrio

Operador (igualdade); testa a igualdade de duas expresses. O resultado ser true se as expresses
forem iguais.
A definio de igual depende do tipo de dado do parmetro:

Nmeros e valores booleanos so comparados por valor e, se tiverem o mesmo valor, so

considerados iguais.

Expresses de seqncia de caracteres so iguais se tiverem o mesmo nmero de caracteres e os

caracteres forem idnticos.

Variveis, objetos, matrizes e funes so comparadas por referncia. Duas variveis so iguais
se fizerem referncia ao mesmo objeto, matriz ou funo. Duas matrizes separadas nunca so
consideradas iguais, mesmo que tenham o mesmo nmero de elementos.
Exemplo

O exemplo a seguir usa o operador == com um comando if:

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

Estes exemplos mostram os resultados de operaes que comparam tipos misturados.

x = "5"; y = "5";
trace(x == y);
// true
x = "5"; y = "66";
trace(x ==y);
// false
x = "chris"; y = "steve";
trace (x == y);
//false
Consulte tambm

!= (diferena), === (igualdade estrita), !== (diferena estrita)

Dicionrio ActionScript

68

=== (igualdade estrita)

Disponibilidade

Flash Player 6.
Uso

expresso1 === expresso2

Descrio

Operador; testa a igualdade de duas expresses; o operador de igualdade estrita executado da

mesma forma que o operador de igualdade, exceto pela converso dos tipos de dados. Se ambas as
expresses forem idnticas, inclusive os tipos de dados, o resultado ser true.
A definio de igual depende do tipo de dado do parmetro:

Nmeros e valores booleanos so comparados por valor e, se tiverem o mesmo valor, so

considerados iguais.

Expresses de seqncia de caracteres so iguais se tiverem o mesmo nmero de caracteres e os

caracteres forem idnticos.

Variveis, objetos, matrizes e funes so comparadas por referncia. Duas variveis so iguais
se fizerem referncia ao mesmo objeto, matriz ou funo. Duas matrizes separadas nunca so
consideradas iguais, mesmo que tenham o mesmo nmero de elementos.
Exemplo

O cdigo a seguir exibe o valor retornado de operaes que usam os operadores de igualdade,
igualdade estrita e diferena estrita.
s1 = new String("5");
s2 = new String("5");
s3 = new String("Hello");
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

Consulte tambm

== (igualdade), != (diferena), === (igualdade estrita)

69

> (maior que)

Disponibilidade

Flash Player 5.
Uso

expresso1 > expresso2

Parmetros

expresso1,expresso2

Um inteiro, um nmero de ponto flutuante ou uma seqncia de

dados.
Retorna

Nada.
Descrio

Operador (comparao); compara duas expresses e determina se expresso1 maior que

expresso2 (true) ou se expresso1 menor ou igual a expresso2 (false).

>= (maior ou igual a)

Disponibilidade

Flash Player 4.
Arquivo do Flash 4:
x > y

Arquivo do Flash 5 convertido:

Number(x) > Number(y)
Uso

expresso1 >= expresso2

Parmetros

expresso1, expresso2

Uma seqncia de dados, um inteiro ou um nmero de ponto

flutuante.
Retorna

Nada.
Descrio

Operador (comparao); compara duas expresses e determina se expresso1 maior ou igual a

expresso2 (true) ou se expresso1 menor que expresso2 (false).
No Flash 5, maior ou igual a (>) um operador de comparao com capacidade para gerenciar
vrios tipos de dados. No Flash 4, > um operador numrico. Os arquivos do Flash 4 trazidos
para o ambiente de criao Flash 5 passam por um processo de converso para manter a
integridade dos tipos de dados.

Dicionrio ActionScript

70

>> (deslocamento para a direita bit a bit)

Disponibilidade

Flash Player 5.
Uso

expresso1 >> expresso2

Parmetros

expresso1

Nmero ou expresso a ser deslocada para a direita.

expresso2

Um nmero ou expresso que converte em um inteiro de 0 a 31.

Retorna

Nada.
Descrio

Operador (bit a bit); converte expresso1 e expresso2 em inteiros de 32 bits e desloca todos
os bits em expresso1 para a direita de acordo com o nmero de casas especificado pelo inteiro
que resulta da converso de expresso2. Bits deslocados para a direita so descartados. Para
preservar o sinal da expresso original, os bits na esquerda sero preenchidos com 0, se o bit
mais significativo (o bit mais esquerda) de expresso1 for 0, e preenchido com 1, se o bit mais
significativo for 1. O deslocamento de um valor em uma posio para a direita equivale diviso
por 2 e ao descarte do resto.
Exemplo

O exemplo a seguir converte 65535 em um inteiro de 32 bits e o desloca 8 bits para a direita.
x = 65535 >> 8

O resultado da operao acima :

x = 255

Isso porque 65535 decimal igual a 1111111111111111 binrio (dezesseis 1),

1111111111111111 binrio deslocado 8 bits para a direita 11111111 binrio e 11111111
binrio 255 decimal. O bit mais significativo 0, pois os inteiros so de 32 bits, portanto o bit
de preenchimento 0.
O exemplo a seguir converte -1 em um inteiro de 32 bits e o desloca 1 bit para a direita.
x = -1 >> 1

O resultado da operao acima :

x = -1

Isso porque -1 decimal igual a 11111111111111111111111111111111 binrio (trinta e dois

1), o deslocamento de um bit para a direita faz com que o bit menos significativo (bit mais
direita) seja descartado e o bit mais significativo seja preenchido com 1. O resultado
11111111111111111111111111111111 (trinta e dois 1) binrio, que representa o inteiro de 32
bits -1.
Consulte tambm

>>= (deslocamento para a direita bit a bit e atribuio)

71

>>= (deslocamento para a direita bit a bit e atribuio)

Disponibilidade

Flash Player 5.
Uso

expresso1 =>>expresso2
Parmetros

expresso1

Nmero ou expresso a ser deslocada para a esquerda.

expresso2

Um nmero ou expresso que converte em um inteiro de 0 a 31.

Retorna

Nada.
Descrio

Operador (atribuio composta bit a bit); este operador executa uma operao de deslocamento
para direita bit a bit e armazena o contedo como um resultado em expresso1.
Exemplo

As duas expresses a seguir so equivalentes.

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

O cdigo comentado a seguir usa o operador bit a bit (>>=) . Ele tambm um exemplo do uso
de todos os operadores bit a bit.
function convertToBinary(number){
var result = "";
for (var i=0; i<32; i++) {
// Extrai o bit menos significativo pelo uso de AND bit a bit
var lsb = number & 1;
// Adiciona esse bit a nossa seqncia de caracteres de resultado
result = (lsb ? "1" : "0") + result;
// Desloca o nmero um bit para a direita para ver prximo bit
number >>= 1;}
return result;
}
trace(convertToBinary(479));
// Retorna a seqncia de caracteres 00000000000000000000000111011111
//A seqncia de caracteres acima a representao binria do nmero decimal
// nmero 479
Consulte tambm

<< (deslocamento para a esquerda bit a bit)

Dicionrio ActionScript

72

>>> (deslocamento para a direita no assinado bit a bit)

Disponibilidade

Flash Player 5.
Uso

expresso1 >>> expresso2

Parmetros

expresso1

Nmero ou expresso a ser deslocada para a direita.

expresso2

Um nmero ou uma expresso que converte em um inteiro de 0 a 31.

Retorna

Nada.
Descrio

Operador (bit a bit); o mesmo que o operador de deslocamento para a direita bit a bit (>>), exceto
que ele no mantm o sinal da expresso original, pois os bits na esquerda sempre so
preenchidos com 0.
Exemplo

O exemplo a seguir converte -1 em um inteiro de 32 bits e o desloca 1 bit para a direita.

x = -1 >>> 1

O resultado da operao acima :

x = 2147483647

Isso porque -1 decimal 11111111111111111111111111111111 binrio (trinta e dois 1) e,

quando deslocado um bit (no assinado) para a direita, o bit menos significativo (mais direita)
descartado e o bit mais significativo (mais esquerda) preenchido com um 0. O resultado
01111111111111111111111111111111 binrio, que representa o inteiro de 32 bits 2147483647.
Consulte tambm

>>= (deslocamento para a direita bit a bit e atribuio)

>>>= (deslocamento para a direita no assinado bit a bit e

atribuio)
Disponibilidade

Flash Player 5.
Uso

expresso1 >>>= expresso2

Parmetros

expresso1

Nmero ou expresso a ser deslocada para a esquerda.

expresso2

Um nmero ou expresso que converte em um inteiro de 0 a 31.

Retorna

Nada.

73

Descrio

Operador (atribuio composta bit a bit); executa uma operao de deslocamento para direita bit
a bit no assinada e armazena o contedo como um resultado em expresso1. As duas expresses
a seguir so equivalentes:
A >>>= B
A = (A >>> B)
Consulte tambm

>>> (deslocamento para a direita no assinado bit a bit), >>= (deslocamento para
a direita bit a bit e atribuio)

Accessibility (objeto)
O objeto Accessibility um conjunto de mtodos usado para criar contedo que pode ser
acessado com o ActionScript. No Flash MX, s existe um mtodo.
Este objeto est disponvel no Flash Player 6.
Resumo de mtodos do objeto Arguments
Propriedade

Descrio

Accessibility.isActive

Indica se um programa leitor de tela est ativo.

Accessibility.isActive
Disponibilidade

Flash Player 6.
Uso

Accessibility.isActive()
Parmetros

Nenhum.
Retorna

Um valor booleano.
Descrio

Mtodo; indica se um programa leitor de tela est ativo ou no atualmente. Use este mtodo
quando desejar que seu filme tenha um comportamento diferente diante de um leitor de tela.
Consulte tambm

System.capabilities.hasAccessibility

Dicionrio ActionScript

74

add
Disponibilidade

Flash Player 4.
Uso

seq_caract1 add seq_caract2

Parmetros

seqncia de caracteres1, seqncia de caracteres2

Uma seqncia de caracteres.

Retorna

Nada.
Descrio

Operador; concatena (combina) duas ou mais seqncias de caracteres. O operador add substitui
o operador add (&) do Flash 4; os arquivos do Flash 4 que usam o operador & so convertidos
automaticamente para usar o operador add na concatenao de seqncias de caracteres quando
trazidos para o ambiente de criao do Flash 5. Entretanto, o operador add est obsoleto no Flash
5 e recomenda-se o uso do operador + na criao de contedo para o Flash 5 Player ou Flash
Player 6. Use o operador add para concatenar seqncias de caracteres se estiver criando contedo
para o Flash 4 ou verses anteriores do Player.
Consulte tambm

+ (adio)

and
Disponibilidade

Flash Player 4.
Uso

condio1 and condio2

Parmetros

condio1, condio2

Condies ou expresses que avaliam como true ou false.

Retorna

Nada.
Descrio

Operador; executa uma operao lgica AND no Flash Player 4. Se ambas as expresses forem
avaliadas como true, toda a expresso true. Esse operador est obsoleto no Flash 5 e os usurios
so incentivados a usar o novo operador && .
Consulte tambm

&& (AND de curto-circuito)

75

arguments (objeto)
O objeto Arguments uma matriz que contm os valores passados como parmetros para
qualquer funo. Toda vez que uma funo chamada no ActionScript, um objeto Arguments
criado automaticamente para essa funo. Alm disso, criada uma variante local, arguments,
que permite a consulta ao objeto Arguments.
O objeto Arguments est disponvel no Flash Player 6.
Resumo de propriedades do objeto Arguments
Propriedade

Descrio

arguments.callee

Refere-se funo sendo chamada.

arguments.caller

Refere-se ao chamamento da funo.

arguments.length

O nmero de parmetros passados para uma funo.

arguments.callee
Disponibilidade

Flash Player 5.
Uso

arguments.callee
Descrio

Propriedade; refere-se funo que est sendo chamada atualmente.

Exemplo

possvel usar a propriedade arguments.callee para tornar uma funo annima repetitiva,
como no exemplo a seguir:
factorial = function (x) {
if (x <= 1) {
return 1;
else {
return x * arguments.callee(x-1);
}
};

A seguir apresentada uma funo repetitiva nomeada:

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

}
}

Dicionrio ActionScript

76

arguments.caller
Disponibilidade

Flash Player 6.
Uso

arguments.caller
Descrio

Propriedade; refere-se ao objeto Arguments da funo chamada.

arguments.length
Disponibilidade

Flash Player 6.
Uso

arguments.length
Descrio

Propriedade; o nmero de parmetros realmente passados para uma funo.

Array (objeto)
O objeto Array permite acessar e manipular matrizes. Uma matriz um objeto cujas propriedades
so identificadas por nmeros que representam suas posies na matriz. Esse nmero chamado
de ndice. Todas as matrizes so de base zero, o que significa que o primeiro elemento na matriz
[0], o segundo [1], etc. No exemplo a seguir, myArray contm os meses do ano.
myArray[0]
myArray[1]
myArray[2]
myArray[3]

=
=
=
=

"Janeiro"
"Fevereiro"
"Maro"
"Abril"

Para criar um objeto Array, use o construtor new Array ou o operador de acesso de matriz ([]).
Para acessar os elementos de uma matriz, use o operador de acesso de matriz ([ ]).
No Flash MX, o objeto Array se tornou um objeto nativo. Assim, voc poder observar uma
melhora radical no desempenho.
Resumo de mtodos do objeto Array

77

Mtodo

Descrio

Array.concat

Concatena os parmetros e os retorna como uma nova matriz.

Array.join

Rene todos os elementos de uma matriz em uma seqncia de caracteres.

Array.pop

Remove o ltimo elemento de uma matriz e retorna seu valor.

Array.push

Adiciona um ou mais elementos ao fim de uma matriz e retorna o novo tamanho da matriz.

Array.reverse

Inverte a direo de uma matriz.

Array.shift

Remove o primeiro elemento de uma matriz e retorna seu valor.

Array.slice

Extrai uma seo de uma matriz e a retorna como uma nova matriz.

Array.sort

Classifica uma matriz no local.

Mtodo

Descrio

Array.sortOn

Classifica uma matriz com base em um campo da matriz.

Array.splice

Adiciona e/ou remove elementos de uma matriz.

Array.toString

Retorna um valor de seqncia de caracteres que representa os elementos no objeto

Array.

Array.unshift

Adiciona um ou mais elementos ao incio de uma matriz e retorna o novo tamanho da

matriz.

Resumo de propriedades do objeto Array

Propriedade

Descrio

Array.length

Retorna o tamanho da matriz.

Construtor do objeto Array

Disponibilidade

Flash Player 5.
Uso

new Array()
new Array(tamanho)
new Array(elemento0, elemento1, elemento2,...elementoN)
Parmetros

tamanho Um inteiro que especifica o nmero de elementos na matriz. No caso de elementos

no contguos, o parmetro tamanho especifica o nmero do ndice do ltimo elemento na matriz
mais 1.
elemento0...elementoN Uma lista de dois ou mais valores arbitrrios. Os valores podem ser
nmeros, seqncias de caracteres, objetos ou outras matrizes. O primeiro elemento em uma
matriz sempre tem um ndice, ou posio 0.
Retorna

Nada.
Descrio

Construtor; permite a criao de uma matriz. Use o construtor para criar diferentes tipos de
matrizes: uma matriz vazia, uma matriz com um tamanho especfico, mas cujos elementos no
tm valores, ou uma cujos elementos tm valores especficos.
Uso 1: Se os parmetros no forem especificados, ser criada uma matriz com tamanho 0.
Uso 2: Se apenas um tamanho for especificado, ser criada uma matriz com o tamanho do
nmero de elementos, sem valores.
Uso 3: Se os parmetros de elemento forem usados para especificar os valores, ser criada uma
matriz com valores especficos.
Exemplo

Uso 1: O exemplo a seguir cria um novo objeto Array com um tamanho inicial 0.
myArray = new Array();

Dicionrio ActionScript

78

Uso 3: O exemplo a seguir cria o objeto new Array go_gos, com o tamanho inicial 5.
go_gos = new Array("Belinda", "Gina", "Kathy", "Charlotte", "Jane");
trace(go_gos.join(" + "));

Os elementos iniciais da matriz go_gos so estes:

go_gos[0]
go_gos[1]
go_gos[2]
go_gos[3]
go_gos[4]

=
=
=
=
=

"Belinda";
"Gina";
"Kathy";
"Charlotte";
"Jane";

O cdigo a seguir adiciona o quinto elemento matriz go-gos e altera o primeiro elemento:
go_gos[5] = "Donna";
go_gos[1] = "Nina"
trace(go_gos.join(" + "));
Consulte tambm

Array.length, [] (acesso de matriz)

Array.concat
Disponibilidade

Flash Player 5.
Uso

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

valor0,...valorN

Nmeros, elementos ou seqncias de caracteres a serem concatenados em

uma nova matriz.

Retorna

Nada.
Descrio

Mtodo; concatena os elementos especificados nos parmetros, se houver, com os elementos em

myArray, e cria uma nova matriz. Se os parmetros valor especificarem uma matriz, os elementos
dessa matriz sero concatenados, em vez da prpria matriz. A matriz myArray permanece
inalterada.
Exemplo

O cdigo a seguir concatena duas matrizes:

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

O cdigo a seguir concatena trs matrizes:

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

79

As matrizes aninhadas no so achatadas da mesma forma que as matrizes comuns. Os elementos

de uma matriz aninhada no so desmembrados em elementos separados na matriz x, como
observado no exemplo abaixo:
a = new array ("a","b","c");
n = new array(1, [2, 3], 4);
// 2 e 3 so elementos de uma matriz aninhada
x = a.concat(n);
x[0] = "a"
x[1] = "b"
x[2] = "c"
x[3] = 1
x[4] = 2, 3
x[5] = 4

Array.join
Disponibilidade

Flash Player 5.
Uso

myArray.join([separador])
Parmetros

Um caractere ou uma seqncia de caracteres que separa elementos da matriz na

seqncia de caracteres retornada. A omisso desse parmetro resulta no uso de uma vrgula como
separador padro.

separador

Retorna

Nada.
Descrio

Mtodo; converte os elementos de uma matriz em seqncias de caracteres, insere o separador

especificado entre eles, concatena esses elementos e retorna a seqncia de caracteres resultante. A
matriz aninhada sempre separada por uma vrgula, no pelo separador passado para o mtodo
join.
Exemplo

O exemplo a seguir cria uma matriz com trs elementos. Depois, rene a matriz trs vezes
usando o separador padro, uma vrgula e um espao, e um sinal de maise os exibe na janela
Sada:
a = new Array("Terra","Lua","Sol")
trace(a.join());
// retorna Terra, Lua, Sol
trace(a.join(" - "));
// retorna Terra - Lua - Sol
trace(a.join(" + "));
// retorna Terra + Lua + Sol

Dicionrio ActionScript

80

Array.length
Disponibilidade

Flash Player 5.
Uso

myArray.length
Descrio

Propriedade; contm o tamanho da matriz. Essa propriedade atualizada automaticamente

quando so adicionados novos elementos matriz. Ao atribuir um valor ao elemento de uma
matriz (por exemplo, myArray[index] = valor), se ndice for um nmero e ndice+1 for
maior do que a propriedade length, a propriedade length ser atualizada para ndice + 1.
Exemplo

O cdigo a seguir explica como a propriedade length atualizada.

// tamanho inicial 0
myArray = new Array();
myArray[0] = 'a';
//myArray.length atualizada para 1
myArray[1] = 'b';
//myArray.length atualizada para 2
myArray[9] = 'c';
//myArray.length atualizada para 10

Array.pop
Disponibilidade

Flash Player 5.
Uso

myArray.pop()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; remove o ltimo elemento de uma matriz e retorna o valor desse elemento.
Exemplo

O cdigo a seguir cria a matriz myPets, com quatro elementos, depois remove seu ltimo
elemento.
myPets = ["gato", "cachorro", "pssaro", "peixe"];
popped = myPets.pop();
trace(popped);
// retorna peixe

81

Array.push
Disponibilidade

Flash Player 5.
Uso

myArray.push(valor,...)
Parmetros

valor

Um ou mais valores a serem anexados matriz.

Retorna

O tamanho da nova matriz.

Descrio

Mtodo; adiciona um ou mais elementos ao fim de uma matriz e retorna o novo tamanho da
matriz.
Exemplo

O exemplo a seguir cria a matriz myPets com dois elementos, gato e cachorro. A segunda linha
adiciona dois elementos matriz. Depois de chamar o mtodo push, a varivel pushed contm
quatro elementos. Como o mtodo push retorna o novo tamanho da matriz, a ao trace na
ltima linha envia o novo tamanho de myPets (4) para a janela Sada:
myPets = ["gato", "cachorro"];
pushed = myPets.push("pssaro", "peixe");
trace(pushed);

Array.reverse
Disponibilidade

Flash Player 5.
Uso

myArray.reverse()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; reverte a matriz no local.

Exemplo

O exemplo a seguir mostra um uso do mtodo Array.reverse.

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

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

Dicionrio ActionScript

82

Array.shift
Disponibilidade

Flash Player 5.
Uso

myArray.shift()
Parmetros

Nenhum.
Retorna

O primeiro elemento de uma matriz.

Descrio

Mtodo; remove o primeiro elemento de uma matriz e retorna esse elemento.

Exemplo

O cdigo a seguir cria a matriz myPets e, em seguida, remove o primeiro elemento da matriz e o
atribui varivel shifted.
myPets = ["gato", "cachorro", "pssaro", "peixe"];
shifted = myPets.shift();
trace(shifted);
// retorna gato
Consulte tambm

Array.pop

Array.slice
Disponibilidade

Flash Player 5.
Uso

myArray.slice(incio, fim)
Parmetros

Um nmero que especifica o ndice do ponto inicial da fatia. Se incio for um nmero
negativo, o ponto inicial comear no fim da matriz, onde -1 o ltimo elemento.

incio

fim Um nmero que especifica o ndice do ponto final da fatia. Se esse argumento for omitido,
a fatia incluir todos os elementos do incio ao fim da matriz. Se fim for um nmero negativo, o
ponto final ser especificado a partir do fim da matriz, onde -1 o ltimo elemento.
Retorna

Nada.
Descrio

Mtodo; extrai um segmento ou subseqncia de caracteres da matriz e o retorna como uma nova
matriz, sem modificar a matriz original. A matriz retornada inclui o elemento incio e todos os
elementos at, mas no incluindo, o elemento fim.

83

Array.sort
Disponibilidade

Flash Player 5.
Uso

myArray.sort([compareFunction])
Parmetros

Uma funo de comparao opcional usada para determinar a ordem de

classificao de elementos de uma matriz. Dados os elementos A e B, o parmetro orderfunc
pode ter um dos trs seguintes valores:

compareFunction

-1 se A aparecer antes de B na seqncia classificada

0 se A = B
1 se A aparecer depois de B na seqncia classificada
Retorna

Nada.
Descrio

Mtodo; classifica a matriz no local, sem fazer uma cpia. Se o argumento orderfunc for
omitido, o Flash classificar os elementos no local com o operador de comparao <.
Exemplo

O exemplo a seguir usa Array.sort sem especificar o parmetro compareFunction.

var fruits = ["oranges", "apples", "strawberries", "pineapples", "cherries"];
trace(fruits.join());
fruits.sort()
trace(fruits.join());

Sada:
oranges,apples,strawberries,pineapples,cherries
exibido apples,cherries,oranges,pineapples,strawberries

Dicionrio ActionScript

84

O exemplo a seguir usa Array.sort com uma funo de ordenao especificada.

var passwords = [
"gary:foo",
"mike:bar",
"john:snafu",
"steve:yuck",
"daniel:1234"
];
function order (a, b) {
// Entradas a serem classificadas esto na forma
// nome:senha
// Classifica usando somente a parte do nome da
// entrada como chave.
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 ("Classificado:");
for (var i=0; i< password.length; i++) {
trace (passwords.join());
}

A execuo do cdigo anterior exibe o seguinte resultado na janela Sada.

daniel:1234
gary:foo
john:snafu
mike:bar
steve:yuck

Array.sortOn
Disponibilidade

Flash Player 6.
Uso

Array.sortOn(fieldName)
Parmetros

fieldName Uma seqncia de caracteres que identifica um campo em um elemento do Array

para usar valor de classificao.
Retorna

Nenhum.

85

Descrio

Mtodo; classifica os elementos de uma matriz com base em um campo da matriz. Se nenhum
parmetro fieldName for passado, a funo falhar. Se vrios parmetros fieldName forem
passados, o primeiro campo ser convertido em um valor de seqncia de caracteres e os
parmetros remanescentes sero ignorados.
Se algum dos elementos comparados no tiver o campo especificado no parmetro fieldName, a
classificao ser o padro do comportamento no mtodo Array.sort.
Exemplo

O exemplo a seguir cria uma nova matriz e a classifica com base no 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");
// resulta no seguinte:
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
Consulte tambm

Array.sort

Array.splice
Disponibilidade

Flash Player 5.
Uso

myArray.splice(incio, deleteCount, valor0,valor1...valorN)

Parmetros

incio

O ndice do elemento na matriz onde a insero e/ou excluso comea.

O nmero de elementos a serem excludos. Esse nmero inclui o elemento

especificado no parmetro incio. Se no houver valores especificados para deleteCount, o
mtodo exclui todos os valores a partir do elemento incio at o ltimo elemento na matriz. Se o
valor for 0, nenhum elemento ser excludo.
deleteCount

Zero ou mais valores a serem inseridos na matriz no ponto de insero especificado no

parmetro incio. Este parmetro opcional.

valor

Retorna

Nada.
Descrio

Mtodo; adiciona e remove elementos de uma matriz. Esse mtodo modifica a matriz sem fazer
uma cpia.

Array.toString
Disponibilidade

Flash Player 5.

Dicionrio ActionScript

86

Uso

myArray.toString()
Parmetros

Nenhum.
Retorna

Uma seqncia de caracteres.

Descrio

Mtodo; retorna um valor de seqncia de caracteres que representa os elementos no objeto Array
especificado. Todos os elementos da matriz, iniciando pelo ndice 0 e terminando no ndice
myArray.length-1, so convertidos em uma seqncia de caracteres concatenados e separados
por vrgulas.
Exemplo

O exemplo a seguir cria myArray, a converte em uma seqncia de caracteres, e exibe 1,2,3,4,5 na
janela Sada.
myArray = new Array();
myArray[0] = 1;
myArray[1] = 2;
myArray[2] = 3;
myArray[3] = 4;
myArray[4] = 5;
trace(myArray.toString());

Array.unshift
Disponibilidade

Flash Player 5.
Uso

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

valor1,...valorN

Um ou mais nmeros, elementos ou variveis a serem inseridos no incio

da matriz.
Retorna

O novo tamanho da matriz.

Descrio

Mtodo; adiciona um ou mais elementos ao incio de uma matriz e retorna o novo tamanho da
matriz.

asfunction
Disponibilidade

Flash Player 5.
Uso

asfunction:function,"parmetro"

87

Parmetros

funo

Um identificador para uma funo.

parmetro
function.

Uma seqncia de caracteres que passada para a funo identificada no parmetro

Retorna

Nada.
Descrio

Protocolo; um protocolo especial para URLs em campos de texto HTML. Nos campos de texto
HTML, o texto pode ter um hiperlink usando a marca A de HTML. O atributo HREF da marca A
contm um URL que pode servir para um protocolo padro como HTTP, HTTPS ou FTP. O
protocolo asfunction um protocolo adicional, especfico do Flash, que faz com que o link
chame uma funo do ActionScript.
Exemplo

Neste exemplo, a funo MyFunc definida nas trs primeiras linhas de cdigo. A varivel
textField associada a um campo de texto HTML. O texto "Clique em mim!" um hiperlink
dentro do campo de texto. A funo MyFunc ser chamada quando o usurio clicar no hiperlink:
function MyFunc(arg){
trace ("Voc clicou em mim!O argumento era "+arg);
}
myTextField.text ="<A HREF=\"asfunction:MyFunc,Foo \">Clique em mim!</A>";

Ao clicar no hiperlink, os resultados a seguir so exibidos na janela Sada:

Voc clicou em mim! O parmetro foi Foo

Boolean (funo)
Disponibilidade

Flash Player 5.
Uso

Booleano(expresso)
Parmetros

expresso

Uma expresso a ser convertida em um valor booleano.

Retorna

Nada.
Descrio

Funo; converte a expresso do parmetro em um valor booleano e retorna um valor da

seguinte maneira:

Se expresso for um valor booleano, o valor de retorno ser expresso.

Se expresso for um nmero e esse no for zero, o valor de retorno ser true, caso contrrio,
o valor de retorno ser false.

Se expresso for uma seqncia de caracteres, o mtodo toNumber ser chamado e o valor de
retorno ser true se o nmero no for zero, caso contrrio, o valor de retorno ser false.

Se expresso for indefinida, o valor de retorno ser false.

Se expresso for um clipe de filme ou um objeto, o valor de retorno ser true.

Dicionrio ActionScript

88

Boolean (objeto)
O objeto Boolean um objeto envoltrio que funciona da mesma forma que o objeto Boolean
JavaScript padro. Use o objeto Boolean para recuperar o tipo de dados primitivo ou a
representao de uma seqncia de caracteres do objeto Boolean. No Flash MX, o objeto Boolean
se tornou um objeto nativo. Assim, voc poder observar uma melhora radical no desempenho.
Use o construtor new Boolean() para criar uma instncia do objeto Boolean antes de chamar
seus mtodos.
Resumo de mtodos do objeto Boolean
Mtodo

Descrio

Boolean.toString

Retorna a representao da seqncia de caracteres (true) ou (false) do objeto

Boolean.

Boolean.valueOf

Retorna o tipo de valor primitivo do objeto Boolean especificado.

Construtor do objeto Boolean

Disponibilidade

Flash Player 5.
Uso

new Boolean(x)
Parmetros

Qualquer expresso. Este parmetro opcional.

Retorna

Nada.
Descrio

Construtor; cria uma instncia do objeto Boolean. Se o parmetro x for omitido, o objeto
Boolean ser inicializado com um valor false. Caso especifique um valor para o parmetro x, o
mtodo o avalia e retorna o resultado como um valor booleano de acordo com as regras
estabelecidas na funo Boolean (funo).
Observao: Para manter a compatibilidade com o Flash Player 4, a manipulao de seqncias de caracteres pelo
objeto Boolean no usa o padro ECMA-262.

Exemplo

O cdigo a seguir cria um novo objeto Boolean vazio denominado myBoolean.

myBoolean = new Boolean();

89

Boolean.toString
Disponibilidade

Flash Player 5.
Uso

myBoolean.toString()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; retorna a representao da seqncia de caracteres, true ou false, do objeto Boolean.

Boolean.valueOf
Disponibilidade

Flash Player 5.
Uso

Boolean.valueOf()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; retorna o tipo de valor primitivo do objeto Boolean especificado.

break
Disponibilidade

Flash Player 4.
Uso

break
Parmetros

Nenhum.
Retorna

Nada.

Dicionrio ActionScript

90

Descrio

Ao; exibida em um loop (for, for..in, do while ou while) ou em um bloco de comandos

associados a um case particular em uma ao switch. A ao break instrui o Flash a ignorar o
resto do corpo do loop, parar a ao de loop e executar o comando aps o comando loop. Ao usar
a ao break, o interpretador Flash ignora o resto dos comandos nesse bloco case e vai para o
primeiro comando subseqente ao switch anexada. Use a ao break para interromper uma
srie de loops aninhados.
Exemplo

O exemplo a seguir usa a ao break para sair de um loop infinito.

i = 0;
while (true) {
if (i >= 100) {
break;
}
i++;
}
Consulte tambm

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

Button (objeto)
Todos os smbolos de boto em um filme do Flash so instncias do objeto Button. possvel dar
um nome de instncia a um boto no inspetor de propriedades e usar os mtodos e as
propriedades do objeto Button para manipular botes com o ActionScript. Nomes de instncia de
boto so exibidos no Movie Explorer e na caixa de dilogo Inserir caminho de destino no painel
Actions.
O objeto Button herda propriedades do objeto Object.
O Flash Player 6 oferece suporte ao objeto Button.
Resumo de mtodos do objeto Button
Mtodo

Descrio

Button.getDepth

Retorna a profundidade de uma instncia de boto.

Resumo de propriedades do objeto Button

91

Propriedade

Descrio

Button._alpha

O valor de transparncia de uma instncia de boto.

Button.enabled

Indica se o boto est ativo.

Button._focusrect

Indica se um boto focalizado tem um retngulo amarelo em volta dele.

Button._height

A altura de uma instncia de boto, em pixels.

Button._highquality

Indica a qualidade do filme.

Button._name

O nome de uma instncia de boto.

Button._parent

Uma referncia instncia do clipe de filme que o pai dessa instncia.

Button._quality

Indica a qualidade do filme.

Propriedade

Descrio

Button._rotation

O grau de rotao de uma instncia de boto.

Button._soundbuftime

Nmero de segundos para que um som seja pr-carregado.

Button.tabEnabled

Indica se um boto est includo na ordenao de guia automtica.

Button.tabIndex

Indica a ordem de guias de um objeto.

Button._target

O caminho de destino de uma instncia de boto.

Button.trackAsMenu

Indica se outros botes podem receber eventos de liberao de mouse.

Button._url

O URL do arquivo SWF que criou a instncia de boto.

Button.useHandCursor

Indica se o cursor mo exibido quando o mouse passar sobre um boto.

Button._visible

Um valor booleano que determina se a instncia de boto est oculta ou visvel.

Button._width

A largura de uma instncia de boto, em pixels.

Button._x

A coordenada x de uma instncia de boto.

Button._xmouse

A coordenada x do cursor relativa instncia de um boto.

Button._xscale

O valor que especifica a porcentagem para o dimensionamento horizontal de uma

instncia de boto.

Button._y

A coordenada y de uma instncia de boto.

Button._ymouse

A coordenada x do cursor relativa instncia de um boto.

Button._yscale

O valor que especifica a porcentagem para o dimensionamento vertical de uma

instncia de boto.

Resumo de eventos do objeto Button

A tabela a seguir lista os resumos de eventos do objeto Button.
Mtodo

Descrio

Button.onDragOut

Chamado enquanto o ponteiro est fora do boto, o boto do mouse

pressionado e rolado para fora da rea do boto.

Button.onDragOver

Chamada enquanto o ponteiro est sobre o boto, o boto do mouse

pressionado, rolado para fora do boto e, em seguida, rolado novamente
sobre o boto.

Button.onKeyUp

Chamada quando uma tecla liberada.

Button.onKillFocus

Chamada quando o foco removido de um boto.

Button.onPress

Chamada quando o mouse pressionado enquanto o ponteiro est sobre

um boto.

Button.onRelease

Chamada quando o mouse liberado enquanto o ponteiro est sobre um

boto.

Button.onReleaseOutside

Chamada quando o mouse liberado enquanto o ponteiro est fora de um

boto, depois que o boto pressionado enquanto o ponteiro est dentro
do boto.

Button.onRollOut

Chamada quando o ponteiro rola para fora da rea de um boto.

Button.onRollOver

Chamada quando o ponteiro do mouse rola sobre um boto.

Button.onSetFocus

Chamada quando um boto tem o foco de entrada e uma tecla liberada.

Dicionrio ActionScript

92

Button._alpha
Disponibilidade

Flash Player 6.
Uso

myButton._alpha
Descrio

Propriedade; define ou recupera a transparncia alfa (valor) do boto especificado por Button. A
faixa de valores vlidos vai de 0 (totalmente transparente) a 100 (totalmente opaco). Os objetos
em um boto com _alpha definido como 0 so ativos, apesar de invisveis.
Exemplo

O exemplo a seguir define a propriedade _alpha de um boto denominado star como 30%.
on(release) {
star._alpha = 30;
}

Button.enabled
Disponibilidade

Flash Player 6.
Uso

myButton.enabled
Descrio

Propriedade; um valor booleano que especifica se um boto est ativado. O valor padro true.

Button._focusrect
Disponibilidade

Flash Player 6.
Uso

myButton._focusrect
Descrio

Propriedade; um valor booleano que especifica se um boto tem um retngulo amarelo em volta
dele quando tiver foco de teclado. Esta propriedade pode substituir a propriedade global
_focusrect.

Button.getDepth
Disponibilidade

Flash Player 6.
Uso

myButton.getDepth()
Retorna

Um inteiro.
Descrio

Mtodo; retorna a profundidade de uma instncia de boto.

93

Button._height
Disponibilidade

Flash Player 6.
Uso

myButton._height
Descrio

Propriedade; define e recupera a altura do boto, em pixels.

Exemplo

O exemplo de cdigo a seguir define a altura e a largura de um boto quando o usurio clicar com
o mouse:
myButton._width = 200;
myButton._height = 200;

Button._highquality
Disponibilidade

Flash Player 6.
Uso

myButton._highquality
Descrio

Propriedade (global); especifica o nvel de sem serrilhado aplicado no filme atual. Especifique 2
(MELHOR) para aplicar alta qualidade com a suavizao de bitmap sempre ativada. Especifique
1 (alta qualidade) para aplicar o recurso sem serrilhado; isso suavizar os bitmaps se o filme no
contiver animao. Especifique 0 (baixa qualidade) para evitar o recurso sem serrilhado.
Exemplo

_highquality = 1;
Consulte tambm

_quality, toggleHighQuality

Button._name
Disponibilidade

Flash Player 6.
Uso

myButton._name
Descrio

Propriedade; retorna o nome de instncia do boto especificado por myButton.

Dicionrio ActionScript

94

Button.onDragOut
Disponibilidade

Flash Player 6.
Uso

myButton.onDragOut
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Manipulador de eventos; chamado quando o boto do mouse estiver pressionado sobre o boto e
o ponteiro rolar para fora do boto.

Button.onDragOver
Disponibilidade

Flash Player 6.
Uso

myButton.onDragOver
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Manipulador de eventos; chamado quando o usurio pressiona e arrasta o boto do mouse para
fora e sobre o boto.
necessrio definir uma funo que seja executada quando o evento chamado.
Exemplo

O exemplo a seguir define uma funo para o mtodo onKeyDown que envia uma ao trace
janela Sada.
myButton.onDragOver = function () {
trace ("onDragOver chamado");
};
Consulte tambm

Button.onKeyUp

95

Button.onKeyDown
Disponibilidade

Flash Player 6.
Uso

myButton.onKeyDown
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Manipulador de eventos; chamado quando um boto tiver foco de teclado e uma tecla for
pressionada. O evento onKeyDown chamado sem nenhum parmetro. Use os mtodos
Key.getAscii e Key.getCode para determinar qual tecla foi pressionada.
necessrio definir uma funo que seja executada quando o evento chamado.
Exemplo

O exemplo a seguir define uma funo para o mtodo onKeyDown que envia uma ao trace
janela Sada.
myButton.onKeyDown = function () {
trace ("onKeyDown chamado");
};
Consulte tambm

Button.onKeyUp

Button.onKeyUp
Disponibilidade

Flash Player 6.
Uso

myButton.onKeyUp
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Manipulador de eventos; chamado quando um boto tiver foco de entrada e uma tecla for
liberada. O evento onKeyUp chamado sem nenhum parmetro. Use os mtodos Key.getAscii e
Key.getCode para determinar qual tecla foi pressionada.
necessrio definir uma funo que seja executada quando o evento chamado.

Dicionrio ActionScript

96

Exemplo

O exemplo a seguir define uma funo para o mtodo onKeyPress que envia uma ao trace
janela Sada.
myButton.onKeyUp = function () {
trace ("onKeyUp chamado");
};

Button.onKillFocus
Disponibilidade

Flash Player 6.
Uso

myButton.onKillFocus = function (newFocus) {

comandos;

};
Parmetros

newFocus

O objeto em foco.

Retorna

Nada.
Descrio

Manipulador de eventos; um evento que chamado quando um boto perde o foco do teclado. O
mtodo onKillFocus recebe um parmetro, newFocus, que um objeto representando o novo
objeto a receber o foco. Se nenhum objeto receber o foco, newFocus conter o valor null.

Button.onPress
Disponibilidade

Flash Player 6.
Uso

myButton.onPress
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Manipulador de eventos; chamado quando um boto for pressionado. necessrio definir uma
funo que seja executada quando o evento chamado.
Exemplo

O exemplo a seguir define uma funo para o mtodo onPress que envia uma ao trace
janela Sada.
myButton.onPress = function () {
trace ("onPress chamado");
};

97

Button.onRelease
Disponibilidade

Flash Player 6.
Uso

myButton.onRelease
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Manipulador de eventos; chamado na liberao de um boto.

necessrio definir uma funo que seja executada quando o evento chamado.
Exemplo

O exemplo a seguir define uma funo para o mtodo onRelease que envia uma ao trace para
a janela Sada.
myButton.onRelease = function () {
trace ("onRelease chamado");
};

Button.onReleaseOutside
Disponibilidade

Flash Player 6.
Uso

myButton.onReleaseOutside
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Manipulador de eventos; chamado na liberao do mouse enquanto o ponteiro estiver fora do

boto depois de pressionar o boto enquanto o ponteiro estiver dentro do boto.
necessrio definir uma funo que seja executada quando o evento chamado.
Exemplo

O exemplo a seguir define uma funo para o mtodo onReleaseOutside que envia uma ao
trace janela Sada.
myButton.onReleaseOutside = function () {
trace ("onReleaseOutside chamado");
};

Dicionrio ActionScript

98

Button.onRollOut
Disponibilidade

Flash Player 6.
Uso

myButton.onRollOut
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Manipulador de eventos; chamado quando o ponteiro rolar para fora da rea de um boto.
necessrio definir uma funo que seja executada quando o evento chamado.
Exemplo

O exemplo a seguir define uma funo para o mtodo onRollOut que envia uma ao trace
janela Sada.
myButton.onRollOut = function () {
trace ("onRollOut chamado");
};

Button.onRollOver
Disponibilidade

Flash Player 6.
Uso

myButton.onRollOver
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Identificador de eventos; chamado na passagem do ponteiro sobre a rea de um boto.

necessrio definir uma funo que seja executada quando o evento chamado.
Exemplo

O exemplo a seguir define uma funo para o mtodo onRollOver que envia uma ao trace
janela Sada.
myButton.onRollOver = function () {
trace ("onRollOver chamado");

};

99

Button.onSetFocus
Disponibilidade

Flash Player 6.
Uso

myButton.onSetFocus = function(oldFocus){
comandos;
};
Parmetros

oldFocus

O objeto a perder o foco de teclado.

Retorna

Nada.
Descrio

Manipulador de eventos; chamado quando um boto recebe foco de teclado. O parmetro

oldFocus o objeto que perde o foco. Por exemplo, se o usurio pressionar a tecla Tab para
mover o foco de entrada de um campo de texto para um boto, o parmetro oldFocus conter a
instncia do campo de texto.
Se nenhum objeto possua o foco anteriormente, oldFocus conter um valor null.

Button._parent
Disponibilidade

Flash Player 6.
Uso

_parent.property
Descrio

Propriedade; especifica ou retorna uma referncia ao clipe de filme ou objeto que contm o clipe
de filme ou objeto atual. O objeto atual aquele que contm o cdigo do ActionScript que faz
referncia a _parent. Use _parent para especificar um caminho relativo para clipes de filme ou
objetos que estiverem acima do clipe de filme ou objeto atual. possvel usar _parent para subir
vrios nveis na lista de exibio, conforme mostrado a seguir:
_parent._parent._alpha = 20;
Consulte tambm

_root, targetPath

Button._quality
Disponibilidade

Flash Player 6.
Uso

myButton._quality
Descrio

Propriedade (global); define ou recupera a qualidade usada para um filme. As fontes de dispositivo
so sempre serrilhadas, sendo assim no so afetadas pela propriedade _quality.

Dicionrio ActionScript 100

A propriedade _quality pode ser definida nos seguintes valores:

"LOW" Qualidade baixa. Os grficos no so apresentados sem serrilhado, os bitmaps no so

suavizados.

"MEDIUM"

"HIGH" Qualidade alta. Os grficos so apresentados sem serrilhado usando uma grade de
pixels 4 x 4 e os bitmaps so suavizados se o filme for esttico. Essa a configurao de
qualidade padro usada pelo Flash.

"BEST" Qualidade muito alta. Os grficos so apresentados sem serrilhado usando uma grade
de pixels 4 x 4 e os bitmaps sempre so suavizados.

Qualidade mdia. Os grficos so apresentados sem serrilhado usando uma grade

de pixels 2 x 2, mas os bitmaps no so suavizados. Adequado para filmes que no contm
texto.

Exemplo

O exemplo a seguir define a qualidade como LOW:

myButton._quality = "LOW";
Consulte tambm

_highquality, toggleHighQuality

Button._rotation
Disponibilidade

Flash Player 6.
Uso

myButton._rotation
Descrio

Propriedade; especifica a rotao do boto em graus.

Button._soundbuftime
Disponibilidade

Flash Player 6.
Uso

myButton._soundbuftime
Descrio

Propriedade (global); um inteiro que especifica o nmero de segundos em que um som

armazenado em pr-buffer antes de comear a fluir.

101

Button.tabEnabled
Disponibilidade

Flash Player 6.
Uso

myButton.tabEnabled
Descrio

Propriedade; pode ser definida em uma instncia dos objetos MovieClip, Button ou TextField.
Por padro, no definido.
Se a propriedade tabEnabled for undefined ou true, o objeto ser includo na ordenao
automtica de guias. Se a propriedade tabIndex tambm estiver definida com um valor, o objeto
estar includo em uma ordenao de guia personalizada. Se tabEnabled for false, o objeto no
ser includo na ordenao automtica de guias. No caso de um clipe de filme, se tabEnabled for
false, os filhos do clipe de filme ainda podero ser includos na ordenao automtica de guias, a
menos que a propriedade tabChildren tambm seja definida como false.
Se tabEnabled for undefined ou true, e se a propriedade tabIndex for definida, ento o objeto
ser includo na ordenao de guia personalizada. Se tabEnabled for false, ento o objeto no
ser includo na ordenao de guia personalizada, ainda que a propriedade tabIndex seja
definida. Se tabEnabled for definido como false em um clipe de filme, os filhos do clipe de
filme ainda podero ser includos ordenao de guia personalizada.
Consulte tambm

Button.tabIndex

Button.tabIndex
Disponibilidade

Flash Player 6.
Uso

myButton.tabIndex
Descrio

Propriedade; permite personalizar a ordenao de guias dos objetos em um filme. possvel

definir a propriedade tabIndex em um boto, clipe de filme ou instncia de campo de texto. Por
padro, ela undefined.
Se algum objeto sendo exibido atualmente no filme do Flash tiver uma propriedade tabIndex, a
ordenao de guia automtica ser desativada e a ordenao de guia ser calculada nas
propriedades tabIndex de objetos do filme. A ordenao personalizada de guias inclui apenas os
objetos que tm propriedades tabIndex.
A propriedade tabIndex pode ser um inteiro no negativo. Os objetos so ordenados de acordo
com suas propriedades tabIndex, em ordem ascendente. Um objeto com um tabIndex 1 vem
antes de um objeto com tabIndex 2. Se dois objetos tiverem o mesmo tabIndex, aquele que vier
antes do outro na ordenao de guia ser undefined.
A ordenao de guia personalizada definida pela propriedade tabIndex flat. Isso significa que as
relaes hierrquicas de objetos so ignoradas no filme do Flash. Todos os objetos no filme do
Flash com propriedades tabIndex so colocados na ordem de guia. Por sua vez, essa
determinada pela ordem dos valores de tabIndex. Se dois objetos tm o mesmo valor de
tabIndex , aquele que vier primeiro ser undefined. Voc no deve usar o mesmo valor de
tabIndex para vrios objetos.

Dicionrio ActionScript 102

Button._target
Disponibilidade

Flash Player 6.
Uso

myButton._target
Descrio

Propriedade (somente leitura); retorna o caminho de destino da instncia de boto especificada no

parmetro Boto.

Button.trackAsMenu
Disponibilidade

Flash Player 6.
Uso

myButton.trackAsMenu
Descrio

Propriedade; uma propriedade booleana que indica se outros botes ou clipes de filme podem ou
no receber eventos de liberao de mouse. Permite a criao de menus. Voc pode definir a
propriedade trackAsMenu em qualquer boto ou objeto de clipe de filme. Se a propriedade
trackAsMenu no existir, o comportamento padro ser false.
possvel alterar a qualquer momento a propriedade trackAsMenu; o boto modificado assume o
novo comportamento logo em seguida.
Consulte tambm

MovieClip.trackAsMenu

Button._url
Disponibilidade

Flash Player 6.
Uso

myButton._url
Descrio

Propriedade (somente leitura); recupera o URL do arquivo SWF que criou o boto.

Button.useHandCursor
Disponibilidade

Flash Player 6.
Uso

myButton.useHandCursor

103

Descrio

Propriedade; um valor booleano que, ao ser definido como true, indica que um cursor mo ser
exibido quando o usurio passar o cursor sobre um boto. O valor padro de useHandCursor
true. Se a propriedade useHandCursor for definida como false, ento ser usado o cursor de
seta no lugar.
Se a qualquer momento a propriedade useHandCursor for alterada; o boto modificado logo
assumir o comportamento do novo cursor. A propriedade useHandCursor pode ser lida de um
objeto de prottipo.

Button._visible
Disponibilidade

Flash Player 6.
Uso

myButton._visible
Descrio

Propriedade; um valor booleano que indica se o boto especificado pelo parmetro Boto
visvel. Os botes invisveis (propriedade _visible definida como false) so desativados.

Button._width
Disponibilidade

Flash Player 6.
Uso

myButton._width
Descrio

Propriedade; define e recupera a largura do boto, em pixels.

Exemplo

O exemplo a seguir define as propriedades de altura e de largura de um boto.

myButton._width=200;
myButton._height=200;
Consulte tambm

MovieClip._width

Dicionrio ActionScript 104

Button._x
Disponibilidade

Flash Player 6.
Uso

myButton._x
Descrio

Propriedade; um inteiro que define a coordenada x de um boto em relao s coordenadas locais

do clipe de filme pai. Se um boto estiver na Linha de tempo principal, seu sistema de
coordenadas refere-se ao canto superior esquerdo do Palco como (0, 0). Se o boto estiver dentro
de outro clipe de filme que tenha transformaes, o boto est no sistema de coordenadas local do
clipe de filme anexado. Assim, para que um clipe de filme gire 90 no sentido anti-horrio, o
boto anexado herda um sistema de coordenadas que girado 90 no sentido anti-horrio. As
coordenadas do boto referem-se posio do ponto do registro.
Consulte tambm

Button._xscale, Button._y, Button._yscale

Button._xmouse
Disponibilidade

Flash Player 6.
Uso

myButton._xmouse
Descrio

Propriedade (somente leitura); retorna a coordenada x da posio do mouse em relao ao boto.

Consulte tambm

Button._ymouse

Button._xscale
Disponibilidade

Flash Player 6.
Uso

myButton._xscale
Descrio

Propriedade; determina o dimensionamento horizontal (porcentagem) do boto conforme

aplicado do ponto do registro do boto. O ponto de registro padro (0,0).
Dimensionar o sistema de coordenadas local afeta as configuraes da propriedade _x e _y, que
so definidas em pixels. Por exemplo, se o clipe de filme pai for dimensionado em 50%, definir a
propriedade _x move um objeto no boto pela metade do nmero de pixels, como se o filme
tivesse sido dimensionado em 100%.
Consulte tambm

Button._x, Button._y, Button._yscale

105

Button._y
Disponibilidade

Flash Player 6.
Uso

myButton._y
Descrio

Propriedade; define a coordenada y do boto em relao s coordenadas locais do clipe de filme

pai. Se um boto estiver na Linha de tempo principal, seu sistema de coordenadas ir referir-se ao
canto superior esquerdo do Palco como (0, 0). Se o boto estiver dentro de outro clipe de filme
que tem transformaes, o boto est no sistema de coordenadas local do clipe de filme anexado.
Assim, para que um clipe de filme gire 90 no sentido anti-horrio, o boto anexado herda um
sistema de coordenadas que girado 90 no sentido anti-horrio. As coordenadas do boto
referem-se posio do ponto do registro.
Consulte tambm

Button._x, Button._xscale, Button._yscale

Button._ymouse
Disponibilidade

Flash Player 6.
Uso

myButton._ymouse
Descrio

Propriedade (somente leitura); indica a coordenada y da posio do mouse em relao ao boto.

Consulte tambm

Button._xmouse

Button._yscale
Disponibilidade

Flash Player 6.
Uso

myButton._yscale
Descrio

Propriedade; define a escala vertical (porcentagem) do boto conforme aplicado do ponto de

registro do boto. O ponto de registro padro (0,0).
Consulte tambm

Button._y, Button._x, Button._xscale

Dicionrio ActionScript 106

call
Disponibilidade

Flash Player 4. Esta ao tornou-se obsoleta no Flash 5. Recomenda-se o uso da ao function

em seu lugar.
Uso

call(quadro)
Parmetros

quadro

O rtulo ou nmero de um quadro na Linha de tempo.

Retorna

Nada.
Descrio

Ao; executa o script no quadro chamado, sem mover a reproduo para esse quadro. No haver
variveis locais, uma vez que a execuo do script concluda.
Consulte tambm

function

chamar funo
Disponibilidade

Flash Player 6
Uso

objeto.funo([parmetros])
Parmetros

objeto

Um objeto (pode ser um clipe de filme) em que a funo foi definida.

funo

Um identificador que especifica uma funo definida pelo usurio.

Um parmetro opcional que indica um parmetro necessrio funo.

parmetros
Retorna

Nada.
Descrio

Ao; permite o uso de campos de parmetros para chamar uma funo definida pelo usurio no
modo Normal no painel Aes.

case
Disponibilidade

Flash Player 4.
Uso

expresso case: comandos

Parmetros

expresso
comandos

107

Qualquer expresso.
Qualquer comando.

Retorna

Nada.
Descrio

Palavra-chave; define uma condio para a ao switch. Os comandos no parmetro comandos

so executados se o parmetro expresso subseqente palavra-chave case for igual ao
parmetro expresso da ao switch que usa a igualdade estrita (===)
O uso da ao case fora de um comando switch apresenta erro e o script no compilado.
Consulte tambm

switch, default, break, === (igualdade estrita)

chr
Disponibilidade

Flash Player 4. Esta funo foi reprovada no Flash 5 e substituda pelo mtodo
String.fromCharCode.
Uso

chr(nmero)
Parmetros

nmero

Um nmero de cdigo ASCII.

Retorna

Nada.
Descrio

Funo de seqncia de caracteres; converte cdigo ASCII em caracteres.

Exemplo

O exemplo a seguir converte o nmero 65 na letra A e o atribui varivel myVar.

myVar = chr(65);
Consulte tambm

String.fromCharCode

clearInterval
Disponibilidade

Flash Player 6.
Uso

clearInterval( intervalID )
Parmetros

intervalID

Um objeto retornado de uma chamada funo setInterval.

Retorna

Nada.
Descrio

Ao; limpa a chamada da funo setInterval.

Dicionrio ActionScript 108

Exemplo

O exemplo a seguir em primeiro lugar define uma chamada de intervalo, depois limpa-a:
function callback() {
trace("interval chamado");
}
var intervalID;
intervalID = setInterval( callback, 1000 );
// depois de algum tempo
clearInterval( intervalID );
Consulte tambm

setInterval

Color (objeto)
O objeto Color define o valor de cor RGB e a transformao de cor de clipes de filmes e recupera
esses valores depois da definio.
necessrio usar o construtor new Color() para criar uma instncia do objeto Color antes de
chamar os mtodos.
Somente o Flash 5 e as verses mais recentes do Flash Player oferecem suporte ao objeto Color.
Resumo de mtodos do objeto Color
Mtodo

Descrio

Color.getRGB

Retorna o valor RGB definido pela ltima chamada setRGB.

Color.getTransform

Retorna a informao de transformao definida pela ltima chamada setTransform.

Color.setRGB

Define a representao hexadecimal do valor RGB de um objeto Color.

Color.setTransform

Define a transformao de cor de um objeto Color.

Construtor do objeto Color

Disponibilidade

Flash Player 5.
Uso

new Color(destino);
Parmetros

destino

O nome da instncia de um clipe de filme.

Retorna

Nada.
Descrio

Construtor; cria uma instncia do objeto Color para o clipe de filme especificado pelo parmetro
destino. Depois ser possvel usar os mtodos desse objeto Color para alterar a cor de todo o
clipe de filme de destino.

109

Exemplo

O exemplo a seguir cria uma instncia do objeto Color denominado myColor para o clipe de
filme myMovieClip e define seu valor RGB:
myColor = new Color(myMovieClip);
myColor.setRGB(0xff9933);

Color.getRGB
Disponibilidade

Flash Player 5.
Uso

myColor.getRGB()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; retorna os valores numricos definidos pela ltima chamada setRGB.

Exemplo

O cdigo a seguir recupera o valor RGB da instncia myColor do objeto Color, converte-o em
uma seqncia de caracteres hexadecimal e a atribui varivel value.
value = myColor.getRGB().toString(16);
Consulte tambm

Color.setRGB

Color.getTransform
Disponibilidade

Flash Player 5.
Uso

myColor.getTransform()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; retorna os valores de transformao definidos pela ltima chamada setTransform.

Consulte tambm

Color.setTransform

Dicionrio ActionScript

110

Color.setRGB
Disponibilidade

Flash Player 5.
Uso

myColor.setRGB(0xRRGGBB)
Parmetros

0xRRGGBB Cor hexadecimal ou RGB a ser definida. RR, GG e BB consistem cada um em dois
dgitos hexadecimais que especifiquem o deslocamento de cada componente de cor. A seqncia
0x informa ao compilador do ActionScript que o nmero um valor hexadecimal.
Descrio

Mtodo; especifica uma cor RGB para uma instncia do objeto Color. Quando este mtodo
chamado, todas as definies anteriores so substitudas pelo mtodo setTransform.
Retorna

Nada.
Exemplo

Este exemplo define o valor de cor RGB do clipe de filme myMovie. Para observar o
funcionamento deste cdigo, coloque um clipe de filme no Palco com o nome da instncia,
myMovie. Depois, coloque o cdigo a seguir no Quadro 1 na Linha de tempo principal e escolha
Controlar > Testar filme.
myColor = new Color(myMovie);
myColor.setRGB(0x993366);
Consulte tambm

Color.setTransform

Color.setTransform
Disponibilidade

Flash Player 5.
Uso

myColor.setTransform(objetoTransformCor);
Parmetros

colorTransformObject Um objeto criado com o construtor new Object. Esta instncia do

objeto Object deve ter as seguintes propriedades que especificam valores de transformao de cor:
ra, rb, ga, gb, ba, bb, aa, ab. Essas propriedades so explicadas a seguir.
Retorna

Nada.
Descrio

Mtodo; define as informaes de transformao de cor para uma instncia do objeto Color. O
parmetro colorTransformObject um objeto genrico criado a partir do construtor new
Object. Ele possui parmetros que especificam os valores de porcentagem e de deslocamento dos
componentes vermelho, verde, azul e alfa (transparncia) de uma cor, inseridos no formato
0xRRGGBBAA.

111

Os parmetros de um objeto de transformao de cor correspondem s configuraes na caixa de

dilogo Efeito avanado e so definidos da seguinte forma:

ra

a porcentagem do componente vermelho (-100 a 100).

rb

o deslocamento do componente vermelho (-255 a 255).

ga

a porcentagem do componente verde (-100 a 100).

gb

o deslocamento do componente verde (-255 a 255).

ba

a porcentagem do componente azul (-100 a 100).

bb

o deslocamento do componente azul (-255 a 255).

aa

a porcentagem de alpha (-100 a 100).

ab

o deslocamento de alpha (-255 a 255).

Crie um parmetro colorTransformObject desta maneira:

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;

Alm disso, possvel usar a seguinte sintaxe para criar um parmetro colorTransformObject:
myColorTransform = { ra: 50, rb: 244, ga: 40, gb: 112, ba: 12, bb:
90, aa: 40, ab: 70}
Exemplo

Este exemplo cria uma nova instncia do objeto Color para um filme de destino. Alm disso, cria
um objeto genrico denominado myColorTransform com as propriedades definidas acima e usa o
mtodo setTransform para passar o colorTransformObject para um objeto Color. Para usar
esse cdigo em um documento Flash (FLA), coloque-o no Quadro 1 na Linha de tempo principal
e coloque um clipe de filme no Palco com o nome de instncia myMovie, como no cdigo a seguir:
//Crie um objeto de cor chamado myColor para o destino myMovie
myColor = new Color(myMovie);
// Crie um objeto de transformao de cor chamado myColorTransform usando
// o objeto genrico Object
myColorTransform = new Object();
// Defina os valores de myColorTransform
myColorTransform = { ra: '50', rb: '244', ga: '40', gb: '112', ba: '12', bb:
'90', aa: '40', ab: '70'};
// Associe o objeto de transformao de cor ao objeto Color
// criado para myMovie
myColor.setTransform(myColorTransform);

Dicionrio ActionScript

112

continue
Disponibilidade

Flash Player 4.
Uso

continue
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Ao; aparece em vrios tipos de comandos de loop; em cada um dos tipos tem um
comportamento diferente.
Em um loop while, continue faz o interpretador do Flash ignorar o resto do corpo do loop e
saltar para o incio do loop, onde a condio testada.
Em um loop do...while, continue faz o interpretador do Flash ignorar o resto do corpo do
loop e saltar para o fim do loop, onde a condio testada.
Em um loop for, continue faz o interpretador do Flash ignorar o resto do corpo do loop e saltar
para a avaliao da ps-expresso for do loop.
Em um loop for...in, continue faz o interpretador do Flash ignorar o resto do corpo do loop e
voltar ao incio do loop, onde o prximo valor na enumerao processado.
Consulte tambm

do while, for, for..in, while

CustomActions (objeto)
Os mtodos do objeto CustomActions permitem que um filme do Flash seja executado na
ferramenta de criao do Flash para gerenciar quaisquer aes personalizadas registradas na
ferramenta de criao. Um filme do Flash pode instalar e desinstalar aes personalizadas, recupar
a definio XML de uma ao personalizada e recuperar a lista de aes personalizadas registradas.
Use esses mtodos para montar filmes do Flash que sejam extenses da ferramenta de criao do
Flash. Um filme de extenso como esse poderia, por exemplo, usar o protocolo do aplicativo Flash
para navegar em um repositrio UDDI e fazer download de servios da Web na caixa de
ferramentas Aes.
Resumo de mtodos do objeto CustomActions

113

Mtodo

Descrio

CustomActions.get

L o contedo de um arquivo de definio XML de aes personalizadas.

CustomActions.install

Instala um novo arquivo de definio XML de aes personalizadas.

CustomActions.list

Retorna uma lista de todas as aes personalizadas registradas.

CustomActions.uninstall

Remove um arquivo de definio XML de aes personalizadas.

CustomActions.get
Disponibilidade

Flash Player 6.
Uso

CustomActions.get(customActionsName)
Parmetros

customActionsName

O nome da definio de aes personalizadas a ser recuperada.

Retorna

Nada.
Descrio

Mtodo; l o contedo do arquivo de definio XML de aes personalizadas denominado

customActionsName.
O nome do arquivo de definies deve ser simples, sem a extenso de arquivo .xml e sem qualquer
separador de diretrio (':', '/' ou '\').
Se o arquivo de definies especificado por customActionsName no puder ser encontrado, ser
retornado o valor undefined. Se a definio XML de aes personalizadas especificada pelo
parmetro customActionsName for localizada, ela ser lida por inteiro e retornada como uma
seqncia de caracteres.

CustomActions.install
Disponibilidade

Flash Player 6.
Uso

CustomActions.install(customActionsName, customXMLDefinition)
Parmetros

customActionsName
customXMLDefinition

O nome da definio de aes personalizadas a ser instalada.

O texto da definio XML a ser instalada.

Retorna

Nada.
Descrio

Mtodo; instala um novo arquivo de definio XML de aes personalizadas indicado pelo
parmetro customActionsName. O contedo do arquivo especificado pela seqncia de
caracteres customXMLDefinition.
O nome do arquivo de definies deve ser simples, sem a extenso de arquivo .xml e sem qualquer
separador de diretrio (':', '/' ou '\').
Se j existir um arquivo de aes personalizadas com o nome customActionsName, ele ser
substitudo.
Se ocorrer um erro durante a instalao, ser retornado o valor false; caso contrrio, ser
retornado o valor true para indicar que a ao personalizada foi instalada com xito.
Se o diretrio Configurao/ActionsPanel/CustomActions for inexistente quando esse mtodo for
chamado, ento o diretrio ser criado.

Dicionrio ActionScript

114

CustomActions.list
Disponibilidade

Flash Player 6.
Uso

CustomActions.list()
Parmetros

Nenhum.
Retorna

Uma matriz.
Descrio

Mtodo; retorna um objeto Array que contm os nomes de todas as aes personalizadas
registradas na ferramenta de criao do Flash. Os elementos da matriz so nomes simples, sem a
extenso de arquivo .xml e sem qualquer separador de diretrio ( por exemplo, :, / ou \). Se
no houver aes personalizadas registradas, o mtodo list retornar uma matriz de tamanho
zero. Se ocorrer um erro, o mtodo list retornar o valor undefined.

CustomActions.uninstall
Disponibilidade

Flash Player 6.
Uso

CustomActions.uninstall(customActionsName)
Parmetros

customActionsName

O nome da definio de aes personalizadas a ser desinstalada.

Retorna

Nada.
Descrio

Mtodo; remove o arquivo de definio XML de aes personalizadas denominado

customActionsName.
O nome do arquivo de definies deve ser simples, sem a extenso de arquivo .xml e sem qualquer
separador de diretrio (':', '/' ou '\').
Se no forem localizadas aes personalizadas com o nome customActionsName, ser retornado o
valor false. Se a remoo das aes personalizadas for bem sucedida, ser retornado o valor true.

Date (objeto)
O objeto Date permite a recuperao dos valores de data e hora relativos hora universal (Hora de
Greenwich, agora chamada de Hora Coordenada Universal) ou relativos ao sistema operacional
em que o Flash Player est sendo executado. Os mtodos do objeto Date no so estticos, mas se
aplicam somente instncia individual do objeto Date especificado quando o mtodo chamado.
O mtodo Date.UTC uma exceo, ele esttico.

115

O objeto Date trata do horrio de vero de modo diferente, em funo do sistema operacional em
uso, e da verso do Flash Player. O Flash Player 6 trata do horrio de vero nestes sistemas
operacionais das seguintes maneiras:

Windowsa sada do objeto Date ajustada automaticamente para o horrio de vero. O

objeto Date detecta se o horrio de vero est em vigor no local atual. Em caso positivo, ele
detecta a data e hora da transio do horrio padro para o horrio de vero. Contudo, as datas
de mudana atualmente em vigor so aplicadas a datas passadas e futuras, sendo assim, as
diferenas de horrio de vero podem ser calculadas de forma errada em datas passadas quando
o local tiver datas de mudana diferentes.

Mac OS 8 e 9o objeto Date usa a diferena relativa ao horrio de vero atual,

independentemente da data ou hora que est sendo calculada. Por exemplo, nos EUA, no fuso
horrio do Pacfico em agosto, quando o horrio de vero (DST) est em vigor, um objeto
Date que tenha a data 1 jan. 2001 ainda informar o horrio de vero, embora ele no esteja
mais em vigor no ms de janeiro. Este problema no pode solucionado no Mac OS 8 ou 9, pois
o banco de dados com as informaes de fuso horrio no est disponvel.

Mac OS Xo objeto Date ajusta automaticamente a sada para horrio de vero. O banco de
dados com as informaes de fuso horrio no Mac OS X usado para determinar se a diferena
de horrio de vero deve ser aplicada a alguma data ou hora atual ou passada.
O Flash Player 5 gerencia o horrio de vero nestes sistemas operacionais da seguinte maneira:

Mac OS 8 e 9o comportamento o mesmo descrito para o Flash Player 6.

Windowsas regras norte-americanas de horrio de vero sempre so aplicadas, o que leva a
mudanas incorretas nos pases da Europa e de outras regies que adotam o horrio de vero
mas com horas de transio diferentes dos Estados Unidos. O Flash detecta corretamente se o
horrio de vero est em vigor no local atual.
Para chamar os mtodos do objeto Date, crie primeiro uma instncia do objeto Date com o
construtor adequado.
O objeto Date requer o Flash Player 5.
Resumo de mtodos do objeto Date
Mtodo

Descrio

Date.getDate

Retorna o dia do ms de acordo com a hora local.

Date.getDay

Retorna o dia da semana de acordo com a hora local.

Date.getFullYear

Retorna o ano com quatro dgitos de acordo com a hora local.

Date.getHours

Retorna a hora de acordo com a hora local.

Date.getMilliseconds

Retorna os milissegundos de acordo com a hora local.

Date.getMinutes

Retorna os minutos de acordo com a hora local.

Date.getMonth

Retorna o ms de acordo com a hora local.

Date.getSeconds

Retorna os segundos de acordo com a hora local.

Date.getTime

Retorna o nmero de milissegundos desde a meia-noite de 1 de janeiro de 1970,

hora universal.

Date.getTimezoneOffset

Retorna a diferena, em minutos, entre o a hora local do computador e a hora

universal.

Date.getUTCDate

Retorna o dia (data) do ms de acordo com a hora universal.

Dicionrio ActionScript

116

117

Mtodo

Descrio

Date.getUTCDay

Retorna o dia da semana de acordo com a hora universal.

Date.getUTCFullYear

Retorna o ano com quatro dgitos de acordo com a hora universal.

Date.getUTCHours

Retorna a hora de acordo com a hora universal.

Date.getUTCMilliseconds

Retorna os milissegundos de acordo com a hora universal.

Date.getUTCMinutes

Retorna os minutos de acordo com a hora universal.

Date.getUTCMonth

Retorna o ms de acordo com a hora universal.

Date.getUTCSeconds

Retorna os segundos de acordo com a hora universal.

Date.getYear

Retorna o ano de acordo com a hora local.

Date.setDate

Define o dia do ms de acordo com a hora local. Retorna a nova hora em

milissegundos.

Date.setFullYear

Define o ano completo de acordo com a hora local. Retorna a nova hora em
milissegundos.

Date.setHours

Define a hora de acordo com a hora local. Retorna a nova hora em milissegundos.

Date.setMilliseconds

Define os milissegundos de acordo com a hora local. Retorna a nova hora em

milissegundos.

Date.setMinutes

Define os minutos de acordo com a hora local. Retorna a nova hora em

milissegundos.

Date.setMonth

Define o ms de acordo com a hora local. Retorna a nova hora em milissegundos.

Date.setSeconds

Define os segundos de acordo com a hora local. Retorna a nova hora em

milissegundos.

Date.setTime

Define a data em milissegundos. Retorna a nova hora em milissegundos.

Date.setUTCDate

Define a data de acordo com a hora universal. Retorna a nova hora em

milissegundos.

Date.setUTCFullYear

Define o ano de acordo com a hora universal. Retorna a nova hora em

milissegundos.

Date.setUTCHours

Define a hora de acordo com a hora universal. Retorna a nova hora em

milissegundos.

Date.setUTCMilliseconds

Define os milissegundos de acordo com a hora universal. Retorna a nova hora em

milissegundos.

Date.setUTCMinutes

Define os minutos de acordo com a hora universal. Retorna a nova hora em

milissegundos.

Date.setUTCMonth

Define o ms de acordo com a hora universal. Retorna a nova hora em

milissegundos.

Date.setUTCSeconds

Define os segundos de acordo com a hora universal. Retorna a nova hora em

milissegundos.

Date.setYear

Define o ano de acordo com a hora local.

Date.toString

Retorna um valor de seqncia de caracteres representando a data e a hora

armazenadas no objeto Date especificado.

Date.UTC

Retorna o nmero de milissegundos entre a meia-noite de 1 de janeiro de 1970,

hora universal, e a hora especificada.

Construtor do objeto Date

Disponibilidade

Flash Player 5.
Uso

new Date()
new Date(ano [, ms [, data [, hora [, minutos [, segundos [, milissegundos
]]]]])
Parmetros

ano

Um valor de 0 a 99 indica 1900 a 1999; caso contrrio, especifique todos os 4 dgitos do

ano.
ms

Um inteiro entre 0 (janeiro) e 11 (dezembro).

data

Um inteiro de 1 a 31. Este parmetro opcional.

hora

Um inteiro entre 0 (meia-noite) e 23 (11 p.m.).

minutos

Um inteiro de 0 a 59. Este parmetro opcional.

segundos

Um inteiro de 0 a 59. Este parmetro opcional.

milissegundos

Um inteiro de 0 a 999. Este parmetro opcional.

Retorna

Um inteiro.
Descrio

Objeto; constri um objeto new Date que mantm a data e hora atuais ou a data especificada.
Exemplo

O exemplo a seguir recupera a data e hora atuais.

now = new Date();

O exemplo a seguir cria um objeto new Date para o aniversrio de Gary, 7 de agosto de 1974.
gary_birthday = new Date (74, 7, 7);

O exemplo a seguir cria um objeto new Date, concatena os valores retornados dos mtodos
getMonth, getDate e getFullYear do objeto Date e os exibe no campo de texto especificado
pela varivel dateTextField.
myDate = new Date();
dateTextField = ((myDate.getMonth() + 1) + "/" + myDate.getDate() + "/" +
myDate.getFullYear());

Date.getDate
Disponibilidade

Flash Player 5.
Uso

myDate.getDate()
Parmetros

Nenhum.

Dicionrio ActionScript

118

Retorna

Um inteiro.
Descrio

Mtodo; retorna o dia do ms (um inteiro de 1 a 31) do objeto Date especificado, de acordo com
a hora local. A hora local determinada pelo sistema operacional em que o Flash Player est sendo
executado.

Date.getDay
Disponibilidade

Flash Player 5.
Uso

myDate.getDay()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna o dia da semana (0 para domingo, 1 para segunda-feira 1, etc.) do objeto Date
especificado, de acordo com a hora local. A hora local determinada pelo sistema operacional em
que o Flash Player est sendo executado.

Date.getFullYear
Disponibilidade

Flash Player 5.
Uso

myDate.getFullYear()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna o ano completo (um nmero de quatro dgitos, por exemplo, 2000) do objeto
Date especificado, de acordo com a hora local. A hora local determinada pelo sistema
operacional em que o Flash Player est sendo executado.
Exemplo

O exemplo a seguir usa o construtor para criar um objeto new Date e enviar o valor retornado
pelo mtodo getFullYear para a janela Sada.
myDate = new Date();
trace(myDate.getFullYear());

119

Date.getHours
Disponibilidade

Flash Player 5.
Uso

myDate.getHours()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna a hora (um inteiro de 0 a 23) do objeto Date especificado, de acordo com a hora
local. A hora local determinada pelo sistema operacional em que o Flash Player est sendo
executado.

Date.getMilliseconds
Disponibilidade

Flash Player 5.
Uso

myDate.getMilliseconds()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna os milissegundos (um inteiro de 0 a 999) do objeto Date especificado, de acordo
com a hora local. A hora local determinada pelo sistema operacional em que o Flash Player est
sendo executado.

Date.getMinutes
Disponibilidade

Flash Player 5.
Uso

myDate.getMinutes()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna os minutos (um inteiro de 0 a 59) do objeto Date especificado, de acordo com a
hora local. A hora local determinada pelo sistema operacional em que o Flash Player est sendo
executado.

Dicionrio ActionScript 120

Date.getMonth
Disponibilidade

Flash Player 5.
Uso

myDate.getMonth()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna o ms (0 para janeiro, 1 para fevereiro, etc.) do objeto Date especificado, de
acordo com a hora local. A hora local determinada pelo sistema operacional em que o Flash
Player est sendo executado.

Date.getSeconds
Disponibilidade

Flash Player 5.
Uso

myDate.getSeconds()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna os segundos (um inteiro de 0 a 59) do objeto Date especificado, de acordo com a
hora local. A hora local determinada pelo sistema operacional em que o Flash Player est sendo
executado.

Date.getTime
Disponibilidade

Flash Player 5.
Uso

myDate.getTime()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna o nmero de milissegundos desde a meia-noite de 1 de janeiro de 1970, hora

universal, do objeto Date especificado. Use este mtodo para representar um instante especfico
no tempo quando comparar dois ou mais objetos Date.

121

Date.getTimezoneOffset
Disponibilidade

Flash Player 5.
Uso

mydate.getTimezoneOffset()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna a diferena, em minutos, entre a hora local do computador e a hora universal.
Exemplo

O exemplo a seguir retorna a diferena entre o horrio de vero de So Francisco e a hora

universal. O horrio de vero ser includo no resultado apresentado somente se a data definida
no objeto Date constar do perodo do horrio de vero.
trace(new Date().getTimezoneOffset());
//
//
//
//
//

420 exibido na janela Sada

(7 horas * 60 minutos/hora = 420 minutos)
Este um exemplo de horrio de vero do Pacfico (PDT (Pacific
Daylight Time) GMT-0700).
O resultado varia em funo do local e da hora do ano.

Date.getUTCDate
Disponibilidade

Flash Player 5.
Uso

myDate.getUTCDate()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna o dia (data) do ms do objeto Date especificado, de acordo com a hora universal.

Dicionrio ActionScript 122

Date.getUTCDay
Disponibilidade

Flash Player 5.
Uso

myDate.getUTCDate()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna o dia da semana do objeto Date especificado, de acordo com a hora universal.

Date.getUTCFullYear
Disponibilidade

Flash Player 5.
Uso

myDate.getUTCFullYear()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna o ano com quatro dgitos do objeto Date especificado, de acordo com a hora
universal.

Date.getUTCHours
Disponibilidade

Flash Player 5.
Uso

myDate.getUTCHours()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna a hora do objeto Date especificado, de acordo com a hora universal.

123

Date.getUTCMilliseconds
Disponibilidade

Flash Player 5.
Uso

myDate.getUTCMilliseconds()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna os milissegundos do objeto Date especificado, de acordo com a hora universal.

Date.getUTCMinutes
Disponibilidade

Flash Player 5.
Uso

myDate.getUTCMinutes()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna os minutos do objeto Date especificado, de acordo com a hora universal.

Date.getUTCMonth
Disponibilidade

Flash Player 5.
Uso

myDate.getUTCMonth()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna o ms do objeto Date especificado, de acordo com a hora universal.

Dicionrio ActionScript 124

Date.getUTCSeconds
Disponibilidade

Flash Player 5.
Uso

myDate.getUTCSeconds()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna os segundos do objeto Date especificado, de acordo com a hora universal.

Date.getYear
Disponibilidade

Flash Player 5.
Uso

myDate.getYear()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna o ano do objeto Date especificado, de acordo com a hora local. A hora local
determinada pelo sistema operacional em que o Flash Player est sendo executado. O ano
completo menos 1900. Por exemplo, o ano 2000 representado como 100.

Date.setDate
Disponibilidade

Flash Player 5.
Uso

myDate.setDate(data)
Parmetros

data

Um inteiro de 1 a 31.

Retorna

Um inteiro.
Descrio

Mtodo; define o dia do ms do objeto Date especificado, de acordo com a hora local, e retorna a
nova hora em milissegundos. A hora local determinada pelo sistema operacional em que o Flash
Player est sendo executado.

125

Date.setFullYear
Disponibilidade

Flash Player 5.
Uso

myDate.setFullYear(ano [, ms [, data]] )
Parmetros

ano Um nmero de quatro dgitos que especifica um ano. Nmeros de dois dgitos no
representam anos; por exemplo, 99 no o ano 1999, mas o ano 99.
ms
data

Um inteiro entre 0 (janeiro) e 11 (dezembro). Este parmetro opcional.

Um nmero de 1 a 31. Este parmetro opcional.

Retorna

Um inteiro.
Descrio

Mtodo; define o ano do objeto Date especificado, de acordo com a hora local, e retorna a nova
hora em milissegundos. Se os parmetros ms e data forem especificados, esses tambm sero
definidos para a hora local. A hora local determinada pelo sistema operacional em que o Flash
Player est sendo executado.
Quando este mtodo chamado, os outros campos do objeto Date especificado no so
modificados, mas, se o dia da semana for alterado em decorrncia do chamamento a esse mtodo,
os mtodos getUTCDay e getDay podem reportar um novo valor.

Date.setHours
Disponibilidade

Flash Player 5.
Uso

myDate.setHours(hora)
Parmetros

hora

Um inteiro entre 0 (meia-noite) e 23 (11 p.m.).

Retorna

Um inteiro.
Descrio

Mtodo; define as horas do objeto Date especificado, de acordo com a hora local, e retorna a nova
hora em milissegundos. A hora local determinada pelo sistema operacional em que o Flash
Player est sendo executado.

Dicionrio ActionScript 126

Date.setMilliseconds
Disponibilidade

Flash Player 5.
Uso

myDate.setMilliseconds(milissegundos)
Parmetros

milissegundos

Um inteiro de 0 a 999.

Retorna

Um inteiro.
Descrio

Mtodo; define os milissegundos do objeto Date especificado, de acordo com a hora local, e
retorna a nova hora em milissegundos. A hora local determinada pelo sistema operacional em
que o Flash Player est sendo executado.

Date.setMinutes
Disponibilidade

Flash Player 5.
Uso

myDate.setMinutes(minutos)
Parmetros

minutos

Um inteiro de 0 a 59.

Retorna

Um inteiro.
Descrio

Mtodo; define os minutos do objeto Date especificado, de acordo com a hora local, e retorna a
nova hora em milissegundos. A hora local determinada pelo sistema operacional em que o Flash
Player est sendo executado.

Date.setMonth
Disponibilidade

Flash Player 5.
Uso

myDate.setMonth(ms [, data ])
Parmetros

ms
data

Um inteiro entre 0 (janeiro) e 11 (dezembro).

Um inteiro de 1 a 31. Este parmetro opcional.

Retorna

Um inteiro.

127

Descrio

Mtodo; define o ms do objeto Date especificado, de acordo com a hora local, e retorna a nova
hora em milissegundos. A hora local determinada pelo sistema operacional em que o Flash
Player est sendo executado.

Date.setSeconds
Disponibilidade

Flash Player 5.
Uso

myDate.setSeconds(segundos)
Parmetros

segundos

Um inteiro de 0 a 59.

Retorna

Um inteiro.
Descrio

Mtodo; define os segundos do objeto Date especificado, de acordo com a hora local, e retorna a
nova hora em milissegundos. A hora local determinada pelo sistema operacional em que o Flash
Player est sendo executado.

Date.setTime
Disponibilidade

Flash Player 5.
Uso

myDate.setTime(milissegundos)
Parmetros

milissegundos

Um valor inteiro onde 0 0:00 GMT 1 jan. 1970.

Retorna

Um inteiro.
Descrio

Mtodo; define a data do objeto Date especificado, em milissegundos, desde a meia-noite de 1

de janeiro de 1970, e retorna a nova hora em milissegundos.

Date.setUTCDate
Disponibilidade

Flash Player 5.
Uso

myDate.setUTCDate(data)
Parmetros

data

Um inteiro de 1 a 31.

Retorna

Um inteiro.

Dicionrio ActionScript 128

Descrio

Mtodo; define a data do objeto Date especificado, de acordo com a hora universal, e retorna a
nova hora em milissegundos. Quando este mtodo chamado, os outros campos do objeto Date
especificado no so modificados, mas, se o dia da semana for alterado em decorrncia do
chamamento a esse mtodo, os mtodos getUTCDay e getDay podem reportar um novo valor.

Date.setUTCFullYear
Disponibilidade

Flash Player 5.
Uso

myDate.setUTCFullYear(ano [, ms [, data]])
Parmetros

ano

O ano especificado com quatro dgitos completos; por exemplo, 2000.

ms

Um inteiro entre 0 (janeiro) e 11 (dezembro). Este parmetro opcional.

data

Um inteiro de 1 a 31. Este parmetro opcional.

Retorna

Um inteiro.
Descrio

Mtodo; define o ano do objeto Date especificado (mydate), de acordo com a hora universal, e
retorna a nova hora em milissegundos.
Opcionalmente, este mtodo tambm pode definir o ms e a data representados pelo objeto Date
especificado. Nenhum outro campo do objeto Date modificado. A chamada de
setUTCFullyear pode fazer com que getUTCDay e getDay reportem um novo valor se o dia da
semana for alterado como resultado dessa operao.

Date.setUTCHours
Disponibilidade

Flash Player 5.
Uso

myDate.setUTCHours(hora [, minutos [, segundos [, milissegundos]]])

Parmetros

hora

Um inteiro entre 0 (meia-noite) e 23 (11 p.m.).

minutos

Um inteiro de 0 a 59. Este parmetro opcional.

segundos

Um inteiro de 0 a 59. Este parmetro opcional.

milissegundos

Um inteiro de 0 a 999. Este parmetro opcional.

Retorna

Um inteiro.
Descrio

Mtodo; define a hora do objeto Date especificado, de acordo com a hora universal, e retorna a
nova hora em milissegundos.

129

Date.setUTCMilliseconds
Disponibilidade

Flash Player 5.
Uso

myDate.setUTCMilliseconds(milissegundos)
Parmetros

milissegundos

Um inteiro de 0 a 999.

Retorna

Um inteiro.
Descrio

Mtodo; define os milissegundos do objeto Date especificado, de acordo com a hora universal, e
retorna a nova hora em milissegundos.

Date.setUTCMinutes
Disponibilidade

Flash Player 5.
Uso

myDate.setUTCMinutes(minutos [, segundos [, milissegundos]])

Parmetros

minutos

Um inteiro de 0 a 59.

segundos

Um inteiro de 0 a 59. Este parmetro opcional.

milissegundos

Um inteiro de 0 a 999. Este parmetro opcional.

Retorna

Um inteiro.
Descrio

Mtodo; define os minutos do objeto Date especificado, de acordo com a hora universal, e retorna
a nova hora em milissegundos.

Date.setUTCMonth
Disponibilidade

Flash Player 5.
Uso

myDate.setUTCMonth(ms [, data])
Parmetros

ms
data

Um inteiro entre 0 (janeiro) e 11 (dezembro).

Um inteiro de 1 a 31. Este parmetro opcional.

Retorna

Um inteiro.

Dicionrio ActionScript 130

Descrio

Mtodo; define o ms e, opcionalmente, o dia (data), do objeto Date especificado, de acordo com
a hora universal, e retorna a nova hora em milissegundos. Quando este mtodo chamado, os
outros campos do objeto Date especificado no so modificados, mas, se o dia da semana for
alterado em decorrncia do resultado da especificao do parmetro data quando for
setUTCMonth for chamado, os mtodos getUTCDay e getDay podem reportar um novo valor.

Date.setUTCSeconds
Disponibilidade

Flash Player 5.
Uso

myDate.setUTCSeconds(segundos [, milissegundos]))
Parmetros

segundos

Um inteiro de 0 a 59.

milissegundos

Um inteiro de 0 a 999. Este parmetro opcional.

Retorna

Um inteiro.
Descrio

Mtodo; define os segundos do objeto Date especificado, de acordo com a hora universal, e
retorna a nova hora em milissegundos.

Date.setYear
Disponibilidade

Flash Player 5.
Uso

myDate.setYear(ano)
Parmetros

ano Se ano for um nmero inteiro entre 099, setYear definir o ano como 1900 + ano; caso
contrrio, o ano ser o valor do parmetro ano.
Retorna

Um inteiro.
Descrio

Mtodo; define o ano do objeto Date especificado, de acordo com a hora local, e retorna a nova
hora em milissegundos. A hora local determinada pelo sistema operacional em que o Flash
Player est sendo executado.

131

Date.toString
Disponibilidade

Flash Player 5.
Uso

myDate.toString()
Parmetros

Nenhum.
Retorna

Uma seqncia de caracteres.

Descrio

Mtodo; retorna, em um formato legvel, o valor de uma seqncia de caracteres do objeto Date
especificado, e retorna a nova hora em milissegundos.
Exemplo

O exemplo a seguir retorna as informaes no objeto Date dateOfBirth como uma seqncia de
caracteres.
var dateOfBirth = newDate(74, 7, 7, 18, 15);
trace (dataNascimento.toString());

Sada (para Hora padro do Pacfico):

Qua Ago 7 18:15:00 GMT-0700 1974

Date.UTC
Disponibilidade

Flash Player 5.
Uso

Date.UTC(ano, ms [, data [, hora [, minutos [, segundos [, milissegundos

]]]]]);
Parmetros

ano

Um nmero de quatro dgitos; por exemplo, 2000.

ms

Um inteiro entre 0 (janeiro) e 11 (dezembro).

data

Um inteiro de 1 a 31. Este parmetro opcional.

hora

Um inteiro entre 0 (meia-noite) e 23 (11 p.m.).

minutos

Um inteiro de 0 a 59. Este parmetro opcional.

segundos

Um inteiro de 0 a 59. Este parmetro opcional.

milissegundos

Um inteiro de 0 a 999. Este parmetro opcional.

Retorna

Um inteiro.

Dicionrio ActionScript 132

Descrio

Mtodo; retorna o nmero de milissegundos entre a meia-noite de 1 de janeiro de 1970, hora

universal, e a hora especificada nos parmetros. Este um mtodo esttico chamado pelo
construtor do objeto Date, no por um objeto Date especfico. Este mtodo permite criar um
objeto Date que assuma uma hora universal, enquanto o construtor de Date assume a hora local.
Exemplo

O exemplo a seguir cria um objeto new Date gary_birthday, definido na hora universal. Esta a
variao de hora universal do exemplo usado para o mtodo construtor new Date:
gary_birthday = new Date(Date.UTC(1974, 7, 8));

default
Disponibilidade

Flash Player 6.
Uso

default: comandos
Parmetros

comandos

Qualquer comando.

Retorna

Nada.
Descrio

Palavra-chave; define o case padro de uma ao switch. Os comandos sero executados se o

parmetroExpresso da ao switch for diferente (usando a igualdade estrita) de algum dos
parmetros Expresso subseqentes s palavras-chaves de case de uma determinada ao
switch.
Para ter um case default, no necessria uma ao switch. Um case default no precisa ser o
ltimo da lista. O uso de uma ao default fora de uma ao switch representa um erro e o
script no pode ser compilado.
Exemplo

No exemplo a seguir, a expresso A diferente das expresses B ou D, portanto o comando que

segue a palavra-chave padro executado e a ao trace enviada para a janela Sada.
switch ( A ) {
case B:
C;
break;
case D:
E;
break;
default:
trace (nenhum caso especfico foi encontrado);
}
Consulte tambm

switch, case, break

133

delete
Disponibilidade

Flash Player 5.
Uso

delete referncia
Parmetros

referncia

O nome da varivel ou do objeto a ser eliminado.

Retorna

Nada.
Descrio

Operador; elimina o objeto ou a varivel especificada pelo parmetro referncia e retorna true
se o objeto for excludo com xito; do contrrio, retorna false. Este operador til para liberar
memria usada pelos scripts. Embora delete seja um operador, normalmente ele usado como
um comando, como no exemplo a seguir:
delete x;

O operador delete pode falhar e retornar false se o parmetro de referncia no existir ou

no puder ser excludo. Objetos e propriedades predefinidos e variveis declaradas com var no
podem ser excludas. No possvel usar o operador delete para remover clipes de filme.
Exemplo

O exemplo a seguir cria um objeto, usa-o e o exclui quando no for mais necessrio.
account = new Object();
account.name = 'Jon';
account.balance = 10000;
delete account;
Exemplo

O exemplo a seguir exclui uma propriedade de um objeto.

// cria um novo objeto "account"
account = new Object();
// atribui nome de propriedade a account
account.name = 'Jon';
// exclui a propriedade
delete account.name;
Exemplo

O exemplo a seguir outro exemplo de excluso da propriedade de um objeto.

// cria um objeto Array com tamanho 0
array = new Array();
// Array.length agora 1
array[0] = "abc";
// adiciona outro elemento matriz, Array.length agora 2
array[1] = "def";
// adiciona outro elemento matriz, Array.length agora 3
array[2] = "ghi";
// array[2] excluda, mas Array.length no alterada,
delete array[2];

Dicionrio ActionScript 134

O exemplo a seguir ilustra o comportamento de delete em referncias de objetos.

// cria um novo objeto e atribui a varivel ref1
// para fazer referncia ao objeto
ref1 = new Object();
ref1.name = "Jody";
// copia a varivel de referncia para uma nova varivel
// e exclui ref1
ref2 = ref1;
delete ref1;

Se ref1 no tivesse sido copiada para ref2, o objeto teria sido excludo durante a excluso de
ref1, pois no haveria referncias. Se ref2 for excludo, no haver mais referncias ao objeto; ele
ser eliminado e a memria que estava sendo usada ficar disponvel.
Consulte tambm

var

do while
Disponibilidade

Flash Player 4.
Uso

do {
comando(s)
} while (condio)
Parmetros

condio

A condio a ser avaliada.

comando(s) O(s) comando(s) a ser(em) executado(s) desde que o parmetro condio seja
avaliado como true.
Retorna

Nada.
Descrio

Ao; executa os comandos e, a seguir, avalia a condio em um loop, pelo tempo em que a
condio for true.
Consulte tambm

break, continue

duplicateMovieClip
Disponibilidade

Flash Player 4.
Uso

duplicateMovieClip(destino, novonome, profundidade)

Parmetros

destino
novonome

135

O caminho de destino do clipe de filme a ser duplicado.

Um identificador exclusivo do clipe de filme duplicado.

Um nvel de profundidade exclusivo para o clipe de filme duplicado. O nvel de

profundidade uma ordem de empilhamento para os clipes de filmes duplicados. Essa ordem de
empilhamento muito parecida com a ordem de empilhamento das camadas na Linha de tempo;
os clipes de filmes com um nvel de profundidade inferior ficam ocultos abaixo de clipes com uma
ordem de empilhamento superior. Voc deve atribuir a cada clipe de filme duplicado um nvel de
profundidade exclusivo para evitar que ele substitua filmes em nveis ocupados.

profundidade

Retorna

Nada.
Descrio

Ao; cria uma instncia de um clipe de filme enquanto o filme reproduzido. A reproduo em
clipes de filme duplicados sempre comea pelo Quadro 1, independente da posio da reproduo
no clipe de filme original (ou pai). As variveis no clipe de filme pai no so copiadas para o
clipe de filme duplicado. Se o clipe de filme pai for excludo, o clipe de filme duplicado tambm o
ser. Use a ao ou mtodo removeMovieClip para excluir uma instncia de clipe de filme criada
com duplicateMovieClip.
Exemplo

Este comando duplica a instncia do clipe de filme flower dez vezes. A varivel i usada para
criar um novo nome de instncia e uma profundidade exclusiva para cada clipe de filme
duplicado.
on (release) {
amount = 10;
while (valor>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++;
valor--;
}
}
Consulte tambm

MovieClip.duplicateMovieClip, removeMovieClip, MovieClip.removeMovieClip

else
Disponibilidade

Flash Player 4.
Uso

Comando else
else {...comando(s)...}
Parmetros

condio

Uma expresso que seja avaliada como true ou false.

comando(s)
comando if

Uma srie alternativa de comandos a ser executada se a condio especificada no

for false.

Dicionrio ActionScript 136

Retorna

Nada.
Descrio

Ao; especifica os comandos a serem executados se a condio no comando if for false.

Consulte tambm

if

else if
Disponibilidade

Flash Player 4.
Uso

if (condio){
comando(s);
} else if (condio){
comando(s);
}
Parmetros

condio

Uma expresso que seja avaliada como true ou false.

comando(s)
comando if

Uma srie alternativa de comandos a ser executada se a condio especificada no

for false.

Retorna

Nada.
Descrio

Ao; avalia uma condio e especifica os comandos a serem executados se a condio no

comando if inicial for false. Se a condio else if for true, o interpretador Flash executar os
comandos entre chaves ({}) que seguem a condio. Se a condio else if for false, o Flash
no considerar os comandos entre chaves e executar os comandos aps as chaves. Use a ao
else if para criar uma lgica ramificada em seus scripts.
Exemplo

O exemplo seguinte faz uso de aes else if para verificar se cada lado de um objeto est dentro
de um limite especfico.
// se o objeto ultrapassar os limites,
// mande-o de volta e inverta a velocidade de percurso
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;
}
Consulte tambm

if

137

#endinitclip
Disponibilidade

Flash Player 6.
Uso

#endinitclip
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Ao; indica o trmino de um bloco de aes de inicializao de componentes.

Exemplo

#initclip
...aes de inicializao de componentes entram aqui...
#endinitclip
Consulte tambm

#initclip

eq (igual especfico de seqncia de caracteres)

Disponibilidade

Flash Player 4. Esse operador foi substitudo no Flash 5 pelo operador == (igualdade).
Uso

expresso1 eq expresso2
Parmetros

expression1,expression2

Nmeros, seqncias de caracteres ou variveis.

Retorna

Nada.
Descrio

Operador de comparao; avalia se duas expresses so iguais e retorna o valor true se a

representao da seqncia de caracteres da expresso1 for igual representao da seqncia de
caracteres da expresso2; caso contrrio, a operao retorna o valor false.
Consulte tambm

== (igualdade)

Dicionrio ActionScript 138

escape
Disponibilidade

Flash Player 5.
Uso

escape(expresso)
Parmetros

expresso

A expresso a ser convertida em seqncia de caracteres e codificada em formato de

URL.
Retorna

Nada.
Descrio

Funo; converte o parmetro em uma seqncia de caracteres e o codifica em formato de URL,

onde todos os caracteres que no so alfanumricos so substitudos por seqncias hexadecimais
de %.
Exemplo

A execuo do cdigo a seguir apresenta o resultado Oi%7B%5BMundo%5D%7D.

escape("Oi{[Mundo]}");
Consulte tambm

unescape

eval
Disponibilidade

Flash Player 5 ou posterior com funcionalidade completa. Voc pode usar a funo eval ao
exportar para o Flash Player 4, mas deve usar a notao de barra e s pode acessar variveis, mas
no propriedades ou objetos.
Uso

eval(expresso);
Parmetros

expresso Uma seqncia de caracteres que contm o nome de uma varivel, propriedade,
objeto ou clipe de filme a ser recuperado.
Retorna

Nada.
Descrio

Funo; acessa variveis, propriedades, objetos ou clipes de filmes por nome. Se expresso for
uma varivel ou propriedade, ser retornado o valor da varivel ou propriedade. Se expresso for
um objeto ou clipe de filme, ser retornada uma referncia ao objeto ou clipe de filme. Se no for
possvel encontrar o elemento citado na expresso, ser retornado o valor undefined.
No Flash 4, a funo eval era usada para simular matrizes, ao passo que no Flash 5, recomenda-se
o uso do objeto Array para esse fim.

139

Tambm possvel usar a funo eval para definir e recuperar de forma dinmica o valor de uma
varivel ou um nome de instncia. Porm, tambm possvel fazer isso atravs do operador de
acesso a matrizes ([]).
Observao: A ao eval do ActionScript no a mesma que a funo eval do JavaScript e no pode ser usada
para avaliar comandos.

Exemplo

O exemplo a seguir faz uso da funo eval para determinar o valor da expresso "piece" + x.
Como o resultado um nome de varivel, piece3, a funo eval retorna o valor da varivel e o
atribui a y:
piece3 = "perigoso";
x = 3;
y = eval("piece" + x);
trace(y);
// Sada: perigoso
Consulte tambm

Array (objeto)

evaluate
Disponibilidade

Flash Player 5.
Uso

comando
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Ao; cria uma nova linha vazia e insere um ponto-e-vrgula (;) para a criao de comandos a
serem avaliados no painel Aes.

false
Disponibilidade

Flash Player 5.
Uso

true
Descrio

Um valor Booleano exclusivo que representa o oposto de true.

Consulte tambm

true

Dicionrio ActionScript 140

FCheckBox (componente)
O componente CheckBox no ambiente de criao Flash oferece o recurso de arrastar e soltar para
adicionar as caixas de seleo a documentos Flash; ele tambm oferece uma interface de usurio
para a definio de parmetros bsicos. Os mtodos do componente FCheckBox permitem
controlar as caixas de seleo durante a execuo: voc pode criar caixas de seleo, controlar as
caixas de seleo criadas no ambiente de criao, definir ou cancelar parmetros bsicos e definir
opes adicionais de tempo de execuo. No preciso usar um construtor para acessar os
mtodos de componentes.
O componente CheckBox tem suporte do Flash Player 6.
Os mtodos do componente no realizam verificao de erros de tipo, como outros objetos e
aes nativos do ActionScript; portanto, recomenda-se a validao dos parmetros antes de passlos para mtodos.
Para obter informaes sobre o uso do componente CheckBox, como definir parmetros durante
o processo de criao e como alterar as cores e a aparncia de componentes, consulte
Personalizando cores e texto do componente e Personalizando aparncias de componentes no
captulo Usando componentesde Usando o Flash.
Resumo dos mtodos do componente FCheckBox

141

Mtodo

Descrio

FCheckBox.getEnabled

Retorna true se a caixa de seleo estiver ativada, false se estiver

desativada.

FCheckBox.getLabel

Retorna o rtulo aplicado caixa de seleo como uma seqncia de

caracteres.

FCheckBox.getValue

Retorna true se a caixa de seleo estiver selecionada, false se no

estiver selecionada.

FCheckBox.registerSkinElement

Registra um elemento de aparncia em uma propriedade.

FCheckBox.setChangeHandler

Especifica um identificador de alterao a ser chamado quando o valor

da caixa de seleo alterado.

FCheckBox.setEnabled

Determina se a caixa de seleo est ativada ou desativada.

FCheckBox.setLabel

Especifica texto para o rtulo da caixa de seleo.

FCheckBox.setLabelPlacement

Especifica se o rtulo exibido esquerda ou direita da caixa de

seleo.

FCheckBox.setSize

Define a largura da caixa de seleo, em pixels, e redesenha a caixa.

FCheckBox.setStyleProperty

Define uma nica propriedade de estilo para um componente.

FCheckBox.setValue

Marca ou desmarca a caixa de seleo e inicia a funo do identificador

de alterao.

FCheckBox.getEnabled
Disponibilidade

Flash Player 6.
Uso

myCheckBox.getEnabled()
Parmetros

Nenhum.
Retorna

Um valor Booleano que indica se a instncia da caixa de seleo est ativada (true) ou desativada
(false).
Descrio

Mtodo; indica se a instncia da caixa de seleo est ativada ou desativada.

Exemplo

O cdigo a seguir retorna o estado ativado de checkBox1 na janela Sada.

trace(checkBox1.getEnabled());
Consulte tambm

FCheckBox.setValue

FCheckBox.getLabel
Disponibilidade

Flash Player 6.
Uso

myCheckBox.getEnabled()
Parmetros

Nenhum.
Retorna

Uma seqncia de caracteres de texto.

Descrio

Mtodo; recupera o rtulo da caixa de seleo.

Exemplo

O cdigo a seguir retorna o rtulo de checkBox1.

checkBox1.getLabel();
Consulte tambm

FCheckBox.setLabel

Dicionrio ActionScript 142

FCheckBox.getValue
Disponibilidade

Flash Player 6.
Uso

myCheckBox.getValue()
Parmetros

Nenhum.
Retorna

Um valor Booleano que indica se a instncia da caixa de seleo est ativada (true) ou desativada
(false).
Descrio

Mtodo; indica se a caixa de seleo est selecionada.

Exemplo

O cdigo a seguir retorna o valor selecionado de KowalczykBox na janela Sada.

trace(KowalczykBox.getValue());
Consulte tambm

FCheckBox.setValue

FCheckBox.registerSkinElement
Disponibilidade

Flash Player 6.
Uso

myCheckBox.registerSkinElement(element, styleProperty)
Parmetros

element

Uma instncia de clipe de filme.

styleProperty

O nome de uma propriedade de FStyleFormat.

Retorna

Nada.
Descrio

Mtodo; registra um elemento de aparncia em uma propriedade de estilo. Elementos de

aparncia so registrados em propriedades no primeiro quadro da camada ReadMe de cada
aparncia na biblioteca.
Os componentes so compostos de aparncias e cada aparncia composta de vrios elementos de
aparncia, cada um dos quais pode ser registrado em uma propriedade do objeto FStyleFormat.
Essas propriedades so valores atribudos pelo formato de estilo atribudo a um componente.
Como padro, o objeto globalStyleFormat atribudo a todos os componentes de interface do
Flash. Esse objeto uma instncia do objeto FStyleFormat.

143

Use este mtodo para registrar propriedades e elementos de aparncia personalizados na interface
do Flash ou aparncias personalizadas de componentes editando o cdigo no primeiro quadro da
camada ReadMe de uma aparncia na biblioteca.
O componente FCheckBox usa as aparncias na pasta FCheckBox Skins depois que o
componente for adicionado ao documento Flash.
Para obter mais informaes, consulte Personalizando aparncias de componentes no captulo
Usando componentesde Usando o Flash.
Exemplo

O cdigo a seguir registra o elemento de aparncia personalizado customChk_mc na propriedade

check no primeiro quadro da camada ReadMe da aparncia fcb_check na pasta FCheckBox Skins
na biblioteca.
check1.registerSkinElement(customChk_mc, "check");

FCheckBox.setChangeHandler
Disponibilidade

Flash Player 6.
Uso

myCheckBox.setChangeHandler(functionName, [location])
Parmetros

Uma seqncia de caracteres que especifica o nome da funo do identificador a

ser executada quando o valor da caixa de seleo alterado. Se o parmetro location no for
especificado, esta funo dever estar na mesma Linha de tempo da instncia do componente.

functionName

Uma referncia de caminho at um objeto de dados, clipe de filme ou Linha de

tempo que contm a funo especificada. Este parmetro opcional e tem como padro a Linha
de tempo pai do componente.

location

Retorna

Nada.
Descrio

Mtodo; especifica um identificador de alterao a ser chamado quando o valor da caixa de

seleo alterado. Voc pode especificar a mesma funo de identificador de alterao para mais
de um componente; a funo sempre aceita a instncia do componente que foi alterada como um
parmetro. Se este mtodo for chamado, valor do parmetro Identificador de alterao
especificado na criao ser cancelado.
Para obter mais informaes, consulte Criando funes do identificador de alterao para
componentes no captulo Usando componentes de Usando o Flash.
Exemplo

O cdigo a seguir especifica myHandler como a funo chamada quando o valor de checkBox1
alterado. Como o parmetro location no foi especificado, myHandler dever estar na mesma
Linha de tempo da instncia do componente.

Dicionrio ActionScript 144

O parmetro component em myHandler automaticamente preenchido com a instncia de um

componente (o componente que foi alterado como resultado de uma entrada do usurio e que
especifica myHandler como seu identificador de alterao). As aes definidas em myHandler
especificam que quando o usurio marca uma caixa de seleo, o nome do componente exibido
na janela Sada juntamente com foi selecionado.
checkBox1.setChangeHandler("myHandler");
function myHandler(component){
trace(component._name + " foi selecionado ");
}

Se, no exemplo acima, myHandler fosse uma funo localizada na Linha de tempo bisav da
Linha de tempo do componente, a primeira linha de cdigo seria da seguinte forma:
check1.setChangeHandler("myHandler", _parent._parent._parent);

O cdigo a seguir cria a funo myHandler em uma instncia de myObject (que da classe
Object) e, a seguir, especifica myHandler como a funo de check1.
myObject = new Object();
myObject.myHandler = function(component){
trace(component._name + " foi selecionado ");
}
check1.setChangeHandler("myHandler", myObject);

FCheckBox.setEnabled
Disponibilidade

Flash Player 6.
Uso

myCheckBox.setEnabled(enable)
Parmetros

enable
(false).

Um valor Booleano que especifica se a caixa de seleo est ativada (true) ou desativada

Retorna

Nada.
Descrio

Mtodo; especifica se a caixa de seleo est ativada (true) ou desativada (false). Se uma caixa de
seleo estiver desativada, ela no aceitar a interao do mouse nem do teclado do usurio. Se
esse parmetro for omitido, o mtodo utilizar o padro true.
Exemplo

O cdigo a seguir desativa checkBox1.

checkBox1.setEnabled(false);

145

FCheckBox.setLabel
Disponibilidade

Flash Player 6.
Uso

myCheckBox.setLabel(label)
Parmetros

label

Uma seqncia de caracteres que especifica o rtulo de texto da caixa de seleo.

Retorna

Nada.
Descrio

Mtodo; especifica o rtulo de texto da caixa de seleo. Como padro, o rtulo exibido direita
da caixa de seleo. Se este mtodo for chamado, o parmetro label especificado na criao ser
cancelado.
Exemplo

O cdigo a seguir aplica o rtulo Enviar mais informaes a checkBox1.

checkBox1.setLabel("Enviar mais informaes");
Consulte tambm

FCheckBox.getLabel, FCheckBox.setLabelPlacement

FCheckBox.setLabelPlacement
Disponibilidade

Flash Player 6.
Uso

myCheckBox.setLabelPlacement(labelPosition)
Parmetros

labelPosition

Uma seqncia de caracteres de texto; especifica "left" ou "right".

Retorna

Nada.
Descrio

Mtodo; especifica se o rtulo exibido esquerda ou direita da caixa de seleo. Se este mtodo
for chamado, o valor do parmetro Label Placement definido durante o processo de criao ser
cancelado.
Exemplo

O cdigo a seguir posiciona o rtulo de checkBox1 esquerda da caixa de seleo.

checkBox1.setLabelPlacement("left");
Consulte tambm

FCheckBox.setLabel

Dicionrio ActionScript 146

FCheckBox.setSize
Disponibilidade

Flash Player 6.
Uso

myCheckBox.setSize(width)
Parmetros

width

Um nmero inteiro que especifica a largura da caixa de seleo, em pixels.

Retorna

Nada.
Descrio

Mtodo; especifica a largura da caixa de seleo e redesenha a caixa. No possvel definir a altura
dos componentes da caixa de seleo. Se este mtodo for chamado, o dimensionamento de largura
aplicado durante o processo de criao ser cancelado.
Para obter mais informaes, consulte Dimensionando componentes CheckBox no captulo
Usando componentesde Usando o Flash.
Exemplo

O cdigo a seguir define a largura da checkBox1 como sendo 200 pixels.

checkBox1.setSize(200);

FCheckBox.setStyleProperty
Disponibilidade

Flash Player 6.
Uso

myCheckBox.setStyleProperty(styleProperty, value)
Parmetros

styleProperty

Uma seqncia de caracteres que especifica uma propriedade do objeto

FStyleFormat.
value

O valor definido para a propriedade.

Retorna

Nada.
Descrio

Mtodo; define uma propriedade FStyleFormat para uma determinada caixa de seleo. Chamar
este mtodo para especificar uma propriedade cancela as configuraes dessa propriedade no
formato de estilo atribudo ao componente. Se o valor undefined for atribudo a uma
propriedade, todos os estilos dessa propriedade sero removidos.
Para definir as propriedades FStyleFormat para vrios componentes, crie um formato de estilo
personalizado. Para obter mais informaes sobre a criao de formatos de estilo personalizados,
consulte Personalizando cores e texto do componente no captulo Usando componentes de
Usando o Flash.

147

Exemplo

O cdigo a seguir define a propriedade shadow de checkBox1 como sendo 0x000000 (preto).
checkBox1.setStyleProperty("shadow", 0x000000);
Consulte tambm

FStyleFormat (object)

FCheckBox.setValue
Disponibilidade

Flash Player 6.
Uso

myCheckBox.setValue(select)
Parmetros

select
(false).

Um valor Booleano que especifica se a caixa de seleo est marcada (true) ou no

Retorna

Nada.
Descrio

Mtodo; marca ou desmarca myCheckBox e inicia a funo do identificador de alterao

especificada (caso haja alguma) durante a execuo. O valor padro true.
Embora o fato de chamar este mtodo cancele o valor do parmetro Initial Value especificado na
criao, no use o mtodo com este objetivo, pois ele tambm inicia a funo do identificador de
alterao associada. Para definir o parmetro Initial Value de uma caixa de seleo durante a
execuo, use FCheckBox.setStyleProperty.
Exemplo

O cdigo a seguir seleciona a instncia de checkBox1 e inicia a funo do identificador de

alterao que estiver especificada.
checkBox1.setValue(true);
Consulte tambm

FCheckBox.getValue

FComboBox (component)
O componente ComboBox no ambiente de criao Flash oferece o recurso de arrastar e soltar
para adicionar listas suspensas de seleo simples a documentos do Flash; ele tambm oferece uma
interface de usurio para a definio de parmetros bsicos. Os mtodos do componente
FComboBox permitem controlar as caixas de combinao durante a execuo: voc pode criar
caixas de combinao, controlar as caixas de combinao criadas no ambiente de criao, definir
ou cancelar os parmetros bsicos e definir as opes adicionais de tempo de execuo. No
preciso usar um construtor para acessar os mtodos de componentes.

Dicionrio ActionScript 148

O componente ComboBox cria caixas de combinao estticas e editveis. A caixa de combinao

esttica uma lista suspensa rolvel que permite aos usurios selecionar itens. Uma caixa de
combinao editvel uma lista suspensa rolvel com um campo de texto na parte superior. Voc
pode permitir que os usurios insiram texto no campo de texto para fazer a caixa de combinao
rolar at o item desejado ou pode usar o campo de texto para definir o texto exibido durante a
execuo.
Tanto a verso esttica quanto a editvel do componente ComboBox relaciona itens de cima para
baixo usando um sistema de indexao baseado no zero. Se o nmero de itens na lista da caixa de
combinao criar uma lista suspensa que ultrapasse o espao disponvel abaixo do componente, a
lista se abrir para cima e no para baixo.
Os mtodos do componente no realizam verificao de erros de tipo, como outros objetos e
aes nativos do ActionScript; portanto, recomenda-se a validao dos parmetros antes de passlos para mtodos.
O componente ComboBox tem suporte do Flash Player 6 e de suas verses posteriores.
Para obter informaes sobre o uso do componente ComboBox, como definir parmetros durante
o processo de criao e como alterar as cores e a aparncia de componentes, consulte
Personalizando cores e texto do componente e Personalizando aparncias de componentes no
captulo Usando componentesde Usando o Flash.
Resumo dos mtodos do componente FComboBox

149

Mtodo

Descrio

FComboBox.addItem

Adiciona um novo item ao final da lista da caixa de combinao.

FComboBox.addItemAt

Adiciona um novo lista da caixa de combinao no ndice

especificado.

FComboBox.getEnabled

Retorna true se a caixa de combinao estiver ativada, false se

estiver desativada.

FComboBox.getItemAt

Retorna o item no ndice especificado como um objeto com as

propriedades label e data.

FComboBox.getLength

Retorna o nmero de itens relacionados na caixa de combinao.

FComboBox.getRowCount

Retorna o nmero de linhas visveis na caixa de combinao.

FComboBox.getScrollPosition

Retorna o ndice do item na parte superior da caixa de combinao.

FComboBox.getSelectedIndex

Retorna o ndice do item atualmente selecionado.

FComboBox.getSelectedItem

Retorna o item atualmente selecionado como um objeto com as

propriedades label e data.

FComboBox.getValue

Retorna o texto no campo de entrada no caso de caixas de

combinao editveis; retorna o rtulo ou os dados do item
selecionado no caso de caixas de combinao estticas.

FComboBox.registerSkinElement

Registra um elemento de aparncia em uma propriedade.

FComboBox.removeAll

Remove todos os itens da caixa de combinao.

FComboBox.removeItemAt

Remove o item no ndice especificado.

FComboBox.replaceItemAt

Substitui o rtulo e os dados de um item no ndice especificado.

FComboBox.setChangeHandler

Atribui uma funo a ser chamada todas as vezes que um item

selecionado ou que o usurio insere texto no campo de texto.

Mtodo

Descrio

FComboBox.setDataProvider

Registra um objeto externo no componente como uma fonte de

dados.

FComboBox.setEditable

Determina se a caixa de combinao editvel (true) ou esttica

(false).

FComboBox.setEnabled

Especifica se a caixa de combinao est ativada (true) ou

desativada (false).

FComboBox.setItemSymbol

Registra o identificador de vinculao de um smbolo a ser usado para

exibir itens de listagem de uma caixa de combinao.

FComboBox.setRowCount

Determina o nmero de itens exibidos na caixa de combinao sem

uma barra de rolagem.

FComboBox.setSelectedIndex

Seleciona o item no ndice especificado.

FComboBox.setSize

Define a largura em pixels da caixa de combinao.

FComboBox.setStyleProperty

Define uma nica propriedade de estilo para a instncia de um

componente.

FComboBox.setValue

Especifica o texto exibido no campo de texto na parte superior da

caixa de combinao editvel.

FComboBox.sortItemsBy

Classifica os itens na caixa de listagem em ordem alfabtica ou

numrica por rtulo ou por dados.

FComboBox.addItem
Disponibilidade

Flash Player 6.
Uso

myComboBox.addItem(label [,data])
Parmetros

label
data

Uma seqncia de caracteres de texto a ser exibida na listagem da caixa de combinao.

O valor a ser associado ao item da listagem. Este parmetro opcional.

Retorna

Nada.
Descrio

Mtodo; adiciona um novo item com o rtulo e os dados especificados ao final da listagem da
caixa de combinao e atualiza a listagem. O parmetro data pode ser qualquer objeto do Flash,
seqncia de caracteres, valor Booleano, nmero inteiro, objeto ou clipe de filme.
Para obter melhor desempenho e menor tempo de carregamento, no adicione mais de 400 itens
a cada quadro. Isso se aplica esteja voc adicionando os itens a uma nica listagem de caixa de
combinao ou a vrias.
Exemplo

O cdigo a seguir adiciona o item Kenny com o valor associado Keen ao final da listagem na caixa
de combinao teacherList.
teacherList.addItem("Kenny", Keen);

Dicionrio ActionScript 150

O cdigo a seguir adiciona o nmero mximo de itens recomendado em um nico quadro

(400 itens) comboBox1:
for (i=0; i<400; i++) {
comboBox1.addItem(i);
}

O cdigo a seguir adiciona o nmero mximo de itens recomendado em um nico quadro

(400 itens) a listBox1 e a comboBox2:
for (i=0; i<200; i++) {
listBox1.addItem(i);
comboBox2.addItem(i);
}
Consulte tambm

FComboBox.addItemAt, FComboBox.getItemAt, FComboBox.replaceItemAt,

FComboBox.setDataProvider, FComboBox.sortItemsBy

FComboBox.addItemAt
Disponibilidade

Flash Player 6.
Uso

myComboBox.addItemAt(index, label [,data])

Parmetros

Um nmero inteiro que especifica a posio onde inserir o item.

Uma seqncia de caracteres que identifica o item da listagem na caixa de combinao.
data O valor a ser associado ao item da listagem. Este parmetro opcional.
index
label

Retorna

Nada.
Descrio

Mtodo; adiciona um novo item com o rtulo especificado e os dados opcionais associados
listagem da caixa de combinao na posio de ndice especificada. O parmetro Data pode ser
qualquer objeto do Flash, seqncia de caracteres, valor Booleano, nmero inteiro, objeto ou clipe
de filme. medida que cada item adicionado, a listagem atualizada e a barra de rolagem
redimensionada.
O componente ComboBox usa um ndice com base no zero, onde o item no ndice 0 exibido no
topo da listagem.
Para obter melhor desempenho e menor tempo de carregamento, no adicione mais de 400 itens
a cada quadro. Isso se aplica esteja voc adicionando os itens a uma nica listagem de caixa de
combinao ou a vrias.
Exemplo

O cdigo a seguir adiciona o item Justin com o valor associado Ace como quinto item na
listagem da caixa de combinao Favorites.
Favorites.addItemAt(4, "Justin", Ace);

Para obter exemplos de como carregar um grande nmero de itens, consulte FComboBox.addItem.
Consulte tambm

FComboBox.getItemAt, FComboBox.removeItemAt, FComboBox.replaceItemAt,

FComboBox.setDataProvider, FComboBox.sortItemsBy

151

FComboBox.getEnabled
Disponibilidade

Flash Player 6.
Uso

myComboBox.getEnabled()
Parmetros

Nenhum.
Retorna

Um valor Booleano que indica se a caixa de combinao est ativada (true) ou desativada
(false).
Descrio

Mtodo; indica se a caixa de combinao est ativada.

Exemplo

O cdigo a seguir usa getEnabled para determinar se comboBox1 est ativada ou desativada e
exibe o resultado na janela Sada.
trace(comboBox1.getEnabled());
Consulte tambm

FComboBox.setEnabled

FComboBox.getItemAt
Disponibilidade

Flash Player 6.
Uso

myComboBox.getItemAt(index)
Parmetros

index

Um nmero inteiro que especifica a posio de um item na caixa de combinao.

Retorna

Um objeto.
Descrio

Mtodo; retorna o item no ndice especificado como um objeto com as propriedades label e data.
O componente ComboBox usa um ndice com base no zero, onde o item no ndice 0 exibido no
topo da listagem.
Exemplo

O cdigo apresentado a seguir retorna o rtulo do item no ndice 4 na comboBox1 como uma
seqncia de caracteres.
trace(comboBox1.getItemAt(4).label);

Dicionrio ActionScript 152

O cdigo a seguir retorna os dados associados ao item no ndice 4 na comboBox2. O valor de

retorno depende do tipo de dado e pode ser um objeto, seqncia de caracteres, referncia de clipe
de filme ou outro valor.
trace(comboBox2.getItemAt(4).data);

O cdigo a seguir retorna um objeto contendo o rtulo e o valor de dados associado ao item no
ndice 4 na comboBox3.
trace(comboBox3.getItemAt(4));
Consulte tambm

FComboBox.getSelectedItem

FComboBox.getLength
Disponibilidade

Flash Player 6.
Uso

myComboBox.getLength()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna o nmero de itens na listagem da caixa de combinao.

Exemplo

O cdigo a seguir recupera o nmero de itens na lista de listMain e armazena esse valor na
varivel len.
var len = listMain.getLength();
Consulte tambm

FComboBox.addItem, FComboBox.addItemAt

FComboBox.getRowCount
Disponibilidade

Flash Player 6.
Uso

myComboBox.getRowCount()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna o nmero de linhas visveis na caixa de combinao.

153

Exemplo

O cdigo a seguir retorna o nmero de linhas visveis em toyList e define o valor para a varivel
rowCount.
var rowCount = toyList.getRowCount();
Consulte tambm

FComboBox.setRowCount

FComboBox.getScrollPosition
Disponibilidade

Flash Player 6.
Uso

myComboBox.getScrollPosition()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna o ndice do item exibido no momento na parte superior da caixa de combinao.
O componente ComboBox usa um ndice com base no zero, onde o item no ndice 0 exibido no
topo da listagem.
Exemplo

O cdigo a seguir recupera o ndice do item que, no momento, est na parte superior da lista em
toyList e armazena esse valor na varivel scrollPos.
var scrollPos = toyList.getScrollPosition();
Consulte tambm

FComboBox.setSelectedIndex

FComboBox.getSelectedIndex
Disponibilidade

Flash Player 6.
Uso

myComboBox.getSelectedIndex()
Parmetros

Nenhum.
Retorna

Um nmero inteiro ou undefined.

Descrio

Mtodo; retorna o ndice do item selecionado no momento na caixa de combinao, ou retorna

undefined, se no houver um item selecionado.
Os itens so apresentados na caixa de combinao da parte superior para a inferior usando um
ndice baseado no zero.

Dicionrio ActionScript 154

Exemplo

O cdigo a seguir recupera o ndice do item atualmente selecionado em toyList e armazena esse
valor na varivel selIndex.
var selIndex = toyList.getSelectedIndex();
Consulte tambm

FComboBox.setSelectedIndex

FComboBox.getSelectedItem
Disponibilidade

Flash Player 6.
Uso

myComboBox.getSelectedItem()
Parmetros

Nenhum.
Retorna

Um objeto ou undefined.
Descrio

Mtodo; retorna o item atualmente selecionado como um objeto com as propriedades label e
data, ou retorna undefined, se no houver um item selecionado.
Exemplo

O cdigo a seguir recupera o rtulo e os dados do item atualmente selecionados na comboBox1.

trace(comboBox1.getSelectedItem());

O cdigo a seguir recupera o rtulo do item atualmente selecionado na comboBox2.

trace(comboBox2.getSelectedItem().label);

O cdigo a seguir recupera os dados do item atualmente selecionado na comboBox3.

trace(comboBox3.getSelectedItem().data);
Consulte tambm

FComboBox.setSelectedIndex

FComboBox.getValue
Disponibilidade

Flash Player 6.
Uso

myComboBox.getValue()
Parmetros

Nenhum.
Retorna

Uma seqncia de caracteres de texto.

155

Descrio

Mtodo; retorna o texto do campo na parte superior da caixa de combinao, se a caixa de

combinao for editvel. Se a caixa de combinao for esttica (no editvel), este mtodo
retornar os dados associados ao item selecionado, ou o rtulo do item, se no houver dados
associados.
Exemplo

O cdigo a seguir retorna os dados ou o rtulo do item atualmente selecionado em menuMain.

trace(menuMain.getValue())
Consulte tambm

FComboBox.setValue

FComboBox.registerSkinElement
Disponibilidade

Flash Player 6.
Uso

myComboBox.registerSkinElement(element, styleProperty)
Parmetros

element

Uma instncia de clipe de filme.

styleProperty

O nome de uma propriedade de FStyleFormat.

Retorna

Nada.
Descrio

Mtodo; registra um elemento de aparncia em uma propriedade de estilo. Elementos de

aparncia so registrados em propriedades no primeiro quadro da camada ReadMe de cada
aparncia na biblioteca.
Os componentes so compostos de aparncias e cada aparncia composta de vrios elementos de
aparncia, cada um dos quais pode ser registrado em uma propriedade do objeto FStyleFormat.
Essas propriedades so valores atribudos pelo formato de estilo atribudo a um componente.
Como padro, o objeto globalStyleFormat atribudo a todos os componentes de interface do
Flash. Esse objeto uma instncia do objeto FStyleFormat.
Use este mtodo para registrar propriedades e elementos de aparncia personalizados na interface
do Flash ou aparncias personalizadas de componentes editando o cdigo no primeiro quadro da
camada ReadMe de uma aparncia na biblioteca.
O componente FComboBox usa as aparncias na pasta FComboBox Skins depois que o
componente for adicionado ao documento Flash.
Para obter mais informaes, consulte Personalizando aparncias de componentes no captulo
Usando componentesde Usando o Flash.
Exemplo

O cdigo a seguir registra o elemento de aparncia personalizado boundBox_mc na propriedade

background no primeiro quadro da camada ReadMe da aparncia FBoundingBox na pasta
Global Skins.
toysMenu.registerSkinElement(boundBox_mc, "background");

Dicionrio ActionScript 156

FComboBox.removeAll
Disponibilidade

Flash Player 6.
Uso

myComboBox.removeAll()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; remove todos os itens na listagem da caixa de combinao, atualiza a listagem e

redimensiona a barra de rolagem. As caixas de combinao sem itens so exibidas sem barra de
rolagem. Este mtodo no pode ser usado se a caixa de combinao estiver desativada.
Exemplo

O cdigo a seguir remove todos os itens de menuMain.

menuMain.removeAll();
Consulte tambm

FComboBox.removeItemAt

FComboBox.removeItemAt
Disponibilidade

Flash Player 6.
Uso

myComboBox.removeItemAt(index)
Parmetros

index

Um nmero inteiro que especifica o ndice do item a ser removido.

Retorna

Um objeto que contm o item removido.

Descrio

Mtodo; retorna o item removido no ndice especificado e atualiza a lista. Quando um item
removido da lista, os ndices dos itens subseqentes so atualizados para refletir suas novas
posies. Se no houver item algum no ndice especificado, este mtodo retornar undefined.
O componente ComboBox usa um ndice com base no zero, onde o item no ndice 0 exibido no
topo da listagem.
Exemplo

O cdigo a seguir remove o quinto item da lista em menuMain.

menuMain.removeItemAt(4);
Consulte tambm

FComboBox.removeAll

157

FComboBox.replaceItemAt
Disponibilidade

Flash Player 6.
Uso

myComboBox.replaceItemAt(index, label [,data])

Parmetros

index

Um nmero inteiro que especifica a posio de um item de listagem.

label

Uma seqncia de caracteres que especifica um novo rtulo para o item de listagem.

O novo valor a ser associado ao item de listagem. Este parmetro opcional; se voc no
especific-lo, qualquer dado atualmente especificado para o item permanece no lugar.

data

Retorna

Nada.
Descrio

Mtodo; atualiza o item no ndice especificado com o rtulo e os dados especificados. Se o item
no ndice especificado tiver um valor de dado associado e voc no especificar um valor para o
parmetro data, o valor dos dados do item de listagem no ser alterado.
O componente ComboBox usa um ndice com base no zero, onde o item no ndice 0 exibido no
topo da listagem.
Exemplo

O cdigo a seguir atualiza o quinto item na caixa de combinao Favorites com o rtulo Nigel
e o valor de dados 7439. Se nenhum dado tiver sido especificado para o item de listagem, Nigel
assume o valor de dados do item de listagem existente.
Favorites.replaceItemAt(4, "Nigel", "7439");
Consulte tambm

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

FComboBox.sortItemsBy

FComboBox.setChangeHandler
Disponibilidade

Flash Player 6.
Uso

myComboBox.setChangeHandler(functionName, [location])
Parmetros

Uma seqncia de caracteres que especifica o nome da funo do identificador a

ser executada quando a seleo na caixa de combinao alterada. Se o parmetro location no
for especificado, esta funo dever estar na mesma Linha de tempo da instncia do componente.
functionName

Uma referncia de caminho at um objeto de dados, clipe de filme ou Linha de

tempo que contm a funo especificada. Este parmetro opcional e tem como padro a Linha
de tempo pai do componente.

location

Dicionrio ActionScript 158

Retorna

Nada.
Descrio

Mtodo; especifica um identificador de alterao a ser chamado quando a seleo na caixa de

seleo alterada. Voc pode especificar a mesma funo de identificador de alterao para mais
de um componente; a funo sempre aceita a instncia do componente que foi alterada como um
parmetro. Se este mtodo for chamado, valor do parmetro Identificador de alterao
especificado na criao ser cancelado.
Para obter mais informaes, consulte Criando funes do identificador de alterao para
componentes no captulo Usando componentesde Usando o Flash.
Exemplo

O cdigo a seguir especifica myHandler como a funo chamada quando o valor de toyList
alterado. Como o parmetro location no foi especificado, myHandler dever estar na mesma
Linha de tempo da instncia do componente.
O parmetro component em myHandler automaticamente preenchido com a instncia de um
componente (o componente que foi alterado como resultado de uma entrada do usurio e que
especifica myHandler como seu identificador de alterao). As aes definidas em myHandler
especificam que o rtulo do item exibido na janela Sada quando o usurio seleciona um item na
listagem.
toyList.setChangeHandler("myHandler");
function myHandler(component){
trace(toyList.getSelectedItem().label);
}

Se, no exemplo acima, myHandler fosse uma funo localizada na Linha de tempo bisav da
Linha de tempo do componente, a primeira linha de cdigo seria da seguinte forma:
toyList.setChangeHandler("myHandler", _parent._parent._parent);

O cdigo a seguir cria a funo myHandler em uma instncia de myObject (que da classe
Object) e, a seguir, especifica myHandler como a funo de toyList.
myObject = new Object();
myObject.myHandler = function(component){
trace(toyList.getSelectedItem().label);
}
toyList.setChangeHandler("myHandler", myObject);

FComboBox.setDataProvider
Disponibilidade

Flash Player 6.
Uso

myComboBox.setDataProvider(dataProvider)
Parmetros

Uma matriz de seqncias de caracteres de texto que lista itens para adicionar,
uma instncia do objeto Array que especifica os itens a serem adicionados ou uma instncia da
classe DataProvider.

dataProvider

Retorna

Nada.

159

Descrio

Mtodo; registra um objeto externo (dataProvider) como a fonte de dados para o componente
da caixa de combinao. Se dataProvider for uma instncia do objeto Array, o objeto poder
especificar label, data ou ambos, pois as propriedades de objeto e o contedo da matriz podero
ser copiados para a caixa de combinao como rtulos, dados ou ambos. Se dataProvider for
uma instncia da classe DataProvider, ele dever implementar a API DataProvider definida no
smbolo DataProvider na pasta FlashUIComponents/Core Assets/ClassTree da biblioteca. A API
DataProvider somente para usurios e programadores avanados; todos os outros usurios
devem usar uma matriz ou um objeto Array.
Exemplo

O cdigo a seguir especifica o objeto Array peopleList1 como o provedor de dados para
comboBox1.
comboBox1.setDataProvider(peopleList1);

O cdigo a seguir cria a matriz peopleList para exibir os rtulos dos itens listados em
comboBox1.
peopleList = new Array();
peopleList[0] = "BHall";
peopleList[1] = "CMoock";
peopleList[2] = "MWobensmith";
peopleList[3] = "MShepherd";

O cdigo a seguir cria a matriz itemList1, que especifica tanto o rtulo quanto os dados para
itens de listagem. Esse objeto Array poderia ser usado como um provedor de dados alternativo
para comboBox1.
itemList1 = new Array();
for (i=0; i<10; i++) {
// criar um item real
var myItem = new Object();
myItem.label = "Item" + i;
myItem.data = 75;
// coloca-lo na matriz
itemList1[i] = myItem;
}

O cdigo a seguir especifica comboData, uma instncia da classe DataProvider, como o provedor
de dados de comboBox1.
comboBox1.setDataProvider(comboData);

O cdigo a seguir cria uma nova instncia da classe DataProvider e, a seguir, adiciona os rtulos
do item usando o mtodo addItem de DataProvider.
Observao: O mtodo addItem somente um mtodo da classe DataProvider. Os programadores interessados
em usar a classe DataProvider devem consultar o smbolo DataProvider na pasta FlashUIComponents/
CoreAssets/ClassTree na biblioteca antes de tentar usar os mtodos.

comboData = new DataProviderClass();

comboData.addItem("Devra");
comboData.addItem("Delia");
comboData.addItem("Vashti");
comboData.addItem("Alicia");
Consulte tambm

FComboBox.addItem, FComboBox.replaceItemAt, FComboBox.sortItemsBy

Dicionrio ActionScript 160

FComboBox.setEditable
Disponibilidade

Flash Player 6.
Uso

myComboBox.setEditable(editable)
Parmetros

editable Um valor
esttica (false).

Booleano que especifica se a caixa de combinao editvel (true) ou

Retorna

Nada.
Descrio

Mtodo; determina se a caixa de combinao editvel (true) ou esttica (false). Uma caixa de
combinao editvel tem um campo de texto; quando o usurio insere texto, a caixa de
combinao rola at o item com o mesmo texto. O campo de texto tambm pode ser utilizado
para exibir texto usando FComboBox.setValue. Se este mtodo for chamado, o valor do
parmetro Editable definido durante o processo de criao ser cancelado.
Exemplo

O cdigo a seguir ativa um campo de texto de entrada na parte superior de menuMain.

menuMain.setEditable(true);
Consulte tambm

FComboBox.setValue

FComboBox.setEnabled
Disponibilidade

Flash Player 6.
Uso

myComboBox.setEnabled(enable)
Parmetros

enable Um valor Booleano que especifica se a caixa de combinao est ativada (true) ou
desativada (false).
Retorna

Nada.
Descrio

Mtodo; determina se a caixa de combinao est ativada (true) ou desativada (false). Se uma
caixa de combinao estiver desativada, ela no aceitar interao de mouse nem de teclado do
usurio. Se esse parmetro for omitido, o mtodo utilizar o padro true.
Exemplo

O cdigo a seguir desativa menuMain.

menuMain.setEnabled(false);
Consulte tambm

FListBox.getEnabled

161

FComboBox.setItemSymbol
Disponibilidade

Flash Player 6.
Uso

myComboBox.setItemSymbol(symbolID)
Parmetros

O identificador de vinculao de smbolo para exibir o contedo da caixa de

combinao.

symbolID

Retorna

Nada.
Descrio

Mtodo; registra um smbolo grfico para exibir os itens de listagem da caixa de combinao. O
valor padro o smbolo FComboBoxItem na biblioteca. Este mtodo destinado a usurios e
programadores avanados.

FComboBox.setRowCount
Disponibilidade

Flash Player 6.
Uso

myComboBox.setRowCount(rows)
Parmetros

rows

O nmero mximo de linhas que a listagem suspensa pode exibir sem rolagem.

Retorna

Nada.
Descrio

Mtodo; define o nmero de itens que podem ser vistos na listagem suspensa da caixa de
combinao sem rolagem. O valor mnimo do parmetro rows 3. Se este mtodo for chamdo, o
valor do parmetro Row Count definido durante o processo de criao ser cancelado.
Exemplo

O cdigo a seguir define o nmero de itens exibidos na listagem suspensa de menuMain como 4.
menuMain.setRowCount(4);
Consulte tambm

FComboBox.setSize

Dicionrio ActionScript 162

FComboBox.setSelectedIndex
Disponibilidade

Flash Player 6.
Uso

myComboBox.setSelectedIndex(index)
Parmetros

index

Um nmero inteiro que especifica o ndice do item a ser selecionado.

Retorna

Nada.
Descrio

Mtodo; seleciona o item especificado e atualiza a caixa de combinao para exibir o item
conforme selecionado. Se este mtodo for chamado, o estado atual de aberto ou fechado da
listagem suspensa no ser alterado. Este mtodo no pode ser utilizado se a caixa de combinao
estiver desativada.
O componente ComboBox usa um ndice com base no zero, onde o item no ndice 0 exibido no
topo da listagem.
Exemplo

O cdigo a seguir seleciona o quinto item na lista de menuMain.

menuMain.setSelectedIndex(3);
Consulte tambm

FComboBox.setRowCount

FComboBox.setSize
Disponibilidade

Flash Player 6.
Uso

myComboBox.setSize(width)
Parmetros

width

Um nmero inteiro que especifica a largura da caixa de combinao, em pixels.

Retorna

Nada.
Descrio

Mtodo; ajusta a caixa de combinao largura especificada. (No possvel definir a altura do
componente de uma caixa de combinao.) Use este mtodo para redimensionar a caixa de
combinao e atualiz-la durante a execuo.
Exemplo

O cdigo a seguir define ou redimensiona a largura do menuMain como sendo 100 pixels.
menuMain.setSize(100);
Consulte tambm

FComboBox.setRowCount

163

FComboBox.setStyleProperty
Disponibilidade

Flash Player 6.
Uso

myComboBox.setStyleProperty(styleProperty, value)
Parmetros

styleProperty

Uma seqncia de caracteres que especifica uma propriedade do objeto

FStyleFormat.
value

O valor definido para a propriedade.

Retorna

Nada.
Descrio

Mtodo; define uma propriedade FStyleFormat para uma determinada caixa de combinao.
Chamar este mtodo para especificar uma propriedade cancela as configuraes dessa propriedade
no formato de estilo atribudo ao componente. Se o valor undefined for atribudo a uma
propriedade, todos os estilos dessa propriedade sero removidos.
Para definir as propriedades FStyleFormat para vrios componentes, crie um formato de estilo
personalizado. Para obter mais informaes sobre a criao de formatos de estilo personalizados,
consulte Personalizando cores e texto do componente no captulo Usando componentes de
Usando o Flash.
Exemplo

O cdigo a seguir define a propriedade arrow de comboBox1 como sendo 0x000000 (preto).
comboBox1.setStyleProperty("arrow", 0x000000);
Consulte tambm

FStyleFormat (object)

FComboBox.setValue
Disponibilidade

Flash Player 6.
Uso

myComboBox.setValue(editableText)
Parmetros

Uma seqncia de caracteres que especifica o texto a ser exibido no campo de

texto de uma caixa de combinao editvel.

editableText

Retorna

Nada.

Dicionrio ActionScript 164

Descrio

Mtodo; especifica oS texto exibido no campo de entrada na parte superior da caixa de

combinao editvel. Se voc chamar este mtodo, o usurio poder ainda inserir texto no campo.
Este mtodo s pode ser usado com caixas de combinao editveis. Antes de chamar este
mtodo, voc deve especificar true para o parmetro Editable (cujo padro false) durante o
processo de criao ou utilizar FComboBox.setEditable para definir o parmetro como true.
Exemplo

O cdigo a seguir insere a seqncia de caracteres Gabino no campo superior da caixa de

combinao surnameMenu.
surnameMenu.setValue("Gabino");
Consulte tambm

FComboBox.getValue

FComboBox.sortItemsBy
Disponibilidade

Flash Player 6.
Uso

myComboBox.sortItemsBy(fieldName, order)
Parmetros

Uma seqncia de caracteres que especifica o nome do campo usado para

classificao. Este ser normalmente "label" ou "data".

fieldName

Uma seqncia de caracteres que especifica se os itens devem ser classificados em ordem
crescente ("ASC") ou decrescente ("DESC").

order

Retorna

Nada.
Descrio

Mtodo; classifica os itens na caixa de combinao em ordem alfabtica ou numrica, na ordem

especificada, usando o nome de campo especificado. Se os itens de fieldName forem uma
combinao de seqncias de caracteres de texto e nmeros inteiros, os itens inteiros sero
apresentados primeiro. O parmetro fieldName geralmente label ou data, mas pode ser
especificado qualquer valor de dado primitivo que atenda s necessidades.
Exemplo

O cdigo a seguir classifica os itens na caixa de combinao surnameMenu em ordem crescente

usando os rtulos dos itens de listagem.
surnameMenu.sortItemsBy("label", "ASC");
Consulte tambm

FComboBox.addItemAt, FComboBox.replaceItemAt, FComboBox.setDataProvider

165

FListBox (component)
O componente ListBox no ambiente de criao Flash oferece recurso de arrastar e soltar para
adicionar caixas de listagem rolveis de seleo nica e seleo mltipla a documentos Flash; ele
tambm oferece uma interface de usurio para definio de parmetros bsicos. Os mtodos do
componente FListBox permitem controlar caixas de listagem durante a execuo: voc pode criar
caixas de listagem, controlar as caixas de listagem criadas no ambiente de criao, definir ou
cancelar parmetros bsicos e definir opes adicionais de tempo de execuo. No preciso usar
um construtor para acessar os mtodos de componentes.
Os mtodos do componente no realizam verificao de erros de tipo, como outros objetos e
aes nativos do ActionScript; portanto, recomenda-se a validao dos parmetros antes de passlos para mtodos.
O componente ListBox tem suporte do Flash Player 6 e de suas verses posteriores.
Para obter informaes sobre o uso do componente ListBox, como definir parmetros durante o
processo de criao e como alterar as cores e a aparncia de componentes, consulte
Personalizando cores e texto do componente e Personalizando aparncias de componentes no
captulo Usando componentesde Usando o Flash.
Resumo dos mtodos do componente FListBox
Mtodo

Descrio

FListBox.addItem

Adiciona um novo item ao final da lista da caixa de listagem.

FListBox.addItemAt

Adiciona um novo item lista da caixa de listagem no ndice

especificado.

FListBox.getEnabled

Retorna true se a caixa de listagem estiver ativada, false se estiver

desativada.

FListBox.getItemAt

Retorna o rtulo e o valor do item no ndice especificado.

FListBox.getLength

Retorna o nmero de itens na caixa de listagem.

FListBox.getRowCount

Retorna o nmero de itens visveis na caixa de listagem.

FListBox.getScrollPosition

Retorna o ndice do item na parte superior da caixa de listagem.

FListBox.getSelectedIndex

Retorna o ndice do item selecionado por ltimo.

FListBox.getSelectedIndices

Retorna os ndices dos vrios itens selecionados.

FListBox.getSelectedItem

Retorna o rtulo e o valor do item selecionado.

FListBox.getSelectedItems

Retorna o rtulo e o valor dos vrios itens selecionados.

FListBox.getSelectMultiple

Retorna true se for permitida seleo mltipla, false se for

permitida seleo nica.

FListBox.getValue

Retorna o rtulo do item selecionado ou quaisquer outras

informaes associadas.

FListBox.registerSkinElement

Registra um elemento de aparncia em uma propriedade.

FListBox.removeAll

Remove todos os itens da caixa de listagem.

FListBox.removeItemAt

Remove o item no ndice especificado.

FListBox.replaceItemAt

Substitui o rtulo e os dados de um item em um ndice especificado

por um novo rtulo e novos dados.

FListBox.setAutoHideScrollBar

Determina se a barra de rolagem fica oculta (true) ou aparente

(false) quando o nmero de itens na caixa de listagem no exigir
rolagem.

Dicionrio ActionScript 166

Mtodo

Descrio

FListBox.setChangeHandler

Atribui uma funo a ser chamada todas as vezes que a seleo for
alterada.

FListBox.setDataProvider

Associa um objeto externo caixa de listagem.

FListBox.setEnabled

Especifica se a caixa de listagem est ativada (true) ou desativada

(false).

FListBox.setItemSymbol

Registra o identificador de vinculao de um smbolo a ser usado para

exibir itens na caixa de listagem.

FListBox.setRowCount

Retorna o nmero de itens exibidos na caixa de listagem.

FListBox.setScrollPosition

Faz a caixa de listagem rolar at que o item no ndice especificado

seja exibido na parte superior da lista.

FListBox.setSelectedIndex

Seleciona o item no ndice especificado e atualiza a caixa de listagem.

FListBox.setSelectedIndices

Seleciona os itens nos ndices especificados e atualiza a caixa de

listagem.

FListBox.setSelectMultiple

Determina se o usurio pode selecionar mais de um item na lista

(true) ou no (false).

FListBox.setSize

Define a largura e a altura da caixa de listagem, em pixels.

FListBox.setStyleProperty

Define uma nica propriedade de estilo para um componente.

FListBox.setWidth

Define a largura da caixa de listagem, em pixels.

FListBox.sortItemsBy

Classifica os itens na caixa de listagem em ordem alfabtica ou

numrica usando o rtulo ou os dados.

FListBox.addItem
Disponibilidade

Flash Player 6.
Uso

myListBox.addItem(label [, data])
Parmetros

Uma seqncia de caracteres de texto que especifica o item a ser adicionado lista.

label
data

Um valor a ser associado ao item de listagem. Este parmetro opcional.

Retorna

Nada.
Descrio

Mtodo; adiciona um novo item com o rtulo e os dados (opcional) especificados ao final da caixa
de listagem, atualiza a caixa de listagem e redimensiona a barra de rolagem. O parmetro Data
pode ser qualquer objeto do Flash, seqncia de caracteres, valor Booleano, nmero inteiro,
objeto ou clipe de filme.
Para obter melhor desempenho e menor tempo de carregamento, no adicione mais de 400 itens
a cada quadro. Isso se aplica esteja voc adicionando os itens a uma nica caixa de listagem ou a
vrias.

167

Exemplo

O cdigo a seguir adiciona Lyvia lista de itens exibidos na caixa de listagem coolGirls.
coolGirls.addItem("Lyvia");

O cdigo a seguir adiciona o nmero mximo de itens recomendado em um nico quadro (400
itens) a listBox1:
for (i=0; i<400; i++) {
listBox1.addItem(i);
}

O cdigo a seguir adiciona o nmero mximo de itens recomendado em um nico quadro (400
itens) a listBox1 e a comboBox2:
for (i=0; i<200; i++) {
listBox1.addItem(i);
comboBox2.addItem(i);
}
Consulte tambm

FListBox.addItemAt, FListBox.getItemAt, FListBox.removeItemAt,

FListBox.replaceItemAt, FListBox.sortItemsBy

FListBox.addItemAt
Disponibilidade

Flash Player 6.
Uso

myListBox.addItemAt(index, label [, data])

Parmetros

index

Um nmero inteiro que especifica a posio onde inserir o item.

label

Uma seqncia de caracteres de texto que especifica o rtulo do item.

data

Um valor a ser associado ao item de listagem. Este parmetro opcional.

Retorna

Nada.
Descrio

Mtodo; adiciona um novo item com o rtulo especificado e os dados (opcionais) associados no
ndice especificado e atualiza a caixa de listagem. O parmetro Data pode ser qualquer objeto do
Flash, seqncia de caracteres, valor Booleano, nmero inteiro, objeto ou clipe de filme.
O componente ListBox usa um ndice com base no zero, onde o item no ndice 0 exibido no
comeo da lista.
Para obter melhor desempenho e menor tempo de carregamento, no adicione mais de 400 itens
a cada quadro. Isso se aplica esteja voc adicionando os itens a uma nica caixa de listagem ou a
vrias.

Dicionrio ActionScript 168

Exemplo

O cdigo a seguir adiciona o item Dave com o valor associado friend como quinto item na caixa
de listagem peopleList.
peopleList.addItemAt(4, "Dave", friend);

Para obter exemplos de como carregar um grande nmero de itens, consulte FListBox.addItem.
Consulte tambm

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

FListBox.sortItemsBy

FListBox.getEnabled
Disponibilidade

Flash Player 6.
Uso

myListBox.getEnabled()
Parmetros

Nenhum.
Retorna

Um valor Booleano que indica se a caixa de listagem est ativada (true) ou desativada (false).
Descrio

Mtodo; indica se a caixa de listagem est ativada.

Exemplo

O cdigo a seguir usa getEnabled para determinar se listMenu est ativado ou desativado e
exibe o resultado na janela Sada.
trace(listMenu.getEnabled());
Consulte tambm

FListBox.setEnabled

FListBox.getItemAt
Disponibilidade

Flash Player 6.
Uso

myListBox.getItemAt(index)
Parmetros

index

Um nmero inteiro que especifica o ndice do item a ser recuperado.

Retorna

Um objeto ou undefined.
Descrio

Mtodo; retorna o item no ndice especificado como um objeto com as propriedades label e
data. Se no houver item algum no ndice especificado, este mtodo retornar undefined.
O componente ListBox usa um ndice com base no zero, onde o item no ndice 0 exibido no
comeo da lista.

169

Exemplo

O cdigo a seguir retorna o rtulo do item no ndice 4 em listMenu1 na janela Sada.

trace(listMenu1.getItemAt(4).label);

O cdigo a seguir retorna os dados ou o valor associado ao item no ndice 4 em listMenu2 na

janela Sada.
trace(listMenu2.getItemAt(4).data);

O cdigo a seguir retorna um objeto contendo o rtulo e o valor de dados associado ao item no
ndice 4 em listMenu3 na janela Sada.
trace(listMenu3.getItemAt(4));
Consulte tambm

FListBox.getSelectedItem

FListBox.getLength
Disponibilidade

Flash Player 6.
Uso

myListBox.getLength()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna o nmero de itens na caixa de listagem.

Exemplo

O cdigo a seguir retorna o nmero de itens em phoneList.

phoneList.getLength();
Consulte tambm

FListBox.setSize

FListBox.getRowCount
Disponibilidade

Flash Player 6.
Uso

myListBox.getRowCount()
Parmetros

Nenhum.
Retorna

Um inteiro.

Dicionrio ActionScript 170

Descrio

Mtodo; retorna o nmero de linhas visveis na caixa de listagem. Este mtodo til para
determinar quantas linhas so exibidas em uma caixa de listagem dimensionada em pixels.
Exemplo

O cdigo a seguir retorna o nmero de linhas visveis em toyList e define o valor para a varivel
rowCount.
var rowCount = toyList.getRowCount();
Consulte tambm

FListBox.setRowCount, FListBox.setSize

FListBox.getScrollPosition
Disponibilidade

Flash Player 6.
Uso

myListBox.getScrollPosition()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna o ndice do item que est atualmente no topo da exibio da caixa de listagem.
Exemplo

O cdigo a seguir retorna o ndice do item no topo de staffList.

staffList.getScrollPosition();
Consulte tambm

FListBox.setScrollPosition

FListBox.getSelectedIndex
Disponibilidade

Flash Player 5
Uso

myListBox.getSelectedIndex()
Parmetros

Nenhum.
Retorna

Um nmero inteiro ou undefined.

171

Descrio

Mtodo; retorna o ndice do item atualmente selecionado em uma caixa de listagem de seleo
nica, o item selecionado por ltimo em uma caixa de listagem de seleo mltipla, ou
undefined, se no houver nenhum item selecionado. Para recuperar os ndices de todos os itens
selecionados em uma caixa de listagem de seleo mltipla, use FListBox.getSelectedIndices.
Exemplo

O cdigo a seguir retorna o ndice do item atualmente selecionado na caixa de listagem de seleo
nica nationList.
nationList.getSelectedIndex();
Consulte tambm

FListBox.setSelectedIndices, FListBox.setSelectMultiple

FListBox.getSelectedIndices
Disponibilidade

Flash Player 6.
Uso

myListBox.getSelectedIndices()
Parmetros

Nenhum.
Retorna

Uma matriz ou undefined.

Descrio

Mtodo; retorna os ndices dos itens atualmente selecionados em uma caixa de listagem de seleo
mltipla como uma matriz, ou retorna undefined, caso nenhum item esteja selecionado.
Exemplo

O cdigo a seguir retorna os ndices dos itens atualmente selecionados na caixa de listagem de
seleo mltipla groceryList.
groceryList.getSelectedIndices();
Consulte tambm

FListBox.getSelectedIndex, FListBox.setSelectMultiple

FListBox.getSelectedItem
Disponibilidade

Flash Player 6.
Uso

myListBox.getSelectedItem()
Parmetros

Nenhum.

Dicionrio ActionScript 172

Retorna

Um objeto ou undefined.
Descrio

Mtodo, retorna o item atualmente selecionado como um objeto com as propriedades label e
data. Se houver mais de um item selecionado, o mtodo retornar o item selecionado por ltimo
na lista; se nenhum item estiver selecionado, o mtodo retornar undefined. Para obter
informaes sobre todos os itens selecionados em uma caixa de listagem de seleo mltipla, use
FListBox.getSelectedItems.
Exemplo

O cdigo a seguir recupera o rtulo do item atualmente selecionado em listBox1.

trace(listBox1.getSelectedItem().label);

O cdigo a seguir retorna os dados ou valores associados ao item atualmente selecionado em

listBox2.
trace(listBox2.getSelectedItem().data);

O cdigo a seguir retorna um objeto contendo o rtulo e o valor de dados associado ao item
atualmente selecionado em listBox3.
trace(listBox3.getSelectedItem());
Consulte tambm

FListBox.getItemAt

FListBox.getSelectedItems
Disponibilidade

Flash Player 6.
Uso

myListBox.getSelectedItems()
Parmetros

Nenhum.
Retorna

Uma matriz ou undefined.

Descrio

Mtodo; retorna os itens atualmente selecionados como uma matriz de objetos com as
propriedades label e data, ou retorna undefined, se no houver item selecionado. Este mtodo
s pode ser usado para obter os itens selecionados em uma caixa de listagem de seleo mltipla.
Para obter informaes sobre o item atualmente selecionado em uma caixa de listagem de seleo
nica, use FListBox.getSelectedItem.
Exemplo

O cdigo a seguir recupera os itens atualmente selecionados em wishList e armazena esses

valores na varivel myObjArray.
var myObjArray = wishList.getSelectedItems();
Consulte tambm

FListBox.getSelectedItem, FListBox.setSelectMultiple

173

FListBox.getSelectMultiple
Disponibilidade

Flash Player 6.
Uso

myListBox.getSelectMultiple()
Parmetros

Nenhum.
Retorna

Um valor booleano.
Descrio

Mtodo; indica se os usurios podem selecionar vrios itens (true) ou somente um nico item
(false) na caixa de listagem.
Exemplo

O cdigo a seguir testa se wishList permite seleo mltipla.

if (wishList.getSelectMultiple()) {
}
Consulte tambm

FListBox.setSelectMultiple

FListBox.getValue
Disponibilidade

Flash Player 6.
Uso

myListBox.getValue()
Parmetros

Nenhum.
Retorna

O rtulo ou os dados associados ao item selecionado.

Descrio

Mtodo; retorna informaes sobre o item atualmente selecionado na caixa de listagem. Se o item
no tiver dados especificados, este mtodo retornar o rtulo do item; se o item tiver dados
associados, este mtodo retornar os dados.
Exemplo

O cdigo a seguir retorna o rtulo do item selecionado em nationList.

trace(nationList.getValue());
Consulte tambm

FListBox.getItemAt

Dicionrio ActionScript 174

FListBox.registerSkinElement
Disponibilidade

Flash Player 6.
Uso

myListBox.registerSkinElement(element, styleProperty)
Parmetros

element

Uma instncia de clipe de filme.

styleProperty

O nome de uma propriedade de FStyleFormat.

Retorna

Nada.
Descrio

Mtodo; registra um elemento de aparncia em uma propriedade de estilo. Elementos de

aparncia so registrados em propriedades no primeiro quadro da camada ReadMe de cada
aparncia na biblioteca.
Os componentes so compostos de aparncias e cada aparncia composta de vrios elementos de
aparncia, cada um dos quais pode ser registrado em uma propriedade do objeto FStyleFormat.
Essas propriedades so valores atribudos pelo formato de estilo atribudo a um componente.
Como padro, o objeto globalStyleFormat atribudo a todos os componentes de interface do
Flash. Esse objeto uma instncia do objeto FStyleFormat.
Use este mtodo para registrar propriedades e elementos de aparncia personalizados na interface
do Flash ou aparncias personalizadas de componentes editando o cdigo no primeiro quadro da
camada ReadMe de uma aparncia na biblioteca.
O componente FListBox usa as aparncias na pasta FListBox Skins depois que o componente for
adicionado ao documento Flash.
Para obter mais informaes, consulte Personalizando aparncias de componentes no captulo
Usando componentesde Usando o Flash.
Exemplo

O cdigo a seguir registra o elemento de aparncia personalizado boundBox_mc na propriedade

background no primeiro quadro da camada ReadMe da aparncia FBoundingBox na pasta
Global Skins na biblioteca.
toysMenu.registerSkinElement(boundBox_mc, "background");
Consulte tambm

FStyleFormat (object)

175

FListBox.removeAll
Disponibilidade

Flash Player 6.
Uso

myListBox.removeAll()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; remove todos os itens da caixa de listagem, atualiza a caixa e redimensiona a barra de
rolagem.
Exemplo

O cdigo a seguir remove todos os itens de wishList.

wishList.removeAll();
Consulte tambm

FListBox.removeItemAt

FListBox.removeItemAt
Disponibilidade

Flash Player 6.
Uso

myListBox.removeItemAt(index)
Parmetros

index

Um nmero inteiro que especifica o ndice do item a ser removido.

Retorna

Nada ou undefined.
Descrio

Mtodo; remove o item no ndice especificado, atualiza os ndices dos itens da lista seguintes ao
item removido para refletir suas novas posies e, a seguir, atualiza a caixa de listagem e
redimensiona a barra de rolagem. Se no houver item algum no ndice especificado, este mtodo
retornar undefined.
O componente ListBox usa um ndice com base no zero, onde o item no ndice 0 exibido no
comeo da lista.
Exemplo

O cdigo a seguir remove o quinto item na lista de wishList.

wishList.removeItemAt(4);
Consulte tambm

FListBox.addItemAt

Dicionrio ActionScript 176

FListBox.replaceItemAt
Disponibilidade

Flash Player 6.
Uso

myListBox.replaceItemAt(index, label [,data])

Parmetros

index

Um nmero inteiro que especifica a posio de um item de listagem.

label

Uma seqncia de caracteres que especifica um novo rtulo para o item de listagem.

O novo valor a ser associado ao item de listagem. Este parmetro opcional; se voc deixar
de especific-lo, qualquer dado atualmente associado ao item permanece no lugar.

data

Retorna

Nada.
Descrio

Mtodo; atualiza o item no ndice especificado com o rtulo e os dados especificados. Se o item
no ndice especificado tiver um valor de dado associado e voc no especificar um valor para o
parmetro data, o valor de dado do item de listagem no ser alterado.
O componente List Box usa um ndice com base no zero, onde o item no ndice 0 exibido no
topo da listagem.
Exemplo

O cdigo a seguir atualiza o quinto item na caixa de listagem Favorites com o novo rtulo
Lucky e o novo valor Cat. Se o valor de dados Cat no for especificado e o dado associado ao
quinto item da lista for Dog, o valor de dados de Lucky ser Dog (o que estaria errado, pois Lucky
um gato ("cat")).
Favoritos.replaceItemAt(4, "Lucky", "Cat");
Consulte tambm

FListBox.addItemAt, FListBox.getItemAt

FListBox.setAutoHideScrollBar
Disponibilidade

Flash Player 6.
Uso

myListBox.setAutoHideScrollBar(hideScroll)
Parmetros

hideScroll Um valor Booleano que especifica se a barra de rolagem deve ficar oculta quando
no for necessria (true) ou deve ser sempre exibida (false).
Retorna

Nada.

177

Descrio

Mtodo; especifica se a barra de rolagem deve ficar oculta quando o nmero de itens na caixa de
listagem puder ser visualizado sem uma barra de rolagem (true) ou se a barra de rolagem ser
sempre exibida (false). Se este mtodo for definido como false e o nmero de itens no exigir
uma barra de rolagem, a barra de rolagem ser exibida como desativada (esmaecida).
Exemplo

O cdigo a seguir oculta a barra de rolagem de wishList quando o nmero de itens na caixa de
listagem puder ser visualizado sem rolagem.
wishList.setAutoHideScrollBar(true);

FListBox.setChangeHandler
Disponibilidade

Flash Player 6.
Uso

myListBox.setChangeHandler(functionName, [location])
Parmetros

Uma seqncia de caracteres que especifica o nome da funo do identificador a

ser executada quando a seleo na caixa de listagem alterada. Se o parmetro location no for
especificado, esta funo dever estar na mesma Linha de tempo da instncia do componente.

functionName

Uma referncia de caminho at um objeto de dados, clipe de filme ou Linha de

tempo que contm a funo especificada. Este parmetro opcional e tem como padro a Linha
de tempo pai do componente.

location

Retorna

Nada.
Descrio

Mtodo; especifica um identificador de alterao a ser chamado quando a seleo na caixa de

listagem alterada. Voc pode especificar a mesma funo de identificador de alterao para mais
de um componente; a funo sempre aceita a instncia do componente que foi alterada como um
parmetro. Se este mtodo for chamado, valor do parmetro Identificador de alterao
especificado na criao ser cancelado.
Para obter mais informaes, consulte Criando funes do identificador de alterao para
componentes no captulo Usando componentesde Usando o Flash.
Exemplo

O cdigo a seguir especifica myHandler como a funo chamada quando o valor de listBox1
alterado. Como o parmetro location no foi especificado, myHandler dever estar na mesma
Linha de tempo da instncia do componente.

Dicionrio ActionScript 178

O parmetro component em myHandler automaticamente preenchido com a instncia de um

componente (o componente que foi alterado como resultado de uma entrada do usurio e que
especifica myHandler como seu identificador de alterao). As aes definidas em myHandler
especificam que o rtulo do item exibido na janela Sada quando o usurio seleciona um item na
listagem.
listBox1.setChangeHandler("myHandler");
function myHandler(component){
trace(listBox1.getSelectedItem().label);
}

Se, no exemplo acima, myHandler fosse uma funo localizada na Linha de tempo bisav da
Linha de tempo do componente, a primeira linha de cdigo seria da seguinte forma:
listBox1.setChangeHandler("myHandler", _parent._parent._parent);

O cdigo a seguir cria a funo myHandler em uma instncia de myObject (que da classe
Object) e, a seguir, especifica myHandler como a funo de listBox1.
myObject = new Object();
myObject.myHandler = function(component){
trace(listBox1.getSelectedItem().label);
}
listBox1.setChangeHandler("myHandler", myObject);

FListBox.setDataProvider
Disponibilidade

Flash Player 6.
Uso

myListBox.setDataProvider(dataProvider)
Parmetros

Uma matriz de seqncias de caracteres de texto que lista itens para adicionar,
uma instncia do objeto Array que especifica os itens a serem adicionados ou uma instncia da
classe DataProvider.

dataProvider

Retorna

Nada.
Descrio

Mtodo; registra um objeto externo (dataProvider) como a fonte de dados para o componente
da caixa de listagem. Se dataProvider for uma instncia do objeto Array, o objeto poder
especificar label, data ou ambos, pois as propriedades de objeto e o contedo da matriz podero
ser copiados para a caixa de listagem como rtulos, dados ou ambos. Se dataProvider for uma
instncia da classe DataProvider, ele dever implementar a API DataProvider definida no smbolo
DataProvider na pasta FlashUIComponents/Core Assets/ClassTree da biblioteca. A API
DataProvider somente para usurios e programadores avanados; todos os outros usurios
devem usar uma matriz ou um objeto Array.
Exemplo

O cdigo a seguir especifica o objeto Array writerList como o provedor de dados para
listBox1.
listBox1.setDataProvider(writerList);

179

O cdigo a seguir cria a matriz writerList para exibir os rtulos dos itens listados em listBox1.
writerList = new Array();
writerList[0] = "Jody";
writerList[1] = "Mary";
writerList[2] = "Marcelle";
writerList[3] = "Dale";
writerList[4] = "Stephanie";
writerList[5] = "Barbara";

O cdigo a seguir cria a matriz itemList1, que especifica tanto o rtulo quanto os dados para
itens de listagem. Esse objeto Array poderia ser usado como um provedor de dados alternativo
para listBox1.
itemList1 = new Array();
for (i=0; i<10; i++) {
// criar um item real
var myItem = new Object();
myItem.label = "Item" + i;
myItem.data = 75;
// coloca-lo na matriz
itemList1[i] = myItem;
}

O cdigo a seguir especifica editorList, uma instncia da classe DataProvider, como o provedor
de dados para listBox1.
listBox1.setDataProvider(editorList);

O cdigo a seguir cria uma nova instncia da classe DataProvider e, a seguir, adiciona os rtulos
do item usando o mtodo addItem de DataProvider.
Observao: O mtodo addItem somente um mtodo da classe DataProvider. Os programadores interessados
em usar a classe DataProvider devem consultar o smbolo DataProvider na pasta FlashUIComponents/
CoreAssets/ClassTree na biblioteca antes de tentar usar os mtodos.

editorList = new DataProviderClass();

editorList.addItem("Anne");
editorList.addItem("Rosana");
editorList.addItem("Lisa");
editorList.addItem("Rebecca");
Consulte tambm

FListBox.addItem, FListBox.replaceItemAt, FListBox.sortItemsBy

FListBox.setEnabled
Disponibilidade

Flash Player 6.
Uso

myListBox.setEnabled(enable)
Parmetros

Um valor Booleano que especifica se a caixa de listagem est ativada (true) ou

desativada (false).

enable

Dicionrio ActionScript 180

Retorna

Nada.
Descrio

Mtodo; especifica se a caixa de listagem est ativada (true) ou desativada (false). Se uma caixa
de seleo estiver desativada, ela no aceitar interao de mouse nem de teclado do usurio. Se
esse parmetro for omitido, o mtodo utilizar o padro true.
Exemplo

O cdigo a seguir desativa interestList.

interestList.setEnabled(false);
Consulte tambm

FListBox.getEnabled

FListBox.setItemSymbol
Disponibilidade

Flash Player 6.
Uso

myListBox.setItemSymbol(symbolID)
Parmetros

O identificador de vinculao de smbolo de um smbolo grfico para exibir o

contedo da caixa de listagem.

symbolID

Retorna

Nada.
Descrio

Mtodo; registra um smbolo grfico para exibir os itens na caixa de listagem. O valor padro o
smbolo FListBoxItem na biblioteca. Este mtodo destinado a usurios e programadores
avanados.

FListBox.setRowCount
Disponibilidade

Flash Player 6.
Uso

myListBox.setRowCount(rows)
Parmetros

rows

O nmero mximo de linhas exibidas na caixa de listagem.

Retorna

Nada.

181

Descrio

Mtodo; retorna o nmero de itens exibidos na caixa de listagem. Se voc usar este mtodo, utilize
FListBox.setWidth, e no FListBox.setSize, para definir a largura da caixa de listagem.
Chamar FListBox.setSize cancela o valor do parmetro Row Count definido durante o
processo de criao. Portanto, se voc chamar este mtodo depois de chamar
FListBox.setRowCount, seu filme desconsiderar a configurao de rowCount e definir a altura
da caixa de listagem em pixels.
Exemplo

O cdigo a seguir define o nmero de itens exibidos em toyList como 4.

toyList.setRowCount(4);
Consulte tambm

FListBox.getRowCount, FListBox.setSize

FListBox.setScrollPosition
Disponibilidade

Flash Player 6.
Uso

myListBox.setScrollPosition(index)
Parmetros

index Um nmero inteiro que especifica o ndice do item a ser exibido na parte superior da
caixa de listagem.
Retorna

Nada.
Descrio

Mtodo; faz a caixa de listagem rolar at que o item especificado seja exibido na parte superior da
caixa.
O componente ListBox usa um ndice com base no zero, onde o item no ndice 0 exibido no
comeo da lista.
Exemplo

O cdigo a seguir exibe o quinto item em toyList no topo da listagem.

toyList.setScrollPosition(4);
Consulte tambm

FListBox.getScrollPosition

Dicionrio ActionScript 182

FListBox.setSelectedIndex
Disponibilidade

Flash Player 6.
Uso

myListBox.setSelectedIndex(index)
Parmetros

index

Um nmero inteiro que especifica o ndice do item a ser selecionado na caixa de listagem.

Retorna

Nada.
Descrio

Mtodo; seleciona o item no ndice especificado e atualiza a caixa de listagem.

O componente ListBox usa um ndice com base no zero, onde o item no ndice 0 exibido no
comeo da lista.
Exemplo

O cdigo a seguir seleciona o quinto item na caixa de listagem.

toyList.setSelectedIndex(4);
Consulte tambm

FListBox.getSelectedIndex, FListBox.getSelectedIndices

FListBox.setSelectedIndices
Disponibilidade

Flash Player 6.
Uso

myListBox.setSelectedIndices(indexArray)
Parmetros

indexArray

Uma matriz de ndices de itens a ser selecionada na caixa de listagem.

Retorna

Nada.
Descrio

Mtodo; seleciona os itens especificados na matriz de ndices e atualiza a caixa de listagem.

O componente ListBox usa um ndice com base no zero, onde o item no ndice 0 exibido no
comeo da lista.
Exemplo

O cdigo a seguir cria uma matriz denominada myArray que especifica os itens que devero ser
selecionados em toyList e, a seguir, passa a matriz para o mtodo setSelectedIndices.
var myArray = new Array (1,4,5,7);
toyList.setSelectedIndices(myArray);
Consulte tambm

FListBox.getSelectedIndices

183

FListBox.setSelectMultiple
Disponibilidade

Flash Player 6.
Uso

myListBox.setSelectMultiple(multipleSelect)
Parmetros

Um valor Booleano que especifica o modo de seleo mltipla (true) ou o

modo de seleo nica (false).

multipleSelect
Retorna

Nada.
Descrio

Mtodo; especifica se os usurios podem selecionar vrios itens (true) ou somente um nico item
(false) na caixa de listagem. A configurao padro false. Se este mtodo for chamado, o
valor do parmetro Select Multiple definido durante o processo de criao ser cancelado.
Exemplo

O cdigo a seguir ativa a seleo mltipla para toyList.

toyList.setSelectMultiple(true);

FListBox.setSize
Disponibilidade

Flash Player 6.
Uso

myListBox.setSize(width, height)
Parmetros

width

Um nmero inteiro que especifica a largura da caixa de listagem, em pixels.

height

Um nmero inteiro que especifica a altura da caixa de listagem, em pixels.

Retorna

Nada.
Descrio

Mtodo; ajusta o tamanho da caixa de listagem durante a execuo segundo a largura e a altura
especificadas. Se este mtodo for chamado, o valor do parmetro Row Count definido durante o
processo de criao ser cancelado. Portanto, se voc chamar este mtodo depois de chamar
FListBox.setRowCount, seu filme definir a altura da caixa de listagem em pixels e
desconsiderar a configurao de rowCount. Para definir a largura de uma caixa de listagem ao
utilizar setRowCount, use FListBox.setWidth.
Exemplo

O cdigo a seguir faz com que phoneList passe a medir 200 pixels de largura e 50 pixels de
altura.
phoneList.setSize(200, 50);
Consulte tambm

FListBox.setRowCount, FListBox.setWidth

Dicionrio ActionScript 184

FListBox.setStyleProperty
Disponibilidade

Flash Player 6.
Uso

myListBox.setStyleProperty(styleProperty, value)
Parmetros

styleProperty

Uma seqncia de caracteres que especifica uma propriedade do objeto

FStyleFormat.
value

O valor definido para a propriedade.

Retorna

Nada.
Descrio

Mtodo; define uma propriedade FStyleFormat para uma determinada caixa de listagem. Chamar
este mtodo para especificar uma propriedade cancela as configuraes dessa propriedade no
formato de estilo atribudo ao componente. Se o valor undefined for atribudo a uma
propriedade, todos os estilos dessa propriedade sero removidos.
Para definir as propriedades FStyleFormat para vrios componentes, crie um formato de estilo
personalizado. Para obter mais informaes sobre a criao de formatos de estilo personalizados,
consulte Personalizando cores e texto do componente no captulo Usando componentes de
Usando o Flash.
Exemplo

O cdigo a seguir define a propriedade shadow de listBox1 como 0x000000 (preto).

listBox1.setStyleProperty("shadow", 0x000000);
Consulte tambm

FStyleFormat (object)

FListBox.setWidth
Disponibilidade

Flash Player 6.
Uso

myListBox.setWidth(width)
Parmetros

width

Um nmero inteiro que especifica a largura da caixa de listagem, em pixels.

Retorna

Nada.
Descrio

Mtodo; especifica a largura da caixa de listagem, em pixels. Este mtodo til para definir a
largura da caixa de listagem quando FListBox.setRowCount for usado para determinar a altura.

185

Exemplo

O cdigo a seguir define a largura da caixa de listagem toyList como 500 pixels.
toyList.setWidth(500);
Consulte tambm

FListBox.setSize

FListBox.sortItemsBy
Disponibilidade

Flash Player 6.
Uso

myListBox.sortItemsBy(fieldName, order)
Parmetros

Uma seqncia de caracteres que especifica o nome do campo usado para

classificao. Este ser normalmente "label" ou "data".

fieldName

Uma seqncia de caracteres que especifica se os itens devem ser classificados em ordem
crescente ("ASC") ou decrescente ("DESC").

order

Retorna

Nada.
Descrio

Mtodo; classifica os itens na caixa de listagem em ordem alfabtica ou numrica, na ordem

especificada, usando o nome de campo especificado. Se os itens de fieldName forem uma
combinao de seqncias de caracteres de texto e nmeros inteiros, os itens inteiros sero
apresentados primeiro. O parmetro fieldName geralmente "label" ou "data", mas os
usurios e programadores avanados podem especificar qualquer primitivo que atenda s suas
necessidades.
Exemplo

O cdigo a seguir classifica os itens na caixa de listagem surnameMenu em ordem crescente usando
os rtulos dos itens de listagem.
surnameMenu.sortItemsBy("label", "ASC");
Consulte tambm

FListBox.addItemAt, FListBox.replaceItemAt

Dicionrio ActionScript 186

_focusrect
Disponibilidade

Flash Player 4.
Uso

_focusrect = Booleano;
Descrio

Propriedade (global); especifica se exibido um retngulo amarelo em volta do boto que tem
foco de teclado. O valor padro, true, exibe um retngulo amarelo em volta do boto ou campo
de texto com foco no momento quando o usurio pressiona a tecla Tab para navegar pelos objetos
em um filme. Especifique false se voc no desejar exibir o retngulo amarelo. Essa uma
propriedade global que pode ser cancelada para instncias especficas.
Consulte tambm

Button._focusrect

for
Disponibilidade

Flash Player 5.
Uso

for(incio; condio; prxima) {

comando(s);
}
Parmetros

incio Uma expresso a ser avaliada antes do incio da seqncia de loop, geralmente uma
expresso de atribuio. O comando var tambm permitido para este parmetro.

Uma expresso que seja avaliada como true ou false. A condio avaliada antes
de cada iterao do loop; o loop termina quando a condio avaliada como false.

condio

prxima Uma expresso que avaliada aps cada iterao do loop; geralmente uma expresso de
atribuio com os operadores ++ (aumento) ou -- (diminuio).
comando(s)

Uma instruo ou instrues a ser(em) executada(s) no corpo do loop.

Descrio

Ao; um construtor de loop que avalia a expresso incio (inicializar) uma vez e comea a
seqncia do loop pelo qual o comando executado e a prxima expresso avaliada enquanto a
condio for avaliada como true.
Algumas propriedades no podem ser enumeradas pelas aes for nem for..in. Por exemplo, os
mtodos internos do objeto Array (Array.sort e Array.reverse) no so includos na
enumerao de um objeto Array, e as propriedades de clipe de filme, como _x e _y, no so
enumeradas.

187

Exemplo

O exemplo a seguir usa for para adicionar os elementos a uma matriz:

for(i=0; i<10; i++) {
array [i] = (i + 5)*10;
trace(array[i]);
}

Os seguintes resultados so exibidos na janela Sada:

50
60
70
80
90
100
110
120
130
140

O exemplo a seguir mostra o uso de for para executar a mesma ao repetidamente. No cdigo
abaixo, o loop for adiciona os nmeros de 1 a 100.
var sum = 0;
for (var i=1; i<=100; i++) {
sum = sum + i;
}
Consulte tambm

++ (incremento), (decrement), for..in, var

for..in
Disponibilidade

Flash Player 5.
Uso

for(variableIterant in objeto){
comando(s);
}
Parmetros

O nome de uma varivel que age como iterando, fazendo referncia a cada
propriedade de um objeto ou elemento em uma matriz.

variableIterant
objeto

O nome de um objeto a ser repetido.

comando(s)

Uma instruo a ser executada para cada iterao.

Retorna

Nada.
Descrio

Ao; realiza um loop pelas propriedades de um objeto ou elemento em uma matriz e executa o
comando para cada propriedade de um objeto.

Dicionrio ActionScript 188

Algumas propriedades no podem ser enumeradas pelas aes for nem for..in. Por exemplo, os
mtodos internos do objeto Array (Array.sort e Array.reverse) no so includos na
enumerao de um objeto Array, e as propriedades de clipe de filme, como _x e _y, no so
enumeradas.
A construo for..in faz a iterao das propriedades de objetos na cadeia prottipo do objeto
iterado. Se o prottipo do filho for pai, a iterao das propriedades do filho com for..in
tambm far a iterao das propriedades do pai.
A ao for..in enumera todos os objetos na cadeia prottipo de um objeto. As propriedades do
objeto so enumeradas primeiro, a seguir, as propriedades de seu prottipo imediato, a seguir, as
propriedades do prottipo do prottipo e assim por diante. A ao for..in no enumera o
mesmo nome de propriedade duas vezes. Se o objeto filho tiver um pai prottipo e ambos
contiverem a propriedade prop, a ao for..in iniciada sobre o filho enumerar prop a partir
do filho, mas ignorar a que est no pai.
Exemplo

O exemplo a seguir mostra o uso de for..in para iterao das propriedades de um objeto:
myObject = { name:'Tara', age:27, city:'San Francisco' };
for (name in myObject) {
trace ("myObject." + name + " = " + myObject[name]);
}

A sada deste exemplo :

myObject.name = Tara
myObject.age = 27
myObject.city = San Francisco

O exemplo a seguir mostra o uso do operador typeof com for..in para iterar um tipo especfico
de filho:
for (name in myMovieClip) {
if (typeof (myMovieClip[name]) = "movieclip") {
trace ("I have a movie clip child named " + name);
}
}

O exemplo a seguir enumera os filhos de um clipe de filme e envia cada um para o quadro 2 de
suas respectivas linhas de tempo. O clipe de filme RadioButtonGroup pai de vrios filhos,
_RedRadioButton_, _GreenRadioButton_ e _BlueRadioButton.
for (var name in RadioButtonGroup) {
RadioButtonGroup[name].gotoAndStop(2);
}

FPushButton (component)
O componente PushButton no ambiente de criao Flash oferece recurso de arrastar e soltar para
adicionar botes a documentos Flash; ele tambm oferece uma interface de usurio para definio
de parmetros bsicos. Os mtodos do componente FPushButton permitem controlar botes
durante a execuo: voc pode criar botes, controlar botes criados no ambiente de criao,
definir ou cancelar parmetros bsicos e definir opes adicionais de tempo de execuo. No
preciso usar um construtor para acessar os mtodos de componentes.
O componente PushButton aceita todas as interaes padro de mouse e teclado. Voc pode usar
os mtodos de FPushButton para especificar uma funo do identificador para os botes de ao,
desativar ou ativar botes e redimensionar botes sem distoro durante a execuo.

189

Os mtodos do componente no realizam verificao de erros de tipo, como outros objetos e

aes nativos do ActionScript; portanto, recomenda-se a validao dos parmetros antes de passlos para mtodos.
O componente PushButton tem suporte do Flash Player 6 e de suas verses posteriores.
Para obter informaes sobre o uso do componente PushButton, como definir parmetros
durante o processo de criao e como alterar as cores e a aparncia de componentes, consulte
Personalizando cores e texto do componente e Personalizando aparncias de componentes no
captulo Usando componentesde Usando o Flash.
Resumo dos mtodos do componente FPushButton
Mtodo

Descrio

FPushButton.getEnabled

Retorna true se o boto estiver ativado, false se estiver desativado.

FPushButton.getLabel

Retorna o rtulo do boto como uma seqncia de caracteres.

FPushButton.registerSkinElement

Registra um elemento de aparncia em uma propriedade.

FPushButton.setClickHandler

Especifica a funo chamada quando o usurio libera o boto.

FPushButton.setEnabled

Determina se o boto est ativado ou desativado.

FPushButton.setLabel

Define o rtulo do boto durante a execuo.

FPushButton.setSize

Define a altura e a largura do boto, em pixels.

FPushButton.setStyleProperty

Define uma nica propriedade de estilo para um componente.

FPushButton.getEnabled
Disponibilidade

Flash Player 6.
Uso

myPushButton.getEnabled()
Parmetros

Nenhum.
Retorna

Um valor booleano.
Descrio

Mtodo; retorna true se a instncia do boto de ao estiver ativada, false se estiver desativada.
Exemplo

O cdigo a seguir retorna o estado ativado do boto de ao submit na janela Sada.

trace(submit.getEnabled());
Consulte tambm

FPushButton.setEnabled

Dicionrio ActionScript 190

FPushButton.getLabel
Disponibilidade

Flash Player 6.
Uso

myPushButton.getLabel()
Parmetros

Nenhum.
Retorna

Uma seqncia de caracteres.

Descrio

Mtodo; retorna o rtulo de texto no boto de ao como uma seqncia de caracteres.

Exemplo

O cdigo a seguir retorna o rtulo do boto de ao buttonPage1 na janela Sada.

trace(buttonPage1.getLabel());
Consulte tambm

FPushButton.setLabel

FPushButton.registerSkinElement
Disponibilidade

Flash Player 6.
Uso

myPushButton.registerSkinElement(element, styleProperty)
Parmetros

element

Uma instncia de clipe de filme.

styleProperty

O nome de uma propriedade de FStyleFormat.

Retorna

Nada.
Descrio

Mtodo; registra um elemento de aparncia em uma propriedade de estilo. Elementos de

aparncia so registrados em propriedades no primeiro quadro da camada ReadMe de cada
aparncia na biblioteca.
Os componentes so compostos de aparncias e cada aparncia composta de vrios elementos de
aparncia, cada um dos quais pode ser registrado em uma propriedade do objeto FStyleFormat.
Essas propriedades so valores atribudos pelo formato de estilo atribudo a um componente.
Como padro, o objeto globalStyleFormat atribudo a todos os componentes de interface do
Flash. Esse objeto uma instncia do objeto FStyleFormat.
Use este mtodo para registrar propriedades e elementos de aparncia personalizados na interface
do Flash ou aparncias personalizadas de componentes editando o cdigo no primeiro quadro da
camada ReadMe de uma aparncia na biblioteca.

191

O componente FPushButton usa as aparncias na pasta FPushButton Skins e a aparncia FLabel

na pasta Global Skins depois que voc adiciona o componente ao documento Flash.
Para obter mais informaes, consulte Personalizando aparncias de componentes no captulo
Usando componentesde Usando o Flash.
Exemplo

O cdigo a seguir registra o elemento de aparncia personalizado newFace_mc na propriedade

face no primeiro quadro da camada ReadMe da aparncia FLabel. A aparncia FLabel est na
pasta Component Skins/Global na biblioteca.
submitButton.registerSkinElement(newFace_mc, "face");
Consulte tambm

FStyleFormat (object)

FPushButton.setClickHandler
Disponibilidade

Flash Player 6.
Uso

myPushButton.setClickHandler(functionName, [location])
Parmetros

Uma seqncia de caracteres que especifica o nome da funo do identificador a

ser executada quando o usurio libera o boto de ao. Se o parmetro location no for
especificado, esta funo dever estar na mesma Linha de tempo da instncia do componente.

functionName

Uma referncia de caminho at um objeto de dados, clipe de filme ou Linha de

tempo que contm a funo especificada. Este parmetro opcional e tem como padro a Linha
de tempo pai do componente.

location

Retorna

Nada.
Descrio

Mtodo; especifica a funo do identificador a ser chamada quando o usurio libera o boto de
ao. Voc pode especificar a mesma funo de identificador para mais de um componente; a
funo sempre aceita a instncia do componente que foi alterada como um parmetro. Se este
mtodo for chamado, o valor do parmetro Identificador de clique especificado na criao ser
cancelado.
Para obter mais informaes, consulte Criando funes do identificador de alterao para
componentes no captulo Usando componentes de Usando o Flash.

Dicionrio ActionScript 192

Exemplo

O cdigo a seguir especifica onClick como a funo chamada quando o valor de button1
alterado. Como o parmetro location no foi especificado, onClick dever estar na mesma
Linha de tempo da instncia do componente. O parmetro component em onClick
automaticamente preenchido com a instncia de um componente (o componente que foi alterado
como resultado de uma entrada do usurio e que especifica onClick como seu identificador de
alterao). As aes definidas em onClick especificam que quando o usurio libera um boto, o
rtulo do boto exibido na janela Sada.
button1.setClickHandler("onClick");
function onClick(component){
trace(component._name);
}

Se, no exemplo acima, onClick fosse uma funo localizada na Linha de tempo bisav da Linha
de tempo do componente, a primeira linha de cdigo seria da seguinte forma:
button1.setChangeHandler("onClick", _parent._parent._parent);

O cdigo a seguir cria a funo onClick em uma instncia de myObject (que da classe Object)
e, a seguir, especifica onClick como a funo de button1.
myObject = new Object();
myObject.onClick = function(component){
trace(component._name);
}
button1.setChangeHandler("onClick", myObject);

FPushButton.setEnabled
Disponibilidade

Flash Player 6.
Uso

myPushButton.setEnabled(enable)
Parmetros

enable

Um valor Booleano que especifica se o boto de ao est ativado (true) ou desativado

(false).
Retorna

Nada.
Descrio

Mtodo; determina se o boto de ao est ativado. Um boto de ao desativado no aceita

interao de mouse nem de teclado do usurio, e o texto sobre ele fica esmaecido. A omisso do
parmetro o mesmo que passar true.
Exemplo

O cdigo a seguir desativa button1.

button1.setEnabled(false);
Consulte tambm

FPushButton.getEnabled

193

FPushButton.setLabel
Disponibilidade

Flash Player 6.
Uso

myPushButton.setLabel(label)
Parmetros

label

Uma seqncia de caracteres que contm o texto a ser exibido no boto de ao.

Retorna

Nada.
Descrio

Mtodo; aplica um rtulo de texto ao boto de ao durante a execuo. Se este mtodo for
chamado, o valor do parmetro label especificado na criao ser cancelado.
Exemplo

O cdigo a seguir aplica o rtulo Cleveland Rocks! a voteButton.

voteButton.setLabel("Cleveland Rocks!");
Consulte tambm

FPushButton.getLabel

FPushButton.setSize
Disponibilidade

Flash Player 6.
Uso

myPushButton.setSize(width, height)
Parmetros

width

Um nmero inteiro que especifica a largura do boto de ao, em pixels.

height

Um nmero inteiro que especifica a altura do boto de ao, em pixels.

Retorna

Nada.
Descrio

Mtodo; define a largura e a altura do boto de ao durante a execuo. Se este mtodo for
chamado, todo dimensionamento aplicado durante o processo de criao ser cancelado. Para
obter mais informaes, consulte Dimensionando componentes PushButtondo captulo
Usando componentes de Usando o Flash.
Exemplo

O cdigo a seguir redimensiona submitButton para 100 x 50 pixels durante a exibio.

submitButton.setSize(100, 50);

Dicionrio ActionScript 194

FPushButton.setStyleProperty
Disponibilidade

Flash Player 6.
Uso

myPushButton.setStyleProperty(styleProperty, value)
Parmetros

styleProperty

Uma seqncia de caracteres que especifica uma propriedade do objeto

FStyleFormat.
value

O valor definido para a propriedade.

Retorna

Nada.
Descrio

Mtodo; define uma propriedade FStyleFormat para um determinado boto de ao. Chamar este
mtodo para especificar uma propriedade cancela as configuraes dessa propriedade no formato
de estilo atribudo ao componente. Se o valor undefined for atribudo a uma propriedade, todos
os estilos dessa propriedade sero removidos.
Para definir as propriedades FStyleFormat para vrios componentes, crie um formato de estilo
personalizado. Para obter mais informaes sobre a criao de formatos de estilo personalizados,
consulte Personalizando cores e texto do componente no captulo Usando componentes de
Usando o Flash.
Exemplo

O cdigo a seguir define a propriedade face do submitButton como 0xffffff (branco).

submitButton.setStyleProperty("face", 0xffffff);
Consulte tambm

FStyleFormat (object)

FRadioButton (component)
Os botes de opo so grupos de botes selecionveis dos quais somente um boto pode ser
selecionado por vez. O componente RadioButton no ambiente de criao Flash oferece recurso de
arrastar e soltar para adicionar grupos de botes de opo a documentos Flash; ele tambm oferece
uma interface de usurio para definio de parmetros bsicos. Os mtodos do componente
FRadioButton permitem controlar botes de opo durante a execuo: voc pode criar botes,
controlar botes de opo criados no ambiente de criao, definir ou cancelar parmetros bsicos
e definir mais opes de tempo de execuo. No preciso usar um construtor para acessar os
mtodos de componentes.
O componente RadioButton tem suporte do Flash Player 6 e de suas verses posteriores.
Os mtodos do componente no realizam verificao de erros de tipo, como outros objetos e
aes nativos do ActionScript; portanto, recomenda-se a validao dos parmetros antes de passlos para mtodos.
Para obter informaes sobre o uso do componente RadioButton, como definir parmetros
durante o processo de criao e como alterar as cores e a aparncia de componentes, consulte
Personalizando cores e texto do componente e Personalizando aparncias de componentes no
captulo Usando componentesde Usando o Flash.

195

Resumo dos mtodos do componente FRadioButton

Mtodo

Descrio

FRadioButton.getData

Retorna um valor de dados para uma instncia do boto de

opo.

FRadioButton.getEnabled

Retorna true se o boto de opo estiver ativado, false se

estiver desativado.

FRadioButton.getLabel

Retorna o rtulo do boto de opo como uma seqncia de

caracteres.

FRadioButton.getState

Retorna o estado selecionado de uma instncia do boto de

opo.

FRadioButton.getValue

Retorna o valor de dados do boto de opo selecionado em um

grupo, ou retorna o rtulo, caso nenhum dado tenha sido
especificado.

FRadioButton.registerSkinElement

Registra um elemento de aparncia em uma propriedade de

estilo.

FRadioButton.setChangeHandler

Especifica uma funo a ser chamada quando a seleo do

boto de opo alterada.

FRadioButton.setData

Define os dados associados a uma instncia do boto de opo.

FRadioButton.setEnabled

Determina se o boto de opo est ativado ou desativado.

FRadioButton.setGroupName

Especifica um nome de grupo para uma instncia de boto de

opo ou define um novo nome para um grupo de botes de
opo.

FRadioButton.setLabel

Aplica um rtulo ao boto de opo durante a execuo.

FRadioButton.setLabelPlacement

Especifica se o rtulo exibido esquerda ou direita do boto

de opo.

FRadioButton.setSize

Define a largura do boto de opo, em pixels.

FRadioButton.setState

Define o estado selecionado da instncia do boto de opo.

FRadioButton.setStyleProperty

Define uma nica propriedade de estilo para uma instncia do

componente.

FRadioButton.setValue

Seleciona um boto de opo em um grupo de botes de opo

durante a execuo.

FRadioButton.getData
Disponibilidade

Flash Player 6.
Uso

myRadioButton.getData()
Parmetros

Nenhum.
Retorna

Uma seqncia de caracteres.

Dicionrio ActionScript 196

Descrio

Mtodo; retorna os dados associados instncia de boto de opo especificada. Use

FRadioButton.getValue para obter os dados associados ao boto de opo selecionado em um
grupo de botes de opo.
Exemplo

O cdigo a seguir retorna os dados associados ao boto de opo flashRadio na janela Sada.
trace(flashRadio.getData());
Consulte tambm

FRadioButton.setData

FRadioButton.getEnabled
Disponibilidade

Flash Player 6.
Uso

myRadioButton.getEnabled()
myRadioButtonGroup.getEnabled()
Parmetros

Nenhum.
Retorna

Um valor Booleano ou undefined.

Descrio

Mtodo; indica se uma instncia de boto de opo ou grupo de botes de opo est ativada(o).
Uso 1: Indica se myRadioButton est ativado (true) ou desativado (false).
Uso 2: Indica se os botes em myRadioButtonGroup esto ativados (true) ou desativados
(false). Se alguns dos botes no grupo estiverem ativados e alguns desativados, o mtodo
retornar undefined.
Exemplo

O cdigo a seguir retorna o estado ativado de radio1 na janela Sada.

trace(radio1.getEnabled());
Consulte tambm

FRadioButton.setEnabled

FRadioButton.getLabel
Disponibilidade

Flash Player 6.
Uso

myRadioButton.getLabel()
Parmetros

Nenhum.

197

Retorna

Uma seqncia de caracteres.

Descrio

Mtodo; retorna o rtulo do boto de opo especificado como uma seqncia de caracteres. No
possvel usar este mtodo para obter rtulos de um grupo de botes de opo; a sintaxe
radioButtonGroup.getLabel no vlida.
Exemplo

O cdigo a seguir retorna o rtulo da instncia radio2 na janela Sada.

trace(radio2.getLabel());
Consulte tambm

FRadioButton.setLabel

FRadioButton.getState
Disponibilidade

Flash Player 6.
Uso

myRadioButton.getState()
Parmetros

Nenhum.
Retorna

Um valor Booleano que indica o estado selecionado do boto de opo.

Descrio

Mtodo; retorna um valor Booleano que indica se myRadioButton est selecionado (true) ou no
(false).
Exemplo

O cdigo a seguir retorna o estado selecionado do boto de opo radio1 na janela Sada.
trace(radio1.getState());
Consulte tambm

FRadioButton.setState

FRadioButton.getValue
Disponibilidade

Flash Player 6.
Uso

myRadioButtonGroup.getValue()
Parmetros

Nenhum.
Retorna

Uma seqncia de caracteres ou undefined.

Dicionrio ActionScript 198

Descrio

Mtodo; retorna os dados associados ao boto de opo selecionado em myRadioButtonGroup,

ou o rtulo do boto de opo, caso nenhum dado tenha sido especificado. Se nenhum boto
tiver sido selecionado, o mtodo retornar undefined.
Exemplo

O cdigo a seguir retorna os dados associados ao boto de opo selecionado no grupo

radioGroup1 na janela Sada.
trace(radioGroup1.getValue());
Consulte tambm

FRadioButton.setValue

FRadioButton.registerSkinElement
Disponibilidade

Flash Player 6.
Uso

myRadioButton.registerSkinElement(element, styleProperty)
Parmetros

element

Uma instncia de clipe de filme.

styleProperty

O nome de uma propriedade de FStyleFormat.

Retorna

Nada.
Descrio

Mtodo; registra um elemento de aparncia em uma propriedade de estilo. Elementos de

aparncia so registrados em propriedades no primeiro quadro da camada ReadMe de cada
aparncia na biblioteca.
Os componentes so compostos de aparncias e cada aparncia composta de vrios elementos de
aparncia, cada um dos quais pode ser registrado em uma propriedade do objeto FStyleFormat.
Essas propriedades so valores atribudos pelo formato de estilo atribudo a um componente.
Como padro, o objeto globalStyleFormat atribudo a todos os componentes de interface do
Flash. Esse objeto uma instncia do objeto FStyleFormat.
Use este mtodo para registrar propriedades e elementos de aparncia personalizados na interface
do Flash ou aparncias personalizadas de componentes editando o cdigo no primeiro quadro da
camada ReadMe de uma aparncia na biblioteca.
O componente FRadioButton usa as aparncias na pasta FPushButton Skins e a aparncia FLabel
na pasta Global Skins depois que voc adiciona o componente ao documento Flash.
Para obter mais informaes, consulte Personalizando aparncias de componentes no captulo
Usando componentesde Usando o Flash.

199

Exemplo

O cdigo a seguir registra o elemento de aparncia personalizado myDot_mc na propriedade

radioDot de FStyleFormat no arquivo ReadMe da aparncia frb_dot localizada na pasta
FRadioButton Skins na biblioteca.
radio1.registerSkinElement(myDot_mc, "radioDot");
Consulte tambm

FStyleFormat (object)

FRadioButton.setChangeHandler
Disponibilidade

Flash Player 6.
Uso

myRadioButton.setChangeHandler(functionName, [location])
myRadioButtonGroup.setChangeHandler(functionName, [location])
Parmetros

Uma seqncia de caracteres que especifica o nome da funo do identificador a

ser executada quando o valor de um boto de opo alterado. Se o parmetro location no for
especificado, esta funo dever estar na mesma Linha de tempo da instncia do componente.

functionName

Uma referncia a um objeto de dados, clipe de filme ou Linha de tempo que contm
a funo especificada. Este parmetro opcional e tem como padro a Linha de tempo pai do
componente.

location

Retorna

Nada.
Descrio

Mtodo; especifica uma funo do identificador de alterao a ser chamada quando a seleo do
boto de opo alterada. Voc pode especificar a mesma funo de identificador de alterao
para mais de um componente; a funo sempre aceita a instncia do componente que foi alterada
como um parmetro. Se este mtodo for chamado, o valor do parmetro Identificador de
alterao especificado na criao ser cancelado.
Uso 1: Especifica a funo a ser chamada se a instncia do boto de opo myRadioButton for
marcada ou desmarcada.
Uso 2: Especifica a funo a ser chamada se o boto de opo selecionado no grupo
radioButtonGroup for alterado. Especificar uma funo para um grupo de botes de opo
equivale a especificar a mesma funo para cada um dos botes de opo nesse grupo
separadamente com myRadioButton.setChangeHandler.
Para obter mais informaes, consulte Criando funes do identificador de alterao para
componentes no captulo Usando componentesde Usando o Flash.
Exemplo

Uso 1: O cdigo a seguir especifica myHandler como a funo chamada quando radio1
selecionado.
radio1.setChangeHandler("myHandler");

Dicionrio ActionScript 200

Uso 2: O cdigo a seguir especifica onChange como a funo chamada quando um boto de
opo no grupo radioGroup1 selecionado.
radioGroup1.setChangeHandler("onChange");

O cdigo a seguir especifica onChange como a funo chamada quando o usurio seleciona um
boto de opo em radioGroup1. Como o parmetro location no foi especificado, onChange
dever estar na mesma Linha de tempo da instncia do componente. O parmetro component em
onChange automaticamente definido com o componente (o componente que foi alterado como
resultado de uma entrada do usurio e que especifica onChange como seu identificador de
alterao) nesse caso, um boto de opo no grupo. As aes definidas em onChange
especificam que quando o usurio seleciona um boto de opo, o nome da instncia exibido na
janela Sada.
radioGroup1.setChangeHandler("onChange");
function onChange(component){
trace(component._name);
}

Se, no exemplo acima, onChange fosse uma funo localizada na Linha de tempo bisav da Linha
de tempo do componente, a primeira linha de cdigo seria da seguinte forma:
radioGroup1.setChangeHandler("onChange", _parent._parent._parent);

O cdigo a seguir cria a funo onChange em uma instncia de myObject (que da classe Object)
e, a seguir, especifica onChange como a funo de radioGroup1.
myObject = new Object();
myObject.onChange = function(component){
trace(component._name);
}
radioGroup1.setChangeHandler("onChange", myObject);

FRadioButton.setData
Disponibilidade

Flash Player 6.
Uso

myRadioButton.setData("data")
Parmetros

data

Os dados a serem associados instncia do boto de opo.

Retorna

Nada.
Descrio

Mtodo; especifica os dados a serem associados instncia do boto de opo. Se este mtodo for
chamado, o valor do parmetro data definido durante o processo de criao ser cancelado.
Exemplo

O cdigo a seguir especifica os dados ActionScript para a instncia do boto de opo

flashRadio.
flashRadio.setData("ActionScript");
Consulte tambm

FRadioButton.getData, FRadioButton.setValue

201

FRadioButton.setEnabled
Disponibilidade

Flash Player 6.
Uso

myRadioButton.setEnabled(enable)
myRadioButtonGroup.setEnabled(enable)
Parmetros

enable Um valor Booleano que especifica se um boto de opo ou todos os botes em um

grupo est(esto) ativado(s) (true) ou desativado(s) (false).
Retorna

Nada.
Descrio

Mtodo; ativa e desativa botes de opo durante a execuo.

Uso 1: Especifica se myRadioButton est ativado (true) ou desativado (false).
Uso 2: Especifica se todos os botes de opo com o nome de grupo radioButtonGroup esto
ativados (true) ou desativados (false). Chamar este mtodo sem passar um parmetro o
mesmo que passar o parmetro true.
Exemplo

Uso 1: O cdigo a seguir desativa somente o boto de opo radio1 sem desativar os outros
botes no grupo.
radio1.setEnabled(false);

Uso 2: O cdigo a seguir desativa todos os botes de opo no grupo radioGroup1.

radioGroup1.setEnabled(false);
Consulte tambm

FRadioButton.getEnabled

FRadioButton.setGroupName
Disponibilidade

Flash Player 6.
Uso

myRadioButton.setGroupName(groupName)
myRadioButtonGroup.setGroupName(groupName)
Parmetros

groupName

Uma seqncia de caracteres que especifica o nome de um grupo de botes de opo.

Retorna

Nada.

Dicionrio ActionScript 202

Descrio

Mtodo; aplica um nome de grupo a uma instncia de boto de opo ou grupo de botes de
opo durante a execuo. Se este mtodo for chamado, o valor do parmetro Group Name
definido durante o processo de criao ser cancelado.
Uso 1: Especifica myRadioButton como integrante do grupo de botes de opo groupName.
Uso 2: Especifica um novo nome de grupo para todos os botes de opo em
myRadioButtonGroup.
Exemplo

Uso 1: O cdigo a seguir especifica Colors como o nome do grupo para a instncia de boto de
opo radioRed.
radioRed.setGroupName("Colors");

Uso2: O cdigo a seguir especifica radioGroupToys como o novo nome de grupo para todos os
botes de opo em radioGroupGames.
radioGroupGames.setGroupName("radioGroupToys");

FRadioButton.setLabel
Disponibilidade

Flash Player 6.
Uso

myRadioButton.setLabel(label)
Parmetros

label

Uma seqncia de caracteres de texto que especifica o rtulo exibido direita do boto de

opo.
Retorna

Nada.
Descrio

Mtodo; aplica um rtulo instncia de boto de opo myRadioButton durante a execuo. Se

este mtodo for chamado, o valor do parmetro label especificado na criao ser cancelado.
No possvel usar este mtodo para definir rtulos para grupos de botes de opo; a sintaxe
radioButtonGroup.getLabel no vlida.
Exemplo

O cdigo a seguir aplica o rtulo Olhos castanhos a radio1.

radio1.setLabel("Olhos castanhos");
Consulte tambm

FRadioButton.getLabel

203

FRadioButton.setLabelPlacement
Disponibilidade

Flash Player 6.
Uso

myRadioButton.setLabelPlacement(labelPosition)
myRadioButtonGroup.setLabelPlacement(labelPosition)
Parmetros

labelPosition

Uma seqncia de caracteres de texto; especifica "left" ou "right".

Descrio

Mtodo; especifica se o rtulo exibido esquerda ou direita do boto de opo. Se este mtodo
for chamado, o valor do parmetro Label Placement definido durante o processo de criao ser
cancelado.
Uso 1: especifica o posicionamento do rtulo de um nico boto de opo.
Uso 2: especifica o posicionamento dos rtulos de todos os botes de opo em um grupo.
Exemplo

Uso 1: O cdigo a seguir posiciona o rtulo de radio1 esquerda do boto de opo.

radio1.setLabelPlacement("left");

Uso 2: O cdigo a seguir posiciona os rtulos dos botes de opo no grupo Colors direita dos
botes.
Colors.setLabelPlacement("right");
Consulte tambm

FRadioButton.setLabel, FRadioButton.setLabelPlacement

FRadioButton.setSize
Disponibilidade

Flash Player 6.
Uso

myRadioButton.setSize(width)
myRadioButtonGroup.setSize(width)
Parmetros

width

Um nmero inteiro que especifica o tamanho do boto de opo, em pixels.

Retorna

Nada.
Descrio

Mtodo; especifica a largura do boto de opo, em pixels, e redesenha o boto de opo. (No
possvel definir a altura de componentes do boto de opo.) Se este mtodo for chamado, o
dimensionamento de largura aplicado durante o processo de criao ser cancelado.
Uso 1: Define o tamanho de um boto de opo.

Dicionrio ActionScript 204

Uso 2: Define o tamanho de todos os botes de opo em um grupo.

Para obter mais informaes, consulte Dimensionando componentes RadioButton no captulo
Usando componentesde Usando o Flash.
Exemplo

O cdigo a seguir define a largura de radio1 como sendo 200 pixels.

radio1.setSize(200);

FRadioButton.setState
Disponibilidade

Flash Player 6.
Uso

myRadioButton.setState("select")
Parmetros

select
(false).

Um valor Booleano que indica se o boto de opo est selecionado (true) ou no

Retorna

Nada.
Descrio

Mtodo: especifica se myRadioButton est selecionado (true) ou no (false). Somente um

boto de opo em um grupo (todos tendo o mesmo parmetro Nome do grupo) pode ter um
estado inicial de true (selecionado). Se mais de um boto de opo tiver true especificado para
este parmetro, o ltimo boto de opo com um parmetro de estado inicial true ser
selecionado. O valor padro para este parmetro false.
Se este mtodo for chamado, o valor do parmetro Initial State definido durante o processo de
criao ser cancelado. Se voc chamar este mtodo e tambm chamar FRadioButton.setValue
para selecionar um boto de opo durante a execuo, e os botes de opo forem botes
diferentes no mesmo grupo, o boto de opo especificado no ltimo mtodo chamado ser
selecionado.
Exemplo

O cdigo a seguir seleciona o boto de opo radio1 durante a execuo.

radio1.setState(true));
Consulte tambm

FRadioButton.getState, FRadioButton.getValue, FRadioButton.setValue

205

FRadioButton.setStyleProperty
Disponibilidade

Flash Player 6.
Uso

myRadioButton.setStyleProperty(styleProperty, value)
myRadioButtonGroup.setStyleProperty(styleProperty, value)
Parmetros

styleProperty

Uma seqncia de caracteres que especifica uma propriedade do objeto

FStyleFormat.
value

O valor definido para a propriedade.

Retorna

Nada.
Descrio

Mtodo; define uma propriedade FStyleFormat para um determinado boto de opo. Chamar
este mtodo para especificar uma propriedade cancela as configuraes dessa propriedade no
formato de estilo atribudo ao componente. Se o valor undefined for atribudo a uma
propriedade, todos os estilos dessa propriedade sero removidos.
Para definir as propriedades FStyleFormat para vrios componentes, crie um formato de estilo
personalizado. Para obter mais informaes sobre a criao de formatos de estilo, consulte
Personalizando cores e texto de componentes no captulo Usando componentes de Usando o
Flash.
Exemplo

O cdigo a seguir define a propriedade radioDot para radioButton1 como 0xFF12AC (rosa).
radioButton1.setStyleProperty("radioDot", 0xFF12AC);

O cdigo a seguir define a propriedade radioDot para todos os botes em radioGroup1 como
0xFF12AC (rosa).
radioGroup1.setStyleProperty("radioDot", 0xFF12AC);
Consulte tambm

FStyleFormat (object)

FRadioButton.setValue
Disponibilidade

Flash Player 6.
Uso

myRadioButtonGroup.setValue("data")
Parmetros

data

Os dados associados ao boto de opo a ser selecionado.

Retorna

Nada.

Dicionrio ActionScript 206

Descrio

Mtodo; marca o boto de opo associado aos dados especificados e desmarca os botes
eventualmente selecionados no mesmo grupo.
Se este mtodo for chamado, o valor do parmetro Initial Value definido durante o processo de
criao ser cancelado. Se voc chamar este mtodo e tambm chamar FRadioButton.setState para
selecionar um boto de opo durante a execuo, e os botes de opo forem botes diferentes
no mesmo grupo, o boto de opo especificado no ltimo mtodo chamado ser selecionado.
Exemplo

O cdigo a seguir seleciona o boto de opo com o dado associado red no grupo de botes de
opo denominado Colors.
Colors.setValue("red");
Consulte tambm

FRadioButton.getData, FRadioButton.getValue, FRadioButton.setState

FScrollBar (component)
O componente ScrollBar no ambiente de criao Flash oferece recurso de arrastar e soltar para
adicionar barras de rolagem a campos de texto dinmicos e de entrada em documentos Flash; ele
tambm oferece uma interface de usurio para definio de parmetros bsicos. Os mtodos do
componente FScrollBar permitem controlar barras de rolagem durante a execuo: voc pode
criar barras de rolagem, controlar barras de rolagem criadas no ambiente de criao, definir ou
cancelar parmetros bsicos e definir opes adicionais de tempo de execuo. No preciso usar
um construtor para acessar os mtodos de componentes. Alguns dos mtodos do componente
FScrollBar no so recomendados para uso com barras de rolagem anexadas a campos de texto.
Consulte as entradas individuais dos mtodos para obter detalhes.
Usurios e programadores avanados podem usar o componente ScrollBar com outros elementos
do Flash para criar interfaces de usurio personalizadas.
Os mtodos do componente no realizam verificao de erros de tipo, como outros objetos e
aes nativos do ActionScript; portanto, recomenda-se a validao dos parmetros antes de passlos para mtodos.
O componente ScrollBar tem suporte do Flash Player 6 e de suas verses posteriores.
Para obter informaes sobre o uso do componente ScrollBar, como definir parmetros durante o
processo de criao e como alterar as cores e a aparncia de componentes, consulte
Personalizando cores e texto do componente e Personalizando aparncias de componentes no
captulo Usando componentes de Usando o Flash.
Resumo dos mtodos do componente FScrollBar.

207

Mtodo

Descrio

FScrollBar.getEnabled

Retorna true se a barra de rolagem estiver ativada, false se

estiver desativada.

FScrollBar.getScrollPosition

Retorna um nmero inteiro que representa a posio atual da

caixa de rolagem (direcionador).

FScrollBar.registerSkinElement

Registra um elemento de aparncia em uma propriedade

definida para uma aparncia no ReadMe localizado no Quadro 1
de um clipe de filme de aparncia na biblioteca.

Mtodo

Descrio

FScrollBar.setChangeHandler

Especifica uma funo a ser chamada todas as vezes que a

posio de rolagem for alterada. (Este mtodo no pode ser
usado com campos de texto.)

FScrollBar.setEnabled

Especifica se a barra de rolagem est ativada (true) ou

desativada (false).

FScrollBar.setHorizontal

Especifica se a barra de rolagem horizontal (true) ou vertical

(false).

FScrollBar.setLargeScroll

Especifica o nmero de posies roladas quando o usurio clica

na trilha.

FScrollBar.setScrollContent

Especifica a instncia de campo de texto qual a barra de

rolagem se aplica.

FScrollBar.setScrollPosition

Define a posio da caixa de rolagem como um nmero inteiro

entre minPos e maxPos.

FScrollBar.setScrollProperties

Define as propriedades pageSize, minPos e maxPos da barra de

rolagem. (Este mtodo no pode ser usado com campos de
texto.)

FScrollBar.setScrollTarget

Especifica um campo de texto como o destino da barra de

rolagem.

FScrollBar.setSize

Define o comprimento da barra de rolagem, em pixels.

FScrollBar.setSmallScroll

Especifica o nmero de posies roladas quando o usurio clica

na seta de rolagem.

FScrollBar.setStyleProperty

Define uma nica propriedade de estilo para um componente.

FScrollBar.getEnabled
Disponibilidade

Flash Player 6.
Uso

myScrollBar.getEnabled()
Parmetros

Nenhum.
Retorna

Um valor booleano.
Descrio

Mtodo; indica se a barra de rolagem est ativada (true) ou desativada (false).

Exemplo

O cdigo a seguir retorna um valor na janela Sada que indica se scroll1 est ativada (true) ou
desativada (false).
trace(scroll1.getEnabled());
Consulte tambm

FScrollBar.setEnabled

Dicionrio ActionScript 208

FScrollBar.getScrollPosition
Disponibilidade

Flash Player 6.
Uso

myScrollBar.getScrollPosition()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna um nmero inteiro que especifica a posio da caixa de rolagem (direcionador).
O valor apresentado na faixa definida pelas propriedades minPos e maxPos que determina os
limites de rolagem da barra de rolagem. Para determinar os parmetros minPos e maxPos, use
FScrollBar.setScrollProperties.
Exemplo

O cdigo a seguir retorna a posio atual da caixa de rolagem da barra de rolagem scroll2 na
janela Sada. Se a configurao de scroll2 em minPos for 2 e em maxPos for 25, um valor de
retorno equivalente a 12 indicar que a caixa de rolagem est no meio da barra de rolagem.
trace(scroll2.getPosition());

Consulte FScrollBar.setChangeHandler para obter outro exemplo que utilize este mtodo.
Consulte tambm

FScrollBar.setChangeHandler, FScrollBar.setScrollPosition

FScrollBar.registerSkinElement
Disponibilidade

Flash Player 6.
Uso

myScrollBar.registerSkinElement(element, styleProperty)
Parmetros

element

Uma instncia de clipe de filme.

styleProperty

Uma seqncia de caracteres que especifica uma propriedade FStyleFormat.

Retorna

Nada.
Descrio

Mtodo; registra um elemento de aparncia em uma propriedade de estilo. Elementos de

aparncia so registrados em propriedades no primeiro quadro da camada ReadMe de cada
aparncia na biblioteca.

209

Os componentes so compostos de aparncias e cada aparncia composta de vrios elementos de

aparncia, cada um dos quais pode ser registrado em uma propriedade do objeto FStyleFormat.
Essas propriedades so valores atribudos pelo formato de estilo atribudo a um componente.
Como padro, o objeto globalStyleFormat atribudo a todos os componentes de interface do
Flash. Esse objeto uma instncia do objeto FStyleFormat.
Use este mtodo para registrar propriedades e elementos de aparncia personalizados na interface
do Flash ou aparncias personalizadas de componentes editando o cdigo no primeiro quadro da
camada ReadMe de uma aparncia na biblioteca.
O componente FScrollBar usa as aparncias na pasta FRadioButton Skins e a aparncia FLabel na
pasta Global Skins depois que voc adiciona o componente ao documento Flash. A edio de
qualquer aparncia na pasta FScrollBar Skins afeta todos os componentes que usam barras de
rolagem (ComboBox, ListBox, ScrollBar e ScrollPane).
Para obter mais informaes, consulte Personalizando aparncias de componentes no captulo
Usando componentes de Usando o Flash.
Exemplo

O cdigo a seguir registra o elemento de aparncia personalizado NewArrow_mc na propriedade

arrow no primeiro quadro da camada ReadMe da aparncia fsb_downArrow na pasta FScrollBar
Skins na biblioteca.
Scroll1.registerSkinElement(NewArrow_mc, "arrow");
Consulte tambm

FStyleFormat (object)

FScrollBar.setChangeHandler
Disponibilidade

Flash Player 6.
Uso

myScrollBar.setChangeHandler(functionName, [location])
Parmetros

Uma seqncia de caracteres que especifica o nome da funo do identificador a

ser executada quando o usurio move a caixa se rolagem. Se o parmetro location no for
especificado, esta funo dever estar na mesma Linha de tempo da instncia do componente.
functionName

Uma referncia de caminho at um objeto de dados, clipe de filme ou Linha de

tempo que contm a funo especificada. Este parmetro opcional e tem como padro a Linha
de tempo pai do componente.

location

Retorna

Nada.
Descrio

Mtodo; especifica um identificador de alterao a ser chamado quando o usurio move a caixa de
rolagem (direcionador) da barra de rolagem. Voc pode especificar a mesma funo de
identificador de alterao para mais de um componente; a funo sempre aceita a instncia do
componente que foi alterada como um parmetro. Se este mtodo for chamado, valor do
parmetro Identificador de alterao especificado na criao ser cancelado.

Dicionrio ActionScript 210

Este mtodo para usurios e programadores avanados que criam aplicativos e componentes
personalizados usando o componente Flash UI ScrollBar; o mtodo no pode ser usado com
barras de rolagem anexadas a campos de texto.
Exemplo

O cdigo a seguir cria uma caixa preenchida no Palco, aplica uma barra de rolagem horizontal,
define as propriedades de rolagem e especifica a funo mover como o identificador de alterao.
O identificador de alterao mover usa a posio de rolagem da barra de rolagem para alterar a
posio _x do clipe de filme entre 50 e 250.
root.createEmptyMovieClip("quadrado", 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();
}

O cdigo a seguir especifica uma funo de identificador de alterao para uma instncia do
componente de barra de rolagem anexado a um componente de caixa de listagem personalizada.
O identificador de alterao define scroll1 para obter a posio de rolagem atual usando
FScrollBar.getScrollPosition e, a seguir, customListBox usa
FScrollBar.setScrollPosition para redefinir a posio de rolagem de forma que o item na
posio de rolagem atual seja exibido no topo da exibio da caixa de listagem personalizada. O
parmetro component automaticamente preenchido com a instncia de um componente (o
componente que foi alterado como resultado de uma entrada do usurio e que especifica
myHandler como seu identificador de alterao).
rolagem1.setChangeHandler("myHandler");
function myHandler(component)
{
customListBox.setScrollPosition(component.getScrollPosition());
}

Se, no exemplo acima, myHandler fosse uma funo localizada na Linha de tempo bisav da
Linha de tempo do componente, a primeira linha de cdigo seria da seguinte forma:
scroll1.setChangeHandler("myHandler", _parent._parent._parent);

211

O cdigo a seguir cria a funo myHandler em uma instncia de myObject (que da classe
Object) e, a seguir, especifica myHandler como a funo de scroll1.
myObject = new Object();
myObject.myHandler = function(component){
customListBox.setScrollPosition(component.getScrollPosition());
}
scroll1.setChangeHandler("myHandler", myObject);
Consulte tambm

FScrollBar.getScrollPosition, FScrollBar.setScrollPosition,
FScrollBar.setScrollProperties

FScrollBar.setEnabled
Disponibilidade

Flash Player 6.
Uso

myScrollBar.setEnabled(enable)
Parmetros

Um valor Booleano que especifica se a barra de rolagem est ativada (true) ou

desativada (false).

enable

Retorna

Nada.
Descrio

Mtodo; determina se a barra de rolagem est ativada (true) ou desativada (false). Se uma barra
de rolagem estiver desativada, ela no aceitar interao de mouse nem de teclado do usurio, e
ficar esmaecida (indisponvel). Chamar este mtodo sem passar um parmetro o mesmo que
passar o parmetro true.
Exemplo

O cdigo a seguir desativa a barra de rolagem scroll2.

scroll2.setEnabled(false);
Consulte tambm

FScrollBar.getEnabled

FScrollBar.setHorizontal
Disponibilidade

Flash Player 6.
Uso

myScrollBar.setHorizontal(horizontalScroll)
Parmetros

horizontalScroll Um valor
(true) ou vertical (false).

Booleano que especifica se a barra de rolagem ser horizontal

Dicionrio ActionScript 212

Retorna

Nada.
Descrio

Mtodo; especifica se a barra de rolagem aplicada ao destino horizontalmente (true) ou

verticalmente (false). O padro deste mtodo false.
Exemplo

O cdigo a seguir especifica que a barra de rolagem scrollText seja aplicada horizontalmente no
destino.
scrollText.setHorizontal(true);
Consulte tambm

FScrollBar.setSize

FScrollBar.setLargeScroll
Disponibilidade

Flash Player 6.
Uso

myScrollBar.setLargeScroll(largeScroll)
Parmetros

Um nmero inteiro que especifica o nmero de posies a serem roladas quando

o usurio clica uma vez na trilha. O valor padro o valor definido para pageSize com
FScrollBar.setScrollProperties.
largeScroll

Retorna

Nada.
Descrio

Mtodo; define a propriedade largeScroll da instncia da barra de rolagem durante a execuo.

Quando o usurio clica uma vez na trilha de rolagem, a caixa de rolagem (direcionador) movida
na distncia especificada em uma posio de largeScroll.
Exemplo

O cdigo a seguir define que quando o usurio clica na trilha, scrollText1 rolado 20 posies.
scrollText1.setLargeScroll(20);
Consulte tambm

FScrollBar.setSmallScroll

FScrollBar.setScrollContent
Disponibilidade

Flash Player 6.
Uso

myScrollBar.setScrollContent(target)
Parmetros

target

213

Uma referncia ao campo de texto da barra de rolagem.

Retorna

Nada.
Descrio

Mtodo; especifica a instncia de campo de texto qual a barra de rolagem se aplica. A instncia
deve ser definida na mesma Linha de tempo e no mesmo nvel da barra de rolagem. Se este
mtodo for chamado, o valor do parmetro Target Text Field definido durante o processo de
criao ser cancelado. Se o valor undefined for passado para o parmetro target, a barra de
rolagem ser dissociada do campo de texto.
Exemplo

O cdigo a seguir anexa scrollText1 ao campo de texto com o nome de instncia textField1.
scrollText1.setScrollContent("textField1");

FScrollBar.setScrollPosition
Disponibilidade

Flash Player 6.
Uso

myScrollBar.setScrollPosition(position)
Parmetros

position Um nmero inteiro entre as configuraes de minPos e maxPos da barra de rolagem.

Consulte FScrollBar.setScrollProperties para obter mais informaes sobre como
configurar as propriedades minPos e maxPos.
Retorna

Nada.
Descrio

Mtodo; especifica a posio da caixa de rolagem (direcionador) na barra de rolagem e executa a

funo especificada comFScrollBar.setChangeHandler.
Exemplo

O cdigo a seguir define a posio da barra de rolagem para scrollText1 como 5.

scrollText1.setScrollPosition(5);

Consulte FScrollBar.setChangeHandler para obter outro exemplo que utilize este mtodo.
Consulte tambm

FScrollBar.setChangeHandler, FScrollBar.setScrollProperties

Dicionrio ActionScript 214

FScrollBar.setScrollProperties
Disponibilidade

Flash Player 6.
Uso

myScrollBar.setScrollProperties(pageSize, minPos, maxPos)

Parmetros

pageSize

Um nmero inteiro que representa o nmero de posies exibidas na pgina.

minPos

Um nmero inteiro que representa a posio de rolagem mnima.

maxPos

Um nmero inteiro que representa a posio de rolagem mxima.

Retorna

Nada.
Descrio

Mtodo; especifica as propriedades pageSize, minPos e maxPos da barra de rolagem e define a

caixa de rolagem (direcionador) da barra de rolagem no tamanho adequado.
Este mtodo para usurios e programadores avanados que criam componentes personalizados;
o mtodo no pode ser usado com barras de rolagem anexadas a campos de texto. Quando uma
barra de rolagem anexada a um campo de texto, as propriedades de rolagem so
automaticamente definidas de acordo com as propriedades do campo de texto e a execuo desse
mtodo quebra a barra de rolagem do campo de texto.
Exemplo

O cdigo a seguir define as propriedades pageSize, minPos e maxPos de uma barra de rolagem
anexada a um componente de caixa de listagem personalizada. A caixa de listagem tem 5 linhas
visveis e um total de 20 itens na lista. Como a caixa indexada de 0 a 19, a propriedade maxPos
ser igual ao nmero total de itens na caixa menos o nmero de itens visveis.
scrollBar.setScrollProperties(5, 0, 15);
Consulte tambm

FScrollBar.setScrollPosition

FScrollBar.setScrollTarget
Disponibilidade

Flash Player 6.
Uso

myScrollBar.setScrollTarget(target)
Parmetros

target
Retorna

Nada.

215

Uma referncia ao campo de texto da barra de rolagem.

Descrio

Mtodo; especifica a instncia de campo de texto qual a barra de rolagem se aplica. A instncia
deve ser definida na mesma Linha de tempo e no mesmo nvel da barra de rolagem. Se este
mtodo for chamado, o valor do parmetro Target Text Field definido durante o processo de
criao ser cancelado. Se o valor undefined for passado para o parmetro target, a barra de
rolagem ser dissociada do campo de texto.
Exemplo

O cdigo a seguir anexa scrollText1 ao campo de texto com o nome de instncia textField1.
scrollText1.setScrollTarget("textField1");

FScrollBar.setSize
Disponibilidade

Flash Player 6.
Uso

myScrollBar.setSize(length)
Parmetros

length

Um nmero inteiro que especifica o comprimento da barra de rolagem, em pixels.

Retorna

Nada.
Descrio

Mtodo; define o comprimento, em pixels, da barra de rolagem durante a execuo. (No

possvel definir a largura dos componentes da barra de rolagem.) Se este mtodo for chamado,
qualquer dimensionamento aplicado durante o processo de criao ser cancelado.
Este mtodo no deve ser usado com barras de rolagem anexadas a campos de texto; a barra de
rolagem automaticamente se ajusta ao tamanho do campo de texto durante o processo de criao.
Para obter mais informaes, consulte Dimensionando componentes do ScrollBar no captulo
Usando componentes de Usando o Flash.
Exemplo

O cdigo a seguir define o comprimento de scrollText1 como sendo 200 pixels.

scrollText1.setSize(200);

FScrollBar.setSmallScroll
Disponibilidade

Flash Player 6.
Uso

myScrollBar.setSmallScroll(smallScroll)
Parmetros

Um nmero inteiro que especifica o nmero de posies a serem roladas quando

o usurio clica em uma seta de rolagem. O valor padro 1.

smallScroll

Dicionrio ActionScript 216

Retorna

Nada.
Descrio

Mtodo; define a propriedade smallScroll da instncia da barra de rolagem durante a execuo,

se o campo de texto tiver o foco. Quando o usurio clica nas setas da barra de rolagem ou em uma
tecla de seta do teclado, a caixa de rolagem (direcionador) se move na distncia especificada por
uma posio de smallScroll.
Exemplo

O cdigo a seguir especifica que quando o usurio clica em uma seta de rolagem, scrollText1
rolado 5 posies.
scrollText1.setSmallScroll(5);
Consulte tambm

FScrollBar.setLargeScroll

FScrollBar.setStyleProperty
Disponibilidade

Flash Player 6.
Uso

myScrollBar.setStyleProperty(styleProperty, value)
Parmetros

styleProperty

Uma seqncia de caracteres que especifica uma propriedade do objeto

FStyleFormat.
value

O valor definido para a propriedade.

Retorna

Nada.
Descrio

Mtodo; define uma propriedade FStyleFormat para uma determinada barra de rolagem. Chamar
este mtodo para especificar uma propriedade cancela as configuraes dessa propriedade no
formato de estilo atribudo ao componente. Se o valor undefined for atribudo a uma
propriedade, todos os estilos dessa propriedade sero removidos.
Para definir as propriedades FStyleFormat para vrios componentes, crie um formato de estilo
personalizado. Para obter mais informaes sobre a criao de formatos de estilo personalizados,
consulte Personalizando cores e texto do componente no captulo Usando componentes de
Usando o Flash.
Exemplo

O cdigo a seguir define a propriedade arrow da scrollBar1 como 0x000000 (preto).

scrollBar1.setStyleProperty("arrow", 0x000000);
Consulte tambm

FStyleFormat (object)

217

FScrollPane (component)
O componente ScrollPane no ambiente de criao Flash oferece recurso de arrastar e soltar para
adicionar painis de rolagem para exibio de clipes de filmes em documentos Flash; ele tambm
oferece uma interface de usurio para definio de parmetros bsicos. Os mtodos do
componente FScrollPane permitem controlar painis de rolagem durante a execuo: voc pode
criar painis de rolagem, controlar painis de rolagem criados no ambiente de criao, definir ou
cancelar parmetros bsicos e definir opes adicionais de tempo de execuo. No preciso usar
um construtor para acessar os mtodos de componentes.
O componente ScrollPane oferece barras de rolagem verticais e horizontais que permitem exibir
clipes de filmes grandes sem ocupar muito espao do Palco. Controles padro de mouse e teclado
so incorporados.
Observao: O componente ScrollPane s exibe clipes de filmes; para adicionar barras de rolagem a campos de
texto dinmicos e de entrada, use o componente ScrollBar. O componente ScrollPane no pode exibir nenhum
contedo que utilize fontes de dispositivo.

Os mtodos do componente no realizam verificao de erros de tipo, como outros objetos e

aes nativos do ActionScript; portanto, recomenda-se a validao dos parmetros antes de passlos para mtodos.
O componente ScrollPane tem suporte do Flash Player 6 e de suas verses posteriores.
Para obter informaes sobre o uso do componente ScrollPane, como definir parmetros durante
o processo de criao e como alterar as cores e a aparncia de componentes, consulte
Personalizando cores e texto do componente e Personalizando aparncias de componentes no
captulo Usando componentes de Usando o Flash.
Resumo dos mtodos do componente FScrollPane.
Mtodo

Descrio

FScrollPane.getPaneHeight

Retorna a altura do painel de rolagem.

FScrollPane.getPaneWidth

Retorna a largura do painel de rolagem.

FScrollPane.getScrollContent

Retorna uma instncia do contedo exibido no painel de

rolagem.

FScrollPane.getScrollPosition

Retorna as coordenadas x e y da posio de rolagem atual.

FScrollPane.loadScrollContent

Carrega um SWF ou JPEG no painel de rolagem.

FScrollPane.refreshPane

Redimensiona as barras de rolagem no painel de rolagem

quando o contedo muda de tamanho.

FScrollPane.registerSkinElement

Registra um elemento de aparncia em uma propriedade

definida para uma aparncia na camada ReadMe localizada
no Quadro 1 de um clipe de filme de aparncia na biblioteca.

FScrollPane.setDragContent

Define o contedo do painel de rolagem como arrastvel.

FScrollPane.setHScroll

Define o estilo de rolagem horizontal do painel de rolagem.

FScrollPane.setScrollContent

Define um clipe de filme como destino do painel de rolagem.

FScrollPane.setScrollPosition

Faz o painel rolar at as coordenadas x, y especificadas.

FScrollPane.setSize

Define a largura e a altura do painel de rolagem, em pixels.

FScrollPane.setStyleProperty

Define uma nica propriedade de estilo para um

componente.

FScrollPane.setVScroll

Define o estilo de rolagem vertical do painel de rolagem.

Dicionrio ActionScript 218

FScrollPane.getPaneHeight
Disponibilidade

Flash Player 6.
Uso

myScrollPane.getPaneHeight()
Parmetros

Nenhum.
Retorna

Um nmero inteiro que especifica a altura da exibio do painel de rolagem.

Descrio

Mtodo; retorna a altura da exibio do painel de rolagem. Voc s pode usar este mtodo para
obter a altura de um painel de rolagem que foi dimensionado com FScrollPane.setSize. Este
mtodo s funciona se o painel de rolagem tiver sido dimensionado com FScrollPane.setSize.
Ele no funciona se voc tiver definido o tamanho atravs das propriedades _width e _height.
Exemplo

O cdigo a seguir obtm a altura e a largura do painel de rolagem display1 e usa os valores
apresentados para redimensionar o painel de rolagem com FScrollPane.setSize.
var h = display1.getPaneHeight();
var w = display1.getPaneWidth();
display1.setSize(w+10, h+10);
Consulte tambm

FScrollPane.getPaneWidth, FScrollPane.setSize

FScrollPane.getPaneWidth
Disponibilidade

Flash Player 6.
Uso

myScrollPane.getPaneWidth()
Parmetros

Nenhum.
Retorna

Um nmero inteiro que especifica a largura da exibio do painel de rolagem.

Descrio

Mtodo; retorna a largura da exibio do painel de rolagem. Voc s pode usar este mtodo para
obter a largura de um painel de rolagem que foi dimensionado com FScrollPane.setSize. Este
mtodo s funciona se o painel de rolagem tiver sido dimensionado com FScrollPane.setSize.
Ele no funciona se voc tiver definido o tamanho atravs das propriedades _width e _height.

219

Exemplo

O cdigo a seguir obtm a altura e a largura do painel de rolagem display1 e usa os valores
apresentados para redimensionar o painel de rolagem com FScrollPane.setSize.
var h = display1.getPaneHeight();
var w = display1.getPaneWidth();
display1.setSize(w+10, h+10);
Consulte tambm

FScrollPane.getPaneHeight, FScrollPane.setSize

FScrollPane.getScrollContent
Disponibilidade

Flash Player 6.
Uso

myScrollPane.getScrollContent()
Parmetros

Nenhum.
Retorna

Uma referncia ao clipe de filme no painel de rolagem.

Descrio

Mtodo; retorna uma instncia do contedo exibido no painel de rolagem.

Exemplo

O cdigo a seguir recupera uma referncia ao clipe de filme dentro de display1, armazena-a em
uma varivel e, a seguir, faz o clipe de filme ir para o quadro 4.
var content = display1.getScrollContent();
content.gotoAndStop(4);
Consulte tambm

FScrollPane.setScrollContent

FScrollPane.getScrollPosition
Disponibilidade

Flash Player 6.
Uso

myScrollPane.getScrollPosition()
Parmetros

Nenhum.
Retorna

Um objeto.
Descrio

Mtodo; retorna um objeto com os campos .x ou .y especificando a posio de rolagem vertical

ou horizontal atual da exibio do painel de rolagem.

Dicionrio ActionScript 220

Exemplo

O cdigo a seguir retorna a posio de rolagem atual do painel de rolagem scroll2 na janela
Sada.
trace(scroll2.getScrollPosition());
Consulte tambm

FScrollPane.setScrollPosition

FScrollPane.loadScrollContent
Disponibilidade

Flash Player 6.
Uso

myScrollPane.loadScrollContent(URL [, functionName, location])

Parmetros

Uma seqncia de caracteres que especifica o URL de um arquivo SWF ou JPEG a ser
carregado no painel de rolagem.

URL

Uma seqncia de caracteres que especifica o nome da funo do identificador a

ser executada quando o contedo do painel de rolagem carregado. Se o parmetro location no
for especificado, esta funo dever estar na mesma Linha de tempo da instncia do componente.
functionName

Uma referncia de caminho at um objeto de dados, clipe de filme ou Linha de

tempo que contm a funo especificada. Este parmetro opcional e tem como padro a Linha
de tempo pai do componente.

location

Retorna

Nada.
Descrio

Mtodo; especifica o URL de um arquivo SWF ou JPEG a ser exibido no painel de rolagem. Os
parmetros opcionais functName e location permitem especificar uma funo de identificador
de alterao a ser chamada quando o contedo carregado.
O URL deve estar no mesmo subdomnio que o URL onde o filme Flash reside no momento.
Para usar arquivos SWF ou JPEG no Flash Player ou testar o filme no ambiente de criao Flash,
voc deve armazenar todos os arquivos SWF ou JPEG na mesma pasta, e os nomes dos arquivos
no podem conter especificaes de pasta nem de unidade de disco.
Se este mtodo for chamado, o valor do parmetro Scroll Content definido durante o processo de
criao ser cancelado.
Consulte FScrollBar.setChangeHandler para obter mais informaes e exemplos de como usar
funes do identificador de alterao.
Exemplo

O cdigo a seguir carrega em display1 um JPEG localizado em um servidor.

display1.loadScrollContent("http://www.YourWebServer.com/Nice.jpg");

221

O cdigo a seguir carrega um JPEG localizado em um servidor e especifica a funo do

identificador de alterao load localizada na Linha de tempo av do componente display1.
display1.loadScrollContent("http://www.YourWebServer.com/Nice.jpg" , "load" ,
_parent._parent);
function load(component){
//contedo est carregado
component.setScrollPostion(10,10);
}
Consulte tambm

FScrollPane.getPaneHeight, FScrollPane.setScrollContent

FScrollPane.refreshPane
Disponibilidade

Flash Player 6.
Uso

myScrollPane.refreshPane()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; redimensiona as barras de rolagem do painel de rolagem quando o contedo dentro do

painel de rolagem alterado. Chame este mtodo se voc redimensionar o contedo na janela do
painel de rolagem usando _width ou _height.
Exemplo

O cdigo a seguir atualiza as barras de rolagem de moviePane depois de aumentar o tamanho do

clipe de filme myContent no painel de rolagem.
var myContent = moviePane.getScrollContent();
myContent._width = 400;
moviePane.refreshPane();
Consulte tambm

FScrollPane.getScrollContent

FScrollPane.registerSkinElement
Disponibilidade

Flash Player 6.
Uso

myScrollPane.registerSkinElement(element, styleProperty)
Parmetros

element

Uma instncia de clipe de filme.

styleProperty

O nome de uma propriedade de FStyleFormat.

Dicionrio ActionScript 222

Retorna

Nada.
Descrio

Mtodo; registra um elemento de aparncia em uma propriedade de estilo. Elementos de

aparncia so registrados em propriedades no primeiro quadro da camada ReadMe de cada
aparncia na biblioteca.
Os componentes so compostos de aparncias e cada aparncia composta de vrios elementos de
aparncia, cada um dos quais pode ser registrado em uma propriedade do objeto FStyleFormat.
Essas propriedades so valores atribudos pelo formato de estilo atribudo a um componente.
Como padro, o objeto globalStyleFormat atribudo a todos os componentes de interface do
Flash. Esse objeto uma instncia do objeto FStyleFormat.
Use este mtodo para registrar propriedades e elementos de aparncia personalizados na interface
do Flash ou aparncias personalizadas de componentes editando o cdigo no primeiro quadro da
camada ReadMe de uma aparncia na biblioteca.
O componente FScrollPane usa as aparncias na pasta FScrollBar Skins e a aparncia FLabel na
pasta Global Skins depois que voc adiciona o componente ao documento Flash. A edio de
qualquer aparncia na pasta FScrollBar Skins afeta todos os componentes que usam barras de
rolagem (ComboBox, ListBox, ScrollBar e ScrollPane).
Para obter mais informaes, consulte Personalizando aparncias de componentes no captulo
Usando componentesde Usando o Flash.
Exemplo

O cdigo a seguir registra o elemento de aparncia personalizado NewArrow_mc na propriedade

arrow no primeiro quadro da camada ReadMe da aparncia fsb_downArrow na pasta FScrollBar
Skins na biblioteca.
Pane1.registerSkinElement(NewArrow_mc, "arrow");
Consulte tambm

FStyleFormat (object)

FScrollPane.setDragContent
Disponibilidade

Flash Player 6.
Uso

myScrollPane.setDragContent(drag)
Parmetros

Um valor Booleano; true que o usurio pode alterar a exibio arrastando o contedo no
painel de rolagem; false especifica que o usurio pode alterar a exibio somente com o uso das
barras de rolagem.
drag

Retorna

Nada.

223

Descrio

Mtodo; especifica se o usurio pode alterar a exibio do painel de rolagem arrastando seu
contedo, alm de usar as barras de rolagem. Se este mtodo for chamado, o valor do parmetro
Drag Content definido durante o processo de criao ser cancelado.
Exemplo

O exemplo a seguir especifica que o contedo no painel de rolagem display1 pode ser arrastado.
display1.setDragContent(true);

FScrollPane.setHScroll
Disponibilidade

Flash Player 6.
Uso

myScrollPane.setHScroll(display)
Parmetros

Um valor Booleano que especifica se a barra de rolagem exibida sempre (true) ou

nunca exibida (false), ou uma seqncia de caracteres que determina que a barra de rolagem
seja exibida somente quando necessrio ("auto").

display

Se este mtodo for chamado, o valor do parmetro Horizontal Scroll definido durante o processo
de criao ser cancelado.
Retorna

Nada.
Descrio

Mtodo; determina se a barra de rolagem horizontal exibida sempre (true), nunca exibida
(false) ou somente quando necessrio ("auto"). O valor padro auto.
Exemplo

O cdigo a seguir oculta a barra de rolagem horizontal em display1.

display1.setHScroll(false);
Consulte tambm

FScrollPane.setVScroll

FScrollPane.setScrollContent
Disponibilidade

Flash Player 6.
Uso

myScrollPane.setScrollContent(target)
Parmetros

target Uma seqncia de caracteres de texto que especifica a ID de vinculao de smbolo de

um clipe de filme na biblioteca ou uma instncia de um clipe de filme.
Retorna

Nada.

Dicionrio ActionScript 224

Descrio

Mtodo; especifica um clipe de filme a ser exibido no painel de rolagem. Se este mtodo for
chamado, o valor do parmetro Scroll Content definido durante o processo de criao ser
cancelado.
Exemplo

O exemplo a seguir especifica a instncia de clipe de filme BetsyTacy como o destino de

display1.
display1.setScrollContent("BetsyTacy");
Consulte tambm

FScrollPane.getPaneHeight, FScrollPane.loadScrollContent

FScrollPane.setScrollPosition
Disponibilidade

Flash Player 6.
Uso

myScrollPane.setScrollPosition(x, y)
Parmetros

Um nmero inteiro que especifica o nmero de pixels (a partir de 0) para a rolagem para a direita.

Um nmero inteiro que especifica o nmero de pixels (a partir de 0) para a rolagem para baixo.

Retorna

Nada.
Descrio

Mtodo; define a posio de rolagem segundo as posies das coordenadas x, y especificadas.

Exemplo

O exemplo a seguir faz o contedo de display1 rolar 14 pixels para baixo e 40 pixels para a direita.
display1.setScrollPosition(14,40);
Consulte tambm

FScrollPane.getScrollPosition

FScrollPane.setSize
Disponibilidade

Flash Player 6.
Uso

myScrollPane.setSize(width, height)
Parmetros

width

Um nmero inteiro que especifica a largura do painel de rolagem, em pixels.

height
Retorna

Nada.

225

Um nmero inteiro que especifica a altura do painel de rolagem, em pixels.

Descrio

Mtodo; define a largura e a altura, em pixels, da exibio do painel de rolagem durante a

execuo. Se este mtodo for chamado, o dimensionamento aplicado durante o processo de
criao ser cancelado.
Para obter mais informaes, consulte Personalizando aparncias de componentes no captulo
Usando componentesde Usando o Flash.
Exemplo

O cdigo a seguir define a largura e a altura de display1 como sendo 500 x 300 pixels.
display1.setSize(500, 300);
Consulte tambm

FScrollPane.getPaneHeight, FScrollPane.getPaneWidth

FScrollPane.setStyleProperty
Disponibilidade

Flash Player 6.
Uso

myScrollPane.setStyleProperty(styleProperty, value)
Parmetros

styleProperty

Uma seqncia de caracteres que especifica uma propriedade do objeto

FStyleFormat.
value

O valor definido para a propriedade.

Retorna

Nada.
Descrio

Mtodo; define uma propriedade FStyleFormat para um determinado painel de rolagem. Chamar
este mtodo para especificar uma propriedade cancela as configuraes dessa propriedade no
formato de estilo atribudo ao componente. Se o valor undefined for atribudo a uma
propriedade, todos os estilos dessa propriedade sero removidos.
Para definir as propriedades FStyleFormat para vrios componentes, crie um formato de estilo
personalizado. Para obter mais informaes sobre a criao de formatos de estilo personalizados,
consulte Personalizando cores e texto do componente no captulo Usando componentes de
Usando o Flash.
Exemplo

O cdigo a seguir define a propriedade arrow de ScrollPane2 como sendo 0x000000 (preto).
ScrollPane2.setStyleProperty("arrow", 0x000000);
Consulte tambm

FStyleFormat (object)

Dicionrio ActionScript 226

FScrollPane.setVScroll
Disponibilidade

Flash Player 6.
Uso

myScrollBar.setVScroll(display)
Parmetros

Um valor Booleano que especifica se a barra de rolagem exibida sempre (true) ou

nunca exibida (false), ou uma seqncia de caracteres que determina que a barra de rolagem
seja exibida somente quando necessrio ("auto").

display

Retorna

Nada.
Descrio

Mtodo; determina se a barra de rolagem vertical exibida sempre (true), nunca exibida
(false) ou somente quando necessrio ("auto"). O valor padro auto.
Se este mtodo for chamado, o valor do parmetro Vertical Scroll definido durante o processo de
criao ser cancelado.
Exemplo

O cdigo a seguir especifica que a barra de rolagem vertical de display1 seja exibida sempre.
display1.setVScroll(true);
Consulte tambm

FScrollPane.setHScroll

FStyleFormat (object)
O objeto FStyleFormat permite definir ou alterar propriedades no formato de estilo global
atribudas a todos os componentes de interface de usurio Flash por padro, ou criar novos
formatos de estilo personalizados para uso com componentes de interface de usurio Flash ou
componentes personalizados que voc cria ou obtm de outras fontes. O formato de estilo global,
ou objeto globalStyleFormat, uma instncia do objeto FStyleFormat que define as
propriedades de formatao de cores e texto usadas para exibir todos os componentes de interface
de usurio Flash.
Para criar um novo formato de estilo personalizado, voc cria uma nova instncia do objeto
FStyleFormat usando o construtor new FStyleFormat(), define as propriedades de
FStyleFormat que desejar incluir no formato de estilo e, a seguir, usa o mtodo
FStyleFormat.addListener para registrar instncias de componentes no novo formato de
estilo. Uma instncia de componente pode ouvir mais de um formato de estilo, mas s pode
obter o valor de um formato de estilo de uma propriedade especfica. Se voc adicionar um
componente como um ouvinte de um formato de estilo, ele utilizar o novo formato de estilo para
propriedades especificadas no formato e utilizar o antigo formato de estilo para todas as outras
propriedades.
No ser preciso usar o construtor FStyleFormat para adicionar ou remover ouvintes ou definir ou
alterar propriedades no formato de estilo global, porque o objeto globalStyleFormat existe no
momento em que qualquer componente de interface de usurio Flash inserido no Palco.

227

Voc pode definir qualquer propriedade de FStyleFormat para uma nica instncia de um
componente usando o mtodo setStyleProperty disponvel a todos os componentes de
interface de usurio Flash. O uso de setStyleProperty permite definir uma propriedade para
um componente sem criar uma instncia do objeto FStyleFormat. O uso de setStyleProperty
cancela a configurao de uma propriedade de formato de estilo especfica atribuda ao
componente sem alterar as outras configuraes de propriedades. Para obter mais informaes,
consulte as entradas de setStyleProperty de componentes individuais.
Ao atribuir um valor de cor a uma propriedade de FStyleFormat, especifique uma cor RGB no
formato 0xRRGGBB.
Para obter mais informaes sobre o formato de estilo global e sobre a criao de formatos de
estilo personalizados, consulte Personalizando cores e texto do componente no captulo
Usando componentes de Usando o Flash.
Resumo de mtodos do objeto FStyleFormat
Mtodo

Descrio

FStyleFormat.addListener

Registra um componente em formato de estilo.

FStyleFormat.applyChanges

Aplica as alteraes efetuadas em valores de propriedades de um

formato de estilo.

FStyleFormat.removeListener

Remove um componente como um ouvinte de um formato de estilo.

Resumo das propriedades do objeto FStyleFormat

As tabelas a seguir listam os resumos das propriedades do objeto FStyleFormat.
Propriedade

Descrio

FStyleFormat.arrow

A cor da seta usada em barras de rolagem e listagens suspensas.

FStyleFormat.background

A cor da poro de fundo de um componente.

FStyleFormat.backgroundDisabled

A cor da poro de fundo de um componente desativado.

FStyleFormat.check

A cor da marca de seleo em uma caixa de seleo assinalada.

FStyleFormat.darkshadow

A cor da borda interna ou da poro de sombreamento mais escuro de

um componente.

FStyleFormat.face

A cor principal do componente.

FStyleFormat.foregroundDisabled

A cor de primeiro plano do componente.

FStyleFormat.highlight

A cor da borda interna ou da poro de sombreamento mais escuro de

um componente quando selecionado.

FStyleFormat.highlight3D

A cor da borda externa ou da poro de sombreamento mais claro de

um componente quando selecionado.

FStyleFormat.radioDot

A cor do ponto em um boto de opo assinalado.

FStyleFormat.scrollTrack

A cor da trilha em uma barra de rolagem.

FStyleFormat.selection

A cor da barra de seleo que destaca um item de listagem em um

componente.

FStyleFormat.selectionDisabled

A cor da barra de seleo que destaca um item de listagem em um

componente desativado.

FStyleFormat.selectionUnfocused

A cor da barra de seleo quando o componente no tem foco de

teclado.

Dicionrio ActionScript 228

Propriedade

Descrio

FStyleFormat.shadow

A cor da borda externa ou da poro de sombreamento claro de um

componente.

FStyleFormat.textAlign

O alinhamento (esquerda, direita ou centro) do texto exibido em um

componente.

FStyleFormat.textBold

Especifica se o texto ser em negrito (true) ou no (false).

FStyleFormat.textColor

A cor de texto padro em todos os componentes atribuda ao formato

de estilo.

FStyleFormat.textDisabled

A cor do texto em um componente desativado.

FStyleFormat.textFont

O nome da fonte para exibio de texto.

FStyleFormat.textIndent

O recuo do texto a partir da margem esquerda at o primeiro caractere

de texto, em pixels.

FStyleFormat.textItalic

Especifica se o texto ser em itlico (true) ou no (false).

FStyleFormat.textLeftMargin

A margem de pargrafo esquerda do texto, em pixels.

FStyleFormat.textRightMargin

A margem de pargrafo direita do texto, em pixels.

FStyleFormat.textSelected

A cor de um item de listagem selecionado em um componente.

FStyleFormat.textSize

O tamanho do texto, em pontos.

FStyleFormat.textUnderline

Especifica se o texto ser sublinhado (true) ou no (false).

Construtor do objeto FStyleFormat

Disponibilidade

Flash Player 6.
Uso

new FStyleFormat()
Parmetros

Nenhum.
Retorna

Uma instncia do objeto FStyleFormat.

Descrio

Mtodo; cria um novo objeto FStyleFormat. Voc cria novos objetos FStyleFormat para definir
propriedades de texto e cores de formatos de estilo personalizados usados com componentes
personalizados ou com os componentes de interface de usurio Flash. Como padro, o objeto
globalStyleFormat atribudo a todos os componentes de interface de usurio Flash. Esse
objeto uma instncia do objeto FStyleFormat. No preciso criar uma nova instncia do objeto
FStyleFormat para alterar propriedades no formato de estilo global, pois ela j existe. Voc
tambm pode usar setStyleProperty para alterar propriedades de instncias especficas de
componentes sem usar um construtor.
Para obter mais informaes, consulte o mtodo setStyleProperty disponvel para cada
componenteFCheckBox.setStyleProperty, FComboBox.setStyleProperty etc. Consulte
tambm Personalizando cores e texto do componente no captulo Usando componentes de
Usando o Flash.

229

Exemplo

O exemplo a seguir cria o novo formato de estilo formStyleFormat.

formStyleFormat = new StyleFormat();

FStyleFormat.addListener
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.addListener(component1 [, component2, ...componentN])

Parmetros

component1 ... componentN

myStyleFormat.

As instncias de componentes a serem registradas em

Retorna

Nada.
Descrio

Mtodo; registra os componentes especificados em myStyleFormat. Use este mtodo para

registrar instncias de componentes de interface de usurio Flash ou componentes personalizados
em um formato de estilo personalizado. Voc tambm pode usar este mtodo com a sintaxe a
seguir para registrar um componente personalizado em um formato de estilo global usado por
todos os componentes de interface de usurio Flash como padro.
globalStyleFormat.addListener(customComponent);
Exemplo

O cdigo a seguir registra formStyleFormat com os componentes myListBox, myComboBox e

myScrollBar.
formStyleFormat.addListener(myListBox, myComboBox, myScrollBar);
Consulte tambm

FStyleFormat.applyChangesFStyleFormat.applyChanges, FStyleFormat.removeListener

FStyleFormat.applyChanges
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.applyChanges([propertyName1, ...propertyNameN])
myStyleFormat.applyChanges()
Parmetros

propertyName1...propertyNameN Uma srie de seqncias de caracteres de texto que

especificam as propriedades a serem atualizadas para todos os componentes atribudos a
myStyleFormat.
Retorna

Nada.

Dicionrio ActionScript 230

Descrio

Mtodo; atualiza a instncia do objeto de formato de estilo especificado e aplica as alteraes a

todos os componentes atribudos ao formato. Voc deve chamar este mtodo ao adicionar ou
remover ouvintes e definir ou alterar propriedades. Ao atualizar propriedades, recomenda-se o uso
da primeira sintaxe para atualizar somente as propriedades para as quais voc estiver especificando
um novo valor.
Uso 1: Atualiza somente as propriedades especificadas nos parmetros.
Uso 2: Atualiza todas as informaes no formato de estilo (ou seja, componentes e propriedades
atribudos) tenham eles sido alterados ou no.
Exemplo

Uso 1: O exemplo a seguir atualiza as propriedades arrow e background, mas no as propriedades

check e highlihgt, em formStyleFormat.
formStyleFormat.arrow = 0x00ffaa;
formStyleFormat.background = 0xaabbcc;
formStyleFormat.check = 0x000000;
formStyleFormat.highlight = 0xffffff;
formStyleFormat.applyChanges("arrow", "background");

Uso 2: O exemplo a seguir atualiza todas as propriedades em formStyleFormatarrow,

background, check e highlight.
formStyleFormat.arrow = 0x00ffaa;
formStyleFormat.background = 0xaabbcc;
formStyleFormat.check = 0x000000;
formStyleFormat.highlight = 0xffffff;
formStyleFormat.applyChanges();
Consulte tambm

FStyleFormat.addListener, FStyleFormat.removeListener

FStyleFormat.arrow
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.arrow
Descrio

Propriedade; o valor de cor RGB da propriedade arrow usado em barras de rolagem e listagens
suspensas em componentes como barras de rolagem, caixas de listagem e caixas de combinao. O
valor da cor dever estar no formato 0xRRGGBB.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir atribui o valor 0x800080 propriedade arrow em formStyleFormat, gerando

um seta roxa.
formStyleFormat.arrow = 0x800080;

231

FStyleFormat.background
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.background
Descrio

Propriedade; o valor de cor RGB da poro de fundo de um componente. Por exemplo, em um

boto de opo ou uma caixa de seleo, a poro de fundo o espao dentro da rea de seleo;
em uma caixa de listagem ou de combinao, a poro de fundo a rea de exibio. O valor da
cor dever estar no formato 0xRRGGBB.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir atribui o valor 0xFFE4E1 propriedade background de formStyleFormat,

produzindo um fundo rosa claro quando o componente ativado.
formStyleFormat.background = 0xFFE4E1;
Consulte tambm

FStyleFormat.face

FStyleFormat.backgroundDisabled
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.backgroundDisabled
Descrio

Propriedade; o valor de cor RGB da poro de fundo de um componente desativado. Geralmente,

a cor de fundo dos elementos desativados da interface de usurio cinza claro. O valor da cor
dever estar no formato 0xRRGGBB.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir atribui o valor 0x808080 propriedade backgroundDisabled de

formStyleFormat, produzindo um fundo cinza quando o componente desativado.
formStyleFormat.backgroundDisabled = 0x808080;
Consulte tambm

FStyleFormat.foregroundDisabled

Dicionrio ActionScript 232

FStyleFormat.check
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.check
Descrio

Propriedade; o valor de cor RGB da marca de seleo em uma caixa de seleo assinalada. O valor
da cor dever estar no formato 0xRRGGBB.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir atribui o valor 0x228B22 propriedade check de formStyleFormat,

produzindo uma seta verde escura.
formStyleFormat.check = 0x228B22;

FStyleFormat.darkshadow
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.darkshadow
Descrio

Propriedade; o valor de cor RGB da borda interna ou da poro de sombreamento mais escuro de
um componente por exemplo, a extremidade interna do crculo de um boto de opo
desmarcado ou de uma caixa de seleo desmarcada. O valor da cor dever estar no formato
0xRRGGBB.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir atribui o valor 0x0000CD propriedade darkshadow de formStyleFormat,

produzindo uma borda interna na cor azul, em tom mdio.
formStyleFormat.darkshadow = 0x0000CD;
Consulte tambm

FStyleFormat.highlight, FStyleFormat.shadow

233

FStyleFormat.face
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.face
Descrio

Propriedade; o valor RGB da cor principal de um componente por exemplo, o cinza usado no
componente PushButton ou ScrollBar. O valor da cor dever estar no formato 0xRRGGBB.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir atribui o valor 0x32CD32 propriedade face de formStyleFormat,

produzindo botes de ao e barras de rolagem na cor verde limo.
formStyleFormat.face = 0x32CD32;

FStyleFormat.foregroundDisabled
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.foregroundDisabled
Descrio

Propriedade; o valor de cor RGB para o primeiro plano de um componente desativado.

Geralmente, a cor de primeiro plano dos elementos desativados da interface de usurio cinza
mdio. O valor da cor dever estar no formato 0xRRGGBB.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir atribui o valor 0x708090 propriedade foregroundDisabled de

formStyleFormat, produzindo um primeiro plano cinza para os componentes desativados.
formStyleFormat.foregroundDisabled = 0x708090;
Consulte tambm

FStyleFormat.backgroundDisabled

Dicionrio ActionScript 234

FStyleFormat.highlight
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.highlight
Descrio

Propriedade; o valor de cor RGB da borda interna ou da poro de sombreamento mais escuro de
um componente quando selecionado por exemplo, a extremidade interna do crculo de um
boto de opo ou de uma caixa de seleo. O valor da cor dever estar no formato 0xRRGGBB.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir atribui o valor 0xFF00FF propriedade highlight de formStyleFormat,

produzindo uma borda interna na cor amarelo brilhante quando o componente selecionado.
formStyleFormat.highlight = 0xFF00FF;
Consulte tambm

FStyleFormat.darkshadow

FStyleFormat.highlight3D
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.highlight3D
Descrio

Propriedade; o valor de cor RGB da borda externa ou da poro de sombreamento mais clara de
um componente quando selecionado por exemplo, a extremidade externa do crculo de um
boto de opo ou de uma caixa de seleo. O valor da cor dever estar no formato 0xRRGGBB.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir atribui o valor 0x40E0D0 propriedade highlight3D de formStyleFormat,

produzindo uma borda externa na cor turquesa brilhante quando o componente selecionado.
formStyleFormat.highlight3D = 0x40E0D0;
Consulte tambm

FStyleFormat.shadow

235

FStyleFormat.radioDot
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.radioDot
Descrio

Propriedade; o valor de cor RGB do ponto de seleo do boto de opo de um componente. O

valor da cor dever estar no formato 0xRRGGBB.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir atribui o valor 0xFF12AC propriedade radioDot de formStyleFormat,

produzindo um ponto de seleo rosa.
formStyleFormat.radioDot = 0xFF12AC;

FStyleFormat.removeListener
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.removeListener(component)
Parmetros

component

O componente a ser removido do formato de estilo.

Descrio

Mtodo; remove um componente atribudo ao formato de estilo.

Se voc remover um componente de interface de usurio Flash como um ouvinte do formato

de estilo global e no o atribuir (no o adicionar como um ouvinte) a um formato de estilo
personalizado, os clipes de filme dos elementos de aparncia sero exibidos como foram
originalmente criados pelo designer de componentes sem um valor de propriedade atribudo.

Se voc remover um componente de interface de usurio Flash como um ouvinte de um

formato de estilo personalizado, o componente no mais usar os valores de propriedade no
formato de estilo personalizado e, em vez disso, usar os valores especificados para essas
propriedades no objeto de formato de estilo global.

Se voc remover um componente personalizado como um ouvinte de um formato de estilo

personalizado sem adicion-lo a um novo formato de estilo personalizado, o componente usar
os valores definidos para as propriedades no formato de estilo global sempre que possvel e, caso
no seja possvel, exibir os elementos de aparncia sem um valor de propriedade.
Exemplo

O exemplo a seguir remove o componente check1 de globalStyleFormat.

globalStyleFormat.removeListener(check1);
Consulte tambm

FStyleFormat.addListener, FStyleFormat.applyChanges

Dicionrio ActionScript 236

FStyleFormat.scrollTrack
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.scrollTrack
Descrio

Propriedade; o valor de cor RGB da poro de trilha de uma barra de rolagem. O componente
ScrollBar usado pelos componentes ScrollPane, ListBox e ComboBox, e a alterao do valor da
propriedade scrollTrack no formato de estilo global altera a cor da trilha de rolagem em todos
os componentes que usam barras de rolagem. O valor da cor dever estar no formato 0xRRGGBB.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir atribui o valor 0xA0522D propriedade scrollTrack em formStyleFormat,

gerando uma trilha de rolagem marrom.
formStyleFormat.scrollTrack = 0xA0522D;

FStyleFormat.selection
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.selection
Descrio

Propriedade; o valor de cor RGB da barra usada para realar o item selecionado na listagem de um
componente. Essa propriedade atua em conjunto com a propriedade
FStyleFormat.textSelected para exibir itens selecionados e voc deve coordenar as cores para
facilitar a leitura dos textos. Por exemplo, o formato de estilo global atribui um valor de cor azul
propriedade selection, usada para exibir a barra de seleo nos componentes ListBox e
ComboBox, e atribui um valor de cor branca propriedade textSelected; essa combinao de
cores permite que o usurio visualize facilmente o texto selecionado. O valor da cor dever estar
no formato 0xRRGGBB.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir atribui o valor 0x87CEEB propriedade selection em formStyleFormat,

gerando uma barra de seleo azul celeste.
formStyleFormat.selection = 0x87CEEB;
Consulte tambm

FStyleFormat.textSelected

237

FStyleFormat.selectionDisabled
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.selectionDisabled
Descrio

Propriedade; o valor de cor RGB da barra de seleo usada para realar um item de listagem em
um componente desativado. O valor da cor dever estar no formato 0xRRGGBB.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir atribui o valor 0x708090 propriedade selectionDisabled de

formStyleFormat, produzindo uma barra de seleo na cor cinza azulada quando o componente
desativado.
formStyleFormat.selectionDisabled = 0x708090;
Consulte tambm

FStyleFormat.selection

FStyleFormat.selectionUnfocused
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.selectionUnfocused
Descrio

Propriedade; o valor de cor RGB da barra de seleo (realce) na listagem de um componente

quando o componente no tem o foco do teclado. O valor da cor dever estar no formato
0xRRGGBB.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir atribui o valor 0xaabbcc propriedade selectionUnfocused de

formStyleFormat.
formStyleFormat.selectionUnfocused = 0xaabbcc;
Consulte tambm

FStyleFormat.selection

Dicionrio ActionScript 238

FStyleFormat.shadow
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.shadow
Descrio

Propriedade; o valor de cor RGB da borda externa ou da poro de sombreamento clara de um

componente por exemplo, a extremidade externa do crculo de um boto de opo desmarcado
ou de uma caixa de seleo desmarcada. O valor da cor dever estar no formato 0xRRGGBB.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir atribui o valor 0x008080 propriedade shadow de formStyleFormat,

produzindo uma borda externa na cor azul esverdeada para componentes de botes de opo e
caixas de seleo desmarcadas.
formStyleFormat.shadow = 0x008080;
Consulte tambm

FStyleFormat.check

FStyleFormat.textAlign
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.textAlign
Descrio

Propriedade; uma seqncia de caracteres de texto que especifica o alinhamento direita,

esquerda ou no centro para o texto exibido em todos os componentes atribudos ao formato de
estilo. A configurao padro left.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir alinha direita todo o texto em componentes usando formStyleFormat.

formStyleFormat.textAlgin = "right";
Consulte tambm

FStyleFormat.textIndent, FStyleFormat.textLeftMargin,
FStyleFormat.textRightMargin

239

FStyleFormat.textBold
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.textBold
Descrio

Propriedade; um valor Booleano que especifica se todo o texto exibido em componentes que usam
o formato de estilo ficar em negrito (true) ou no (false). A configurao padro false.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir determina que todo o texto exibido em componentes atribudos a

formStyleFormat fique em negrito.
formStyleFormat.textBold = true;
Consulte tambm

FStyleFormat.textItalic, FStyleFormat.textUnderline

FStyleFormat.textColor
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.textColor
Descrio

Propriedade; o valor de cor RGB para a cor de texto padro em todos os componentes atribudos
ao formato de estilo. O valor da cor dever estar no formato 0xRRGGBB.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir atribui o valor 0x000000 propriedade textColor em formStyleFormat,

produzindo texto em preto.
formStyleFormat.textColor = 0x000000;
Consulte tambm

FStyleFormat.textDisabled, FStyleFormat.textSelected

Dicionrio ActionScript 240

FStyleFormat.textDisabled
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.textDisabled
Descrio

Propriedade; o valor de cor RGB para a cor de texto padro usada para exibir texto em
componentes desativados atribudos ao formato de estilo. O valor da cor dever estar no formato
0xRRGGBB.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir atribui o valor 0xCOCOC0 propriedade textDisabled de formStyleFormat,

produzindo um texto prateado quando o componente desativado.
formStyleFormat.textDisabled = 0xCOCOC0;
Consulte tambm

FStyleFormat.textAlign, FStyleFormat.textSelected

FStyleFormat.textFont
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.textFont
Descrio

Propriedade; uma seqncia de caracteres de texto que especifica a fonte usada para exibir texto
em todos os componentes atribudos ao formato de estilo.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir atribui o valor Arial propriedade textFont de formStyleFormat.

formStyleFormat.textFont = "Arial";

FStyleFormat.textIndent
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.textIndent
Descrio

Propriedade; um nmero inteiro que especifica o recuo, em pixels, a partir da margem esquerda
at o primeiro caractere de texto para todo o texto exibido usando o formato de estilo.

241

Exemplo

O cdigo a seguir recua todo o texto exibido por formStyleFormat em 5 pixels.

formStyleFormat.textIndent = 5;
Consulte tambm

FStyleFormat.textAlign, FStyleFormat.textLeftMargin

FStyleFormat.textItalic
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.textItalic
Descrio

Propriedade; um valor Booleano que especifica se todo o texto exibido em componentes que usam
o formato de estilo ficar em itlico (true) ou no (false). A configurao padro false.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir determina que todo o texto exibido em componentes atribudos a

formStyleFormat fique em itlico.
formStyleFormat.textItalic = true;
Consulte tambm

FStyleFormat.textBold

FStyleFormat.textLeftMargin
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.textLeftMargin
Descrio

Propriedade; um nmero inteiro que especifica a margem esquerda do pargrafo, em pixels, para
todo o texto exibido em componentes atribudo ao formato de estilo.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir especifica um valor de 4 pixels para a propriedade textLeftMargin de

formStyleFormat.
formStyleFormat.textLeftMargin = 4;
Consulte tambm

FStyleFormat.textRightMargin

Dicionrio ActionScript 242

FStyleFormat.textRightMargin
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.textRightMargin

Propriedade; um nmero inteiro que especifica a margem direita do pargrafo, em pixels, para
todo o texto exibido em componentes atribudo ao formato de estilo.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir especifica um valor de 4 pixels para a propriedade textRightMargin de

formStyleFormat.
formStyleFormat.textRightMargin = 4;
Consulte tambm

FStyleFormat.textLeftMargin

FStyleFormat.textSelected
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.textSelected
Descrio

Propriedade; o valor de cor RGB que especifica a cor do texto selecionado em componentes
atribudos ao formato de estilo. Essa propriedade atua em conjunto com a propriedade
FStyleFormat.selection para exibir itens de listagem selecionados e voc deve coordenar as cores
para facilitar a leitura dos textos. Por exemplo, o formato de estilo global atribui um valor de cor
azul propriedade selection, usada para exibir a barra de seleo nos componentes ListBox e
ComboBox, e atribui um valor de cor branca propriedade textSelected; essa combinao de
cores permite que o usurio visualize facilmente o texto selecionado. O valor da cor dever estar
no formato 0xRRGGBB.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir atribui o valor 0xffffff propriedade textSelected de formStyleFormat,

produzindo um texto branco quando o componente selecionado.
formStyleFormat.textSelected = 0xffffff;
Consulte tambm

FStyleFormat.selection, FStyleFormat.textDisabled

243

FStyleFormat.textSize
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.textSize
Descrio

Propriedade; um nmero inteiro que especifica o tamanho do ponto do texto exibido em

componentes atribudos ao formato de estilo. A configurao padro para esta propriedade texto
de 12 pontos.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir especifica texto de 10 pontos para todos os componentes atribudos a

formStyleFormat.
formStyleFormat.textSize = 10;
Consulte tambm

FStyleFormat.textFont

FStyleFormat.textUnderline
Disponibilidade

Flash Player 6.
Uso

myStyleFormat.textUnderline
Descrio

Propriedade; especifica se o texto exibido em componentes que usam o formato de estilo

especificado ser sublinhado (true) ou no (false). A configurao padro false.
Voc deve usar FStyleFormat.applyChanges ao atualizar propriedades com um novo valor.
Exemplo

O cdigo a seguir determina que todo o texto exibido em componentes atribudos a

formStyleFormat seja sublinhado.
formStyleFormat.textUnderline = true;
Consulte tambm

FStyleFormat.textBold, FStyleFormat.textItalic

Dicionrio ActionScript 244

Function (objeto)
O objeto Function encontra-se disponvel no Flash MX.
Resumo das propriedades do objeto Function
Mtodo

Descrio

Function.prototype

Refere-se a um objeto que o prottipo de uma classe.

Resumo dos mtodos do objeto Function

Mtodo

Descrio

Function.apply

Ativa o cdigo ActionScript para chamar uma funo.

Function.call

Invoca a funo representada por um objeto Function.

Function.apply
Disponibilidade

Flash Player 6.
Uso

myFunction.apply(thisObject, argumentsObject)
Parmetros

thisObject

O objeto ao qual myFunction aplicada.

argumentsObject

Uma matriz cujos elementos so passados para myFunction como

parmetros.
Retorna

Qualquer valor que a funo chamada especifica.

Descrio

Mtodo; especifica o valor de this para ser usado em qualquer funo que ActionScript chame.
Este mtodo tambm especifica os parmetros a serem passados a qualquer funo chamada.
Como apply um mtodo do objeto Function, ele tambm um mtodo de todo objeto de
funo em ActionScript.
Os parmetros so especificados como um objeto Array. Em geral, isso til quando o nmero de
parmetros a serem passados s conhecido quando o script realmente executado.
Exemplo

As invocaes de funo a seguir so equivalentes.

Math.atan2(1, 0)
Math.atan2.apply(null, [1, 0])

Voc pode construir um filme Flash que contenha campos de entrada que permitam ao usurio
inserir o nome de uma funo a ser invocada e nenhum ou qualquer nmero de parmetros a
serem passados funo. O boto Chamar usaria ento o mtodo apply para chamar a funo,
especificando os parmetros.

245

No exemplo, o usurio especifica um nome de funo em um campo de texto de entrada

denominado functionName. A quantidade de parmetros especificada em um campo de texto
de entrada denominado numParameters. At 10 parmetros so especificados em campos de
texto denominados parameter1, parameter2, at parameter10.
on (release) {
callTheFunction();
}
...
function callTheFunction()
{
var theFunction = eval(functionName.text);
var n = Number(numParameters);
var parameters = [];
for (var i = 0; i < n; i++) {
parameters.push(eval("parameter" + i));
}
theFunction.apply(null, parameters);
}

Function.call
Disponibilidade

Flash Player 6.
Uso

myFunction.call(thisObject, parameter1, ..., parameterN)

Parmetros

thisObject

Especifica o valor de this no corpo da funo.

parameter1

Um parmetro a ser passado a myFunction. Voc pode especificar zero ou mais

parmetros.
parameterN
Retorna

Nada.
Descrio

Mtodo; invoca a funo representada por um objeto Function. Toda funo em ActionScript
representada por um objeto Function para que todas as funes ofeream suporte ao mtodo call.
Em quase todos os casos, o operador de chamada de funo (()) pode ser usado no lugar do
mtodo call. O operador de chamada de funo produz um cdigo conciso e de fcil leitura. O
mtodo call til principalmente quando o parmetro this da invocao da funo precisa ser
explicitamente controlado. Normalmente, se uma funo invocada como um mtodo de um
objeto, no corpo da funo, this definido para myObject como no exemplo a seguir:
myObject.myMethod(1, 2, 3);

Em algumas situaes, pode ser prefervel que this aponte para algum outro lugar; por exemplo,
se uma funo tiver que ser invocada como um mtodo de um objeto, mas no estiver realmente
armazenada como um mtodo desse objeto.
myObject.myMethod.call(myOtherObject, 1, 2, 3);

Dicionrio ActionScript 246

Voc pode passar o valor null para o parmetro thisObject para invocar uma funo como uma
funo regular e no como um mtodo de um objeto. Por exemplo, as invocaes de funo a
seguir so equivalentes:
Math.sin(Math.PI / 4)
Math.sin.call(null, Math.PI / 4)

Exemplo
Este exemplo usa o mtodo call para fazer uma funo se comportar como um mtodo de outro
objeto, sem armazenar a funo no objeto.
function MyObject() {
}
function MyMethod(obj) {
trace("this == obj? " + (this == obj));
}
var obj = new MyObject();
MyMethod.call(obj, obj);

A ao trace envia o seguinte cdigo para a janela Sada:

this == obj? true

Function.prototype
Disponibilidade

Flash Player 6.
Uso

myFunction.prototype
Descrio

Propriedade; em uma funo de construtor, a propriedade prototype refere-se a um objeto que

o prottipo da classe construda. Cada instncia da classe que criada pela funo de construtor
herda todas as propriedades e mtodos do objeto prottipo.

fscommand
Disponibilidade

Flash Player 3.
Uso

fscommand("command", "parameters")
Parmetros

comand Uma seqncia de caracteres passada ao aplicativo host para qualquer uso ou um
comando passado ao Flash Player independente.
parameters Uma seqncia de caracteres passada ao aplicativo host para qualquer uso ou um
valor passado ao Flash Player.
Retorna

Nada.

247

Descrio

Ao; permite que o filme Flash se comunique com o Flash Player ou com o programa que
hospeda o Flash Player, como um navegador da Web. Voc tambm pode usar a ao fscommand
para passar mensagens para o Macromedia Director ou para o Visual Basic, Visual C++ e outros
programas que possam hospedar controles ActiveX.
Uso 1: Para enviar uma mensagem ao Flash Player, voc deve usar comandos e parmetros
predefinidos. A tabela a seguir mostra os valores que podem ser especificados para os parmetros
command e parameters da ao fscommand para controlar um filme reproduzido na verso
independente do Flash Player (incluindo projetores):
Comando

Parmetros

Objetivo

quit

Nenhum

Fecha o projetor.

fullscreen

true ou false

A especificao de true define o Flash Player no modo de tela cheia. A

especificao de false faz o exibidor voltar exibio de menu normal.

allowscale

true ou false

A especificao de false define o exibidor para que o filme seja sempre

desenhado em seu tamanho original e nunca escalado. A especificao
de true fora o filme a ser escalado para 100% do exibidor.

showmenu

true ou false

A especificao de true ativa o conjunto completo de itens do menu de

contexto. A especificao de false torna esmaecidos todos os itens do
menu de contexto, exceto Sobre o Flash Player.

exec

Caminho para o
aplicativo

Executa um aplicativo no projetor.

trapallkeys

true ou false

A especificao de true envia todos os eventos de teclas, incluindo as

teclas de acelerao,para o identificador onClipEvent(keyDown/
keyUp) no Flash Player.

Uso 2: Para usar a ao fscommand para enviar uma mensagem para uma linguagem de script
como JavaScript em um navegador da Web, voc pode passar dois parmetros quaisquer nos
parmetros command e parameters. Esses parmetros podem ser seqncias de caracteres ou
expresses e sero usados em uma funo JavaScript que captura, ou manipula, a ao
fscommand .
Em um navegador da Web, a ao fscommand chama a funo JavaScript
moviename_DoFScommand na pgina HTML que contm o filme Flash. O moviename o nome
do Flash Player conforme atribudo pelo atributo NAME da tag EMBED ou pela propriedade ID da
tag OBJECT. Se o nome atribudo ao Flash Player for myMovie, a funo JavaScript chamada ser
myMovie_DoFSCommand.
Uso 3: A ao fscommand pode enviar mensagens ao Macromedia Director que so interpretadas
pelo Lingo como seqncias de caracteres, eventos ou cdigo Lingo executvel. Se a mensagem for
uma seqncia de caracteres ou um evento, voc dever criar o cdigo Lingo para receb-la a
partir da ao fscommand e executar uma ao no Director.
Uso 4: No Visual Basic, Visual C++ e em outros programas que podem hospedar controles
ActiveX, fscommand envia um evento VB com duas seqncias de caracteres que podem ser
tratadas na linguagem de programao do ambiente. Para obter mais informaes, use as palavraschave Flash method e faa uma pesquisa noFlash Support Center.

Dicionrio ActionScript 248

Exemplo

Uso 1: No exemplo a seguir, a ao fscommand determina que o Flash Player ajuste o filme para
toda a tela do monitor quando o boto for liberado.
on(release){
fscommand("fullscreen", true);
}

Uso 2: O exemplo a seguir usa a ao fscommand aplicada a um boto em Flash para abrir uma
caixa de mensagem JavaScript em uma pgina HTML. A mensagem em si enviada para
JavaScript como o parmetro de fscommand.
Voc deve adicionar uma funo pgina HTML que contm o filme Flash. Esta funo
myMovie_DoFSCommand repousa na pgina HTML e aguarda uma ao fscommand no Flash.
Quando um fscommand disparado no Flash (por exemplo, quando um usurio pressiona o
boto), as seqncias de caracteres command e parameter so passadas para a funo
myMovie_DoFSCommand. Voc pode usar as seqncias de caracteres passadas no seu cdigo
JavaScript ou VBScript da maneira que desejar. Neste exemplo, a funo contm um comando
condicional if que verifica se a seqncia de caracteres de comando messagebox. Se for, uma
caixa de alerta JavaScript (ou messagebox) aberta e exibe o contedo da seqncia de caracteres
parameters.
function myMovie_DoFSCommand(command, args) {
if (command == "messagebox") {
alert(args);
}

}
No documento Flash, adicione a ao fscommand a um boto:
fscommand("messagebox", "Esta uma caixa de mensagem chamada de dentro do
Flash.")

Voc tambm pode usar expresses para a ao fscommand e seus parmetros, como no exemplo a
seguir:
fscommand("messagebox", "Ol, " + nome + ", bem-vindo(a) ao nosso site na
Web!")

Para testar o filme, escolha Arquivo > Visualizar Publicao > HTML.
Observao: Se voc publicar o seu filme usando o Flash com o modelo FSCommand nas Configuraes de
Publicao em HTML, a funo myMovie_DoFSCommand ser inserida automaticamente. Os atributos NAME e ID do
filme sero o nome do arquivo. Por exemplo, para o arquivo myMovie.fla, os atributos seriam definidos como
myMovie.

function
Disponibilidade

Flash Player 5.
Uso

function functionname ([parameter0, parameter1,...parameterN]){

comando(s)
}
function ([parameter0, parameter1,...parameterN]){
comando(s)
}

249

Parmetros

functionname

O nome da nova funo.

parameter Um identificador que representa um parmetro a ser passado para a funo. Esses
parmetros so opcionais.
comando(s)

Qualquer instruo ActionScript definida para o corpo da funo.

Retorna

Nada.
Descrio

Ao; um conjunto de comandos que voc define para a realizao de uma determinada tarefa.
Voc pode declarar, ou definir, uma funo em um local e cham-la de diferentes scripts em um
filme. Quando voc define uma funo, tambm pode especificar parmetros para ela. Os
parmetros so espaos reservados para valores sobre os quais a funo far suas operaes. Voc
pode passar parmetros diferentes para uma funo todas as vezes que cham-la. Isso permite
reutilizar uma funo em diversas situaes diferentes.
Use a ao return no(s) comando(s) de uma funo para fazer a funo apresentar, ou gerar, um
valor.
Uso 1: Declara uma funo com o nome da funo, os parmetros e o(s) comando(s)
especificados. Quando uma funo chamada, a declarao da funo chamada. No
permitido repassar uma referncia; na mesma lista de aes, uma funo pode ser declarada aps
ser chamada. Uma declarao de funo substitui qualquer declarao anterior da mesma funo.
Esta sintaxe pode ser usada sempre que for permitido um comando.
Uso 2: Cria uma funo annima e apresenta a mesma. Esta sintaxe usada em expresses e
particularmente til para a instalao de mtodos em objetos.
Exemplo

Uso 1: O exemplo a seguir define a funo sqr, que aceita um parmetro e retorna o quadrado
do parmetro. Observe que, se a funo for declarada e usada no mesmo script, a
declarao de funo pode aparecer aps o uso da funo.

(x*x)

y=sqr(3);
function sqr(x) {
return x*x;
}

Uso 2: A funo a seguir define um objeto Circle:

function Circle(radius) {
this.radius = radius;
}

O comando a seguir define uma funo annima que calcula a rea de um crculo e a anexa ao
objeto Circle como um mtodo:
Circle.prototype.area = function () {return Math.PI * this.radius *
this.radius}

Dicionrio ActionScript 250

ge (maior ou igual a especfico de seqncias de caracteres)

Disponibilidade

Flash Player 4. Esse operador foi substitudo no Flash 5 pelo operador >= (maior ou igual a).
Uso

expresso1 ge expresso2
Parmetros

expression1, expression2

Nmeros, seqncias de caracteres ou variveis

Retorna

Nada.
Descrio

Operador (comparao); compara a representao em seqncia de caracteres da expresso1

com a representao em seqncia de caracteres da expresso2 e retorna true se a expresso1
for maior ou igual expresso2; caso contrrio, retorna false.
Consulte tambm

>= (maior ou igual a)

getProperty
Disponibilidade

Flash Player 4.
Uso

getProperty(instancename , property)
Parmetros

instancename

O nome da instncia de um clipe de filme para o qual a propriedade est sendo

recuperada.
property

Uma propriedade de um clipe de filme.

Retorna

Nada.
Descrio

Funo; retorna o valor de property especificada para o clipe de filme instancename.

Exemplo

O exemplo a seguir recupera a coordenada do eixo horizontal (_x) do clipe de filme myMovie e
atribui a coordenada varivel myMovieX:
myMovieX = getProperty(_root.myMovie, _x);

251

getTimer
Disponibilidade

Flash Player 4.
Uso

getTimer()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Funo; retorna o nmero de milissegundos decorridos desde o incio da reproduo do filme.

getURL
Disponibilidade

Flash 2. As opes GET e POST s esto disponveis no Flash 4 e verses posteriores.

Uso

getURL(url [, window [, "variables"]])

Parmetros

url

O URL de onde o documento ser obtido.

window Um parmetro opcional que especifica a janela ou quadro HTML em que o documento
deve ser carregado. Voc pode inserir o nome de uma janela especfica ou escolher um dos
seguintes nomes de destino reservados:

_self

especifica o quadro atual na janela atual.

_blank

especifica uma nova janela.

_parent
_top

especifica a origem do quadro atual.

especifica o quadro de nvel superior na janela atual.

variables Um mtodo GET ou POST para envio de variveis. Caso no haja variveis, omitir
esse parmetro. O mtodo GET anexa as variveis ao final do URL e usado para pequenos
nmeros. O mtodo POST envia as variveis em um cabealho HTTP separado e usado com
longas seqncias de caracteres.
Retorna

Nada.
Descrio

Ao; carrega um documento de uma URL especfica em uma janela ou passa variveis para outro
aplicativo em uma URL definida. Para testar esta ao, certifique-se de que o arquivo a ser
carregado esteja no local especificado. Para usar uma URL absoluta (por exemplo, http://
www.meuservidor.com), voc precisa de uma conexo de rede.

Dicionrio ActionScript 252

Exemplo

Este exemplo carrega uma nova URL em uma janela em branco do navegador. A ao getURL
direciona a varivel incomingAd como o parmetro url para que voc possa alterar a URL
carregada sem que seja necessrio editar o filme do Flash. O valor da varivel incomingAd
passado para o Flash no incio do filme com uma ao loadVariables.
on(release) {
getURL(incomingAd, "_blank");
}
Consulte tambm

loadVariables, XML.send, XML.sendAndLoad, XMLSocket.send

getVersion
Disponibilidade

Flash Player 5.
Uso

getVersion()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Funo; retorna uma seqncia de caracteres contendo informaes sobre a verso e plataforma
do Flash Player.
A funo getVersion s retorna informaes para Flash Player 5 ou verses posteriores.
Exemplo

O exemplo a seguir mostra uma seqncia de caracteres apresentada como resposta pela funo
getVersion.
WIN 5,0,17,0

Isso indica que a plataforma Windows e o nmero da verso do Flash Player verso 5 principal,
verso secundria 17(5.0r17).

_global
Disponibilidade

Flash Player 6.
Uso

_global.identifier
Parmetros

Nenhum.

253

Retorna

Uma referncia ao objeto global que possui as principais classes ActionScript, como String,
Object, Math e Array.
Descrio

Identificador; cria variveis globais, objetos ou classes. Por exemplo, voc poderia criar uma
biblioteca que exposta como um objeto global ActionScript, muito parecido com o objeto Math
ou Date. Diferentemente das variveis declaradas na Linha de tempo ou em nvel local, as
variveis e funes globais so visveis em todas as Linhas de Tempo e escopos no filme Flash,
desde que no sejam encobertas por identificadores com nomes idnticos em escopos internos.
Exemplo

O exemplo a seguir cria uma funo de nvel superior factorial que est disponvel para todas as
Linhas de tempo e escopos no filme Flash:
_global.factorial = function (n) {
if (n <= 1) {
return 1;
else {
return n * factorial(n-1);
}
}
Consulte tambm

var, set variable

globalStyleFormat
Disponibilidade

Flash Player 6.
Uso

globalStyleFormat.styleProperty
Parmetros

styleProperty

Uma propriedade do objeto FStyleFormat.

Retorna

Nada.
Descrio

Instncia de objeto; uma instncia do objeto FStyleFormat que define as propriedades de formato
de estilo para componentes de interface de usurio Flash. A instncia globalStyleFormat fica
disponvel quando um componente de interface de usurio Flash inserido no Palco. Voc define
ou altera propriedades de formato de estilo para componentes de interface de usurio Flash
editando as propriedades na instncia de objeto globalStyleFormat. Para obter mais
informaes, consulte Personalizando cores e texto do componente no captulo Usando
componentes de Usando o Flash.
Exemplo

O cdigo a seguir define a propriedade arrow da propriedade FStyleFormat para a instncia

globalStyleFormat.
globalStyleFormat.arrow = 0x800080;
Consulte tambm

FStyleFormat (object)

Dicionrio ActionScript 254

gotoAndPlay
Disponibilidade

Flash 2.
Uso

gotoAndPlay(scene, frame)
Parmetros

scene

O nome da cena para onde a reproduo enviada.

frame

O nmero do quadro ou rtulo para onde a reproduo enviada.

Retorna

Nada.
Descrio

Ao; envia a reproduo para o quadro especificado em uma cena e reproduz a partir desse quadro.
Se no for especificada uma cena, a reproduo segue para o quadro especificado na cena atual.
Exemplo

Quando o usurio clica em um boto com a ao gotoAndPlay atribuda, a reproduo enviada

para o Quadro 16 e comea a reproduzir.
on(release) {
gotoAndPlay(16);
}

gotoAndStop
Disponibilidade

Flash 2.
Uso

gotoAndStop(scene, frame)
Parmetros

scene

O nome da cena para onde a reproduo enviada.

frame

O nmero do quadro ou rtulo para onde a reproduo enviada.

Retorna

Nada.
Descrio

Ao; envia a reproduo para o quadro especificado em uma cena e a interrompe. Se no for
especificada uma cena, a reproduo segue para o quadro especificado na cena atual.
Exemplo

Quando o usurio clica em um boto ao qual est atribuda a ao gotoAndStop, a reproduo

enviada para o quadro 5 e o filme pra de ser reproduzido.
on(release) {
gotoAndStop(5);
}

255

gt (maior que especfico de seqncias de caracteres)

Disponibilidade

Flash Player 4. Este operador foi reprovado no Flash 5 e substitudo pelo novo operador > (maior
que).
Uso

expresso1 gt expresso2
Parmetros

expression1,expression2

Nmeros, seqncias de caracteres ou variveis.

Descrio

Operador (comparao); compara a representao em seqncia de caracteres da expresso1

com a representao em seqncia de caracteres da expresso2 e retorna true se a expresso1
for maior que a expresso2; caso contrrio, retorna false.
Consulte tambm

> (maior que)

_highquality
Disponibilidade

Flash Player 4.
Uso

_highquality
Descrio

Propriedade (global); especifica o nvel de sem serrilhado aplicado no filme atual. Especifique 2
(MELHOR) para aplicar alta qualidade com a suavizao de bitmap sempre ativada. Especifique
1 (alta qualidade) para aplicar o recurso sem serrilhado; isso suavizar os bitmaps se o filme no
contiver animao. Especifique 0 (baixa qualidade) para evitar o recurso sem serrilhado.
Exemplo

_highquality = 1;
Consulte tambm

_quality, toggleHighQuality

if
Disponibilidade

Flash Player 4.
Uso

if(condio) {
comando(s);
}
Parmetros

condio
comando(s)

Uma expresso que seja avaliada como true ou false.

As instrues a serem executadas se ou quando a condio for avaliada como true.

Dicionrio ActionScript 256

Retorna

Nada.
Descrio

Ao; avalia uma condio para determinar a prxima ao em um filme. Se a condio for true,
o Flash executar os comandos aps a condio dentro das chaves ({}). Se a condio for false, o
Flash ignorar os comandos contidos nas chaves e executar os comandos posteriores a elas. Use a
ao if para criar lgica ramificada em seus scripts.
Exemplo

No exemplo a seguir, a condio entre parnteses avalia a varivel name para verificar se ela tem o
valor literal Erica. Caso tenha, a ao play entre as chaves executada.
if(name == "Erica"){
play();
}
Exemplo

O exemplo a seguir utiliza uma ao if para avaliar quando o usurio libera um objeto arrastvel
no filme. Se o objeto tiver sido liberado menos de 300 milissegundos depois de arrastado, a
condio ser avaliada como true e os comandos entre as chaves sero executados. Esses
comandos definem variveis para armazenar informaes como a nova posio do objeto, a fora e
a velocidade com que ele foi lanado. A varivel timePressed tambm redefinida. Se o objeto
tiver sido liberado mais de 300 milissegundos depois de arrastado, a condio ser avaliada como
false e nenhum comando ser executado.
if (getTimer()<timePressed+300) {
// se a condio for true,
// o objeto foi lanado.
// qual a nova posio deste objeto?
xNewLoc = this._x;
yNewLoc = this._y;
//qual a fora empregada para seu lanamento?
xTravel = xNewLoc-xLoc;
yTravel = yNewLoc-yLoc;
// a definio da velocidade do objeto depende
// da distncia percorrida
xInc = xTravel/2;
yInc = yTravel/2;
timePressed = 0;
}
Consulte tambm

else

257

ifFrameLoaded
Disponibilidade

Flash Player 3. A ao ifFrameLoaded foi reprovada no Flash 5; o uso da ao

MovieClip._framesloaded encorajado.
Uso

ifFrameLoaded(cena, quadro) {
comando;
}
ifFrameLoaded(quadro) {
comando(s);
}
Parmetros

cena

A cena que deve ser carregada.

quadro

O nmero ou rtulo do quadro que deve ser carregado antes da execuo do prximo

comando.
comando(s) As instrues a serem executadas se uma determinada cena (ou cena e quadro
especficos) for carregada.
Retorna

Nada.
Descrio

Ao; verifica se o contedo de um quadro especfico est disponvel localmente. Use

ifFrameLoaded para iniciar a reproduo de uma animao simples enquanto o resto do filme
descarregado para o computador local. A diferena entre o uso de _framesloaded e
ifFrameLoaded que _framesloaded permite que voc adicione seus prprios comandos if ou
else.
Consulte tambm

MovieClip._framesloaded

#include
Disponibilidade

N/A
Uso

#include "filename.as"
Parmetros

O nome do arquivo para o script a ser adicionado ao painel Aes; .as a

extenso de arquivo recomendada.

filename.as
Retorna

Nada.
Descrio

Ao; inclui o contedo do arquivo especificado no parmetro quando o filme testado,

publicado ou exportado. A ao #include chamada quando voc testa, publica ou exporta. A
ao #include verificada quando ocorre uma verificao de sintaxe.

Dicionrio ActionScript 258

#initclip
Disponibilidade

Flash Player 6.
Uso

#initclip order
Parmetros

Um nmero inteiro que especifica a ordem de execuo de blocos de cdigo #initclip.

Este um parmetro opcional.

order

Descrio

Ao; indica o incio de um bloco de aes de inicializao de componentes. Quando vrios clipes
so inicializados ao mesmo tempo, voc pode usar o parmetro order (ordem) para especificar a
inicializao que ocorrer primeiro. As aes de inicializao de componentes so executadas
quando um smbolo de clipe de filme definido. Se o clipe de filme for um smbolo exportado, as
aes de inicializao de componentes sero executadas antes das aes no Quadro 1 do arquivo
SWF. Caso contrrio, elas sero executadas imediatamente antes das aes do quadro que contm
a primeira instncia do smbolo de clipe de filme associado.
As aes de inicializao de componentes so executadas apenas uma vez durante a reproduo de
um filme e voc deve us-las para inicializaes de uma etapa, como a definio e o registro de
classes.
Exemplo

O exemplo de cdigo a seguir foi atribudo ao primeiro quadro de um filme que um

componente de caixa de seleo. As aes #initclip e #endinitclip indicam o bloco de
condies que delimitam como aes de inicializao de componente. Os comandos delimitados
registram a classe e os mtodos de armazenamento em um objeto de prottipo.
#initclip
if (typeof(CheckBox) == "indefinido") {
// Definir o construtor para (e, portanto, definir) a classe CheckBox
function CheckBox() {
//Configurar nossas vinculaes de dados
this.watch ('value', function (id, oldval, newval) { ... };
this.watch ('label', function (id, oldval, newval) { ... };
}
// Definir que a cadeia de prottipos CheckBox herda de MovieClip
CheckBox.prototype = new MovieClip();
// Registrar CheckBox como a classe do smbolo de "Caixa de seleo"
Object.registerClass("Caixa de seleo", CheckBox);
// Configurar alguns mtodos
CheckBox.prototype.enable = function () { ... };
CheckBox.prototype.show = function () { ... };
CheckBox.prototype.hide = function () { ... };
// Configurar uma funo conveniente para criar
// caixas de seleo
CheckBox.create = function (parentMovieClip, instanceName, depth) {
parentMovieClip.attachMovie("CheckBox", instanceName, depth);
};
}
#endinitclip
Observao: Se voc copiar e colar esse cdigo no painel Aes, ser gerado um erro quando o script for
compilado por causa das funes indefinidas ({...})

Consulte tambm

#endinitclip

259

instanceof
Disponibilidade

Flash Player 6.
Uso

object instanceof class

Parmetros

Um objeto ActionScript.

object
class

Uma referncia a uma funo construtora ActionScript, como String ou Date.

Retorna

Se o objeto for uma instncia de classe, instanceof retornar true; caso contrrio,
instanceof retornar false.
Descrio

Operador; determina se um objeto pertence a uma determinada classe. Testa se o objeto uma
instncia de classe.
Um objeto ActionScript considerado uma instncia de uma classe quando o objeto de prottipo
da funo construtora est na cadeia de prottipos do objeto ActionScript.
O operador instanceof no converte tipos primitivos em objetos envoltrios. Por exemplo, o
cdigo a seguir retorna true:
new String("Ol") instanceof String

J o cdigo a seguir retorna false:

"Ol" instanceof String
Exemplo

Para ilustrar o algoritmo do operador instanceof, o exemplo a seguir mostra a aparncia possvel
desse operador instanceof caso seja codificado como uma funo do ActionScript.
function instanceof (theObject, theClass){
while ((theObject = theObject.__proto__) != null) {
if (theObject == theClass.prototype) {
return true;
}
}
return false;
}
Consulte tambm

typeof

Dicionrio ActionScript 260

int
Disponibilidade

Flash Player 4. Esta funo foi reprovada no Flash 5 e substituda pelo mtodo Math.round.
Uso

int(valor)
Parmetros

valor

Um nmero a ser arredondado para um inteiro.

Retorna

Nada.
Descrio

Funo; converte um nmero decimal no valor inteiro mais prximo.

Consulte tambm

Math.floor

isFinite
Disponibilidade

Flash Player 5.
Uso

isFinite(expresso)
Parmetros

expresso

Um valor booleano, varivel ou outra expresso a ser avaliada.

Retorna

Nada.
Descrio

Funo de alto nvel; avalia a expresso e retorna true se for um nmero finito e false se for
um nmero infinito ou infinito negativo. A presena do infinito ou infinito negativo indica uma
condio de erro matemtico como uma diviso por 0.
Exemplo

A seguir so mostrados exemplos dos valores retornados por isFinite:

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

261

isNaN
Disponibilidade

Flash Player 5.
Uso

isNaN(expresso)
Parmetros

expresso

Um valor booleano, varivel ou outra expresso a ser avaliada.

Retorna

Nada.
Descrio

Funo de alto nvel; avalia o parmetro e retorna true se o valor no for um nmero (NaN),
indicando a presena de erros matemticos.
Exemplo

O cdigo a seguir demonstra valores de retorno para a funo isNan.

isNan("rvore")
// retorna true
isNan(56)
// retorna false
isNaN(Number.POSITIVE_INFINITY)
// retorna false

Key (objeto)
O objeto Key um objeto de alto nvel que voc pode acessar sem usar um construtor. Use os
mtodos do objeto Key para criar uma interface que pode ser controlada por um usurio com um
teclado padro. As propriedades do objeto Key so constantes que representam as teclas mais
comumente usadas para controlar jogos. Para obter uma lista completa de valores do cdigo de
tecla, consulte o apndice Teclas do teclado e valores de cdigos de teclas em Usando o Flash.
Exemplo

O script a seguir usa o objeto Key para identificar teclas em qualquer teclado, de forma que o
usurio possa controlar um clipe de filme.
onClipEvent (enterFrame) {
if(Key.isDown(Key.RIGHT)) {
this._x=_x+10;
} else if (Key.isDown(Key.DOWN)) {
this._y=_y+10;
}
}

Dicionrio ActionScript 262

Resumo dos mtodos do objeto Key

Mtodo

Descrio

Key.addListener

Registra um objeto para receber a notificao quando os mtodos onKeyDown e

onKeyUp so chamados.

Key.getAscii

Retorna o valor ASCII da ltima tecla pressionada.

Key.getCode

Retorna o cdigo de tecla virtual da ltima tecla pressionada.

Key.isDown

Retorna true se a tecla especificada no parmetro for pressionada.

Key.isToggled

Retorna true se a tecla Num Lock ou Caps Lock estiver ativada.

Key.removeListener

Remove um objeto que foi registrado anteriormente com addListener.

Resumo das propriedades do objeto Key

Todas as propriedades do objeto Key so constantes.
Propriedade

Descrio

Key.BACKSPACE

Constante associada ao valor do cdigo da tecla Backspace (8).

Key.CAPSLOCK

Constante associada ao valor do cdigo da tecla Caps Lock (20).

Key.CONTROL

Constante associada ao valor do cdigo da tecla Control (17).

Key.DELETEKEY

Constante associada ao valor do cdigo da tecla Delete (46).

Key.DOWN

Constante associada ao valor do cdigo da tecla Seta para baixo (40).

Key.END

Constante associada ao valor do cdigo da tecla End (35).

Key.ENTER

Constante associada ao valor do cdigo da tecla Enter (13).

Key.ESCAPE

Constante associada ao valor do cdigo da tecla Escape (27).

Key.HOME

Constante associada ao valor do cdigo da tecla Home (36).

Key.INSERT

Constante associada ao valor do cdigo da tecla Insert (45).

Key.LEFT

Constante associada ao valor do cdigo da tecla Seta para esquerda (37).

Key.PGDN

Constante associada ao valor do cdigo da tecla Page Down (34).

Key.PGUP

Constante associada ao valor do cdigo da tecla Page Up (33).

Key.RIGHT

Constante associada ao valor do cdigo da tecla Seta para direita (39).

Key.SHIFT

Constante associada ao valor do cdigo da tecla Shift (16).

Key.SPACE

Constante associada ao valor do cdigo de tecla da Barra de espaos (32).

Key.TAB

Constante associada ao valor do cdigo da tecla Tab (9).

Key.UP

Constante associada ao valor do cdigo da tecla Seta para cima (38).

Resumo dos ouvintes do objeto Key

263

Mtodo

Descrio

Key.onKeyDown

Notificado quando uma tecla pressionada.

Key.onKeyUp

Notificado quando uma tecla liberada

Key.addListener
Disponibilidade

Flash Player 6.
Uso

Key.addListener (newListener)
Parmetros

newListener

Um objeto com os mtodos onKeyDown e onKeyUp.

Retorna

Nada.
Descrio

Mtodo; registra um objeto para receber a notificao onKeyDown e onKeyUp. Quando uma tecla
pressionada ou liberada, independentemente do foco de entrada, todos os objetos ouvintes
registrados com addListener tm o mtodo onKeyDown ou onKeyUp chamado. Vrios objetos
podem ouvir notificaes de teclado. Se o ouvinte newListener j estiver registrado, nenhuma
alterao ocorrer.
Exemplo

Este exemplo cria um novo objeto ouvinte e define uma funo para onKeyDown e onKeyUp. A
ltima linha usa o mtodo addListener para registrar o ouvinte com o objeto Key para que possa
receber notificaes de eventos de tecla pressionada e tecla liberada.
myListener = new Object();
myListener.onKeyDown = function () {
trace ("Voc pressionou uma tecla.");
}
myListener.onKeyUp = function () {
trace ("Voc liberou uma tecla.");
}
Key.addListener(myListener);

Key.BACKSPACE
Disponibilidade

Flash Player 5.
Uso

Key.BACKSPACE
Descrio

Propriedade; constante associada ao valor do cdigo da tecla Backspace (8).

Key.CAPSLOCK
Disponibilidade

Flash Player 5.
Uso

Key.CAPSLOCK
Descrio

Propriedade; constante associada ao valor do cdigo da tecla Caps Lock (20).

Dicionrio ActionScript 264

Key.CONTROL
Disponibilidade

Flash Player 5.
Uso

Key.CONTROL
Descrio

Propriedade; constante associada ao valor do cdigo da tecla Control (17).

Key.DELETEKEY
Disponibilidade

Flash Player 5.
Uso

Key.DELETEKEY
Descrio

Propriedade; constante associada ao valor do cdigo da tecla Delete (46).

Key.DOWN
Disponibilidade

Flash Player 5.
Uso

Key.DOWN
Descrio

Propriedade; constante associada ao valor do cdigo da tecla Seta para baixo (40).

Key.END
Disponibilidade

Flash Player 5.
Uso

Key.END
Descrio

Propriedade; constante associada com o valor do cdigo de chave da tecla End (35).

Key.ENTER
Disponibilidade

Flash Player 5.
Uso

Key.ENTER
Descrio

Propriedade; constante associada ao valor do cdigo da tecla Enter (13).

265

Key.ESCAPE
Disponibilidade

Flash Player 5.
Uso

Key.ESCAPE
Descrio

Propriedade; constante associada ao valor do cdigo da tecla Escape (27).

Key.getAscii
Disponibilidade

Flash Player 5.
Uso

Key.getAscii();
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; retorna o cdigo ASCII da ltima tecla pressionada ou liberada. Os valores ASCII
retornados correspondem aos valores do teclado ingls. Por exemplo, se voc pressionar Shift+2,
Key.getAscii retornar @ em um teclado japons, da mesma forma que ocorre com um teclado
ingls.

Key.getCode
Disponibilidade

Flash Player 5.
Uso

Key.getCode();
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; retorna o valor do cdigo de tecla da ltima tecla pressionada. Para associar o valor do
cdigo de tecla retornado tecla virtual em um teclado padro, utilize as informaes do
Apndice C, Teclas do teclado e valores de cdigos de teclas de Usando o Flash.

Dicionrio ActionScript 266

Key.HOME
Disponibilidade

Flash Player 5.
Uso

Key.HOME
Descrio

Propriedade; constante associada ao valor do cdigo da tecla Home (36).

Key.INSERT
Disponibilidade

Flash Player 5.
Uso

Key.INSERT
Descrio

Propriedade; constante associada ao valor do cdigo da tecla Insert (45).

Key.isDown
Disponibilidade

Flash Player 5.
Uso

Key.isDown(keycode);
Parmetros

keycode O valor do cdigo de tecla atribudo a uma determinada tecla ou propriedade do

objeto Key associada a uma tecla especfica. Para obter uma lista de todos os cdigos associados s
teclas de um teclado padro, consulte o Apndice C, Teclas do teclado e valores de cdigos de
teclas de Usando o Flash.
Retorna

Nada.
Descrio

Mtodo; retorna true se a tecla especificada em cdigo_de_tecla pressionada. No Macintosh,

os valores do cdigo de tecla das teclas Caps Lock e Num Lock so idnticos.

Key.isToggled
Disponibilidade

Flash Player 5.
Uso

Key.isToggled(keycode)
Parmetros

keycode

267

O cdigo da tecla Caps Lock (20) ou Num Lock (144).

Retorna

Nada.
Descrio

Mtodo; retorna true se a tecla Caps Lock ou Num Lock estiver ativada (ou for alternada). No
Macintosh, os valores de cdigo de tecla para essas teclas so idnticos.

Key.LEFT
Disponibilidade

Flash Player 5.
Uso

Key.LEFT
Descrio

Propriedade; constante associada ao valor do cdigo de tecla para a tecla Seta para esquerda (37).

Key.onKeyDown
Disponibilidade

Flash Player 6.
Uso

someListener.onKeyDown
Descrio

Ouvinte; notificado quando uma tecla pressionada. necessrio criar um objeto ouvinte para
usar onKeyDown. Em seguida, possvel definir uma funo para onKeyDown e usar o mtodo
addListener para registrar o ouvinte com o objeto Key, como mostrado a seguir:
someListener = new Object();
someListener.onKeyDown = function () { ... };
Key.addListener(someListener);

Os ouvintes permitem a cooperao de partes diferentes de cdigo. Isso ocorre porque vrios
ouvintes podem receber notificaes sobre um nico evento.
Consulte tambm

Key.addListener

Key.onKeyUp
Disponibilidade

Flash Player 6.
Uso

someListener.onKeyUp

Dicionrio ActionScript 268

Descrio

Ouvinte; notificado quando uma tecla liberada. necessrio criar um objeto ouvinte para usar
onKeyUp. Em seguida, possvel definir uma funo para onKeyUp e usar o mtodo addListener
para registrar o ouvinte no objeto Key, como mostrado a seguir:
someListener = new Object();
someListener.onKeyUp = function () { ... };
Key.addListener(someListener);

Os ouvintes permitem a cooperao de partes diferentes de cdigo. Isso ocorre porque vrios
ouvintes podem receber notificaes sobre um nico evento.
Consulte tambm

Key.addListener

Key.PGDN
Disponibilidade

Flash Player 5.
Uso

Key.PGDN
Descrio

Propriedade; constante associada ao valor do cdigo de tecla para a tecla Page Down (34).

Key.PGUP
Disponibilidade

Flash Player 5.
Uso

Key.PGUP
Descrio

Propriedade; constante associada ao valor do cdigo da tecla Page Up (33).

Key.removeListener
Disponibilidade

Flash Player 6.
Uso

Key.removeListener (ouvinte)
Parmetros

ouvinte

Um objeto.

Retorna

Se o ouvinte tiver sido removido com xito, o mtodo retornar true. Caso o ouvinte no
tenha sido removido com xito, por exemplo, se ele no estava na lista de ouvintes do objeto Key,
o mtodo retornar false.
Descrio

Mtodo; remove um objeto anteriormente registrado com o mtodo addListener.

269

Key.RIGHT
Disponibilidade

Flash Player 5.
Uso

Key.RIGHT
Descri

o
Propriedade; constante associada ao valor do cdigo da tecla Seta para direita (39).

Key.SHIFT
Disponibilidade

Flash Player 5.
Uso

Key.SHIFT
Descrio

Propriedade; constante associada ao valor do cdigo da tecla Shift (16).

Key.SPACE
Disponibilidade

Flash Player 5.
Uso

Key.SPACE
Descrio

Propriedade; constante associada ao valor do cdigo de tecla da Barra de espaos (32).

Key.TAB
Disponibilidade

Flash Player 5.
Uso

Key.TAB
Descrio

Propriedade; constante associada ao valor do cdigo da tecla Tab (9).

Key.UP
Disponibilidade

Flash Player 5.
Uso

Key.UP
Descrio

Propriedade; constante associada ao valor do cdigo da tecla Seta para cima (38).

Dicionrio ActionScript 270

le (menor que ou igual a especfico da seqncia de

caracteres)
Disponibilidade

Flash Player 4. Este operador foi reprovado no Flash 5 e substitudo pelo operador <= (menor ou
igual a) .
Uso

expression1 le expression2
Parmetros

expression1,expression2

Nmeros, seqncias de caracteres ou variveis.

Retorna

Nada.
Descrio

Operador (comparao); compara expression1 com expression2 e retorna um valor true se

expression1 for menor ou igual a expresssion2; de outra forma, retorna um valor false.
Consulte tambm

<= (menor ou igual a)

length
Disponibilidade

Flash Player 4. Esta funo, assim como todas as funes de seqncias de caracteres, foi
reprovada no Flash 5. Recomenda-se utilizar os mtodos e a propriedade length do objeto String
para a realizao das mesmas operaes.
Uso

length(expresso)
length(varivel)
Parmetros

expresso
varivel

Uma seqncia de caracteres.

O nome de uma varivel.

Retorna

Nada.
Descrio

Funo de seqncia de caracteres; retorna o comprimento da seqncia de caracteres ou do nome

da varivel especificada.
Exemplo

O exemplo a seguir retorna o valor da seqncia de caracteres "Ol".

length("Ol");

O resultado 4.
Consulte tambm

" " (delimitador de seqncia de caracteres), String.length

271

_level
Disponibilidade

Flash Player 4.
Uso

_levelN
Descrio

Propriedade; uma referncia ao filme raiz Linha de tempo de _levelN. necessrio empregar a
ao loadMovieNum para carregar filmes no Flash Player antes de usar a propriedade _level para
especific-los. Tambm possvel utilizar _levelN para especificar um filme carregado no nvel
atribudo por N.
O filme inicial carregado em uma instncia do Flash Player carregado automaticamente em
_level0. O filme em _level0 define a taxa de quadros, a cor de fundo e o tamanho do quadro
para todos os outros filmes carregados. Em seguida, os filmes so empilhados em nveis que
recebem nmeros mais altos do que o do filme em _level0.
necessrio atribuir um nvel para cada filme carregado no Flash Player com a ao
loadMovieNum. possvel atribuir nveis em qualquer ordem. Se voc atribuir um nvel que j
contenha um arquivo SWF (inclusive _level0), o filme nesse nvel ser descarregado e
substitudo pelo novo.
Exemplo

O exemplo a seguir interrompe a reproduo na Linha de tempo principal do filme em _level9.

_level9.stop();

O exemplo a seguir envia a reproduo na Linha de tempo principal do filme em _level4 para o
quadro 5. necessrio que o filme em _level4 tenha sido carregado anteriormente com uma
ao loadMovieNum.
_level4.gotoAndStop(5);
Consulte tambm

loadMovie, MovieClip.swapDepths

loadMovie
Disponibilidade

Flash Player 3.
Uso

loadMovie("url",nvel/destino[, variveis])
Parmetros

url O URL absoluto ou relativo do arquivo SWF ou JPEG que deve ser carregado. Um
caminho relativo deve ser relativo ao arquivo SWF no nvel 0. O URL deve estar no mesmo
subdomnio que o URL onde o filme reside no momento. Para uso no Flash Player ou para
verificaes no modo de teste do aplicativo de criao Flash, todos os arquivos SWF devem ser
armazenados na mesma pasta, e os nomes dos arquivos no podem incluir especificaes de pasta
ou unidade de disco.

Dicionrio ActionScript 272

destino Um caminho para um clipe de filme de destino. O clipe de filme de destino ser
substitudo pelo filme ou pela imagem carregada. necessrio especificar um clipe de filme de
destino ou um nvel de filme de destino; no possvel especificar as duas opes.
nvel Um inteiro que especifica o nvel no qual o filme foi carregado no Flash Player. Quando
voc carrega um filme ou imagem em um determinado nvel, a ao loadMovie do painel Aes
no modo normal alterna para loadMovieNum; no modo Especialista, necessrio especificar
loadMovieNum ou escolher essa opo na caixa de ferramentas Aes.
variveis Um parmetro opcional que especifica um mtodo HTTP para o envio de variveis.
O parmetro deve ser a seqncia de caracteres GET ou POST. Se no houver nenhuma varivel a
ser enviada, omita esse parmetro. O mtodo GET anexa as variveis ao final do URL e usado
para pequenos nmeros de variveis. O mtodo POST envia as variveis em um cabealho HTTP
separado e usado para seqncias de caracteres maiores de variveis.
Retorna

Nada.
Descrio

Ao; carrega um arquivo SWF ou JPEG no Flash Player durante a reproduo do filme original.
A ao loadMovie permite que voc exiba vrios filmes de uma vez ou alterne entre os filmes sem
carregar outro documento HTML. Sem a ao loadMovie, o Flash Player exibe um nico filme
(arquivo SWF) e encerrado em seguida
Quando voc usa a ao loadMovie, necessrio especificar um nvel no Flash Player ou um clipe
de filme de destino no qual o filme ser carregado. Se voc especificar um nvel, a ao ser
alterada para loadMovieNum. Se um filme for carregado em um clipe de filme de destino, voc
poder usar o caminho de destino desse clipe para especificar o filme carregado.
Um filme ou imagem carregada em um destino herda as propriedades de posio, rotao e
dimensionamento do clipe de filme de destino. O canto superior esquerdo da imagem ou filme
carregado alinhado ao ponto de registro do clipe de filme de destino. Como alternativa, se o
destino for a Linha de tempo _root, o canto superior esquerdo da imagem ou filme alinhado ao
canto superior esquerdo do Palco.
Use a ao unloadMovie para remover os filmes carregados com a ao loadMovie.
Exemplo

O comando loadMovie a seguir anexado a um boto de navegao chamado Produtos. H um

clipe de filme invisvel no Palco com o nome de instncia dropZone. A ao loadMovie usa este
clipe de filme como o parmetro de destino para carregar os produtos no arquivo SWF, na posio
correta no Palco.
on(release) {
loadMovie("products.swf",_root.dropZone);
}

O exemplo a seguir carrega uma imagem JPEG do mesmo diretrio que o arquivo SWF que
chama a ao loadMovie:
loadMovie("image45.jpeg", "nosso_clipe_de_filme");
Consulte tambm

loadMovieNum, unloadMovie, unloadMovieNum, _level

273

loadMovieNum
Disponibilidade

Flash Player 4. Os arquivos do Flash 4 abertos no Flash 5 so convertidos para que utilizem a
sintaxe correta.
Uso

loadMovieNum("url",nvel[, variveis])
Parmetros

O URL absoluto ou relativo do arquivo SWF ou JPEG a ser carregado. Um caminho

relativo deve ser relativo ao arquivo SWF no nvel 0. O URL deve estar no mesmo subdomnio
que o URL onde o filme reside no momento. Para uso no Flash Player independente ou para
verificaes no modo de teste de filme no aplicativo de criao Flash, todos os arquivos SWF
devem ser armazenados na mesma pasta e os nomes dos arquivos no podem incluir especificaes
de pasta ou unidade de disco.

url

nvel

Um inteiro que especifica o nvel no qual o filme foi carregado no Flash Player.

variveis Um parmetro opcional que especifica um mtodo HTTP para o envio de variveis.
O parmetro deve ser a seqncia de caracteres GET ou POST. Se no houver nenhuma varivel a
ser enviada, omita esse parmetro. O mtodo GET anexa as variveis ao final do URL e usado
para pequenos nmeros de variveis. O mtodo POST envia as variveis em um cabealho HTTP
separado e usado para seqncias de caracteres maiores de variveis.
Retorna

Nada.
Descrio

Ao; carrega um arquivo SWF ou JPEG em um nvel do Flash Player durante a reproduo do
filme carregado originalmente. Quando voc carrega um filme em um nvel em vez de faz-lo em
um destino, a ao loadMovie do painel Aes no modo normal alterna para loadMovieNum; no
modo Especialista, necessrio especificar loadMovieNum ou escolher essa opo na caixa de
ferramentas Aes. Normalmente, o Flash Player exibe um nico filme (arquivo SWF) e em
seguida encerrado. A ao loadMovieNum permite que voc exiba vrios filmes de uma vez ou
alterne entre os filmes sem carregar outro documento HTML.
O Flash Player apresenta uma ordem de empilhamento de nveis iniciada em 0. Esses nveis so
como camadas de acetato: transparentes, a no ser pelos objetos em cada nvel. Quando voc usa a
ao loadMovieNum, necessrio especificar um nvel do Flash Player no qual o filme ser
carregado. Quando um filme carregado em um determinado nvel, possvel usar a sintaxe
_levelN, na qual N o nmero do nvel para especificar o filme.
Quando voc carrega um filme, pode especificar qualquer nmero de nvel, alm de carregar
filmes em um nvel que j tenha um arquivo SWF carregado. Se voc o fizer, o novo filme ir
substituir o arquivo SWF existente. Se voc carregar um filme no nvel 0, todos os nveis do Flash
Player sero descarregados. Alm disso, o nvel 0 ser substitudo pelo novo arquivo. O filme no
nvel 0 define a taxa de quadros, a cor de fundo e o tamanho do quadro para todos os outros
filmes carregados.

Dicionrio ActionScript 274

A ao loadMovieNum tambm permite carregar arquivos JPEG em um filme durante sua

reproduo. No caso de imagens e arquivos SWF, o canto superior esquerdo da imagem
alinhado com o canto superior esquerdo do Palco durante o carregamento do arquivo. Alm disso,
nos dois casos o arquivo carregado herda a rotao e o dimensionamento, sendo que o contedo
original substitudo.
Use a ao unloadMovieNum
loadMovieNum.

para remover filmes ou imagens carregadas com a ao

Exemplo

Este exemplo carrega a imagem JPEG image45.jpg no nvel 2 do Flash Player.

loadMovieNum("http://www.blag.com/image45.jpg", 2); //
Consulte tambm

loadMovie, unloadMovie, unloadMovieNum, _level

loadVariables
Disponibilidade

Flash Player 4.
Uso

loadVariables ("url" ,nvel/"destino" [, variveis])

Parmetros

url Um URL absoluto ou relativo no qual as variveis esto localizadas. Se voc acessar o filme
com um navegador da Web, o host do URL dever estar no mesmo subdomnio do filme.

Um inteiro que especifica o nvel que receber as variveis no Flash Player. Quando voc
carrega variveis em um nvel, a ao do painel Aes no modo normal torna-se
loadVariablesNum; no modo Especialista necessrio especificar loadVariablesNum ou
escolher essa opo na caixa de ferramentas Aes.
nvel

destino O caminho de destino para um clipe de filme que recebe as variveis carregadas.
necessrio especificar um clipe de filme de destino ou um nvel (nvel) no Flash Player; no
possvel especificar as duas opes.
variveis Um parmetro opcional que especifica um mtodo HTTP para o envio de variveis.
O parmetro deve ser a seqncia de caracteres GET ou POST. Se no houver nenhuma varivel a
ser enviada, omita esse parmetro. O mtodo GET anexa as variveis ao final do URL e usado
para pequenos nmeros de variveis. O mtodo POST envia as variveis em um cabealho HTTP
separado e usado para seqncias de caracteres maiores de variveis.
Retorna

Nada.
Descrio

Ao; l dados de um arquivo externo, como um arquivo de texto ou texto gerado por um script
CGI, Active Server Pages (ASP) ou PHP, ou ainda um script Perl e define os valores das variveis
em um nvel do Flash Player ou um clipe de filme de destino. Essa ao tambm pode ser usada
para atualizar as variveis no filme ativo com novos valores.

275

O texto no URL especificado deve ter o formato MIME padro aplicativo/x-www-formato de

url codificado (um formato padro usado por scripts CGI). O filme e as variveis a serem
carregadas devem residir no mesmo subdomnio. Qualquer nmero de variveis pode ser
especificado. Por exemplo, a frase abaixo define vrias variveis:
company=Macromedia&address=600+Townsend&city=San+Francisco&zip=94103

O primeiro filme a ser aberto em uma instncia do Flash Player carregado no nvel inferior
(identificado no cdigo como _level0). Quando voc usa a ao loadMovie ou loadMovieNum
para carregar filmes subseqentes no Flash Player, necessrio atribuir um nmero de nvel no
Flash Player ou um clipe de filme de destino no qual cada filme ser carregado. Quando voc usa
a ao loadVariables, necessrio especificar um nvel do Flash Player ou um clipe de filme de
destino no qual as variveis sero carregadas.
Exemplo

Este exemplo carrega informaes de um arquivo de texto em campos de texto no clipe de filme
varTarget da Linha de tempo principal. Os nomes das variveis dos campos de texto devem
corresponder aos nomes das variveis no arquivo data.txt.
on(release) {
loadVariables("data.txt", "_root.varTarget");
}
Consulte tambm

loadVariablesNum, loadMovie, loadMovieNum, getURL, MovieClip.loadMovie,

MovieClip.loadVariables

loadVariablesNum
Disponibilidade

Flash Player 4. Os arquivos do Flash 4 abertos no Flash 5 so convertidos para que utilizem a
sintaxe correta.
Uso

loadVariables ("url" ,nvel [, variveis])

Parmetros

url Um URL absoluto ou relativo no qual as variveis esto localizadas. Se voc acessar o filme
com um navegador da Web, o host do URL dever estar no mesmo subdomnio do filme.
nvel

Um inteiro que especifica o nvel que receber as variveis no Flash Player.

variveis Um parmetro opcional que especifica um mtodo HTTP para o envio de variveis.
O parmetro deve ser a seqncia de caracteres GET ou POST. Se no houver nenhuma varivel a
ser enviada, omita esse parmetro. O mtodo GET anexa as variveis ao final do URL e usado
para pequenos nmeros de variveis. O mtodo POST envia as variveis em um cabealho HTTP
separado e usado para seqncias de caracteres maiores de variveis.
Retorna

Nada.

Dicionrio ActionScript 276

Descrio

Ao; l os dados de um arquivo externo, como um arquivo de texto ou texto gerado por um
script CGI, Active Server Pages (ASP) ou PHP e define os valores das variveis em um nvel do
Flash Player. Essa ao tambm pode ser usada para atualizar as variveis no filme ativo com novos
valores. Quando voc carrega variveis em um nvel, a ao do painel Aes no modo normal
torna-se loadVariablesNum; no modo Especialista necessrio especificar loadVariablesNum
ou escolher essa opo na caixa de ferramentas Aes.
O texto no URL especificado deve ter o formato MIME padro aplicativo/x-www-formato de
url codificado (um formato padro usado por scripts CGI). O filme e as variveis a serem
carregadas devem residir no mesmo subdomnio. Qualquer nmero de variveis pode ser
especificado. Por exemplo, a frase abaixo define vrias variveis:
company=Macromedia&address=600+Townsend&city=San+Francisco&zip=94103

O primeiro filme a ser aberto em uma instncia do Flash Player carregado no nvel inferior
(identificado no cdigo como _level0). Quando voc usa a ao loadMovie ou loadMovieNum
para carregar filmes subseqentes no Flash Player, necessrio atribuir um nmero de nvel no
Flash Player ou um clipe de filme de destino no qual cada filme ser carregado. Quando voc usa
a ao loadVariablesNum, necessrio especificar um nvel do Flash Player no qual as variveis
sero carregadas.
Exemplo

Este exemplo carrega informaes de um arquivo de texto em campos de texto na Linha de tempo
principal do filme no nvel 0 do Flash Player. Os nomes das variveis dos campos de texto devem
corresponder aos nomes das variveis no arquivo data.txt.
on(release) {
loadVariablesNum("data.txt", 0);
}
Consulte tambm

getURL, loadMovie, loadMovieNum, loadVariables, MovieClip.loadMovie,

MovieClip.loadVariables

LoadVars (objeto)
O objeto LoadVars uma alternativa ao loadVariables para a transferncia de variveis entre
um filme do Flash e um servidor.
Voc pode usar o objeto LoadVars para obter informaes sobre erros, indicaes de progresso e
fluxos de dados durante seu download. O objeto LoadVars funciona de maneira muito
semelhante ao objeto XML; ele utiliza os mtodos load, send e sendAndLoad para estabelecer
comunicaes com um servidor. A diferena principal entre os objetos LoadVars e XML que o
primeiro transfere o nome e pares de valores ActionScript, em vez de uma rvore XML DOM
armazenada no objeto XML.
O objeto LoadVars segue as mesmas restries de segurana do objeto XML.
necessrio usar o construtor new LoadVars() para criar uma instncia do objeto LoadVars
antes de chamar seus mtodos.
O objeto LoadVars suportado pelo Flash Player 6 e verses posteriores.

277

Resumo dos mtodos do objeto LoadVars

Mtodo

Descrio

LoadVars.load

Faz download de variveis de um URL especificado.

LoadVars.getBytesTotal

Retorna o nmero de bytes carregados de um mtodo load ou sendAndLoad.

LoadVars.getBytesTotal

Retorna o nmero total de bytes que sero descarregados por um mtodo load
ou sendAndLoad.

LoadVars.send

Envia variveis de um objeto LoadVars para um URL.

LoadVars.sendAndLoad

Envia variveis de um objeto LoadVars para um URL e faz o download da

resposta do servidor para um objeto de destino.

LoadVars.toString

Retorna uma seqncia de caracteres codificados de URL que contm todas as

variveis enumerveis do objeto LoadVars.

Resumo das propriedades do objeto LoadVars

Todas as propriedades do objeto Key so constantes.
Propriedade

Descrio

LoadVars.contentType Indica um tipo de dados MIME.

LoadVars.load

Um valor booleano que indica se foi realizada uma operao load ou

sendAndLoad.

Resumo dos eventos do objeto LoadVars

Mtodo

Descrio

LoadVars.onLoad

Chamado quando uma operao load or sendAndLoad concluda.

Construtor do objeto LoadVars

Disponibilidade

Flash Player 6.
Uso

new LoadVars()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Construtor; cria uma instncia do objeto LoadVars. Em seguida, voc pode usar os mtodos desse
objeto LoadVars para enviar e carregar dados.
Exemplo

O exemplo a seguir cria uma instncia do objeto LoadVars chamada myLoadVars:

myLoadVars = new LoadVars();

Dicionrio ActionScript 278

LoadVars.contentType
Disponibilidade

Flash Player 6.
Uso

myLoadVars.contentType
Descrio

Propriedade; o tipo MIME enviado ao servidor quando voc chama o mtodo LoadVars.send ou
LoadVars.sendAndLoad. O padro aplicativo/x-www-codificado na forma de url.
Consulte tambm

LoadVars.send, LoadVars.sendAndLoad

LoadVars.getBytesLoaded
Disponibilidade

Flash Player 6.
Uso

myLoadVars.getBytesLoaded()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna o nmero de bytes descarregados por um mtodo load ou sendAndLoad. O

mtodo getBytesLoaded retorna undefined se no houver nenhuma operao load em
andamento ou se load ainda no tiver sido iniciada

LoadVars.getBytesTotal
Disponibilidade

Flash Player 6.
Uso

myLoadVars.getBytesTotal()
Parmetros

Nenhum.
Retorna

Um inteiro.

279

Descrio

Mtodo; retorna o nmero total de bytes descarregados por uma operao load ou sendAndLoad.
O mtodo getBytesTotal retorna undefined se no houver nenhuma operao load em
andamento ou se load ainda no tiver sido iniciada. O mtodo getBytesTotal tambm retorna
undefined se no for possvel determinar o nmero total de bytes; por exemplo, quando o
download foi iniciado, mas o servidor no transmitiu um item de tamanho do contedo HTTP.

LoadVars.load
Disponibilidade

Flash Player 6.
Uso

myLoadVars.load(url)
Parmetros

url

O URL de onde ser feito o download das variveis.

Retorna

Uma seqncia de caracteres.

Descrio

Mtodo; faz download de variveis do URL especificado, analisa os dados da varivel e coloca as
variveis resultantes em loadVarsObject. As propriedades em loadVarsObject com o mesmo
nome de variveis descarregadas so substitudas. As propriedades em loadVarsObject com
nomes diferentes das variveis descarregadas no so excludas. Esta uma ao assncrona.
Os dados descarregados devem estar codificados com o tipo de contedo MIME aplicativo/xwww-codificado na forma de url. Este o mesmo formato utilizado por loadVariables.
Este mtodo semelhante ao mtodo XML.load do objeto XML.

LoadVars.loaded
Disponibilidade

Flash Player 6.
Uso

myLoadVars.loaded
Descrio

Propriedade; indefinida por padro. Quando uma operao load ou sendAndLoad iniciada, a
propriedade loaded definida como false. Quando a operao load ou sendAndLoad
concluda, a propriedade loaded definida como true. Se a operao load ainda no tiver sido
concluda ou tiver apresentado erros, a propriedade loaded permanece definida como false.
A operao LoadVars.loaded semelhante propriedade XML.loaded do objeto XML.

Dicionrio ActionScript 280

LoadVars.onLoad
Disponibilidade

Flash Player 6.
Uso

myLoadVars.onLoad(xito)
Parmetros

xito O parmetro
no (false).

indica se a operao de carregamento foi concluda com xito (true) ou

Retorna

Um valor booleano.
Descrio

Manipulador de eventos; chamado quando uma operao load ou sendAndLoad concluda. Se a

operao tiver sido bem-sucedida, loadVarsObject ser preenchido com variveis descarregadas
pela operao load ou sendAndLoad, sendo que essas variveis estaro disponveis quando
onLoad for chamado.
Este mtodo permanece indefinido por padro, mas possvel defini-lo atravs da atribuio de
uma funo de retorno de chamada a ele.
Este mtodo semelhante ao mtodo XML.onLoad do objeto XML.

LoadVars.send
Disponibilidade

Flash Player 6.
Uso

loadVarsObject.send(url [,destino, mtodo] )

Parmetros

loadVarsObject
url

O objeto LoadVars a partir do qual as variveis devem ser carregadas.

O URL no qual as variveis devem ser carregadas.

A janela de quadro do navegador na qual as respostas sero exibidas.

destino
mtodo

O mtodo "GET" ou "POST" do protocolo HTTP.

Retorna

Uma seqncia de caracteres.

Descrio

Mtodo; envia as variveis do objeto myLoadVars para o URL especificado. Todas as variveis
enumerveis do objeto myLoadVars so concatenadas em uma seqncia de caracteres no formato
aplicativo/x-www-codificado na forma de url por padro e essa seqncia enviada para o URL que
utiliza o mtodo HTTP POST. Este o mesmo formato usado pela ao loadVariables. O tipo
de contedo MIME enviado nos cabealhos de solicitaes HTTP o valor de
myLoadVars.contentType ou o padro aplicativo/x-www-codificado na forma de url. O mtodo
"POST" usado, a menos que "GET" seja especificado.

281

Se o parmetro destino for especificado, a resposta do servidor ser exibida na janela de quadro
do navegador chamada destino. Se o parmetro destino for omitido, a resposta do servidor ser
descartada.
Este mtodo semelhante ao mtodo XML.send do objeto XML.

LoadVars.sendAndLoad
Disponibilidade

Flash Player 6.
Uso

myLoadVars.sendAndLoad(url, targetObject[,mtodo])
Parmetros

loadVarsObject
url

O objeto LoadVars a partir do qual as variveis devem ser carregadas.

O URL no qual as variveis devem ser carregadas.

targetObject
mtodo

O objeto LoadVars que recebe as variveis descarregadas.

O mtodo "GET" ou "POST" do protocolo HTTP.

Retorna

Uma seqncia de caracteres.

Descrio

Mtodo; envia variveis do objeto myLoadVars para o URL especificado. A resposta do servidor
descarregada e analisada como dados variveis. As variveis resultantes so colocadas no objeto
targetObject .
As variveis so enviadas da mesma forma que LoadVars.send. As variveis so descarregadas em
da mesma forma que LoadVars.load.

targetObject

Este mtodo semelhante ao mtodo XML.sendAndLoad do objeto XML.

LoadVars.toString
Disponibilidade

Flash Player 6.
Uso

loadVarsObject.toString()
Parmetros

Nenhum.
Retorna

Uma seqncia de caracteres.

Descrio

Mtodo; retorna uma seqncia de caracteres que contm todas as variveis enumerveis do
objeto LoadVars, no formato de contedo MIME aplicativo/x-www-codificado na forma de url.

Dicionrio ActionScript 282

Exemplo

var myVars = new LoadVars();

myVars.name = Gary;
myVars.age = 26;
trace (myVars.toString());
would output
name=Gary&age=26

lt (menor que seqncia de caracteres especfica)

Disponibilidade

Flash Player 4. Este operador foi reprovado no Flash 5 e substitudo pelo novo operador < (menor
que).
Uso

expression1 lt expression2
Parmetros

expression1, expression2

Nmeros, seqncias de caracteres ou variveis

Descrio

Operador (comparao); compara a expression1 com a expression2 e retorna true se

expression1 for menor do que expression2; caso contrrio, retorna false.
Consulte tambm

< (menor que)

Math (objeto)
O objeto Math um objeto de alto nvel que voc pode acessar sem usar um construtor.
Use os mtodos e propriedades desse objeto para acessar e manipular constantes e funes
matemticas. Todas as propriedades e mtodos do objeto Math so estticas e devem ser chamadas
com a sintaxe Math.method(parmetro) ou Math.constant. Em ActionScript, as constantes
so definidas com a preciso mxima de nmeros de ponto flutuante IEEE-754 de dupla preciso.
Vrios mtodos do objeto Math usam o radiano de um ngulo como parmetro. Voc pode usar a
equao abaixo para calcular os valores radianos ou simplesmente passar a equao (inserindo um
valor para graus) para o parmetro radiano.
Para calcular um valor radiano, use esta frmula:
radiano = Math.PI/180 * grau

O exemplo a seguir mostra a passagem de uma equao como um parmetro para calcular o seno
de um ngulo de 45 graus:
Math.SIN(Math.PI/180 * 45)

o mesmo que Math.SIN(.7854)

O objeto Math totalmente suportado no Flash Player 5. Voc pode usar mtodos do objeto
Math no Flash Player 4, mas eles so emulados com aproximaes e podem no ser to precisos
quanto as funes matemticas no emuladas suportadas pelo Flash Player 5.

283

Resumo dos mtodos do objeto Math

Mtodo

Descrio

Math.abs

Calcula um valor absoluto.

Math.acos

Calcula um arco cosseno.

Math.asin

Calcula um arco seno.

Math.atan

Calcula um arco tangente.

Math.atan2

Calcula um ngulo do eixo x ao ponto.

Math.ceil

Arredonda um nmero para o inteiro mais prximo

Math.cos

Calcula um cosseno.

Math.exp

Calcula um valor exponencial.

Math.floor

Arredonda um nmero para o inteiro mais prximo

Math.log

Calcula um logaritmo natural.

Math.max

Retorna o maior de dois inteiros.

Math.min

Retorna o menor de dois inteiros.

Math.pow

Calcula x elevado potncia de y.

Math.random

Retorna um nmero pseudo-aleatrio entre 0.0 e 1.0.

Math.round

Arredonda para o inteiro mais prximo.

Math.sin

Calcula um seno.

Math.sqrt

Calcula uma raiz quadrada.

Math.tan

Calcula uma tangente.

Resumo das propriedades do objeto Math

Todas as propriedades do objeto Math so constantes.
Propriedade

Descrio

Math.E

Constante de Euler e a base de logaritmos naturais (aproximadamente 2,718).

Math.LN2

O logaritmo natural de 2 (aproximadamente 0,693).

Math.LOG2E

O logaritmo de base 2 de e (aproximadamente 1,442).

Math.LN10

O logaritmo natural de10 (aproximadamente 2,302).

Math.LOG10E

O logaritmo de base 10 de e (aproximadamente 0,434).

Math.PI

A razo entre a circunferncia de um crculo e o seu dimetro (aproximadamente 3,14159).

Math.SQRT1_2

O inverso da raiz quadrada de 1/2 (aproximadamente 0,707).

Math.SQRT2

A raiz quadrada de 2 (aproximadamente 1,414).

Dicionrio ActionScript 284

Math.abs
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.abs(x)
Parmetros

Um nmero.

Retorna

Um nmero.
Descrio

Mtodo; calcula e retorna um valor absoluto do nmero especificado pelo parmetro x.

Math.acos
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.acos(x)
Parmetros

Um nmero de -1,0 a 1,0.

Retorna

Nada.
Descrio

Mtodo; calcula e retorna o arco cosseno do nmero especificado no parmetro x, em radianos.

Math.asin
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.asin(x);
Parmetros

Um nmero de -1,0 a 1,0.

Retorna

Um nmero.
Descrio

Mtodo; calcula e retorna o arco seno de um nmero especificado no parmetro x, em radianos.

285

Math.atan
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.atan(x)
Parmetros

Um nmero.

Retorna

Um nmero.
Descrio

Mtodo; calcula e retorna o arco tangente do nmero especificado no parmetro x. O valor

retornado est entre o pi negativo dividido por 2 e o pi positivo dividido por 2.

Math.atan2
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.atan2(y, x)
Parmetros

Um nmero que especifica a coordenada x do ponto.

Um nmero que especifica a coordenada y do ponto.

Retorna

Um nmero.
Descrio

Mtodo; calcula e retorna o arco tangente de y/x em radianos. O valor retornado representa o
ngulo referente ao cateto oposto de um tringulo retngulo, onde x o cateto adjacente e y o
cateto oposto.

Math.ceil
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.ceil(x)
Parmetros

Um nmero ou expresso.

Dicionrio ActionScript 286

Retorna

Um nmero.
Descrio

Mtodo; retorna o teto do nmero ou expresso especificada. O teto de um nmero o nmero

inteiro mais prximo que maior que ou igual ao nmero.

Math.cos
Uso

Math.cos(x)
Parmetros

Um ngulo medido em radianos.

Retorna

Um nmero.
Descrio

Mtodo; retorna o cosseno (um valor de -1,0 a 1,0) do ngulo especificado pelo parmetro x. O
ngulo x deve ser especificado em radianos. Use as informaes descritas na introduo do objeto
Math para calcular um radiano.

Math.E
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.E
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Constante; uma constante matemtica para a base de logaritmos naturais, apresentados como e. O
valor aproximado de e 2,71828.
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.

287

Math.exp
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.exp(x)
Parmetros

O exponente; um nmero ou expresso.

Retorna

Um nmero.
Descrio

Mtodo; retorna o valor de base do logaritmo natural (e), potncia do exponente especificado no
parmetro x. A constante Math.E pode fornecer o valor de e.

Math.floor
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.floor(x)
Parmetros

Um nmero ou expresso.

Retorna

Um nmero.
Descrio

Mtodo; retorna o piso do nmero ou expresso especificada no parmetro x. O piso o inteiro

mais prximo menor ou igual ao nmero ou expresso especificada.
Exemplo

O exemplo de cdigo a seguir retorna um valor 12:

Math.floor(12.5);

Math.log
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.log(x)

Dicionrio ActionScript 288

Parmetros

Um nmero ou expresso com um valor maior que 0.

Retorna

Um nmero.
Descrio

Mtodo; retorna o logaritmo natural do parmetro x.

Math.LOG2E
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.LOG2E
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Constante; uma constante matemtica do logaritmo de base 2 da constante e (Math.E), expressa

como log e2, com um valor aproximado de 1,442695040888963387.

Math.LOG10E
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.LOG10E
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Constante; uma constante matemtica para o logaritmo de base 10 da constante e (Math.E),

expressa como log 10e, com um valor aproximado de 0,43429448190325181667.

289

Math.LN2
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.LN2
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Constante; uma constante matemtica do logaritmo natural de 2, expressa como loge2, com um
valor aproximado de 0,69314718055994528623.

Math.LN10
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.LN10
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Constante; uma constante matemtica do logaritmo natural de 10, expressa como log e10, com
um valor aproximado de 2,3025850929940459011.

Math.max
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.max(x , y)
Parmetros

Um nmero ou expresso.

Um nmero ou expresso.

Dicionrio ActionScript 290

Retorna

Um nmero.
Descrio

Mtodo; avalia x e y e retorna o maior valor.

Math.min
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.min(x , y)
Parmetros

Um nmero ou expresso.

Um nmero ou expresso.

Retorna

Nada.
Descrio

Mtodo; avalia x e y e retorna o menor valor.

Math.PI
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.PI
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Constante; uma constante matemtica da razo entre a circunferncia de um crculo e o seu

dimetro expressa como pi, com um valor de 3,14159265358979

291

Math.pow
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.pow(x , y)
Parmetros

Um nmero a ser elevado a uma potncia.

Um nmero que especifica a potncia qual o parmetro x elevado.

Retorna

Um nmero.
Descrio

Mtodo; calcula e retorna x potncia de y, xy.

Math.random
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.random()
Parmetros

Nenhum.
Retorna

Um nmero.
Descrio

Mtodo; retorna n, onde 0 <= n < 1.

Consulte tambm

random

Dicionrio ActionScript 292

Math.round
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.round(x)
Parmetros

Um nmero.

Retorna

Um nmero.
Descrio

Mtodo; arredonda o valor do parmetro x para cima ou para baixo para o inteiro mais prximo e
retorna esse valor.

Math.sin
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e as propriedades do objeto Math so emulados

atravs de aproximaes e podem no ser to precisos quanto as funes matemticas no
emuladas suportadas pelo Flash Player 5.
Uso

Math.sin(x)
Parmetros

Um ngulo medido em radianos.

Retorna

Nada.
Descrio

Mtodo; calcula e retorna o seno do ngulo especificado em radianos. Use as informaes

descritas na introduo do objeto Math para calcular um radiano.

Math.sqrt
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.sqrt(x)
Parmetros

293

Um nmero ou expresso maior que ou igual a 0.

Retorna

Um nmero.
Descrio

Mtodo; calcula e retorna a raiz quadrada do nmero especificado.

Math.SQRT1_2
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.SQRT1_2
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Constante; uma constante matemtica do inverso da raiz quadrada de meio (1/2), com um valor
aproximado de 0,707106781186.

Math.SQRT2
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.SQRT2
Parmetros

Nenhum.
Descrio

Constante; uma constante matemtica para a raiz quadrada de 2, com um valor aproximado de
1,414213562373.

Dicionrio ActionScript 294

Math.tan
Disponibilidade

Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com
aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas
suportadas pelo Flash Player 5.
Uso

Math.tan(x)
Parmetros

Um ngulo medido em radianos.

Retorna

Um nmero.
Descrio

Mtodo; calcula e retorna a tangente do ngulo especificado. Para calcular um radiano, use as
informaes apresentadas na introduo de Math (objeto).

maxscroll
Disponibilidade

Flash Player 4.
Uso

variable_name.maxscroll
Descrio

Propriedade (somente leitura); uma propriedade reprovada que indica o nmero da linha visvel
mais acima do texto em um campo quando a linha mais inferior desse campo tambm est visvel.
A propriedade maxscroll funciona em conjunto com a propriedade scroll para controlar
a exibio de informaes em um campo de texto. Esta propriedade pode ser recuperada, mas no
modificada.
Consulte tambm

TextField.maxscroll, TextField.scroll

mbchr
Disponibilidade

Flash Player 4. Esta funo foi reprovada e substituda pelo mtodo String.fromCharCode.
Uso

mbchr(nmero)
Parmetros

nmero

O nmero a ser convertido em um caractere de vrios bytes.

Retorna

Uma seqncia de caracteres.

295

Descrio

Funo de seqncia de caracteres; converte um nmero de cdigo ASCII em um caractere de

vrios bytes.
Consulte tambm

String.fromCharCode

mblength
Disponibilidade

Flash Player 4. Esta funo foi reprovada e substituda por String (objeto).
Uso

mblength(seqncia de caracteres)
Parmetros

seqncia de caracteres

Uma seqncia de caracteres.

Retorna

Um nmero.
Descrio

Funo de seqncia de caracteres; retorna o tamanho da seqncia de caracteres de vrios bytes.

mbord
Disponibilidade

Flash Player 4. Esta funo foi reprovada no Flash 5 e substituda pelo mtodo
String.charCodeAt.
Uso

mbord(caractere)
Parmetros

caractere

O caractere a ser convertido em um nmero de vrios bytes.

Retorna

Um nmero.
Descrio

Funo de seqncia de caracteres; converte o caractere especificado em um nmero de vrios

bytes.
Consulte tambm

String.fromCharCode

Dicionrio ActionScript 296

mbsubstring
Disponibilidade

Flash Player 4. Esta funo foi substituda no Flash 5 pelo mtodo String.substr.
Uso

mbsubstring(valor, ndice, contagem)

Parmetros

A seqncia de caracteres de vrios bytes da qual extrair uma nova seqncia de caracteres
de vrios bytes.

valor

ndice

O nmero do primeiro caractere a ser extrado.

O nmero de caracteres a ser includo na seqncia de caracteres extrada, sem incluir

o caractere ndice.

contagem

Retorna

Uma seqncia de caracteres.

Descrio

Funo de seqncia de caracteres; extrai uma nova seqncia de caracteres de vrios bytes de uma
seqncia de caracteres de vrios bytes.
Consulte tambm

String.substr

mtodo
Disponibilidade

Flash Player 6.
Uso

object.method = function ([parmetros]) {

...corpo da funo...
};
Parmetros

object

Um identificador de um objeto.

method

Um identificador de um mtodo.

parmetros

Parmetros que devem ser passados para a funo. Um parmetro opcional.

Retorna

Nada.
Descrio

Ao (modo normal apenas); permite a definio dos mtodos para os objetos atravs do painel
Aes no modo Normal. Para mais informaes sobre a definio de mtodos para objetos,
consulte Usando o Flash.

297

Mouse (objeto)
O objeto Mouse um objeto de alto nvel que voc pode acessar sem usar um construtor. Use os
mtodos do objeto Mouse para ocultar e mostrar o cursor no filme. Por padro, o ponteiro do
mouse fica visvel, mas possvel ocult-lo e implementar um ponteiro personalizado usando um
clipe de filme.
Resumo do mtodo Mouse
Mtodo

Descrio

Mouse.addListener

Registra um objeto para receber as notificaes onMouseDown, onMouseMove e

onMouseUp.

Mouse.hide

Oculta o ponteiro do mouse no filme.

Mouse.removeListener

Remove um objeto registrado com o mtodo addListener.

Mouse.show

Exibe o ponteiro do mouse no filme.

Resumo de ouvintes de Mouse

Mtodo

Descrio

MovieClip.onMouseDown

Notificado quando o boto do mouse pressionado.

MovieClip.onMouseMove

Notificado quando o boto do mouse movido.

MovieClip.onMouseUp

Notificado quando o boto do mouse liberado.

Mouse.addListener
Disponibilidade

Flash Player 6.
Uso

Mouse.addListener (newListener)
Parmetros

newListener

Um objeto.

Retorna

Nada.
Descrio

Mtodo; registra um objeto para receber notificaes dos manipuladores de retorno de chamada
onMouseDown, onMouseMove e onMouseUp.
O parmetro newListener deve conter um objeto com mtodos definidos para os eventos
onMouseDown, onMouseMove e onMouseUp.
Quando o mouse pressionado, movido ou liberado, independentemente do foco de entrada,
todos os objetos ouvintes registrados com o mtodo addListener tm o mtodo onMouseDown,
onMouseMove ou onMouseUp chamado. Vrios objetos podem ouvir notificaes de teclado. Se o
ouvinte newListener j estiver registrado, nenhuma alterao ocorrer.

Dicionrio ActionScript 298

Mouse.hide
Disponibilidade

Flash Player 5.
Uso

Mouse.hide()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; oculta o cursor em um filme. Por padro, o cursor fica visvel.

Exemplo

O cdigo a seguir, anexado a um clipe de filme na Linha de tempo principal, oculta o cursor
padro e define as posies x e y da instncia do clipe de filme customCursor como as posies x
e y do mouse na Linha de tempo principal.
onClipEvent(enterFrame) {
Mouse.hide();
customCursorMC._x = _root._xmouse;
customCursorMC._y = _root._ymouse;
}
Consulte tambm

Mouse.show, MovieClip._xmouse, MovieClip._ymouse

Mouse.onMouseDown
Disponibilidade

Flash Player 6.
Uso

someListener.onMouseDown
Descrio

Ouvinte; notificado quando o mouse pressionado. Para usar o ouvinte onMouseDown,

necessrio criar um objeto ouvinte. Em seguida, voc pode definir uma funo para onMouseDown
e usar o mtodo addListener para registrar o ouvinte com o objeto Mouse, como mostrado no
cdigo a seguir:
someListener = new Object();
someListener.onMouseDown = function () { ... };
Mouse.addListener(someListener);

Os ouvintes permitem a cooperao de partes diferentes de cdigo. Isso ocorre porque vrios
ouvintes podem receber notificaes sobre um nico evento.
Consulte tambm

Mouse.addListener

299

Mouse.onMouseMove
Disponibilidade

Flash Player 6.
Uso

someListener.onMouseMove
Descrio

Ouvinte; notificado quando o mouse movido. Para usar o ouvinte onMouseMove, necessrio
criar um objeto ouvinte. Em seguida, possvel definir uma funo para onMouseMove e usar o
mtodo addListener para registrar o ouvinte com o objeto Mouse, como mostrado no cdigo a
seguir:
someListener = new Object();
someListener.onMouseMove = function () { ... };
Mouse.addListener(someListener);

Os ouvintes permitem a cooperao de partes diferentes de cdigo. Isso ocorre porque vrios
ouvintes podem receber notificaes sobre um nico evento.
Consulte tambm

Mouse.addListener

Mouse.onMouseUp
Disponibilidade

Flash Player 6.
Uso

someListener.onMouseUp
Descrio

Ouvinte; notificado quando o mouse liberado. Para usar o ouvinte onMouseUp, necessrio criar
um objeto ouvinte. Em seguida, voc pode definir uma funo para onMouseUp e usar o mtodo
addListener para registrar o ouvinte com o objeto Mouse, como mostrado no cdigo a seguir:
someListener = new Object();
someListener.onMouseUp = function () { ... };
Mouse.addListener(someListener);

Os ouvintes permitem a cooperao de partes diferentes de cdigo. Isso ocorre porque vrios
ouvintes podem receber notificaes sobre um nico evento.
Consulte tambm

Mouse.addListener

Dicionrio ActionScript 300

Mouse.removeListener
Disponibilidade

Flash Player 6.
Uso

Mouse.removeListener (ouvinte)
Parmetros

ouvinte

Um objeto.

Retorna

Se o objeto ouvinte tiver sido removido com xito, o mtodo retornar true; se a remoo do
ouvinte no tiver sido bem-sucedida (por exemplo, se o ouvinte no estava na lista de ouvintes
do objeto Mouse), o mtodo retornar false.
Descrio

Mtodo; remove um objeto registrado anteriormente com o mtodo addListener.

Mouse.show
Disponibilidade

Flash Player 5.
Uso

Mouse.show()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; exibe o cursor em um filme. Por padro, o cursor fica visvel.

Consulte tambm

Mouse.show, MovieClip._xmouse, MovieClip._ymouse

MovieClip (objeto)
Os mtodos do objeto MovieClip oferecem a mesma funcionalidade que as aes dos clipes de
filme de destino. Tambm existem mtodos adicionais que no tm aes equivalentes na caixa de
ferramentas Aes do painel Aes.
Voc no precisa usar um mtodo construtor para chamar os mtodos do objeto MovieClip; em
vez disso, faa referncia s instncias do clipe de filme por nome, usando a sintaxe a seguir:
myMovieClip.play();
myMovieClip.gotoAndPlay(3);

301

Resumo dos mtodos do objeto MovieClip

Mtodo

Descrio

MovieClip.attachMovie

Anexa um filme biblioteca.

MovieClip.createEmptyMovieClip

Cria um clipe de filme vazio.

MovieClip.createTextField

Cria um campo de texto vazio.

MovieClip.duplicateMovieClip

Duplica o clipe de filme especificado.

MovieClip.getBounds

Retorna as coordenadas x e y mnimas e mximas de um filme em um

espao de coordenadas especificado.

MovieClip.getBytesLoaded

Retorna o nmero de bytes carregados do clipe de filme especificado.

MovieClip.getBytesTotal

Retorna o tamanho do clipe de filme em bytes.

MovieClip.getDepth

Retorna a profundidade de um clipe de filme.

MovieClip.getURL

Recupera um documento de um URL.

MovieClip.globalToLocal

Converte o objeto Ponto das coordenadas do Palco nas coordenadas

locais do clipe de filme especificado.

MovieClip.gotoAndPlay

Envia a reproduo para um quadro em especfico no clipe de filme e

reproduz o filme.

MovieClip.gotoAndStop

Envia a reproduo para um quadro em especfico no clipe de filme e

encerra o filme.

MovieClip.hitTest

Retorna true se h interseo entre a caixa delimitadora do clipe de

filme especificado e a caixa delimitadora do clipe de filme de destino.

MovieClip.loadMovie

Carrega o filme no clipe de filme.

MovieClip.loadVariables

Carrega variveis de um URL ou outro local no clipe de filme

MovieClip.localToGlobal

Converte um objeto Ponto das coordenadas locais do clipe de filme nas

coordenadas globais do Palco.

MovieClip.nextFrame

Envia a reproduo para o prximo quadro do clipe de filme.

MovieClip.play

Reproduz o clipe de filme especificado.

MovieClip.prevFrame

Envia a reproduo para o quadro anterior do clipe de filme.

MovieClip.removeMovieClip

Remove o clipe de filme da Linha de tempo se ele foi criado com uma
ao duplicateMovieClip ou com o mtodo attachMovie.

MovieClip.setMask

Especifica um clipe de filme como uma mscara para outro clipe de

filme.

MovieClip.startDrag

Especifica um clipe de filme como arrastvel e comea a arrast-lo.

MovieClip.stop

Pra o filme que est sendo reproduzido no momento.

MovieClip.stopDrag

Pra o arraste de qualquer clipe de filme que esteja sendo arrastado.

MovieClip.swapDepths

Troca o nvel de profundidade de dois filmes.

MovieClip.unloadMovie

Remove um filme que foi carregado com a ao loadMovie.

Dicionrio ActionScript 302

Resumo de mtodos de desenho de MovieClip

Mtodo

Descrio

MovieClip.beginFill

Comea a desenhar um preenchimento no Palco.

MovieClip.beginGradientFill

Comea a desenhar um preenchimento de gradiente no Palco.

MovieClip.clear

Remove todos os comandos de desenho associados a uma instncia de

clipe de filme.

MovieClip.curveTo

Desenha uma curva utilizando o ltimo estilo de linha.

MovieClip.endFill

Conclui o preenchimento especificado por beginFill ou

beginGradientFill.

MovieClip.lineStyle

Define o trao das linhas criadas com os mtodos lineTo e curveTo.

MovieClip.lineTo

Desenha uma linha utilizando o estilo de linha atual.

MovieClip.moveTo

Move a posio do desenho especificado para determinadas

coordenadas.

Resumo das propriedades do objeto MovieClip

303

Propriedade

Descrio

MovieClip._alpha

O valor de transparncia de uma instncia de clipe de filme.

MovieClip._currentframe

O nmero do quadro no qual a reproduo est localizada no momento.

MovieClip._droptarget

O caminho absoluto em notao de sintaxe de barra da instncia do

clipe de filme na qual um clipe de filme arrastvel foi solto.

MovieClip.enabled

Indica se um clipe de filme de boto est ativado.

MovieClip.focusEnabled

Permite que um clipe de filme receba o foco.

MovieClip._focusrect

Indica se um clipe de filme focalizado tem um retngulo amarelo ao seu

redor.

MovieClip._framesloaded

O nmero de quadros que foram carregados de um filme em fluxo.

MovieClip._height

A altura de uma instncia de clipe de filme em pixels.

MovieClip.hitArea

Designa outro clipe de filme para atuar como a rea de clicagem de um

clipe de filme de boto.

MovieClip._highquality

Define a qualidade de processamento de um filme.

MovieClip._name

O nome da instncia de um clipe de filme.

MovieClip._parent

Uma referncia ao clipe de filme que inclui outro clipe de filme.

MovieClip._rotation

O grau de rotao de uma instncia de clipe de filme.

MovieClip._soundbuftime

O nmero de segundos decorridos antes de um som comear a ser

reproduzido.

MovieClip.tabChildren

Indica se os filhos de um clipe de filme so includos na ordenao

automtica de guias.

MovieClip.tabEnabled

Indica se um clipe de filme includo na ordenao de guias.

MovieClip.tabIndex

Indica a ordem de guias de um objeto.

MovieClip._target

O caminho de destino de uma instncia de clipe de filme.

MovieClip._totalframes

O nmero total de quadros de uma instncia de clipe de filme.

Propriedade

Descrio

MovieClip.trackAsMenu

Indica se outros botes podem receber eventos de liberao de mouse.

MovieClip._url

O URL do arquivo SWF a partir do qual um clipe de filme foi

descarregado.

MovieClip.useHandCursor

Determina se a mo exibida quando um usurio rola o cursor do mouse

sobre um clipe de filme de boto.

MovieClip._visible

Um valor booleano que determina se uma instncia de clipe de filme est

oculta ou visvel.

MovieClip._width

A largura de uma instncia de clipe de filme em pixels.

MovieClip._x

A coordenada x de uma instncia de clipe de filme.

MovieClip._xmouse

A coordenada x do cursor em uma instncia de clipe de filme.

MovieClip._xscale

O valor que especifica a porcentagem para o dimensionamento

horizontal de um clipe de filme.

MovieClip._y

A coordenada y de uma instncia de clipe de filme.

MovieClip._ymouse

A coordenada y do cursor em uma instncia de clipe de filme.

MovieClip._yscale

O valor que especifica a porcentagem para o dimensionamento vertical

de um clipe de filme.

Resumo de manipuladores de evento do objeto MovieClip

Propriedade

Descrio

MovieClip.onData

Chamada quando todos os dados so carregados em um clipe de filme.

MovieClip.onDragOut

Chamada enquanto o ponteiro est fora do boto, o boto do mouse

pressionado no interior e rola para fora da rea do boto.

MovieClip.onDragOver

Chamada enquanto o ponteiro est sobre o boto, o boto do mouse foi

pressionado, rolado para fora do boto e, a seguir, rolado de volta sobre
o boto.

MovieClip.onEnterFrame

Chamada continuamente na taxa de quadros do filme. As aes

associadas ao evento do clipe enterFrame so processadas depois das
aes que tenham sido anexadas aos quadros afetados.

MovieClip.onKeyDown

Chamada quando uma tecla pressionada. Use os mtodos

Key.getCode e Key.getAscii para recuperar informaes sobre a
ltima tecla pressionada.

MovieClip.onKeyUp

Chamada quando uma tecla liberada.

MovieClip.onKillFocus

Chamada quando o foco removido de um boto.

MovieClip.onLoad

Chamada quando o clipe de filme criado e aparece na Linha de tempo.

MovieClip.onMouseDown

Chamada quando o boto esquerdo do mouse pressionado.

MovieClip.onMouseMove

Chamada sempre que o mouse movido.

MovieClip.onMouseUp

Chamada quando o boto esquerdo do mouse liberado.

MovieClip.onPress

Chamada quando o mouse pressionado enquanto o ponteiro est

sobre um boto.

MovieClip.onRelease

Chamada quando o mouse liberado enquanto o ponteiro est sobre

um boto.

Dicionrio ActionScript 304

Propriedade

Descrio

MovieClip.onReleaseOutside

Chamada quando o mouse liberado enquanto o ponteiro est fora de

um boto, depois que o boto pressionado enquanto o ponteiro est
dentro do boto.

MovieClip.onRollOut

Chamada quando o ponteiro rola para fora da rea de um boto.

MovieClip.onRollOver

Chamada quando o ponteiro do mouse rola sobre um boto.

MovieClip.onSetFocus

Chamada quando um boto tem o foco de entrada e uma tecla

liberada.

MovieClip.onUnload

Chamada no primeiro quadro depois que o clipe de filme removido da

Linha de tempo. As aes associadas ao evento do clipe de filme
Unload so processadas antes que as aes sejam anexadas ao quadro
atingido.

MovieClip._alpha
Disponibilidade

Flash Player 4.
Uso

myMovieClip._alpha
Descrio

Propriedade; define ou recupera a transparncia alfa (valor) do clipe de filme especificado por
MovieClip. A faixa de valores vlidos vai de 0 (totalmente transparente) a 100 (totalmente
opaco). Os objetos em um clipe de filme com _alpha definida como 0 so ativos, apesar de serem
invisveis. Por exemplo, voc ainda pode clicar em um boto em um clipe de filme que tenha a
propriedade _alpha definida como 0.
Exemplo

Os comandos a seguir definem como 30% a propriedade _alpha de um clipe de filme chamado
star quando o usurio clica no boto.
on(release) {
star._alpha = 30;
}

MovieClip.attachMovie
Disponibilidade

Flash Player 5.
Uso

myMovieClip.attachMovie( idName, newName, profundidade [, initObject] )

Parmetros

idName O nome de vinculao do smbolo do clipe de filme na biblioteca a ser anexada a um

clipe de filme no Palco. o nome inserido no campo Identificador na caixa de dilogo
Propriedades de Vinculao do Smbolo.
newname

Um nome de instncia nico para o clipe de filme que est sendo anexado ao clipe de

filme.
profundidade

305

Um inteiro que especifica o nvel de profundidade no qual o filme colocado.

Um objeto que contm propriedades que devem ser utilizadas para preencher o clipe
de filme recm-anexado. Este parmetro permite que os clipes de filme criados dinamicamente
recebam parmetros de clipe. Se initObject no for um objeto, ele ser ignorado. Todas as
propriedades de initObject so copiadas na nova instncia. As propriedades especificadas com
initObject esto disponveis para a funo construtora. Este parmetro opcional.
initObject

Retorna

Nada.
Descrio

Mtodo; pega um smbolo da biblioteca e o anexa ao filme no Palco especificado por MovieClip.
Use a ao ou mtodo removeMovieClip ou unloadMovie para remover um clipe de filme
anexado com attachMovie.
Exemplo

O exemplo a seguir anexa o smbolo com o identificador de vinculao crculo instncia de

clipe de filme localizada no Palco, no filme.
on (release) {
thing.attachMovie( "crculo", "crculo1", 2 );
}
Consulte tambm

MovieClip.removeMovieClip, MovieClip.unloadMovie, Object.registerClass,

removeMovieClip

MovieClip.beginFill
Disponibilidade

Flash Player 6.
Uso

myMovieClip.beginFill ([rgb[, alfa]])

Parmetro

rgb Um valor de cor hexadecimal (por exemplo, vermelho corresponde a 0xFF0000, azul a
0x0000FF e assim por diante). Caso este valor no seja fornecido ou esteja indefinido, nenhum
preenchimento ser criado.

Um nmero inteiro entre 0 e 100 que especifica o valor alfa do preenchimento. Se este
valor no for informado, a opo100 (slido) ser usada. Se o valor for menor do que 0, o Flash
usar 0. Se o valor for maior do que 100, o Flash usar 100.

alfa

Retorna

Nada.
Descrio

Mtodo; indica o incio de um novo caminho de desenho. Se houver um caminho aberto (isto ,
se a posio atual do desenho no for igual posio anterior especificada em um mtodo
moveTo) e se houver um preenchimento associado a ele, esse caminho ser fechado com uma
linha e preenchido em seguida. Trata-se de um processo semelhante ao que ocorre quando o
mtodo endFill chamado.

Dicionrio ActionScript 306

Consulte tambm

MovieClip.beginGradientFill, MovieClip.endFill

MovieClip.beginGradientFill
Disponibilidade

Flash Player 6.
Uso

myMovieClip.beginGradientFill (fillType, cores, alfas, propores, matriz)

Parmetro

fillType

A seqncia de caracteres "linear" ou "radial".

Uma matriz de valores de cores hexadecimais RGB a ser utilizada no gradiente (por
exemplo, vermelho corresponde a 0xFF0000, azul a 0x0000FF e assim por diante).

cores

Uma matriz de valores alfa para as cores correspondentes na matriz cores; a faixa de
valores vlidos vai de 0 a 100. Se o valor for menor do que 0, o Flash usar 0. Se o valor for maior
do que 100, o Flash usar 100.

alfas

propores Uma matriz de razes de distribuio de cores; a faixa de valores vlidos vai de 0 a
255. Este valor define a porcentagem de largura em que o exemplo de cor realizado a 100 por
cento.
matriz Uma matriz de transformao que um objeto que possui um dos dois conjuntos de
propriedades a seguir:

a, b, c, d, e, f, g, h, i, que pode ser usado para descrever uma matriz do tipo 3 x 3 da seguinte
forma:
a b c
d e f
g h i

O exemplo a seguir usa um mtodo beginGradientFill com um parmetro matrix que

um objeto com essas propriedades.
_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", cores, alfas, propores, matriz
);
moveto(100,100);
lineto(100,300);
lineto(300,300);
lineto(300,100);
lineto(100,100);
endFill();
}

307

Se no houver uma propriedade matrixType, todos os outros parmetros sero necessrios; a

funo falhar se faltar qualquer parmetro. Esta matriz dimensiona, converte, gira e inclina o
gradiente da unidade definido em (-1,-1) e (1,1).<

matrixType, x, y, w, h, r.

As propriedades indicam o seguinte: matrixType a seqncia de caracteres "box", x a

posio horizontal relativa ao ponto de registro do clipe pai do canto superior esquerdo do
gradiente, y a posio vertical relativa ao ponto de registro do clipe pai do canto superior
esquerdo do gradiente, w a largura do gradiente, h sua altura e r a sua rotao em radianos.
O exemplo a seguir usa um mtodo beginGradientFill com um parmetro matrix que
um objeto com essas propriedades.
_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", cores, alfas, propores, matriz
);
moveto(100,100);
lineto(100,300);
lineto(300,300);
lineto(300,100);
lineto(100,100);
endFill();
}

Dicionrio ActionScript 308

Se houver uma propriedade matrixType, ela dever ser igual a "box" e todos os outros
parmetros sero necessrios. A funo falhar se uma dessas condies no for atendida.

Retorna

Nada.
Descrio

Mtodo; indica o incio de um novo caminho de desenho. Se o primeiro parmetro estiver

indefinido, ou se nenhum parmetro tiver sido passado, o caminho no ter preenchimento. Se
houver um caminho aberto (isto , se a posio atual do desenho no for igual posio anterior
especificada em um mtodo moveTo) e se houver um preenchimento associado a ele, esse
caminho ser fechado com uma linha e preenchido em seguida. Trata-se de um processo
semelhante ao que ocorre quando voc chama o mtodo endFill.
Este mtodo falhar se qualquer uma das condies a seguir for encontrada:

O nmero de itens nos parmetros cores, alfas e propores no igual.

O parmetro fillType no linear ou radial.
Um dos campos no objeto para o parmetro matrix est ausente ou invlido.

309

Exemplo

O cdigo a seguir usa os dois mtodos para desenhar dois retngulos empilhados com um
preenchimento de gradiente vermelho e azul e um trao verde slido de 5 pontos.
_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", cores, alfas, propores, matriz );
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", cores, alfas, propores, matriz );
moveto(100,310);
lineto(100,510);
lineto(600,510);
lineto(600,310);
lineto(100,310);
endFill();
}

Consulte tambm

MovieClip.beginFill, MovieClip.endFill, MovieClip.lineStyle, MovieClip.lineTo,

MovieClip.moveTo

Dicionrio ActionScript 310

MovieClip.clear
Disponibilidade

Flash Player 6.
Uso

myMovieClip.clear()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; remove todos os comandos de desenho associados a um clipe de filme. As formas e linhas
criadas com as ferramentas de desenho do Flash no so afetadas. Quando o mtodo clear
chamado, o estilo de linha atual tambm removido.
Consulte tambm

MovieClip.lineStyle

MovieClip.createEmptyMovieClip
Disponibilidade

Flash Player 6.
Uso

myMovieClip.createEmptyMovieClip (instanceName, profundidade)

Parmetro

instanceName

Uma seqncia de caracteres que identifica o nome da instncia do novo clipe

de filme.
profundidade

Um inteiro que especifica a profundidade do novo clipe de filme.

Retorna

Nada.
Descrio

Mtodo; cria um clipe de filme vazio como filho de outro clipe de filme existente. Este mtodo
apresenta um comportamento semelhante ao de attachMovie, s que no preciso fornecer um
nome de vinculao externo para o novo clipe de filme. O ponto de registro de um clipe de filme
vazio recm-criado o canto superior esquerdo. Este mtodo falhar se um dos parmetros estiver
faltando.
Consulte tambm

MovieClip.attachMovie

311

MovieClip.createTextField
Disponibilidade

Flash Player 6.
Uso

myMovieClip.createTextField (instanceName, profundidade, x, y, largura, altura)

Parmetros

instanceName

Uma seqncia de caracteres que identifica o nome da instncia do novo campo

de texto.
profundidade

Um inteiro positivo que especifica a profundidade do novo campo de texto.

Um inteiro que especifica a coordenada x do novo campo de texto.

Um inteiro que especifica a coordenada y do novo campo de texto.

Um inteiro positivo que especifica a largura do novo campo de texto.

largura
altura

Um inteiro positivo que especifica a altura do novo campo de texto.

Retorna

Nada.
Descrio

Mtodo; cria um novo campo de texto vazio como filho do clipe de filme especificado pelo
parmetro MovieClip. Use o mtodo createTextField para criar campos de texto durante a
reproduo de um filme. O campo de texto posicionado em (x, y) com as dimenses de
largura por altura. Os parmetros x e y so relativos ao clipe de filme recipiente; esses
parmetros correspondem s propriedades _x e _y do campo de texto. Os parmetros largura e
altura correspondem s propriedades _width e _height do campo de texto.
As propriedades padro de um campo de texto so as seguintes:
type = "dynamic",
border = false,
background = false,
password = false,
multiline = false,
html = false,
embedFonts = false,
variable = null,
maxChars = null

Dicionrio ActionScript 312

Um campo de texto criado com createTextField recebe o seguinte objeto TextFormat padro:
font = "Times New Roman"
size = 12
textColor = 0x000000
bold = false
italic = false,
underline = false
url = ""
target = ""
align = "left"
leftMargin = 0
rightMargin = 0
indent = 0
leading = 0
bullet = false
tabStops = [] (matriz vazia)
Exemplo

O exemplo a seguir cria um campo de texto com uma largura de 300, uma altura de 100, uma
coordenada x de 100, uma coordenada y de 100, sem borda, com texto vermelho e sublinhado.
_root.createTextField("meutexto",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 o meu primeiro texto de objeto de campo de teste";
mytext.setTextFormat(myformat);
Consulte tambm

TextFormat (objeto)

MovieClip._currentframe
Disponibilidade

Flash Player 4.
Uso

myMovieClip._currentframe
Descrio

Propriedade (somente leitura); retorna o nmero do quadro no qual a reproduo est localizada
na Linha de tempo especificada por MovieClip.
Exemplo

O exemplo a seguir usa a propriedade _currentframe para orientar a reproduo de actionClip

do clipe de filme para avanar cinco quadros em relao sua posio atual.
actionClip.gotoAndStop(_currentframe + 5);

313

MovieClip.curveTo
Disponibilidade

Flash Player 6.
Uso

myMovieClip.curveTo (controlX, controlY, anchorX, anchorY)

Parmetros

Um inteiro que especifica uma posio horizontal relativa ao ponto de registro do

clipe de filme pai do ponto de controle.

controlX

Um inteiro que especifica uma posio vertical relativa ao ponto de registro do clipe
de filme pai do ponto de controle.

controlY

anchorX Um inteiro que especifica uma posio horizontal relativa ao ponto de registro do clipe
de filme pai do prximo ponto de ancoragem.
anchorY Um inteiro que especifica uma posio vertical relativa ao ponto de registro do clipe de
filme pai do prximo ponto de ancoragem.
Retorna

Nada.
Descrio

Mtodos; desenha uma curva utilizando o estilo de linha atual da posio de desenho para
(anchorX, anchorY) com o ponto de controle especificado por (controlX, controlY). Em
seguida, a posio atual do desenho definida para (anchorX, anchorY). Se o clipe de filme que
voc est criando apresentar contedo elaborado com as ferramentas de desenho do Flash, as
chamadas para curveTo sero desenhadas sob esse contedo. Se voc chamar curveTo antes de
realizar qualquer chamada a moveTo, o padro de posio atual do desenho ser (0, 0). Se faltar
algum parmetro, o mtodo falhar e a posio atual do desenho no ser alterada.
Exemplo

O exemplo a seguir desenha um crculo com uma linha azul slida fina e um preenchimento
vermelho slido.
_root.createEmptyMovieClip( "crculo", 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();
}
Consulte tambm

MovieClip.beginFill, MovieClip.createEmptyMovieClip, MovieClip.endFill,

MovieClip.lineStyle, MovieClip.lineTo, MovieClip.moveTo

Dicionrio ActionScript 314

MovieClip._droptarget
Disponibilidade

Flash Player 4.
Uso

myMovieClip._droptarget
Descrio

Propriedade (somente leitura); retorna o caminho absoluto, em notao de sintaxe de barra, da

instncia do clipe de filme em que MovieClip foi solto. A propriedade _droptarget sempre
retorna um caminho iniciado com uma barra (/). Para comparar a propriedade _droptarget de
uma instncia a uma referncia, use a funo eval para converter o valor retornado de sintaxe de
barra para uma referncia de sintaxe de ponto.
Exemplo

O exemplo a seguir avalia a propriedade _droptarget da instncia do clipe de filme garbage e

usa eval para convert-la de sintaxe de barra em uma referncia de sintaxe de ponto. A referncia
garbage , ento, comparada com a referncia instncia do clipe de filme trash. Se as duas
referncias forem equivalentes, a visibilidade de garbage ser definida como false. Se no forem
equivalentes, a instncia de garbage ser redefinida para sua posio original.
if (eval(garbage._droptarget) == _root.trash) {
garbage._visible = false;
else {
garbage._x = x_pos;
garbage._y = y_pos;
}

As variveis x_pos e y_pos so definidas no Quadro 1 do filme com o seguinte script:

x_pos = garbage._x;
y_pos = garbage._y;
Consulte tambm

startDrag

MovieClip.duplicateMovieClip
Disponibilidade

Flash Player 5.
Uso

myMovieClip.duplicateMovieClip(newname, profundidade [,initObject])

Parmetros

newname

Um identificador exclusivo do clipe de filme duplicado.

Um nmero exclusivo que especifica o nvel de profundidade no qual o filme

especificado deve ser colocado.

profundidade

initObject Um objeto que contm propriedades com as quais o clipe de filme duplicado deve
ser preenchido. Este parmetro permite que os clipes de filme criados dinamicamente recebam
parmetros de clipe. Se initObject no for um objeto, ele ser ignorado. Todas as propriedades
de initObject so copiadas na nova instncia. As propriedades especificadas com initObject
esto disponveis para a funo construtora. Este parmetro opcional.

315

Retorna

Nada.
Descrio

Mtodo; cria uma instncia do clipe de filme especificado enquanto o filme est sendo executado.
Os clipes de filme duplicados sempre comeam a reproduo no Quadro 1, independente do
quadro atual do clipe de filme quando o mtodo duplicateMovieClip chamado. As variveis
no clipe de filme pai no so copiadas para o clipe de filme duplicado. Os clipes de filme criados
com o mtodo duplicateMovieClip no so duplicados quando voc chama
duplicateMovieMethod em seus pais. Se o clipe de filme pai for excludo, o clipe de filme
duplicado tambm o ser. Os clipes de filme adicionados com duplicateMovieClip podem ser
excludos com a ao ou o mtodo removeMovieClip.
Consulte tambm

duplicateMovieClip, MovieClip.removeMovieClip, removeMovieClip

MovieClip.enabled
Disponibilidade

Flash Player 6.
Uso

myMovieClip.enabled
Descrio

Propriedade; um valor booleano que indica se um clipe de filme de boto est ativado. O valor
padro de enabled true. Se enabled for definida como false, os mtodos de retorno de
chamada do clipe de filme de boto e os eventos de ao on no sero mais chamados. Alm disso,
os quadros Over, Down e Up so desativados. A propriedade enabled no afeta a Linha de
tempo do clipe de filme de boto; se um clipe de filme estiver sendo reproduzido, esse processo
no ser interrompido. O clipe de filme continua a receber eventos de Movieclip (por exemplo,
mouseDown, mouseUp, keyDown e keyUp).
A propriedade enabled regula apenas as propriedades de boto de um clipe de filme de boto.
possvel alterar a propriedade enabled a qualquer momento; o clipe de filme de boto
modificado ativado ou desativado imediatamente. A propriedade enabled pode ser lida a partir
de um objeto de prottipo. Se enabled estiver definida como false, o objeto no ser includo
na ordenao automtica de guias.

MovieClip.endFill
Disponibilidade

Flash Player 6.
Uso

myMovieClip.endFill()
Parmetros

Nenhum.
Retorna

Nada.

Dicionrio ActionScript 316

Descrio

Mtodo; aplica um preenchimento s linhas e curvas adicionadas desde a ltima chamada ao

mtodo beginFill ou beginGradientFill. O Flash usa o preenchimento especificado na
chamada anterior a beginFill ou beginGradientFill. Se a posio de desenho atual no for
igual posio anterior especificada em um mtodo moveTo e um preenchimento for definido, o
caminho ser fechado com uma linha e preenchido em seguida.

MovieClip.focusEnabled
Disponibilidade

Flash Player 6.
Uso

myMovieClip.focusEnabled
Descrio

Propriedade; se o valor for undefined ou false, um clipe de filme no poder receber o foco de
entrada, a menos que seja um clipe de filme de boto. Se o valor da propriedade focusEnabled
for true, um clipe de filme poder receber o foco de entrada mesmo que no seja do tipo de
boto.

MovieClip._focusrect
Disponibilidade

Flash Player 6.
Uso

myMovieClip._focusrect
Descrio

Propriedade; um valor booleano que especifica se um clipe de filme apresenta um retngulo

amarelo ao seu redor quando tem o foco do teclado. Esta propriedade pode substituir a
propriedade global _focusrect.

MovieClip._framesloaded
Disponibilidade

Flash Player 4.
Uso

myMovieClip._framesloaded
Descrio

Propriedade (somente leitura); o nmero de quadros que foram carregados de um filme em fluxo.
Esta propriedade til para determinar se o contedo de um determinado quadro e todos os
quadros antes dele foram carregados e esto disponveis localmente no navegador. Isso til para
monitorar o processo de download de filmes grandes. Por exemplo, voc pode exibir uma
mensagem para os usurios indicando que o filme est carregando at que um determinado
quadro do filme tenha sido carregado.

317

Exemplo

O exemplo a seguir utiliza a propriedade _framesloaded para iniciar um filme quando todos os
quadros esto carregados. Se nem todos os quadros estiverem carregados, a propriedade _xscale da
instncia do clipe de filme loader ser aumentada proporcionalmente para criar uma barra de
progresso.
if (_framesloaded >= _totalframes) {
gotoAndPlay ("Scene 1", "start");
else {
_root.loader._xscale = (_framesloaded/_totalframes)*100);
}

MovieClip.getBounds
Disponibilidade

Flash Player 5.
Uso

myMovieClip.getBounds(targetCoordinateSpace)
Parmetros

targetCoordinateSpace O caminho de destino da Linha de tempo cujo sistema de

coordenadas voc deseja usar como ponto de referncia.
Retorna

Um objeto com as propriedades xMin, xMax, yMin e yMax.

Descrio

Mtodo; retorna as propriedades correspondenters aos valores de coordenadas mnimos e

mximos x e y da instncia especificada por MovieClip para o parmetro
targetCoordinateSpace.
Observao: Use os mtodos localToGlobal e globalToLocal do objeto MovieClip para converter as
coordenadas locais do clipe de filme em coordenadas do Palco ou as coordenadas do Palco em coordenadas
locais, respectivamente.

Exemplo

No exemplo a seguir, o objeto retornado pelo mtodo getBounds atribudo ao identificador

clipBounds. Em seguida, possvel acessar os valores de cada propriedade e utiliz-los em um
script. Outra instncia de clipe de filme, chamada clip2, colocada junto de clip neste script.
clipBounds = clip.getBounds(_root);
clip2._x = clipBounds.xMax;
Consulte tambm

MovieClip.globalToLocal, MovieClip.localToGlobal

Dicionrio ActionScript 318

MovieClip.getBytesLoaded
Disponibilidade

Flash Player 6.
Uso

myMovieClip.getBytesLoaded()
Parmetros

Nenhum.
Retorna

Um inteiro que indica o nmero de bytes carregados.

Descrio

Mtodo; retorna o nmero de bytes carregados (enviados) para o objeto Movieclip especificado.
possvel comparar o valor do mtodo getBytesLoaded com o do mtodo getBytesTotal para
determinar a porcentagem de um clipe de filme que j foi carregada.
Consulte tambm

MovieClip.getBytesTotal

MovieClip.getBytesTotal
Disponibilidade

Flash Player 5.
Uso

myMovieClip.getBytesTotal()
Parmetros

Nenhum.
Retorna

Um nmero inteiro que indica o tamanho total, em bytes, do objeto MovieClip especificado.
Descrio

Mtodo; retorna o tamanho, em bytes, do objeto MovieClip especificado. No caso de clipes de

filme externos (o filme raiz ou um clipe de filme que est sendo carregado em um destino ou um
nvel), o valor de retorno o tamanho do arquivo SWF.
Consulte tambm

MovieClip.getBytesLoaded

MovieClip.getDepth
Disponibilidade

Flash Player 6.
Uso

myMovieClip.getDepth
Parmetros

Nenhum.

319

Retorna

Um inteiro.
Descrio

Mtodo; retorna a profundidade de uma instncia de clipe de filme.

MovieClip.getURL
Disponibilidade

Flash Player 5.
Uso

myMovieClip.getURL(URL [,janela, variveis])

Parmetros

URL

O URL a partir do qual obter o documento.

janela Um parmetro opcional que especifica o nome, quadro ou expresso que determina a
janela ou quadro HTML no qual o documento foi carregado. Tambm possvel usar um dos
seguintes nomes de destino reservados: _self especifica o quadro atual na janela atual, _blank
especifica uma nova janela, _parent especifica o pai do quadro atual, _top especifica o quadro de
nvel superior da janela atual.

Um parmetro opcional que especifica um mtodo para o envio de variveis

associado ao filme a ser carregado. Se no houver variveis, omita esse parmetro; caso contrrio,
especifique se deseja carregar as variveis usando um mtodo GET ou POST. GET anexa as variveis
ao final do URL, e usado para pequenos nmeros de variveis. POST envia as variveis em um
cabealho HTTP em separado e usado para maiores seqncias de caracteres de variveis.
variveis

Retorna

Nada.
Descrio

Mtodo; carrega um documento do URL especificado na janela especificada. O mtodo getURL

tambm pode ser usado para passar variveis para outro aplicativo definido no URL usando o
mtodo GET ou POST.
Consulte tambm

getURL

MovieClip.globalToLocal
Disponibilidade

Flash Player 5.
Uso

myMovieClip.globalToLocal(ponto)
Parmetros

O nome ou identificador de um objeto criado com o objeto genrico Object

especificando as coordenadas x e y como propriedades.

ponto

Retorna

Nada.

Dicionrio ActionScript 320

Descrio

Mtodo; converte o objeto Ponto das coordenadas do Palco (global) em coordenadas do clipe de
filme (local).
Exemplo

O exemplo a seguir converte as coordenadas x e y globais do objeto Ponto em coordenadas locais

do clipe de filme.
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();
}
Consulte tambm

MovieClip.getBounds, MovieClip.localToGlobal

MovieClip.gotoAndPlay
Disponibilidade

Flash Player 5.
Uso

myMovieClip.gotoAndPlay(quadro)
Parmetros

quadro

O nmero do quadro para o qual a reproduo enviada.

Retorna

Nada.
Descrio

Mtodo; inicia a reproduo do filme no quadro especificado.

Consulte tambm

gotoAndPlay

MovieClip.gotoAndStop
Disponibilidade

Flash Player 5.
Uso

myMovieClip.gotoAndStop(quadro)
Parmetros

quadro
Retorna

Nada.

321

O nmero do quadro para o qual a reproduo enviada.

Descrio

Mtodo; envia a reproduo para o quadro especificado do clipe de filme e a interrompe nessa posio.
Consulte tambm

gotoAndStop

MovieClip._height
Disponibilidade

Flash Player 4.
Uso

myMovieClip._height
Descrio

Propriedade; define e recupera a altura do clipe de filme, em pixels.

Exemplo

O exemplo de cdigo a seguir define a altura e a largura de um clipe de filme quando o usurio
clicar com o mouse.
onClipEvent(mouseDown) {
_width=200;
_height=200;
}

MovieClip._highquality
Disponibilidade

Flash Player 6.
Uso

myMovieClip._highquality
Descrio

Propriedade (global); especifica o nvel de sem serrilhado aplicado no filme atual. Especifique 2
(MELHOR) para aplicar alta qualidade com a suavizao de bitmap sempre ativada. Especifique
1 (alta qualidade) para aplicar o recurso sem serrilhado; isso suavizar os bitmaps se o filme no
contiver animao. Especifique 0 (baixa qualidade) para evitar o recurso sem serrilhado. Esta
propriedade pode substituir a propriedade global _highquality.
Exemplo

myMovieClip._highquality = 1;
Consulte tambm

_quality, toggleHighQuality

Dicionrio ActionScript 322

MovieClip.hitArea
Disponibilidade

Flash Player 6.
Uso

myMovieClip.hitArea
Retorna

Uma referncia a um clipe de filme.

Descrio

Propriedade; designa outro clipe de filme para atuar como a rea de clicagem de um clipe de filme
de boto. Se no houver uma propriedade hitArea ou se ela for null ou undefined, o prprio
clipe de filme de boto ser usado como a rea de clicagem. O valor da propriedade hitArea pode
ser uma referncia para um objeto de clipe de filme.
possvel alterar a propriedade hitArea a qualquer momento; o clipe de filme de boto
modificado assume imediatamente o comportamento da nova rea de clicagem. O clipe de filme
designado como rea de clicagem no precisa ficar visvel; sua forma grfica testada mesmo que
esteja invisvel. A propriedade hitArea pode ser lida de um objeto de prottipo.

MovieClip.hitTest
Disponibilidade

Flash Player 5.
Uso

myMovieClip.hitTest(x, y, shapeFlag)
myMovieClip.hitTest(destino)
Parmetros

A coordenada x da rea de clicagem no Palco.

A coordenada y da rea de clicagem no Palco.

As coordenadas x e y so definidas no espao de coordenadas globais.

destino O caminho de destino da rea de clicagem que pode entrar em interseo ou se
sobrepor instncia especificada por MovieClip. Normalmente, destino representa um boto
ou um campo de entrada de texto.

Um valor booleano que determina se ser avaliada a forma completa da instncia

especificada (true) ou apenas a caixa delimitadora (false). Esse parmetro s pode ser
especificado se a rea de clicagem for identificada com os parmetros das coordenadas x e y.

shapeFlag

Retorna

Nada.
Descrio

Mtodo; avalia a instncia especificada por MovieClip para ver se ela se sobrepe ou entra em
interseo com a rea de clicagem identificada pelos parmetros de destino ou das coordenadas x
e y.

323

Uso 1: compara as coordenadas x e y com a forma ou com a caixa delimitadora da instncia

especificada, de acordo com a definio de shapeFlag. Se shapeFlag for definido como true,
somente a rea realmente ocupada pela instncia no Palco avaliada e se x e y se sobrepuserem em
algum ponto, um valor true retornado. Isso til para determinar se o clipe de filme est
dentro de uma rea de clicagem ou de ponto ativo especificada.
Uso 2: avalia as caixas delimitadoras de destino e da instncia especificada e retorna true se elas
se sobrepuserem ou entrarem em interseo em algum ponto.
Exemplo

O exemplo a seguir usa hitTest com as propriedades x_mouse e y_mouse para determinar se o
mouse est sobre a caixa delimitadora de destino:
if (hitTest( _root._xmouse, _root._ymouse, false));

O exemplo a seguir usa hitTest para determinar se o item ball do clipe de filme se sobrepe ou
entra em interseo com o item square do clipe de filme:
if(_root.ball, hittest(_root.square)){
trace("ball intersects square");
}
Consulte tambm

MovieClip.getBounds, MovieClip.globalToLocal, MovieClip.localToGlobal

MovieClip.lineStyle
Disponibilidade

Flash Player 6.
Uso

myMovieClip.lineStyle ([espessura[, rgb[, alfa]]])

Parmetros

Um inteiro que indica a espessura da linha em pontos; a faixa de valores vlidos vai
de 0 a 255. Se nenhum nmero for especificado ou se o parmetro estiver indefinido, nenhuma
linha ser desenhada. Se um valor menor do que 0 for passado, o Flash usar 0. O valor 0 indica a
espessura fina; 255 indica a espessura mxima. Se um valor maior do que 255 for passado, o
interpretador do Flash usar 255.
espessura

rgb Um valor de cor hexadecimal da linha (por exemplo, vermelho corresponde a 0xFF0000,
azul corresponde a 0x0000FF e assim por diante). Se nenhum valor for indicado, o Flash usar
0x000000 (preto).

Um nmero inteiro que indica o valor alfa da cor da linha; a faixa de valores vlidos vai de
0 a 100. Se nenhum valor for indicado, o Flash usar 100 (slido). Se o valor for menor do que 0,
o Flash usar 0 e se for maior do que 100, o Flash usar100.

alfa

Retorna

Nada.
Descrio

Mtodo; especifica um estilo de linha que ser usado pelo Flash para as chamadas subseqentes
aos mtodos lineTo e curveTo at que lineStyle seja chamado com parmetros diferentes.
possvel chamar o mtodo lineStyle durante o desenho de um caminho para especificar estilos
diferentes para segmentos de linha distintos em um caminho.
Observao: As chamadas para clear redefinem o mtodo lineStyle como indefinido.

Dicionrio ActionScript 324

Exemplo

O cdigo a seguir desenha um tringulo com uma linha magenta slida de 5 pontos e sem
preenchimento.
_root.createEmptyMovieClip( "tringulo", 1 );
with ( _root.triangle )
{
lineStyle( 5, 0xff00ff, 100 );
moveTo( 200, 200 );
lineTo( 300,300 );
lineTo( 100, 300 );
lineTo( 200, 200 );
}
Consulte tambm

MovieClip.beginFill, MovieClip.beginGradientFill, MovieClip.clear,

MovieClip.curveTo, MovieClip.lineTo, MovieClip.moveTo,

MovieClip.lineTo
Disponibilidade

Flash Player 6.
Uso

myMovieClip.lineTo (x, y)
Parmetros

Um inteiro que indica a posio horizontal relativa ao ponto de registro do clipe de filme pai.

Um inteiro que indica a posio vertical relativa ao ponto de registro do clipe de filme pai.

Retorna

Nada.
Descrio

Mtodo; desenha uma linha utilizando o estilo atual a partir da posio do desenho no momento
em (x, y); a posio atual do desenho ento definida como (x, y). Se o clipe de filme no qual
voc est desenhando apresentar contedo criado com as ferramentas de desenho do Flash, - as
chamadas para lineTo sero feitas sob o contedo. Se voc chamar o mtodo lineTo antes de
realizar qualquer chamada a moveTo, o padro da posio atual do desenho ser (0, 0). Se faltar
algum parmetro, o mtodo falhar e a posio atual do desenho no ser alterada.
Exemplo

O exemplo a seguir desenha um tringulo sem nenhuma linha e um preenchimento azul

parcialmente transparente.
_root.createEmptyMovieClip ("tringulo", 1);
with (_root.triangle){
beginFill (0x0000FF, 50);
lineStyle (5, 0xFF00FF, 100);
moveTo (200, 200);
lineTo (300, 300);
lineTo (100, 300);
lineTo (200, 200);
endFill();
}

325

Consulte tambm

MovieClip.beginFill, MovieClip.createEmptyMovieClip, MovieClip.endFill,

MovieClip.lineStyle, MovieClip.moveTo

MovieClip.loadMovie
Disponibilidade

Flash Player 5.
Uso

myMovieClip.loadMovie("url" [,variveis])
Parmetros

url Um URL absoluto ou relativo do arquivo SWF ou JPEG a ser carregado. Um caminho
relativo deve ser relativo ao arquivo SWF em _level0. O URL deve estar no mesmo subdomnio
que o URL onde o filme reside no momento. Para uso no Flash Player independente ou para teste
no modo de teste de filme no aplicativo de criao do Flash, todos os arquivos SWF devem ser
armazenados na mesma pasta, e os nomes dos arquivos no podem incluir especificaes de pasta
ou unidade de disco.

Um parmetro opcional que especifica um mtodo HTTP para o envio ou

carregamento de variveis. O parmetro deve ser a seqncia de caracteres GET ou POST. Se no
houver nenhuma varivel a ser enviada, omita esse parmetro. O mtodo GET anexa as variveis ao
final do URL e usado para pequenos nmeros de variveis. O mtodo POST envia as variveis em
um cabealho HTTP separado e usado para seqncias de caracteres maiores de variveis.
variveis

Retorna

Nada.
Descrio

Mtodo; carrega arquivos SWF ou JPEG em um clipe de filme no Flash Player durante a
reproduo do filme original. Sem o mtodo loadMovie, o Flash Player exibe um nico filme
(arquivo SWF) e encerrado em seguida. O mtodo loadMovie permite que voc exiba vrios
filmes de uma vez e alterne entre os filmes sem carregar outro documento HTML.
Um filme ou imagem carregada em um clipe de filme herda as propriedades de posio, rotao e
dimensionamento do clipe de filme. Utilize o caminho de destino do clipe de filme para
especificar o filme carregado.
Use o mtodo unloadMovie para remover filmes ou imagens carregadas com o mtodo
Use o mtodo loadVariables para manter o filme ativo e atualizar as variveis com
os novos valores.

loadMovie.

Consulte tambm

loadMovie, loadMovieNum, MovieClip.loadVariables, MovieClip.unloadMovie,

unloadMovie, unloadMovieNum

Dicionrio ActionScript 326

MovieClip.loadVariables
Disponibilidade

Flash Player 5.
Uso

myMovieClip.loadVariables("url", variveis)
Parmetros

url O URL absoluto ou relativo para o arquivo externo que contm as variveis a serem
carregadas. O host do URL deve estar no mesmo subdomnio que o clipe de filme.
variveis Um parmetro opcional que especifica um mtodo HTTP para o envio de variveis.
O parmetro deve ser a seqncia de caracteres GET ou POST. Se no houver nenhuma varivel a
ser enviada, omita esse parmetro. O mtodo GET anexa as variveis ao final do URL e usado
para pequenos nmeros de variveis. O mtodo POST envia as variveis em um cabealho HTTP
separado e usado para seqncias de caracteres maiores de variveis.
Retorna

Nada.
Descrio

Mtodo; l dados de um arquivo externo e define os valores das variveis em MovieClip. O

arquivo externo pode ser um arquivo de texto gerado por um script CGI, Active Server Pages
(ASP) ou PHP, e pode conter qualquer nmero de variveis.
Esse mtodo tambm pode ser usado para atualizar variveis no clipe de filme ativo com
novos valores.
Esse mtodo exige que o texto no URL esteja no formato MIME padro: aplicativo/x-wwwformato de url codificado (formato de script CGI).
Consulte tambm

loadMovie, loadVariables, loadVariablesNum, MovieClip.unloadMovie

MovieClip.localToGlobal
Disponibilidade

Flash Player 5.
Uso

myMovieClip.localToGlobal(ponto)
Parmetros

O nome ou identificador de um objeto criado com o objeto Object, que especifica as

coordenadas x e y como propriedades.

ponto

Retorna

Nada.
Descrio

Mtodo; converte o objeto Ponto das coordenadas do clipe de filme (locais) em coordenadas do
Palco (globais).

327

Exemplo

O exemplo a seguir converte as coordenadas x e y do objeto Ponto das coordenadas do clipe de

filme (local) em coordenadas do Palco (globais). As coordenadas x e y locais so especificadas com
as propriedades _xmouse e _ymouse para recuperar as coordenadas x e y da posio do mouse.
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();
}
Consulte tambm

MovieClip.globalToLocal

MovieClip.moveTo
Disponibilidade

Flash Player 6.
Uso

myMovieClip.moveTo (x, y)
Parmetros

Um inteiro que indica a posio horizontal relativa ao ponto de registro do clipe de filme pai.

Um inteiro que indica a posio vertical relativa ao ponto de registro do clipe de filme pai.

Retorna

Nada.
Descrio

Mtodo; move a posio atual do desenho para (x, y). Se faltar algum parmetro, o mtodo
falhar e a posio atual do desenho no ser alterada.
Exemplo

Este exemplo desenha um tringulo com linhas magenta slidas de 5 pontos e sem
preenchimento. A primeira linha cria um clipe de filme vazio para o desenho. Um tipo de linha
definido no comando with e, em seguida, a posio inicial do desenho indicada pelo mtodo
moveTo.
_root.createEmptyMovieClip( "tringulo", 1 );
with ( _root.triangle )
{
lineStyle( 5, 0xff00ff, 100 );
moveTo( 200, 200 );
lineTo( 300,300 );
lineTo( 100, 300 );
lineTo( 200, 200 );
}
Consulte tambm

MovieClip.createEmptyMovieClip, MovieClip.lineStyle, MovieClip.lineTo

Dicionrio ActionScript 328

MovieClip._name
Disponibilidade

Flash Player 4.
Uso

myMovieClip._name
Descrio

Propriedade; retorna o nome da instncia do clipe de filme especificado por MovieClip.

MovieClip.nextFrame
Disponibilidade

Flash Player 5.
Uso

myMovieClip.nextFrame()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; envia a reproduo para o prximo quadro e a encerra.

Consulte tambm

nextFrame

MovieClip.onData
Disponibilidade

Flash Player 6.
Uso

myMovieClip.onData
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Manipulador de eventos; chamado quando um clipe de filme recebe dados de uma chamada
loadVariables ou loadMovie.
necessrio definir uma funo que seja executada quando o evento chamado.

329

Exemplo

O exemplo a seguir define uma funo para o mtodo onData que envia uma ao trace janela
Sada.
myMovieClip.onData = function () {
trace ("onData chamado");
};

MovieClip.onDragOut
Disponibilidade

Flash Player 6.
Uso

myMovieClip.onDragOver
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Manipulador de eventos; chamado quando o ponteiro pressionado e arrastado fora e, em

seguida, sobre o clipe de filme.
necessrio definir uma funo que seja executada quando o evento chamado.
Exemplo

O exemplo a seguir define uma funo para o mtodo onDragOut que envia uma ao trace
janela Sada.
myMovieClip.onDragOut = function () {
trace ("onDragOut chamado");
};
Consulte tambm

MovieClip.onDragOver

MovieClip.onDragOver
Disponibilidade

Flash Player 6.
Uso

myMovieClip.onDragOver
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Manipulador de eventos; chamado quando o ponteiro pressionado e arrastado fora e, em

seguida, sobre o clipe de filme.
necessrio definir uma funo que seja executada quando o evento chamado.

Dicionrio ActionScript 330

Exemplo

O exemplo a seguir define uma funo para o mtodo onDragOut que envia uma ao trace
janela Sada.
myMovieClip.onDragOver = function () {
trace ("onDragOver chamado");
};
Consulte tambm

MovieClip.onDragOut

MovieClip.onEnterFrame
Disponibilidade

Flash Player 6.
Uso

myMovieClip.onEnterFrame
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Manipulador de eventos; chamado continuamente taxa de quadros do filme. As aes associadas

ao evento do clipe enterFrame so processadas depois das aes que tenham sido anexadas aos
quadros afetados.
necessrio definir uma funo que seja executada quando o evento chamado.
Exemplo

O exemplo a seguir define uma funo para o mtodo onEnterFrame que envia trace janela
Sada.
myMovieClip.onEnterFrame = function () {
trace ("onEnterFrame chamado");
};

MovieClip.onKeyDown
Disponibilidade

Flash Player 6.
Uso

myMovieClip.onKeyDown
Parmetros

Nenhum.
Retorna

Nada.

331

Descrio

Manipulador de eventos; chamado quando um clipe de filme tem o foco de entrada e uma tecla
pressionada. O evento onKeyDown chamado sem nenhum parmetro. Use os mtodos
Key.getAscii e Key.getCode para determinar qual tecla foi pressionada.
necessrio definir uma funo que seja executada quando o evento chamado.
Exemplo

O exemplo a seguir define uma funo para o mtodo onKeyDown que envia uma ao trace
janela Sada.
myMovieClip.onKeyDown = function () {
trace ("onKeyDown chamado");
};
Consulte tambm

MovieClip.onKeyUp

MovieClip.onKeyUp
Disponibilidade

Flash Player 6.
Uso

myMovieClip.onKeyUp
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Evento; chamado quando uma tecla liberada. O evento onKeyUp chamado sem nenhum
parmetro. Use os mtodos Key.getAscii e Key.getCode para determinar qual tecla foi
pressionada.
necessrio definir uma funo que seja executada quando o evento chamado.
Exemplo

O exemplo a seguir define uma funo para o mtodo onKeyPress que envia uma ao trace
janela Sada.
myMovieClip.onKeyUp = function () {
trace ("onKeyUp chamado");
};

MovieClip.onKillFocus
Disponibilidade

Flash Player 6.
Uso

myMovieClip.onKillFocus = function (newFocus) {

comandos;

};

Dicionrio ActionScript 332

Parmetros

newFocus

O objeto que recebe o foco do teclado.

Retorna

Nada.
Descrio

Manipulador de eventos; um evento que chamado quando um clipe de filme perde o foco do
teclado. O mtodo onKillFocus recebe um parmetro, newFocus, que um objeto
representando o novo objeto a receber o foco. Se nenhum objeto receber o foco, newFocus
conter o valor null.

MovieClip.onLoad
Disponibilidade

Flash Player 6.
Uso

myMovieClip.onLoad
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Manipulador de eventos; chamado quando o clipe de filme criado e aparece na Linha de tempo.
necessrio definir uma funo que seja executada quando o evento chamado.
Exemplo

O exemplo a seguir define uma funo para o mtodo onLoad que envia uma ao trace janela
Sada:
myMovieClip.onLoad = function () {
trace ("onLoad chamado");
};

MovieClip.onMouseDown
Disponibilidade

Flash Player 6.
Uso

myMovieClip.onMouseDown
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Manipulador de eventos; chamado quando o boto do mouse pressionado.

necessrio definir uma funo que seja executada quando o evento chamado.

333

Exemplo

O exemplo a seguir define uma funo para o mtodo onMouseDown que envia uma ao trace
janela Sada:
myMovieClip.onMouseDown = function () {
trace ("onMouseDown chamado");
}

MovieClip.onMouseMove
Disponibilidade

Flash Player 6.
Uso

myMovieClip.onMouseMove
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Manipulador de eventos; chamado quando o mouse movido.

necessrio definir uma funo que seja executada quando o evento chamado.
Exemplo

O exemplo a seguir define uma funo para o mtodo onMouseMove que envia uma ao trace
janela Sada.
myMovieClip.onMouseMove = function () {
trace ("onMouseMove chamado");
};

MovieClip.onMouseUp
Disponibilidade

Flash Player 6.
Uso

myMovieClip.onMouseUp
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Manipulador de eventos; chamado quando o mouse liberado.

necessrio definir uma funo que seja executada quando o evento chamado.

Dicionrio ActionScript 334

Exemplo

O exemplo a seguir define uma funo para o mtodo onMouseUp que envia uma ao trace
janela Sada.
myMovieClip.onMouseUp = function () {
trace ("onMouseUp chamado");

};

MovieClip.onPress
Disponibilidade

Flash Player 6.
Uso

myMovieClip.onPress
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Identificador de eventos; chamado quando o ponteiro do mouse clicado sobre um clipe de filme.
necessrio definir uma funo que seja executada quando o evento chamado.
Exemplo

O exemplo a seguir define uma funo para o mtodo onPress que envia uma ao trace janela
Sada.
myMovieClip.onPress = function () {
trace ("onPress chamado");
};

MovieClip.onRelease
Disponibilidade

Flash Player 6.
Uso

myMovieClip.onRelease
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Manipulador de eventos; chamado quando um clipe de filme de boto liberado.

necessrio definir uma funo que seja executada quando o evento chamado.

335

Exemplo

O exemplo a seguir define uma funo para o mtodo onPress que envia uma ao trace janela
Sada.
myMovieClip.onRelease = function () {
trace ("onRelease chamado");
};

MovieClip.onReleaseOutside
Disponibilidade

Flash Player 6.
Uso

myMovieClip.onReleaseOutside
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Manipulador de eventos; chamado quando o mouse liberado enquanto o ponteiro est fora do
clipe de filme, depois que o boto do mouse pressionado dentro do clipe de filme.
necessrio definir uma funo que seja executada quando o evento chamado.
Exemplo

O exemplo a seguir define uma funo para o mtodo onReleaseOutside que envia uma ao
trace janela Sada.
myMovieClip.onReleaseOutside = function () {
trace ("onReleaseOutside chamado");
};

MovieClip.onRollOut
Disponibilidade

Flash Player 6.
Uso

myMovieClip.onRollOut
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Manipulador de eventos; chamado quando o ponteiro rola fora da rea de um clipe de filme.
necessrio definir uma funo que seja executada quando o evento chamado.

Dicionrio ActionScript 336

Exemplo

O exemplo a seguir define uma funo para o mtodo onRollOut que envia uma ao trace
janela Sada.
myMovieClip.onRollOut = function () {
trace ("onRollOut chamado");
};

MovieClip.onRollOver
Disponibilidade

Flash Player 6.
Uso

myMovieClip.onRollOver
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Manipulador de eventos; chamado quando o ponteiro rola sobre uma rea do clipe de filme.
necessrio definir uma funo que seja executada quando o evento chamado.
Exemplo

O exemplo a seguir define uma funo para o mtodo onRollOver que envia uma ao trace
janela Sada.
myMovieClip.onRollOver = function () {
trace ("onRollOver chamado");
};

MovieClip.onSetFocus
Disponibilidade

Flash Player 6.
Uso

myMovieClip.onSetFocus = function(oldFocus){
comandos;
};
Parmetros

oldFocus

O objeto que perde o foco.

Retorna

Nada.
Descrio

Manipulador de eventos; chamado quando um clipe de filme recebe o foco do teclado. O

parmetro oldFocus o objeto que perde o foco. Por exemplo, se o usurio pressionar a tecla Tab
para mover o foco de entrada de um clipe de filme para um campo de texto, oldFocus contr a
instncia do clipe de filme.
Se nenhum objeto possua o foco anteriormente, oldFocus conter um valor null.

337

MovieClip.onUnload
Disponibilidade

Flash Player 6.
Uso

myMovieClip.onUnload
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Manipulador de eventos; chamado no primeiro quadro depois que o clipe de filme removido da
Linha de tempo. As aes associadas ao evento onUnload so processadas antes de qualquer ao
anexada ao quadro em questo. necessrio definir uma funo a ser executada quando o evento
for chamado.
Exemplo

O exemplo a seguir define uma funo para o mtodo onUnload que envia uma ao trace
janela Sada.
myMovieClip.onUnload = function () {
trace ("onUnload chamado");
};

MovieClip._parent
Disponibilidade

Flash Player 6.
Uso

myMovieClip._parent.property
_parent._parent.property
Descrio

Propriedade; especifica ou retorna uma referncia ao clipe de filme ou objeto que contm o clipe
de filme ou objeto atual. O objeto atual o que contm o cdigo ActionScript que faz referncia a
_parent. Use a propriedade _parent para especificar um caminho relativo para clipes de filme ou
objetos que estiverem acima do clipe de filme ou objeto atual.
Consulte tambm

_root, targetPath

Dicionrio ActionScript 338

MovieClip.play
Disponibilidade

Flash Player 5.
Uso

myMovieClip.play()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; move a reproduo na Linha de tempo do clipe de filme.

Consulte tambm

play

MovieClip.prevFrame
Disponibilidade

Flash Player 5.
Uso

myMovieClip.prevFrame()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; envia a reproduo do quadro anterior e o pra.

Consulte tambm

prevFrame

MovieClip.removeMovieClip
Disponibilidade

Flash Player 5.
Uso

myMovieClip.removeMovieClip()
Parmetros

Nenhum.
Retorna

Nada.

339

Descrio

Mtodo; remove uma instncia de clipe de filme criado com a ao duplicateMovieclip ou os

mtodos duplicateMovieClip ou attachMovie do objeto MovieClip.
Consulte tambm

MovieClip.attachMovie, MovieClip.attachMovie, removeMovieClip,

MovieClip.attachMovie

MovieClip._rotation
Disponibilidade

Flash Player 4.
Uso

myMovieClip._rotation
Descrio

Propriedade; especifica a rotao do clipe de filme em graus.

MovieClip.setMask
Disponibilidade

Flash Player 6.
Uso

myMovieClip.setMask (maskMovieClip)
Parmetros

myMovieClip
maskMovieClip

O nome de instncia de um clipe de filme a ser mascarado.

O nome de instncia de um clipe de filme que ser uma mscara.

Retorna

Nada.
Descrio

Mtodo; transforma o clipe de filme do parmetro maskMovieClip em uma mscara que revela o
clipe de filme especificado pelo parmetro myMovieClip.
O mtodo setMask permite que clipes de filme com vrios quadros e contedo complexo com
diversas camadas atuem como mscaras. possvel ativar e desativar mscaras em tempo de
execuo. Entretanto, voc no pode usar a mesma mscara para vrios itens com mscara (o que
possvel atravs do uso de camadas de mscara). Se houver fontes de dispositivo em um clipe de
filme mascarado, elas sero desenhadas, mas no mascaradas. No possvel definir um clipe de
filme como sua prpria mscara, por exemplo mc.setMask(mc).
Se voc criar uma camada de mscara que contenha um clipe de filme e, em seguida, aplicar o
mtodo setMask a ele, a chamada setMask ter prioridade e no ser possvel reverter isso. Por
exemplo, se houver um clipe de filme em uma camada de mscara chamada UIMask, esta mascara
outra camada que contm outro clipe de filme chamado UIMaskee. Se, medida que o filme for
reproduzido, voc chamar UIMask.setMask(UIMaskee), UIMask ser mascarado por UIMaskee
desse ponto em diante.

Dicionrio ActionScript 340

Para cancelar uma mscara criada com ActionScript, passe o valor null ao mtodo setMask. O
cdigo a seguir cancela a mscara sem afetar a camada da mscara na Linha de tempo.
UIMask.setMask(null)
Exemplo

O exemplo de cdigo a seguir usa o clipe de filme circleMask para mascarar o clipe de filme
theMaskee.
theMaskee.setMask(circleMask);

MovieClip._soundbuftime
Disponibilidade

Flash Player 6.
Uso

myMovieClip._soundbuftime
Descrio

Propriedade (global); um inteiro que especifica o nmero de segundos em que um som

armazenado em pr-buffer antes de comear a fluir.

MovieClip.startDrag
Disponibilidade

Flash Player 5.
Uso

myMovieClip.startDrag([bloqueio, [esquerdo, superior, direito, inferior]])

Parmetros

Um valor booleano que especifica se o clipe de filme a ser arrastado est bloqueado
no centro da posio do mouse (true) ou no ponto onde o usurio clicou pela primeira vez no
clipe de filme (false). Este parmetro opcional.
bloqueio

esquerdo, superior, direito, inferior

Valores relativos s coordenadas do pai do clipe de

filme que especificam um retngulo de restrio para o clipe de filme. Esses parmetros so
opcionais.

Retorna

Nada.
Descrio

Mtodo; permite que o usurio arraste o clipe de filme especificado. O filme permanece arrastvel
at que seja explicitamente encerrado chamando o mtodo stopDrag ou at que outro clipe de
filme se torne arrastvel. Somente um clipe de filme arrastvel de cada vez.
Consulte tambm

MovieClip._droptarget, MovieClip.startDrag, MovieClip.stopDrag

341

MovieClip.stop
Disponibilidade

Flash Player 5.
Uso

myMovieClip.stop()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo ; pra o clipe de filme em execuo no momento.

Consulte tambm

stop

MovieClip.stopDrag
Disponibilidade

Flash Player 5.
Uso

myMovieClip.stopDrag()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; finaliza um mtodo startDrag. Um filme que adquire a caracterstica de arrastvel com
o mtodo startDrag, permanece arrastvel at a adio de um mtodo stopDrag ou at que
outro filme se torne arrastvel. Somente um clipe de filme arrastvel de cada vez.
Consulte tambm

MovieClip._droptarget, MovieClip.startDrag, stopDrag

MovieClip.swapDepths
Disponibilidade

Flash Player 5.
Uso

myMovieClip.swapDepths(profundidade)
myMovieClip.swapDepths(destino)

Dicionrio ActionScript 342

Parmetros

destino A instncia do clipe de filme cuja profundidade est sendo trocada pela instncia
especificada em myMovieClip. As duas instncias devem ter o mesmo clipe de filme pai.

Um nmero que especifica o nvel de profundidade no qual MovieClip

deve ser colocado.

profundidade

Retorna

Nada.
Descrio

Mtodo; troca a ordem do empilhamento ou z (nvel de profundidade) da instncia especificada

(MovieClip) pelo filme determinado pelo parmetro target ou pelo filme que ocupa atualmente
o nvel de profundidade indicado no parmetro depth. Os dois filmes devem ter o mesmo clipe
de filme pai. Trocar o nvel de profundidade do clipe de filme tem o efeito de mover um filme
para frente ou para trs de outro. Se um filme fica interpolado quando esse mtodo chamado, a
interpolao encerrada.
Consulte tambm

_level

MovieClip.tabChildren
Disponibilidade

Flash Player 6.
Uso

myMovieClip.tabChildren
Descrio

Propriedade; indefinida por padro. Se tabChildren for undefined ou true, os filhos de um

clipe de filme sero includos na ordenao automtica de guias. Se o valor de tabChildren for
false, os filhos de um clipe de filme no sero includos na ordenao automtica de guias.
Exemplo

Um dispositivo de IU de caixa de listagem criado como um clipe de filme contm vrios itens.
possvel clicar em cada um desses itens para selecion-los, portanto, estes itens so botes.
Todavia, somente a prpria caixa de listagem considerada uma parada de tabulao. Os itens
contidos na caixa de listagem devem ser excludos da ordenao de guias. Para fazer isso, defina a
propriedade tabChildren da caixa de listagem como false.
A propriedade tabChildren no apresenta nenhum efeito quando a propriedade tabIndex
usada; ela s afeta a ordenao automtica de guias.
Consulte tambm

Button.tabIndex, TextField.tabIndex

343

MovieClip.tabEnabled
Disponibilidade

Flash Player 6.
Uso

MovieClip.tabEnabled
Descrio

Propriedade; pode ser definida em uma instncia dos objetos MovieClip, Button ou TextField. A
opo undefined utilizada por padro.
Se a propriedade tabEnabled for undefined ou true, o objeto ser includo na ordenao
automtica de guias. Se a propriedade tabIndex tambm estiver definida com um determinado
valor, o objeto ser includo na ordenao personalizada de guias tambm. Se tabEnabled for
false, o objeto no ser includo na ordenao automtica de guias. No caso de um clipe de
filme, se tabEnabled for false, os filhos do clipe de filme ainda podero ser includos na
ordenao automtica de guias, a menos que a propriedade tabChildren tambm seja definida
como false.
Consulte tambm

MovieClip.tabChildren, MovieClip.tabIndex

MovieClip.tabIndex
Disponibilidade

Flash Player 6.
Uso

myMovieClip.tabIndex
Descrio

Propriedade; permite personalizar a ordenao de guias dos objetos em um filme. A propriedade

tabIndex permanece indefinida por padro. Voc pode definir tabIndex em um boto, clipe
de filme ou instncia de campo de texto.
Se um objeto de um filme do Flash contm uma propriedade tabIndex, a ordenao automtica
de guias desativada. Nesse caso, a ordenao calculada com base nas propriedades tabIndex
dos objetos no filme. A ordenao personalizada de guias inclui apenas os objetos que tm
propriedades tabIndex.
A propriedade tabIndex deve ser um inteiro positivo. Os objetos so ordenados de acordo com
suas propriedades tabIndex, em ordem ascendente. Um objeto com tabIndex de 1 precede um
objeto com tabIndex de 2. A ordenao personalizada de guias ignora os relacionamentos
hierrquicos dos objetos em um filme do Flash. Todos os objetos contidos no filme do Flash que
possuem a propriedade tabIndex so colocados na ordenao de guias. Voc no deve usar o
mesmo valor de tabIndex para vrios objetos.

Dicionrio ActionScript 344

MovieClip._target
Disponibilidade

Flash Player 4.
Uso

myMovieClip._target
Descrio

Propriedade (somente leitura); retorna o caminho de destino da instncia do clipe de filme

especificada no parmetro MovieClip.

MovieClip._totalframes
Disponibilidade

Flash Player 4.
Uso

myMovieClip._totalframes
Descrio

Propriedade (somente leitura); retorna o nmero total de quadros na instncia de clipe de filme
especificada no parmetro MovieClip.

MovieClip.trackAsMenu
Disponibilidade

Flash Player 6.
Uso

myMovieClip.trackAsMenu
Descrio

Propriedade; uma propriedade booleana que indica se outros botes ou clipes de filme podem ou
no receber eventos de liberao de mouse. Permite a criao de menus. Voc pode definir a
propriedade trackAsMenu em qualquer boto ou objeto de clipe de filme. Se a propriedade
trackAsMenu no existir, o comportamento padro ser false.
Voc pode alterar a propriedade trackAsMenu a qualquer momento; o clipe de filme de boto
modificado adquire imediatamente o novo comportamento.
Consulte tambm

Button.trackAsMenu

MovieClip.unloadMovie
Disponibilidade

Flash Player 5.
Uso

myMovieClip.unloadMovie()
Parmetros

Nenhum.

345

Retorna

Nada.
Descrio

Mtodo; remove um clipe de filme carregado com os mtodos do MovieClip loadMovie ou

attachMovie.
Consulte tambm

MovieClip.attachMovie, MovieClip.loadMovie, unloadMovie, unloadMovieNum

MovieClip._url
Disponibilidade

Flash Player 4.
Uso

myMovieClip._url
Descrio

Propriedade (somente leitura); recupera o URL do arquivo SWF do qual o clipe de filme foi
descarregado.

MovieClip.useHandCursor
Disponibilidade

Flash Player 6.
Uso

myMovieClip.useHandCursor
Descrio

Propriedade; um valor booleano que indica se o cursor em forma de mo exibido quando um

usurio rola o mouse sobre um clipe de filme de boto. O valor padro de useHandCursor
true. Se useHandCursor estiver definida como true, o cursor em forma de mo padro usado
para botes exibido quando um usurio rola o mouse sobre um clipe de filme de boto. Se
useHandCursor for false, o cursor em forma de seta ser usado.
Voc pode alterar a propriedade useHandCursor a qualquer momento; o clipe de filme de boto
modificado adquire imediatamente o comportamento do novo cursor. A propriedade
useHandCursor pode ser lida de um objeto de prottipo.

Dicionrio ActionScript 346

MovieClip._visible
Disponibilidade

Flash Player 4.
Uso

myMovieClip._visible
Descrio

Propriedade; um valor booleano que indica se o filme especificado pelo parmetro MovieClip est
visvel. Os clipes de filme que no so visveis (propriedade _visible definida como false) so
desativados. Por exemplo, um boto em um clipe de filme com a propriedade _visible definida
como false no pode ser clicado.

MovieClip._width
Disponibilidade

Flash Player 4 como uma propriedade somente leitura.

Uso

myMovieClip._width
Descrio

Propriedade; define e recupera a largura do clipe de filme, em pixels.

Exemplo

O exemplo de cdigo a seguir define a altura e a largura das propriedades de um clipe de filme
quando o usurio clica com o mouse.
onclipEvent(mouseDown) {
_width=200;
_height=200;
}
Consulte tambm

MovieClip._height

MovieClip._x
Disponibilidade

Flash Player 3.
Uso

myMovieClip._x
Descrio

Propriedade; um inteiro que define a coordenada x do filme relativa s coordenadas locais do clipe
de filme pai. Se um clipe de filme estiver na Linha de tempo principal, seu sistema de coordenadas
refere-se ao canto superior esquerdo do Palco como (0, 0). Se o clipe de filme estiver dentro de
outro clipe de filme que tem transformaes, o clipe de filme est no sistema de coordenadas local
do clipe de filme anexado. Assim, para um clipe de filme girado 90 no sentido anti-horrio, os
filhos desse clipe herdam um sistema de coordenadas que girado 90 no mesmo sentido. As
coordenadas do clipe de filme referem-se posio do ponto do registro.
Consulte tambm

MovieClip._xscale, MovieClip._y, MovieClip._yscale

347

MovieClip._xmouse
Disponibilidade

Flash Player 5.
Uso

myMovieClip._xmouse
Descrio

Propriedade (somente leitura); retorna a coordenada x da posio do mouse.

Consulte tambm

Mouse (objeto), MovieClip._ymouse

MovieClip._xscale
Disponibilidade

Flash Player 4.
Uso

myMovieClip._xscale
Descrio

Propriedade; determina o dimensionamento horizontal (porcentagem) do clipe de filme como

aplicado do ponto do registro do clipe de filme. O ponto de registro padro (0,0).
Dimensionar o sistema de coordenadas local afeta as configuraes da propriedade _x e _y, que
so definidas em pixels. Por exemplo, se o clipe de filme pai dimensionado em 50%, a definio
da propriedade _x move um objeto no clipe de filme pela metade do nmero de pixels, como se o
filme tivesse sido definido em 100%.
Consulte tambm

MovieClip._x, MovieClip._y, MovieClip._yscale

MovieClip._y
Disponibilidade

Flash Player 3.
Uso

myMovieClip._y
Descrio

Propriedade; define a coordenada y do filme relativa s coordenadas locais do clipe de filme pai. Se
um clipe de filme estiver na Linha de tempo principal, seu sistema de coordenadas refere-se ao
canto superior esquerdo do Palco como (0, 0). Se o clipe de filme estiver dentro de outro clipe de
filme que tem transformaes, o clipe de filme est no sistema de coordenadas local do clipe de
filme anexado. Assim, para um clipe de filme girado 90 no sentido anti-horrio, os filhos do clipe
de filme herdam um sistema de coordenadas que girado 90 no mesmo sentido. As coordenadas
do clipe de filme referem-se posio do ponto de registro.
Consulte tambm

MovieClip._x, MovieClip._xscale, MovieClip._yscale

Dicionrio ActionScript 348

MovieClip._ymouse
Disponibilidade

Flash Player 5.
Uso

myMovieClip._ymouse
Descrio

Propriedade (somente leitura); indica a coordenada y da posio do mouse.

Consulte tambm

Mouse (objeto), MovieClip._xmouse

MovieClip._yscale
Disponibilidade

Flash Player 4.
Uso

myMovieClip._yscale
Descrio

Propriedade; define a escala vertical (porcentagem) do clipe de filme conforme aplicado do ponto
de registro do clipe de filme. O ponto de registro padro (0,0).
Dimensionar o sistema de coordenadas local afeta as configuraes da propriedade _x e _y, que
so definidas em pixels. Por exemplo, se o clipe de filme pai dimensionado em 50%, definir a
propriedade _x move um objeto no clipe de filme pela metade do nmero de pixels, como se o
filme tivesse sido dimensionado em 100%.
Consulte tambm

MovieClip._x, MovieClip._xscale, MovieClip._y

NaN
Disponibilidade

Flash Player 5.
Uso

NaN
Descrio

Varivel; uma varivel predefinida com o valor IEEE 754 para NaN (No Nmero).

349

ne (diferente especfico de seqncia de caracteres)

Disponibilidade

Flash Player 4. Este operador foi reprovado e substitudo pelo operador != (diferena).
Uso

expression1 ne expression2
Parmetros

expression1,expression2

Nmeros, seqncias de caracteres ou variveis.

Retorna

Nada.
Descrio

Operador (comparao); compara a expression1 com a expression2 e retorna true se a

expression1 no for igual expression2; caso contrrio, retorna false.
Consulte tambm

!= (diferena)

new
Disponibilidade

Flash Player 5.
Uso

novo construtor()
Parmetros

construtor Uma funo seguida por parmetros opcionais em parnteses. Normalmente, a

funo o nome do tipo de objeto (por exemplo, Array, Math, Number ou Object) a ser criado.
Retorna

Nada.
Descrio

Operador; cria um novo objeto, inicialmente annimo, e chama a funo identificada pelo
parmetro construtor. O novo operador passa funo quaisquer parmetros opcionais em
parnteses, bem como o objeto recm-criado, que referenciado com a palavra-chave this. Em
seguida, a funo construtora pode usar this para definir as variveis do objeto.
A propriedade prototype da funo construtora copiada na propriedade __proto__ do novo
objeto. Como resultado, o novo objeto suporta todos os mtodos e propriedades especificados no
objeto Prototype da funo construtora.

Dicionrio ActionScript 350

Exemplo

O exemplo a seguir cria a funo Book e, em seguida, usa o operador new para criar os objetos
book1 e book2.
function Book(nome, preo){
this.name = name;
this.price = price;
}
book1 = new Book("Confederacy of Dunces", 19.95);
book2 = new Book("The Floating Opera", 10.95);
Exemplo

O exemplo a seguir usa o novo operador para criar uma instncia do objeto Array com 18
elementos:
golfCourse = new Array(18);
Consulte tambm

[] (acesso de matriz), {} (inicializador de objeto)

A seo do mtodo constructor em cada entrada do objeto.

newline
Disponibilidade

Flash Player 4.
Uso

newline
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Constante; inclui um caractere de retorno de carro () que insere uma linha em branco no cdigo
do ActionScript. Use newline para aumentar o espao para informaes recuperadas por uma
funo ou ao em seu cdigo.

nextFrame
Disponibilidade

Flash 2.
Uso

nextFrame()
Parmetros

Nenhum.
Retorna

Nada.

351

Descrio

Ao; envia a reproduo para o prximo quadro e o encerra.

Exemplo

Neste exemplo, quando o usurio clica no boto, a reproduo passa para o prximo quadro e
encerrada.
on (release) {
nextFrame();
}

nextScene
Disponibilidade

Flash 2.
Uso

nextScene()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Ao; envia a reproduo para o Quadro 1 da prxima cena e faz uma interrupo.
Exemplo

Neste exemplo, quando o usurio libera o boto, a reproduo enviada para o Quadro1 da
prxima cena.
on(release) {
nextScene();
}
Consulte tambm

prevScene

not
Disponibilidade

Flash Player 4. Este operador foi substitudo pelo operador ! (NOT lgico).
Uso

not expresso
Parmetros

expresso

Uma varivel ou outra expresso que seja convertida em um valor booleano.

Descrio

Operador; executa uma operao NOT lgica no Flash Player 4.

Consulte tambm

! (NOT lgico)

Dicionrio ActionScript 352

null
Disponibilidade

Flash Player 5.
Uso

null
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Palavra-chave; um valor especial que pode ser atribudo a variveis, ou retornado por uma funo
se nenhum dado tiver sido fornecido. Voc pode usar null para representar os valores ausentes ou
no ter um tipo de dados definido.
Exemplo

Em um contexto numrico, null avaliado como 0. possvel realizar testes de igualdade com
null. Neste comando, um n de rvore binrio no tem filho esquerda; por isso, o campo do
filho esquerda pode ser definido como null.
if (tree.left == null) {
tree.left = new TreeNode();
}

Number (funo)
Disponibilidade

Flash Player 4.
Uso

Number(expresso)
Parmetros

expresso

Uma expresso a ser convertida em um nmero.

Retorna

Nada.
Descrio

Funo; converte o parmetro expresso em um nmero e retorna um valor como a seguir:

Se expresso for um nmero, o valor de retorno ser expresso.
Se expresso for um valor booleano, o valor de retorno ser 1 se expresso for true ou 0 se
expresso for false.
Se expresso for uma seqncia de caracteres, a funo tenta analisar expresso como um
nmero decimal com um exponente inicial opcional, isto , 1,57505e-3.
Se expresso for indefinida, o valor de retorno ser 0.

353

Essa funo usada para converter os arquivos do Flash 4 que contm operadores obsoletos que
so importados no ambiente de criao do Flash 5. Consulte o operador & para obter mais
informaes.
Consulte tambm

Number (objeto)

Number (objeto)
O objeto Number um objeto wrapper simples do tipo de dados nmero; isso significa que voc
pode manipular valores numricos primitivos usando os mtodos e propriedades associados ao
objeto Number. Este objeto idntico ao objeto Number do JavaScript. No Flash MX, o objeto
Number tornou-se um objeto nativo. Assim, voc poder observar uma melhora radical no
desempenho.
necessrio usar um construtor durante a chamada aos mtodos do objeto Number, mas no
preciso utiliz-lo durante a chamada s propriedades deste objeto. Os exemplos a seguir
especificam a sintaxe para chamar os mtodos e propriedades do objeto Number.
O exemplo a seguir chama o mtodo toString do objeto Number, que retorna a seqncia de
caracteres 1234.
myNumber = new Number(1234);
myNumber.toString();

Este exemplo chama a propriedade MIN_VALUE (tambm chamada constante) do objeto Number:
smallest = Number.MIN_VALUE

Dicionrio ActionScript 354

Resumo de mtodos do objeto Number

Mtodo

Descrio

Number.toString

Retorna a representao da seqncia de caracteres do objeto Number.

Number.valueOf

Retorna o valor primitivo do objeto Number.

Resumo de propriedades do objeto Number

Propriedade

Descrio

Number.MAX_VALUE

Constante que representa o maior nmero representvel (IEEE 754 de dupla

preciso). Esse nmero aproximadamente 1,7976931348623158e+308.

Number.MIN_VALUE

Constante que representa o menor nmero representvel (IEEE 754 de dupla

preciso). Esse nmero aproximadamente 5e-324.

Number.NaN

Constante que representa o valor No Nmero (NaN).

Number.NEGATIVE_INFINITY

Constante que representa o valor do infinito negativo.

Number.POSITIVE_INFINITY

Constante que representa o valor do infinito positivo. Este valor o mesmo da

varivel global Infinity.

Construtor do objeto Number

Disponibilidade

Flash Player 5.
Uso

myNumber = new Number(valor)

Parmetros

O valor numrico do objeto Number que est sendo criado ou um valor a ser convertido
em um nmero.

valor

Retorna

Nada.
Descrio

Construtor; cria um novo objeto Number. Voc deve usar o construtor Number quando estiver
utilizando os mtodos toString e valueOf do objeto Number. No use um construtor quando
estiver usando as propriedades do objeto Number. O construtor new Number usado,
basicamente, como um espao reservado. Uma instncia do objeto Number no a mesma que a
funo Number que converte um parmetro em um valor primitivo.
Exemplo

O cdigo a seguir cria objetos new Number.

n1 = new Number(3.4);
n2 = new Number(-10);
Consulte tambm

Number (funo)

355

Number.MAX_VALUE
Disponibilidade

Flash Player 5.
Uso

Number.MAX_VALUE
Descrio

Propriedade; o maior nmero representvel (IEEE 754 de dupla preciso). Esse nmero
aproximadamente 1,79E+308.

Number.MIN_VALUE
Disponibilidade

Flash Player 5.
Uso

Number.MIN_VALUE
Descrio

Propriedade; o menor nmero representvel (IEEE 754 de dupla preciso). Esse nmero
aproximadamente 5e-324.

Number.NaN
Disponibilidade

Flash Player 5.
Uso

Number.NaN
Descrio

Propriedade; o valor IEEE-754 que representa No Nmero (NaN).

Number.NEGATIVE_INFINITY
Disponibilidade

Flash Player 5.
Uso

Number.NEGATIVE_INFINITY
Descrio

Propriedade; retorna o valor IEEE 754 que representa o infinito negativo.

O infinito negativo um valor numrico especial que retornado quando uma operao ou
funo matemtica retorna um valor negativo maior do que pode ser representado.

Dicionrio ActionScript 356

Number.POSITIVE_INFINITY
Disponibilidade

Flash Player 5.
Uso

Number.POSITIVE_INFINITY
Descrio

Propriedade; retorna o valor IEEE 754 que representa o infinito positivo. Este valor o mesmo
que a varivel global Infinity.
O infinito positivo um valor numrico especial retornado quando uma operao ou funo
matemtica retorna um valor maior do que pode ser representado.

Number.toString
Disponibilidade

Flash Player 5.
Uso

myNumber.toString(raiz)
Parmetros

Especifica a base numrica (de 2 a 36) a ser usada para a converso de nmero em
seqncia de caracteres. Se voc no especificar o parmetro raiz, o valor padro ser 10.

raiz

Retorna

Nada.
Descrio

Mtodo; retorna a representao da seqncia de caracteres do objeto Number especificado

(myNumber).
Exemplo

O exemplo a seguir usa o mtodo Number.toString, especificando 2 para o parmetro radix e

retorna uma seqncia de caracteres que contm a representao binria do nmero1000.
myNumber = new Number (1000);
myNumber.toString(2);

Number.valueOf
Disponibilidade

Flash Player 5.
Uso

myNumber.valueOf()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo;retorna o tipo de valor primitivo do objeto Number especificado.

357

Object (objeto)
O objeto Object genrico est na raiz da hierarquia de classes do ActionScript. O objeto Object
genrico do ActionScript contm um pequeno subconjunto de recursos fornecido pelo objeto
Object do JavaScript. No Flash MX, o objeto Object tornou-se um objeto nativo. Assim, voc
poder observar uma melhora radical no desempenho.
O objeto Object genrico suportado no Flash Player 5.
Resumo de mtodos do objeto Object
Mtodo

Descrio

Object.addProperty

Cria uma propriedade de apanhador/definidor em um objeto.

Object.registerClass

Atribui uma classe do ActionScript a uma instncia de clipe de filme.

Object.toString

Converte o objeto especificado em uma seqncia de caracteres e o retorna.

Object.unwatch

Remove o registro criado por um mtodo Object.watch.

Object.valueOf

Retorna o valor primitivo do objeto Object

Object.watch

Registra uma funo de chamada a ser ativada quando uma determinada

propriedade de um objeto do ActionScript alterada.

Resumo de propriedades do objeto Object

Propriedade

Descrio

Object.__proto__

Uma referncia propriedade prototype da funo construtora do objeto.

Construtor do objeto Object

Disponibilidade

Flash Player 5.
Uso

new Object(valor)
Parmetros

Um nmero, valor booleano ou seqncia de caracteres a ser convertido em um objeto.

Este parmetro opcional. Se voc no especificar valor, o construtor cria um novo objeto com
propriedades no definidas.
valor

Descrio

Construtor; cria um novo objeto Object.

Dicionrio ActionScript 358

Object.addProperty
Disponibilidade

Flash Player 6.
Uso

myObject.addProperty( prop, getFunc, setFunc )

Parmetros

prop

O nome da propriedade de objeto a ser criada.

getFunc

A funo chamada para recuperar o valor da propriedade; este parmetro um objeto

de funo.
setFunc A funo chamada para definir o valor da propriedade; este parmetro um objeto de
funo. Se voc passar o valor null para este parmetro, a propriedade ser do tipo somente leitura.
Retorna

Retorna um valor de true se a propriedade for criada com xito; caso contrrio, retorna false.
Descrio

Mtodo; cria uma propriedade de apanhador/definidor. Quando o Flash l uma propriedade de

apanhador/definidor, chama a funo get e o valor de retorno da funo torna-se um valor de
prop. Quando o Flash grava uma propriedade de apanhador/definidor, chama a funo set e passa
a ela o novo valor como um parmetro. Se j houver uma propriedade com o mesmo nome, a
nova propriedade a substituir.
Uma funo get no possui nenhum parmetro. Seu valor de retorno pode ser de qualquer tipo.
Seu tipo pode ser alterado entre as chamadas. O valor de retorno tratado como o valor atual da
propriedade.
Uma funo set utiliza um parmetro, que o novo valor da propriedade. Por exemplo, se a
propriedade x for atribuda pelo comando x = 1, a funo set receber o parmetro 1 do tipo
number. O valor de retorno da funo setter ignorado.
possvel adicionar propriedades de apanhador/definidor aos objetos de prottipo. Se voc
adicionar uma propriedade de apanhador/definidor a um objeto de prottipo, todas as instncias
de objeto que herdam o objeto de prottipo tambm herdam esta propriedade. Isso torna possvel
adicionar uma propriedade de apanhador/definidor em um local, o objeto de prottipo, e fazer
com que ela seja propagada para todas as instncias de uma classe (muito semelhante adio de
mtodos a objetos de prottipo). Se uma funo get/set for chamada para uma propriedade de
apanhador/definidor em um objeto de prottipo herdado, a referncia passada funo get/set
ser o objeto referenciado originalmente, e no o objeto de prottipo.
Se chamado incorretamente, Object.addProperty poder apresentar um erro. A tabela a seguir
descreve os erros que podem ocorrer:

359

Condio de erro

O que acontece

prop no um nome de propriedade vlido; por exemplo, uma

seqncia de caracteres vazia.

Retorna false e a propriedade no

adicionada.

getFunc no um objeto de funo vlido.

Retorna false e a propriedade no

adicionada.

setFunc no um objeto de funo vlido.

Retorna false e a propriedade no

adicionada.

Exemplo

Uso 1: As propriedades internas TextField.scroll e TextField.maxscroll so do tipo

apanhador/definidor. O objeto TextField possui os mtodos internos getScroll, setScroll e
getMaxScroll. O construtor TextField cria as propriedades de apanhador/definidor e as aponta
para os mtodos get/set internos, como mostrado a seguir:
this.addProperty("scroll", this.getScroll, this.setScroll);
this.addProperty("maxscroll", this.getMaxScroll, null);

Quando um script recupera o valor de myTextField.scroll, o interpretador do ActionScript

chama myTextField.getScroll automaticamente. Quando um script modifica o valor de
myTextField.scroll, o interpretador chama myTextField.setScroll. A propriedade
maxscroll no especifica uma funo set, portanto, as tentativas feitas para modificar maxscroll
so ignoradas.
Uso 2: O exemplo anterior de TextField.scroll e TextField.maxscroll funciona, mas as
propriedades scroll e maxscroll so adicionadas a todas as instncias do objeto TextField. Isso
significa que o custo para estabelecer as propriedades de dois slots de propriedades para cada
instncia do objeto. Se houver muitas propriedades como scroll e maxscroll em uma classe,
possvel que elas consumam uma grande quantidade de memria. Nesse caso, voc pode adicionar
as propriedades scroll e maxscroll a TextField.prototype:
TextField.prototype.addProperty("scroll", this.getScroll, this.setScroll);
TextField.prototype.addProperty("maxscroll", this.getMaxScroll, null);

Agora, as propriedades scroll e maxscroll existem apenas em um local: o objeto

TextField.prototype. Entretanto, o efeito o mesmo do cdigo anterior que adicionou
scroll e maxscroll diretamente a todas as instncias. Se scroll ou maxscroll for acessada em
uma instncia de TextField, a cadeia de prottipos ser percorrida para cima e a propriedade de
apanhador/definidor de TextField.prototype ser encontrada.

Object.__proto__
Disponibilidade

Flash Player 5.
Uso

myObject.__proto__
Parmetros

Nenhum.
Descrio

Propriedade; refere-se propriedade prototype da funo construtora que criou myObject. A

propriedade __proto__ atribuda automaticamente a todos os objetos durante sua criao. O
interpretador do ActionScript usa a propriedade __proto__ para acessar a propriedade
prototype da funo construtora do objeto e assim descobrir quais propriedades e mtodos o
objeto herda de sua classe.

Dicionrio ActionScript 360

Object.registerClass
Disponibilidade

Flash Player 6
Uso

Object.registerClass(symbolID, theClass)
Parmetros

O identificador de vinculao do smbolo de clipe de filme ou o identificador de

seqncia de caracteres da classe do ActionScript.

symbolID

theClass Uma referncia funo construtora da classe do ActionScript ou null para cancelar
o registro do smbolo.
Retorna

Se o registro da classe for bem-sucedido, ser retornado um valor de true; caso contrrio, false
ser retornado.
Descrio

Mtodo; associa um smbolo de clipe de filme a uma classe de objeto do ActionScript. Se no

houver um smbolo, o Flash criar uma associao entre um identificador de seqncia de
caracteres e uma classe de objeto.
Quando uma instncia do smbolo de clipe de filme especificado for colocada pela Linha de
tempo, ela ser registrada na classe indicada pelo parmetro theClass e no na classe MovieClip.
Quando uma instncia do smbolo de clipe de filme especificado for criada com o mtodo
attachMovie ou duplicateMovieClip, ela ser registrada na classe indicada pelo parmetro
theClass e no na classe MovieClip.
Se theClass for null, Object.registerClass remover qualquer definio de classe de
ActionScript associada ao smbolo de clipe de filme ou identificador de classe especificado. No
caso de smbolos de clipe de filme, qualquer instncia existente do clipe de filme permanecer
inalterada, mas as novas instncias do smbolo sero associadas classe MovieClip padro.
Se um smbolo j estiver registrado em uma classe, o mtodo Object.registerClass o
susbtituir pelo novo registro.
Quando uma instncia de clipe de filme colocada pela Linha de tempo ou criada com
ou duplicateMovieClip, ActionScript chama o construtor da classe apropriada
com a palavra-chave this apontando para o objeto. A funo construtora chamada sem
nenhum parmetro.
attachMovie

Se o mtodo Object.registerClass for usado para registrar um clipe de filme com uma classe
ActionScript diferente de MovieClip, o smbolo do clipe de filme no herdar os mtodos,
propriedades e eventos da classe MovieClip incorporada, a menos que a classe MovieClip seja
includa na cadeia prottipo da nova classe. O cdigo a seguir cria uma nova classe ActionScript
denominada theClass que herda as propriedades da classe MovieClip:
theClass.prototype = new MovieClip();

361

Exemplo

Este exemplo cria um componente para um dispositivo de IU de caixa de seleo padro.

Primeiro crie um smbolo de clipe de filme chamado Caixa de seleo na bilbioteca. Em seguida,
crie uma classe CheckBox no ActionScript que representar a caixa de seleo.
// Define o construtor para (e assim define)
Classe CheckBox
function CheckBox() {
...
}
// Define que a cadeia de prottipos CheckBox
herdar de MovieClip
CheckBox.prototype = new MovieClip();
// Define os mtodos da classe 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 () {

Agora necessrio associar a classe CheckBox ao smbolo de clipe de filme de Caixa de seleo.
Primeiro, voc precisa da capacidade de identificar o smbolo de clipe de filme de Caixa de seleo
com o ActionScript. Para fazer isso, insira um identificador na caixa de dilogo Vinculao da
biblioteca e selecione Exportar para ActionScript.
Em seguida, faa com que o ActionScript associe a classe CheckBox ao smbolo CheckBox:
Object.registerClass("CheckBox" /*symbolID*/, CheckBox /*theClass*/ );

Uso 1 (colocao de Linha de tempo): Agora possvel colocar instncias de CheckBox no palco
na ferramenta de criao, sendo que em tempo de execuo, as instncias recebero
automaticamente a classe do ActionScript CheckBox. Se voc inserir duas instncias,
myCheckBox1 e myCheckBox2, poder control-las chamando mtodos, como mostrado a seguir:
myCheckBox1.setValue(true);
myCheckBox2.setValue(false);
myCheckBox2.setLabel("new label for #2");

Dicionrio ActionScript 362

Uso 2 (Instncias dinmicas): Voc pode usar o mtodo attachMovie para criar uma nova
instncia da caixa de seleo no Palco, medida que o filme reproduzido. Como o smbolo
CheckBox registrado na classe do ActionScript CheckBox, a nova instncia dinmica receber
essa classe automaticamente.
// createCheckBox uma funo assistente que
// cria CheckBoxes dinamicamente
function createCheckBox(nome, profundidade) {
attachMovie("CheckBox", nome, profundidade);
}
createCheckBox("myCheckBox3", 100);
myCheckBox3.setValue(false);
myCheckBox3.setLabel("novo rtulo para #3");
Consulte tambm

MovieClip.attachMovie, MovieClip.duplicateMovieClip

Object.toString
Disponibilidade

Flash Player 5.
Uso

myObject.toString()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; converte o objeto especificado em uma seqncia de caracteres e o retorna.

Object.unwatch
Disponibilidade

Flash Player 6.
Uso

myObject.unwatch (prop)
Parmetros

O nome da propriedade de objeto que no dever mais ser observada, como uma
seqncia de caracteres.

prop

Retorna

Um valor booleano.
Descrio

Mtodo; remove um ponto de controle criado pelo mtodo Object.watch. Este mtodo
retornar um valor de true se o ponto de controle tiver sido removido com xito; caso contrrio,
retornar false.

363

Object.valueOf
Disponibilidade

Flash Player 5.
Uso

myObject.valueOf()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; retorna o valor primitivo do objeto especificado. Se o objeto no tiver um valor

primitivo, o objeto retornado.

Object.watch
Disponibilidade

Flash Player 6.
Uso

myObject.watch( prop, callback [, userData] )

Parmetros

prop

Uma seqncia de caracteres que indica o nome da propriedade do objeto a ser observada.

A funo a ser chamada quando a propriedade observada alterada. Este parmetro

um objeto de funo e no um nome de funo como uma seqncia de caracteres. O formato de
callback callback(prop, oldval, newval, userData).
callback

Uma parte arbitrria dos dados de ActionScript passada ao mtodo callback. Se o

parmetro userData for omitido, undefined ser passado ao mtodo de retorno de chamada.
Este parmetro opcional.
userData

Retorna

Um valor de true se o ponto de controle tiver sido criado com xito, caso contrrio, retorna um
valor false.
Descrio

Mtodo; registra uma funo de retorno de chamada a ser ativada quando uma determinada
propriedade de um objeto do ActionScript alterada. Quando a propriedade alterada, a funo
de retorno de chamada ativada com myObject como o objeto recipiente.
Um ponto de controle pode filtrar (ou anular) a atribuio de valor retornando um newval
modificado (ou oldval). Se voc excluir uma propriedade para a qual tenha sido definido um
ponto de controle, este ponto no desaparecer. Se, posteriormente, voc recriar a propriedade, o
ponto de controle ainda estar valendo. Para remover o ponto de controle, use o mtodo
Object.unwatch.
Apenas um nico ponto de controle pode ser registrado em uma propriedade. As chamadas
subseqentes a Object.watch na mesma propriedade substituem o ponto de controle original.

Dicionrio ActionScript 364

O mtodo Object.watch apresenta um comportamento semelhante funo Object.watch no

Netscape JavaScript 1.2 ou posterior. A diferena principal o parmetro userData, que uma
adio do Flash a Object.watch no suportada pelo Netscape Navigator. Voc pode passar o
parmetro userData funo de retorno de chamada e us-lo nesta funo.
O mtodo Object.watch no pode observar propriedades de apanhador/definidor. As
propriedades de apanhador/definidor funcionam atravs de avaliao preguiosa o valor da
propriedade no determinado at que ela seja realmente consultada. Com freqncia, a
avaliao preguiosa eficiente porque a propriedade no atualizada constantemente;assim, ela
avaliada quando necessrio. Entretanto, Object.watch precisa avaliar uma propriedade para
acionar pontos de controle nela. Para funcionar com uma propriedade de apanhador/definidor,
Object.watch precisa avali-la constantemente, o que um processo ineficaz.
Geralmente, as propriedades predefinidas de ActionScript, como _x, _y, _width e _height, so
propriedades de apanhador/definidor e, portanto, no podem ser observadas com Object.watch.
Exemplo

Este exemplo mostra um componente CheckBox com mtodos que definem o rtulo ou valor de
cada instncia de caixa de seleo:
myCheckBox1.setValue(true);
myCheckBox1.setLabel("novo rtulo");
...

adequado considerar o valor e o rtulo de uma caixa de seleo como propriedades. possvel
utilizar Object.watch para fazer com que o acesso ao valor e ao rtulo parea com o acesso
propriedade em vez de chamada a mtodo, como mostrado a seguir:
// Definir o construtor para (e, portanto, definir) a classe CheckBox
function CheckBox() {
...
this.watch ('value', function (id, oldval, newval)) {
...
}
this.watch ('label', function (id, oldval, newval)) {
...
}
}

Quando a propriedade do valor ou rtulo modificada, a funo especificada pelo componente

chamada para realizar as tarefas necessrias para atualizao da aparncia e do estado do
componente, de forma a refletir seus novos parmetros. Portanto, o comando de atribuio a
seguir usa um manipulador Object.watch para notificar o componente de que a varivel foi
alterada e fazer com que ele atualize sua representao grfica
myCheckBox1.value = false;

Esta sintaxe mais concisa do que a anterior:

myCheckBox1.setValue(false);
Consulte tambm

Object.addProperty, Object.unwatch

365

onClipEvent
Disponibilidade

Flash Player 5.
Uso

onClipEvent(movieEvent){
comando(s);
}
Parmetros

movieEvent um dispositivo de ativao chamado evento. Quando o evento ocorre, so

executados os comandos posteriores a ele entre chaves. Qualquer um dos valores a seguir pode ser
especificado pelo parmetro movieEvent.

load

A ao iniciada assim que o clipe de filme criado e aparece na Linha de tempo.

unload A ao iniciada no primeiro quadro depois do clipe de filme ser removido da Linha
de tempo. As aes associadas ao evento do clipe de filme Unload so processadas antes que as
aes sejam anexadas ao quadro atingido.

enterFrame A ao disparada continuamente taxa de quadros do filme. As aes

associadas ao evento do clipe enterFrame so processadas depois das aes que tenham sido
anexadas aos quadros afetados.

mouseMove A ao iniciada toda vez que o mouse movido. Use as propriedades _xmouse e
_ymouse para determinar a posio do mouse atual.

mouseDown

keyUp

data A ao iniciada quando os dados so recebidos em uma ao loadVariables ou

loadMovie. Quando especificado com uma ao loadVariables, o evento data ocorre

mouseUp

A ao iniciada quando o boto esquerdo do mouse pressionado.

A ao iniciada quando o boto esquerdo do mouse liberado.

A ao iniciada quando uma tecla pressionada. Use o mtodo Key.getCode para

recuperar informaes sobre a ltima tecla pressionada.

keyDown

A ao iniciada quando uma tecla liberada. Use o mtodo Key.getCode para

recuperar informaes sobre a ltima tecla pressionada.

somente uma vez, quando a ltima varivel carregada. Quando especificado com uma ao
o evento data ocorre repetidamente, medida que cada seo de dados
recuperada.
loadMovie,

comando(s)

Os comandos a serem executados quando o evento mouseEvent ocorre.

Descrio

Manipulador de eventos; dispara aes definidas por uma instncia especfica de um clipe de
filme.
Exemplo

O comando a seguir inclui o script de um arquivo externo quando o filme exportado; as aes
no script includo so executadas quando o clipe de filme ao qual elas esto anexadas carregado:
onClipEvent(load) {
#include "myScript.as"
}

Dicionrio ActionScript 366

O exemplo a seguir usa onClipEvent com o evento de filme keyDown. Normalmente, o evento de
filme keyDown usado juntamente com um ou mais mtodos e propriedades do objeto Key. O
script a seguir usa o mtodo Key.getCode para descobrir qual tecla foi pressionada pelo usurio;
se a tecla pressionada corresponder propriedade Key.RIGHT, o filme ser enviado ao quadro
seguinte, se corresponder propriedade Key.LEFT, o filme ser enviado ao quadro anterior.
onClipEvent(load) {
if (Key.getCode() == Key.RIGHT) {
_parent.nextFrame();
} else if (Key.getCode() == Key.LEFT){
_parent.prevFrame();
}
}

O exemplo a seguir usa onClipEvent com o evento de filme mouseMove. As propriedades

_xmouse e _ymouse controlam a posio do mouse sempre que ele movido.
onClipEvent(mouseMove) {
stageX=_root.xmouse;
stageY=_root.ymouse;
}
Consulte tambm

Key (objeto), MovieClip._xmouse, MovieClip._ymouse, on

on
Disponibilidade

Flash 2. Nem todos os eventos so suportados no Flash 2.

Uso

on(mouseEvent) {
comando(s);
}
Parmetros

Os comandos a serem executados quando o evento mouseEvent ocorre.

Um mouseEvent um dispositivo de ativao chamado evento. Quando o evento ocorre, os
comandos posteriores a ele entre chaves so executados. Qualquer um dos valores a seguir pode ser
especificado pelo parmetro movieEvent:
press O boto do mouse pressionado enquanto o ponteiro est sobre o boto.
release O boto do mouse liberado enquanto o ponteiro est sobre o boto.
releaseOutside O boto do mouse liberado enquanto o ponteiro est fora do boto,
depois que o boto foi pressionado enquanto o ponteiro estava dentro do boto.
rollOut O ponteiro rola fora da rea do boto.
rollOver O ponteiro do mouse rola sobre o boto.
dragOut Enquanto o ponteiro est sobre o boto, o boto do mouse pressionado e rolado
para fora da rea do boto.
dragOver Com o ponteiro sobre o boto, o boto do mouse pressionado, rolado para fora
do boto e, a seguir, rolado de volta sobre o boto.
keyPress (tecla) A tecla especificada pressionada. A parte tecla do parmetro
especificada por qualquer cdigo de tecla listado no Apndice C, "Teclas do teclado e valores de
cdigos de teclas" de Usando o Flash ou qualquer uma das constantes listadas em Resumo das
propriedades do objeto Key.
comando(s)

367

Descrio

Manipulador de eventos; especifica o evento do mouse ou o pressionamento de tecla que dispara

uma ao.
Exemplo

No script a seguir, a ao startDrag executada quando o mouse pressionado e o script

condicional executado quando o mouse liberado e o objeto ignorado.
on(press) {
startDrag("rabbit");
}
on(release) {
trace(_root.rabbit._y);
trace(_root.rabbit._x);
stopDrag();
}
Consulte tambm

onClipEvent

or
Disponibilidade

Flash 4. Este operador foi reprovado e substitudo pelo operador || (OR lgico).
Uso

condition1 ou condition2
Parmetros

condition1,2

Uma expresso que pode receber o valor true ou false.

Retorna

Nada.
Descrio

Operador; avalia condition1 e condition2 e se alguma das expresses for true, toda a expresso
ser true.
Consulte tambm

|| (OR lgico), | (OR bit a bit)

ord
Disponibilidade

Flash Player 4. Esta funo foi reprovada e substituda pelos mtodos e propriedades de String
(objeto).
Uso

ord(caractere)
Parmetros

caractere

O caractere a ser convertido em um nmero de cdigo ASCII.

Retorna

Nada.

Dicionrio ActionScript 368

Descrio

Funo de seqncia de caracteres; converte caracteres em nmeros de cdigo ASCII.

Consulte tambm

String (objeto)

_parent
Disponibilidade

Flash Player 4.
Uso

_parent.property
_parent._parent.property
Descrio

Propriedade; especifica ou retorna uma referncia ao clipe de filme ou objeto que contm o clipe
de filme ou objeto atual. O objeto atual o que contm o cdigo ActionScript que faz referncia a
_parent. Use _parent para especificar um caminho relativo para clipes de filme ou objetos que
estiverem acima do clipe de filme ou objeto atual.
Exemplo

No exemplo a seguir, o clipe de filme desk um filho do clipe de filme classroom. Quando o
script abaixo executado dentro do clipe de filme desk, a reproduo salta para o Quadro 10 na
Linha de tempo do clipe de filme classroom.
_parent.gotoAndStop(10);
Consulte tambm

_root, targetPath

parseFloat
Disponibilidade

Flash Player 5.
Uso

parseFloat(seqncia de caracteres)
Parmetros

seqncia de caracteres

A seqncia de caracteres a ser lida e convertida em um nmero de

ponto flutuante.
Retorna

Nada.
Descrio

Funo; converte uma seqncia de caracteres em um nmero de ponto flutuante. A funo l ou

"analisa" e retorna os nmeros em uma seqncia de caracteres at alcanar um caractere que no
seja parte do nmero inicial. Se a seqncia de caracteres no comear com um nmero que possa
ser analisado, parseFloat retornar NaN. O espao em branco que precede os inteiros vlidos
ignorado, pois so caracteres precedentes no numricos.

369

Exemplo

O exemplo a seguir usa a funo parseFloat para avaliar vrios tipos de nmeros.
parseFloat("-2")

reorna -2

parseFloat("2.5")

retorna 2.5

parseFloat("3.5e6")

retorna 3.5e6, or 3500000

parseFloat("foobar")
parseFloat(" 5.1")

retorna NaN

retorna 5.1

parseFloat("3.75math")

retorna 3.75

parseFloat("0garbage")

retorna 0

parseInt
Disponibilidade

Flash Player 5.
Uso

parseInt(expresso, [raiz])
Parmetros

expresso

Uma seqncia de caracteres a ser convertida em um inteiro.

Um inteiro que representa a raiz (base) do nmero a ser analisado. Os valores permitidos
vo de 2 a 36. Este parmetro opcional.

raiz

Retorna

Nada.
Descrio

Funo; converte uma seqncia de caracteres em um inteiro. Se no for possvel converter a

seqncia de caracteres especificada nos parmetros em um nmero, a funo retornar NaN. Os
inteiros que comeam com 0 ou que especificam uma raiz de 8 so interpretados como nmeros
octais. As seqncias de caracteres que comeam com 0x so interpretadas como nmeros
hexadecimais. O espao em branco que precede os inteiros vlidos ignorado, pois so caracteres
precedentes no numricos.
Exemplo

Os exemplos a seguir usam a funo parseInt para avaliar vrios tipos de nmeros.
parseInt("3.5")
// retorna 3.5
parseInt("barra")
// retorna NaN
parseInt("4foo")
// retorna 4

Dicionrio ActionScript 370

A seguir so mostrados exemplos de converses hexadecimais:

parseInt("0x3F8")
// retorna 1016
parseInt("3E8", 16)
// retorna 1000

A seguir so mostrados exemplos de uma converso binria:

parseInt("1010", 2)
// retorna 10 (a representao decimal do binrio 1010)

A seguir mostrado um exemplo de anlise de nmero octal (neste caso, o nmero octal
identificado pela raiz, 8):
parseInt("777", 8)
// retorna 511 (a representao decimal do octal 777)

play
Disponibilidade

Flash 2.
Uso

play()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Ao; move a reproduo para frente na Linha de tempo.

Exemplo

O cdigo a seguir usa um comando if para verificar o valor de um nome que o usurio insere. Se
o usurio inserir Steve, a ao play chamada e a reproduo move para frente na Linha de
tempo. Se o usurio inserir qualquer coisa diferente de Steve, o filme no reproduzido e um
campo de texto com o nome de varivel alert exibido.
stop();
if (name == "Steve") {
play();
else {
alert="Voc no Steve!";
}

371

prevFrame
Disponibilidade

Flash 2.
Uso

prevFrame()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Ao; envia a reproduo para o quadro anterior e o encerra. Se o quadro atual for 1, a reproduo
no ser movida.
Exemplo

Quando o usurio clica em um boto que tem o manipulador a seguir anexado, a reproduo
enviada ao quadro anterior.
on(release) {
prevFrame();
}
Consulte tambm

MovieClip.prevFrame

prevScene
Disponibilidade

Flash 2.
Uso

prevScene()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Ao; envia a reproduo para o Quadro 1 da cena anterior e faz uma ininterrupo.
Consulte tambm

nextScene

Dicionrio ActionScript 372

print
Disponibilidade

Flash Player 4.20.

Uso

print (nvel)
print (nvel, "Caixa delimitadora")
print ("destino")
print ("destino", "Caixa delimitadora")
printAsBitmap (nvel)
printAsBitmap (nvel, "Caixa delimitadora")
printAsBitmap ("destino")
printAsBitmap ("destino", "Caixa delimitadora")
Parmetros

No modo normal do painel Aes, escolhe Como vetores para imprimir quadros que
no contenham imagens de bitmap nem usem transparncia (alfa) ou efeitos de cores; escolha
Como bitmap para imprimir quadros que contenham imagens de bitmap, transparncia ou efeitos
de cores. Se voc escolher o parmetro de impresso Como bitmap, a sintaxe AsBitmap ser
anexada ao print no painel Aes.
print

O nvel a ser impresso no Flash Player. Se voc escolher um nvel no modo normal do
painel Aes, a ao print alternar para printNum ou printAsBitmapNum; no modo
especialista, necessrio especificar printNum ou printAsBitmapNum. Por padro, todos os
quadros do nvel so impressos. Se voc quiser imprimir quadros especficos do nvel, atribua um
rtulo de quadro #p aos quadros desejados.
nvel

destino O nome da instncia do clipe de filme a ser impresso. Por padro, todos os quadros na
instncia de destino so impressos. Se voc quiser imprimir quadros especficos do clipe de filme,
atribua um rtulo de quadro #p a esses quadros.
Caixa delimitadora Um modificador que define a rea de impresso do filme. Este
parmetro opcional. Voc pode escolher um dos itens a seguir:

bmovie Indica a caixa delimitadora de um quadro especfico em um filme como a rea de

impresso de todos os quadros imprimveis no filme. Atribua um rtulo de quadro #b ao
quadro cuja caixa delimitadora voc deseja usar como a rea de impresso.

Indica uma composio de todas as caixas delimitadoras, de todos os quadros

imprimveis, como a rea de impresso. Especifique o parmetro bmax quando os quadros
imprimveis em seu filme variarem em tamanho.

Indica uma caixa delimitadora de cada quadro imprimvel a ser usada como rea de
impresso para o quadro. Isso altera a rea de impresso de cada quadro e dimensiona os
objetos para caberem na rea de impresso. Use bframe se voc tiver objetos de tamanhos
diferentes em cada quadro e desejar que cada objeto ocupe toda a pgina impressa.

bmax

bframe

Retorna

Nenhum.

373

Descrio

Ao; imprime o clipe de filme de destino de acordo com os limites especificados no parmetro
(bmovie, bmax ou bframe). Para imprimir quadros especficos do filme de destino, necessrio
anexar um rtulo de quadro #P a esses quadros. Embora a ao print resulte em impresses de
mais qualidade do que a ao printAsBitmap, no possvel us-la para imprimir filmes que
utilizem transparncias alfa ou efeitos especiais de cores.
Se voc no especificar um parmetro de rea de impresso, ela ser determinada pelo tamanho do
Palco do filme carregado, por padro. O filme no herda o tamanho do Palco do filme principal.
Voc pode controlar a rea de impresso especificando os parmetros bmovie, bmax ou bframe.
Todos os elementos imprimveis em um filme devem ser totalmente carregados antes que a
impresso possa comear.
O recurso de impresso do Flash Player suporta as impressoras PostScript e no PostScript. As
impressoras no PostScript convertem vetores em bitmaps.
Exemplo

O exemplo a seguir imprimir todos os quadros imprimveis em myMovie com a rea de

impresso definida pela caixa delimitadora do quadro com o rtulo do quadro #b anexado:
print("myMovie","bmovie");

O exemplo a seguir imprimir todos os quadros imprimveis em myMovie com uma rea de
impresso definida pela caixa delimitadora de cada quadro:
print("myMovie","bframe");
Consulte tambm

printNum, printAsBitmap, printAsBitmapNum

printAsBitmap
Disponibilidade

Flash Player 4.20.

Uso

printAsBitmap(destino, "Caixa delimitadora")

Parmetros

destino O nome da instncia do clipe de filme a ser impresso. Por padro, todos os quadros do
filme so impressos. Para imprimir quadros especficos do filme, necessrio anexar um rtulo de
quadro #P a esses quadros.
Caixa delimitadora Um modificador que define a rea de impresso do filme. Voc pode
escolher um dos seguintes parmetros:

bmovie Indica a caixa delimitadora de um quadro especfico em um filme como a rea de

impresso de todos os quadros imprimveis no filme. Atribua um rtulo de quadro #b ao
quadro cuja caixa delimitadora voc deseja usar como a rea de impresso.

Indica uma composio de todas as caixas delimitadoras, de todos os quadros

imprimveis, como a rea de impresso. Especifique o parmetro bmax quando os quadros
imprimveis em seu filme variarem em tamanho.

Indica uma caixa delimitadora de cada quadro imprimvel a ser usada como rea de
impresso para o quadro. Isso altera a rea de impresso de cada quadro e dimensiona os
objetos para caberem na rea de impresso. Use bframe se voc tiver objetos de tamanhos
diferentes em cada quadro e desejar que cada objeto ocupe toda a pgina impressa.

bmax

bframe

Dicionrio ActionScript 374

Retorna

Nenhum.
Descrio

Ao; imprime o clipe de filme de destino como um bitmap. Use a ao printAsBitmap para
imprimir filmes que contenham quadros com objetos que usem transparncia ou efeitos de cor. A
ao printAsBitmap imprime na resoluo mais alta disponvel da impressora para manter a
maior definio e qualidade possvel.
Se o seu filme no contiver transparncias alfa ou efeitos de cor, use a ao print para obter
resultados de melhor qualidade.
Por padro, a rea de impresso determinada pelo tamanho do Palco do filme carregado. O filme
no herda o tamanho do Palco do filme principal. Voc pode controlar a rea de impresso
especificando os parmetros bmovie, bmax ou bframe.
Todos os elementos imprimveis em um filme devem ser totalmente carregados antes que a
impresso possa comear.
O recurso de impresso do Flash Player suporta as impressoras PostScript e no PostScript. As
impressoras no PostScript convertem vetores em bitmaps.
Consulte tambm

print, printAsBitmapNum, printNum

printAsBitmapNum
Disponibilidade

Flash Player 5.
Uso

printAsBitmapNum(nvel)
printAsBitmapNum(nvel, "Caixa delimitadora")
Parmetros

O nvel a ser impresso no Flash Player. Por padro, todos os quadros do nvel so
impressos. Se voc quiser imprimir quadros especficos do nvel, atribua um rtulo de quadro #p
aos quadros desejados.

nvel

Caixa delimitadora Um modificador que define a rea de impresso do filme. Este

parmetro opcional. Voc pode escolher um dos seguintes parmetros:

375

bmovie Indica a caixa delimitadora de um quadro especfico em um filme como a rea de

impresso de todos os quadros imprimveis no filme. Atribua um rtulo de quadro #b ao
quadro cuja caixa delimitadora voc deseja usar como a rea de impresso.

Indica uma composio de todas as caixas delimitadoras, de todos os quadros

imprimveis, como a rea de impresso. Especifique o parmetro bmax quando os quadros
imprimveis em seu filme variarem em tamanho.

Indica uma caixa delimitadora de cada quadro imprimvel a ser usada como rea de
impresso para o quadro. Isso altera a rea de impresso de cada quadro e dimensiona os
objetos para caberem na rea de impresso. Use bframe se voc tiver objetos de tamanhos
diferentes em cada quadro e desejar que cada objeto ocupe toda a pgina impressa.

bmax

bframe

Retorna

Nenhum.
Descrio

Ao; imprime um nvel no Flash Player como um bitmap. Use a ao printAsBitmapNum para
imprimir filmes que contenham quadros com objetos que usem transparncia ou efeitos de cor. A
ao printAsBitmapNum imprime na resoluo mais alta disponvel da impressora para manter a
melhor definio e qualidade possvel. Para calcular o tamanho do arquivo imprimvel de um
quadro indicado para ser impresso como um bitmap, multiplique a largura do pixel pela altura do
pixel pela resoluo da impressora.
Se o seu filme no contiver transparncias alfa ou efeitos de cor, use a ao printNum para obter
resultados de melhor qualidade.
Por padro, a rea de impresso determinada pelo tamanho do Palco do filme carregado. O filme
no herda o tamanho do Palco do filme principal. Voc pode controlar a rea de impresso
especificando os parmetros bmovie, bmax ou bframe.
Todos os elementos imprimveis em um filme devem ser totalmente carregados antes que a
impresso possa comear.
O recurso de impresso do Flash Player suporta as impressoras PostScript e no PostScript. As
impressoras no PostScript convertem vetores em bitmaps.
Consulte tambm

print, printAsBitmap, printNum

printNum
Disponibilidade

Flash Player 5.
Uso

printNum (nvel, "Caixa delimitadora")

Parmetros

O nvel a ser impresso no Flash Player. Por padro, todos os quadros do nvel so
impressos. Se voc quiser imprimir quadros especficos do nvel, atribua um rtulo de quadro #p
aos quadros desejados.

nvel

Caixa delimitadora Um modificador que define a rea de impresso do filme. Voc pode
escolher um dos seguintes parmetros:

bmovie Indica a caixa delimitadora de um quadro especfico em um filme como a rea de

impresso de todos os quadros imprimveis no filme. Atribua um rtulo de quadro #b ao
quadro cuja caixa delimitadora voc deseja usar como a rea de impresso.

Indica uma composio de todas as caixas delimitadoras, de todos os quadros

imprimveis, como a rea de impresso. Especifique o parmetro bmax quando os quadros
imprimveis em seu filme variarem em tamanho.

Indica uma caixa delimitadora de cada quadro imprimvel a ser usada como rea de
impresso para o quadro. Isso altera a rea de impresso de cada quadro e dimensiona os
objetos para caberem na rea de impresso. Use bframe se voc tiver objetos de tamanhos
diferentes em cada quadro e desejar que cada objeto ocupe toda a pgina impressa.

bmax

bframe

Dicionrio ActionScript 376

Retorna

Nenhum.
Descrio

Ao; imprime o nvel no Flash Player conforme os limites especificados no parmetro Caixa
delimitadora ("bmovie", "bmax", "bframe"). Para imprimir quadros especficos do filme de
destino, necessrio anexar um rtulo de quadro #P a esses quadros. Embora a ao printNum
oferea impresses de qualidade superior s da ao printAsBitmapNum, no possvel usar
printNum para imprimir filmes com transparncias alfa ou efeitos de cor especiais.
Se voc no especificar um parmetro de rea de impresso, ela ser determinada pelo tamanho do
Palco do filme carregado, por padro. O filme no herda o tamanho do Palco do filme principal.
Voc pode controlar a rea de impresso especificando os parmetros bmovie, bmax ou bframe.
Todos os elementos imprimveis em um filme devem ser totalmente carregados antes que a
impresso possa comear.
O recurso de impresso do Flash Player suporta as impressoras PostScript e no PostScript. As
impressoras no PostScript convertem vetores em bitmaps.
Consulte tambm

print, printAsBitmap, printAsBitmapNum

_quality
Disponibilidade

Flash Player 5.
Uso

_quality
Descrio

Propriedade (global); define ou recupera a qualidade usada para um filme. As fontes de dispositivo
so sempre serrilhadas, sendo assim no so afetadas pela propriedade _quality.
A propriedade _quality pode ser definida nos seguintes valores:

"LOW"

"MEDIUM"

"HIGH" Qualidade alta. Os grficos so apresentados sem serrilhado usando uma grade de 4 x
4, em pixels, e os bitmaps so suavizados quando o filme esttico. Essa a configurao de
qualidade padro usada pelo Flash.

"BEST" Qualidade muito alta. Os grficos so apresentados sem serrilhado usando uma grade
de 4 x 4, em pixels, e os bitmaps sempre so suavizados.

Qualidade baixa. Os grficos no so apresentados sem serrilhado, os bitmaps no so

suavizados.

Qualidade mdia. Os grficos so apresentados sem serrilhado usando uma grade de

2 x 2, em pixels, mas os bitmaps no so suavizados. Adequado para filmes que no contm texto.

Exemplo

O exemplo a seguir define a qualidade como LOW:

_quality = "LOW";
Consulte tambm

_highquality, toggleHighQuality

377

random
Disponibilidade

Flash Player 4. Esta funo est obsoleta no Flash 5; recomendvel usar o mtodo Math.random.
Uso

random(valor)
Parmetros

valor

Um inteiro.

Retorna

Um inteiro.
Descrio

Funo; retorna um inteiro aleatrio entre 0 e um a menos que o inteiro especificado no

parmetro valor.
Exemplo

O seguinte uso de random retorna um valor de 0, 1, 2, 3 ou 4:

random(5);
Consulte tambm

Math.random

removeMovieClip
Disponibilidade

Flash Player 4.
Uso

removeMovieClip(destino)
Parmetros

destino O caminho de destino de uma instncia de clipe de filme criada com

duplicateMovieClip, ou o nome da instncia de um clipe de filme criada com os
attachMovie ou duplicateMovieClip do objeto MovieClip.

mtodos

Retorna

Nenhum.
Descrio

Ao; exclui uma instncia de clipe de filme criada com os mtodos attachMovie ou
duplicateMovieClip do objeto MovieClip, ou com a ao duplicateMovieClip.
Consulte tambm

duplicateMovieClip, MovieClip.duplicateMovieClip, MovieClip.attachMovie,

MovieClip.removeMovieClip

Dicionrio ActionScript 378

return
Disponibilidade

Flash Player 5.
Uso

return[expresso]
return
Parmetros

expresso Uma seqncia de caracteres, um nmero, uma matriz ou um objeto a ser avaliado e
retornado como um valor da funo. Este parmetro opcional.
Retorna

O parmetro avaliado expresso, se fornecido.

Descrio

Ao; especifica o valor retornado pela funo. A ao return avalia expresso e retorna o
resultado como o valor da funo em que executada. A ao return faz com que a funo pare
de ser executada e a substitui pelo valor retornado. Se o comando return for usado isoladamente,
retornar null.
Exemplo

O exemplo a seguir usa a ao return dentro do corpo da funo sum para retornar o valor
adicionado dos trs parmetros. A prxima linha de cdigo chama a funo sum e atribui o valor
retornado varivel newValue:
function sum(a, b, c){
return a + b + c;
}
newValue = sum(4, 32, 78);
trace(newValue);
// envia 114 janela Sada
Consulte tambm

function

_root
Disponibilidade

Flash Player 4.
Uso

_root.movieClip
_root.action
_root.property
Parmetros

movieClip
action
property

379

O nome da instncia de um clipe de filme.

Uma ao ou mtodo.
Uma propriedade do objeto MovieClip.

Descrio

Propriedade; especifica ou retorna uma referncia Linha de tempo do filme raiz. Se um filme
tem vrios nveis, a Linha de tempo do filme raiz est no nvel contido no script sendo executado
no momento. Por exemplo, se um script no nvel 1 avaliar _root, ser retornado _level1.
Especificar _root o mesmo que usar a notao de barra (/) para especificar um caminho
absoluto dentro do nvel atual.
Exemplo

O exemplo a seguir interrompe a Linha de tempo do nvel que contm o script sendo executado
no momento:
_root.stop();

O exemplo a seguir envia a Linha de tempo no nvel atual para o quadro 3:

_root.gotoAndStop(3);
Consulte tambm

_parent, targetPath

scroll
Disponibilidade

Flash Player 4.
Uso

textFieldVariableName.scroll = x
Descrio

Propriedade; uma propriedade obsoleta que controla a exibio de informaes em um campo de

texto associado a uma varivel. A propriedade scroll define onde o campo de texto comea
exibindo o contedo; depois de defini-lo, o Flash Player o atualiza medida que o usurio rola
pelo campo de texto. A propriedade scroll til para direcionar os usurios para um pargrafo
em especfico em um trecho longo, ou para criar campos de texto de rolagem. Essa propriedade
pode ser recuperada e modificada.
Exemplo

O cdigo a seguir anexado a um boto Para cima que rola o campo de texto myText:
on (release) {
myText.scroll = myText.scroll + 1;
}
Consulte tambm

TextField.maxscroll, TextField.scroll

Selection (objeto)
O objeto Selection permite definir e controlar em que campo de texto o cursor localizado em
um filme do Flash. O campo de texto que supostamente est em foco aquele em que o cursor
est atualmente localizado. Os ndices do intervalo de seleo so baseados em zero (por exemplo,
a primeira posio 0, a segunda 1 e assim por diante).
No h nenhum mtodo construtor para o objeto Selection, pois s pode haver um campo
focalizado por vez.

Dicionrio ActionScript 380

Resumo de mtodos do objeto Selection

Mtodo

Descrio

Selection.addListener

Registra um objeto para receber notificao quando o mtodo onSetFocus

chamado.

Selection.getBeginIndex

Retorna o ndice no comeo do intervalo da seleo. Retorna -1 se no houver

ndice ou campo selecionado no momento.

Selection.getCaretIndex

Retorna a posio atual do cursor no intervalo de seleo focalizado. Retorna -1

se no houver posio de cursor ou intervalo de seleo focalizado no momento.

Selection.getEndIndex

Retorna o ndice no final do intervalo de seleo. Retorna -1 se no houver ndice

ou campo selecionado no momento.

Selection.getFocus

Retorna o nome da varivel do campo de texto em foco no momento. Retorna

null caso no haja campo de texto em foco no momento.

Selection.removeListener

Remove um objeto que foi registrado com addListener.

Selection.setFocus

Pe em foco o campo de texto associado varivel especificada no parmetro.

Selection.setSelection

Define os ndices de incio e de fim do intervalo de seleo.

Resumo de ouvintes do objeto Selection

Mtodo

Descrio

Selection.onSetFocus

Notificado quando o foco de entrada alterado.

Selection.addListener
Disponibilidade

Flash Player 6.
Uso

Selection.addListener(novo_Ouvinte)
Parmetros

novo_Ouvinte

Objeto com um mtodo onSetFocus.

Retorna

Nenhum.
Descrio

Mtodo; registra um objeto para receber notificaes de alterao de foco do teclado. Quando o
foco alterado (por exemplo, sempre que o mtodo Selection.SetFocus chamado), todos os
objetos ouvintes registrados com addListener tm seu mtodo onSetFocus chamado. Vrios
objetos podem ouvir notificaes de alterao de foco. Se o ouvinte newListener j estiver
registrado, nenhuma alterao ocorrer.

381

Selection.getBeginIndex
Disponibilidade

Flash Player 5.
Uso

Selection.getBeginIndex()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna o ndice no incio do intervalo de seleo. Se nenhum ndice existir ou nenhum
campo de texto estiver em foco no momento, o mtodo retornar -1. Os ndices do intervalo de
seleo so baseados em zero (por exemplo, a primeira posio 0, a segunda 1 e assim por diante).

Selection.getCaretIndex
Disponibilidade

Flash Player 5.
Uso

Selection.getCaretIndex()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna o ndice da posio do cursor intermitente. Se nenhum cursor intermitente for
exibido, o mtodo retornar -1. Os ndices do intervalo de seleo so baseados em zero (por
exemplo, a primeira posio 0, a segunda 1 e assim por diante).

Selection.getEndIndex
Disponibilidade

Flash Player 5.
Uso

Selection.getEndIndex()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna o ndice final do intervalo de seleo focalizado no momento. Se nenhum ndice
existir ou nenhum intervalo de seleo estiver em foco no momento, o mtodo retornar -1. Os
ndices do intervalo de seleo so baseados em zero (por exemplo, a primeira posio 0, a
segunda 1 e assim por diante).

Dicionrio ActionScript 382

Selection.getFocus
Disponibilidade

Flash Player 5. Os nomes de instncia para botes e campos de texto funcionam no Flash Player 6.
Uso

Selection.getFocus()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; retorna o nome da varivel do campo de texto que est evidenciado. Se nenhum campo
de texto estiver evidenciado, o mtodo retornar null. Se o foco atual for um boto que seja uma
instncia do objeto Button, getFocus retornar o caminho de destino como uma seqncia de
caracteres. Se o foco atual for um campo de texto que seja uma instncia do objeto TextField,
getFocus retornar o caminho de destino como uma seqncia de caracteres.
Se um clipe de filme com botes for o boto atualmente em foco, Selection.getFocus
retornar o caminho de destino do clipe de filme com botes. Se um campo de texto com um
nome de instncia estiver atualmente em foco, Selection.getFocus retornar o caminho de
destino do objeto TextField. Caso contrrio, retornar o nome da varivel do campo de texto.

Selection.onSetFocus
Disponibilidade

Flash Player 6.
Uso

someListener.onSetFocus = function(oldFocus, newFocus){

comandos;
}
Descrio

Ouvinte; notificado quando o foco de entrada alterado. Para usar onSetFocus, crie um objeto
ouvinte. Em seguida, possvel definir uma funo para onSetFocus e usar o mtodo
addListener para registrar o ouvinte com o objeto Selection, como a seguir:
someListener = new Object();
someListener.onSetFocus = function () { ... };
Selection.addListener(someListener);

Os ouvintes permitem a cooperao de partes diferentes de cdigo. Isso ocorre porque vrios
ouvintes podem receber notificaes sobre um nico evento.
Consulte tambm

Selection.addListener

383

Selection.removeListener
Disponibilidade

Flash Player 6.
Uso

Selection.removeListener(ouvinte)
Parmetros

ouvinte

O objeto que deixar de receber notificaes de foco.

Retorna

Se o ouvinte tiver sido removido com xito, o mtodo retornar um valor true. Se o ouvinte
no tiver sido removido com xito, por exemplo, caso o ouvinte no estivesse na lista de ouvintes
do objeto Selection, o mtodo retornar um valor false.
Descrio

Mtodo; remove um objeto anteriormente registrado com addListener.

Selection.setFocus
Disponibilidade

Flash Player 5. Os nomes de instncia para botes e campos de texto funcionam apenas no Flash
Player 6.
Uso

Selection.setFocus(caminho_varivel)
Parmetros

Uma seqncia de caracteres especificando o caminho do nome de uma

varivel associada a um campo de texto.

caminho_varivel

Retorna

Um evento.
Descrio

Mtodo; pe em foco o campo de texto editvel associado varivel especificada pelo

caminho_varivel. O parmetro caminho_varivel deve ser uma seqncia de caracteres
literal do caminho dessa varivel. possvel usar a notao de ponto ou barra para especificar o
caminho. Tambm possvel usar um caminho relativo ou absoluto.
Se um caminho de destino de uma instncia de boto for passado como o parmetro
caminho_varivel, esse boto se tornar o novo foco. Se um caminho de destino de uma
instncia de campo de texto for passado como o parmetro caminho_varivel, esse campo de
texto se tornar o novo foco. Se null for passado, o foco atual ser removido.
Se um clipe de filme com botes for passado para Selection.setFocus, ele se tornar o boto
atualmente em foco. Se um objeto TextField for especificado, ele se tornar o foco atual. Se um
objeto Button for especificado, ele se tornar o boto atualmente em foco.

Dicionrio ActionScript 384

Exemplo

O exemplo a seguir pe em foco um campo de texto na Linha de tempo principal que associado
varivel myVar. O parmetro caminho_varivel um caminho absoluto; portanto, possvel
chamar a ao de qualquer Linha de tempo.
Selection.setFocus("_root.myVar");

No exemplo a seguir, o campo de texto associado a myVar est em um clipe de filme chamado
myClip na Linha de tempo principal. possvel usar um dos caminhos a seguir para definir o
foco. O primeiro relativo e o segundo absoluto.
Selection.setFocus("myClip.myVar");
Selection.setFocus("_root.myClip.myVar");

Selection.setSelection
Disponibilidade

Flash Player 5.
Uso

Selection.setSelection(incio, fim)
Parmetros

incio
fim

O ndice inicial do intervalo de seleo.

O ndice final do intervalo de seleo.

Retorna

Nada.
Descrio

Mtodo; define o intervalo de seleo do campo de texto focalizado no momento. O novo

intervalo de seleo comear no ndice especificado no parmetro incio e terminar no ndice
especificado no parmetro fim. Os ndices do intervalo de seleo so baseados em zero (por
exemplo, a primeira posio 0, a segunda 1 e assim por diante). Esse mtodo no tem efeito se
no houver campo de texto focalizado no momento.

set variable
Disponibilidade

Flash Player 4.
Uso

set(varivel, expresso)
Parmetros

varivel
expresso
Retorna

Nada.

385

Um identificador para conter o valor do parmetro expresso.

Um valor atribudo varivel.

Descrio

Ao; atribui um valor a uma varivel. Uma varivel um recipiente que contm dados. O
recipiente sempre o mesmo, mas o contedo pode mudar. Ao alterar o valor de uma varivel
quando o filme estiver sendo reproduzido, voc poder registrar e salvar informaes sobre as
atividades do usurio, gravar valores que mudam medida que o filme reproduzido ou avaliar se
uma condio true ou false.
As variveis podem conter qualquer tipo de dado (por exemplo, seqncia de caracteres, nmero,
Booleano, objeto ou clipe de filme). A Linha de tempo de cada filme e clipe de filme possui seu
prprio conjunto de variveis, e cada varivel possui seu prprio valor, independentemente das
variveis em outras linhas de tempo.
ActionScript uma linguagem com tipos dinmicos. Cada varivel tem um tipo. O tipo
atribudo no tempo de execuo e pode mudar durante a execuo. Isso diferente de uma
linguagem com tipos estticos, como Java ou C++, onde o tipo atribudo no tempo de
compilao e no pode ser alterado no tempo de execuo.
Exemplo

Este exemplo define uma varivel chamada orig_x_pos, que armazena a posio do eixo x
original do clipe de filme ship para redefinir o envio em sua localizao inicial posteriormente no
filme.
on(release) {
set(orig_x_pos, getProperty ("ship", _x ));
}

O cdigo anterior fornece o mesmo resultado que o cdigo a seguir:

on(release) {
orig_x_pos = ship._x;
}
Consulte tambm

var, call

setInterval
Disponibilidade

Flash Player 6.
Uso

setInterval( funo, intervalo[, arg1, arg2, ..., argn] )

setInterval( objeto, nome_do_mtodo, intervalo[, arg1, arg2, ..., argn] )
Parmetros

funo

Um nome de funo ou uma referncia a uma funo annima.

objeto

Um objeto derivado do objeto Object.

nome_do_mtodo

O nome do mtodo para chamar o parmetro objeto.

intervalo O tempo em milissegundos entre chamadas para o parmetro funo

nome_do_mtodo.
arg1, arg2, ..., argn
nome_do_mtodo.

ou

Parmetros opcionais passados para o parmetro funo ou

Dicionrio ActionScript 386

Retorna

Um identificador de intervalo que pode ser passado para clearInterval a fim de cancelar o
intervalo.
Descrio

Ao; chama uma funo, um mtodo ou um objeto em intervalos peridicos enquanto um filme
reproduzido. possvel usar uma funo de intervalo para atualizar variveis de um banco de
dados ou atualizar uma exibio de tempo.
Se intervalo for menor que a taxa de quadros do filme (por exemplo, 10 quadros por segundo
(fps) equivalem a 100 milissegundos), a funo de intervalo ser chamada o mais prximo possvel
de intervalo. Use a funo updateAfterEvent para certificar-se de que a tela seja atualizada
com a freqncia necessria. Se intervalo for maior que a taxa de quadros do filme, a funo de
intervalo s ser chamada quando a reproduo entrar em um quadro para minimizar o impacto
sempre que a tela for atualizada.
O exemplo da primeira sintaxe acima a sintaxe padro para a funo setInterval no painel
Aes no modo Normal. Para usar o exemplo da segunda sintaxe, use o painel Aes no modo
Especialista.
Exemplo

Uso 1: o exemplo a seguir chama uma funo annima a cada 1.000 milissegundos (a cada 1
segundo).
setInterval( function(){ trace("interval called"); }, 1000 );

Uso 2: o exemplo a seguir define duas funes de retorno de chamada e chama cada uma delas.
Ambas as chamadas da funo setInterval enviam a seqncia de caracteres "interval
called" para a janela Sada a cada 1.000 milissegundos. A primeira chamada de setInterval
chama a funo callback1 que contm uma ao trace. A segunda chamada de setInterval
passa a seqncia de caracteres "interval called" para a funo callback2 como um
parmetro.
function callback1() {
trace("interval chamado");
}
function callback2(arg) {
trace(arg);
}
setInterval( callback1, 1000 );
setInterval( callback2, 1000, "interval called" );

Uso 3: este exemplo usa um mtodo de um objeto. Use esta sintaxe quando quiser chamar um
mtodo que seja definido para um objeto. S possvel usar esta sintaxe no modo Especialista.
obj = new Object();
obj.interval = function() {
trace("interval function called");
}
setInterval( obj, "interval", 1000 );
obj2 = new Object();
obj2.interval = function(s) {
trace(s);
}
setInterval( obj2, "interval", 1000, "interval function called" );

387

Use a segunda forma da sintaxe setInterval para chamar um mtodo de um objeto, como a
seguir:
setInterval( obj2, "interval", 1000, "interval function called" );
Consulte tambm

clearInterval, updateAfterEvent

setProperty
Disponibilidade

Flash Player 4.
Uso

setProperty("destino", propriedade, valor/expresso)

Parmetros

O caminho para o nome da instncia do clipe de filme cuja propriedade ser definida.

destino

propriedade
valor

A propriedade que ser definida.

O novo valor literal da propriedade.

expresso

Uma equao que avaliada como o novo valor da propriedade.

Retorna

Nada.
Descrio

Ao; altera o valor da propriedade de um clipe de filme enquanto o filme reproduzido.

Exemplo

Este comando define a propriedade _alpha de um clipe de filme chamado star como 30%
quando o boto clicado:
on(release) {
setProperty("star", _alpha, "30");
}
Consulte tambm

getProperty

Sound (objeto)
O objeto Sound permite controlar o som em um filme. possvel adicionar sons a um clipe de
filme da Biblioteca enquanto o filme est sendo reproduzido e controlar esses sons. Se no for
especificado um destino durante a criao de um novo objeto Sound, ser possvel usar os
mtodos para controlar o som de todo o filme. Voc deve usar o construtor new Sound para criar
uma instncia do objeto Sound antes de chamar os mtodos do objeto Sound.
O objeto Sound suportado no Flash Player 5 e no Flash Player 6.

Dicionrio ActionScript 388

Resumo de mtodos do objeto Sound

Mtodo

Descrio

Sound.attachSound

Anexa o som especificado no parmetro.

Sound.getBytesLoaded

Retorna o nmero de bytes carregados para o som especificado.

Sound.getBytesTotal

Retorna o tamanho do som em bytes.

Sound.getPan

Retorna o valor da chamada setPan anterior.

Sound.getTransform

Retorna o valor da chamada setTransform anterior.

Sound.getVolume

Retorna o valor da chamada setVolume anterior.

Sound.loadSound

Carrega um arquivo MP3 no Flash Player.

Sound.setPan

Define a distribuio esquerda/direita do som.

Sound.setTransform

Define a quantidade de cada canal, esquerdo e direito, a ser reproduzido em cada

alto-falante.

Sound.setVolume

Define o nvel de volume de um som.

Sound.start

Comea a reproduzir um som desde o incio ou, opcionalmente, de um ponto de

deslocamento definido no parmetro.

Sound.stop

Pra o som especificado ou todos os sons em reproduo no momento.

Resumo das propriedades do objeto Sound

Mtodo

Descrio

Sound.duration

Tamanho de um som em milissegundos.

Sound.position

Nmero de milissegundos em que o som foi reproduzido.

Resumo de identificadores de eventos do objeto Sound

Mtodo

Descrio

Sound.onLoad

Chamado quando um som carregado.

Sound.onSoundComp
lete

Chamado quando a reproduo de um som interrompida.

Construtor do objeto Sound

Disponibilidade

Flash Player 5.
Uso

new Sound([destino])
Parmetros

destino
Retorna

Nada.

389

A instncia de clipe de filme em que o objeto Sound opera. Este parmetro opcional.

Descrio

Construtor; cria um novo objeto Sound para um clipe de filme especificado. Se no for
especificada uma instncia de destino, o objeto Sound controlar todos os sons do filme.
Exemplo

O exemplo a seguir cria uma nova instncia do objeto Sound chamada GlobalSound. A segunda
linha chama o mtodo setVolume e ajusta o volume de todos os sons do filme em 50%.
globalsound = new Sound();
globalsound.setVolume(50);

O exemplo a seguir cria uma nova instncia do objeto Sound, passa para ela o clipe de filme de
destino meu_Filme e chama o mtodo start que inicia qualquer som em meu_Filme.
moviesound = new Sound(meu_Filme);
moviesound.start();

Sound.attachSound
Disponibilidade

Flash Player 5.
Uso

mySound.attachSound("Nome_id")
Parmetros

Nome_id O identificador de um som exportado na Biblioteca. O identificador est localizado na

caixa de dilogo Propriedades de vinculao de smbolo.
Retorna

Nada.
Descrio

Mtodo; anexa o som especificado no parmetro Nome_id ao objeto Sound especificado. O som
deve estar na biblioteca do filme atual e ser especificado para exportao na caixa de dilogo
Propriedades de Vinculao de Smbolo. Voc deve chamar Sound.start para iniciar a
reproduo do som.
Consulte tambm

Sound.start

Sound.duration
Disponibilidade

Flash Player 6.
Uso

mySound.duration
Descrio

Propriedade (somente leitura); a durao de um som em milissegundos.

Dicionrio ActionScript 390

Sound.getBytesLoaded
Disponibilidade

Flash Player 6.
Uso

Sound.getBytesLoaded()
Parmetros

Nenhum.
Retorna

Um inteiro que indica o nmero de bytes carregados.

Descrio

Mtodo; retorna o nmero de bytes carregados (transmitidos) do objeto Sound especificado.

possvel comparar o valor de getBytesLoaded ao valor de getBytesTotal para determinar que
porcentagem de um som foi carregada.
Consulte tambm

Sound.getBytesTotal

Sound.getBytesTotal
Disponibilidade

Flash Player 6.
Uso

Sound.getBytesTotal()
Parmetros

Nenhum.
Retorna

Um inteiro indicando o tamanho total, em bytes, do objeto Sound especificado.

Descrio

Mtodo; retorna o tamanho, em bytes, do objeto Sound especificado.

Consulte tambm

Sound.getBytesLoaded

Sound.getPan
Disponibilidade

Flash Player 5.
Uso

mySound.getPan();
Parmetros

Nenhum.

391

Retorna

Nada.
Descrio

Mtodo; retorna o nvel de pan definido na ltima chamada setPan como um inteiro de -100
(esquerda) a 100 (direita). (0 define os canais esquerdo e direito igualmente.) A configurao de
pan controla a distribuio esquerda-direita dos sons futuros e atuais em um filme.
Esse mtodo cumulativo com os mtodos setVolume ou setTransform.
Consulte tambm

Sound.setPan

Sound.getTransform
Disponibilidade

Flash Player 5.
Uso

mySound.getTransform();
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; retorna as informaes de transformao do som do objeto Sound especificado na ltima

chamada setTransform.
Consulte tambm

Sound.setTransform

Sound.getVolume
Disponibilidade

Flash Player 5.
Uso

mySound.getVolume()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; retorna o nvel do volume de som como um inteiro de 0 a 100, no qual 0 sem volume
e 100 o volume total. A configurao padro 100.
Consulte tambm

Sound.setVolume

Dicionrio ActionScript 392

Sound.loadSound
Disponibilidade

Flash Player 6.
Uso

mySound.loadSound("url", isStreaming)
Parmetros

url

Local de um arquivo de som MP3 no servidor.

isStreaming

Valor booleano que indica se o som um evento ou um fluxo de som.

Retorna

Nada.
Descrio

Mtodo; carrega um arquivo MP3 em uma instncia do objeto Sound. possvel usar o
parmetro isSteaming para indicar se o som um evento ou um fluxo de som.
Os eventos de som so totalmente carregados antes de serem reproduzidos. Eles so gerenciados
pelo objeto Sound do ActionScript e respondem a todos os mtodos e propriedades desse objeto.
Os fluxos de som so reproduzidos durante o download. A reproduo comea aps o
recebimento de dados suficientes para iniciar o descompactador. Assim como nos eventos de som,
os fluxos de som s existem na memria virtual e seu download no feito para o disco rgido.
Exemplo

O exemplo a seguir carrega um evento de som:

s.loadSound( "http://caminho_do_servidor:porta/nome_de_arquivo_mp3", false);

O exemplo a seguir carrega um fluxo de som:

loadSound( "http://caminho_do_servidor:porta/nome_de_arquivo_mp3", true);

Sound.onLoad
Disponibilidade

Flash Player 6.
Uso

mySoundObject.onLoad = callbackFunction
Parmetros

mySoundObject

Um objeto Sound.

callbackFunction

Uma funo.

Retorna

Nada.
Descrio

Identificador de eventos; chamado automaticamente quando um som carregado. Crie uma

funo que seja executada quando o evento onLoad for chamado. possvel usar uma funo
annima ou uma funo nomeada.
Consulte tambm

Sound.onSoundComplete

393

Sound.onSoundComplete
Disponibilidade

Flash Player 6.
Uso

mySoundObject.onSoundComplete = callbackFunction
Parmetros

mySoundObject

Um objeto Sound.

callbackFunction

Uma funo.

Retorna

Nada.
Descrio

Evento; chamado automaticamente quando a reproduo de um som concluda. possvel usar

o evento onSoundComplete para ativar eventos em um filme com base na concluso de um som.
Crie uma funo que seja executada quando o evento onSoundComplete for chamado. possvel
usar uma funo annima ou uma funo nomeada.
Exemplo

Uso 1: o exemplo a seguir usa uma funo annima:

s = new Sound();
s.attachSound("mySound");
s.onSoundComplete = function() { trace("mySound completed"); };
s.start();

Uso 2: o exemplo a seguir usa uma funo nomeada:

function callback1() {
trace("mySound completed");
}
s = new Sound();
s.attachSound("mySound");
s.onSoundComplete = callback1;
s.start();

Sound.position
Disponibilidade

Flash Player 6.
Uso

mySound.position
Parmetros

Nenhum.
Retorna

Nmero de milissegundos em que o som foi reproduzido.

Dicionrio ActionScript 394

Descrio

Propriedade (somente leitura); retorna o nmero de milissegundos em que um som foi

reproduzido. Se o som for repetido, a posio ser redefinida como 0 no incio de cada loop.

Sound.setPan
Disponibilidade

Flash Player 5.
Uso

mySound.setPan(pan);
Parmetros

pan Um inteiro que especifica a distribuio esquerda-direita de um som. O intervalo de valores

vlidos de -100 a 100, no qual -100 usa somente o canal esquerdo, 100 usa somente o canal
direito e 0 distribui o som uniformemente entre os dois canais.
Retorna

Nada.
Descrio

Mtodo; determina como o som reproduzido nos canais esquerdo e direito (alto-falantes). No
caso de sons mono, pan determina o alto-falante (esquerdo ou direito) pelo qual o som passa.
Exemplo

O exemplo a seguir cria uma instncia do objeto Sound s e anexa um som com o Identificador L7
da Biblioteca. Tambm chama os mtodos setVolume e setPan para controlar o som L7.
onClipEvent(mouseDown) {
// cria um objeto de som
s = new Sound(this);
// anexa um som da biblioteca
s.attachSound("L7");
//define o volume como 50%
s.setVolume(50);
//desliga o som no canal direito
s.setPan(-100);
//inicia 30 segundos no som e o reproduz 5 vezes
s.start(30, 5);
Consulte tambm

Sound.attachSound, Sound.setPan, Sound.setTransform, Sound.setVolume, Sound.start

Sound.setTransform
Disponibilidade

Flash Player 5.
Uso

mySound.setTransform(soundTransformObject)
Parmetros

soundTransformObject

395

Um objeto criado com o construtor do objeto Object genrico.

Retorna

Nada.
Descrio

Mtodo; define as informaes de transformao ou de distribuio do som de um objeto

Sound.
O parmetro soundTransformObject um objeto criado por meio do mtodo construtor do
objeto Object genrico com parmetros que especificam como o som distribudo para os canais
esquerdo e direito (alto-falantes).
Os sons ocupam quantidade considervel de espao em disco e memria. Como o som estreo usa
duas vezes mais dados do que os sons mono, geralmente melhor usar sons mono de 6 bits de 22
KHz. Voc pode usar o mtodo setTransform para reproduzir sons mono como estreo, sons
estreo como mono e para adicionar efeitos de som interessantes.
Os parmetros do soundTransformObject so os seguintes:
11 Uma porcentagem que especifica a quantidade de som do canal esquerdo a ser reproduzida
no alto-falante esquerdo (de 0 a 100).
1r Uma porcentagem que especifica a quantidade de som do canal direito a ser reproduzida no
alto-falante esquerdo (de 0 a 100).
rr Uma porcentagem que especifica a quantidade de som do canal direito a ser reproduzida no
alto-falante direito (de 0 a 100).
rl
Uma porcentagem que especifica a quantidade de som do canal esquerdo a ser reproduzida
no alto-falante direito (de 0 a 100).

O resultado lquido dos parmetros representado pela seguinte frmula:

leftOutput = left_input * ll + right_input * lr
rightOutput = right_input * rr + left_input * rl

Os valores para left_input ou right_input so determinados pelo tipo (estreo ou mono) do

som do filme.
Os sons estreo dividem a entrada de som uniformemente entre os alto-falantes esquerdo e direito
e, por padro, tm as seguintes configuraes de transformao:
ll
lr
rr
rl

=
=
=
=

100
0
100
0

Os sons mono reproduzem toda a entrada de som no alto-falante esquerdo e, por padro, tm as
seguintes configuraes de transformao:
ll
lr
rr
rl

=
=
=
=

100
100
0
0

Exemplo

O exemplo a seguir ilustra uma configurao que pode ser obtida com o mtodo setTransform,
mas no com os mtodos setVolume ou setPan, mesmo que estejam combinados.

Dicionrio ActionScript 396

O cdigo abaixo cria um novo objeto soundTransformObject e define suas propriedades para
que o som de ambos os canais seja reproduzido somente no canal esquerdo.
mySoundTransformObject = new Object;
mySoundTransformObject.ll = 100;
mySoundTransformObject.lr = 100;
mySoundTransformObject.rr = 0;
mySoundTransformObject.rl = 0;

Para aplicar o objeto soundTransformObject a um objeto Sound, necessrio passar o objeto

para Sound usando o mtodo setTransform da seguinte maneira:
mySound.setTransform(mySoundTransformObject);

O exemplo a seguir reproduz um som estreo como mono; soundTransformObjectMono tem os

seguintes parmetros:
mySoundTransformObjectMono = new Object;
mySoundTransformObjectMono.ll = 50;
mySoundTransformObjectMono.lr = 50;
mySoundTransformObjectMono.rr = 50;
mySoundTransformObjectMono.rl = 50;
mySound.setTransform(soundTransformObjectMono);

Este exemplo reproduz o canal esquerdo na metade de sua capacidade e adiciona o restante do
canal esquerdo ao canal direito; soundTransformObjectHalf tem os seguintes parmetros:
mySoundTransformObjectHalf = new Object;
mySoundTransformObjectHalf.ll = 50;
mySoundTransformObjectHalf.lr = 0;
mySoundTransformObjectHalf.rr = 100;
mySoundTransformObjectHalf.rl = 50;
setTransform(soundTransformObjectHalf);
Consulte tambm

Construtor do objeto Object

Sound.setVolume
Disponibilidade

Flash Player 5.
Uso

mySound.setVolume(volume)
Parmetros

volume Um nmero de 0 a 100 que representa um nvel de volume.100 o volume total e 0

nenhum volume. A configurao padro 100.
Retorna

Nada.
Descrio

Mtodo; define o volume do objeto Sound.

397

Exemplo

O exemplo a seguir define o volume em 50% e, com o tempo, transfere o som do alto-falante
esquerdo para o direito:
onClipEvent (load) {
i = -100;
s = new Sound();
s.setVolume(50);
}
onClipEvent (enterFrame) {
if (i <= 100) {
S.setPan(i++);
}
}
Consulte tambm

Sound.setPan, Sound.setTransform

Sound.start
Disponibilidade

Flash Player 5.
Uso

mySound.start([deslocamento_Segundo, loop])
Parmetros

Um parmetro opcional que permite comear a reproduzir o som em

um ponto especfico. Por exemplo, no caso de um som de 30 segundos que deva iniciar a
reproduo no meio, especifique 15 para o parmetro deslocamento_Segundo. O som no
atrasado 15 segundos; em vez disso, ele inicia a sua reproduo na marca de 15 segundos.

deslocamento_Segundo

Um parmetro opcional que permite especificar o nmero de vezes em que o som deve ser
reproduzido consecutivamente.

loop

Retorna

Nada.
Descrio

Mtodo; inicia a reproduo do ltimo som anexado desde o incio se nenhum parmetro estiver
especificado, ou em um ponto especificado pelo parmetro deslocamento_Segundo.
Consulte tambm

Sound.stop

Sound.stop
Disponibilidade

Flash Player 5.
Uso

mySound.stop(["Nome_id"])

Dicionrio ActionScript 398

Parmetros

Nome_id Uma parmetro opcional que especifica a interrupo da reproduo de determinado

som. O parmetro Nome_id deve ser colocado entre aspas (" ").
Retorna

Nada.
Descrio

Mtodo; interrompe todos os sons em reproduo no momento se nenhum parmetro estiver

especificado, ou somente o som especificado no parmetro Nome_id.
Consulte tambm

Sound.start

_soundbuftime
Disponibilidade

Flash Player 4.
Uso

_soundbuftime = integer
Parmetros

integer

O nmero de segundos decorridos antes que o filme comece a ser reproduzido.

Descrio

Propriedade (global); estabelece o nmero de segundos de som de fluxo para o pr-buffer. O valor
padro 5 segundos.

Stage (objeto)
O objeto Stage um objeto de alto nvel que pode ser acessado sem o uso de um construtor.
Use os mtodos e as propriedades deste objeto para acessar e manipular informaes sobre os
limites de um filme do Flash.
O objeto Stage est disponvel no Flash Player 6 e posterior.
Resumo de mtodos do objeto Stage
Mtodo

Descrio

Stage.addListener

Adiciona um objeto ouvinte ao objeto Stage.

Stage.removeListener

Remove um objeto ouvinte do objeto Stage.

Resumo das propriedades do objeto Stage

399

Mtodo

Descrio

Stage.align

Alinhamento do filme do Flash no navegador.

Stage.height

Altura do objeto Stage, em pixels.

Stage.width

Largura do objeto Stage, em pixels.

Stage.scaleMode

O dimensionamento atual do filme do Flash.

Resumo de identificadores de eventos do objeto Stage

Mtodo

Descrio

Stage.onResize

Indica que o filme foi redimensionado.

Stage.addListener
Disponibilidade

Flash Player 6.
Uso

Stage.addListener(meu_Ouvinte)
Parmetros

meu_Ouvinte

Objeto que ouve uma notificao de retorno de chamada do evento onResize.

Retorna

Nada.
Descrio

Mtodo; detecta quando um filme do Flash redimensionado se Stage.scaleMode =

O mtodo addListener no funciona com a configurao de dimensionamento de
filme padro ("showAll") nem com outras configuraes de dimensionamento ("exactFit" e
"noBorder").

"noScale".

Para usar addListener, crie primeiro um objeto ouvinte. O objeto ouvinte aquele que recebe
notificao de um evento quando este ativado em um filme. Os objetos ouvintes do objeto Stage
recebem notificao de Stage.onResize.
Exemplo

Este exemplo cria um novo objeto ouvinte chamado meu_Ouvinte. Em seguida, usa
meu_Ouvinte para chamar onResize e define uma funo que ser chamada quando onResize
for ativado. Finalmente, o cdigo adiciona o objeto meu_Ouvinte lista de retorno de chamada
do objeto Stage. Os objetos ouvintes permitem que vrios objetos ouam notificaes de
redimensionamento.
myListener = new Object();
myListener.onResize = function () { ... }
Stage.addListener(meu_Ouvinte);

Stage.align
Disponibilidade

Flash Player 6.
Uso

Stage.align
Descrio

Propriedade; indica o alinhamento atual do filme do Flash dentro do Palco.

Dicionrio ActionScript 400

A tabela a seguir lista os valores da propriedade align. Os valores no listados aqui centralizam o
filme na rea do Palco.
Valor

Vertical

Horizontal

"T"

superior

centro

"B"

inferior

centro

"L"

centro

esquerda

"R"

centro

direita

"TL"

superior

esquerda

"TR"

superior

direita

"BL"

inferior

esquerda

"BR"

inferior

direita

Stage.height
Disponibilidade

Flash Player 6.
Uso

Stage.height
Descrio

Propriedade (somente leitura); indica a altura atual, em pixels, do palco do filme do Flash.
Quando a propriedade Stage.noScale tem o valor true, height representa a altura do Flash
Player. Quando o valor Stage.noScale false (o filme dimensionado quando a janela do
exibidor redimensionada), height representa a altura do filme do Flash.

Stage.onResize
Disponibilidade

Flash Player 6.
Uso

Stage.onResize() = function() {...}

Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo de retorno de chamada; indica que o filme do Flash foi redimensionado. possvel usar
este evento para gravar uma funo que disponha os objetos no Palco quando um filme for
redimensionado.

401

Stage.removeListener
Disponibilidade

Flash Player 6.
Uso

Stage.removeListener(meu_Ouvinte)
Parmetros

meu_Ouvinte
addListener.

Um objeto adicionado lista de retorno de chamada de um objeto com o mtodo

Retorna

Nada.
Descrio

Mtodo; remove um objeto ouvinte criado com addListener.

Consulte tambm

Stage.addListener

Stage.scaleMode
Disponibilidade

Flash Player 6.
Uso

Stage.scaleMode = "value"
Descrio

Propriedade; indica o dimensionamento atual do filme do Flash dentro do Palco. A propriedade

scaleMode fora o modo de dimensionamento especfico do filme. Como padro, o filme usa os
parmetros HTML definidos na caixa de dilogo Configuraes de publicao.
A propriedade scaleMode pode usar os valores "exactFit", "showAll", "noBorder" e
Qualquer outro valor define a propriedade scaleMode como o padro "showAll".

"noScale".

Stage.width
Disponibilidade

Flash Player 6.
Uso

Stage.width
Descrio

Propriedade (somente leitura); indica a largura atual, em pixels, do palco do filme do Flash.
Quando o valor de Stage.noScale true, a propriedade width representa a largura do Player.
Quando o valor de Stage.noScale false (o filme dimensionado quando a janela do
exibidor redimensionada), width representa a largura do filme do Flash.

Dicionrio ActionScript 402

startDrag
Disponibilidade

Flash Player 4.
Uso

startDrag(destino,[bloqueio ,esquerdo , superior , direito, inferior])

Parmetros

destino

O caminho de destino do clipe de filme a ser arrastado.

Um valor booleano que especifica se o clipe de filme a ser arrastado est bloqueado
no centro da posio do mouse (true) ou no ponto onde o usurio clicou pela primeira vez no
clipe de filme (false). Este parmetro opcional.
bloqueio

esquerdo, superior, direito, inferior

Valores relativos s coordenadas do pai do clipe de

filme que especificam um retngulo de restrio para o clipe de filme. Esses parmetros so opcionais.

Retorna

Nada.
Descrio

Ao; torna o clipe de filme de destino arrastvel enquanto o filme est sendo exibido. Somente
um clipe de filme pode ser arrastado de cada vez. Quando uma operao startDrag executada,
o clipe de filme permanece arrastvel at que seja explicitamente encerrado por uma ao
stopDrag ou at que uma ao startDrag para outro clipe de filme seja chamada.
Exemplo

Para criar um clipe de filme que os usurios possam posicionar em qualquer local, anexe as aes
startDrag e stopDrag a um boto dentro do clipe de filme.
on(press) {
startDrag(this, true);
}
on(release) {
stopDrag();
}
Consulte tambm

MovieClip._droptarget, stopDrag

stop
Disponibilidade

Flash 2.
Uso

stop
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Ao; encerra o filme em exibio. A utilidade mais comum dessa ao controlar clipes de filme
com botes.

403

stopAllSounds
Disponibilidade

Flash Player 3.
Uso

stopAllSounds()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Ao; encerra a reproduo de todos os sons de um filme sem interromper a exibio do filme.
Sons definidos como 'em streaming' voltaro a ser reproduzidos quando a reproduo for movida
sobre os quadros em que se encontram.
Exemplo

O cdigo a seguir pode ser aplicado a um boto que, quando clicado, encerra todos os sons do
filme.
on(release) {
stopAllSounds();
}
Consulte tambm

Sound (objeto)

stopDrag
Disponibilidade

Flash Player 4.
Uso

stopDrag()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Ao; encerra a operao de arraste em andamento.

Dicionrio ActionScript 404

Exemplo

Este comando interrompe a ao de arraste na instncia mc quando o usurio libera o boto do

mouse:
on(press) {
startDrag("mc");
}
on(release) {
stopdrag();
}
Consulte tambm

MovieClip.stopDrag, MovieClip._droptarget, startDrag,

String (funo)
Disponibilidade

Flash Player 4.
Uso

String(expresso)
Parmetros

expresso

Expresso para converter em uma seqncia de caracteres.

Retorna

Nada.
Descrio

Funo; retorna uma representao de seqncia de caracteres do parmetro especificado da

seguinte maneira:
Se expresso for um valor Booleano, a seqncia de caracteres retornada ser true ou false.
Se expresso for um nmero, a seqncia de caracteres retornada ser uma representao de
texto do nmero.
Se expresso for uma seqncia de caracteres, a seqncia retornada ser expresso.
Se expresso for um objeto, o valor retornado ser uma representao de seqncia de caracteres
do objeto gerado pela chamada da propriedade da seqncia de caracteres referente ao objeto ou
pela chamada de Object.toString, se tal propriedade no existir.
Se expresso for um clipe de filme, o valor de retorno ser o caminho de destino do clipe de
filme em notao de barra (/).
Se expresso for undefined, o valor de retorno ser uma seqncia de caracteres vazia ("").
Consulte tambm

Number.toString, Object.toString,
caracteres)

405

String (objeto), " " (delimitador de seqncia de

" " (delimitador de seqncia de caracteres)

Disponibilidade

Flash Player 4.
Uso

"texto"
Parmetros

texto

Um caractere.

Retorna

Nada.
Descrio

Delimitador de seqncia de caracteres; quando usadas antes e depois de caracteres, as aspas

indicam que os caracteres tm um valor literal e so considerados como uma seqncia de
caracteres, e no como varivel, valor numrico ou outro elemento do ActionScript.
Exemplo

Este exemplo usa aspas para indicar que o valor da varivel yourGuess a seqncia de caracteres
literal Prince Edward Island e no o nome de uma varivel. O valor province uma varivel, e
no uma literal; para determinar o valor de province, necessrio localizar o valor de yourGuess.
yourGuess = "Prince Edward Island";
on(release){
province = yourGuess
trace(province);
}
// exibe Prince Edward Island na janela Sada
Consulte tambm

String (objeto), String (funo)

String (objeto)
O objeto String um envoltrio para o tipo de dados primitivo de seqncia de caracteres, que
permite usar os mtodos e as propriedades do objeto String para manipular tipos de valores
primitivos de seqncias de caracteres. possvel converter o valor de qualquer objeto em uma
seqncia de caracteres usando a funo String(). No Flash MX, o objeto String tornou-se um
objeto nativo. Assim, voc poder observar uma melhora radical no desempenho.
Todos os mtodos do objeto String, exceto concat, fromCharCode, slice e substr, so
genricos. Isso significa que os prprios mtodos podem chamar this.toString antes de
permitir suas operaes, e podem ser usados com outros objetos que no sejam objetos String.
Como todos os ndices de seqncia de caracteres so baseados em zero, o ndice do ltimo
caractere para qualquer seqncia x o seguinte:
x.length - 1

Dicionrio ActionScript 406

Voc pode chamar qualquer um dos mtodos do objeto String usando o mtodo construtor new
String ou usando o valor literal de uma seqncia de caracteres. Se voc especificar o valor literal
de uma seqncia de caracteres, o interpretador ActionScript automaticamente o converter em
um objeto String temporrio, chamar o mtodo e depois descartar o objeto String temporrio.
Voc tambm pode utilizar a propriedade String.length com o valor literal de uma seqncia
de caracteres.
importante no confundir o valor literal de uma seqncia de caracteres com uma instncia do
objeto String. No exemplo a seguir, a primeira linha de cdigo cria o valor literal da seqncia de
caracteres s1 e a segunda linha de cdigo cria uma instncia do objeto String s2.
s1 = "foo"
s2 = new String("foo")

Use valores literais da seqncia de caracteres, a menos seja necessrio usar especificamente um
objeto String.
Resumo de mtodos do objeto String
Mtodo

Descrio

String.charAt

Retorna o caractere em um local especfico em uma seqncia de caracteres.

String.charCodeAt

Retorna o valor do caractere de um ndice determinado como um inteiro de 16 bits entre

0 e 65535.

String.concat

Combina o texto de duas seqncias de caracteres e retorna uma nova seqncia de

caracteres

String.fromCharCode Retorna uma seqncia de caracteres constituda de caracteres especificados nos

parmetros.
String.indexOf

Pesquisa a seqncia de caracteres e retorna o ndice da subseqncia de caracteres

especificada nos parmetros. Se o valor ocorrer mais de uma vez, o ndice da primeira
ocorrncia retornado. Se o valor no for encontrado, -1 retornado.

String.lastIndexOf

Retorna o ndice da ltima subseqncia de caracteres dentro da seqncia de

caracteres que aparece antes da posio de incio especificada no parmetro, ou
retorna -1 se no encontrado.

String.slice

Extrai uma seo de uma seqncia de caracteres e retorna uma nova seqncia de
caracteres.

String.split

Divide um objeto String em uma matriz de seqncias de caracteres separando a

seqncia em subseqncias.

String.substr

Retorna um nmero especificado de caracteres em uma seqncia de caracteres,

comeando no local especificado no parmetro.

String.substring

Retorna os caracteres entre dois ndices, especificado nos parmetros como uma
seqncia de caracteres.

String.toLowerCase

Converte a seqncia de caracteres em minsculas e retorna o resultado; no altera o

contedo do objeto original.

String.toUpperCase

Converte a seqncia de caracteres em maisculas e retorna o resultado; no altera o

contedo do objeto original.

Resumo de propriedades do objeto String

407

Propriedade

Descrio

String.length

Retorna o tamanho da seqncia de caracteres

Construtor do objeto String

Disponibilidade

Flash Player 5.
Uso

new String(valor)
Parmetros

valor

O valor inicial do objeto new String.

Retorna

Nada.
Descrio

Construtor; cria um objeto new String.

Consulte tambm

String (funo), " " (delimitador de seqncia de caracteres)

String.charAt
Disponibilidade

Flash Player 5.
Uso

myString.charAt(ndice)
Parmetros

ndice

O nmero do caractere a ser retornado na seqncia de caracteres.

Retorna

Nada.
Descrio

Mtodo; retorna o caractere na posio especificada pelo parmetro ndice. O ndice do primeiro
caractere em uma seqncia de caracteres 0. Se ndice no for um nmero de 0 a
string.length - 1, ser retornada uma seqncia de caracteres vazia.

String.charCodeAt
Disponibilidade

Flash Player 5.
Uso

myString.charCodeAt(ndice)
Parmetros

ndice Um inteiro que especifica a posio de um caractere na seqncia de caracteres. O

primeiro caractere indicado por 0 e o ltimo indicado por myString.length-1.
Retorna

Nada.

Dicionrio ActionScript 408

Descrio

Mtodo; retorna um nmero inteiro de 16 bits de 0 a 65535 que representa o caractere

especificado por ndice.
Este mtodo semelhante a string.charAt, exceto pelo fato de o valor retornado ser um cdigo
de caracteres inteiro de 16 bits, e no um caractere.
Exemplo

No exemplo a seguir, o mtodo charCodeAt chamado na primeira letra da seqncia de

caracteres Chris.
s = new String(Chris);
i = s.charCodeAt(0);
// i = 67

String.concat
Disponibilidade

Flash Player 5.
Uso

myString.concat(valor1,...valorN)
Parmetros

valor1,...valorN

Zero ou mais valores a serem concatenados.

Retorna

Nada.
Descrio

Mtodo; combina o valor do objeto String aos parmetros e retorna a seqncia de caracteres
recm-formada; o valor original, myString, inalterado.

String.fromCharCode
Disponibilidade

Flash Player 5.
Uso

String.fromCharCode(c1,c2,...cN)
Parmetros

c1,c2,...cN

Inteiros decimais que representam valores ASCII.

Retorna

Nada.
Descrio

Mtodo; retorna uma seqncia de caracteres constituda de caracteres representados pelos valores
ASCII nos parmetros.

409

Exemplo

Este exemplo usa o mtodo fromCharCode para inserir um caractere @ no endereo eletrnico.
address = "dog" + String.fromCharCode(64) + "house.net";
trace(address);
// sada: dog@house.net

String.indexOf
Disponibilidade

Flash Player 5.
Uso

myString.indexOf(subseqncia de caracteres, [incio_ndice])

Parmetros

subseqncia de caracteres Um inteiro ou uma seqncia de caracteres que especifica a

subseqncia de caracteres a ser procurada em myString.
incio_ndice Um inteiro que especifica o ponto inicial em myString para procurar pela
subseqncia de caracteres. Este parmetro opcional.
Retorna

Nada.
Descrio

Mtodo; pesquisa a seqncia de caracteres e retorna a posio da primeira ocorrncia da

subseqncia de caracteres especificada. Se o valor no for encontrado, o mtodo retorna -1.

String.lastIndexOf
Disponibilidade

Flash Player 5.
Uso

myString.lastIndexOf(subseqncia de caracteres, [incio_ndice])

Parmetros

subseqncia de caracteres

Um inteiro ou seqncia de caracteres que especifica a

seqncia a ser procurada.

incio_ndice
caracteres. Este

Um inteiro que especifica o ponto inicial para procurar pela subseqncia de

parmetro opcional.

Retorna

Nada.
Descrio

Mtodo; procura a seqncia de caracteres da direita para a esquerda e retorna o ndice da ltima
ocorrncia de subseqncia de caracteres localizada antes de incio_ndice na seqncia
de caracteres de chamada. Se a subseqncia de caracteres no for encontrada, o mtodo
retorna -1.

Dicionrio ActionScript 410

String.length
Disponibilidade

Flash Player 5.
Uso

string.length
Parmetros

Nenhum.
Descrio

Propriedade; retorna o nmero de caracteres no objeto String especificado.

String.slice
Disponibilidade

Flash Player 5.
Uso

myString.slice(incio, [fim])
Parmetros

Um nmero que especifica o ndice do ponto inicial da fatia. Se incio for um nmero
negativo, o ponto inicial determinado a partir do final da seqncia de caracteres, onde -1 o
ltimo caractere.

incio

Um nmero que especifica o ndice do ponto final da fatia. Se fim no for especificado, a
fatia incluir todos os caracteres do incio ao fim da seqncia de caracteres. Se fim for um
nmero negativo, o ponto final determinado a partir do final da seqncia de caracteres, onde -1
o ltimo caractere.

fim

Retorna

Nada.
Descrio

Mtodo; extrai uma fatia, ou subseqncia de caracteres, do objeto String especificado; em

seguida, retorna-a como uma nova seqncia, sem modificar o objeto String original. A seqncia
de caracteres retornada inclui o caractere de incio e todos os caracteres at (mas no incluindo)
o caractere de fim.
Exemplo

O exemplo a seguir define uma varivel, text, cria uma instncia do objeto String, s, e a passa
para a varivel text. O mtodo slice extrai uma seo da seqncia de caracteres contida na
varivel e a ao trace a envia para a janela Sada.
text = "lexington";
s = new String( text );
trace(s.slice( 1, 3 ));
trace(s);

A janela Sada exibe ex.

411

O cdigo a seguir produz o mesmo resultado, mas o parmetro passado para a funo String
uma seqncia de caracteres em vez de uma varivel.
s = new String( "lexington" );
trace(s.slice( 1, 3 ));
trace(s);

A janela Sada exibe ex.

String.split
Disponibilidade

Flash Player 5.
Uso

myString.split("delimitador", [limite])
Parmetros

delimitador O caractere ou a seqncia de caracteres em que myString dividido. Se o

parmetro delimitador no for definido, toda a seqncia de caracteres ser colocada no
primeiro elemento da matriz.
limite

O nmero de itens que devem ser colocados na matriz. Este parmetro opcional.

Retorna

Uma matriz que contm as subseqncias de caracteres de myString.

Descrio

Mtodo; divide um objeto String em subseqncias de caracteres quebrando-o sempre que o

parmetro delimitador especificado ocorre e retorna as subseqncias de caracteres em uma
matriz. Se for usada uma seqncia de caracteres vazia ("") como delimitador, cada caractere na
seqncia ser colocado como um elemento na matriz, como no cdigo a seguir.
myString = "Joe";
i = myString.split("");
trace (i);

A janela Sada exibe o seguinte:

J, O, E

Se o parmetro delimitador no for definido, toda a seqncia de caracteres ser colocada no

primeiro elemento da matriz retornada.
Exemplo

O exemplo a seguir retorna uma matriz com cinco elementos.

myString = "P, A, T, S, Y";
myString.split(",");

Este exemplo retorna uma matriz com dois elementos.

myString.split(",", 2);

Dicionrio ActionScript 412

String.substr
Disponibilidade

Flash Player 5.
Uso

myString.substr(incio, [tamanho])
Parmetros

incio Um inteiro que indica a posio do primeiro caractere em myString a ser usado para
criar a subseqncia de caracteres. Se incio for um nmero negativo, a posio inicial
determinada a partir do final da seqncia de caracteres, onde -1 o ltimo caractere.

O nmero de caracteres na subseqncia de caracteres que est sendo criada. Se

no for especificado, a subseqncia de caracteres inclui todos os caracteres do incio ao
fim da seqncia de caracteres.
tamanho
tamanho

Retorna

Nada.
Descrio

Mtodo; retorna os caracteres em uma seqncia de caracteres do ndice especificado no

parmetro incio at o nmero de caracteres especificado no parmetro tamanho. O mtodo
substr no altera a seqncia de caracteres especificada por myString, mas retorna uma nova
seqncia de caracteres.

String.substring
Disponibilidade

Flash Player 5.
Uso

myString.substring(de, para)
Parmetros

Um inteiro que indica a posio do primeiro caractere de myString usado para criar a
subseqncia de caracteres. Os valores vlidos referentes a de vo de 0 a string.length - 1. Se
de for um valor negativo, 0 ser usado.
de

para Um inteiro que 1+ o ndice do ltimo caractere em myString a ser extrado. Os valores
vlidos referentes a para vo de 1 a string.length. O caractere indexado pelo parmetro para
no est includo na seqncia de caracteres extrada. Se este parmetro for omitido,
string.length ser usado. Se este parmetro for um valor negativo, 0 ser usado.
Retorna

Nada.
Descrio

Mtodo; retorna uma seqncia de caracteres que consiste nos caracteres entre os pontos
especificados pelos parmetros de e para. Se o parmetro to no for especificado, o fim da
subseqncia de caracteres ser o fim da seqncia de caracteres. Se o valor referente a de for igual
ao valor referente a para, o mtodo retornar uma seqncia de caracteres vazia. Se o valor
referente a de for maior que o valor referente a para, os parmetros sero trocados
automaticamente antes de a funo ser executada e o valor original ser inalterado.

413

String.toLowerCase
Disponibilidade

Flash Player 5.
Uso

myString.toLowerCase()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; retorna uma cpia do objeto String, com todos os caracteres em maisculas convertidos
em minsculas. O valor original no se altera.

String.toUpperCase
Disponibilidade

Flash Player 5.
Uso

myString.toUpperCase()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; retorna uma cpia do objeto String, com todos os caracteres em maisculas convertidos
em minsculas. O valor original no se altera.

substring
Disponibilidade

Flash Player 4. Esta funo tornou-se obsoleta em favor de String.substr.

Uso

substring("seqncia de caracteres", ndice, contagem)

Parmetros

seqncia de caracteres

A seqncia de caracteres da qual ser extrada a nova seqncia de

caracteres.
ndice

O nmero do primeiro caractere a ser extrado.

O nmero de caracteres a ser includo na seqncia de caracteres extrada, sem incluir

o caractere ndice.

contagem

Dicionrio ActionScript 414

Retorna

Nada.
Descrio

Funo String; extrai parte de uma seqncia de caracteres. Esta funo baseia-se em 1, enquanto
os mtodos do objeto String baseiam-se em 0.
Consulte tambm

String.substr

super
Disponibilidade

Flash Player 6.
Uso

super.method([arg1, ..., argN])

super([arg1, ..., argN])
Parmetros

method

O mtodo que ser chamado na superclasse.

Parmetros opcionais que so passados para a verso da superclasse do mtodo (sintaxe 1)

ou para a funo construtora da superclasse (sintaxe 2).

arg1

Retorna

Ambas as formas chamam uma funo. A funo pode retornar qualquer valor.
Descrio

Operador: o estilo da primeira sintaxe pode ser usado no corpo de um mtodo de objeto para
chamar a verso de superclasse de um mtodo e pode, opcionalmente, passar parmetros (arg1 ...
argN) para o mtodo de superclasse. Isso til para criar mtodos de subclasse que adicionem um
comportamento extra aos mtodos de superclasse, mas que tambm chamem os mtodos de
superclasse para executar o comportamento original.
O estilo da segunda sintaxe pode ser usado dentro do corpo de uma funo construtora para
chamar a verso de superclasse da funo construtora e pode, opcionalmente, passar parmetros
para ela. Isso til para criar uma subclasse que execute uma inicializao adicional, mas que
tambm chame o construtor de superclasse para executar a inicializao da superclasse.

415

Exemplo

O exemplo a seguir cria duas classes, ParentClass e ChildClass, e define um mtodo chamado
method para cada classe. Cada definio de mtodo tem uma ao trace que envia uma
mensagem para a janela Sada. A penltima linha de cdigo cria uma instncia de ChildClass e
chama seu mtodo do method:
function ParentClass() {
}
ParentClass.prototype.method = function () {
trace("ParentClass implementation of method");
};
function ChildClass() {
}
ChildClass.prototype = new ParentClass();
ChildClass.prototype.method = function () {
trace("ChildClass implementation of method");
super.method();
};
x = new ChildClass();
x.method();

O seguinte exibido na janela Sada:

ChildClass implementation of method
ParentClass implementation of method

O exemplo a seguir passa parmetros para o super construtor:

function SuperClass(arg){
trace("SuperClass constructor was passed " + arg);
}
function SubClass(arg){
super(arg);
trace("SubClass constructor");
}

switch
Disponibilidade

Flash Player 4.
Uso

switch (expresso){
caseClause:
[defaultClause:]
}
Parmetros

expresso

Qualquer expresso.

caseClause Uma palavra-chave case seguida de uma expresso, dois-pontos e um grupo de

comandos para serem executados se a expresso corresponder ao parmetro expresso de troca
usando igualdade estrita (===).

Uma palavra-chave default seguida de comandos para serem executados se

nenhuma das expresses com diferenciao de maisculas e minsculas corresponder ao
parmetro expresso de troca usando igualdade estrita (===).

defaultClause

Retorna

Nada.

Dicionrio ActionScript 416

Descrio

Ao; cria uma estrutura ramificada para comandos do ActionScript. Como a ao if, a ao
switch testa uma condio e executa comandos se a condio retornar um valor true.
Exemplo

No exemplo a seguir, se o parmetro number for avaliado como 1, a ao trace seguinte a case 1
ser executada; se o parmetro numer for avaliado como 2, a ao trace seguinte a case 2 ser
executada e assim por diante. Se nenhuma expresso case corresponder ao parmetro number, a
ao trace seguinte palavra-chave default ser executada.
switch (number) {
case 1:
trace ("case 1 tested true");
break;
case 2:
trace ("case 2 tested true");
break;
case 3:
trace ("case 3 tested true");
break;
default:
trace ("no case tested true")
}

No exemplo a seguir, no h uma quebra no primeiro grupo case; portanto, se o nmero for 1, A
e B sero enviados para a janela Sada:
switch (number) {
case 1:
trace ("A");
case 2:
trace ("B");
break;
default
trace ("D")
}
Consulte tambm

=== (igualdade estrita), break, case, default, if

System (objeto)
Este um objeto de alto nvel que contm o objeto Capabilities. necessrio usar o objeto System
para utilizar o objeto Capabilities e suas propriedades. Por exemplo, o cdigo a seguir verifica se
um sistema tem recursos de udio.
System.capabilites.hasAudio

System.capabilities (objeto)
possvel usar o objeto System.capabilites para determinar os recursos do sistema e do exibidor
que hospedam um filme do Flash. Isso permite ajustar o contedo para formatos diferentes. Por
exemplo, a tela de um telefone celular (preto-e-branco, 100 pixels quadrados) diferente da tela
de PC colorida de 1.000 pixels quadrados. Para oferecer um contedo apropriado ao maior
nmero possvel de usurios, possvel usar o objeto Capabilities para determinar o tipo de
dispositivo de um usurio. Em seguida, possvel especificar que o servidor envie diferentes
arquivos SWFs com base nos recursos do dispositivo, ou solicitar que o filme do Flash altere sua
apresentao com base nos recursos do dispositivo.

417

 possvel enviar informaes sobre recursos usando um mtodo GET ou POST HTTP. A seguir,
exibido um exemplo de uma seqncia de caracteres do servidor referente a um dispositivo que
no tem suporte MP3 e tem uma tela de 400 x 200 pixels, 8 x 4 centmetros:
"A=t&MP3=f&AE=gsm&VE=h11&ACC=f&V=WIN%206%2C0%2C0%2C129&M=Macromedia%WINDOWS&R=
400x200&DP=72&COL=color&AR=1.0&OS=WINDOWS%2000&L=en-US"

O objeto Capabilities est disponvel no Flash Player 6.

Acesse todas as propriedades do objeto Capabilities por meio do objeto System.capabilities.
Resumo das propriedades do objeto Capabilities
Propriedade

Descrio

System.capabilities.hasAudioEncoder

Indica os codificadores de udio suportados.

System.capabilities.hasAccessibility

Indica se o dispositivo atende aos padres de acessibilidade.

System.capabilities.hasAudio

Indica se o dispositivo tem recursos de udio.

System.capabilities.hasMP3

Indica se o dispositivo tem um decodificador MP3.

System.capabilities.language

Indica o idioma suportado pelo Flash Player.

System.capabilities.manufacturer

Indica o fabricante do Flash Player.

System.capabilities.os

Indica o sistema operacional que hospeda o Flash Player.

System.capabilities.pixelAspectRatio

Indica a proporo de pixels da tela.

System.capabilities.screenColor

Indica se a tela colorida, em preto-e-branco ou em tons de

cinza.

System.capabilities.screenDPI

Indica os pontos por polegada da tela.

System.capabilities.screenResolution.x Indica o tamanho horizontal da tela.

System.capabilities.screenResolution.y Indica o tamanho vertical da tela.
System.capabilities.version

Indica a verso mais antiga do Flash Player para a qual h

suporte.

System.capabilities.hasVideoEncoder

Indica os codificadores de vdeo suportados.

System.capabilities.hasAudioEncoder
Disponibilidade

Flash Player 6.
Uso

System.capabilities.hasAudioEncoder
Descrio

Propriedade; uma matriz de decodificadores de udio. A seqncia de caracteres do servidor AE.

Dicionrio ActionScript 418

System.capabilities.hasAccessibility
Disponibilidade

Flash Player 6.
Uso

System.capabilities.hasAccessibility
Descrio

Propriedade; um valor booleano que indica se o dispositivo suporta ou no a comunicao entre o

Flash Player e os auxlios de acessibilidade. O valor padro false. A seqncia de caracteres do
servidor ACC.

System.capabilities.hasAudio
Disponibilidade

Flash Player 6.
Uso

System.capabilities.hasAudio
Descrio

Propriedade; um valor booleano que indica se o exibidor tem ou no recursos de udio. O valor
padro true. A seqncia de caracteres do servidor A.

System.capabilities.hasMP3
Disponibilidade

Flash Player 6.
Uso

System.capabilities.hasMP3
Descrio

Propriedade; um valor booleano que indica se o exibidor tem ou no um decodificador MP3. O

valor padro true. A seqncia de caracteres do servidor MP3.

System.capabilities.language
Disponibilidade

Flash Player 6.
Uso

System.capabilities.language

419

Descrio

Propriedade; um cdigo de idioma de duas letras minsculas do ISO 639-1, e uma submarca de
cdigo de pas de duas letras maisculas opcional do ISO 3166. Os prprios idiomas so
nomeados com as marcas em ingls. Por exemplo, pt o idioma do documento que voc l neste
momento. A seqncia de caracteres do servidor LAN. O Flash suporta o seguinte subconjunto
das marcas de idioma:
Idioma

Marca

Pases e Marcas Suportados

Ingls

en

Estados Unidos = US, Reino Unido = UK

Francs

fr

Coreano

ko

Japons

ja

Sueco

sv

Alemo

de

Espanhol

es

Italiano

it

Chins Simplificado

zh

Repblica Popular da China (Chins Simplificado)

= CN

Chins Tradicional

zh

Taiwan (Chins Tradicional) = TW

Portugus

pt

Polons

pl

Hngaro

hu

Tcheco

cs

Turco

tr

Finlands

fi

Dinamarqus

da

Noruegus

no

Holands

nl

Russo

ru

Outros/Desconhecidos

xu

System.capabilities.manufacturer
Disponibilidade

Flash Player 6.
Uso

System.capabilities.manufacturer
Descrio

Propriedade; uma seqncia de caracteres que indica o fabricante do Flash Player. O padro
"Macromedia OSName" (OSname pode ser "Windows","Macintosh" ou "Other OS Name"). A
seqncia de caracteres do servidor M.

Dicionrio ActionScript 420

System.capabilities.os
Disponibilidade

Flash Player 6.
Uso

System.capabilities.os
Descrio

Propriedade; uma seqncia de caracteres que indica o fabricante do Flash Player. O padro uma
seqncia de caracteres vazia ("")A propriedade os pode retornar as seguintes seqncias de
caracteres: "Windows XP", "Windows 2000", "Windows NT", "Windows 98/ME", "Windows 95",
"Windows CE" (disponvel apenas em SDK, no na verso desktop) e "MacOS". A seqncia de
caracteres do servidor OS.

System.capabilities.pixelAspectRatio
Disponibilidade

Flash Player 6.
Uso

System.capabilities.hasVideoEncoder
Descrio

Propriedade; um inteiro que indica a proporo de pixels da tela. O valor padro 1.0. A
seqncia de caracteres do servidor PAR.

System.capabilities.screenColor
Disponibilidade

Flash Player 6.
Uso

System.capabilities.screenColor
Descrio

Propriedade; indica a cor da tela: colorida (color), cinza (gray) ou preto-e-branco (bw). O valor
padro color. A seqncia de caracteres do servidor SC.

System.capabilities.screenDPI
Disponibilidade

Flash Player 6.
Uso

System.capabilities.screenDPI
Descrio

Propriedade; indica os pontos por polegada (dpi) da tela, em pixels. O valor padro 72. A
seqncia de caracteres do servidor DPI.

421

System.capabilities.screenResolution.x
Disponibilidade

Flash Player 6.
Uso

System.capabilities.screenResolution.x
Descrio

Propriedade; um inteiro que indica a resoluo horizontal mxima da tela. O valor padro 800
(pixels). A seqncia de caracteres do servidor SRX.

System.capabilities.screenResolution.y
Disponibilidade

Flash Player 6.
Uso

System.capabilities.screenResolution.y
Descrio

Propriedade; um inteiro que indica a resoluo vertical mxima da tela. O valor padro 600
(pixels). A seqncia de caracteres do servidor SRY.

System.capabilities.version
Disponibilidade

Flash Player 6.
Uso

System.capabilities.version
Descrio

Propriedade; um inteiro que especifica a verso suportada do Flash Player. O padro 6.0. A
seqncia de caracteres do servidor VER.

System.capabilities.hasVideoEncoder
Disponibilidade

Flash Player 6.
Uso

System.capabilities.hasVideoEncoder
Descrio

Propriedade; uma matriz de codificadores de vdeo. A seqncia de caracteres do servidor VE.

Dicionrio ActionScript 422

targetPath
Disponibilidade

Flash Player 5.
Uso

targetpath(objeto_MovieClip)
Parmetros

objeto_MovieClip Referncia (por exemplo, _root ou _parent) ao clipe de filme cujo

caminho de destino est sendo recuperado.
Retorna

Nada.
Descrio

Funo; retorna uma seqncia de caracteres que contm o caminho de destino de

objeto_MovieClip. O caminho de destino retornado em notao com pontos. Para recuperar o
caminho de destino em notao de barras, use a propriedade _target.
Exemplo

Este exemplo exibe o caminho de destino de um clipe de filme assim que carregado.
onClipEvent(load){
trace(targetPath(this));
}
Consulte tambm

eval

tellTarget
Disponibilidade

Flash Player 3. (Obsoleto no Flash 5; recomendvel usar a notao com pontos e a ao with.)
Uso

tellTarget("destino") {
comando(s);
}
Parmetros

destino Uma seqncia de caracteres que especifica o caminho de destino da Linha de tempo a
ser controlada.
comando(s)
Retorna

Nada.

423

Os comandos que sero executados se a condio for avaliada como true.

Descrio

Ao; aplica os comandos especificados no parmetro statements para a Linha de tempo

especificada no parmetro destino. A ao tellTarget til para controles de navegao.
Atribua tellTarget a botes que encerram ou comeam clipes de filme em qualquer local do
Palco. Voc tambm pode fazer clipes de filme irem para um quadro em particular no clipe. Por
exemplo, atribua tellTarget a botes que encerrem ou comecem clipes de filme no Palco ou
solicitem que os clipes de filme saltem para um quadro especfico.
No Flash 5, possvel usar a notao com pontos em vez da ao tellTarget. Use a ao with a
fim de emitir vrias aes para a mesma Linha de tempo. possvel usar a ao with para
especificar qualquer objeto, enquanto a ao tellTarget s pode especificar clipes de filme.
Exemplo

O comando tellTarget controla na instncia do clipe de filme ball na Linha de tempo

principal. O quadro 1 da instncia ball est em branco e tem uma ao stop, de maneira que
no visvel no Palco. Quando o boto com a ao a seguir clicado, tellTarget solicita que a
reproduo em ball v para o quadro 2, onde a animao comea.
on(release) {
tellTarget("ball") {
gotoAndPlay(15);
}
}

O exemplo a seguir usa uma notao com pontos para alcanar os mesmos resultados.
on(release) {
ball.gotoAndPlay(2);
}

Se for necessrio emitir vrios comandos para a instncia ball, use a ao with, como no
comando a seguir.
on(release) {
with(ball) {
gotoAndPlay(15);
_alpha = 15;
_xscale = 50;
_yscale = 50;
}
}
Consulte tambm

with

TextField (objeto)
Todos os campos de texto dinmicos e de entrada em um filme do Flash so instncias do objeto
TextField. possvel dar a um campo de texto um nome de instncia no Inspetor de propriedades
e usar os mtodos e as propriedades do objeto TextField para manipul-lo com o ActionScript. Os
nomes de instncia do TextField so exibidos no Movie Explorer e na caixa de dilogo Inserir
caminho de destino no painel Aes.
O objeto TextField herda do objeto Object.
Para criar um campo de texto dinamicamente, use o mtodo MovieClip.createTextField.
O objeto TextField tem suporte do Flash Player 6 e de suas verses posteriores.

Dicionrio ActionScript 424

Resumo de mtodos do objeto TextField

Mtodo

Descrio

TextField.addListener

Registra um objeto para receber notificao quando os eventos onChanged e

oNScroller forem chamados.

TextField.getDepth

Retorna a espessura de um campo de texto.

TextField.getNewTextFormat

Obtm o formato de texto padro atribudo ao texto recm-inserido.

TextField.removeListener

Remove um objeto ouvinte.

TextField.removeTextField

Remove um campo de texto que foi criado com

MovieClip.createTextField.

TextField.setNewTextFormat

Define um objeto de formato de texto para o texto que inserido por um

usurio ou por um mtodo.

TextField.replaceSel

Substitui a seleo atual.

TextField.setTextFormat

Define o formato de texto padro atribudo ao texto recm-inserido.

Resumo das propriedades do objeto TextField

425

Propriedade

Descrio

TextField._alpha

O valor da transparncia de uma instncia de campo de texto.

TextField.autoSize

Controla o alinhamento automtico e o dimensionamento de um campo de

texto.

TextField.background

Indica se o campo de texto tem um preenchimento de fundo.

TextField.backgroundColor

Indica a cor do preenchimento de fundo.

TextField.border

Indica se o campo de texto tem uma borda.

TextField.borderColor

Indica a cor da borda.

TextField.bottomScroll

A linha visvel mais inferior em um campo de texto.

TextField.embedFonts

Indica se o campo de texto usa contornos de fontes incorporadas ou fontes

de dispositivo.

TextField._highquality

Indica a qualidade do filme.

TextField._height

A altura de uma instncia de campo de texto em pixels. Afeta somente a

caixa delimitadora do campo de texto, e no a espessura da borda nem o
tamanho da fonte de texto.

TextField.hscroll

Indica o valor de rolagem horizontal de um campo de texto.

TextField.html

Indica a posio de rolagem mxima atual de um campo de texto.

TextField.htmlText

Contm uma representao HTML do contedo de um campo de texto.

TextField.length

O nmero de caracteres em um campo de texto.

TextField.maxChars

O nmero mximo de caracteres que um campo de texto pode conter.

TextField.maxhscroll

O valor mximo de TextField.hscroll.

TextField.maxscroll

O valor mximo de TextField.scroll.

TextField.multiline

Indica se o campo de texto contm vrias linhas.

TextField._name

O nome de uma instncia de campo de texto.

Propriedade

Descrio

TextField._parent

Uma referncia instncia que o pai desta instncia; seja do tipo Button ou
MovieClip.

TextField.password

Indica se um campo de texto oculta os caracteres de entrada.

TextField._quality

Indica a qualidade de um filme.

TextField.restrict

O conjunto de caracteres que um usurio pode digitar em um campo de

texto.

TextField._rotation

O grau de rotao de uma instncia de campo de texto.

TextField.scroll

Indica a posio de rolagem atual de um campo de texto.

TextField.selectable

Indica se um campo de texto pode ser selecionado.

TextField._soundbuftime

A quantidade de tempo em que um som deve ser armazenado em pr-buffer

antes de ser reproduzido.

TextField.tabEnabled

Indica se um clipe de filme est includo na ordenao de tabulao

automtica.

TextField.tabIndex

Indica a ordem de guias de um objeto.

TextField.text

O texto atual no campo de texto.

TextField.textColor

A cor do texto atual no campo de texto.

TextField.textHeight

A altura da caixa delimitadora do campo de texto.

TextField.textWidth

A largura da caixa delimitadora do campo de texto.

TextField.type

Indica se um campo de texto dinmico ou de entrada.

TextField._url

A URL do arquivo SWF que criou a instncia de campo de texto.

TextField.variable

O nome da varivel associada ao campo de texto.

TextField._visible

Um valor booleano que determina se uma instncia de campo de texto est

oculta ou visvel.

TextField._width

A largura de uma instncia de campo de texto em pixels. Afeta somente a

caixa delimitadora do campo de texto, e no a espessura da borda nem o
tamanho da fonte de texto.

TextField.wordWrap

Indica se o campo de texto faz quebra automtica de linha.

TextField._x

A coordenada x de uma instncia de campo de texto.

TextField._xmouse

A coordenada x do cursor relativo a uma instncia de campo de texto.

TextField._xscale

O valor que especifica a porcentagem para dimensionar horizontalmente

uma instncia de campo de texto.

TextField._y

A coordenada y de uma instncia de campo de texto.

TextField._ymouse

A coordenada y do cursor relativo a uma instncia de campo de texto.

TextField._yscale

O valor que especifica a porcentagem para dimensionar verticalmente uma

instncia de campo de texto.

Dicionrio ActionScript 426

Resumo de identificadores de eventos do objeto TextField

Mtodo

Descrio

TextField.onChanged

Chamado quando o campo de texto alterado.

TextField.onKillFocus

Chamado quando o campo de texto perde o foco.

TextField.onScroller

Chamado quando a propriedade scroll, maxscroll, hscroll, maxhscroll

ou bottomscroll de um campo de texto alterada.

TextField.onSetFocus

Chamado quando o campo de texto recebe o foco.

Resumo de ouvintes do objeto TextField

Mtodo

Descrio

TextField.onChanged

Notificado quando o campo de texto alterado.

TextField.onScroller

Notificado quando a propriedade scroll ou maxscroll de um campo de

texto alterada.

TextField._alpha
Disponibilidade

Flash Player 6.
Uso

TextField._alpha
Descrio

Propriedade; define ou recupera a transparncia alfa (valor) do campo de texto especificado por
TextField. A faixa de valores vlidos vai de 0 (totalmente transparente) a 100 (totalmente opaco).
Exemplo

Os comandos a seguir definem a propriedade _alpha de um campo de texto chamado de text1

como 30%.
on(release) {
text1._alpha = 30;
}

TextField.addListener
Disponibilidade

Flash Player 6.
Uso

TextField.addListener(novo_Ouvinte)
Parmetros

novo_Ouvinte
Retorna

Nada.

427

Um objeto com notificaes dos eventos onChanged e onScroller.

Descrio

Mtodo; registra um objeto para receber notificaes de eventos. Quando o evento onChanged ou
onScroller ocorre, os eventos TextField.onChanged e TextField.onScroller so chamados,
seguidos dos mtodos onChanged e onScroller de objetos ouvintes registrados com
addListener. Vrios objetos podem ouvir notificaes de alterao. Se o ouvinte newListener j
estiver registrado, nenhuma alterao ocorrer.

TextField.autoSize
Disponibilidade

Flash Player 6.
Uso

TextField.autoSize
Descrio

Propriedade; controla o alinhamento e o dimensionamento automticos de campos de texto. Se o

valor de dimensionamento automtico for "none", o campo de texto se comportar normalmente
e no ser redimensionado ou alinhado automaticamente para corresponder ao texto. Se o valor
for "left", o campo de texto expandir ou contrair seus lados direito e inferior para se ajustar a
todo o texto contido. Os lados esquerdo e superior permanecem nas mesmas posies. Se o valor
de dimensionamento automtico for "center", o campo de texto ser dimensionado
automaticamente, mas seu centro horizontal permanecer ancorado na posio central horizontal
original do campo de texto. O lado inferior ainda ser expandido para se ajustar a todo o texto
contido. Se o valor de dimensionamento automtico for "right", o campo de texto ser
dimensionado automaticamente, mas os lados esquerdo e inferior sero expandidos ou contrados.
Os lados superior e direito permanecem nas mesmas posies. Ao definir a propriedade
autoSize, true ser sinnimo de "esquerda" e false de "nenhum".
Exemplo

O exemplo a seguir define a propriedade autosize do campo de texto textField2 como "center".
textField2.autosize = "center";

TextField.background
Disponibilidade

Flash Player 6.
Uso

TextField.background
Descrio

Propriedade; se true, o campo de texto ter um preenchimento de fundo. Se false, o campo de

texto no ter nenhum preenchimento de fundo.

Dicionrio ActionScript 428

TextField.backgroundColor
Disponibilidade

Flash Player 6.
Uso

TextField.backgroundColor
Descrio

Propriedade; a cor do fundo do campo de texto. O padro 0xFFFFFF (branco). Esta propriedade
pode ser recuperada ou definida, mesmo que, no momento, no haja fundo, mas a cor s ser
visvel se o campo de texto tiver uma borda.
Consulte tambm

TextField.background

TextField.border
Disponibilidade

Flash Player 6.
Uso

TextField.border
Descrio

Propriedade; se true, o campo de texto ter uma borda. Se false, o campo de texto no ter borda.

TextField.borderColor
Disponibilidade

Flash Player 6.
Uso

TextField.borderColor
Descrio

Propriedade; a cor da borda do campo de texto, o padro 0x000000 (preto). Esta propriedade
pode ser recuperada ou definida, mesmo que no haja borda no momento.
Consulte tambm

TextField.border

429

TextField.bottomScroll
Disponibilidade

Flash Player 6.
Uso

TextField.bottomScroll
Descrio

Propriedade (somente leitura); um inteiro (ndice baseado em 1) que indica a linha mais inferior
atualmente visvel em TextField. Imagine o campo de texto como uma janela para um bloco
de texto. A propriedade Textfield.scroll o ndice baseado em 1 da linha visvel mais superior
na janela.
Todo o texto entre as linhas TextField.scroll e TextField.bottomScroll est visvel
atualmente no campo de texto.

TextField.embedFonts
Disponibilidade

Flash Player 6.
Uso

TextField.embedFonts
Descrio

Propriedade; um valor booleano que, quando true, exibe o campo de texto usando contornos de
fontes incorporadas. Se false, exibir o campo de texto usando fontes de dispositivo.

TextField._focusrect
Disponibilidade

Flash Player 6.
Uso

TextField._focusrect
Descrio

Propriedade; um valor booleano que especifica se um campo de texto tem um retngulo amarelo
em torno dele quando est em foco.

TextField.getDepth
Disponibilidade

Flash Player 6.
Uso

TextField.getDepth
Parmetros

Nenhum.

Dicionrio ActionScript 430

Retorna

Um inteiro.
Descrio

Mtodo; retorna a espessura de um campo de texto.

TextField.getFontList
Disponibilidade

Flash Player 6.
Uso

TextField.getFontList
Parmetros

Nenhum.
Retorna

Uma matriz.
Descrio

Mtodo; retorna um objeto Array cujos elementos so os nomes de todas as fontes no sistema host
do Flash Player, inclusive fontes no arquivo SWF e em quaisquer arquivos SWF de elementos
carregados. Os nomes so do tipo seqncia de caracteres.

TextField.getNewTextFormat
Disponibilidade

Flash Player 6.
Uso

TextField.getNewTextFormat()
Parmetros

Nenhum.
Retorna

Um objeto TextFormat.
Descrio

Mtodo; retorna um objeto TextFormat que contm uma cpia do objeto de formato de texto do
campo de texto. O objeto de formato de texto o formato recebido pelo texto recm-inserido,
como o texto inserido com o mtodo replaceSel ou o texto digitado por um usurio. Quando
getNewTextFormat chamado, o objeto TextFormat retornado tem todas as suas propriedades
definidas. Nenhuma propriedade null.

431

TextField.getTextFormat
Disponibilidade

Flash Player 6.
Uso

TextField.getTextFormat()
TextField.getTextFormat (ndice)
TextField.getTextFormat (incio_ndice, fim_ndice)
Parmetros

ndice

Um inteiro que especifica um caractere em uma seqncia de caracteres.

Retorna

Um objeto.
Descrio

Mtodo; (Uso 1) retorna um objeto TextFormat que contm informaes de formatao para todo o
texto em um campo de texto. Somente as propriedades comuns a todo o texto no campo de texto
so definidas no objeto TextFormat resultante. Qualquer propriedade que seja misturada, ou seja,
que tenha valores diferentes em pontos diferentes no texto, tem seu valor definido como null.
Uso 2: retorna um objeto TextFormat que contm uma cpia do formato de texto do campo de
texto em ndice.
Uso 3: retorna um objeto TextFormat que contm informaes de formatao para o intervalo de
texto de incio_ndice a fim_ndice.
Consulte tambm

TextField.getNewTextFormat, TextField.setNewTextFormat, TextField.setTextFormat

TextField._height
Disponibilidade

Flash Player 6.
Uso

TextField._height
Descrio

Propriedade; define e recupera a altura do campo de texto, em pixels.

Exemplo

O exemplo de cdigo a seguir define a altura e a largura de um campo de texto.

myTextField._width = 200;
myTextField._height = 200;

Dicionrio ActionScript 432

TextField._highquality
Disponibilidade

Flash Player 6.
Uso

TextField._highquality
Descrio

Propriedade (global); especifica o nvel de sem serrilhado aplicado no filme atual. Especifique 2
(MELHOR) para aplicar alta qualidade com a suavizao de bitmap sempre ativada. Especifique
1 (alta qualidade) para aplicar o recurso sem serrilhado; isso suavizar os bitmaps se o filme no
contiver animao. Especifique 0 (baixa qualidade) para evitar o recurso sem serrilhado.
Exemplo

_highquality = 1;
Consulte tambm

_quality, toggleHighQuality

TextField.hscroll
Disponibilidade

Flash Player 6.
Uso

TextField.hscroll
Retorna

Um inteiro.
Descrio

Propriedade; indica a posio de rolagem horizontal atual. Se a propriedade hscroll for 0, o

texto no ser rolado horizontalmente.
Exemplo

O exemplo a seguir rola o texto horizontalmente.

on (release) {
myTextField.hscroll += 1;
}
Consulte tambm

TextField.maxhscroll, TextField.scroll

433

TextField.html
Disponibilidade

Flash Player 6.
Uso

TextField.html
Descrio

Propriedade; um sinalizador que indica se o campo de texto contm uma representao HTML.
Se a propriedade html for true, o campo de texto ser HTML. Se html for false, o campo de
texto ser no-HTML.
Consulte tambm

TextField.htmlText

TextField.htmlText
Disponibilidade

Flash Player 6.
Uso

TextField.htmlText
Descrio

Propriedade; se o campo de texto for HTML, esta propriedade conter a representao HTML do
contedo do campo de texto. Se o campo de texto no for HTML, ele se comportar da mesma
maneira que a propriedade text. possvel especificar que um campo de texto seja HTML no
Inspetor de propriedades ou ao configurar a propriedade html do campo de texto como true.
Exemplo

No exemplo a seguir, o texto do campo de texto text2 est em negrito.

text2.html = true;
text2.htmlText = "<b>texto em negrito </b>";

TextField.length
Disponibilidade

Flash Player 6.
Uso

TextField.length
Descrio

Propriedade (somente leitura); indica o nmero de caracteres em um campo de texto. Esta

propriedade retorna o mesmo valor que text.length, mas mais rpida. Um caractere como
tabulao (\t), por exemplo, conta como um caractere.

Dicionrio ActionScript 434

TextField.maxChars
Disponibilidade

Flash Player 6.
Uso

TextField.maxChars
Descrio

Propriedade; indica o nmero mximo de caracteres que o campo de texto pode conter. Um script
pode inserir mais texto que o permitido por maxChars; a propriedade maxChars s indica quanto
texto um usurio pode digitar. Se o valor desta propriedade for null, no haver limite para a
quantidade de texto que um usurio pode digitar.

TextField.maxhscroll
Disponibilidade

Flash Player 6.
Uso

TextField.maxhscroll
Descrio

Propriedade (somente leitura); indica o valor mximo de TextField.hscroll.

Consulte tambm

TextField.hscroll

TextField.maxscroll
Disponibilidade

Flash Player 6.
Uso

TextField.maxscroll
Descrio

Propriedade (somente leitura); indica o valor mximo de TextField.scroll.

Consulte tambm

TextField.scroll

TextField.multiline
Disponibilidade

Flash Player 6.
Uso

TextField.multiline
Descrio

Propriedade; indica se o campo de texto contm vrias linhas. Se o valor for true, o campo de
texto conter vrias linhas; se for false, ele ser um campo de texto de uma nica linha.

435

TextField._name
Disponibilidade

Flash Player 6.
Uso

TextField._name
Descrio

Propriedade; retorna o nome da instncia do campo de texto especificado por TextField.

TextField.onChanged
Disponibilidade

Flash Player 6.
Uso

TextField.onChanged
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Identificador de eventos; chamado quando o contedo de um campo de texto alterado. Como

padro, indefinido; possvel defini-lo em um script.

TextField.onKillFocus
Disponibilidade

Flash Player 6.
Uso

TextField.onKillFocus = function (newFocus) {

comandos;

};
Parmetros

newFocus

O objeto em foco.

Retorna

Nada.
Descrio

Identificador de eventos; um evento que chamado quando um campo de texto perde o foco do
teclado. O mtodo onKillFocus recebe um parmetro, newFocus, que um objeto
representando o novo objeto a receber o foco. Se nenhum objeto receber o foco, newFocus
conter o valor null.

Dicionrio ActionScript 436

TextField.onScroller
Disponibilidade

Flash Player 6.
Uso

TextField.onScroller
Descrio

Identificador de eventos; um evento que chamado quando uma das propriedades de rolagem do
campo de texto alterada.
Consulte tambm

TextField.hscroll, TextField.maxhscroll, TextField.maxscroll, TextField.scroll

TextField.onSetFocus
Disponibilidade

Flash Player 6.
Uso

TextField.onSetFocus = function(oldFocus){
comandos;
};
Parmetros

oldFocus

O objeto que perde o foco.

Retorna

Nada.
Descrio

Identificador de eventos; chamado quando um campo de texto recebe o foco do teclado. O

parmetro oldFocus o objeto que perde o foco. Por exemplo, se o usurio pressionar a tecla Tab
para mover o foco de entrada de um boto para um campo de texto, oldFocus conter a instncia
do campo de texto.
Se nenhum objeto possua o foco anteriormente, oldFocus conter um valor null.

TextField._parent
Disponibilidade

Flash Player 6.
Uso

_parent.property
_parent._parent.property
Descrio

Propriedade; especifica ou retorna uma referncia ao clipe de filme ou objeto que contm o clipe
de filme ou objeto atual. O objeto atual o que contm o cdigo ActionScript que faz referncia a
_parent. Use _parent para especificar um caminho relativo para clipes de filme ou objetos que
estiverem acima do clipe de filme ou objeto atual.
Consulte tambm

_root, targetPath

437

TextField.password
Disponibilidade

Flash Player 6.
Uso

TextField.password
Descrio

Propriedade; se o valor de password for true, o campo de texto ser de senha e ocultar os
caracteres de entrada. Se for false, o campo de texto no ser de senha.

TextField._quality
Disponibilidade

Flash Player 6.
Uso

TextField._quality
Descrio

Propriedade (global); define ou recupera a qualidade usada para um filme. As fontes de dispositivo
so sempre serrilhadas, sendo assim no so afetadas pela propriedade _quality.
A propriedade _quality pode ser definida nos seguintes valores:

"LOW"

"MEDIUM"

"HIGH" Qualidade alta. Os grficos so apresentados sem serrilhado usando uma grade de 4 x
4, em pixels, e os bitmaps so suavizados quando o filme esttico. Essa a configurao de
qualidade padro usada pelo Flash.

"BEST" Qualidade muito alta. Os grficos so apresentados sem serrilhado usando uma grade
de 4 x 4, em pixels, e os bitmaps sempre so suavizados.

Qualidade baixa. Os grficos no so apresentados sem serrilhado, os bitmaps no so

suavizados.

Qualidade mdia. Os grficos so apresentados sem serrilhado usando uma grade

de 2 x 2, em pixels, mas os bitmaps no so suavizados. Adequado para filmes que no contm
texto.

Exemplo

O exemplo a seguir define a qualidade como LOW:

textfield._quality = "LOW";
Consulte tambm

_highquality, toggleHighQuality

Dicionrio ActionScript 438

TextField.removeListener
Disponibilidade

Flash Player 6.
Uso

Selection.removeListener(ouvinte)
Parmetros

O objeto que deixar de receber notificaes de foco.

ouvinte
Retorna

Se o ouvinte tiver sido removido com xito, o mtodo retornar um valor true. Se o ouvinte
no tiver sido removido com xito (por exemplo, se o ouvinte no estava na lista de ouvintes do
objeto TextField), o mtodo retornar o valor false.
Descrio

Mtodo; remove um objeto ouvinte anteriormente registrado para uma instncia de campo de
texto com addListener.

TextField.removeTextField
Disponibilidade

Flash Player 6.
Uso

TextField.removeTextField()
Descrio

Mtodo; remove o campo de texto especificado por TextField. Esta operao s pode ser
executada em um campo de texto que tenha sido criado com o mtodo createTextField do
objeto MovieClip. Ela no funcionar em campos de texto inseridos pela Linha de tempo.
Quando este mtodo chamado, o campo de texto instrudo a se remover. semelhante ao
mtodo MovieClip.removeMovieClip.
Consulte tambm

MovieClip.createTextField

TextField.replaceSel
Disponibilidade

Flash Player 6.
Uso

TextField.replaceSel(texto)
Parmetros

texto
Retorna

Nada.

439

Uma seqncia de caracteres.

Descrio

Mtodo; substitui a seleo atual pelo contedo do parmetro texto. O texto inserido na
posio da seleo atual, usando o formato de caracteres padro atual e o formato de pargrafo
padro. O texto no tratado como HTML, mesmo que o campo de texto seja HTML.
possvel usar o mtodo replaceSel para inserir e excluir textos sem interromper a formatao
de caractere e pargrafo do resto do texto.

TextField.restrict
Disponibilidade

Flash Player 6.
Uso

TextField.restrict
Descrio

Propriedade; indica o conjunto de caracteres que um usurio pode digitar no campo de texto. Se o
valor da propriedade restrict for null, ser possvel digitar qualquer caractere. Se o valor da
propriedade restrict for uma seqncia de caracteres vazia, no ser possvel digitar nenhum
caractere. Se o valor da propriedade restrict for uma seqncia de caracteres, s ser possvel
digitar os caracteres da seqncia no campo de texto. A seqncia de caracteres rastreada da
esquerda para a direita. possvel especificar um intervalo usando o trao (-). Isso restringe apenas
a interao com o usurio; um script pode colocar qualquer texto no campo de texto. Esta
propriedade no sincronizada com as caixas de seleo Incorporar contornos de fonte no
Inspetor de propriedades.
Se a seqncia de caracteres comear com ^, todos os caracteres sero aceitos inicialmente e os
caracteres sucessores na seqncia sero excludos do conjunto de caracteres aceitos. Se a seqncia
de caracteres no comear com ^, nenhum caractere ser aceito inicialmente e os caracteres
sucessores na seqncia sero includos no conjunto de caracteres aceitos.
Exemplo

O exemplo a seguir s permite que sejam digitados caracteres em maisculas, espaos e nmeros
em um campo de texto:
my_txt.restrict = "A-Z 0-9";

O exemplo a seguir inclui todos os caracteres, mas exclui letras minsculas:

my_txt.restrict = "^a-z";

possvel usar uma barra invertida para digitar um ^ ou - literalmente. As seqncias de barra
invertida aceitas so \-, \^ ou \\. A barra invertida deve ser um caractere real na seqncia de
caracteres para que, quando especificada no ActionScript, seja usada uma barra invertida dupla.
Por exemplo, o cdigo a seguir inclui somente o trao (-) e o circunflexo (^).
my_txt.restrict = "\\-\\^";

O ^ pode ser usado em qualquer parte da seqncia de caracteres para alternar entre caracteres
includos e caracteres excludos. O cdigo a seguir contm somente letras maisculas, mas exclui a
letra maiscula Q.
my_txt.restrict = "A-Z^Q";

possvel usar a seqncia de escape \u para construir seqncias de caracteres restrict. O

cdigo a seguir contm somente os caracteres de ASCII 32 (espao) a ASCII 126 (til).
my_txt.restrict = "\u0020-\u007E";

Dicionrio ActionScript 440

TextField._rotation
Disponibilidade

Flash Player 6.
Uso

TextField._rotation
Descrio

Propriedade; especifica a rotao do campo de texto em graus.

TextField.scroll
Disponibilidade

Flash Player 6.
Uso

TextField.scroll
Descrio

Propriedade; define a posio vertical do texto em um campo de texto. A propriedade scroll

til para direcionar os usurios para um pargrafo em especfico em um trecho longo, ou para
criar campos de texto de rolagem. Essa propriedade pode ser recuperada e modificada.
Exemplo

O cdigo a seguir anexado a um boto Para cima que rola pelo campo de texto myText.
on (release) {
myText.scroll = myText.scroll + 1;
}
Consulte tambm

TextField.maxscroll, TextField.scroll

TextField.selectable
Disponibilidade

Flash Player 6.
Uso

TextField.selectable
Descrio

Propriedade; um valor booleano que indica se o campo de texto pode ser selecionado. O valor
true indica que o texto pode ser selecionado.

441

TextField.setNewTextFormat
Disponibilidade

Flash Player 6.
Uso

TextField.setNewTextFormat(textFormat)
Parmetros

textFormat

Uma instncia do objeto TextFormat.

Retorna

Nada.
Descrio

Mtodo; define um objeto TextFormat para o texto recm-inserido, como o texto inserido com o
mtodo replaceSel ou o texto digitado por um usurio em um campo de texto. Cada campo de
texto tem um novo formato de texto. Quando o texto inserido, o novo formato de texto
atribudo ao novo texto.
O formato de texto definido em uma nova instncia do objeto TextFormat. Ele contm
informaes de formatao de caractere e pargrafo. As informaes sobre formatao de caractere
descrevem a aparncia de caracteres individuais. Por exemplo: o nome da fonte, o tamanho do
ponto, a cor e a URL associada. As informaes sobre formatao de pargrafo descrevem a
aparncia de um pargrafo. Por exemplo: margem esquerda, margem direita, recuo da primeira
linha e alinhamento esquerdo, direito e centralizado.
Consulte tambm

TextField.getNewTextFormat, TextField.getTextFormat, TextField.setTextFormat

TextField.setTextFormat
Disponibilidade

Flash Player 6.
Uso

TextField.setTextFormat (textFormat)
TextField.setTextFormat (ndice, textFormat)
TextField.setTextFormat (incio_ndice, fim_ndice, textFormat)
Parmetros

incio_ndice
fim_ndice

Um inteiro.

Um inteiro que especifica o primeiro caractere aps o intervalo de texto desejado.

textFormat Uma instncia do objeto TextFormat. Um objeto TextFormat que contm

informaes de formatao de caractere e pargrafo.
Retorna

Nada.

Dicionrio ActionScript 442

Descrio

Mtodo; define um objeto de formato de texto para um intervalo especificado de texto em um

campo de texto. possvel atribuir um formato de texto a cada caractere de um campo de texto. O
formato de texto do primeiro caractere de um pargrafo examinado para realizar formatao de
pargrafo para todo o pargrafo. O mtodo setTextFormat altera o formato de texto aplicado a
caracteres isoladamente, a grupos de caracteres ou a todo o corpo de texto em um campo de texto.
O formato de texto definido em uma nova instncia do objeto TextFormat. Ele contm
informaes de formatao de caractere e pargrafo. As informaes de formatao de caractere
descrevem a aparncia dos caracteres. Por exemplo: o nome da fonte, o tamanho do ponto, a cor e
a URL associada. As informaes de formatao de pargrafo descrevem a aparncia de um
pargrafo. Por exemplo: margem esquerda, margem direita, recuo da primeira linha e alinhamento
esquerdo, direito e centralizado.
Uso 1: aplica as propriedades de textFormat a todo o texto no campo de texto.
Uso 2: aplica as propriedades de textFormat ao caractere na posio ndice.
Uso 3: aplica as propriedades do parmetro textFormat ao intervalo de texto do parmetro
ao parmetro fim_ndice.

incio_ndice
Exemplo

Este exemplo cria um novo objeto TextFormat chamado myTextFormat e define sua propriedade
bold como true. Em seguida, chama o mtodo setTextFormat e aplica o novo formato de texto
ao campo de texto myTextField.
myTextFormat = new TextFormat();
myTextFormat.bold = true;
myTextField.setTextFormat(myTextFormat);
Consulte tambm

TextFormat (objeto)

TextField._soundbuftime
Disponibilidade

Flash Player 6.
Uso

TextField._soundbuftime
Descrio

Propriedade (global); um inteiro que especifica o nmero de segundos em que um som

armazenado em pr-buffer antes de comear a fluir.

443

TextField.tabEnabled
Disponibilidade

Flash Player 6.
Uso

TextField.tabEnabled
Descrio

Propriedade; pode ser definida em uma instncia dos objetos MovieClip, Button ou TextField.
Por padro, no definido.
Se a propriedade tabEnabled for undefined ou tiver um valor true, o objeto ser includo na
ordenao de tabulao automtica, e ser includo na ordenao de tabulao personalizada se a
propriedade tabIndex tambm for definida como um valor. Se tabEnabled for false, o objeto
no ser includo na ordenao automtica de guias. No caso de um clipe de filme, se tabEnabled
for false, os filhos do clipe de filme ainda podero ser includos na ordenao automtica de
guias, a menos que a propriedade tabChildren tambm seja definida como false.
Se tabEnabled for undefined ou true, o objeto ser includo na ordenao de tabulao
personalizada se a propriedade tabIndex for definida. Se tabEnabled for false, ento o objeto
no ser includo na ordenao de guia personalizada, ainda que a propriedade tabIndex seja
definida. Se tabEnabled for definido como false em um clipe de filme, os filhos do clipe de
filme ainda podero ser includos na ordenao de tabulao personalizada.

TextField.tabIndex
Disponibilidade

Flash Player 6.
Uso

TextField.tabIndex
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Propriedade; permite personalizar a ordenao de guias dos objetos em um filme. possvel

definir a propriedade tabIndex em um boto, clipe de filme ou instncia de campo de texto. Por
padro, ela undefined.
Se algum objeto sendo exibido atualmente no filme do Flash tiver uma propriedade tabIndex, a
ordenao de guia automtica ser desativada e a ordenao de guia ser calculada nas
propriedades tabIndex de objetos do filme. A ordenao personalizada de guias inclui apenas os
objetos que tm propriedades tabIndex.
A propriedade tabIndex deve ser um inteiro positivo. Os objetos so ordenados de acordo com
suas propriedades tabIndex, em ordem ascendente. Um objeto com um tabIndex 1 vem antes
de um objeto com tabIndex 2. Se dois objetos tiverem o mesmo valor tabIndex, aquele que
preceder o outro na ordenao de tabulao ser undefined.

Dicionrio ActionScript 444

A ordenao de tabulao personalizada definida pela propriedade tabIndex simples. Isso significa
que as relaes hierrquicas de objetos so ignoradas no filme do Flash. Todos os objetos no filme do
Flash com propriedades tabIndex so colocados na ordem de guia. Por sua vez, essa determinada
pela ordem dos valores de tabIndex. Se dois objetos tiverem o mesmo valor tabIndex, o primeiro
ser undefined. Voc no deve usar o mesmo valor de tabIndex para vrios objetos.

TextField._target
Disponibilidade

Flash Player 6.
Uso

TextField._target
Descrio

Propriedade (somente leitura); retorna o caminho de destino da instncia de campo de texto

especificada no parmetro TextField.

TextField.text
Disponibilidade

Flash Player 6.
Uso

TextField.text
Descrio

Propriedade; indica o texto atual no campo de texto. As linhas so separadas pelo caractere de
retorno de carro ('\r', ASCII 13). Esta propriedade contm o texto normal no formatado no
campo de texto, sem marcas HTML, mesmo que o campo de texto seja HTML.
Consulte tambm

TextField.htmlText

TextField.textColor
Disponibilidade

Flash Player 6.
Uso

TextField.textColor
Descrio

Propriedade; indica a cor do texto em um campo de texto.

TextField.textHeight
Disponibilidade

Flash Player 6.
Uso

TextField.textHeight
Descrio

Propriedade; indica a altura do texto.

445

TextField.textWidth
Disponibilidade

Flash Player 6.
Uso

TextField.textWidth
Descrio

Propriedade; indica a largura do texto.

TextField.type
Disponibilidade

Flash Player 6.
Uso

TextField.type
Descrio

Propriedade; especifica o tipo de campo de texto. H dois valores: "dynamic", que especifica um
campo de texto dinmico (no pode ser editado pelo usurio) e "input", que especifica um
campo de texto de entrada.
Exemplo

TextField.type = "dynamic";

TextField._url
Disponibilidade

Flash Player 6.
Uso

TextField._url
Descrio

Propriedade (somente leitura); recupera a URL do arquivo SWF que criou o campo de texto.

TextField.variable
Disponibilidade

Flash Player 6.
Uso

TextField._variable
Descrio

Propriedade; o nome da varivel qual o campo de texto est associado. O tipo dessa propriedade
String.

Dicionrio ActionScript 446

TextField._visible
Disponibilidade

Flash Player 6.
Uso

TextField._visible
Descrio

Propriedade; um valor booleano que indica se o campo de texto especificado pelo parmetro
TextField visvel. Os campos de texto que no so visveis (propriedade _visible definida
como false) so desativados.

TextField._width
Disponibilidade

Flash Player 6.
Uso

TextField._width
Descrio

Propriedade; define e recupera a largura do campo de texto, em pixels.

Exemplo

O exemplo a seguir define as propriedades de altura e largura de um campo de texto:

myTextField._width=200;
myTextField._height=200;
Consulte tambm

MovieClip._height

TextField.wordWrap
Disponibilidade

Flash Player 6.
Uso

TextField.wordWrap
Descrio

Propriedade; um valor booleano que indica se o campo de texto tem quebra automtica de linha.
Se o valor de wordWrap for true, o campo de texto ter quebra automtica de linha; se o valor for
false, o campo de texto no ter quebra automtica de linha.

447

TextField._x
Disponibilidade

Flash Player 6.
Uso

TextField._x
Descrio

Propriedade; um inteiro que define a coordenada x de um campo de texto em relao s

coordenadas locais do clipe de filme pai. Se um campo de texto estiver na Linha de tempo
principal, seu sistema de coordenadas ser referente ao canto superior esquerdo do Palco como (0,
0). Se o campo de texto estiver dentro de um clipe de filme que tenha transformaes, o campo de
texto estar no sistema de coordenadas local do clipe de filme anexado. Assim, para um clipe de
filme girado 90 no sentido anti-horrio, o campo de texto anexado herda um sistema de
coordenadas que girado 90 no sentido anti-horrio. As coordenadas do campo de texto
referem-se posio do ponto de registro.
Consulte tambm

TextField._xscale, TextField._y, TextField._yscale

TextField._xmouse
Disponibilidade

Flash Player 6.
Uso

TextField._xmouse
Descrio

Propriedade (somente leitura); retorna a coordenada x da posio do mouse relativa ao campo de

texto.
Consulte tambm

TextField._ymouse

TextField._xscale
Disponibilidade

Flash Player 6.
Uso

TextField._xscale
Descrio

Propriedade; determina a escala horizontal (porcentagem) do campo de texto como aplicado no

ponto de registro do campo de texto. O ponto de registro padro (0,0).
Consulte tambm

TextField._x, TextField._y, TextField._yscale

Dicionrio ActionScript 448

TextField._y
Disponibilidade

Flash Player 6.
Uso

TextField._y
Descrio

Propriedade; define a coordenada y de um campo de texto relativa s coordenadas locais do clipe de

filme pai. Se um campo de texto estiver na Linha de tempo principal, seu sistema de coordenadas
ser referente ao canto superior esquerdo do Palco como (0, 0). Se o campo de texto estiver dentro
de outro clipe de filme que tenha transformaes, o campo de texto estar no sistema de
coordenadas local do clipe de filme anexado. Assim, para um clipe de filme girado 90 no sentido
anti-horrio, o campo de texto anexado herda um sistema de coordenadas que girado 90 no
sentido anti-horrio. As coordenadas do campo de texto referem-se posio do ponto de registro.
Consulte tambm

TextField._x, TextField._xscale, TextField._yscale

TextField._ymouse
Disponibilidade

Flash Player 6.
Uso

TextField._ymouse
Descrio

Propriedade (somente leitura); indica a coordenada y da posio do mouse relativa ao campo de

texto.
Consulte tambm

TextField._xmouse

TextField._yscale
Disponibilidade

Flash Player 6.
Uso

TextField._yscale
Descrio

Propriedade; define a escala vertical (porcentagem) do campo de texto conforme aplicado no

ponto de registro do campo de texto. O ponto de registro padro (0,0).
Consulte tambm

TextField._x, TextField._xscale, TextField._y

449

TextFormat (objeto)
O objeto TextFormat representa informaes de formatao de caractere.
Use o construtor new TextFormat para criar uma instncia do objeto TextFormat antes de
chamar seus mtodos.
possvel definir parmetros TextFormat como null para indicar que eles so indefinidos.
Quando um objeto TextFormat aplicado a um campo de texto usando o mtodo
setTextFormat, apenas as propriedades definidas so aplicadas, como no seguinte exemplo:
myTextFormat = new TextFormat();
myTextFormat.bold = true;
myTextField.setTextFormat(myTextFormat);

Este cdigo cria primeiro um objeto TextFormat vazio com todas as suas propriedades
indefinidas; em seguida, define a propriedade bold como um valor definido.
O cdigo myTextField.setTextFormat(myTextFormat) s altera a propriedade bold do
formato de texto padro do campo de texto, pois a propriedade bold a nica definida em
myTextFormat. Todos os outros aspectos do formato de texto padro do campo de texto
permanecem inalterados.
Quando getTextFormat chamado, um objeto TextFormat retornado com todas as
propriedades definidas; nenhuma propriedade null.
Resumo de mtodos do objeto TextFormat
Mtodo

Descrio

TextFormat.getTextExtent

Retorna um objeto com duas propriedades, width e height, que indicam o

tamanho de um texto em um campo de texto.

Resumo das propriedades do objeto TextFormat

Propriedade

Descrio

TextFormat.align

Indica o alinhamento de um pargrafo.

TextFormat.blockIndent

Indica o recuo de bloco em pontos.

TextFormat.bold

Indica se o texto est em negrito.

TextFormat.bullet

Indica se o texto est ou no em uma lista com marcadores.

TextFormat.color

Indica a cor do texto.

TextFormat.font

Indica o nome da fonte do texto com um formato de texto.

TextFormat.indent

Indica o recuo da margem esquerda ao primeiro caractere no pargrafo.

TextFormat.italic

Indica se o texto est em itlico.

TextFormat.leading

Indica a quantidade de espao vertical entre as linhas.

TextFormat.leftMargin

Indica a margem esquerda do pargrafo, em pontos.

TextFormat.rightMargin

Indica a margem direita do pargrafo, em pontos.

TextFormat.tabStops

Especifica interrupes de tabulao personalizadas.

TextFormat.target

Indica a janela em um navegador na qual um hiperlink exibido.

TextFormat.size

Indica o tamanho do ponto do texto.

TextFormat.underline

Indica se o texto est sublinhado.

TextFormat.url

Indica o URL ao qual o texto est vinculado.

Dicionrio ActionScript 450

Construtor do objeto TextFormat

Uso

new TextFormat([fonte, [tamanho, [cor, [negrito, [itlico, [sublinhado, [url,

[destino, [alinhamento, [margem_Esquerda, [margem_Direita, [recuo,
[entrelinhamento]]]]]]]]]]]]])
Parmetros

fonte

O nome de uma fonte de texto como uma seqncia de caracteres.

Um inteiro que indica o tamanho do ponto.

tamanho

cor A cor do texto que usa esse formato de texto. Um nmero que contm trs componentes
RGB de 8 bits; por exemplo, 0xFF0000 vermelho, 0x00FF00 verde.
negrito

Um valor Booleano que indica se o texto est em negrito.

itlico

Um valor Booleano que indica se o texto est em itlico.

sublinhado

Um valor Booleano que indica se o texto est sublinhado.

O URL ao qual o texto neste formato de texto se vincula por hiperlink. Se url for uma
seqncia de caracteres vazia, o texto no ter um hiperlink.

url

destino A janela de destino em que o hiperlink exibido. Se a janela de destino for uma
seqncia de caracteres vazia, o texto ser exibido na janela de destino padro _self. Se a
propriedade TextFormat.url for definida como uma seqncia de caracteres vazia ou como o
valor null, ela poder ser obtida ou definida, mas no ter efeito.
alinhamento O alinhamento do pargrafo, representado como uma seqncia de caracteres. Se
for "left", o pargrafo ser alinhado esquerda. Se for "center", o pargrafo ser centralizado.
Se for "right", o pargrafo ser alinhado direita.
margem_Esquerda
margem_Direita
recuo

Indica a margem esquerda do pargrafo, em pontos.

Indica a margem direita do pargrafo, em pontos.

Um inteiro que indica o recuo da margem esquerda ao primeiro caractere no pargrafo.

entrelinhamento

Um nmero que indica a quantidade de espao vertical entre as linhas.

Descrio

Construtor; cria uma instncia do objeto TextFormat com as propriedades especificadas. Permite
alterar as propriedades do objeto TextFormat para alterar a formatao de campos de texto.
possvel definir qualquer parmetro como o valor null para indicar que no est definido.
Todos os parmetros so opcionais; qualquer parmetro omitido tratado como null.
Disponibilidade

Flash Player 6.

451

TextFormat.align
Disponibilidade

Flash Player 6.
Uso

TextFormat.align
Descrio

Propriedade; indica o alinhamento do pargrafo, representado como uma seqncia de caracteres.

O alinhamento do pargrafo, representado como uma seqncia de caracteres. Se for "left", o
pargrafo ser alinhado esquerda. Se for "center", o pargrafo ser centralizado. Se for
"right", o pargrafo ser alinhado direita. O valor padro null, o que indica que a
propriedade indefinida.

TextFormat.blockIndent
Disponibilidade

Flash Player 6.
Uso

TextFormat.blockIndent
Descrio

Propriedade; um nmero que indica o recuo de bloco em pontos. O recuo de bloco aplicado a
um bloco de texto inteiro; ou seja, a todas as linhas do texto. Por outro lado, o recuo normal
(TextFormat.indent) s afeta a primeira linha de cada pargrafo. Se esta propriedade for null, o
objeto TextFormat no especificar um recuo de bloco.

TextFormat.bold
Disponibilidade

Flash Player 6.
Uso

TextFormat.bold
Descrio

Propriedade; um valor Booleano que indica se o texto est em negrito. O valor padro null, o
que indica que a propriedade indefinida.

TextFormat.bullet
Disponibilidade

Flash Player 6.
Uso

TextFormat.bullet
Descrio

Propriedade; um valor booleano que indica que o texto parte de uma lista com marcadores. Em
uma lista com marcadores, cada pargrafo de texto recuado. esquerda da primeira linha de
cada pargrafo, exibido um smbolo de marcador. Se esta propriedade for null, o objeto
TextFormat no especificar que o texto tenha ou no marcadores.

Dicionrio ActionScript 452

TextFormat.color
Disponibilidade

Flash Player 6.
Uso

TextFormat.color
Descrio

Propriedade; indica a cor do texto. Um nmero que contm trs componentes RGB de 8 bits; por
exemplo, 0xFF0000 vermelho, 0x00FF00 verde.

TextFormat.font
Disponibilidade

Flash Player 6.
Uso

TextFormat.font
Descrio

Propriedade; o nome da fonte do texto nesse formato, como uma seqncia de caracteres. O valor
padro null, o que indica que a propriedade indefinida.

TextFormat.getTextExtent
Disponibilidade

Flash Player 6.
Uso

TextFormat.getTextExtent (texto)
Parmetros

texto

Uma seqncia de caracteres.

Retorna

Um objeto com as propriedades width e height.

Descrio

Mtodo; retorna o tamanho da seqncia de caracteres de texto especificada no parmetro texto

nesse formato de caractere. O valor retornado um objeto da classe Object com duas
propriedades, width e height. O texto tratado como texto regular (no HTML). O texto
uma nica linha de texto; os retornos de carro e alimentaes de linha so ignorados e nenhuma
quebra automtica de linha aplicada.

453

TextFormat.indent
Disponibilidade

Flash Player 6.
Uso

TextFormat.indent
Descrio

Propriedade; um inteiro que indica o recuo da margem esquerda ao primeiro caractere no

pargrafo. O valor padro null, o que indica que a propriedade indefinida.

TextFormat.italic
Disponibilidade

Flash Player 6.
Uso

TextFormat.italic
Descrio

Propriedade; um valor booleano que indica se o texto nesse formato est em itlico. O valor
padro null, o que indica que a propriedade indefinida.

TextFormat.leading
Disponibilidade

Flash Player 6.
Uso

TextFormat.leading
Descrio

Propriedade; a quantidade de espao vertical entre as linhas. O valor padro null, o que indica
que a propriedade indefinida.

TextFormat.leftMargin
Disponibilidade

Flash Player 6.
Uso

TextFormat.leftMargin
Descrio

Propriedade; a margem esquerda do pargrafo, em pontos. O valor padro null, o que indica
que a propriedade indefinida.

Dicionrio ActionScript 454

TextFormat.rightMargin
Disponibilidade

Flash Player 6.
Uso

TextFormat.rightMargin
Descrio

Propriedade; a margem direita do pargrafo, em pontos. O valor padro null, o que indica que
a propriedade indefinida.

TextFormat.size
Disponibilidade

Flash Player 6.
Uso

TextFormat.size
Descrio

Propriedade; o tamanho do ponto do texto nesse formato. O valor padro null, o que indica
que a propriedade indefinida.

TextFormat.tabStops
Disponibilidade

Flash Player 6.
Uso

TextFormat.tabStops
Descrio

Propriedade; especifica interrupes de tabulao personalizadas como uma Matriz de inteiros

no negativos. Cada interrupo de tabulao especificada em pontos. Se as interrupes de
tabulao personalizadas no forem especificadas (null), a interrupo de tabulao padro ser 4
(largura mdia de caractere).

TextFormat.target
Disponibilidade

Flash Player 6.
Uso

TextFormat.target
Descrio

Propriedade; indica a janela de destino em que o hiperlink exibido. Se a janela de destino for
uma seqncia de caracteres vazia, o texto ser exibido na janela de destino padro _self. Se a
propriedade TextFormat.url for definida como uma seqncia de caracteres vazia ou como o
valor null, ela poder ser obtida ou definida, mas no ter efeito.

455

TextFormat.underline
Disponibilidade

Flash Player 6.
Uso

TextFormat.underline
Descrio

Propriedade; um valor Booleano que indica se o texto que usa este TextFormat est sublinhado. Se
underline estiver definido como true, o texto nesse formato estar sublinhado. Se estiver
definido como false, o texto nesse formato no estar sublinhado. Note que este o mesmo
sublinhado obtido pela marca <U>, que no o sublinhado "verdadeiro", pois no ignora os
descendentes corretamente. O valor padro null, o que indica que a propriedade indefinida.

TextFormat.url
Disponibilidade

Flash Player 6.
Uso

TextFormat.url
Descrio

Propriedade; indica a URL qual o texto nesse formato est vinculado. Se a propriedade url for
uma seqncia de caracteres vazia, o texto no ter um hiperlink. O valor padro null, o que
indica que a propriedade indefinida.

this
Disponibilidade

Flash Player 5.
Uso

this
Descrio

Palavra-chave; faz referncia a uma instncia de objeto ou de clipe de filme. Quando um script
executado, this faz referncia instncia do clipe de filme que contm o script. Quando um
mtodo chamado, this contm uma referncia ao objeto que contm o mtodo chamado.
Dentro de uma ao identificadora de eventos on anexada a um boto, this refere-se Linha de
tempo que contm o boto. Dentro de uma ao identificadora de eventos onClipEvent anexada
a um clipe de filme, this refere-se Linha de tempo do prprio clipe de filme.
Exemplo

No exemplo a seguir, a palavra-chave this faz referncia ao objeto Circle.

function Circle(radius) {
this.radius = radius;
this.area = Math.PI * radius * radius;
}

Dicionrio ActionScript 456

No comando a seguir atribudo a um quadro, a palavra-chave this faz referncia ao clipe de filme
atual.
// define a propriedade alpha do clipe de filme atual como 20
star._alpha = 20;

No comando a seguir em um manipulador onClipEvent, a palavra-chave this faz referncia ao

clipe de filme atual.
// quando o clipe de filme carregado, uma operao startDrag
// iniciada para o clipe de filme atual.
onClipEvent (load) {
startDrag (this, true);
}
Consulte tambm

new

toggleHighQuality
Disponibilidade

Flash 2.
Uso

toggleHighQuality()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Ao; ativa e desativa o modo sem serrilhado no Flash Player. O modo sem serrilhado suaviza as
bordas dos objetos e reduz a reproduo do filme. A ao toggleHighQuality afeta todos os
filmes no Flash Player.
Exemplo

O cdigo a seguir pode ser aplicado a um boto que, quando clicado, ative e desative o modo sem
serrilhado.
on(release) {
toggleHighQuality();
}
Consulte tambm

_quality, _highquality

457

trace
Disponibilidade

Flash Player 4.
Uso

trace(expresso)
Parmetros

Uma expresso a ser avaliada. Quando um arquivo SWF aberto na ferramenta de

criao Flash (atravs do comando Testar filme), o valor do parmetro expresso exibido na
janela Sada.

expresso

Retorna

Nada.
Descrio

Ao; avalia a expresso e exibe os resultados na janela Sada no modo de teste.

Use trace para registrar notas de programao ou para exibir mensagens na janela Sada
enquanto testa um filme. Use o parmetro expresso para verificar se uma condio existe ou
para exibir valores na janela Sada. A ao trace semelhante funo alert no JavaScript.
possvel usar o comando Omitir aes de traagem em Configuraes de publicao para
remover aes trace do arquivo SWF exportado.
Exemplo

Este exemplo de um jogo no qual uma instncia de clipe de filme arrastvel chamada rabbi
deve ser liberada em um destino especfico. Um comando adicional avalia a propriedade
_droptarget e executa diferentes aes dependendo do local onde rabbi liberado. A ao
trace usada no fim do script para avaliar o local do clipe de filme rabbi e exibe o resultado na
janela Sada. Se rabbi no se comportar como esperado (por exemplo, se ele se encaixar no
destino errado), os valores enviados para a janela Sada pela ao trace ajudaro a determinar o
problema no 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();
}

Dicionrio ActionScript 458

true
Disponibilidade

Flash Player 5.
Uso

true
Descrio

Um valor booleano exclusivo que representa o oposto de false.

Consulte tambm

false

typeof
Disponibilidade

Flash Player 5.
Uso

typeof expresso
Parmetros

expresso

Seqncia de caracteres, clipe de filme, boto, objeto ou funo.

Descrio

Operador; um operador unrio colocado antes de um nico parmetro. O operador typeof faz
com que o interpretador Flash avalie expresso; o resultado uma seqncia de caracteres que
especifica se a expresso uma seqncia de caracteres, um clipe de filme, um objeto ou uma
funo. A tabela a seguir mostra os resultados do operador typeof em cada tipo de expresso:

459

Parmetro

Sada

String

seqncia de caracteres

MovieClip

movieclip

Button

objeto

Campo de texto

objeto

Number

number

Booleano

boolean

Objeto

objeto

Funo

function

undefined
Disponibilidade

Flash Player 5.
Uso

undefined
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Um valor especial, geralmente usado para indicar que um valor ainda no foi atribudo a uma
varivel. Uma referncia a um valor indefinido retorna o valor especial undefined. O cdigo do
ActionScript typeof(undefined) retorna a seqncia de caracteres "undefined". O nico valor
do tipo undefined undefined.
Quando undefined convertido em uma seqncia de caracteres, ele convertido na seqncia
vazia.
O valor undefined semelhante ao valor especial null. De fato, quando null e undefined so
comparados ao operador de igualdade, eles so comparados como iguais.
Exemplo

Neste exemplo, a varivel x no foi declarada e, portanto, tem o valor undefined. Na primeira
seo de cdigo, o operador de igualdade (==) compara o valor x ao valor undefined e o resultado
apropriado enviado janela Sada. Na segunda seo de cdigo, o operador de igualdade
compara os valores null e undefined.
// x no foi declarado
trace ("The value of x is " + x);
if (x == undefined) {
trace ("x is undefined");
else {
trace ("x is not undefined");
}
trace ("typeof (x) is " + typeof (x));
if (null == undefined) {
trace ("null and undefined are equal");
else {
trace ("null and undefined are not equal");
}

O seguinte resultado exibido na janela Sada:

The value of x is x is undefined
typeof (x) is undefined
null and undefined are equal
Observao: Na especificao ECMA-262, undefined convertido na seqncia de caracteres undefined, e
no na seqncia de caracteres vazia. Esta uma diferena entre o ActionScript e a especificao ECMA-262.

Dicionrio ActionScript 460

unescape
Disponibilidade

Flash Player 5.
Uso

unescape(x)
Parmetros

Uma seqncia de caracteres com seqncias hexadecimais de escape.

Retorna

Nada.
Descrio

Funo de alto nvel; avalia o parmetro x como uma seqncia de caracteres, decodifica a
seqncia de caracteres de um formato de codificao URL (convertendo todas as seqncias
hexadecimais em caracteres ASCII) e retorna a seqncia de caracteres.
Exemplo

O exemplo a seguir ilustra o processo de converso de escape em unescape.

escape("Hello{[World]}");

O resultado de escape o seguinte:

("Hello%7B%5BWorld%5D%7D);

Use unescape para retornar ao formato original:

unescape("Hello%7B%5BWorld%5D%7D")

O resultado o seguinte:
Hello{[World]}

unloadMovie
Disponibilidade

Flash Player 3.
Uso

unloadMovie[Num](nvel/"destino")
Parmetros

O nvel (_levelN) de um filme carregado. Quando um filme descarregado de um nvel,

a ao unloadMovie no painel Aes no modo Normal muda para unloadMovieNum; no modo
Especialista, necessrio especificar unloadMovieNum ou escolh-lo na caixa de ferramentas Aes.
nvel

destino

O caminho de destino de um clipe de filme.

Retorna

Nenhum.
Descrio

Ao; remove um filme carregado ou um clipe de filme do Flash Player. Para descarregar um filme
que tenha sido carregado em um nvel do Flash Player, use o parmetro nvel. Para descarregar
um clipe de filme carregado, use o parmetro destino.

461

Exemplo

O exemplo a seguir descarrega o clipe de filme draggable na Linha de tempo principal e carrega
o filme movie.swf no nvel 4.
on (press) {
unloadMovie ("_root.draggable");
loadMovieNum ("movie.swf", 4);
}

O exemplo a seguir descarrega o filme carregado no nvel 4:

on (press) {
unloadMovieNum (4);
}
Consulte tambm

loadMovie, loadMovieNum, unloadMovieNum

unloadMovieNum
Disponibilidade

Flash Player 3.
Uso

unloadMovieNum(nvel)
Parmetros

nvel

O nvel (_levelN) de um filme carregado.

Retorna

Nada.
Descrio

Ao; remove um filme carregado do Flash Player.

Consulte tambm

loadMovie, loadMovieNum

updateAfterEvent
Disponibilidade

Flash Player 5.
Uso

updateAfterEvent()
Parmetros

Nenhum.
Retorna

Nada.

Dicionrio ActionScript 462

Descrio

Ao; atualiza a exibio (independentemente dos quadros por segundo definidos para o filme)
quando chamada dentro de um identificador onClipEvent ou como parte de uma funo ou
mtodo passado para setInterval. O Flash ignora as chamadas para updateAfterEvent que
no estejam dentro de um identificador onClipEvent ou que no sejam parte de uma funo ou
mtodo passado para setInterval.
Consulte tambm

onClipEvent, setInterval

var
Disponibilidade

Flash Player 5.
Uso

var variableName1 [= valor1] [...,variableNameN [=valorN]]

Parmetros

variableName
valor

Um identificador.

O valor atribudo varivel.

Retorna

Nada.
Descrio

Ao; usado para declarar variveis locais. Se voc declarar variveis locais em uma funo, as
variveis so definidas para a funo e expiram no final da chamada de funo. Se as variveis no
so declaradas em um bloco ({}), mas a lista de aes foi executada com uma ao call, as
variveis so locais e expiram no final da lista atual. Se as variveis no so declaradas em um bloco
e a lista de aes atuais no foi executada com a ao call, as variveis no so locais.
Exemplo

Os exemplos a seguir usam a ao var para declarar e atribuir variveis:

var
var
var
var

x;
y = 1;
z = 3, w = 4;
s, t, u = z;

void
Disponibilidade

Flash Player 5.
Uso

void (expresso)
Descrio

Operador; um operador unrio que descarta o valor da expresso e retorna um valor indefinido.
O operador void geralmente usado em comparaes que usem o operador == para testar os
valores indefinidos.

463

while
Disponibilidade

Flash Player 4.
Uso

while(condio) {
comando(s);
}
Parmetros

A expresso que reavaliada sempre que a ao while executada. Se o comando for

avaliado como true, comando(s) ser executado.

condio

comando(s)

O cdigo que ser executado se a condio for avaliada como true.

Retorna

Nada.
Descrio

Ao; testa uma expresso e executa um comando ou srie de comandos repetidamente em um

loop, contanto que a expresso seja true.
Antes de o bloco de comando ser executado, a condio testada; se o teste retornar true, o
bloco de comando ser executado. Se a condio for false, o bloco de comando ser ignorado e o
primeiro comando aps o bloco de comando da ao while ser executado.
O loop normalmente usado para executar um ao enquanto uma varivel de contador for
menor do que um valor especificado. No final de cada loop, o contador incrementado at que o
valor especificado seja obtido. Nesse ponto, a condio no mais true e o loop termina.
O comando while executa a srie de etapas a seguir. Cada repetio das etapas de 1 a 4 chamada
de iterao do loop. A condio testada novamente no incio de cada iterao, como nas
seguintes etapas:
1

A expresso condio avaliada.

Se condio for avaliada como true ou como um valor conversvel ao valor Booleano true,
como um nmero diferente de zero, v para a etapa 3.
Caso contrrio, o comando while ser concludo e a execuo continuar no prximo
comando aps o loop while.

Execute o bloco de comando comando(s).

V para a etapa 1.

Dicionrio ActionScript 464

Exemplo

Este exemplo duplica cinco clipes de filme no Palco, todos com uma posio x e y geradas
aleatoriamente, propriedade xscale e yscale e _alpha para conseguirem um efeito difuso. A
varivel foo inicializada com o valor 0. O parmetro condio definido para que o loop
while seja executado cinco vezes ou enquanto o valor da varivel foo for menor que 5. Dentro do
loop while, um clipe de filme duplicado e setProperty usado para ajustar as vrias
propriedades do clipe de filme duplicado. O ltimo comando do loop incrementa foo para que,
quando o valor alcanar 5, o parmetro condio seja avaliado como false e o loop no seja
executado.
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++;
}
}
Consulte tambm

do while, continue, for, for..in

with
Disponibilidade

Flash Player 5.
Uso

with (objeto) {
comando(s);
}
Parmetros

objeto

Uma instncia de um objeto ou clipe de filme do ActionScript.

comando(s)

Uma ao ou grupo de aes entre chaves.

Retorna

Nada.
Descrio

Ao; permite especificar um objeto (como um clipe de filme) com o parmetro objeto e avaliar
expresses e aes dentro desse objeto com o parmetro comando(s). Isso evita que seja necessrio
escrever repetidamente o nome do objeto ou o caminho do objeto.
O parmetro objeto torna-se o contexto em que as propriedades, variveis e funes no parmetro
comando(s) so lidas. Por exemplo, se objeto for myArray e duas das propriedades especificadas
forem length e concat, essas propriedades sero lidas automaticamente como myArray.length e
myArray.concat. Em outro exemplo, se objeto for state.california, qualquer comando ou
ao dentro da ao with ser chamado de dentro do comando california.

465

Para localizar o valor de um identificador no parmetro comando(s), o ActionScript inicia no

comeo da cadeia do escopo especificado pelo objeto e procura pelo identificador em cada nvel
da cadeia do escopo, em uma ordem especfica.
A cadeia do escopo usada pela ao with para resolver identificadores comea com o primeiro
item na lista a seguir e continua at o ltimo item:

O objeto especificado no parmetro objeto na ao with mais interna.

O objeto especificado no parmetro objeto na ao with mais externa.
O objeto Activation. (um objeto temporrio que criado automaticamente quando uma
funo chamada e mantm as variveis locais chamadas na funo.)

O clipe de filme que contm o script sendo executado no momento.

O objeto Global (objetos internos como Math e String).
Para definir uma varivel dentro de uma ao with, a varivel deve ter sido declarada fora da ao
ou necessrio inserir o caminho completo para a Linha de tempo na qual a varivel deve
morar. Se for definida uma varivel em uma ao with sem ser declarada, a ao with procurar
pelo valor de acordo com a cadeia do escopo. Se a varivel no existir ainda, o novo valor ser
definido na Linha de tempo da qual a ao with foi chamada.
with

No Flash 5, a ao with substitui a ao tellTarget obsoleta. Voc encorajado a usar with em

vez de tellTarget, pois uma extenso do ActionScript padro do padro ECMA 262. A
principal diferena entre as aes with e tellTarget que with considera um clipe de filme ou
outro objeto como seu parmetro, enquanto tellTarget considera uma seqncia de caracteres
de caminho de destino que identifica um clipe de filme como seu parmetro e no pode ser usada
para especificar objetos.
Exemplo

O exemplo a seguir define as propriedades x e y da instncia someOtherMovieClip e instrui

someOtherMovieClip a ir para o quadro 3 e parar:
with (someOtherMovieClip) {
_x = 50;
_y = 100;
gotoAndStop(3);
}

O prximo trecho de cdigo mostra como escrever o cdigo anterior sem usar uma ao with.
someOtherMovieClip._x = 50;
someOtherMovieClip._y = 100;
someOtherMovieClip.gotoAndStop(3);

Tambm possvel escrever esse cdigo usando a ao tellTarget. Entretanto, se

someOtherMovieClip no fosse um clipe de filme, mas um objeto, no seria possvel usar a ao
with.
tellTarget ("someOtherMovieClip") {
_x = 50;
_y = 100;
gotoAndStop(3);
}

Dicionrio ActionScript 466

A ao with til para fornecer acesso a vrios itens simultaneamente em uma cadeia de escopo.
No exemplo a seguir, o objeto Math interno posicionado no incio da cadeia de escopo. Definir
Math como um objeto padro resolve os identificadores cos, sin e PI como Math.cos, Math.sin
e Math.PI, respectivamente. Os identificadores a, x, y e r no so mtodos ou propriedades do
objeto Math, mas como existem no escopo de ativao do objeto da funo polar, eles so
resolvidos como as variveis locais correspondentes.
function polar(r) {
var a, x, y;
with (Math) {
a = PI * r * r;
x = r * cos(PI);
y = r * sin(PI/2);
}
trace("area = " +a);
trace("x = " + x);
trace("y = " + y);
}

Voc pode utilizar aes with aninhadas para ter acesso a informaes em vrios escopos. No
exemplo a seguir, a instncia fresno e a instncia salinas so filhas da instncia california. O
cdigo define os valores _alpha de fresno e salinas sem alterar o valor _alpha de california.
with (california){
with (fresno){
_alpha = 20;
}
with (salinas){
_alpha = 40;
}
}
Consulte tambm

tellTarget

XML (objeto)
Use os mtodos e propriedades do objeto XML para carregar, analisar, enviar, montar e manipular
rvores de documento XML. No Flash MX, o objeto XML tornou-se um objeto nativo. Assim,
voc poder observar uma melhora radical no desempenho.
Voc deve usar o construtor new XML() para criar uma instncia do objeto XML antes de chamar
qualquer um de seus mtodos.
O Flash Player 5 e o Flash Player 6 oferecem suporte ao XML.
Resumo dos mtodos do objeto XML

467

Mtodo

Descrio

XML.appendChild

Anexa um n ao fim da lista filha do objeto especificado.

XML.cloneNode

Clona o n especificado e, opcionalmente, clona recursivamente todos os filhos.

XML.createElement

Cria um novo elemento XML.

XML.createTextNode

Cria um novo n de texto XML.

XML.getBytesLoaded

Retorna o nmero de bytes carregados do documento XML especificado.

XML.getBytesTotal

Retorna o tamanho do documento XML em bytes.

Mtodo

Descrio

XML.hasChildNodes

Retorna true se o n especificado tiver ns filhos; caso contrrio, retorna false.

XML.insertBefore

Insere um n na frente de um n existente na lista de filhos do n especificado.

XML.load

Carrega um documento (especificado pelo objeto XML) a partir de uma URL.

XML.parseXML

Analisa um documento XML na rvore de objeto XML especificada.

XML.removeNode

Remove o n especificado de seu pai.

XML.send

Envia o objeto XML especificado para uma URL.

XML.sendAndLoad

Envia o objeto XML especificado para uma URL e carrega a resposta do servidor em
outro objeto XML.

XML.toString

Converte o n especificado e todos os seus filhos em texto XML.

Resumo das propriedades do objeto XML

Propriedade

Descrio

XML.contentType

Indica o tipo de MIME transmitido para o servidor.

XML.docTypeDecl

Define e retorna informaes sobre a declarao DOCTYPE de um documento XML.

XML.firstChild

Faz referncia ao primeiro filho na lista do n especificado.

XML.ignoreWhite

Quando definida como true, os ns de texto que s contm espao em branco so

descartados durante o processo de anlise.

XML.lastChild

Faz referncia ao ltimo filho na lista do n especificado.

XML.load

Verifica se o objeto XML especificado foi carregado.

XML.nextSibling

Faz referncia ao prximo irmo na lista de filhos do n pai.

XML.nodeName

Retorna o nome da marca de um elemento XML.

XML.nodeType

Retorna o tipo do n especificado (elemento XML ou n de texto).

XML.nodeValue

Retorna o texto do n especificado se o n for um n de texto.

XML.parentNode

Faz referncia ao n pai do n especificado.

XML.previousSibling

Faz referncia ao irmo anterior na lista de filhos do n pai.

XML.status

Retorna um cdigo de status numrico que indica o xito ou a falha de uma operao
de anlise de um documento XML.

XML.xmlDecl

Define e retorna informaes sobre uma declarao de um documento XML.

Resumo de colees do objeto XML

Mtodo

Descrio

XML.attributes

Retorna um vetor associativo que contm todos os atributos do n especificado.

XML.childNodes

Retorna um vetor que contm referncias aos ns filhos do n especificado.

Resumo de identificadores de eventos do objeto XML

Mtodo

Descrio

XML.onData

Uma funo de retorno de chamada que chamada quando o download de um texto

XML foi totalmente feito do servidor, ou quando ocorre um erro ao fazer o download
de um texto XML de um servidor.

XML.onLoad

Uma funo de retorno de chamada para load e sendAndLoad.

Dicionrio ActionScript 468

Construtor do objeto XML

Disponibilidade

Flash Player 5.
Uso

new XML([origem])
Parmetros

origem

O texto XML analisado para criar o novo objeto XML.

Retorna

Nada.
Descrio

Construtor; cria um novo objeto XML. Voc deve usar o mtodo construtor para criar uma
instncia do objeto XML antes de chamar qualquer mtodo do objeto XML.
Observao: Os mtodos createElement e createTextNode so os mtodos do construtor para criar os
elementos e ns de texto em uma rvore de documentos XML.

Exemplo

Uso 1: o exemplo a seguir cria um novo objeto XML vazio.

myXML = new XML();

Uso 2: o exemplo a seguir cria um novo objeto XML analisando o texto XML especificado no
parmetro origem e preenche o objeto XML recm-criado com a rvore de documentos XML
resultante.
anyOtherXML = new XML("<state>California<city>san francisco</city></state>");
Consulte tambm

XML.createElement, XML.createTextNode

XML.appendChild
Disponibilidade

Flash Player 5.
Uso

myXML.appendChild(n_Filho)
Parmetros

n_Filho

O n filho a ser adicionado lista de filhos do objeto XML especificado.

Retorna

Nada.
Descrio

Mtodo; anexa o n filho especificado lista de filhos do objeto XML. O n filho anexado
colocado na estrutura depois de removido de seu n pai existente, se houver algum.

469

Exemplo

O exemplo a seguir clona o ltimo n do doc1 e o anexa ao doc2.

doc1 = new XML(src1);
doc2 = new XML();
node = doc1.lastChild.cloneNode(true);
doc2.appendChild(node);

XML.attributes
Disponibilidade

Flash Player 5.
Uso

myXML.attributes
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Coleo (leitura-gravao); retorna um vetor associativo que contm todos os atributos do objeto
XML especificado.
Exemplo

O exemplo a seguir grava os nomes dos atributos XML na janela Sada.

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);

A seguir est o que escrito janela Sada:

Val
first

XML.childNodes
Disponibilidade

Flash Player 5.
Uso

myXML.childNodes
Parmetros

Nenhum.
Retorna

Nada.

Dicionrio ActionScript 470

Descrio

Coleo (somente leitura); retorna um vetor dos filhos do objeto XML especificado. Cada
elemento no vetor uma referncia a um objeto XML que representa um n filho. Essa uma
propriedade somente leitura e no pode ser usada para manipular ns filhos. Use os mtodos
appendChild, insertBefore e removeNode para manipul-los.
Essa coleo no definida para os ns de texto (nodeType == 3).
Consulte tambm

XML.nodeType

XML.cloneNode
Disponibilidade

Flash Player 5.
Uso

myXML.cloneNode(profundidade)
Parmetros

Valor booleano que especifica se os filhos do objeto XML especificado so

clonados recursivamente.

profundidade

Retorna

Nada.
Descrio

Mtodo; cria e retorna um novo n XML do mesmo tipo, valor, nome e atributos do objeto XML
especificado. Se profundidade for definido como true, todos os ns filhos so clonados de
forma recursiva, resultando em uma cpia exata da rvore de documentos do objeto original.
O clone do n que retornado no mais associado rvore do item clonado.
Conseqentemente, nextSibling, parentNode e previousSibling tm um valor null. Se uma cpia
de clipe no for realizada, firstChild e lastChild tambm sero null.

XML.contentType
Disponibilidade

Flash Player 6.
Uso

myXML.contentType
Descrio

Propriedade; o tipo de MIME que enviado para o servidor quando o mtodo XML.send ou
XML.sendAndLoad chamado. O padro application/x-www-form-urlencoded.
Consulte tambm

XML.send, XML.sendAndLoad

471

XML.createElement
Disponibilidade

Flash Player 5.
Uso

myXML.createElement(nome)
Parmetros

nome

O nome da marca do elemento XML que est sendo criado.

Retorna

Nada.
Descrio

Mtodo; cria um novo elemento XML com o nome especificado no parmetro. O novo elemento
inicialmente no tem pai, filhos nem irmos. O mtodo retorna uma referncia ao objeto XML
criado recentemente que representa o elemento. Esse mtodo e createTextNode so os mtodos
construtores para criao de ns de um objeto XML.

XML.createTextNode
Disponibilidade

Flash Player 5.
Uso

myXML.createTextNode(texto)
Parmetros

texto

O texto usado para criar o novo n de texto.

Retorna

Nada.
Descrio

Mtodo; cria um novo n de texto XML com o texto especificado. Inicialmente, o novo n no
tem pai e os ns de texto no podem ter filhos nem irmos. Esse mtodo retorna uma referncia
ao objeto XML que representa o novo n de texto. Esse mtodo e o createElement so os
mtodos do construtor para criao de ns de um objeto XML.

Dicionrio ActionScript 472

XML.docTypeDecl
Disponibilidade

Flash Player 5.
Uso

myXML.XMLdocTypeDecl
Descrio

Propriedade; define e retorna informaes sobre a declarao DOCTYPE do documento XML. Aps
o texto XML ter sido analisado em um objeto XML, a propriedade XML.docTypeDecl do objeto
XML definida como o texto da declarao DOCTYPE do documento XML. Por exemplo,
<!DOCTYPE greeting SYSTEM "hello.dtd">. Esta propriedade definida usando uma
representao de seqncia de caracteres da declarao DOCTYPE, e no de um objeto do n XML.
O analisador XML do ActionScript no um analisador de validao. A declarao DOCTYPE
lida pelo analisador e armazenada na propriedade docTypeDecl, mas nenhuma validao DTD
executada.
Se nenhuma declarao DOCTYPE foi encontrada durante uma operao de anlise,
XML.docTypeDecl definido como indefinido. XML.toString mostra o contedo de
XML.docTypeDecl imediatamente depois da declarao XML armazenada em XML.xmlDecl, e
antes de qualquer outro texto no objeto XML. Se XML.docTypeDecl for indefinido, nenhuma
declarao DOCTYPE ser mostrada.
Exemplo

O exemplo a seguir usa XML.docTypeDecl para definir a declarao DOCTYPE de um objeto XML.
myXML.docTypeDecl = "<!DOCTYPE greeting SYSTEM \"hello.dtd\">";
Consulte tambm

XML.toString, XML.xmlDecl

XML.firstChild
Disponibilidade

Flash Player 5.
Uso

myXML.firstChild
Descrio

Propriedade (somente leitura); avalia o objeto XML especificado e faz referncia ao primeiro filho
na lista de filhos do n pai. Essa propriedade null se o n no tiver filhos. Essa propriedade
indefinida se o n for um n de texto. Essa uma propriedade somente leitura e no pode ser
usada para manipular ns filhos; use os mtodos appendChild, insertBefore e removeNode
para manipular ns filhos.
Consulte tambm

XML.appendChild, XML.insertBefore, XML.removeNode

473

XML.getBytesLoaded
Disponibilidade

Flash Player 6.
Uso

XML.getBytesLoaded()
Parmetros

Nenhum.
Retorna

Um inteiro que indica o nmero de bytes carregados.

Descrio

Mtodo; retorna o nmero de bytes carregados (transmitidos) do documento XML. possvel

comparar o valor de getBytesLoaded com o valor de getBytesTotal para determinar que
porcentagem de um documento XML foi carregada.
Consulte tambm

XML.getBytesTotal

XML.getBytesTotal
Disponibilidade

Flash Player 6.
Uso

XML.getBytesTotal()
Parmetros

Nenhum.
Retorna

Um inteiro.
Descrio

Mtodo; retorna o tamanho, em bytes, do documento XML.

Consulte tambm

XML.getBytesLoaded

XML.hasChildNodes
Disponibilidade

Flash Player 5.
Uso

myXML.hasChildNodes()
Parmetros

Nenhum.

Dicionrio ActionScript 474

Retorna

Nada.
Descrio

Mtodo; retorna true se o objeto XML especificado tem ns filhos; caso contrrio, retorna false.
Exemplo

O exemplo a seguir usa as informaes do objeto XML em uma funo definida pelo usurio.
if (rootNode.hasChildNodes()) {
myfunc (rootNode.firstChild);
}

XML.ignoreWhite
Disponibilidade

Flash Player 5.
Uso

myXML.ignoreWhite = boolean
XML.prototype.ignoreWhite = boolean
Parmetros

boolean

Um valor Booleano (true ou false).

Descrio

Propriedade; a configurao padro false. Quando definida como true, os ns de texto que s
contm espao em branco so descartados durante o processo de anlise. Os ns de texto com
espao em branco inicial ou de rastro no so afetados.
Uso 1: possvel definir a propriedade ignoreWhite para objetos XML individuais, como no
cdigo a seguir:
myXML.ignoreWhite = true

XML.insertBefore
Disponibilidade

Flash Player 5.
Uso

myXML.insertBefore(n_Filho, n_anterior)
Parmetros

n_Filho

O n a ser inserido.

n_anterior

O n antes do ponto de insero de n_Filho.

Retorna

Nada.
Descrio

Mtodo; insere um novo n filho na lista de filhos do objeto XML, antes do n n_anterior. Se
o parmetro n_anterior for indefinido ou null, o n ser adicionado usando appendChild. Se
n_anterior no for um filho de myXML, ocorrer erro na insero.

475

XML.lastChild
Disponibilidade

Flash Player 5.
Uso

myXML.lastChild
Descrio

Propriedade (somente leitura); avalia o objeto XML e faz referncia ao ltimo n filho na lista de
filhos do n pai. Esse mtodo retorna null se o n no tiver filhos. Essa uma propriedade
somente leitura e no pode ser usada para manipular ns filhos; use os mtodos appendChild,
insertBefore e removeNode para manipular ns filhos.
Consulte tambm

XML.appendChild, XML.insertBefore, XML.removeNode

XML.load
Disponibilidade

Flash Player 5.
Uso

myXML.load(url)
Parmetros

url A URL em que o documento XML a ser carregado est localizado. O URL deve estar no
mesmo subdomnio que o URL onde o filme reside no momento.
Retorna

Nada.
Descrio

Mtodo; carrega um documento XML da URL especificada e substitui o contedo do objeto

XML especificado pelo objeto com os dados XML descarregados. O processo de carregamento
assncrono; ele no termina imediatamente aps o mtodo load ser carregado. Quando load
executado, a propriedade do objeto XML loaded definida como false. Quando os dados XML
terminam de descarregar, a propriedade loaded definida como true e o mtodo onLoad
chamado. Os dados XML no so analisados at que sejam totalmente descarregados. Se o objeto
XML continha anteriormente rvores XML, elas so descartadas.
Voc pode especificar sua prpria funo de chamada no lugar do mtodo onLoad.
Exemplo

A seguir, um exemplo simples usando XML.load:

doc = new XML();
doc.load ("theFile.xml");
Consulte tambm

XML.loaded, XML.onLoad

Dicionrio ActionScript 476

XML.loaded
Disponibilidade

Flash Player 5.
Uso

myXML.loaded
Descrio

Propriedade (somente leitura); determina se o processo de carregamento do documento iniciado

pela chamada XML.load foi concludo. Se o processo for concludo com xito, o mtodo retorna
true; caso contrrio, ele retorna false.
Exemplo

O exemplo a seguir usa o XML.loaded em um script simples.

if (doc.loaded) {
gotoAndPlay(4);
}

XML.nextSibling
Disponibilidade

Flash Player 5.
Uso

myXML.nextSibling
Descrio

Propriedade (somente leitura); avalia o objeto XML e faz referncia ao prximo irmo na lista de
filhos do n pai. Esse mtodo retorna null se o n no tiver um n irmo prximo. Essa uma
propriedade somente leitura e no pode ser usada para manipular ns filhos. Use os mtodos
appendChild, insertBefore e removeNode para manipul-los.
Consulte tambm

XML.appendChild, XML.insertBefore, XML.removeNode

XML.nodeName
Disponibilidade

Flash Player 5.
Uso

myXML.nodeName
Descrio

Propriedade; considera ou retorna o nome do objeto XML. Se o objeto XML for um elemento
XML (nodeType == 1), nodeName o nome da marca que representa o n no arquivo XML. Por
exemplo, TITLE o nodeName de uma marca TITLE em HTML. Se o objeto XML for um n de
texto (nodeType == 3), o nodeName ser null.
Consulte tambm

XML.nodeType

477

XML.nodeType
Disponibilidade

Flash Player 5.
Uso

myXML.nodeType
Descrio

Propriedade (somente leitura); aceita ou apresenta um valor nodeType , onde 1 um elemento

XML e 3 um n de texto.
Consulte tambm

XML.nodeValue

XML.nodeValue
Disponibilidade

Flash Player 5.
Uso

myXML.nodeValue
Descrio

Propriedade; retorna o valor do n do objeto XML. Se o objeto XML for um n de texto,

nodeType ser 3 e nodeValue ser o texto do n. Se o objeto XML for um elemento XML (tipo
de n 1), ser somente leitura e ter null como nodeValue.
Consulte tambm

XML.nodeType

XML.onData
Disponibilidade

Flash Player 5
Uso

myXML.onData()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Identificador de eventos; chamado quando o download de um texto XML foi totalmente feito do
servidor, ou quando ocorre um erro ao fazer o download do texto XML de um servidor. Esse
identificador chamado antes de o XML ser analisado e, portanto, pode ser usado para chamar
uma rotina de anlise personalizada em vez de usar o analisador XML do Flash. O mtodo
XML.onData retorna o valor undefined ou uma seqncia de caracteres que contenha texto XML
cujo download tenha sido feito do servidor. Se o valor retornado for undefined, ocorreu um erro
durante o download do XML do servidor.

Dicionrio ActionScript 478

Por padro, o mtodo XML.onData chama o mtodo XML.onLoad. possvel substituir o mtodo
XML.onData por seu prprio comportamento, mas o XML.onLoad no ser mais chamado, a
menos que seja na sua implementao do XML.onData.
Exemplo

O exemplo a seguir mostra como o mtodo onData por padro:

XML.prototype.onData = function (src) {
if (src == undefined) {
this.onLoad(false);
else {
this.parseXML(src);
this.loaded = true;
this.onLoad(true);
}
}

possvel substituir o mtodo XML.onData para interceptar o texto XML sem analis-lo.

XML.onLoad
Disponibilidade

Flash Player 5.
Uso

myXML.onLoad(xito)
Parmetros

Um valor booleano que indica se o objeto XML foi carregado com xito por meio de
uma operao XML.load ou XML.sendAndLoad.

xito

Retorna

Nada.
Descrio

Mtodo; chamado pelo Flash Player quando um documento XML recebido do servidor. Se o
documento XML for recebido com xito, o parmetro xito ser true. Se o documento no tiver
sido recebido ou se tiver ocorrido algum erro ao receber a resposta do servidor, o parmetro xito
ser false. A implementao padro deste mtodo no est ativa. Para substituir a
implementao padro, atribua uma funo que contm suas prprias aes.

479

Exemplo

O exemplo a seguir cria um filme do Flash simples para um aplicativo de comrcio eletrnico. O
mtodo sendAndLoad transmite um elemento XML que contm o nome e a senha do usurio, e
instala um identificador onLoad para lidar com a resposta do 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);
Consulte tambm

function, XML.load, XML.sendAndLoad

XML.parentNode
Disponibilidade

Flash Player 5.
Uso

myXML.parentNode
Descrio

Propriedade (somente leitura); faz referncia ao n pai do objeto XML especificado, ou retorna
null se o n no tiver pai. Essa uma propriedade somente leitura e no pode ser usada para
manipular ns filhos; use os mtodos appendChild, insertBefore, e removeNode para
manipular os filhos.

XML.parseXML
Disponibilidade

Flash Player 5.
Uso

myXML.parseXML(origem)
Parmetros

origem

O texto XML a ser analisado e passado para o objeto XML especificado.

Retorna

Nada.
Descrio

Mtodo; analisa o texto XML especificado no parmetro origem e preenche o objeto XML
especificado com a rvore XML resultante. Quaisquer rvores existentes no objeto XML so
descartadas.

Dicionrio ActionScript 480

XML.previousSibling
Disponibilidade

Flash Player 5.
Uso

myXML.previousSibling
Descrio

Propriedade (somente leitura); retorna uma referncia do irmo anterior na lista de filhos do n
pai. Retorna null se o n no tiver um n irmo anterior. Essa uma propriedade somente leitura
e no pode ser usada para manipular ns filhos; use os mtodos appendChild, insertBefore e
removeNode para manipular ns filhos.

XML.removeNode
Disponibilidade

Flash Player 5.
Uso

myXML.childNodes[1].removeNode()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; remove o objeto XML especificado de seu pai. Todos os descendentes do n tambm so
excludos.

XML.send
Disponibilidade

Flash Player 5.
Uso

myXML.send(url, [janela])
Parmetros

url

A URL de destino do objeto XML especificado.

janela A janela do navegador que exibe dados retornados pelo servidor: _self especifica o
quadro atual na janela atual, _blank especifica uma nova janela, _parent especifica o pai do
quadro atual e _top especifica o quadro de alto nvel na janela atual. Este parmetro opcional; se
nenhum parmetro window for especificado, ser o mesmo que especificar _self.
Retorna

Nada.
Descrio

Mtodo; codifica o objeto XML especificado em um documento XML e o envia para o URL
especificado usando o mtodo POST.

481

XML.sendAndLoad
Disponibilidade

Flash Player 5.
Uso

myXML.sendAndLoad(url,objeto_XML_de destino)
Parmetros

url A URL de destino do objeto XML especificado. A URL deve estar no mesmo subdomnio
que a URL de onde o filme foi descarregado.
objeto_XML_de destino Um objeto XML criado com o mtodo construtor XML que
receber as informaes de retorno do servidor.
Retorna

Nada.
Descrio

Mtodo; codifica o objeto XML especificado em um documento XML, envia-o para a URL
especificada usando o mtodo POST, faz o download da resposta do servidor e a carrega no objeto
objeto_XML_de destino especificado nos parmetros. A resposta do servidor carregada da
mesma maneira usada pelo mtodo load.
Consulte tambm

XML.load

XML.status
Disponibilidade

Flash Player 5.
Uso

myXML.status
Descrio

Propriedade; define e retorna automaticamente um valor numrico que indica se um documento

XML foi analisado com xito em um objeto XML. Os cdigos de status numrico e uma
descrio de cada um deles so listados da seguinte maneira:

0 Sem erro; a anlise foi concluda com xito.

-2 Uma seo CDATA no foi terminada adequadamente.
-3 A declarao XML no foi terminada adequadamente.
-4

A declarao DOCTYPE no foi terminada adequadamente.

-5 Um comentrio no foi terminado adequadamente.

-6 Um elemento XML foi mal formado.
-7 Out of memory.
-8 Um valor de atributo no foi terminado adequadamente.
-9 Uma marca de incio no correspondeu a uma marca de fim.
-10 Foi encontrada uma marca de fim sem uma marca de incio correspondente.

Dicionrio ActionScript 482

XML.toString
Disponibilidade

Flash Player 5.
Uso

myXML.toString()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; avalia o objeto XML especificado, constri uma representao textual da estrutura XML
incluindo n, filhos e atributos, e retorna o resultado como uma seqncia de caracteres.
No caso de objetos XML de alto nvel (os criados com o construtor), XML.toString gera a
declarao XML do documento (armazenada em XML.xmlDecl), seguida da declarao DOCTYPE
do documento (armazenada em XML.docTypeDecl), seguida da representao textual de todos os
ns XML no objeto. A declarao XML no mostrada se XML.xmlDecl for indefinido. A
declarao DOCTYPE no mostrada se XML.docTypeDecl for indefinido.
Exemplo

O cdigo a seguir um exemplo do mtodo XML.toString que envia <h1>test</h1> para a

janela de sada.
node = new XML("<h1>test</h1>");
trace(node.toString());
Consulte tambm

XML.docTypeDecl, XML.xmlDecl

XML.xmlDecl
Disponibilidade

Flash Player 5.
Uso

myXML.xmlDecl
Descrio

Propriedade; define e retorna informaes sobre uma declarao XML do documento. Depois de
o documento XML ser analisado em um objeto XML, essa propriedade definida como o texto
da declarao XML do documento. Essa propriedade definida usando uma representao de
seqncia de caracteres da declarao XML, no de um objeto do n XML. Se nenhuma
declarao XML foi encontrada durante a operao de anlise, a propriedade definida como
undefined. XML. O mtodo toString apresenta o contedo de XML.xmlDecl antes de qualquer
outro texto no objeto XML. Se XML.xmlDecl contiver o tipo indefinido, nenhuma declarao
XML mostrada.

483

Exemplo

O exemplo a seguir usa XML.xmlDecl para definir a declarao do documento XML de um objeto
XML.
myXML.xmlDecl = "<?xml version=\"1.0\" ?>";

A seguir, um exemplo de declarao XML:

<?xml version="1.0" ?>
Consulte tambm

XML.docTypeDecl, XML.toString

XMLSocket (objeto)
O objeto XMLSocket implementa soquetes do cliente que permitem que o computador que est
executando o Flash Player se comunique com um computador servidor identificado pelo endereo
IP ou nome de domnio.
Usando o objeto XMLSocket
Para usar o objeto XMLSocket, o computador servidor deve executar um daemon que
compreenda o protocolo usado pelo objeto XMLSocket. O protocolo o seguinte:

Mensagens XML so enviadas atravs de uma conexo de soquetes de fluxo TCP/IP full-duplex.
Cada mensagem XML um documento XML completo, terminado por um byte zero.
Um nmero ilimitado de mensagens XML pode ser enviado e recebido por uma conexo
XMLSocket.
O objeto XMLSocket til para aplicativos cliente servidor que requerem uma latncia baixa,
como sistemas de bate-papo em tempo real. Uma soluo de bate-papo baseada em HTTP
pesquisa o servidor freqentemente e descarrega novas mensagens usando uma solicitao HTTP.
Comparando, uma soluo de bate-papo XMLSocket mantm uma conexo aberta com o
servidor, o que permite que o servidor envie mensagens de chegada imediatamente sem uma
solicitao do cliente.
Configurar um servidor para se comunicar com o objeto XMLSocket pode ser difcil. Se o seu
aplicativo no exigir interatividade em tempo real, use a ao loadVariables ou a conectividade
do servidor XML baseado em HTTP do Flash (XML.load, XML.sendAndLoad, XML.send) em vez
do objeto XMLSocket.
Para usar os mtodos do objeto XMLSocket, use a construtora new XMLSocket para criar um
novo objeto XMLSocket.

Dicionrio ActionScript 484

XMLSocket e segurana
Como o objeto XMLSocket estabelece e mantm uma conexo aberta com o servidor, as restries
a seguir foram colocadas no objeto XMLSocket por motivos de segurana:

O mtodo XMLSocket.connect s pode conectar a nmeros de porta TCP maiores que ou

iguais a 1024. Uma conseqncia dessa restrio que os daemons do servidor que se
comunicam com o objeto XMLSocket tambm devem ser atribudos a nmeros de porta
maiores que ou iguais a 1024. Os nmeros de porta abaixo de 1024 geralmente so usados
pelos servios de sistema como FTP, Telnet e HTTP, barrando, dessa forma, o objeto
XMLSocket dessas portas por motivos de segurana. A restrio do nmero de porta limita a
possibilidade desses recursos serem acessados e abusados de forma no adequada.

O mtodo XMLSocket.connect pode se conectar somente a computadores no mesmo

subdomnio onde o arquivo SWF (filme) reside. Essa restrio no se aplica aos filmes que
estejam sendo executados fora de um disco local. (Essa restrio idntica s regras de
segurana do loadVariables, XML.sendAndLoad e XML.load.)
Resumo de mtodos do objeto XMLSocket
Mtodo

Descrio

XMLSocket.close

Fecha uma conexo de soquete aberta.

XMLSocket.connect

Estabelece uma conexo com o servidor especificado.

XMLSocket.send

Envia um objeto XML para o servidor.

Resumo de identificadores de eventos do objeto XMLSocket

Mtodo

Descrio

XMLSocket.onClose

Uma funo de chamada que chamada quando uma conexo XMLSocket

fechada.

XMLSocket.onConnect

Uma funo de chamada que chamada quando uma conexo XMLSocket

estabelecida.

XMLSocket.onData

Uma funo de retorno de chamada que chamada aps o download de uma

mensagem XML do servidor.

XMLSocket.onXML

Uma funo de chamada que chamada quando um objeto XML chega do servidor.

Construtor do objeto XMLSocket

Disponibilidade

Flash Player 5.
Uso

new XMLSocket()
Parmetros

Nenhum.
Retorna

Nada.

485

Descrio

Construtor; cria um novo objeto XMLSocket. O objeto XMLSocket no conectado

inicialmente com qualquer servidor. Voc deve chamar o mtodo XMLSocket.connect para
conectar o objeto ao servidor.
Exemplo

myXMLSocket = new XMLSocket();

Consulte tambm

XMLSocket.connect

XMLSocket.close
Disponibilidade

Flash Player 5.
Uso

myXMLSocket.close()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; fecha a conexo especificada pelo objeto XMLSocket.

Consulte tambm

XMLSocket.connect

XMLSocket.connect
Disponibilidade

Flash Player 5.
Uso

myXMLSocket.connect(host, porta)
Parmetros

Um nome de domnio DNS totalmente qualificado ou um endereo IP no formato

aaa.bbb.ccc.ddd. Voc tambm pode especificar null para se conectar ao servidor host no qual o
filme reside.

host

O nmero da porta TCP no host usado para estabelecer uma conexo. O nmero da
porta deve ser 1024 ou superior.

porta

Retorna

Nada.

Dicionrio ActionScript 486

Descrio

Mtodo; estabelece uma conexo com o host de Internet especificado usando a porta TCP
especificada (deve ser 1024 ou superior), e retorna true ou false dependendo do xito da
conexo. Se voc no sabe o nmero da porta de sua mquina host de Internet, entre em contato
com o administrador da rede. Se o plug-in Flash Netscape ou o controle ActiveX estiver sendo
usado, o host especificado no parmetro dever ter o mesmo subdomnio do host do qual foi feito
o download do filme.
Se for especificado null para o parmetro host, o host contatado ser aquele em que reside o
filme que chama XMLSocket.connect. Por exemplo, se o download do filme foi feito de http://
www.seu_site.com, especificar null para o parmetro do host o mesmo que digitar o endereo
IP de www.seu_site.com.
Se XMLSocket.connect retorna um valor true, o palco inicial do processo da conexo obteve xito;
mais tarde, o mtodo XMLSocket.onConnect chamado para determinar se a conexo final obteve
xito ou falhou. Se XMLSocket.connect retorna false, uma conexo no pode ser estabelecida.
Exemplo

O exemplo a seguir usa XMLSocket.connect para se conectar com o host onde o filme reside, e
usa trace para exibir o valor de retorno que indica o xito ou falha da conexo.
function myOnConnect(success) {
if (success) {
trace ("Connection succeeded!")
else {
trace ("Connection failed!")
}
}
socket = new XMLSocket()
socket.onConnect = myOnConnect
if (!socket.connect(null, 2000)) {
trace ("Connection failed!")
}
Consulte tambm

function, XMLSocket.onConnect

XMLSocket.onClose
Disponibilidade

Flash Player 5.
Uso

myXMLSocket.onClose()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Mtodo; uma funo de chamada que chamada somente quando uma conexo aberta fechada
pelo servidor. A implementao padro desse mtodo no executa aes. Para substituir a
implementao padro, atribua uma funo que contm suas prprias aes.
Consulte tambm

function, XMLSocket.onConnect

487

XMLSocket.onConnect
Disponibilidade

Flash Player 5.
Uso

myXMLSocket.onConnect(xito)
Parmetros

xito Um valor
(true ou false).

booleano que indica se uma conexo de soquete foi estabelecida com xito

Retorna

Nada.
Descrio

Mtodo; uma funo de retorno de chamada chamada pelo Flash Player quando uma solicitao
de conexo iniciada pelo mtodo XMLSocket.connect obtm xito ou falha. Se a conexo obtm
xito, o parmetro xito true; caso contrrio, o parmetro xito false.
A implementao padro desse mtodo no executa aes. Para substituir a implementao
padro, atribua uma funo que contm suas prprias aes.
Exemplo

O exemplo a seguir ilustra o processo de especificao de uma funo de substituio do mtodo

onConnect em uma aplicao de bate-papo simples.
A funo controla para qual tela os usurios so conduzidos, dependendo do xito da conexo
estabelecida. Se a conexo for estabelecida com xito, os usurios sero conduzidos para a tela de
bate-papo principal no quadro chamado startChat. Se a conexo no tiver xito, os usurios vo
para uma tela com as informaes de soluo de problemas no quadro rotulado
connectionFailed.
function myOnConnect(success) {
if (success) {
gotoAndPlay("startChat")
else {
gotoAndStop("connectionFailed")
}
}

Depois de criar o objeto XMLSocket usando o mtodo construtor, o script instala no mtodo
onConnect usando o operador de atribuio:
socket = new XMLSocket()
socket.onConnect = myOnConnect

Finalmente, a conexo iniciada. Se a conexoretornar false, o filme enviado para o quadro

chamado connectionFailed, e onConnect nunca chamado. Se connect retornar true, o
filme saltar para um quadro chamado waitForConnection, que a tela Aguarde. O filme
permanece no quadro waitForConnection at que o manipulador onConnect seja chamado, o
que acontece em algum momento no futuro dependendo da latncia da rede.
if (!socket.connect(null, 2000)) {
gotoAndStop("connectionFailed")
else {
gotoAndStop("waitForConnection")
}
Consulte tambm

function, XMLSocket.connect

Dicionrio ActionScript 488

XMLSocket.onData
Disponibilidade

Flash Player 5.
Uso

XMLSocket.onData()
Parmetros

Nenhum.
Retorna

Nada.
Descrio

Identificador de eventos; chamado aps o download de uma mensagem XML do servidor,

terminada por um byte zero.
Por padro, o mtodo XMLSocket.onData chama o mtodo XMLSocket.onXML. Se voc substituir
XMLSocket.onData por seu prprio comportamento, XMLSocket.onXML no ser mais chamado,
a menos que seja na sua implementao de XMLSocket.onData.
XMLSocket.prototype.onData = function (src) {
this.onXML(new XML(src));
}

No exemplo acima, o parmetro src uma seqncia de caracteres que contm texto XML cujo
download foi feito do servidor. O byte zero de trmino no includo na seqncia de caracteres.
XMLSocket.onData

pode ser substitudo para interceptar o texto XML sem analis-lo.

XMLSocket.onXML
Disponibilidade

Flash Player 5.
Uso

myXMLSocket.onXML(objeto)
Parmetro

objeto Uma instncia do objeto XML que contm um documento XML analisado recebido de
um servidor.
Retorna

Nada.
Descrio

Mtodo; uma funo de retorno de chamada chamada pelo Flash Player quando o objeto XML
especificado que contm um documento XML chega atravs de uma conexo XMLSocket aberta.
Uma conexo XMLSocket pode ser usada para transferir um nmero ilimitado de documentos
XML entre o cliente e o servidor. Cada documento terminado com um byte 0 (zero). Quando o
Flash Player recebe o byte zero, ele analisa todo o XML recebido desde o byte zero anterior ou
desde que a conexo foi estabelecida, se essa for a primeira mensagem recebida. Cada lote de XML
analisado tratado como um nico documento XML e passado para o mtodo onXML.
A implementao padro desse mtodo no executa aes. Para substituir a implementao
padro, atribua uma funo que contm aes definidas por voc.

489

Exemplo

A funo a seguir substitui a implementao padro do mtodo onXML em um aplicativo de batepapo simples. A funo myOnXML instrui o aplicativo de bate-papo a reconhecer um nico
elemento XML, MESSAGE, no seguinte formato:
<MESSAGE USER="John" TEXT="Ol, meu nome John!" />.

O manipulador onXML deve primeiro ser instalado no objeto XMLSocket da seguinte forma:
socket.onXML = myOnXML;

A funo displayMessage subentendida como uma funo definida pelo usurio que exibe a
mensagem recebida pelo usurio.
function myOnXML(doc) {
var e = doc.firstChild;
if (e != null && e.nodeName == "MESSAGE") {
displayMessage(e.attributes.user, e.attributes.text);
}
}
Consulte tambm

function

XMLSocket.send
Disponibilidade

Flash Player 5.
Uso

myXMLSocket.send(objeto)
Parmetros

objeto

Um objeto XML ou outros dados a serem transmitidos para o servidor.

Retorna

Nada.
Descrio

Mtodo; converte o objeto XML ou os dados especificados no parmetro objeto em uma

seqncia de caracteres e a transmite para o servidor, seguida de um byte zero. Se objeto for um
objeto XML, a seqncia de caracteres ser a representao textual XML do objeto XML. A
operao de envio assncrona; ela retorna imediatamente, mas os dados podem ser transmitidos
posteriormente. O mtodo XMLSocket.send no retorna nenhum valor que indique se os dados
foram transmitidos com xito.
Se o objeto myXMLSocket no for conectado com o servidor (usando XMLSocket.connect), a
operao XMLSocket.send ir falhar.

Dicionrio ActionScript 490

Exemplo

O exemplo a seguir ilustra como possvel especificar um nome e uma senha de usurio para
enviar o objeto XML myXML para o servidor:
var myXML = new XML();
var myLogin = myXML.createElement("login");
myLogin.attributes.username = usernameTextField;
myLogin.attributes.password = passwordTextField;
myXML.appendChild(myLogin);
myXMLSocket.send(myXML);
Consulte tambm

XMLSocket.connect

491

Dicionrio ActionScript 492