flash.errors

# IllegalOperationError - AS3

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

The IllegalOperationError exception is thrown when a method is not implemented or the implementation doesn't cover the current usage.

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

View the examples

More examples

Comparing the Error classes
flash.error package Error classes

Public Properties
Hide Inherited Public Properties
Show Inherited 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
Hide Inherited Public Methods
Show Inherited Public Methods

| Method | Defined By
--- | --- | ---
|  | IllegalOperationError(message:String = "") Creates a new IllegalOperationError object. | IllegalOperationError
|  | getStackTrace():String Returns the call stack for an error at the time of the error's construction as a string. | Error
|  | hasOwnProperty(name:String):Boolean Indicates whether an object has a specified property defined. | Object
|  | isPrototypeOf(theClass:Object):Boolean Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter. | Object
|  | propertyIsEnumerable(name:String):Boolean Indicates whether the specified property exists and is enumerable. | Object
|  | setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Sets the availability of a dynamic property for loop operations. | Object
|  | toLocaleString():String Returns the string representation of this object, formatted according to locale-specific conventions. | Object
|  | toString():String [override] Returns the string "Error" by default or the value contained in the Error.message property, if defined. | Error
|  | valueOf():Object Returns the primitive value of the specified object. | Object

Constructor Detail

### IllegalOperationError

()
Constructor

`public function IllegalOperationError(message:String = "")`

Language Version: | ActionScript 3.0

Runtime Versions: | AIR 1.0, Flash Player 9

Creates a new IllegalOperationError object.

Parameters

| `message:String` (default = "``")`` — A string associated with the error object.

Examples How to use this example
IllegalOperationErrorExample.as
The following example shows the use of an `IllegalOperationError` handler.
Copy

    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");
            }
        }
    }

© 2015 Adobe Systems Incorporated. All rights reserved.
Mon Apr 10 2017, 12:28 PM -07:00