QMetaObject::invokeMethod的用法

一、QMetaObject::invokeMethod的用法

“QMetaObject::invokeMethod”是Qt中的一个功能强大的函数，允许你以反射的方式在运作时调用对象的方法。这在需要跨线程执行方法或在不直接访问对象方法的情况下非常有用。它是基于Qt元对象系统的，可以用来调用任何被"Q_OBJECT"宏修饰的类的成员方法。
以下是“QMetaObject::invokeMethod”的基本用法：

bool QMetaObject::invokeMethod(QObject *object,
                              const char *method,
                              Qt::ConnectionType type,
                              QGenericReturnArgument ret,
                              QGenericArgument val0 = QGenericArgument(nullptr),
                              QGenericArgument val1 = QGenericArgument(),
                              ... /* 更多参数 */);

• “object”：要调用方法的对象。
• “method”:要调用的方法名，必须是该对象的成员方法。
• “type”：调用类型，比如“Qt::DirectConnection”（当前线程直接调用）或“Qt::QueuedConnection”（在对象所在的线程中排队调用）。
• “ret”：用于接收返回值的“QGenericReturnArgument”，如果方法没有返回值，这个参数可以省略。
• “val0”，“val1”，…方法的参数，使用“Q_ARG”宏来指定。
  示例一：跨线程调用方法
  假设你有一个对象“worker”，其在另一个线程中，你想从主线程安全地调用它的一个方法“doWork”：

QMetaObject::invokeMethod(worker,"doWork",Qt::QueuedConnection);
class Worker : public QObject {
    Q_OBJECT
public slots:
    void doWork() {
        // 工作代码
    }
};

Worker *worker = new Worker; // 假设这个worker对象运行在另一个线程

// 在主线程中安全调用worker的doWork方法
QMetaObject::invokeMethod(worker, "doWork", Qt::QueuedConnection);

这个调用会将“doWork”方法的执行安排到“worker”所在的线程的事件循环中。
示例二：带参数的方法调用
如果要调用的方法有参数，你可以使用“Q_ARG”宏来传递它们：

class Worker : public QObject {
    Q_OBJECT
public slots:
    void doWorkWithParam(int value) {
        // 使用value参数的工作代码
    }
    void doWorkWithParam2(int value1,QString value2){
        qDebug()<<"doWork in  thread:"<<QThread::currentThreadId();
        qDebug()<<"Received values:"<<value1<<","<<value2;
        //实际的工作代码...
        emit workFinished();
    }
signals:
    void workFinished();
};

// ...

int someValue = 42;
QMetaObject::invokeMethod(worker, "doWorkWithParam", Qt::QueuedConnection,
                          Q_ARG(int, someValue));
QMetaObject::invokeMethod(worker,"doWorkWithParam2",Qt::AutoConnection,Q_ARG(int,42),Q_ARG(QString,"Hello,World!"));

注意事项：

• 方法名称必须准确无误，包括大小写。
• “QMetaObject::invokeMethod”返回一个“bool”值，表明方法是否成功调用。这不代表方法执行的成功与否，而只是调用是否成功发起。
• 使用这种方法调用时，编译器不会对方法名或参数类型进行检查，因此需要特别注意确保正确性。
• 如果在跨线程调用中使用“Qt::DirectConnection”,可能会出现线程安全问题。确保根据情况选择适当的“Qt::ConnectionType”。
  “QMetaObject::invokeMethod”是一个非常强大的工具，但由于其运行时特性，建议谨慎使用，并在使用情况下优先使用更常规的信号和槽机制。
• 当你使用 QMetaObject::invokeMethod 方法调用一个方法时，如果没有明确指定连接类型（ConnectionType），它将默认使用 Qt::AutoConnection，这意味着 Qt 将根据以下规则选择连接类型：如果调用者
  接收者在同一线程，则使用 Qt::DirectConnection。这意味着被调用的方法将在调用 invokeMethod 的线程中直接执行。如果调用者和接收者在不同线程，则使用 Qt::QueuedConnection。这意味着被调用的方法将被添加到接收者线程的事件队列中，稍后由接收者线程处理。这个自动选择连接类型的机制使得 invokeMethod 更加灵活，因为它可以适应不同的线程关系。然而，在使用 Qt::AutoConnection 时，需要确保被调用的方法是线程安全的，因为它可能在调用者线程或接收者线程中执行