QMetaMethod Class

成员函数文档

QMetaMethod::Access QMetaMethod::access() const

返回此方法的访问修饰符（private、protected 或 public）。

另请参阅 methodType()。

[static] template <typename PointerToMemberFunction> QMetaMethod QMetaMethod::fromSignal(PointerToMemberFunction signal)

返回与给定的signal 相对应的元方法；如果signal 的值是nullptr ，或者该信号不属于该类，则返回无效的QMetaMethod 。

示例：

QMetaMethod destroyedSignal = QMetaMethod::fromSignal(&QObject::destroyed);

在对象object 上调用此方法。如果成员方法能够被调用，则返回true ；如果不存在该成员方法或参数不匹配，则返回false 。

对于带有 QTemplatedMetaMethodReturnArgument 参数的重载，member 函数调用的返回值将被赋值给ret 。对于没有此类成员的重载，被调用函数的返回值（如有）将被丢弃。 QTemplatedMetaMethodReturnArgument 是一个内部类型，不应直接使用。应改用 qReturnArg() 函数。

带有 `Qt::ConnectionType `type 参数的重载允许显式选择调用是否为同步：

• 若type 为Qt::DirectConnection ，则该成员将立即在当前线程中被调用。
• 如果type 为Qt::QueuedConnection ，则会发送一个QEvent ，并在应用程序进入obj 被创建或移动到的线程中的事件循环时立即调用该成员。
• 如果type 为Qt::BlockingQueuedConnection ，则该方法的调用方式与Qt::QueuedConnection 相同，不同之处在于当前线程将阻塞直至事件被传递。使用此连接类型在同一线程内的对象之间进行通信将导致死锁。
• 如果 `type ` 为 `Qt::AutoConnection`，且 `obj ` 与调用者位于同一线程中，则该成员函数将以同步方式被调用；否则将以异步方式调用。这是未包含 `type ` 参数的重载行为。

要异步调用QPushButton 上的animateClick() 槽函数：

int methodIndex = pushButton->metaObject()->indexOfMethod("animateClick()");
QMetaMethod method = metaObject->method(methodIndex);
method.invoke(pushButton, Qt::QueuedConnection);

在异步方法调用中，参数必须是可复制类型，因为 Qt 需要在后台将参数复制并存储到事件中。 自 Qt 6.5 起，该函数会自动注册所使用的类型；但作为副作用，无法使用仅被前向声明的类型进行调用。此外，也无法进行使用指向未带 const 修饰符的类型的引用作为参数的异步调用。

若要对某个任意对象obj 同步调用compute(QString, int, double) 槽函数并获取其返回值，请按以下方式操作：

QString retVal;
QByteArray normalizedSignature = QMetaObject::normalizedSignature("compute(QString, int, double)");
int methodIndex = obj->metaObject()->indexOfMethod(normalizedSignature);
QMetaMethod method = obj->metaObject()->method(methodIndex);
method.invoke(obj, Qt::DirectConnection, qReturnArg(retVal),
              QString("sqrt"), 42, 9.7);

如果“compute”槽方法接收的参数并非恰好按指定顺序包含一个QString 、一个int 和一个double ，则调用将失败。 请注意，必须显式指定QString 的类型，因为字符字面量并非完全匹配的正确类型。如果该方法接受的参数分别是QByteArray 、qint64 和long double ，则调用应写为：

QString retVal;
QByteArray normalizedSignature = QMetaObject::normalizedSignature("compute(QByteArray, qint64, long double)");
int methodIndex = obj->metaObject()->indexOfMethod(normalizedSignature);
QMetaMethod method = obj->metaObject()->method(methodIndex);
method.invoke(obj, Qt::DirectConnection, qReturnArg(retVal),
              QByteArray("sqrt"), qint64(42), 9.7L);

也可以使用Q_ARG() 和Q_RETURN_ARG() 宏来执行相同的调用，如下所示：

QString retVal;
QByteArray normalizedSignature = QMetaObject::normalizedSignature("compute(QString, int, double)");
int methodIndex = obj->metaObject()->indexOfMethod(normalizedSignature);
QMetaMethod method = obj->metaObject()->method(methodIndex);
method.invoke(obj,
              Qt::DirectConnection,
              Q_RETURN_ARG(QString, retVal),
              Q_ARG(QString, "sqrt"),
              Q_ARG(int, 42),
              Q_ARG(double, 9.7));

这些函数在 Qt 6.5 中引入。

另请参阅 Q_ARG()、Q_RETURN_ARG()、qRegisterMetaType()，以及QMetaObject::invokeMethod()。

在Q_GADGET 上调用此方法。如果能成功调用该成员，则返回true ；如果不存在该成员或参数不匹配，则返回false 。

指针gadget 必须指向 gadget 类的实例。

调用始终是同步的。

对于带 QTemplatedMetaMethodReturnArgument 参数的重载，member 函数调用的返回值将被存入ret 中。对于不带该参数的重载，被调用函数的返回值（如有）将被丢弃。 QTemplatedMetaMethodReturnArgument 是一种内部类型，不应直接使用。应改用 qReturnArg() 函数。

这些函数在 Qt 6.5 中引入。

另请参阅 Q_ARG()、Q_RETURN_ARG()、qRegisterMetaType() 以及QMetaObject::invokeMethod()。

[since 6.2] bool QMetaMethod::isConst() const

返回该方法是否带有 const 修饰符。

该函数在 Qt 6.2 中引入。

bool QMetaMethod::isValid() const

如果该方法有效（可被检查并调用），则返回true ；否则返回false 。

int QMetaMethod::methodIndex() const

返回此方法的索引。

QByteArray QMetaMethod::methodSignature() const

返回该方法的签名（例如，setValue(double) ）。

另请参阅 parameterTypes() 和parameterNames()。

QMetaMethod::MethodType QMetaMethod::methodType() const

返回此方法的类型（信号、插槽或方法）。

另请参阅 access()。

QByteArray QMetaMethod::name() const

返回此方法的名称。

另请参阅 methodSignature() 和parameterCount()。

[since 6.9] QByteArrayView QMetaMethod::nameView() const

返回此方法的名称。只要该方法所属类的元对象有效，返回的QByteArrayView 对象就有效。

该函数在 Qt 6.9 中引入。

另请参阅 name 。

int QMetaMethod::parameterCount() const

返回此方法的参数个数。

另请参阅 parameterType() 和parameterNames()。

[since 6.0] QMetaType QMetaMethod::parameterMetaType(int index) const

返回位于指定index 处的参数的元类型。

如果index 小于零或大于parameterCount()，则返回一个无效的QMetaType 。

该函数在 Qt 6.0 中引入。

另请参阅 parameterCount()、returnMetaType() 和QMetaType 。

QList<QByteArray> QMetaMethod::parameterNames() const

返回一个参数名称列表。

另请参阅 parameterTypes() 和methodSignature()。

int QMetaMethod::parameterType(int index) const

返回给定index 中的参数类型。

返回值是已向QMetaType 注册的类型之一；若该类型未注册，则返回QMetaType::UnknownType 。

另请参阅 parameterCount()、parameterMetaType()、returnType() 以及QMetaType 。

[since 6.0] QByteArray QMetaMethod::parameterTypeName(int index) const

返回位置为index 处的类型名称。如果位置为index 处没有参数，则返回一个空QByteArray

该函数自 Qt 6.0 起引入。

另请参阅 parameterNames()。

QList<QByteArray> QMetaMethod::parameterTypes() const

返回一个参数类型的列表。

另请参阅 parameterNames() 和methodSignature()。

[since 6.0] int QMetaMethod::relativeMethodIndex() const

返回该方法内部的局部索引。

该函数在 Qt 6.0 中引入。

[since 6.0] QMetaType QMetaMethod::returnMetaType() const

返回此方法的返回类型。

该函数在 Qt 6.0 中引入。

另请参阅 parameterMetaType()、QMetaType 以及typeName()。

int QMetaMethod::returnType() const

返回此方法的返回类型。

返回值是已通过QMetaType 注册的类型之一；如果该类型未注册，则返回值为QMetaType::UnknownType 。

另请参阅 parameterType()、QMetaType 、typeName() 以及returnMetaType()。

int QMetaMethod::revision() const

如果通过Q_REVISION 指定了方法修订版本，则返回该修订版本；否则返回0。自Qt 6.0起，非零值会被编码，并可通过QTypeRevision::fromEncodedVersion()进行解码。

const char *QMetaMethod::tag() const

返回与该方法关联的标签。

标签是moc 所识别的特殊宏，可用于为方法添加额外信息。

可以在函数声明中通过以下方式添加标签信息：

    // In the class MainWindow declaration
    #ifndef Q_MOC_RUN
    // define the tag text as empty, so the compiler doesn't see it
    #  define MY_CUSTOM_TAG
    #endif
    //...
    private slots:
        MY_CUSTOM_TAG void testFunc();

并可通过以下方式访问这些信息：

    MainWindow win;
    win.show();

    intfunctionIndex=win.metaObject()->indexOfSlot("testFunc()");
    QMetaMethod mm=win.metaObject()->method(functionIndex);
    qDebug() << mm.tag(); // prints MY_CUSTOM_TAG

目前，moc 会提取并记录所有标签，但不会对任何标签进行特殊处理。您可以使用这些标签以不同方式对方法进行标注，并根据应用程序的具体需求进行处理。

const char *QMetaMethod::typeName() const

返回此方法的返回类型名称。如果此方法是构造函数，则该函数返回一个空字符串（构造函数没有返回类型）。

另请参阅 returnType() 和QMetaType::name()。