Window 是 AIR 桌面应用程序中其它窗口的顶级容器。
Window 容器无法在其他布局容器中使用,在这个意义上来说,它是一种特殊容器。spark.components.Window 组件必须是其 MXML 文档中的顶级组件。
使用 Window 组件定义本机窗口的最简便方法是创建一个 MXML 文档,并在该文档中使用 <s:Window> 标签作为顶级标签。您可以按照使用其他任何容器的方式来使用 Window 组件,包括指定布局类型、定义子控件等等。与其他所有自定义 MXML 组件类似,编译应用程序的同时也会将 MXML 文档编译到作为 Window 组件子类的自定义类中。
在应用程序代码中,要在屏幕上显示 Window 子类的实例,请首先在代码中创建类的实例(通过定义变量并调用 new MyWindowClass() 构造函数)。接下来,设置您希望为新窗口指定的所有属性。最后,调用 Window 组件的 open() 方法,从而在屏幕上打开该窗口。
请注意,Window 类的部分属性仅可以在调用
open() 方法打开该窗口之前设置。创建基础 NativeWindow 后,可以读取这些初始化属性,但无法对其进行更改。此限制适用于下列属性:
-
maximizable -
minimizable -
resizable -
systemChrome -
transparent -
type
隐藏 MXML 语法
The <s:Window> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:Window
Properties
alwaysInFront="false"
colorCorrection="default"
maximizable="true"
menu="null"
minimizable="true"
resizable="true"
showStatusBar="true"
status=""
systemChrome="standard"
title=""
titleIcon="null"
transparent="false"
type="normal"
Styles
backgroundAlpha="1.0"
backgroundColor="0xFFFFFF"
resizeAffordanceWidth="6"
Effects
closeEffect="No default"
minimizeEffect="No default"
unminimizeEffect="No default"
Events
applicationActivate="No default"
applicationDeactivate="No default"
close="No default"
closing="No default"
displayStateChange="No default"
displayStateChanging="No default"
moving="No default"
networkChange="No default"
resizing="No default"
windowActivate="No default"
windowComplete="No default"
windowDeactivate="No default"
windowMove="No default"
windowResize="No default"
/>
mxmlContentFactory
样式为常见样式,或与特定主题关联。如果为常见样式,则可以用于任何主题。如果样式与特定主题关联,则只有应用程序使用该主题时才能使用该样式。
语言版本: ActionScript 3.0
产品版本: Flex 4
运行时版本: Flash10, AIR 1.5
由 backgroundColor 属性定义的颜色的 Alpha 级别。
默认值为 1.0。
语言版本: ActionScript 3.0
产品版本: Flex 4
运行时版本: Flash10, AIR 1.5
应用程序的背景色。将此颜色用作应用程序的舞台颜色和 HTML 嵌入标签的背景色。
默认值为 0xFFFFFF。
语言版本: ActionScript 3.0
产品版本: Flex 4
运行时版本: Flash10, AIR 1.5
指定该元素的哪条基线对齐到 alignmentBaseline 以确定元素在该行上的垂直位置.
语言版本: ActionScript 3.0
产品版本: Flex 4
运行时版本: Flash10, AIR 1.5
指定当列表相应侧的内边距值为 auto 时,列表开始边缘的自动缩进.
语言版本: ActionScript 3.0
产品版本: Flex 4
运行时版本: Flash10, AIR 1.5
提供窗口边框周围的误差范围,以便更易于调整大小。如果是在距离窗口的外部边缘 resizeAffordance 像素的位置进行单击,则可以将在窗口上的单击视为在窗口边框上的单击。
默认值为 6。
alwaysInFront:Boolean
确定基础 NativeWindow 是否始终显示在其他窗口的前方(包括其他应用程序的窗口)。设置此属性的同时也就设置了基础 NativeWindow 的 alwaysInFront 属性。有关此项设置如何影响窗口堆叠顺序的详细信息,请参阅 NativeWindow.alwaysInFront 属性说明。
public function get alwaysInFront():Boolean public function set alwaysInFront(value:Boolean):void
closed:Boolean [只读]
一个标志,用于指示窗口是否已关闭。
public function get closed():Boolean
colorCorrection:String
舞台的 colorCorrection 属性的值。如果此应用程序无权访问舞台的 colorCorrection 属性,则会将 colorCorrection 属性的值报告为 null。仅允许主应用程序设置 colorCorrection 属性。如果子应用程序需要设置 color correction 属性,则它将需要通过主应用程序的实例进行设置,可以直接使用对象实例,或通过某个事件(不存在用于此目的的框架事件)。
默认值为 ColorCorrection.DEFAULT。
public function get colorCorrection():String public function set colorCorrection(value:String):void
maximizable:Boolean
指定窗口是否可最大化。此属性的值在窗口打开后是只读的。
public function get maximizable():Boolean public function set maximizable(value:Boolean):void
menu:FlexNativeMenu
此窗口的窗口菜单。某些操作系统不支持窗口菜单,此时将忽略此属性。
public function get menu():FlexNativeMenu public function set menu(value:FlexNativeMenu):void
minimizable:Boolean
指定窗口是否可最小化。此属性在窗口打开后是只读的。
public function get minimizable():Boolean public function set minimizable(value:Boolean):void
nativeWindow:NativeWindow [只读]
此 Window 组件使用的基础 NativeWindow。
public function get nativeWindow():NativeWindow
renderMode:String
指定 NativeWindow 对象的呈示模式。此属性的有效值常量是由 NativeWindowRenderMode 类定义的。如果未指定,则 renderMode 的默认值为 NativeWindowRenderMode.AUTO。
此属性在窗口打开后是只读的。
public function get renderMode():String public function set renderMode(value:String):void
resizable:Boolean
指定窗口是否可调整大小。此属性在窗口打开后是只读的。
public function get resizable():Boolean public function set resizable(value:Boolean):void
showStatusBar:Boolean
如果为 true,则状态栏可见。
只有将 WindowedApplicationSkin 类或 SparkChromeWindowedApplicationSkin 类用作应用程序或任何应用程序窗口的外观时,才会显示状态栏。
默认值为 true。
public function get showStatusBar():Boolean public function set showStatusBar(value:Boolean):void
status:String
如果可见,为显示在状态栏中的字符串。
默认值为 ""。
此属性可用作数据绑定的源。修改此属性后,将调度 statusChanged 事件。
public function get status():String public function set status(value:String):void
systemChrome:String
指定窗口具有的系统镶边类型(如果有)。可能值集由 NativeWindowSystemChrome 类中的常量定义。
打开窗口后,此属性将立即变为只读模式。
默认值为 NativeWindowSystemChrome.STANDARD。
public function get systemChrome():String public function set systemChrome(value:String):void
title:String
窗口标题栏和任务栏中显示的标题文本。
默认值为 ""。
此属性可用作数据绑定的源。修改此属性后,将调度 titleChanged 事件。
public function get title():String public function set title(value:String):void
titleIcon:Class
用于绘制标题栏图标的 Class(通常是图像)。
默认值为 null。
此属性可用作数据绑定的源。修改此属性后,将调度 titleIconChanged 事件。
public function get titleIcon():Class public function set titleIcon(value:Class):void
transparent:Boolean
指定窗口是否透明。对于使用系统镶边的窗口,不支持将此属性设置为 true。
此属性在窗口打开后是只读的。
public function get transparent():Boolean public function set transparent(value:Boolean):void
type:String
指定此组件代表的 NativeWindow 类型。可能值集由 NativeWindowType 类中的常量定义。
打开窗口后,此属性将立即变为只读模式。
默认值为 NativeWindowType.NORMAL。
public function get type():String public function set type(value:String):void
public function activate():void
激活基础 NativeWindow(即使此 Window 的应用程序当前未处于活动状态)。
public static function getWindow(component:UIComponent):IWindow
返回将某个组件编为其子级的 Window。
:UIComponent — 希望查找其 Window 的组件。
IWindow — IWindow 对象。
public function maximize():void
最大化窗口;如果窗口已经最大化,则不执行任何操作。
public function open(openWindowActive:Boolean = true):void
创建基础 NativeWindow 并将其打开。关闭后,Window 对象仍为一个有效的引用,但是不允许访问大多数的属性和方法。关闭的窗口无法重新打开。
:Boolean (default = true) — 指定打开的 Window 是否已激活(即它是否具有焦点)。默认值为 true。
public function orderInBackOf(window:IWindow):Boolean
将窗口排序到另一个窗口的正后方。要将窗口排序到不实现 IWindow 的 NativeWindow 之后,请使用此窗口的 nativeWindow 的 orderInBackOf() 方法。
:IWindow — 此窗口将排序到其后方的 IWindow(Window 或 WindowedAplication)。
Boolean — 如果窗口成功排序到另一个窗口的后方,则为 true;如果窗口不可见或处于最小化状态,则为 false。
public function orderInFrontOf(window:IWindow):Boolean
将窗口排序到另一个窗口的正前方。要将该窗口排序到不实现 IWindow 的 NativeWindow 之前,请使用此窗口的 nativeWindow 的 orderInFrontOf() 方法。
:IWindow — 此窗口将排序到其前方的 IWindow(Window 或 WindowedAplication)。
Boolean — 如果窗口成功排序到另一个窗口的前方,则为 true;如果该窗口不可见或处于最小化状态,则为 false。
public function orderToBack():Boolean
将窗口排序到同一应用程序中的其它所有窗口的后方。
Boolean — 如果窗口成功排序到其它所有窗口的后方,则为 true;如果该窗口不可见或处于最小化状态,则为 false。
public function orderToFront():Boolean
将窗口排序到同一应用程序中的其它所有窗口的前方。
Boolean — 如果窗口成功排序到其它所有窗口的前方,则为 true;如果该窗口不可见或处于最小化状态,则为 false。
public function restore():void
还原窗口(如果窗口处于最大化状态,则取消最大化;如果处于最小化状态,则取消最小化)。
protected function setupWindowInitOptions():NativeWindowInitOptions
创建并填充用于创建内部 nativeWindow 的 NativeWindowInitOptions。
NativeWindowInitOptionsmx.events.AIREventmx.events.AIREvent.APPLICATION_ACTIVATE
当激活此应用程序时调度。
AIREvent.APPLICATION_ACTIVATE 常量可为 applicationActivate 事件定义事件对象的 type 属性的值。
事件对象的属性有下列值:
bubblescancelablecurrentTargetmyButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 filetargetcurrentTarget 属性始终可以访问侦听事件的 Object。typemx.events.AIREventmx.events.AIREvent.APPLICATION_DEACTIVATE
当取消激活此应用程序时调度。
AIREvent.APPLICATION_DEACTIVATE 常量可为 applicationDeactivate 事件定义事件对象的 type 属性的值。
事件对象的属性有下列值:
bubblescancelablecurrentTargetmyButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 filetargetcurrentTarget 属性始终可以访问侦听事件的 Object。typeflash.events.Eventflash.events.Event.CLOSE
在窗口关闭之后调度。
Event.CLOSE 常量定义 close 事件对象的 type 属性的值。
此事件具有以下属性:
bubblesfalsecancelablefalse;没有要取消的默认行为。currentTargettargetflash.events.Eventflash.events.Event.CLOSING
在窗口关闭之前调度。此事件是可取消的。
Event.CLOSING 常量定义 closing 事件对象的 type 属性值。
此事件具有以下属性:
bubblesfalsecancelabletrue;取消此事件对象将停止关闭操作。currentTargettargetflash.events.NativeWindowDisplayStateEventflash.events.NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGE
在显示状态更改为最小化、最大化或还原状态之后调度。
定义 displayStateChange 事件对象的 type 属性的值。
此事件具有以下属性:
afterDisplayStatebeforeDisplayStatetargetbubblescurrentTargetcancelablefalse;没有要取消的默认行为。flash.events.NativeWindowDisplayStateEventflash.events.NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGING
在显示状态更改为最小化、最大化或还原状态之前调度。
定义 displayStateChanging 事件对象的 type 属性的值。
此事件具有以下属性:
afterDisplayStatebeforeDisplayStatetargetbubblescurrentTargetcancelabletrue;取消该事件会阻止更改。flash.events.NativeWindowBoundsEventflash.events.NativeWindowBoundsEvent.MOVING
在移动窗口前和拖动窗口时调度。
定义 moving 事件对象的 type 属性值。
此事件具有以下属性:
afterBoundsbeforeBoundsbubblescancelabletrue;取消该事件会阻止窗口移动。currentTargettarget注意:在 Linux 上,此事件不支持 preventDefault() 方法。
flash.events.Eventflash.events.Event.NETWORK_CHANGE
当计算机连接到网络或与网络断开连接时调度。
Event.NETWORK_CHANGE 常量定义 networkChange 事件对象的 type 属性值。
此事件具有以下属性:
bubblesfalsecancelablefalse;没有要取消的默认行为。currentTargettargetflash.events.NativeWindowBoundsEventflash.events.NativeWindowBoundsEvent.RESIZING
在调整基础 NativeWindow 的大小之前或拖动 Window 对象边界时调度。
定义 resizing 事件对象的 type 属性值。
此事件具有以下属性:
afterBoundsbeforeBoundstargetbubblescurrentTargetcancelabletrue;取消该事件会阻止窗口移动。注意:在 Linux 上,此事件不支持 preventDefault() 方法。
mx.events.AIREventmx.events.AIREvent.WINDOW_ACTIVATE
在激活窗口之后调度。
AIREvent.WINDOW_ACTIVATE 常量可为 windowActivate 事件定义事件对象的 type 属性的值。
事件对象的属性有下列值:
bubblescancelablecurrentTargetmyButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 filetargetcurrentTarget 属性始终可以访问侦听事件的 Object。typemx.events.AIREventmx.events.AIREvent.WINDOW_COMPLETE
当 Window 完成其初始布局并打开基础 NativeWindow 时调度。
AIREvent.WINDOW_COMPLETE 常量可为 windowComplete 事件定义事件对象的 type 属性的值。
事件对象的属性有下列值:
bubblescancelablecurrentTargetmyButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 filetargetcurrentTarget 属性始终可以访问侦听事件的 Object。typemx.events.AIREventmx.events.AIREvent.WINDOW_DEACTIVATE
在取消激活窗口之后调度。
AIREvent.WINDOW_DEACTIVATE 常量可为 windowDeactivate 事件定义事件对象的 type 属性的值。
事件对象的属性有下列值:
bubblescancelablecurrentTargetmyButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 filetargetcurrentTarget 属性始终可以访问侦听事件的 Object。typemx.events.FlexNativeWindowBoundsEventmx.events.FlexNativeWindowBoundsEvent.WINDOW_MOVE
在移动窗口后调度。
FlexNativeWindowBoundsEvent.WINDOW_MOVE 常量可为 windowMove 事件定义事件对象的 type 属性的值。
事件对象的属性有下列值:
afterBoundsbeforeBoundsbubblescancelablecurrentTargetmyButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 filetargetcurrentTarget 属性始终可以访问侦听事件的 Object。typemx.events.FlexNativeWindowBoundsEventmx.events.FlexNativeWindowBoundsEvent.WINDOW_RESIZE
在调整基础 NativeWindow 的大小后调度。
FlexNativeWindowBoundsEvent.WINDOW_RESIZE 常量可为 windowResize 事件定义事件对象的 type 属性的值。
事件对象的属性有下列值:
afterBoundsbeforeBoundsbubblescancelablecurrentTargetmyButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 filetargetcurrentTarget 属性始终可以访问侦听事件的 Object。type
显示 MXML 语法








