1. Aprendendo ActionScript 2.0 no Flash

2. Marcas comerciais1 Step RoboPDF, ActiveEdit, ActiveTest, Authorware, Blue Sky Software, Blue Sky, Breeze, Breezo, Captivate, Central,ColdFusion, Contribute, Database Explorer, Director, Dreamweaver, Fireworks, Flash, FlashCast, FlashHelp, Flash Lite,FlashPaper, Flash Video Encoder, Flex, Flex Builder, Fontographer, FreeHand, Generator, HomeSite, JRun, MacRecorder,Macromedia, MXML, RoboEngine, RoboHelp, RoboInfo, RoboPDF, Roundtrip, Roundtrip HTML, Shockwave, SoundEdit,Studio MX, UltraDev e WebHelp so marcas comerciais registradas ou marcas comerciais da Macromedia, Inc. e podem estarregistradas nos Estados Unidos ou em outras jurisdies, inclusive internacionais. Outros nomes de produtos, logotipos, designs,ttulos, palavras ou frases mencionados nesta publicao podem ser marcas comerciais, marcas de servio ou nomes comerciais daMacromedia, Inc. ou de outras entidades e podem estar registrados em certas jurisdies, inclusive internacionais.Informaes de terceirosEste guia contm links para sites da Web de terceiros que no esto sob o controle da Macromedia. Nesses casos, a Macromediano responsvel pelo contedo de nenhum site vinculado. Se acessar um dos sites da Web de terceiros mencionados neste guia,voc estar assumindo os riscos inerentes. A Macromedia oferece esses links apenas como uma convenincia, e a incluso de umlink no significa que a Macromedia apia ou aceita qualquer responsabilidade pelo contedo apresentado nos sites 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. Navegador Opera Copyright 1995-2002 Opera Software ASA e seus fornecedores. Todos osdireitos reservados.O vdeo Macromedia Flash 8 possui tecnologia de vdeo On2 TrueMotion. 1992-2005 On2 Technologies, Inc. Todos osdireitos reservados. http://www.on2.com.Visual SourceSafe uma marca comercial ou comercial registrada da Microsoft Corporation nos Estados Unidos e/ou em outrospases.Copyright 2005 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 ouem parte, sem o consentimento prvio por escrito da Macromedia, Inc. No obstante o precedente, o proprietrio ouusurio autorizado de uma cpia vlida do software com que este manual foi fornecido pode imprimir uma cpia destemanual a partir de uma verso eletrnica com a finalidade nica de ele prprio ou um usurio autorizado aprender a usareste software, desde que nenhuma parte deste manual seja impressa, reproduzida, distribuda, revendida ou transmitidapara qualquer outro fim, incluindo, sem limitao, fins comerciais, como vendas de cpias desta documentao oufornecimento de servios de suporte pr-pagos.AgradecimentosGerenciamento de projetos: Sheila McGinnCriao do texto: Jen deHaan; Peter deHaan, Joey LottEditora geral: Rosana FrancescatoEditora chefe: Lisa StanzianoEdio: Linda Adler, Geta Carlson, Evelyn Eldridge, John Hammett, Mary Kraemer, Noreen Maher, Jessie Wood, Anne SzablaGerenciamento de produo: Patrice ONeill, Kristin Conradi, Yuko YagiProjeto de mdia e produo: Adam Barnett, Aaron Begley, Paul Benkman. John Francis, Geeta Karmarkar, Masayo Noda,Paul Rangel, Arena Reed, Mario ReynosoAgradecimentos especiais a Jody Bleyle, Mary Burger, Lisa Friendly, Stephanie Gowin, Bonnie Loo, Mary Ann Walsh, Erick Vera,aos testadores beta e a toda a equipe de engenharia e controle de qualidade do Flash e do Flash Player.Primeira edio: Setembro de 2005Macromedia, Inc.601 Townsend St.San Francisco, CA 94103

3. ContedoIntroduo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Pblico-alvo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Requisitos de sistema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Atualizando arquivos XML para Flash . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Sobre a documentao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Recursos adicionais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Captulo 1: Novidades do ActionScript no Flash 8 . . . . . . . . . . . . 19Novidades do ActionScript 2.0 e do Flash 8 . . . . . . . . . . . . . . . . . . . . . . 19Alteraes no modelo de segurana para arquivos SWF instaladoslocalmente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Captulo 2: Escrevendo e editando o ActionScript 2.0 . . . . . . . . 31Sobre o ActionScript e eventos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32Organizando o cdigo ActionScript. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34Usando o painel Actions e a janela Script. . . . . . . . . . . . . . . . . . . . . . . . 36Sobre o painel Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37Sobre a janela Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Sobre a codificao no painel Actions e na janela Script . . . . . . . . . . 39Sobre recursos do painel Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62Sobre comportamentos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65Sobre as configuraes de publicao do ActionScript . . . . . . . . . . . 66Captulo 3: Sobre o ActionScript . . . . . . . . . . . . . . . . . . . . . . . . . . 71O que ActionScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72Sobre a opo entre o ActionScript 1.0 e o ActionScript 2.0 . . . . . . .73Noes bsicas do ActionScript e do Flash Player . . . . . . . . . . . . . . . .74 3

4. Captulo 4: Dados e tipos de dados . . . . . . . . . . . . . . . . . . . . . . . . 75Sobre dados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Sobre tipos de dados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Sobre variveis. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91Organizando dados em objetos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .114Sobre a converso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .116Captulo 5: Fundamentos da sintaxe e da linguagem . . . . . . . . 119Sobre sintaxe, instrues e expresses . . . . . . . . . . . . . . . . . . . . . . . . . 120Sobre sintaxe de ponto e caminhos de destino . . . . . . . . . . . . . . . . . . 124Sobre pontuadores de linguagem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132Sobre constantes e palavras-chave . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143Sobre instrues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149Sobre arrays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172Sobre operadores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185Captulo 6: Funes e mtodos . . . . . . . . . . . . . . . . . . . . . . . . . . 213Sobre funes e mtodos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213Noes bsicas sobre mtodos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .235Captulo 7: Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239Sobre a programao orientada a objeto e o Flash . . . . . . . . . . . . . 240Criando arquivos de classes personalizados. . . . . . . . . . . . . . . . . . . . 249Sobre como trabalhar com classes personalizadas em umaplicativo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .252Exemplo: Criando classes personalizadas. . . . . . . . . . . . . . . . . . . . . . . 278Exemplo: Usando arquivos de classes personalizados no Flash . . . 291Atribuindo uma classe a smbolos no Flash. . . . . . . . . . . . . . . . . . . . . 295Compilando e exportando classes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .296Noes bsicas sobre classes e escopo . . . . . . . . . . . . . . . . . . . . . . . 299Sobre classes de nvel superior e internas . . . . . . . . . . . . . . . . . . . . . . 302Sobre como trabalhar com classes internas . . . . . . . . . . . . . . . . . . . . . 312Captulo 8: Herana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319Sobre herana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319Sobre a criao de subclasses no Flash . . . . . . . . . . . . . . . . . . . . . . . . 321Usando o polimorfismo em um aplicativo . . . . . . . . . . . . . . . . . . . . . . . 3274 Contedo

5. Captulo 9: Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331Sobre interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .331Criando interfaces como tipos de dados. . . . . . . . . . . . . . . . . . . . . . . . 337Noes bsicas sobre herana e interfaces . . . . . . . . . . . . . . . . . . . . . 339Exemplo: Usando interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340Exemplo: Criando uma interface complexa . . . . . . . . . . . . . . . . . . . . . 342Captulo 10: Manipulando eventos . . . . . . . . . . . . . . . . . . . . . . . 347Usando mtodos manipuladores de eventos . . . . . . . . . . . . . . . . . . . . 348Usando ouvintes de eventos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .351Usando ouvintes de eventos com componentes . . . . . . . . . . . . . . . . 353Usando manipuladores de eventos de boto e de clipe de filme. . . 355Transmitindo eventos de instncias de componentes . . . . . . . . . . . . 360Criando clipes de filme com estados de boto . . . . . . . . . . . . . . . . . . .361Escopo do manipulador de eventos . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362Escopo da palavra-chave this . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365Usando a classe Delegate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366Captulo 11: Trabalhando com clipes de filme . . . . . . . . . . . . . . 369Sobre o controle de clipes de filme com o ActionScript . . . . . . . . . . 370Chamando vrios mtodos em um nico clipe de filme. . . . . . . . . . . 372Carregando e descarregando arquivos SWF . . . . . . . . . . . . . . . . . . . 373Alterando a posio e a aparncia de um clipe de filme . . . . . . . . . . 376Arrastando clipes de filme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377Criando clipes de filme durante a execuo . . . . . . . . . . . . . . . . . . . . . 378Adicionando parmetros aos clipes de filme criadosdinamicamente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383Gerenciando profundidades do clipe de filme . . . . . . . . . . . . . . . . . . . 385Sobre o armazenamento em cache e a rolagem de clipesde filme com o ActionScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389Usando clipes de filme como mscaras . . . . . . . . . . . . . . . . . . . . . . . . 397Manipulando eventos de clipes de filme . . . . . . . . . . . . . . . . . . . . . . . . 399Atribuindo uma classe a um smbolo de clipe de filme . . . . . . . . . . . . 399Inicializando as propriedades de classe . . . . . . . . . . . . . . . . . . . . . . . . .401Captulo 12: Trabalhando com texto e seqnciasde caracteres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403Sobre campos de texto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405Sobre o carregamento de texto e variveis em campos de texto . . .415Usando fontes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420Sobre a renderizao de fontes e texto sem serrilhado. . . . . . . . . . . 430 Contedo 5

6. Sobre o layout e a formatao de texto . . . . . . . . . . . . . . . . . . . . . . . . 439Formatando texto com estilos CSS . . . . . . . . . . . . . . . . . . . . . . . . . . . .447Usando texto em formato HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461Exemplo: Criando texto de rolagem . . . . . . . . . . . . . . . . . . . . . . . . . . . .475Sobre seqncias de caracteres e a classe String. . . . . . . . . . . . . . . . 477Captulo 13: Animao, filtros e desenhos . . . . . . . . . . . . . . . . . 497Scripts de animao com o ActionScript 2.0 . . . . . . . . . . . . . . . . . . 498Sobre cache de bitmap, rolagem e desempenho . . . . . . . . . . . . . . . 508Sobre as classes Tween e TransitionManager . . . . . . . . . . . . . . . . . 509Usando efeitos de filtro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .526Trabalhando com filtros usando ActionScript . . . . . . . . . . . . . . . . . . .534Manipulando efeitos de filtro com cdigo . . . . . . . . . . . . . . . . . . . . . . .557Criando bitmaps com a classe BitmapData . . . . . . . . . . . . . . . . . . . . . 561Modos de mistura . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .564Sobre a ordem de operao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567Desenhando com o ActionScript. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567Noes bsicas sobre dimensionamento e guias de trecho . . . . . . .583Captulo 14: Criando interao com o ActionScript . . . . . . . . . 589Sobre eventos e interao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590Controlando a reproduo de arquivos SWF . . . . . . . . . . . . . . . . . . . 590Criando interatividade e efeitos visuais. . . . . . . . . . . . . . . . . . . . . . . . . 593Criando vinculaes de dados durante a execuo como ActionScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .607Desconstruindo um script de exemplo . . . . . . . . . . . . . . . . . . . . . . . . . . 616Captulo 15: Trabalhando com imagens, som e vdeo . . . . . . . . 619Sobre o carregamento e o trabalho com mdia externa . . . . . . . . . . 620Carregando arquivos SWF e de imagem externos . . . . . . . . . . . . . . . 621Sobre o carregamento e o uso de arquivos MP3 externos . . . . . . . .626Atribuindo vinculao a recursos da biblioteca. . . . . . . . . . . . . . . . . . . 631Sobre o uso de vdeo FLV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .632Sobre a criao de animaes do progresso para arquivosde mdia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6546 Contedo

7. Captulo 16: Trabalhando com dados externos . . . . . . . . . . . . . 663Enviando e carregando variveis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 664Usando HTTP para conectar a scripts do servidor . . . . . . . . . . . . . . . 668Sobre upload e download de arquivos . . . . . . . . . . . . . . . . . . . . . . . . . 674Sobre XML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 683Enviando mensagens para o Flash Player e a partir deste . . . . . . . . 692Sobre a API External . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 696Captulo 17: Noes bsicas de segurana . . . . . . . . . . . . . . . . 707Sobre compatibilidade com os modelos de seguranaanteriores do Flash Player . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708Sobre segurana do arquivo local e o Flash Player . . . . . . . . . . . . . . 709Sobre domnios, segurana entre domnios e arquivos SWF . . . . . 727Arquivos de diretivas de servidor para autorizar o acesso a dados. 736Acesso de protocolo HTTP para HTTPS entre arquivos SWF . . . . . 741Captulo 18: Depurando aplicativos . . . . . . . . . . . . . . . . . . . . . . 745Depurando scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 745Usando o painel Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 759Captulo 19: Melhores prticas e convenes de codificaopara ActionScript 2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .767Convenes de atribuio de nome . . . . . . . . . . . . . . . . . . . . . . . . . . . . 769Usando de comentrios no cdigo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 779Convenes de codificao do ActionScript . . . . . . . . . . . . . . . . . . . . 782Otimizao do ActionScript e do Flash Player . . . . . . . . . . . . . . . . . . 798Formatando a sintaxe do ActionScript . . . . . . . . . . . . . . . . . . . . . . . . . 799Apndice A: Mensagens de erro . . . . . . . . . . . . . . . . . . . . . . . . . 809Apndice B: Operadores Flash 4 obsoletos . . . . . . . . . . . . . . . . 815Apndice C: Teclas do teclado e valores de cdigosde teclas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 817Apndice D: Criando scripts para verses anteriores do FlashPlayer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 825Sobre a especificao de verses anteriores do Flash Player . . . . 825Usando o Flash 8 para criar contedo para o Flash Player 4 . . . . . 826 Contedo 7

8. Apndice E: Programao orientada a objeto como ActionScript 1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 829Sobre o ActionScript 1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 830Criando um objeto personalizado no ActionScript 1.0 . . . . . . . . . . . . 831Atribuindo mtodos a um objeto personalizado noActionScript 1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .832Definindo mtodos manipuladores de eventos noActionScript 1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .834Criando herana no ActionScript 1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . .836Adicionando propriedades getter/setter a objetos noActionScript 1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 837Usando as propriedades do objeto Function no ActionScript 1.0 . .838Apndice F: Terminologia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 841ndice. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8518 Contedo

9. IntroduoO Macromedia Flash Basic 8 e o Macromedia Flash Professional 8 so as ferramentas decriao padro profissionais para a produo de experincias de grande impacto na Web. OActionScript a linguagem utilizada para adicionar interatividade aos aplicativos Flash, sejamos aplicativos arquivos SWF animados simples ou aplicativos de Internet avanados maiscomplexos. Para usar o Flash, no necessrio o ActionScript, mas, se voc desejar fornecerinteratividade bsica ou complexa com o usurio, trabalhar com objetos diferentes daquelescontidos no Flash (como botes e clipes de filme) ou ento transformar um arquivo SWF emuma experincia de usurio mais eficiente, dever usar o ActionScript.Para obter mais informaes, consulte os tpicos a seguir:Pblico-alvo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Atualizando arquivos XML para Flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Requisitos de sistema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Sobre a documentao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Recursos adicionais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Pblico-alvoEste manual pressupe que voc j tenha instalado o Flash Basic 8 ou o Flash Professional 8 esaiba como usar a interface de usurio. preciso que saiba posicionar objetos no Stage emanipul-los no ambiente de criao do Flash. Se j tiver usado uma linguagem de criao, oActionScript lhe parecer familiar. No entanto, se for iniciante em programao, saiba que osfundamentos do ActionScript so fceis de aprender. Voc pode comear com comandossimples e criar mais complexidade com o tempo. Pode adicionar muita interatividade aos seusarquivos sem precisar aprender (ou escrever) muito cdigo.Requisitos de sistemaO ActionScript 2.0 no tem qualquer requisito de sistema alm do Flash 8 . 9

10. Este manual pressupe que voc esteja utilizando as configuraes de publicao padro paraos arquivos do Flash: Flash Player 8 e ActionScript 2.0. Se voc alterar qualquer uma dessasconfiguraes, as explicaes e exemplos de cdigo apresentados na documentao poderono funcionar corretamente. Caso desenvolva aplicativos para verses anteriores do FlashPlayer, consulte o Apndice D, Criando scripts para verses anteriores do Flash Player, napgina 825.Atualizando arquivos XML para Flash importante que estejam sempre instalados os arquivos XML para Flash mais recentes. AMacromedia algumas vezes apresenta recursos em verses com ponto (verses menores) doFlash Player. Quando uma verso dessas se encontrar disponvel, atualize sua verso do Flashpara obter os arquivos XML mais recentes. Caso contrrio, o compilador do Flash 8 podergerar erros caso voc use novas propriedades ou mtodos indisponveis na verso do FlashPlayer que veio com a instalao do Flash.Por exemplo, o Flash Player 7 (7.0.19.0) continha um novo mtodo para o objeto System ,System.security.loadPolicyFile. Para acessar esse mtodo, use o instalador PlayerUpdater (Atualizador de player) para atualizar todos os players instalados com o Flash. Casocontrrio, o compilador do Flash exibir erros.Lembre-se de que possvel instalar um Player Updater que seja de uma ou mais versesmaiores mais recentes que a sua do Flash. Fazendo isso, obter os arquivos XML necessrios,mas no dever receber mensagens de erro do compilador quando publicar verses maisantigas do Flash Player. Algumas vezes, novos mtodos ou propriedades encontram-sedisponveis para verses mais antigas, e ter os arquivos XML mais recentes minimiza os errosde compilao quando voc tenta acessar mtodos ou propriedades mais antigos.Sobre a documentaoEste manual oferece uma viso geral da sintaxe do ActionScript e informaes sobre como us-lo quando trabalhar com diferentes tipos de objetos. Para obter detalhes sobre a sintaxe e o usode cada elemento da linguagem, consulte o ActionScript 2.0 Language Reference.Para obter mais informaes, consulte os seguintes tpicos: Viso geral do manual Aprendendo ActionScript 2.0 na pgina 11 Sobre os arquivos de exemplo na pgina 15 Termos usados neste documento na pgina 13 Copiar e colar cdigo na pgina 1310 Introduo

11. Viso geral do manual Aprendendo ActionScript 2.0A lista a seguir resume o contedo deste manual: O Captulo 1, Novidades do ActionScript no Flash 8, descreve recursos que so novos no ActionScript, alteraes no compilador e no depurador e o novo modelo de programao para a linguagem ActionScript 2.0. O Captulo 2, Escrevendo e editando o ActionScript 2.0, descreve recursos do editor do ActionScript dentro do Flash que facilitam a escrita de cdigo. O Captulo 3, Sobre o ActionScript, descreve o que a linguagem ActionScript e detalha como escolher qual verso utilizar. O Captulo 4, Dados e tipos de dados, descreve a terminologia e os conceitos bsicos sobre dados, tipos de dados e variveis. Esses conceitos sero usados em todo o manual. O Captulo 5, Fundamentos da sintaxe e da linguagem, descreve a terminologia e os conceitos bsicos da linguagem ActionScript. Esses conceitos sero usados em todo o manual. O Captulo 6, Funes e mtodos, descreve como escrever diferentes tipos de funes e mtodos e como us-los no seu aplicativo. O Captulo 7, Classes, descreve como criar classes e objetos personalizados no ActionScript. Esse captulo tambm lista as classes internas do ActionScript e oferece uma viso geral de como utiliz-las para acessar recursos avanados do ActionScript. O Captulo 8, Herana, descreve a herana na linguagem ActionScript e como estender classes internas ou personalizadas. O Captulo 9, Interfaces, descreve como criar interfaces e trabalhar com elas no ActionScript. O Captulo 10, Manipulando eventos, descreve vrias formas de manipular eventos: mtodos manipuladores de eventos, ouvintes de eventos e manipuladores de eventos de boto e de clipe de filme. O Captulo 11, Trabalhando com clipes de filme, descreve clipes de filme e o AcionScript que voc pode usar para crontrol-los. O Captulo 12, Trabalhando com texto e seqncias de caracteres, descreve os diferentes modos como voc pode controlar o texto e as seqncias de caracteres no Flash e inclui informaes sobre formatao de texto e o FlashType (renderizao de texto avanada, como texto sem serrilhado). O Captulo 13, Animao, filtros e desenhos, descreve como criar animao e imagens baseadas em cdigo, adicionar filtros a objetos e desenhar usando o ActionScript. Sobre a documentao 11

12. O Captulo 14, Criando interao com o ActionScript, descreve alguns modos simples de criar aplicativos mais interativos, incluindo o controle quando os arquivos SWF so executados e a criao de ponteiros personalizados e de controles de som. O Captulo 15, Trabalhando com imagens, som e vdeo, descreve como importar arquivos de mdia externos, como imagens de bitmap, arquivos MP3, arquivos Flash Video (FLV) e outros arquivos SWF, nos aplicativos Flash. Esse captulo tambm oferece uma viso geral de como trabalhar com o vdeo nos aplicativos e como criar animaes para o carregamento da barra de progresso. O Captulo 16, Trabalhando com dados externos, descreve como processar dados de fontes externas usando scripts de servidor ou de cliente nos aplicativos. Esse captulo descreve como integrar os dados com os aplicativos. O Captulo 17, Noes bsicas de segurana, explica a segurana no Flash Player, na medida em que se relaciona com o trabalho com arquivos SWF localmente no disco rgido. Esse captulo tambm explica questes de segurana entre domnios e como carregar dados de servidores ou atravs de domnios. O Captulo 18, Depurando aplicativos, descreve o depurador do ActionScript dentro do Flash, que facilita a escrita de aplicativos. O Captulo 19, Melhores prticas e convenes de codificao para ActionScript 2.0, explica as melhores prticas para usar o Flash e para escrever o ActionScript. Esse captulo tambm lista convenes de codificao padronizadas, como variveis de atribuio de nome e outras convenes. O Apndice A, Mensagens de erro, lista as mensagens de erro que o compilador do Flash pode gerar. O Apndice B, Operadores Flash 4 obsoletos, lista todos os operadores obsoletos do Flash 4 e sua associatividade. O Apndice C, Teclas do teclado e valores de cdigos de teclas, lista todas as teclas de um teclado padro e os valores de cdigos de teclas ASCII correspondentes usados para identificar as teclas no ActionScript. O Apndice D, Criando scripts para verses anteriores do Flash Player, fornece diretrizes para ajud-lo a criar scripts sintaticamente corretos para a verso do Flash Player desejada. O Apndice E, Programao orientada a objeto com o ActionScript 1.0, fornece informaes sobre o uso do modelo de objeto ActionScript 1.0 para escrver scripts. O Apndice F, Terminologia, lista a terminologia comumente usada ao trabalhar com a linguagem ActionScript e fornece descries para os termos.Este manual explica como usar a linguagem ActionScript. Para obter informaes sobre oselementos de linguagem propriamente ditos, consulte o ActionScript 2.0 Language Reference.12 Introduo

13. Convenes tipogrficasEste manual usa as seguintes convenes tipogrficas: Fonte Code indica cdigo do ActionScript. Fonte Code negrito, normalmente em um procedimento, indica cdigo que voc precisa modificar ou adicionar a um cdigo j adicionado ao arquivo FLA. Em alguns casos, pode ser usado para realar o cdigo a ser observado. Texto em negrito indica dados que voc precisa digitar na interface de usurio, como nome de arquivo ou nome de instncia. Texto em itlico indica um novo termo definido no texto que se segue. Em um caminho de arquivo, pode indicar um valor que deve ser substitudo (por exemplo, por um nome de diretrio no seu prprio disco rgido).Termos usados neste documentoOs seguintes termos so usados neste manual: Voc refere-se ao desenvolvedor que escreve um script ou aplicativo. O usurio refere-se pessoa que executar os scripts e aplicativos. Tempo de compilao o momento em que voc publica, exporta, testa ou depura o documento. Tempo de execuo o momento em que o script executado no Flash Player.Termos do ActionScript como mtodo e objeto so definidos no Apndice F, Terminologia,na pgina 841.Copiar e colar cdigoQuando voc colar o ActionScript do painel Help (Ajuda) para o FLA ou o arquivo doActionScript, preste ateno aos caracteres especiais. So caracteres especiais as aspas especiais(tambm chamadas de aspas curvas ou aspas inglesas). Esses caracteres no so interpretadospelo editor do ActionScript, ento o cdigo lana um erro quando voc tenta compil-lo noFlash. Sobre a documentao 13

14. Voc pode identificar se os caracteres de aspas so especiais quando eles no so codificadospor cores de forma correta. Ou seja, se nenhuma seqncia de caracteres mudar de cor noeditor de cores, ser preciso substituir os caracteres especiais por caracteres de aspas retascomuns. Se voc digitar um caractere de aspa simples ou dupla diretamente no editor doActionScript, sempre digitar um caractere de aspa reta. O compilador (quando voc testa oupublica um arquivo SWF) lana um erro e permite que voc saiba que h um tipo errado(marcas de aspas especiais ou curvas) de caracteres no seu cdigo.N OT A Voc tambm pode encontrar aspas especiais se colar o ActionScript de outros locais, como de uma pgina da Web ou um documento do Microsoft Word.Cuidado com quebras de linha ao copiar e colar cdigo. Ao colar o seu cdigo de algunslocais, a linha de cdigo poder se quebrar em um local inapropriado. Certifique-se de que acodificao de cores da sua sintaxe esteja correta no editor do ActionScript se achar que asquebras de linha representam um problema. Compare o cdigo do painel Actions (Aes)com o do painel Help para ver se correspondem. Procure ativar o Word Wrap (quebraautomtica de linha) no editor do ActionScript para ajudar a solucionar quebras de linhaexcedentes no cdigo (selecione View (Exibir) > Word Wrap (quebra automtica de linha) najanela Script ou Word Wrap no menu pop-up do painel Actions.)Recursos adicionaisAlm deste manual sobre o ActionScript, existem outros sobre outros tpicos do Flash, comocomponentes e o Macromedia Flash Lite. Voc pode acessar cada manual no painel Help(Help > Flash Help (Ajuda do Flash)), exibindo o sumrio padro. Clique no boto Clear(Limpar) para ver os manuais disponveis; para obter mais informaes, consulte Ondeencontrar documentao sobre outros assuntos na pgina 17.Para obter mais informaes sobre outros recursos disponveis, consulte os seguintes tpicos: Sobre os arquivos de exemplo na pgina 15 Onde encontrar arquivos PDF ou documentao impressa na pgina 15 Sobre o LiveDocs na pgina 16 Recursos on-line adicionais na pgina 17 Onde encontrar documentao sobre outros assuntos na pgina 1714 Introduo

15. Sobre os arquivos de exemploH vrios arquivos de exemplo baseados no ActionScript que so instalados com o Flash. Essesarquivos de exemplo mostram como o cdigo funciona em um arquivo FLA; geralmenteservem como uma ferramenta de aprendizado bem til. Os captulos deste manual muitasvezes fazem referncia a esses arquivos, mas recomendamos que voc consulte tambm a pastade arquivos de exemplo do seu disco rgido.Os arquivos de exemplo incluem arquivos FLA de aplicativo que usam funes comuns doFlash instaladas com ele. Esses aplicativos foram projetados para apresentar aos novosdesenvolvedores do Flash as capacidades dos aplicativos Flash assim como para mostrar aosdesenvolvedores avanados como funcionam os recursos do Flash no contexto.Voc pode encontrar os arquivos de origem de exemplo com foco no ActionScript na pastaSamples (Exemplos) do disco rgido. No Windows, navegue at a unidade de inicializaoProgram FilesMacromediaFlash 8Samples and TutorialsSamplesActionScript. No Macintosh, navegue at Macintosh HD/Applications/Macromedia Flash 8/Samples and Tutorials/Samples/ActionScript/.Voc ver como so teis os seguintes arquivos de exemplo com foco em componentes, poiseles contm vrios cdigos ActionScript. Eles tambm podem ser encontrados na pastaSamples do disco rgido: No Windows, navegue at a unidade de inicializaoProgram FilesMacromediaFlash 8Samples and TutorialsSamplesComponents. No Macintosh, navegue at Macintosh HD/Applications/Macromedia Flash 8/Samples and Tutorials/Samples/Components/.Voc tambm pode encontrar arquivos de exemplo adicionais para download na Internet. Apgina da Web a seguir contm links e descries de arquivos de exemplo adicionais:www.macromedia.com/go/flash_samples/.Onde encontrar arquivos PDF ou documentaoimpressaCaso prefira ler a documentao em formato impresso, as verses PDF de cada manualencontram-se disponveis para download. V at www.macromedia.com/support/documentation/ e selecione o produto em que est interessado. Voc pode exibir ou fazer odownload do PDF ou acessar o link da verso LiveDocs do manual. Recursos adicionais 15

16. Muitas vezes voc tambm pode adquirir a documentao impressa. Para obter informaesatualizadas, v at o site de suporte da documentao e selecione Flash Basic 8 ou FlashProfessional 8.Sobre o LiveDocsVoc pode acessar a documentao no site LiveDocs ou pelo painel Help. O site LiveDocscontm todas as pginas de ajuda do Flash e pode conter comentrios que esclaream,atualizem ou corrijam partes da documentao. Clique em View Comments (Exibircomentrios) em LiveDocs na parte inferior de uma pgina do painel Help para exibir apgina equivalente no site LiveDocs. V at http://livedocs.macromedia.com para ver umalista de toda a documentao disponvel no formato LiveDocs.Escritores tcnicos monitoram o site LiveDocs. Uma das vantagens do LiveDocs vercomentrios que esclarecem a documentao ou corrigir erros ou problemas que surgem apso lanamento de um software. No no LiveDocs que voc faz solicitaes de ajuda, comoperguntas sobre seu cdigo que no funciona, comentrios sobre problemas com software ouinstalao ou perguntas sobre como criar algo com o Flash. Nele voc fornece informaessobre a documentao (por exemplo, voc aponta uma frase ou pargrafo que requeresclarecimento).Quando voc clica no boto para adicionar um comentrio sobre o LiveDocs, h diversospontos sobre os tipos de comentrios que so aceitveis no sistema. Leia essas diretrizesatentamente para que seu comentrio no seja removido do site.Se tiver alguma dvida sobr eo Flash, faa sua pergunta nos fruns da Web da Macromedia:www.macromedia.com/support/forums/. Os fruns da Web so o melhor local para fazerperguntas, pois h vrios funcionrios da Macromedia l, voluntrios da equipe Macromedia,gerentes e membros de grupos de usurio da Macromedia e at escritores tcnicos quemonitoram esses fruns.Engenheiros no monitoram o sistema LiveDocs, mas a lista de tarefas do Flash. Se achar queencontrou um erro (bug) no software ou se quiser solicitar um aprimoramento para o Flash,preencha o formulrio em www.macromedia.com/go/wish. Se voc relatar o bug ou asolicitao de aprimoramento no LiveDocs, eles no sero adicionados de forma oficial aobanco de dados de bugs. Use o formulrio apropriado se quiser que um engenheiro d atenoao bug reportado ou sua solicitao.Lembre-se de dar ateno aos caracteres especiais e s quebras de linha quando colar da Web,incluindo do LiveDocs. A Macromedia vem se esforando para remover todos os caracteresespeciais dos exemplos de cdigo, mas, se voc tiver dificuldades para colar o cdigo, consulteCopiar e colar cdigo na pgina 13.16 Introduo

17. Recursos on-line adicionaisExistem vrios recursos on-line que oferecem vrias instrues, ajuda e orientao parafacilitar o uso do Macromedia Flash 8. Consulte com freqncia os seguintes sites para obteratualizaes:O site The Macromedia Developer Center (www.macromedia.com/devnet) atualizadoregularmente com as informaes mais recentes sobre o Flash, alm de ofereceraconselhamentos de usurios experientes, tpicos avanados, exemplos, dicas, tutoriais(incluindo tutoriais com vrias partes) e outras atualizaes. Visite com freqncia o site daWeb para saber das ltimas novidades sobre o Flash e como obter o mximo do programa.O site The Macromedia Flash Support Center (www.macromedia.com/support/flash)fornece TechNotes (Notas Tcnicas), atualizaes de documentao e links para recursosadicionais na comunidade Flash.O site The Macromedia Weblogs (http://weblogs.macromedia.com) fornece uma lista dosweblogs (tambm chamados de blogs) de funcionrios e da comunidade Macromedia .Os fruns da Web da Macromedia (http://webforums.macromedia.com) oferecem vriosfruns para perguntas especficas sobre o Flash, seus aplicativos ou a linguagem ActionScript.Os fruns so monitorados por voluntrios da equipe Macromedia e muitas vezes so visitadospor funcionrios de l tambm. Se no souber a quem recorrer ou como resolver umproblema, comece por um frum do Flash.O site The Macromedia Community (www.macromedia.com/community) hospedaregularmente Macrochats, uma srie de apresentaes ao vivo sobre uma variedade de tpicosfeitas por funcionrios ou membros da comunidade Macromedia. Consulte regulamente o site procura de atualizaes e para registrar-se nos Macrochats.Onde encontrar documentao sobre outrosassuntosOs manuais a seguir oferecem informaes adicionais sobre assuntos comumente associadosao ActionScript 2.0: Para obter informaes sobre os elementos que compem a linguagem ActionScript, consulte o ActionScript 2.0 Language Reference. Para obter informaes sobre como trabalhar no ambiente de criao do Flash, consulte o How to Use Help (Como usar a Ajuda). Para obter informaes sobre como trabalhar com componentes, consulte o Using Components (Usando componentes). Recursos adicionais 17

18. 18 Introduo

19. CAPTULO 1Novidades do ActionScriptno Flash 8 1O Macromedia Flash Basic 8 e o Macromedia Flash Professional 8 oferecem vriosaprimoramentos que facilitam a criao de scripts mais eficientes com uso da linguagemActionScript. Os novos recursos, analisados neste captulo, incluem novos elementos delinguagem (consulte Acrscimos linguagem ActionScript na pgina 22), ferramentas deedio aprimoradas (consulte Alteraes de edio do ActionScript na pgina 28), alteraesno modelo de segurana e outros aprimoramentos do ActionScript relacionados ferramentade criao.Para obter mais informaes, consulte os seguintes tpicos:Novidades do ActionScript 2.0 e do Flash 8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Alteraes no modelo de segurana para arquivos SWF instalados localmente . 29Novidades do ActionScript 2.0 e doFlash 8A linguagem ActionScript cresceu e desenvolveu-se desde sua introduo, h vrios anos. Comcada nova verso do Flash, mais palavras-chave, objetos, mtodos e outros elementos foramadicionados linguagem. Existem tambm aprimoramentos do ActionScript relacionados aosambientes de criao do Flash 8. O Flash Basic 8 e o Flash Professional 8 introduzem vriosnovos elementos de linguagem para recursos expressivos, como filtros e modos de mistura,alm do desenvolvimento de aplicativos, como integrao do JavaScript (ExternalInterface) eentrada e sada de arquivo (FileReference e FileReferenceList).Esta seo fornece uma viso geral dos elementos e classes da linguagem ActionScript que sonovos ou foram alterados no Flash 8 e aprimoramentos do ActionScript relacionados ferramenta de criao. Para obter uma lista de adies especficas ao ActionScript 2.0, consulteAcrscimos linguagem ActionScript na pgina 22. Para usar qualquer dos novos elementosda linguagem nos seus scripts, tenha em mente o Flash Player 8 (o padro) quando publicarseus documentos. 19

20. Os recursos a seguir foram adicionados ao Flash Basic 8 e ao Flash Professional 8 (a menos queexplicitado de forma diferente): Os aprimoramentos do editor do ActionScript permitem a exibio de caracteres ocultos nos scripts. Para obter mais informaes, consulte Exibindo caracteres ocultos na pgina 57. As opes de depurao agora encontram-se disponveis na janela Script, assim como no painel Actions, para arquivos do ActionScript. O diretrio Configuration que inclui arquivos XML e arquivos de classes est reorganizado. Para obter detalhes, consulte Arquivos de configurao instalados com o Flash 8 na pgina 69. possvel definir uma preferncia para recarregar arquivos de script modificados ao trabalhar em um aplicativo, o que ajuda a evitar o trabalho com verses mais antigas de arquivos de script e a substituio de arquivos de script mais novos. Para obter mais informaes, consulte Sobre as preferncias do ActionScript na pgina 44. O recurso da janela Script encontra-se disponvel no Flash Basic 8 e no Flash Professional 8. Isso significa que voc pode criar um arquivo do ActionScript nos dois programas. O Script Assist (Assistncia de script), semelhante ao Normal Mode (Modo Normal) em edies anteriores do Flash, ajuda voc a codificar sem que precise ter noes de sintaxe. Para obter mais informaes sobre o Script Assist, consulte Sobre o Script Assist na pgina 62. possvel carregar novos tipos de arquivos de imagem durante a execuo, o que inclui imagens JPEG progressivas e arquivos GIF e PNG no-animados. Se voc carregar um arquivo animado, o primeiro quadro da animao ser exibido. possvel atribuir identificadores de vinculao a arquivos de bitmap e de som armazenados na biblioteca (Library), o que significa que voc pode anexar imagens ao Stage ou trabalhar com esses recursos em bibliotecas compartilhadas. O cache de bitmap permite o aumento do desempenho dos aplicativos durante a execuo por meio do cache de uma representao de bitmap de suas instncias. Voc pode usar o ActionScript para acessar essa propriedade. Para obter mais informaes, consulte Sobre cache de bitmap, rolagem e desempenho na pgina 508.20 Novidades do ActionScript no Flash 8

21. O dimensionamento em 9 trechos permite o dimensionamento de instncias de clipe de filme sem expanso dos traos que contornam o clipe de filme. Voc pode usar o cdigo ActionScript para acessar esse recurso no Flash Basic 8 e no Flash Professional 8 ou na ferramenta de criao do Flash 8. Para obter mais informaes, consulte Trabalhando com dimensionamento de 9 trechos no ActionScript na pgina 585. Para obter informaes sobre como acessar o dimensionamento em 9 trechos na ferramenta de criao, consulte Sobre dimensionamento em 9 trechos e smbolos de clipe de filme na pgina 91 em Usando o Flash. Agora voc pode adicionar informaes de metadados para os arquivos FLA na caixa de dilogo Publish Settings (Configuraes de publicao). Pode adicionar um nome e uma descrio ao arquivo FLA usando a caixa de dilogo para ajudar a aumentar a visibilidade da pesquisa on-line. O painel Strings (Seqncias de caracteres) est aprimorado e agora inclui suporte multilinha no campo String e um arquivo de linguagem XML. Para obter mais informaes, consulte Sobre o painel Strings na pgina 479. Um novo coletor de lixo faz parte do Flash Player, que usa um coletor incremental para melhorar o desempenho. O fluxo de trabalho para a criao de aplicativos acessveis est aprimorado. No Flash Player 8 no h mais necessidade de os desenvolvedores adicionarem todos os objetos ao ndice de tabulao para que o contedo seja lido corretamente por um leitor de tela. Para obter mais informaes sobre o ndice de tabulao, consulte tabIndex (Button.tabIndex property), tabIndex (MovieClip.tabIndex property) e tabIndex (TextField.tabIndex property) em ActionScript 2.0 Language Reference. O Flash Player aumentou a segurana dos arquivos locais; agora h mais segurana quando os arquivos SWF so executados no disco rgido. Para obter informaes sobre segurana de arquivos locais, consulte Sobre segurana do arquivo local e o Flash Player na pgina 709. Usando o cdigo ActionScript, voc pode usar a API Drawing (API de desenho) para controlar o estilo de linhas dos traos desenhados. Para obter informaes sobre novos estilos de linha, consulte Usando estilos de linha na pgina 574. Usando o cdigo ActionScript, voc poder usar a API Drawing para criar gradientes mais complexos com os quais preencher as formas. Para obter informaes sobre preenchimentos de gradiente, consulte Usando preenchimentos de gradiente complexos na pgina 573. Voc pode usar o cdigo ActionScript para aplicar muitos filtros a objetos no Stage (como instncias de clipe de filme). Para obter informaes sobre filtros e o ActionScript, consulte Trabalhando com filtros usando ActionScript na pgina 534. Novidades do ActionScript 2.0 e do Flash 8 21

22. Para fazer o upload dos arquivos para um servidor, use as APIs FileReference e FileReferenceList. Para obter mais informaes, consulte Sobre upload e download de arquivos na pgina 674. Voc pode usar o cdigo ActionScript para acessar meios novos e avanados de aplicar e manipular cores. Para obter mais informaes, consulte Definindo valores de cores na pgina 599 e ColorTransform (flash.geom.ColorTransform) em ActionScript 2.0 Language Reference. Foram feitos diversos aprimoramentos no texto, incluindo novas opes, propriedades e parmetros nas classes TextField e TextFormat. Para obter mais informaes, consulte TextField e TextFormat em ActionScript 2.0 Language Reference. Para acessar os recursos avanados de eliminao de serrilhado (FlashType), use o cdigo ActionScript. Para obter mais informaes, consulte Sobre a renderizao de fontes e texto sem serrilhado na pgina 430. Quando testar o aplicativo, voc poder excluir os arquivos ASO. Selecione Control (Controlar) > Delete ASO files (Excluir arquivos ASO) ou Control > Delete ASO files e Test Movie (Testar filme) na ferramenta de criao. Para obter informaes, consulte Usando arquivos ASO na pgina 298.Para obter uma lista de classes, elementos de linguagem, mtodos e propriedades especficasadicionadas ao ActionScript 2.0 no Flash 8, consulte Acrscimos linguagem ActionScriptna pgina 22.Acrscimos linguagem ActionScriptEsta seo lista acrscimos aos elementos e classes da linguagem ActionScript novos oualterados no Flash 8. As classes e os elementos de linguagem a seguir so novos acrscimos aoFlash Player 8 ou passaram a ter suporte recentemente nesse programa.As classes a seguir foram adicionadas ao ActionScript 2.0 no Flash 8: A classe BevelFilter (do pacote flash.filters) permite a adio de efeitos de chanfro a objetos. A classe BitmapData (do pacote flash.display) permite a criao e a manipulao de imagens de bitmap transparentes ou opacas dimensionadas arbitrariamente. A classe BitmapFilter (do pacote flash.display) uma classe base para efeitos de filtro. A classe BlurFilter permite a aplicao de embaamentos a objetos no Flash. A classe ColorMatrixFilter (do pacote flash.filters) permite a aplicao de transformaes a cores ARGB e valores alfa. A classe ColorTransform (do pacote flash.geom) permite o ajuste de valores de cores em clipes de filme. A classe Color obsoleta em relao a esta classe.22 Novidades do ActionScript no Flash 8

23. A classe ConvolutionFilter (do pacote flash.filters) permite a aplicao de efeitos de filtro de toro de matriz. A classe DisplacementMapFilter (do pacote flash.filters) permite o uso de valores em pixels de um objeto BitmapData para o deslocamento de um objeto. A classe DropShadowFilter (do pacote flash.filters) permite a adio de sombreamentos a objetos. A classe ExternalInterface (do pacote flash.external) permite que voc se comunique usando o ActionScript com o recipiente do Flash Player (o sistema que contm o aplicativo Flash, como um navegador com JavaScript, ou o aplicativo desktop). A classe FileReference (do pacote flash.net ) permite o upload e o download de arquivos entre o computador do usurio e um servidor. A classe FileReferenceList (do pacote flash.net) permite a seleo de um ou mais arquivos para upload. A classe GlowFilter (do pacote flash.filters) permite a adio de efeitos de brilho a objetos. A classe GradientBevelFilter (do pacote flash.filters) permite a adio de chanfros gradientes a objetos. A classe GradientGlowFilter (do pacote flash.filters) permite a adio de efeitos de brilho gradiente a objetos. A classe IME (da classe System) permite a manipulao do IME (Input Method Editor, Editor de mtodo de entrada) do sistema operacional no Flash Player. A classe Locale (do pacote mx.lang) permite o controle do modo de exibio de texto multilnge em um arquivo SWF. A classe Matrix (do pacote flash.geom) representa uma matriz de transformao que determina como mapear pontos de um espao de coordenada para o outro. O objeto Point (do pacote flash.geom) representa um local em um sistema de coordenadas bidimensional, onde x representa o eixo horizontal e y representa o eixo vertical. A classe Rectangle (do pacote flash.geom) permite a criao e a modificao de objetos Rectangle. A classe TextRenderer (do pacote flash.text) oferece funcionalidade para fontes incorporadas sem serrilhado. A classe Transform (do pacote flash.geom) coleta dados sobre transformaes de cores e manipulaes de coordenadas aplicadas a uma instncia MovieClip. N O TA No Flash 8 foi adicionado suporte oficial para a classe AsBroadcaster. Novidades do ActionScript 2.0 e do Flash 8 23

24. Os novos elementos, mtodos e funes da linguagem adicionados a classes existentes noActionScript incluem: A funo global showRedrawRegions permite que o player do depurador indique as regies da tela que esto sendo redesenhadas (ou seja, regies problemticas que esto sendo atualizadas). A funo faz o player mostrar o que foi redesenhado, mas no permite que voc controle as regies de redesenho. A propriedade blendMode da classe Button, que define o modo de mistura para a instncia do boto. A propriedade cacheAsBitmap da classe Button, que permite o cache do objeto como representao interna de bitmap da instncia. A propriedade filters da classe Button, que um array indexado que contm cada objeto filtro associado ao boto. A propriedade scale9Grid da classe Button, que a regio retangular que define nove regies de dimensionamento para a instncia. A propriedade hasIME da classe System.capabilities, que indica se o sistema possui um IME instalado. A propriedade getUTCYear da classe Date, que retorna o ano dessa data, de acordo com a hora universal. A constante ALT da classe Key. O mtodo isAccessible() da classe Key retorna um valor booleano que indica se a ltima tecla pressionada pode ser acessada por outros arquivos SWF, dependendo das restries de segurana. O manipulador de eventos onHTTPStatus da classe LoadVars retorna o cdigo de status retornado do servidor (por exemplo, o valor 404 para pgina no encontrada). Para obter mais informaes, consulte onHTTPStatus (LoadVars.onHTTPStatus handler) em ActionScript 2.0 Language Reference. O mtodo attachBitmap() da classe MovieClip, que anexa uma imagem de bitmap a um clipe de filme. Para obter mais informaes, consulte BitmapData (flash.display.BitmapData) em ActionScript 2.0 Language Reference. O mtodo beginBitmapFill() da classe MovieClip, que preenche um clipe de filme com uma imagem de bitmap. Os parmetros spreadMethod, interpolationMethod e focalPointRatio do mtodo beginGradientFill() da classe MovieClip. Esse mtodo preenche uma rea de desenho com uma imagem de bitmap, e o bitmap pode ser repetido ou colocado lado a lado para preencher a rea.24 Novidades do ActionScript no Flash 8

25. A propriedade blendMode da classe MovieClip, que permite a definio do modo de mistura para a instncia. A propriedade cacheAsBitmap da classe MovieClip, que permite o cache do objeto como uma representao interna de bitmap da instncia. A propriedade filters da classe MovieClip, que um array indexado que contm cada objeto filtro associado no momento instncia. O mtodo getRect() da classe MovieClip, que retorna propriedades que so os valores de coordenada mnimo e mximo da instncia especificada. O mtodo lineGradientStyle() da classe MovieClip, que especifica um estilo de linha gradiente que o Flash usa quando desenha um caminho. Os parmetros pixelHinting, noScale, capsStyle, jointStyle e miterLimit do mtodo lineStyle() da classe MovieClip. Esses parmetros especificam tipos de estilos de linha que voc pode usar ao desenhar linhas. A propriedade opaqueBackground da classe MovieClip, que define a cor de fundo opaca (no transparente) do clipe de filme como a cor que o valor hexadecimal RGB especifica. A propriedade scale9Grid da classe MovieClip, que a regio retangular que define nove regies de dimensionamento para a instncia. A propriedade scrollRect da classe MovieClip, que permite que voc role rapidamente o contedo do clipe de filme e que a janela exiba um contedo maior. A propriedade transform da classe MovieClip, que permite configuraes em relao aos limites de matriz, transformao de cores e pixels de um clipe de filme. Para obter mais informaes, consulte Transform (flash.geom.Transform) em ActionScript 2.0 Language Reference. O parmetro status da classe MovieClipLoader. O manipulador de eventos onLoadComplete retorna o cdigo de status retornado do servidor (por exemplo, o valor 404 para pgina no encontrada). Para obter mais informaes, consulte onLoadComplete (MovieClipLoader.onLoadComplete event listener) em ActionScript 2.0 Language Reference. O manipulador de eventos onLoadError da classe MovieClipLoader chamado quando um arquivo carregado com MovieClipLoader.loadClip() no pode ser carregado. O parmetro secure do mtodo SharedObject.getLocal() determina se o acesso a esse objeto compartilhado se restringe a arquivos SWF transmitidos por uma conexo HTTPS. Para obter mais informaes, consulte getLocal (SharedObject.getLocal method) em ActionScript 2.0 Language Reference. A constante ID3 da classe Sound. Novidades do ActionScript 2.0 e do Flash 8 25

26. A propriedade sandboxType da classe System.security indica o tipo de sandbox de segurana em que o arquivo SWF de chamada est operando. Para obter mais informaes, consulte sandboxType (security.sandboxType property) em ActionScript 2.0 Language Reference. O mtodo parse() da classe TextField.StyleSheet. A propriedade antiAliasType da classe TextField, que define o tipo de eliminao de serrilhado utilizada na instncia TextField. A propriedade filters da classe TextField, que um array indexado que contm cada objeto filtro associado no momento instncia TextField. A propriedade gridFitType da classe TextField, que define o tipo de ajuste grade usado na instncia. Para obter informaes sobre ajuste grade e TextField.gridFitType, consulte gridFitType (TextField.gridFitType property) em ActionScript 2.0 Language Reference. A propriedade sharpness da classe TextField, que estabelece a definio das bordas de glifo para a instncia TextField. Se usar essa propriedade, ter de definir o mtodo antiAliasType() como avanado. A propriedade thickness da classe TextField, que define a espessura das bordas de glifo na instncia TextField. Se usar essa propriedade, ter de definir o mtodo antiAliasType() como avanado. O valor justify da propriedade align da classe TextFormat, que permite a justificao de um pargrafo especfico. A propriedade indent da classe TextFormat, que permite o uso de valores negativos. A propriedade kerning da classe TextFormat, que permite a ativao ou desativao do kerning para o objeto TextFormat. A propriedade leading da classe TextFormat, que permite o uso de entrelinhamento negativo, ou seja, que o espao entre as linhas seja inferior altura do texto. Isso permite que voc coloque linhas de texto juntas nos aplicativos. A propriedade letterSpacing da classe TextFormat, que permite a especificao da quantidade de espao distribuda uniformemente entre os caracteres. A propriedade _alpha da classe Video, que a quantidade especificada de transparncia para o objeto vdeo. A propriedade _height da classe Video, que indica a altura da instncia do vdeo. A propriedade _name da classe Video, que indica o nome de instncia do vdeo. A propriedade _parent da classe Video, que indica a instncia ou objeto de clipe de vdeo que contm a instncia do vdeo.26 Novidades do ActionScript no Flash 8

27. A propriedade _rotation da classe Video, que permite a definio do valor de rotao da instncia do vdeo em graus. A propriedade _visible da classe Video, que permite a definio da visibilidade de uma instncia de vdeo. A propriedade _width da classe Video, que permite a definio da largura da instncia do vdeo. A propriedade _x da classe Video, que permite a definio da coordenada x da instncia do vdeo. A propriedade _xmouse da classe Video, que permite a definio da coordenada x da posio do ponteiro do mouse. A propriedade _xscale da classe Video, que permite a definio do percentual de dimensionamento horizontal da instncia do vdeo. A propriedade _y da classe Video, que permite a definio da coordenada y da instncia do vdeo. A propriedade _ymouse da classe Video, quer permite a definio da coordenada y da posio do ponteiro do mouse. A propriedade _yscale da classe Video, que permite a definio do percentual de dimensionamento vertical da instncia do vdeo. O manipulador de eventos onHTTPStatus da classe XML retorna o cdigo de status retornado do servidor (por exemplo, o valor 404 para pgina no encontrada). Para obter mais informaes, consulte onHTTPStatus (XML.onHTTPStatus handler) em ActionScript 2.0 Language Reference. A propriedade localName da classe XMLNode, que retorna o nome completo do objeto n XML (incluindo o prefixo e o nome local). A propriedade namespaceURI da classe XMLNode, que l o URI do namespace para o qual o prefixo do n XML resolve. Para obter mais informaes, consulte namespaceURI (XMLNode.namespaceURI property) em ActionScript 2.0 Language Reference. A propriedade prefix da classe XMLNode, que l o prefixo do nome do n. O mtodo getNamespaceForPrefix() da classe XMLNode, que retorna o URI do namespace associado ao prefixo especificado para o n. O mtodo getPrefixForNamespace da classe XMLNode, que retorna o prefixo associado a um URI de namespace especificado para o n. Novidades do ActionScript 2.0 e do Flash 8 27

28. Sobre elementos de linguagem obsoletosAlguns elementos de linguagem esto obsoletos no Flash Player 8. Para obter uma lista doselementos de linguagem obsoletos e alternativas para uso no Flash Player 8, consulte as seesa seguir do ActionScript 2.0 Language Reference: Deprecated Class summary Deprecated Function summary Deprecated Property summary Deprecated Operator summaryAlteraes de edio do ActionScriptO editor do ActionScript no painel Actions e na janela Script foi atualizado de vrias maneiraspara ficar mais eficiente e fcil de usar do que nas verses anteriores da ferramenta. Essasalteraes so resumidas nesta seo.View hidden characters (Exibir caracteres ocultos) Agora voc pode usar o menu pop-upOptions (Opes) dos painis Script, Debugger (Depurador) e Output (Sada) para exibir ouocultar caracteres quando escrever arquivos de script no painel Actions ou na janela Script.Para obter informaes sobre esse recurso, consulte Exibindo caracteres ocultosna pgina 57.Script assist added to Actions panel (Script assist adicionado ao painel Actions) Nasverses anteriores do Flash, voc podia trabalhar no painel Actions tanto no modo normal, emque voc preenchia opes e parmetros para criar cdigo, quanto no modo especialista, emque voc adicionava comandos diretamente ao painel Script. Essas opes no estavamdisponveis no Flash MX 2004 e no Flash MX Professional 2004. No entanto, no Flash Basic8 e no Flash Professional 8, voc pode trabalhar no modo Script Assist, que semelhante aomodo normal e muito mais eficiente que ele. Para obter informaes sobre o modo ScriptAssist, consulte Captulo 13, Criando ActionScript com o Script Assist em Usando o Flash.Para ver um tutorial sobre o Script Assist, consulte o Captulo 13, Criando um eventostartDrag/stopDrag com o Script Assist do manual Usando o Flash.28 Novidades do ActionScript no Flash 8

29. Reload modified files (Recarregar arquivos modificados) Voc pode recarregar osarquivos de script modificados quando trabalhar em um aplicativo. exibida uma mensagemde aviso, solicitando o recarregamento dos arquivos de script modificados associados aoaplicativo em que voc est trabalhando. Esse recurso especialmente vantajoso para equipesque trabalham simultaneamente em aplicativos. Ele ajuda a evitar o trabalho com scriptsdesatualizados ou que verses mais recentes de um script acabem sendo substitudas. Se umarquivo de script tiver sido movido ou excludo, uma mensagem de aviso ser exibida esolicitar o salvamento dos arquivos conforme necessrio. Para obter mais informaes,consulte Sobre as preferncias do ActionScript na pgina 44.Alteraes no modelo de segurana paraarquivos SWF instalados localmenteO Flash Player 8 possui um modelo de segurana novo e aperfeioado por meio do qual osaplicativos Flash e os arquivos SWF de um computador local podem se comunicar com aInternet e o sistema de arquivos local, em vez de serem executados de um servidor remoto daWeb. Ao desenvolver um aplicativo Flash, voc precisa indicar se um arquivo SWF pode secomunicar com uma rede ou com um sistema de arquivos local.N OT A Nesta descrio, um arquivo SWF local um arquivo SWF instalado localmente no computador de um usurio (e no disponibilizado a partir de um site) e no inclui arquivos de projetor (EXE).Nas verses anteriores do Flash Player, os arquivos SWF locais podiam interagir com outrosarquivos SWF e carregar dados de qualquer computador remoto ou local sem configurardefinies de segurana. No Flash Player 8, um arquivo SWF no pode fazer conexes com osistema de arquivos local e a rede (como a Internet) no mesmo aplicativo sem fazer umaconfigurao de segurana. Isso para sua segurana. Dessa forma, um arquivo SWF no podeler arquivos no seu disco rgido e depois enviar o contedo deles pela Internet.A restrio de segurana afeta todo o contedo implantado localmente, seja um contedoherdado (um arquivo FLA criado em uma verso anterior do Flash) ou criado no Flash 8.Usando o Flash MX 2004 ou uma ferramenta de criao anterior, voc pode testar umaplicativo Flash que seja executado localmente e tambm acesse a Internet. No Flash Player 8,esse aplicativo agora solicita permisso ao usurio para se comunicar com a Internet. Alteraes no modelo de segurana para arquivos SWF instalados localmente 29

30. Quando voc testa um arquivo no disco rgido, so necessrias vrias etapas para determinar seele um documento local confivel (seguro) ou um documento potencialmente no-confivel(sem segurana). Se voc criar o arquivo no ambiente de criao do Flash (por exemplo,quando selecionar Control > Test Movie), seu arquivo ser considerado confivel, pois ele seencontra no ambiente de teste.No Flash Player 7 e anteriores, os arquivos SWF locais tinham permisses para acessar osistema de arquivos local e a rede. No Flash Player 8, os arquivos SWF locais podem ter trsnveis de permisso: Access the local file system only (Acessar somente o sistema de arquivos local), o nvel padro. O arquivo SWF local pode ser lido no sistema de arquivos local e em caminhos de rede de conveno universal de atribuio de nomes (UNC, Universal Naming Convention) e no pode se comunicar com a Internet. Access the network only (Acessar somente a rede). O arquivo SWF local pode acessar somente a rede (como a Internet) e no o sistema de arquivos local onde o arquivo SWF est instalado. Access to both the local file system and the network (Acessar o sistemas de arquivos local e a rede). O arquivo SWF local pode ser lido no sistema de arquivos local onde o arquivo est instalado, pode ser lido em qualquer servidor que lhe conceda permisso (e gravar nele) e pode criar vrios scripts para outros arquivos SWF na rede ou no sistema de arquivos local que lhe conceda permisso.Para obter mais detalhes sobre cada nvel de permisso, consulte Sobre segurana do arquivolocal e o Flash Player na pgina 709.H tambm pequenas alteraes em System.security.allowDomain e aprimoramentos emSystem.security.allowInsecureDomain. Para obter mais informaes sobre segurana dearquivos locais, consulte o Captulo 17, Noes bsicas de segurana.30 Novidades do ActionScript no Flash 8

31. CAPTULO 2Escrevendo e editando oActionScript 2.0 2Ao escrever o cdigo ActionScript no Macromedia Flash Basic 8 ou no Macromedia FlashProfessional 8, use o painel Actions (Aes) ou a janela Script. O painel Actions e a janelaScript contm um editor de cdigo completo (o editor do ActionScript) que inclui refernciasde cdigo e sinalizao por cores, formatao de cdigo, realce de sintaxe, verificao desintaxe, depurao, nmeros de linha, quebra automtica de linha e suporte a Unicode emduas exibies diferentes. Para obter mais informaes sobre o editor do ActionScript,consulte Usando o painel Actions e a janela Script na pgina 36.Use um dos dois mtodos para escrever o cdigo ActionScript no Flash. Voc pode criarscripts que faam parte de seu documento do Flash (ou seja, scripts incorporados ao arquivoFLA) ou criar scripts externos (scripts ou classes armazenadas em arquivos externos). No possvel usar o painel Actions para criar scripts externos.Use o editor do ActionScript no painel Actions ao criar scripts em um arquivo FLA. O painelActions contm o editor do ActionScript em um painel Script e ferramentas de suporte parafacilitar a criao de scripts. Essas ferramentas incluem a caixa de ferramentas Actions (Aes)que oferece um acesso rpido aos elementos bsicos da linguagem ActionScript; o navegadorScript que ajuda na navegao por todos os scripts do documento; e o modo Script Assist(Assistncia de script) que solicita os elementos necessrios para a criao de scripts. Para obtermais informaes sobre o painel Actions, consulte Sobre o painel Actions na pgina 37. Paraobter mais informaes sobre o Script Assist, consulte Sobre o Script Assist na pgina 62.Quando precisar criar um script externo, use o editor do ActionScript na janela Script paracriar um novo arquivo do ActionScript. (Voc tambm pode usar o seu editor de texto favoritopara criar um arquivo externo do AS.) Na janela Script, o editor do Action Script incluirecursos de assistncia a cdigo, como referncias de cdigo e sinalizao por cores, verificaode sintaxe etc., da mesma forma que no painel Actions. Para obter mais informaes sobre ajanela Script, consulte Sobre a janela Script na pgina 38. 31

32. O Flash oferece assistncia adicional a scripts atravs de comportamentos. Oscomportamentos so funes predefinidas do ActionScript que voc pode anexar a objetos nodocumento do Flash sem precisar criar o cdigo ActionScript. Para obter mais informaessobre comportamentos, consulte Sobre comportamentos na pgina 65.Para obter mais informaes sobre como manipular eventos, consulte as seguintes sees:Sobre o ActionScript e eventos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32Organizando o cdigo ActionScript. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34Usando o painel Actions e a janela Script. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36Sobre o painel Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Sobre a janela Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Sobre a codificao no painel Actions e na janela Script . . . . . . . . . . . . . . . . . . . . . . 39Sobre recursos do painel Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62Sobre comportamentos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65Sobre as configuraes de publicao do ActionScript . . . . . . . . . . . . . . . . . . . . . . . 66Sobre o ActionScript e eventosNo Macromedia Flash Basic 8 e no Macromedia Flash Professional 8, o cdigo ActionScript executado quando ocorre um evento: por exemplo, quando um clipe de filme carregado,quando um quadro-chave inserido na timeline ou quando o usurio clica em um boto. Oseventos podem ser ativados pelo usurio ou pelo sistema. Os usurios clicam em botes domouse e pressionam teclas; o sistema ativa eventos quando condies especficas so atendidasou quando processos so concludos (o arquivo SWF carregado, a timeline alcana umdeterminado quadro, um elemento grfico conclui o download etc.).Quando ocorre um evento, voc cria um manipulador de eventos para responder ao evento comuma ao. Compreender quando e onde ocorrero os eventos o ajudar a determinar como eonde voc responder a eles com uma ao e quais ferramentas do ActionScript utilizar emcada caso. Para obter mais informaes, consulte Sobre a criao de scripts para manipulareventos na pgina 35.Os eventos podem ser agrupados em vrias categorias: eventos de mouse e teclado, queocorrem quando o usurio interage com seu aplicativo Flash atravs do mouse e do teclado;eventos de clipe, que ocorrem em clipes de filme; e eventos de quadro, que ocorrem emquadros na timeline.Para obter informaes sobre os tipos de scripts que podem ser criados para manipulareventos, consulte Sobre a criao de scripts para manipular eventos na pgina 35.32 Escrevendo e editando o ActionScript 2.0

33. Eventos de mouse e tecladoQuando o usurio interage com seu aplicativo ou arquivo SWF, ele ativa eventos de mouse eteclado. Por exemplo, quando ele rola sobre um boto, ocorre o evento Button.onRollOverou on(rollOver); quando ele clica em um boto, o evento Button.onRelease ativado; seuma tecla do teclado for pressionada, o evento on(keyPress) ocorrer. Voc pode criar umcdigo em um quadro ou anexar scripts a uma instncia para manipular esses eventos eadicionar toda a interatividade desejada.Eventos de clipeEm um clipe de filme, voc pode reagir a diversos eventos de clipe ativados quando o usurioentra ou sai da cena ou interagir com a cena usando o mouse ou o teclado. Por exemplo, vocpode carregar uma imagem externa SWF ou JPG no clipe de filme quando o usurio entrar nacena ou permitir que os movimentos do mouse do usurio reposicionem elementos na cena.Eventos de quadroEm uma timeline principal ou de clipe de filme, um evento de sistema ocorre quando areproduo entra em um quadro-chave conhecido como evento de quadro. Os eventos dequadro so teis para ativar aes baseadas na passagem de tempo (que se movem pelatimeline) ou para interagir com elementos visveis no momento no Stage. Quando vocadiciona um script a um quadro-chave, ele executado quando o quadro-chave alcanadodurante uma reproduo. Os script anexados a um quadro so chamados scripts de quadro.Uma das utilizaes mais comuns dos scripts de quadro interromper a reproduo quandoum determinado quadro-chave alcanado. Isso feito com a funo stop(). Selecione umquadro-chave e adicione a funo stop() como um elemento de script no painel Actions.Ao interromper arquivo SWF em um quadro-chave especfico, voc precisar executar umaao. Voc pode, por exemplo, usar um script de quadro para atualizar dinamicamente o valorde um rtulo, gerenciar a interao dos elementos no Stage etc. Sobre o ActionScript e eventos 33

34. Organizando o cdigo ActionScript possvel anexar scripts a quadros-chave e instncias de objeto (clipes de filme, botes eoutros smbolos). Entretanto, se o seu cdigo ActionScript for distribudo por vrios quadros-chave e instncias de objeto, a depurao de seu aplicativo ficar muito mais difcil. Tambmser difcil compartilhar o cdigo com diferentes aplicativos Flash. Portanto, importante quevoc siga as prticas recomendadas de codificao ao criar o ActionScript no Flash.Em vez de anexar scripts aos elementos, como quadros-chave, clipes de filme e botes,responda aos eventos chamando as funes residentes em um local central. Um dos mtodosconsiste em anexar o ActionScript incorporado ao primeiro ou ao segundo quadro datimeline, sempre que possvel, para que voc no precise pesquisar o arquivo FLA a fim delocalizar todo o cdigo. Uma prtica comum envolve a criao de uma camada denominadaactions e a incluso do cdigo ActionScript nessa camada.Ao anexar todos os scripts a elementos individuais, voc incorpora todo o cdigo ao arquivoFLA. Se o compartilhamento de seu cdigo com outros aplicativos do Flash for um requisitoimportante para voc, use a janela Script ou o seu editor de texto favorito para criar umarquivo externo do ActionScript (AS).A criao de um arquivo externo torna o seu cdigo mais modular e bem organizado. medida que seu projeto for se desenvolvendo, essa convenincia ter cada vez mais utilidadedo que voc imagina. Um arquivo externo ajudar na depurao e tambm no gerenciamentodo controle de origem caso voc esteja trabalhando em um projeto junto com outrosdesenvolvedores.Para usar o cdigo ActionScript contido em um arquivo externo do AS, crie um script noarquivo FLA e use a instruo #include para acessar o cdigo armazenado externamente,como mostrado no exemplo a seguir:#include "../core/Functions.as"34 Escrevendo e editando o ActionScript 2.0

35. Tambm possvel usar o ActionScript 2.0 para criar classes personalizadas. Armazene asclasses personalizadas em arquivos externos do AS e use instrues import em um script paraexportar as classes para o arquivo SWF, em vez de usar instrues #include. Para obter maisinformaes sobre como criar arquivos de classe, consulte Criando arquivos de classespersonalizados na pgina 249 e Sobre a importao de arquivos de classes na pgina 254que tratam da importao desses arquivos. Voc tambm pode usar componentes (clipes defilme predefinidos) para compartilhar cdigo e funcionalidade, como scripts e elementos deUI.NO T A O cdigo do ActionScript em arquivos externos compilado em um arquivo SWF quando voc publica, exporta, testa ou depura um arquivo FLA. Portanto, se voc fizer qualquer alterao em um arquivo externo, ser preciso salv-lo e recompilar os arquivos FLA que o utilizam.Ao criar o ActionScript no Flash 8, use o painel Actions, a janela Script ou ambos. O uso dopainel Actions ou da janela Script determinado pelo modo de resposta aos eventos, pelomodo de organizao do cdigo e, principalmente, pelas prticas recomendadas decodificao.Para obter mais informaes sobre convenes e prticas recomendadas de codificao,consulte Convenes de codificao do ActionScript na pgina 782.Outros problemas relacionados a fluxo de trabalho e organizao de cdigo devero serconsiderados quando voc usar comportamentos, que so funes predefinidas doActionScript (consulte Sobre comportamentos na pgina 65).Sobre a criao de scripts para manipular eventosA criao de cdigo para eventos pode ser categorizada em dois grupos principais: eventos queocorrem na timeline (em quadros-chave) e eventos que ocorrem em instncias de objeto(clipes de filme, botes e componentes). A interatividade de seu aplicativo ou arquivo SWFpode ser distribuda pelos vrios elementos de seu projeto; voc tambm pode optar poradicionar scripts diretamente a esses elementos. Entretanto, a Macromedia recomenda a noadio direta de scripts a esses elementos (quadros-chave e objetos). Nesse caso, voc deveresponder aos eventos chamando as funes residentes em um local central, conforme descritoem Organizando o cdigo ActionScript. Organizando o cdigo ActionScript 35

36. Usando o painel Actions e a janela ScriptPara criar scripts em um arquivo FLA, insira o ActionScript diretamente no painel Actions.Para criar scripts externos a serem includos ou importados para o seu aplicativo, voc podeusar a janela Script (File [Arquivo] > New [Novo] e selecionar ActionScript File [Arquivo doActionScript]) ou o seu editor de texto preferido.A utilizao do painel Actions ou da janela Script equivale ao uso dos recursos do editor doActionScript para criar, formatar e editar o cdigo. O painel Actions e a janela Script possuemo painel Script (onde o cdigo digitado) e a caixa de ferramentas Actions. O painel Actionsoferece mais alguns recursos de assistncia a cdigo do que a janela Script. O Flash ofereceesses recursos no painel Actions por eles serem especialmente teis no contexto de edio doActionScript em um arquivo FLA.Para exibir o painel Actions, siga um destes procedimentos: Selecione Window (Janela) > Actions (Aes). Pressione F9.Para exibir a janela Script, siga um destes procedimentos: Para comear a escrever um novo script, selecione File (Arquivo) > New (Novo) e ActionScript File (Arquivo do ActionScript). Para abrir um script existente, selecione File > Open (Abrir) e abra um arquivo do AS. Para editar um script j aberto, clique na guia do documento que exibe o nome do script.Para obter mais informaes, consulte os tpicos a seguir: Sobre o painel Actions na pgina 37 Sobre a janela Script na pgina 3836 Escrevendo e editando o ActionScript 2.0

37. Sobre o painel ActionsUse o painel Actions para criar o ActionScript em um documento do Flash (arquivo FLA). Opainel consiste em trs painis, e cada um deles oferece suporte criao e ao gerenciamentode scripts.Actions (Aes), caixade ferramentas Navegador Script Script, painel Menu pop-up Caixa de ferramentas Actions Use esta caixa de ferramentas para pesquisar uma lista categrica de elementos da linguagem ActionScript (funes, classes, tipos etc.) e, em seguida, insira-os no painel Script. Para inserir um elemento de script no painel Script, clique duas vezes nele ou arraste-o diretamente para esse painel. Voc tambm pode adicionar elementos de linguagem aos scripts usando o boto Add (+) (Adicionar) localizado na barra de ferramentas do painel Actions. Para obter mais informaes, consulte Sobre as barras de ferramentas do painel Actions e da janela Script na pgina 40. Navegador Script Exibe uma lista hierrquica de elementos do Flash (clipes de filme, quadros e botes) contendo scripts. Use o navegador Script para se mover rapidamente entre todos os scripts do documento do Flash. Se voc clicar em um item no navegador Script, o script associado a esse item aparecer no painel Script e a reproduo passar para essa posio na timeline. Se voc clicar duas vezes em um item do navegador Script, o script ficar preso (travado no lugar). Para obter mais informaes, consulte Prendendo scripts no painel Actions na pgina 63. Sobre o painel Actions 37

38. Painel Script No painel Script, voc digita seu cdigo. O painel fornece ferramentas para a criao de scripts em um editor completo (o editor do ActionScript) que inclui verificao e formatao de sintaxe, referncias de cdigo, sinalizao por cores, depurao e outros recursos que simplificam a criao. Para obter mais informaes, consulte Usando o painel Actions e a janela Script na pgina 36. Para obter informaes sobre cada boto da barra de ferramentas do painel Actions, consulte Sobre a codificao no painel Actions e na janela Script na pgina 39. Para obter mais informaes sobre os recursos do painel Actions, consulte os seguintes tpicos: Sobre as barras de ferramentas do painel Actions e da janela Script na pgina 40 Sobre as opes de edio do ActionScript na pgina 42 Sobre as referncias de cdigo no Flash na pgina 47 Formatando cdigo na pgina 53 Usando o realce de sintaxe na pgina 54 Usando nmeros de linha e quebra automtica de linha na pgina 55 Usando teclas de atalho de Escape na pgina 56 Exibindo caracteres ocultos na pgina 57 Usando a ferramenta Find na pgina 58 Verificando sintaxe e pontuao na pgina 59 Importando e exportando scripts na pgina 60Sobre a janela ScriptVoc pode criar e editar o ActionScript na janela Script ao criar um novo arquivo doActionScript, do Flash Communication ou do Flash JavaScript. Use a janela Script para criar eeditar arquivos de script externos. A janela oferece suporte sinalizao da sintaxe por cores, areferncias de cdigo e a outras opes de editor.Nessa janela, possvel criar um ActionScript externo, a comunicao do ActionScript earquivos do Flash JavaScript. Dependendo do tipo de arquivo de script externo criado, a caixade ferramentas Actions fornecer uma lista completa dos elementos de linguagem disponveispara cada um deles.Ao usar a janela Script, voc perceber que alguns dos outros recursos de assistncia a cdigo,como o navegador Script, o modo Script Assist e os comportamentos, no estaro disponveis.Isso ocorre porque esses recursos so teis apenas no contexto de criao de um documento doFlash, e no de criao de um arquivo de script externo.38 Escrevendo e editando o ActionScript 2.0

39. Voc tambm observar que vrias opes disponveis no painel Actions no esto disponveisna janela Script. A janela Script oferece suporte s seguintes opes de editor: caixa deferramentas Actions, recursos local