System.Classes.TThread.StaticQueue

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

class procedure StaticQueue(const AThread: TThread; AMethod: TThreadMethod); static; deprecated 'From C++ just use Queue now that it is just a static method';

C++

static void __fastcall StaticQueue _DEPRECATED_ATTRIBUTE1("From C++ just use Queue now that it is just a static method") (TThread* const AThread, TThreadMethod AMethod);

Properties

Type Visibility Source Unit Parent
procedure
function
public
System.Classes.pas
System.Classes.hpp
System.Classes TThread

Description

Warning: StaticQueue is deprecated. Please use Queue.

Asynchronously executes a method call within the main thread.

StaticQueue causes the call specified by AMethod to be executed using the main thread, thereby avoiding multi-thread conflicts. The current thread is passed in the AThread parameter.

If you are unsure whether a method call is thread-safe, call it from within the Synchronize or StaticQueue methods to ensure that it executes in the main thread.

Unlike Synchronize, execution of the current thread is allowed to continue. The main thread will eventually process all queued methods.

Warning: Do not call StaticQueue from within the main thread. This can cause an infinite loop.

Note: StaticQueue simply calls Queue with the same parameters.

Note: You can also protect unsafe methods using critical sections or the multi-read exclusive-write synchronizer.

See Also