ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Working with AIR native windows
public function onCloseCommand(event:MouseEvent):void{
var closingEvent:Event = new Event(Event.CLOSING,true,true);
dispatchEvent(closing);
if(!closingEvent.isDefaultPrevented()){
win.close();
}
}
The dispatchEvent() method returns false if the event preventDefault() method is called by a listener.
However, it can also return false for other reasons, so it is better to explicitly use the isDefaultPrevented()
method to test whether the change should be canceled.
Maximizing, minimizing, and restoring a window
Adobe AIR 1.0 and later
To maximize the window, use the NativeWindow maximize() method.
myWindow.maximize();
To minimize the window, use the NativeWindow minimize() method.
myWindow.minimize();
To restore the window (that is, return it to the size that it was before it was either minimized or maximized), use the
NativeWindow restore() method.
myWindow.restore();
A window that has an owner is minimized and restored when the owning window is minimized or restored. No events
are dispatched by the owned window when it is minimized because its owner is minimized.
Note: The behavior that results from maximizing an AIR window is different from the Mac OS X standard behavior.
Rather than toggling between an application-defined “standard” size and the last size set by the user, AIR windows toggle
between the size last set by the application or user and the full usable area of the screen.
On the Linux operating system, different window managers enforce different rules regarding setting the window
display state:
On some window managers, utility windows cannot be maximized.
If a maximum size is set for the window, then some windows do not allow a window to be maximized. Some other
window managers set the display state to maximized, but do not resize the window. In either of these cases, no
display state change event is dispatched.
Some window managers do not honor the window maximizable or minimizable settings.
Note: On Linux, window properties are changed asynchronously. If you change the display state in one line of your
program, and read the value in the next, the value read will still reflect the old setting. On all platforms, the
NativeWindow object dispatches the displayStateChange event when the display state changes. If you need to take
some action based on the new state of the window, always do so in a displayStateChange event handler. See “Listening
for window events” on page 914.
Last updated 6/6/2012
909