Returns the application window that is currently active. If the active desktop window does not belong to this application, activeWindow returns null.

The contents of the application descriptor file for this AIR application. The application descriptor file includes application settings.

var appXml:XML = Shell.shell.applicationDescriptor;
var appId:String = appXml.@appId;
var appVersion:String = appXml.@version;
var appName:String = appXml.name[0];
trace("appId:", appId);
trace("version:", appVersion);
trace("name:", appName);

The application ID of this application.

The value of this ID is set in the application descriptor file.

Specifies whether the application should automatically terminate when all windows have been closed.

When autoExit is true, which is the default, the application will terminate when all windows have been closed. Both exiting and exit events will be dispatched. When autoExit is false, you must call Shell.shell.exit() to terminate the application.

The application icon.

Use Shell.supportsDockIcon and Shell.supportsSystemTrayIcon to determine the icon object type. The type will be one of the subclasses of InteractiveIcon. On Mac OS X, Shell.icon will be an object of type DockIcon. On Windows, Shell.icon will be an object of type SystemTrayIcon.

The icon object is automatically created, but 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 the icon. 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 will choose the image closest in size to the icon's display dimensions, scaling the image if necessary.

Veja também

Specifies how many seconds must elapse without keyboard or mouse input before a presenceChange event is dispatched.

By default, the idleThreshold is 300 seconds (5 minutes).

Veja também

The application menu.

To provide a menu for an application, create a NativeMenu object, along with associated NativeMenuItems and event handlers, and assign it to this menu property.

Application menus are supported when Shell.shell.supportsMenu is true. Not all operating systems support application menus. For exemplo, application menus are supported on Mac OS X, but not on Windows. Assigning a NativeMenu object to this property when Shell.shell.supportsMenu is false is allowed, but does nothing.

Note: On Mac OS X, the menu property references the operating-system-supplied default application menu. You can modify the the existing menu structure by adding and removing items, submenus, and by adding event listeners.

Veja também

Lists the NativeWindows that are currently opened by the application.

The publisher ID of this application.

The value of this ID is set in the application's publisherid file, which is generated at install time from the certificate chain used to sign the application.

The patch level of the AIR runtime.

The version number of the AIR runtime.

Obtains the singleton instance of the Shell class.

Specifies whether this application will automatically launch whenever the current user logs in.

Specifies whether AIR supports application dock icons on the current operating system. When true, the Shell.icon property will be of type, DockIcon.

Mac OS X and various Linux user interfaces provide an application "dock" containing icons for running or frequently used applications.

Veja também

Specifies whether the current operating system supports a global application menu bar.

When true, the Shell.menu property can be used to define (or access) a native application menu.

Veja também

Specifies whether AIR supports system tray icons on the current operating system. When true, the Shell.icon property will be of type, SystemTrayIcon.

On Microsoft Windows, the system tray region of the task bar is officially called the Notification Area.

Veja também

Returns the time, in seconds, since the last mouse or keyboard input.

Veja também

Activates this application.

Under circumstances determined by the operating system, this method will 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 this application is activated, then one of the visible windows owned by the application will be activated and brought to the desktop foreground, that is, in front of the windows of other applications that may be open.

activateApplication() has no effect if the application has no visible windows.

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 exemplo, 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. Objects with registered event listeners are not automatically removed from memory because the garbage collector does not remove objects that still have references.

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).

Parâmetros

function(evt:Event):void

Invokes an internal delete command on the focused display object

Invokes an internal copy command on the focused display object

Invokes an internal cut command on the focused display object

Parâmetros

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 cancelled and may or may not complete.

Note that an exiting event will not be dispatched. If an exiting event is required by application logic, call Shell.shell.dispatchEvent(), passing in an Event object of type exiting. Likewise, closing and close events will not be 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.

Parâmetros

Gets the default application 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. getDefaultApplication() will return the string, "false", for all other file types.

Parâmetros

Specifies whether this application is currently the default application for opening files with the specified extension.

Parâmetros

Invokes an internal paste command on the focused display object

Invokes platform-specific key equivalent for a keyboard event Used to execute cut/copy/paste/etc editing commands

Parâmetros

Invokes an internal redo command on the focused display object

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. removeAsDefaultApplication() will return falsefor all other file types.

Parâmetros

Parâmetros

Invokes an internal selectAll command on the focused display object

Sets this application as the default application 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. setAsDefaultApplication() will return falsefor all other file types.

Parâmetros

Invokes an internal undo command on the focused display object

Dispatched when this application becomes the active desktop application.

Note: This event does not go through a "capture phase" and is dispatched directly to the target, whether the target is on the display list or not.

This event has the following properties:

Dispatched when the desktop focus is switched to a different application.

Note: This event does not go through a "capture phase" and is dispatched directly to the target, whether the target is on the display list or not.

This event has the following properties:

Dispatched when the application's exit sequence is started.

The exiting event is dispatched when application exit is initiated by the operating system, for exemplo, when a user issues the Cmd-Q key sequence on Mac OS X, or when autoExit=true and the last application window is closed. Canceling this event will prevent the application from exiting.

Note: Calling the Shell.exit() method does not cause an exiting event to be dispatched. Applications that wish to warn components of an impending exit should dispatch the exiting event before calling exit

This event has the following properties:

Dispatched when an application is invoked. All invoke events are queued until a listener is registered. 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.

The InvokeEvent object has the following properties:

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.

This event has the following properties:

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.

This event has the following properties:

Veja também

Dispatched when the user uses the mouse use or keyboard 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.

This event has the following properties:

Veja também