属性

返回值

函数体

功能

static

QThread *

QThread::currentThread()

返回当前线程的指针，静态函数。

static

Qt::HANDLE

QThread::currentThreadId()

返回当前线程的句柄，静态函数

static

bool

QThread::isFinished() const

如果线程执行结束，返回true，否则返回false

static

bool

QThread::isRunning() const

如果当前线程在运行中，返回true，否则返回false

static

int

QThread::idealThreadCount()

返回理理想状态下该系统支持的线程的数量。如果无发现检测到处理器的核数，返回值为-1

protected

int

exec()

使线程进入事件循环状态，并且处于wait状态，直到调用exit()函数使其退出。退出时返回值是调用exit()函数时的输入参数。如果调用quit()函数，其退出的返回值为0.该函数一般在run()函数中调用，使线程进入事件循环处理状态。

protected

void

exit(int returnCode = 0)

告知线程从事件循环状态退出，并且返回returnCode的值。一般说来，返回0表示成功退出，返回非0值表示遇到错误。调用该函数后，线程不会再进行事件处理，除非再次调用exec()函数。如果当前线程不处于执行状态，那么下次调用exec()也会直接返回

private signal

void

finished()

在线程执行完毕前发出该信号，当发出该信号时，意味着线程早已经退出了事件循环处理状态，即不再处理除了延迟删除事件(deferred deletion)之外的任何事件。可以把该信号和QObject::deleteLater()连接起来用来删除线程中的对象。如果强制使用terminate()函数来结束线程，那么将无法得知finish()信号的发送线程。另外，这是一个私有信号，所以用户无法发出这个信号。

static

bool

QThread::isInterruptionRequested() const

返回当前线程上运行的任务是否可以停止，可以通过requestInterruption()来进行中断查询。该函数可以使得长时间运行的任务彻底停止，永远不要检查该函数的返回值是否是安全的。但是进行长时间任务时提倡有规律的使用该方法。但是不要频繁使用该方法避免线程切换的开销。

static

bool

QThread::isRunning() const

返回当前线程是否正在运行，如果在运行，返回true，否则返回false

static

int

QThread::loopLevel() const

该函数返回当前事件循环的层级，但是该函数只能在线程内部调用。

static

void

QThread::msleep(unsigned long msecs)

强制线程休息msecs毫秒

static

void

QThread::usleep(unsigned long usecs)

强制线程休息usecs微秒

static

void

QThread::sleep(unsigned long secs)

强制线程休息secs秒

virtual protected

void

QThread::run()

该函数是线程运行的起始点。调用start()函数之后，新创建的函数调用该函数，默认的QThread简单的调用exec()进入事件循环机制。我们可以重载这个函数来实现更高级的线程管理方式。从该函数返回将结束线程。

static

void

QThread::setPriority(Priority priority)

该函数设置线程运行的优先级，如果线程并没有处于运行状态，该函数什么也不做。可以通过调用start()来指定一个优先级来启动线程。优先级的效果依赖于操作系统的调度方式，尤其是在不支持优先级的操作系统上，优先级设置会被忽略。

slot

void

QThread::quit()

告诉线程的事件循环退出并且返回0值，相当于调用QThread::exit(0)。如果线程没有事件循环，这个函数则什么也不做。

virtual protected

void

QThread::setStackSize(uint stackSize)

设置线程堆栈的最大值，如果设置的值大于0，那么就会将堆栈最大值设置为当前数值。否则，线程堆栈的最大值由操作系统来决定。警告：大部分操作系统都会自己设置线程堆栈的最大最小值，如果设置的堆栈大小超出范围，线程则不能启动。

static protected

void

QThread::setTerminationEnabled(bool enabled = true)

slot

void

QThread::start(Priority priority = InheritPriority)

通过调用run()函数启动线程。操作系统会根据优先级来调度线程。如果线程已经处于运行状态，该函数什么也不做。优先级设置依赖于操作系统的线程调度方式。

signal

void

QThread::started()

线程开始执行时发出该信号，发出时间在run()函数调用之前。注意：这是一个私有信号，因此只能由线程发出，用户不能发出该信号。

slot

void

QThread::terminate()

终止当前线程。线程或许不会立即被终止，依赖于线程的调度策略。一般情况下，调用该函数之后再调用QThread::wait()来确保线程结束。该线程终止后，等待该线程的其他线程将被唤醒。警告：该函数比较危险，不推荐这样做。线程可能在任何代码处终止。或许在修改数据时被终止，线程结束后自己不能去做清理工作。

static

bool

QThread::wait(unsigned long time = ULONG_MAX)

阻塞当前的进程，直到满足如下两个条件之一： 1.相关的线程完成其任务，然后如果线程已经结束，则该函数返回true，如果线程没有启动，则该函数也会返回true。 2. 经过了特定长度的时间，如果时间是ULONG_MAX（默认值），那么wait()函数几乎不会超时。（即该函数必须从run()函数返回）如果wait函数超时，那么该函数会返回false。

static

void

QThread::yieldCurrentThread()

将当前线程的执行权让给别的可执行线程。至于让给哪一个可执行线程，那就是操作系统的事情了。