The QMetaObject class contains meta-information about Qt objects. More...

#include <qobjectdefs.h>

Inheritance diagram for QMetaObject:

Collaboration diagram for QMetaObject:

Classes
struct	Data

struct	SuperData

Public Types
enum	Call { InvokeMetaMethod , ReadProperty , WriteProperty , ResetProperty , CreateInstance , IndexOfMethod , RegisterPropertyMetaType , RegisterMethodArgumentMetaType , BindableProperty }

typedef void Connection::	RestrictedBool

Public Member Functions
const char *	className () const

const QMetaObject *	superClass () const

bool	inherits (const QMetaObject *metaObject) const noexcept

QObject *	cast (QObject *obj) const

const QObject *	cast (const QObject *obj) const

QString	tr (const char s, const char c, int n=-1) const

QMetaType	metaType () const

int	methodOffset () const

int	enumeratorOffset () const

int	propertyOffset () const

int	classInfoOffset () const

int	constructorCount () const

int	methodCount () const

int	enumeratorCount () const

int	propertyCount () const

int	classInfoCount () const

int	indexOfConstructor (const char *constructor) const

int	indexOfMethod (const char *method) const

int	indexOfSignal (const char *signal) const

int	indexOfSlot (const char *slot) const

int	indexOfEnumerator (const char *name) const

int	indexOfProperty (const char *name) const

int	indexOfClassInfo (const char *name) const

QMetaMethod	constructor (int index) const

QMetaMethod	method (int index) const

QMetaEnum	enumerator (int index) const

QMetaProperty	property (int index) const

QMetaClassInfo	classInfo (int index) const

QMetaProperty	userProperty () const

QObject *	newInstance (QGenericArgument val0=QGenericArgument(nullptr), 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	static_metacall (Call, int, void **) const

	~Connection ()

	Connection ()

	Connection (const Connection &other)

Connection &	operator= (const Connection &other)

	operator RestrictedBool () const

	Connection (Connection &&other) noexcept

void	swap (Connection &other) noexcept

Static Public Member Functions
static bool	checkConnectArgs (const char signal, const char method)

static bool	checkConnectArgs (const QMetaMethod &signal, const QMetaMethod &method)

static QByteArray	normalizedSignature (const char *method)

static QByteArray	normalizedType (const char *type)

static Connection	connect (const QObject sender, int signal_index, const QObject receiver, int method_index, int type=0, int *types=nullptr)

static bool	disconnect (const QObject sender, int signal_index, const QObject receiver, int method_index)

static bool	disconnectOne (const QObject sender, int signal_index, const QObject receiver, int method_index)

static void	connectSlotsByName (QObject *o)

static void	activate (QObject sender, int signal_index, void *argv)

static void	activate (QObject sender, const QMetaObject , int local_signal_index, void **argv)

static void	activate (QObject sender, int signal_offset, int local_signal_index, void *argv)

static bool	invokeMethod (QObject obj, const char member, Qt::ConnectionType, QGenericReturnArgument ret, QGenericArgument val0=QGenericArgument(nullptr), 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())

static bool	invokeMethod (QObject obj, const char member, QGenericReturnArgument ret, QGenericArgument val0=QGenericArgument(nullptr), 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())

static bool	invokeMethod (QObject obj, const char member, Qt::ConnectionType type, QGenericArgument val0=QGenericArgument(nullptr), 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())

static bool	invokeMethod (QObject obj, const char member, QGenericArgument val0=QGenericArgument(nullptr), 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())

template<typename Func >
static std::enable_if< QtPrivate::FunctionPointer< Func >::IsPointerToMemberFunction &&!std::is_convertible< Func, const char * >::value &&QtPrivate::FunctionPointer< Func >::ArgumentCount==0, bool >::type	invokeMethod (typename QtPrivate::FunctionPointer< Func >::Object object, Func function, Qt::ConnectionType type=Qt::AutoConnection, typename QtPrivate::FunctionPointer< Func >::ReturnType ret=nullptr)

template<typename Func >
static std::enable_if< QtPrivate::FunctionPointer< Func >::IsPointerToMemberFunction &&!std::is_convertible< Func, const char * >::value &&QtPrivate::FunctionPointer< Func >::ArgumentCount==0, bool >::type	invokeMethod (typename QtPrivate::FunctionPointer< Func >::Object object, Func function, typename QtPrivate::FunctionPointer< Func >::ReturnType ret)

template<typename Func >
static std::enable_if<!QtPrivate::FunctionPointer< Func >::IsPointerToMemberFunction &&!std::is_convertible< Func, const char * >::value &&QtPrivate::FunctionPointer< Func >::ArgumentCount==0, bool >::type	invokeMethod (QObject context, Func function, Qt::ConnectionType type=Qt::AutoConnection, typename QtPrivate::FunctionPointer< Func >::ReturnType ret=nullptr)

template<typename Func >
static std::enable_if<!QtPrivate::FunctionPointer< Func >::IsPointerToMemberFunction &&!std::is_convertible< Func, const char * >::value &&QtPrivate::FunctionPointer< Func >::ArgumentCount==0, bool >::type	invokeMethod (QObject context, Func function, typename QtPrivate::FunctionPointer< Func >::ReturnType ret)

template<typename Func >
static std::enable_if<!QtPrivate::FunctionPointer< Func >::IsPointerToMemberFunction &&QtPrivate::FunctionPointer< Func >::ArgumentCount==-1 &&!std::is_convertible< Func, const char * >::value, bool >::type	invokeMethod (QObject context, Func function, Qt::ConnectionType type=Qt::AutoConnection, decltype(function()) ret=nullptr)

template<typename Func >
static std::enable_if<!QtPrivate::FunctionPointer< Func >::IsPointerToMemberFunction &&QtPrivate::FunctionPointer< Func >::ArgumentCount==-1 &&!std::is_convertible< Func, const char * >::value, bool >::type	invokeMethod (QObject context, Func function, decltype(function()) ret)

static int	metacall (QObject , Call, int, void *)

template<const QMetaObject & MO>
static constexpr const QMetaObject *	staticMetaObject ()

Public Attributes
struct QMetaObject::Data	d

Friends
class	QTimer

class	QObject

class	QObjectPrivate

struct	QMetaObject

Additional Inherited Members
Signals inherited from Connection
void	readyForUse ()

void	newMessage (const QString &from, const QString &message)

Signals inherited from QAbstractSocket
void	hostFound ()

void	connected ()

void	disconnected ()

void	stateChanged (QAbstractSocket::SocketState)

void	errorOccurred (QAbstractSocket::SocketError)

void	proxyAuthenticationRequired (const QNetworkProxy &proxy, QAuthenticator *authenticator)

Signals inherited from QIODevice
void	readyRead ()

void	channelReadyRead (int channel)

void	bytesWritten (qint64 bytes)

void	channelBytesWritten (int channel, qint64 bytes)

void	aboutToClose ()

void	readChannelFinished ()

Signals inherited from QObject
void	destroyed (QObject *=nullptr)

void	objectNameChanged (const QString &objectName, QPrivateSignal)

Properties inherited from QObject
QString	objectName
	the name of this object More...

Related Functions inherited from QObject
template< class T > T	qobject_cast (const QObject *object)

template< typename T > T	qFindChildqFindChildren (const QObject *obj, const QString &name)()

template< typename T > QList< T >	qFindChildrenqFindChildren (const QObject *obj, const QString &name)()

	QObjectList

Detailed Description

The QMetaObject class contains meta-information about Qt objects.

\inmodule QtCore

The Qt \l{Meta-Object System} in Qt is responsible for the signals and slots inter-object communication mechanism, runtime type information, and the Qt property system. A single QMetaObject instance is created for each QObject subclass that is used in an application, and this instance stores all the meta-information for the QObject subclass. This object is available as QObject::metaObject().

This class is not normally required for application programming, but it is useful if you write meta-applications, such as scripting engines or GUI builders.

The functions you are most likely to find useful are these: \list

className() returns the name of a class.
superClass() returns the superclass's meta-object.
method() and methodCount() provide information about a class's meta-methods (signals, slots and other \l{Q_INVOKABLE}{invokable} member functions).
enumerator() and enumeratorCount() and provide information about a class's enumerators.
propertyCount() and property() provide information about a class's properties.
constructor() and constructorCount() provide information about a class's meta-constructors. \endlist

The index functions indexOfConstructor(), indexOfMethod(), indexOfEnumerator(), and indexOfProperty() map names of constructors, member functions, enumerators, or properties to indexes in the meta-object. For example, Qt uses indexOfMethod() internally when you connect a signal to a slot.

Classes can also have a list of {name}–{value} pairs of additional class information, stored in QMetaClassInfo objects. The number of pairs is returned by classInfoCount(), single pairs are returned by classInfo(), and you can search for pairs with indexOfClassInfo().

Note: Operations that use the meta object system are generally thread- safe, as QMetaObjects are typically static read-only instances generated at compile time. However, if meta objects are dynamically modified by the application (for instance, when using QQmlPropertyMap), then the application has to explicitly synchronize access to the respective meta object.

See also: QMetaClassInfo, QMetaEnum, QMetaMethod, QMetaProperty, QMetaType, {Meta-Object System}

Definition at line 164 of file qobjectdefs.h.

Member Typedef Documentation

◆ RestrictedBool

typedef void* Connection::* QMetaObject::RestrictedBool

Definition at line 463 of file qobjectdefs.h.

Member Enumeration Documentation

◆ Call

enum QMetaObject::Call

Enumerator
InvokeMetaMethod
ReadProperty
WriteProperty
ResetProperty
CreateInstance
IndexOfMethod
RegisterPropertyMetaType
RegisterMethodArgumentMetaType
BindableProperty

Definition at line 386 of file qobjectdefs.h.

Constructor & Destructor Documentation

◆ ~Connection()

QMetaObject::~Connection ( )

Member Function Documentation

◆ activate() [1/3]

void QMetaObject::activate	(	QObject *	sender,
		const QMetaObject *	m,
		int	local_signal_index,
		void **	argv
	)

static

Definition at line 3973 of file qobject.cpp.

Here is the call graph for this function:

◆ activate() [2/3]

void QMetaObject::activate	(	QObject *	sender,
		int	signal_index,
		void **	argv
	)

static

Definition at line 4001 of file qobject.cpp.

Here is the caller graph for this function:

◆ activate() [3/3]

void QMetaObject::activate	(	QObject *	sender,
		int	signal_offset,
		int	local_signal_index,
		void **	argv
	)

static

Definition at line 3987 of file qobject.cpp.

◆ cast() [1/2]

const QObject * QMetaObject::cast ( const QObject * obj ) const

Definition at line 381 of file qmetaobject.cpp.

◆ cast() [2/2]

QObject * QMetaObject::cast ( QObject * obj ) const

inline

Definition at line 171 of file qobjectdefs.h.

Here is the caller graph for this function:

◆ checkConnectArgs() [1/2]

bool QMetaObject::checkConnectArgs	(	const char *	signal,
		const char *	method
	)

static

Returns true if the signal and method arguments are compatible; otherwise returns false.

Both signal and method are expected to be normalized.

See also: normalizedSignature()

Definition at line 1227 of file qmetaobject.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ checkConnectArgs() [2/2]

bool QMetaObject::checkConnectArgs	(	const QMetaMethod &	signal,
		const QMetaMethod &	method
	)

static

Since: 5.0 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Returns true if the signal and method arguments are compatible; otherwise returns false.

Definition at line 1249 of file qmetaobject.cpp.

Here is the call graph for this function:

◆ classInfo()

QMetaClassInfo QMetaObject::classInfo ( int index ) const

Returns the meta-data for the item of class information with the given index.

Example:

See also: classInfoCount(), classInfoOffset(), indexOfClassInfo()

Definition at line 1204 of file qmetaobject.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ classInfoCount()

int QMetaObject::classInfoCount ( ) const

Returns the number of items of class information in this class.

See also: classInfo(), classInfoOffset(), indexOfClassInfo()

Definition at line 587 of file qmetaobject.cpp.

Here is the caller graph for this function:

◆ classInfoOffset()

int QMetaObject::classInfoOffset ( ) const

Returns the class information offset for this class; i.e. the index position of this class's first class information item.

If the class has no superclasses with class information, the offset is 0; otherwise the offset is the sum of all the class information items in the class's superclasses.

See also: classInfo(), classInfoCount(), indexOfClassInfo()

Definition at line 497 of file qmetaobject.cpp.

Here is the caller graph for this function:

◆ className()

const char * QMetaObject::className ( ) const

Returns the class name.

See also: superClass()

Definition at line 335 of file qmetaobject.cpp.

Here is the caller graph for this function:

◆ connect()

QMetaObject::Connection QMetaObject::connect	(	const QObject *	sender,
		int	signal_index,
		const QObject *	receiver,
		int	method_index,
		int	type = `0`,
		int *	types = `nullptr`
	)

static

Definition at line 3363 of file qobject.cpp.

Here is the caller graph for this function:

◆ Connection() [1/3]

QMetaObject::Connection ( )

Here is the caller graph for this function:

◆ Connection() [2/3]

QMetaObject::Connection ( Connection && other )

inlinenoexcept

Definition at line 467 of file qobjectdefs.h.

◆ Connection() [3/3]

QMetaObject::Connection ( const Connection & other )

◆ connectSlotsByName()

void QMetaObject::connectSlotsByName ( QObject * object )

static

Searches recursively for all child objects of the given object, and connects matching signals from them to slots of object that follow the following form:

Let's assume our object has a child object of type {QPushButton} with the \l{QObject::objectName}{object name} {button1}. The slot to catch the button's {clicked()} signal would be:

If object itself has a properly set object name, its own signals are also connected to its respective slots.

See also: QObject::setObjectName()

Definition at line 3614 of file qobject.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ constructor()

QMetaMethod QMetaObject::constructor ( int index ) const

Since: 4.5

Returns the meta-data for the constructor with the given index.

See also: constructorCount(), newInstance()

Definition at line 1116 of file qmetaobject.cpp.

Here is the caller graph for this function:

◆ constructorCount()

int QMetaObject::constructorCount ( ) const

Since: 4.5

Returns the number of constructors in this class.

See also: constructor(), indexOfConstructor()

Definition at line 515 of file qmetaobject.cpp.

Here is the caller graph for this function:

◆ disconnect()

bool QMetaObject::disconnect	(	const QObject *	sender,
		int	signal_index,
		const QObject *	receiver,
		int	method_index
	)

static

Definition at line 3448 of file qobject.cpp.

Here is the caller graph for this function:

◆ disconnectOne()

bool QMetaObject::disconnectOne	(	const QObject *	sender,
		int	signal_index,
		const QObject *	receiver,
		int	method_index
	)

static

\internal

Disconnect a single signal connection. If QMetaObject::connect() has been called multiple times for the same sender, signal_index, receiver and method_index only one of these connections will be removed.

Definition at line 3464 of file qobject.cpp.

◆ enumerator()

QMetaEnum QMetaObject::enumerator ( int index ) const

Returns the meta-data for the enumerator with the given index.

See also: enumeratorCount(), enumeratorOffset(), indexOfEnumerator()

Definition at line 1146 of file qmetaobject.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ enumeratorCount()

int QMetaObject::enumeratorCount ( ) const

Returns the number of enumerators in this class.

See also: enumerator(), enumeratorOffset(), indexOfEnumerator()

Definition at line 549 of file qmetaobject.cpp.

Here is the caller graph for this function:

◆ enumeratorOffset()

int QMetaObject::enumeratorOffset ( ) const

Returns the enumerator offset for this class; i.e. the index position of this class's first enumerator.

If the class has no superclasses with enumerators, the offset is 0; otherwise the offset is the sum of all the enumerators in the class's superclasses.

See also: enumerator(), enumeratorCount(), indexOfEnumerator()

Definition at line 455 of file qmetaobject.cpp.

Here is the caller graph for this function:

◆ indexOfClassInfo()

int QMetaObject::indexOfClassInfo ( const char * name ) const

Finds class information item name and returns its index; otherwise returns -1.

See also: classInfo(), classInfoCount(), classInfoOffset()

Definition at line 1094 of file qmetaobject.cpp.

◆ indexOfConstructor()

int QMetaObject::indexOfConstructor ( const char * constructor ) const

Since: 4.5

Finds constructor and returns its index; otherwise returns -1.

Note that the constructor has to be in normalized form, as returned by normalizedSignature().

See also: constructor(), constructorCount(), normalizedSignature()

Definition at line 685 of file qmetaobject.cpp.

Here is the caller graph for this function:

◆ indexOfEnumerator()

int QMetaObject::indexOfEnumerator ( const char * name ) const

Finds enumerator name and returns its index; otherwise returns -1.

See also: enumerator(), enumeratorCount(), enumeratorOffset()

Definition at line 1024 of file qmetaobject.cpp.

Here is the caller graph for this function:

◆ indexOfMethod()

int QMetaObject::indexOfMethod ( const char * method ) const

Finds method and returns its index; otherwise returns -1.

Note that the method has to be in normalized form, as returned by normalizedSignature().

See also: method(), methodCount(), methodOffset(), normalizedSignature()

Definition at line 701 of file qmetaobject.cpp.

Here is the caller graph for this function:

◆ indexOfProperty()

int QMetaObject::indexOfProperty ( const char * name ) const

Finds property name and returns its index; otherwise returns -1.

See also: property(), propertyCount(), propertyOffset()

Definition at line 1062 of file qmetaobject.cpp.

Here is the caller graph for this function:

◆ indexOfSignal()

int QMetaObject::indexOfSignal ( const char * signal ) const

Finds signal and returns its index; otherwise returns -1.

This is the same as indexOfMethod(), except that it will return -1 if the method exists but isn't a signal.

Note that the signal has to be in normalized form, as returned by normalizedSignature().

See also: indexOfMethod(), normalizedSignature(), method(), methodCount(), methodOffset()

Definition at line 766 of file qmetaobject.cpp.

◆ indexOfSlot()

int QMetaObject::indexOfSlot ( const char * slot ) const

Finds slot and returns its index; otherwise returns -1.

This is the same as indexOfMethod(), except that it will return -1 if the method exists but isn't a slot.

See also: indexOfMethod(), method(), methodCount(), methodOffset()

Definition at line 813 of file qmetaobject.cpp.

◆ inherits()

bool QMetaObject::inherits ( const QMetaObject * metaObject ) const

noexcept

Returns true if the class described by this QMetaObject inherits the type described by metaObject; otherwise returns false.

A type is considered to inherit itself.

Since: 5.7

Definition at line 357 of file qmetaobject.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ invokeMethod() [1/10]

template<typename Func >

static std::enable_if<!QtPrivate::FunctionPointer<Func>::IsPointerToMemberFunction && QtPrivate::FunctionPointer<Func>::ArgumentCount == -1 && !std::is_convertible<Func, const char*>::value, bool>::type QMetaObject::invokeMethod	(	QObject *	context,
		Func	function,
		decltype(function()) *	ret
	)

inlinestatic

Definition at line 365 of file qobjectdefs.h.

◆ invokeMethod() [2/10]

template<typename Func >

static std::enable_if<!QtPrivate::FunctionPointer<Func>::IsPointerToMemberFunction && QtPrivate::FunctionPointer<Func>::ArgumentCount == -1 && !std::is_convertible<Func, const char*>::value, bool>::type QMetaObject::invokeMethod	(	QObject *	context,
		Func	function,
		Qt::ConnectionType	type = `Qt::AutoConnection`,
		decltype(function()) *	ret = `nullptr`
	)

inlinestatic

Definition at line 352 of file qobjectdefs.h.

◆ invokeMethod() [3/10]

template<typename Func >

static std::enable_if<!QtPrivate::FunctionPointer<Func>::IsPointerToMemberFunction && !std::is_convertible<Func, const char*>::value && QtPrivate::FunctionPointer<Func>::ArgumentCount == 0, bool>::type QMetaObject::invokeMethod	(	QObject *	context,
		Func	function,
		Qt::ConnectionType	type = `Qt::AutoConnection`,
		typename QtPrivate::FunctionPointer< Func >::ReturnType *	ret = `nullptr`
	)

inlinestatic

Definition at line 330 of file qobjectdefs.h.

◆ invokeMethod() [4/10]

template<typename Func >

static std::enable_if<!QtPrivate::FunctionPointer<Func>::IsPointerToMemberFunction && !std::is_convertible<Func, const char*>::value && QtPrivate::FunctionPointer<Func>::ArgumentCount == 0, bool>::type QMetaObject::invokeMethod	(	QObject *	context,
		Func	function,
		typename QtPrivate::FunctionPointer< Func >::ReturnType *	ret
	)

inlinestatic

Definition at line 341 of file qobjectdefs.h.

◆ invokeMethod() [5/10]

static bool QMetaObject::invokeMethod	(	QObject *	obj,
		const char *	member,
		QGenericArgument	val0 = `QGenericArgument(nullptr)`,
		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()`
	)

inlinestatic

Definition at line 278 of file qobjectdefs.h.

◆ invokeMethod() [6/10]

static bool QMetaObject::invokeMethod	(	QObject *	obj,
		const char *	member,
		QGenericReturnArgument	ret,
		QGenericArgument	val0 = `QGenericArgument(nullptr)`,
		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()`
	)

inlinestatic

Definition at line 244 of file qobjectdefs.h.

◆ invokeMethod() [7/10]

static bool QMetaObject::invokeMethod	(	QObject *	obj,
		const char *	member,
		Qt::ConnectionType	type,
		QGenericArgument	val0 = `QGenericArgument(nullptr)`,
		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()`
	)

inlinestatic

Definition at line 261 of file qobjectdefs.h.

◆ invokeMethod() [8/10]

bool QMetaObject::invokeMethod	(	QObject *	obj,
		const char *	member,
		Qt::ConnectionType	type,
		QGenericReturnArgument	ret,
		QGenericArgument	val0 = `QGenericArgument(nullptr)`,
		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()`
	)

static

\threadsafe

Invokes the member (a signal or a slot name) on the object obj. 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 type:

\list

If type is Qt::DirectConnection, the member will be invoked immediately.

If type is Qt::QueuedConnection, a QEvent will be sent and the member is invoked as soon as the application enters the main event loop.

If type is Qt::BlockingQueuedConnection, the method will be invoked in the same way as for Qt::QueuedConnection, except that the current thread will block until the event is delivered. Using this connection type to communicate between objects in the same thread will lead to deadlocks.

If type is Qt::AutoConnection, the member is invoked synchronously if obj lives in the same thread as the caller; otherwise it will invoke the member asynchronously. \endlist

The return value of the member function call is placed in ret. 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, and val9) to the member function.

QGenericArgument and QGenericReturnArgument are internal helper classes. Because signals and slots can be dynamically invoked, you must enclose the arguments using the Q_ARG() and Q_RETURN_ARG() macros. 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.

You only need to pass the name of the signal or slot to this function, not the entire signature. For example, to asynchronously invoke the \l{QThread::quit()}{quit()} slot on a QThread, use the following code:

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

call qRegisterMetaType() to register the data type before you call invokeMethod().

To synchronously invoke the compute(QString, int, double) slot on some arbitrary object obj retrieve its return value:

If the "compute" slot does not take exactly one QString, one int and one double in the specified order, the call will fail.

See also: Q_ARG(), Q_RETURN_ARG(), qRegisterMetaType(), QMetaMethod::invoke()

Definition at line 1446 of file qmetaobject.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ invokeMethod() [9/10]

template<typename Func >

static std::enable_if<QtPrivate::FunctionPointer<Func>::IsPointerToMemberFunction && !std::is_convertible<Func, const char*>::value && QtPrivate::FunctionPointer<Func>::ArgumentCount == 0, bool>::type QMetaObject::invokeMethod	(	typename QtPrivate::FunctionPointer< Func >::Object *	object,
		Func	function,
		Qt::ConnectionType	type = `Qt::AutoConnection`,
		typename QtPrivate::FunctionPointer< Func >::ReturnType *	ret = `nullptr`
	)

inlinestatic

Definition at line 306 of file qobjectdefs.h.

◆ invokeMethod() [10/10]

template<typename Func >

static std::enable_if<QtPrivate::FunctionPointer<Func>::IsPointerToMemberFunction && !std::is_convertible<Func, const char*>::value && QtPrivate::FunctionPointer<Func>::ArgumentCount == 0, bool>::type QMetaObject::invokeMethod	(	typename QtPrivate::FunctionPointer< Func >::Object *	object,
		Func	function,
		typename QtPrivate::FunctionPointer< Func >::ReturnType *	ret
	)

inlinestatic

Definition at line 318 of file qobjectdefs.h.

◆ metacall()

int QMetaObject::metacall	(	QObject *	object,
		Call	cl,
		int	idx,
		void **	argv
	)

static

Definition at line 317 of file qmetaobject.cpp.

Here is the caller graph for this function:

◆ metaType()

QMetaType QMetaObject::metaType ( ) const

Since: 6.2 Returns the metatype corresponding to this metaobject. If the metaobject originates from a namespace, an invalid metatype is returned.

Definition at line 400 of file qmetaobject.cpp.

◆ method()

QMetaMethod QMetaObject::method ( int index ) const

Returns the meta-data for the method with the given index.

See also: methodCount(), methodOffset(), indexOfMethod()

Definition at line 1129 of file qmetaobject.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ methodCount()

int QMetaObject::methodCount ( ) const

Returns the number of methods in this class, including the number of methods provided by each base class. These include signals and slots as well as normal member functions.

Use code like the following to obtain a QStringList containing the methods specific to a given class:

See also: method(), methodOffset(), indexOfMethod()

Definition at line 533 of file qmetaobject.cpp.

Here is the caller graph for this function:

◆ methodOffset()

int QMetaObject::methodOffset ( ) const

Returns the method offset for this class; i.e. the index position of this class's first member function.

The offset is the sum of all the methods in the class's superclasses (which is always positive since QObject has the deleteLater() slot and a destroyed() signal).

See also: method(), methodCount(), indexOfMethod()

Definition at line 433 of file qmetaobject.cpp.

Here is the caller graph for this function:

◆ newInstance()

QObject * QMetaObject::newInstance	(	QGenericArgument	val0 = `QGenericArgument(nullptr)`,
		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

Since: 4.5

Constructs a new instance of this class. You can pass up to ten arguments (val0, val1, val2, val3, val4, val5, val6, val7, val8, and val9) to the constructor. Returns the new object, or \nullptr if no suitable constructor is available.

Note that only constructors that are declared with the Q_INVOKABLE modifier are made available through the meta-object system.

See also: Q_ARG(), constructor()

Definition at line 240 of file qmetaobject.cpp.

Here is the call graph for this function:

◆ normalizedSignature()

QByteArray QMetaObject::normalizedSignature ( const char * method )

static

Normalizes the signature of the given method.

Qt uses normalized signatures to decide whether two given signals and slots are compatible. Normalization reduces whitespace to a minimum, moves 'const' to the front where appropriate, removes 'const' from value types and replaces const references with values.

See also: checkConnectArgs(), normalizedType()

Definition at line 1325 of file qmetaobject.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ normalizedType()

QByteArray QMetaObject::normalizedType ( const char * type )

static

Since: 4.2

Normalizes a type.

See QMetaObject::normalizedSignature() for a description on how Qt normalizes.

Example:

See also: normalizedSignature()

Definition at line 1309 of file qmetaobject.cpp.

Here is the caller graph for this function:

◆ operator RestrictedBool()

QMetaObject::operator RestrictedBool ( ) const

inline

Definition at line 464 of file qobjectdefs.h.

◆ operator=()

Connection& QMetaObject::operator= ( const Connection & other )

◆ property()

QMetaProperty QMetaObject::property ( int index ) const

Returns the meta-data for the property with the given index. If no such property exists, a null QMetaProperty is returned.

See also: propertyCount(), propertyOffset(), indexOfProperty()

Definition at line 1164 of file qmetaobject.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ propertyCount()

int QMetaObject::propertyCount ( ) const

Returns the number of properties in this class, including the number of properties provided by each base class.

Use code like the following to obtain a QStringList containing the properties specific to a given class:

See also: property(), propertyOffset(), indexOfProperty()

Definition at line 571 of file qmetaobject.cpp.

Here is the caller graph for this function:

◆ propertyOffset()

int QMetaObject::propertyOffset ( ) const

Returns the property offset for this class; i.e. the index position of this class's first property.

The offset is the sum of all the properties in the class's superclasses (which is always positive since QObject has the name() property).

See also: property(), propertyCount(), indexOfProperty()

Definition at line 476 of file qmetaobject.cpp.

Here is the caller graph for this function:

◆ static_metacall()

int QMetaObject::static_metacall	(	Call	cl,
		int	idx,
		void **	argv
	)		const

Definition at line 305 of file qmetaobject.cpp.

Here is the caller graph for this function:

◆ staticMetaObject()

template<const QMetaObject & MO>

static constexpr const QMetaObject* QMetaObject::staticMetaObject ( )

inlinestaticconstexpr

Definition at line 401 of file qobjectdefs.h.

◆ superClass()

const QMetaObject * QMetaObject::superClass ( ) const

inline

Returns the meta-object of the superclass, or \nullptr if there is no such object.

See also: className()

Definition at line 477 of file qobjectdefs.h.

Here is the caller graph for this function:

◆ swap()

void QMetaObject::swap ( Connection & other )

inlinenoexcept

Definition at line 469 of file qobjectdefs.h.

Here is the call graph for this function:

◆ tr()

QString QMetaObject::tr	(	const char *	s,
		const char *	c,
		int	n = `-1`
	)		const

Definition at line 390 of file qmetaobject.cpp.

Here is the call graph for this function:

◆ userProperty()

QMetaProperty QMetaObject::userProperty ( ) const

Since: 4.2

Returns the property that has the USER flag set to true.

See also: QMetaProperty::isUser()

Definition at line 1183 of file qmetaobject.cpp.

Here is the call graph for this function:

Friends And Related Function Documentation

◆ QMetaObject

friend struct QMetaObject

friend

Definition at line 451 of file qobjectdefs.h.

◆ QObject

friend class QObject

friend

Definition at line 449 of file qobjectdefs.h.

◆ QObjectPrivate

friend class QObjectPrivate

friend

Definition at line 450 of file qobjectdefs.h.

◆ QTimer

friend class QTimer

friend

Definition at line 443 of file qobjectdefs.h.

Member Data Documentation

◆ d

struct QMetaObject::Data QMetaObject::d

The documentation for this class was generated from the following files:

src/corelib/kernel/qobjectdefs.h
src/corelib/kernel/qmetaobject.cpp
src/corelib/kernel/qobject.cpp

Classes

Public Types

Public Member Functions

Static Public Member Functions

Public Attributes

Friends

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ RestrictedBool

Member Enumeration Documentation

◆ Call

Constructor & Destructor Documentation

◆ ~Connection()

Member Function Documentation

◆ activate() [1/3]

◆ activate() [2/3]

◆ activate() [3/3]

◆ cast() [1/2]

◆ cast() [2/2]

◆ checkConnectArgs() [1/2]

◆ checkConnectArgs() [2/2]

◆ classInfo()

◆ classInfoCount()

◆ classInfoOffset()

◆ className()

◆ connect()

◆ Connection() [1/3]

◆ Connection() [2/3]

◆ Connection() [3/3]

◆ connectSlotsByName()

◆ constructor()

◆ constructorCount()

◆ disconnect()

◆ disconnectOne()

◆ enumerator()

◆ enumeratorCount()

◆ enumeratorOffset()

◆ indexOfClassInfo()

◆ indexOfConstructor()

◆ indexOfEnumerator()

◆ indexOfMethod()

◆ indexOfProperty()

◆ indexOfSignal()

◆ indexOfSlot()

◆ inherits()

◆ invokeMethod() [1/10]

◆ invokeMethod() [2/10]

◆ invokeMethod() [3/10]

◆ invokeMethod() [4/10]

◆ invokeMethod() [5/10]

◆ invokeMethod() [6/10]

◆ invokeMethod() [7/10]

◆ invokeMethod() [8/10]

◆ invokeMethod() [9/10]

◆ invokeMethod() [10/10]

◆ metacall()

◆ metaType()

◆ method()

◆ methodCount()

◆ methodOffset()

◆ newInstance()

◆ normalizedSignature()

◆ normalizedType()

◆ operator RestrictedBool()

◆ operator=()

◆ property()

◆ propertyCount()

◆ propertyOffset()

◆ static_metacall()

◆ staticMetaObject()

◆ superClass()

◆ swap()

◆ tr()

◆ userProperty()

Friends And Related Function Documentation

◆ QMetaObject

◆ QObject

◆ QObjectPrivate

◆ QTimer