Exception object

The Exception object inherits from the Throwable object and is the base class for user-defined or "checked" exceptions. A function or user-defined event must declare each checked exception it throws, and a caller to a function or event that throws a checked exception must either catch the exception or throw the exception itself.

Unlike RuntimeError objects, Exception objects do not have built-in properties that provide information about the location where the error occurred.

The CORBAUserException system object inherits from Exception. This object maps to the CORBA_USER_EXCEPTION object that can be thrown from CORBA applications when user-defined exceptions have not been handled. Unlike the CORBASystemException object and its descendants, the CORBAUserException object is a checked exception and must be declared and caught like other checked exceptions.

Properties

Exception property

Datatype

Description

ClassDefinition

PowerObject

An object of type PowerObject containing information about the class definition of the object or control

Text

String

Contains the text of the error message


Events

Exception event

Occurs

Constructor

Immediately before the exception is thrown

Destructor

Immediately after the exception is thrown


Functions

Exception function

Datatype returned

Description

ClassName

String

Returns the name assigned to the object.

GetContextService

Integer

Creates a reference to a context-specific instance of the specified service.

GetMessage

String

Returns the error message from objects of type Throwable.

GetParent

PowerObject

Returns a reference to the name of the parent object.

PostEvent

Boolean

Adds an event to the end of the message queue for the object.

SetMessage

Sets an error message for an object of type Throwable.

TriggerEvent

Integer

Triggers a specific event in the object and executes the script for the event.

TypeOf

Object

Returns the type of the object.