The
This event has the following properties:
This event has the following properties:
You can check for error events that do not have any listeners by using the debugger
version of Flash Player or the AIR Debug Launcher (ADL). The string defined by the
Notes:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
In this example, the
Note: To run this example, you need an FLV file
whose name and location match the variable passed to
This event has the following properties:
The information object could have a
The information object could also be something different. The
P2P connections send messages to a
For example, Flex Data Services sends Message
objects that cause coercion errors if you try to access the
The following table describes the possible string values of the
Flash Player has detected a network change, for example, a dropped wireless connection, a successful wireless connection,or a network cable loss.
Use this event to check for a network interface change. Don't use this event to implement your NetConnection reconnect logic. Use
The seek operation is complete.
Sent when
If you consistently see errors regarding the buffer, try changing the buffer using the
Use the following properties to access an UncaughtErrorEvents instance:
To catch an error directly and prevent an uncaught error event, do the following:
If the content loaded by a Loader object is an AVM1 (ActionScript 2) SWF file,
uncaught errors in the AVM1 SWF file do not result in an
When nested nodes are involved, mouse events target the deepest possible nested node that
is visible in the display list. This node is called the target node. To have a
target node's ancestor receive notification of a mouse event, use
Notes:
In the constructor, a rectangle
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
In the constructor, a rectangle
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
The value of property
The value of this property can be
Event targets are an important part of the Flash® Player and Adobe AIR event model. The event target serves as the focal point for how events flow through the display list hierarchy. When an event such as a mouse click or a keypress occurs, an event object is dispatched into the event flow from the root of the display list. The event object makes a round-trip journey to the event target, which is conceptually divided into three phases: the capture phase includes the journey from the root to the last node before the event target's node; the target phase includes only the event target node; and the bubbling phase includes any subsequent nodes encountered on the return trip to the root of the display list.
In general, the easiest way for a user-defined class to gain event dispatching capabilities is to extend EventDispatcher. If this is impossible (that is, if the class is already extending another class), you can instead implement the IEventDispatcher interface, create an EventDispatcher member, and write simple hooks to route calls into the aggregated EventDispatcher.
Class-level member functions are not subject to garbage
collection, so you can set
After you successfully register an event listener, you cannot change its priority
through additional calls to
After the listener is registered, subsequent calls to
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.
When you no longer need an event listener, remove it by calling
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 also being processed on this node, the event listener is not triggered during the current phase but may 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 it is registered again for future processing).
The difference between
The difference between
The specific details of the failure can be found on the SQLError object
in the SQLErrorEvent instance's
The error value has the following
format:
The ErrorEvent class defines only one type of
You can check for
An uncaught error also causes an error dialog box displaying the error event to appear
when content is running in the
Note: This example does not work if you have a file named MissingFile.xml in the same directory as your SWF file.
Note: The
This event has the following properties:
A device or operating system interprets gesture input. So, different devices or operating systems have different requirements for individual gesture types. A swipe on one device might require different input movement than a swipe on another device. Refer to the hardware or operating system documentation to discover how the device or operating system interprets contact as a specific gesture.
Use the Multitouch class to determine the current environment's support for touch interaction, and to manage the support of touch interaction if the current environment supports it.
Note: When objects are nested on the display list, touch events target the deepest possible
nested object that is visible in the display list. This object is called the target node. To have a target node's
ancestor (an object containing the target node in the display list) receive notification of a touch event, use
While the user is in contact with the device, the TransformGestureEvent object's scale, rotation, and offset properties are incremental values
from the previous gesture event. For example, as a gesture increases the size of a display object, the scale values might go in sequence
For TransformGestureEvent objects, properties not modified by the current gesture are set to identity values. For example, a pan gesture does not have a rotation
or scale transformation, so the
The dispatched TransformGestureEvent object has the following properties:
The dispatched TransformGestureEvent object has the following properties:
The dispatched TransformGestureEvent object has the following properties:
The dispatched TransformGestureEvent object has the following properties:
The initiating object dispatches:
The initiating object is the interactive object passed that is to the NativeDragManager object in the call
to
Potential target interactive objects dispatches:
Typically a handler for the
Any InteractiveObject type object can be a drag initiator or a drop target.
Event objects are passed as parameters to event listeners. Dispatching a native drag event does not trigger the associated behavior.
The string is in the following format:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
If the object dispatching the event is not in the same security domain
as the initiating object, then the clipboard can be read only in the handler for
a
The dispatched PressAndTapGestureEvent object has the following properties:
This event has the following properties:
If altitude is not supported by the device, then this property is set to
Note: On Android devices, heading is not supported. The value of the
The CameraRoll class dispatches a
Defines the value of the
Defines the value of the
This event has the following properties:
This value is one of the possible values of the StageVideoEvent object
This value is one of the possible values of the StageVideoEvent object
For example, if the platform does not support hardware decoding and display of the audio or video codec of the video, the StageVideoEvent object has this status value.
This value is one of the possible values of the StageVideoEvent object
For example, consider a platform that does not support decoding and displaying the video's audio or video codec with either software or hardware. In this case, the StageVideoEvent object has this status value.
This status value also is used if no hardware decoders are available. This situation can occur in AIR for TV. For backward compatibility with its previous releases, AIR for TV allows you to use a Video object for hardware decoding and display. By using a Video object, you are using the underlying hardware decoder and therefore you have one less StageVideo object available for use. Note that using a StageVideo object for hardware video decoding and display is recommended.
There are two types of LocationChangeEvent:
A NetDataEvent is dispatched for the following messages:
Use the DNSResolver
The properties of the Event class carry basic information about an event, such as
the event's type or whether the event's default behavior can be canceled. For many
events, such as the events represented by the Event class constants, this basic information
is sufficient. Other events, however, may require more detailed information.
The methods of the Event class can be used in event listener functions to affect the
behavior of the event object. Some events have an associated default behavior.
Other sources of information include:
ProductManager pulled from table
Returns a new Event object that is a copy of the original instance of the Event object.
You do not normally call
The new Event object includes all the properties of the original.
When creating your own custom Event class, you must override the
inherited
In this example,
class PingEvent extends Event {
var URL:String;
public override function toString():String {
return formatToString("PingEvent", "type", "bubbles", "cancelable", "eventPhase", "URL");
}
}
Many events have associated behaviors that are carried out by default.
An example of a behavior that is not cancelable is the default behavior associated with
the
You can use the
Note: This method does not cancel the behavior associated with this event; see
Note: This method does not cancel the behavior associated with this event; see
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.
AIR for TV devices never automatically dispatch this event. You can, however, dispatch it manually.
This event has the following properties:
This event has the following properties:
This event has the following properties:
ProductManager pulled from table
This event has the following properties:
This event has the following properties:
This event has the following properties:
Note: TextField objects do not dispatch
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
Note: TextField objects do not dispatch
This event has the following properties:
Note: TextField objects do not dispatch
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.
AIR for TV devices never automatically dispatch this event. You can, however, dispatch it manually.
This event has the following properties:
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:
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:
This event has the following properties:
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:
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:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
Note: TextField objects do not dispatch
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:
This event has the following properties:
This event has the following properties:
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:
This event has the following properties:
This event has the following properties:
This event has the following properties:
Note: TextField objects do not dispatch
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
When an event occurs, it moves through the three phases of the event flow: the capture phase, which flows from the top of the display list hierarchy to the node just before the target node; the target phase, which comprises the target node; and the bubbling phase, which flows from the node subsequent to the target node back up the display list hierarchy.
Some events, such as the
Note: The domain shown in this example is fictitious and
A text field is created and its content is set to an HTML-formatted string by
using the
The
Three text fields for the preliminary instructions, the user input, and the
warning (error) messages are created. An event listener is added to respond to
the user's text input by triggering the
Note: The text events are dispatched when a user enters characters
and not as a response to any keyboard input, such as backspace. To catch all
keyboard events, use a listener for the
The
The first if statement in the
This event has the following properties:
A text field is created and its content is set to an HTML-formatted string by
using the
The
Note: This event is not dispatched for the Delete or Backspace keys.
This event has the following properties:
Three text fields for the preliminary instructions, the user input, and the
warning (error) messages are created. An event listener is added to respond to
the user's text input by triggering the
Note: The text events are dispatched when a user enters characters
and not as a response to any keyboard input, such as backspace. To catch all
keyboard events, use a listener for the
The
The first if statement in the
This event has two uses:
Dynamically generating audio using the Sound object Use the
In your function, you use the
If a Sound object has not loaded an MP3 file, when you call its
Thes latency of the event varies from platform to platform, and it could change in future
versions of
Provide between 2048 and 8192 samples to the
If you provide fewer than 2048 samples, tha Sound object plays the remaining samples
and then stops the sound as if the end of a sound file was reached, generating
a
You can use the
When you use the
Capturing Microphone audio Use the
In the event handler function, use the
This event has the following properties:
HTTPStatusEvent objects are always sent before error or completion events. An
HTTPStatusEvent object does not necessarily indicate an error condition; it simply reflects
the HTTP status code (if any) that is provided by the networking stack.
Notes:
The
This event has the following properties:
This event has the following properties:
If
The runtime uses this class to create FileListEvent objects. You will not use this constructor directly in your code.
This event has the following properties:
For the
There are four types of events:
This event has the following properties:
This event has the following properties:
Note: On Linux, the
This event has the following properties:
This event has the following properties:
Note: On Linux, the
If the event is
If the event is
The
A row identifier is used to uniquely identify a row in a table within the database. The value is frequently generated by the database.
The row identifier for a single SQL
For more information about primary keys and generated row identifiers,
see the "
Event targets are an important part of the Flash® Player and Adobe® AIR® event model. The event target serves as the focal point for how events flow through the display list hierarchy. When an event such as a mouse click or a keypress occurs, Flash Player or the AIR application dispatches an event object into the event flow from the root of the display list. The event object then makes its way through the display list until it reaches the event target, at which point it begins its return trip through the display list. This round-trip journey to the event target is conceptually divided into three phases: the capture phase comprises the journey from the root to the last node before the event target's node, the target phase comprises only the event target node, and the bubbling phase comprises any subsequent nodes encountered on the return trip to the root of the display list.
In general, the easiest way for a user-defined class to gain event dispatching capabilities is to extend EventDispatcher. If this is impossible (that is, if the class is already extending another class), you can instead implement the IEventDispatcher interface, create an EventDispatcher member, and write simple hooks to route calls into the aggregated EventDispatcher.
The EventDispatcher class is generally used as a base class, which means that
The function can have any name.
Class-level member functions are not subject to garbage
collection, so you can set
After you successfully register an event listener, you cannot change its priority
through additional calls to
Keep in mind that after the listener is registered, subsequent calls to
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
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).
The difference between
When
The difference between the
When
Use the Multitouch class to determine the current environment's support for touch interaction, and to manage the support of touch interaction if the current environment supports it.
Note: When objects are nested on the display list, touch events target the deepest possible
nested object that is visible in the display list. This object is called the target node. To have a target node's
ancestor (an object containing the target node in the display list) receive notification of a touch event, use
The dispatched TouchEvent object has the following properties:
The dispatched TouchEvent object has the following properties:
The dispatched TouchEvent object has the following properties:
The dispatched TouchEvent object has the following properties:
The dispatched TouchEvent object has the following properties:
The dispatched TouchEvent object has the following properties:
The dispatched TouchEvent object has the following properties:
The dispatched TouchEvent object has the following properties:
On a Mac OS, the value of the
The value of this property can be
The
The string is in the following format:
This event has the following properties:
Use this Socket object for all communication with the client. Your application is responsible for maintaining a reference to the Socket object. If you don't, the object is eligible for garbage collection and may be destroyed by the runtime without warning.
This event has the following properties:
When you initially connect to a remote shared object that is persistent locally and/or on the server, all the properties of this object are set to empty strings.
Otherwise, Flash sets
The
The
Because mappings between keys and specific characters vary by device and operating system, use the TextEvent event type for processing character input.
To listen globally for key events, listen on the Stage for the capture and target or bubble phase.
When you test this example, you need to click the square first for the keyboard events to work.
Also, if you are using the Test Movie command in Flash, the authoring interface may respond to certain keys instead of the event listeners attached to the child sprite.
This event has the following properties:
This event has the following properties:
Note: When an input method editor (IME) is running,
Note: When an input method editor (IME) is running,
This event has the following properties:
This event has the following properties:
If the event is
If the event is
This event class reports the current video rendering status. Use this event for the following purposes:
Constructor.
This event has the following properties:
For internal use only. Use flash.media.VideoStatus.ACCELERATED instead.
For internal use only. Use flash.media.VideoStatus.SOFTWARE instead.
For internal use only. Use flash.media.VideoStatus.UNAVAILABLE instead.
Returns the rendering status of the VideoEvent object. Possible values include "unavailable", "software", and "accelerated".
Use the Multitouch class to determine the current environment's support for touch interaction, and to manage the support of touch interaction if the current environment supports it.
Note: When objects are nested on the display list, touch events target the deepest possible
nested object that is visible in the display list. This object is called the target node. To have a target node's
ancestor (an object containing the target node in the display list) receive notification of a touch event, use
The dispatched GestureEvent object has the following properties:
On a Mac OS, the value of the
This event has the following properties:
This event fires when the state of the
NOTE: This notification occurs only when the state of the
Constructor.
This event has the following properties:
Reports the current availability of stage video using a constant of the flash.media.StageVideoAvailability class.
Note: If the socket is bound to the special address:
This event has the following properties:
In order for digitally protected content to be available offline, its voucher must be cached to the user's local machine. (The application decides where to store the content locally in order for it to be available offline.)
This event has the following properties:
This event has the following properties:
This event has the following properties:
SoftKeyboardEvents are dispatched by TextFields and by InteractiveObjects that have their
The softKeyboardActivate event is dispatched after the softKeyboardActivating event and cannot be canceled. To prevent the virtual keyboard from displaying, cancel the softKeyboardActivating event.
This event has the following properties:
This event has the following properties:
This event has the following properties:
Notes:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
Returns a new Event object that is a copy of the original instance of the Event object.
You do not normally call
The new Event object includes all the properties of the original.
When creating your own custom Event class, you must override the
inherited
In this example,
The authentication is automatically added to the DRMManager session cache. You
can save the token and use it to authenticate the user in a future session. Reuse a
token with the
This event has the following properties:
This event has the following properties:
This event has the following properties:
Notes:
This event has the following properties:
This event has the following properties:
Security error events are the final events dispatched for any target object. This means that any other events, including generic error events, are not dispatched for a target object that experiences a security error.
To create a
This event has the following properties:
The UncaughtErrorEvents object that dispatches the event is associated with either a LoaderInfo object or a Loader object. Use the following properties to access an UncaughtErrorEvents instance:
When an
When one SWF loads another,
A Loader object's
As with other event bubbling, calling
When content is running in a debugger version of the runtime, such as the
debugger version of Flash Player or the AIR Debug Launcher (ADL), an uncaught
error dialog appears when an uncaught error happens.
For those runtime versions, the error dialog appears even when a listener is registered
for the
If the content loaded by a Loader object is an AVM1 (ActionScript 2) SWF file,
uncaught errors in the AVM1 SWF file do not result in an
In the constructor, the code registers a listener for the
In the
In the constructor, the code creates a Loader object and registers a listener for
the
In the
This event has the following properties:
However, the
If that
Consequently, in your
If the
All other properties and methods of the Error class are available in all runtime versions.
The NativeApplication object always dispatches an
Only a single instance of a particular application can be launched. Subsequent attempts to
launch the application will result in a new
InvokeEvent objects are dispatched by the NativeApplication object
(
The InvokeEvent object has the following properties:
Note: When multiple files are selected and opened on Mac® OS X, AIR
dispatches a single
If an application is started from the command line, this property is typically set to the current working directory of the command line shell from which the application was started. If an application is launched from the GUI shell, this is typically the file system root.
The ScreenMouseEvent object extends the MouseEvent class to provide two additional properties,
This event has the following relevant properties:
This event has the following relevant properties:
This event has the following relevant properties:
This event has the following relevant properties:
This event has the following relevant properties:
This event has the following relevant properties:
This event has the following properties:
This event has the following properties:
The value of this property can be
The DRMAuthenticateEvent handler is responsible for gathering the required credentials
(such as the user name, password, and type) and passing the values to the
If user authentication failed, the application will retry authentication and dispatch a new DRMAuthenticateEvent event for the NetStream object.
This event has the following properties:
This event has the following properties:
This event has the following properties:
On Linux, the StorageVolumeInfo object only dispatches
Some devices, such as some digital cameras and phones, appear in the
Returns a new Event object that is a copy of the original instance of the Event object.
You do not normally call
The new Event object includes all the properties of the original.
When creating your own custom Event class, you must override the
inherited
In this example,
The event has the following properties:
The event has the following properties:
The runtime dispatches a DRMErrorEvent object when a NetStream object, trying to play a digital rights management (DRM) encrypted file, encounters a DRM-related error. For example, a DRMErrorEvent object is dispatched when the content provider does not support the viewing application, or when the user authorization fails, possibly because the user has not purchased the content.
In the case of invalid user credentials, the DRMAuthenticateEvent object handles the error by repeatedly dispatching until the user enters valid credentials, or the application denies further attempts. The application should listen to any other DRM error events in order to detect, identify, and handle the DRM-related errors.
This class provides properties containing the object throwing the exception, the error code, and,
where applicable, a suberror code and text message containing information related to the error. For
a description of DRM-related error codes, see the
This event has the following properties:
You can use the object referenced by the
This event has the following properties:
This event has the following properties:
This event has the following properties:
This event has the following properties:
The value of this property can be
Browser invocation is permitted only if an application specifies the following in the application descriptor file:
If the application is not running, the NativeApplication object dispatches both an InvokeEvent
event and a
If the application is launched as the result of a seamless installation from the browser (with
the user choosing to launch upon installation), the NativeApplication object dispatches a BrowserInvoke
event only if arguments were passed (via the SWF file in the browser passing an array to
the
Like the
The BrowserInvokeEvent object has the following properties:
This event has the following properties:
There are two types of StageOrientationEvent event:
The
Note: If the
Important: ORIENTATION_CHANGING events are not dispatched on Android devices.
This event has the following properties:This event has the following properties: