TThread::Queue - C++ Builder

C++ Builder 参考手册 ➙ System::Classes ➙ TThreadQueue


头文件:#include <System.Classes.hpp>
命名空间:System::Classes
类:TThread
访问权限:public: / protected:
函数原型:

public:
    static void __fastcall Queue(TThread* const AThread, TThreadMethod AMethod);
    static void __fastcall Queue(TThread* const AThread, _di_TThreadProcedure AThreadProc);
protected:
    void __fastcall Queue(TThreadMethod AMethod);
    void __fastcall Queue(_di_TThreadProcedure AThreadProc);

Queue 是 TThread 的成员函数,把一个函数加入异步执行队列。

参数:

AThread:要进行异步执行的函数所在的线程对象,如果不需要在主线程调用那里访问线程对象,这个参数可以为 NULL;
AMethod:需要在主线程异步执行的方法;
AThreadProc:需要在主线程异步执行的匿名函数。

返回值:

无。

  • Queue 把一个函数加入异步执行队列,这个函数将在主线程里面执行,但是不要在主线程里面调用 Queue。
  • ForceQueue 把一个函数加入异步执行队列,可以在主线程里面调用这个方法;
  • Queue 和 ForceQueue 不等待放入队列的函数的执行,函数放入执行队列之后立即返回,继续执行线程的其他代码,如果要让一个函数在主线程里面执行,并且等待这个函数执行完成,需要用 Synchronize 方法;
  • AThreadProc 参数在 C++ 里面需要继承 TCppInterfacedObject<TThreadProcedure> 并且重载 Invoke 方法,把 new 出来的对象传递给 AThreadProc 参数,这个 Invoke 方法就是异步执行的函数,这个对象在异步执行函数结束之后自动销毁;
  • 线程结束时会取消异步执行队列的执行,如果还没等队列里面的函数执行时,线程已经结束了,就不会执行加入队列里面的函数,本文后面的例子也会说明这一点。

例1:使用 TThreadMethod AMethod 参数的 Queue 方法,即成员函数指针参数:

class TTestThread : public System::Classes::TThread
{
public:
    TTestThread()
    : System::Classes::TThread(true)
    {
        FreeOnTerminate = true;
    }
private:
    void __fastcall Function1(void)
    {
        UnicodeString s;
        DWORD dwThreadID = ::GetCurrentThreadId();
        ShowMessage(s.sprintf(L"Queued Function1, ThreadID=%ld", dwThreadID));
    }
    void __fastcall Function2(void)
    {
        UnicodeString s;
        DWORD dwThreadID = ::GetCurrentThreadId();
        ShowMessage(s.sprintf(L"Synchronized Function2, ThreadID=%ld", dwThreadID));
    }
protected:
    void __fastcall Execute(void)
    {
        Queue(Function1);
        Synchronize(Function2);
    }
};
//---------------------------------------------------------------------------
void __fastcall TForm1::Button1Click(TObject *Sender)
{
    UnicodeString s;
    DWORD dwThreadID = ::GetCurrentThreadId();
    ShowMessage(s.sprintf(L"Main thread: ThreadID=%ld", dwThreadID));
    (new TTestThread)->Start();
}

运行结果:

  • 通过运行结果可以看到,在 Button1 里面获取的主线程ID、Queue 调用的 Function1 里面,Synchronize 调用的 Function2 里面的线程ID都是相同的,说明 Function1 和 Function2 都运行在主线程里面;
  • 如果去掉 TTestThread::Execute 里面的 Synchronize(Function2); 会发现 Function1 也没有被执行,原因是还没等 Function1 执行,线程已经结束了,线程结束时会取消异步队列的执行。如果把 Synchronize 那个位置换成一个延时,Function1 也会执行,只要 Function1 执行之前线程没有结束就可以。
运行结果:在按钮点击事件里面的线程ID
运行结果:在 Queue 调用的 Function1 里面的线程ID
运行结果:在 Synchronize 调用的 Function2 里面的线程ID

例2:使用 _di_TThreadProcedure AThreadProc 参数的 Queue 方法

class TQueuedFunc : public TCppInterfacedObject<TThreadProcedure>
{
public:
    void __fastcall Invoke(void)
    {
        UnicodeString s;
        DWORD dwThreadID = ::GetCurrentThreadId();
        ShowMessage(s.sprintf(L"TQueuedFunc::Invoke: ThreadID=%ld", dwThreadID));
    }
};

class TTestThread : public System::Classes::TThread
{
public:
    TTestThread()
    : System::Classes::TThread(true)
    {
        FreeOnTerminate = true;
    }
protected:
    void __fastcall Execute(void)
    {
        Queue(new TQueuedFunc);
        for(int i=0; i<100; i++)
        {
            Sleep(1);
        }
    }
};

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    UnicodeString s;
    DWORD dwThreadID = ::GetCurrentThreadId();
    ShowMessage(s.sprintf(L"Main thread: ThreadID=%ld", dwThreadID));
    (new TTestThread)->Start();
}

运行结果:

  • 通过运行结果可以看到,在 Button1 里面获取的主线程ID 和 Queue 调用的 TQueuedFunc::Invoke 里面的线程ID都是相同的,说明 TQueuedFunc::Invoke 运行在主线程里面;
  • 如果去掉 TTestThread::Execute 里面的循环延时,TQueuedFunc::Invoke 不会执行,new 出来的 TQueuedFunc 对象直接被销毁了,因为还没等执行 TQueuedFunc::Invoke 线程已经结束了,线程结束时会取消这个线程异步执行队列的执行。
运行结果:在按钮点击事件里面的线程ID
运行结果:在 Queue 调用的 TQueuedFunc::Invoke 里面的线程ID

相关:


C++ Builder 参考手册 ➙ System::Classes ➙ TThreadQueue

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,445评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,889评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,047评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,760评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,745评论 5 367
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,638评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,011评论 3 398
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,669评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,923评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,655评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,740评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,406评论 4 320
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,995评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,961评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,197评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,023评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,483评论 2 342