ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Working with AIR native windows
When you create a window with the Flex mx:Window class, specify the initialization properties on the window object
itself, either in the MXML declaration for the window, or in the code that creates the window. The underlying
NativeWindow object is not created until you call the open() method. Once a window is opened, these initialization
properties cannot be changed.
Creating the initial application window
Adobe AIR 1.0 and later
AIR creates the initial application window based on the properties specified in the application descriptor and loads the
file referenced in the content element. The content element must reference a SWF file or an HTML file.
The initial window can be the main window of your application or it can merely serve to launch one or more other
windows. You do not have to make it visible at all.
Creating the initial window with ActionScript
Adobe AIR 1.0 and later
When you create an AIR application using ActionScript, the main class of your application must extend the Sprite class
(or a subclass of Sprite). This class serves as the main entry point for the application.
When your application launches, AIR creates a window, creates an instance of the main class, and adds the instance to
the window stage. To access the window, you can listen for the addedToStage event and then use the nativeWindow
property of the Stage object to get a reference to the NativeWindow object.
The following example illustrates the basic skeleton for the main class of an AIR application built with ActionScript:
}
package {
import flash.display.NativeWindow;
import flash.display.Sprite;
import flash.events.Event;
public class MainClass extends Sprite
{
private var mainWindow:NativeWindow;
public function MainClass(){
this.addEventListener(Event.ADDED_TO_STAGE, initialize);
}
}
private function initialize(event:Event):void{
mainWindow = this.stage.nativeWindow;
//perform initialization...
mainWindow.activate(); //show the window
}
Note: Technically, you CAN access the nativeWindow property in the constructor function of the main class. However,
this is a special case applying only to the initial application window.
When creating an application in Flash Professional, the main document class is created automatically if you do not
create your own in a separate ActionScript file. You can access the NativeWindow object for the initial window using
the stage nativeWindow property. For example, the following code activates the main window in the maximized state
(from the timeline):
Last updated 6/6/2012
898