Paket | flash.display |
Klass | public class Stage |
Arv | Stage DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
För SWF-innehåll som körs i webbläsaren (i Flash® Player) representerar scenen hela det område som Flash-innehåll visas i. För innehåll som körs i AIR på klientoperativsystem har varje NativeWindow-objekt ett motsvarande Stage-objekt.
Stage-objektet är inte globalt åtkomligt. Du måste gå till det via stage
-egenskapen hos en DisplayObject-instans.
Klass Stage har flera indirekta överordnade klasser – DisplayObjectContainer, InteractiveObject, DisplayObject och EventDispatcher – som den ärver egenskaper och metoder från. Många av dessa egenskaper och metoder är antingen otillämpbara på Stage-objekt, eller kräver säkerhetskontroller vid anrop från ett Stage-objekt. De egenskaper och metoder som kräver säkerhetskontroller finns dokumenterade som en del av klass Stage.
Dessutom är följande ärvda egenskaper otillämpbara på Stage-objekt. Försök att använda dem ger IllegalOperationError. Dessa egenskaper kan alltid läsas, men eftersom de inte kan ställas in så innehåller de alltid standardvärden.
-
accessibilityProperties
-
alfa
-
blendMode
-
cacheAsBitmap
-
contextMenu
-
filter
-
focusRect
-
loaderInfo
-
mask
-
mouseEnabled
-
namn
-
opaqueBackground
-
rotation
-
scale9Grid
-
scaleX
-
scaleY
-
scrollRect
-
tabEnabled
-
tabIndex
-
transform
-
visible
-
x
-
y
Vissa händelser som du kanske förväntar dig ska vara en del av klassen Stage, som till exempel enterFrame
, exitFrame
, frameConstructed
och render
, kan inte vara stage-händelser eftersom det inte garanterat kan finnas en referens till stage-objektet vid alla tillfällen då dessa händelser används. Dessa händelser kan inte skickas av stage-objektet och skickas därför av alla DisplayObject-instanser. Detta innebär att du kan lägga till en händelseavlyssnare till vilken DisplayObject-instans som helst för att avlyssna dessa händelser. Dessa händelser, som utgör en del av klassen DisplayObject, kallas ”utsända händelser” för att skilja dem från händelser vilkas mål är en specifik DisplayObject-instans. Två andra utsända händelser, activate
och deactivate
, tillhör klassen DisplayObjects superklass EventDispatcher. Händelserna activate
och deactivate
liknar klassen DisplayObjects utsända händelser, med undantaget att dessa två händelser inte bara skickas av alla DisplayObject-instanser utan också av alla EventDispatcher-instanser och instanser av andra underklasser till EventDispatcher. Mer information om utsända händelser finns under klassen DisplayObject.
Relaterade API-element
Egenskap | Definieras med | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
Den aktuella hjälpmedelsimplementeringen (AccessibilityImplementation) för den här InteractiveObject-instansen. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
De nuvarande hjälpmedelsalternativen för det här visningsobjektet. | DisplayObject | ||
align : String
Ett värde från klassen StageAlign som anger scenens justering i Flash Player eller webbläsaren. | Stage | ||
allowsFullScreen : Boolean [skrivskyddad]
Anger om den här scenen tillåter att helskärmsläge används
| Stage | ||
allowsFullScreenInteractive : Boolean [skrivskyddad]
Anger om den här scenen tillåter att helskärmsläge används med textinmatningsläge
| Stage | ||
alpha : Number
Anger det angivna objektets alfagenomskinlighetsvärde. | DisplayObject | ||
autoOrients : Boolean
Anger om scenen automatiskt ändrar orientering när enhetens orientering ändras. | Stage | ||
blendMode : String
Ett värde från klassen BlendMode som anger vilket blandningsläge som ska användas. | DisplayObject | ||
blendShader : Shader [lässkyddad]
Ställer in en skuggning som används för blandning av förgrund och bakgrund. | DisplayObject | ||
browserZoomFactor : Number [skrivskyddad]
Anger webbläsarens zoomningsfaktor. | Stage | ||
cacheAsBitmap : Boolean
Om det är true, sparar Flash-miljöerna en intern bitmappsrepresentation av visningsobjektet i cache-minnet. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
Om detta inte är null definierar det här Matrix-objektet hur ett visningsobjekt återges när cacheAsBitmap har värdet true. | DisplayObject | ||
color : uint
SWF-bakgrundsfärgen. | Stage | ||
colorCorrection : String
Styr färgkorrigering för visningar i Flash-miljön. | Stage | ||
colorCorrectionSupport : String [skrivskyddad]
Anger om Flash-miljön körs på ett operativsystem som kan hantera färgkorrigering och om färgprofilen för huvudbildskärmen kan läsas och förstås av Flash-miljön. | Stage | ||
constructor : * | Stage | ||
contentsScaleFactor : Number [skrivskyddad]
Anger effektiv pixelskalningsfaktor för scenen. | Stage | ||
contextMenu : NativeMenu
Anger vilken snabbmeny som är associerad med det här objektet. | InteractiveObject | ||
deviceOrientation : String [skrivskyddad]
Enhetens fysiska orientering. | Stage | ||
displayState : String
Ett värde från klassen StageDisplayState som anger vilket visningsläge som ska användas. | Stage | ||
doubleClickEnabled : Boolean
Anger om det här objektet tar emot doubleClick-händelser. | InteractiveObject | ||
filters : Array
En indexerad array som innehåller varje filterobjekt som är associerat med visningsobjektet. | DisplayObject | ||
focus : InteractiveObject
Det interaktiva objekt som har tangentbordsfokus, eller null om fokus inte är inställt eller om det objekt som är i fokus tillhör en säkerhetssandlåda som det anropande objektet inte har åtkomst till. | Stage | ||
focusRect : Object
Anger om det här objektet visar en fokusram. | InteractiveObject | ||
frameRate : Number
Hämtar och ställer in bildrutehastighet för scenen. | Stage | ||
fullScreenHeight : uint [skrivskyddad]
Returnerar höjden på den bildskärm som ska användas vid helskärmsläge, om läget aktiveras direkt. | Stage | ||
fullScreenSourceRect : Rectangle
Ställer in Flash-miljön på att skala en viss del av scenen till helskärmsläge. | Stage | ||
fullScreenWidth : uint [skrivskyddad]
Returnerar bredden på den bildskärm som ska användas vid helskärmsläge, om läget aktiveras direkt. | Stage | ||
height : Number [åsidosätt]
Anger visningsobjektets höjd i pixlar. | Stage | ||
loaderInfo : LoaderInfo [skrivskyddad]
Returnerar ett LoaderInfo-objekt som innehåller information om hur filen som visningsobjektet tillhör ska läsas in. | DisplayObject | ||
mask : DisplayObject
Det anropande visningsobjektet maskeras av det angivna visningsobjektet. | DisplayObject | ||
metaData : Object
Erhåller metadataobjektet för instansen DisplayObject om metadata har lagrats tillsammans med instansen för detta DisplayObject i SWF-filen via en PlaceObject4-tagg. | DisplayObject | ||
mouseChildren : Boolean [åsidosätt]
Avgör om objektets underordnade objekt är aktiverade för en mus eller annan användarindataenhet (eller inte). | Stage | ||
mouseEnabled : Boolean
Anger om det här objektet tar emot musmeddelanden eller annan indata från användaren. | InteractiveObject | ||
mouseLock : Boolean
Ange som true för att aktivera låsning av musen. | Stage | ||
mouseX : Number [skrivskyddad]
Anger x-koordinaten för musens eller användarens indataenhets position i pixlar. | DisplayObject | ||
mouseY : Number [skrivskyddad]
Anger y-koordinaten för musens eller användarens indataenhets position i pixlar. | DisplayObject | ||
name : String
Anger instansnamnet för DisplayObject. | DisplayObject | ||
nativeWindow : NativeWindow [skrivskyddad]
En referens till NativeWindow-objektet som innehåller denna scen. | Stage | ||
needsSoftKeyboard : Boolean
Anger om ett virtuellt tangentbord (t.ex. ett skärmtangentbord) ska visas när den här InteractiveObject-instansen är i fokus. | InteractiveObject | ||
numChildren : int [åsidosätt] [skrivskyddad]
Returnerar antalet underordnade objekt det här objektet har. | Stage | ||
opaqueBackground : Object
Anger om visningsobjektet är ogenomskinligt med en viss bakgrundsfärg. | DisplayObject | ||
orientation : String [skrivskyddad]
Scenens aktuella orientering. | Stage | ||
parent : DisplayObjectContainer [skrivskyddad]
Anger DisplayObjectContainer-objektet som innehåller visningsobjektet. | DisplayObject | ||
quality : String
Ett värde från klassen StageQuality som anger vilken återgivningskvalitet som ska användas. | Stage | ||
root : DisplayObject [skrivskyddad]
För ett visningsobjekt i en inläst SWF-fil är rotegenskapen det översta visningsobjektet i den del av visningslistans trädstruktur som representeras av den SWF-filen. | DisplayObject | ||
rotation : Number
Anger DisplayObject-instansens rotation i grader från den ursprungliga orienteringen. | DisplayObject | ||
rotationX : Number
Anger x-axelsrotationen i grader för DisplayObject-instansen, från den ursprungliga orienteringen i förhållande till den överordnade 3D-behållaren. | DisplayObject | ||
rotationY : Number
Anger y-axelsrotationen i grader för DisplayObject-instansen, från den ursprungliga orienteringen i förhållande till den överordnade 3D-behållaren. | DisplayObject | ||
rotationZ : Number
Anger z-axelsrotationen i grader för DisplayObject-instansen, från den ursprungliga orienteringen i förhållande till den överordnade 3D-behållaren. | DisplayObject | ||
scale9Grid : Rectangle
Det skalningsrutnät som används för närvarande. | DisplayObject | ||
scaleMode : String
Ett värde från klassen StageScaleMode som anger vilket skalningsläge som ska användas. | Stage | ||
scaleX : Number
Anger vågrät skala (i procent) för objektet utifrån dess registreringspunkt. | DisplayObject | ||
scaleY : Number
Anger lodrät skala (i procent) för objektet utifrån dess registreringspunkt. | DisplayObject | ||
scaleZ : Number
Anger djupskala (procent) för objektet utifrån dess registreringspunkt. | DisplayObject | ||
scrollRect : Rectangle
Visningsobjektets gränser för rullningsrektangeln. | DisplayObject | ||
showDefaultContextMenu : Boolean
Anger om standardalternativen på snabbmenyn i Flash-miljön ska visas eller döljas. | Stage | ||
softKeyboard : String
Kontrollerar utseendet på skärmtangentbordet. | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
Definierar det område som ska behållas på skärmen när skärmtangentbordet visas (ej tillgängligt på iOS). | InteractiveObject | ||
softKeyboardRect : Rectangle [skrivskyddad]
En rektangel som anger den del av scenen som för tillfället upptas av ett skärmtangentbord. | Stage | ||
stage : Stage [skrivskyddad]
Visningsobjektets scen. | DisplayObject | ||
stage3Ds : Vector.<Stage3D> [skrivskyddad]
En lista med Stage3D-objekt som är tillgängliga för att visa 3-dimensionellt innehåll. | Stage | ||
stageFocusRect : Boolean
Anger om objekt visas med en lysande kantlinje när de är i fokus eller inte. | Stage | ||
stageHeight : int
Anger scenens höjd i pixlar. | Stage | ||
stageVideos : Vector.<StageVideo> [skrivskyddad]
En lista över StageVideo-objekt som är tillgängliga för uppspelning av extern video. | Stage | ||
stageWidth : int
Anger scenens bredd i pixlar. | Stage | ||
supportedOrientations : Vector.<String> [skrivskyddad]
De orienteringar som stöds av den aktuella enheten. | Stage | ||
supportsOrientationChange : Boolean [statisk] [skrivskyddad]
Om programmet har stöd för ändringar av scenens orientering (och enhetsrotation). | Stage | ||
tabChildren : Boolean [åsidosätt]
Avgör om objektets underordnade objekt är tabbaktiverade. | Stage | ||
tabEnabled : Boolean
Anger om det här objektet inkluderas i tabbordningen. | InteractiveObject | ||
tabIndex : int
Anger tabbordningen för objekt i en SWF-fil. | InteractiveObject | ||
textSnapshot : flash.text:TextSnapshot [åsidosätt] [skrivskyddad]
Returnerar ett TextSnapshot-objekt för den här DisplayObjectContainer-instansen. | Stage | ||
transform : flash.geom:Transform
Ett objekt med egenskaper som gäller ett visningsobjekts matris, färgomformning och pixelgränser. | DisplayObject | ||
visible : Boolean
Om visingsobjektet är synligt eller inte. | DisplayObject | ||
vsyncEnabled : Boolean
Detta representerar det aktuella tillståndet för vsync i den underliggande grafiklösningen. Vi kan aktivera/inaktivera vsync så vi kan rendera omedelbart utan att vänta på nästa VSYNC-tillstånd. | Stage | ||
width : Number [åsidosätt]
Anger visningsobjektets bredd i pixlar. | Stage | ||
wmodeGPU : Boolean [skrivskyddad]
Anger om GPU-sammansättning är tillgänglig och i så fall om det används. | Stage | ||
x : Number
Anger x-koordinaten för DisplayObject-instansen i förhållande till de lokala koordinaterna för den överordnade DisplayObjectContainer. | DisplayObject | ||
y : Number
Anger y-koordinaten för DisplayObject-instansen i förhållande till de lokala koordinaterna för den överordnade DisplayObjectContainer. | DisplayObject | ||
z : Number
Anger z-koordinatens position längs DisplayObject-instansens z-axel i förhållande till den överordnade 3D-behållaren. | DisplayObject |
Metod | Definieras med | ||
---|---|---|---|
[åsidosätt]
Lägger till en underordnad DisplayObject-instans i den här DisplayObjectContainer-instansen. | Stage | ||
[åsidosätt]
Lägger till en underordnad DisplayObject-instans i den här DisplayObjectContainer-instansen. | Stage | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [åsidosätt]
Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser. | Stage | ||
Anger om säkerhetsrestriktionerna kan göra att visningsobjekt utelämnas från listan som returneras när metoden DisplayObjectContainer.getObjectsUnderPoint() anropas med den angivna punkten. | DisplayObjectContainer | ||
Ger tangentbordsfokus till det interaktiva objekt som anges av objectToFocus, och fokusriktningen anges av parametern direction. | Stage | ||
Avgör om det angivna visningsobjektet är underordnat DisplayObjectContainer-instansen eller själva instansen. | DisplayObjectContainer | ||
[åsidosätt]
Skickar en händelse till händelseflödet. | Stage | ||
Returnerar en rektangel som definierar visningsområdets område i relation till targetCoordinateSpace-objektets koordinatsystem. | DisplayObject | ||
Returnerar den underordnade visningsobjektsinstansen som finns vid det angivna indexvärdet. | DisplayObjectContainer | ||
Returnerar det underordnade visningsobjektet som har ett visst namn. | DisplayObjectContainer | ||
Returnerar indexpositionen för en underordnad DisplayObject-instans. | DisplayObjectContainer | ||
Returnerar en array med objekt som ligger under den angivna punkten och är underordnade (eller indirekt underordnade) den här DisplayObjectContainer-instansen. | DisplayObjectContainer | ||
Returnerar en rektangel som definierar visningsområdets gräns, baserat på koordinatsystemet som definieras av targetCoordinateSpace-parametern, exklusive eventuella linjer i former. | DisplayObject | ||
Konverterar punktobjektet från scenens (globala) koordinater till visningsobjektets (lokala) koordinater. | DisplayObject | ||
Konverterar en tvådimensionell punkt från scenens (globala) koordinater till ett tredimensionellt visningsobjekts (lokala) koordinater. | DisplayObject | ||
[åsidosätt]
Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse. | Stage | ||
Anger om det finns en egenskap angiven för ett objekt. | Object | ||
Utvärderar begränsningsramen för visningsobjektet för att kontrollera om den överlappar eller korsar begränsningsramen för obj-visningsobjektet. | DisplayObject | ||
Utvärderar visningsobjektet för att avgöra om det överlappar eller korsar den punkt som anges av x- och y-parametrarna. | DisplayObject | ||
Anrop av invalidate()-metoden signalerar till Flash-miljöerna att aktivera visningsobjekt vid nästa möjlighet att återge visningslistan (exempelvis när spelhuvudet går till en ny bildruta). | Stage | ||
Avgör om egenskapen Stage.focus returnerar null av säkerhetsskäl. | Stage | ||
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | ||
Konverterar en tredimensionell punkt för det tredimensionella visningsobjektets (lokala) koordinater till en tvådimensionell punkt i scenens (globala) koordinater. | DisplayObject | ||
Konverterar punktobjektet från visningsobjektets (lokala) koordinater till scenens (globala) koordinater. | DisplayObject | ||
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | ||
Tar bort den angivna underordnade DisplayObject-instansen från listan med underordnade för DisplayObjectContainer-instansen. | DisplayObjectContainer | ||
[åsidosätt]
Tar bort ett underordnat DisplayObject från den angivna indexpositionen i den underordnade listan i DisplayObjectContainer. | Stage | ||
Tar bort alla child-DisplayObject-instanser från listan med underordnade för DisplayObjectContainer-instansen. | DisplayObjectContainer | ||
Tar bort en avlyssnare från EventDispatcher-objektet. | EventDispatcher | ||
Visar ett virtuellt tangentbord. | InteractiveObject | ||
Ställer in scenens orientering med de angivna proportionerna. | Stage | ||
[åsidosätt]
Ändrar positionen för ett befintligt underordnat objekt i behållaren för visningsobjekt. | Stage | ||
Ställer in scenen på den angivna orienteringen. | Stage | ||
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | ||
Stoppar rekursivt tidslinjekörning av alla filmklipp vars rot är detta objekt. | DisplayObjectContainer | ||
Byter z-ordningen (framifrån och bakåt-ordning) för de två underordnade objekten. | DisplayObjectContainer | ||
[åsidosätt]
Byter z-ordningen (framifrån och bakåt-ordning) för underordnade objekt vid de två angivna indexpositionerna i listan med underordnade objekt. | Stage | ||
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | ||
Returnerar det angivna objektets strängbeteckning. | Object | ||
Returnerar det angivna objektets primitiva värde. | Object | ||
[åsidosätt]
Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen. | Stage |
Händelse | Sammanfattning | Definieras med | ||
---|---|---|---|---|
[utsändningshändelse] Skickas när Flash Player eller AIR får operativsystemfokus och blir aktivt. | EventDispatcher | |||
Skickas när ett visningsobjekt läggs till i visningslistan. | DisplayObject | |||
Skickas när ett visningsobjekt läggs till i scenens visningslista, antingen direkt eller genom tillägg av ett underträd som innehåller visningsobjektet. | DisplayObject | |||
Skickas när egenskapen browserZoomFactor för Stage-objektet ändras. | Stage | |||
Skickas när användaren väljer ”Ta bort” på textinnehållsmenyn. | InteractiveObject | |||
Skickas när en användare trycker ner och släpper upp huvudknappen på sitt pekdon över samma InteractiveObject. | InteractiveObject | |||
Skickas när en användargest utlöser den snabbmeny som är kopplad till detta interaktiva objekt i ett AIR-program. | InteractiveObject | |||
Skickas när användaren aktiverar den plattformsspecifika tangentkombinationen för funktionen Kopiera eller väljer ”Kopiera” på snabbmenyn. | InteractiveObject | |||
Skickas när användaren aktiverar den plattformsspecifika tangentkombinationen för funktionen Klipp ut eller väljer Klipp ut på snabbmenyn. | InteractiveObject | |||
[utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt. | EventDispatcher | |||
Skickas när en användare trycker ner och släpper upp huvudknappen på ett pekdon två gånger i snabb följd över samma InteractiveObject när detta objekts doubleClickEnabled-flagga är satt till true. | InteractiveObject | |||
[utsändningshändelse] Skickas när spelhuvudet går in i en ny bildruta. | DisplayObject | |||
[utsändningshändelse] Skickas när spelhuvudet stänger den aktuella bildrutan. | DisplayObject | |||
Skickas när ett visningsobjekt fokuserats. | InteractiveObject | |||
Skickas när ett visningsobjekt tappar fokusering. | InteractiveObject | |||
[utsändningshändelse] Skickas efter att konstruktorerna för bildrutevisningsobjekt har körts men innan bildruteskript har körts. | DisplayObject | |||
Skickas när Stage-objektet går in i, eller ut ur, fullskärmsläget. | Stage | |||
Skickas när användaren skapar en kontaktpunkt längs pekytans kant med en InteractiveObject-instans (såsom att trycka längs kanten av pekytan på Siri Remote för Apple-TV). Vissa enheter kan också tolka denna kontakt som en kombination av flera pekhändelser. | InteractiveObject | |||
Skickas när användaren trycker på två kontaktpunkter över samma InteractiveObject-instans på en beröringsaktiverad enhet (som att trycka med två fingrar och sedan släppa dem över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Skickas när användaren flyttar en kontaktpunkt över InteractiveObject-instansen på en beröringsaktiverad enhet (som att flytta ett finger från vänster till höger över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Skickas när användaren utför en rotationsgest vid en kontaktpunkt med en InteractiveObject-instans (som att vidröra en skärm med två fingrar och rotera dem över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Skickas när användaren utför en svepningsgest vid en kontaktpunkt med en InteractiveObject-instans (som att vidröra en skärm med tre fingrar och sedan flytta fingrarna parallellt över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Skickas när användaren skapar en kontaktpunkt med en InteractiveObject-instans och sedan vidrör en beröringsaktiverad enhet (som att placera flera fingrar över ett visningsobjekt för att öppna en meny och sedan använda ett finger för att peka på ett menyalternativ på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Skickas när användaren utför en zoomningsgest vid en kontaktpunkt med en InteractiveObject-instans (som att vidröra en skärm med två fingrar och sedan snabbt sära på fingrarna över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Den här händelsen skickas till alla klientprogram som har stöd för indata via ett redigeringsprogram för inmatningsmetoder (IME). | InteractiveObject | |||
Skickas när användaren trycker på en tangent. | InteractiveObject | |||
Skickas när användaren försöker att ändra fokuseringen med tangentbordsnavigering. | InteractiveObject | |||
Skickas när användaren släpper upp en tangent. | InteractiveObject | |||
Skickas när en användare trycker ned och släpper upp mittenknappen på sitt pekdon över samma InteractiveObject. | InteractiveObject | |||
Skickas när en användare trycker på pekdonets mittenknapp över en InteractiveObject-instans. | InteractiveObject | |||
Skickas när en användare släpper pekdonets knapp över en InteractiveObject-instans. | InteractiveObject | |||
Skickas när en användare trycker på pekdonets knapp över en InteractiveObject-instans. | InteractiveObject | |||
Skickas när användaren försöker att ändra fokuseringen med ett pekdon. | InteractiveObject | |||
Skickas av Stage-objektet när pekaren flyttas bort från scenområdet. | Stage | |||
Skickas när en användare flyttar pekdonet när det befinner sig över ett InteractiveObject. | InteractiveObject | |||
Skickas när användaren flyttar bort pekdonet från en InteractiveObject-instans. | InteractiveObject | |||
Skickas när användaren flyttar pekdonet över en InteractiveObject-instans. | InteractiveObject | |||
Skickas när en användare släpper pekdonets knapp över en InteractiveObject-instans. | InteractiveObject | |||
Skickas när mushjulet rullas över en InteractiveObject-instans. | InteractiveObject | |||
Skickas av drag initiator InteractiveObject när användaren släpper dragrörelsen. | InteractiveObject | |||
Skickas av ett InteractiveObject-målobjekt när ett objekt dras till målobjektet och dragningen har accepterats med ett anrop till DragManager.acceptDragDrop(). | InteractiveObject | |||
Skickas av ett InteractiveObject-objekt när en dragrörelse går in i dess gränser. | InteractiveObject | |||
Skickas av ett InteractiveObject-objekt när en dragrörelse går utanför dess gränser. | InteractiveObject | |||
Skickas kontinuerligt av ett InteractiveObject-objekt när en dragrörelse pågår inom dess gränser. | InteractiveObject | |||
Skickas i början av en dragning av det InteractiveObject-objekt som anges som dragningsinitierare i DragManager.doDrag()-anropet. | InteractiveObject | |||
Skickas under en dragning av det InteractiveObject-objekt som anges som dragningsinitierare i DragManager.doDrag()-anropet. | InteractiveObject | |||
Skickas av Stage-objektet när scenens orientering ändras. | Stage | |||
Skickas av Stage-objektet när förändringen av scenorienteringen börjar. | Stage | |||
Skickas när användaren aktiverar den plattformsspecifika tangentkombinationen för funktionen Klistra in eller väljer Klistra in på snabbmenyn. | InteractiveObject | |||
Skickas när användaren sänker en aktiv penna förbi skärmens upptäcktströskel. | InteractiveObject | |||
Skickas när användaren lyfter en aktiv penna över skärmens upptäcktströskel. | InteractiveObject | |||
Skickas när användaren flyttar en aktiv penna över skärmen medan den behålls inom skärmens upptäcktströskel. | InteractiveObject | |||
Skickas när användaren flyttar en aktiv penna bort från detta InteractiveObject medan den behålls inom skärmens upptäcktströskel. | InteractiveObject | |||
Skickas när användaren flyttar en aktiv penna direkt över detta InteractiveObject medan den behålls inom skärmens upptäcktströskel. | InteractiveObject | |||
Skickas när användaren flyttar en aktiv penna bort från detta InteractiveObject och något av dess underordnade objekt medan den behålls inom skärmens upptäcktströskel. | InteractiveObject | |||
Skickas när användaren flyttar en aktiv penna över detta InteractiveObject från utsidan av objektets underordnade träd i visningslistan (men stannar kvar inom skärmens upptäcktströskel). | InteractiveObject | |||
Skickas när användaren släpper knappen på pekaren efter att första ha tryckt på den över en InteractiveObject-instans och sedan flyttat pekaren bort från InteractiveObject-instansen. | InteractiveObject | |||
Skickas när ett visningsobjekt ska tas bort från visningslistan. | DisplayObject | |||
Skickas när ett visningsobjekt ska tas bort från visningslistan, antingen direkt eller genom borttagning av ett underträd som innehåller visningsobjektet. | DisplayObject | |||
[utsändningshändelse] Skickas när visningslistan ska uppdateras och återges. | DisplayObject | |||
Skickas när scaleMode-egenskapen för Stage-objektet satts till StageScaleMode.NO_SCALE och storleken på SWF-filen ändras. | Stage | |||
Skickas när en användare trycker ned och släpper upp högerknappen på sitt pekdon över samma InteractiveObject. | InteractiveObject | |||
Skickas när en användare trycker på pekdonets knapp över en InteractiveObject-instans. | InteractiveObject | |||
Skickas när en användare släpper pekdonets knapp över en InteractiveObject-instans. | InteractiveObject | |||
Skickas när användaren flyttar bort pekdonet från en InteractiveObject-instans. | InteractiveObject | |||
Skickas när användaren flyttar pekdonet över en InteractiveObject-instans. | InteractiveObject | |||
Skickas när användaren aktiverar den plattformsspecifika tangentkombinationen för funktionen Markera allt eller väljer Markera allt på snabbmenyn. | InteractiveObject | |||
Skickas omedelbart efter att skärmtangentbordet tas fram (visas). | InteractiveObject | |||
Skickas omedelbart innan skärmtangentbordet tas fram (visas). | InteractiveObject | |||
Skickas omedelbart efter att skärmtangentbordet döljs. | InteractiveObject | |||
Skickas av Stage-objektet när statusen för egenskapen stageVideos ändras. | Stage | |||
Skickas när värdet på objektets tabChildren-flagga ändras. | InteractiveObject | |||
Skickas när objektets tabEnabled-flagga ändras. | InteractiveObject | |||
Skickas när värdet på objektets tabIndex-egenskap ändras. | InteractiveObject | |||
Skickas när användaren skriver ett eller flera texttecken. | InteractiveObject | |||
Skickas när användaren först kontaktar en beröringsaktiverad enhet (som att vidröra en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Skickas när användaren avslutar kontakten med en beröringsaktiverad enhet (som att lyfta fingret från en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Skickas när användaren rör enheten och skickas kontinuerligt tills kontaktpunkten avlägsnas. | InteractiveObject | |||
Skickas när användaren flyttar kontaktpunkten bort från en InteractiveObject-instans på en beröringsaktiverad enhet (som att dra fingret från ett visningsobjekt till ett annat på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Skickas när användaren flyttar kontaktpunkten över en InteractiveObject-instans på en beröringsaktiverad enhet (som att dra fingret från en punkt utanför ett visningsobjekt till en punkt över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Skickas när användaren flyttar kontaktpunkten bort från en InteractiveObject-instans på en beröringsaktiverad enhet (som att dra fingret från ett visningsobjekt till en punkt utanför visningsobjektet på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Skickas när användaren flyttar kontaktpunkten över en InteractiveObject-instans på en beröringsaktiverad enhet (som att dra fingret från en punkt utanför ett visningsobjekt till en punkt över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Skickas när användaren lyfter kontaktpunkten över samma InteractiveObject-instans där kontakten initierades på en beröringsaktiverad enhet (som att trycka med fingret och sedan släppa det vid en enda kontaktpunkt över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | |||
Skickas av Stage-objektet när tillståndet ändras för egenskapen vsync. | Stage |
align | egenskap |
align:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ett värde från klassen StageAlign som anger scenens justering i Flash Player eller webbläsaren. Dessa värden är giltiga:
Värde | Lodrät justering | Vågrät |
---|---|---|
StageAlign.TOP | Upptill | Centrera |
StageAlign.BOTTOM | Nedtill | Centrera |
StageAlign.LEFT | Centrera | Vänster |
StageAlign.RIGHT | Centrera | Höger |
StageAlign.TOP_LEFT | Upptill | Vänster |
StageAlign.TOP_RIGHT | Upptill | Höger |
StageAlign.BOTTOM_LEFT | Nedtill | Vänster |
StageAlign.BOTTOM_RIGHT | Nedtill | Höger |
align
-egenskapen finns bara tillgänglig för objekt som befinner sig i samma säkerhetssandlåda som Stage-ägaren (SWF-huvudfilen). För att undvika detta kan Stage-ägaren bevilja anroparens domän tillstånd genom att anropa Security.allowDomain()
-metoden eller Security.alowInsecureDomain()
-metoden. Ytterligare information finns i kapitlet ”Säkerhet” i Utvecklarhandbok för Adobe ActionScript 3.0.
Implementering
public function get align():String
public function set align(value:String):void
Relaterade API-element
allowsFullScreen | egenskap |
allowsFullScreenInteractive | egenskap |
autoOrients | egenskap |
autoOrients:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2 |
Anger om scenen automatiskt ändrar orientering när enhetens orientering ändras.
Det initiala värdet för den här egenskapen härleds från elementet autoOrients
i programbeskrivningsfilen och får som standard värdet false
. När egenskapen ändras till false
garanteras inte beteendet. På vissa enheter behåller scenen den aktuella orienteringen. På andra ändras scenorienteringen till en enhetsdefinierad standardorientering. Därefter ändras inte scenorienteringen mer.
Stöd för AIR-profiler: Den här funktionen stöds på mobilenheter, men inte på operativsystem för datorer eller enheter med AIR for TV. Du kan testa stödet vid körning med egenskapen Stage.supportsOrientantionChange
. På sidan om stöd för AIR-profiler hittar du mer information om API-stöd för flera profiler.
Implementering
public function get autoOrients():Boolean
public function set autoOrients(value:Boolean):void
Relaterade API-element
browserZoomFactor | egenskap |
color | egenskap |
colorCorrection | egenskap |
colorCorrection:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5 |
Styr färgkorrigering för visningar i Flash-miljön. Färgkorrigering fungerar bara om huvudbildskärmen är tilldelad en ICC-färgprofil som anger enhetens särskilda färgattribut. I Flash-miljön är standardbeteendet att försöka matcha värdens (vanligtvis en webbläsare) färgkorrigering.
Använd egenskapen Stage.colorCorrectionSupport
för att avgöra om det finns tillgänglig färgkorrigering på det aktuella systemet och i standardtillståndet. Om färgkorrigering finns antas alla färger vara i standardfärgområdet sRGB. Vid färgkorrigering tas ingen hänsyn till källprofiler för indataenheter. Ingen färgkorrigering används. Det är endast scenens utdata som mappas till huvudskärmens ICC-färgprofil.
Fördelarna med att aktivera färghantering innebär vanligtvis förutsägbara och konsekventa färger, bättre konvertering, mer exakta provtryck och effektivare utdata för olika medier. Tänk dock på att färghanteringen inte ger perfekta konverteringar. Det beror på de ursprungliga bilderna och att olika enheter har olika färgomfång. Färghanteringen tar inte heller bort behovet av anpassade eller redigerade profiler. Färgprofilerna är beroende av webbläsare, operativsystem (OS), OS-tillägg, utdataenheter och programstöd.
Användning av färgkorrigering ger sämre prestanda i Flash-miljön. Färgkorrigeringen i Flash-miljön är en dokumentformatsfärgkorrigering eftersom alla SWF-filmer hanteras som dokument med implicita sRGB-profiler. Använd egenskapen Stage.colorCorrectionSupport
för att ange att Flash-miljön ska korrigera färger när SWF-filen (dokumentet) visas så att färgområdet visas. I Flash-miljöerna finns bara kompensation för skillnader mellan olika bildskärmar, inte för skillnader mellan olika indataenheter (kamera, skanner o.s.v.).
De tre möjliga värdena är strängar med motsvarande konstanter i klassen flash.display.ColorCorrection:
"default"
: Använd samma färgkorrigering som värdsystemet."on"
: Genomför alltid färgkorrigering."off"
: Genomför aldrig färgkorrigering.
Implementering
public function get colorCorrection():String
public function set colorCorrection(value:String):void
Relaterade API-element
Exempel ( Så här använder du exemplet )
Stage.colorCorrection
inte är ett värde från klassen ColorCorrection rapporterar hanteraren ett fel.
function addHandler(add_event:Event) { switch(stage.colorCorrection) { case ColorCorrection.ON: stage.colorCorrection = ColorCorrection.OFF; lblCMEnableState.text = "State: " + stage.colorCorrection; break; case ColorCorrection.OFF: stage.colorCorrection = ColorCorrection.DEFAULT; lblCMEnableState.text = "State: " + stage.colorCorrection; break; case ColorCorrection.DEFAULT: stage.colorCorrection = ColorCorrection.ON; lblCMEnableState.text = "State: " + stage.colorCorrection; break; default: lblCMEnableState.text = "Error."; break; }
colorCorrectionSupport | egenskap |
colorCorrectionSupport:String
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10, AIR 1.5 |
Anger om Flash-miljön körs på ett operativsystem som kan hantera färgkorrigering och om färgprofilen för huvudbildskärmen kan läsas och förstås av Flash-miljön. Egenskapen returnerar standardtillståndet för färgkorrigering på värdsystemet (vanligtvis webbläsaren). Returvärdena kan för närvarande vara:
De tre möjliga värdena är strängar med motsvarande konstanter i klassen flash.display.ColorCorrectionSupport:
"unsupported"
: Färgkorrigering är ej tillgänglig."defaultOn"
: Genomför alltid färgkorrigering."defaultOff"
: Genomför aldrig färgkorrigering.
Implementering
public function get colorCorrectionSupport():String
Relaterade API-element
Exempel ( Så här använder du exemplet )
stage.colorCorrectionSupport
för att se om det är DEFAULT_ON
eller DEFAULT_OFF
, vilket är värden från klassen ColorCorrectionSupport. Om egenskapen har något av dessa båda värden visas det aktuella värdet i textfältet. Om värdet varken är DEFAULT_ON
eller DEFAULT_OFF
visas däremot "unsupported" i textfältet.
function addHandler(add_event:Event) { if (stage.colorCorrectionSupport == ColorCorrectionSupport.DEFAULT_ON || stage.colorCorrectionSupport == ColorCorrectionSupport.DEFAULT_OFF) { lblHasCM.text = "stage.colorCorrectionSupport: " + stage.colorCorrectionSupport; } else { lblHasCM.text = "stage.colorCorrectionSupport: unsupported"; } }
constructor | egenskap |
contentsScaleFactor | egenskap |
contentsScaleFactor:Number
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 11.5 |
Anger effektiv pixelskalningsfaktor för scenen. Det här värdet är 1 på vanliga skärmar och HiDPI-skärmar (retina-skärmar). När scenen återges på HiDPI-skärmar dubbleras pixelupplösningen, även om scenskalningsläget anges till StageScaleMode.NO_SCALE. Stage.stageWidth och Stage.stageHeight rapporteras fortfarande i klassiska pixelenheter.
Implementering
public function get contentsScaleFactor():Number
deviceOrientation | egenskap |
deviceOrientation:String
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2 |
Enhetens fysiska orientering.
På enheter med utfällbara tangentbord har tangentbordets status högre prioritet än den rotation som identifieras av accelerometern när enhetens orientering ska fastställas. På en stående enhet med ett sidomonterat tangentbord rapporterar egenskapen deviceOrientation
således ROTATED_LEFT
när tangentbordet är utfällt, oavsett hur användaren håller enheten.
Använd konstanterna som definieras i klassen StageOrientation när du ställer in eller jämför värden för den här egenskapen.
Stöd för AIR-profiler: Den här funktionen stöds på mobilenheter, men inte på operativsystem för datorer eller enheter med AIR for TV. Du kan testa stödet vid körning med egenskapen Stage.supportsOrientationChange
. På sidan om stöd för AIR-profiler hittar du mer information om API-stöd för flera profiler.
Implementering
public function get deviceOrientation():String
Relaterade API-element
displayState | egenskap |
displayState:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9.0.28.0, Flash Lite 4 |
Ett värde från klassen StageDisplayState som anger vilket visningsläge som ska användas. Dessa värden är giltiga:
StageDisplayState.FULL_SCREEN
Ställer in AIR-program eller innehåll i Flash Player så att scenen expanderas över användarens hela skärm. Tangentbordsinmatningar är inaktiverade, med undantag för en begränsad uppsättning icke-utskriftsbara tangenter.StageDisplayState.FULL_SCREEN_INTERACTIVE
Anger att programmet ska expandera scenen över hela användarens skärm, med tillåten tangentbordsinmatning. (Tillgängligt i AIR och Flash Player, från och med Flash Player 11.3.)StageDisplayState.NORMAL
Återställer scenen till standardvisningsläge.
Filmens skalningsbeteende i helskärmsläget avgörs av inställningen för scaleMode
(som ställs in med egenskapen Stage.scaleMode
eller SWF-filens embed tag
-inställningar i HTML-filen). Om scaleMode
-egenskapen sätts till noScale
när programmet går till helskärmsläge, uppdateras egenskaperna Stage width
och height
och Stage resize
-händelsen skickas. Om något annat skalningsläge är inställt, kommer scenen och dess innehåll att skalanpassas så att de fyller upp de nya skärmdimensionerna. Scenobjekten behåller de ursprungliga värdena för width
och height
, och de skickar ingen resize
-händelse.
Följande begränsningar gäller för SWF-filer som körs på en HTML-sida (inte de som använder den fristående Flash Player eller AIR-miljön):
- För att aktivera helskärmsläget lägger man till
allowFullScreen
-parametern tillobject
- ochembed
-taggarna på HTML-sidan med SWF-filen, medallowFullScreen
satt till"true"
, enligt detta exempel:<param name="allowFullScreen" value="true" /> ... <embed src="example.swf" allowFullScreen="true" ... >
En HTML-sida kan också använda ett skript för att generera SWF-inbäddningstaggar. Du måste ändra skriptet så att det lägger in rätt
allowFullScreen
-inställningar. HTML-sidor som genererats av Flash Professional och Flash Builder använder funktionenAC_FL_RunContent()
för att bädda in referenser till SWF-filer, och du måste lägga till inställningarna för parameternallowFullScreen
enligt följande:AC_FL_RunContent( ... "allowFullScreen", "true", ... )
- Helskärmsläge aktiveras som svar på en musklickning eller tangenttryckning. Filmens
Stage.displayState
kan inte ändras utan indata från användaren. Flash-miljöerna begränsar tangentbordsinmatning i helskärmsläge. Godkända tangenter inkluderar tangentbordskortkommandon som avslutar helskärmsläget och ej skrivbara tangenter som pilar, mellanslag, Skift och Tab. (Använd interaktivt helskärmsläge för att få stöd för inmatning från fler tangenter.) Följande kortkommandon avbryter helskärmsläget: Esc (Windows, Linux och Mac), Ctrl+W (Windows), Kommando+W (Mac) och Alt+F4. - Från och med Flash Player 9.0.115.0 fungerar helskärm på samma sätt i fönsterlöst läge som i fönsterläge. Om du ställer in fönsterläget (
wmode
i HTML) på ogenomskinlig fönsterlös (opaque
) eller genomskinlig fönsterlös (transparent
) kan helskärm aktiveras, men helskärmsfönstret kommer alltid att vara ogenomskinligt. - För att aktivera det interaktiva helskärmsläget, som ger stöd för tangentbordsinteraktion, lägger du till parametern
allowFullScreenInteractive
tillobject
- ochembed
-taggarna på HTML-sidan med SWF-filen, medallowFullScreenInteractive
satt till"true"
, enligt detta exempel:<param name="allowFullScreenInteractive" value="true" /> ...
Dessa begränsningar gäller inte för SWF-innehåll som körs i den fristående Flash Player eller i AIR.
När helskärmsläget aktiveras, visas i Flash-miljön snabbt ett meddelande över SWF-innehållet för att informera användarna om att de befinner sig i helskärmsläge och att de kan trycka på Escape-tangenten för att stänga helskärmsläget.
När det interaktiva helskärmsläget aktiveras, i Flash Player visas en bekräftelse för SWF-innehållet, får användarna åtkomst till utökad tangentbordsinmatning (inklusive utskriftsbara tangenter) och de informeras om att de kan trycka på Escape-tangenten för att stänga det interaktiva helskärmsläget. Du ska inte göra några antaganden om utseende/plats för bekräftelsen. Du kan bestämma om användarna ska ha åtkomst till utökad tangentbordsinmatning genom att avlyssna händelsen FullScreenEvent.FULL_SCREEN_INTERACTIVE_ACCEPTED
.
För AIR-innehåll som körs i helskärmsläge är systemets skärmsläckare och energisparalternativ inaktiverade när videoinnehållet spelas upp, antingen tills videon avslutas eller helskärmsläget avbryts.
När displayState
ställs in på StageDisplayState.FULL_SCREEN
eller StageDisplayState.FULL_SCREEN_INTERACTIVE
i Linux är det en asynkron åtgärd.
Implementering
public function get displayState():String
public function set displayState(value:String):void
Utlöser
SecurityError — Anrop av displayState -egenskapen för ett Stage-objekt ger ett undantag för varje anropare som inte befinner sig i samma säkerhetssandlåda som Stageägaren (SWF-huvudfilen). För att undvika detta kan Stage-ägaren bevilja anroparens domän tillstånd genom att anropa Security.allowDomain() -metoden eller Security.allowInsecureDomain() -metoden. Ytterligare information finns i kapitlet ”Säkerhet” i Utvecklarhandbok för Adobe ActionScript 3.0. Försök att ställa in displayState -egenskapen när dialogrutan för inställningar visas, utan ett användargensvar, eller om param - eller embed -HTML-taggens allowFullScreen -attribut inte satts till true , ger ett säkerhetsfel.
|
Relaterade API-element
Exempel ( Så här använder du exemplet )
displayState
-egenskapen. Obs: Av säkerhetsskäl kan helskärmen bara aktiveras under vissa bestämda omständigheter, som exempelvis när användaren har klickat eller tryckt på en tangent. Vid körning i en webbläsare måste allowFullScreen-egenskapen ha satts till true.
package { import flash.display.Sprite; import flash.display.Stage; import flash.events.*; import flash.net.NetConnection; import flash.net.NetStream; import flash.media.Video; public class FullScreenExample extends Sprite { private var videoURL:String = "testVideo.flv"; private var connection:NetConnection; private var stream:NetStream; private var video:Video; public function FullScreenExample() { connection = new NetConnection(); connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); connection.connect(null); loaderInfo.addEventListener(Event.INIT, createMouseListener); } private function createMouseListener(event:Event):void { stage.addEventListener(MouseEvent.CLICK,toggleFullScreen); } private function toggleFullScreen(event:MouseEvent):void { switch(stage.displayState) { case "normal": stage.displayState = "fullScreen"; break; case "fullScreen": default: stage.displayState = "normal"; break; } } // Video related: private function netStatusHandler(event:NetStatusEvent):void { switch (event.info.code) { case "NetConnection.Connect.Success": connectStream(); break; case "NetStream.Play.StreamNotFound": trace("Unable to locate video: " + videoURL); break; } } private function connectStream():void { var stream:NetStream = new NetStream(connection); stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); stream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); video = new Video(stage.stageWidth,stage.stageHeight); video.attachNetStream(stream); stream.play(videoURL); addChild(video); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } private function asyncErrorHandler(event:AsyncErrorEvent):void { // ignore AsyncErrorEvent events. } } }
focus | egenskap |
focus:InteractiveObject
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Det interaktiva objekt som har tangentbordsfokus, eller null
om fokus inte är inställt eller om det objekt som är i fokus tillhör en säkerhetssandlåda som det anropande objektet inte har åtkomst till.
Implementering
public function get focus():InteractiveObject
public function set focus(value:InteractiveObject):void
Utlöser
Error — Ett fel uppkommer om om fokus inte kan ställas in på målet.
|
Exempel ( Så här använder du exemplet )
myTF
så att användaren kan börja skriva utan att behöva klicka på något. På iOS-enheter, mobila Android-enheter och tvOS-enheter måste användaren klicka i textfältet för att aktivera skärmtangentbordet. Om du testar den här koden med utvecklingsverktyget har du bara tillgång till ett fåtal tangenter, eftersom värden (webbläsaren eller verktyget) tolkar de flesta tangenttryckningar först. Om du vill se hur det här exemplet ska fungera kompilerar du det och kör SWF-filen.
var myTF:TextField = new TextField(); myTF.border =true; myTF.type = TextFieldType.INPUT; addChild(myTF); stage.focus= myTF;
frameRate | egenskap |
frameRate:Number
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Hämtar och ställer in bildrutehastighet för scenen. Bildrutefrekvensen anges i bildrutor per sekund. Frekvensen är som standard inställd på bildrutefrekvensen för den första SWF-fil som läses in. De giltiga bildrutefrekvenserna är från 0,01 till 1 000 bildrutor per sekund.
Obs! Ett program klarar eventuellt inte höga bildrutehastigheter, antingen på grund av att målplattformen inte är tillräckligt snabb eller därför att spelaren synkroniseras med visningsenhetens lodräta släckningstider (vanligen 60 Hz för LCD-enheter). I vissa fall kan en målplattform dessutom välja att sänka den högsta bildrutehastigheten om den förväntar en hög CPU-belastning.
Om du ändrar värdet på egenskapen frameRate
för ett Stage-objekt ändrar detta bildrutehastigheten för alla Stage-objekt i innehåll som körs i Adobe AIR (används av olika NativeWindow-objekt).
Implementering
public function get frameRate():Number
public function set frameRate(value:Number):void
Utlöser
SecurityError — Anrop av frameRate -egenskapen för ett Stage-objekt ger ett undantag för varje anropare som inte befinner sig i samma säkerhetssandlåda som Stageägaren (SWF-huvudfilen). För att undvika detta kan Stage-ägaren bevilja anroparens domän tillstånd genom att anropa Security.allowDomain() -metoden eller Security.allowInsecureDomain() -metoden. Ytterligare information finns i kapitlet ”Säkerhet” i Utvecklarhandbok för Adobe ActionScript 3.0.
|
fullScreenHeight | egenskap |
fullScreenHeight:uint
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Returnerar höjden på den bildskärm som ska användas vid helskärmsläge, om läget aktiveras direkt. Om användaren har flera bildskärmar används den bildskärm som störst del av scenen är på vid det tillfället.
Obs: Om användaren kan flytta webbläsaren från en bildskärm till en annan efter att värdet har hämtats men innan helskärmsläget aktiveras kan värdet bli felaktigt. Om du hämtar värdet i en händelsehanterare som ställer in Stage.displayState
på StageDisplayState.FULL_SCREEN
blir värdet korrekt.
Detta är bildskärmens pixelhöjd och det är samma som scenens höjd skulle vara om Stage.align
ställdes in på StageAlign.TOP_LEFT
och Stage.scaleMode
ställdes in på StageScaleMode.NO_SCALE
.
Implementering
public function get fullScreenHeight():uint
Relaterade API-element
fullScreenSourceRect
fullScreenWidth
scaleMode
StageDisplayState
flash.events.Event.RESIZE
flash.events.FullScreenEvent
Exempel ( Så här använder du exemplet )
enterFullScreen()
som ställer in egenskapen fullScreenSourceRect
och aktiverar helskärmsläge. För att ställa in fullScreenSourceRect
-egenskapen börjar händelsehanteraren med den röda fyrkantens plats och mått. Den jämför den röda fyrkantens bildformat (bredden delat med höjden) med scenens bildformat vid helskärmsbredd och -höjd så att rektangeln (fullScreenSourceRect
) kan expanderas så att den matchar skärmens bildformat. Resultatet blir att den röda fyrkanten tar upp hela bildskärmens höjd och den gröna bakgrunden syns på sidorna. Om bildformatet inte hade matchats skulle scenens bakgrundsfärg, som är vit som standard, visas på sidorna i stället för den gröna bakgrunden.
Obs: Testa exemplet i webbläsaren. Välj mallen Endast Flash - Tillåt helskärm på fliken HTML i dialogrutan Publiceringsinställningar i Flash. Ange Flash Player-version 9.0.115.0 och kontrollera att formaten Flash och HTML är markerade på fliken Format. Publicera och öppna HTML-filen som skapas i webbläsaren.
import flash.display.Sprite; import flash.display.Stage; import flash.display.StageDisplayState; import flash.events.MouseEvent; import flash.geom.Rectangle; // cover the stage with a green rectangle var greenRect:Sprite = new Sprite(); greenRect.graphics.beginFill(0x00FF00); greenRect.graphics.drawRect(0, 0, stage.stageWidth, stage.stageHeight); addChild(greenRect); // create red square on stage, turn it into a button for going to full screen var redSquare:Sprite = new Sprite(); redSquare.graphics.beginFill(0xFF0000); redSquare.graphics.drawRect(0, 0, 300, 300); redSquare.x = 50; redSquare.y = 50; redSquare.addEventListener(MouseEvent.CLICK, enterFullScreen); redSquare.buttonMode = true; addChild(redSquare); function enterFullScreen(e:MouseEvent):void { // we will go to full screen zoomed in on the red square var redSquare:Sprite = e.target as Sprite; var fullScreenRect:Rectangle = new Rectangle(redSquare.x, redSquare.y, redSquare.width, redSquare.height); // calculate aspect ratio of the red square var rectAspectRatio:Number = fullScreenRect.width / fullScreenRect.height; // calculate aspect ratio of the screen var screenAspectRatio:Number = stage.fullScreenWidth / stage.fullScreenHeight; // change the fullScreenRect so that it covers the entire screen, keeping it centered on the redSquare // try commenting out this section to see what happens if you do not fix the aspect ratio. if (rectAspectRatio > screenAspectRatio) { var newHeight:Number = fullScreenRect.width / screenAspectRatio; fullScreenRect.y -= ((newHeight - fullScreenRect.height) / 2); fullScreenRect.height = newHeight; } else if (rectAspectRatio < screenAspectRatio) { var newWidth:Number = fullScreenRect.height * screenAspectRatio; fullScreenRect.x -= ((newWidth - fullScreenRect.width) / 2); fullScreenRect.width = newWidth; } // go to full screen stage.fullScreenSourceRect = fullScreenRect; stage.displayState = StageDisplayState.FULL_SCREEN; }
fullScreenSourceRect | egenskap |
fullScreenSourceRect:Rectangle
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Ställer in Flash-miljön på att skala en viss del av scenen till helskärmsläge. Om det går skalar Flash-miljön i maskinvaran, vilket innebär att grafik- och videokort på användarens dator används och att innehållet visas snabbare än vid programvaruskalning.
När den här egenskapen är inställd på en giltig rektangel och egenskapen displayState
är inställd på helskärmsläge skalar Flash-miljön det angivna området. Scenens faktiska storlek i pixlar i ActionScript ändras inte. Flash-miljön tillämpar en lägsta gräns för rektangelns storlek för att standardmeddelandet "Tryck på Esc för att avsluta helskärmsläget" ska få plats. Gränsen är vanligen ungefär 260 gånger 30 pixlar, men den kan variera beroende på plattform och Flash-version.
Den här egenskapen kan bara ställas in när Flash-miljön inte är i helskärmsläge. Ställ in den här egenskapen först och ställ därefter in egenskapen displayState
på helskärmsläge, vilket visas i kodexemplen. Obs! I Flash Player 15 och senare kan den här egenskapen anges även när Flash-miljön är i helskärmsläge.
Aktivera skalning genom att ställa in egenskapen fullScreenSourceRect
på ett rektangelobjekt.
// valid, will enable hardware scaling stage.fullScreenSourceRect = new Rectangle(0,0,320,240);
Inaktivera skalning genom att ställa in egenskapen fullScreenSourceRect=null
i ActionScript 3.0 och undefined
i ActionScript 2.0.
stage.fullScreenSourceRect = null;
Slutanvändaren kan också välja att inaktivera maskinvaruskalning i Flash Players visningsinställningar (alternativet är aktiverat som standard). Mer information finns på www.adobe.com/go/display_settings_se.
Implementering
public function get fullScreenSourceRect():Rectangle
public function set fullScreenSourceRect(value:Rectangle):void
Relaterade API-element
Stage.displayState
Stage.scaleMode
flash.events.FullScreenEvent
flash.events.Event.RESIZE
Exempel ( Så här använder du exemplet )
import flash.geom.*; { stage.fullScreenSourceRect = new Rectangle(0,0,320,240); stage.displayState = StageDisplayState.FULL_SCREEN; }
För att helskärmsläge med maskinvaruskalning ska kunna användas måste följande villkor vara uppfyllda:
- Flash Player 9.0.115.0 eller senare samt ett redigeringsverktyg som har stöd för det behövs.
- HTML-mallar måste modifieras för att hantera helskärmsläge. Attributet
allowFullScreen
måste vara inställt påtrue
för taggarnaobject
ochembed
. (Det skript som genererar taggar för SWF-inbäddning måste också tillåta helskärm.) Information om exempelfiler som kan användas med Flash Builder finns i artikeln Utforska helskärmsläge i Flash Player 9. - Programmet måste ha behörighet för och åtkomst till en FLV-videofil. I det här exemplet antas Flash Video-filen (FLV) finnas i samma katalog som SWF-filen.
- Användaren måste tillåta åtkomst till helskärmsläge.
- Ytterligare information om maskinvaruskalning finns i artikeln Exploring Flash Player support for high-definition H.264 video and AAC audio för Flash Player.
En FLV-fil läses in med objekten NetConnection och NetStream. Eftersom FLV-filen finns i samma katalog som SWF-filen och kommer att ansluta via HTTP, ställs parametern för metoden NetConnection.connect()
in på null
. NetConnection-objektet connect
rapporterar sin status genom att skicka en netStatus
-händelse som anropar metoden netStatusHandler()
. Metoden netStatusHandler()
kontrollerar om anslutningen lyckades och anropar metoden connectStream()
, som skapar ett NetStream-objekt som tar NetConnection-objektet som parameter. Dessutom skapas ett videoobjekt och NetStream-objektet kopplas till videoobjektet. Videoobjektet läggs sedan till i visningslistan och flödet ställs in på uppspelning. Eftersom FLV-videofilen inte innehåller information om metadata eller referenspunkter skickas en AsyncError
-händelse. En avlyssnare måste ställas in för att hantera händelsen. Här skapas avlyssnaren och den ignorerar händelsen. En annan avlyssnare för netStatus
-händelsen skapas också för NetStream-objektet. Den visar ett felmeddelande om flödet inte hittas. (Observera att netStatusHandler()
skulle kunna användas för att hantera ett obegränsat antal olika statusmeddelanden som rapporteras för flödet eller anslutningen.)
När egenskaperna och metoderna i en inläst SWF-fil är tillgängliga anropas metoden createMouseListener()
. Den skapar en händelseavlyssnare som registrerar när musen klickas över scenen. Metoden toggleFullScreen()
kontrollerar om visningsläget är helskärm eller normal. Om det är normal ändras videoobjektets storlek till videoflödets storlek. Egenskapen fullScreenSourceRect
ställs in på en rektangel som matchar videoobjektets mått. Egenskapen Stage.displayMode
ställs in på helskärm, vilket gör att videon i källrektangeln expanderar så att hela skärmen täcks. Om systemkraven är uppfyllda används datorns grafikmaskinvara för att förbättra prestanda för videoåtergivningen i helskärm och visningsläget ställs in på helskärm. Ett try...catch
-block används för att hantera eventuella säkerhetsfel som kan uppstå när visningen växlas till helskärmsläge. (Observera att visningsläget måste ställas in på helskärmsläge efter att egenskapen fullScreenSourceRect
ställs in.) Innan videoobjektet övergår till normalläge återställs dess bredd och höjd till det sparade ursprungliga videoobjektets bredd och höjd. Annars skulle ändringar som gjorts i videoobjektet för helskärmsläge avgöra objektets bredd och höjd.
package { import flash.display.Sprite; import flash.display.StageDisplayState; import flash.media.Video; import flash.net.NetConnection; import flash.net.NetStream; import flash.events.NetStatusEvent; import flash.events.AsyncErrorEvent; import flash.events.SecurityErrorEvent; import flash.events.MouseEvent; import flash.events.Event; import flash.geom.Rectangle; public class Stage_fullScreenSourceRectExample2 extends Sprite { private var videoURL:String = "testVideo1.flv"; private var connection:NetConnection; private var stream:NetStream; private var myVideo:Video; private var savedWidth:uint; private var savedHeight:uint; public function Stage_fullScreenSourceRectExample2() { connection = new NetConnection(); connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); connection.connect(null); loaderInfo.addEventListener(Event.INIT, createMouseListener); } private function createMouseListener(event:Event):void { stage.addEventListener(MouseEvent.CLICK, toggleFullScreen); } private function toggleFullScreen(event:MouseEvent):void { if(stage.displayState == StageDisplayState.NORMAL) { myVideo.width = myVideo.videoWidth; myVideo.height = myVideo.videoHeight; try { stage.fullScreenSourceRect = new Rectangle(myVideo.x, myVideo.y, myVideo.width, myVideo.height); stage.displayState = StageDisplayState.FULL_SCREEN; } catch (e:SecurityError) { trace ("A security error occurred while switching to full screen: " + event); myVideo.width = savedWidth; myVideo.height = savedHeight; } }else { myVideo.width = savedWidth; myVideo.height = savedHeight; stage.displayState = StageDisplayState.NORMAL; } } private function netStatusHandler(event:NetStatusEvent):void { switch (event.info.code) { case "NetConnection.Connect.Success": connectStream(); break; case "NetStream.Play.StreamNotFound": trace ("Unable to locate video: " + videoURL); break; } } private function connectStream():void { var stream:NetStream = new NetStream(connection); stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); stream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); myVideo = new Video(); myVideo.attachNetStream(stream); stream.play(videoURL); savedWidth = myVideo.width; savedHeight = myVideo.height; addChild(myVideo); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } private function asyncErrorHandler(event:AsyncErrorEvent):void { } } }
fullScreenWidth | egenskap |
fullScreenWidth:uint
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Returnerar bredden på den bildskärm som ska användas vid helskärmsläge, om läget aktiveras direkt. Om användaren har flera bildskärmar används den bildskärm som störst del av scenen är på vid det tillfället.
Obs: Om användaren kan flytta webbläsaren från en bildskärm till en annan efter att värdet har hämtats men innan helskärmsläget aktiveras kan värdet bli felaktigt. Om du hämtar värdet i en händelsehanterare som ställer in Stage.displayState
på StageDisplayState.FULL_SCREEN
blir värdet korrekt.
Detta är bildskärmens pixelbredd och det är samma som scenens bredd skulle vara om Stage.align
ställdes in på StageAlign.TOP_LEFT
och Stage.scaleMode
ställdes in på StageScaleMode.NO_SCALE
.
Implementering
public function get fullScreenWidth():uint
Relaterade API-element
fullScreenHeight
fullScreenSourceRect
scaleMode
StageDisplayState
flash.events.Event.RESIZE
flash.events.FullScreenEvent
Exempel ( Så här använder du exemplet )
enterFullScreen()
som ställer in egenskapen fullScreenSourceRect
och aktiverar helskärmsläge. För att ställa in fullScreenSourceRect
-egenskapen börjar händelsehanteraren med den röda fyrkantens plats och mått. Den jämför den röda fyrkantens bildformat (bredden delat med höjden) med scenens bildformat vid helskärmsbredd och -höjd så att rektangeln (fullScreenSourceRect
) kan expanderas så att den matchar skärmens bildformat. Resultatet blir att den röda fyrkanten tar upp hela bildskärmens höjd och den gröna bakgrunden syns på sidorna. Om bildformatet inte hade matchats skulle scenens bakgrundsfärg, som är vit som standard, visas på sidorna i stället för den gröna bakgrunden.
Obs: Testa exemplet i webbläsaren. Välj mallen Endast Flash - Tillåt helskärm på fliken HTML i dialogrutan Publiceringsinställningar i Flash. Ange Flash Player-version 9.0.115.0 och kontrollera att formaten Flash och HTML är markerade på fliken Format. Publicera och öppna HTML-filen som skapas i webbläsaren.
import flash.display.Sprite; import flash.display.Stage; import flash.display.StageDisplayState; import flash.events.MouseEvent; import flash.geom.Rectangle; // cover the stage with a green rectangle var greenRect:Sprite = new Sprite(); greenRect.graphics.beginFill(0x00FF00); greenRect.graphics.drawRect(0, 0, stage.stageWidth, stage.stageHeight); addChild(greenRect); // create red square on stage, turn it into a button for going to full screen var redSquare:Sprite = new Sprite(); redSquare.graphics.beginFill(0xFF0000); redSquare.graphics.drawRect(0, 0, 300, 300); redSquare.x = 50; redSquare.y = 50; redSquare.addEventListener(MouseEvent.CLICK, enterFullScreen); redSquare.buttonMode = true; addChild(redSquare); function enterFullScreen(e:MouseEvent):void { // we will go to full screen zoomed in on the red square var redSquare:Sprite = e.target as Sprite; var fullScreenRect:Rectangle = new Rectangle(redSquare.x, redSquare.y, redSquare.width, redSquare.height); // calculate aspect ratio of the red square var rectAspectRatio:Number = fullScreenRect.width / fullScreenRect.height; // calculate aspect ratio of the screen var screenAspectRatio:Number = stage.fullScreenWidth / stage.fullScreenHeight; // change the fullScreenRect so that it covers the entire screen, keeping it centered on the redSquare // try commenting out this section to see what happens if you do not fix the aspect ratio. if (rectAspectRatio > screenAspectRatio) { var newHeight:Number = fullScreenRect.width / screenAspectRatio; fullScreenRect.y -= ((newHeight - fullScreenRect.height) / 2); fullScreenRect.height = newHeight; } else if (rectAspectRatio < screenAspectRatio) { var newWidth:Number = fullScreenRect.height * screenAspectRatio; fullScreenRect.x -= ((newWidth - fullScreenRect.width) / 2); fullScreenRect.width = newWidth; } // go to full screen stage.fullScreenSourceRect = fullScreenRect; stage.displayState = StageDisplayState.FULL_SCREEN; }
height | egenskap |
height:Number
[åsidosätt] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Anger visningsobjektets höjd i pixlar. Höjden beräknas baserat på gränserna för innehållet i visningsobjektet. När du anger height
-egenskapen justerasscaleY
-egenskapen in därefter så som visas i följande kod:
var rect:Shape = new Shape(); rect.graphics.beginFill(0xFF0000); rect.graphics.drawRect(0, 0, 100, 100); trace(rect.scaleY) // 1; rect.height = 200; trace(rect.scaleY) // 2;
Förutom för objekten TextField och Video har ett visningsobjekt utan innehåll (t.ex. en tom sprite) en höjd på 0, även om du försöker ange height
till ett annat värde.
Implementering
override public function get height():Number
override public function set height(value:Number):void
Utlöser
SecurityError — Referens till height -egenskapen för ett Stage-objekt ger ett undantag för varje anropare som inte befinner sig i samma säkerhetssandlåda som Stageägaren (SWF-huvudfilen). För att undvika detta kan Stage-ägaren bevilja anroparens domän tillstånd genom att anropa Security.allowDomain() -metoden eller Security.allowInsecureDomain() -metoden. Ytterligare information finns i kapitlet ”Säkerhet” i Utvecklarhandbok för Adobe ActionScript 3.0.
| |
IllegalOperationError — Det är aldrig tillåtet att ställa in height -egenskapen för ett Stage-objekt, även om det anropande objektet är Stage-ägaren (SWF-huvudfilen).
|
mouseChildren | egenskap |
mouseChildren:Boolean
[åsidosätt] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Avgör om objektets underordnade objekt är aktiverade för en mus eller annan användarindataenhet (eller inte). Om ett objekt är aktiverat kan användaren interagera med det via en mus eller annan användarindataenhet. Standardvärdet är true
.
Denna egenskap är användbar när du skapar en knapp med en Sprite-klassinstans (i stället för att använda SimpleButton-klassen). När du använder en Sprite-instans för att skapa en knapp kan du välja att dekorera knappen genom att använda addChild()
-metoden för att lägga till ytterligare Sprite-instanser. Denna process kan leda till oväntat beteende med mushändelser eftersom de Sprite-instanser du lägger till som underordnade kan bli målobjektet för en mushändelse när du förväntar dig att den överordnade instansen ska vara målobjektet. För att säkerställa att den överordnade instansen används som målobjekt för mushändelser kan du sätta mouseChildren
-egenskapen för den överordnade instansen till false
.
Ingen händelse skickas när denna egenskap sätts. Du måste använda addEventListener()
-metoden för att skapa interaktiv funktionalitet.
Implementering
override public function get mouseChildren():Boolean
override public function set mouseChildren(value:Boolean):void
Utlöser
SecurityError — Referens till mouseChildren -egenskapen för ett Stage-objekt ger ett undantag för varje anropare som inte befinner sig i samma säkerhetssandlåda som Stageägaren (SWF-huvudfilen). För att undvika detta kan Stage-ägaren bevilja anroparens domän tillstånd genom att anropa Security.allowDomain() -metoden eller Security.allowInsecureDomain() -metoden. Ytterligare information finns i kapitlet ”Säkerhet” i Utvecklarhandbok för Adobe ActionScript 3.0.
|
mouseLock | egenskap |
mouseLock:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 11.2, AIR 3.2 |
Ange som true
för att aktivera låsning av musen. Om du låser musen inaktiveras markören och obegränsade musrörelser aktiveras. Du kan bara aktivera låsning av musen i helskärmsläge för skrivbordsprogram. Om du anger det på program som inte är i helskärmsläge, eller program på mobila enheter, genereras ett undantagsfel.
Låsning av musen inaktiveras automatiskt och markören blir synlig igen när:
- Användaren avslutar helskärmsläget med Esc-tangenten (alla plattformar), Ctrl-W (Windows), Cmd-W (Mac) eller Alt-F4 (Windows).
- Programfönstret förlorar fokus.
- Eventuella inställningsgränssnitt är synliga, inklusive alla dialogrutor för sekretess.
- En systemspecifik dialogruta visas, t.ex. en dialogruta för filöverföring.
När helskärmsläget avslutas anges den här egenskapen automatiskt till false
.
Händelser som är kopplade till musrörelser, som mouseMove
-händelsen, använder klassen MouseEvent för att representera händelseobjektet. När låsning av musen är inaktiverat använder du egenskaperna MouseEvent.localX
och MouseEvent.localY
för att fastställa var musen finns. När låsning av musen är aktiverat använder du egenskaperna MouseEvent.movementX
och MouseEvent.movementY
för att fastställa var musen finns. Egenskaperna movementX
och movementY
innehåller förändringar av musens position sedan den senaste händelsen, i stället för absoluta koordinater för musens position.
Obs! När programmet är i helskärmsläge skickas inte mushändelseavlyssnare som är kopplade till andra visningsobjekt än Stage. Om du vill få musskillnader (deltavärden) och andra mushändelser när mouseLock
är true
måste du därför koppla mushändelseavlyssnare till Stage-objektet.
Implementering
public function get mouseLock():Boolean
public function set mouseLock(value:Boolean):void
Relaterade API-element
nativeWindow | egenskap |
nativeWindow:NativeWindow
[skrivskyddad] Körningsmiljöversioner: | AIR 1.0, Flash Lite 4 |
En referens till NativeWindow-objektet som innehåller denna scen.
Fönstret representerar ett inbyggt fönster i operativsystemet. Scenen representerar innehållet som finns i fönstret. Den här egenskapen är bara giltig för innehåll som körs i AIR på plattformar med stöd för klassen NativeWindow. På andra plattformar är den här egenskapen null
. I Flash Player (innehåll som körs i en webbläsare) är den här egenskapen också null
.
Implementering
public function get nativeWindow():NativeWindow
numChildren | egenskap |
numChildren:int
[skrivskyddad] [åsidosätt] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Returnerar antalet underordnade objekt det här objektet har.
Implementering
override public function get numChildren():int
Utlöser
SecurityError — Referens till numChildren -egenskapen för ett Stage-objekt ger ett undantag för varje anropare som inte befinner sig i samma säkerhetssandlåda som Stageägaren (SWF-huvudfilen). För att undvika detta kan Stage-ägaren bevilja anroparens domän tillstånd genom att anropa Security.allowDomain() -metoden eller Security.allowInsecureDomain() -metoden. Ytterligare information finns i kapitlet ”Säkerhet” i Utvecklarhandbok för Adobe ActionScript 3.0.
|
orientation | egenskap |
orientation:String
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2 |
Scenens aktuella orientering. Den här egenskapen är inställd på ett av fyra värden som definieras som konstanter i StageOrientation-klassen:
StageOrientation-konstant | Scenorientering |
---|---|
StageOrientation.DEFAULT | Scenen har standardorientering (rättvänd) |
StageOrientation.ROTATED_RIGHT | Scenen roteras åt höger. |
StageOrientation.ROTATED_LEFT | Scenen roteras åt vänster. |
StageOrientation.UPSIDE_DOWN | Scenen vänds upp och ned. |
StageOrientation.UNKNOWN | Programmet har inte fastställt skärmens inledande orientering än. Du kan lägga till en händelseavlyssnare för orientationChange -händelsen |
Du använder metoden setOrientation()
för att ställa in scenorienteringen.
Viktigt! Egenskapen orientation har stöd på Android-enheter från och med namnrymden 2.6.
Implementering
public function get orientation():String
Relaterade API-element
quality | egenskap |
quality:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ett värde från klassen StageQuality som anger vilken återgivningskvalitet som ska användas. Dessa värden är giltiga:
StageQuality.LOW
– Låg återgivningskvalitet. Grafiken är inte kantutjämnad och bitmappar jämnas inte ut, men körningsmiljöerna använder fortfarande mipmappning.StageQuality.MEDIUM
– Medelhög återgivningskvalitet. Grafiken kantutjämnas med ett 2 x 2 pixelrutnät och bitmappsutjämning är beroende avBitmap.smoothing
-inställningen. Körningsmiljöer använder mipmapping. Den här inställningen passar filmer som inte innehåller text.StageQuality.HIGH
– Hög återgivningskvalitet. Grafiken kantutjämnas med ett 4 x 4 pixelrutnät och bitmappsutjämning är beroende avBitmap.smoothing
-inställningen. Körningsmiljöer använder mipmapping. Detta är standardinställningen för återgivningskvalitet i Flash Player.StageQuality.BEST
– Mycket hög återgivningskvalitet. Grafik kantutjämnas med ett 4 x 4 pixelrutnät. OmBitmap.smoothing
ärtrue
använder körningsmiljön en nedskalningsalgoritm av hög kvalitet som producerar färre defekter (att användaStageQuality.BEST
medBitmap.smoothing
inställt påtrue
försämrar dock prestandan avsevärt, det är inte en inställning som rekommenderas).
Högre kvalitetsinställningar ger bättre återgivning av skalade bitmappar. Högre kvalitetsinställningar är dock beräkningsmässigt dyrare. Om du använder högre kvalitetsinställningar vid återgivning av skalad video kan det minska bildrutehastigheten.
Metoden BitmapData.draw()
använder värdet på egenskapen Stage.quality
. Du kan också använda metoden BitmapData.drawWithQuality()
, med vilken du kan ange parametern quality
för metoden och ignorera det aktuella värdet på Stage.quality
.
I skrivbordsprofilen för Adobe AIR kan quality
ställas in på StageQuality.BEST
eller StageQuality.HIGH
(standardvärdet är StageQuality.HIGH
). Att ställa in ett annat värde har ingen effekt (och egenskapen är fortsatt oförändrad). I AIR:s mobilprofil finns alla fyra inställningarna. Standardvärdet för mobilenheter är StageQuality.MEDIUM
.
Om du ställer in quality
-egenskapen för ett Stage-objekt ändrar detta återgivningskvaliteten för alla Stage-objekt i innehåll som körs i Adobe AIR (används av olika NativeWindow-objekt).
quality
-egenskapen.
Implementering
public function get quality():String
public function set quality(value:String):void
Utlöser
SecurityError — Anrop av quality -egenskapen för ett Stage-objekt ger ett undantag för varje anropare som inte befinner sig i samma säkerhetssandlåda som Stageägaren (SWF-huvudfilen). För att undvika detta kan Stage-ägaren bevilja anroparens domän tillstånd genom att anropa Security.allowDomain() -metoden eller Security.allowInsecureDomain() -metoden. Ytterligare information finns i kapitlet ”Säkerhet” i Utvecklarhandbok för Adobe ActionScript 3.0.
|
Relaterade API-element
scaleMode | egenskap |
scaleMode:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ett värde från klassen StageScaleMode som anger vilket skalningsläge som ska användas. Dessa värden är giltiga:
StageScaleMode.EXACT_FIT
– Hela programmet syns i det angivna området utan att det ursprungliga bildformatet bevaras. Förvrängning kan uppstå och programmet kan visas utdraget eller ihopdraget.StageScaleMode.SHOW_ALL
– Hela programmet syns utan förvrängning i det angivna området, samtidigt som programmets ursprungliga bildformat bevaras. Kantlinjer kan visas på programmets sidor.StageScaleMode.NO_BORDER
– Hela programmet fyller ut det angivna området, utan förvrängning men eventuellt med beskärning, samtidigt som programmets ursprungliga bildformat bevaras.StageScaleMode.NO_SCALE
– Hela programmet låses så att det inte ändras även om spelarfönstrets storlek ändras. Beskärning kan förekomma om spelarfönstret är mindre än Flash-innehållet.
Implementering
public function get scaleMode():String
public function set scaleMode(value:String):void
Utlöser
SecurityError — Anrop av scaleMode -egenskapen för ett Stage-objekt ger ett undantag för varje anropare som inte befinner sig i samma säkerhetssandlåda som Stageägaren (SWF-huvudfilen). För att undvika detta kan Stage-ägaren bevilja anroparens domän tillstånd genom att anropa Security.allowDomain() -metoden eller Security.allowInsecureDomain() -metoden. Ytterligare information finns i kapitlet ”Säkerhet” i Utvecklarhandbok för Adobe ActionScript 3.0.
|
Relaterade API-element
showDefaultContextMenu | egenskap |
showDefaultContextMenu:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Anger om standardalternativen på snabbmenyn i Flash-miljön ska visas eller döljas.
Om showDefaultContextMenu
-egenskapen sätts till true
(standardinställningen) visas alla alternativ på snabbmenyn. Om showDefaultContextMenu
-egenskapen sätts till false
visas bara menyalternativen för Inställningar och Om...
Implementering
public function get showDefaultContextMenu():Boolean
public function set showDefaultContextMenu(value:Boolean):void
Utlöser
SecurityError — Anrop av showDefaultContextMenu -egenskapen för ett Stage-objekt ger ett undantag för varje anropare som inte befinner sig i samma säkerhetssandlåda som Stageägaren (SWF-huvudfilen). För att undvika detta kan Stage-ägaren bevilja anroparens domän tillstånd genom att anropa Security.allowDomain() -metoden eller Security.allowInsecureDomain() -metoden. Ytterligare information finns i kapitlet ”Säkerhet” i Utvecklarhandbok för Adobe ActionScript 3.0.
|
softKeyboardRect | egenskap |
softKeyboardRect:Rectangle
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2.6, Flash Player 10.2 |
En rektangel som anger den del av scenen som för tillfället upptas av ett skärmtangentbord. Rektangelns komponenter är (0,0,0,0) när skärmtangentbordet inte visas.
Implementering
public function get softKeyboardRect():Rectangle
Relaterade API-element
stage3Ds | egenskap |
stage3Ds:Vector.<Stage3D>
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 11, AIR 3 |
En lista med Stage3D-objekt som är tillgängliga för att visa 3-dimensionellt innehåll.
Du kan bara använda ett begränsat antal Stage3D-objekt i taget. Antalet tillgängliga Stage3D-objekt beror på plattformen och tillgänglig maskinvara.
Ett Stage3D-objekt ritas framför ett StageVideo-objekt och bakom Flash visningslista.
Implementering
public function get stage3Ds():Vector.<Stage3D>
Relaterade API-element
stageFocusRect | egenskap |
stageFocusRect:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Anger om objekt visas med en lysande kantlinje när de är i fokus eller inte.
Implementering
public function get stageFocusRect():Boolean
public function set stageFocusRect(value:Boolean):void
Utlöser
SecurityError — Anrop av stageFocusRect -egenskapen för ett Stage-objekt ger ett undantag för varje anropare som inte befinner sig i samma säkerhetssandlåda som Stageägaren (SWF-huvudfilen). För att undvika detta kan Stage-ägaren bevilja anroparens domän tillstånd genom att anropa Security.allowDomain() -metoden eller Security.allowInsecureDomain() -metoden. Ytterligare information finns i kapitlet ”Säkerhet” i Utvecklarhandbok för Adobe ActionScript 3.0.
|
stageHeight | egenskap |
stageHeight:int
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Anger scenens höjd i pixlar.
Om värdet på egenskapen Stage.scaleMode
anges till StageScaleMode.NO_SCALE
när användaren ändrar storlek på fönstret behåller sceninnehållet sin definierade storlek, medan egenskapen stageHeight
ändras så att den visar den nya höjden på det skärmområde som upptas av SWF-filen. (I andra skalningslägen visar stageHeight
-egenskapen originalbredden på SWF-filen.) Du kan lägga till en händelseavlyssnare för resize
-händelsen och sedan använda stageHeight
-egenskapen i Stage-klassen för att avgöra den faktiska pixeldimensionen på det storleksändrade fönstret i Flash-miljön. Händelseavlyssnare gör att du kan styra hur skärminnehållet justeras när användaren ändrar storlek på fönstret.
Enheter med AIR for TV skiljer sig något från klientenheter när du anger egenskapen stageHeight
. Om egenskapen Stage.scaleMode
ställs in på StageScaleMode.NO_SCALE
, och du anger egenskapen stageHeight
, ändras scenens höjd inte förrän vid nästa bildruta i SWF-filen.
Obs! I en HTML-sida med SWF-filen måste både object
- och embed
-taggarnas height
-attribut ställas in på ett procenttal (till exempel 100 %
), inte på pixlar. Om inställningarna skapas av JavaScript-kod måste parametern height
för metoden AC_FL_RunContent()
också anges till ett procenttal. Detta procenttal används i stageHeight
-värdet.
Implementering
public function get stageHeight():int
public function set stageHeight(value:int):void
Utlöser
SecurityError — Anrop av stageHeight -egenskapen för ett Stage-objekt ger ett undantag för varje anropare som inte befinner sig i samma säkerhetssandlåda som Stageägaren (SWF-huvudfilen). För att undvika detta kan Stage-ägaren bevilja anroparens domän tillstånd genom att anropa Security.allowDomain() -metoden eller Security.allowInsecureDomain() -metoden. Ytterligare information finns i kapitlet ”Säkerhet” i Utvecklarhandbok för Adobe ActionScript 3.0.
|
Relaterade API-element
stageVideos | egenskap |
stageVideos:Vector.<StageVideo>
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2.5, Flash Player 10.2 |
En lista över StageVideo-objekt som är tillgängliga för uppspelning av extern video.
Du kan bara använda ett begränsat antal StageVideo-objekt i taget. När en SWF-fil börjar spelas beror antalet tillgängliga StageVideo-objekt på plattformen och den tillgängliga maskinvaran.
Om du vill använda ett StageVideo-objekt tilldelar du en medlem av Vector-objektet stageVideos
till en StageVideo-variabel.
Alla StageVideo-objekt visas på scenen bakom eventuella visningsobjekt. StageVideo-objekt visas på scenen i den ordning de har i Vector-objektet stageVideos
. Om Vector-objektet stageVideos
till exempel innehåller tre poster:
- StageVideo-objektet vid index 0 i Vector-objektet
stageVideos
visas bakom alla StageVideo-objekt. - StageVideo-objektet vid index 1 visas framför StageVideo-objektet vid index 0.
- StageVideo-objektet vid index 2 visas framför StageVideo-objektet vid index 1.
Använd egenskapen StageVideo.depth
om du vill ändra den här ordningen.
Obs! Enheter med AIR for TV har bara stöd för ett StageVideo-objekt.
Implementering
public function get stageVideos():Vector.<StageVideo>
Relaterade API-element
Exempel ( Så här använder du exemplet )
var stageVideo:StageVideo; if ( stage.stageVideos.length >= 1 ) { stageVideo = stage.stageVideos[0]; }
stageWidth | egenskap |
stageWidth:int
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Anger scenens bredd i pixlar.
Om värdet på egenskapen Stage.scaleMode
ändras till StageScaleMode.NO_SCALE
när användaren ändrar storlek på fönstret behåller sceninnehållet sin definierade storlek medan egenskapen stageWidth
ändras så att den visar den nya bredden på det skärmområde som upptas av SWF-filen. (I andra skalningslägen visar stageWidth
-egenskapen originalbredden på SWF-filen.) Du kan lägga till en händelseavlyssnare för resize
-händelsen och sedan använda stageWidth
-egenskapen i Stage-klassen för att avgöra den faktiska pixeldimensionen på det storleksändrade fönstret i Flash-miljön. Händelseavlyssnare gör att du kan styra hur skärminnehållet justeras när användaren ändrar storlek på fönstret.
Enheter med AIR for TV skiljer sig något från klientenheter när du anger egenskapen stageWidth
. Om egenskapen Stage.scaleMode
ställs in på StageScaleMode.NO_SCALE
, och du anger egenskapen stageWidth
, ändras scenens bredd inte förrän vid nästa bildruta i SWF-filen.
Obs! I en HTML-sida med SWF-filen måste både object
- och embed
-taggarnas width
-attribut ställas in på ett procenttal (till exempel 100 %
), inte på pixlar. Om inställningarna skapas av JavaScript-kod måste parametern width
för metoden AC_FL_RunContent()
också anges till ett procenttal. Detta procenttal används i stageWidth
-värdet.
Implementering
public function get stageWidth():int
public function set stageWidth(value:int):void
Utlöser
SecurityError — Anrop av stageWidth -egenskapen för ett Stage-objekt ger ett undantag för varje anropare som inte befinner sig i samma säkerhetssandlåda som Stageägaren (SWF-huvudfilen). För att undvika detta kan Stage-ägaren bevilja anroparens domän tillstånd genom att anropa Security.allowDomain() -metoden eller Security.allowInsecureDomain() -metoden. Ytterligare information finns i kapitlet ”Säkerhet” i Utvecklarhandbok för Adobe ActionScript 3.0.
|
Relaterade API-element
supportedOrientations | egenskap |
supportedOrientations:Vector.<String>
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2.6 |
De orienteringar som stöds av den aktuella enheten.
Du kan använda de orienteringssträngar som ingår i den här listan som parametrar för metoden setOrientation()
. Om en orientering som saknar stöd ställs in misslyckas det utan fel.
Möjliga orienteringar omfattar:
StageOrientation-konstant | Scenorientering |
---|---|
StageOrientation.DEFAULT | Ställer in scenorienteringen på standardorienteringen (rättvänd). |
StageOrientation.ROTATED_RIGHT | Ställer in att scenorienteringen ska roteras åt höger. |
StageOrientation.ROTATED_LEFT | Ställer in att scenorienteringen ska roteras åt vänster. |
StageOrientation.UPSIDE_DOWN | Ställer in att scenorienteringen ska vändas upp och ned. |
Implementering
public function get supportedOrientations():Vector.<String>
Relaterade API-element
supportsOrientationChange | egenskap |
supportsOrientationChange:Boolean
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2 |
Om programmet har stöd för ändringar av scenens orientering (och enhetsrotation). Den här egenskapen är för tillfället bara true
i AIR-program som körs på mobilenheter.
Implementering
public static function get supportsOrientationChange():Boolean
Relaterade API-element
tabChildren | egenskap |
tabChildren:Boolean
[åsidosätt] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Avgör om objektets underordnade objekt är tabbaktiverade. Aktiverar eller inaktiverar tabbar för objektets underordnade. Standardvärdet är true
.
Obs! Använd inte egenskapen tabChildren
med Flex. Använd egenskapen mx.core.UIComponent.hasFocusableChildren
i stället.
Implementering
override public function get tabChildren():Boolean
override public function set tabChildren(value:Boolean):void
Utlöser
SecurityError — Referens till tabChildren -egenskapen för ett Stage-objekt ger ett undantag för varje anropare som inte befinner sig i samma säkerhetssandlåda som Stageägaren (SWF-huvudfilen). För att undvika detta kan Stage-ägaren bevilja anroparens domän tillstånd genom att anropa Security.allowDomain() -metoden eller Security.allowInsecureDomain() -metoden. Ytterligare information finns i kapitlet ”Säkerhet” i Utvecklarhandbok för Adobe ActionScript 3.0.
|
textSnapshot | egenskap |
textSnapshot:flash.text:TextSnapshot
[skrivskyddad] [åsidosätt] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Returnerar ett TextSnapshot-objekt för den här DisplayObjectContainer-instansen.
Implementering
override public function get textSnapshot():flash.text:TextSnapshot
Utlöser
IllegalOperationError — Att referera textSnapshot -egenskapen för ett Stage-objekt ger ett undantag eftersom Stage-klassen inte implementerar denna egenskap. För att undvika detta anropar man textSnapshot -egenskapen för en annan visningsobjektbehållare än Stage-objektet.
|
vsyncEnabled | egenskap |
vsyncEnabled:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 29.0 |
Detta representerar det aktuella tillståndet för vsync i den underliggande grafiklösningen. Vi kan aktivera/inaktivera vsync så vi kan rendera omedelbart utan att vänta på nästa VSYNC-tillstånd. Egenskapen kan läsas när som helst. Det går endast att ställa in egenskapen efter det att VsyncStateChangeAvailabilityEvent har utlösts.
Implementering
public function get vsyncEnabled():Boolean
public function set vsyncEnabled(value:Boolean):void
width | egenskap |
width:Number
[åsidosätt] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Anger visningsobjektets bredd i pixlar. Bredden beräknas baserat på gränserna för innehållet i visningsobjektet. När du anger width
-egenskapen justerasscaleX
-egenskapen in därefter så som visas i följande kod:
var rect:Shape = new Shape(); rect.graphics.beginFill(0xFF0000); rect.graphics.drawRect(0, 0, 100, 100); trace(rect.scaleX) // 1; rect.width = 200; trace(rect.scaleX) // 2;
Förutom för objekten TextField och Video har ett visningsobjekt utan innehåll (t.ex. en tom sprite) en bredd på 0, även om du försöker ange width
till ett annat värde.
Implementering
override public function get width():Number
override public function set width(value:Number):void
Utlöser
SecurityError — Referens till width -egenskapen för ett Stage-objekt ger ett undantag för varje anropare som inte befinner sig i samma säkerhetssandlåda som Stageägaren (SWF-huvudfilen). För att undvika detta kan Stage-ägaren bevilja anroparens domän tillstånd genom att anropa Security.allowDomain() -metoden eller Security.allowInsecureDomain() -metoden. Ytterligare information finns i kapitlet ”Säkerhet” i Utvecklarhandbok för Adobe ActionScript 3.0.
| |
IllegalOperationError — Det är aldrig tillåtet att sätta width -egenskapen för ett Stage-objekt, ens om du är Stage-ägare.
|
wmodeGPU | egenskap |
wmodeGPU:Boolean
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.0.32, AIR 1.5.2, Flash Lite 4 |
Anger om GPU-sammansättning är tillgänglig och i så fall om det används. Värdet wmodeGPU
är bara
true när alla de tre villkoren nedan är uppfyllda:
- GPU-sammansättning har begärts.
- GPU-sammansättning är tillgängligt.
- GPU-sammansättning används.
Egenskapen wmodeGPU
anger i synnerhet något av följande:
- GPU-sammansättning har inte begärts eller är inte tillgängligt. I sådana fall är
wmodeGPU
-egenskapsvärdetfalse
. - GPU-sammansättning har begärts (om det är tillämpligt och tillgängligt), men miljön fungerar i "reservläge" (ej optimal återgivning) på grund av begränsningar i innehållet. I sådana fall är
wmodeGPU
-egenskapsvärdettrue
. - GPU-sammansättning har begärts (om det är tillämpligt och tillgängligt) och miljön fungerar i bästa möjliga läge. I sådana fall är
wmodeGPU
-egenskapsvärdet ocksåtrue
.
Egenskapen wmodeGPU
identifierar med andra ord återgivningsmiljöns funktioner och tillstånd. För miljöer som inte har stöd för GPU-sammansättning, t.ex. AIR 1.5.2, är värdet alltid false
eftersom (så som anges ovan) värdet endast är true
när GPU-sammansättning har begärts, är tillgängligt och används.
Egenskapen wmodeGPU
är praktisk att använda vid körningstid för att avgöra om GPU-sammansättning används. Värdet för wmodeGPU
anger om innehållet kan skalas av maskinvaran eller inte så att grafik kan presenteras med rätt storlek. Du kan även avgöra om återgivning sker i en snabb bana eller inte så att du kan justera innehållets komplexitetsgrad därefter.
För Flash Player i en webbläsare kan GPU-sammansättning begäras med värdet gpu
för HTML-parametern wmode
på sidan som är värd för SWF-filen. För andra konfigurationer kan GPU-sammansättning begäras i SWF-filens rubrik (ställs in med SWF-redigeringsverktygen).
Egenskapen wmodeGPU
identifierar dock inte den aktuella återgivningsprestandan. Även om GPU-sammansättning används, kanske återgivningsprocessen inte fungerar i bästa möjliga läge. Använd en felsökningsversion för Flash-miljön och ställ in DisplayGPUBlendsetting
i mm.cfg-filen om du vill justera innehållet för optimal återgivning.
Obs! Egenskapen är alltid false
när den refereras till av ActionScript som körs innan miljön utför sitt första återgivningspass. Om du t.ex. studerar wmodeGPU
i ett skript i bildruta 1 i Adobe Flash Professional och SWF-filen är den första SWF-filen som läses in i en ny instans i miljön, är värdet wmodeGPU
false
. Vänta tills minst ett återgivningspass har utförts för att få rätt värde. Om du skriver en händelseavlyssnare för händelsen exitFrame
för ett DisplayObject
får wmodeGPU
rätt värde.
Implementering
public function get wmodeGPU():Boolean
Relaterade API-element
Exempel ( Så här använder du exemplet )
wmodeGPU
efter det att visningsobjektet mySprite har återgetts så att du får rätt värde.
mySprite.addEventListener(EXIT_FRAME, exithandler): function exithandler(exiteventobject:Event):void { trace(stage.wmodeGPU); }
addChild | () | metod |
override public function addChild(child:DisplayObject):DisplayObject
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Lägger till en underordnad DisplayObject-instans i den här DisplayObjectContainer-instansen. Den underordnade läggs till framför (över) alla andra underordnade i denna DisplayObjectContainer-instans. (För att lägga till en underordnad till en specifik indexposition använder man addChildAt()
-metoden.)
Om du lägger till ett underordnat objekt som redan har en annan visningsobjektbehållare som överordnad tas objektet bort från det andra visningsobjektets lista med underordnade.
Obs! Kommandot stage.addChild()
kan orsaka problem med en publicerad SWF-fil, bl.a. säkerhetsproblem och konflikter med andra inlästa SWF-filer. Det finns bara en scen i en Flash-miljöinstans, oavsett hur många SWF-filer som läses in till miljön. Objekt bör därför egentligen aldrig läggas till direkt på scenen. Det enda objekt som bör finnas på scenen är rotobjektet. Skapa ett DisplayObjectContainer-objekt som ska innehålla alla objekt i visningslistan. Om det behövs lägger du därefter till den DisplayObjectContainer-instansen på scenen.
Parametrar
child:DisplayObject — Den DisplayObject-instans som ska läggas till som underordnad till denna DisplayObjectContainer-instans.
|
DisplayObject — Den DisplayObject-instans som du skickar i child -parametern.
|
Utlöser
SecurityError — Anrop av addChild() -metoden för ett Stage-objekt ger ett undantag för varje anropare som inte befinner sig i samma säkerhetssandlåda som Stageägaren (SWF-huvudfilen). För att undvika detta kan Stage-ägaren bevilja anroparens domän tillstånd genom att anropa Security.allowDomain() -metoden eller Security.allowInsecureDomain() -metoden. Ytterligare information finns i kapitlet ”Säkerhet” i Utvecklarhandbok för Adobe ActionScript 3.0.
|
addChildAt | () | metod |
override public function addChildAt(child:DisplayObject, index:int):DisplayObject
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Lägger till en underordnad DisplayObject-instans i den här DisplayObjectContainer-instansen. Den underordnade läggs till i den specificerade indexpositionen. Ett indexvärde på 0 står för visningslistans baksida (botten) för detta DisplayObjectContainer-objekt.
I följande exempel visas tre visningsobjekt, betecknade a, b och c, i indexpositionerna 0, 2 och 1:
Om du lägger till ett underordnat objekt som redan har en annan visningsobjektbehållare som överordnad tas objektet bort från det andra visningsobjektets lista med underordnade.
Parametrar
child:DisplayObject — Den DisplayObject-instans som ska läggas till som underordnad till denna DisplayObjectContainer-instans.
| |
index:int — Den indexposition som den underordnade läggs till till. Om du specificerar en indexposition som är upptagen flyttas det underordnade objektet i den positionen, och alla högre positioner, upp ett steg i listan med underordnade.
|
DisplayObject — Den DisplayObject-instans som du skickar i child -parametern.
|
Utlöser
SecurityError — Anrop av addChildAt() -metoden för ett Stage-objekt ger ett undantag för varje anropare som inte befinner sig i samma säkerhetssandlåda som Stageägaren (SWF-huvudfilen). För att undvika detta kan Stage-ägaren bevilja anroparens domän tillstånd genom att anropa Security.allowDomain() -metoden eller Security.allowInsecureDomain() -metoden. Ytterligare information finns i kapitlet ”Säkerhet” i Utvecklarhandbok för Adobe ActionScript 3.0.
|
addEventListener | () | metod |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser. Du kan registrera händelseavlyssnare på alla noder i visningslistan efter en särskild typ av händelse, fas och prioritet.
När du har registrerat en händelseavlyssnare går det inte att ändra dess prioritet genom ytterligare anrop till addEventListener()
. För att kunna ändra avlyssnarens prioritet måste du först anropa removeListener()
. Sedan går det att registrera avlyssnaren på nytt med den nya prioritetsnivån.
Kom ihåg att när avlyssnaren har registrerats så skapar anrop till addEventListener()
med annan type
eller useCapture
-värde en separat avlyssnarregistrering. Om du till exempel först registrerar en avlyssnare med useCapture
inställt på true
, avlyssnar den bara under hämtningsfasen. Om du anropar addEventListener()
igen med samma avlyssningsobjekt men med useCapture
inställt på false
, får du två separata avlyssnare: en som avlyssnar under hämtningsfasen och en som avlyssnar under både mål- och bubblingsfasen.
Det går inte att registrera en händelseavlyssnare endast för målfasen eller bubblingsfasen. De faserna är sammankopplade vid registreringen eftersom bubblande bara tillämpas på de som är överordnade målnoden.
Om du inte längre behöver en händelseavlyssnare tar du bort den genom att anropa removeEventListener()
. Annars finns risk för minnesproblem. Händelseavlyssnare tas inte automatiskt bort från minnet, eftersom skräpinsamlaren inte tar bort avlyssnaren så länge det skickande objektet finns (om inte parametern useWeakReference
är true
).
Kopiering av en EventDispatcher-instans innebär inte att de händelseavlyssnare som är kopplade till den kopieras. (Om en nod som du nyss skapat behöver en händelseavlyssnare måste du koppla avlyssnaren efter att du skapat noden.) Om du däremot flyttar en EventDispatcher-instans flyttas den kopplade händelseavlyssnaren med.
Om händelseavlyssnaren är registrerad på en nod samtidigt som en händelse bearbetas på den noden aktiveras inte händelseavlyssnaren under den aktuella fasen, men den kan aktiveras under en senare fas i händelseflödet, t.ex. bubblingsfasen.
Om en händelseavlyssnare tas bort från en nod samtidigt som en händelse bearbetas på den noden, aktiveras den ändå av de aktuella åtgärderna. När händelseavlyssnaren tagits bort anropas den aldrig mer (om den inte registreras på nytt för framtida bearbetning).
Parametrar
type:String — Händelsens typ.
| |
listener:Function — Avlyssnarfunktionen som bearbetar händelsen. Den här funktionen måste acceptera ett Event-objekt som sin enda parameter och får inte returnera någonting, se följande exempel:
function(evt:Event):void Funktionen kan ha vilket namn som helst. | |
useCapture:Boolean (default = false ) —
Avgör om avlyssnaren fungerar i hämtningsfasen eller mål- och bubblingsfaserna. Om useCapture är inställd på true bearbetar avlyssningsprocessen bara händelsen under hämtningsfasen och inte under mål- eller bubblingsfasen. Om useCapture är inställd på false bearbetar avlyssningsprocessen bara händelsen under mål- och bubblingsfasen. Om du vill avlyssna händelsen under alla tre faserna anropar du addEventListener två gånger, en gång med useCapture inställd på true , och sedan en gång med useCapture inställd på false .
| |
priority:int (default = 0 ) — Händelseavlyssnarens prioritetsnivå. Prioriteten anges av ett 32-bitars heltal med tecken. Ju högre tal, desto högre prioritet. Alla avlyssnare med prioritet n bearbetas före avlyssnare med prioritet n -1. Om två eller fler avlyssnare har samma prioritet bearbetas de i den ordning de lades till. Standardprioritet är 0.
| |
useWeakReference:Boolean (default = false ) — Avgör om referensen till avlyssnaren är stark eller svag. En stark referens (standard) förhindrar att avlyssnaren skräpsamlas. Det gör inte en svag referens. Medlemsfunktioner på klassnivå skräpsamlas inte, så du kan ange |
Utlöser
SecurityError — Anrop av addEventListener -metoden för ett Stage-objekt ger ett undantag för varje anropare som inte befinner sig i samma säkerhetssandlåda som Stageägaren (SWF-huvudfilen). För att undvika denna situation kan Stage-ägaren bevilja anroparens domän tillstånd genom att anropa Security.allowDomain() -metoden eller Security.allowInsecureDomain() -metoden. Ytterligare information finns i kapitlet ”Säkerhet” i Utvecklarhandbok för Adobe ActionScript 3.0.
|
assignFocus | () | metod |
public function assignFocus(objectToFocus:InteractiveObject, direction:String):void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0 |
Ställer in tangentbordsfokus till det interaktiva objekt som anges av objectToFocus
, med den fokusriktning som anges av parametern direction
.
Fokusriktningen måste definieras av programmet (eller programramverket). Det finns ingen inbyggd fokussortering för interaktiva objekt, men du kan använda andra tillgängliga egenskaper för att skapa en sorteringsprincip. Du kan t.ex. sortera interaktiva objekt efter deras positioner på scenen eller i visningslistan. Att anropa assignFocus()
motsvarar att ställa in egenskapen Stage.focus
med den ytterligare möjligheten att indikera riktningen som fokus ställs in ifrån.
objectToFocus
skickar en focusIn
-händelse när den tar emot fokus. FocusEvent-objektets egenskap direction
rapporterar värdet av parametern direction
.
Om du tilldelar ett HTMLLoader-objekt till objectToFocus
-parametern, väljer HTMLLoader-objektet ett lämpligt objekt i HTML DOM som går att fokusera utifrån parametervärdet för direction
. Om värdet är FocusDirection.BOTTOM
fokuseras objektet i HTML DOM i slutet av läsordningen. Om värdet är FocusDirection.TOP
fokuseras objektet i HTML DOM i början av läsordningen. Om värdet är NONE
fokuseras HTMLLoader-objektet utan att dess aktuella, fokuserade element ändras.
Parametrar
objectToFocus:InteractiveObject — Det objekt som ska fokuseras eller null för att nollställa eventuellt fokus på scenen.
| |
direction:String — Den riktning som objectToFocus fokuseras från. Giltiga värden är konstanter i klassen FocusDirection.
|
Utlöser
Error — Om fokus inte kan anges är målobjektet eller direction inte en giltig typ.
|
Relaterade API-element
dispatchEvent | () | metod |
override public function dispatchEvent(event:Event):Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Skickar en händelse till händelseflödet. Händelsemålet är det EventDispatcher-objekt som dispatchEvent()
-metoden anropas till.
Parametrar
event:Event — Event-objektet som skickas till händelseflödet. En klon av händelsen skapas automatiskt om en händelse skickas om. När en händelse har skickats kan dess target -egenskap inte ändras. Du måste skapa en ny kopia av händelsen om du vill skicka om för arbete.
|
Boolean — Värdet true om händelsen skickades. Värdet false anger att det inte fungerade eller att preventDefault() anropades för händelsen.
|
Utlöser
SecurityError — Anrop av dispatchEvent() -metoden för ett Stage-objekt ger ett undantag för varje anropare som inte befinner sig i samma säkerhetssandlåda som Stageägaren (SWF-huvudfilen). För att undvika detta kan Stage-ägaren bevilja anroparens domän tillstånd genom att anropa Security.allowDomain() -metoden eller Security.allowInsecureDomain() -metoden. Ytterligare information finns i kapitlet ”Säkerhet” i Utvecklarhandbok för Adobe ActionScript 3.0.
|
hasEventListener | () | metod |
override public function hasEventListener(type:String):Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse. Då kan du bestämma var i händelseflödeshierarkin ett EventDispatcher-objekt har förändrat hanteringen av en händelsetyp. Använd willTrigger()
om du vill ta reda på om en viss händelsetyp faktiskt aktiverar en händelseavlyssnare.
Skillnaden mellan hasEventListener()
och willTrigger()
är att hasEventListener()
bara undersöker det objekt som det hör till, medan willTrigger()
undersöker hela händelseflödet för händelsen som angetts av type
-parametern.
När hasEventListener()
anropas från ett LoaderInfo-objekt beaktas bara de avlyssnare som anroparen kan komma åt.
Parametrar
type:String — Händelsens typ.
|
Boolean — Värdet true om en avlyssnare för den angivna typen är registrerad, annars false .
|
Utlöser
SecurityError — Anrop av hasEventListener() -metoden för ett Stage-objekt ger ett undantag för varje anropare som inte befinner sig i samma säkerhetssandlåda som Stageägaren (SWF-huvudfilen). För att undvika detta kan Stage-ägaren bevilja anroparens domän tillstånd genom att anropa Security.allowDomain() -metoden eller Security.allowInsecureDomain() -metoden. Ytterligare information finns i kapitlet ”Säkerhet” i Utvecklarhandbok för Adobe ActionScript 3.0.
|
invalidate | () | metod |
public function invalidate():void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Anrop av invalidate()
-metoden signalerar till Flash-miljöerna att aktivera visningsobjekt vid nästa möjlighet att återge visningslistan (exempelvis när spelhuvudet går till en ny bildruta). När du anropar invalidate()
-metoden, och visningslistan återges därefter, skickar Flash-miljön en render
-händelse till varje visningsobjekt som registrerats för att lyssna efter render
-händelsen. Du måste anropa invalidate()
-metoden varje gång du vill att Flash-miljön ska skicka render
-händelser.
render
-händelsen ger dig möjlighet att ändra visningslistan alldeles innan den faktiskt återges. Det ger dig möjlighet att skjuta upp uppdateringar av visningslistan till den sista möjligheten. Det kan ge bättre prestanda genom att eliminera onödiga skärmuppdateringar.
render
-händelsen skickas bara till visningsobjekt som befinner sig i samma säkerhetsdomän som den kod som anropar stage.invalidate()
-metoden, eller till visningsobjekt från en säkerhetsdomän som fått tillstånd via Security.allowDomain()
-metoden.
Relaterade API-element
isFocusInaccessible | () | metod |
public function isFocusInaccessible():Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Avgör om egenskapen Stage.focus
returnerar null
av säkerhetsskäl. Med andra ord så returnerar isFocusInaccessible
true
om det objekt som är i fokus tillhör en säkerhetssandlåda som SWF-filen inte har åtkomst till.
Boolean — true om det objekt som är i fokus tillhör en säkerhetssandlåda som SWF-filen inte har åtkomst till.
|
removeChildAt | () | metod |
override public function removeChildAt(index:int):DisplayObject
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Tar bort ett underordnat DisplayObject från den angivna index
-positionen i den underordnade listan i DisplayObjectContainer. Den borttagna underordnades parent
-egenskap sätts till null
och objektet skräpsamlas om det inte finns några andra referenser till den underordnade. Indexpositionerna för eventuella visningsobjekt över det det underordnade i DisplayObjectContainer stegas ner med 1.
Skräpinsamlaren allokerar om oanvänt minnesutrymme. När en variabel eller ett objekt inte längre aktivt refereras till, eller sparas någonstans, sveper skräpinsamlaren igenom och torkar bort det minnesutrymme som den/det förut använde, om det inte finns någon referens till den/det.
Parametrar
index:int — Det underordnade indexet för det DisplayObject som ska tas bort.
|
DisplayObject — Den DisplayObject-instans som togs bort.
|
Utlöser
SecurityError — Anrop av removeChildAt() -metoden för ett Stage-objekt ger ett undantag för varje anropare som inte befinner sig i samma säkerhetssandlåda som det objekt som ska tas bort. För att undvika detta kan ägaren av objektet ifråga bevilja anroparens domän tillstånd genom att anropa Security.allowDomain() -metoden eller Security.allowInsecureDomain() -metoden. Ytterligare information finns i kapitlet ”Säkerhet” i Utvecklarhandbok för Adobe ActionScript 3.0.
|
setAspectRatio | () | metod |
public function setAspectRatio(newAspectRatio:String):void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2 |
Ställer in scenens orientering med de angivna proportionerna.
Om scenorienteringen ändras på grund av metodanropet skickar Stage-objektet en orientationChange-händelse.
Om du vill veta om enhetsorientering stöds kontrollerar du värdet på egenskapen Stage.supportsOrientantionChange
.
Stöd för AIR-profiler: Den här funktionen stöds på mobilenheter, men inte på operativsystem för datorer eller enheter med AIR for TV. Du kan testa stödet vid körning med egenskapen Stage.supportsOrientantionChange
. På sidan om stöd för AIR-profiler hittar du mer information om API-stöd för flera profiler.
Parametrar
newAspectRatio:String — Typkoden för önskade proportioner (StageAspectRatio.PORTRAIT , StageAspectRatio.LANDSCAPE eller StageAspectRatio.ANY ).
|
Utlöser
ArgumentError — Värdet för parametern newAspectRatio är inte giltigt. Värdet måste matcha någon av konstanterna som definieras i klassen StageAspectRatio.
|
Relaterade API-element
setChildIndex | () | metod |
override public function setChildIndex(child:DisplayObject, index:int):void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ändrar positionen för ett befintligt underordnat objekt i behållaren för visningsobjekt. Detta påverkar skiktningen av underordnade objekt. I följande exempel visas tre visningsobjekt, betecknade a, b och c, i indexpositionerna 0, 1 och 2:
När du använder setChildIndex()
-metoden och anger en index-position som redan är upptagen, är de enda positioner som kan ändras de som ligger mellan visningsobjektets tidigare och nya position. Alla andra förblir desamma. Om en underordnad flyttas till ett index som är LÄGRE än dess nuvarande index kommer alla underordnade emellan att ÖKA med 1 i sin indexreferens. Om en underordnad flyttas till ett index som är HÖGRE än dess nuvarande index kommer alla underordnade emellan att MINSKA med 1 i sin indexreferens. Om visningsobjektbehållaren i föregående exempel exempelvis har namnet container
så kan du växla positionerna för de visningsobjekt som är betecknade a och b genom att anropa följande kod:
container.setChildIndex(container.getChildAt(1), 0);
Denna kod leder till följande objektordning:
Parametrar
child:DisplayObject — Den underordnade DisplayObject-instans som du vill ändra indexnumret för.
| |
index:int — Det resulterande indexnumret för child -visningsobjektet.
|
Utlöser
SecurityError — Anrop av setChildIndex() -metoden för ett Stage-objekt ger ett undantag för varje anropare som inte befinner sig i samma säkerhetssandlåda som Stageägaren (SWF-huvudfilen). För att undvika detta kan Stage-ägaren bevilja anroparens domän tillstånd genom att anropa Security.allowDomain() -metoden eller Security.allowInsecureDomain() -metoden. Ytterligare information finns i kapitlet ”Säkerhet” i Utvecklarhandbok för Adobe ActionScript 3.0.
|
setOrientation | () | metod |
public function setOrientation(newOrientation:String):void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2 |
Ställer in scenen på den angivna orienteringen.
Ställ in parametern newOrientation
på ett av följande fyra värden som definieras som konstanter i StageOrientation-klassen:
StageOrientation-konstant | Scenorientering |
---|---|
StageOrientation.DEFAULT | Ställer in scenorienteringen på standardorienteringen (rättvänd). |
StageOrientation.ROTATED_RIGHT | Ställer in att scenorienteringen ska roteras åt höger. |
StageOrientation.ROTATED_LEFT | Ställer in att scenorienteringen ska roteras åt vänster. |
StageOrientation.UPSIDE_DOWN | Ställer in att scenorienteringen ska vändas upp och ned. |
Ställ inte in parametern på StageOrientation.UNKNOWN
eller något annat strängvärde än de som anges i tabellen.
Om du vill veta om det finns stöd för ändrad enhetsorientering kontrollerar du värdet för egenskapen Stage.supportsOrientantionChange
. Kontrollera i listan som tillhandahålls av egenskapen supportedOrientations
vilka orienteringar som har stöd i den aktuella enheten.
Att ställa in orienteringen är en asynkron åtgärd. Det finns ingen garanti att den slutförs omedelbart efter anropet av metoden setOrientation()
. Lägg till en händelseavlyssnare för händelsen orientationChange
för att bestämma när orienteringsförändringen är slutförd.
Viktigt! Metoden setOrientation()
saknade stöd på Android-enheter före AIR 2.6.
setOrientation()
orsakar inte att en orientationChanging
-händelse skickas.
Parametrar
newOrientation:String — Scenens nya orientering.
|
Händelser
orientationChange: — Storleken på scenen har ändrats som ett resultat av anropet till metoden setOrientation() .
|
Utlöser
ArgumentError — Värdet för parametern newOrientation är inte giltigt. Värdet måste motsvara en av konstanterna som definierats i klassen StageOriention, utom konstanten StageOrientation.UNKNOWN .
|
Relaterade API-element
swapChildrenAt | () | metod |
override public function swapChildrenAt(index1:int, index2:int):void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Byter z-ordningen (framifrån och bakåt-ordning) för underordnade objekt vid de två angivna indexpositionerna i listan med underordnade objekt. Samtliga övriga underordnade objekt i visningsobjektbehållaren blir kvar i samma indexpositioner.
Parametrar
index1:int — Det första underordnade objektets indexposition.
| |
index2:int — Det andra underordnade objektets indexposition.
|
Utlöser
SecurityError — Anrop av swapChildrenAt() -metoden för ett Stage-objekt ger ett undantag för varje anropare som inte befinner sig i samma säkerhetssandlåda som ägaren till något av de objekt som ska byta plats. För att undvika detta kan Stage-ägaren bevilja anroparens domän tillstånd genom att anropa Security.allowDomain() -metoden eller Security.allowInsecureDomain() -metoden. Ytterligare information finns i kapitlet ”Säkerhet” i Utvecklarhandbok för Adobe ActionScript 3.0.
|
willTrigger | () | metod |
override public function willTrigger(type:String):Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen. Den här metoden returnerar true
om en händelsavlyssnare aktiveras under någon av faserna i händelseflödet när en händelse av den angivna typen skickas till det här EventDispatcher-objektet eller någon av dess underordnade.
Skillnaden mellan metoderna hasEventListener()
och willTrigger()
är att hasEventListener()
bara undersöker det objekt som det hör till, medan willTrigger()
-metoden undersöker hela händelseflödet för händelsen som angetts av type
-parametern.
När willTrigger()
anropas från ett LoaderInfo-objekt beaktas bara de avlyssnare som anroparen kan komma åt.
Parametrar
type:String — Händelsens typ.
|
Boolean — Värdet true om en avlyssnare för den angivna typen kommer att aktiveras, annars false .
|
Utlöser
SecurityError — Anrop av willTrigger() -metoden för ett Stage-objekt ger ett undantag för varje anropare som inte befinner sig i samma säkerhetssandlåda som Stageägaren (SWF-huvudfilen). För att undvika detta kan Stage-ägaren bevilja anroparens domän tillstånd genom att anropa Security.allowDomain() -metoden eller Security.allowInsecureDomain() -metoden. Ytterligare information finns i kapitlet ”Säkerhet” i Utvecklarhandbok för Adobe ActionScript 3.0.
|
browserZoomChange | Händelse |
flash.events.Event
egenskap Event.type =
flash.events.Event.BROWSER_ZOOM_CHANGE
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 15 |
Skickas när egenskapen browserZoomFactor
för Stage-objektet ändras.
Event.BROWSER_ZOOM_CHANGE
-konstanten definierar värdet på type
-egenskapen för ett browserZoomChange
-händelseobjekt.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
bubbles | false |
cancelable | false ; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Sceninstansen. |
fullScreen | Händelse |
flash.events.FullScreenEvent
egenskap FullScreenEvent.type =
flash.events.FullScreenEvent.FULL_SCREEN
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9.0.28.0, Flash Lite 4 |
Skickas när Stage-objektet går in i, eller ut ur, fullskärmsläget. Ändring av fullskärmsläget kan initieras med ActionScript, eller genom att användaren använder ett kortkommando, eller om aktuell fokusering lämnar fullskärmsfönstret.
KonstantenFullScreenEvent.FULL_SCREEN
definierar värdet för ett fullScreen
-händelseobjekts type
-egenskap.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
fullScreen | true om visningsläget är helskärm eller false om det är normalt. |
bubbles | false |
cancelable | false ; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Scenobjektet. |
mouseLeave | Händelse |
flash.events.Event
egenskap Event.type =
flash.events.Event.MOUSE_LEAVE
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Skickas av Stage-objektet när pekaren flyttas bort från scenområdet. Händelsen skickas inte om musknappen trycks in.
Event.MOUSE_LEAVE
-konstanten definierar värdet på type
-egenskapen i ett mouseLeave
-händelseobjekt.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
bubbles | false |
cancelable | false ; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Scenobjektet. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
orientationChange | Händelse |
flash.events.StageOrientationEvent
egenskap StageOrientationEvent.type =
flash.events.StageOrientationEvent.ORIENTATION_CHANGE
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2.0 |
Skickas av Stage-objektet när scenens orientering ändras.
Orienteringsförändringar kan inträffa när användaren roterar enheten, öppnar ett utfällbart tangentbord eller när setAspectRatio()
anropas.
Obs! Om egenskapen autoOrients
är false
ändras inte scenens orientering när en enhet roteras. StageOrientationEvents skickas alltså bara för enhetsrotation när autoOrients
är true
.
ORIENTATION_CHANGE
definierar värdet på type
-egenskapen i ett orientationChange
-händelseobjekt. Den här händelsen har följande egenskaper:
Egenskaper | Värden |
---|---|
afterOrientation | Scenens nya orientering. |
beforeOrientation | Scenens tidigare orientering. |
target | Det Stage-objekt som skickade orienteringsändringen. |
bubbles | true |
currentTarget | Anger det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
cancelable | false , det är för sent för att avbryta ändringen. |
orientationChanging | Händelse |
flash.events.StageOrientationEvent
egenskap StageOrientationEvent.type =
flash.events.StageOrientationEvent.ORIENTATION_CHANGING
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2.0 |
Skickas av Stage-objektet när förändringen av scenorienteringen börjar.
Viktigt! orientationChanging-händelser skickas inte på Android-enheter.
Obs!
-
Om egenskapen
autoOrients
ärfalse
ändras inte scenens orientering när en enhet roteras. StageOrientationEvents skickas alltså bara för enhetsrotation närautoOrients
ärtrue
. -
När du ställer in orienteringen i programmet med metoden
setOrientation()
skickas intehändelsenorientationChanging
.
ORIENTATION_CHANGING
definierar värdet på type
-egenskapen i ett orientationChanging
-händelseobjekt. Den här händelsen har följande egenskaper:
Egenskaper | Värden |
---|---|
afterOrientation | Scenens nya orientering. |
beforeOrientation | Scenens tidigare orientering. |
target | Det Stage-objekt som skickade orienteringsändringen. |
bubbles | true |
currentTarget | Anger det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
cancelable | true . |
resize | Händelse |
flash.events.Event
egenskap Event.type =
flash.events.Event.RESIZE
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Skickas när scaleMode
-egenskapen för Stage-objektet anges som StageScaleMode.NO_SCALE
och storleken på SWF-filen ändras. Skickas även när skärmorienteringen ändras i helskärmsläge i Flash Player 15 och senare.
Event.RESIZE
-konstanten definierar värdet på type
-egenskapen i ett resize
-händelseobjekt.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
bubbles | false |
cancelable | false ; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Scenobjektet. |
stageVideoAvailability | Händelse |
flash.events.StageVideoAvailabilityEvent
egenskap StageVideoAvailabilityEvent.type =
flash.events.StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABILITY
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 10.2 |
Skickas av Stage-objektet när statusen för egenskapen stageVideos ändras.
Definierar värdet förtype
-egenskapen i ett stageVideoAvailability
-händelseobjekt.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
availability | Den status som rapporteras av händelsen. |
bubbles | false |
cancelable | false ; det finns inget standardbeteende att avbryta. |
currentTarget | Objektet som aktivt bearbetar händelsen. |
target | Det Stage-objekt som rapporterar om tillgänglighet för video på scenen. |
Exempel ( Så här använder du exemplet )
StageExample
för att skicka händelser när scenen aktiveras eller storleksändras. Detta genomförs med följande steg:
- Först sätter klasskonstruktorn Flashprogrammet till fast, oavsett storleken på Flash Player-fönstret, och lägger sedan till två händelseavlyssnare med
activateHandler()
- ochresizeHandler()
-metoderna. activateHandler()
-metoden körs vid klickning med den vänstra musknappen.resizeHandler()
-metoden körs när storleken på scenen ändras.
package { import flash.display.Sprite; import flash.display.StageAlign; import flash.display.StageScaleMode; import flash.events.Event; public class StageExample extends Sprite { public function StageExample() { stage.scaleMode = StageScaleMode.NO_SCALE; stage.align = StageAlign.TOP_LEFT; stage.addEventListener(Event.ACTIVATE, activateHandler); stage.addEventListener(Event.RESIZE, resizeHandler); } private function activateHandler(event:Event):void { trace("activateHandler: " + event); } private function resizeHandler(event:Event):void { trace("resizeHandler: " + event); trace("stageWidth: " + stage.stageWidth + " stageHeight: " + stage.stageHeight); } } }
VsyncStateChangeAvailability | Händelse |
flash.events.VsyncStateChangeAvailabilityEvent
egenskap VsyncStateChangeAvailabilityEvent.type =
flash.events.VsyncStateChangeAvailabilityEvent
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 29.0 |
Skickas av Stage-objektet när tillståndet ändras för egenskapen vsync.
Definierar värdet för typegenskapen i ett VsyncStateChangeAvailabilityEvent
-händelseobjekt.
Exempel ( Så här använder du exemplet )
VsyncExample
för att skicka händelser när vsync-tillståndet på scenen kan aktiveras eller inaktiveras. Detta genomförs med följande steg:
- Konstruktorn utlöser först scenhändelsen
VsyncStateChangeAvailabilityEvent
- Sedan anropas metoden
onVsyncStateChangeAvailability
, som kontrollerar omVsyncStateChangeAvailabilityEvent
är tillgängligt eller inte. - Om det är tillgängligt kan du ändra vsync-tillståndet på scenen, annars är värdet för egenskapen
vsyncEnable
skrivskyddat. - Värdet för aktivering av vsync kan bara utlösas om händelsen utlöses.
package { import flash.display.Sprite; import flash.events.VsyncStateChangeAvailabilityEvent public class VsyncExample extends Sprite { public function VsyncExample() { stage.addEventListener(VsyncStateChangeAvailabilityEvent.VSYNC_STATE_CHANGE_AVAILABILITY, onVsyncStateChangeAvailability); } public function onVsyncStateChangeAvailability(event:VsyncStateChangeAvailabilityEvent):void { if (event.available) { // vsyncEnabled is now changeable and can be turned off. stage.vsyncEnabled = false; // Now, AS can change VSYNC state because event.available is true trace("vsyncEnabled of Stage object is changeable"); } else { // vsyncEnabled is not changeable now. This could be due to fallback to software rendering, for example. stage.vsyncEnabled = false; // This will be ignored because event.available is now false trace("vsyncEnabled of Stage object is read-only"); trace("Current value of vsyncEnabled of Stage object is "+ stage.vsyncEnabled); } } } }
Tue Jun 12 2018, 01:40 PM Z