Threading modes

NOTE Single-thread mode is incompatible with AWT/Swing Dialogs. If you use single-thread mode, you cannot use AWT Dialogs, Swing JDialogs, or modal JInternalFrames in your application. There are also some other limitations. See the class IlvEventThreadUtil for a precise description of the limitations.

The SWT events are handled in the SWT event thread and AWT/Swing events are handled in the AWT/Swing event thread. This is the default mode.

You can switch between the two threads by using the SWT method Display.asyncExec() and the AWT method EventQueue.invokeLater().

If your application uses this mode, you must be careful to:

Make API calls on SWT widgets only in the SWT event thread. Otherwise, you will get SWTExceptions of type ERROR_THREAD_INVALID_ACCESS.

Make API calls on JComponents, which include IlvDiagrammer, IlvJScrollManagerView, and IlvJManagerViewPanel, only in the AWT/Swing event thread. Otherwise, you risk deadlocks.

At the JViews Framework level, make API calls on JComponents, which include IlvManager and IlvJManagerViewPanel, only in the AWT/Swing event thread. Otherwise, you risk deadlocks.

In single-thread mode, SWT and AWT/Swing events are handled in the same thread.

Single-thread mode reduces the risk of producing deadlocks.

Enable this mode by calling setAWTThreadRedirect or enableAWTThreadRedirect early during initialization.

The following example shows how to enable single-thread mode:

If you are using JComponents other than IlvDiagrammer, IlvJScrollManagerView, and IlvJManagerViewPanel in your application, your JComponents must use the method isDispatchThread rather than EventQueue.isDispatchThread() or SwingUtilities.isEventDispatchThread().

At the JViews Framework level, if you are using JComponents other than IlvManager and IlvJManagerViewPanel in your application, your JComponents must use the method isDispatchThread rather than EventQueue.isDispatchThread() (see http://java.sun.com/javase/7/docs/api/java/awt/EventQueue.html#isDispatchThread()) or SwingUtilities.isEventDispatchThread() (see http://java.sun.com/javase/7/docs/api/javax/swing/SwingUtilities.html#isEventDispatchThread().)