FileDocCategorySizeDatePackage
ToolkitException.javaAPI DocphoneME MR2 API (J2ME)5631Wed May 02 18:00:40 BST 2007sim.toolkit

ToolkitException

public class ToolkitException extends CardRuntimeException
This class extends the Throwable class and allows the classes of this package to throw specific exceptions in case of problems.

version
8.3.0

Fields Summary
public static final short
HANDLER_OVERFLOW
This reason code (= 1) is used to indicate that data are to large than the storage space available in the handler.
public static final short
HANDLER_NOT_AVAILABLE
This reason code (= 2) is used to indicate that the Handler is not available (e.g. busy).
public static final short
UNAVAILABLE_ELEMENT
This reason code (= 3) is used to indicate that the element is unavailable in the handler buffer.
public static final short
MENU_ENTRY_NOT_FOUND
This reason code (= 4) is used to indicate that the requested menu entry is not define for the corresponding applet.
public static final short
REGISTRY_ERROR
This reason code (= 5) is used to indicate an error in the applet registry.
public static final short
EVENT_NOT_SUPPORTED
This reason code (= 6) is used to indicate that the event code is not supported by the toolkit framework
public static final short
EVENT_ALREADY_REGISTERED
This reason code (= 7) is used to indicate that the maximum number of registered applet for this event is already reached (e.g Call Control)
public static final short
OUT_OF_TLV_BOUNDARIES
This reason code (= 8) is used to indictae that either the offset, the length or both are out of current TLV boundaries.
public static final short
ME_PROFILE_NOT_AVAILABLE
This reason code (= 9) is used to indicate that the Terminal Profile data are not available
public static final short
ALLOWED_LENGTH_EXCEEDED
This reason code (=10) is used to indicate that the provided menu entry string is bigger than the space alloacted space.
public static final short
NO_TIMER_AVAILABLE
This reason code (=11) is used to indicate that all the available timers or the maximum number of timers have been allocated to the applet.
public static final short
INVALID_TIMER_ID
This reason code (=12) is used to indicate that the indicated timer identifier is not allocated to this applet.
public static final short
EVENT_NOT_ALLOWED
This reason code (=13) is used to indicate that the registration to an indicated event can not be changed by the called method.
public static final short
BAD_INPUT_PARAMETER
This reason code (=14) is used to indicate that an input parameter of the method is not valid.
Constructors Summary
public ToolkitException(short reason)
Construct a ToolkitException instance with the specified reason.

param
reason the reason for the exception

    
    // ------------------------------- Constructors ---------------------------
                        
       
        super(reason);
    
Methods Summary
public static voidthrowIt(short reason)
Throws the Toolkit Interface's instance of the ToolkitException class with the specified reason.

param
reason the reason for the exception.
exception
ToolkitException always

        ToolkitException systemInstance = 
            ViewHandler.currentTI.getToolkitExceptionInstance();
        systemInstance.setReason(reason);
        throw systemInstance;