NativeWindowInitOptions

Paket	flash.display
Klasse	public class NativeWindowInitOptions
Vererbung	NativeWindowInitOptions Object

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Die NativeWindowInitOptions-Klasse definiert die Initialisierungsoptionen, die für die Erstellung einer neuen NativeWindow-Instanz verwendet werden.

Die in den Initialisierungsoptionen definierten Eigenschaften können nach der Erstellung eines Fensters nicht mehr geändert werden.

Hinweis: Für das von AIR automatisch erstellte erste Anwendungsfenster sind alle diese Eigenschaften (mit Ausnahme von type) im Anwendungsdeskriptor festgelegt. Das ursprüngliche Fenster hat immer den Typ NativeWindowType.NORMAL.

Verwandte API-Elemente

flash.display.NativeWindow
flash.display.NativeWindowType
flash.display.NativeWindowSystemChrome

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		maximizable : Boolean Legt fest, ob ein Fenster durch den Benutzer maximiert werden kann.	NativeWindowInitOptions
		minimizable : Boolean Legt fest, ob ein Fenster durch den Benutzer minimiert werden kann.	NativeWindowInitOptions
		owner : NativeWindow Gibt das NativeWindow-Objekt an, das Eigentümer aller mit diesen NativeWindowInitOptions erstellten Fenster ist.	NativeWindowInitOptions
		renderMode : String Gibt den Rendermodus des NativeWindow-Objekts an, das mit diesen NativeWindowInitOptions erstellt wurde.	NativeWindowInitOptions
		resizable : Boolean Legt fest, ob die Fenstergröße durch den Benutzer geändert werden kann.	NativeWindowInitOptions
		systemChrome : String Legt fest, ob Systemchrom für das Fenster zur Verfügung steht.	NativeWindowInitOptions
		transparent : Boolean Gibt an, ob das Fenster Transparenz und Alpha-Blending zum Desktop unterstützt.	NativeWindowInitOptions
		type : String Gibt den Typ des zu erstellenden Fensters an.	NativeWindowInitOptions

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		NativeWindowInitOptions() Erstellt ein neues NativeWindowInitOptions-Objekt.	NativeWindowInitOptions
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object

Eigenschaftendetails

maximizable

Eigenschaft

maximizable:Boolean

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Legt fest, ob ein Fenster durch den Benutzer maximiert werden kann.

Bei Fenstern mit Systemchrom beeinflusst diese Einstellung die Darstellung der Maximierungsschaltfläche des Fensters. Sie beeinflusst zudem andere Teile der systemverwalteten Benutzeroberfläche, wie das Fenster-Menü unter Microsoft Windows.

Wenn diese Eigenschaft auf false gesetzt ist, kann das Fenster durch den Benutzer nicht maximiert werden. Durch das Aufrufen der maximize()-Methode von NativeWindow wird das Fenster unmittelbar maximiert.

Hinweise zum Verhalten des Betriebssystems:

Unter Betriebssystemen wie Mac OS X, bei denen eine Maximierung des Fensters die Größenänderung nicht verhindert, müssen sowohl maximizable als auch resizable auf false eingestellt werden, um zu verhindern, dass die Fenstergröße geändert wird.
Einige Linux-Fenstermanager lassen das Maximieren von Fenstern durch den Benutzer zu, selbst wenn die maximizable-Eigenschaft den Wert false aufweist.

Der Standardwert ist true.

Implementierung
public function get maximizable():Boolean
public function set maximizable(value:Boolean):void

Verwandte API-Elemente

flash.display.NativeWindow.displayState

minimizable

Eigenschaft

minimizable:Boolean

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Legt fest, ob ein Fenster durch den Benutzer minimiert werden kann.

Bei Fenstern mit Systemchrom beeinflusst diese Einstellung die Darstellung der Minimierungsschaltfläche des Fensters. Sie beeinflusst zudem andere Teile der systemverwalteten Benutzeroberfläche, wie das Fenster-Menü unter Microsoft Windows.

Wenn diese Eigenschaft auf false gesetzt ist, kann das Fenster durch den Benutzer nicht minimiert werden. Durch das Aufrufen der minimize()-Methode von NativeWindow wird das Fenster unmittelbar minimiert.

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

Der Standardwert ist true.

Implementierung
public function get minimizable():Boolean
public function set minimizable(value:Boolean):void

Verwandte API-Elemente

flash.display.NativeWindow.displayState

owner

Eigenschaft

owner:NativeWindow

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 2.6

Gibt das NativeWindow-Objekt an, das Eigentümer aller mit diesen NativeWindowInitOptions erstellten Fenster ist.

Wenn ein Fenster einen Eigentümer hat, wird dieses Fenster immer vor seinem Eigentümer angezeigt und wird zusammen mit seinem Eigentümer minimiert, ausgeblendet und geschlossen.

Der Standardwert ist null.

Implementierung
public function get owner():NativeWindow
public function set owner(value:NativeWindow):void

Verwandte API-Elemente

flash.display.NativeWindow.owner
flash.display.NativeWindow.listOwnedWindows()

renderMode

Eigenschaft

renderMode:String

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 3.0

Gibt den Rendermodus des NativeWindow-Objekts an, das mit diesen NativeWindowInitOptions erstellt wurde.

Konstanten für die gültigen Werte dieser Eigenschaft sind in der NativeWindowRenderMode-Klasse definiert

Wenn kein Wert angegeben wird, hat renderMode den Standardwert NativeWindowRenderMode.AUTO.

Der Standardwert ist NativeWindowRenderMode.AUTO.

Implementierung
public function get renderMode():String
public function set renderMode(value:String):void

Verwandte API-Elemente

flash.display.NativeWindowRenderMode

resizable

Eigenschaft

resizable:Boolean

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Legt fest, ob die Fenstergröße durch den Benutzer geändert werden kann.

Wenn diese Eigenschaft auf false gesetzt ist, kann die Fenstergröße durch einen Benutzer, der Systemchrom verwendet, nicht geändert werden. Durch Aufrufen der startResize()-Methode von NativeWindow als Antwort auf ein Mausereignis kann der Benutzer die Größe des Fensters ändern. Die Fenstergröße kann auch durch das direkte Setzen der Fenstergrenzen geändert werden.

Hinweise zum Verhalten des Betriebssystems:

Unter Betriebssystemen wie Mac OS X, bei denen die Fenstermaximierung eine Größenänderungsoperation ist, müssen sowohl maximizable als auch resizable auf false eingestellt werden, um zu verhindern, dass die Fenstergröße geändert wird.
Einige Linux-Fenstermanager lassen das Ändern der Fenstergröße durch den Benutzer zu, selbst wenn die resizable-Eigenschaft den Wert false aufweist.

Der Standardwert ist true.

Implementierung
public function get resizable():Boolean
public function set resizable(value:Boolean):void

Verwandte API-Elemente

flash.display.NativeWindow.bounds

systemChrome

Eigenschaft

systemChrome:String

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Legt fest, ob Systemchrom für das Fenster zur Verfügung steht.

Chrom bezieht sich auf die Fenstersteuerungen, über die der Benutzer die Desktop-Eigenschaften eines Fensters steuern kann. Das Systemchrom verwendet die Standardsteuerungen der Desktop-Umgebung, in der die AIR-Anwendung ausgeführt wird, und entspricht der standardmäßigen Gestaltung des nativen Betriebssystems.

Um von einem Framework (wie Flex) bereitgestelltes Chrom zu verwenden oder um eigenes Fensterchrom anzugeben, stellen Sie systemChrome auf NativeWindowSystemChrome.NONE ein.

Konstanten für die gültigen Werte dieser Eigenschaft sind in der NativeWindowSystemChrome-Klasse definiert:

NativeWindowSystemChrome.NONE
NativeWindowSystemChrome.STANDARD

Wird keine Angabe gemacht, gilt für systemChrome der Standardwert NativeWindowSystemChrome.STANDARD.

Bei Fenstern mit Systemchrom kann die transparent-Eigenschaft nicht auf true gesetzt werden.

Der Standardwert ist NativeWindowSystemChrome.STANDARD.

Implementierung
public function get systemChrome():String
public function set systemChrome(value:String):void

Verwandte API-Elemente

flash.display.NativeWindowSystemChrome

transparent

Eigenschaft

transparent:Boolean

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Gibt an, ob das Fenster Transparenz und Alpha-Blending zum Desktop unterstützt.

Bei der Einstellung true wird die Fensteranzeige vor dem Desktop zusammengesetzt. Fensterbereiche, die nicht von einem Anzeigeobjekt bedeckt werden oder die von einem Anzeigeobjekt mit einer Alpha-Einstellung von fast Null bedeckt werden, sind praktisch unsichtbar und erfassen keine Mausereignisse (die Mausereignisse werden von dem Desktop-Objekt unter dem Fenster empfangen). Der Alpha-Wert, bei dem ein Objekt keine Mausereignisse mehr erfasst, liegt je nach Betriebssystem zwischen ca. 0,06 und 0,01.

Bei Fenstern mit Systemchrom kann die transparent-Eigenschaft nicht auf true gesetzt werden.

Hinweis: Nicht alle Linux-Fenstermanager unterstützen Transparenz. Auf diesen Systemen werden transparente Bereiche eines Fensters mit Schwarz erstellt.

Der Standardwert ist false.

Implementierung
public function get transparent():Boolean
public function set transparent(value:Boolean):void

type

Eigenschaft

type:String

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Gibt den Typ des zu erstellenden Fensters an.

Konstanten für die gültigen Werte dieser Eigenschaft sind in der NativeWindowType-Klasse definiert:

NativeWindowType.NORMAL: Ein typisches Fenster. Normale Fenster verwenden das Fensterdesign in voller Größe und erscheinen in der Taskleiste von Windows oder Linux.
NativeWindowType.UTILITY: Eine Werkzeugpalette. Dienstprogrammfenster verwenden eine schmalere Version des System-Fensterdesigns und werden nicht in der Windows-Taskleiste angezeigt.
NativeWindowType.LIGHTWEIGHT – Lightweight-Fenster können kein System-Fensterdesign haben und erscheinen nicht in der Taskleiste von Windows oder Linux. Zudem verfügen Lightweight-Fenster nicht über das System-Menü (Alt+Leertaste) unter Windows. Lightweight-Fenster eignen sich für Benachrichtigungen und Steuerungen wie Kombinationsfelder, die einen Anzeigebereich öffnen, der nur für einen kurzen Zeitraum eingeblendet wird. Bei Verwendung des Lightweight-Typs muss systemChrome auf NativeWindowSystemChrome.NONE eingestellt werden.

Wenn kein Wert angegeben wird, hat type den Standardwert NativeWindowType.NORMAL.

Der Standardwert ist NativeWindowType.NORMAL.

Implementierung
public function get type():String
public function set type(value:String):void

Verwandte API-Elemente

flash.display.NativeWindowType

Konstruktordetails

()

Konstruktor

public function NativeWindowInitOptions()

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Erstellt ein neues NativeWindowInitOptions-Objekt.

Die Standardwerte des neu erstellten Objekts lauten:

systemChrome = NativeWindowSystemChrome.STANDARD
type = NativeWindowType.NORMAL
transparent = false
owner = null
resizable = true
maximizable = true
minimizable = true

Rechtliche Hinweise | Onlinedatenschutzerklärung

NativeWindowInitOptions - AS3

Klassen x

maximizable

minimizable

owner

renderMode

resizable

systemChrome

transparent

type

NativeWindowInitOptions