TThread::NameThreadForDebugging - C++ Builder

C++ Builder 参考手册 ➙ TThread ➙ NameThreadForDebugging

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

static void __fastcall NameThreadForDebugging(
    System::AnsiString AThreadName, 
    unsigned AThreadID = 0xffffffff);

static void __fastcall NameThreadForDebugging(
    System::UnicodeString AThreadName, 
    unsigned AThreadID = 0xffffffff);

NameThreadForDebugging 是 TThread 的成员函数，给线程起个名字，只用来调试程序。

参数：

AThreadName：给线程起的名字；
AThreadID：给这个 ThreadID 的线程起名，如果等于 0xffffffff (默认值) 为当前线程。

返回值：

无。

给线程起个名字，只用来调试程序，如果不是调试方式运行的程序，这个函数什么也不执行。

例：

class TTestThread : public System::Classes::TThread
{
public:
    __fastcall TTestThread();
protected:
    void __fastcall Execute(void);
};

__fastcall TTestThread::TTestThread()
    : System::Classes::TThread(true)
{
    FreeOnTerminate = true;
}

void __fastcall TTestThread::Execute(void)
{
    for(int i=0; i<10; i++)
    {
        Sleep(200);
    }
}

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    TTestThread *lpThread = new TTestThread;
    TThread::NameThreadForDebugging(UnicodeString(L"测试线程--玄坴"),lpThread->ThreadID);
    lpThread->Start();
}

运行时打开调试线程页面：
选择菜单 View -> Debug Windows -> Threads 在调试界面底部出现线程列表，点击按钮 Button1 启动线程，可以看到在线程列表里面 Thread Id 栏显示了线程的名字：

调试程序的线程列表里面可以看到线程的名字

参考：

C++ Builder 参考手册 ➙ TThread ➙ NameThreadForDebugging