Paket | flash.display |
Klasse | public class Stage |
Vererbung | Stage DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Für SWF-Inhalt, der im Browser angezeigt wird (in Flash® Player), repräsentiert die Bühne den gesamten Bereich, in dem der Inhalt angezeigt wird. Für Inhalt, der in AIR unter Desktopbetriebssystemen ausgeführt wird, hat jedes NativeWindow-Objekt ein zugehöriges Stage-Objekt.
Das Stage-Objekt ist nicht global zugänglich. Sie müssen über die stage
-Eigenschaft einer DisplayObject-Instanz darauf zugreifen.
Die Stage-Klasse besitzt mehrere übergeordneten Klassen (DisplayObjectContainer, InteractiveObject, DisplayObject und EventDispatcher), von denen sie Eigenschaften und Methoden übernimmt. Viele dieser Eigenschaften und Methoden lassen sich entweder gar nicht auf Stage-Objekte anwenden oder erfordern eine Sicherheitsüberprüfung, wenn sie für ein Stage-Objekt aufgerufen werden. Die Eigenschaften und Methoden, die eine Sicherheitsüberprüfung benötigen, sind als Teil der Stage-Klasse dokumentiert.
Darüber hinaus sind die folgenden geerbten Eigenschaften auf Stage-Objekte nicht anwendbar. Wenn Sie versuchen, diese Eigenschaften zu setzen, wird ein Fehler vom Typ „IllegalOperationError“ ausgelöst. Diese Eigenschaften werden zwar immer gelesen, doch da sie nicht gesetzt werden können, enthalten sie stets die Standardwerte.
-
accessibilityProperties
-
alpha
-
blendMode
-
cacheAsBitmap
-
contextMenu
-
filters
-
focusRect
-
loaderInfo
-
mask
-
mouseEnabled
-
name
-
opaqueBackground
-
rotation
-
scale9Grid
-
scaleX
-
scaleY
-
scrollRect
-
tabEnabled
-
tabIndex
-
transform
-
visible
-
x
-
y
Manche Ereignisse, von denen Sie erwarten würden, dass Sie zur Stage-Klasse gehören, z. B. enterFrame
, exitFrame
, frameConstructed
und render
, können keine Stage-Ereignisse sein, da in den Situationen, in denen sie verwendet werden, keine Verweis auf das Stage-Objekt garantiert werden kann. Da diese Ereignisse nicht vom Stage-Objekt ausgelöst werden können, werden sie stattdessen von jeder DisplayObject-Instanz ausgelöst. Das bedeutet, dass Sie jeder beliebigen DisplayObjekt-Instanz einen Ereignis-Listener hinzufügen können, der auf die Ereignisse wartet. Diese Ereignisse, die zur DisplayObject-Klasse gehören, werden broadcast-Ereignisse genannt, um sie von Ereignissen zu unterscheiden, die bei einer spezifischen DisplayObject-Instanz vorkommen. Zwei andere broadcast-Ereignisse, activate
und deactivate
, gehören zu EventDispatcher, der Superklasse von DisplayObject. Die activate
- und deactivate
-Ereignisse verhalten sich ähnlich wie die broadcast-Ereignisse von DisplayObject, mit der Ausnahme, dass sie nicht nur von allen DisplayObject-Instanzen ausgelöst werden sondern auch von allen EventDispatcher-Instanzen und den Instanzen anderer Unterklassen von EventDispatcher. Weitere Informationen zu broadcast-Ereignissen finden Sie im Abschnitt zur DisplayObject-Klasse.
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
Die aktuelle Eingabehilfenimplementierung (AccessibilityImplementation) für diese InteractiveObject-Instanz. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
Die aktuellen Optionen für Eingabehilfen zur Barrierefreiheit dieses Anzeigeobjekts. | DisplayObject | ||
align : String
Ein Wert aus der StageAlign-Klasse, der die Ausrichtung der Bühne im Flash Player oder Browser bestimmt. | Stage | ||
allowsFullScreen : Boolean [schreibgeschützt]
Legt fest, ob diese Bühne die Verwendung des Vollbildmodus zulässt
| Stage | ||
allowsFullScreenInteractive : Boolean [schreibgeschützt]
Legt fest, ob diese Bühne die Verwendung des Vollbildmodus für die Texteingabe zulässt
| Stage | ||
alpha : Number
Gibt den Alphatransparenzwert des angegebenen Objekts an. | DisplayObject | ||
autoOrients : Boolean
Legt fest, ob die Bühne automatisch die Ausrichtung ändert, wenn die Ausrichtung des Geräts geändert wird. | Stage | ||
blendMode : String
Ein Wert aus der BlendMode-Klasse, mit dem angegeben wird, welcher Mischmodus verwendet werden soll. | DisplayObject | ||
blendShader : Shader [Nur Schreiben]
Legt einen Shader fest, der für das Mischen von Vordergrund und Hintergrund verwendet wird. | DisplayObject | ||
browserZoomFactor : Number [schreibgeschützt]
Legt den Browser-Zoomfaktor fest. | Stage | ||
cacheAsBitmap : Boolean
Wird diese Eigenschaft auf „true“ gesetzt, speichern Flash-Laufzeitumgebungen eine interne Bitmap-Darstellung des Anzeigeobjekts im Cache. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
Bei einem Nicht-Null-Wert definiert dieses Matrix-Objekt, wie ein Anzeigeobjekt dargestellt wird, wenn cacheAsBitmap auf „true“ gesetzt ist. | DisplayObject | ||
color : uint
Die SWF-Hintergrundfarbe. | Stage | ||
colorCorrection : String
Steuert die Farbkorrektur der Flash-Laufzeitumgebung für Anzeigen. | Stage | ||
colorCorrectionSupport : String [schreibgeschützt]
Gibt an, ob die Flash-Laufzeitumgebung auf einem Betriebssystem ausgeführt wird, das Farbkorrektur unterstützt, und ob das Farbprofil des primären (Haupt-) Bildschirms von der Flash-Laufzeitumgebung gelesen und interpretiert wird. | Stage | ||
constructor : * | Stage | ||
contentsScaleFactor : Number [schreibgeschützt]
Gibt den effektiven Pixelskalierungsfaktor der Bühne an. | Stage | ||
contextMenu : NativeMenu
Gibt das diesem Objekt zugeordnete Kontextmenü an. | InteractiveObject | ||
deviceOrientation : String [schreibgeschützt]
Die physische Ausrichtung des Geräts. | Stage | ||
displayState : String
Ein Wert aus der StageDisplayState-Klasse, der festlegt, welcher Anzeigestatus zu verwenden ist. | Stage | ||
doubleClickEnabled : Boolean
Gibt an, ob das Objekt doubleClick-Ereignisse empfängt. | InteractiveObject | ||
filters : Array
Ein indiziertes Array, das alle dem Anzeigeobjekt derzeit zugeordneten filter-Objekte enthält. | DisplayObject | ||
focus : InteractiveObject
Das interaktive Objekt mit Tastaturfokus bzw. „null“, wenn der Fokus nicht gesetzt ist oder wenn das Objekt mit dem Fokus zu einer Sicherheits-Sandbox gehört, auf die mit dem aufrufenden Objekt nicht zugegriffen werden kann. | Stage | ||
focusRect : Object
Gibt an, ob für dieses Objekt ein Fokusrechteck angezeigt wird. | InteractiveObject | ||
frameRate : Number
Ruft die Bildrate der Bühne ab und setzt sie gegebenenfalls neu. | Stage | ||
fullScreenHeight : uint [schreibgeschützt]
Setzt die Höhe des Monitors, der verwendet wird, wenn der Vollbildmodus aktiviert wird, zurück, falls dieser Modus sofort aufgerufen wird. | Stage | ||
fullScreenSourceRect : Rectangle
Veranlasst die Flash-Laufzeitumgebung einen bestimmten Bereich der Bühne im Vollbildmodus anzuzeigen. | Stage | ||
fullScreenWidth : uint [schreibgeschützt]
Setzt die Breite des Monitors, der verwendet wird, wenn der Vollbildmodus aktiviert wird, zurück, falls dieser Modus sofort aufgerufen wird. | Stage | ||
height : Number [override]
Gibt die Höhe des Anzeigeobjekts in Pixeln an. | Stage | ||
loaderInfo : LoaderInfo [schreibgeschützt]
Gibt ein LoaderInfo-Objekt mit Informationen zum Laden der Datei zurück, zu der dieses Anzeigeobjekt gehört. | DisplayObject | ||
mask : DisplayObject
Das aufrufende Anzeigeobjekt wird durch das angegebene mask-Objekt maskiert. | DisplayObject | ||
metaData : Object
Bezieht das Metadatenobjekt der DisplayObject-Instanz, wenn Metadaten neben der Instanz dieses DisplayObject in der SWF-Datei durch ein PlaceObject4-Tag gespeichert wurden. | DisplayObject | ||
mouseChildren : Boolean [override]
Bestimmt, ob die untergeordneten Elemente des Objekts maus- oder benutzereingabegerätfähig sind oder nicht. | Stage | ||
mouseEnabled : Boolean
Gibt an, ob dieses Objekt Meldungen von der Maus oder einem anderen Benutzereingabegerät empfängt. | InteractiveObject | ||
mouseLock : Boolean
Legen Sie den Wert auf „true“ fest, um die Maussperre zu aktivieren. | Stage | ||
mouseX : Number [schreibgeschützt]
Gibt die x-Koordinate der Position der Maus oder des Benutzereingabegeräts in Pixeln an. | DisplayObject | ||
mouseY : Number [schreibgeschützt]
Gibt die y-Koordinate der Position der Maus oder des Benutzereingabegeräts in Pixeln an. | DisplayObject | ||
name : String
Gibt den Instanznamen des Anzeigeobjekts an. | DisplayObject | ||
nativeWindow : NativeWindow [schreibgeschützt]
Ein Verweis auf das NativeWindow-Objekt, das diese Bühne enthält. | Stage | ||
needsSoftKeyboard : Boolean
Gibt an, ob eine virtuelle Tastatur (Bildschirmtastatur) angezeigt wird, wenn diese InteractiveObject-Instanz den Fokus erhält. | InteractiveObject | ||
numChildren : int [override] [schreibgeschützt]
Liefert die Anzahl der Objekte, die diesem Objekt untergeordnet sind. | Stage | ||
opaqueBackground : Object
Legt fest, ob das Anzeigeobjekt bei einer bestimmten Hintergrundfarbe undurchsichtig ist. | DisplayObject | ||
orientation : String [schreibgeschützt]
Die aktuelle Ausrichtung der Bühne. | Stage | ||
parent : DisplayObjectContainer [schreibgeschützt]
Gibt das DisplayObjectContainer-Objekt an, das dieses Anzeigeobjekt enthält. | DisplayObject | ||
quality : String
Ein Wert der StageQuality-Klasse, der die verwendete Wiedergabequalität angibt. | Stage | ||
root : DisplayObject [schreibgeschützt]
Bei einem Anzeigeobjekt in einer geladenen SWF-Datei ist die root-Eigenschaft das oberste Anzeigeobjekt in dem Teil der Baumstruktur der Anzeigeliste, der diese SWF-Datei repräsentiert. | DisplayObject | ||
rotation : Number
Gibt die Drehung der DisplayObject-Instanz ausgehend von der ursprünglichen Ausrichtung in Grad an. | DisplayObject | ||
rotationX : Number
Gibt die x-Achsendrehung der DisplayObject-Instanz in Grad an, und zwar bezogen auf die ursprüngliche Ausrichtung zum übergeordneten 3D-Container. | DisplayObject | ||
rotationY : Number
Gibt die y-Achsendrehung der DisplayObject-Instanz in Grad an, und zwar bezogen auf die ursprüngliche Ausrichtung zum übergeordneten 3D-Container. | DisplayObject | ||
rotationZ : Number
Gibt die Drehung der z-Achse der DisplayObject-Instanz in Grad an, ausgehend von ihrer ursprünglichen Ausrichtung relativ zum übergeordneten 3D-Container. | DisplayObject | ||
scale9Grid : Rectangle
Das aktuell verwendete Skalierungsraster. | DisplayObject | ||
scaleMode : String
Ein Wert aus der StageScaleMode-Klasse, mit dem angegeben wird, welcher Skalierungsmodus verwendet werden soll. | Stage | ||
scaleX : Number
Gibt die horizontale Skalierung (Prozentwert) des Objekts ausgehend vom Registrierungspunkt an. | DisplayObject | ||
scaleY : Number
Gibt die vertikale Skalierung (Prozentwert) eines Objekts ausgehend vom Registrierungspunkt an. | DisplayObject | ||
scaleZ : Number
Gibt die Tiefenskalierung (Prozentwert) eines Objekts ausgehend vom Registrierungspunkt an. | DisplayObject | ||
scrollRect : Rectangle
Die Begrenzungen des Bildlaufrechtecks für das Anzeigeobjekt. | DisplayObject | ||
showDefaultContextMenu : Boolean
Gibt an, ob die Standardelemente im Kontextmenü der Flash-Laufzeitumgebung ein- oder ausgeblendet werden. | Stage | ||
softKeyboard : String
Steuert das Erscheinungsbild der Bildschirmtastatur. | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
Definiert einen Bereich, der auf dem Bildschirm sichtbar bleiben soll, wenn eine virtuelle Tastatur angezeigt wird (nicht unter iOS verfügbar). | InteractiveObject | ||
softKeyboardRect : Rectangle [schreibgeschützt]
Ein Rechteck, das den Bereich der Bühne definiert, der zurzeit von einer Softwaretastatur eingenommen wird. | Stage | ||
stage : Stage [schreibgeschützt]
Die Bühne des Anzeigeobjekts. | DisplayObject | ||
stage3Ds : Vector.<Stage3D> [schreibgeschützt]
Eine Liste von Stage3D-Objekten, die für die Anzeige von dreidimensionalen Inhalten verfügbar sind. | Stage | ||
stageFocusRect : Boolean
Bestimmt, ob Objekte mit leuchtendem Rahmen angezeigt werden, wenn sie den Fokus besitzen. | Stage | ||
stageHeight : int
Die aktuelle Höhe der Bühne in Pixel. | Stage | ||
stageVideos : Vector.<StageVideo> [schreibgeschützt]
Eine Liste der StageVideo-Objekte, die zum Abspielen externer Videos verfügbar sind. | Stage | ||
stageWidth : int
Bestimmt die aktuelle Breite der Bühne in Pixel. | Stage | ||
supportedOrientations : Vector.<String> [schreibgeschützt]
Die vom aktuellen Gerät unterstützten Ausrichtungen. | Stage | ||
supportsOrientationChange : Boolean [statisch] [schreibgeschützt]
Ob die Anwendung Änderungen an der Bühnenausrichtung (und Gerätedrehung) unterstützt. | Stage | ||
tabChildren : Boolean [override]
Bestimmt, ob die dem Objekt untergeordneten Objekte per Tabulatortaste aktivierbar sind. | Stage | ||
tabEnabled : Boolean
Gibt an, ob sich dieses Objekt in der Tabulatorreihenfolge befindet. | InteractiveObject | ||
tabIndex : int
Gibt die Tabulatorreihenfolge von Objekten in einer SWF-Datei an. | InteractiveObject | ||
textSnapshot : flash.text:TextSnapshot [override] [schreibgeschützt]
Liefert ein TextSnapshot-Objekt für diese DisplayObjectContainer-Instanz. | Stage | ||
transform : flash.geom:Transform
Ein Objekt mit Eigenschaften, die zur Matrix, Farbtransformation und Pixelbegrenzung eines Anzeigeobjekts gehören. | DisplayObject | ||
visible : Boolean
Gibt an, ob das Anzeigeobjekt sichtbar ist oder nicht. | DisplayObject | ||
vsyncEnabled : Boolean
Dies stellt den aktuellen vsync-Status der zugrunde liegenden Grafiklösung dar. Wir können vsync aktivieren/deaktivieren, um sofort zu rendern, ohne auf den nächsten VSYNC-Status warten zu müssen. | Stage | ||
width : Number [override]
Gibt die Breite des Anzeigeobjekts in Pixeln an. | Stage | ||
wmodeGPU : Boolean [schreibgeschützt]
Gibt an, ob GPU-Compositing verfügbar ist und verwendet wird. | Stage | ||
x : Number
Gibt die x-Koordinate der DisplayObject-Instanz relativ zu den lokalen Koordinaten des übergeordneten DisplayObjectContainer-Objekts an. | DisplayObject | ||
y : Number
Gibt die y-Koordinate der DisplayObject-Instanz relativ zu den lokalen Koordinaten des übergeordneten DisplayObjectContainer-Objekts an. | DisplayObject | ||
z : Number
Gibt die z-Koordinatenposition an der z-Achse der DisplayObject-Instanz relativ zum übergeordneten 3D-Container an. | DisplayObject |
Methode | Definiert von | ||
---|---|---|---|
[override]
Fügt dieser DisplayObjectContainer-Instanz eine untergeordnete DisplayObject-Instanz hinzu. | Stage | ||
[override]
Fügt dieser DisplayObjectContainer-Instanz eine untergeordnete DisplayObject-Instanz hinzu. | Stage | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [override]
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | Stage | ||
Gibt an, ob aufgrund der Sicherheitseinschränkungen irgendwelche Anzeigeobjekte aus der Liste ausgeschlossen werden, die beim Aufrufen der DisplayObjectContainer.getObjectsUnderPoint()-Methode mit dem angegebenen point-Punkt zurückgegeben wird. | DisplayObjectContainer | ||
Stellt den Tastaturfokus auf das interaktive Objekt ein, das vom objectToFocus-Parameter angegeben wird. Dabei wird die Richtung des Fokus vom direction-Parameter bestimmt. | Stage | ||
Ermittelt, ob das angegebene Anzeigeobjekt der DisplayObjectContainer-Instanz oder der Instanz selbst untergeordnet ist. | DisplayObjectContainer | ||
[override]
Sendet ein Ereignis in den Ereignisablauf. | Stage | ||
Gibt ein Rechteck zurück, das den Bereich des Anzeigeobjekts in Bezug auf das Koordinatensystem des targetCoordinateSpace-Objekts definiert. | DisplayObject | ||
Gibt die untergeordnete Anzeigeobjektinstanz zurück, die sich an der angegebenen Indexposition befindet. | DisplayObjectContainer | ||
Gibt das untergeordnete Anzeigeobjekt für den angegebenen Namen zurück. | DisplayObjectContainer | ||
Gibt die Indexposition einer untergeordneten DisplayObject-Instanz zurück. | DisplayObjectContainer | ||
Gibt ein Array an Objekten zurück, die unter dem angegebenen Punkt liegen und dieser DisplayObjectContainer-Instanz untergeordnet sind (auch über mehrere Unterordnungsstufen hinweg). | DisplayObjectContainer | ||
Gibt ein Rechteck zurück, das die Begrenzung des Anzeigeobjekts (ohne etwaige Striche oder Formen) definiert, und zwar aufgrund des vom Parameter „targetCoordinateSpace“ definierten Koordinatensystems. | DisplayObject | ||
Konvertiert das point-Objekt von den (globalen) Bühnenkoordinaten in die (lokalen) Koordinaten des Anzeigeobjekts. | DisplayObject | ||
Konvertiert einen zweidimensionale Punkt von den (globalen) Bühnenkoordinaten in die dreidimensionalen (lokalen) Koordinaten des Anzeigeobjekts. | DisplayObject | ||
[override]
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | Stage | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Untersucht den Begrenzungsrahmen des Anzeigeobjekts, um festzustellen, ob er sich mit dem Begrenzungsrahmen des obj-Anzeigeobjekts überschneidet. | DisplayObject | ||
Wertet das Anzeigeobjekt aus, um festzustellen, ob es den durch die Parameter „x“ und „y“ festgelegten Punkt überdeckt oder schneidet. | DisplayObject | ||
Durch Aufrufen der invalidate()-Methode wird Flash-Laufzeitumgebungen signalisiert, dass bei nächster Gelegenheit die Anzeigeliste neu gezeichnet werden muss (z. B., wenn der Abspielkopf in ein neues Bild tritt). | Stage | ||
Legt fest, ob die Stage.focus-Eigenschaft aus Sicherheitsgründen den Wert „null“ zurückgibt. | Stage | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Konvertiert einen dreidimensionalen Punkt der dreidimensionalen (lokalen) Koordinaten des Anzeigeobjekts in einen zweidimensionalen Punkt der (globalen) Bühnenkoordinaten. | DisplayObject | ||
Konvertiert das point-Objekt von den (lokalen) Koordinaten des Anzeigeobjekts in die (globalen) Bühnenkoordinaten. | DisplayObject | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Entfernt die angegebene untergeordnete DisplayObject-Instanz aus der Child-Liste der DisplayObjectContainer-Instanz. | DisplayObjectContainer | ||
[override]
Entfernt ein untergeordnetes Anzeigeobjekt aus der angegebenen Indexposition in der Child-Liste des Anzeigeobjekt-Containers. | Stage | ||
Entfernt alle untergeordneten DisplayObject-Instanzen aus der Liste der untergeordneten Elemente der DisplayObjectContainer-Instanz. | DisplayObjectContainer | ||
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | ||
Blendet eine virtuelle Tastatur ein. | InteractiveObject | ||
Legt die Bühne auf eine Ausrichtung mit dem angegebenen Seitenverhältnis fest. | Stage | ||
[override]
Ändert die Position eines vorhandenen untergeordneten Objekts im Anzeigeobjekt-Container. | Stage | ||
Stellt die Bühne auf die angegebene Ausrichtung ein. | Stage | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Stoppt rekursiv die Ausführung von allen Movieclips, die auf diesem Objekt gerootet sind. | DisplayObjectContainer | ||
Kehrt die z-Reihenfolge (von vorne nach hinten) der beiden angegebenen untergeordneten Objekte um. | DisplayObjectContainer | ||
[override]
Kehrt die z-Reihenfolge (von vorne nach hinten) der untergeordneten Objekte an den beiden angegebenen Indexpositionen in der Child-Liste um. | Stage | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object | ||
[override]
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | Stage |
Ereignis | Übersicht | Definiert von | ||
---|---|---|---|---|
[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | |||
Wird ausgelöst, wenn ein Objekt der Anzeigeliste hinzugefügt wird. | DisplayObject | |||
Wird ausgelöst, wenn ein Anzeigeobjekt der Anzeigeliste für die Bühne hinzugefügt wird. Dies erfolgt entweder direkt oder über das Hinzufügen einer Unterstruktur, die das Anzeigeobjekt enthält. | DisplayObject | |||
Wird ausgelöst, wenn die browserZoomFactor-Eigenschaft des Stage-Objekts geändert wird. | Stage | |||
Wird ausgelöst, wenn der Benutzer aus dem Kontextmenü die Option „Löschen“ wählt. | InteractiveObject | |||
Wird ausgelöst, wenn ein Benutzer die Haupttaste des Zeigegeräts über derselben InteractiveObject-Instanz drückt und wieder loslässt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer das Kontextmenü, das mit diesem interaktiven Objekt verknüpft ist, in einer AIR-Anwendung einblendet. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer die plattformspezifische Tastenkombination für „Kopieren“ aktiviert oder im Kontextmenü des Texts „Kopieren“ wählt. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer die plattformspezifische Tastenkombination für „Ausschneiden“ aktiviert oder im Kontextmenü des Texts „Ausschneiden“ wählt. | InteractiveObject | |||
[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | |||
Wird ausgelöst, wenn der Benutzer die Haupttaste des Zeigegeräts zweimal schnell hintereinander über dem gleichen InteractiveObject-Objekt drückt und das doubleClickEnabled-Flag des Objekts „true“ lautet. | InteractiveObject | |||
[broadcast event] Wird ausgelöst, wenn der Abspielkopf ein neues Bild erreicht. | DisplayObject | |||
[broadcast event] Wird ausgelöst, wenn der Abspielkopf das aktuelle Bild verlässt. | DisplayObject | |||
Wird ausgelöst, nachdem ein Anzeigeobjekt den Fokus erhalten hat. | InteractiveObject | |||
Wird ausgelöst, nachdem ein Anzeigeobjekt den Fokus verloren hat. | InteractiveObject | |||
[broadcast event] Wird ausgelöst, nachdem die Konstruktoren von Bildanzeigeobjekten ausgeführt wurden, bevor Bildskripten ausgeführt wurden. | DisplayObject | |||
Wird ausgelöst, wenn der Vollbildmodus für das Stage-Objekt aktiviert oder deaktiviert wird. | Stage | |||
Wird abgesetzt, wenn der Benutzer einen Kontaktpunkt entlang der Kante der Touch-Oberfläche mit einer InteractiveObject-Instanz erstellt (z. B. durch Tippen entlang der Kante der Touch-Oberfläche auf Siri Remote für Apple TV). Bei einigen Geräten könnte dieser Kontakt auch als eine Kombination von verschiedenen Kontaktereignissen ausgelegt werden. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer auf zwei Kontaktpunkte über derselben InteractiveObject-Instanz auf einem berührungsempfindlichen Gerät drückt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen zwei Finger auf ein Anzeigeobjekt drückt und wieder loslässt). | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer einen Berührungspunkt über die InteractiveObject-Instanz auf einem berührungsempfindlichen Gerät bewegt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger über ein Anzeigeobjekt von links nach rechts bewegt). | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer eine Drehgeste an einem Kontaktpunkt mit einer InteractiveObject-Instanz ausführt (zum Beispiel mit zwei Fingern den Bildschirm eines Mobiltelefons oder Tablets berührt und die Finger dann über einem Anzeigeobjekt dreht). | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer eine Swipe-Geste an einem Kontaktpunkt mit einer InteractiveObject-Instanz ausführt (zum Beispiel mit drei Fingern den Bildschirm eines Mobiltelefons oder Tablets berührt und die Finger dann parallel über ein Anzeigeobjekt bewegt). | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer einen Kontaktpunkt mit einer InteractiveObject-Instanz erstellt und dann auf ein berührungsempfindliches Gerät tippt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen mehrere Finger auf einem Anzeigeobjekt platziert, um ein Menü zu öffnen, und dann mit einem Finger tippt, um einen Menüpunkt auszuwählen). | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer eine Zoom-Geste an einem Kontaktpunkt mit einer InteractiveObject-Instanz ausführt (zum Beispiel mit zwei Fingern den Bildschirm eines Mobiltelefons oder Tablets berührt und die Finger dann schnell über einem Anzeigeobjekt spreizt). | InteractiveObject | |||
Dieses Ereignis wird an jede Client-Anwendung abgesetzt, die die Inline-Eingabe mit einem IME unterstützt | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer eine Taste drückt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer versucht, den Fokus mithilfe der Tastatur zu ändern. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer eine Taste loslässt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer die mittlere Taste des Zeigegeräts über derselben InteractiveObject-Instanz drückt und loslässt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer die mittlere Taste des Zeigegeräts über einer InteractiveObject-Instanz drückt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz loslässt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz drückt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer versucht, den Fokus mithilfe eines Zeigegeräts zu ändern. | InteractiveObject | |||
Wird vom Stage-Objekt abgesetzt, wenn der Zeiger aus dem Bühnenbereich verschoben wird. | Stage | |||
Wird ausgelöst, wenn der Benutzer das Zeigegerät bewegt, während es sich auf einer InteractiveObject-Instanz befindet. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer das Zeigegerät von einer InteractiveObject-Instanz wegbewegt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer das Zeigegerät auf eine InteractiveObject-Instanz bewegt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz loslässt. | InteractiveObject | |||
Wird ausgelöst, wenn das Mausrad über einer InteractiveObject-Instanz gedreht wird. | InteractiveObject | |||
Wird vom InteractiveObject-Ziehinitiator ausgelöst, wenn der Benutzer die Ziehbewegung beendet. | InteractiveObject | |||
Wird vom InteractiveObject-Zielobjekt ausgelöst, wenn ein gezogenes Objekt darauf abgelegt wird und das Ablegen mit einem Aufruf von „DragManager.acceptDragDrop()“ akzeptiert wurde. | InteractiveObject | |||
Wird von einer InteractiveObject-Instanz ausgelöst, wenn eine Ziehbewegung in ihre Begrenzungen eintritt. | InteractiveObject | |||
Wird von einer InteractiveObject-Instanz ausgelöst, wenn eine Ziehbewegung ihre Begrenzungen verlässt. | InteractiveObject | |||
Wird von einer InteractiveObject-Instanz kontinuierlich ausgelöst, während eine Ziehbewegung innerhalb ihrer Begrenzungen verbleibt. | InteractiveObject | |||
Wird am Anfang eines Ziehvorgangs von der InteractiveObject-Instanz ausgelöst, die als Ziehinitiator im DragManager.doDrag()-Aufruf festgelegt ist. | InteractiveObject | |||
Wird während eines Ziehvorgangs von der InteractiveObject-Instanz ausgelöst, die als Ziehinitiator im DragManager.doDrag()-Aufruf festgelegt ist. | InteractiveObject | |||
Wird vom Stage-Objekt abgesetzt, wenn sich die Bühnenausrichtung ändert. | Stage | |||
Wird vom Stage-Objekt abgesetzt, wenn die Änderung der Bühnenausrichtung beginnt. | Stage | |||
Wird abgesetzt, wenn der Benutzer die plattformspezifische Tastenkombination für „Einfügen“ aktiviert oder im Kontextmenü des Texts „Einfügen“ wählt. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer einen aktiven Eingabestift unter den Schwellenwert für die Abstandserkennung des Bildschirms senkt. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer einen aktiven Eingabestift über den Schwellenwert für die Abstandserkennung des Bildschirms anhebt. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer den aktiven Eingabestift über den Bildschirm bewegt, während er innerhalb des Schwellenwerts der Abstandserkennung bleibt. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer den aktiven Eingabestift von diesem InteractiveObject wegbewegt, während er innerhalb des Schwellenwerts der Abstandserkennung auf dem Bildschirm bleibt. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer den aktiven Eingabestift direkt über dieses InteractiveObject bewegt, während er innerhalb des Schwellenwerts der Abstandserkennung auf dem Bildschirm bleibt. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer einen aktiven Eingabestift von diesem InteractiveObject und seinen untergeordneten Elementen wegbewegt, während er innerhalb des Schwellenwerts der Abstandserkennung auf dem Bildschirm bleibt. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer einen aktiven Eingabestift von außerhalb der Nachfolgerstruktur des Objekts in der Anzeigeliste über dieses InteractiveObject bewegt (und dabei innerhalb des Schwellenwerts für die Abstandserkennung auf dem Bildschirm bleibt). | InteractiveObject | |||
Wird abgesetzt, wenn ein Benutzer die Taste des Zeigegeräts loslässt, nachdem er die Taste über einer InteractiveObject-Instanz gedrückt und das Zeigegerät dann von der InteractiveObject-Instanz wegbewegt hat. | InteractiveObject | |||
Wird ausgelöst, wenn ein Objekt aus der Anzeigeliste entfernt werden soll. | DisplayObject | |||
Wird ausgelöst, wenn ein Anzeigeobjekt aus der Anzeigeliste entfernt werden soll. Dies erfolgt entweder direkt oder über das Entfernen einer Unterstruktur, die das Anzeigeobjekt enthält. | DisplayObject | |||
[broadcast event] Wird ausgelöst, wenn die Anzeigeliste kurz davor steht, aktualisiert und neu gezeichnet zu werden. | DisplayObject | |||
Wird ausgelöst, wenn die scaleMode-Eigenschaft des Stage-Objekts auf „StageScaleMode.NO_SCALE“ gesetzt und die Größe der SWF-Datei verändert wird. | Stage | |||
Wird ausgelöst, wenn der Benutzer die rechte Taste des Zeigegeräts über derselben InteractiveObject-Instanz drückt und loslässt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz drückt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz loslässt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer das Zeigegerät von einer InteractiveObject-Instanz wegbewegt. | InteractiveObject | |||
Wird ausgelöst, wenn der Benutzer das Zeigegerät auf eine InteractiveObject-Instanz bewegt. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer die plattformspezifische Tastenkombination für „Alles auswählen“ aktiviert oder im Kontextmenü des Texts „Alles auswählen“ wählt. | InteractiveObject | |||
Wird sofort nach dem Einblenden der Softwaretastatur abgesetzt. | InteractiveObject | |||
Wird direkt vor dem Einblenden der Softwaretastatur abgesetzt. | InteractiveObject | |||
Wird sofort nach dem Ausblenden der Softwaretastatur abgesetzt. | InteractiveObject | |||
Wird vom Stage-Objekt abgesetzt, wenn sich der Status der stageVideos-Eigenschaft ändert. | Stage | |||
Wird ausgelöst, wenn sich der Wert des tabChildren-Flags des Objekts ändert. | InteractiveObject | |||
Wird ausgelöst, wenn sich das tabEnabled-Flag des Objekts ändert. | InteractiveObject | |||
Wird ausgelöst, wenn sich der Wert der tabIndex-Eigenschaft des Objekts ändert. | InteractiveObject | |||
Wird ausgelöst, wenn ein Benutzer ein oder mehrere Textzeichen eingibt. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer ein berührungsempfindliches Gerät erstmals berührt (zum Beispiel mit dem Finger das Touchscreen eines Mobiltelefons oder Tablets berührt). | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer den Kontaktpunkt bei einem berührungsempfindlichen Gerät entfernt (zum Beispiel den Finger vom Touchscreen eines Mobiltelefons oder Tablets hebt). | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer das Gerät berührt, und zwar kontinuierlich, bis der Kontaktpunkt entfernt wird. | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer den Kontaktpunkt bei einem berührungsempfindlichen Gerät von einer InteractiveObject-Instanz wegbewegt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger von einem Anzeigeobjekt zu einem anderen zieht). | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer den Kontaktpunkt bei einem berührungsempfindlichen Gerät über eine InteractiveObject-Instanz bewegt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger von einem Punkt außerhalb des Anzeigeobjekts auf einen Punkt über einem Anzeigeobjekt zieht). | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer den Kontaktpunkt bei einem berührungsempfindlichen Gerät von einer InteractiveObject-Instanz wegbewegt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger von einem Anzeigeobjekt auf einen Punkt außerhalb des Anzeigeobjekts zieht). | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer den Kontaktpunkt bei einem berührungsempfindlichen Gerät über eine InteractiveObject-Instanz bewegt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger von einem Punkt außerhalb des Anzeigeobjekts auf einen Punkt über einem Anzeigeobjekt zieht). | InteractiveObject | |||
Wird abgesetzt, wenn der Benutzer den Kontaktpunkt über derselben InteractiveObject-Instanz anhebt, auf der der Kontakt eingeleitet wurde (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger von einem einzelnen Kontaktpunkt hebt). | InteractiveObject | |||
Wird vom Stage-Objekt ausgelöst, wenn sich der Status der vsync-Eigenschaft ändert. | Stage |
align | Eigenschaft |
align:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ein Wert aus der StageAlign-Klasse, der die Ausrichtung der Bühne im Flash Player oder Browser bestimmt. Folgende Werte sind gültig:
Wert | Vertical Alignment | Horizontal |
---|---|---|
StageAlign.TOP | Top | Center |
StageAlign.BOTTOM | Bottom | Center |
StageAlign.LEFT | Center | Left |
StageAlign.RIGHT | Center | Right |
StageAlign.TOP_LEFT | Top | Left |
StageAlign.TOP_RIGHT | Top | Right |
StageAlign.BOTTOM_LEFT | Bottom | Left |
StageAlign.BOTTOM_RIGHT | Bottom | Right |
Die Eigenschaft align
ist nur für ein Objekt verfügbar, das sich in derselben Sicherheits-Sandbox befindet wie der Bühneneigentümer (die Haupt-SWF-Datei). Um dies zu verhindern, kann der Bühneneigentümer der Domäne des aufrufenden Objekts die entsprechende Berechtigung erteilen, indem er die Methode Security.allowDomain()
oder Security.alowInsecureDomain()
aufruft. Weitere Informationen finden Sie im Kapitel „Sicherheit“ des ActionScript 3.0 Entwicklerhandbuchs.
Implementierung
public function get align():String
public function set align(value:String):void
Verwandte API-Elemente
allowsFullScreen | Eigenschaft |
allowsFullScreenInteractive | Eigenschaft |
autoOrients | Eigenschaft |
autoOrients:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2 |
Legt fest, ob die Bühne automatisch die Ausrichtung ändert, wenn die Ausrichtung des Geräts geändert wird.
Der Anfangswert dieser Eigenschaft wird vom autoOrients
-Element des Anwendungsdeskriptors abgeleitet und ist standardmäßig false
. Wenn die Eigenschaft auf false
geändert wird, kann das Verhalten nicht garantiert werden. Bei einigen Geräten behält die Bühne ihre aktuelle Ausrichtung. Bei anderen ändert sich die Bühnenausrichtung zu einer vom Gerät definierten Standardausrichtung, nach der keine weiteren Ausrichtungsänderungen möglich sind.
Unterstützung von AIR-Profilen: Diese Funktion wird auf mobilen Geräten unterstützt, nicht jedoch auf Desktopbetriebssystemen oder Geräten mit AIR für TV. Mit der Stage.supportsOrientantionChange
-Eigenschaft können Sie testen, ob zur Laufzeit Unterstützung gegeben ist. Weitere Informationen zum AIR-Support über mehrere Profile finden Sie unter Unterstützung von AIR-Profilen.
Implementierung
public function get autoOrients():Boolean
public function set autoOrients(value:Boolean):void
Verwandte API-Elemente
browserZoomFactor | Eigenschaft |
browserZoomFactor:Number
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 15 |
Legt den Browser-Zoomfaktor fest. Änderungen des Browser-Zoomfaktors wirken sich auf den Skalierungsfaktor der Bühne aus.
Implementierung
public function get browserZoomFactor():Number
color | Eigenschaft |
colorCorrection | Eigenschaft |
colorCorrection:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Steuert die Farbkorrektur der Flash-Laufzeitumgebung für Anzeigen. Die Farbkorrektur funktioniert nur, wenn dem Hauptmonitor ein gültiges ICC-Farbprofil zugewiesen ist, in dem die speziellen Farbattribute des Geräts angegeben sind. Standardmäßig versucht die Flash-Laufzeitumgebung, die Farbkorrektur des Hosts (normalerweise ein Browser) nachzubilden.
Verwenden Sie die Stage.colorCorrectionSupport
-Eigenschaft, um festzustellen, ob die Farbkorrektur auf dem aktuellen System verfügbar und als Standard festgelegt ist. Ist die Farbkorrektur verfügbar, wird davon ausgegangen, dass alle Farben der Bühne im sRGB-Farbraum, dem am weitesten verbreiteten Farbraum, liegen. Quellprofile von Eingabegeräten werden bei der Farbkorrektur nicht berücksichtigt. Es erfolgt keine Farbkorrektur der Eingabe. Es wird lediglich die Bühnenausgabe dem ICC-Farbprofil des Hauptmonitors zugeordnet.
Allgemein gesagt sind die Vorteile des Farbmanagements folgende: berechenbare und konsistente Farbe, bessere Konvertierung, genaueres Proofing und effizientere Ausgabe über mehrere Medien hinweg. Beachten Sie jedoch, dass das Farbmanagement keine perfekten Konvertierungen leisten kann, da Geräte oder Ausgangsbilder einen unterschiedlichen Farbumfang haben. Weiterhin ist trotz Farbmanagement das Einrichten benutzerdefinierter oder bearbeiteter Profile nötig. Farbprofile sind abhängig von Browsern, Betriebssystemen (OS), Betriebssystemerweiterungen, Ausgabegeräten und dem Anwendungssupport.
Die Anwendung von Farbkorrektur beeinträchtigt die Leistung der Flash-Laufzeitumgebung. Die Farbkorrektur einer Flash-Laufzeitumgebung ist eine Farbkorrektur im Dokumentstil, da alle SWF-Filme als Dokumente mit impliziten sRGB-Profilen betrachtet werden. Verwenden Sie die Stage.colorCorrectionSupport
-Eigenschaft, um die Flash-Laufzeitumgebung anzuweisen, Farben auf den Anzeigefarbraum zu korrigieren, wenn die SWF-Datei (Dokument) angezeigt wird. Flash-Laufzeitumgebungen kompensieren nur Unterschiede zwischen Monitoren, nicht zwischen Eingabegeräten (Kamera, Scanner usw.)
Die drei möglichen Werte sind Strings mit entsprechenden Konstanten in der flash.display.ColorCorrection-Klasse:
"default"
: Verwendet dieselbe Farbkorrektur wie das Hostsystem"on"
: Farbkorrektur immer durchführen"off"
: Farbkorrektur nie durchführen
Implementierung
public function get colorCorrection():String
public function set colorCorrection(value:String):void
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
Stage.colorCorrection
-Wert kein Wert aus der ColorCorrection-Klasse ist, meldet die Prozedur einen Fehler.
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 | Eigenschaft |
colorCorrectionSupport:String
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt an, ob die Flash-Laufzeitumgebung auf einem Betriebssystem ausgeführt wird, das Farbkorrektur unterstützt, und ob das Farbprofil des primären (Haupt-) Bildschirms von der Flash-Laufzeitumgebung gelesen und interpretiert wird. Diese Eigenschaft gibt auch den Standardstatus der Farbkorrektur des Hostsystems (normalerweise der Browser) zurück. Aktuell gültige Rückgabewerte sind:
Die drei möglichen Werte sind Strings mit entsprechenden Konstanten in der flash.display.ColorCorrectionSupport-Klasse:
"unsupported"
: Die Farbkorrektur ist nicht verfügbar."defaultOn"
: Farbkorrektur immer ausführen."defaultOff"
: Farbkorrektur nie ausführen.
Implementierung
public function get colorCorrectionSupport():String
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
stage.colorCorrectionSupport
überprüft, um festzustellen, ob er auf DEFAULT_ON
oder DEFAULT_OFF
eingestellt ist; dies sind Werte aus der ColorCorrectionSupport-Klasse. Wenn die Eigenschaft einen dieser Werte aufweist, wird im Textfeld der aktuelle Wert angezeigt. Andernfalls, wenn der Wert weder DEFAULT_ON
noch DEFAULT_OFF
ist, wird im Textfeld „unsupported“ (nicht unterstützt) angezeigt.
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 | Eigenschaft |
contentsScaleFactor | Eigenschaft |
contentsScaleFactor:Number
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 11.5 |
Gibt den effektiven Pixelskalierungsfaktor der Bühne an. Dieser Wert ist 1 auf Standardbildschirmen und HiDPI(Retina Display)-Bildschirmen. Wenn die Bühne auf HiDPI-Bildschirmen gerendert wird, wird die Pixelauflösung verdoppelt, auch wenn der Bühnenskalierungsmodus auf StageScaleMode.NO_SCALE eingestellt ist. Stage.stageWidth und Stage.stageHeight werden weiterhin in klassischen Pixeleinheiten angegeben.
Implementierung
public function get contentsScaleFactor():Number
deviceOrientation | Eigenschaft |
deviceOrientation:String
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2 |
Die physische Ausrichtung des Geräts.
Bei Geräten mit herausschiebbarer Tastatur hat der Zustand der Tastatur eine höhere Priorität beim Bestimmen der Geräteausrichtung als die vom Beschleunigungssensor erkannte Ausrichtung. Bei einem hochformatigen Gerät mit seitlich angebrachter Tastatur meldet die deviceOrientation
-Eigenschaft deshalb ROTATED_LEFT
, wenn die Tastatur geöffnet ist, unabhängig davon, wie der Benutzer das Gerät hält.
Verwenden Sie die in der StageOrientation-Klasse definierten Konstanten, wenn Sie Werte für diese Eigenschaft festlegen oder vergleichen.
Unterstützung von AIR-Profilen: Diese Funktion wird auf mobilen Geräten unterstützt, nicht jedoch auf Desktopbetriebssystemen oder Geräten mit AIR für TV. Mit der Stage.supportsOrientationChange
-Eigenschaft können Sie testen, ob zur Laufzeit Unterstützung gegeben ist. Weitere Informationen zum AIR-Support über mehrere Profile finden Sie unter Unterstützung von AIR-Profilen.
Implementierung
public function get deviceOrientation():String
Verwandte API-Elemente
displayState | Eigenschaft |
displayState:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9.0.28.0, Flash Lite 4 |
Ein Wert aus der StageDisplayState-Klasse, der festlegt, welcher Anzeigestatus zu verwenden ist. Folgende Werte sind gültig:
StageDisplayState.FULL_SCREEN
Legt fest, dass die AIR-Anwendung oder der Inhalt im Flash Player die Bühne auf den gesamten Bildschirm des Benutzers erweitert. Die Tastatureingabe ist deaktiviert mit Ausnahme einer begrenzten Auswahl von Tasten für nichtdruckbare Zeichen.StageDisplayState.FULL_SCREEN_INTERACTIVE
: Legt fest, dass die Anwendung die Bühne auf den gesamten Bildschirm des Benutzers ausdehnt, wobei die Tastatureingabe erlaubt ist. (Verfügbar in AIR und Flash Player ab Flash Player 11.3.)StageDisplayState.NORMAL
: Setzt die Bühne auf den Standardanzeigemodus der Bühne zurück.
Das Skalierverhalten des Films im Vollbildmodus wird durch die scaleMode
-Einstellung bestimmt (diese wird mithilfe der Stage.scaleMode
-Eigenschaft oder der embed
-Tageinstellungen der SWF-Datei in der HTML-Datei eingerichtet). Wenn die scaleMode
-Eigenschaft den Wert noScale
hat, während die Anwendung in den Vollbildmodus wechselt, werden die width
- und height
-Eigenschaften der Bühne aktualisiert und das Stage-Objekt setzt ein resize
-Ereignis ab. Wenn ein anderer Skalierungsmodus eingestellt wird, werden die Bühne und ihr Inhalt skaliert, um die neuen Abmessungen auszufüllen. Das Stage-Objekt behält seine ursprünglichen width
- und height
-Werte und setzt kein resize
-Ereignis ab.
Die folgenden Einschränkungen gelten für SWF-Dateien, die innerhalb einer HTML-Seite wiedergegeben werden (nicht für SWF-Dateien, die den eigenständigen Flash Player oder die AIR-Laufzeitumgebung verwenden):
- Um den Vollbildmodus zu aktivieren, fügen Sie den Parameter
allowFullScreen
den Tagsobject
undembed
auf der HTML-Seite hinzu, die die SWF-Datei enthält. Dabei mussallowFullScreen
wie im folgenden Beispiel auf"true"
gesetzt sein:<param name="allowFullScreen" value="true" /> ... <embed src="example.swf" allowFullScreen="true" ... >
Auf einer HTML-Seite können die Tags zum Einbetten von SWF auch mithilfe eines Skripts erzeugt werden. Sie müssen das Skript ändern, damit die richtigen
allowFullScreen
-Einstellungen eingefügt werden. Von Flash Professional und Flash Builder erzeugte HTML-Seiten verwenden dieAC_FL_RunContent()
-Funktion, um Verweise auf SWF-Dateien einzubetten. Sie müssen dann dieallowFullScreen
-Parametereinstellungen wie folgt hinzufügen:AC_FL_RunContent( ... "allowFullScreen", "true", ... )
- Der Vollbildmodus wird als Reaktion auf einen Mausklick oder das Drücken einer Taste durch Benutzer initiiert. Der Film kann
Stage.displayState
nicht ohne Eingabe von Benutzern ändern. Flash-Laufzeitumgebungen beschränken Tastatureingaben im Vollbildmodus. Zu den gültigen Eingaben gehören Tastaturbefehle, die den Vollbildmodus beenden sowie Tasten für nicht druckbare Zeichen wie Pfeiltasten, Leertaste, Umschalt-Taste und Tabulatortasten. (Verwenden Sie den interaktiven Vollbildmodus, um Eingaben mit weiteren Tasten zu unterstützen.) Tastaturbefehle zum Beenden des Vollbildmodus sind: Escape (Windows, Linux, Mac), Strg+W (Windows), Befehlstaste+W (Mac) und Alt+F4. - Ab Flash Player 9.0.115.0 und höher funktioniert der Vollbildmodus im fensterlosen Modus genau wie im Fenstermodus. Wenn Sie den Fenstermodus (
wmode
im HTML-Code) auf „Undurchsichtig ohne Fenster“ (opaque
) oder „Transparent ohne Fenster“ (transparent
) einstellen, kann das Vollbild initiiert werden, das Vollbildfenster ist jedoch immer undurchsichtig. - Um den interaktiven Vollbildmodus zu aktivieren, der Tastatureingaben unterstützt, fügen Sie den Parameter
allowFullScreenInteractive
den Tagsobject
undembed
auf der HTML-Seite hinzu, die die SWF-Datei enthält. Dabei mussallowFullScreenInteractive
wie im folgenden Beispiel auf"true"
gesetzt sein:<param name="allowFullScreenInteractive" value="true" /> ...
Diese Einschränkungen gelten nicht für SWF-Inhalt, der im eigenständigen Flash Player oder in AIR ausgeführt wird.
Beim Wechsel in den Vollbildmodus blendet die Flash-Laufzeitumgebung kurz eine Benachrichtigung über dem SWF-Inhalt an. Damit wird den Benutzern mitgeteilt, dass der Vollbildmodus aufgerufen wird und sie diesen mit der Escape-Taste beenden können.
Beim Wechsel in den interaktiven Vollbildmodus blendet Flash Player eine Bestätigungsaufforderung über dem SWF-Inhalt ein. So können Benutzer die erweiterte Tastatureingabe (einschließlich Tasten für druckbare Zeichen) zulassen und werden darüber informiert, dass sie den interaktiven Vollbildmodus mit der Escape-Taste beenden können. Sie sollten keine Annahmen bezüglich des Aussehens und der Position der Bestätigungsmeldung machen. Sie können feststellen, ob ein Benutzer den Zugriff auf die erweiterte Tastatureingabe zugelassen hat, indem Sie einen Listener für das FullScreenEvent.FULL_SCREEN_INTERACTIVE_ACCEPTED
-Ereignis verwenden.
Für AIR-Inhalt, der im Vollbildmodus ausgeführt wird, werden der Bildschirmschoner und die Energiesparoptionen während der Wiedergabe von Video-Inhalt deaktiviert, bis das Video gestoppt oder der Vollbildmodus beendet wird.
Unter Linux ist das Setzen von displayState
auf StageDisplayState.FULL_SCREEN
oder StageDisplayState.FULL_SCREEN_INTERACTIVE
ein asynchroner Vorgang.
Implementierung
public function get displayState():String
public function set displayState(value:String):void
Auslöser
SecurityError — Durch Aufrufen der displayState -Eigenschaft eines Stage-Objekts wird für jeden Aufrufer, der sich nicht in derselben Sicherheits-Sandbox wie der Bühneneigentümer (die Haupt-SWF-Datei) befindet, eine Ausnahme ausgelöst. Um dies zu verhindern, kann der Bühneneigentümer der Domäne des Aufrufers die entsprechende Berechtigung erteilen, indem er die Methode Security.allowDomain() oder Security.allowInsecureDomain() aufruft. Weitere Informationen finden Sie im Kapitel „Sicherheit“ des ActionScript 3.0 Entwicklerhandbuchs. Es wird ein Sicherheitsfehler ausgelöst, wenn versucht wird, die displayState -Eigenschaft bei angezeigtem Einstellungsdialogfeld einzurichten, ohne dass eine Benutzerreaktion erfolgt, oder wenn das allowFullScreen -Attribut des HTML-Tags param oder embed nicht auf true gesetzt ist.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
displayState
-Eigenschaft ändern. Hinweis: Aufgrund von Sicherheitsbeschränkungen kann der Vollbildmodus nur in bestimmten Situationen ausgelöst werden, z. B. wenn Benutzer auf die entsprechende Option klicken oder eine Taste drücken. Wenn die allowFullScreen-Eigenschaft in einem Browser ausgeführt wird, muss sie auf „true“ gesetzt sein.
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 | Eigenschaft |
focus:InteractiveObject
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Das interaktive Objekt mit Tastaturfokus bzw. null
, wenn der Fokus nicht gesetzt ist oder wenn das Objekt mit dem Fokus zu einer Sicherheits-Sandbox gehört, zu der das aufrufende Objekt keinen Zugang hat.
Implementierung
public function get focus():InteractiveObject
public function set focus(value:InteractiveObject):void
Auslöser
Error — Gibt eine Fehlermeldung aus, wenn der Fokus nicht auf das Ziel gesetzt werden kann.
|
Beispiel ( Verwendung dieses Beispiels )
myTF
gesetzt, sodass der Benutzer mit dem Tippen beginnen kann, ohne vorher auf das Feld zu klicken. Auf mobilen Geräten mit iOS und Android sowie auf Geräten mit tvOS muss der Benutzer in das Textfeld klicken, um die Softwaretastatur zu aktivieren. Wenn Sie diesen Code in der Benutzeroberfläche des Authoring-Tools testen, können Sie nur auf wenige Tasten zugreifen, da der Host (Browser oder Tool) die meisten Tastenbetätigungen zuerst interpretiert. Um die beabsichtigte Funktionsweise dieses Beispiels zu sehen, kompilieren Sie es und führen Sie die SWF-Datei aus.
var myTF:TextField = new TextField(); myTF.border =true; myTF.type = TextFieldType.INPUT; addChild(myTF); stage.focus= myTF;
frameRate | Eigenschaft |
frameRate:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ruft die Bildrate der Bühne ab und setzt sie gegebenenfalls neu. Die Bildrate wird als Bilder pro Sekunde definiert. Standardmäßig wird die Bildrate von der zuerst geladenen SWF-Datei übernommen. Der zulässige Bereich für die Bildrate liegt zwischen 0,01 und 1000 Bildern pro Sekunde.
Hinweis: Eine hohe Bildrate kann von einer Anwendung möglicherweise nicht eingehalten werden, entweder weil die Zielplattform nicht schnell genug ist oder weil der Player mit der vertikalen Austastlücke des Anzeigegeräts (in der Regel 60 Hz auf LCD-Geräten) synchronisiert ist. In manchen Fällen ist es auch möglich, dass die Zielplattform die maximale Bildrate herabsetzt, wenn eine hohe CPU-Auslastung erwartet wird.
Bei Inhalt, der in Adobe AIR ausgeführt wird, gilt Folgendes: Wenn die framfeRate
-Eigenschaft für ein Stage-Objekt eingestellt wird, ändert dies die Bildrate für alle Stage-Objekte (von unterschiedlichen NativeWindow-Objekten verwendet).
Implementierung
public function get frameRate():Number
public function set frameRate(value:Number):void
Auslöser
SecurityError — Durch Aufrufen der frameRate -Eigenschaft eines Stage-Objekts wird für jeden Aufrufer, der sich nicht in derselben Sicherheits-Sandbox wie der Bühneneigentümer (die Haupt-SWF-Datei) befindet, eine Ausnahme ausgelöst. Um dies zu verhindern, kann der Bühneneigentümer der Domäne des Aufrufers die entsprechende Berechtigung erteilen, indem er die Methode Security.allowDomain() oder Security.allowInsecureDomain() aufruft. Weitere Informationen finden Sie im Kapitel „Sicherheit“ des ActionScript 3.0 Entwicklerhandbuchs.
|
fullScreenHeight | Eigenschaft |
fullScreenHeight:uint
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Setzt die Höhe des Monitors, der verwendet wird, wenn der Vollbildmodus aktiviert wird, zurück, falls dieser Modus sofort aufgerufen wird. Wenn der Benutzer über mehrere Monitore verfügt, wird der Monitor verwendet, auf dem sich zu diesem Zeitpunkt der größte Teil der Bühne befindet.
Hinweis: Falls der Benutzer die Möglichkeit hat, zwischen dem Abrufen des Wertes und dem Wechseln in den Vollbildmodus den Browser von einem Monitor zu einem anderen zu verschieben, könnte der Wert inkorrekt sein. Wenn Sie den Wert in eine Ereignisprozedur abrufen, die Stage.displayState
auf StageDisplayState.FULL_SCREEN
setzt, ist der Wert korrekt.
Dies ist die Höhe des Monitors in Pixel; dieser Wert ist identisch mit der Höhe der Bühne, wenn Stage.align
auf den Wert StageAlign.TOP_LEFT
und Stage.scaleMode
auf den Wert StageScaleMode.NO_SCALE
gesetzt ist.
Implementierung
public function get fullScreenHeight():uint
Verwandte API-Elemente
fullScreenSourceRect
fullScreenWidth
scaleMode
StageDisplayState
flash.events.Event.RESIZE
flash.events.FullScreenEvent
Beispiel ( Verwendung dieses Beispiels )
enterFullScreen()
ausgelöst, die die Eigenschaft fullScreenSourceRect
festlegt und den Vollbildmodus aktiviert. Um die Eigenschaft fullScreenSourceRect
festzulegen, beginnt die Ereignisprozedur mit der Position und den Abmessungen des roten Quadrats. Danach wird das Seitenverhältnis (Breite durch Höhe) des roten Quadrats mit dem Seitenverhältnis der Bühne im Vollbild verglichen, sodass das Rechteck (fullScreenSourceRect
) dem Seitenverhältnis des Bildschirms entsprechend erweitert werden kann. Im Ergebnis nimmt das rote Quadrat die gesamte Höhe des Bildschirms ein, während an beiden Seiten der grüne Hintergrund sichtbar ist. Wenn das Seitenverhältnis nicht angepasst worden wäre, wäre anstelle des grünen Hintergrunds auf beiden Seiten die Hintergrundfarbe der Bühne (standardmäßig weiß) zu sehen.
Hinweis: Testen Sie dieses Beispiel im Browser. Wählen Sie auf der Registerkarte „HTML“ des Dialogfelds „Einstellungen für Veröffentlichungen“ die Vorlage „Nur Flash - Vollbild zulassen“. Geben Sie 9.0.115.0 bei der Flash Player-Version an und achten Sie darauf, dass auf der Registerkarte „Format“ die Formate „Flash“ und „HTML“ ausgewählt sind. Die resultierende HTML-Datei lässt sich im Browser veröffentlichen und öffnen.
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 | Eigenschaft |
fullScreenSourceRect:Rectangle
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Veranlasst die Flash-Laufzeitumgebung einen bestimmten Bereich der Bühne im Vollbildmodus anzuzeigen. Falls verfügbar, verwendet die Flash-Laufzeitumgebung die Hardwareskalierung, wobei die Grafik- und Videokarte des Computers genutzt wird und Inhalte im Allgemeinen schneller als bei der Softwareskalierung angezeigt werden.
Wenn diese Eigenschaft auf ein gültiges Rechteck und die Eigenschaft displayState
auf den Vollbildmodus gesetzt wird, skaliert die Flash-Laufzeitumgebung den angegebenen Bereich. Die tatsächliche Größe der Bühne in Pixeln innerhalb von ActionScript wird nicht geändert. Die Flash-Laufzeitumgebung erzwingt eine Mindestgröße des Rechtecks, damit die standardmäßige Meldung „Vollbildmodus mit Esc beenden“ darin Platz findet. Diese Mindestgröße beträgt normalerweise ca. 260 x 30 Pixel, kann jedoch je nach Plattform und Flash-Laufzeitumgebungsversion variieren.
Diese Eigenschaft kann nur festgelegt werden, wenn sich die Flash-Laufzeitumgebung nicht im Vollbildmodus befindet. Um diese Eigenschaft richtig zu verwenden, legen Sie sie zuerst fest und setzen Sie dann die Eigenschaft displayState
auf den Vollbildmodus, wie in den Codebeispielen gezeigt. Hinweis: In Flash Player 15 und höher kann diese Eigenschaft auch festgelegt werden, wenn Flash Runtime sich im Vollbildmodus befindet.
Um die Skalierung zu aktivieren, legen Sie die Eigenschaft fullScreenSourceRect
auf ein Rechteckobjekt fest:
// valid, will enable hardware scaling stage.fullScreenSourceRect = new Rectangle(0,0,320,240);
Um die Skalierung zu deaktivieren, legen Sie in ActionScript 3.0 fullScreenSourceRect=null
und in ActionScript 2.0 undefined
fest.
stage.fullScreenSourceRect = null;
Der Endbenutzer kann die Hardwareskalierung, die standardmäßig aktiviert ist, in den Flash Player-Anzeigeeinstellungen auch deaktivieren. Weitere Informationen finden Sie unter www.adobe.com/go/display_settings_de.
Implementierung
public function get fullScreenSourceRect():Rectangle
public function set fullScreenSourceRect(value:Rectangle):void
Verwandte API-Elemente
Stage.displayState
Stage.scaleMode
flash.events.FullScreenEvent
flash.events.Event.RESIZE
Beispiel ( Verwendung dieses Beispiels )
import flash.geom.*; { stage.fullScreenSourceRect = new Rectangle(0,0,320,240); stage.displayState = StageDisplayState.FULL_SCREEN; }
Damit der Vollbildmodus mit Hardwarebeschleunigung verwendet werden kann, müssen folgende Bedingungen erfüllt sein:
- Flash Player 9.0.115.0 oder höher wird benötigt, ebenso ein Authoring-Tool, das diese Version unterstützt.
- HTML-Vorlagen müssen modifiziert werden, damit sie den Vollbildmodus unterstützen. Das Attribut
allowFullScreen
muss für die Tagsobject
undembed
auftrue
gesetzt werden. (Die Skripten, die SWF-Einbettungs-Tags generieren, müssen ebenfalls den Vollbildmodus zulassen.) Beispieldateien, die für Flash Builder verwendet werden können, finden Sie im Artikel Exploring full-screen mode in Flash Player 9. - Ihre Anwendung muss über Zugriffsberechtigungen für eine FLV-Videodatei verfügen. In diesem Beispiel wird davon ausgegangen, dass sich die Flash Video-Datei (FLV) im selben Ordner wie die SWF-Datei befindet.
- Der Benutzer muss den Zugriff auf den Vollbildmodus zulassen.
- Weitere Informationen zur Hardwareskalierung finden Sie im Artikel Exploring Flash Player support for high-definition H.264 video and AAC audio für Flash Player.
Eine FLV-Datei wird mit den Objekten NetConnection und NetStream geladen. Da sich die FLV-Datei im selben Ordner wie die SWF-Datei befindet und die Verbindung über HTTP hergestellt wird, wird der Parameter der NetConnection.connect()
-Methode auf null
gesetzt. Das NetConnection-Objekt connect
meldet seinen Status, indem ein netStatus
-Ereignis ausgelöst wird, welches die netStatusHandler()
-Methode aufruft. Die netStatusHandler()
-Methode überprüft, ob die Verbindung erfolgreich hergestellt wurde, und ruft die connectStream()
-Methode auf, die ein NetStream-Objekt erstellt, welches das NetConnection-Objekt als Parameter annimmt. Sie erstellt auch ein Video-Objekt und fügt das NetStream-Objekt dem Video-Objekt hinzu. Das Video-Objekt wird dann der Anzeigeliste hinzugefügt, und der Stream wird für das Abspielen eingerichtet. Da die FLV-Videodatei keine Metadaten oder Cue-Point-Informationen enthält, wird ein AsyncError
-Ereignis ausgelöst. Es muss ein Listener für die Verarbeitung des Ereignisses eingerichtet werden. Hier wurde der Listener erstellt und ignoriert das Ereignis. Ein weiterer Listener für das Ereignis netStatus
wurde für das NetStream-Objekt eingerichtet. Er zeigt eine Fehlermeldung an, wenn der Stream nicht gefunden wurde. (Beachten Sie, dass netStatusHandler()
für die Verarbeitung beliebig vieler unterschiedlicher Statusinformationen, die für den Stream oder die Verbindung gemeldet werden, verwendet werden könnte.)
Wenn auf die Eigenschaften und Methoden einer geladenen SWF-Datei zugegriffen werden kann, wird die createMouseListener()
-Methode aufgerufen. Sie richtet einen Ereignis-Listener für das Klicken auf die Bühne ein. Die toggleFullScreen()
-Methode überprüft, ob der Anzeigestatus im Vollbild oder im normalen Modus ist. Für den normalen Modus wird die Größe des Video-Objekts auf die Größe des Videostreams gesetzt. Die fullScreenSourceRect
-Eigenschaft wird auf ein Rechteck gesetzt, das den Abmessungen des Video-Objekts entspricht. Dann wird die Stage.displayMode
-Eigenschaft auf den Vollbildmodus gesetzt, wodurch das Video im ursprünglichen Rechteck erweitert wird, um den gesamten Vollbildbereich auszufüllen. Wenn die Systemanforderungen erfüllt sind, wird die Grafikhardware des Computers verwendet, um die Leistung der Videodarstellung im Vollbild zu verbessern, und der Anzeigestatus wird auf den Vollbildmodus gesetzt. Um Sicherheitsfehler abzufangen, die beim Wechsel in den Vollbildmodus auftreten könnten, wird eine try...catch
-Anweisung verwendet. (Beachten Sie, dass der Anzeigestatus auf den Vollbildmodus gesetzt werden muss, nach die Eigenschaft fullScreenSourceRect
gesetzt wurde.) Vor dem Wechsel in den normalen Modus werden die Breite und Höhe des Video-Objekts auf die Werte des gespeicherten ursprünglichen Video-Objekts zurückgesetzt. Andernfalls bestimmen die für den Vollbildmodus am Video-Objekt vorgenommenen Änderungen die Breite und Höhe.
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 | Eigenschaft |
fullScreenWidth:uint
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Setzt die Breite des Monitors, der verwendet wird, wenn der Vollbildmodus aktiviert wird, zurück, falls dieser Modus sofort aufgerufen wird. Wenn der Benutzer über mehrere Monitore verfügt, wird der Monitor verwendet, auf dem sich zu diesem Zeitpunkt der größte Teil der Bühne befindet.
Hinweis: Falls der Benutzer die Möglichkeit hat, zwischen dem Abrufen des Wertes und dem Wechseln in den Vollbildmodus den Browser von einem Monitor zu einem anderen zu verschieben, könnte der Wert inkorrekt sein. Wenn Sie den Wert in eine Ereignisprozedur abrufen, die Stage.displayState
auf StageDisplayState.FULL_SCREEN
setzt, ist der Wert korrekt.
Dies ist die Breite des Monitors in Pixel; dieser Wert ist identisch mit der Breite der Bühne, wenn Stage.align
auf den Wert StageAlign.TOP_LEFT
und Stage.scaleMode
auf den Wert StageScaleMode.NO_SCALE
gesetzt ist.
Implementierung
public function get fullScreenWidth():uint
Verwandte API-Elemente
fullScreenHeight
fullScreenSourceRect
scaleMode
StageDisplayState
flash.events.Event.RESIZE
flash.events.FullScreenEvent
Beispiel ( Verwendung dieses Beispiels )
enterFullScreen()
ausgelöst, die die Eigenschaft fullScreenSourceRect
festlegt und den Vollbildmodus aktiviert. Um die Eigenschaft fullScreenSourceRect
festzulegen, beginnt die Ereignisprozedur mit der Position und den Abmessungen des roten Quadrats. Danach wird das Seitenverhältnis (Breite durch Höhe) des roten Quadrats mit dem Seitenverhältnis der Bühne im Vollbild verglichen, sodass das Rechteck (fullScreenSourceRect
) dem Seitenverhältnis des Bildschirms entsprechend erweitert werden kann. Im Ergebnis nimmt das rote Quadrat die gesamte Höhe des Bildschirms ein, während an beiden Seiten der grüne Hintergrund sichtbar ist. Wenn das Seitenverhältnis nicht angepasst worden wäre, wäre anstelle des grünen Hintergrunds auf beiden Seiten die Hintergrundfarbe der Bühne (standardmäßig weiß) zu sehen.
Hinweis: Testen Sie dieses Beispiel im Browser. Wählen Sie auf der Registerkarte „HTML“ des Dialogfelds „Einstellungen für Veröffentlichungen“ die Vorlage „Nur Flash - Vollbild zulassen“. Geben Sie 9.0.115.0 bei der Flash Player-Version an und achten Sie darauf, dass auf der Registerkarte „Format“ die Formate „Flash“ und „HTML“ ausgewählt sind. Die resultierende HTML-Datei lässt sich im Browser veröffentlichen und öffnen.
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 | Eigenschaft |
height:Number
[override] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt die Höhe des Anzeigeobjekts in Pixeln an. Die Höhe wird auf Basis der Begrenzungen des Inhalts des Anzeigeobjekts berechnet. Wenn Sie die Eigenschaft height
festsetzen, wird die Eigenschaft scaleY
entsprechend angepasst, wie im folgenden Code gezeigt.
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;
Abgesehen von TextField- und Video-Objekten, hat ein Anzeigeobjekt ohne Inhalt (z. B. ein leeres Sprite) eine Höhe von 0, selbst wenn Sie versuchen, height
auf einen anderen Wert zu setzen.
Implementierung
override public function get height():Number
override public function set height(value:Number):void
Auslöser
SecurityError — Durch das Verweisen auf die height -Eigenschaft eines Stage-Objekts wird für jeden Aufrufer, der sich nicht in derselben Sicherheits-Sandbox wie der Bühneneigentümer (die Haupt-SWF-Datei) befindet, eine Ausnahme ausgelöst. Um dies zu verhindern, kann der Bühneneigentümer der Domäne des Aufrufers die entsprechende Berechtigung erteilen, indem er die Methode Security.allowDomain() oder Security.allowInsecureDomain() aufruft. Weitere Informationen finden Sie im Kapitel „Sicherheit“ des ActionScript 3.0 Entwicklerhandbuchs.
| |
IllegalOperationError — Es ist niemals zulässig, die height -Eigenschaft eines Stage-Objekts zu setzen, selbst wenn das aufrufende Objekt der Bühneneigentümer (die Haupt-SWF-Datei) ist.
|
mouseChildren | Eigenschaft |
mouseChildren:Boolean
[override] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bestimmt, ob die untergeordneten Elemente des Objekts maus- oder benutzereingabegerätfähig sind oder nicht. Wenn ein Objekt aktiviert ist, kann ein Benutzer damit interagieren, indem er eine Maus oder ein anderes Benutzereingabegerät verwendet. Der Standardwert lautet true
.
Diese Eigenschaft ist praktisch, wenn Sie eine Schaltfläche mit einer Instanz der Sprite-Klasse (anstelle der SimpleButton-Klasse) erstellen. Wenn Sie zum Erstellen einer Schaltfläche eine Sprite-Instanz verwenden, können Sie die Schaltfläche ausrüsten und mithilfe der addChild()
-Methode zusätzliche Sprite-Instanzen hinzufügen. Dieser Vorgang kann zu unerwarteten Verhaltensweisen bei Mausereignissen führen, da die untergeordneten Sprite-Instanzen zum Zielobjekt eines Mausereignisses werden können, wenn eigentlich die übergeordnete Instanz des Zielobjekts erwartet wird. Um sicherzustellen, dass die übergeordnete Instanz als Zielobjekt für Mausereignisse dient, können Sie die mouseChildren
-Eigenschaft der übergeordneten Instanz auf false
setzen.
Durch das Festlegen dieser Eigenschaft wird kein Ereignis ausgelöst. Um interaktive Funktionalität zu erzielen, müssen Sie die addEventListener()
-Methode verwenden.
Implementierung
override public function get mouseChildren():Boolean
override public function set mouseChildren(value:Boolean):void
Auslöser
SecurityError — Durch das Verweisen auf die mouseChildren -Eigenschaft eines Stage-Objekts wird für jeden Aufrufer, der sich nicht in derselben Sicherheits-Sandbox wie der Bühneneigentümer (die Haupt-SWF-Datei) befindet, eine Ausnahme ausgelöst. Um dies zu verhindern, kann der Bühneneigentümer der Domäne des Aufrufers die entsprechende Berechtigung erteilen, indem er die Methode Security.allowDomain() oder Security.allowInsecureDomain() aufruft. Weitere Informationen finden Sie im Kapitel „Sicherheit“ des ActionScript 3.0 Entwicklerhandbuchs.
|
mouseLock | Eigenschaft |
mouseLock:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 11.2, AIR 3.2 |
Legen Sie den Wert auf true
fest, um die Maussperre zu aktivieren. Wenn die Maussperre aktiviert ist, wird der Cursor ausgeschaltet und die Maus kann ohne Grenzen bewegt werden. Sie können die Maussperre nur für Desktopanwendungen im Vollbildmodus aktivieren. Wenn Sie sie für Anwendungen, die nicht im Vollbildmodus ausgeführt werden, oder für Anwendungen auf mobilen Geräten festlegen, wird eine Ausnahme ausgegeben.
Unter den folgenden Bedingungen wird die Maussperre automatisch deaktiviert und der Mauscursor ist wieder sichtbar:
- Der Benutzer beendet den Vollbildmodus, indem er die Esc-Taste drückt (alle Plattformen) oder eine der folgenden Tastenkombinationen verwendet: Strg+W (Windows), Befehl+W (Mac) oder Alt-F4 (Windows).
- Das Anwendungsfenster verliert den Fokus.
- Ein Element der Einstellungsbenutzeroberfläche ist sichtbar, zum Beispiel ein Datenschutzdialogfeld.
- Ein natives Dialogfeld wird angezeigt, zum Beispiel beim Hochladen einer Datei.
Beim Beenden des Vollbildmodus wird diese Eigenschaft automatisch auf false
eingestellt.
Ereignisse, die mit Mausbewegung verknüpft sind, zum Beispiel das mouseMove
-Ereignis, verwenden die MouseEvent-Klasse, um das Ereignisobjekt darzustellen. Wenn die Maussperre aktiviert ist, verwenden Sie die Eigenschaften MouseEvent.localX
und MouseEvent.localY
, um die Position der Maus zu bestimmen. Wenn die Maussperre deaktiviert ist, verwenden Sie die Eigenschaften MouseEvent.movementX
und MouseEvent.movementY
, um die Position der Maus zu bestimmen. Die Eigenschaften movementX
und movementY
enthalten Änderungen an der Position der Maus seit dem letzten Ereignis anstelle absoluter Koordinaten für die Mausposition.
Hinweis: Wenn sich die Anwendung im Vollbildmodus befindet, werden Mausereignis-Listener, die an andere Anzeigeobjekte als die Bühne angehängt sind, nicht abgesetzt. Um Mausdeltawerte und andere Mausereignisse zu erhalten, wenn mouseLock
den Wert true
hat, hängen Sie die Mausereignis-Listener an das Stage-Objekt an.
Implementierung
public function get mouseLock():Boolean
public function set mouseLock(value:Boolean):void
Verwandte API-Elemente
nativeWindow | Eigenschaft |
nativeWindow:NativeWindow
[schreibgeschützt] Laufzeitversionen: | AIR 1.0, Flash Lite 4 |
Ein Verweis auf das NativeWindow-Objekt, das diese Bühne enthält.
Das Fenster repräsentiert das Fenster des nativen Betriebssystems; die Bühne repräsentiert den Inhalt des Fensters. Diese Eigenschaft ist nur gültig für Inhalt, der auf Plattformen, die die NativeWindow-Klasse unterstützen, in AIR ausgeführt wird. Bei anderen Plattformen ist diese Eigenschaft null
. In Flash Player (in einem Browser ausgeführter Inhalt) ist diese Eigenschaft ebenfalls null
.
Implementierung
public function get nativeWindow():NativeWindow
numChildren | Eigenschaft |
numChildren:int
[schreibgeschützt] [override] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liefert die Anzahl der Objekte, die diesem Objekt untergeordnet sind.
Implementierung
override public function get numChildren():int
Auslöser
SecurityError — Durch das Verweisen auf die numChildren -Eigenschaft eines Stage-Objekts wird für jeden Aufrufer, der sich nicht in derselben Sicherheits-Sandbox wie der Bühneneigentümer (die Haupt-SWF-Datei) befindet, eine Ausnahme ausgelöst. Um dies zu verhindern, kann der Bühneneigentümer der Domäne des Aufrufers die entsprechende Berechtigung erteilen, indem er die Methode Security.allowDomain() oder Security.allowInsecureDomain() aufruft. Weitere Informationen finden Sie im Kapitel „Sicherheit“ des ActionScript 3.0 Entwicklerhandbuchs.
|
orientation | Eigenschaft |
orientation:String
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2 |
Die aktuelle Ausrichtung der Bühne. Diese Eigenschaft wird auf einen der vier Werte gesetzt, die in der StageOrientation-Klasse als Konstanten definiert sind:
StageOrientation-Konstante | Bühnenausrichtung |
---|---|
StageOrientation.DEFAULT | Der Bildschirm befindet sich in der Standardausrichtung (rechte Seite nach oben). |
StageOrientation.ROTATED_RIGHT | Der Bildschirm ist nach rechts gedreht. |
StageOrientation.ROTATED_LEFT | Der Bildschirm ist nach links gedreht. |
StageOrientation.UPSIDE_DOWN | Der Bildschirm ist auf den Kopf gedreht. |
StageOrientation.UNKNOWN | Die Anwendung hat die anfängliche Ausrichtung des Bildschirms noch nicht bestimmt. Sie können einen Ereignis-Listener für das orientationChange -Ereignis hinzufügen |
Um die Bühnenausrichtung festzulegen, verwenden Sie die setOrientation()
-Methode.
Wichtig: Die orientation-Eigenschaft wird auf Android-Geräten ab 2.6-Namespace unterstützt.
Implementierung
public function get orientation():String
Verwandte API-Elemente
quality | Eigenschaft |
quality:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ein Wert der StageQuality-Klasse, der die verwendete Wiedergabequalität angibt. Folgende Werte sind gültig:
StageQuality.LOW
: Niedrige Wiedergabequalität. Für Grafiken wird kein Anti-Aliasing und für Bitmaps keine Glättung durchgeführt, aber in Laufzeitumgebungen wird weiterhin MIP-Mapping verwendet.StageQuality.MEDIUM
: Mittlere Wiedergabequalität. Für Grafiken wird ein Anti-Aliasing mit einem 2x2-Pixelraster durchgeführt. Das Glätten von Bitmaps hängt von der EinstellungBitmap.smoothing
ab. Für Laufzeitumgebungen wird MIP-Mapping verwendet. Diese Einstellung ist für Filme geeignet, die keinen Text enthalten.StageQuality.HIGH
: Hohe Wiedergabequalität. Für Grafiken wird ein Anti-Aliasing mit einem 4x4-Pixelraster durchgeführt. Das Glätten von Bitmaps hängt von der EinstellungBitmap.smoothing
ab. Für Laufzeitumgebungen wird MIP-Mapping verwendet. Dies ist die von Flash Player verwendete Standardeinstellung für die Wiedergabequalität.StageQuality.BEST
: Maximale Wiedergabequalität. Für Grafiken wird ein Anti-Aliasing mit einem 4x4-Pixelraster durchgeführt. WennBitmap.smoothing
den Werttrue
aufweist, verwendet die Laufzeitumgebung einen hochwertigen Algorithmus für die Verkleinerung, durch den weniger Artefakte entstehen (bei Verwendung vonStageQuality.BEST
mitBitmap.smoothing
und dem Werttrue
verringert sich die Leistung jedoch erheblich; daher wird diese Einstellung nicht empfohlen).
Bei höheren Qualitätseinstellungen werden skalierte Bitmaps besser dargestellt. Höhere Qualitätseinstellungen beanspruchen jedoch auch mehr Computerressourcen. Besonders bei der Wiedergabe von skaliertem Video kann eine hohe Qualitätseinstellung die Bildrate verringern.
Die BitmapData.draw()
-Methode verwendet den Wert der Stage.quality
-Eigenschaft. Alternativ dazu können Sie die BitmapData.drawWithQuality()
-Methode verwenden, mit der Sie den quality
-Parameter für die Methode festlegen und den aktuellen Wert von Stage.quality
ignorieren können.
Im Desktop-Profil von Adobe AIR kann tquality
auf StageQuality.BEST
oder StageQuality.HIGH
gesetzt werden (der Standardwert ist StageQuality.HIGH
). Der Versuch, die Eigenschaft auf einen anderen Wert einzustellen, hat keinerlei Auswirkungen (und die Eigenschaft wird nicht geändert). Im mobile-Profil von AIR sind alle vier Qualitätseinstellungen verfügbar. Der Standardwert für mobile Geräte ist StageQuality.MEDIUM
.
Bei Inhalt, der in Adobe AIR ausgeführt wird, gilt Folgendes: Wenn die quality
-Eigenschaft für ein Stage-Objekt eingestellt wird, ändert dies die Wiedergabequalität für alle Stage-Objekte (von unterschiedlichen NativeWindow-Objekten verwendet).
quality
-Eigenschaft darauf keine Auswirkung.
Implementierung
public function get quality():String
public function set quality(value:String):void
Auslöser
SecurityError — Durch Aufrufen der quality -Eigenschaft eines Stage-Objekts wird für jeden Aufrufer, der sich nicht in derselben Sicherheits-Sandbox wie der Bühneneigentümer (die Haupt-SWF-Datei) befindet, eine Ausnahme ausgelöst. Um dies zu verhindern, kann der Bühneneigentümer der Domäne des Aufrufers die entsprechende Berechtigung erteilen, indem er die Methode Security.allowDomain() oder Security.allowInsecureDomain() aufruft. Weitere Informationen finden Sie im Kapitel „Sicherheit“ des ActionScript 3.0 Entwicklerhandbuchs.
|
Verwandte API-Elemente
scaleMode | Eigenschaft |
scaleMode:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ein Wert aus der StageScaleMode-Klasse, mit dem angegeben wird, welcher Skalierungsmodus verwendet werden soll. Folgende Werte sind gültig:
StageScaleMode.EXACT_FIT
: Die gesamte Anwendung wird im angegebenen Bereich angezeigt. Das ursprüngliche Seitenverhältnis wird nicht beibehalten. Verzerrungen können auftreten und die Anwendung erscheint möglicherweise gestreckt oder gestaucht.StageScaleMode.SHOW_ALL
: Die gesamte Anwendung wird im angegebenen Bereich verzerrungsfrei angezeigt. Dabei bleibt das ursprüngliche Seitenverhältnis der Anwendung erhalten. Unter Umständen werden an zwei Seiten der Anwendung Ränder angezeigt.StageScaleMode.NO_BORDER
: Die gesamte Anwendung füllt den angegebenen Bereich so, dass er ohne Verzerrung in den angegebenen Bereich passt. Bei Bedarf wird jedoch zugeschnitten. Das ursprüngliche Seitenverhältnis der Anwendung bleibt erhalten.StageScaleMode.NO_SCALE
: Die gesamte Anwendung wird fixiert und bleibt auch dann unverändert, wenn sich die Größe des Player-Fensters ändert. Ist das Player-Fenster kleiner als der Flash-Inhalt, wird der Inhalt zugeschnitten.
Implementierung
public function get scaleMode():String
public function set scaleMode(value:String):void
Auslöser
SecurityError — Durch Aufrufen der scaleMode -Eigenschaft eines Stage-Objekts wird für jeden Aufrufer, der sich nicht in derselben Sicherheits-Sandbox wie der Bühneneigentümer (die Haupt-SWF-Datei) befindet, eine Ausnahme ausgelöst. Um dies zu verhindern, kann der Bühneneigentümer der Domäne des Aufrufers die entsprechende Berechtigung erteilen, indem er die Methode Security.allowDomain() oder Security.allowInsecureDomain() aufruft. Weitere Informationen finden Sie im Kapitel „Sicherheit“ des ActionScript 3.0 Entwicklerhandbuchs.
|
Verwandte API-Elemente
showDefaultContextMenu | Eigenschaft |
showDefaultContextMenu:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Gibt an, ob die Standardelemente im Kontextmenü der Flash-Laufzeitumgebung ein- oder ausgeblendet werden.
Wenn die showDefaultContextMenu
-Eigenschaft auf true
gesetzt ist (die Standardeinstellung), werden alle Elemente des Kontextmenüs eingeblendet. Wenn die showDefaultContextMenu
-Eigenschaft auf false
gesetzt ist, werden nur die Befehle „Einstellungen“ und „Info...“ angezeigt.
Implementierung
public function get showDefaultContextMenu():Boolean
public function set showDefaultContextMenu(value:Boolean):void
Auslöser
SecurityError — Durch Aufrufen der showDefaultContextMenu -Eigenschaft eines Stage-Objekts wird für jeden Aufrufer, der sich nicht in derselben Sicherheits-Sandbox wie der Bühneneigentümer (die Haupt-SWF-Datei) befindet, eine Ausnahme ausgelöst. Um dies zu verhindern, kann der Bühneneigentümer der Domäne des Aufrufers die entsprechende Berechtigung erteilen, indem er die Methode Security.allowDomain() oder Security.allowInsecureDomain() aufruft. Weitere Informationen finden Sie im Kapitel „Sicherheit“ des ActionScript 3.0 Entwicklerhandbuchs.
|
softKeyboardRect | Eigenschaft |
softKeyboardRect:Rectangle
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.6, Flash Player 10.2 |
Ein Rechteck, das den Bereich der Bühne definiert, der zurzeit von einer Softwaretastatur eingenommen wird. Die Rechteckkomponenten sind (0,0,0,0), wenn die virtuelle Tastatur nicht eingeblendet wird.
Implementierung
public function get softKeyboardRect():Rectangle
Verwandte API-Elemente
stage3Ds | Eigenschaft |
stage3Ds:Vector.<Stage3D>
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 11, AIR 3 |
Eine Liste von Stage3D-Objekten, die für die Anzeige von dreidimensionalen Inhalten verfügbar sind.
Sie können jeweils nur eine begrenzte Anzahl von Stage3D-Objekten verwenden. Die Anzahl der verfügbaren Stage3D-Objekte ist von der Plattform und der verfügbaren Hardware abhängig.
Ein Stage3D-Objekt wird vor einem StageVideo-Objekt und hinter der Flash-Anzeigeliste gezeichnet.
Implementierung
public function get stage3Ds():Vector.<Stage3D>
Verwandte API-Elemente
stageFocusRect | Eigenschaft |
stageFocusRect:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bestimmt, ob Objekte mit leuchtendem Rahmen angezeigt werden, wenn sie den Fokus besitzen.
Implementierung
public function get stageFocusRect():Boolean
public function set stageFocusRect(value:Boolean):void
Auslöser
SecurityError — Durch Aufrufen der stageFocusRect -Eigenschaft eines Stage-Objekts wird für jeden Aufrufer, der sich nicht in derselben Sicherheits-Sandbox wie der Bühneneigentümer (die Haupt-SWF-Datei) befindet, eine Ausnahme ausgelöst. Um dies zu verhindern, kann der Bühneneigentümer der Domäne des Aufrufers die entsprechende Berechtigung erteilen, indem er die Methode Security.allowDomain() oder Security.allowInsecureDomain() aufruft. Weitere Informationen finden Sie im Kapitel „Sicherheit“ des ActionScript 3.0 Entwicklerhandbuchs.
|
stageHeight | Eigenschaft |
stageHeight:int
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Die aktuelle Höhe der Bühne in Pixel.
Wenn der Wert der Stage.scaleMode
-Eigenschaft auf StageScaleMode.NO_SCALE
eingestellt ist und der Benutzer die Fenstergröße ändert, behält der Bühneninhalt seine definierte Größe bei, während die stageHeight
-Eigenschaft sich ändert und dann der neuen Höhe des Bildschirmbereichs entspricht, in dem die SWF-Datei angezeigt wird. (Bei den anderen Skalierungsmodi entspricht die stageHeight
-Eigenschaft immer der Originalhöhe der SWF-Datei.) Sie können einen Ereignis-Listener für das resize
-Ereignis hinzufügen und dann über die stageHeight
-Eigenschaft der Stage-Klasse die tatsächlichen Pixelabmessungen des Flash-Laufzeitumgebungsfensters bestimmen, dessen Größe geändert wurde. Über den Ereignis-Listener können Sie steuern, wie der Bildschirminhalt angepasst wird, wenn der Benutzer die Fenstergröße ändert.
Geräte mit AIR für TV verhalten sich anders als Desktopgeräte, wenn Sie die stageHeight
-Eigenschaft festlegen. Wenn die Stage.scaleMode
-Eigenschaft auf StageScaleMode.NO_SCALE
gesetzt ist und Sie die stageHeight
-Eigenschaft festlegen, wird die Bühnenhöhe erst im nächsten Bild der SWF-Datei geändert.
Hinweis: Auf einer HTML-Seite, die die SWF-Datei enthält, muss für die beiden Tags object
und embed
das zugehörige height
-Attribut auf einen Prozentwert eingestellt werden (wie 100 %
), nicht auf Pixel. Wenn die Einstellungen von JavaScript-Code generiert werden, muss der height
-Parameter der AC_FL_RunContent()
-Methode ebenfalls auf einen Prozentwert eingestellt werden. Dieser Prozentsatz wird auf den Wert von stageHeight
angewendet.
Implementierung
public function get stageHeight():int
public function set stageHeight(value:int):void
Auslöser
SecurityError — Durch Aufrufen der stageHeight -Eigenschaft eines Stage-Objekts wird für jeden Aufrufer, der sich nicht in derselben Sicherheits-Sandbox wie der Bühneneigentümer (die Haupt-SWF-Datei) befindet, eine Ausnahme ausgelöst. Um dies zu verhindern, kann der Bühneneigentümer der Domäne des Aufrufers die entsprechende Berechtigung erteilen, indem er die Methode Security.allowDomain() oder Security.allowInsecureDomain() aufruft. Weitere Informationen finden Sie im Kapitel „Sicherheit“ des ActionScript 3.0 Entwicklerhandbuchs.
|
Verwandte API-Elemente
stageVideos | Eigenschaft |
stageVideos:Vector.<StageVideo>
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5, Flash Player 10.2 |
Eine Liste der StageVideo-Objekte, die zum Abspielen externer Videos verfügbar sind.
Sie können jeweils nur eine begrenzte Anzahl von StageVideo-Objekten verwenden. Wenn die Ausführung einer SWF-Datei beginnt, richtet sich die Anzahl der verfügbaren StageVideo-Objekte nach der Plattform und der verfügbaren Hardware.
Um ein StageVideo-Objekt zu verwenden, weisen Sie ein Mitglied des stageVideos
-Vektorobjekts einer StageVideo-Variable zu.
Alle StageVideo-Objekte werden auf der Bühne hinter allen Anzeigeobjekten angezeigt. Die StageVideo-Objekte werden auf der Bühne in der Reihenfolge angezeigt, in der sie im stageVideos
-Vektorobjekt erscheinen. Beispiel: Das stageVideos
-Vektorobjekt enthält drei Einträge:
- Das StageVideo-Objekt an der Indexposition 0 des
stageVideos
-Vektorobjekts wird hinter allen StageVideo-Objekten angezeigt. - Das StageVideo-Objekt an der Indexposition 1 wird vor dem StageVideo-Objekt an der Indexposition 0 angezeigt.
- Das StageVideo-Objekt an der Indexposition 2 wird vor dem StageVideo-Objekt an der Indexposition 1 angezeigt.
Mit der StageVideo.depth
-Eigenschaft können Sie diese Reihenfolge ändern.
Hinweis: Geräte mit AIR für TV unterstützen nur ein StageVideo-Objekt.
Implementierung
public function get stageVideos():Vector.<StageVideo>
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
var stageVideo:StageVideo; if ( stage.stageVideos.length >= 1 ) { stageVideo = stage.stageVideos[0]; }
stageWidth | Eigenschaft |
stageWidth:int
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bestimmt die aktuelle Breite der Bühne in Pixel.
Wenn der Wert der Stage.scaleMode
-Eigenschaft auf StageScaleMode.NO_SCALE
eingestellt ist und der Benutzer die Fenstergröße ändert, behält der Bühneninhalt seine definierte Größe bei, während die stageWidth
-Eigenschaft sich ändert und dann der neuen Breite des Bildschirmbereichs entspricht, in dem die SWF-Datei angezeigt wird. (Bei den anderen Skalierungsmodi entspricht die stageWidth
-Eigenschaft immer der Originalbreite der SWF-Datei.) Sie können einen Ereignis-Listener für das resize
-Ereignis hinzufügen und dann über die stageWidth
-Eigenschaft der Stage-Klasse die tatsächlichen Pixelabmessungen des Flash-Laufzeitumgebungsfensters bestimmen, dessen Größe geändert wurde. Über den Ereignis-Listener können Sie steuern, wie der Bildschirminhalt angepasst wird, wenn der Benutzer die Fenstergröße ändert.
Geräte mit AIR für TV verhalten sich anders als Desktopgeräte, wenn Sie die stageWidth
-Eigenschaft festlegen. Wenn die Stage.scaleMode
-Eigenschaft auf StageScaleMode.NO_SCALE
gesetzt ist und Sie die stageWidth
-Eigenschaft festlegen, wird die Bühnenbreite erst im nächsten Bild der SWF-Datei geändert.
Hinweis: Auf einer HTML-Seite, die die SWF-Datei enthält, muss für die beiden Tags object
und embed
das zugehörige width
-Attribut auf einen Prozentwert eingestellt werden (wie 100 %
), nicht auf Pixel. Wenn die Einstellungen von JavaScript-Code generiert werden, muss der width
-Parameter der AC_FL_RunContent()
-Methode ebenfalls auf einen Prozentwert eingestellt werden. Dieser Prozentsatz wird auf den Wert von stageWidth
angewendet.
Implementierung
public function get stageWidth():int
public function set stageWidth(value:int):void
Auslöser
SecurityError — Durch Aufrufen der stageWidth -Eigenschaft eines Stage-Objekts wird für jeden Aufrufer, der sich nicht in derselben Sicherheits-Sandbox wie der Bühneneigentümer (die Haupt-SWF-Datei) befindet, eine Ausnahme ausgelöst. Um dies zu verhindern, kann der Bühneneigentümer der Domäne des Aufrufers die entsprechende Berechtigung erteilen, indem er die Methode Security.allowDomain() oder Security.allowInsecureDomain() aufruft. Weitere Informationen finden Sie im Kapitel „Sicherheit“ des ActionScript 3.0 Entwicklerhandbuchs.
|
Verwandte API-Elemente
supportedOrientations | Eigenschaft |
supportedOrientations:Vector.<String>
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.6 |
Die vom aktuellen Gerät unterstützten Ausrichtungen.
Sie können die in dieser Liste enthaltenen orientation-Strings als Parameters für die setOrientation()
-Methode verwenden. Wenn Sie eine nicht unterstützte Ausrichtung festlegen, kommt es zu einem Fehler.
Die möglichen Ausrichtungen sind:
StageOrientation-Konstante | Bühnenausrichtung |
---|---|
StageOrientation.DEFAULT | Legt die Bühnenausrichtung auf die Standardausrichtung (rechte Seite oben) fest. |
StageOrientation.ROTATED_RIGHT | Legt die Bühnenausrichtung als nach rechts gedreht fest. |
StageOrientation.ROTATED_LEFT | Legt die Bühnenausrichtung als nach links gedreht fest. |
StageOrientation.UPSIDE_DOWN | Legt die Bühnenausrichtung als auf den Kopf gedreht fest. |
Implementierung
public function get supportedOrientations():Vector.<String>
Verwandte API-Elemente
supportsOrientationChange | Eigenschaft |
supportsOrientationChange:Boolean
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2 |
Ob die Anwendung Änderungen an der Bühnenausrichtung (und Gerätedrehung) unterstützt. Zurzeit hat diese Eigenschaft nur in AIR-Anwendungen, die auf mobilen Geräten ausgeführt werden, den Wert true
.
Implementierung
public static function get supportsOrientationChange():Boolean
Verwandte API-Elemente
tabChildren | Eigenschaft |
tabChildren:Boolean
[override] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Bestimmt, ob die dem Objekt untergeordneten Objekte per Tabulatortaste aktivierbar sind. Aktiviert oder deaktiviert die Möglichkeit zur Auswahl von untergeordneten Objekten mithilfe der Tabulatortaste. Der Standardwert lautet true
.
Hinweis: Verwenden Sie die tabChildren
-Eigenschaft nicht in Flex. Verwenden Sie stattdessen die mx.core.UIComponent.hasFocusableChildren
-Eigenschaft.
Implementierung
override public function get tabChildren():Boolean
override public function set tabChildren(value:Boolean):void
Auslöser
SecurityError — Durch das Verweisen auf die tabChildren -Eigenschaft eines Stage-Objekts wird für jeden Aufrufer, der sich nicht in derselben Sicherheits-Sandbox wie der Bühneneigentümer (die Haupt-SWF-Datei) befindet, eine Ausnahme ausgelöst. Um dies zu verhindern, kann der Bühneneigentümer der Domäne des Aufrufers die entsprechende Berechtigung erteilen, indem er die Methode Security.allowDomain() oder Security.allowInsecureDomain() aufruft. Weitere Informationen finden Sie im Kapitel „Sicherheit“ des ActionScript 3.0 Entwicklerhandbuchs.
|
textSnapshot | Eigenschaft |
textSnapshot:flash.text:TextSnapshot
[schreibgeschützt] [override] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Liefert ein TextSnapshot-Objekt für diese DisplayObjectContainer-Instanz.
Implementierung
override public function get textSnapshot():flash.text:TextSnapshot
Auslöser
IllegalOperationError — Ein Verweis auf die textSnapshot -Eigenschaft eines Stage-Objekts löst eine Ausnahme aus, da diese Eigenschaft nicht in der Stage-Klasse implementiert ist. Um dies zu verhindern, rufen Sie die textSnapshot -Eigenschaft eines Anzeigeobjekt-Containers auf, der nicht das Stage-Objekt ist.
|
vsyncEnabled | Eigenschaft |
vsyncEnabled:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 29.0 |
Dies stellt den aktuellen vsync-Status der zugrunde liegenden Grafiklösung dar. Wir können vsync aktivieren/deaktivieren, um sofort zu rendern, ohne auf den nächsten VSYNC-Status warten zu müssen. Die Eigenschaft kann jederzeit gelesen werden. Allerdings kann die Eigenschaft erst festgelegt werden, nachdem das VsyncStateChangeAvailabilityEvent ausgelöst wurde.
Implementierung
public function get vsyncEnabled():Boolean
public function set vsyncEnabled(value:Boolean):void
width | Eigenschaft |
width:Number
[override] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt die Breite des Anzeigeobjekts in Pixeln an. Die Breite wird auf Basis der Begrenzungen des Inhalts des Anzeigeobjekts berechnet. Wenn Sie die Eigenschaft width
festsetzen, wird die Eigenschaft scaleX
entsprechend angepasst, wie im folgenden Code gezeigt.
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;
Abgesehen von TextField- und Video-Objekten, hat ein Anzeigeobjekt ohne Inhalt (z. B. ein leeres Sprite) eine Breite von 0, selbst wenn Sie versuchen, width
auf einen anderen Wert zu setzen.
Implementierung
override public function get width():Number
override public function set width(value:Number):void
Auslöser
SecurityError — Durch das Verweisen auf die width -Eigenschaft eines Stage-Objekts wird für jeden Aufrufer, der sich nicht in derselben Sicherheits-Sandbox wie der Bühneneigentümer (die Haupt-SWF-Datei) befindet, eine Ausnahme ausgelöst. Um dies zu verhindern, kann der Bühneneigentümer der Domäne des Aufrufers die entsprechende Berechtigung erteilen, indem er die Methode Security.allowDomain() oder Security.allowInsecureDomain() aufruft. Weitere Informationen finden Sie im Kapitel „Sicherheit“ des ActionScript 3.0 Entwicklerhandbuchs.
| |
IllegalOperationError — Es ist niemals zulässig, die width -Eigenschaft eines Stage-Objekts zu setzen, selbst wenn Sie der Bühneneigentümer sind.
|
wmodeGPU | Eigenschaft |
wmodeGPU:Boolean
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.0.32, AIR 1.5.2, Flash Lite 4 |
Gibt an, ob GPU-Compositing verfügbar ist und verwendet wird. Der Wert von wmodeGPU
ist nur dann true
, wenn alle drei der folgenden Bedingungen erfüllt sind:
- GPU-Compositing wurde angefordert.
- GPU-Compositing ist verfügbar.
- GPU-Compositing wird verwendet.
Insbesondere die wmodeGPU
-Eigenschaft gibt einen der folgenden Fälle an:
- GPU-Compositing wurde nicht angefordert oder ist nicht verfügbar. In diesem Fall hat die
wmodeGPU
-Eigenschaft den Wertfalse
. - GPU-Compositing wurde angefordert (falls zutreffend und verfügbar), die Umgebung arbeitet aufgrund von Einschränkungen des Inhalts jedoch im „Fallbackmodus“ (keine optimale Darstellung). In diesem Fall hat die
wmodeGPU
-Eigenschaft den Werttrue
. - GPU-Compositing wurde angefordert (falls zutreffend und verfügbar), die Umgebung arbeitet im besten Modus. In diesem Fall hat die
wmodeGPU
-Eigenschaft ebenfalls den Werttrue
.
Anders ausgedrückt identifiziert die wmodeGPU
-Eigenschaft die Fähigkeiten und den Status der Darstellungsumgebung. Bei Laufzeitumgebungen, die GPU-Compositing nicht unterstützen, wie AIR 1.5.2, ist der Wert immer false
, da (wie oben beschrieben) der Wert nur dann true
ist, wenn GPU-Compositing angefordert wurde, verfügbar ist und verwendet wird.
Die wmodeGPU
-Eigenschaft ist hilfreich, um zur Laufzeit festzustellen, ob GPU-Compositing verwendet wird oder nicht. Der Wert von wmodeGPU
gibt an, ob Ihr Inhalt von der Hardware skaliert wird oder nicht, sodass Sie Grafiken in der richtigen Größe präsentieren können. Sie können auch feststellen, ob Sie über einen schnellen Pfad rendern oder nicht, sodass Sie die Komplexität Ihrer Inhalte entsprechend anpassen können.
Für Flash Player, der in einem Browser ausgeführt wird, kann GPU-Compositing durch den Wert gpu
für den wmode
-HTML-Parameter auf der Seite, die den SWF-Datei hostet, angefordert werden. Bei anderen Konfigurationen kann GPU-Compositing im Header einer SWF-Datei angefordert werden (die Einstellung erfolgt über SWF-Authoring-Tools).
Die wmodeGPU
-Eigenschaft identifiziert nicht die aktuelle Renderingleistung. Auch wenn GPU-Compositing „verwendet wird“, läuft der Renderingvorgang nicht unbedingt im besten Modus. Um den Inhalt für die optimale Darstellung anzupassen, verwenden Sie eine Debugger-Version einer Flash-Laufzeitumgebung und stellen Sie DisplayGPUBlendsetting
in Ihrer Datei „mm.cfg“ ein.
Hinweis: Diese Eigenschaft hat immer den Wert false
, wenn aus ActionScript darauf verwiesen wird, das ausgeführt wird, bevor die Laufzeitumgebung ihren ersten Renderingdurchgang ausführt. Wenn Sie wmodeGPU
zum Beispiel von einem Skript in Bild 1 in Adobe Flash Professional untersuchen und Ihre SWF-Datei die erste SWF-Datei ist, die in eine neue Instanz der Laufzeitumgebung geladen wird, ist hat wmodeGPU
den Wert false
. Um einen genauen Wert zu erhalten, warten Sie, bis wenigstens ein Renderingdurchgang erfolgt ist. Wenn Sie einen Ereignis-Listener für das exitFrame
-Eigenschaft eines DisplayObject
schreiben, hat wmodeGPU
den korrekten Wert.
Implementierung
public function get wmodeGPU():Boolean
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
wmodeGPU
-Eigenschaft untersucht, nachdem das mySprite-Anzeigeobjekt gerendert wurde, sodass Sie einen genauen Wert erhalten.
mySprite.addEventListener(EXIT_FRAME, exithandler): function exithandler(exiteventobject:Event):void { trace(stage.wmodeGPU); }
addChild | () | Methode |
override public function addChild(child:DisplayObject):DisplayObject
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Fügt dieser DisplayObjectContainer-Instanz eine untergeordnete DisplayObject-Instanz hinzu. Die untergeordnete Instanz wird allen anderen untergeordneten Objekten dieser DisplayObjectContainer-Instanz an der ersten Position (also oben) hinzugefügt. (Um ein untergeordnetes Objekt an einer bestimmten Indexposition hinzuzufügen, verwenden Sie die addChildAt()
-Methode.)
Wenn Sie ein Child-Objekt hinzufügen, das bereits einem anderen Anzeigeobjektcontainer untergeordnet worden ist, wird es aus dessen Child-Liste entfernt.
Hinweis: Der Befehl stage.addChild()
kann mit einer veröffentlichten SWF-Datei Probleme verursachen, darunter Sicherheitsprobleme und Konflikte mit anderen geladenen SWF-Dateien. In einer Flash-Laufzeitinstanz gibt es immer nur eine Bühne, unabhängig davon, wie viele SWF-Dateien Sie in die Laufzeitumgebung laden. Im Allgemeinen sollten Objekte deshalb gar nicht direkt zur Bühne hinzugefügt werden. Das einzige Objekt, dass die Bühne enthalten sollte, ist das Stammobjekt. Erstellen Sie einen DisplayObjectContainer, um alle Elemente der Anzeigeliste aufzunehmen. Falls erforderlich, fügen Sie diese DisplayObjectContainer-Instanz dann der Bühne hinzu.
Parameter
child:DisplayObject — Die DisplayObject-Instanz, die der DisplayObjectContainer-Instanz untergeordnet werden soll.
|
DisplayObject — Die DisplayObject-Instanz, die Sie im Parameter child übergeben.
|
Auslöser
SecurityError — Durch Aufrufen der addChild() -Methode eines Stage-Objekts wird für jeden Aufrufer, der sich nicht in derselben Sicherheits-Sandbox wie der Bühneneigentümer (die Haupt-SWF-Datei) befindet, eine Ausnahme ausgelöst. Um dies zu verhindern, kann der Bühneneigentümer der Domäne des Aufrufers die entsprechende Berechtigung erteilen, indem er die Methode Security.allowDomain() oder Security.allowInsecureDomain() aufruft. Weitere Informationen finden Sie im Kapitel „Sicherheit“ des ActionScript 3.0 Entwicklerhandbuchs.
|
addChildAt | () | Methode |
override public function addChildAt(child:DisplayObject, index:int):DisplayObject
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Fügt dieser DisplayObjectContainer-Instanz eine untergeordnete DisplayObject-Instanz hinzu. Das untergeordnete Objekt wird an der angegebenen Indexposition eingefügt. Die Indexposition 0 bezeichnet das hintere (untere) Ende der Anzeigeliste für dieses DisplayObjectContainer-Objekt.
Das folgende Beispiel enthält z. B. drei Anzeigeobjekte mit der Bezeichnung a, b und c jeweils an den Indexpositionen 0, 1 und 2:
Wenn Sie ein Child-Objekt hinzufügen, das bereits einem anderen Anzeigeobjektcontainer untergeordnet worden ist, wird es aus dessen Child-Liste entfernt.
Parameter
child:DisplayObject — Die DisplayObject-Instanz, die der DisplayObjectContainer-Instanz untergeordnet werden soll.
| |
index:int — Die Indexposition, an der die untergeordnete Instanz hinzugefügt wird. Wenn Sie eine gerade besetzte Indexposition angeben, werden das untergeordnete Objekt an dieser Stelle sowie alle darüber liegenden Positionen innerhalb der Child-Liste um eine Position nach oben verschoben.
|
DisplayObject — Die DisplayObject-Instanz, die Sie im Parameter child übergeben.
|
Auslöser
SecurityError — Durch Aufrufen der addChildAt() -Methode eines Stage-Objekts wird für jeden Aufrufer, der sich nicht in derselben Sicherheits-Sandbox wie der Bühneneigentümer (die Haupt-SWF-Datei) befindet, eine Ausnahme ausgelöst. Um dies zu verhindern, kann der Bühneneigentümer der Domäne des Aufrufers die entsprechende Berechtigung erteilen, indem er die Methode Security.allowDomain() oder Security.allowInsecureDomain() aufruft. Weitere Informationen finden Sie im Kapitel „Sicherheit“ des ActionScript 3.0 Entwicklerhandbuchs.
|
addEventListener | () | Methode |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. Sie können Ereignis-Listener bei allen Knoten in der Anzeigeliste für eine bestimmte Art von Ereignis, Phase oder Priorität registrieren.
Nachdem Sie einen Ereignis-Listener erfolgreich registriert haben, können Sie seine Priorität nicht durch weitere Aufrufe von addEventListener()
ändern. Um die Priorität eines Listeners zu ändern, müssen Sie zunächst removeListener()
aufrufen. Anschließend können Sie den Listener mit der neuen Prioritätsstufe erneut aufrufen.
Nach der Registrierung des Listeners haben nachfolgende Aufrufe von addEventListener()
mit einem anderen type
- oder useCapture
-Wert eine separate Listener-Registrierung zur Folge. Wenn Sie beispielsweise zuerst einen Listener registrieren, für den useCapture
auf true
gesetzt ist, wird dieser nur während der Aufnahmephase aktiv sein. Wenn Sie addEventListener()
für dasselbe Listener-Objekt erneut aufrufen, diesmal aber useCapture
auf false
gesetzt ist, werden zwei separate Listener angelegt: einer, der während der Aufnahmephase aktiv ist und ein zweiter, der während der Ziel- und Bubbling-Phase aktiv ist.
Sie können einen Ereignis-Listener nicht nur für die Ziel- oder Bubbling-Phase registrieren. Die beiden Phasen hängen während der Registrierung immer zusammen, da Bubbling nur für übergeordnete Elemente des Zielknotens gilt.
Wenn Sie einen Ereignis-Listener nicht mehr brauchen, entfernen sie ihn, indem Sie removeEventListener()
aufrufen. Andernfalls könnte es zu Speicherproblemen kommen. Ereignis-Listener werden nicht automatisch aus dem Speicher entfernt, da der Garbage Collector den Listener nicht entfernt, solange das auslösende Objekt vorhanden ist (sofern der useWeakReference
-Parameter auf true
gesetzt ist).
Beim Kopieren einer EventDispatcher-Instanz werden zugewiesene Ereignis-Listener nicht kopiert. (Wenn ein neu angelegter Knoten einen Ereignis-Listener benötigt, müssen Sie den Listener nach dem Erstellen des Knotens zuweisen.) Wenn Sie jedoch eine EventDispatcher-Instanz verschieben, werden zugewiesene Ereignis-Listener ebenfalls verschoben.
Wenn der Ereignis-Listener bei einem Knoten registriert wird, während mit diesem Knoten ein Ereignis durchgeführt wird, so wird der Ereignis-Listener während der aktuellen Phase nicht ausgelöst, kann aber während einer späteren Phase im Ereignisablauf ausgelöst werden, etwa während der Bubbling-Phase.
Wird ein Ereignis-Listener von einem Knoten entfernt, während mit dem Knoten ein Ereignis durchgeführt wird, so wird er von den aktuellen Aktionen immer noch ausgelöst. Nachdem er entfernt worden ist, wird der Ereignis-Listener nicht wieder aufgerufen (es sei denn er wird für spätere Verarbeitungsvorgänge erneut aufgerufen).
Parameter
type:String — Der Ereignistyp.
| |
listener:Function — Die Listener-Funktion, die das Ereignis verarbeitet. Diese Funktion muss ein Ereignisobjekt als einzigen Parameter akzeptieren und darf keinen Wert zurückgeben, wie das nachfolgende Beispiel zeigt:
function(evt:Event):void Der Name der Funktion ist beliebig. | |
useCapture:Boolean (default = false ) —
Bestimmt, ob der Listener in der Erfassungsphase oder in der Ziel- und Bubbling-Phase arbeitet. Ist useCapture auf true gesetzt, so verarbeitet der Listener das Ereignis nur während der Erfassungsphase und nicht während der Ziel- oder Bubbling-Phase. Hat useCapture hingegen den Wert false , verarbeitet der Listener das Ereignis nur während der Ziel- oder Bubbling-Phase. Um auf das Ereignis in allen drei Phasen zu warten, rufen Sie addEventListener() zweimal auf; einmal ist useCapture auf true gesetzt, und beim zweiten Mal hat useCapture den Wert false .
| |
priority:int (default = 0 ) — Die Prioritätsstufe des Ereignis-Listeners. Die Priorität wird durch eine vorzeichenbehaftete 32-Bit-Ganzzahl zugewiesen. Je höher die Zahl, desto höher die Priorität. Alle Listener mit der Priorität n werden vor Listenern mit der Priorität n -1 verarbeitet. Wenn zwei oder mehr Listener die gleiche Priorität aufweisen, werden sie in der Reihenfolge verarbeitet, in der sie hinzugefügt wurden. Die Standardpriorität ist 0.
| |
useWeakReference:Boolean (default = false ) — Bestimmt, ob der Verweis auf den Listener stark oder schwach ist. Ein starker Verweis (der Standard) verhindert, dass der Listener von einem Garbage Collector entfernt wird. Ein schwacher Verweis hingegen nicht. Funktionen von Mitgliedern auf Klassenebene werden nicht vom Garbagekollektor entfernt. Daher können Sie |
Auslöser
SecurityError — Durch Aufrufen der addEventListener -Methode eines Stage-Objekts wird für jeden Aufrufer, der sich nicht in derselben Sicherheits-Sandbox wie der Bühneneigentümer (die Haupt-SWF-Datei) befindet, eine Ausnahme ausgelöst. Um dies zu verhindern, kann der Bühneneigentümer der Domäne des Aufrufers die entsprechende Berechtigung erteilen, indem er die Methode Security.allowDomain() oder Security.allowInsecureDomain() aufruft. Weitere Informationen finden Sie im Kapitel „Sicherheit“ des ActionScript 3.0 Entwicklerhandbuchs.
|
assignFocus | () | Methode |
public function assignFocus(objectToFocus:InteractiveObject, direction:String):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0 |
Stellt den Tastaturfokus auf das interaktive Objekt ein, das vom objectToFocus
-Parameter angegeben wird. Dabei wird die Richtung des Fokus vom direction
-Parameter bestimmt.
Das Konzept der Fokusrichtung muss von der Anwendung (oder vom Anwendungsframework) definiert werden. Es existiert keine inhärente Funktionalität zum Sortieren des Fokus von interaktiven Objekten, Sie können jedoch über andere verfügbare Eigenschaften ein Anordnungsprinzip definieren. Beispielsweise können Sie interaktive Objekte nach ihren Positionen auf der Bühne oder in der Anzeigeliste sortieren. Ein Aufruf von assignFocus()
entspricht dem Einstellen der Stage.focus
-Eigenschaft, bietet jedoch zusätzlich die Möglichkeit, die Richtung anzugeben, aus der der Fokus eingestellt wird.
Das objectToFocus
-Objekt löst beim Erhalt des Fokus ein focusIn
-Ereignis aus. Die direction
-Eigenschaft des FocusEvent-Objekts gibt die Einstellung des direction
-Parameters an.
Wenn Sie das HTMLLoader-Objekt dem objectToFocus
-Parameter zuweisen, wählt das HTMLLoader-Objekt im HTML-DOM das richtige zu fokussierende Objekt auf Basis des direction
-Parameterwerts. Wenn es sich dabei um FocusDirection.BOTTOM
handelt, erhält im HTML-DOM das zu fokussierende Objekt am Ende der Lesereihefolge den Fokus. Wenn es sich dabei um FocusDirection.TOP
handelt, erhält im HTML-DOM das zu fokussierende Objekt zu Beginn der Lesereihenfolge den Fokus. Wenn es sich dabei um NONE
handelt, erhält das HTMLLoader-Objekt den Fokus, ohne dass sein aktuell fokussiertes Element geändert wird.
Parameter
objectToFocus:InteractiveObject — Das Objekt, das den Fokus erhalten soll, oder null , um den Fokus von einem beliebigen Element auf der Bühne zu entfernen.
| |
direction:String — Die Richtung, aus der das objectToFocus -Objekt den Fokus erhält. Gültige Werte werden als Konstanten in der FocusDirection-Klasse aufgelistet.
|
Auslöser
Error — Wenn der Fokus nicht auf das Ziel eingestellt werden kann oder wenn die Richtung keinen gültigen Typ aufweist.
|
Verwandte API-Elemente
dispatchEvent | () | Methode |
override public function dispatchEvent(event:Event):Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Sendet ein Ereignis in den Ereignisablauf. Das Ereignisziel ist das EventDispatcher-Objekt, für das die Methode dispatchEvent()
aufgerufen wird.
Parameter
event:Event — Das Ereignisobjekt, das in den Ereignisablauf integriert wird. Wenn das Ereignis erneut gesendet wird, wird automatisch ein Klon des Ereignisses erstellt. Nachdem ein Ereignis ausgelöst wurde, lässt sich seine target -Eigenschaft nicht mehr ändern, daher funktioniert ein Zurücksenden des Ereignisses nur, wenn Sie eine neue Kopie des Ereignisses erstellen.
|
Boolean — Der Wert true , wenn das Ereignis erfolgreich ausgelöst wurde. Der Wert false weist entweder auf einen Fehler hin oder auf die Tatsache, dass preventDefault() für das Ereignis aufgerufen worden ist.
|
Auslöser
SecurityError — Durch Aufrufen der dispatchEvent() -Methode eines Stage-Objekts wird für jeden Aufrufer, der sich nicht in derselben Sicherheits-Sandbox wie der Bühneneigentümer (die Haupt-SWF-Datei) befindet, eine Ausnahme ausgelöst. Um dies zu verhindern, kann der Bühneneigentümer der Domäne des Aufrufers die entsprechende Berechtigung erteilen, indem er die Methode Security.allowDomain() oder Security.allowInsecureDomain() aufruft. Weitere Informationen finden Sie im Kapitel „Sicherheit“ des ActionScript 3.0 Entwicklerhandbuchs.
|
hasEventListener | () | Methode |
override public function hasEventListener(type:String):Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. Dadurch können Sie bestimmen, wo ein EventDispatcher-Objekt die Verarbeitung eines Ereignistyps in der Ereignisablaufhierarchie geändert hat. Um festzustellen, ob ein bestimmter Ereignistyp einen Ereignis-Listener auslöst, verwenden Sie willTrigger()
.
Der Unterschied zwischen hasEventListener()
und willTrigger()
besteht darin, dass hasEventListener()
nur das Objekt untersucht, zu dem es gehört, während willTrigger()
den gesamten Ereignisablauf auf das im Parameter type
angegebene Ereignis untersucht.
Wird hasEventListener()
von einem LoaderInfo-Objekt aus aufgerufen, werden nur die Listener berücksichtigt, die dem Aufrufer zugänglich sind.
Parameter
type:String — Der Ereignistyp.
|
Boolean — Der Wert true , wenn ein Listener des angegebenen Typs registriert ist; andernfalls false .
|
Auslöser
SecurityError — Durch Aufrufen der hasEventListener() -Methode eines Stage-Objekts wird für jeden Aufrufer, der sich nicht in derselben Sicherheits-Sandbox wie der Bühneneigentümer (die Haupt-SWF-Datei) befindet, eine Ausnahme ausgelöst. Um dies zu verhindern, kann der Bühneneigentümer der Domäne des Aufrufers die entsprechende Berechtigung erteilen, indem er die Methode Security.allowDomain() oder Security.allowInsecureDomain() aufruft. Weitere Informationen finden Sie im Kapitel „Sicherheit“ des ActionScript 3.0 Entwicklerhandbuchs.
|
invalidate | () | Methode |
public function invalidate():void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Durch Aufrufen der invalidate()
-Methode wird Flash-Laufzeitumgebungen signalisiert, dass bei nächster Gelegenheit die Anzeigeliste neu gezeichnet werden muss (z. B., wenn der Abspielkopf in ein neues Bild tritt). Nachdem Sie die invalidate()
-Methode aufgerufen haben und die Anzeigeliste neu gezeichnet worden ist, sendet die Flash-Laufzeitumgebung ein render
-Ereignis an jedes Anzeigeobjekt, das gemäß seiner Registrierung auf das render
-Ereignis wartet. Sie müssen die invalidate()
-Methode immer dann aufrufen, wenn die Flash-Laufzeitumgebung render
-Ereignisse senden soll.
Das render
-Ereignis gibt Ihnen die Gelegenheit, Änderungen an der Anzeigeliste vorzunehmen, und zwar unmittelbar bevor sie neu gezeichnet wird. Dadurch haben Sie die Möglichkeit, Aktualisierungen an der Anzeigeliste bis zur letzten Gelegenheit zurückzustellen. Auf diese Weise wird die Performance verbessert, da unnötige Bildschirmaktualisierungen vermieden werden.
Das render
-Ereignis wird nur ausgelöst, um Objekte anzuzeigen, die sich in derselben Sicherheitsdomäne befinden wie der Code, der die stage.invalidate()
-Methode aufruft, oder um Anzeigeobjekte aus einer Sicherheitsdomäne anzuzeigen, der die Berechtigung über die Security.allowDomain()
-Methode erteilt wurde.
Verwandte API-Elemente
isFocusInaccessible | () | Methode |
public function isFocusInaccessible():Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Legt fest, ob die Stage.focus
-Eigenschaft aus Sicherheitsgründen den Wert null
zurückgibt. Anders ausgedrückt: isFocusInaccessible
gibt den Wert true
zurück, wenn das Objekt mit dem Fokus zu einer Sicherheits-Sandbox gehört, auf die die SWF-Datei keinen Zugriff hat.
Boolean — true , wenn das Objekt mit dem Fokus zu einer Sicherheits-Sandbox gehört, auf die die SWF-Datei keinen Zugriff hat.
|
removeChildAt | () | Methode |
override public function removeChildAt(index:int):DisplayObject
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Entfernt ein untergeordnetes Anzeigeobjekt aus der angegebenen index
-Position in der Child-Liste des Anzeigeobjekt-Containers. Die parent
-Eigenschaft des entfernten untergeordneten Objekts wird auf null
gesetzt, und das Objekt wird vom Garbage Collector entfernt, wenn keine anderen Verweise auf das untergeordnete Objekt existieren. Die Indexpositionen von Anzeigeobjekten über dem untergeordneten Objekt im Anzeigeobjekt-Container werden um jeweils 1 herabgesetzt.
Der Garbage Collector weist nicht verwendete Speicherkapazität neu zu. Wenn auf Variablen oder Objekte nicht mehr aktiv verwiesen wird und diese auch nirgends mehr gespeichert sind, werden sie vom Garbagekollektor entfernt, und der belegte Arbeitsspeicher wird bereinigt.
Parameter
index:int — Die Child-Indexposition des zu entfernenden Anzeigeobjekts.
|
DisplayObject — Die entfernte DisplayObject-Instanz.
|
Auslöser
SecurityError — Durch das Aufrufen der removeChildAt() -Methode eines Stage-Objekts wird für jeden Aufrufer, der sich nicht in derselben Sicherheits-Sandbox wie das zu entfernende Objekt befindet, eine Ausnahme ausgelöst. Um dies zu verhindern, kann der Objekteigentümer der Domäne des Aufrufers die entsprechende Berechtigung erteilen, indem er die Methode Security.allowDomain() oder Security.allowInsecureDomain() aufruft. Weitere Informationen finden Sie im Kapitel „Sicherheit“ des ActionScript 3.0 Entwicklerhandbuchs.
|
setAspectRatio | () | Methode |
public function setAspectRatio(newAspectRatio:String):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2 |
Legt die Bühne auf eine Ausrichtung mit dem angegebenen Seitenverhältnis fest.
Wenn sich die Bühnenausrichtung in Folge des Methodenaufrufs ändert, setzt das Stage-Objekt ein orientationChange-Ereignis ab.
Um festzustellen, welche Geräteausrichtung unterstützt wird, überprüfen Sie den Wert der Stage.supportsOrientantionChange
-Eigenschaft.
Unterstützung von AIR-Profilen: Diese Funktion wird auf mobilen Geräten unterstützt, nicht jedoch auf Desktopbetriebssystemen oder Geräten mit AIR für TV. Mit der Stage.supportsOrientantionChange
-Eigenschaft können Sie testen, ob zur Laufzeit Unterstützung gegeben ist. Weitere Informationen zum AIR-Support über mehrere Profile finden Sie unter Unterstützung von AIR-Profilen.
Parameter
newAspectRatio:String — Der Typcode für das gewünschte Seitenverhältnis (StageAspectRatio.PORTRAIT , StageAspectRatio.LANDSCAPE oder StageAspectRatio.ANY ).
|
Auslöser
ArgumentError — Der als newAspectRatio -Parameter übergebene Wert ist nicht gültig. Der Wert muss einer der Konstanten entsprechen, die in der StageAspectRatio-Klasse definiert wurden.
|
Verwandte API-Elemente
setChildIndex | () | Methode |
override public function setChildIndex(child:DisplayObject, index:int):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ändert die Position eines vorhandenen untergeordneten Objekts im Anzeigeobjekt-Container. Dies wirkt sich auf die Anordnung der untergeordneten Objekte aus. Das folgende Beispiel enthält z. B. drei Anzeigeobjekte mit der Bezeichnung a, b und c jeweils an den Indexpositionen 0, 1 und 2:
Wenn Sie die setChildIndex()
-Methode verwenden und eine bereits belegte Indexposition angeben, werden nur die Positionen zwischen der alten und der neuen Position des Anzeigeobjekts geändert. Alle anderen Positionen bleiben unverändert. Wenn ein untergeordnetes Objekt an eine NIEDRIGERE Indexposition als bisher verschoben wird, werden alle dazwischen liegenden untergeordneten Objekte für den Indexverweis um 1 ERHÖHT. Wenn ein untergeordnetes Objekt an eine HÖHERE Indexposition als bisher verschoben wird, werden alle dazwischen liegenden untergeordneten Objekte für den Indexverweis um 1 VERRINGERT. Wenn der Anzeigeobjekt-Container im vorigen Beispiel z. B. den Namen container
hat, können Sie die Position der Anzeigeobjekte mit den Bezeichnungen a und b austauschen, indem Sie den folgenden Code aufrufen:
container.setChildIndex(container.getChildAt(1), 0);
Dieser Code führt zur folgenden Objektanordnung:
Parameter
child:DisplayObject — Die child-DisplayObject-Instanz, deren Indexnummer Sie ändern möchten.
| |
index:int — Die resultierende Indexnummer für das child -Anzeigeobjekt.
|
Auslöser
SecurityError — Durch Aufrufen der setChildIndex() -Methode eines Stage-Objekts wird für jeden Aufrufer, der sich nicht in derselben Sicherheits-Sandbox wie der Bühneneigentümer (die Haupt-SWF-Datei) befindet, eine Ausnahme ausgelöst. Um dies zu verhindern, kann der Bühneneigentümer der Domäne des Aufrufers die entsprechende Berechtigung erteilen, indem er die Methode Security.allowDomain() oder Security.allowInsecureDomain() aufruft. Weitere Informationen finden Sie im Kapitel „Sicherheit“ des ActionScript 3.0 Entwicklerhandbuchs.
|
setOrientation | () | Methode |
public function setOrientation(newOrientation:String):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2 |
Stellt die Bühne auf die angegebene Ausrichtung ein.
Legt den newOrientation
-Parameter auf einen der folgenden vier Werte fest, die in der StageOrientation-Klasse als Konstanten definiert wurden:
StageOrientation-Konstante | Bühnenausrichtung |
---|---|
StageOrientation.DEFAULT | Legt die Bühnenausrichtung auf die Standardausrichtung (rechte Seite oben) fest. |
StageOrientation.ROTATED_RIGHT | Legt die Bühnenausrichtung als nach rechts gedreht fest. |
StageOrientation.ROTATED_LEFT | Legt die Bühnenausrichtung als nach links gedreht fest. |
StageOrientation.UPSIDE_DOWN | Legt die Bühnenausrichtung als auf den Kopf gedreht fest. |
Stellen Sie den Parameter nicht auf StageOrientation.UNKNOWN
oder einen anderen Stringwert als die in der Tabelle aufgeführten ein.
Um festzustellen, ob das Ändern der Geräteausrichtung unterstützt wird, überprüfen Sie den Wert der Stage.supportsOrientantionChange
-Eigenschaft. Überprüfen Sie die Liste, die von der supportedOrientations
-Eigenschaft bereitgestellt wird, um festzustellen, welche Ausrichtungen vom aktuellen Gerät unterstützt werden.
Das Festlegen der Ausrichtung ist ein asynchroner Vorgang. Es ist nicht garantiert, dass der Vorgang sofort nach dem Aufrufen der setOrientation()
-Methode abgeschlossen wird. Fügen Sie einen Ereignis-Listener für das orientationChange
-Ereignis hinzu, um festzustellen, wann die Änderung der Ausrichtung abgeschlossen ist.
Wichtig: Die setOrientation()
-Methode wurde auf Android-Geräten in Versionen vor AIR 2.6 nicht unterstützt.
setOrientation()
-Methode führt nicht dazu, dass ein orientationChanging
-Ereignis abgesetzt wird.
Parameter
newOrientation:String — Die neue Ausrichtung der Bühne.
|
Ereignisse
orientationChange: — Die Bühnengröße wurde als Ergebnis des Aufrufs der setOrientation() -Methode geändert.
|
Auslöser
ArgumentError — Der als newOrientation -Parameter übergebene Wert ist nicht gültig. Der Wert muss mit einer der Konstanten übereinstimmen, die in der StageOrientation-Klasse definiert wurden, mit Ausnahme der StageOrientation.UNKNOWN -Konstante.
|
Verwandte API-Elemente
swapChildrenAt | () | Methode |
override public function swapChildrenAt(index1:int, index2:int):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Kehrt die z-Reihenfolge (von vorne nach hinten) der untergeordneten Objekte an den beiden angegebenen Indexpositionen in der Child-Liste um. Alle anderen untergeordneten Objekte im Anzeigeobjekt-Container bleiben auf derselben Indexposition.
Parameter
index1:int — Die Indexposition des ersten untergeordneten Objekts.
| |
index2:int — Die Indexposition des zweiten untergeordneten Objekts.
|
Auslöser
SecurityError — Durch Aufruf der swapChildrenAt() -Methode eines Stage-Objekts wird für jeden Aufrufer, der sich nicht in derselben Sicherheits-Sandbox wie der Eigentümer eines der auszutauschenden Objekte befindet, eine Ausnahme ausgelöst. Um dies zu verhindern, kann der Objekteigentümer der Domäne des Aufrufers die entsprechende Berechtigung erteilen, indem er die Methode Security.allowDomain() oder Security.allowInsecureDomain() aufruft. Weitere Informationen finden Sie im Kapitel „Sicherheit“ des ActionScript 3.0 Entwicklerhandbuchs.
|
willTrigger | () | Methode |
override public function willTrigger(type:String):Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. Diese Methode liefert den Wert true
, wenn während irgendeiner Phase des Ereignisablaufs ein Ereignis-Listener aufgerufen wird, wenn ein Ereignis des angegebenen Typs für dieses EventDispatcher-Objekt oder eines seiner nachfolgenden Elemente ausgelöst wird.
Der Unterschied zwischen der hasEventListener()
- und der willTrigger()
-Methode besteht darin, dass die Methode hasEventListener()
nur das Objekt untersucht, zu dem sie gehört, während die willTrigger()
-Methode den gesamten Ereignisablauf auf das im Parameter type
angegebene Ereignis untersucht.
Wird willTrigger()
von einem LoaderInfo-Objekt aus aufgerufen, werden nur die Listener berücksichtigt, die dem Aufrufer zugänglich sind.
Parameter
type:String — Der Ereignistyp.
|
Boolean — Der Wert true , wenn ein Listener des angegebenen Typs ausgelöst wird; andernfalls false .
|
Auslöser
SecurityError — Durch Aufrufen der willTrigger() -Methode eines Stage-Objekts wird für jeden Aufrufer, der sich nicht in derselben Sicherheits-Sandbox wie der Bühneneigentümer (die Haupt-SWF-Datei) befindet, eine Ausnahme ausgelöst. Um dies zu verhindern, kann der Bühneneigentümer der Domäne des Aufrufers die entsprechende Berechtigung erteilen, indem er die Methode Security.allowDomain() oder Security.allowInsecureDomain() aufruft. Weitere Informationen finden Sie im Kapitel „Sicherheit“ des ActionScript 3.0 Entwicklerhandbuchs.
|
browserZoomChange | Ereignis |
flash.events.Event
Eigenschaft Event.type =
flash.events.Event.BROWSER_ZOOM_CHANGE
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 15 |
Wird ausgelöst, wenn die browserZoomFactor
-Eigenschaft des Stage-Objekts geändert wird.
Event.BROWSER_ZOOM_CHANGE
-Konstante definiert den Wert der type
-Eigenschaft eines browserZoomChange
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Die Stage-Instanz. |
fullScreen | Ereignis |
flash.events.FullScreenEvent
Eigenschaft FullScreenEvent.type =
flash.events.FullScreenEvent.FULL_SCREEN
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9.0.28.0, Flash Lite 4 |
Wird ausgelöst, wenn der Vollbildmodus für das Stage-Objekt aktiviert oder deaktiviert wird. Ein Änderung des Vollbildmodus kann initiiert werden, indem ActionScript verwendet wird, indem Benutzer einen Tastaturbefehl drücken oder indem das Vollbildfenster den Fokus abgibt.
Die KonstanteFullScreenEvent.FULL_SCREEN
definiert den Wert der type
-Eigenschaft eines fullScreen
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
fullScreen | true bei Vollbildanzeige und false bei normaler Anzeige. |
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Stage-Objekt. |
mouseLeave | Ereignis |
flash.events.Event
Eigenschaft Event.type =
flash.events.Event.MOUSE_LEAVE
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wird vom Stage-Objekt abgesetzt, wenn der Zeiger aus dem Bühnenbereich verschoben wird. Wenn die Maustaste gedrückt wird, wird das Ereignis nicht abgesetzt.
DieEvent.MOUSE_LEAVE
-Konstante definiert den Wert der type
-Eigenschaft eines mouseLeave
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Stage-Objekt. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet. |
orientationChange | Ereignis |
flash.events.StageOrientationEvent
Eigenschaft StageOrientationEvent.type =
flash.events.StageOrientationEvent.ORIENTATION_CHANGE
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.0 |
Wird vom Stage-Objekt abgesetzt, wenn sich die Bühnenausrichtung ändert.
Ausrichtungsänderungen können auftreten, wenn der Benutzer das Gerät dreht oder eine Tastatur herausschiebt oder wenn setAspectRatio()
aufgerufen wird.
Hinweis: Wenn die autoOrients
-Eigenschaft den Wert false
hat, ändert sich die Bühnenausrichtung beim Drehen des Geräts nicht. StageOrientationEvents für die Gerätedrehung wird also nur dann abgesetzt, wenn autoOrients
den Wert true
hat.
ORIENTATION_CHANGE
-Konstante definiert den Wert der type
-Eigenschaft eines orientationChange
-Ereignisobjekts. Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaften | Werte |
---|---|
afterOrientation | Die neue Ausrichtung der Bühne. |
beforeOrientation | Die alte Ausrichtung der Bühne. |
target | Das Stage-Objekt, das die Ausrichtungsänderung abgesetzt hat. |
bubbles | true |
currentTarget | Gibt das Objekt an, das das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
cancelable | false ; es ist zu spät, um die Änderung abzubrechen. |
orientationChanging | Ereignis |
flash.events.StageOrientationEvent
Eigenschaft StageOrientationEvent.type =
flash.events.StageOrientationEvent.ORIENTATION_CHANGING
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.0 |
Wird vom Stage-Objekt abgesetzt, wenn die Änderung der Bühnenausrichtung beginnt.
Wichtig: orientationChanging-Ereignisse werden bei Android-Geräten nicht abgesetzt.
Hinweise:
-
Wenn die
autoOrients
-Eigenschaft den Wertfalse
hat, ändert sich die Bühnenausrichtung beim Drehen des Geräts nicht. StageOrientationEvents für die Gerätedrehung wird also nur dann abgesetzt, wennautoOrients
den Werttrue
hat. -
Wenn Sie die Ausrichtung programmgesteuert mit der
setOrientation()
-Methode festlegen, wird dasorientationChanging
-Ereignis nicht abgesetzt.
ORIENTATION_CHANGING
-Konstante definiert den Wert der type
-Eigenschaft eines orientationChanging
-Ereignisobjekts. Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaften | Werte |
---|---|
afterOrientation | Die neue Ausrichtung der Bühne. |
beforeOrientation | Die alte Ausrichtung der Bühne. |
target | Das Stage-Objekt, das die Ausrichtungsänderung abgesetzt hat. |
bubbles | true |
currentTarget | Gibt das Objekt an, das das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
cancelable | true . |
resize | Ereignis |
flash.events.Event
Eigenschaft Event.type =
flash.events.Event.RESIZE
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wird ausgelöst, wenn die scaleMode
-Eigenschaft des Stage-Objekts auf StageScaleMode.NO_SCALE
gesetzt und die Größe der SWF-Datei verändert wird. Wird ebenfalls ausgelöst, wenn in Flash Player 15 und höher die Bildschirmausrichtung im Vollbildmodus geändert wird.
Event.RESIZE
-Konstante definiert den Wert der type
-Eigenschaft eines resize
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Stage-Objekt. |
stageVideoAvailability | Ereignis |
flash.events.StageVideoAvailabilityEvent
Eigenschaft StageVideoAvailabilityEvent.type =
flash.events.StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABILITY
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 10.2 |
Wird vom Stage-Objekt abgesetzt, wenn sich der Status der stageVideos-Eigenschaft ändert.
Definiert den Wert dertype
-Eigenschaft eines stageVideoAvailability
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
availability | Der vom Ereignis gemeldete Status. |
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, das das Ereignis aktiv verarbeitet. |
target | Das Stage-Objekt, das die Verfügbarkeit des Bühnenvideos angibt. |
Beispiel ( Verwendung dieses Beispiels )
StageExample
verwendet, um Ereignisse auszulösen, wenn die Bühne aktiviert oder wenn deren Größe geändert wird. Dies wird in den folgenden Schritten erreicht:
- Der Klassenkonstruktor richtet zuerst die Flash-Anwendung ein, die unabhängig von der Größe des Flash Player-Fensters fixiert werden soll, und fügt unter Verwendung der Methoden
activateHandler()
undresizeHandler()
dann zwei Ereignis-Listener hinzu. - Die
activateHandler()
-Methode wird ausgeführt, sobald die linke Maustaste gedrückt wird. - Die
resizeHandler()
-Methode wird ausgeführt, wenn die Größe der Bühne geändert wird.
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 | Ereignis |
flash.events.VsyncStateChangeAvailabilityEvent
Eigenschaft VsyncStateChangeAvailabilityEvent.type =
flash.events.VsyncStateChangeAvailabilityEvent
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 29.0 |
Wird vom Stage-Objekt ausgelöst, wenn sich der Status der vsync-Eigenschaft ändert.
Definiert den Wert der type-Eigenschaft eines VsyncStateChangeAvailabilityEvent
-Ereignisobjekts.
Beispiel ( Verwendung dieses Beispiels )
VsyncExample
-Klasse genutzt, um Ereignisse auszulösen, wenn der vsync-Status der Bühne aktiviert oder deaktiviert werden kann. Dies wird in den folgenden Schritten erreicht:
- Der Konstruktor löst zuerst das Stage-Ereignis
VsyncStateChangeAvailabilityEvent
aus. - Dann wird die Methode
onVsyncStateChangeAvailability
aufgerufen, in der geprüft wird, ob dasVsyncStateChangeAvailabilityEvent
verfügbar ist oder nicht. - Falls verfügbar, können Sie den vsync-Status der Bühne umschalten. Andernfalls ist der Wert der
vsyncEnable
-Eigenschaft schreibgeschützt. - Der vsyncEnable-Wert kann nur dann ausgelöst werden, wenn das Ereignis ausgelöst wird.
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, 10:04 AM Z