Pakket flash.utils 

Hiermee wordt een opgegeven aanroep van setInterval() geannuleerd.

Parameters

Verwante API-elementen

package {
    import flash.display.Sprite;
    import flash.utils.*;

    public class ClearIntervalExample extends Sprite {
        private var intervalDuration:Number = 1000; // duration between intervals, in milliseconds
        private var intervalId:uint;
        private var counter:uint     = 0;
        private var stopCount:uint     = 3;
        
        public function ClearIntervalExample() {
            intervalId = setInterval(myRepeatingFunction, intervalDuration, "Hello", "World");
        }

        public function myRepeatingFunction():void {
            trace(arguments[0] + " " + arguments[1]);

            counter++;
            if(counter == stopCount) {
                trace("Clearing Interval");
                clearInterval(intervalId);    
            }
        }
    }
}

Hiermee wordt een opgegeven aanroep van setTimeout() geannuleerd.

Parameters

Verwante API-elementen

package {
    import flash.display.Sprite;
    import flash.utils.*;

    public class ClearTimeoutExample extends Sprite {
        private var delay:Number = 1000; // delay before calling myDelayedFunction
        private var intervalId:uint;
        private var count:uint = 1000000;
        
        public function ClearTimeoutExample() {
            intervalId = setTimeout(myDelayedFunction, delay);
            startCounting();
        }

        public function startCounting():void {
            var i:uint = 0;
            do {
                if(i == count-1) {
                    clearTimeout(intervalId);
                    trace("Your computer can count to " + count + " in less than " + delay/1000 + " seconds.");    
                }
                i++;
            } while(i < count)            
        }
        
        public function myDelayedFunction():void {
            trace("Time expired.");
        }
    }
}

Hiermee wordt een XML-object gemaakt dat het ActionScript-object beschrijft dat als parameter van de methode is benoemd. Deze methode implementeert het programmeerconcept van reflectie voor de ActionScript-taal.

Wanneer de parameter value een instantie van een type is, bevat het geretourneerde XML-object alle instantie-eigenschappen van dat type, maar geen statische eigenschappen. U kunt dit controleren wanneer u een XML-object parseert door de waarde te bestuderen van het kenmerk isStatic van de tag <type>. Deze is false als de parameter value een instantie van een type is.

Geef het type zelf door voor de parameter value om de statische eigenschappen van een type te verkrijgen. Het geretourneerde XML-object bevat niet alleen de statische eigenschap van het type, maar ook alle instantie-eigenschappen ervan. De instantie-eigenschappen zijn genest in een tag met de naam <factory> om ze van de statische eigenschappen te onderscheiden. In dit geval is het kenmerk isStatic van de tag <type> true.

Opmerking: wanneer u alleen maar een overervingshiërarchie van een object moet doorlopen, en de andere informatie die door describeType() is opgegeven niet nodig hebt, gebruikt u in plaats daarvan de functies getQualifiedClassName() en getQualifiedSuperclassName().

In de volgende tabel wordt een aantal tags en kenmerken beschreven van het XML-object dat is gegenereerd door describeType() (alle klasse- en interfacenamen worden in volledig gekwalificeerde indeling geretourneerd):

Parameters

Verwante API-elementen

package {
    import flash.display.Sprite;
    import flash.utils.describeType;
    
    public class DescribeTypeExample extends Sprite {
        public function DescribeTypeExample() {
            var child:Sprite = new Sprite();
            var description:XML = describeType(child);
            trace(description..accessor.@name.toXMLString());
        }
    }
}

Retourneert een beschermde kopie van de ingevoerde tekenreeks die als UTF-8 of systeemcodepagina is gecodeerd, afhankelijk van de waarde van System.useCodePage. Wanneer u System.useCodePage gebruikt, kan oudere inhoud die is gecodeerd in lokale codepagina's worden benaderd door het runtimeprogramma, maar alleen op systemen met de oudere codepagina. Japanse gegevens die zijn gecodeerd als Shift-JIS worden bijvoorbeeld alleen correct beschermd en onbeschermd weergegeven op een besturingssysteem dat een standaardcodepagina voor Japans gebruikt.

Parameters

Retourneert een verwijzing naar het klasseobject dat door de parameter name wordt opgegeven.

Parameters

package {
    import flash.display.DisplayObject;
    import flash.display.Sprite;
    import flash.utils.getDefinitionByName;

    public class GetDefinitionByNameExample extends Sprite {
        private var bgColor:uint = 0xFFCC00;
        private var size:uint = 80;

        public function GetDefinitionByNameExample() {
            var ClassReference:Class = getDefinitionByName("flash.display.Sprite") as Class;
            var instance:Object = new ClassReference();
            instance.graphics.beginFill(bgColor);
            instance.graphics.drawRect(0, 0, size, size);
            instance.graphics.endFill();
            addChild(DisplayObject(instance));
        }
    }
}

Retourneert de volledig gekwalificeerde klassenaam van een object.

Parameters

Verwante API-elementen

Hiermee wordt de volledig gekwalificeerde klassenaam van de basisklasse van het object geretourneerd dat door de parameter value wordt opgegeven. Deze functie verschaft een snellere manier van basisklassenamen ophalen dan describeType(), maar geeft ook niet alle informatie die describeType() geeft.

Nadat u de klassenaam hebt opgehaald met deze functie, kunt u de klassenaam omzetten in een klassereferentie met de functie getDefinitionByName().

Opmerking: deze functie beperkt zichzelf tot instantiehiërarchieën, terwijl de functie describeType() klasseobjecthiërarchieën gebruikt als de parameter value een gegevenstype is. Het aanroepen van describeType() op een gegevenstype retourneert de superklasse op basis van de klasseobjecthiërarchie, waarin alle klasseobjecten overnemen van Class. De functie getQualifiedSuperclassName() daarentegen negeert de klasseobjecthiërarchie en retourneert de superklasse op basis van de bekendere instantiehiërarchie. Het aanroepen van getQualifiedSuperclassName(String) retourneert bijvoorbeeld Object, hoewel technisch gezien het klasseobject String overerft van Class. Met andere woorden, de resultaten zijn hetzelfde, of u nu een instantie van een type gebruikt of het type zelf.

Parameters

Verwante API-elementen

Wordt gebruikt om relatieve tijd te berekenen. Als een Flash-runtime bezig is met het verwerken van ActionScript 3.0, retourneert deze methode het aantal milliseconden dat is verstreken sinds de virtuele machine voor ActionScript 3.0 (AVM2) is gestart door de Flash-runtime. Als een Flash-runtime bezig is met het verwerken van ActionScript 2.0, retourneert deze methode het aantal milliseconden dat is verstreken sinds de initialisatie van de Flash-runtime. Een Flash-runtime gebruikt twee virtuele machines voor de verwerking van ActionScript. AVM1 is de ActionScript-VM waarmee ActionScript 1.0 en 2.0 wordt uitgevoerd. AVM2 is de ActionScript-VM waarmee ActionScript 3.0 wordt uitgevoerd. Het gedrag van de getTimer()-methode is anders voor AVM1 dan voor AVM2.

Zie het object Date voor een kalenderdatum (timestamp).

Verwante API-elementen

package {
    import flash.utils.getTimer;
    import flash.display.Sprite;

    public class GetTimerExample extends Sprite {
        public function GetTimerExample() {
            var duration:uint = getTimer();
            trace("duration: " + duration);
        }
    }
}

Hiermee wordt een functie volgens een opgegeven interval (in milliseconden) uitgevoerd.

In plaats van de methode setInterval() te gebruiken, kunt u ook een object Timer maken met het opgegeven interval, met 0 als de parameter repeatCount (die de timer oneindig laat herhalen).

Wanneer u de methode clearInterval() wilt gebruiken om de aanroep setInterval() te annuleren, moet u de aanroep setInterval() toewijzen aan een variabele (waarnaar de functie clearInterval() later zal verwijzen). Als u de functie clearInterval() niet aanroept om de aanroep setInterval() te annuleren, wordt het object dat de closure-functie voor setTimeout bevat, niet opgeschoond.

Parameters

Verwante API-elementen

package {
    import flash.display.Sprite;
    import flash.utils.*;

    public class SetIntervalExample extends Sprite {
        private var intervalDuration:Number = 1000; // duration between intervals, in milliseconds
        
        public function SetIntervalExample() {
            var intervalId:uint = setInterval(myRepeatingFunction, intervalDuration, "Hello", "World");
        }

        public function myRepeatingFunction():void {
            trace(arguments[0] + " " + arguments[1]);
        }
    }
}

Hiermee wordt een opgegeven functie na een opgegeven vertraging (in milliseconden) uitgevoerd.

In plaats van deze methode te gebruiken, kunt u ook een object Timer met het opgegeven interval maken, met 1 als parameter repeatCount (die de timer instelt om slechts één keer te lopen).

Wanneer u de methode clearTimeout() wilt gebruiken om de aanroep setTimeout() te annuleren, moet u de aanroep setTimeout() toewijzen aan een variabele (waarnaar de functieclearTimeout() later zal verwijzen). Als u de functie clearTimeout() niet aanroept om de aanroep setTimeout() te annuleren, wordt het object dat de closure-functie voor setTimeout bevat, niet opgeschoond.

Parameters

Verwante API-elementen

package {
    import flash.display.Sprite;
    import flash.utils.*;

    public class SetTimeoutExample extends Sprite {
        private var delay:Number = 1000; // delay before calling myDelayedFunction
        
        public function SetTimeoutExample() {
            var intervalId:uint = setTimeout(myDelayedFunction, delay, "Hello", "World");
        }

        public function myDelayedFunction():void {
            trace(arguments[0] + " " + arguments[1]);
        }
    }
}

Retourneert een onbeschermde kopie van de ingevoerde tekenreeks die is gedecodeerd van een systeemcodepagina of UTF-8, afhankelijk van de waarde van System.useCodePage. Wanneer u System.useCodePage gebruikt, kan oudere inhoud die is gecodeerd in lokale codepagina's worden benaderd door het runtimeprogramma, maar alleen op systemen met de oudere codepagina. Japanse gegevens die zijn gecodeerd als Shift-JIS worden bijvoorbeeld alleen correct beschermd en onbeschermd weergegeven op een besturingssysteem dat een standaardcodepagina voor Japans gebruikt.

Parameters