Package | flash.desktop |
Class | public final class NativeApplication |
Inheritance | NativeApplication EventDispatcher Object |
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
The NativeApplication class provides application information, application-wide functions, and dispatches application-level events.
The NativeApplication object is a singleton object, created automatically at startup.
Get the NativeApplication instance of an application with the static property
NativeApplication.nativeApplication
.
Property | Defined By | ||
---|---|---|---|
activeWindow : NativeWindow [read-only]
The active application window. | NativeApplication | ||
applicationDescriptor : XML [read-only]
The contents of the application descriptor file for this AIR application. | NativeApplication | ||
applicationID : String [read-only]
The application ID of this application. | NativeApplication | ||
autoExit : Boolean
Specifies whether the application should automatically terminate when
all windows have been closed. | NativeApplication | ||
constructor : Object
A reference to the class object or constructor function for a given object instance. | Object | ||
icon : InteractiveIcon [read-only]
The application icon. | NativeApplication | ||
idleThreshold : int
The number of seconds that must elapse without keyboard or mouse input
before a userIdle event is dispatched. | NativeApplication | ||
menu : NativeMenu
The application menu. | NativeApplication | ||
nativeApplication : NativeApplication [static] [read-only]
The singleton instance of the NativeApplication object. | NativeApplication | ||
openedWindows : Array [read-only]
An array containing all the open native windows of this application. | NativeApplication | ||
prototype : Object [static]
A reference to the prototype object of a class or function object. | Object | ||
publisherID : String [read-only]
The publisher ID of this application. | NativeApplication | ||
runtimePatchLevel : uint [read-only]
The patch level of the runtime hosting this application. | NativeApplication | ||
runtimeVersion : String [read-only]
The version number of the runtime hosting this application. | NativeApplication | ||
startAtLogin : Boolean
Specifies whether this application is automatically launched whenever the
current user logs in. | NativeApplication | ||
supportsDockIcon : Boolean [static] [read-only]
Indicates whether AIR supports application dock icons on the current operating system. | NativeApplication | ||
supportsMenu : Boolean [static] [read-only]
Specifies whether the current operating system supports a global application menu bar. | NativeApplication | ||
supportsSystemTrayIcon : Boolean [static] [read-only]
Specifies whether AIR supports system tray icons on the current operating system. | NativeApplication | ||
timeSinceLastUserInput : int [read-only]
The time, in seconds, since the last mouse or keyboard input. | NativeApplication |
Method | Defined By | ||
---|---|---|---|
Activates this application. | NativeApplication | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [override]
Registers an event listener object with an EventDispatcher object so that the listener
receives notification of an event. | NativeApplication | ||
Invokes an internal delete command on the focused display object. | NativeApplication | ||
Invokes an internal copy command on the focused display object. | NativeApplication | ||
Invokes an internal cut command on the focused display object. | NativeApplication | ||
[override]
Dispatches an event into the event flow. | NativeApplication | ||
Terminates this application. | NativeApplication | ||
Gets the default application for opening files with the specified extension. | NativeApplication | ||
Checks whether the EventDispatcher object has any listeners registered for a specific type
of event. | EventDispatcher | ||
Indicates whether an object has a specified property defined. | Object | ||
Indicates whether an instance of the Object class is in the prototype chain of the object specified
as the parameter. | Object | ||
Specifies whether this application is currently the default application
for opening files with the specified extension. | NativeApplication | ||
Invokes an internal paste command on the focused display object. | NativeApplication | ||
Indicates whether the specified property exists and is enumerable. | Object | ||
Removes this application as the default for opening files with the specified extension. | NativeApplication | ||
[override]
Removes a listener from the EventDispatcher object. | NativeApplication | ||
Invokes an internal selectAll command on the focused display object. | NativeApplication | ||
Sets this application as the default application for opening files with the specified extension. | NativeApplication | ||
Sets the availability of a dynamic property for loop operations. | Object | ||
Returns the string representation of this object, formatted according to locale-specific conventions. | Object | ||
Returns the string representation of the specified object. | Object | ||
Returns the primitive value of the specified object. | Object | ||
Checks whether an event listener is registered with this EventDispatcher object or any of
its ancestors for the specified event type. | EventDispatcher |
Event | Summary | Defined By | ||
---|---|---|---|---|
Dispatched when this application becomes the active desktop application. | NativeApplication | |||
Dispatched when an application is invoked by a SWF file running in the user's browser. | NativeApplication | |||
Dispatched when the desktop focus is switched to a different application. | NativeApplication | |||
Dispatched when the application exit sequence is started. | NativeApplication | |||
Dispatched when an application is invoked. | NativeApplication | |||
Dispatched when either a new network connection becomes available or an existing network connection is lost. | NativeApplication | |||
Dispatched when the user has been idle for the period of time specified by the idleThreshold property. | NativeApplication | |||
Dispatched when the operating system detects mouse or keyboard activity after an idle period. | NativeApplication |
activeWindow | property |
activeWindow:NativeWindow
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
The active application window.
If the active desktop window does not belong
to this application, or there is no active window, activeWindow
is
null
.
Implementation
public function get activeWindow():NativeWindow
applicationDescriptor | property |
applicationDescriptor:XML
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
The contents of the application descriptor file for this AIR application.
Implementation
public function get applicationDescriptor():XML
Example ( How to use this example )
copyright
and version
elements from the application descriptor file. Note that you must use the default namespace
defined in the application descriptor XML.
var appDescriptor:XML = NativeApplication.nativeApplication.applicationDescriptor; var ns:Namespace = appDescriptor.namespace(); var appCopyright:String = appDescriptor.ns::copyright; var appVersion:String = appDescriptor.ns::version; trace("appId:", appCopyright); trace("version:", appVersion);
applicationID | property |
applicationID:String
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
The application ID of this application.
The value of this ID is set in the application descriptor file.
Implementation
public function get applicationID():String
autoExit | property |
autoExit:Boolean
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
Specifies whether the application should automatically terminate when all windows have been closed.
When autoExit
is true
, which is the default,
the application terminates when all windows are closed. Both
exiting
and exit
events are dispatched.
When autoExit
is false
, you must call
NativeApplication.nativeApplication.exit()
to terminate the application.
Implementation
public function get autoExit():Boolean
public function set autoExit(value:Boolean):void
icon | property |
icon:InteractiveIcon
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
The application icon.
Use NativeApplication.supportsDockIcon
and NativeApplication.supportsSystemTrayIcon
to determine the icon class. The type will be one
of the subclasses of InteractiveIcon. On Mac® OS X, NativeApplication.icon
is an object of type DockIcon
. On Windows®, NativeApplication.icon
is an object of type SystemTrayIcon
. On Linux, an application icon is not always supported. In this case,
the icon
property is null
.
The icon
object is automatically created, but it is not initialized
with image data. On some operating systems, such as Mac OS X, a default image is supplied.
On others, such as Windows, the icon is not displayed unless image data is assigned to it.
To assign an icon image, set the icon.bitmaps
property with an array
containing at least one BitmapData object. If more than one BitmapData object is included
in the array, then the operating system chooses the image that is closest in size to the icon's
display dimensions, scaling the image if necessary.
Implementation
public function get icon():InteractiveIcon
See also
idleThreshold | property |
idleThreshold:int
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
The number of seconds that must elapse without keyboard or mouse input
before a userIdle
event is dispatched.
By default, the idle threshold is 300 seconds (5 minutes). The acceptable range of values is from 5 (5 seconds) through 86,400 (1 day), inclusive.
Implementation
public function get idleThreshold():int
public function set idleThreshold(value:int):void
Throws
ArgumentError — If you attempt to set the property to an invalid value.
The acceptable range of values is from 5 (5 seconds) through 86,400 (1 day), inclusive.
|
See also
menu | property |
menu:NativeMenu
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
The application menu.
Application menus are supported when NativeApplication.nativeApplication.supportsMenu
is true
. Not all operating systems support application
menus. For example, application menus are supported on Mac OS X, but not on Windows or Linux.
Assigning a NativeMenu object to this property when NativeApplication.nativeApplication.supportsMenu
is false
is allowed, but does nothing. Be sure to use the
NativeApplication.nativeApplication.supportsMenu
property to determine whether the
operating system supports application menus. Using other means (such as Capabilities.os
)
to determine support can lead to programming errors (if some possible target operating systems
are not considered).
Note: On Mac OS X, the menu
property references the
operating-system-supplied default application menu. You can modify the
existing menu structure by adding and removing items and submenus, and
by adding event listeners. You can also replace the default menus entirely by
assigning a new NativeMenu object to this menu
property.
Implementation
public function get menu():NativeMenu
public function set menu(value:NativeMenu):void
See also
nativeApplication | property |
nativeApplication:NativeApplication
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
The singleton instance of the NativeApplication object.
Implementation
public static function get nativeApplication():NativeApplication
Throws
Error — If accessed by content outside the application
security sandbox.
|
openedWindows | property |
openedWindows:Array
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
An array containing all the open native windows of this application.
Implementation
public function get openedWindows():Array
publisherID | property |
publisherID:String
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
The publisher ID of this application.
The value of this ID is set in the application's publisherid file, which is generated at installation from the certificate chain used to sign the application.
Implementation
public function get publisherID():String
runtimePatchLevel | property |
runtimePatchLevel:uint
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
The patch level of the runtime hosting this application.
Implementation
public function get runtimePatchLevel():uint
runtimeVersion | property |
runtimeVersion:String
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
The version number of the runtime hosting this application.
Implementation
public function get runtimeVersion():String
startAtLogin | property |
startAtLogin:Boolean
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
Specifies whether this application is automatically launched whenever the current user logs in.
The startAtLogin
property reflects the status of the operating-system-defined mechanism for
designating that an application should start automatically when a user logs in. The
user can change the status manually by using the operating system user interface. This
property reflects the current status, whether the status was last changed
by the AIR application or by the operating system.
Implementation
public function get startAtLogin():Boolean
public function set startAtLogin(value:Boolean):void
Throws
IllegalOperationError — On Windows when another application with the same name
(but with a different path to the executable) is already set to
launch when this user logs in.
| |
IllegalOperationError — If this application is not installed, which
may be the case when launched by the AIR Debug Launcher (ADL).
|
supportsDockIcon | property |
supportsDockIcon:Boolean
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
Indicates whether AIR supports application dock icons on the current operating system.
If true
, the NativeApplication.icon
property is of type
DockIcon
.
Mac OS X and various Linux® user interfaces provide an application "dock" containing icons for applications that are running or are frequently used.
Be sure to use the NativeApplication.supportsDockIcon
property to determine whether the
operating system supports application dock icons. Using other means (such as Capabilities.os
)
to determine support can lead to programming errors (if some possible target operating systems
are not considered).
Implementation
public static function get supportsDockIcon():Boolean
See also
supportsMenu | property |
supportsMenu:Boolean
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
Specifies whether the current operating system supports a global application menu bar.
When true
, the NativeApplication.menu
property can be used to define (or access) a native
application menu.
Be sure to use the NativeApplication.supportsMenu
property to determine whether the
operating system supports the application menu bar. Using other means (such as Capabilities.os
)
to determine support can lead to programming errors (if some possible target operating systems
are not considered).
Implementation
public static function get supportsMenu():Boolean
See also
supportsSystemTrayIcon | property |
supportsSystemTrayIcon:Boolean
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
Specifies whether AIR supports system tray icons on the current operating system.
If true
, the NativeApplication.icon
property is of type
SystemTrayIcon
.
Be sure to use the NativeApplication.supportsSystemTrayIcon
property to determine whether the
operating system supports system tray icons. Using other means (such as Capabilities.os
)
to determine support can lead to programming errors (if some possible target operating systems
are not considered).
Note: On Windows, the system tray region of the task bar is officially called the Notification Area.
Implementation
public static function get supportsSystemTrayIcon():Boolean
See also
timeSinceLastUserInput | property |
timeSinceLastUserInput:int
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
The time, in seconds, since the last mouse or keyboard input.
Implementation
public function get timeSinceLastUserInput():int
See also
activate | () | method |
public function activate(window:NativeWindow = null):void
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
Activates this application.
Under some circumstances determined by the operating system, this method does not activate an application. Most operating systems restrict the ability of an application to activate itself to prevent it from accidentally or maliciously making it impossible for a user to use other applications.
If the operating system allows activation, then the specified window is activated and
brought to the desktop foreground; that is, in front of the windows of other applications.
(If the window
parameter is null
, then a
visible window of this application is activated.)
The activate()
method has no effect if the application has no visible windows.
The activate operation is synchronous.
Parameters
window:NativeWindow (default = null ) — The NativeWindow object of the window to activate along with the application.
|
Events
activate: — Dispatched if the activation state changes.
|
addEventListener | () | method |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Runtime Versions: | AIR 1.0 |
Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event. You can register event listeners on all nodes in the display list for a specific type of event, phase, and priority.
After you successfully register an event listener, you cannot change its priority
through additional calls to addEventListener()
. To change a listener's
priority, you must first call removeListener()
. Then you can register the
listener again with the new priority level.
Keep in mind that after the listener is registered, subsequent calls to
addEventListener()
with a different type
or
useCapture
value result in the creation of a separate listener registration.
For example, if you first register a listener with useCapture
set to
true
, it listens only during the capture phase. If you call
addEventListener()
again using the same listener object, but with
useCapture
set to false
, you have two separate listeners: one
that listens during the capture phase and another that listens during the target and
bubbling phases.
You cannot register an event listener for only the target phase or the bubbling phase. Those phases are coupled during registration because bubbling applies only to the ancestors of the target node.
If you no longer need an event listener, remove it by calling
removeEventListener()
, or memory problems could result. Event listeners are not automatically
removed from memory because the garbage
collector does not remove the listener as long as the dispatching object exists (unless the useWeakReference
parameter is set to true
).
Copying an EventDispatcher instance does not copy the event listeners attached to it. (If your newly created node needs an event listener, you must attach the listener after creating the node.) However, if you move an EventDispatcher instance, the event listeners attached to it move along with it.
If the event listener is being registered on a node while an event is being processed on this node, the event listener is not triggered during the current phase but can be triggered during a later phase in the event flow, such as the bubbling phase.
If an event listener is removed from a node while an event is being processed on the node, it is still triggered by the current actions. After it is removed, the event listener is never invoked again (unless registered again for future processing).
Parameters
type:String — The type of event.
| |
listener:Function — The listener function that processes the event. This function must accept
an Event object as its only parameter and must return nothing, as this example shows:
function(evt:Event):void The function can have any name. | |
useCapture:Boolean (default = false ) —
Determines whether the listener works in the capture phase or the
target and bubbling phases. If useCapture is set to true ,
the listener processes the event only during the capture phase and not in the
target or bubbling phase. If useCapture is false , the
listener processes the event only during the target or bubbling phase. To listen for
the event in all three phases, call addEventListener twice, once with
useCapture set to true , then again with
useCapture set to false .
| |
priority:int (default = 0 ) — The priority level of the event listener. The priority is designated by
a signed 32-bit integer. The higher the number, the higher the priority. All listeners
with priority n are processed before listeners of priority n-1. If two
or more listeners share the same priority, they are processed in the order in which they
were added. The default priority is 0.
| |
useWeakReference:Boolean (default = false ) — Determines whether the reference to the listener is strong or
weak. A strong reference (the default) prevents your listener from being garbage-collected.
A weak reference does not. Class-level member functions are not subject to garbage
collection, so you can set |
clear | () | method |
public function clear():Boolean
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
Invokes an internal delete command on the focused display object.
This function call is ignored if the focused object does not implement the command. Only display objects descending from the TextField or HTMLLoader classes currently implement this command.
Note: The clear()
command deletes
selected text. If nothing is selected, it does not clear all text.
Boolean — true .
|
copy | () | method |
public function copy():Boolean
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
Invokes an internal copy command on the focused display object.
This function call is ignored if the component does not implement the command. Only display objects descending from the TextField or HTMLLoader classes currently implement this command.
ReturnsBoolean |
cut | () | method |
public function cut():Boolean
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
Invokes an internal cut command on the focused display object.
This function call is ignored if the component does not implement the command. Only display objects descending from the TextField or HTMLLoader classes currently implement this commands.
ReturnsBoolean — true .
|
dispatchEvent | () | method |
override public function dispatchEvent(event:Event):Boolean
Runtime Versions: | AIR 1.0 |
Dispatches an event into the event flow. The event target is the EventDispatcher
object upon which the dispatchEvent()
method is called.
Parameters
event:Event — The Event object that is dispatched into the event flow.
If the event is being redispatched, a clone of the event is created automatically.
After an event is dispatched, its target property cannot be changed, so you
must create a new copy of the event for redispatching to work.
|
Boolean — A value of true if the event was successfully dispatched. A value of false indicates failure or that preventDefault() was called
on the event.
|
exit | () | method |
public function exit(errorCode:int = 0):void
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
Terminates this application.
The call to the exit()
method will return;
the shutdown sequence does not begin until the currently executing code
(such as a current event handler) has completed. Pending asynchronous
operations are canceled and may or may not complete.
Note that an exiting
event is not dispatched. If an exiting
event is required by application logic, call NativeApplication.nativeApplication.dispatchEvent()
, passing
in an Event object of type exiting
. Likewise, closing
and close
events are not dispatched before
application windows are closed. If windows should be notified before your application
exits, you can dispatch closing
events for each open window.
If a window close
event is required, call the window's
close()
method before exiting.
Parameters
errorCode:int (default = 0 ) — The exit code reported to the operating system when this application exits.
|
getDefaultApplication | () | method |
public function getDefaultApplication(extension:String):String
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
Gets the default application for opening files with the specified extension.
Note: This method can only be used with file types declared in the
fileTypes
statement of the application descriptor.
Parameters
extension:String — A String containing the extension of the file type of interest (without the ".").
|
String — The path of the default application.
|
Throws
Error — If the extension parameter does not contain one of the
file extensions declared in the application descriptor.
|
See also
isSetAsDefaultApplication | () | method |
public function isSetAsDefaultApplication(extension:String):Boolean
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
Specifies whether this application is currently the default application for opening files with the specified extension.
Parameters
extension:String — A String containing the extension of the file type of interest (without the ".").
|
Boolean — true if this application is the default.
|
Throws
Error — If the extension parameter does not contain one of the
file extensions declared in the application descriptor.
|
See also
paste | () | method |
public function paste():Boolean
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
Invokes an internal paste command on the focused display object.
This function call is ignored if the component does not implement the command. Only display objects descending from the TextField or HTMLLoader classes currently implement this command.
ReturnsBoolean — true .
|
removeAsDefaultApplication | () | method |
public function removeAsDefaultApplication(extension:String):void
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
Removes this application as the default for opening files with the specified extension.
Note: This method can only be used with file types listed in the
fileTypes
statement in the application descriptor.
Parameters
extension:String — A String containing the extension of the file type of interest
(without the ".").
|
Throws
Error — If the extension parameter does not contain one of the
file extensions declared in the application descriptor.
|
See also
removeEventListener | () | method |
override public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Runtime Versions: | AIR 1.0 |
Removes a listener from the EventDispatcher object. If there is no matching listener registered with the EventDispatcher object, a call to this method has no effect.
Parameters
type:String — The type of event.
| |
listener:Function — The listener object to remove.
| |
useCapture:Boolean (default = false ) —
Specifies whether the listener was registered for the capture phase or the
target and bubbling phases. If the listener was registered for both the capture phase and the
target and bubbling phases, two calls to removeEventListener() are required
to remove both, one call with useCapture() set to true , and another
call with useCapture() set to false .
|
selectAll | () | method |
public function selectAll():Boolean
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
Invokes an internal selectAll command on the focused display object.
This function call is ignored if the component does not implement the command. Only display objects descending from the TextField or HTMLLoader classes currently implement this command.
ReturnsBoolean — true .
|
setAsDefaultApplication | () | method |
public function setAsDefaultApplication(extension:String):void
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 |
Sets this application as the default application for opening files with the specified extension.
Note: This method can only be used with file types declared in the
fileTypes
statement in the application descriptor.
Parameters
extension:String — A String containing the extension of the file type of interest (without the ".").
|
Throws
Error — If the extension parameter does not contain one of the
file extensions declared in the application descriptor.
|
See also
activate | Event |
flash.events.Event
property Event.type =
flash.events.Event.ACTIVATE
Runtime Versions: | AIR 1.0 |
Dispatched when this application becomes the active desktop application.
TheACTIVATE
constant defines the value of the type
property of an activate
event object.
Note: This event has neither a "capture phase" nor a "bubble phase", which means that event listeners must be added directly to any potential targets, whether the target is on the display list or not.
This event has the following properties:
Property | Value |
---|---|
bubbles | false |
cancelable | false ; there is no default behavior to cancel. |
currentTarget | The object that is actively processing the Event object with an event listener. |
target | Any DisplayObject instance with a listener registered for the activate event. |
browserInvoke | Event |
flash.events.BrowserInvokeEvent
property BrowserInvokeEvent.type =
flash.events.BrowserInvokeEvent.Browser_INVOKE
Runtime Versions: | AIR 1.0 |
Dispatched when an application is invoked by a SWF file running in the user's browser.
Browser invocation is permitted only if an application specifies the following in the application descriptor file:
<allowBrowserInvocation>true</allowBrowserInvocation>
deactivate | Event |
flash.events.Event
property Event.type =
flash.events.Event.DEACTIVATE
Runtime Versions: | AIR 1.0 |
Dispatched when the desktop focus is switched to a different application.
TheEvent.DEACTIVATE
constant defines the value of the type
property of a deactivate
event object.
Note: This event has neither a "capture phase" nor a "bubble phase", which means that event listeners must be added directly to any potential targets, whether the target is on the display list or not.
This event has the following properties:
Property | Value |
---|---|
bubbles | false |
cancelable | false ; there is no default behavior to cancel. |
currentTarget | The object that is actively processing the Event object with an event listener. |
target | Any DisplayObject instance with a listener registered for the deactivate event. |
exiting | Event |
flash.events.Event
property Event.type =
flash.events.Event.EXITING
Runtime Versions: | AIR 1.0 |
Dispatched when the application exit sequence is started.
The exiting event is dispatched when application exit is initiated by
the operating system; for example, when a user issues the Cmd-Q
key sequence on Mac OS X, or when the autoExit
property of
the NativeApplication object is true
and the last
application window is closed.
Canceling this event prevents the application from exiting.
Note: Calling the NativeApplication exit()
method does not cause an
exiting
event to be dispatched. To warn components of an impending exit,
dispatch the exiting
event before calling exit()
Event.EXITING
constant defines the value of the type
property of an exiting
event object.
This event has the following properties:
Property | Value |
---|---|
bubbles | false |
cancelable | true ; canceling this event object stops the exit operation. |
currentTarget | The NativeApplication object. |
target | The NativeApplication object. |
invoke | Event |
flash.events.InvokeEvent
property InvokeEvent.type =
flash.events.InvokeEvent.INVOKE
Runtime Versions: | AIR 1.0 |
Dispatched when an application is invoked.
When an application is invoked a second time,
another instance of the application is not started. Instead, the first instance
receives an additional invoke event. It is the responsibility of the
application to handle subsequent invoke
events appropriately.
Note: All invoke
events are queued. When a listener for this
event is registered, it receives all events in the queue as well as any new events.
Queued events may be delivered before or after any new invoke
events.
InvokeEvent.INVOKE
constant defines the value of the type
property of an InvokeEvent object.
The InvokeEvent object has the following properties:
Properties | Values |
---|---|
arguments | The array of string arguments passed during this invocation. |
currentDirectory | a File object representing the directory that should be used to resolve any relative paths in the arguments array. |
reason | a code indicating whether the invoke event was dispatched
because the application started automatically at login (InvokeEventReason.LOGIN ), or
for another reason (InvokeEventReason.STANDARD ). Available as of AIR version 1.5.1. |
bubbles | false . |
cancelable | false ;
there is no default behavior to cancel. |
currentTarget | Indicates the object that is actively processing this InvokeEvent object with an event listener. |
target | Always the NativeApplication object. |
networkChange | Event |
flash.events.Event
property Event.type =
flash.events.Event.NETWORK_CHANGE
Runtime Versions: | AIR 1.0 |
Dispatched when either a new network connection becomes available or an existing network connection is lost.
A networkChange
event does not necessarily mean that the host computer has
gone online or offline; it may just be transitioning from one type of
connection to another. Applications can use this event to help optimize the
task of monitoring remote resource availability. The dispatch of a
networkChange
event is often a good time to verify the availability of any remote resources.
Note: There may be a short delay between a network change and the delivery of this event.
TheEvent.NETWORK_CHANGE
constant defines the value of the type
property of a networkChange
event object.
This event has the following properties:
Property | Value |
---|---|
bubbles | false |
cancelable | false ; there is no default behavior to cancel. |
currentTarget | The object that is actively processing the Event object with an event listener. |
target | The NativeApplication object. |
userIdle | Event |
flash.events.Event
property Event.type =
flash.events.Event.USER_IDLE
Runtime Versions: | AIR 1.0 |
Dispatched when the user has been idle for the period of time specified by the
idleThreshold
property.
The amount of time that the user has been idle can be
determined from the timeSinceLastUserInput
property.
Event.USER_IDLE
constant defines the value of the type
property of a userIdle
event object.
This event has the following properties:
Property | Value |
---|---|
bubbles | false |
cancelable | false ; there is no default behavior to cancel. |
target | The NativeApplication object. |
See also
userPresent | Event |
flash.events.Event
property Event.type =
flash.events.Event.USER_PRESENT
Runtime Versions: | AIR 1.0 |
Dispatched when the operating system detects mouse or keyboard activity after an idle period.
The period of time that is considered idle is configurable with the idleThreshold
property. The amount of time that the user has been idle can be determined from
the timeSinceLastUserInput
property.
Event.USER_PRESENT
constant defines the value of the type
property of a userPresent
event object.
This event has the following properties:
Property | Value |
---|---|
bubbles | false |
cancelable | false ; there is no default behavior to cancel. |
target | The NativeApplication object. |
See also
Fri Mar 19 2010, 02:45 AM -07:00