Professional Documents
Culture Documents
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:
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
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
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)
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
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
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
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 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); }
39
! (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
! 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
Flash Player 6.
Uso
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
% (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
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
% (mdulo)
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
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
Flash Player 4.
Uso
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!"); }
Flash Player 5.
Uso
Nenhum.
Retorna
Nada.
Dicionrio ActionScript
44
Descrio
Operador (atribuio composta bit a bit); atribui a expresso1 o valor da expresso1 & Por exemplo, as duas expresses a seguir so idnticas.
() (parnteses)
Disponibilidade
Flash Player 4.
Uso
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
with
(subtrao)
Disponibilidade
Flash Player 4.
Uso
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
O resultado -5.
Dicionrio ActionScript
46
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
* (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
*= (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
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
Dicionrio ActionScript
48
. (ponto).
Disponibilidade
Flash Player 4.
Uso
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
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
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 Uma expresso que avaliada para um valor booleano, normalmente uma expresso de comparao como x < 5. expresso2, expresso3
Retorna
Nada.
Descrio
Operador; instrui o Flash a avaliar expresso1 e, se o valor de expresso1 for true, ele retornar o valor de expresso2; caso contrrio, retornar o valor de expresso3.
Exemplo
O comando a seguir atribui o valor de varivel x a varivel z, pois expresso1 foi avaliada como true:
x = 5; y = 10; z = (x < 6) ? x: y; trace (z); // retorna 5
/ (diviso)
Disponibilidade
Flash Player 4.
Uso
expresso1 / expresso2
Parmetros
expresso
Retorna
Nada.
Descrio
Operador (aritmtico); divide expresso1 por expresso2. O resultado da operao de diviso um nmero de dupla preciso e ponto flutuante.
Exemplo
O comando a seguir divide o nmero de ponto flutuante 22,0 por 7,0 e exibe o resultado na janela Sada.
trace(22,0 / 7,0);
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
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
// (delimitador de comentrio)
/= (atribuio de diviso)
Disponibilidade
Flash Player 4.
Uso
expresso1 /= expresso2
Parmetros
expresso1,expresso2
Retorna
Nada.
Descrio
Operador (atribuio composta aritmtica); atribui a expresso1 o valor da expresso1 / expresso2. Por exemplo, os dois comandos a seguir so equivalentes:
x /= y x = x / y
Exemplo
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;
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
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)
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
{} (inicializador de objeto)
Disponibilidade
Flash Player 5.
Uso
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
Object (objeto)
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
57
|| (OR lgico)
Disponibilidade
Flash Player 4.
Uso
expresso1 || expresso2
Parmetros
expresso1,expresso2
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
Flash Player 5.
Uso
expresso1
Parmetros
|= expresso2
expresso1,expresso2
Retorna
Nenhum.
Descrio
Operador (atribuio bit a bit); atribui a expresso1 o valor de expresso1 | expresso2. Por exemplo, os dois comandos a seguir so equivalentes:
x |= y; x = x | y;
Exemplo
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
expresso1 + expresso2
Parmetros
expresso1,expresso2
Retorna
Nenhum.
Descrio
Operador; adiciona expresses numricas ou concatena (combina) seqncias de caracteres. Se uma expresso for uma seqncia de caracteres, todas as outras expresses so convertidas em seqncias de caracteres e concatenadas. Se ambas as expresses forem inteiras, a soma ser um inteiro; se uma ou ambas as expresses forem nmeros de ponto flutuante, a soma ser um nmero de ponto flutuante.
Exemplo
O exemplo a seguir concatena duas seqncias de caracteres e exibe o resultado na janela Sada.
nome = "Cola"; instrumento = "Baterias"; trace (nome + " toca " + instrumento);
Dicionrio ActionScript
60
Exemplo
As variveis associadas a campos de texto dinmico e de entrada tm a seqncia de caracteres como tipo de dado. No exemplo a seguir, o depsito da varivel um campo de texto de entrada no Palco. Depois que um usurio inserir um valor, o script tenta adicionar o depsito a oldBalance. Contudo, como depsito um tipo de dado de seqncia de caracteres, o script concatena (combina os dados para formar uma seqncia de caracteres) os valores da varivel em vez de som-los.
oldBalance = 1345,23; currentBalance = deposit + oldBalance; trace (currentBalance);
Por exemplo, se um usurio inserir 475 no campo de texto de depsito, a ao trace envia o valor 4751345,23 para a janela Sada. Para corrigir isso, use a funo Number para converter a seqncia de caracteres em um nmero, como no exemplo a seguir:
currentBalance = Number(deposit) + oldBalance;
Exemplo
Este comando adiciona os 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
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
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)
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
expresso1,expresso2
Descrio
Operador (comparao); compara duas expresses e determina se expresso1 menor que expresso2; em caso positivo, o operador retorna true. Se expresso1 for maior ou igual a expresso2, o operador retorna false. As expresses de seqncia de caracteres so avaliadas em ordem alfabtica; todas as letras maisculas vm antes das minsculas.
Dicionrio ActionScript
62
Exemplo
Os exemplos a seguir ilustram retornos true e false para comparaes numricas e de seqncias de caracteres:
3 < 10; // true 10 < 3; // false "Allen" < "Jack"; // true "Jack" < "Allen"; // false "11" < "3"; //true "11" < 3; // comparao numrica // false "C" < "abc"; // false "A" < "a"; // true
Flash Player 5.
Uso
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
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)
Flash Player 5.
Uso
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)
Dicionrio ActionScript
64
Parmetros
expresso1,expresso2
Retorna
Nada.
Descrio
Operador (comparao); compara duas expresses e determina se expresso1 menor ou igual aexpresso2 ; em caso positivo, o operador retorna true. Se expresso1 for maior que expresso2, o operador retorna false. As expresses de seqncia de caracteres so avaliadas em ordem alfabtica; todas as letras maisculas vm antes das minsculas. No Flash 5, o operador menor ou igual a (<=) um operador de comparao, com capacidade para gerenciar vrios tipos de dados. No Flash 4, <= um operador numrico. Os arquivos do Flash 4 trazidos para o ambiente de criao Flash 5 passam por um processo de converso para manter a integridade dos tipos de dados. O exemplo a seguir ilustra a converso de um arquivo do Flash 4 que contm uma comparao do tipo numrica.
Exemplo
Os exemplos a seguir ilustram resultados true e false para comparaes numricas e de seqncias de caracteres:
5 <= 10; // true 2 <= 2; // true 10 <= 3; // false "Allen" <= "Jack"; // true "Jack" <= "Allen"; // false "11" <= "3"; //true "11" <= 3; // comparao numrica // false "C" <= "abc"; // false "A" <= "a"; // true
65
<> (diferena)
Disponibilidade
Flash 2.
Uso
expresso1,expresso2
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
expresso1
Parmetros
= expresso2
expresso1 expresso2
Retorna
Nada.
Descrio
Operador; atribui o tipo de expresso2 (o parmetro da direita) varivel, ao elemento da matriz ou propriedade em expresso1.
Dicionrio ActionScript
66
No Flash 5, = um operador de atribuio e o operador == usado para avaliar a igualdade. No Flash 4, = um operador de igualdade numrico. Os arquivos do Flash 4 trazidos para o ambiente de criao Flash 5 passam por um processo de converso para manter a integridade dos tipos de dados.
Exemplo
O exemplo a seguir usa o operador de atribuio para atribuir o tipo de dado numrico varivel x.
x = 5
O exemplo a seguir usa o operador de atribuio para atribuir o tipo de dado de seqncia de caracteres varivel x.
x = "hello"
Consulte tambm
== (igualdade)
-= (atribuio de subtrao)
Disponibilidade
Flash Player 4.
Uso
expresso1 -= expresso2
Parmetros
expresso1,expresso2
Retorna
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
67
== (igualdade)
Disponibilidade
Flash Player 5.
Uso
expresso1 == expresso2
Parmetros
expresso1,expresso2
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:
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
Dicionrio ActionScript
68
Flash Player 6.
Uso
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:
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
69
Flash Player 5.
Uso
expresso1,expresso2
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).
expresso1, expresso2
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
Flash Player 5.
Uso
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
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
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
71
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
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
Dicionrio ActionScript
72
Flash Player 5.
Uso
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
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
Flash Player 5.
Uso
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
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, condio2
Retorna
Nada.
Descrio
Operador; executa uma operao lgica AND no Flash Player 4. Se ambas as expresses forem avaliadas como true, toda a expresso true. Esse operador est obsoleto no Flash 5 e os usurios so incentivados a usar o novo operador && .
Consulte tambm
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
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); } };
}
}
Dicionrio ActionScript
76
arguments.caller
Disponibilidade
Flash Player 6.
Uso
arguments.caller
Descrio
arguments.length
Disponibilidade
Flash Player 6.
Uso
arguments.length
Descrio
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
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.
Flash Player 5.
Uso
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(" + "));
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.concat
Disponibilidade
Flash Player 5.
Uso
myArray.concat(valor0,valor1,...valorN)
Parmetros
valor0,...valorN
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
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
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
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
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 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:
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
Sada:
oranges,apples,strawberries,pineapples,cherries exibido apples,cherries,oranges,pineapples,strawberries
Dicionrio ActionScript
84
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
incio
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
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
da matriz.
Retorna
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>";
Boolean (funo)
Disponibilidade
Flash Player 5.
Uso
Booleano(expresso)
Parmetros
expresso
Retorna
Nada.
Descrio
Funo; converte a expresso do parmetro em um valor booleano e retorna um valor da seguinte maneira:
Se expresso for um valor booleano, o valor de retorno ser expresso. Se expresso for um nmero e esse no for zero, o valor de retorno ser true, caso contrrio,
o valor de retorno ser false.
Se expresso for uma seqncia de caracteres, o mtodo toNumber ser chamado e o valor de
retorno ser true se o nmero no for zero, caso contrrio, o valor de retorno ser false.
Se expresso for indefinida, o valor de retorno ser false. Se expresso for um clipe de filme ou um objeto, o valor de retorno ser true.
Dicionrio ActionScript
88
Boolean (objeto)
O objeto Boolean um objeto envoltrio que funciona da mesma forma que o objeto Boolean JavaScript padro. Use o objeto Boolean para recuperar o tipo de dados primitivo ou a representao de uma seqncia de caracteres do objeto Boolean. No Flash MX, o objeto Boolean se tornou um objeto nativo. Assim, voc poder observar uma melhora radical no desempenho. Use o construtor new Boolean() para criar uma instncia do objeto Boolean antes de chamar seus mtodos. Resumo de mtodos do objeto Boolean
Mtodo 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.
Flash Player 5.
Uso
new Boolean(x)
Parmetros
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
89
Boolean.toString
Disponibilidade
Flash Player 5.
Uso
myBoolean.toString()
Parmetros
Nenhum.
Retorna
Nada.
Descrio
Boolean.valueOf
Disponibilidade
Flash Player 5.
Uso
Boolean.valueOf()
Parmetros
Nenhum.
Retorna
Nada.
Descrio
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
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.
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.
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
93
Button._height
Disponibilidade
Flash Player 6.
Uso
myButton._height
Descrio
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
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
};
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
oldFocus
Retorna
Nada.
Descrio
Manipulador de eventos; chamado quando um boto recebe foco de teclado. O parmetro oldFocus o objeto que perde o foco. Por exemplo, se o usurio pressionar a tecla Tab para mover o foco de entrada de um campo de texto para um boto, o parmetro oldFocus conter a instncia do campo de texto. Se nenhum objeto possua o foco anteriormente, oldFocus conter um valor null.
Button._parent
Disponibilidade
Flash Player 6.
Uso
_parent.property
Descrio
Propriedade; especifica ou retorna uma referncia ao clipe de filme ou objeto que contm o clipe de filme ou objeto atual. O objeto atual aquele que contm o cdigo do ActionScript que faz referncia a _parent. Use _parent para especificar um caminho relativo para clipes de filme ou objetos que estiverem acima do clipe de filme ou objeto atual. possvel usar _parent para subir vrios nveis na lista de exibio, conforme mostrado a seguir:
_parent._parent._alpha = 20;
Consulte tambm
_root, targetPath
Button._quality
Disponibilidade
Flash Player 6.
Uso
myButton._quality
Descrio
Propriedade (global); define ou recupera a qualidade usada para um filme. As fontes de dispositivo so sempre serrilhadas, sendo assim no so afetadas pela propriedade _quality.
"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
_highquality, toggleHighQuality
Button._rotation
Disponibilidade
Flash Player 6.
Uso
myButton._rotation
Descrio
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.
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
MovieClip._width
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._xmouse
Disponibilidade
Flash Player 6.
Uso
myButton._xmouse
Descrio
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
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._ymouse
Disponibilidade
Flash Player 6.
Uso
myButton._ymouse
Descrio
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
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
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 comandos
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
chr
Disponibilidade
Flash Player 4. Esta funo foi reprovada no Flash 5 e substituda pelo mtodo String.fromCharCode.
Uso
chr(nmero)
Parmetros
nmero
Retorna
Nada.
Descrio
String.fromCharCode
clearInterval
Disponibilidade
Flash Player 6.
Uso
clearInterval( intervalID )
Parmetros
intervalID
Retorna
Nada.
Descrio
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.
Flash Player 5.
Uso
new Color(destino);
Parmetros
destino
Retorna
Nada.
Descrio
Construtor; cria uma instncia do objeto Color para o clipe de filme especificado pelo parmetro destino. Depois ser possvel usar os mtodos desse objeto Color para alterar a cor de todo o clipe de filme de destino.
109
Exemplo
O exemplo a seguir cria uma instncia do objeto Color denominado myColor para o clipe de filme myMovieClip e define seu valor RGB:
myColor = new Color(myMovieClip); myColor.setRGB(0xff9933);
Color.getRGB
Disponibilidade
Flash Player 5.
Uso
myColor.getRGB()
Parmetros
Nenhum.
Retorna
Nada.
Descrio
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
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).
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
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
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
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:
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
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 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.
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.
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
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
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.
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
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 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.
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
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
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
Retorna
Um inteiro.
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
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
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());
Date.UTC
Disponibilidade
Flash Player 5.
Uso
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.
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
133
delete
Disponibilidade
Flash Player 5.
Uso
delete referncia
Parmetros
referncia
Retorna
Nada.
Descrio
Operador; elimina o objeto ou a varivel especificada pelo parmetro referncia e retorna true se o objeto for excludo com xito; do contrrio, retorna false. Este operador til para liberar memria usada pelos scripts. Embora delete seja um operador, normalmente ele usado como um comando, como no exemplo a seguir:
delete x;
O operador delete pode falhar e retornar false se o parmetro de referncia no existir ou no puder ser excludo. Objetos e propriedades predefinidos e variveis declaradas com var no podem ser excludas. No possvel usar o operador delete para remover clipes de filme.
Exemplo
O exemplo a seguir cria um objeto, usa-o e o exclui quando no for mais necessrio.
account = new Object(); account.name = 'Jon'; account.balance = 10000; delete account;
Exemplo
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
condio
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
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
else
Disponibilidade
Flash Player 4.
Uso
Uma expresso que seja avaliada como true ou false. Uma srie alternativa de comandos a ser executada se a condio especificada no for false.
Retorna
Nada.
Descrio
if
else if
Disponibilidade
Flash Player 4.
Uso
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
#initclip
Flash Player 4. Esse operador foi substitudo no Flash 5 pelo operador == (igualdade).
Uso
expresso1 eq expresso2
Parmetros
expression1,expression2
Retorna
Nada.
Descrio
Operador de comparao; avalia se duas expresses so iguais e retorna o valor true se a representao da seqncia de caracteres da expresso1 for igual representao da seqncia de caracteres da expresso2; caso contrrio, a operao retorna o valor false.
Consulte tambm
== (igualdade)
escape
Disponibilidade
Flash Player 5.
Uso
escape(expresso)
Parmetros
expresso
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
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
true
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
FCheckBox.setValue
FCheckBox.getLabel
Disponibilidade
Flash Player 6.
Uso
myCheckBox.getEnabled()
Parmetros
Nenhum.
Retorna
FCheckBox.setLabel
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
FCheckBox.setValue
FCheckBox.registerSkinElement
Disponibilidade
Flash Player 6.
Uso
myCheckBox.registerSkinElement(element, styleProperty)
Parmetros
element
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.
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
145
FCheckBox.setLabel
Disponibilidade
Flash Player 6.
Uso
myCheckBox.setLabel(label)
Parmetros
label
Retorna
Nada.
Descrio
Mtodo; especifica o rtulo de texto da caixa de seleo. Como padro, o rtulo exibido direita da caixa de seleo. Se este mtodo for chamado, o parmetro label especificado na criao ser cancelado.
Exemplo
FCheckBox.getLabel, FCheckBox.setLabelPlacement
FCheckBox.setLabelPlacement
Disponibilidade
Flash Player 6.
Uso
myCheckBox.setLabelPlacement(labelPosition)
Parmetros
labelPosition
Retorna
Nada.
Descrio
Mtodo; especifica se o rtulo exibido esquerda ou direita da caixa de seleo. Se este mtodo for chamado, o valor do parmetro Label Placement definido durante o processo de criao ser cancelado.
Exemplo
FCheckBox.setLabel
FCheckBox.setSize
Disponibilidade
Flash Player 6.
Uso
myCheckBox.setSize(width)
Parmetros
width
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
FCheckBox.setStyleProperty
Disponibilidade
Flash Player 6.
Uso
myCheckBox.setStyleProperty(styleProperty, value)
Parmetros
styleProperty
FStyleFormat.
value
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
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.
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.
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);
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
Disponibilidade
Flash Player 6.
Uso
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
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
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
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);
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
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
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
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.
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
FComboBox.setSelectedIndex
FComboBox.getValue
Disponibilidade
Flash Player 6.
Uso
myComboBox.getValue()
Parmetros
Nenhum.
Retorna
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
FComboBox.setValue
FComboBox.registerSkinElement
Disponibilidade
Flash Player 6.
Uso
myComboBox.registerSkinElement(element, styleProperty)
Parmetros
element
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");
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
FComboBox.removeItemAt
FComboBox.removeItemAt
Disponibilidade
Flash Player 6.
Uso
myComboBox.removeItemAt(index)
Parmetros
index
Retorna
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
FComboBox.removeAll
157
FComboBox.replaceItemAt
Disponibilidade
Flash Player 6.
Uso
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.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.
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.
FComboBox.setEditable
Disponibilidade
Flash Player 6.
Uso
myComboBox.setEditable(editable)
Parmetros
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
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
FListBox.getEnabled
161
FComboBox.setItemSymbol
Disponibilidade
Flash Player 6.
Uso
myComboBox.setItemSymbol(symbolID)
Parmetros
symbolID
Retorna
Nada.
Descrio
Mtodo; registra um smbolo grfico para exibir os itens de listagem da caixa de combinao. O valor padro o smbolo FComboBoxItem na biblioteca. Este mtodo destinado a usurios e programadores avanados.
FComboBox.setRowCount
Disponibilidade
Flash Player 6.
Uso
myComboBox.setRowCount(rows)
Parmetros
rows
O nmero mximo de linhas que a listagem suspensa pode exibir sem rolagem.
Retorna
Nada.
Descrio
Mtodo; define o nmero de itens que podem ser vistos na listagem suspensa da caixa de combinao sem rolagem. O valor mnimo do parmetro rows 3. Se este mtodo for chamdo, o valor do parmetro Row Count definido durante o processo de criao ser cancelado.
Exemplo
O cdigo a seguir define o nmero de itens exibidos na listagem suspensa de menuMain como 4.
menuMain.setRowCount(4);
Consulte tambm
FComboBox.setSize
FComboBox.setSelectedIndex
Disponibilidade
Flash Player 6.
Uso
myComboBox.setSelectedIndex(index)
Parmetros
index
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
FComboBox.setRowCount
FComboBox.setSize
Disponibilidade
Flash Player 6.
Uso
myComboBox.setSize(width)
Parmetros
width
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
FStyleFormat.
value
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.
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
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.
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
Disponibilidade
Flash Player 6.
Uso
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.
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.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
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
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 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
FListBox.setSize
FListBox.getRowCount
Disponibilidade
Flash Player 6.
Uso
myListBox.getRowCount()
Parmetros
Nenhum.
Retorna
Um inteiro.
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
FListBox.setScrollPosition
FListBox.getSelectedIndex
Disponibilidade
Flash Player 5
Uso
myListBox.getSelectedIndex()
Parmetros
Nenhum.
Retorna
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
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.
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 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
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
FListBox.setSelectMultiple
FListBox.getValue
Disponibilidade
Flash Player 6.
Uso
myListBox.getValue()
Parmetros
Nenhum.
Retorna
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
FListBox.getItemAt
FListBox.registerSkinElement
Disponibilidade
Flash Player 6.
Uso
myListBox.registerSkinElement(element, styleProperty)
Parmetros
element
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
FListBox.removeItemAt
FListBox.removeItemAt
Disponibilidade
Flash Player 6.
Uso
myListBox.removeItemAt(index)
Parmetros
index
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
FListBox.addItemAt
FListBox.replaceItemAt
Disponibilidade
Flash Player 6.
Uso
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.
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.
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).
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
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
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
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
FListBox.getScrollPosition
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
FListBox.getSelectedIndex, FListBox.getSelectedIndices
FListBox.setSelectedIndices
Disponibilidade
Flash Player 6.
Uso
myListBox.setSelectedIndices(indexArray)
Parmetros
indexArray
Retorna
Nada.
Descrio
Mtodo; seleciona os itens especificados na matriz de ndices e atualiza a caixa de listagem. O componente ListBox usa um ndice com base no zero, onde o item no ndice 0 exibido no comeo da lista.
Exemplo
O cdigo a seguir cria uma matriz denominada myArray que especifica os itens que devero ser selecionados em toyList e, a seguir, passa a matriz para o mtodo setSelectedIndices.
var myArray = new Array (1,4,5,7); toyList.setSelectedIndices(myArray);
Consulte tambm
FListBox.getSelectedIndices
183
FListBox.setSelectMultiple
Disponibilidade
Flash Player 6.
Uso
myListBox.setSelectMultiple(multipleSelect)
Parmetros
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
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
FListBox.setStyleProperty
Disponibilidade
Flash Player 6.
Uso
myListBox.setStyleProperty(styleProperty, value)
Parmetros
styleProperty
FStyleFormat.
value
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
FStyleFormat (object)
FListBox.setWidth
Disponibilidade
Flash Player 6.
Uso
myListBox.setWidth(width)
Parmetros
width
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
_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
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
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 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
for..in
Disponibilidade
Flash Player 5.
Uso
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.
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]); }
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
FPushButton.setEnabled
FPushButton.getLabel
Disponibilidade
Flash Player 6.
Uso
myPushButton.getLabel()
Parmetros
Nenhum.
Retorna
FPushButton.setLabel
FPushButton.registerSkinElement
Disponibilidade
Flash Player 6.
Uso
myPushButton.registerSkinElement(element, styleProperty)
Parmetros
element
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.
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
(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
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
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
FPushButton.setStyleProperty
Disponibilidade
Flash Player 6.
Uso
myPushButton.setStyleProperty(styleProperty, value)
Parmetros
styleProperty
FStyleFormat.
value
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
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
FRadioButton.getData
Disponibilidade
Flash Player 6.
Uso
myRadioButton.getData()
Parmetros
Nenhum.
Retorna
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
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
FRadioButton.setEnabled
FRadioButton.getLabel
Disponibilidade
Flash Player 6.
Uso
myRadioButton.getLabel()
Parmetros
Nenhum.
197
Retorna
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
FRadioButton.setLabel
FRadioButton.getState
Disponibilidade
Flash Player 6.
Uso
myRadioButton.getState()
Parmetros
Nenhum.
Retorna
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
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
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
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");
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
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);
FRadioButton.getEnabled
FRadioButton.setGroupName
Disponibilidade
Flash Player 6.
Uso
myRadioButton.setGroupName(groupName) myRadioButtonGroup.setGroupName(groupName)
Parmetros
groupName
Retorna
Nada.
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
FRadioButton.getLabel
203
FRadioButton.setLabelPlacement
Disponibilidade
Flash Player 6.
Uso
myRadioButton.setLabelPlacement(labelPosition) myRadioButtonGroup.setLabelPlacement(labelPosition)
Parmetros
labelPosition
Descrio
Mtodo; especifica se o rtulo exibido esquerda ou direita do boto de opo. Se este mtodo for chamado, o valor do parmetro Label Placement definido durante o processo de criao ser cancelado. Uso 1: especifica o posicionamento do rtulo de um nico boto de opo. Uso 2: especifica o posicionamento dos rtulos de todos os botes de opo em um grupo.
Exemplo
Uso 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
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.
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
FRadioButton.setState
Disponibilidade
Flash Player 6.
Uso
myRadioButton.setState("select")
Parmetros
select (false).
Retorna
Nada.
Descrio
Mtodo: especifica se myRadioButton est selecionado (true) ou no (false). Somente um boto de opo em um grupo (todos tendo o mesmo parmetro Nome do grupo) pode ter um estado inicial de true (selecionado). Se mais de um boto de opo tiver true especificado para este parmetro, o ltimo boto de opo com um parmetro de estado inicial true ser selecionado. O valor padro para este parmetro false. Se este mtodo for chamado, o valor do parmetro Initial State definido durante o processo de criao ser cancelado. Se voc chamar este mtodo e tambm chamar FRadioButton.setValue para selecionar um boto de opo durante a execuo, e os botes de opo forem botes diferentes no mesmo grupo, o boto de opo especificado no ltimo mtodo chamado ser selecionado.
Exemplo
205
FRadioButton.setStyleProperty
Disponibilidade
Flash Player 6.
Uso
styleProperty
FStyleFormat.
value
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
Retorna
Nada.
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
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.getEnabled
Disponibilidade
Flash Player 6.
Uso
myScrollBar.getEnabled()
Parmetros
Nenhum.
Retorna
Um valor booleano.
Descrio
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
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.
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.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
FScrollBar.getEnabled
FScrollBar.setHorizontal
Disponibilidade
Flash Player 6.
Uso
myScrollBar.setHorizontal(horizontalScroll)
Parmetros
Retorna
Nada.
Descrio
Mtodo; especifica se a barra de rolagem aplicada ao destino horizontalmente (true) ou verticalmente (false). O padro deste mtodo false.
Exemplo
O cdigo a seguir especifica que a barra de rolagem scrollText seja aplicada horizontalmente no destino.
scrollText.setHorizontal(true);
Consulte tambm
FScrollBar.setSize
FScrollBar.setLargeScroll
Disponibilidade
Flash Player 6.
Uso
myScrollBar.setLargeScroll(largeScroll)
Parmetros
Um nmero inteiro que especifica o nmero de posies a serem roladas quando o usurio clica uma vez na trilha. O valor padro o valor definido para pageSize com FScrollBar.setScrollProperties.
largeScroll
Retorna
Nada.
Descrio
Mtodo; define a propriedade largeScroll da instncia da barra de rolagem durante a execuo. Quando o usurio clica uma vez na trilha de rolagem, a caixa de rolagem (direcionador) movida na distncia especificada em uma posio de largeScroll.
Exemplo
O cdigo a seguir define que quando o usurio clica na trilha, scrollText1 rolado 20 posies.
scrollText1.setLargeScroll(20);
Consulte tambm
FScrollBar.setSmallScroll
FScrollBar.setScrollContent
Disponibilidade
Flash Player 6.
Uso
myScrollBar.setScrollContent(target)
Parmetros
target
213
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
Consulte FScrollBar.setChangeHandler para obter outro exemplo que utilize este mtodo.
Consulte tambm
FScrollBar.setChangeHandler, FScrollBar.setScrollProperties
FScrollBar.setScrollProperties
Disponibilidade
Flash Player 6.
Uso
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
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
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
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.
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
FStyleFormat.
value
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
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.getPaneHeight
Disponibilidade
Flash Player 6.
Uso
myScrollPane.getPaneHeight()
Parmetros
Nenhum.
Retorna
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
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
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.
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
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
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
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 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
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.
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
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
FStyleFormat.
value
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)
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.
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).
Flash Player 6.
Uso
new FStyleFormat()
Parmetros
Nenhum.
Retorna
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
FStyleFormat.addListener
Disponibilidade
Flash Player 6.
Uso
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
FStyleFormat.applyChangesFStyleFormat.applyChanges, FStyleFormat.removeListener
FStyleFormat.applyChanges
Disponibilidade
Flash Player 6.
Uso
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.
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
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
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
FStyleFormat.addListener, FStyleFormat.applyChanges
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
FStyleFormat.selection
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
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
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
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
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
FStyleFormat.textRightMargin
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
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
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.
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
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
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
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);
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);
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
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.
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); }
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
249
Parmetros
functionname
parameter Um identificador que representa um parmetro a ser passado para a funo. Esses parmetros so opcionais. comando(s)
Retorna
Nada.
Descrio
Ao; um conjunto de comandos que voc define para a realizao de uma determinada tarefa. Voc pode declarar, ou definir, uma funo em um local e cham-la de diferentes scripts em um filme. Quando voc define uma funo, tambm pode especificar parmetros para ela. Os parmetros so espaos reservados para valores sobre os quais a funo far suas operaes. Voc pode passar parmetros diferentes para uma funo todas as vezes que cham-la. Isso permite reutilizar uma funo em diversas situaes diferentes. Use a ao return no(s) comando(s) de uma funo para fazer a funo apresentar, ou gerar, um valor. Uso 1: Declara uma funo com o nome da funo, os parmetros e o(s) comando(s) especificados. Quando uma funo chamada, a declarao da funo chamada. No permitido repassar uma referncia; na mesma lista de aes, uma funo pode ser declarada aps ser chamada. Uma declarao de funo substitui qualquer declarao anterior da mesma funo. Esta sintaxe pode ser usada sempre que for permitido um comando. Uso 2: Cria uma funo annima e apresenta a mesma. Esta sintaxe usada em expresses e particularmente til para a instalao de mtodos em objetos.
Exemplo
(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; }
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}
Flash Player 4. Esse operador foi substitudo no Flash 5 pelo operador >= (maior ou igual a).
Uso
expresso1 ge expresso2
Parmetros
expression1, expression2
Retorna
Nada.
Descrio
Operador (comparao); compara a representao em seqncia de caracteres da expresso1 com a representao em seqncia de caracteres da expresso2 e retorna true se a expresso1 for maior ou igual expresso2; caso contrrio, retorna false.
Consulte tambm
getProperty
Disponibilidade
Flash Player 4.
Uso
getProperty(instancename , property)
Parmetros
instancename
recuperada.
property
Retorna
Nada.
Descrio
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
getURL
Disponibilidade
url
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
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.
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
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
globalStyleFormat
Disponibilidade
Flash Player 6.
Uso
globalStyleFormat.styleProperty
Parmetros
styleProperty
Retorna
Nada.
Descrio
Instncia de objeto; uma instncia do objeto FStyleFormat que define as propriedades de formato de estilo para componentes de interface de usurio Flash. A instncia globalStyleFormat fica disponvel quando um componente de interface de usurio Flash inserido no Palco. Voc define ou altera propriedades de formato de estilo para componentes de interface de usurio Flash editando as propriedades na instncia de objeto globalStyleFormat. Para obter mais informaes, consulte Personalizando cores e texto do componente no captulo Usando componentes de Usando o Flash.
Exemplo
O cdigo a seguir define a propriedade arrow da propriedade FStyleFormat para a instncia globalStyleFormat.
globalStyleFormat.arrow = 0x800080;
Consulte tambm
FStyleFormat (object)
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
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
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
_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.
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
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.
#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 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
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
int
Disponibilidade
Flash Player 4. Esta funo foi reprovada no Flash 5 e substituda pelo mtodo Math.round.
Uso
int(valor)
Parmetros
valor
Retorna
Nada.
Descrio
Math.floor
isFinite
Disponibilidade
Flash Player 5.
Uso
isFinite(expresso)
Parmetros
expresso
Retorna
Nada.
Descrio
Funo de alto nvel; avalia a expresso e retorna true se for um nmero finito e false se for um nmero infinito ou infinito negativo. A presena do infinito ou infinito negativo indica uma condio de erro matemtico como uma diviso por 0.
Exemplo
261
isNaN
Disponibilidade
Flash Player 5.
Uso
isNaN(expresso)
Parmetros
expresso
Retorna
Nada.
Descrio
Funo de alto nvel; avalia o parmetro e retorna true se o valor no for um nmero (NaN), indicando a presena de erros matemticos.
Exemplo
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; } }
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).
263
Key.addListener
Disponibilidade
Flash Player 6.
Uso
Key.addListener (newListener)
Parmetros
newListener
Retorna
Nada.
Descrio
Mtodo; registra um objeto para receber a notificao onKeyDown e onKeyUp. Quando uma tecla pressionada ou liberada, independentemente do foco de entrada, todos os objetos ouvintes registrados com addListener tm o mtodo onKeyDown ou onKeyUp chamado. Vrios objetos podem ouvir notificaes de teclado. Se o ouvinte newListener j estiver registrado, nenhuma alterao ocorrer.
Exemplo
Este exemplo cria um novo objeto ouvinte e define uma funo para onKeyDown e onKeyUp. A ltima linha usa o mtodo addListener para registrar o ouvinte com o objeto Key para que possa receber notificaes de eventos de tecla pressionada e tecla liberada.
myListener = new Object(); myListener.onKeyDown = function () { trace ("Voc pressionou uma tecla."); } myListener.onKeyUp = function () { trace ("Voc liberou uma tecla."); } Key.addListener(myListener);
Key.BACKSPACE
Disponibilidade
Flash Player 5.
Uso
Key.BACKSPACE
Descrio
Key.CAPSLOCK
Disponibilidade
Flash Player 5.
Uso
Key.CAPSLOCK
Descrio
Key.CONTROL
Disponibilidade
Flash Player 5.
Uso
Key.CONTROL
Descrio
Key.DELETEKEY
Disponibilidade
Flash Player 5.
Uso
Key.DELETEKEY
Descrio
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
265
Key.ESCAPE
Disponibilidade
Flash Player 5.
Uso
Key.ESCAPE
Descrio
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.
Key.HOME
Disponibilidade
Flash Player 5.
Uso
Key.HOME
Descrio
Key.INSERT
Disponibilidade
Flash Player 5.
Uso
Key.INSERT
Descrio
Key.isDown
Disponibilidade
Flash Player 5.
Uso
Key.isDown(keycode);
Parmetros
keycode O valor do cdigo de tecla atribudo a uma determinada tecla ou propriedade do objeto Key associada a uma tecla especfica. Para obter uma lista de todos os cdigos associados s teclas de um teclado padro, consulte o Apndice C, Teclas do teclado e valores de cdigos de teclas de Usando o Flash.
Retorna
Nada.
Descrio
Mtodo; retorna true se a tecla especificada em cdigo_de_tecla pressionada. No Macintosh, os valores do cdigo de tecla das teclas Caps Lock e Num Lock so idnticos.
Key.isToggled
Disponibilidade
Flash Player 5.
Uso
Key.isToggled(keycode)
Parmetros
keycode
267
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
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
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
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
Key.SPACE
Disponibilidade
Flash Player 5.
Uso
Key.SPACE
Descrio
Key.TAB
Disponibilidade
Flash Player 5.
Uso
Key.TAB
Descrio
Key.UP
Disponibilidade
Flash Player 5.
Uso
Key.UP
Descrio
Propriedade; constante associada ao valor do cdigo da tecla Seta para cima (38).
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
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
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
Nada.
Descrio
Funo de seqncia de caracteres; retorna o comprimento da seqncia de caracteres ou do nome da varivel especificada.
Exemplo
O resultado 4.
Consulte tambm
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 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.
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
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.
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
loadVariables
Disponibilidade
Flash Player 4.
Uso
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
Disponibilidade
Flash Player 4. Os arquivos do Flash 4 abertos no Flash 5 so convertidos para que utilizem a sintaxe correta.
Uso
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
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 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
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 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.
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
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
Retorna
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.
LoadVars.onLoad
Disponibilidade
Flash Player 6.
Uso
myLoadVars.onLoad(xito)
Parmetros
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 url
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
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
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.
LoadVars.toString
Disponibilidade
Flash Player 6.
Uso
loadVarsObject.toString()
Parmetros
Nenhum.
Retorna
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.
Exemplo
var myVars = new LoadVars(); myVars.name = Gary; myVars.age = 26; trace (myVars.toString()); would output name=Gary&age=26
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
Operador (comparao); compara a expression1 com a expression2 e retorna true se expression1 for menor do que expression2; caso contrrio, retorna false.
Consulte tambm
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 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 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).
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
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
Retorna
Nada.
Descrio
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
Retorna
Um nmero.
Descrio
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.
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
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
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
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)
Parmetros
Retorna
Um nmero.
Descrio
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
Retorna
Um nmero.
Descrio
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
Retorna
Nada.
Descrio
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
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
random
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
Retorna
Nada.
Descrio
Mtodo; calcula e retorna o seno do ngulo especificado em radianos. Use as informaes descritas na introduo do objeto Math para calcular um radiano.
Math.sqrt
Disponibilidade
Flash Player 5. No Flash Player 4, os mtodos e propriedades do objeto Math so emulados com aproximaes e podem no ser to precisos quanto as funes matemticas no emuladas suportadas pelo Flash Player 5.
Uso
Math.sqrt(x)
Parmetros
293
Retorna
Um nmero.
Descrio
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.
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
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
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
Um nmero.
Descrio
mbord
Disponibilidade
Flash Player 4. Esta funo foi reprovada no Flash 5 e substituda pelo mtodo String.charCodeAt.
Uso
mbord(caractere)
Parmetros
caractere
Retorna
Um nmero.
Descrio
String.fromCharCode
mbsubstring
Disponibilidade
Flash Player 4. Esta funo foi substituda no Flash 5 pelo mtodo String.substr.
Uso
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
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
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.
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.
Mouse.hide
Disponibilidade
Flash Player 5.
Uso
Mouse.hide()
Parmetros
Nenhum.
Retorna
Nada.
Descrio
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.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
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
Mouse.show
Disponibilidade
Flash Player 5.
Uso
Mouse.show()
Parmetros
Nenhum.
Retorna
Nada.
Descrio
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
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.
MovieClip.onEnterFrame
MovieClip.onKeyDown
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._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
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.beginFill
Disponibilidade
Flash Player 6.
Uso
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.
Consulte tambm
MovieClip.beginGradientFill, MovieClip.endFill
MovieClip.beginGradientFill
Disponibilidade
Flash Player 6.
Uso
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(); }
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.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
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
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
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
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._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; }
startDrag
MovieClip.duplicateMovieClip
Disponibilidade
Flash Player 5.
Uso
newname
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
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.
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
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
MovieClip.getBytesLoaded
Disponibilidade
Flash Player 6.
Uso
myMovieClip.getBytesLoaded()
Parmetros
Nenhum.
Retorna
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
MovieClip.getURL
Disponibilidade
Flash Player 5.
Uso
URL
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.
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
Nada.
Descrio
gotoAndPlay
MovieClip.gotoAndStop
Disponibilidade
Flash Player 5.
Uso
myMovieClip.gotoAndStop(quadro)
Parmetros
quadro
Retorna
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
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
MovieClip.hitArea
Disponibilidade
Flash Player 6.
Uso
myMovieClip.hitArea
Retorna
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
x y
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.lineStyle
Disponibilidade
Flash Player 6.
Uso
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.
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.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.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
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
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._name
Disponibilidade
Flash Player 4.
Uso
myMovieClip._name
Descrio
MovieClip.nextFrame
Disponibilidade
Flash Player 5.
Uso
myMovieClip.nextFrame()
Parmetros
Nenhum.
Retorna
Nada.
Descrio
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.
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
};
Parmetros
newFocus
Retorna
Nada.
Descrio
Manipulador de eventos; um evento que chamado quando um clipe de filme perde o foco do teclado. O mtodo onKillFocus recebe um parmetro, newFocus, que um objeto representando o novo objeto a receber o foco. Se nenhum objeto receber o foco, newFocus conter o valor null.
MovieClip.onLoad
Disponibilidade
Flash Player 6.
Uso
myMovieClip.onLoad
Parmetros
Nenhum.
Retorna
Nada.
Descrio
Manipulador de eventos; chamado quando o clipe de filme criado e aparece na Linha de tempo. necessrio definir uma funo que seja executada quando o evento chamado.
Exemplo
O exemplo a seguir define uma funo para o mtodo onLoad que envia uma ao trace janela Sada:
myMovieClip.onLoad = function () { trace ("onLoad chamado"); };
MovieClip.onMouseDown
Disponibilidade
Flash Player 6.
Uso
myMovieClip.onMouseDown
Parmetros
Nenhum.
Retorna
Nada.
Descrio
Manipulador de eventos; chamado quando o boto do mouse pressionado. necessrio definir uma funo que seja executada quando o evento chamado.
333
Exemplo
O exemplo a seguir define uma funo para o mtodo onMouseDown que envia uma ao trace janela Sada:
myMovieClip.onMouseDown = function () { trace ("onMouseDown chamado"); }
MovieClip.onMouseMove
Disponibilidade
Flash Player 6.
Uso
myMovieClip.onMouseMove
Parmetros
Nenhum.
Retorna
Nada.
Descrio
Manipulador de eventos; chamado quando o mouse movido. necessrio definir uma funo que seja executada quando o evento chamado.
Exemplo
O exemplo a seguir define uma funo para o mtodo onMouseMove que envia uma ao trace janela Sada.
myMovieClip.onMouseMove = function () { trace ("onMouseMove chamado"); };
MovieClip.onMouseUp
Disponibilidade
Flash Player 6.
Uso
myMovieClip.onMouseUp
Parmetros
Nenhum.
Retorna
Nada.
Descrio
Manipulador de eventos; chamado quando o mouse liberado. necessrio definir uma funo que seja executada quando o evento chamado.
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.
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
oldFocus
Retorna
Nada.
Descrio
Manipulador de eventos; chamado quando um clipe de filme recebe o foco do teclado. O parmetro oldFocus o objeto que perde o foco. Por exemplo, se o usurio pressionar a tecla Tab para mover o foco de entrada de um clipe de filme para um campo de texto, oldFocus contr a instncia do clipe de filme. Se nenhum objeto possua o foco anteriormente, oldFocus conter um valor null.
337
MovieClip.onUnload
Disponibilidade
Flash Player 6.
Uso
myMovieClip.onUnload
Parmetros
Nenhum.
Retorna
Nada.
Descrio
Manipulador de eventos; chamado no primeiro quadro depois que o clipe de filme removido da Linha de tempo. As aes associadas ao evento onUnload so processadas antes de qualquer ao anexada ao quadro em questo. necessrio definir uma funo a ser executada quando o evento for chamado.
Exemplo
O exemplo a seguir define uma funo para o mtodo onUnload que envia uma ao trace janela Sada.
myMovieClip.onUnload = function () { trace ("onUnload chamado"); };
MovieClip._parent
Disponibilidade
Flash Player 6.
Uso
myMovieClip._parent.property _parent._parent.property
Descrio
Propriedade; especifica ou retorna uma referncia ao clipe de filme ou objeto que contm o clipe de filme ou objeto atual. O objeto atual o que contm o cdigo ActionScript que faz referncia a _parent. Use a propriedade _parent para especificar um caminho relativo para clipes de filme ou objetos que estiverem acima do clipe de filme ou objeto atual.
Consulte tambm
_root, targetPath
MovieClip.play
Disponibilidade
Flash Player 5.
Uso
myMovieClip.play()
Parmetros
Nenhum.
Retorna
Nada.
Descrio
play
MovieClip.prevFrame
Disponibilidade
Flash Player 5.
Uso
myMovieClip.prevFrame()
Parmetros
Nenhum.
Retorna
Nada.
Descrio
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._rotation
Disponibilidade
Flash Player 4.
Uso
myMovieClip._rotation
Descrio
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.
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
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
341
MovieClip.stop
Disponibilidade
Flash Player 5.
Uso
myMovieClip.stop()
Parmetros
Nenhum.
Retorna
Nada.
Descrio
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.swapDepths
Disponibilidade
Flash Player 5.
Uso
myMovieClip.swapDepths(profundidade) myMovieClip.swapDepths(destino)
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.
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._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.
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
myMovieClip._width
Descrio
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
347
MovieClip._xmouse
Disponibilidade
Flash Player 5.
Uso
myMovieClip._xmouse
Descrio
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._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._ymouse
Disponibilidade
Flash Player 5.
Uso
myMovieClip._ymouse
Descrio
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
NaN
Disponibilidade
Flash Player 5.
Uso
NaN
Descrio
Varivel; uma varivel predefinida com o valor IEEE 754 para NaN (No Nmero).
349
Flash Player 4. Este operador foi reprovado e substitudo pelo operador != (diferena).
Uso
expression1 ne expression2
Parmetros
expression1,expression2
Retorna
Nada.
Descrio
Operador (comparao); compara a expression1 com a expression2 e retorna true se a expression1 no for igual expression2; caso contrrio, retorna false.
Consulte tambm
!= (diferena)
new
Disponibilidade
Flash Player 5.
Uso
novo construtor()
Parmetros
construtor Uma funo seguida por parmetros opcionais em parnteses. Normalmente, a funo o nome do tipo de objeto (por exemplo, Array, Math, Number ou Object) a ser criado.
Retorna
Nada.
Descrio
Operador; cria um novo objeto, inicialmente annimo, e chama a funo identificada pelo parmetro construtor. O novo operador passa funo quaisquer parmetros opcionais em parnteses, bem como o objeto recm-criado, que referenciado com a palavra-chave this. Em seguida, a funo construtora pode usar this para definir as variveis do objeto. A propriedade prototype da funo construtora copiada na propriedade __proto__ do novo objeto. Como resultado, o novo objeto suporta todos os mtodos e propriedades especificados no objeto Prototype da funo construtora.
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
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
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
! (NOT lgico)
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
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
Flash Player 5.
Uso
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
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
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.
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
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
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.
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
Object.addProperty
Disponibilidade
Flash Player 6.
Uso
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.
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");
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
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
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.
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;
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
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
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" }
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
on
Disponibilidade
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
Nada.
Descrio
Operador; avalia condition1 e condition2 e se alguma das expresses for true, toda a expresso ser true.
Consulte tambm
ord
Disponibilidade
Flash Player 4. Esta funo foi reprovada e substituda pelos mtodos e propriedades de String (objeto).
Uso
ord(caractere)
Parmetros
caractere
Retorna
Nada.
Descrio
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
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")
retorna 5.1
parseFloat("3.75math") parseFloat("0garbage")
parseInt
Disponibilidade
Flash Player 5.
Uso
parseInt(expresso, [raiz])
Parmetros
expresso raiz
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
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
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
print
Disponibilidade
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
printAsBitmap
Disponibilidade
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
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
printAsBitmapNum
Disponibilidade
Flash Player 5.
Uso
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
printNum
Disponibilidade
Flash Player 5.
Uso
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
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
_quality
Disponibilidade
Flash Player 5.
Uso
_quality
Descrio
Propriedade (global); define ou recupera a qualidade usada para um filme. As fontes de dispositivo so sempre serrilhadas, sendo assim no so afetadas pela propriedade _quality. A propriedade _quality pode ser definida nos seguintes valores:
"LOW"
"MEDIUM"
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
_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
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
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
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
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();
_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.
Selection.addListener
Disponibilidade
Flash Player 6.
Uso
Selection.addListener(novo_Ouvinte)
Parmetros
novo_Ouvinte
Retorna
Nenhum.
Descrio
Mtodo; registra um objeto para receber notificaes de alterao de foco do teclado. Quando o foco alterado (por exemplo, sempre que o mtodo Selection.SetFocus chamado), todos os objetos ouvintes registrados com addListener tm seu mtodo onSetFocus chamado. Vrios objetos podem ouvir notificaes de alterao de foco. Se o ouvinte newListener j estiver registrado, nenhuma alterao ocorrer.
381
Selection.getBeginIndex
Disponibilidade
Flash Player 5.
Uso
Selection.getBeginIndex()
Parmetros
Nenhum.
Retorna
Um inteiro.
Descrio
Mtodo; retorna o ndice no incio do intervalo de seleo. Se nenhum ndice existir ou nenhum campo de texto estiver em foco no momento, o mtodo retornar -1. Os ndices do intervalo de seleo so baseados em zero (por exemplo, a primeira posio 0, a segunda 1 e assim por diante).
Selection.getCaretIndex
Disponibilidade
Flash Player 5.
Uso
Selection.getCaretIndex()
Parmetros
Nenhum.
Retorna
Um inteiro.
Descrio
Mtodo; retorna o ndice da posio do cursor intermitente. Se nenhum cursor intermitente for exibido, o mtodo retornar -1. Os ndices do intervalo de seleo so baseados em zero (por exemplo, a primeira posio 0, a segunda 1 e assim por diante).
Selection.getEndIndex
Disponibilidade
Flash Player 5.
Uso
Selection.getEndIndex()
Parmetros
Nenhum.
Retorna
Um inteiro.
Descrio
Mtodo; retorna o ndice final do intervalo de seleo focalizado no momento. Se nenhum ndice existir ou nenhum intervalo de seleo estiver em foco no momento, o mtodo retornar -1. Os ndices do intervalo de seleo so baseados em zero (por exemplo, a primeira posio 0, a segunda 1 e assim por diante).
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
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
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
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.
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
Retorna
Nada.
Descrio
Mtodo; define o intervalo de seleo do campo de texto focalizado no momento. O novo intervalo de seleo comear no ndice especificado no parmetro incio e terminar no ndice especificado no parmetro fim. Os ndices do intervalo de seleo so baseados em zero (por exemplo, a primeira posio 0, a segunda 1 e assim por diante). Esse mtodo no tem efeito se no houver campo de texto focalizado no momento.
set variable
Disponibilidade
Flash Player 4.
Uso
set(varivel, expresso)
Parmetros
varivel expresso
Retorna
Nada.
385
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 )); }
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.
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
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
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.
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
Sound.getBytesLoaded
Disponibilidade
Flash Player 6.
Uso
Sound.getBytesLoaded()
Parmetros
Nenhum.
Retorna
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
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
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
Sound.onLoad
Disponibilidade
Flash Player 6.
Uso
mySoundObject.onLoad = callbackFunction
Parmetros
mySoundObject
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
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
Sound.position
Disponibilidade
Flash Player 6.
Uso
mySound.position
Parmetros
Nenhum.
Retorna
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.setTransform
Disponibilidade
Flash Player 5.
Uso
mySound.setTransform(soundTransformObject)
Parmetros
soundTransformObject
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).
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.
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
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
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"])
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
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.
399
Stage.addListener
Disponibilidade
Flash Player 6.
Uso
Stage.addListener(meu_Ouvinte)
Parmetros
meu_Ouvinte
Retorna
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
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
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
Nada.
Descrio
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.
startDrag
Disponibilidade
Flash Player 4.
Uso
destino bloqueio
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
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
String (funo)
Disponibilidade
Flash Player 4.
Uso
String(expresso)
Parmetros
expresso
Retorna
Nada.
Descrio
Funo; retorna uma representao de seqncia de caracteres do parmetro especificado da seguinte maneira: Se expresso for um valor Booleano, a seqncia de caracteres retornada ser true ou false. Se expresso for um nmero, a seqncia de caracteres retornada ser uma representao de texto do nmero. Se expresso for uma seqncia de caracteres, a seqncia retornada ser expresso. Se expresso for um objeto, o valor retornado ser uma representao de seqncia de caracteres do objeto gerado pela chamada da propriedade da seqncia de caracteres referente ao objeto ou pela chamada de Object.toString, se tal propriedade no existir. Se expresso for um clipe de filme, o valor de retorno ser o caminho de destino do clipe de filme em notao de barra (/). Se expresso for undefined, o valor de retorno ser uma seqncia de caracteres vazia ("").
Consulte tambm
405
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)
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
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
407
Flash Player 5.
Uso
new String(valor)
Parmetros
valor
Retorna
Nada.
Descrio
String.charAt
Disponibilidade
Flash Player 5.
Uso
myString.charAt(ndice)
Parmetros
ndice
Retorna
Nada.
Descrio
Mtodo; retorna o caractere na posio especificada pelo parmetro ndice. O ndice do primeiro caractere em uma seqncia de caracteres 0. Se ndice no for um nmero de 0 a string.length - 1, ser retornada uma seqncia de caracteres vazia.
String.charCodeAt
Disponibilidade
Flash Player 5.
Uso
myString.charCodeAt(ndice)
Parmetros
ndice Um inteiro que especifica a posio de um caractere na seqncia de caracteres. O primeiro caractere indicado por 0 e o ltimo indicado por myString.length-1.
Retorna
Nada.
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
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
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
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
subseqncia de caracteres
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.
String.length
Disponibilidade
Flash Player 5.
Uso
string.length
Parmetros
Nenhum.
Descrio
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);
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);
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.
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);
Se o parmetro delimitador no for definido, toda a seqncia de caracteres ser colocada no primeiro elemento da matriz retornada.
Exemplo
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
seqncia de caracteres
caracteres.
ndice contagem
O nmero de caracteres a ser includo na seqncia de caracteres extrada, sem incluir o caractere ndice.
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
method arg1
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();
switch
Disponibilidade
Flash Player 4.
Uso
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.
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
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
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.
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
targetPath
Disponibilidade
Flash Player 5.
Uso
targetpath(objeto_MovieClip)
Parmetros
objeto_MovieClip Referncia (por exemplo, _root ou _parent) ao clipe de filme cujo caminho de destino est sendo recuperado.
Retorna
Nada.
Descrio
Funo; retorna uma seqncia de caracteres que contm o caminho de destino de objeto_MovieClip. O caminho de destino retornado em notao com pontos. Para recuperar o caminho de destino em notao de barras, use a propriedade _target.
Exemplo
Este exemplo exibe o caminho de destino de um clipe de filme assim que carregado.
onClipEvent(load){ trace(targetPath(this)); }
Consulte tambm
eval
tellTarget
Disponibilidade
Flash Player 3. (Obsoleto no Flash 5; recomendvel usar a notao com pontos e a ao with.)
Uso
tellTarget("destino") { comando(s); }
Parmetros
destino Uma seqncia de caracteres que especifica o caminho de destino da Linha de tempo a ser controlada. comando(s)
Retorna
Nada.
423
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.
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._alpha
Disponibilidade
Flash Player 6.
Uso
TextField._alpha
Descrio
Propriedade; define ou recupera a transparncia alfa (valor) do campo de texto especificado por TextField. A faixa de valores vlidos vai de 0 (totalmente transparente) a 100 (totalmente opaco).
Exemplo
Os comandos a seguir definem a propriedade _alpha de um campo de texto chamado de text1 como 30%.
on(release) { text1._alpha = 30; }
TextField.addListener
Disponibilidade
Flash Player 6.
Uso
TextField.addListener(novo_Ouvinte)
Parmetros
novo_Ouvinte
Retorna
Nada.
427
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.
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.
Retorna
Um inteiro.
Descrio
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
ndice
Retorna
Um objeto.
Descrio
Mtodo; (Uso 1) retorna um objeto TextFormat que contm informaes de formatao para todo o texto em um campo de texto. Somente as propriedades comuns a todo o texto no campo de texto so definidas no objeto TextFormat resultante. Qualquer propriedade que seja misturada, ou seja, que tenha valores diferentes em pontos diferentes no texto, tem seu valor definido como null. Uso 2: retorna um objeto TextFormat que contm uma cpia do formato de texto do campo de texto em ndice. Uso 3: retorna um objeto TextFormat que contm informaes de formatao para o intervalo de texto de incio_ndice a fim_ndice.
Consulte tambm
TextField._height
Disponibilidade
Flash Player 6.
Uso
TextField._height
Descrio
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
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
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.
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
TextField.hscroll
TextField.maxscroll
Disponibilidade
Flash Player 6.
Uso
TextField.maxscroll
Descrio
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
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
};
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.
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.onSetFocus
Disponibilidade
Flash Player 6.
Uso
oldFocus
Retorna
Nada.
Descrio
Identificador de eventos; chamado quando um campo de texto recebe o foco do teclado. O parmetro oldFocus o objeto que perde o foco. Por exemplo, se o usurio pressionar a tecla Tab para mover o foco de entrada de um boto para um campo de texto, oldFocus conter a instncia do campo de texto. Se nenhum objeto possua o foco anteriormente, oldFocus conter um valor null.
TextField._parent
Disponibilidade
Flash Player 6.
Uso
_parent.property _parent._parent.property
Descrio
Propriedade; especifica ou retorna uma referncia ao clipe de filme ou objeto que contm o clipe de filme ou objeto atual. O objeto atual o que contm o cdigo ActionScript que faz referncia a _parent. Use _parent para especificar um caminho relativo para clipes de filme ou objetos que estiverem acima do clipe de filme ou objeto atual.
Consulte tambm
_root, targetPath
437
TextField.password
Disponibilidade
Flash Player 6.
Uso
TextField.password
Descrio
Propriedade; se o valor de password for true, o campo de texto ser de senha e ocultar os caracteres de entrada. Se for false, o campo de texto no ser de senha.
TextField._quality
Disponibilidade
Flash Player 6.
Uso
TextField._quality
Descrio
Propriedade (global); define ou recupera a qualidade usada para um filme. As fontes de dispositivo so sempre serrilhadas, sendo assim no so afetadas pela propriedade _quality. A propriedade _quality pode ser definida nos seguintes valores:
"LOW"
"MEDIUM"
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
_highquality, toggleHighQuality
TextField.removeListener
Disponibilidade
Flash Player 6.
Uso
Selection.removeListener(ouvinte)
Parmetros
ouvinte
Retorna
Se o ouvinte tiver sido removido com xito, o mtodo retornar um valor true. Se o ouvinte no tiver sido removido com xito (por exemplo, se o ouvinte no estava na lista de ouvintes do objeto TextField), o mtodo retornar o valor false.
Descrio
Mtodo; remove um objeto ouvinte anteriormente registrado para uma instncia de campo de texto com addListener.
TextField.removeTextField
Disponibilidade
Flash Player 6.
Uso
TextField.removeTextField()
Descrio
Mtodo; remove o campo de texto especificado por TextField. Esta operao s pode ser executada em um campo de texto que tenha sido criado com o mtodo createTextField do objeto MovieClip. Ela no funcionar em campos de texto inseridos pela Linha de tempo. Quando este mtodo chamado, o campo de texto instrudo a se remover. semelhante ao mtodo MovieClip.removeMovieClip.
Consulte tambm
MovieClip.createTextField
TextField.replaceSel
Disponibilidade
Flash Player 6.
Uso
TextField.replaceSel(texto)
Parmetros
texto
Retorna
Nada.
439
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";
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";
TextField._rotation
Disponibilidade
Flash Player 6.
Uso
TextField._rotation
Descrio
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
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.setTextFormat
Disponibilidade
Flash Player 6.
Uso
incio_ndice fim_ndice
Um inteiro.
textFormat Uma instncia do objeto TextFormat. Um objeto TextFormat que contm informaes de formatao de caractere e pargrafo.
Retorna
Nada.
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.
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
TextField.textHeight
Disponibilidade
Flash Player 6.
Uso
TextField.textHeight
Descrio
445
TextField.textWidth
Disponibilidade
Flash Player 6.
Uso
TextField.textWidth
Descrio
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.
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
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._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._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._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
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.
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.
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.
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
Retorna
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.
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 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(); }
true
Disponibilidade
Flash Player 5.
Uso
true
Descrio
false
typeof
Disponibilidade
Flash Player 5.
Uso
typeof expresso
Parmetros
expresso
Descrio
Operador; um operador unrio colocado antes de um nico parmetro. O operador typeof faz com que o interpretador Flash avalie expresso; o resultado uma seqncia de caracteres que especifica se a expresso uma seqncia de caracteres, um clipe de filme, um objeto ou uma funo. A tabela a seguir mostra os resultados do operador typeof em cada tipo de expresso:
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"); }
unescape
Disponibilidade
Flash Player 5.
Uso
unescape(x)
Parmetros
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 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
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); }
unloadMovieNum
Disponibilidade
Flash Player 3.
Uso
unloadMovieNum(nvel)
Parmetros
nvel
Retorna
Nada.
Descrio
loadMovie, loadMovieNum
updateAfterEvent
Disponibilidade
Flash Player 5.
Uso
updateAfterEvent()
Parmetros
Nenhum.
Retorna
Nada.
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
variableName valor
Retorna
Um identificador.
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
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
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
with
Disponibilidade
Flash Player 5.
Uso
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); }
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
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.
XML.onLoad
Flash Player 5.
Uso
new XML([origem])
Parmetros
origem
Retorna
Nada.
Descrio
Construtor; cria um novo objeto XML. Voc deve usar o mtodo construtor para criar uma instncia do objeto XML antes de chamar qualquer mtodo do objeto XML.
Observao: Os mtodos createElement e createTextNode so os mtodos do construtor para criar os elementos e ns de texto em uma rvore de documentos XML.
Exemplo
Uso 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
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
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
XML.childNodes
Disponibilidade
Flash Player 5.
Uso
myXML.childNodes
Parmetros
Nenhum.
Retorna
Nada.
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
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
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.
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
473
XML.getBytesLoaded
Disponibilidade
Flash Player 6.
Uso
XML.getBytesLoaded()
Parmetros
Nenhum.
Retorna
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
XML.getBytesLoaded
XML.hasChildNodes
Disponibilidade
Flash Player 5.
Uso
myXML.hasChildNodes()
Parmetros
Nenhum.
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
boolean
Descrio
Propriedade; a configurao padro false. Quando definida como true, os ns de texto que s contm espao em branco so descartados durante o processo de anlise. Os ns de texto com espao em branco inicial ou de rastro no so afetados. Uso 1: possvel definir a propriedade ignoreWhite para objetos XML individuais, como no cdigo a seguir:
myXML.ignoreWhite = true
XML.insertBefore
Disponibilidade
Flash Player 5.
Uso
myXML.insertBefore(n_Filho, n_anterior)
Parmetros
n_Filho
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.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
XML.loaded, XML.onLoad
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
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.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.
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
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
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
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.
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
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.
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\" ?>";
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.
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:
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
XMLSocket.connect
XMLSocket.close
Disponibilidade
Flash Player 5.
Uso
myXMLSocket.close()
Parmetros
Nenhum.
Retorna
Nada.
Descrio
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.
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
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
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
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
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.
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