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