Scripts schrijven en beheren

U kunt uw code automatisch opmaken en laten inspringen bij het typen. Als u dynamische lettertypetoewijzing gebruikt, weet u zeker dat de juiste lettertypen worden gebruikt voor meertalige teksten.

Opties voor Automatisch opmaken instellen

Code opmaken volgens de instellingen voor Automatisch opmaken

• Klik op de werkbalk van het deelvenster Handelingen of het Script-venster op Automatisch opmaken.
• Selecteer Automatisch opmaken in het optiemenu (in de rechterbovenhoek van het deelvenster Handelingen).
• Druk op Ctrl+Shift+F (Windows) of op Cmd+Shift+F (Macintosh).
• Selecteer Gereedschappen > Automatisch opmaken in het Script-venster.

Dynamische lettertypetoewijzing gebruiken

Automatisch inspringen gebruiken

Opmerkingen plaatsen bij codegebieden

Opmerkingen in de code zijn delen in de code die door de ActionScript-compiler worden genegeerd. In een opmerking kunt u uitleggen wat de code doet, of u kunt code die u niet wilt verwijderen tijdelijk uitschakelen. U start een opmerking voor een coderegel met een dubbele slash (//). De compiler negeert alle tekst na de dubbele slash. U kunt ook opmerkingen plaatsen voor grotere blokken code door een slash en een asterisk (/*) aan het begin van het blok en een asterisk en een slash (*/) aan het eind van het blok te typen.

U kunt deze markeringen handmatig typen, maar u kunt ook de knoppen bovenin het deelvenster Handelingen of het Script-venster gebruiken.

Een opmerking typen voor een coderegel

Er wordt een dubbele slash (//) op het invoegpunt geplaatst.

Een opmerking typen voor meerdere coderegels

De tekens voor de blokopmerking worden aan het begin (/*) en het eind (*/) van de selectie geplaatst.

Een opmerking verwijderen

Syntaxiskleuren gebruiken

Zoals in elke taal is in ActionScript syntaxis de manier waarop elementen worden geordend om betekenis te genereren. Wanneer u onjuiste ActionScript-syntaxis gebruikt, werken de scripts niet.

Als u syntaxisfouten wilt markeren, moet u een kleurcode instellen voor uw scripts. Stel dat u de syntaxiskleuren zodanig instelt dat gereserveerde woorden in blauw worden weergegeven. Als u var typt, wordt het woord var in blauw weergegeven. Als u echter per ongeluk vae typt, blijft het woord vae zwart, zodat u ziet dat u een typefout hebt gemaakt.

Ga als volgt te werk:

• Selecteer Bewerken > Voorkeuren (Windows) of Animate > Voorkeuren (Macintosh), klik op Code-editor in de categorielijst en geef de gewenste syntaxiskleuren op.

• Terwijl het invoegpunt in het Script-veld staat, drukt u op Ctrl-U (Windows) of op Cmd-U (Macintosh).

De lijsten met id's en trefwoorden gebruiken bij runtime

Bij het opstarten van Animate worden de lijsten met id's en trefwoorden gelezen vanaf het resourcebestand en in de cache opgeslagen. Behalve het lezen van de standaardlijsten vanaf de resource, wordt ook gescand op bijkomende lijsten met id's en trefwoorden in de map Voorkeuren. U kunt ook bijkomende trefwoorden en id's toevoegen door "TXT-bestanden" in de volgende mappen toe te voegen:

• C:\Users\<Gebruikersnaam>[AppData]\Roaming\Adobe\Animate\13.0[ActionscriptKeywords]\

• C:\Users\<Gebruikersnaam>[AppData]\Roaming\Adobe\Animate\13.0[ActionscriptIdentifiers]\

• C:\Users\<Gebruikersnaam>[AppData]\Roaming\Adobe\Animate\13.0[JavascriptKeywords]\

• C:\Users\<Gebruikersnaam>[AppData]\Roaming\Adobe\Animate\13.0[JavascriptIdentifiers]\

Regelnummers en tekstomloop gebruiken

Als u code gaat bewerken of aanpassen, maakt het gebruik van regelnummers de code overzichtelijker. Tekstomloop zorgt ervoor dat u niet horizontaal door lange regels code hoeft te schuiven (dat is met name belangrijk als u in de ontwerpomgeving of met een lage beeldschermresolutie werkt).

Regelnummers in- of uitschakelen

• Selecteer Weergave > Regelnummers in het Script-venster.
• Druk op Ctrl+Shift+L (Windows) of op Cmd+Shift+L (Macintosh).

Een specifieke regel markeren

• Selecteer Bewerken > Ga naar regel in het Script-venster.

Tekstomloop in- of uitschakelen

• Selecteer Weergave > Tekstomloop in het Script-venster.
• Druk op Ctrl+Shift+W (Windows) of op Cmd+Shift+W (Macintosh).

Verborgen tekens weergeven

Tekens zoals spaties, tabs en regeleinden worden in de ActionScript-code verborgen. Soms moet u deze tekens weergeven, bijvoorbeeld als u double-bytespaties wilt zoeken en verwijderen die geen deel uitmaken van een tekenreekswaarde, omdat die compilerfouten veroorzaken.

• Druk op Ctrl+Shift+8 (Windows) of op Cmd+Shift+8 (Macintosh).

De volgende symbolen worden gebruikt voor het weergeven van verborgen tekens:

Tekst in een script zoeken

Met het gereedschap Zoeken kunt u tekst in uw scripts zoeken en vervangen.

Tekst zoeken

Tekst in een script zoeken en vervangen

(Verouderd in Animate) Een zoekopdracht herhalen in het deelvenster Handelingen

(Verouderd in Animate) Een zoekopdracht herhalen in het deelvenster Script

(Verouderd in Animate) Syntaxis en leestekens controleren

U kunt de ActionScript-code snel controleren zonder dat u het FLA-bestand publiceert.

Wanneer u de syntaxis controleert, wordt het huidige script gecontroleerd. Als het huidige script ActionScript-klassen aanroept, worden deze klassen eveneens gecontroleerd. Eventuele andere scripts in het FLA-bestand worden niet gecontroleerd.

Bij de syntaxiscontrole van ActionScript 2.0-bestanden wordt de code uitgevoerd via de compiler om syntaxis- en compilerfouten te genereren.

Bij de syntaxiscontrole van ActionScript 3.0-bestanden worden alleen syntaxisfouten gegenereerd. Als u compilatiefouten wilt genereren zoals niet-overeenkomend typen, onjuiste retourwaarden en verkeerd gespelde variabele- of methodenamen, moet u de opdracht Besturing > Testen gebruiken.

Syntaxis controleren

Voer een van de volgende handelingen uit om de syntaxis te controleren:

• Klik in het deelvenster Handelingen of het Script-venster op Syntaxis controleren .
• Klik in het Script-veld en druk vervolgens op Ctrl + T (Windows) of Cmd + T (Macintosh). Het Script-veld krijgt de focus als u hierin klikt of typt. Als een object in het werkgebied de focus heeft, wordt het deelvenster Transformeren geopend.

Syntaxisfouten worden in het deelvenster Compilerfouten weergegeven.

Evenwicht van leestekens controleren

(Verouderd in Animate) Scripts importeren en exporteren

U kunt een script in het deelvenster Handelingen of het Script-venster importeren. U kunt uw scripts ook uit het deelvenster Handelingen naar externe ActionScript-bestanden exporteren. (Wanneer u het Script-venster gebruikt, is exporteren niet nodig omdat u het AS-bestand kunt opslaan.)

Als de tekst in uw scripts er anders uitziet dan u had verwacht wanneer u een bestand opent of importeert, wijzigt u de voorkeur voor importcodering.

Een extern AS-bestand importeren

Een script exporteren vanuit het deelvenster Handelingen

Tekstcoderingsopties instellen

De waarschuwing voor exportcodering in- of uitschakelen

(Verouderd in Animate) Codering voor geïmporteerde en geëxporteerde scripts

U kunt in ActionScript het type codering opgeven dat u wilt gebruiken voor geïmporteerde of geëxporteerde ActionScript-bestanden. UTF-8-codering is een 8-bits Unicode-indeling waarmee u tekst in meerdere talen in uw bestanden kunt opnemen. Standaardcodering is de codering die wordt ondersteund door de taal die uw systeem momenteel gebruikt. Deze codering wordt ook wel de traditionele codepagina genoemd.

Scripts vastzetten in het deelvenster Handelingen

Gebruik de functie Script vastzetten om tabbladen met afzonderlijke scripts vast te zetten in het deelvenster Script en ze dienovereenkomstig te verplaatsen. Deze functie is handig als u de code in een FLA-bestand niet op één centrale locatie hebt geordend, of als u meerdere scripts gebruikt.

U kunt een script vastzetten om de geopende locatie van de code in het deelvenster Handelingen te behouden en om te schakelen tussen de verschillende geopende scripts. Dat is vooral handig bij het opsporen van fouten. 

U kunt ook een of meerdere scripts losmaken als u een geselecteerd script (of alle scripts) wilt losmaken van het deelvenster Handelingen.

In de volgende afbeelding bevindt het script dat aan de huidige locatie op de tijdlijn is gekoppeld zich op frame1 van de laag met de naam Verwijderen. (De tab uiterst links volgt altijd de locatie op de tijdlijn.) Het script wordt ook vastgezet zoals getoond in het meest rechtse tabblad. De volgende twee scripts zijn vastgezet:

• In frame 1 
• In frame 15 van de laag met de naam Intro

Gebruik sneltoetsen of klik op de tabbladen om tussen de vastgezette scripts te schakelen. Wanneer u van het ene vastgezette script naar het andere gaat, wordt uw huidige positie op de tijdlijn niet gewijzigd. Als u een nieuw script selecteert in de scriptnavigator, verplaatst de focus zich naar het eerste frame, dat wil zeggen: Frame 1.

Een script vastzetten

Alle scripts vrijmaken

sneltoetsen voor vastgezette scripts

Als het invoegpunt in het Script-veld staat, kunt u de volgende sneltoetsen gebruiken om met vastgezette scripts te werken.

Doelpaden invoegen

Veel scripthandelingen zijn gericht op het beïnvloeden van filmclips, knoppen en andere symboolinstanties. In uw code kunt u naar symboolinstanties op een tijdlijn verwijzen door een doelpad in te voegen. Een doelpad is het adres van de instantie die u als doel wilt gebruiken. U kunt een absoluut of een relatief doelpad instellen. Een absoluut pad bevat het volledige adres van de instantie. Een relatief pad bevat slechts het deel van het adres dat afwijkt van het adres van het script in het FLA-bestand. Een relatief pad werkt dan ook niet als u het script naar een andere locatie verplaatst.

Codehints gebruiken

Wanneer u in het deelvenster Handelingen of in het Script-venster werkt, kan de software detecteren welke handeling u invoert en op basis daarvan een codehint weergeven. Er bestaan twee soorten codehints: knopinfo met de complete syntaxis voor de handeling en een pop-upmenu waarin mogelijke ActionScript-elementen worden weergegeven, zoals namen van methoden of eigenschappen (soms wordt dit een vorm van codevoltooiing genoemd).

Codehints zijn standaard ingeschakeld. Door voorkeuren in te stellen, kunt u codehints uitschakelen of bepalen hoe snel ze moeten worden weergegeven. Wanneer u codehints bij de voorkeuren hebt uitgeschakeld, kunt u toch handmatig een codehint weergeven voor een specifieke opdracht.

Codehints inschakelen

U kunt codehints op verschillende manieren activeren.

Strikte invoer voor objecten

Als u ActionScript 2.0 in combinatie met strikte invoer gebruikt voor een variabele die is gebaseerd op een ingebouwde klasse (zoals Button, Array, enzovoort), worden in het Script-veld codehints voor de variabele weergegeven. Stel dat u de volgende twee coderegels invoert:

Zodra u de punt (.) typt, toont Animate een lijst met methoden en eigenschappen die beschikbaar zijn voor Array-objecten in een pop-upmenu, omdat u de variabele als een array hebt getypt.

Achtervoegsels en codehints

Als u ActionScript 1.0 gebruikt of als u codehints wilt weergeven voor objecten zonder deze strikt in te voeren, moet u een achtervoegsel aan de naam van elk object toevoegen op het moment dat u het object maakt. Het achtervoegsel dat codehints activeert voor de klasse Camera is bijvoorbeeld _cam. Stel dat u de volgende code typt: var my_array = new Array(); var my_cam = Camera.get();

Als u vervolgens my_cam typt gevolgd door een punt, worden codehints voor het object Camera weergegeven.

Gebruik voor de objecten die in het werkgebied worden weergegeven het achtervoegsel in het vak Instantienaam in Eigenschapcontrole. Als u bijvoorbeeld codehints wilt weergeven voor objecten MovieClip, gebruikt u Eigenschapcontrole om aan alle objecten MovieClip instantienamen toe te wijzen met het achtervoegsel _mc. Wanneer u vervolgens de instantienaam typt, gevolgd door een punt, worden codehints weergegeven.

In de volgende tabel worden de achtervoegsels weergegeven die codehints activeren in ActionScript 2.0:

Opmerkingen en codehints

U kunt ook ActionScript-opmerkingen gebruiken om de klasse van een object op te geven voor codehints. In het volgende voorbeeld wordt via een opmerking aangegeven dat de klasse van de instantie theObject Object is, enzovoort.

Als u vervolgens theMC invoert gevolgd door een punt, worden codehints weergegeven met de lijst met MovieClip-methoden en -eigenschappen. Als u vervolgens theArray invoert gevolgd door een punt, worden codehints weergegeven met de lijst met Array-methoden en -eigenschappen, enzovoort.

Adobe raadt echter aan in plaats van deze techniek strikte gegevensinvoer of achtervoegsels te gebruiken, omdat deze technieken codehints automatisch activeren waardoor uw code begrijpelijker wordt.

Voorkeurinstellingen opgeven voor automatische codehints

• Selecteer Bewerken > Voorkeuren (Windows) of Animate > Voorkeuren (Macintosh) in het deelvenster Handelingen of in het Script-venster, klik in de categorielijst op Code-editor en schakel vervolgens Codehints in of uit.

(Verouderd in Animate) Een vertraging voor codehints opgeven

Codehints in knopinfostijl gebruiken

Codehints in menustijl gebruiken

Een codehint handmatig weergeven

Codehints voor aangepaste klassen

Als u aangepaste ActionScript 3.0-klassen maakt, parseert Animate de klassen en wordt er eveneens bepaald welke objecten, eigenschappen en methoden in de klassen worden opgenomen. Animate kan vervolgens codehints bieden wanneer u code schrijft die naar de aangepaste klassen verwijst. Voltooiing van aangepaste klassencode wordt automatisch uitgevoerd voor alle klassen die u aan andere code hebt gekoppeld met de opdracht import.

Met codehints kunnen ontwikkelaars sneller werken omdat ze niet hoeven te onthouden welke objecten, methoden en eigenschappen er allemaal door de klasse worden gebruikt. Ook kunnen ontwerpers hierdoor werken met klassen die ze niet zelf hebben geschreven, omdat ze niet precies hoeven te weten hoe de klasse in elkaar zit.

Codehints kunnen onder meer voor de volgende items worden gegeven:

• Codehints voor geneste klasseverwijzingen

  Bij het schrijven van geneste verwijzingen is het handig als u voortdurend codehints krijgt.

• Codehints voor "this"

  Als u "this" in een klassenbestand typt, krijgt u codehints voor de desbetreffende klasse.

• Codehints voor "new+<spatie>"

  Als u "new+<spatie>" typt, geeft Animate een lijst met beschikbare klassen en pakketten weer.

• Codehints voor "import"

  Als u "import+<spatie>" typt, geeft Animate een lijst met alle ingebouwde en aangepaste pakketten weer.

• Codehints voor SWC-bibliotheken

  Als u een SWC-bibliotheek toevoegt aan het bibliotheekpad of het externe bibliotheekpad, schakelt Animate codehints in voor alle klassen die in het SWC-bestand zijn opgenomen.