[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] Reference for unit 'Classes' (#rtl)

WakeMainThread

Handler which is called if a thread wants to synchronize with the main application thread.

Declaration

Source position: classesh.inc line 2188

var WakeMainThread: TNotifyEvent = Nil;

Description

WakeMainThread is a handler, which, when set, is called by the TThread.Synchronize routine to signal the main thread that a synchronization routine is waiting in the queue.

This handler is by default empty. An actual implementation depends on the main program logic (usually an event loop) and must be provided by the event loop logic: the event loop will normally call CheckSynchronize at regular intervals. The WakeMainThread can make sure this happens as soon as possible.

While this handle should alert the main program thread that a thread is waiting for synchronization, the call is executed by the thread, and should therefore NOT synchronize the thread, but should somehow signal the main thread that a thread is waiting for synchronization. For example, by sending a message.

See also

CheckSynchronize

  

Check whether there are any synchronize calls in the synchronize queue.

TThread.Synchronize

  

Synchronizes the thread by executing the method in the main thread.


Documentation generated on: May 14 2021