ActionScript-voorbeelden gebruiken

Codefragmentvoorbeelden

Een codefragmentvoorbeeld ziet er als volgt uit:

var x:int = 5; 
trace(x); // 5

Codefragmenten bevatten code om één enkel idee te demonstreren. De fragmenten bevatten gewoonlijk geen pakket- of klasseninstructies.

Voorbeelden die zijn gebaseerd op een klasse

Veel voorbeelden tonen de broncode van een complete ActionScript-klasse. Een op een klasse gebaseerd voorbeeld ziet er als volgt uit:

package { 
    public class Example1 { 
        public function Example1():void { 
            var x:int = 5; 
            trace(x); //5 
        } 
    } 
}

De code voor een op een klasse gebaseerd voorbeeld bevat een pakketinstructie, een klassendeclaratie en een constructorfunctie.

Praktische voorbeelden met meerdere bronbestanden

Veel van de onderwerpen in de ActionScript 3.0-ontwikkelaarsgids bevatten realistische voorbeelden die laten zien hoe bepaalde ActionScript-functies in een praktische context kunnen worden gebruikt. Deze voorbeelden bevatten gewoonlijk meerdere bestanden, waaronder:

Praktische voorbeelden worden gewoonlijk als ZIP-archiefbestanden geleverd.

Lijst met voorbeelden uit de gids voor ontwikkelaars in het ZIP-bestand

Het ZIP-bestand voor Flash Professional CS5 en Flex 4 (te downloaden van www.adobe.com/go/learn_programmingAS3samples_flash_nl ) bevat de volgende voorbeelden:

• AlarmClock ( Voorbeeld van gebeurtenisafhandeling: alarmklok

• AlgorithmicVisualGenerator ( Voorbeeld van de API voor tekenen: Algorithmic Visual Generator )

• ASCIIArt ( Voorbeeld van strings: ASCII-afbeeldingen )

• CapabilitiesExplorer ( Voorbeeld van mogelijkheden: systeemmogelijkheden bepalen )

• CustomErrors ( Voorbeeld van foutafhandeling: CustomErrors-toepassing )

• DisplayObjectTransformer ( Voorbeeld van geometrie: een matrixtransformatie toepassen op een weergaveobject )

• FilterWorkbench ( Voorbeeld van het filteren van weergaveobjecten: Filter Workbench )

• GlobalStockTicker ( Voorbeeld: een toepassing voor het volgen van aandelenkoersen internationaliseren )

• IntrovertIM_HTML ( Voorbeeld van externe API: communicatie tussen ActionScript en JavaScript in een webbrowser )

• NewsLayout ( TekstField-voorbeeld: tekstopmaak in krantenstijl )

• PlayList ( Voorbeeld van arrays: PlayList )

• PodcastPlayer ( Voorbeeld van geluid: Podcast-speler )

• ProjectionDragger ( Voorbeeld: Perspectiefprojectie )

• ReorderByZ ( Matrix3D-objecten gebruiken om de weergavevolgorde te wijzigen )

• RSSViewer ( Voorbeeld van XML in ActionScript: RSS-gegevens van internet laden )

• RuntimeAssetsExplorer ( Voorbeeld van een filmclip: RuntimeAssetsExplorer )

• SimpleClock ( Voorbeeld van datum en tijd: eenvoudige analoge klok )

• SpinningMoon ( Bitmapvoorbeeld: geanimeerde draaiende maan )

• SpriteArranger ( Voorbeeld van weergaveobjecten: SpriteArranger )

• TelnetSocket ( Voorbeeld van TCP-socket: een Telnet-client maken )

• VideoJukebox ( Voorbeeld van video: videojukebox )

• WikiEditor ( Voorbeeld van een reguliere expressie: een Wiki-parser )

• WordSearch ( Voorbeeld van muisinvoer: WordSearch )

Praktische voorbeelden worden eveneens gebruikt in veel van de artikelen in het Flash Developer Center en het Flex Developer Center.

Een codefragmentvoorbeeld uitvoeren in Flash Professional

Een codefragmentvoorbeeld uitvoeren in Flash Professional:

1. Selecteer Bestand > Nieuw.

2. Selecteer Flash-document in het dialoogvenster Nieuw document en klik op OK.

   Er wordt een nieuw Flash-venster weergegeven.

3. Klik in het deelvenster Tijdlijn op het eerste frame van de eerste laag.

4. Typ of plak in het deelvenster Handelingen het codefragmentvoorbeeld.

5. Selecteer Bestand > Opslaan. Geef het bestand een naam en klik op OK.

6. Als u het voorbeeld wilt testen, selecteert u Besturing > Film testen.

Een op een klasse gebaseerd voorbeeld uitvoeren in Flash Professional

Een op een klasse gebaseerd voorbeeld uitvoeren in Flash Professional:

Een praktisch voorbeeld uitvoeren in Flash Professional

Praktische voorbeelden worden gewoonlijk als ZIP-archiefbestanden geleverd. Een praktisch voorbeeld uitvoeren in Flash Professional:

1. Pak het archiefbestand uit in een map naar keuze.

2. Selecteer in Flash Professional achtereenvolgens Bestand > Openen.

3. Blader naar de map waar u het archiefbestand hebt uitgepakt. Selecteer het FLA-bestand in deze map en klik op Openen.

4. Als u het voorbeeld wilt testen, selecteert u Besturing > Film testen.

Een codefragmentvoorbeeld uitvoeren in Flash Builder

Een codefragmentvoorbeeld uitvoeren in Flash Builder:

Een op een klasse gebaseerd voorbeeld uitvoeren in Flash Builder

Een op een klasse gebaseerd voorbeeld uitvoeren in Flash Builder:

1. Selecteer Bestand > Nieuw > ActionScript-project.

2. Geef in het veld Projectnaam de naam van de primaire klasse op (bijvoorbeeld ContextMenuExample). Gebruik de standaardwaarden voor de overige velden (of wijzig de waarden overeenkomstig uw specifieke omgeving). Klik op Voltooien om het project en het primaire ActionScript-bestand te maken.

3. Wis eventuele gegenereerde inhoud uit het ActionScript-bestand. Plak de voorbeeldcode, waaronder pakket- en importinstructies, in het ActionScript-bestand en sla het bestand op.

   Opmerking: Sommige van de op klassen gebaseerde voorbeelden, zoals het flashx.textLayout.container.ContainerController-klassenvoorbeeld , bevatten meerdere niveaus in de pakketdeclaratie ( package flashx.textLayout.container.examples { ). Sla voor deze voorbeelden het bestand op in een submap die overeenkomt met de pakketdeclaratie (flashx/textLayout/container/examples) of verwijder de pakketnaam (zodat ActionScript alleen begint met package { ). Op deze manier kunt u het bestand vanaf een willekeurige locatie testen.

4. Als u het voorbeeld wilt uitvoeren, selecteert u Uitvoeren en vervolgens de menu-uitvoeringsoptie voor de primaire ActionScript-klassennaam (zoals Uitvoeren > ContextMenuExample uitvoeren).

Een praktisch voorbeeld uitvoeren in Flash Builder

Praktische voorbeelden worden gewoonlijk als ZIP-archiefbestanden geleverd. Een praktisch voorbeeld uitvoeren in Flash Builder:

Grootte van het werkgebied

Als u een voorbeeld uitvoert op een mobiel apparaat is het werkgebied veel kleiner dan bij een niet-mobiel apparaat. Bij veel voorbeelden hoeft het werkgebied niet een bepaalde grootte te hebben. Geef bij het maken van het SWF-bestand een werkgebiedgrootte op die geschikt is voor uw apparaat. Geef bijvoorbeeld 176 x 208 pixels op.

Het doel van de praktische voorbeelden in de ActionScript 3.0-ontwikkelaarsgids is de verschillende ActionScript 3.0-concepten en -klassen te illustreren. De gebruikersinterfaces hiervan zijn dusdanig ontworpen dat ze er mooi uit zien en goed werken op een desktop- of een laptopcomputer. Hoewel de voorbeelden werken op mobiele apparaten, zijn het werkgebied en het ontwerp van de interface niet geschikt voor een klein scherm. Adobe raadt u aan de praktische voorbeelden op een computer uit te voeren om zo meer te leren over ActionScript. Vervolgens kunt u de relevante codefragmenten in uw mobiele toepassingen uitvoeren.

Tekstvelden in plaats van trace-instructies

Wanneer u een voorbeeld uitvoert op een mobiel apparaat, kunt u de uitvoer van de trace-instructies van het voorbeeld niet zien. Als u de uitvoer wilt zien, maakt u een instantie van de klasse TextField. Voeg vervolgens de tekst van de trace-instructies toe aan de eigenschap text van het tekstveld.

U kunt de volgende functie gebruiken om een tekstveld voor tracering in te stellen:

function createTracingTextField(x:Number, y:Number, 
                                width:Number, height:Number):TextField { 
           
    var tracingTF:TextField = new TextField(); 
    tracingTF.x = x; 
    tracingTF.y = y; 
    tracingTF.width = width; 
    tracingTF.height = height; 
     
    // A border lets you more easily see the area the text field covers. 
    tracingTF.border = true; 
    // Left justifying means that the right side of the text field is automatically 
    // resized if a line of text is wider than the width of the text field. 
    // The bottom is also automatically resized if the number of lines of text 
    // exceed the length of the text field. 
    tracingTF.autoSize = TextFieldAutoSize.LEFT; 
     
    // Use a text size that works well on the device. 
    var myFormat:TextFormat = new TextFormat(); 
    myFormat.size = 18; 
    tracingTF.defaultTextFormat = myFormat; 
     
    addChild(tracingTF); 
    return tracingTF; 
}

Voeg deze functie bijvoorbeeld toe aan de documentklasse als een functie van het type private. Traceer vervolgens in andere methoden van de documentklasse gegevens met soortgelijke code zoals hier staat weergegeven:

var traceField:TextField = createTracingTextField(10, 10, 150, 150); 
// Use the newline character "\n" to force the text to the next line. 
traceField.appendText("data to trace\n"); 
traceField.appendText("more data to trace\n"); 
// Use the following line to clear the text field. 
traceField.appendText("");

De methode appendText() accepteert slechts één waarde als parameter. Deze waarde moet een tekenreeks zijn (een String-instantie of een letterlijke tekenreeks). Wanneer u de waarde wilt afdrukken van een variabele die geen tekenreeks is, moet u de waarde eerst omzetten in een tekenreeks. De eenvoudigste manier om dit te bereiken is het aanroepen van de methode toString() van het object:

var albumYear:int = 1999; 
traceField.appendText("albumYear = "); 
traceField.appendText(albumYear.toString());

Tekengrootte

In veel voorbeelden worden tekstvelden gebruikt om te helpen bij het illustreren van een concept. In sommige gevallen wordt de leesbaarheid op een mobiel apparaat verbeterd als de tekengrootte in het tekstveld wordt aangepast. Als in een voorbeeld een tekstveldinstantie genaamd myTextField wordt gebruikt, kan de tekengrootte hiervan aan de hand van de volgende code worden aangepast:

// Use a text size that works well on the device. 
var myFormat:TextFormat = new TextFormat(); 
myFormat.size = 18; 
myTextField.defaultTextFormat = myFormat

Gebruikersinvoer vastleggen

Het mobiele besturingssysteem en de mobiele browser leggen een aantal gebeurtenissen aangaande gebruikersinvoer vast, die niet worden ontvangen door de SWF-inhoud. Specifiek gedrag is afhankelijk van het besturingssysteem en de browser, maar kan resulteren in onverwacht gedrag wanneer u de voorbeelden op een mobiel apparaat uitvoert. Zie Hogere prioriteit KeyboardEvent voor meer informatie.

Ook zijn de gebruikersinterfaces van veel voorbeelden ontworpen voor een desktop- of een laptopcomputer. Zo zijn de meeste praktische voorbeelden in de ActionScript 3.0-ontwikkelaarsgids bij uitstek geschikt voor weergave op een desktopcomputer. Daarom wordt niet altijd het hele werkgebied weergegeven op het scherm van het mobiele apparaat. De mogelijkheid om door de inhoud van de browser te pannen is afhankelijk van de browser. Bovendien zijn de voorbeelden niet ontworpen voor het afvangen en afhandelen van schuif- of bladergebeurtenissen. Daarom zijn de gebruikersinterfaces van sommige voorbeelden niet geschikt om op een klein scherm te worden uitgevoerd. Adobe raadt u aan de voorbeelden op een computer uit te voeren om zo meer te leren over ActionScript. Vervolgens kunt u de relevante codefragmenten in uw mobiele toepassingen uitvoeren.

Zie Weergaveobjecten pannen en schuiven voor meer informatie.

Afhandeling van focus

Bij sommige voorbeelden moet u zorgen dat een veld de focus krijgt. Als een veld de focus heeft, kunt u bijvoorbeeld tekst invoeren of een knop selecteren. Gebruik het aanwijsapparaat van het mobiele apparaat, bijvoorbeeld de stylus, of uw vinger om een veld de focus te geven. U kunt hiervoor ook de navigatietoetsen van het mobiele apparaat gebruiken. Gebruik de selectietoets van het mobiele apparaat, net zoals u Enter op een computer gebruikt, voor het selecteren van een knop die de focus heeft. Op sommige apparaten kunt u een knop selecteren door er tweemaal op te tikken.

Zie Focus beheren voor meer informatie.

Afhandeling van muisgebeurtenissen

Veel voorbeelden luisteren of er muisgebeurtenissen plaatsvinden. Op een computer doen muisgebeurtenissen zich bijvoorbeeld voor als een gebruiker met de muisaanwijzer over een weergaveobject gaat of met de muisknop op een weergaveobject klikt. Op mobiele apparaten worden gebeurtenissen die het resultaat zijn van het gebruik van een aanwijsapparaat, zoals een stylus, of het gebruik van een vinger, aanraakgebeurtenissen genoemd. In Flash Player 10.1 worden aanraakgebeurtenissen aan muisgebeurtenissen toegewezen. Deze toewijzing zorgt ervoor dat SWF-inhoud die is ontwikkeld voor een oudere versie van Flash Player 10.1, blijft werken. Voorbeelden werken derhalve wanneer een aanwijsapparaat wordt gebruikt bij het selecteren of slepen van een weergaveobject.

Prestaties

Mobiele apparaten zijn minder krachtig dan desktopapparaten. Sommige voorbeelden die de CPU zwaar belasten, werken mogelijk langzaam op een mobiel apparaat. Zo maakt het voorbeeld in Voorbeeld van de API voor tekenen: Algorithmic Visual Generator bij het invoeren van elk frame uitgebreide berekeningen en tekenbewerkingen. Als u dit voorbeeld op een computer uitvoert, worden er verschillende API's voor tekenen gedemonstreerd. Dit voorbeeld is echter niet geschikt voor sommige mobiele apparaten vanwege de prestatiebeperkingen van deze apparaten.

Op De prestaties voor het Flash-platform optimaliseren vindt u meer informatie over de prestaties op mobiele apparatuur.

Tips en trucs

Bij de voorbeelden is geen rekening gehouden met de speciale die het ontwikkelen van toepassingen voor mobiele apparaten met zich meebrengt. Deze speciale vereisten zijn het gevolg van de beperkingen van het geheugen en het vermogen van de CPU van mobiele apparaten. Daar komt nog bij dat een gebruikersinterface voor een klein scherm aan andere eisen moet voldoen dan een gebruikersinterface voor een desktopcomputer. Op http://www.adobe.com/go/learn_optimizing_fp_nl vindt u meer informatie over het ontwikkelen van toepassingen voor mobiele apparatuur.