| Package | flash.errors |
| Class | public dynamic class IllegalOperationError |
| Inheritance | IllegalOperationError  Error Object |
| Language Version: | ActionScript 3.0 |
| Runtime Versions: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Examples of illegal operation error exceptions include:
- A base class, such as DisplayObjectContainer, provides more functionality than a Stage can support (such as masks)
- Certain accessibility methods are called when the player is compiled without accessibility support
- The mms.cfg setting prohibits a FileReference action
- ActionScript tries to run a
FileReference.browse()call when a browse dialog box is already open - ActionScript tries to use an unsupported protocol for a FileReference object (such as FTP)
- Authoring-only features are invoked from a run-time player
- An attempt is made to set the name of a Timeline-placed object
More examples
Public Properties
| Property | Defined By | ||
|---|---|---|---|
 | constructor : Object
A reference to the class object or constructor function for a given object instance. | Object | |
| errorID : int [read-only]
Contains the reference number associated with the specific error message. | Error | |
| message : String
Contains the message associated with the Error object. | Error | |
| name : String
Contains the name of the Error object. | Error | |
Public Methods
| Method | Defined By | ||
|---|---|---|---|
IllegalOperationError(message:String = "")
Creates a new IllegalOperationError object. | IllegalOperationError | ||
|
Returns the call stack for an error at the time of the error's
construction as a string. | Error | |
|
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 | |
|
Indicates whether the specified property exists and is enumerable. | Object | |
|
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 | |
| [override]
Returns the string "Error" by default or the value contained in the Error.message property,
if defined. | Error | |
|
Returns the primitive value of the specified object. | Object | |
Constructor Detail
IllegalOperationError | () | Constructor |
Examples How to use this example
IllegalOperationErrorExample.as
The following example shows the use of an
IllegalOperationError handler.
package {
import flash.display.DisplayObject;
import flash.display.Sprite;
import flash.errors.IllegalOperationError;
public class IllegalOperationErrorExample extends Sprite {
public function IllegalOperationErrorExample() {
var child:Sprite = new Sprite();
try {
addChild(child);
}
catch(e:IllegalOperationError) {
trace(e);
}
}
public override function addChild(child:DisplayObject):DisplayObject {
throw new IllegalOperationError("addChild cannot be performed on the IllegalOperationErrorExample class");
}
}
}
Thu Dec 4 2014, 05:50 PM -08:00