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 ++ ! != !== % %= & && &= () * *= , . ?: / // /* /= [] ^ ^= {} | (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)

23

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 abs acos add addItem addItemAt addListener Consulte a entrada Math.abs Math.acos add FComboBox.addItem, FListBox.addItem FComboBox.addItemAt, FListBox.addItem FStyleFormat.addListenerFStyleFormat.addListener, Key.addListener, Mouse.addListener, Selection.addListener, Stage.addListenerStage.addListener, TextField.addListener Object.addProperty and Stage.align, TextFormat.align MovieClip._alpha, Button._alpha, TextField._alpha XML.appendChild Function.apply FStyleFormat.applyChangesFStyleFormat.applyChanges

addProperty and align _alpha appendChild apply applyChanges

Dicionrio ActionScript

24

Elemento do ActionScript Argumentos Array arrow asfunction asin atan atan2 attachMovie attachSound attributes autosize background backgroundColor backgroundDisabled BACKSPACE beginFill beginGradientFill blockIndent bold Booleano border borderColor bottomScroll break bullet Button call call function callee caller capabilities CAPSLOCK case ceil charAt charCodeAt check childNodes chr clear clearInterval

Consulte a entrada arguments (objeto) Array (objeto) FStyleFormat.arrow asfunction Math.asin Math.atan Math.atan2 MovieClip.attachMovie Sound.attachSound XML.attributes TextField.autoSize FStyleFormat.background, TextField.background TextField.backgroundColor FStyleFormat.backgroundDisabled Key.BACKSPACE MovieClip.beginFill MovieClip.beginGradientFill TextFormat.blockIndent TextFormat.bold Boolean (funo), Boolean (objeto) TextField.border TextField.borderColor TextField.bottomScroll break TextFormat.bullet Button (objeto) call, Function.call chamar funo arguments.callee arguments.caller System.capabilities (objeto) Key.CAPSLOCK case Math.ceil String.charAt String.charCodeAt FStyleFormat.check XML.childNodes chr MovieClip.clear clearInterval

25

Elemento do ActionScript cloneNode close Cor concat connect constructor

Consulte a entrada XML.cloneNode XMLSocket.close Color (objeto), TextFormat.color Array.concat, String.concat XMLSocket.connect Array (objeto), Boolean (objeto), Color (objeto), Date (objeto), Number (funo), Object (objeto), Sound (objeto), String (objeto), XML (objeto), XMLSocket (objeto) LoadVars.contentType, XML.contentType continue Key.CONTROL Math.cos XML.createElement MovieClip.createEmptyMovieClip MovieClip.createTextField XML.createTextNode MovieClip._currentframe MovieClip.curveTo Date (objeto) FStyleFormat.darkshadow defaultdefault delete Key.DELETEKEY XML.docTypeDecl do while Key.DOWN MovieClip._droptarget duplicateMovieClip, MovieClip.duplicateMovieClip Sound.duration Math.E #endinitclip else else if TextField.embedFonts Button.enabled, MovieClip.enabled Key.END MovieClip.endFill Key.ENTER eq (igual especfico de seqncia de caracteres) escape Key.ESCAPE eval

contentType ccntinue CONTROL cos createElement createEmptyMovieClip createTextField createTextNode _currentframe curveTo Date darkshadow default delete DELETEKEY docTypeDecl do while DOWN _droptarget duplicateMovieClip duration E #endinitclip else else if embedFonts enab led END endFill ENTER eq escape (funo) ESCAPE (constante) eval

Dicionrio ActionScript

26

Elemento do ActionScript evaluate exp face false FCheckBox FComboBox firstChild FListBox floor focusEnabled _focusrect fonte for for..in foregroundDisabled FPushButton FRadioButton _framesloaded fromCharCode fscommand FScrollBar FScrollPane FStyleFormat function ge get getAscii getBeginIndex getBounds getBytesLoaded getBytesTotal getCaretIndex getCode getData getDate getDay getDepth getEnabled

Consulte a entrada evaluate Math.exp FStyleFormat.face false FCheckBox (componente) FListBox (component) XML.firstChild FListBox (component) Math.floor MovieClip.focusEnabled _focusrect, Button._focusrect, TextField._focusrect, MovieClip._focusrect TextFormat.font for for..in FStyleFormat.foregroundDisabled FPushButton (component) FPushButton (component) MovieClip._framesloaded String.fromCharCode fscommand FScrollBar (component) FScrollPane (component) FStyleFormat (object) function, Function (objeto) ge (maior ou igual a especfico de seqncias de caracteres) CustomActions.get Key.getAscii Selection.getBeginIndex MovieClip.getBounds LoadVars.getBytesLoaded, MovieClip.getBytesLoaded, Sound.getBytesLoaded, XML.getBytesLoaded LoadVars.getBytesTotal, MovieClip.getBytesTotal, Sound.getBytesTotal, XML.getBytesTotal Selection.getCaretIndex Key.getCode FRadioButton.getData Date.getDate Date.getDay Button.getDepth, MovieClip.getDepth, TextField.getDepth FCheckBox.getEnabled, FComboBox.getEnabled, FListBox.getEnabled, FPushButton.getEnabled, FRadioButton.getEnabled, FScrollBar.getEnabled

27

Elemento do ActionScript getEndIndex getFocus getFontList getFullYear getHours getItemAt getLabel getLength getMilliseconds getMinutes getMonth getNewTextFormet getPan getPaneHeight getPaneWidth getProperty getRowCount getRGB getScrollContent getScrollPosition getSeconds getSelectedIndex getSelectedIndices getSelectedItem getSelectedItems getSelectMultiple getState getTextExtent getTextFormat getTime getTimer getTimezoneOffset getTransform getURL getUTCDate getUTCDay getUTCFullYear getUTCHours getUTCMilliseconds getUTCMinutes

Consulte a entrada Selection.getEndIndex Selection.getFocus TextField.getFontList Date.getFullYear Date.getHours FComboBox.getItemAt, FListBox.addItemAt FCheckBox.getLabel, FPushButton.getLabel, FRadioButton.getLabel FComboBox.getLength, FListBox.getLength Date.getMilliseconds Date.getMinutes Date.getMonth TextField.getNewTextFormat Sound.getPan FScrollPane.getPaneHeight FScrollPane.getPaneWidth getProperty FComboBox.getRowCount, FListBox.getRowCount Color.getRGB FScrollPane.getScrollContent FComboBox.getScrollPosition, FListBox.getScrollPosition, FScrollBar.getScrollPosition, FScrollPane.getScrollPosition Date.getSeconds FComboBox.getSelectedIndex, FListBox.getSelectedIndex FListBox.getSelectedIndices FComboBox.getSelectedItem, FListBox.getSelectedItem FListBox.getSelectedItem FListBox.getSelectMultiple FRadioButton.getState TextFormat.getTextExtent TextField.getTextFormat Date.getTime getTimer Date.getTimezoneOffset Color.getTransform, Sound.getTransform getURL, MovieClip.getURL Date.getUTCDate Date.getUTCDay Date.getUTCFullYear Date.getUTCHours Date.getUTCMilliseconds Date.getUTCMinutes

Dicionrio ActionScript

28

Elemento do ActionScript getUTCMonth getUTCSeconds getValue getVersion getVolume getYear _global globalStyleFormat globalToLocal goto gotoAndPlay gotoAndStop gt hasAccessibility hasAudio hasAudioEncoder hasMP3 hasVideoEncoder hasChildNodes height _height hide highlight highlight3D _highquality hitArea hitTest HOME hscroll html htmlText if ifFrameLoaded ignoreWhite #include indent indexOf #initclip INSERT insertBefore

Consulte a entrada Date.getUTCMonth Date.getUTCSeconds FCheckBox.getValue, FComboBox.getValue, FListBox.getValue, FRadioButton.getValue getVersion Sound.getVolume Date.getYear _global globalStyleFormat MovieClip.globalToLocal gotoAndPlay, gotoAndStop gotoAndPlay, MovieClip.gotoAndPlay gotoAndStop, MovieClip.gotoAndStop gt (maior que especfico de seqncias de caracteres) System.capabilities.hasAccessibility System.capabilities.hasAudio System.capabilities.hasAudioEncoder System.capabilities.hasMP3 System.capabilities.hasVideoEncoder XML.hasChildNodes Stage.height MovieClip._height, TextField._height, Button._height Mouse.hide FStyleFormat.highlight FStyleFormat.highlight3D _highquality, Button._highquality, MovieClip._highquality, TextField._highquality MovieClip.hitArea MovieClip.hitTest Key.HOME TextField.hscroll TextField.html TextField.htmlText if ifFrameLoaded XML.ignoreWhite #include TextFormat.indent String.indexOf #initclip Key.INSERT XML.insertBefore

29

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

Consulte a entrada CustomActions.install instanceof int Accessibility.isActive Key.isDown isFinite isNaN Key.isToggled TextFormat.italic Array.join Key (objeto) System.capabilities.language XML.lastChild String.lastIndexOf le (menor que ou igual a especfico da seqncia de caracteres) TextFormat.leading Key.LEFT TextFormat.leftMargin arguments.length, Array.length, String.length, Sound.loadSound, TextField.length _level MovieClip.lineStyle MovieClip.lineTo CustomActions.uninstall Math.LN2 Math.LN10 XML.load, LoadVars.load XML.loaded, LoadVars.loaded loadMovie, MovieClip.loadMovie loadMovieNum FScrollPane.loadScrollContent Sound.loadSound loadVariables, MovieClip.loadVariables loadVariablesNum LoadVars (objeto) MovieClip.localToGlobal Math.log Math.LOG2E Math.LOG10E lt (menor que seqncia de caracteres especfica) System.capabilities.manufacturer

Dicionrio ActionScript

30

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

Consulte a entrada Math (objeto) Math.max TextField.maxChars TextField.maxhscroll maxscroll, TextField.maxscroll Number.MAX_VALUE mbchr mblength mbord mbsubstring mtodo Math.min Number.MIN_VALUE Mouse (objeto) MovieClip.moveTo MovieClip (objeto) TextField.multiline MovieClip._name, TextField._name, Button._name NaN, Number.NaN ne (diferente especfico de seqncia de caracteres) Number.NEGATIVE_INFINITY new newline nextFrame, MovieClip.nextFrame nextScene XML.nextSibling XML.nodeName XML.nodeType XML.nodeValue not null Number (funo), Number (objeto) Object (objeto) on onClipEvent XMLSocket.onClose TextField.onChanged XMLSocket.onConnect XML.onData, XMLSocket.onData Button.onDragOut, MovieClip.onDragOut Button.onDragOver, MovieClip.onDragOver

31

Elemento do ActionScript onEnterFrame onKeyDown onKeyUp onKillFocus onLoad onMouseDown onMouseMove onMouseUp onPress onRelease onReleaseOutisde onResize onRollOut onRollOver onScroller onSetFocus onSort onSoundComplete onUnload onXML or (logical OR) ord os _parent parentNode parseFloat parseInt parseXML password PGDN PGUP PI pixelAspectRatio play pop position POSITIVE_INFINITY pow prevFrame

Consulte a entrada MovieClip.onEnterFrame Button.onKeyDown, Key.onKeyDown, MovieClip.onKeyDown Button.onKeyUp, Key.onKeyUp, MovieClip.onKeyUp Button.onKillFocus, MovieClip.onKillFocus, TextField.onKillFocus LoadVars.onLoad, MovieClip.onLoad, Sound.onLoad, XML.onLoad Mouse.onMouseDown, MovieClip.onMouseDown Mouse.onMouseMove, MovieClip.onMouseMove Mouse.onMouseUp, MovieClip.onMouseUp Button.onPress, MovieClip.onPress Button.onRelease, MovieClip.onRelease Button.onReleaseOutside, MovieClip.onReleaseOutside Stage.onResize Button.onRollOut Button.onRollOver TextField.onScroller Button.onSetFocus, MovieClip.onSetFocus, Selection.onSetFocus, TextField.onSetFocus Array.pop Sound.onSoundComplete MovieClip.onUnload XMLSocket.onXML or ord System.capabilities.os _parent, Button._parent, MovieClip._parent, TextField._parent XML.parentNode parseFloat parseInt XML.parseXML TextField.password Key.PGDN Key.PGUP Math.PI System.capabilities.pixelAspectRatio play, MovieClip.play Array.pop Sound.position Number.POSITIVE_INFINITY Math.pow prevFrame, MovieClip.prevFrame

Dicionrio ActionScript

32

Elemento do ActionScript previousSibling prevScene print printAsBitmap printAsBitmapNum printNum __proto__ push _quality radioDot random refreshPane registerClass registerSkinElement

Consulte a entrada XML.previousSibling prevScene print printAsBitmap printAsBitmapNum printNum Object.__proto__ Array.push _quality, TextField._quality, Button._quality FStyleFormat.radioDot random, Math.random FScrollPane.refreshPane Object.registerClass FCheckBox.registerSkinElement, FComboBox.registerSkinElement, FListBox.registerSkinElement, FPushButton.registerSkinElement, FRadioButton.registerSkinElement, FScrollPane.registerSkinElement, FScrollPane.registerSkinElement FComboBox.removeAll, FListBox.removeAll FComboBox.removeItemAt, FListBox.removeItemAt FStyleFormat.removeListener, Key.removeListener, Mouse.removeListener, Selection.removeListener, Stage.removeListener, TextField.removeListener removeMovieClip, MovieClip.removeMovieClip XML.removeNode TextField.removeTextField FComboBox.replaceItemAt, FListBox.replaceItemAt TextField.replaceSel Capabilities.screenResolutionX Capabilities.screenResolutionY TextField.restrict return Array.reverse Key.RIGHT TextFormat.rightMargin _root MovieClip._rotation, Button._rotation, TextField._rotation Math.round Stage.scaleMode System.capabilities.screenColor System.capabilities.screenDPI System.capabilities.screenResolution.x System.capabilities.screenResolution.y

removeAll removeItemAt removeListener

removeMovieClip removeNode removeTextField replaceItemAt replaceSel resolutionX resolutionY restrict return reverse RIGHT rightMargin _root _rotation round scaleMode screenColor screenDPI screenResolution.x screenResolution.y

33

Elemento do ActionScript scroll scrollTrack selectable selection Selection selectionDisabled selectionUnfocused send sendAndLoad set variable setAutoHideScrollBar setChangeHandler

Consulte a entrada scroll, TextField.scroll FStyleFormat.scrollTrack TextField.selectable FStyleFormat.selection Selection (objeto) FStyleFormat.selectionDisabled FStyleFormat.selectionUnfocused LoadVars.send, XML.send, XMLSocket.send LoadVars.sendAndLoad, XML.sendAndLoad set variable FListBox.setAutoHideScrollBar FCheckBox.setChangeHandler, FComboBox.setChangeHandler, FListBox.setChangeHandler, FRadioButton.setChangeHandler, FScrollBar.setChangeHandler FPushButton.setClickHandler FRadioButton.setData FComboBox.setDataProvider, FListBox.setDataProvider Date.setDate FScrollPane.setDragContent FComboBox.setEditable FCheckBox.setEnabled,FComboBox.setEnabled, FListBox.setEnabled, FPushButton.setEnabled, FRadioButton.setEnabled, FScrollBar.setEnabled Selection.setFocus Date.setFullYear FRadioButton.setGroupName FScrollBar.setHorizontal Date.setHours FScrollPane.setHScroll setInterval FComboBox.setItemSymbol, FListBox.setItemSymbol FCheckBox.setLabel, FPushButton.setLabel, FRadioButton.setLabel FCheckBox.setLabelPlacement, FRadioButton.setLabelPlacement FScrollBar.setLargeScroll MovieClip.setMask Date.setMilliseconds Date.setMinutes Date.setMonth TextField.setNewTextFormat Sound.setPan setProperty Color.setRGB

setClickHandler setData setDataProvider setDate setDragContent setEditable setEnabled

setFocus setFullYear setGroupName setHorizontal setHours setHScroll setInterval setItemSymbol setLabel setLabelPlacement setLargeScroll setMask setMilliseconds setMinutes setMonth setNewTextFormat setPan setProperty setRGB

Dicionrio ActionScript

34

Elemento do ActionScript setRowCount setScrollContent setScrollPosition setScrollProperties setScrollTarget setSeconds setSelectedIndex setSelectedIndices setSelection setSelectMultiple setSize setSmallScroll setState setStyleProperty

Consulte a entrada FComboBox.setRowCount, FListBox.setRowCount FScrollBar.setSize, FScrollPane.setScrollContent FListBox.setScrollPosition, FScrollBar.setScrollPosition, FScrollPane.setScrollPosition FScrollBar.setScrollProperties FScrollBar.setScrollTarget Date.setSeconds FComboBox.setSelectedIndex, FListBox.setSelectedIndex FListBox.setSelectedIndices Selection.setSelection FListBox.setSelectMultiple FCheckBox.setSize, FComboBox.setSize, FListBox.setSize, FPushButton.setSize, FScrollBar.setSize, FScrollPane.setSize FScrollBar.setSmallScroll FRadioButton.setState FCheckBox.setStyleProperty, FComboBox.setStyleProperty, FListBox.setStyleProperty, FPushButton.setStyleProperty, FRadioButton.setStyleProperty, FScrollBar.setStyleProperty, FScrollPane.setStyleProperty TextField.setTextFormat Date.setTime Color.setTransform, Sound.setTransform Date.setUTCDate Date.setUTCFullYear Date.setUTCHours Date.setUTCMilliseconds Date.setUTCMinutes Date.setUTCMonth Date.setUTCSeconds FCheckBox.setValue, FComboBox.setValue, FRadioButton.setValue Sound.setVolume FScrollPane.setVScroll FListBox.setWidth Date.setYear FStyleFormat.shadow Array.shift Key.SHIFT Mouse.show Math.sin TextFormat.size Array.slice, String.slice Array.sort FComboBox.sortItemsBy, FListBox.sortItemsBy

setTextFormat setTime setTransform setUTCDate setUTCFullYear setUTCHours setUTCMilliseconds setUTCMinutes setUTCMonth setUTCSeconds setValue setVolume setVScroll setWidth setYear shadow shift (method) SHIFT (constant) show sin size slice sort sortItemsBy

35

Elemento do ActionScript Sound _soundbuftime SPACE splice split sqrt SQRT1_2 SQRT2 start startDrag status stop stopAllSounds stopDrag String substr substring super swapDepths switch System TAB tabChildren tabEnabled tabIndex tabStops tan target _target targetPath tellTarget text textAlign textBold textColor textDisabled TextField textFont TextFormat textHeight

Consulte a entrada Sound (objeto) _soundbuftime, TextField._soundbuftime, MovieClip._soundbuftime, Button._soundbuftime Key.SPACE Array.splice String.split Math.sqrt Math.SQRT1_2 Math.SQRT2 Sound.start startDrag, MovieClip.startDrag XML.status stop, MovieClip.stop, Sound.stop stopAllSounds stopDrag, MovieClip.stopDrag String (funo), String (objeto) String.substring substring, String.substring super MovieClip.swapDepths switch System (objeto) Key.TAB MovieClip.tabChildren Button.tabEnabled, TextField.tabEnabled, MovieClip.tabEnabled Button.tabIndex, MovieClip.tabIndex, TextField.tabIndex TextFormat.tabStops Math.tan TextFormat.target Button._target, MovieClip._target, TextField._target targetPath tellTarget TextField.text FStyleFormat.textAlign FStyleFormat.textBold FStyleFormat.textColor, TextField.textColor FStyleFormat.textDisabled TextField (objeto) FStyleFormat.textFont TextFormat (objeto) TextField.textHeight

Dicionrio ActionScript

36

Elemento do ActionScript textIndent textItalic textLeftMargin textRightMargin textSelected textSize textUnderline textWidth this toggleHighQuality toLowerCase toString _totalframes toUpperCase trace trackAsMenu true type typeof undefined underline unescape uninstall unloadMovie unLoadMovieNum unshift unwatch UP updateAfterEvent url _url useHandCursor UTC valueOf var variable version _visible void watch while

Consulte a entrada FStyleFormat.textIndent FStyleFormat.textItalic FStyleFormat.textLeftMargin FStyleFormat.textRightMargin FStyleFormat.textSelected FStyleFormat.textSize FStyleFormat.textUnderline TextField.textWidth this toggleHighQuality String.toLowerCase Array.toString, Boolean.toString, Date.toString, Number.toString, Object.toString, XML.toString MovieClip._totalframes String.toUpperCase trace Button.trackAsMenu, MovieClip.trackAsMenu true TextField.type typeof undefined TextFormat.underline unescape CustomActions.uninstall unloadMovie, MovieClip.unloadMovie unloadMovieNum Array.unshift Object.unwatch Key.UP updateAfterEvent TextFormat.url MovieClip._url, TextField._url, Button._url Button.useHandCursor, MovieClip.useHandCursor Date.UTC Boolean.valueOf, Number.valueOf, Object.valueOf var TextField.variable System.capabilities.version MovieClip._visible, Button._visible, TextField._visible void Object.watch while

37

Elemento do ActionScript width _width with wordwrap _x XML xmlDecl XMLSocket _xmouse _xscale _y _ymouse _yscale

Consulte a entrada Stage.width MovieClip._width, TextField._width, Button._width with TextField.wordWrap Button._x, MovieClip._x, TextField._x XML (objeto) XML.xmlDecl XMLSocket (objeto) Button._xmouse, MovieClip._xmouse, TextField._xmouse Button._xscale, MovieClip._xscale, TextField._xscale Button._y, MovieClip._y, TextField._y Button._ymouse, MovieClip._ymouse, TextField._ymouse Button._yscale, MovieClip._yscale, TextField._yscale

(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 retorna true

! false

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 5 != 5

retorna true 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 s1 s1 s1 s1 s1 s1 s1 s1 == == == == === === === === !== !== !== !== s2; // true s3; // false n; // true b; // false s2; // true s3; // false n; // false b; // false s2; // false s3; // true n; // true b; // true

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

expresso2. x &= y x = x & y

Exemplo

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

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.

parmetro1...parmetroN

Uma srie de parmetros que devem ser executados antes de os resultados serem transferidos como parmetros para a funo fora dos parnteses.

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. varivel

Uma varivel na Linha do tempo do nome da instncia do clipe de filme esquerda do operador ponto (.).

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
Retorna

Valores de qualquer tipo.

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
Retorna

Um nmero ou uma varivel que avalia um nmero.

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
Retorna

Qualquer caractere.

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;
Consulte tambm

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

/* (delimitador de comentrio)

/* (delimitador de comentrio)
Disponibilidade

Flash Player 5.
Uso

/* comentrio */ /* comentrio comentrio */

Parmetros

comentrio
Retorna

Qualquer caractere.

Nada.

51

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
Retorna

Um nmero ou uma varivel que avaliada para um nmero.

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. Elementos em uma matriz. O nome de uma matriz multidimensional simulada.

a0, a1,...aN

myMultiDimensionalArray E

O nmero (ou ndice) de um elemento em uma matriz. O nome de um objeto. Uma seqncia de caracteres ou expresso que d nome a uma propriedade do objeto.

objeto valor
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
Retorna

Um nmero.

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

Inteiros e variveis.

Nenhum.

55

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. Os nomes das propriedades. Os valores correspondentes de cada propriedade nome.

nome1,2,...N valor1,2,...N
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
Retorna

Um nmero.

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
Parmetros

|= expresso2

expresso1,expresso2
Retorna

Um nmero ou uma varivel.

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
Retorna

Um nmero.

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
Retorna

Nmeros ou seqncias de caracteres.

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
Parmetros

+= expresso2

expresso1,expresso2
Retorna

Nmeros ou seqncias de caracteres.

Nada.
Descrio

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

Operador (atribuio composta aritmtica); atribui a expresso1 o valor de expresso1 + Por exemplo, os dois comandos a seguir tm o mesmo resultado:

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
Descrio

Nmeros ou seqncias de caracteres.

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 expresso2
Retorna

Nmero ou expresso a ser deslocada para a esquerda. Um nmero ou expresso que converte em um inteiro de 0 a 31.

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 expresso2
Retorna

Nmero ou expresso a ser deslocada para a esquerda. Um nmero ou expresso que converte em um inteiro de 0 a 31.

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
Retorna

Nmeros ou seqncias de caracteres.

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
Parmetros

= expresso2

expresso1 expresso2
Retorna

Varivel, elemento de uma matriz ou propriedade de um objeto. Valor de qualquer tipo.

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
Retorna

Nmero ou expresso que avalie um nmero.

Nada.
Descrio

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

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

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 s1 s1 s1 s1 s1 s1 s1 s1 == == == == === === === === !== !== !== !== s2; // true s3; // false n; // true b; // false s2; // true s3; // false n; // false b; // false s2; // false s3; // true n; // true b; // true

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 expresso2
Retorna

Nmero ou expresso a ser deslocada para a direita. Um nmero ou expresso que converte em um inteiro de 0 a 31.

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 expresso2
Retorna

Nmero ou expresso a ser deslocada para a esquerda. Um nmero ou expresso que converte em um inteiro de 0 a 31.

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 expresso2
Retorna

Nmero ou expresso a ser deslocada para a direita. Um nmero ou uma expresso que converte em um inteiro de 0 a 31.

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 expresso2
Retorna

Nmero ou expresso a ser deslocada para a esquerda. Um nmero ou expresso que converte em um inteiro de 0 a 31.

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 Accessibility.isActive Descrio 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

Retorna

Uma seqncia de caracteres.

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
Retorna

Condies ou expresses que avaliam como true ou false.

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 arguments.callee arguments.caller arguments.length Descrio Refere-se funo sendo chamada. Refere-se ao chamamento da funo. 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
Mtodo Array.concat Array.join Array.pop Array.push Array.reverse Array.shift Array.slice Array.sort Descrio Concatena os parmetros e os retorna como uma nova matriz. Rene todos os elementos de uma matriz em uma seqncia de caracteres. Remove o ltimo elemento de uma matriz e retorna seu valor. Adiciona um ou mais elementos ao fim de uma matriz e retorna o novo tamanho da matriz. Inverte a direo de uma matriz. Remove o primeiro elemento de uma matriz e retorna seu valor. Extrai uma seo de uma matriz e a retorna como uma nova matriz. Classifica uma matriz no local.

77

Mtodo Array.sortOn Array.splice Array.toString Array.unshift

Descrio Classifica uma matriz com base em um campo da matriz. Adiciona e/ou remove elementos de uma matriz. Retorna um valor de seqncia de caracteres que representa os elementos no objeto Array. Adiciona um ou mais elementos ao incio de uma matriz e retorna o novo tamanho da matriz.

Resumo de propriedades do objeto Array

Propriedade Array.length Descrio 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

separador

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.

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
Retorna

Um ou mais valores a serem anexados matriz.

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

incio

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.

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

compareFunction

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:

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

Zero ou mais valores a serem inseridos na matriz no ponto de insero especificado no parmetro incio. Este parmetro opcional.

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. Uma seqncia de caracteres que passada para a funo identificada no parmetro

parmetro function.
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
Retorna

Uma expresso a ser convertida em um valor booleano.

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 Boolean.toString Boolean.valueOf Descrio Retorna a representao da seqncia de caracteres (true) ou (false) do objeto Boolean. 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 Button.getDepth Descrio Retorna a profundidade de uma instncia de boto.

Resumo de propriedades do objeto Button

Propriedade Button._alpha Button.enabled Button._focusrect Button._height Button._highquality Button._name Button._parent Button._quality Descrio O valor de transparncia de uma instncia de boto. Indica se o boto est ativo. Indica se um boto focalizado tem um retngulo amarelo em volta dele. A altura de uma instncia de boto, em pixels. Indica a qualidade do filme. O nome de uma instncia de boto. Uma referncia instncia do clipe de filme que o pai dessa instncia. Indica a qualidade do filme.

91

Propriedade Button._rotation Button._soundbuftime Button.tabEnabled Button.tabIndex Button._target Button.trackAsMenu Button._url Button.useHandCursor Button._visible Button._width Button._x Button._xmouse Button._xscale Button._y Button._ymouse Button._yscale

Descrio O grau de rotao de uma instncia de boto. Nmero de segundos para que um som seja pr-carregado. Indica se um boto est includo na ordenao de guia automtica. Indica a ordem de guias de um objeto. O caminho de destino de uma instncia de boto. Indica se outros botes podem receber eventos de liberao de mouse. O URL do arquivo SWF que criou a instncia de boto. Indica se o cursor mo exibido quando o mouse passar sobre um boto. Um valor booleano que determina se a instncia de boto est oculta ou visvel. A largura de uma instncia de boto, em pixels. A coordenada x de uma instncia de boto. A coordenada x do cursor relativa instncia de um boto. O valor que especifica a porcentagem para o dimensionamento horizontal de uma instncia de boto. A coordenada y de uma instncia de boto. A coordenada x do cursor relativa instncia de um boto. 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 Button.onDragOut Button.onDragOver Descrio Chamado enquanto o ponteiro est fora do boto, o boto do mouse pressionado e rolado para fora da rea do boto. 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. Chamada quando uma tecla liberada. Chamada quando o foco removido de um boto. Chamada quando o mouse pressionado enquanto o ponteiro est sobre um boto. Chamada quando o mouse liberado enquanto o ponteiro est sobre um boto. 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. Chamada quando o ponteiro rola para fora da rea de um boto. Chamada quando o ponteiro do mouse rola sobre um boto. Chamada quando um boto tem o foco de entrada e uma tecla liberada.

Button.onKeyUp Button.onKillFocus Button.onPress Button.onRelease Button.onReleaseOutside

Button.onRollOut Button.onRollOver Button.onSetFocus

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
Retorna

O objeto em foco.

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
Retorna

O objeto a perder o foco de teclado.

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"

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.

"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.

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
Retorna

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

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 funo

Um objeto (pode ser um clipe de filme) em que a funo foi definida. 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

Qualquer expresso. Qualquer comando.

107

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
Retorna

Um nmero de cdigo ASCII.

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
Retorna

Um objeto retornado de uma chamada funo setInterval.

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 Color.getRGB Color.getTransform Color.setRGB Color.setTransform Descrio Retorna o valor RGB definido pela ltima chamada setRGB. Retorna a informao de transformao definida pela ltima chamada setTransform. Define a representao hexadecimal do valor RGB de um objeto Color. Define a transformao de cor de um objeto Color.

Construtor do objeto Color

Disponibilidade

Flash Player 5.
Uso

new Color(destino);
Parmetros

destino
Retorna

O nome da instncia de um clipe de filme.

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 rb ga gb ba bb aa ab

a porcentagem do componente vermelho (-100 a 100). o deslocamento do componente vermelho (-255 a 255). a porcentagem do componente verde (-100 a 100). o deslocamento do componente verde (-255 a 255). a porcentagem do componente azul (-100 a 100). o deslocamento do componente azul (-255 a 255). a porcentagem de alpha (-100 a 100). 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
Mtodo CustomActions.get CustomActions.install CustomActions.list CustomActions.uninstall Descrio L o contedo de um arquivo de definio XML de aes personalizadas. Instala um novo arquivo de definio XML de aes personalizadas. Retorna uma lista de todas as aes personalizadas registradas. Remove um arquivo de definio XML de aes personalizadas.

113

CustomActions.get
Disponibilidade

Flash Player 6.
Uso

CustomActions.get(customActionsName)
Parmetros

customActionsName
Retorna

O nome da definio de aes personalizadas a ser recuperada.

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
Retorna

O nome da definio de aes personalizadas a ser instalada. O texto da definio XML a ser instalada.

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
Retorna

O nome da definio de aes personalizadas a ser desinstalada.

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 Date.getDate Date.getDay Date.getFullYear Date.getHours Date.getMilliseconds Date.getMinutes Date.getMonth Date.getSeconds Date.getTime Date.getTimezoneOffset Date.getUTCDate Descrio Retorna o dia do ms de acordo com a hora local. Retorna o dia da semana de acordo com a hora local. Retorna o ano com quatro dgitos de acordo com a hora local. Retorna a hora de acordo com a hora local. Retorna os milissegundos de acordo com a hora local. Retorna os minutos de acordo com a hora local. Retorna o ms de acordo com a hora local. Retorna os segundos de acordo com a hora local. Retorna o nmero de milissegundos desde a meia-noite de 1 de janeiro de 1970, hora universal. Retorna a diferena, em minutos, entre o a hora local do computador e a hora universal. Retorna o dia (data) do ms de acordo com a hora universal.

Dicionrio ActionScript

116

Mtodo Date.getUTCDay Date.getUTCFullYear Date.getUTCHours Date.getUTCMilliseconds Date.getUTCMinutes Date.getUTCMonth Date.getUTCSeconds Date.getYear Date.setDate Date.setFullYear Date.setHours Date.setMilliseconds Date.setMinutes Date.setMonth Date.setSeconds Date.setTime Date.setUTCDate Date.setUTCFullYear Date.setUTCHours Date.setUTCMilliseconds Date.setUTCMinutes Date.setUTCMonth Date.setUTCSeconds Date.setYear Date.toString Date.UTC

Descrio Retorna o dia da semana de acordo com a hora universal. Retorna o ano com quatro dgitos de acordo com a hora universal. Retorna a hora de acordo com a hora universal. Retorna os milissegundos de acordo com a hora universal. Retorna os minutos de acordo com a hora universal. Retorna o ms de acordo com a hora universal. Retorna os segundos de acordo com a hora universal. Retorna o ano de acordo com a hora local. Define o dia do ms de acordo com a hora local. Retorna a nova hora em milissegundos. Define o ano completo de acordo com a hora local. Retorna a nova hora em milissegundos. Define a hora de acordo com a hora local. Retorna a nova hora em milissegundos. Define os milissegundos de acordo com a hora local. Retorna a nova hora em milissegundos. Define os minutos de acordo com a hora local. Retorna a nova hora em milissegundos. Define o ms de acordo com a hora local. Retorna a nova hora em milissegundos. Define os segundos de acordo com a hora local. Retorna a nova hora em milissegundos. Define a data em milissegundos. Retorna a nova hora em milissegundos. Define a data de acordo com a hora universal. Retorna a nova hora em milissegundos. Define o ano de acordo com a hora universal. Retorna a nova hora em milissegundos. Define a hora de acordo com a hora universal. Retorna a nova hora em milissegundos. Define os milissegundos de acordo com a hora universal. Retorna a nova hora em milissegundos. Define os minutos de acordo com a hora universal. Retorna a nova hora em milissegundos. Define o ms de acordo com a hora universal. Retorna a nova hora em milissegundos. Define os segundos de acordo com a hora universal. Retorna a nova hora em milissegundos. Define o ano de acordo com a hora local. Retorna um valor de seqncia de caracteres representando a data e a hora armazenadas no objeto Date especificado. Retorna o nmero de milissegundos entre a meia-noite de 1 de janeiro de 1970, hora universal, e a hora especificada.

117

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 Um inteiro entre 0 (janeiro) e 11 (dezembro). Um inteiro de 1 a 31. Este parmetro opcional. Um inteiro entre 0 (meia-noite) e 23 (11 p.m.). Um inteiro de 0 a 59. Este parmetro opcional. Um inteiro de 0 a 59. Este parmetro opcional. Um inteiro de 0 a 999. Este parmetro opcional.

ano.
ms data hora

minutos segundos

milissegundos
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
Retorna

Um inteiro de 0 a 999.

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
Retorna

Um inteiro de 0 a 59.

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
Retorna

Um inteiro de 0 a 59.

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
Retorna

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

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 ms data

O ano especificado com quatro dgitos completos; por exemplo, 2000. Um inteiro entre 0 (janeiro) e 11 (dezembro). Este parmetro opcional. 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.). Um inteiro de 0 a 59. Este parmetro opcional. Um inteiro de 0 a 59. Este parmetro opcional. Um inteiro de 0 a 999. Este parmetro opcional.

minutos segundos

milissegundos
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
Retorna

Um inteiro de 0 a 999.

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 segundos

Um inteiro de 0 a 59. Um inteiro de 0 a 59. Este parmetro opcional. Um inteiro de 0 a 999. Este parmetro opcional.

milissegundos
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. Um inteiro de 0 a 999. Este parmetro opcional.

milissegundos
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 ms data hora

Um nmero de quatro dgitos; por exemplo, 2000. Um inteiro entre 0 (janeiro) e 11 (dezembro). Um inteiro de 1 a 31. Este parmetro opcional. Um inteiro entre 0 (meia-noite) e 23 (11 p.m.). Um inteiro de 0 a 59. Este parmetro opcional. Um inteiro de 0 a 59. Este parmetro opcional. Um inteiro de 0 a 999. Este parmetro opcional.

minutos segundos

milissegundos
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
Retorna

Qualquer comando.

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
Retorna

O nome da varivel ou do objeto a ser eliminado.

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

O caminho de destino do clipe de filme a ser duplicado. Um identificador exclusivo do clipe de filme duplicado.

135

profundidade

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.

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 comando(s) comando if

Uma expresso que seja avaliada como true ou false. 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 comando(s) comando if

Retorna

Uma expresso que seja avaliada como true ou false. Uma srie alternativa de comandos a ser executada se a condio especificada no for false.

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
Retorna

Nmeros, seqncias de caracteres ou variveis.

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
Mtodo FCheckBox.getEnabled FCheckBox.getLabel FCheckBox.getValue FCheckBox.registerSkinElement FCheckBox.setChangeHandler FCheckBox.setEnabled FCheckBox.setLabel FCheckBox.setLabelPlacement FCheckBox.setSize FCheckBox.setStyleProperty FCheckBox.setValue Descrio Retorna true se a caixa de seleo estiver ativada, false se estiver desativada. Retorna o rtulo aplicado caixa de seleo como uma seqncia de caracteres. Retorna true se a caixa de seleo estiver selecionada, false se no estiver selecionada. Registra um elemento de aparncia em uma propriedade. Especifica um identificador de alterao a ser chamado quando o valor da caixa de seleo alterado. Determina se a caixa de seleo est ativada ou desativada. Especifica texto para o rtulo da caixa de seleo. Especifica se o rtulo exibido esquerda ou direita da caixa de seleo. Define a largura da caixa de seleo, em pixels, e redesenha a caixa. Define uma nica propriedade de estilo para um componente. Marca ou desmarca a caixa de seleo e inicia a funo do identificador de alterao.

141

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. O nome de uma propriedade de FStyleFormat.

styleProperty
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

functionName

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.

location

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.

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).
Retorna

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

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
Retorna

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

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
Retorna

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

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).
Retorna

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

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
Mtodo FComboBox.addItem FComboBox.addItemAt FComboBox.getEnabled FComboBox.getItemAt FComboBox.getLength FComboBox.getRowCount FComboBox.getScrollPosition FComboBox.getSelectedIndex FComboBox.getSelectedItem FComboBox.getValue Descrio Adiciona um novo item ao final da lista da caixa de combinao. Adiciona um novo lista da caixa de combinao no ndice especificado. Retorna true se a caixa de combinao estiver ativada, false se estiver desativada. Retorna o item no ndice especificado como um objeto com as propriedades label e data. Retorna o nmero de itens relacionados na caixa de combinao. Retorna o nmero de linhas visveis na caixa de combinao. Retorna o ndice do item na parte superior da caixa de combinao. Retorna o ndice do item atualmente selecionado. Retorna o item atualmente selecionado como um objeto com as propriedades label e data. 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. Registra um elemento de aparncia em uma propriedade. Remove todos os itens da caixa de combinao. Remove o item no ndice especificado. Substitui o rtulo e os dados de um item no ndice especificado. Atribui uma funo a ser chamada todas as vezes que um item selecionado ou que o usurio insere texto no campo de texto.

FComboBox.registerSkinElement FComboBox.removeAll FComboBox.removeItemAt FComboBox.replaceItemAt FComboBox.setChangeHandler

149

Mtodo FComboBox.setDataProvider FComboBox.setEditable FComboBox.setEnabled FComboBox.setItemSymbol FComboBox.setRowCount FComboBox.setSelectedIndex FComboBox.setSize FComboBox.setStyleProperty FComboBox.setValue FComboBox.sortItemsBy

Descrio Registra um objeto externo no componente como uma fonte de dados. Determina se a caixa de combinao editvel (true) ou esttica (false). Especifica se a caixa de combinao est ativada (true) ou desativada (false). Registra o identificador de vinculao de um smbolo a ser usado para exibir itens de listagem de uma caixa de combinao. Determina o nmero de itens exibidos na caixa de combinao sem uma barra de rolagem. Seleciona o item no ndice especificado. Define a largura em pixels da caixa de combinao. Define uma nica propriedade de estilo para a instncia de um componente. Especifica o texto exibido no campo de texto na parte superior da caixa de combinao editvel. 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. O nome de uma propriedade de FStyleFormat.

styleProperty
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 label data

Um nmero inteiro que especifica a posio de um item de listagem. 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.

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 location

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.

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

dataProvider

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.

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

Retorna

Booleano que especifica se a caixa de combinao editvel (true) ou

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

symbolID

O identificador de vinculao de smbolo para exibir o contedo da caixa de combinao.

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

editableText

Uma seqncia de caracteres que especifica o texto a ser exibido no campo de texto de uma caixa de combinao editvel.

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

fieldName order

Uma seqncia de caracteres que especifica o nome do campo usado para classificao. Este ser normalmente "label" ou "data".

Uma seqncia de caracteres que especifica se os itens devem ser classificados em ordem crescente ("ASC") ou decrescente ("DESC").

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 FListBox.addItem FListBox.addItemAt FListBox.getEnabled FListBox.getItemAt FListBox.getLength FListBox.getRowCount FListBox.getScrollPosition FListBox.getSelectedIndex FListBox.getSelectedIndices FListBox.getSelectedItem FListBox.getSelectedItems FListBox.getSelectMultiple FListBox.getValue FListBox.registerSkinElement FListBox.removeAll FListBox.removeItemAt FListBox.replaceItemAt FListBox.setAutoHideScrollBar Descrio Adiciona um novo item ao final da lista da caixa de listagem. Adiciona um novo item lista da caixa de listagem no ndice especificado. Retorna true se a caixa de listagem estiver ativada, false se estiver desativada. Retorna o rtulo e o valor do item no ndice especificado. Retorna o nmero de itens na caixa de listagem. Retorna o nmero de itens visveis na caixa de listagem. Retorna o ndice do item na parte superior da caixa de listagem. Retorna o ndice do item selecionado por ltimo. Retorna os ndices dos vrios itens selecionados. Retorna o rtulo e o valor do item selecionado. Retorna o rtulo e o valor dos vrios itens selecionados. Retorna true se for permitida seleo mltipla, false se for permitida seleo nica. Retorna o rtulo do item selecionado ou quaisquer outras informaes associadas. Registra um elemento de aparncia em uma propriedade. Remove todos os itens da caixa de listagem. Remove o item no ndice especificado. Substitui o rtulo e os dados de um item em um ndice especificado por um novo rtulo e novos dados. 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 FListBox.setChangeHandler FListBox.setDataProvider FListBox.setEnabled FListBox.setItemSymbol FListBox.setRowCount FListBox.setScrollPosition FListBox.setSelectedIndex FListBox.setSelectedIndices FListBox.setSelectMultiple FListBox.setSize FListBox.setStyleProperty FListBox.setWidth FListBox.sortItemsBy

Descrio Atribui uma funo a ser chamada todas as vezes que a seleo for alterada. Associa um objeto externo caixa de listagem. Especifica se a caixa de listagem est ativada (true) ou desativada (false). Registra o identificador de vinculao de um smbolo a ser usado para exibir itens na caixa de listagem. Retorna o nmero de itens exibidos na caixa de listagem. Faz a caixa de listagem rolar at que o item no ndice especificado seja exibido na parte superior da lista. Seleciona o item no ndice especificado e atualiza a caixa de listagem. Seleciona os itens nos ndices especificados e atualiza a caixa de listagem. Determina se o usurio pode selecionar mais de um item na lista (true) ou no (false). Define a largura e a altura da caixa de listagem, em pixels. Define uma nica propriedade de estilo para um componente. Define a largura da caixa de listagem, em pixels. 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

label data

Uma seqncia de caracteres de texto que especifica o item a ser adicionado lista. 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 label data

Um nmero inteiro que especifica a posio onde inserir o item. Uma seqncia de caracteres de texto que especifica o rtulo do item. 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. O nome de uma propriedade de FStyleFormat.

styleProperty
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 label data

Um nmero inteiro que especifica a posio de um item de listagem. 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.

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

functionName

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

dataProvider

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.

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

enable

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

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

symbolID

O identificador de vinculao de smbolo de um smbolo grfico para exibir o contedo da caixa de listagem.

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
Retorna

Uma matriz de ndices de itens a ser selecionada na caixa de listagem.

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

multipleSelect
Retorna

Um valor Booleano que especifica o modo de seleo mltipla (true) ou o modo de seleo nica (false).

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 height

Um nmero inteiro que especifica a largura da caixa de listagem, em pixels. 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

fieldName order

Uma seqncia de caracteres que especifica o nome do campo usado para classificao. Este ser normalmente "label" ou "data".

Uma seqncia de caracteres que especifica se os itens devem ser classificados em ordem crescente ("ASC") ou decrescente ("DESC").

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. condio

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.

prxima Uma expresso que avaliada aps cada iterao do loop; geralmente uma expresso de atribuio com os operadores ++ (aumento) ou -- (diminuio). comando(s)
Descrio

Uma instruo ou instrues a ser(em) executada(s) no corpo do loop.

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

variableIterant objeto

O nome de uma varivel que age como iterando, fazendo referncia a cada propriedade de um objeto ou elemento em uma matriz. O nome de um objeto a ser repetido. Uma instruo a ser executada para cada iterao.

comando(s)
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 FPushButton.getEnabled FPushButton.getLabel FPushButton.registerSkinElement FPushButton.setClickHandler FPushButton.setEnabled FPushButton.setLabel FPushButton.setSize FPushButton.setStyleProperty Descrio Retorna true se o boto estiver ativado, false se estiver desativado. Retorna o rtulo do boto como uma seqncia de caracteres. Registra um elemento de aparncia em uma propriedade. Especifica a funo chamada quando o usurio libera o boto. Determina se o boto est ativado ou desativado. Define o rtulo do boto durante a execuo. Define a altura e a largura do boto, em pixels. 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. O nome de uma propriedade de FStyleFormat.

styleProperty
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

functionName

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.

location

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.

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 height

Um nmero inteiro que especifica a largura do boto de ao, em pixels. 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 FRadioButton.getData FRadioButton.getEnabled FRadioButton.getLabel FRadioButton.getState FRadioButton.getValue Descrio Retorna um valor de dados para uma instncia do boto de opo. Retorna true se o boto de opo estiver ativado, false se estiver desativado. Retorna o rtulo do boto de opo como uma seqncia de caracteres. Retorna o estado selecionado de uma instncia do boto de opo. Retorna o valor de dados do boto de opo selecionado em um grupo, ou retorna o rtulo, caso nenhum dado tenha sido especificado. Registra um elemento de aparncia em uma propriedade de estilo. Especifica uma funo a ser chamada quando a seleo do boto de opo alterada. Define os dados associados a uma instncia do boto de opo. Determina se o boto de opo est ativado ou desativado. Especifica um nome de grupo para uma instncia de boto de opo ou define um novo nome para um grupo de botes de opo. Aplica um rtulo ao boto de opo durante a execuo. Especifica se o rtulo exibido esquerda ou direita do boto de opo. Define a largura do boto de opo, em pixels. Define o estado selecionado da instncia do boto de opo. Define uma nica propriedade de estilo para uma instncia do componente. Seleciona um boto de opo em um grupo de botes de opo durante a execuo.

FRadioButton.registerSkinElement FRadioButton.setChangeHandler FRadioButton.setData FRadioButton.setEnabled FRadioButton.setGroupName

FRadioButton.setLabel FRadioButton.setLabelPlacement FRadioButton.setSize FRadioButton.setState FRadioButton.setStyleProperty FRadioButton.setValue

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. O nome de uma propriedade de FStyleFormat.

styleProperty
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

functionName

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. 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
Retorna

Uma seqncia de caracteres que especifica o nome de um grupo de botes de opo.

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
Descrio

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

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).
Retorna

Um valor Booleano que indica se o boto de opo est selecionado (true) ou no

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.
Mtodo FScrollBar.getEnabled FScrollBar.getScrollPosition FScrollBar.registerSkinElement Descrio Retorna true se a barra de rolagem estiver ativada, false se estiver desativada. Retorna um nmero inteiro que representa a posio atual da caixa de rolagem (direcionador). 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.

207

Mtodo FScrollBar.setChangeHandler

Descrio 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.) Especifica se a barra de rolagem est ativada (true) ou desativada (false). Especifica se a barra de rolagem horizontal (true) ou vertical (false). Especifica o nmero de posies roladas quando o usurio clica na trilha. Especifica a instncia de campo de texto qual a barra de rolagem se aplica. Define a posio da caixa de rolagem como um nmero inteiro entre minPos e maxPos. Define as propriedades pageSize, minPos e maxPos da barra de rolagem. (Este mtodo no pode ser usado com campos de texto.) Especifica um campo de texto como o destino da barra de rolagem. Define o comprimento da barra de rolagem, em pixels. Especifica o nmero de posies roladas quando o usurio clica na seta de rolagem. Define uma nica propriedade de estilo para um componente.

FScrollBar.setEnabled FScrollBar.setHorizontal FScrollBar.setLargeScroll FScrollBar.setScrollContent FScrollBar.setScrollPosition FScrollBar.setScrollProperties

FScrollBar.setScrollTarget FScrollBar.setSize FScrollBar.setSmallScroll FScrollBar.setStyleProperty

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. Uma seqncia de caracteres que especifica uma propriedade FStyleFormat.

styleProperty
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 location

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.

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

enable

Um valor Booleano que especifica se a barra de rolagem est ativada (true) ou desativada (false).

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

Uma referncia ao campo de texto da barra de rolagem.

213

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 minPos maxPos

Retorna

Um nmero inteiro que representa o nmero de posies exibidas na pgina.

Um nmero inteiro que representa a posio de rolagem mnima. Um nmero inteiro que representa a posio de rolagem mxima.

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

Uma referncia ao campo de texto da barra de rolagem.

Nada.

215

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
Retorna

Um nmero inteiro que especifica o comprimento da barra de rolagem, em pixels.

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

smallScroll

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.

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 FScrollPane.getPaneHeight FScrollPane.getPaneWidth FScrollPane.getScrollContent FScrollPane.getScrollPosition FScrollPane.loadScrollContent FScrollPane.refreshPane FScrollPane.registerSkinElement Descrio Retorna a altura do painel de rolagem. Retorna a largura do painel de rolagem. Retorna uma instncia do contedo exibido no painel de rolagem. Retorna as coordenadas x e y da posio de rolagem atual. Carrega um SWF ou JPEG no painel de rolagem. Redimensiona as barras de rolagem no painel de rolagem quando o contedo muda de tamanho. 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. Define o contedo do painel de rolagem como arrastvel. Define o estilo de rolagem horizontal do painel de rolagem. Define um clipe de filme como destino do painel de rolagem. Faz o painel rolar at as coordenadas x, y especificadas. Define a largura e a altura do painel de rolagem, em pixels. Define uma nica propriedade de estilo para um componente. Define o estilo de rolagem vertical do painel de rolagem.

FScrollPane.setDragContent FScrollPane.setHScroll FScrollPane.setScrollContent FScrollPane.setScrollPosition FScrollPane.setSize FScrollPane.setStyleProperty FScrollPane.setVScroll

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

URL

Uma seqncia de caracteres que especifica o URL de um arquivo SWF ou JPEG a ser carregado no painel de rolagem.

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 location

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.

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. O nome de uma propriedade de FStyleFormat.

styleProperty

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

display

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").

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

x y

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 height

Um nmero inteiro que especifica a largura do painel de rolagem, em pixels. Um nmero inteiro que especifica a altura do painel de rolagem, em pixels.

Retorna

Nada.

225

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

display

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").

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 FStyleFormat.addListener FStyleFormat.applyChanges FStyleFormat.removeListener Descrio Registra um componente em formato de estilo. Aplica as alteraes efetuadas em valores de propriedades de um formato de estilo. 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 FStyleFormat.arrow FStyleFormat.background FStyleFormat.backgroundDisabled FStyleFormat.check FStyleFormat.darkshadow FStyleFormat.face FStyleFormat.foregroundDisabled FStyleFormat.highlight FStyleFormat.highlight3D FStyleFormat.radioDot FStyleFormat.scrollTrack FStyleFormat.selection FStyleFormat.selectionDisabled FStyleFormat.selectionUnfocused Descrio A cor da seta usada em barras de rolagem e listagens suspensas. A cor da poro de fundo de um componente. A cor da poro de fundo de um componente desativado. A cor da marca de seleo em uma caixa de seleo assinalada. A cor da borda interna ou da poro de sombreamento mais escuro de um componente. A cor principal do componente. A cor de primeiro plano do componente. A cor da borda interna ou da poro de sombreamento mais escuro de um componente quando selecionado. A cor da borda externa ou da poro de sombreamento mais claro de um componente quando selecionado. A cor do ponto em um boto de opo assinalado. A cor da trilha em uma barra de rolagem. A cor da barra de seleo que destaca um item de listagem em um componente. A cor da barra de seleo que destaca um item de listagem em um componente desativado. A cor da barra de seleo quando o componente no tem foco de teclado.

Dicionrio ActionScript 228

Propriedade FStyleFormat.shadow FStyleFormat.textAlign FStyleFormat.textBold FStyleFormat.textColor FStyleFormat.textDisabled FStyleFormat.textFont FStyleFormat.textIndent FStyleFormat.textItalic FStyleFormat.textLeftMargin FStyleFormat.textRightMargin FStyleFormat.textSelected FStyleFormat.textSize FStyleFormat.textUnderline

Descrio A cor da borda externa ou da poro de sombreamento claro de um componente. O alinhamento (esquerda, direita ou centro) do texto exibido em um componente. Especifica se o texto ser em negrito (true) ou no (false). A cor de texto padro em todos os componentes atribuda ao formato de estilo. A cor do texto em um componente desativado. O nome da fonte para exibio de texto. O recuo do texto a partir da margem esquerda at o primeiro caractere de texto, em pixels. Especifica se o texto ser em itlico (true) ou no (false). A margem de pargrafo esquerda do texto, em pixels. A margem de pargrafo direita do texto, em pixels. A cor de um item de listagem selecionado em um componente. O tamanho do texto, em pontos. 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.

Retorna

As instncias de componentes a serem registradas em

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
Descrio

O componente a ser removido do formato de estilo.

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 Function.prototype Descrio Refere-se a um objeto que o prottipo de uma classe.

Resumo dos mtodos do objeto Function

Mtodo Function.apply Function.call Descrio Ativa o cdigo ActionScript para chamar uma funo. 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. Uma matriz cujos elementos so passados para myFunction como

argumentsObject

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 parameter1

Especifica o valor de this no corpo da funo. 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 quit fullscreen allowscale Parmetros Nenhum true ou false true ou false Objetivo Fecha o projetor. 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. 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. 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. Executa um aplicativo no projetor. A especificao de true envia todos os eventos de teclas, incluindo as teclas de acelerao,para o identificador onClipEvent(keyDown/ keyUp) no Flash Player.

showmenu

true ou false

exec trapallkeys

Caminho para o aplicativo true ou false

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

Qualquer instruo ActionScript definida para o corpo da funo.

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

(x*x)

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.
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
Retorna

Nmeros, seqncias de caracteres ou variveis

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
Retorna

Uma propriedade de um clipe de filme.

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. especifica uma nova janela. especifica a origem do quadro atual.

_blank

_parent _top

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
Retorna

Uma propriedade do objeto FStyleFormat.

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 frame
Retorna

O nome da cena para onde a reproduo enviada. O nmero do quadro ou rtulo para onde a reproduo enviada.

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 frame
Retorna

O nome da cena para onde a reproduo enviada. O nmero do quadro ou rtulo para onde a reproduo enviada.

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
Descrio

Nmeros, seqncias de caracteres ou variveis.

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 quadro

A cena que deve ser carregada. 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

filename.as
Retorna

O nome do arquivo para o script a ser adicionado ao painel Aes; .as a extenso de arquivo recomendada.

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

order

Um nmero inteiro que especifica a ordem de execuo de blocos de cdigo #initclip. Este um parmetro opcional.

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

object class
Retorna

Um objeto ActionScript. Uma referncia a uma funo construtora ActionScript, como String ou Date.

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
Retorna

Um nmero a ser arredondado para um inteiro.

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
Retorna

Um valor booleano, varivel ou outra expresso a ser avaliada.

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
Retorna

Um valor booleano, varivel ou outra expresso a ser avaliada.

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 Key.addListener Key.getAscii Key.getCode Key.isDown Key.isToggled Key.removeListener Descrio Registra um objeto para receber a notificao quando os mtodos onKeyDown e onKeyUp so chamados. Retorna o valor ASCII da ltima tecla pressionada. Retorna o cdigo de tecla virtual da ltima tecla pressionada. Retorna true se a tecla especificada no parmetro for pressionada. Retorna true se a tecla Num Lock ou Caps Lock estiver ativada. Remove um objeto que foi registrado anteriormente com addListener.

Resumo das propriedades do objeto Key Todas as propriedades do objeto Key so constantes.
Propriedade Key.BACKSPACE Key.CAPSLOCK Key.CONTROL Key.DELETEKEY Key.DOWN Key.END Key.ENTER Key.ESCAPE Key.HOME Key.INSERT Key.LEFT Key.PGDN Key.PGUP Key.RIGHT Key.SHIFT Key.SPACE Key.TAB Key.UP Descrio Constante associada ao valor do cdigo da tecla Backspace (8). Constante associada ao valor do cdigo da tecla Caps Lock (20). Constante associada ao valor do cdigo da tecla Control (17). Constante associada ao valor do cdigo da tecla Delete (46). Constante associada ao valor do cdigo da tecla Seta para baixo (40). Constante associada ao valor do cdigo da tecla End (35). Constante associada ao valor do cdigo da tecla Enter (13). Constante associada ao valor do cdigo da tecla Escape (27). Constante associada ao valor do cdigo da tecla Home (36). Constante associada ao valor do cdigo da tecla Insert (45). Constante associada ao valor do cdigo da tecla Seta para esquerda (37). Constante associada ao valor do cdigo da tecla Page Down (34). Constante associada ao valor do cdigo da tecla Page Up (33). Constante associada ao valor do cdigo da tecla Seta para direita (39). Constante associada ao valor do cdigo da tecla Shift (16). Constante associada ao valor do cdigo de tecla da Barra de espaos (32). Constante associada ao valor do cdigo da tecla Tab (9). Constante associada ao valor do cdigo da tecla Seta para cima (38).

Resumo dos ouvintes do objeto Key

Mtodo Key.onKeyDown Key.onKeyUp Descrio Notificado quando uma tecla pressionada. Notificado quando uma tecla liberada

263

Key.addListener
Disponibilidade

Flash Player 6.
Uso

Key.addListener (newListener)
Parmetros

newListener
Retorna

Um objeto com os mtodos onKeyDown e onKeyUp.

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

O cdigo da tecla Caps Lock (20) ou Num Lock (144).

267

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
Retorna

Um objeto.

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
Retorna

Nmeros, seqncias de caracteres ou variveis.

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
Retorna

Uma seqncia de caracteres. O nome de uma varivel.

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

url

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. Um inteiro que especifica o nvel no qual o filme foi carregado no Flash Player.

nvel

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.
Exemplo

para remover filmes ou imagens carregadas com a ao

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 LoadVars.load LoadVars.getBytesTotal LoadVars.getBytesTotal LoadVars.send LoadVars.sendAndLoad LoadVars.toString Descrio Faz download de variveis de um URL especificado. Retorna o nmero de bytes carregados de um mtodo load ou sendAndLoad. Retorna o nmero total de bytes que sero descarregados por um mtodo load ou sendAndLoad. Envia variveis de um objeto LoadVars para um URL. Envia variveis de um objeto LoadVars para um URL e faz o download da resposta do servidor para um objeto de destino. 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 LoadVars.onLoad Descrio 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).

Retorna

indica se a operao de carregamento foi concluda com xito (true) ou

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. O mtodo "GET" ou "POST" do protocolo HTTP.

destino mtodo
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 objeto LoadVars que recebe as variveis descarregadas.

O URL no qual as variveis devem ser carregadas. O mtodo "GET" ou "POST" do protocolo HTTP.

targetObject mtodo
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 .
targetObject

As variveis so enviadas da mesma forma que LoadVars.send. As variveis so descarregadas em da mesma forma que LoadVars.load.

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
Descrio

Nmeros, seqncias de caracteres ou variveis

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 Math.abs Math.acos Math.asin Math.atan Math.atan2 Math.ceil Math.cos Math.exp Math.floor Math.log Math.max Math.min Math.pow Math.random Math.round Math.sin Math.sqrt Math.tan Descrio Calcula um valor absoluto. Calcula um arco cosseno. Calcula um arco seno. Calcula um arco tangente. Calcula um ngulo do eixo x ao ponto. Arredonda um nmero para o inteiro mais prximo Calcula um cosseno. Calcula um valor exponencial. Arredonda um nmero para o inteiro mais prximo Calcula um logaritmo natural. Retorna o maior de dois inteiros. Retorna o menor de dois inteiros. Calcula x elevado potncia de y. Retorna um nmero pseudo-aleatrio entre 0.0 e 1.0. Arredonda para o inteiro mais prximo. Calcula um seno. Calcula uma raiz quadrada. Calcula uma tangente.

Resumo das propriedades do objeto Math Todas as propriedades do objeto Math so constantes.
Propriedade Math.E Math.LN2 Math.LOG2E Math.LN10 Math.LOG10E Math.PI Math.SQRT1_2 Math.SQRT2 Descrio Constante de Euler e a base de logaritmos naturais (aproximadamente 2,718). O logaritmo natural de 2 (aproximadamente 0,693). O logaritmo de base 2 de e (aproximadamente 1,442). O logaritmo natural de10 (aproximadamente 2,302). O logaritmo de base 10 de e (aproximadamente 0,434). A razo entre a circunferncia de um crculo e o seu dimetro (aproximadamente 3,14159). O inverso da raiz quadrada de 1/2 (aproximadamente 0,707). 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

x y

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

x y

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

x y

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

x y

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

Um nmero ou expresso maior que ou igual a 0.

293

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
Retorna

O nmero a ser convertido em um caractere de vrios bytes.

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
Retorna

Uma seqncia de caracteres.

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
Retorna

O caractere a ser convertido em um nmero de vrios bytes.

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

valor

A seqncia de caracteres de vrios bytes da qual extrair uma nova seqncia de caracteres de vrios bytes. O nmero do primeiro caractere a ser extrado.

ndice contagem

O nmero de caracteres a ser includo na seqncia de caracteres extrada, sem incluir o caractere ndice.

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 method

Um identificador de um objeto. Um identificador de um mtodo. Parmetros que devem ser passados para a funo. Um parmetro opcional.

parmetros
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 Mouse.addListener Mouse.hide Mouse.removeListener Mouse.show Descrio Registra um objeto para receber as notificaes onMouseDown, onMouseMove e onMouseUp. Oculta o ponteiro do mouse no filme. Remove um objeto registrado com o mtodo addListener. Exibe o ponteiro do mouse no filme.

Resumo de ouvintes de Mouse

Mtodo MovieClip.onMouseDown MovieClip.onMouseMove MovieClip.onMouseUp Descrio Notificado quando o boto do mouse pressionado. Notificado quando o boto do mouse movido. Notificado quando o boto do mouse liberado.

Mouse.addListener
Disponibilidade

Flash Player 6.
Uso

Mouse.addListener (newListener)
Parmetros

newListener
Retorna

Um objeto.

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
Retorna

Um objeto.

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 MovieClip.attachMovie MovieClip.createEmptyMovieClip MovieClip.createTextField MovieClip.duplicateMovieClip MovieClip.getBounds MovieClip.getBytesLoaded MovieClip.getBytesTotal MovieClip.getDepth MovieClip.getURL MovieClip.globalToLocal MovieClip.gotoAndPlay MovieClip.gotoAndStop MovieClip.hitTest MovieClip.loadMovie MovieClip.loadVariables MovieClip.localToGlobal MovieClip.nextFrame MovieClip.play MovieClip.prevFrame MovieClip.removeMovieClip MovieClip.setMask MovieClip.startDrag MovieClip.stop MovieClip.stopDrag MovieClip.swapDepths MovieClip.unloadMovie Descrio Anexa um filme biblioteca. Cria um clipe de filme vazio. Cria um campo de texto vazio. Duplica o clipe de filme especificado. Retorna as coordenadas x e y mnimas e mximas de um filme em um espao de coordenadas especificado. Retorna o nmero de bytes carregados do clipe de filme especificado. Retorna o tamanho do clipe de filme em bytes. Retorna a profundidade de um clipe de filme. Recupera um documento de um URL. Converte o objeto Ponto das coordenadas do Palco nas coordenadas locais do clipe de filme especificado. Envia a reproduo para um quadro em especfico no clipe de filme e reproduz o filme. Envia a reproduo para um quadro em especfico no clipe de filme e encerra o filme. Retorna true se h interseo entre a caixa delimitadora do clipe de filme especificado e a caixa delimitadora do clipe de filme de destino. Carrega o filme no clipe de filme. Carrega variveis de um URL ou outro local no clipe de filme Converte um objeto Ponto das coordenadas locais do clipe de filme nas coordenadas globais do Palco. Envia a reproduo para o prximo quadro do clipe de filme. Reproduz o clipe de filme especificado. Envia a reproduo para o quadro anterior do clipe de filme. Remove o clipe de filme da Linha de tempo se ele foi criado com uma ao duplicateMovieClip ou com o mtodo attachMovie. Especifica um clipe de filme como uma mscara para outro clipe de filme. Especifica um clipe de filme como arrastvel e comea a arrast-lo. Pra o filme que est sendo reproduzido no momento. Pra o arraste de qualquer clipe de filme que esteja sendo arrastado. Troca o nvel de profundidade de dois filmes. Remove um filme que foi carregado com a ao loadMovie.

Dicionrio ActionScript 302

Resumo de mtodos de desenho de MovieClip

Mtodo MovieClip.beginFill MovieClip.beginGradientFill MovieClip.clear MovieClip.curveTo MovieClip.endFill MovieClip.lineStyle MovieClip.lineTo MovieClip.moveTo Descrio Comea a desenhar um preenchimento no Palco. Comea a desenhar um preenchimento de gradiente no Palco. Remove todos os comandos de desenho associados a uma instncia de clipe de filme. Desenha uma curva utilizando o ltimo estilo de linha. Conclui o preenchimento especificado por beginFill ou beginGradientFill. Define o trao das linhas criadas com os mtodos lineTo e curveTo. Desenha uma linha utilizando o estilo de linha atual. Move a posio do desenho especificado para determinadas coordenadas.

Resumo das propriedades do objeto MovieClip

Propriedade MovieClip._alpha MovieClip._currentframe MovieClip._droptarget MovieClip.enabled MovieClip.focusEnabled MovieClip._focusrect MovieClip._framesloaded MovieClip._height MovieClip.hitArea MovieClip._highquality MovieClip._name MovieClip._parent MovieClip._rotation MovieClip._soundbuftime MovieClip.tabChildren MovieClip.tabEnabled MovieClip.tabIndex MovieClip._target MovieClip._totalframes Descrio O valor de transparncia de uma instncia de clipe de filme. O nmero do quadro no qual a reproduo est localizada no momento. O caminho absoluto em notao de sintaxe de barra da instncia do clipe de filme na qual um clipe de filme arrastvel foi solto. Indica se um clipe de filme de boto est ativado. Permite que um clipe de filme receba o foco. Indica se um clipe de filme focalizado tem um retngulo amarelo ao seu redor. O nmero de quadros que foram carregados de um filme em fluxo. A altura de uma instncia de clipe de filme em pixels. Designa outro clipe de filme para atuar como a rea de clicagem de um clipe de filme de boto. Define a qualidade de processamento de um filme. O nome da instncia de um clipe de filme. Uma referncia ao clipe de filme que inclui outro clipe de filme. O grau de rotao de uma instncia de clipe de filme. O nmero de segundos decorridos antes de um som comear a ser reproduzido. Indica se os filhos de um clipe de filme so includos na ordenao automtica de guias. Indica se um clipe de filme includo na ordenao de guias. Indica a ordem de guias de um objeto. O caminho de destino de uma instncia de clipe de filme. O nmero total de quadros de uma instncia de clipe de filme.

303

Propriedade MovieClip.trackAsMenu MovieClip._url MovieClip.useHandCursor MovieClip._visible MovieClip._width MovieClip._x MovieClip._xmouse MovieClip._xscale MovieClip._y MovieClip._ymouse MovieClip._yscale

Descrio Indica se outros botes podem receber eventos de liberao de mouse. O URL do arquivo SWF a partir do qual um clipe de filme foi descarregado. Determina se a mo exibida quando um usurio rola o cursor do mouse sobre um clipe de filme de boto. Um valor booleano que determina se uma instncia de clipe de filme est oculta ou visvel. A largura de uma instncia de clipe de filme em pixels. A coordenada x de uma instncia de clipe de filme. A coordenada x do cursor em uma instncia de clipe de filme. O valor que especifica a porcentagem para o dimensionamento horizontal de um clipe de filme. A coordenada y de uma instncia de clipe de filme. A coordenada y do cursor em uma instncia de clipe de filme. O valor que especifica a porcentagem para o dimensionamento vertical de um clipe de filme.

Resumo de manipuladores de evento do objeto MovieClip

Propriedade MovieClip.onData MovieClip.onDragOut MovieClip.onDragOver Descrio Chamada quando todos os dados so carregados em um clipe de filme. Chamada enquanto o ponteiro est fora do boto, o boto do mouse pressionado no interior e rola para fora da rea do boto. 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. 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. Chamada quando uma tecla pressionada. Use os mtodos Key.getCode e Key.getAscii para recuperar informaes sobre a ltima tecla pressionada. Chamada quando uma tecla liberada. Chamada quando o foco removido de um boto. Chamada quando o clipe de filme criado e aparece na Linha de tempo. Chamada quando o boto esquerdo do mouse pressionado. Chamada sempre que o mouse movido. Chamada quando o boto esquerdo do mouse liberado. Chamada quando o mouse pressionado enquanto o ponteiro est sobre um boto. Chamada quando o mouse liberado enquanto o ponteiro est sobre um boto.

MovieClip.onEnterFrame

MovieClip.onKeyDown

MovieClip.onKeyUp MovieClip.onKillFocus MovieClip.onLoad MovieClip.onMouseDown MovieClip.onMouseMove MovieClip.onMouseUp MovieClip.onPress MovieClip.onRelease

Dicionrio ActionScript 304

Propriedade MovieClip.onReleaseOutside

Descrio 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. Chamada quando o ponteiro rola para fora da rea de um boto. Chamada quando o ponteiro do mouse rola sobre um boto. Chamada quando um boto tem o foco de entrada e uma tecla liberada. 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.onRollOut MovieClip.onRollOver MovieClip.onSetFocus MovieClip.onUnload

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 Um inteiro que especifica o nvel de profundidade no qual o filme colocado.

filme.
profundidade

305

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. alfa

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.

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 cores alfas

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

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.

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 Um inteiro que especifica a profundidade do novo clipe de filme.

de filme.
profundidade
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 Um inteiro positivo que especifica a profundidade do novo campo de texto.

de texto.
profundidade x y

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. Um inteiro positivo que especifica a altura do novo campo de texto.

largura altura
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

controlX controlY

Um inteiro que especifica uma posio horizontal relativa ao ponto de registro do clipe de filme pai do ponto de controle. Um inteiro que especifica uma posio vertical relativa ao ponto de registro do clipe de filme pai do ponto de controle.

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.

profundidade

Um nmero exclusivo que especifica o nvel de profundidade no qual o filme especificado deve ser colocado.

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

ponto

O nome ou identificador de um objeto criado com o objeto genrico Object especificando as coordenadas x e y como propriedades.

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
Retorna

O nmero do quadro para o qual a reproduo enviada.

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

O nmero do quadro para o qual a reproduo enviada.

Nada.

321

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

x y

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. shapeFlag

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.

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). alfa

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.

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

x y

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.
loadMovie.

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.

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

ponto

O nome ou identificador de um objeto criado com o objeto Object, que especifica as coordenadas x e y como propriedades.

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

x y

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
Retorna

O objeto que recebe o foco do teclado.

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
Retorna

O objeto que perde o foco.

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
Retorna

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.

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. profundidade

Um nmero que especifica o nvel de profundidade no qual MovieClip deve ser colocado.

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
Retorna

Nmeros, seqncias de caracteres ou variveis.

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
Descrio

Uma varivel ou outra expresso que seja convertida em um valor booleano.

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
Retorna

Uma expresso a ser convertida em um nmero.

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 Number.toString Number.valueOf Descrio Retorna a representao da seqncia de caracteres do objeto Number. Retorna o valor primitivo do objeto Number.

Resumo de propriedades do objeto Number

Propriedade Number.MAX_VALUE Number.MIN_VALUE Number.NaN Number.NEGATIVE_INFINITY Number.POSITIVE_INFINITY Descrio Constante que representa o maior nmero representvel (IEEE 754 de dupla preciso). Esse nmero aproximadamente 1,7976931348623158e+308. Constante que representa o menor nmero representvel (IEEE 754 de dupla preciso). Esse nmero aproximadamente 5e-324. Constante que representa o valor No Nmero (NaN). Constante que representa o valor do infinito negativo. 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

valor

O valor numrico do objeto Number que est sendo criado ou um valor a ser convertido em um nmero.

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

raiz

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.

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 Object.addProperty Object.registerClass Object.toString Object.unwatch Object.valueOf Object.watch Descrio Cria uma propriedade de apanhador/definidor em um objeto. Atribui uma classe do ActionScript a uma instncia de clipe de filme. Converte o objeto especificado em uma seqncia de caracteres e o retorna. Remove o registro criado por um mtodo Object.watch. Retorna o valor primitivo do objeto Object 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 Object.__proto__ Descrio 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. A funo chamada para recuperar o valor da propriedade; este parmetro um objeto

getFunc

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:
Condio de erro prop no um nome de propriedade vlido; por exemplo, uma seqncia de caracteres vazia. getFunc no um objeto de funo vlido. setFunc no um objeto de funo vlido. O que acontece Retorna false e a propriedade no adicionada. Retorna false e a propriedade no adicionada. Retorna false e a propriedade no adicionada.

359

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

symbolID

O identificador de vinculao do smbolo de clipe de filme ou o identificador de seqncia de caracteres da classe do ActionScript.

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

prop

O nome da propriedade de objeto que no dever mais ser observada, como uma seqncia de caracteres.

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 mouseUp keyDown keyUp

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. A ao iniciada quando uma tecla liberada. Use o mtodo Key.getCode para recuperar informaes sobre a ltima tecla pressionada.

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

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

Os comandos a serem executados quando o evento mouseEvent ocorre.

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
Retorna

Uma expresso que pode receber o valor true ou false.

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
Retorna

O caractere a ser convertido em um nmero de cdigo ASCII.

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 retorna 2.5 retorna 3.5e6, or 3500000 retorna NaN retorna 3.75 retorna 0

parseFloat("2.5")

parseFloat("3.5e6")

parseFloat("foobar") parseFloat(" 5.1")

retorna 5.1

parseFloat("3.75math") parseFloat("0garbage")

parseInt
Disponibilidade

Flash Player 5.
Uso

parseInt(expresso, [raiz])
Parmetros

expresso raiz

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.

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.
bmax

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.
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.
bmax

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

nvel

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.

Caixa delimitadora Um modificador que define a rea de impresso do filme. Este parmetro opcional. 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.
bmax

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.
bframe

375

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

nvel

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.

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.
bmax

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.
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"

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

"MEDIUM"

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.

"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.

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
Retorna

Um inteiro.

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.
Retorna

mtodos

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

O nome da instncia de um clipe de filme. Uma propriedade do objeto MovieClip.

Uma ao ou mtodo.

379

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 Selection.addListener Selection.getBeginIndex Selection.getCaretIndex Selection.getEndIndex Selection.getFocus Selection.removeListener Selection.setFocus Selection.setSelection Descrio Registra um objeto para receber notificao quando o mtodo onSetFocus chamado. Retorna o ndice no comeo do intervalo da seleo. Retorna -1 se no houver ndice ou campo selecionado no momento. 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. Retorna o ndice no final do intervalo de seleo. Retorna -1 se no houver ndice ou campo selecionado no momento. 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. Remove um objeto que foi registrado com addListener. Pe em foco o campo de texto associado varivel especificada no parmetro. Define os ndices de incio e de fim do intervalo de seleo.

Resumo de ouvintes do objeto Selection

Mtodo Selection.onSetFocus Descrio Notificado quando o foco de entrada alterado.

Selection.addListener
Disponibilidade

Flash Player 6.
Uso

Selection.addListener(novo_Ouvinte)
Parmetros

novo_Ouvinte
Retorna

Objeto com um mtodo onSetFocus.

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
Retorna

O objeto que deixar de receber notificaes de foco.

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

caminho_varivel

Uma seqncia de caracteres especificando o caminho do nome de uma varivel associada a um campo de texto.

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

Um identificador para conter o valor do parmetro expresso. Um valor atribudo varivel.

Nada.

385

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 objeto

Um nome de funo ou uma referncia a uma funo annima. Um objeto derivado do objeto Object. O nome do mtodo para chamar o parmetro objeto. ou

nome_do_mtodo

intervalo O tempo em milissegundos entre chamadas para o parmetro funo nome_do_mtodo. arg1, arg2, ..., argn nome_do_mtodo.

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

destino

O caminho para o nome da instncia do clipe de filme cuja propriedade ser definida. A propriedade que ser definida. Uma equao que avaliada como o novo valor da propriedade. O novo valor literal da propriedade.

propriedade valor

expresso
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 Sound.attachSound Sound.getBytesLoaded Sound.getBytesTotal Sound.getPan Sound.getTransform Sound.getVolume Sound.loadSound Sound.setPan Sound.setTransform Sound.setVolume Sound.start Sound.stop Descrio Anexa o som especificado no parmetro. Retorna o nmero de bytes carregados para o som especificado. Retorna o tamanho do som em bytes. Retorna o valor da chamada setPan anterior. Retorna o valor da chamada setTransform anterior. Retorna o valor da chamada setVolume anterior. Carrega um arquivo MP3 no Flash Player. Define a distribuio esquerda/direita do som. Define a quantidade de cada canal, esquerdo e direito, a ser reproduzido em cada alto-falante. Define o nvel de volume de um som. Comea a reproduzir um som desde o incio ou, opcionalmente, de um ponto de deslocamento definido no parmetro. Pra o som especificado ou todos os sons em reproduo no momento.

Resumo das propriedades do objeto Sound

Mtodo Sound.duration Sound.position Descrio Tamanho de um som em milissegundos. Nmero de milissegundos em que o som foi reproduzido.

Resumo de identificadores de eventos do objeto Sound

Mtodo Sound.onLoad Sound.onSoundComp lete Descrio Chamado quando um som carregado. Chamado quando a reproduo de um som interrompida.

Construtor do objeto Sound

Disponibilidade

Flash Player 5.
Uso

new Sound([destino])
Parmetros

destino
Retorna

A instncia de clipe de filme em que o objeto Sound opera. Este parmetro opcional.

Nada.

389

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. Valor booleano que indica se o som um evento ou um fluxo de som.

isStreaming
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. Uma funo.

callbackFunction
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. Uma funo.

callbackFunction
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

Um objeto criado com o construtor do objeto Object genrico.

395

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

deslocamento_Segundo

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.

loop

Um parmetro opcional que permite especificar o nmero de vezes em que o som deve ser reproduzido consecutivamente.

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
Descrio

O nmero de segundos decorridos antes que o filme comece a ser reproduzido.

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 Stage.addListener Stage.removeListener Descrio Adiciona um objeto ouvinte ao objeto Stage. Remove um objeto ouvinte do objeto Stage.

Resumo das propriedades do objeto Stage

Mtodo Stage.align Stage.height Stage.width Stage.scaleMode Descrio Alinhamento do filme do Flash no navegador. Altura do objeto Stage, em pixels. Largura do objeto Stage, em pixels. O dimensionamento atual do filme do Flash.

399

Resumo de identificadores de eventos do objeto Stage

Mtodo Stage.onResize Descrio Indica que o filme foi redimensionado.

Stage.addListener
Disponibilidade

Flash Player 6.
Uso

Stage.addListener(meu_Ouvinte)
Parmetros

meu_Ouvinte
Retorna

Objeto que ouve uma notificao de retorno de chamada do evento onResize.

Nada.
Descrio

"noScale".

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").

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 "T" "B" "L" "R" "TL" "TR" "BL" "BR" Vertical superior inferior centro centro superior superior inferior inferior Horizontal centro centro esquerda direita esquerda direita esquerda 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.
Retorna

Um objeto adicionado lista de retorno de chamada de um objeto com o mtodo

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.
"noScale".

A propriedade scaleMode pode usar os valores "exactFit", "showAll", "noBorder" e Qualquer outro valor define a propriedade scaleMode como o padro "showAll".

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 bloqueio

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.
esquerdo, superior, direito, inferior
Retorna

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.

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
Retorna

Expresso para converter em uma seqncia de caracteres.

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)

String (objeto), " " (delimitador de seqncia de

405

" " (delimitador de seqncia de caracteres)

Disponibilidade

Flash Player 4.
Uso

"texto"
Parmetros

texto
Retorna

Um caractere.

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 String.charAt String.charCodeAt String.concat Descrio Retorna o caractere em um local especfico em uma seqncia de caracteres. Retorna o valor do caractere de um ndice determinado como um inteiro de 16 bits entre 0 e 65535. 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. 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. Extrai uma seo de uma seqncia de caracteres e retorna uma nova seqncia de caracteres. Divide um objeto String em uma matriz de seqncias de caracteres separando a seqncia em subseqncias. Retorna um nmero especificado de caracteres em uma seqncia de caracteres, comeando no local especificado no parmetro. Retorna os caracteres entre dois ndices, especificado nos parmetros como uma seqncia de caracteres. Converte a seqncia de caracteres em minsculas e retorna o resultado; no altera o contedo do objeto original. Converte a seqncia de caracteres em maisculas e retorna o resultado; no altera o contedo do objeto original.

String.lastIndexOf

String.slice String.split String.substr String.substring String.toLowerCase String.toUpperCase

Resumo de propriedades do objeto String

Propriedade String.length Descrio Retorna o tamanho da seqncia de caracteres

407

Construtor do objeto String

Disponibilidade

Flash Player 5.
Uso

new String(valor)
Parmetros

valor
Retorna

O valor inicial do objeto new String.

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
Retorna

O nmero do caractere a ser retornado na seqncia de caracteres.

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
Retorna

Zero ou mais valores a serem concatenados.

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
Retorna

Inteiros decimais que representam valores ASCII.

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
Retorna

Um inteiro que especifica o ponto inicial para procurar pela subseqncia de parmetro opcional.

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

incio

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.

fim

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.

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
Retorna

O nmero de itens que devem ser colocados na matriz. Este parmetro opcional.

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 contagem

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.

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 arg1

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

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 (===). defaultClause

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 (===).

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 System.capabilities.hasAudioEncoder System.capabilities.hasAccessibility System.capabilities.hasAudio System.capabilities.hasMP3 System.capabilities.language System.capabilities.manufacturer System.capabilities.os System.capabilities.pixelAspectRatio System.capabilities.screenColor System.capabilities.screenDPI Descrio Indica os codificadores de udio suportados. Indica se o dispositivo atende aos padres de acessibilidade. Indica se o dispositivo tem recursos de udio. Indica se o dispositivo tem um decodificador MP3. Indica o idioma suportado pelo Flash Player. Indica o fabricante do Flash Player. Indica o sistema operacional que hospeda o Flash Player. Indica a proporo de pixels da tela. Indica se a tela colorida, em preto-e-branco ou em tons de cinza. 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 System.capabilities.hasVideoEncoder Indica a verso mais antiga do Flash Player para a qual h suporte. 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 Ingls Francs Coreano Japons Sueco Alemo Espanhol Italiano Chins Simplificado Chins Tradicional Portugus Polons Hngaro Tcheco Turco Finlands Dinamarqus Noruegus Holands Russo Outros/Desconhecidos Marca en fr ko ja sv de es it zh zh pt pl hu cs tr fi da no nl ru xu Repblica Popular da China (Chins Simplificado) = CN Taiwan (Chins Tradicional) = TW Pases e Marcas Suportados Estados Unidos = US, Reino Unido = UK

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

Os comandos que sero executados se a condio for avaliada como true.

Nada.

423

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 TextField.addListener TextField.getDepth TextField.getNewTextFormat TextField.removeListener TextField.removeTextField TextField.setNewTextFormat TextField.replaceSel TextField.setTextFormat Descrio Registra um objeto para receber notificao quando os eventos onChanged e oNScroller forem chamados. Retorna a espessura de um campo de texto. Obtm o formato de texto padro atribudo ao texto recm-inserido. Remove um objeto ouvinte. Remove um campo de texto que foi criado com MovieClip.createTextField. Define um objeto de formato de texto para o texto que inserido por um usurio ou por um mtodo. Substitui a seleo atual. Define o formato de texto padro atribudo ao texto recm-inserido.

Resumo das propriedades do objeto TextField

Propriedade TextField._alpha TextField.autoSize TextField.background TextField.backgroundColor TextField.border TextField.borderColor TextField.bottomScroll TextField.embedFonts TextField._highquality TextField._height Descrio O valor da transparncia de uma instncia de campo de texto. Controla o alinhamento automtico e o dimensionamento de um campo de texto. Indica se o campo de texto tem um preenchimento de fundo. Indica a cor do preenchimento de fundo. Indica se o campo de texto tem uma borda. Indica a cor da borda. A linha visvel mais inferior em um campo de texto. Indica se o campo de texto usa contornos de fontes incorporadas ou fontes de dispositivo. Indica a qualidade do filme. 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. Indica o valor de rolagem horizontal de um campo de texto. Indica a posio de rolagem mxima atual de um campo de texto. Contm uma representao HTML do contedo de um campo de texto. O nmero de caracteres em um campo de texto. O nmero mximo de caracteres que um campo de texto pode conter. O valor mximo de TextField.hscroll. O valor mximo de TextField.scroll. Indica se o campo de texto contm vrias linhas. O nome de uma instncia de campo de texto.

TextField.hscroll TextField.html TextField.htmlText TextField.length TextField.maxChars TextField.maxhscroll TextField.maxscroll TextField.multiline TextField._name

425

Propriedade TextField._parent TextField.password TextField._quality TextField.restrict TextField._rotation TextField.scroll TextField.selectable TextField._soundbuftime TextField.tabEnabled TextField.tabIndex TextField.text TextField.textColor TextField.textHeight TextField.textWidth TextField.type TextField._url TextField.variable TextField._visible TextField._width

Descrio Uma referncia instncia que o pai desta instncia; seja do tipo Button ou MovieClip. Indica se um campo de texto oculta os caracteres de entrada. Indica a qualidade de um filme. O conjunto de caracteres que um usurio pode digitar em um campo de texto. O grau de rotao de uma instncia de campo de texto. Indica a posio de rolagem atual de um campo de texto. Indica se um campo de texto pode ser selecionado. A quantidade de tempo em que um som deve ser armazenado em pr-buffer antes de ser reproduzido. Indica se um clipe de filme est includo na ordenao de tabulao automtica. Indica a ordem de guias de um objeto. O texto atual no campo de texto. A cor do texto atual no campo de texto. A altura da caixa delimitadora do campo de texto. A largura da caixa delimitadora do campo de texto. Indica se um campo de texto dinmico ou de entrada. A URL do arquivo SWF que criou a instncia de campo de texto. O nome da varivel associada ao campo de texto. Um valor booleano que determina se uma instncia de campo de texto est oculta ou visvel. 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. Indica se o campo de texto faz quebra automtica de linha. A coordenada x de uma instncia de campo de texto. A coordenada x do cursor relativo a uma instncia de campo de texto. O valor que especifica a porcentagem para dimensionar horizontalmente uma instncia de campo de texto. A coordenada y de uma instncia de campo de texto. A coordenada y do cursor relativo a uma instncia de campo de texto. O valor que especifica a porcentagem para dimensionar verticalmente uma instncia de campo de texto.

TextField.wordWrap TextField._x TextField._xmouse TextField._xscale TextField._y TextField._ymouse TextField._yscale

Dicionrio ActionScript 426

Resumo de identificadores de eventos do objeto TextField

Mtodo TextField.onChanged TextField.onKillFocus TextField.onScroller TextField.onSetFocus Descrio Chamado quando o campo de texto alterado. Chamado quando o campo de texto perde o foco. Chamado quando a propriedade scroll, maxscroll, hscroll, maxhscroll ou bottomscroll de um campo de texto alterada. Chamado quando o campo de texto recebe o foco.

Resumo de ouvintes do objeto TextField

Mtodo TextField.onChanged TextField.onScroller Descrio Notificado quando o campo de texto alterado. 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

Um objeto com notificaes dos eventos onChanged e onScroller.

Nada.

427

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
Retorna

Um inteiro que especifica um caractere em uma seqncia de caracteres.

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
Retorna

O objeto em foco.

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
Retorna

O objeto que perde o foco.

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"

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

"MEDIUM"

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.

"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.

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

ouvinte
Retorna

O objeto que deixar de receber notificaes de foco.

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

Uma seqncia de caracteres.

Nada.

439

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
Retorna

Uma instncia do objeto TextFormat.

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.
incio_ndice
Exemplo

Uso 3: aplica as propriedades do parmetro textFormat ao intervalo de texto do parmetro ao parmetro fim_ndice.

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 TextFormat.getTextExtent Descrio 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 TextFormat.align TextFormat.blockIndent TextFormat.bold TextFormat.bullet TextFormat.color TextFormat.font TextFormat.indent TextFormat.italic TextFormat.leading TextFormat.leftMargin TextFormat.rightMargin TextFormat.tabStops TextFormat.target TextFormat.size TextFormat.underline TextFormat.url Descrio Indica o alinhamento de um pargrafo. Indica o recuo de bloco em pontos. Indica se o texto est em negrito. Indica se o texto est ou no em uma lista com marcadores. Indica a cor do texto. Indica o nome da fonte do texto com um formato de texto. Indica o recuo da margem esquerda ao primeiro caractere no pargrafo. Indica se o texto est em itlico. Indica a quantidade de espao vertical entre as linhas. Indica a margem esquerda do pargrafo, em pontos. Indica a margem direita do pargrafo, em pontos. Especifica interrupes de tabulao personalizadas. Indica a janela em um navegador na qual um hiperlink exibido. Indica o tamanho do ponto do texto. Indica se o texto est sublinhado. 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 tamanho

O nome de uma fonte de texto como uma seqncia de caracteres. Um inteiro que indica o tamanho do ponto.

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 itlico

Um valor Booleano que indica se o texto est em negrito. Um valor Booleano que indica se o texto est em itlico. Um valor Booleano que indica se o texto est sublinhado.

sublinhado url

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.

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 nmero que indica a quantidade de espao vertical entre as linhas.

Um inteiro que indica o recuo da margem esquerda ao primeiro caractere no pargrafo.

entrelinhamento
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

expresso

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.

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
Descrio

Seqncia de caracteres, clipe de filme, boto, objeto ou funo.

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:
Parmetro String MovieClip Button Campo de texto Number Booleano Objeto Funo Sada seqncia de caracteres movieclip objeto objeto number boolean objeto function

459

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
Retorna

O caminho de destino de um clipe de filme.

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
Retorna

O nvel (_levelN) de um filme carregado.

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
Retorna

Um identificador.

O valor atribudo varivel.

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

condio

A expresso que reavaliada sempre que a ao while executada. Se o comando for avaliado como true, comando(s) ser executado. O cdigo que ser executado se a condio for avaliada como true.

comando(s)
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 2

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.

3 4

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. Uma ao ou grupo de aes entre chaves.

comando(s)
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
Mtodo XML.appendChild XML.cloneNode XML.createElement XML.createTextNode XML.getBytesLoaded XML.getBytesTotal Descrio Anexa um n ao fim da lista filha do objeto especificado. Clona o n especificado e, opcionalmente, clona recursivamente todos os filhos. Cria um novo elemento XML. Cria um novo n de texto XML. Retorna o nmero de bytes carregados do documento XML especificado. Retorna o tamanho do documento XML em bytes.

467

Mtodo XML.hasChildNodes XML.insertBefore XML.load XML.parseXML XML.removeNode XML.send XML.sendAndLoad XML.toString

Descrio Retorna true se o n especificado tiver ns filhos; caso contrrio, retorna false. Insere um n na frente de um n existente na lista de filhos do n especificado. Carrega um documento (especificado pelo objeto XML) a partir de uma URL. Analisa um documento XML na rvore de objeto XML especificada. Remove o n especificado de seu pai. Envia o objeto XML especificado para uma URL. Envia o objeto XML especificado para uma URL e carrega a resposta do servidor em outro objeto XML. Converte o n especificado e todos os seus filhos em texto XML.

Resumo das propriedades do objeto XML

Propriedade XML.contentType XML.docTypeDecl XML.firstChild XML.ignoreWhite XML.lastChild XML.load XML.nextSibling XML.nodeName XML.nodeType XML.nodeValue XML.parentNode XML.previousSibling XML.status XML.xmlDecl Descrio Indica o tipo de MIME transmitido para o servidor. Define e retorna informaes sobre a declarao DOCTYPE de um documento XML. Faz referncia ao primeiro filho na lista do n especificado. Quando definida como true, os ns de texto que s contm espao em branco so descartados durante o processo de anlise. Faz referncia ao ltimo filho na lista do n especificado. Verifica se o objeto XML especificado foi carregado. Faz referncia ao prximo irmo na lista de filhos do n pai. Retorna o nome da marca de um elemento XML. Retorna o tipo do n especificado (elemento XML ou n de texto). Retorna o texto do n especificado se o n for um n de texto. Faz referncia ao n pai do n especificado. Faz referncia ao irmo anterior na lista de filhos do n pai. Retorna um cdigo de status numrico que indica o xito ou a falha de uma operao de anlise de um documento XML. Define e retorna informaes sobre uma declarao de um documento XML.

Resumo de colees do objeto XML

Mtodo XML.attributes XML.childNodes Descrio Retorna um vetor associativo que contm todos os atributos do n especificado. Retorna um vetor que contm referncias aos ns filhos do n especificado.

Resumo de identificadores de eventos do objeto XML

Mtodo XML.onData Descrio 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. Uma funo de retorno de chamada para load e sendAndLoad.

XML.onLoad

Dicionrio ActionScript 468

Construtor do objeto XML

Disponibilidade

Flash Player 5.
Uso

new XML([origem])
Parmetros

origem
Retorna

O texto XML analisado para criar o novo objeto XML.

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
Retorna

O n filho a ser adicionado lista de filhos do objeto XML especificado.

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

profundidade

Valor booleano que especifica se os filhos do objeto XML especificado so clonados recursivamente.

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
Retorna

O texto usado para criar o novo n de texto.

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
Descrio

Um valor Booleano (true ou false).

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. O n antes do ponto de insero de n_Filho.

n_anterior
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

xito

Um valor booleano que indica se o objeto XML foi carregado com xito por meio de uma operao XML.load ou XML.sendAndLoad.

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
Retorna

O texto XML a ser analisado e passado para o objeto XML especificado.

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 XMLSocket.close XMLSocket.connect XMLSocket.send Descrio Fecha uma conexo de soquete aberta. Estabelece uma conexo com o servidor especificado. Envia um objeto XML para o servidor.

Resumo de identificadores de eventos do objeto XMLSocket

Mtodo XMLSocket.onClose XMLSocket.onConnect XMLSocket.onData XMLSocket.onXML Descrio Uma funo de chamada que chamada quando uma conexo XMLSocket fechada. Uma funo de chamada que chamada quando uma conexo XMLSocket estabelecida. Uma funo de retorno de chamada que chamada aps o download de uma mensagem XML do servidor. 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

host

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

Retorna

booleano que indica se uma conexo de soquete foi estabelecida com xito

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
Retorna

Um objeto XML ou outros dados a serem transmitidos para o servidor.

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