NativeWindow  - AS3

Gibt an, ob es sich bei diesem Fenster um das aktive Anwendungsfenster handelt.

Verwenden Sie die activate()-Methode, um ein Fenster zu aktivieren.

Verwandte API-Elemente

Gibt an, ob dieses Fenster sich stets vor anderen Fenstern befindet (auch vor Fenstern anderer Anwendungen).

Die Tiefenanordnung des Systems lässt sich in zwei Fenstergruppen einteilen. Fenster in der Gruppe alwaysInFront werden immer vor allen anderen Fenstern angezeigt. Die Tiefenanordnung der Fenster in derselben Gruppe wird normal bestimmt. Das heißt, dass ein Fenster durch Aktivieren vor die anderen Fenster in seiner Gruppe gestellt wird.

Wird alwaysInFront von false zu true geändert, wird das Fenster vor alle anderen Fenster gestellt. Beim Ändern der Eigenschaft von true zu false wird das Fenster hinter die Fenster gestellt, die auf „alwaysInFront“ eingestellt sind, es befindet sich jedoch immer noch vor allen anderen Fenstern. Wenn die Eigenschaft auf ihren aktuellen Wert eingestellt wird, ändert sich die Tiefenanordnung der Fenster nicht. Das Festlegen der alwaysInFront-Eigenschaft eines Fensters, das einen Eigentümer hat, bleibt ohne Auswirkungen.

Die alwaysInFront-Eigenschaft sollte nur selten auf true gesetzt werden, da Fenster mit dieser Einstellung auch vor den Fenstern anderer Anwendungen angezeigt werden, selbst wenn die andere Anwendung aktiv ist.

Hinweise zum Verhalten des Betriebssystems:

• Einige Linux-Fenstermanager zeigen keine Fenster an, deren alwaysInFront-Eigenschaft vor Vollbildfenstern auf gesetzt ist.
• Unter Mac^® OS X hat die Einstellung von alwaysInFront auf true keine Wirkung, wenn die displayState-Eigenschaft der Fensterbühne entweder fullScreen oder fullScreenInteractive lautet.

windowObj.alwaysInFront = true;

displayObject.stage.nativeWindow.alwaysInFront=true;

window.nativeWindow.alwaysInFront = true;

Die Größe und Position dieses Fensters.

Die Abmessungen eines Fensters umfassen auch ggf. vorhandenes Systemchrom. Die Abmessungen der Fensterbühne entsprechen den Fensterabmessungen abzüglich der Größe des ggf. vorhandenen Systemchroms. Wenn die Breite und die Höhe des Fensters geändert werden, ändern sich auch die Eigenschaften stageWidth und stageHeight der Bühne. Umgekehrt wird bei einer Änderung der Bühnenabmessungen auch die Fenstergröße geändert.

In einem HTML-Stammfenster entsprechen die outerWidth- und outerHeight-Eigenschaften den Fenstereigenschaften height und width. Die Eigenschaften innerWidth und innerHeight entsprechen den Eigenschaften stage.stageWidth und stage.stageHeight abzüglich der Dicke der automatischen Bildlaufleisten, die ggf. im Fenster angezeigt werden.

Ein resize-Ereignis wird immer ausgelöst, wenn sich die Breite oder die Höhe dieses Fensters ändert. Gleichermaßen wird ein move-Ereignis ausgelöst, wenn sich der Ursprung (x,y) dieses Fensters ändert. Unter Mac OS und Windows löst das direkte Setzen der bounds-Eigenschaft kein moving- oder resizing-Ereignis aus. Unter Linux löst das NativeWindow moving- und resizing-Ereignisse aus, wenn Sie die bounds-Eigenschaft setzen.

Das Setzen der bounds-Eigenschaft für ein Fenster entspricht dem Setzen der Eigenschaften x, y, width und height. Ähnlich entspricht das Setzen der einzelnen Abmessungen dem Setzen der bounds-Eigenschaft. Wenn Sie alle Abmessungen unter Verwendung der bounds-Eigenschaft gleichzeitig setzen, werden weniger Ereignisse ausgelöst.

Die Reihenfolge, in der die einzelnen Abmessungswerte gesetzt werden, ist nicht garantiert. Bei Linux-Fenstermanagern, die die Vergrößerung von Fenstern über den Desktopbereich hinaus nicht erlauben, kann die Änderung einer einzelnen Eigenschaft blockiert werden, selbst wenn der Gesamteffekt bei Anwendung aller Eigenschaftenänderungen ein gültiges Fenster ergeben hätte.

Wenn die angegebene Breite bzw. Höhe den erlaubten Mindest- oder Höchstwert unter- bzw. überschreitet, wird die Fensterbreite oder -höhe auf den nächsten zulässigen Wert gesetzt. Folgende Faktoren bestimmen die minimale und maximale Breite bzw. Höhe:

• Die minSize- und maxSize-Eigenschaft des NativeWindow-Objekts
• Die Mindest- und Höchstgrenze des Betriebssystems, die den Werten von NativeWindow.systemMinSize und NativeWindow.systemMaxSize entspricht.
• Die maximale Breite und Höhe eines Fensters in Adobe AIR, die je 4095 Pixel beträgt. (In AIR 1.5 und älter beträgt die maximale Breite und Höhe eines Fensters jeweils 2880 Pixel.)
• Die minimale Breite und Höhe für ein beliebiges angezeigtes Systemchrom.

Pixelwerte werden auf die nächste Ganzzahl gerundet, wenn die Position oder Größe eines Fensters geändert wird.

Verwandte API-Elemente

windowObj.bounds = new Rectangle(200, 200, 1000, 800);

displayObject.stage.nativeWindow.bounds = new Rectangle(20, 20, 800, 600);

window.nativeWindow.bounds = new air.Rectangle(20, 20, 800, 600);

Gibt an, ob dieses Fenster geschlossen wurde.

Beim Zugriff auf die folgenden Eigenschaften für ein geschlossenes Fenster wird ein Fehler aufgrund eines ungültigen Vorgangs ausgegeben:

• title
• bounds
• x, y, width, height
• displayState
• visible

Gleichermaßen wird beim Aufrufen der folgenden Methoden für ein geschlossenes Fenster ein Fehler aufgrund eines ungültigen Vorgangs ausgegeben:

• minimize()
• maximize()
• restore()
• startResize()
• startMove()

var isWindowClosed:Boolean = windowObj.closed;

var isWindowClosed:Boolean = displayObject.stage.nativeWindow.closed;

var isWindowClosed = window.nativeWindow.closed;

Der Anzeigestatus dieses Fensters.

Konstanten für die möglichen Werte sind in der NativeWindowDisplayState-Klasse definiert:

• NativeWindowDisplayState.NORMAL
• NativeWindowDisplayState.MINIMIZED
• NativeWindowDisplayState.MAXIMIZED

Verwandte API-Elemente

var state:String = windowObj.displayState;

Die Höhe dieses Fensters in Pixel.

Die Abmessungen eines Fensters umfassen auch ggf. angezeigtes Systemfensterchrom. Die Höhe des nutzbaren Anzeigebereichs innerhalb eines Fensters ist über die Stage.stageHeight-Eigenschaft verfügbar.

Das Ändern der height-Eigenschaft eines Fensters entspricht dem Ändern der Höhe über die bounds-Eigenschaft.

Wenn die angegebene Höhe den erlaubten Mindest- oder Höchstwert unter- bzw überschreitet, wird die Fensterhöhe auf den nächsten zulässigen Wert gesetzt. Folgende Faktoren bestimmen die minimale und maximale Höhe:

• Die minSize.x- und maxSize.x-Eigenschaft des NativeWindow-Objekts
• Die Mindest- und Höchstgrenze des Betriebssystems, die den Werten von NativeWindow.systemMinSize und NativeWindow.systemMaxSize entspricht.
• Die maximale Höhe eines Fensters in Adobe AIR, 4095 Pixel (in AIR 1.5 und älter 2880 Pixel).

Unter Linux ist das Setzen der height-Eigenschaft ein asynchroner Vorgang.

Durch Warten auf das resize-Ereignis, das auf allen Plattformen ausgelöst wird, kann festgestellt werden, ob die Höhenänderung abgeschlossen wurde.

Pixelwerte werden auf die nächste Ganzzahl gerundet, wenn die Höhe eines Fensters geändert wird.

Verwandte API-Elemente

Gibt an, ob das Clientsystem native Fenster unterstützt.

Gibt die maximizable-Einstellung an, mit der dieses Fenster erstellt wurde.

Die maximizable-Einstellung kann nach der Erstellung des Fensters nicht mehr geändert werden.

Hinweis: Einige Linux-Fenstermanager lassen das Maximieren von Fenstern durch den Benutzer zu, selbst wenn die maximizable-Eigenschaft den Wert false aufweist.

Verwandte API-Elemente

Die maximale Größe dieses Fensters.

Der Größengrenzwert wird über die Koordinaten eines Point-Objekts festgelegt. Die x-Eigenschaft des Punkts entspricht der Fensterbreite, und die y-Eigenschaft der Fensterhöhe.

Die maxSize-Einschränkung wird für Änderungsvorgänge der Fenstergröße erzwungen, die über ActionScript --Code und über das Betriebssystem aufgerufen werden.

Beim Einstellen von maxSize werden die Fenstergrenzen geändert, wenn die aktuellen Begrenzungen größer als die neue Maximalgröße sind.

Wenn die angegebene Breite bzw. Höhe den erlaubten Höchstwert überschreitet, wird die Fensterbreite auf den nächsten zulässigen Wert gesetzt. Folgende Faktoren bestimmen die minimale und maximale Breite bzw. Höhe:

• Der maximal zulässige Wert des Betriebssystems, also der NativeWindow.systemMaxSize-Wert.
• Die maximale Breite und Höhe eines Fensters in Adobe AIR, die je 4095 Pixel beträgt. (In AIR 1.5 und älter beträgt die maximale Breite und Höhe eines Fensters jeweils 2880 Pixel.)

Hinweis: Unter manchen Betriebssystemen, beispielsweise Mac OS X, werden Fenster beim Vergrößern nur auf den maxSize-Wert maximiert, selbst wenn das maximierte Fenster kleiner ist als das Betriebssystemfenster. Das Fenster befindet sich dennoch im maximierten Anzeigestatus.

Verwandte API-Elemente

windowObj.maxSize = new Point(1040,920);

displayObject.stage.nativeWindow.maxSize = new Point(800,600);

window.nativeWindow.maxSize = new air.Point(960,960);

Das native Menü für dieses Fenster.

Wenn der menu-Eigenschaft des Fensters ein NativeMenu-Objekt zugewiesen ist, wird ein natives Menü für das Fenster angezeigt, wenn NativeWindow.supportsMenu auf true eingestellt ist, es sei denn, die systemChrome-Eigenschaft des Fensters lautet NativeWindowSystemChrome.NONE.

Hinweis: Wenn NativeWindow.supportsMenu auf false eingestellt ist oder wenn die systemChrome-Eigenschaft des Fensters NativeWindowSystemChrome.NONE lautet, darf einem Fenster zwar ein Menü zugewiesen werden, dies hat jedoch keine Wirkung. Sie sollten die NativeWindow.supportsMenu-Eigenschaft verwenden, um festzulegen, ob das Betriebssystem Fenstermenüs unterstützt. Die Verwendung anderer Vorgehensweisen (z. B. Capabilities.os) zur Festlegung der Unterstützung kann zu Programmierfehlern führen (beispielsweise dann, wenn mögliche Zielbetriebssysteme nicht berücksichtigt werden).

Verwandte API-Elemente

Gibt die minimizable-Einstellung an, mit der dieses Fenster erstellt wurde.

Die minimizable-Einstellung kann nach der Erstellung des Fensters nicht mehr geändert werden.

Hinweis: Einige Linux-Fenstermanager lassen das Minimieren von Fenstern durch den Benutzer zu, selbst wenn die minimizable-Eigenschaft den Wert false aufweist.

Verwandte API-Elemente

Die Mindestgröße dieses Fensters.

Der Größengrenzwert wird über die Koordinaten eines Point-Objekts festgelegt. Die x-Eigenschaft des Punkts entspricht der Fensterbreite, und die y-Eigenschaft der Fensterhöhe.

Beim Einstellen von minSize werden die Fenstergrenzen geändert, wenn die aktuellen Begrenzungen kleiner als die neue Mindestgröße sind.

Die minSize-Einschränkung wird für Änderungsvorgänge der Fenstergröße erzwungen, die über ActionScript --Code und über das Betriebssystem aufgerufen werden.

Hinweis: Die Breite und Höhe von ggf. angezeigtem Systemchrom können möglicherweise dazu führen, dass ein Fenster nicht auf die angegebene minimale Größe eingestellt werden kann.

Verwandte API-Elemente

windowObj.minSize = new Point(200,80);

displayObject.stage.nativeWindow.minSize = new Point(120,60);

window.nativeWindow.minSize = new air.Point(80,60);

Das NativeWindow-Objekt, das Eigentümer dieses Fensters ist.

Der Eigentümer eines Fensters wird beim Erstellen des Fensters festgelegt und kann nicht geändert werden. Um ein Fenster zu erstellen, das einen Eigentümer hat, legen Sie das NativeWindow-Objekt, das der Eigentümer ist, als owner-Eigenschaft des NativeWindowInitOptions-Objekts fest, das zum Erstellen des untergeordneten Fensters verwendet wird.

Hinweis: Unter Linux zeigen einige Fenstermanager keine untergeordneten Fenster (Eigentum) im Vordergrund des Eigentümerfensters an, wenn dieses im Vollbildmodus angezeigt wird.

Verwandte API-Elemente

Gibt die renderMode-Einstellung an, mit der dieses Fenster erstellt wurde.

Bei dem von NativeWindow.renderMode zurückgegebenen Wert handelt es sich um eine der Konstanten, die in der NativeWindowRenderMode-Klasse definiert sind.

Die renderMode-Einstellung kann nach der Erstellung des Fensters nicht mehr geändert werden.

Verwandte API-Elemente

Gibt die resizable-Einstellung an, mit der dieses Fenster erstellt wurde.

Die resizable-Einstellung kann nach der Erstellung des Fensters nicht mehr geändert werden.

Verwandte API-Elemente

Das Stage-Objekt für dieses Fenster. Das Stage-Objekt ist das Stammobjekt in der Anzeigelistenarchitektur, die in ActionScript 3.0-basiertem SWF-Inhalt verwendet wird.

Die Bühne bildet den Stamm der Anzeigeliste für das Fenster. Visuelle Anzeigeobjekte können einem Fenster hinzugefügt werden, indem sie der Bühne hinzugefügt werden oder einem anderen Objekt, das sich bereits in der Anzeigeliste dieser Bühne befindet. Die Bühnenabmessungen entsprechen denen des Fensterclientbereichs, wenn Systemchrom für das Fenster verwendet wird. Die Bühnenabmessungen sind mit denen des Fensters identisch, wenn kein Systemchrom verwendet wird.

Verwandte API-Elemente

import flash.display.StageAlign;

windowObj.stage.align = StageAlign.TOP_LEFT;

Gibt an, ob AIR native Fenstermenüs auf dem aktuellen Computersystem unterstützt.

Wenn NativeWindow.supportsMenu auf true eingestellt ist, wird ein natives Menü für ein Fenster angezeigt, wenn der menu-Eigenschaft des Fensters ein nativemenu-Objekt zugewiesen ist, es sei denn, die systemchrome-Eigenschaft des Fensters ist auf NativeWindowSystemChrome.NONE eingestellt. Sie sollten die NativeWindow.supportsMenu-Eigenschaft verwenden, um festzulegen, ob das Betriebssystem native Fenstermenüs unterstützt. Die Verwendung anderer Vorgehensweisen (z. B. Capabilities.os) zur Festlegung der Unterstützung kann zu Programmierfehlern führen (beispielsweise dann, wenn mögliche Zielbetriebssysteme nicht berücksichtigt werden).

Hinweis: Wenn NativeWindow.supportsMenu auf false eingestellt ist oder wenn die systemChrome-Eigenschaft des Fensters NativeWindowSystemChrome.NONE lautet, darf einem Fenster zwar ein Menü zugewiesen werden, dies hat jedoch keine Wirkung.

Verwandte API-Elemente

Gibt an, ob AIR Fensterbenachrichtigungshinweise auf dem aktuellen Computersystem unterstützt.

Wenn NativeWindow.supportsNotification auf true eingestellt ist, bewirkt ein Aufruf der notifyUser()-Methode des Fensters, dass der Benutzer in einem visuellen Hinweis auf ein wichtiges Ereignis aufmerksam gemacht wird. Der visuelle Hinweis entspricht den Konventionen des nativen Betriebssystems. So blinkt unter Windows^® beispielsweise das Taskleistensymbol auf.

Hinweis: notifyUser() kann zwar aufgerufen werden, wenn NativeWindow.supportsNotification auf false eingestellt ist, hat in diesem Fall jedoch keine Wirkung.

Verwandte API-Elemente

Gibt an, ob AIR native Fenster mit transparenten Pixeln unterstützt.

Wenn NativeWindow.supportsTransparency auf true gesetzt ist, wird Pixeltransparenz befolgt, sofern die transparent-Eigenschaft auf true gesetzt ist. Die Deckkraft aller Pixel wird auf 1 gesetzt, wenn NativeWindow.supportsTransparency auf false gesetzt ist, unabhängig vom Wert der transparent-Eigenschaft des Fensters. Voll transparente Pixel werden schwarz dargestellt, wenn NativeWindow.supportsTransparency auf false gesetzt ist. Sie sollten die NativeWindow.supportsTransparency-Eigenschaft verwenden, um festzulegen, ob das Betriebssystem Transparenz unterstützt. Die Verwendung anderer Vorgehensweisen (z. B. Capabilities.os) zur Festlegung der Unterstützung kann zu Programmierfehlern führen (beispielsweise dann, wenn mögliche Zielbetriebssysteme nicht berücksichtigt werden).

Hinweis: Der Wert dieser Eigenschaft kann sich aufgrund von Benutzereinstellungen für das Betriebssystem ändern, während die Anwendung ausgeführt wird.

Verwandte API-Elemente

Gibt die Systemchromeinstellung an, mit der dieses Fenster erstellt wurde.

Bei den von NativeWindow.systemChrome zurückgegebenen Werten handelt es sich um eine der Konstanten, die in der NativeWindowSystemChrome-Klasse definiert sind.

Die Systemchromeinstellung kann nach der Erstellung des Fensters nicht mehr geändert werden.

Verwandte API-Elemente

var sysChromeType:String = windowObj.systemChrome;

var sysChromeType:String = displayObject.stage.nativeWindow.systemChrome;

var sysChromeType = window.nativeWindow.systemChrome;

import flash.display.NativeWindow;
import flash.display.NativeWindowSystemChrome;
import flash.display.NativeWindowInitOptions;

public function deChromeWindow(oldWindow:NativeWindow):NativeWindow{
    if(oldWindow.systemChrome != NativeWindowSystemChrome.NONE){
        var newOptions:NativeWindowInitOptions = new NativeWindowInitOptions();
        newOptions.systemChrome = NativeWindowSystemChrome.NONE;
        newOptions.transparent = true;
        
        var newWindow:NativeWindow = new NativeWindow(newOptions);
        newWindow.stage.stageWidth = oldWindow.stage.stageWidth;
        newWindow.stage.stageHeight = oldWindow.stage.stageHeight;
        newWindow.stage.align = oldWindow.stage.align;
        newWindow.stage.scaleMode = oldWindow.stage.scaleMode;
        
        for(var i:int = 0; i < oldWindow.stage.numChildren; i++){
            newWindow.stage.addChild(oldWindow.stage.getChildAt(i));
        }
        newWindow.activate();
        oldWindow.close();
        
        return newWindow;
    }
    return oldWindow;
}

Die größte Fenstergröße, die unter dem Betriebssystem zulässig ist.

Der Größengrenzwert wird über die Koordinaten eines Point-Objekts festgelegt. Die x-Eigenschaft des Punkts entspricht der Fensterbreite, und die y-Eigenschaft der Fensterhöhe.

Neben den Größenbeschränkungen des Betriebssystems gilt in AIR eine maximale Fenstergröße von 4095 mal 4095 Pixel (2880 Pixel mal 2880 Pixel in AIR 1.5 und älter). Des Weiteren kann eine Anwendung mithilfe der maxSize-Eigenschaft des NativeWindow-Objekts einen Grenzwert setzen.

Die kleinste Fenstergröße, die unter dem Betriebssystem zulässig ist.

Der Größengrenzwert wird über die Koordinaten eines Point-Objekts festgelegt. Die x-Eigenschaft des Punkts entspricht der Fensterbreite, und die y-Eigenschaft der Fensterhöhe.

Der Fenstertitel.

Der Titel wird im Systemchrom des Fensters eingeblendet, sofern angezeigt, sowie in anderen systemabhängigen Orten (beispielsweise in der Taskleiste).

windowObj.title = "Window Title";

Gibt die Transparenzeinstellung an, mit der dieses Fenster erstellt wurde.

Die transparent-Eigenschaft kann nach der Erstellung des Fensters nicht mehr geändert werden. Die Transparenz wirkt sich sowohl auf die visuelle Darstellung als auch auf das Mausverhalten des Fensters aus. Unter Windows und Max OS X kann ein Fenster Mausereignisse nicht wahrnehmen, wenn der Alphawert der Pixel unter einer bestimmten Grenze liegt. Diese Grenze liegt je nach Betriebssystem ungefähr zwischen ,06 und ,01. Unter Linux nimmt das Fenster Mausereignisse oberhalb volltransparenter Bereiche wahr und hindert Benutzer dadurch daran, auf andere Fenster und Elemente auf dem Desktop zuzugreifen.

Hinweis: Die Fenstertransparenz kann nicht in allen Fällen unterstützt werden. Ist aufgrund der Betriebssystemkonfiguration des Benutzers die Transparenz nicht verfügbar, so wird das Fenster ohne Transparenz erstellt. Bereiche, die transparent hätten sein sollen, werden mit Schwarz zusammengesetzt. Verwenden Sie die NativeWindow.supportsTransparency-Eigenschaft um festzulegen, ob die Fenstertransparenz unterstützt wird.

Verwandte API-Elemente

Gibt die type-Einstellung an, mit der dieses Fenster erstellt wurde.

Bei den von NativeWindow.type zurückgegebenen Werten handelt es sich um eine der Konstanten, die in der NativeWindowType-Klasse definiert sind.

Die type-Einstellung kann nach der Erstellung des Fensters nicht mehr geändert werden.

Verwandte API-Elemente

Gibt an, ob dieses Fenster sichtbar ist.

Ein unsichtbares Fenster wird nicht auf dem Desktop angezeigt, aber alle Eigenschaften und Methoden des Fensters sind gültig.

Standardmäßig ist visible auf false eingestellt. Um ein Fenster anzuzeigen, stellen Sie visible auf true ein oder rufen Sie NativeWindow.activate() auf.

Wenn dieses Fenster einen Eigentümer hat, bestimmt der Sichtbarkeitsstatus des Eigentümerfensters, ob dieses Fenster angezeigt wird. Wenn das Eigentümerfenster nicht angezeigt wird, werden die Fenster, die es besitzt, nicht angezeigt, selbst wenn ihre visible-Eigenschaften auf true gesetzt sind.

Hinweis: Unter Mac OS X hat die Einstellung visible=false für ein minimiertes Fenster nicht zur Folge, dass das Fenstersymbol aus dem Dock entfernt wird. Wenn der Benutzer anschließend auf das Symbol im Dock klickt, kehrt das Fenster zum visible-Status zurück und wird auf dem Desktop angezeigt.

Verwandte API-Elemente

windowObj.visible = true;

displayObj.stage.nativeWindow.visible = true;

window.nativeWindow.visible = true;

Die Breite dieses Fensters in Pixel.

Die für ein natives Fenster protokollierten Abmessungen umfassen alle angezeigten Systemfensterchrome. Die Breite des nutzbaren Anzeigebereichs innerhalb eines Fensters ist über die Stage.stageWidth-Eigenschaft verfügbar.

Das Ändern der width-Eigenschaft eines Fensters entspricht dem Ändern der Breite über die bounds-Eigenschaft.

Wenn die angegebene Breite den erlaubten Mindest- oder Höchstwert unter- bzw überschreitet, wird die Fensterbreite auf den nächsten zulässigen Wert gesetzt. Folgende Faktoren bestimmen die minimale und maximale Breite:

• Die minSize.y- und maxSize.y-Eigenschaft des NativeWindow-Objekts
• Die Mindest- und Höchstgrenze des Betriebssystems, die den Werten von NativeWindow.systemMinSize.y und NativeWindow.systemMaxSize.y entspricht.
• Die maximale Breite eines Fensters in Adobe AIR, 4095 Pixel (in AIR 1.5 und älter 2880 Pixel).

Unter Linux ist das Setzen der width-Eigenschaft ein asynchroner Vorgang.

Durch Warten auf das resize-Ereignis, das auf allen Plattformen ausgelöst wird, kann festgestellt werden, ob die Höhenänderung abgeschlossen wurde.

Pixelwerte werden auf die nächste Ganzzahl gerundet, wenn die Breite eines Fensters geändert wird.

Verwandte API-Elemente

Die horizontale Achsenkoordinate der linken oberen Ecke dieses Fensters relativ zur linken oberen Ecke des Betriebssystemdesktops.

Auf Systemen mit mehreren Monitoren kann x negativ sein. Wenn Sie den Wert speichern, etwa um ein Fenster wieder an seiner vorherigen Position zu platzieren, sollten Sie sicherstellen, dass die wiederhergestellte Position brauchbar ist. Änderungen der Bildschirmauflösung oder Monitoranordnung können dazu führen, dass ein Fenster außerhalb des Bildschirms platziert wird. Verwenden Sie die Screen-Klasse, um Informationen über die Desktopgeometrie zu erhalten.

Das Ändern der x-Eigenschaft eines Fensters entspricht dem Ändern der Position über die bounds-Eigenschaft.

Unter Linux ist das Setzen der x-Eigenschaft ein asynchroner Vorgang.

Durch Warten auf das move-Ereignis, das auf allen Plattformen ausgelöst wird, kann die Fertigstellung der Positionsänderung entdeckt werden.

Pixelwerte werden auf die nächste Ganzzahl gerundet, wenn die x-Koordinate eines Fensters geändert wird.

Verwandte API-Elemente

Die vertikale Achsenkoordinate der oberen linken Ecke dieses Fensters relativ zur oberen linken Ecke des Betriebssystem-Desktops.

Auf Systemen mit mehreren Monitoren kann y negativ sein. Wenn Sie den Wert speichern, etwa um ein Fenster wieder an seiner vorherigen Position zu platzieren, sollten Sie sicherstellen, dass die wiederhergestellte Position brauchbar ist. Änderungen der Bildschirmauflösung oder Monitoranordnung können dazu führen, dass ein Fenster außerhalb des Bildschirms platziert wird. Verwenden Sie die Screen-Klasse, um Informationen über die Desktopgeometrie zu erhalten.

Das Ändern der y-Eigenschaft eines Fensters entspricht dem Ändern der Position über die bounds-Eigenschaft.

Unter Linux ist das Setzen der y-Eigenschaft ein asynchroner Vorgang.

Durch Warten auf das move-Ereignis, das auf allen Plattformen ausgelöst wird, kann die Fertigstellung der Positionsänderung entdeckt werden.

Pixelwerte werden auf die nächste Ganzzahl gerundet, wenn die y-Koordinate eines Fensters geändert wird.

Verwandte API-Elemente

Erstellt eine neue NativeWindow-Instanz und ein entsprechendes Betriebssystem-Fenster.

Die im initOptions-Parameter definierten Einstellungen können nach der Erstellung des Fensters nicht mehr geändert werden. Ungültige initOptions-Einstellungen geben einen Fehler aufgrund eines ungültigen Vorgangs aus. Einstellungen, die zwar gültig, aber auf dem aktuellen System nicht verfügbar sind, verursachen keinen Ausnahmefehler. Die spezifischen Fensterfunktionen des aktuellen Betriebssystems lassen sich bei Bedarf über die statischen NativeWindow-Mitglieder ermitteln, wie beispielsweise systemMaxSize.

Die Standardfenstergröße wird vom Betriebssystem bestimmt. Fenster werden in einem nicht sichtbaren Zustand erstellt. Damit Änderungen am Fenster nicht sichtbar werden, ändern Sie nicht die visible-Eigenschaft des Fensters auf true und rufen Sie nicht activate() auf, bevor die Fensteränderungen abgeschlossen sind.

Verwandte API-Elemente

import flash.display.NativeWindowInitOptions;
import flash.display.NativeWindowSystemChrome;
import flash.display.NativeWindowType;
import flash.display.NativeWindow;
import flash.display.StageAlign;
import flash.display.StageScaleMode;
import flash.geom.Rectangle;

var windowOptions:NativeWindowInitOptions = new NativeWindowInitOptions();
windowOptions.systemChrome = NativeWindowSystemChrome.STANDARD;
windowOptions.type = NativeWindowType.NORMAL;

var newWindow:NativeWindow = new NativeWindow(windowOptions);
newWindow.stage.scaleMode = StageScaleMode.NO_SCALE;
newWindow.stage.align = StageAlign.TOP_LEFT;
newWindow.bounds = new Rectangle(100, 100, 800, 800);

newWindow.activate();

Aktiviert dieses Fenster.

Die Aktivierung eines Fensters hat folgende Auswirkungen:

• Das Fenster wird sichtbar.
• Das Fenster wird in den Vordergrund gestellt.
• Das Fenster erhält Tastatur- und Mausfokus.

Unter Linux ist activate() ein asynchroner Vorgang.

Das NativeWindow-Objekt löst auf allen Plattformen ein activate-Ereignis aus.

Verwandte API-Elemente

displayObject.stage.nativeWindow.activate();

windowObj.activate();

window.nativeWindow.activate();

Schließt dieses Fenster.

Ein close-Ereignis wird ausgelöst, sobald der Schließvorgang beendet wurde. Ein closing-Ereignis wird nicht ausgelöst. Wenn das Abbrechen des Schließvorgangs zulässig sein soll, lösen Sie ein closing-Ereignis aus und überprüfen Sie, ob registrierte Listener das Standardverhalten vor dem Aufruf der close-Methode abbrechen.

Wenn ein Fenster geschlossen wird, werden auch alle Fenster, deren Eigentümer es ist, geschlossen. Das untergeordnete Fenster setzt keine closing-Ereignisse ab.

Wenn auf Anzeigeobjektinstanzen, die sich aktuell im Fenster befinden, nicht anderswo verwiesen wird, werden sie vom Garbagekollektor eingesammelt und zerstört, mit Ausnahme des ursprünglichen mit AIR erstellten Anwendungsfensters. Damit Anzeigeobjekte vom Garbagekollektor aus dem ursprünglichen Fenster entfernt werden können, müssen Sie sie von der Fensterbühne entfernen.

Nach dem Schließen ist das NativeWindow-Objekt zwar immer noch ein gültiger Verweis, aber beim Zugriff auf die meisten Eigenschaften und Methoden wird ein Fehler aufgrund eines ungültigen Vorgangs ausgegeben.

Geschlossene Fenster können nicht erneut geöffnet werden. Wenn das Fenster bereits geschlossen ist, werden keine Aktionen ausgeführt und keine Ereignisse ausgelöst.

Hinweis: Um ein Fenster auszublenden, ohne es zu schließen, stellen Sie seine visible-Eigenschaft auf false ein.

Verwandte API-Elemente

windowObj.close();

displayObj.stage.nativeWindow.close();

window.close(); //overriddable in HTMLHost

window.nativeWindow.close(); //not overriddable

public function closeCommand():Boolean{
    var closeEvent:Event = new Event(Event.CLOSING,true,true);
    windowObj.dispatchEvent(closeEvent);
    if(!closeEvent.isDefaultPrevented()){
        windowObj.close();
        return true;
    } else {
      return false;
    }
}

<script src="AIRAliases.js" type="text/javascript"></script>
<script type="text/javascript">
    var dirtyData = false;
    function closeWindow(){
            var closingEvent = new air.Event(air.Event.CLOSING,true,true);
            window.nativeWindow.dispatchEvent(closingEvent);
               if(!closingEvent.isDefaultPrevented()){
                   window.nativeWindow.close();
                //or use: window.close(); 
               return true;
           } else {
               return false;
        }
    }
        
    function onClosing(event){
        if(dirtyData){
            event.preventDefault();
            //Save data...
        }
    }    

    window.nativeWindow.addEventListener(air.Event.CLOSING,onClosing);        
</script>

Konvertiert einen Punkt in Pixelkoordinaten relativ zum Ursprung der Fensterbühne (ein globaler Punkt hinsichtlich der Anzeigeliste) in einen Punkt auf dem virtuellen Desktop

Virtuelle Desktop-Koordinaten sind relativ zur oberen linken Ecke des primären Monitors.

Parameter

Verwandte API-Elemente

Gibt eine Liste der NativeWindow-Objekte an, die diesem Fenster gehören.

Sie können den Eigentümer von NativeWindows nicht ändern, indem Sie Objekte zum zurückgegebenen Vektor hinzufügen bzw. daraus entfernen. Das Eigentumsverhältnis eines Fensters kann nach dem Erstellen eines Fensters nicht mehr geändert werden.

Verwandte API-Elemente

Maximiert dieses Fenster.

Ein Aufruf der maximize()-Methode löst ein displayStateChange-Ereignis und ggf. auch ein move- und ein resize-Ereignis aus. Während das Systemchrom ein displayStateChanging-Ereignis ausgelöst wird, das abgebrochen werden kann, wenn der Benutzer einen Maximierungsbefehl initiiert, muss Ihre Maximierungslogik dieses Verhalten, falls erwünscht, erst implementieren.

Die maximize()-Methode wird asynchron ausgeführt. Durch Warten auf das displayStateChange-Ereignis kann festgestellt werden, ob die Statusänderung abgeschlossen wurde. Wenn das Fenster bereits maximiert ist, werden keine Aktionen ausgeführt und keine Ereignisse ausgelöst.

Hinweise zum Verhalten des Betriebssystems:

• Auf Betriebssystemen, unter denen die Maximierung des Fensters eine Größenänderung nicht verhindert (wie beispielsweise Mac OS X), wird das Fenster beim Aufruf von maximize() auf die volle Bildschirmgröße vergrößert, was jedoch eine anschließende Größenänderung nicht verhindert. Bei der Größenänderung eines vergrößerten Fensters wird auch der Anzeigestatus wiederhergestellt.
• Auf manchen Betriebssystemen, wie Mac OS X oder manchen Linux-Fenstermanagern, werden Fenster beim Maximieren nicht über die in der maxSize-Eigenschaft angegebenen Breite und Höhe hinaus vergrößert. Auf anderen vergrößern sich Fenster und füllen den ganzen Bildschirm aus, auch wenn er größer ist als die in maxSize angegebene Größe.
• Bei manchen Linux-Fenstermanagern können Fenster von Dienstprogrammen nicht maximiert werden.

Verwandte API-Elemente

public function maximizeWindow(nativeWin:NativeWindow):Boolean{
  if(nativeWin.displayState != NativeWindowDisplayState.MAXIMIZED){
    var beforeState:String = nativeWin.displayState;
    var afterState:String = NativeWindowDisplayState.MAXIMIZED;
    var displayStateEvent:NativeWindowDisplayStateEvent = 
        new NativeWindowDisplayStateEvent(NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGING,
                                              true,true,beforeState,afterState);
    nativeWin.dispatchEvent(displayStateEvent);
    if(!displayStateEvent.isDefaultPrevented()){
        nativeWin.maximize();
        return true;
    } else {
      return false;
    }
  }
  return false;
}

function maximizeWindow(nativeWin){
    if(nativeWin.displayState != air.NativeWindowDisplayState.MAXIMIZED){
        var beforeState = nativeWin.displayState;
        var afterState = air.NativeWindowDisplayState.MAXIMIZED;
        var displayStateEvent = 
            new air.NativeWindowDisplayStateEvent(air.NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGING,
                                              true,true,beforeState,afterState);
        nativeWin.dispatchEvent(displayStateEvent);
        if(!displayStateEvent.isDefaultPrevented()){
            nativeWin.maximize();
            return true;
        } else {
          return false;
        }
     }
     return false;
}

Minimiert dieses Fenster.

Ein Aufruf von minimize() löst ein displayStateChange-Ereignis und ggf. auch ein move- und ein resize-Ereignis aus. Während für das Systemchrom ein displayStateChanging-Ereignis ausgelöst wird, das abgebrochen werden kann, wenn der Benutzer einen Minimierungsbefehl ausgibt, ist dies beim direkten Aufruf von minimize() nicht der Fall. Dieses Verhalten kann in der Minimierungslogik implementiert werden.

Die minimize()-Methode wird asynchron ausgeführt. Durch Warten auf das displayStateChange-Ereignis, das auf allen Plattformen ausgelöst wird, kann festgestellt werden, ob die Statusänderung abgeschlossen wurde. Wenn das Fenster bereits minimiert ist, werden keine Aktionen ausgeführt und keine Ereignisse ausgelöst.

Alle Fenster, die Eigentum dieses Fensters sind, werden ausgeblendet, wenn es minimiert wird. Die untergeordneten Fenster setzen keine displayStateChanging- oder displayStateChange-Ereignisse ab.

Hinweise:

• Unter Windows wird ein unsichtbares Fenster (visible == false) durch das Minimieren sichtbar.
• Bei manchen Linux-Fenstermanagern können Fenster von Dienstprogrammen nicht minimiert werden.

Verwandte API-Elemente

public function minimizeWindow(nativeWin:NativeWindow):Boolean{
    if(nativeWin.displayState != NativeWindowDisplayState.MINIMIZED){
        var beforeState:String = nativeWin.displayState;
        var afterState:String = NativeWindowDisplayState.MINIMIZED;
        var displayStateEvent:NativeWindowDisplayStateEvent = 
            new NativeWindowDisplayStateEvent(NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGING,
                                              true,true,beforeState,afterState);
        nativeWin.dispatchEvent(displayStateEvent);
        if(!displayStateEvent.isDefaultPrevented()){
            nativeWin.minimize();
            return true;
        } else {
          return false;
        }
     }
     return false;
}

 
function minimizeWindow(){
    if(window.nativeWindow.displayState != air.NativeWindowDisplayState.MINIMIZED){
        var beforeState = window.nativeWindow.displayState;
        var afterState = air.NativeWindowDisplayState.MINIMIZED;
        var displayStateEvent = 
            new air.NativeWindowDisplayStateEvent(air.NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGING,
                                              true,true,beforeState,afterState);
        window.nativeWindow.dispatchEvent(displayStateEvent);
        if(!displayStateEvent.isDefaultPrevented()){
            window.nativeWindow.minimize();
            return true;
        } else {
          return false;
        }
     }
     return false;
}

Löst über das Betriebssystem einen visuellen Hinweis aus, der anzeigt, dass ein wichtiges Ereignis aufgetreten ist.

Wenn NativeWindow.supportsNotification auf true eingestellt ist, entspricht der visuelle Hinweis den Konventionen des nativen Betriebssystems. Unter Windows blinkt beispielsweise das Symbol in der Taskleiste.

Der type-Parameter bestimmt die Intensität des visuellen Hinweises. Konstanten für die zulässigen Werte sind in der NotificationType-Klasse definiert und können folgendermaßen lauten:

• NotificationType.INFORMATIONAL
• NotificationType.CRITICAL

Visuelle Hinweise, die nur zur Information dienen, werden nur kurz angezeigt. Dagegen werden visuelle Hinweise für kritische Benachrichtigungen so lange angezeigt, bis der Benutzer dieses Fenster aktiviert. Nicht alle Linux-Fenstermanager unterstützen zwei Benachrichtigungsebenen: Bei solchen Fenstermanagern hat notifyUser() die gleichen Auswirkungen, egal, welche Option festgelegt ist.

Hinweis: notifyUser() kann zwar aufgerufen werden, wenn NativeWindow.supportsNotification auf false eingestellt ist, hat in diesem Fall jedoch keine Wirkung.

Parameter

Stellt dieses Fenster direkt hinter das angegebene Fenster.

Weder das Fenster noch die Anwendung wird aktiviert oder erhält den Fokus. Minimierte oder ausgeblendete Fenster (visible ist false) können nicht neu angeordnet werden.

Ein Fenster, das einem anderen Fenster gehört, kann nicht hinter seinen Eigentümer verschoben werden. Wenn dieses Fenster einen Eigentümer hat, werden der Eigentümer und seine anderen untergeordneten Fenster ebenfalls hinter dem Ziel eingeordnet. Wenn das Zielfenster einen Eigentümer hat, wird dieses Fenster stattdessen hinter den Eigentümer des Fensters verschoben.

Bei manchen Linux-Fenstermanagern können Fenster von Dienstprogrammen nicht hinter normalen Fenstern angeordnet werden.

Parameter

windowBehind.orderInBackOf(windowFront);

displayObjBehind.stage.nativeWindow.orderInBackOf(displayObjectFront.stage.nativeWindow);

jsWindowObjBehind.nativeWindow.orderInBackOf(jsWindowObjFront.nativeWindow);

Stellt dieses Fenster direkt vor das angegebene Fenster.

Weder das Fenster noch die Anwendung wird aktiviert oder erhält den Fokus. Minimierte oder ausgeblendete Fenster (visible ist false) können nicht neu angeordnet werden.

Ein Fenster kann nicht in den Vordergrund eines Fensters, dessen Eigentümer es ist, verschoben werden. Wenn dieses Fenster einen Eigentümer hat, werden der Eigentümer und dessen andere untergeordnete Fenster ebenfalls im Vordergrund dies Ziels angeordnet. Wenn das Zielfenster einen Eigentümer hat, wird dieses Fenster ebenfalls im Vordergrund aller anderen Fenster, die denselben Eigentümer wie das Ziel haben, angeordnet.

Bei manchen Linux-Fenstermanagern können normale Fenster nicht vor Fenstern von Dienstprogrammen angeordnet werden.

Parameter

windowFront.orderInFrontOf(windowBehind);

displayObjFront.stage.nativeWindow.orderInFrontOf(displayObjectBehind.stage.nativeWindow);

jsWindowObjFront.nativeWindow.orderInFrontOf(jsWindowObjBehind.nativeWindow);

Stellt dieses Fenster hinter alle anderen sichtbaren Fenster in den Hintergrund.

Weder das Fenster noch die Anwendung wird aktiviert oder erhält den Fokus. Minimierte oder ausgeblendete Fenster (visible ist false) können nicht neu angeordnet werden.

Wenn alwaysInFront den Wert true hat, wird dieses Fenster beim Aufruf dieser Methode nicht hinter Fenster gestellt, für die alwaysInFront gleich false gilt.

Ein Fenster, das einem anderen Fenster gehört, kann nicht hinter seinen Eigentümer verschoben werden. Wenn dieses Fenster einen Eigentümer hat, werden der Eigentümer und dessen andere untergeordnete Fenster ebenfalls am unteren Ende der Anzeigeliste angeordnet. Dieses Fenster muss hinter alle anderen Fenster verschoben werden, die Eigentum desselben Fensters sind. Wenn dieses Fenster Eigentümer von anderen Fenstern ist, werden diese Fenster ebenfalls in ihrer aktuellen relativen Reihenfolge zueinander in den Hintergrund verschoben.

Bei manchen Linux-Fenstermanagern können Fenster von Dienstprogrammen nicht hinter normalen Fenstern angeordnet werden.

windowObj.orderToBack();

displayObj.stage.nativeWindow.orderToBack();

window.nativeWindow.orderToBack();

Stellt dieses Fenster vor alle anderen sichtbaren Fenster in den Vordergrund.

Weder das Fenster noch die Anwendung wird aktiviert oder erhält den Fokus. Minimierte oder ausgeblendete Fenster (visible ist false) können nicht neu angeordnet werden.

Wenn alwaysInFront auf false gesetzt ist, wird dieses Fenster beim Aufruf dieser Methode nicht vor Fenster gestellt, für die alwaysInFront gleich true gilt.

Ein Fenster kann nicht in den Vordergrund eines Fensters, dessen Eigentümer es ist, verschoben werden. Wenn dieses Fenster Eigentümer von anderen Fenstern ist, werden diese Fenster ebenfalls in ihrer aktuellen relativen Reihenfolge zueinander in den Vordergrund verschoben. Wenn dieses Fenster einen Eigentümer hat, werden der Eigentümer und dessen andere Fenster ebenfalls im Vordergrund des Fensters angeordnet. Dieses Fenster wird vor andere Fenster verschoben, die denselben Eigentümer haben.

Bei manchen Linux-Fenstermanagern können normale Fenster nicht vor Fenstern von Dienstprogrammen angeordnet werden.

windowObj.orderToFront();

displayObj.stage.nativeWindow.orderToFront();

window.nativeWindow.orderToFront();

Stellt dieses Fenster von einem minimierten oder maximierten Zustand wieder her.

Ein Aufruf von restore() löst ein displayStateChange-Ereignis und ggf. auch ein move- und ein resize-Ereignis aus. Während für das Systemchrom ein displayStateChanging-Ereignis ausgelöst wird, das abgebrochen werden kann, wenn der Benutzer einen Minimierungsbefehl initiiert, muss Ihre Maximierungslogik dieses Verhalten, falls erwünscht, erst implementieren.

Wenn das Fenster sich bereits im Status NativeWindowDisplayState.NORMAL befindet, werden keine Aktionen ausgeführt und keine Ereignisse ausgelöst.

Durch Warten auf das displayStateChange-Ereignis, das auf allen Plattformen ausgelöst wird, kann festgestellt werden, ob die Statusänderung abgeschlossen wurde.

Verwandte API-Elemente

public function restoreWindow(nativeWin:NativeWindow):Boolean{
    if(nativeWin.displayState != NativeWindowDisplayState.NORMAL){
        var beforeState:String = nativeWin.displayState;
        var afterState:String = NativeWindowDisplayState.NORMAL;
        var displayStateChangingEvent:NativeWindowDisplayStateEvent = 
            new NativeWindowDisplayStateEvent(NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGING,
                                              true,true,beforeState,afterState);
        nativeWin.dispatchEvent(displayStateChangingEvent);
        if(!displayStateChangingEvent.isDefaultPrevented()){
            nativeWin.restore();
            return true;
        } else {
          return false;
        }
     }
     return false;
}

function restoreWindow(nativeWin){
    if(window.nativeWindow.displayState != air.NativeWindowDisplayState.NORMAL){
        var beforeState = window.nativeWindow.displayState;
        var afterState = air.NativeWindowDisplayState.NORMAL;
        var displayStateEvent = 
            new air.NativeWindowDisplayStateEvent(air.NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGING,
                                              true,true,beforeState,afterState);
        window.nativeWindow.dispatchEvent(displayStateEvent);
        if(!displayStateEvent.isDefaultPrevented()){
            window.nativeWindow.restore();
            return true;
        } else {
          return false;
        }
     }
     return false;
}

Startet eine systemgesteuerte Verschiebung dieses Fensters.

Beim Aufruf von einem mouseDown-Ereignis startet diese Methode eine mausgesteuerte Verschiebesequenz, die bis zum Auftreten eines mouseUp-Ereignisses fortgesetzt wird.

Beim Aufruf von anderem Code startet diese Methode eine tastatur- oder mausgesteuerte Verschiebesequenz gemäß der Standardsequenz des Betriebssystems.

Bei einer Verschiebesequenz werden mehrere Ereignisse ausgelöst, während der Fensterursprung sich verschiebt. Für jeden Verschiebungsschritt wird zunächst ein moving-Ereignis ausgelöst. Wird dieses moving-Ereignis nicht abgebrochen, wird die Fensterposition aktualisiert und ein move-Ereignis ausgelöst. Wenn das moving-Ereignis abgebrochen wird, wird die Verschiebesequenz umgehend beendet.

var initOpts:NativeWindowInitOptions = new NativeWindowInitOptions();
var win:NativeWindow = new NativeWindow(initOpts);
win.activate();
win.stage.addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler);

function mouseDownHandler(event:MouseEvent):void
{
    win.startMove();
}

Startet eine systemgesteuerte Größenänderung dieses Fensters.

Beim Aufruf von einer mouseDown-Ereignisprozedur startet diese Methode eine mausgesteuerte Größenänderungssequenz, die bis zum Auftreten eines mouseUp-Ereignisses fortgesetzt wird.

Beim Aufruf von anderem Code startet diese Methode eine tastatur- oder mausgesteuerte Größenänderungssequenz gemäß der Standardsequenz des Betriebssystems.

Bei der Größenänderungssequenz werden mehrere Ereignisse ausgelöst, während die Fensterabmessungen sich ändern. Für jeden Änderungsschritt wird zunächst ein resizing-Ereignis ausgelöst. Wird dieses resizing-Ereignis nicht abgebrochen, werden die Fensterabmessungen aktualisiert und ein resize-Ereignis wird ausgelöst. Wenn das resizing-Ereignis abgebrochen wird, wird die Sequenz umgehend beendet.

Parameter

Verwandte API-Elemente

stage.addEventListener(MouseEvent.MOUSE_DOWN, onResizeCommand);

function onResizeCommand(event:MouseEvent):void
{
    var win:NativeWindow = event.target.nativeWindow;
    var resizeFrom:String = "";
    if (event.stageY < win.height * .33)
    {
        resizeFrom = NativeWindowResize.TOP;
    }
    else if (event.stageY > win.height * .66)
    {
        resizeFrom = NativeWindowResize.BOTTOM;
    }
    if (event.stageX < win.width * .33)
    {
        resizeFrom += NativeWindowResize.LEFT;
    }
    else if (event.stageX > win.width * .66)
    {
        resizeFrom += NativeWindowResize.RIGHT;
    }
    win.startResize(resizeFrom);    
}

Wird von diesem NativeWindow-Objekt ausgelöst, nachdem das Fenster aktiviert wurde.

Hinweis: Dieses Ereignis verfügt weder über eine Aufnahmephase noch über eine Bubbling-Phase. Das bedeutet, dass Ereignis-Listener potenziellen Zielen direkt hinzugefügt werden müssen, unabhängig davon, ob sich das Ziel in der Anzeigeliste befindet oder nicht.

AIR für TV setzt dieses Ereignis niemals ab. Sie können es jedoch manuell absetzen.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird von diesem NativeWindow-Objekt ausgelöst, nachdem das Fenster geschlossen wurde.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird von diesem NativeWindow-Objekt ausgelöst, unmittelbar bevor das Fenster geschlossen werden soll. Dieses Ereignis kann abgebrochen werden, um das Schließen des Fensters zu verhindern.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird von diesem NativeWindow-Objekt ausgelöst, nachdem das Fenster deaktiviert wurde.

Hinweis: Dieses Ereignis verfügt weder über eine Aufnahmephase noch über eine Bubbling-Phase. Das bedeutet, dass Ereignis-Listener potenziellen Zielen direkt hinzugefügt werden müssen, unabhängig davon, ob sich das Ziel in der Anzeigeliste befindet oder nicht.

AIR für TV setzt dieses Ereignis niemals ab. Sie können es jedoch manuell absetzen.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird von diesem NativeWindow-Objekt ausgelöst, nachdem sich die displayState-Eigenschaft des Fensters geändert hat.

Ändern Sie nicht die Größe des Fensters oder seinen Anzeigestatus in der displayStateChange-Ereignisprozedur.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird von diesem NativeWindow-Objekt ausgelöst, unmittelbar bevor sich die display-Eigenschaft des Fensters ändert. Dieses Ereignis kann abgebrochen werden, um die Änderung zu verhindern.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

function displayStateChanging_handler(displayStateEvent:NativeWindowDisplayStateEvent):void
{
  //shouldStopStateChange is an application-defined Boolean indicating 
  //that display state changes should be canceled
  if (displayStateEvent.type == NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGING 
                                  &&    shouldStopStateChange)
  {
    displayStateEvent.preventDefault();
  }
}

Wird von diesem NativeWindow-Objekt ausgelöst, nachdem das Fenster auf dem Desktop verschoben wurde.

Ein move-Ereignis wird immer ausgelöst, wenn sich der Ursprung (x- oder y-Eigenschaft) des Fensters ändert. Verursacht werden kann dies durch eine systemgesteuerte Fensterverschiebung, durch Minimieren, Maximieren oder Wiederherstellen des Fensters oder durch die Änderung der Fensterposition durch Setzen der x-, y- oder bounds-Eigenschaft.

Hinweis: Vermeiden Sie Aktionen, die möglicherweise gleichzeitig Betriebssystem-Dialogfelder in den Prozedurfunktionen für die beiden Ereignisse moving und move eines NativeWindow-Objekts öffnen. Dies kann beispielsweise auftreten, wenn beide Prozedurfunktionen einen Fehler ausgeben. Wenn das passiert, reagiert das zweite geöffnete Dialogfeld nicht auf Mausklicks und muss mithilfe der Tastatur geschlossen werden.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird von diesem NativeWindow-Objekt ausgelöst, unmittelbar bevor das Fenster auf dem Desktop verschoben werden soll. Dieses Ereignis kann abgebrochen werden, um die Verschiebung zu verhindern oder zu ändern.

Hinweis: Vermeiden Sie Aktionen, die möglicherweise gleichzeitig Betriebssystem-Dialogfelder in den Prozedurfunktionen für die beiden Ereignisse moving und move eines NativeWindow-Objekts öffnen. Dies kann beispielsweise auftreten, wenn beide Prozedurfunktionen einen Fehler ausgeben. Wenn das passiert, reagiert das zweite geöffnete Dialogfeld nicht auf Mausklicks und muss mithilfe der Tastatur geschlossen werden.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Hinweis: Unter Linux wird die preventDefault()-methode für dieses Ereignis nicht unterstützt.

Wird von diesem NativeWindow-Objekt ausgelöst, nachdem die Größe des Fensters geändert wurde. Ein resize-Ereignis wird immer ausgelöst, wenn sich die Größe (width- oder height-Eigenschaft) ändert. Verursacht werden kann dies durch eine systemgesteuerte Größenänderung des Fensters, durch Minimieren, Maximieren oder Wiederherstellen des Fensters oder die Änderung der Fenstergröße durch das Setzen der width-, height- oder bounds-Eigenschaft. resize-Ereignisse für NativeWindow werden während systemgesteuerter resize-Schleifen ausgelöst. Im Gegensatz dazu werden resize-Ereignisse für Stage-Objekte ausgelöst, wenn die Bühne für das Zeichnen bereit ist.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird von diesem NativeWindow-Objekt ausgelöst, unmittelbar bevor die Größe des Fensters auf dem Desktop geändert werden soll. Dieses Ereignis kann abgebrochen werden, um die Größenänderung zu verhindern oder zu ändern.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Hinweis: Unter Linux wird die preventDefault()-methode für dieses Ereignis nicht unterstützt.

function boundsChanging_handler(boundsEvent:NativeWindowBoundsEvent):void
{
  //shouldStopResize is an application-defined Boolean indicating 
  //that resize operations should be canceled
  if (boundsEvent.type == NativeWindowBoundsEvent.RESIZING && shouldStopResize)
  {
    boundsEvent.preventDefault();
  }
}