flash.errors.IllegalOperationError - Adobe® Flex® 4 Language Reference (Flex 4)

Package	flash.errors
Class	public dynamic class IllegalOperationError
Inheritance	IllegalOperationError Error Object

Language Version:

ActionScript 3.0

Runtime Versions:

Flash Player 9, AIR 1.0

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 Flash 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

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
		prototype : Object [static] A reference to the prototype object of a class or function object.	Object

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 as a string at the time of the error's construction (for the debugger version of Flash Player and the AIR Debug Launcher (ADL) only; returns null if not using the debugger version of Flash Player or the ADL.	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.

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