Aprendendo ActionScript 2.0 no Flash -...

Aprendendo ActionScript 2.0 no Flash

Marcas comerciais

1 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 estar registradas 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 da Macromedia, Inc. ou de outras entidades e podem estar registrados em certas jurisdies, inclusive internacionais.

Informaes de terceiros

Este guia contm links para sites da Web de terceiros que no esto sob o controle da Macromedia. Nesses casos, a Macromedia no 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 um link 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 os direitos reservados.

O vdeo Macromedia Flash 8 possui tecnologia de vdeo On2 TrueMotion. 1992-2005 On2 Technologies, Inc. Todos os direitos reservados. http://www.on2.com.

Visual SourceSafe uma marca comercial ou comercial registrada da Microsoft Corporation nos Estados Unidos e/ou em outros pases.

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 ou em parte, sem o consentimento prvio por escrito da Macromedia, Inc. No obstante o precedente, o proprietrio ou usurio autorizado de uma cpia vlida do software com que este manual foi fornecido pode imprimir uma cpia deste manual a partir de uma verso eletrnica com a finalidade nica de ele prprio ou um usurio autorizado aprender a usar este software, desde que nenhuma parte deste manual seja impressa, reproduzida, distribuda, revendida ou transmitida para qualquer outro fim, incluindo, sem limitao, fins comerciais, como vendas de cpias desta documentao ou fornecimento de servios de suporte pr-pagos.

Agradecimentos

Gerenciamento de projetos: Sheila McGinn

Criao do texto: Jen deHaan; Peter deHaan, Joey Lott

Editora geral: Rosana Francescato

Editora chefe: Lisa Stanziano

Edio: Linda Adler, Geta Carlson, Evelyn Eldridge, John Hammett, Mary Kraemer, Noreen Maher, Jessie Wood, Anne Szabla

Gerenciamento de produo: Patrice ONeill, Kristin Conradi, Yuko Yagi

Projeto de mdia e produo: Adam Barnett, Aaron Begley, Paul Benkman. John Francis, Geeta Karmarkar, Masayo Noda, Paul Rangel, Arena Reed, Mario Reynoso

Agradecimentos 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 2005

Macromedia, Inc. 601 Townsend St. San Francisco, CA 94103

http://www.on2.com

Contedo

Introduo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

Pblico-alvo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9Requisitos de sistema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9Atualizando arquivos XML para Flash . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Sobre a documentao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Recursos adicionais. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Captulo 1: Novidades do ActionScript no Flash 8 . . . . . . . . . . . . 19

Novidades do ActionScript 2.0 e do Flash 8 . . . . . . . . . . . . . . . . . . . . . . 19Alteraes no modelo de segurana para arquivos SWF instalados localmente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Captulo 2: Escrevendo e editando o ActionScript 2.0 . . . . . . . . 31

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

Captulo 3: Sobre o ActionScript . . . . . . . . . . . . . . . . . . . . . . . . . . 71

O 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

Captulo 4: Dados e tipos de dados . . . . . . . . . . . . . . . . . . . . . . . . 75

Sobre dados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Sobre tipos de dados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Sobre variveis. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91Organizando dados em objetos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .114Sobre a converso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .116

Captulo 5: Fundamentos da sintaxe e da linguagem . . . . . . . . 119

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

Captulo 6: Funes e mtodos . . . . . . . . . . . . . . . . . . . . . . . . . . 213

Sobre funes e mtodos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213Noes bsicas sobre mtodos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .235

Captulo 7: Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239

Sobre a programao orientada a objeto e o Flash . . . . . . . . . . . . . 240Criando arquivos de classes personalizados. . . . . . . . . . . . . . . . . . . . 249Sobre como trabalhar com classes personalizadas em um aplicativo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .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 . . . . . . . . . . . . . . . . . . . . . 312

Captulo 8: Herana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319

Sobre herana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319Sobre a criao de subclasses no Flash . . . . . . . . . . . . . . . . . . . . . . . . 321Usando o polimorfismo em um aplicativo . . . . . . . . . . . . . . . . . . . . . . .327

4 Contedo

Captulo 9: Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331

Sobre interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .331Criando interfaces como tipos de dados. . . . . . . . . . . . . . . . . . . . . . . . 337Noes bsicas sobre herana e interfaces. . . . . . . . . . . . . . . . . . . . . 339Exemplo: Usando interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340Exemplo: Criando uma interface complexa . . . . . . . . . . . . . . . . . . . . . 342

Captulo 10: Manipulando eventos . . . . . . . . . . . . . . . . . . . . . . . 347

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

Captulo 11: Trabalhando com clipes de filme . . . . . . . . . . . . . . 369

Sobre 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 criados dinamicamente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383Gerenciando profundidades do clipe de filme . . . . . . . . . . . . . . . . . . . 385Sobre o armazenamento em cache e a rolagem de clipes de 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 . . . . . . . . . . . . . . . . . . . . . . . . .401

Captulo 12: Trabalhando com texto e seqncias de caracteres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403

Sobre 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

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

Captulo 13: Animao, filtros e desenhos. . . . . . . . . . . . . . . . . 497

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

Captulo 14: Criando interao com o ActionScript . . . . . . . . . 589

Sobre eventos e interao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590Controlando a reproduo de arquivos SWF . . . . . . . . . . . . . . . . . . . 590Criando interatividade e efeitos visuais. . . . . . . . . . . . . . . . . . . . . . . . . 593Criando vinculaes de dados durante a execuo com o ActionScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .607Desconstruindo um script de exemplo . . . . . . . . . . . . . . . . . . . . . . . . . . 616

Captulo 15: Trabalhando com imagens, som e vdeo . . . . . . . . 619

Sobre 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 arquivos de mdia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .654

6 Contedo

Captulo 16: Trabalhando com dados externos . . . . . . . . . . . . . 663

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

Captulo 17: Noes bsicas de segurana . . . . . . . . . . . . . . . . 707

Sobre compatibilidade com os modelos de segurana anteriores 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 . . . . . 741

Captulo 18: Depurando aplicativos . . . . . . . . . . . . . . . . . . . . . . 745

Depurando scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 745Usando o painel Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 759

Captulo 19: Melhores prticas e convenes de codificao para ActionScript 2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .767

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

Apndice A: Mensagens de erro . . . . . . . . . . . . . . . . . . . . . . . . . 809

Apndice B: Operadores Flash 4 obsoletos . . . . . . . . . . . . . . . . 815

Apndice C: Teclas do teclado e valores de cdigos de teclas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 817

Apndice D: Criando scripts para verses anteriores do Flash Player . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 825

Sobre a especificao de verses anteriores do Flash Player . . . . 825Usando o Flash 8 para criar contedo para o Flash Player 4 . . . . . 826

Contedo 7

Apndice E: Programao orientada a objeto com o ActionScript 1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 829

Sobre o ActionScript 1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 830Criando um objeto personalizado no ActionScript 1.0 . . . . . . . . . . . . 831Atribuindo mtodos a um objeto personalizado no ActionScript 1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .832Definindo mtodos manipuladores de eventos no ActionScript 1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .834Criando herana no ActionScript 1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . .836Adicionando propriedades getter/setter a objetos no ActionScript 1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .837Usando as propriedades do objeto Function no ActionScript 1.0 . .838

Apndice F: Terminologia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 841

ndice. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 851

8 Contedo

Introduo

O Macromedia Flash Basic 8 e o Macromedia Flash Professional 8 so as ferramentas de criao padro profissionais para a produo de experincias de grande impacto na Web. O ActionScript a linguagem utilizada para adicionar interatividade aos aplicativos Flash, sejam os aplicativos arquivos SWF animados simples ou aplicativos de Internet avanados mais complexos. Para usar o Flash, no necessrio o ActionScript, mas, se voc desejar fornecer interatividade bsica ou complexa com o usurio, trabalhar com objetos diferentes daqueles contidos no Flash (como botes e clipes de filme) ou ento transformar um arquivo SWF em uma experincia de usurio mais eficiente, dever usar o ActionScript.

Para obter mais informaes, consulte os tpicos a seguir:Pblico-alvo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Atualizando arquivos XML para Flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Requisitos de sistema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Sobre a documentao. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Recursos adicionais. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Pblico-alvoEste manual pressupe que voc j tenha instalado o Flash Basic 8 ou o Flash Professional 8 e saiba como usar a interface de usurio. preciso que saiba posicionar objetos no Stage e manipul-los no ambiente de criao do Flash. Se j tiver usado uma linguagem de criao, o ActionScript lhe parecer familiar. No entanto, se for iniciante em programao, saiba que os fundamentos do ActionScript so fceis de aprender. Voc pode comear com comandos simples e criar mais complexidade com o tempo. Pode adicionar muita interatividade aos seus arquivos sem precisar aprender (ou escrever) muito cdigo.

Requisitos de sistemaO ActionScript 2.0 no tem qualquer requisito de sistema alm do Flash 8 .

9

Este manual pressupe que voc esteja utilizando as configuraes de publicao padro para os arquivos do Flash: Flash Player 8 e ActionScript 2.0. Se voc alterar qualquer uma dessas configuraes, as explicaes e exemplos de cdigo apresentados na documentao podero no funcionar corretamente. Caso desenvolva aplicativos para verses anteriores do Flash Player, consulte o Apndice D, Criando scripts para verses anteriores do Flash Player, na pgina 825.

Atualizando arquivos XML para Flash importante que estejam sempre instalados os arquivos XML para Flash mais recentes. A Macromedia algumas vezes apresenta recursos em verses com ponto (verses menores) do Flash Player. Quando uma verso dessas se encontrar disponvel, atualize sua verso do Flash para obter os arquivos XML mais recentes. Caso contrrio, o compilador do Flash 8 poder gerar erros caso voc use novas propriedades ou mtodos indisponveis na verso do Flash Player 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 Player Updater (Atualizador de player) para atualizar todos os players instalados com o Flash. Caso contrrio, o compilador do Flash exibir erros.

Lembre-se de que possvel instalar um Player Updater que seja de uma ou mais verses maiores 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 mais antigas do Flash Player. Algumas vezes, novos mtodos ou propriedades encontram-se disponveis para verses mais antigas, e ter os arquivos XML mais recentes minimiza os erros de 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 uso de 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 13

10 Introduo

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

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 os elementos de linguagem propriamente ditos, consulte o ActionScript 2.0 Language Reference.

12 Introduo

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 cdigo Quando voc colar o ActionScript do painel Help (Ajuda) para o FLA ou o arquivo do ActionScript, preste ateno aos caracteres especiais. So caracteres especiais as aspas especiais (tambm chamadas de aspas curvas ou aspas inglesas). Esses caracteres no so interpretados pelo editor do ActionScript, ento o cdigo lana um erro quando voc tenta compil-lo no Flash.

Sobre a documentao 13

Voc pode identificar se os caracteres de aspas so especiais quando eles no so codificados por cores de forma correta. Ou seja, se nenhuma seqncia de caracteres mudar de cor no editor de cores, ser preciso substituir os caracteres especiais por caracteres de aspas retas comuns. Se voc digitar um caractere de aspa simples ou dupla diretamente no editor do ActionScript, sempre digitar um caractere de aspa reta. O compilador (quando voc testa ou publica 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.

Cuidado com quebras de linha ao copiar e colar cdigo. Ao colar o seu cdigo de alguns locais, a linha de cdigo poder se quebrar em um local inapropriado. Certifique-se de que a codificao de cores da sua sintaxe esteja correta no editor do ActionScript se achar que as quebras 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 (quebra automtica de linha) no editor do ActionScript para ajudar a solucionar quebras de linha excedentes no cdigo (selecione View (Exibir) > Word Wrap (quebra automtica de linha) na janela 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, como componentes 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 Onde encontrar 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 17

NO

TA

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.

14 Introduo

Sobre os arquivos de exemplo H vrios arquivos de exemplo baseados no ActionScript que so instalados com o Flash. Esses arquivos de exemplo mostram como o cdigo funciona em um arquivo FLA; geralmente servem como uma ferramenta de aprendizado bem til. Os captulos deste manual muitas vezes fazem referncia a esses arquivos, mas recomendamos que voc consulte tambm a pasta de arquivos de exemplo do seu disco rgido.

Os arquivos de exemplo incluem arquivos FLA de aplicativo que usam funes comuns do Flash instaladas com ele. Esses aplicativos foram projetados para apresentar aos novos desenvolvedores do Flash as capacidades dos aplicativos Flash assim como para mostrar aos desenvolvedores avanados como funcionam os recursos do Flash no contexto.

Voc pode encontrar os arquivos de origem de exemplo com foco no ActionScript na pasta Samples (Exemplos) do disco rgido.

No Windows, navegue at a unidade de inicializao\Program Files\Macromedia\Flash 8\Samples and Tutorials\Samples\ActionScript\.

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, pois eles contm vrios cdigos ActionScript. Eles tambm podem ser encontrados na pasta Samples do disco rgido:

No Windows, navegue at a unidade de inicializao\Program Files\Macromedia\Flash 8\Samples and Tutorials\Samples\Components\.

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. A pgina da Web a seguir contm links e descries de arquivos de exemplo adicionais: www.macromedia.com/go/flash_samples/.

Onde encontrar arquivos PDF ou documentao impressaCaso prefira ler a documentao em formato impresso, as verses PDF de cada manual encontram-se disponveis para download. V at www.macromedia.com/support/documentation/ e selecione o produto em que est interessado. Voc pode exibir ou fazer o download do PDF ou acessar o link da verso LiveDocs do manual.

Recursos adicionais 15

http://www.macromedia.com/go/flash_samples/http://www.macromedia.com/support/documentation/http://www.macromedia.com/support/documentation/

Muitas vezes voc tambm pode adquirir a documentao impressa. Para obter informaes atualizadas, v at o site de suporte da documentao e selecione Flash Basic 8 ou Flash Professional 8.

Sobre o LiveDocs Voc pode acessar a documentao no site LiveDocs ou pelo painel Help. O site LiveDocs contm todas as pginas de ajuda do Flash e pode conter comentrios que esclaream, atualizem ou corrijam partes da documentao. Clique em View Comments (Exibir comentrios) em LiveDocs na parte inferior de uma pgina do painel Help para exibir a pgina equivalente no site LiveDocs. V at http://livedocs.macromedia.com para ver uma lista de toda a documentao disponvel no formato LiveDocs.

Escritores tcnicos monitoram o site LiveDocs. Uma das vantagens do LiveDocs ver comentrios que esclarecem a documentao ou corrigir erros ou problemas que surgem aps o lanamento de um software. No no LiveDocs que voc faz solicitaes de ajuda, como perguntas sobre seu cdigo que no funciona, comentrios sobre problemas com software ou instalao ou perguntas sobre como criar algo com o Flash. Nele voc fornece informaes sobre a documentao (por exemplo, voc aponta uma frase ou pargrafo que requer esclarecimento).

Quando voc clica no boto para adicionar um comentrio sobre o LiveDocs, h diversos pontos sobre os tipos de comentrios que so aceitveis no sistema. Leia essas diretrizes atentamente 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 fazer perguntas, pois h vrios funcionrios da Macromedia l, voluntrios da equipe Macromedia, gerentes e membros de grupos de usurio da Macromedia e at escritores tcnicos que monitoram esses fruns.

Engenheiros no monitoram o sistema LiveDocs, mas a lista de tarefas do Flash. Se achar que encontrou 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 a solicitao de aprimoramento no LiveDocs, eles no sero adicionados de forma oficial ao banco de dados de bugs. Use o formulrio apropriado se quiser que um engenheiro d ateno ao 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 caracteres especiais dos exemplos de cdigo, mas, se voc tiver dificuldades para colar o cdigo, consulte Copiar e colar cdigo na pgina 13.

16 Introduo

http://www.macromedia.com/support/documentation/http://livedocs.macromedia.com/http://www.macromedia.com/support/forums/http://www.macromedia.com/go/wish/

Recursos on-line adicionaisExistem vrios recursos on-line que oferecem vrias instrues, ajuda e orientao para facilitar o uso do Macromedia Flash 8. Consulte com freqncia os seguintes sites para obter atualizaes:

O site The Macromedia Developer Center (www.macromedia.com/devnet) atualizado regularmente com as informaes mais recentes sobre o Flash, alm de oferecer aconselhamentos de usurios experientes, tpicos avanados, exemplos, dicas, tutoriais (incluindo tutoriais com vrias partes) e outras atualizaes. Visite com freqncia o site da Web 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 recursos adicionais na comunidade Flash.

O site The Macromedia Weblogs (http://weblogs.macromedia.com) fornece uma lista dos weblogs (tambm chamados de blogs) de funcionrios e da comunidade Macromedia .

Os fruns da Web da Macromedia (http://webforums.macromedia.com) oferecem vrios fruns 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 visitados por funcionrios de l tambm. Se no souber a quem recorrer ou como resolver um problema, comece por um frum do Flash.

O site The Macromedia Community (www.macromedia.com/community) hospeda regularmente Macrochats, uma srie de apresentaes ao vivo sobre uma variedade de tpicos feitas por funcionrios ou membros da comunidade Macromedia. Consulte regulamente o site procura de atualizaes e para registrar-se nos Macrochats.

Onde encontrar documentao sobre outros assuntosOs manuais a seguir oferecem informaes adicionais sobre assuntos comumente associados ao 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

http://www.macromedia.com/devnethttp://www.macromedia.com/support/flashhttp://weblogs.macromedia.comhttp://webforums.macromedia.comhttp://www.macromedia.com/community/

18 Introduo

1

CAPTULO 1

Novidades do ActionScript no Flash 8

O Macromedia Flash Basic 8 e o Macromedia Flash Professional 8 oferecem vrios aprimoramentos que facilitam a criao de scripts mais eficientes com uso da linguagem ActionScript. Os novos recursos, analisados neste captulo, incluem novos elementos de linguagem (consulte Acrscimos linguagem ActionScript na pgina 22), ferramentas de edio aprimoradas (consulte Alteraes de edio do ActionScript na pgina 28), alteraes no modelo de segurana e outros aprimoramentos do ActionScript relacionados ferramenta de criao.

Para obter mais informaes, consulte os seguintes tpicos:Novidades do ActionScript 2.0 e do Flash 8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Alteraes no modelo de segurana para arquivos SWF instalados localmente . 29

Novidades do ActionScript 2.0 e do Flash 8A linguagem ActionScript cresceu e desenvolveu-se desde sua introduo, h vrios anos. Com cada nova verso do Flash, mais palavras-chave, objetos, mtodos e outros elementos foram adicionados linguagem. Existem tambm aprimoramentos do ActionScript relacionados aos ambientes de criao do Flash 8. O Flash Basic 8 e o Flash Professional 8 introduzem vrios novos elementos de linguagem para recursos expressivos, como filtros e modos de mistura, alm do desenvolvimento de aplicativos, como integrao do JavaScript (ExternalInterface) e entrada e sada de arquivo (FileReference e FileReferenceList).

Esta seo fornece uma viso geral dos elementos e classes da linguagem ActionScript que so novos 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, consulte Acrscimos linguagem ActionScript na pgina 22. Para usar qualquer dos novos elementos da linguagem nos seus scripts, tenha em mente o Flash Player 8 (o padro) quando publicar seus documentos.

19

Os recursos a seguir foram adicionados ao Flash Basic 8 e ao Flash Professional 8 (a menos que explicitado 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

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

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 especficas adicionadas ao ActionScript 2.0 no Flash 8, consulte Acrscimos linguagem ActionScript na pgina 22.

Acrscimos linguagem ActionScriptEsta seo lista acrscimos aos elementos e classes da linguagem ActionScript novos ou alterados no Flash 8. As classes e os elementos de linguagem a seguir so novos acrscimos ao Flash 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.


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.

NO

TA

No Flash 8 foi adicionado suporte oficial para a classe AsBroadcaster.


Os novos elementos, mtodos e funes da linguagem adicionados a classes existentes no ActionScript 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.


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.


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.


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.


Sobre elementos de linguagem obsoletosAlguns elementos de linguagem esto obsoletos no Flash Player 8. Para obter uma lista dos elementos de linguagem obsoletos e alternativas para uso no Flash Player 8, consulte as sees a seguir do ActionScript 2.0 Language Reference:

Deprecated Class summary

Deprecated Function summary

Deprecated Property summary

Deprecated Operator summary

Alteraes de edio do ActionScriptO editor do ActionScript no painel Actions e na janela Script foi atualizado de vrias maneiras para ficar mais eficiente e fcil de usar do que nas verses anteriores da ferramenta. Essas alteraes so resumidas nesta seo.

View hidden characters (Exibir caracteres ocultos) Agora voc pode usar o menu pop-up Options (Opes) dos painis Script, Debugger (Depurador) e Output (Sada) para exibir ou ocultar caracteres quando escrever arquivos de script no painel Actions ou na janela Script. Para obter informaes sobre esse recurso, consulte Exibindo caracteres ocultos na pgina 57.

Script assist added to Actions panel (Script assist adicionado ao painel Actions) Nas verses anteriores do Flash, voc podia trabalhar no painel Actions tanto no modo normal, em que voc preenchia opes e parmetros para criar cdigo, quanto no modo especialista, em que voc adicionava comandos diretamente ao painel Script. Essas opes no estavam disponveis no Flash MX 2004 e no Flash MX Professional 2004. No entanto, no Flash Basic 8 e no Flash Professional 8, voc pode trabalhar no modo Script Assist, que semelhante ao modo normal e muito mais eficiente que ele. Para obter informaes sobre o modo Script Assist, 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 evento startDrag/stopDrag com o Script Assist do manual Usando o Flash.


Reload modified files (Recarregar arquivos modificados) Voc pode recarregar os arquivos de script modificados quando trabalhar em um aplicativo. exibida uma mensagem de aviso, solicitando o recarregamento dos arquivos de script modificados associados ao aplicativo em que voc est trabalhando. Esse recurso especialmente vantajoso para equipes que trabalham simultaneamente em aplicativos. Ele ajuda a evitar o trabalho com scripts desatualizados ou que verses mais recentes de um script acabem sendo substitudas. Se um arquivo de script tiver sido movido ou excludo, uma mensagem de aviso ser exibida e solicitar o salvamento dos arquivos conforme necessrio. Para obter mais informaes, consulte Sobre as preferncias do ActionScript na pgina 44.

Alteraes no modelo de segurana para arquivos SWF instalados localmenteO Flash Player 8 possui um modelo de segurana novo e aperfeioado por meio do qual os aplicativos Flash e os arquivos SWF de um computador local podem se comunicar com a Internet e o sistema de arquivos local, em vez de serem executados de um servidor remoto da Web. Ao desenvolver um aplicativo Flash, voc precisa indicar se um arquivo SWF pode se comunicar com uma rede ou com um sistema de arquivos local.

Nas verses anteriores do Flash Player, os arquivos SWF locais podiam interagir com outros arquivos SWF e carregar dados de qualquer computador remoto ou local sem configurar definies de segurana. No Flash Player 8, um arquivo SWF no pode fazer conexes com o sistema de arquivos local e a rede (como a Internet) no mesmo aplicativo sem fazer uma configurao de segurana. Isso para sua segurana. Dessa forma, um arquivo SWF no pode ler 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 contedo herdado (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 um aplicativo 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.

NO

TA

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

Alteraes no modelo de segurana para arquivos SWF instalados localmente 29

Quando voc testa um arquivo no disco rgido, so necessrias vrias etapas para determinar se ele 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 se encontra no ambiente de teste.

No Flash Player 7 e anteriores, os arquivos SWF locais tinham permisses para acessar o sistema de arquivos local e a rede. No Flash Player 8, os arquivos SWF locais podem ter trs nveis 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 arquivo local e o Flash Player na pgina 709.

H tambm pequenas alteraes em System.security.allowDomain e aprimoramentos em System.security.allowInsecureDomain. Para obter mais informaes sobre segurana de arquivos locais, consulte o Captulo 17, Noes bsicas de segurana.


2

CAPTULO 2

Escrevendo e editando o ActionScript 2.0

Ao escrever o cdigo ActionScript no Macromedia Flash Basic 8 ou no Macromedia Flash Professional 8, use o painel Actions (Aes) ou a janela Script. O painel Actions e a janela Script contm um editor de cdigo completo (o editor do ActionScript) que inclui referncias de cdigo e sinalizao por cores, formatao de cdigo, realce de sintaxe, verificao de sintaxe, depurao, nmeros de linha, quebra automtica de linha e suporte a Unicode em duas 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 criar scripts que faam parte de seu documento do Flash (ou seja, scripts incorporados ao arquivo FLA) 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 painel Actions contm o editor do ActionScript em um painel Script e ferramentas de suporte para facilitar 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 navegador Script 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 obter mais informaes sobre o painel Actions, consulte Sobre o painel Actions na pgina 37. Para obter 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 para criar um novo arquivo do ActionScript. (Voc tambm pode usar o seu editor de texto favorito para criar um arquivo externo do AS.) Na janela Script, o editor do Action Script inclui recursos de assistncia a cdigo, como referncias de cdigo e sinalizao por cores, verificao de sintaxe etc., da mesma forma que no painel Actions. Para obter mais informaes sobre a janela Script, consulte Sobre a janela Script na pgina 38.

31

O Flash oferece assistncia adicional a scripts atravs de comportamentos. Os comportamentos so funes predefinidas do ActionScript que voc pode anexar a objetos no documento do Flash sem precisar criar o cdigo ActionScript. Para obter mais informaes sobre comportamentos, consulte Sobre comportamentos na pgina 65.

Para obter mais informaes sobre como manipular eventos, consulte as seguintes sees:Sobre o ActionScript e eventos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Organizando o cdigo ActionScript. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Usando o painel Actions e a janela Script. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Sobre o painel Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Sobre a janela Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Sobre a codificao no painel Actions e na janela Script . . . . . . . . . . . . . . . . . . . . . . 39

Sobre recursos do painel Actions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Sobre comportamentos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Sobre as configuraes de publicao do ActionScript . . . . . . . . . . . . . . . . . . . . . . . 66

Sobre 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. Os eventos podem ser ativados pelo usurio ou pelo sistema. Os usurios clicam em botes do mouse e pressionam teclas; o sistema ativa eventos quando condies especficas so atendidas ou quando processos so concludos (o arquivo SWF carregado, a timeline alcana um determinado quadro, um elemento grfico conclui o download etc.).

Quando ocorre um evento, voc cria um manipulador de eventos para responder ao evento com uma ao. Compreender quando e onde ocorrero os eventos o ajudar a determinar como e onde voc responder a eles com uma ao e quais ferramentas do ActionScript utilizar em cada caso. Para obter mais informaes, consulte Sobre a criao de scripts para manipular eventos na pgina 35.

Os eventos podem ser agrupados em vrias categorias: eventos de mouse e teclado, que ocorrem 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 em quadros na timeline.

Para obter informaes sobre os tipos de scripts que podem ser criados para manipular eventos, consulte Sobre a criao de scripts para manipular eventos na pgina 35.

32 Escrevendo e editando o ActionScript 2.0

Eventos de mouse e tecladoQuando o usurio interage com seu aplicativo ou arquivo SWF, ele ativa eventos de mouse e teclado. Por exemplo, quando ele rola sobre um boto, ocorre o evento Button.onRollOver ou on(rollOver); quando ele clica em um boto, o evento Button.onRelease ativado; se uma tecla do teclado for pressionada, o evento on(keyPress) ocorrer. Voc pode criar um cdigo em um quadro ou anexar scripts a uma instncia para manipular esses eventos e adicionar toda a interatividade desejada.

Eventos de clipeEm um clipe de filme, voc pode reagir a diversos eventos de clipe ativados quando o usurio entra ou sai da cena ou interagir com a cena usando o mouse ou o teclado. Por exemplo, voc pode carregar uma imagem externa SWF ou JPG no clipe de filme quando o usurio entrar na cena 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 a reproduo entra em um quadro-chave conhecido como evento de quadro. Os eventos de quadro so teis para ativar aes baseadas na passagem de tempo (que se movem pela timeline) ou para interagir com elementos visveis no momento no Stage. Quando voc adiciona um script a um quadro-chave, ele executado quando o quadro-chave alcanado durante 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 quando um determinado quadro-chave alcanado. Isso feito com a funo stop(). Selecione um quadro-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 uma ao. Voc pode, por exemplo, usar um script de quadro para atualizar dinamicamente o valor de um rtulo, gerenciar a interao dos elementos no Stage etc.

Sobre o ActionScript e eventos 33

Organizando o cdigo ActionScript possvel anexar scripts a quadros-chave e instncias de objeto (clipes de filme, botes e outros 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. Tambm ser difcil compartilhar o cdigo com diferentes aplicativos Flash. Portanto, importante que voc 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 mtodos consiste em anexar o ActionScript incorporado ao primeiro ou ao segundo quadro da timeline, sempre que possvel, para que voc no precise pesquisar o arquivo FLA a fim de localizar todo o cdigo. Uma prtica comum envolve a criao de uma camada denominada actions e a incluso do cdigo ActionScript nessa camada.

Ao anexar todos os scripts a elementos individuais, voc incorpora todo o cdigo ao arquivo FLA. Se o compartilhamento de seu cdigo com outros aplicativos do Flash for um requisito importante para voc, use a janela Script ou o seu editor de texto favorito para criar um arquivo 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 utilidade do que voc imagina. Um arquivo externo ajudar na depurao e tambm no gerenciamento do controle de origem caso voc esteja trabalhando em um projeto junto com outros desenvolvedores.

Para usar o cdigo ActionScript contido em um arquivo externo do AS, crie um script no arquivo FLA e use a instruo #include para acessar o cdigo armazenado externamente, como mostrado no exemplo a seguir:#include "../core/Functions.as"


Tambm possvel usar o ActionScript 2.0 para criar classes personalizadas. Armazene as classes personalizadas em arquivos externos do AS e use instrues import em um script para exportar as classes para o arquivo SWF, em vez de usar instrues #include. Para obter mais informaes sobre como criar arquivos de classe, consulte Criando arquivos de classes personalizados na pgina 249 e Sobre a importao de arquivos de classes na pgina 254 que tratam da importao desses arquivos. Voc tambm pode usar componentes (clipes de filme predefinidos) para compartilhar cdigo e funcionalidade, como scripts e elementos de UI.

Ao criar o ActionScript no Flash 8, use o painel Actions, a janela Script ou ambos. O uso do painel Actions ou da janela Script determinado pelo modo de resposta aos eventos, pelo modo de organizao do cdigo e, principalmente, pelas prticas recomendadas de codificao.

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 ser considerados quando voc usar comportamentos, que so funes predefinidas do ActionScript (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 que ocorrem 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 SWF pode ser distribuda pelos vrios elementos de seu projeto; voc tambm pode optar por adicionar scripts diretamente a esses elementos. Entretanto, a Macromedia recomenda a no adio direta de scripts a esses elementos (quadros-chave e objetos). Nesse caso, voc deve responder aos eventos chamando as funes residentes em um local central, conforme descrito em Organizando o cdigo ActionScript.

NO

TA

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.

Organizando o cdigo ActionScript 35

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 pode usar a janela Script (File [Arquivo] > New [Novo] e selecionar ActionScript File [Arquivo do ActionScript]) ou o seu editor de texto preferido.

A utilizao do painel Actions ou da janela Script equivale ao uso dos recursos do editor do ActionScript para criar, formatar e editar o cdigo. O painel Actions e a janela Script possuem o painel Script (onde o cdigo digitado) e a caixa de ferramentas Actions. O painel Actions oferece mais alguns recursos de assistncia a cdigo do que a janela Script. O Flash oferece esses recursos no painel Actions por eles serem especialmente teis no contexto de edio do ActionScript 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 38


Sobre o painel ActionsUse o painel Actions para criar o ActionScript em um documento do Flash (arquivo FLA). O painel consiste em trs painis, e cada um deles oferece suporte criao e ao gerenciamento de scripts.

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.

Navegador Script Script, painel Menu pop-upActions (Aes), caixa de ferramentas

Sobre o painel Actions 37

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 60

Sobre a janela ScriptVoc pode criar e editar o ActionScript na janela Script ao criar um novo arquivo do ActionScript, do Flash Communication ou do Flash JavaScript. Use a janela Script para criar e editar arquivos de script externos. A janela oferece suporte sinalizao da sintaxe por cores, a referncias de cdigo e a outras opes de editor.

Nessa janela, possvel criar um ActionScript externo, a comunicao do ActionScript e arquivos do Flash JavaScript. Dependendo do tipo de arquivo de script externo criado, a caixa de ferramentas Actions fornecer uma lista completa dos elementos de linguagem disponveis para 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 do Flash, e no de criao de um arquivo de script externo.


Voc tambm observar que vrias opes disponveis no painel Actions no esto disponveis na janela Script. A janela Script oferece suporte s seguintes opes de editor: caixa de ferramentas Actions, recursos localizar e substituir, verificao de sintaxe, formatao automtica, referncias de cdigo e opes de depurao (somente arquivos do ActionScript). Alm disso, ela oferece suporte exibio de nmeros de linha, caracteres ocultos e quebra automtica de linha.

Para exibir a janela Script:

1. Selecione File (Arquivo) > New (Novo).

2. Selecione o tipo de arquivo externo que deseja criar (arquivo do ActionScript, arquivo do Flash Communication ou arquivo do Flash JavaScript).

possvel abrir vrios arquivos externos ao mesmo tempo; os nomes dos arquivos so exibidos em guias na parte superior da janela Script. Para obter mais informaes sobre os recursos da janela Script, 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 60

Sobre a codificao no painel Actions e na janela ScriptO painel Script, local de edio do cdigo, o principal elemento do painel Actions e da janela Script. O painel Actions e a janela Script oferecem recursos bsicos de assistncia a cdigo e de edio de script, como referncias de cdigo, sinalizao por cores, formatao automtica etc.

Os recursos que ajudam na edio do cdigo podem ser acessados na barra de ferramentas do painel Actions ou da janela Script, atravs do sistema de menu e no prprio painel Script.

Sobre a codificao no painel Actions e na janela Script 39

Os tpicos a seguir apresentam os vrios recursos do editor do ActionScript (painel Actions e janela Script):

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 preferncias do ActionScript na pgina 44 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 60

Para obter os recursos especficos apenas do painel Actions, por exemplo, prender o script e navegador Script, consulte Sobre recursos do painel Actions na pgina 62.

Sobre as barras de ferramentas do painel Actions e da janela ScriptAs barras de ferramentas do painel Actions e da janela Script contm links para os recursos de assistncia a cdigo que ajudam a simplificar e agilizar a codificao no ActionScript. Elas sero diferentes caso voc utilize o editor do ActionScript no painel Actions ou no painel Script. A imagem a seguir exibe os recursos localizados na barra de ferramentas do painel Actions. As opes marcadas esto disponveis apenas no painel Actions.

Menu pop-up*

Debug Options (Opes de depurao)*

Referncia

Find (Localizar)

Add a new item to the script (Adicionar um novo item ao script)

Insert target path (Inserir caminho de destino)*

Check Syntax (Verificar sintaxe)

Auto Format (Formatao automtica)

Show Code Hint (Mostrar referncia de cdigo)

Script Assist *

* Somente no painel Actions


Os recursos localizados na barra de ferramentas sero discutidos em detalhes em Usando o painel Actions e a janela Script na pgina 36. Veja a seguir um breve resumo dos botes disponveis nas barras de ferramentas do painel Actions e da janela Script.

Add a new item to the script (Adicionar um novo item ao script) Exiba todos os elementos de linguagem tambm existentes na caixa de ferramentas do ActionScript. A seleo de um item na lista categorizada de elementos de linguagem adiciona-o ao script. Find (Localizar) Localize e substitua qualquer texto no cdigo ActionScript. Para obter mais informaes, consulte Usando a ferramenta Find na pgina 58. Insert target path (Inserir caminho de destino) Somente no painel Actions. Ajuda na configurao de um caminho de destino relativo ou absoluto de uma ao no script. Para obter mais informaes, consulte Inserindo caminhos de destino na pgina 65. Check Syntax (Verificar sintaxe) Verifique erros na sintaxe do script atual. Os erros de sintaxe so listados no painel Output (Sada). Para obter mais informaes, consulte Verificando sintaxe e pontuao na pgina 59.Auto Format (Formatao automtica) Formate seu script para uma sintaxe de codificao apropriada e para melhorar a legibilidade. Voc pode definir as preferncias de formatao automtica na caixa de dilogo Preferences (Preferncias), disponvel no menu Edit (Editar) ou no menu pop-up do painel Actions. Para obter mais informaes, consulte Formatando cdigo na pgina 53. Show Code Hint (Mostrar referncia de cdigo) Se tiver desativado a referncia de cdigo automtica, voc poder usar o comando Show Code Hint para exibir manualmente uma referncia de cdigo relativa linha de cdigo na qual estiver trabalhando. Para obter mais informaes, consulte Sobre o Script Assist na pgina 62. Debug Options (Opes de depurao) Defina e remova pontos de interrupo no script, para que, ao depurar seu documento do

Date post:	15-Dec-2018
Category:	Documents
Upload:	vuongnhi
View:	226 times
Download:	0 times

Aprendendo ActionScript 2.0 no Flash -...

Documents