The QMetaMethod 類提供有關成員函數的元數據。 更多...
| 頭： | #include <QMetaMethod> |
| enum | Access { Private, Protected, Public } |
| enum | MethodType { Method, Signal, Slot, Constructor } |
| Access | access () const |
| bool | invoke (QObject * object , Qt::ConnectionType connectionType , QGenericReturnArgument returnValue , QGenericArgument val0 = QGenericArgument( 0 ), QGenericArgument val1 = QGenericArgument(), QGenericArgument val2 = QGenericArgument(), QGenericArgument val3 = QGenericArgument(), QGenericArgument val4 = QGenericArgument(), QGenericArgument val5 = QGenericArgument(), QGenericArgument val6 = QGenericArgument(), QGenericArgument val7 = QGenericArgument(), QGenericArgument val8 = QGenericArgument(), QGenericArgument val9 = QGenericArgument()) const |
| bool | invoke (QObject * object , QGenericReturnArgument returnValue , QGenericArgument val0 = QGenericArgument( 0 ), QGenericArgument val1 = QGenericArgument(), QGenericArgument val2 = QGenericArgument(), QGenericArgument val3 = QGenericArgument(), QGenericArgument val4 = QGenericArgument(), QGenericArgument val5 = QGenericArgument(), QGenericArgument val6 = QGenericArgument(), QGenericArgument val7 = QGenericArgument(), QGenericArgument val8 = QGenericArgument(), QGenericArgument val9 = QGenericArgument()) const |
| bool | invoke (QObject * object , Qt::ConnectionType connectionType , QGenericArgument val0 = QGenericArgument( 0 ), QGenericArgument val1 = QGenericArgument(), QGenericArgument val2 = QGenericArgument(), QGenericArgument val3 = QGenericArgument(), QGenericArgument val4 = QGenericArgument(), QGenericArgument val5 = QGenericArgument(), QGenericArgument val6 = QGenericArgument(), QGenericArgument val7 = QGenericArgument(), QGenericArgument val8 = QGenericArgument(), QGenericArgument val9 = QGenericArgument()) const |
| bool | invoke (QObject * object , QGenericArgument val0 = QGenericArgument( 0 ), QGenericArgument val1 = QGenericArgument(), QGenericArgument val2 = QGenericArgument(), QGenericArgument val3 = QGenericArgument(), QGenericArgument val4 = QGenericArgument(), QGenericArgument val5 = QGenericArgument(), QGenericArgument val6 = QGenericArgument(), QGenericArgument val7 = QGenericArgument(), QGenericArgument val8 = QGenericArgument(), QGenericArgument val9 = QGenericArgument()) const |
| int | methodIndex () const |
| MethodType | methodType () const |
| QList<QByteArray> | parameterNames () const |
| QList<QByteArray> | parameterTypes () const |
| const char * | signature () const |
| const char * | tag () const |
| const char * | typeName () const |
The QMetaMethod 類提供有關成員函數的元數據。
A QMetaMethod 擁有 methodType ()， signature (), 列錶化的 parameterTypes () 和 parameterNames (), a return typeName ()， tag (), and an access () specifier. You can use invoke () to invoke the method on an arbitrary QObject .
A method will only be registered with the meta-object system if it is a slot, a signal, or declared with the Q_INVOKABLE macro. Constructors can also be registered with Q_INVOKABLE .
另請參閱 QMetaObject , QMetaEnum , QMetaProperty ，和 Qt 的特性係統 .
This enum describes the access level of a method, following the conventions used in C++.
| 常量 | 值 |
|---|---|
QMetaMethod::Private
|
0
|
QMetaMethod::Protected
|
1
|
QMetaMethod::Public
|
2
|
| 常量 | 值 | 描述 |
|---|---|---|
QMetaMethod::Method
|
0
|
函數是純成員函數。 |
QMetaMethod::Signal
|
1
|
函數是信號。 |
QMetaMethod::Slot
|
2
|
函數是槽。 |
QMetaMethod::Constructor
|
3
|
函數是構造函數。 |
Returns the access specification of this method (private, protected, or public).
Signals are always protected, meaning that you can only emit them from the class or from a subclass.
另請參閱 methodType ().
Invokes this method on the object object . Returns true if the member could be invoked. Returns false if there is no such member or the parameters did not match.
The invocation can be either synchronous or asynchronous, depending on the connectionType :
The return value of this method call is placed in returnValue . If the invocation is asynchronous, the return value cannot be evaluated. You can pass up to ten arguments ( val0 , val1 , val2 , val3 , val4 , val5 , val6 , val7 , val8 ，和 val9 ) to this method call.
QGenericArgument and QGenericReturnArgument are internal helper classes. Because signals and slots can be dynamically invoked, you must enclose the arguments using the Q_ARG () 和 Q_RETURN_ARG () 宏。 Q_ARG () takes a type name and a const reference of that type; Q_RETURN_ARG () takes a type name and a non-const reference.
To asynchronously invoke the animateClick() slot on a QPushButton :
int methodIndex = pushButton->metaObject()->indexOfMethod("animateClick()"); QMetaMethod method = metaObject->method(methodIndex); method.invoke(pushButton, Qt::QueuedConnection);
With asynchronous method invocations, the parameters must be of types that are known to Qt's meta-object system, because Qt needs to copy the arguments to store them in an event behind the scenes. If you try to use a queued connection and get the error message
QMetaMethod::invoke: Unable to handle unregistered datatype 'MyType'
call qRegisterMetaType () to register the data type before you call QMetaMethod::invoke().
要同步援引
compute(QString, int, double)
槽在某些任意對象
obj
檢索其返迴值：
QString retVal; QByteArray normalizedSignature = QMetaObject::normalizedSignature("compute(QString, int, double)"); int methodIndex = obj->metaObject()->indexOfMethod(normalizedSignature); QMetaMethod method = 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));
QMetaObject::normalizedSignature () is used here to ensure that the format of the signature is what invoke() expects. E.g. extra whitespace is removed.
若 compute 槽不接受 1 個準確 QString , one int and one double in the specified order, the call will fail.
警告： this method will not test the validity of the arguments: object must be an instance of the class of the QMetaObject of which this QMetaMethod has been constructed with. The arguments must have the same type as the ones expected by the method, else, the behaviour is undefined.
另請參閱 Q_ARG (), Q_RETURN_ARG (), qRegisterMetaType ()，和 QMetaObject::invokeMethod ().
此函數重載 invoke ().
This overload always invokes this method using the connection type Qt::AutoConnection .
此函數重載 invoke ().
此重載可以被使用，若對成員的返迴值不感興趣。
此函數重載 invoke ().
This overload invokes this method using the connection type Qt::AutoConnection 並忽略返迴值。
返迴此方法的索引。
該函數在 Qt 4.6 引入。
返迴此方法 (信號、槽或方法) 的類型。
另請參閱 access ().
返迴參數名稱的列錶。
另請參閱 parameterTypes () 和 signature ().
Returns a list of parameter types.
另請參閱 parameterNames () 和 signature ().
返迴此方法的簽名 (如
setValue(double)
).
另請參閱 parameterTypes () 和 parameterNames ().
Returns the tag associated with this method.
Tags are special macros recognized by
moc
that make it possible to add extra information about a method.
Tag information can be added in the following way in the function declaration:
#define THISISTESTTAG // tag text ... private slots: THISISTESTTAG void testFunc();
and the information can be accessed by using:
MainWindow win; win.show(); int functionIndex = win.metaObject()->indexOfSlot("testFunc()"); QMetaMethod mm = metaObject()->method(functionIndex); qDebug() << mm.tag(); // prints THISISTESTTAG
For the moment,
moc
doesn't support any special tags.
Returns the return type of this method, or an empty string if the return type is void .
