Top Description Fields Constructors Methods
org.eclipse.swt

public Class SWTException

extends RuntimeException
Class Inheritance

This runtime exception is thrown whenever a recoverable error occurs internally in SWT. The message text and error code provide a further description of the problem. The exception has a throwable field which holds the underlying exception that caused the problem (if this information is available (i.e. it may be null)).

SWTExceptions are thrown when something fails internally, but SWT is left in a known stable state (eg. a widget call was made from a non-u/i thread, or there is failure while reading an Image because the source file was corrupt).

See Also
SWTError, Sample code and further information

Field Summary

Modifier and TypeField and Description
public int
code

The SWT error code, one of SWT.ERROR_*.

pack-priv static final long
public Throwable
throwable

The underlying throwable that caused the problem, or null if this information is not available.

Constructor Summary

AccessConstructor and Description
public
SWTException()

Constructs a new instance of this class with its stack trace filled in. The error code is set to an unspecified value.

public
SWTException(String
the detail message for the exception
message
)

Constructs a new instance of this class with its stack trace and message filled in. The error code is set to an unspecified value.

public
SWTException(int
the SWT error code
code
)

Constructs a new instance of this class with its stack trace and error code filled in.

public
SWTException(int
the SWT error code
code
,
String
the detail message for the exception
message
)

Constructs a new instance of this class with its stack trace, error code and message filled in. Specifying null as the message is equivalent to specifying an empty string.

Method Summary

Modifier and TypeMethod and Description
public Throwable

Returns:

the underlying throwable
getCause
()

Overrides java.lang.Throwable.getCause.

Returns the underlying throwable that caused the problem, or null if this information is not available.
public String

Returns:

the error message string of this SWTException object
getMessage
()

Overrides java.lang.Throwable.getMessage.

Returns the string describing this SWTException object.
public void
printStackTrace()

Overrides java.lang.Throwable.printStackTrace.

Outputs a printable representation of this exception's stack trace on the standard error stream.

Field Detail

codeback to summary
public int code

The SWT error code, one of SWT.ERROR_*.

serialVersionUIDback to summary
pack-priv static final long serialVersionUID

Hides java.lang.RuntimeException.serialVersionUID.

throwableback to summary
public Throwable throwable

The underlying throwable that caused the problem, or null if this information is not available.

Constructor Detail

SWTExceptionback to summary
public SWTException()

Constructs a new instance of this class with its stack trace filled in. The error code is set to an unspecified value.

SWTExceptionback to summary
public SWTException(String message)

Constructs a new instance of this class with its stack trace and message filled in. The error code is set to an unspecified value. Specifying null as the message is equivalent to specifying an empty string.

Parameters
message:String

the detail message for the exception

SWTExceptionback to summary
public SWTException(int code)

Constructs a new instance of this class with its stack trace and error code filled in.

Parameters
code:int

the SWT error code

SWTExceptionback to summary
public SWTException(int code, String message)

Constructs a new instance of this class with its stack trace, error code and message filled in. Specifying null as the message is equivalent to specifying an empty string.

Parameters
code:int

the SWT error code

message:String

the detail message for the exception

Method Detail

getCauseback to summary
public Throwable getCause()

Overrides java.lang.Throwable.getCause.

Returns the underlying throwable that caused the problem, or null if this information is not available.

Note

This method overrides Throwable.getCause() that was added to JDK1.4. It is necessary to override this method in order for inherited printStackTrace() methods to work.

Returns:Throwable

the underlying throwable

Annotations
@Override
Since
3.1
getMessageback to summary
public String getMessage()

Overrides java.lang.Throwable.getMessage.

Returns the string describing this SWTException object.

It is combined with the message string of the Throwable which caused this SWTException (if this information is available).

Returns:String

the error message string of this SWTException object

Annotations
@Override
printStackTraceback to summary
public void printStackTrace()

Overrides java.lang.Throwable.printStackTrace.

Outputs a printable representation of this exception's stack trace on the standard error stream.

Note

printStackTrace(PrintStream) and printStackTrace(PrintWriter) are not provided in order to maintain compatibility with CLDC.

Annotations
@Override