org.eclipse.swt.widgets

Class Synchronizer

java.lang.Object

org.eclipse.swt.widgets.Synchronizer

public class Synchronizer
extends java.lang.Object

Instances of this class provide synchronization support for displays. A default instance is created automatically for each display, and this instance is sufficient for almost all applications.

IMPORTANT: Typical application code never needs to deal with this class. It is provided only to allow applications which require non-standard synchronization behavior to plug in the support they require. Subclasses which override the methods in this class must ensure that the superclass methods are invoked in their implementations

See Also:

Display.setSynchronizer(org.eclipse.swt.widgets.Synchronizer), Sample code and further information

Structure Diagram

Field Summary

Fields

Modifier and Type	Field and Description
(package private) Display	display
(package private) static int	GROW_SIZE
(package private) static boolean	IS_CARBON
(package private) static boolean	IS_COCOA
(package private) static boolean	IS_GTK
(package private) static int	MESSAGE_LIMIT
(package private) int	messageCount
(package private) java.lang.Object	messageLock
(package private) RunnableLock[]	messages
(package private) java.lang.Thread	syncThread

Constructor Summary

Constructors

Constructor and Description
Synchronizer(Display display) Constructs a new instance of this class.

Method Summary

Methods

Modifier and Type	Method and Description
(package private) void	addLast(RunnableLock lock)
protected void	asyncExec(java.lang.Runnable runnable) Causes the run() method of the runnable to be invoked by the user-interface thread at the next reasonable opportunity.
(package private) int	getMessageCount()
(package private) void	releaseSynchronizer()
(package private) RunnableLock	removeFirst()
(package private) boolean	runAsyncMessages()
(package private) boolean	runAsyncMessages(boolean all)
protected void	syncExec(java.lang.Runnable runnable) Causes the run() method of the runnable to be invoked by the user-interface thread at the next reasonable opportunity.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

display

Display display

messageCount

int messageCount

messages

RunnableLock[] messages

messageLock

java.lang.Object messageLock

syncThread

java.lang.Thread syncThread

GROW_SIZE

static final int GROW_SIZE

See Also:

Constant Field Values

MESSAGE_LIMIT

static final int MESSAGE_LIMIT

See Also:

Constant Field Values

IS_CARBON

static final boolean IS_CARBON

IS_COCOA

static final boolean IS_COCOA

IS_GTK

static final boolean IS_GTK

Constructor Detail

Synchronizer

public Synchronizer(Display display)

Constructs a new instance of this class.

Parameters:

display - the display to create the synchronizer on

Method Detail

addLast

void addLast(RunnableLock lock)

asyncExec

protected void asyncExec(java.lang.Runnable runnable)

Causes the run() method of the runnable to be invoked by the user-interface thread at the next reasonable opportunity. The caller of this method continues to run in parallel, and is not notified when the runnable has completed.

Parameters:

runnable - code to run on the user-interface thread.

See Also:

syncExec(java.lang.Runnable)

getMessageCount

int getMessageCount()

releaseSynchronizer

void releaseSynchronizer()

removeFirst

RunnableLock removeFirst()

runAsyncMessages

boolean runAsyncMessages()

runAsyncMessages

boolean runAsyncMessages(boolean all)

syncExec

protected void syncExec(java.lang.Runnable runnable)

Causes the run() method of the runnable to be invoked by the user-interface thread at the next reasonable opportunity. The thread which calls this method is suspended until the runnable completes.

Parameters:

runnable - code to run on the user-interface thread.

Throws:

SWTException -

• ERROR_FAILED_EXEC - if an exception occurred when executing the runnable

See Also:

asyncExec(java.lang.Runnable)