Q_DECLARE_METATYPE與qRegisterMetaType
2010-09-07 18:20
來源 https://www.cnblogs.com/cute/archive/2011/03/02/1969166.html
參考 http://hi.baidu.com/cyclone/blog/item/01108bd40599b00fa18bb793.html
基本理解
- Q_DECLARE_METATYPE
- 如果要使自定義類型或其他非QMetaType內置類型在QVaiant中使用，必須使用該宏。
- 該類型必須有公有的 構造、析構、復制構造 函數
- qRegisterMetaType 必須使用該函數的兩種情況
- 如果非QMetaType內置類型要在 Qt 的屬性系統中使用
- 如果非QMetaType內置類型要在 queued 信號與槽 中使用
二者關系
二者的代碼：
-
Q_DECLARE_METATYPE 展開后是一個特化后的類 QMetaTypeId<TYPE>
-
qRegisterMetaType 將某類型注冊中 MetaType 系統中
二者的聯系：
-
QMetaTypeId<TYPE>的類中的成員包含對qRegisterMetaType的調用
-
我們知道類中的成員函數並不一定會被調用(即，該宏並不確保類型被注冊到MetaType)。
- 通過qRegisterMetaType可以確保類型被注冊
兩個qRegisterMetaType 的聯系
- 無參的qRegisterMetaType函數會通過該成員調用帶參數的qRegisterMetaType()
這兩個東西真難理清，不妨看看源碼吧。
Q_DECLARE_METATYPE
代碼來源：src/corelib/kernel/qmetatype.h
#define Q_DECLARE_METATYPE(TYPE) \
QT_BEGIN_NAMESPACE \
template <> \
struct QMetaTypeId< TYPE > \
{ \
enum { Defined = 1 }; \
static int qt_metatype_id() \
{ \
static QBasicAtomicInt metatype_id = Q_BASIC_ATOMIC_INITIALIZER(0); \
if (!metatype_id) \
metatype_id = qRegisterMetaType< TYPE >(#TYPE); \
return metatype_id; \
} \
}; \
QT_END_NAMESPACE
-
宏展開是一個在Qt的命名空間中的一個類模板的特化 QMetaTypeId<TYPE>
- 該類含一個enum和一個返回!QMetaType的id的成員函數
qRegisterMetaType(const char *typeName)
代碼來源：src/corelib/kernel/qmetatype.h
template <typename T>
int qRegisterMetaType(const char *typeName)
{
typedef void*(*ConstructPtr)(const T*);
ConstructPtr cptr = qMetaTypeConstructHelper<T>;
typedef void(*DeletePtr)(T*);
DeletePtr dptr = qMetaTypeDeleteHelper<T>;
return QMetaType::registerType(typeName, reinterpret_cast<QMetaType::Destructor>(dptr),
reinterpret_cast<QMetaType::Constructor>(cptr));
}
- 該函數的核心就是調用了registerType 函數
- 兩個Helper模板函數分別對構造和析構函數進行封裝
registerType
代碼來源：src/corelib/kernel/qmetatype.cpp
int QMetaType::registerType(const char *typeName, Destructor destructor, Constructor constructor)
函數功能：
-
根據類型名查找其MetaType類型，如果已存在，則直接返回;否則創建后返回。
- 創建一個 !QCustomTypeInfo 對象
- 該對象包含要類型的構造、析構信息，已經規范化后的類型名
- 該對象存入一個全局的!QVector中
qRegisterMetaType()
看manual，可以知道，qRegisterMetaType 還有一個無參的重載函數。
template <typename T>
inline int qRegisterMetaType()
{
return qMetaTypeId(static_cast<T *>(0));
}
- 函數看起來和帶參數的那個似乎區別很大(難道不是么？)。
- 手冊中告訴我們，執行這個的時候，模板參數T必須用 Q_DECLARE_METATYPE() 聲明過
- 能猜到原因嗎？注意看前面 Q_DECLARE_METATYPE() 代碼，
- 對了。類中的成員函數qt_metatype_id中包含對qRegisterMetaType(typeName)的調用
-
這兒就是輾轉調用了這個帶參數的qRegisterMetaType函數
unregisterType(const char *typeName)
函數的作用是取消自己先前注冊的某個metatype類型。
前面提到注冊信息在一個全局的 QVector<QCustomTypeInfo>中，當取消注冊的時候是怎么樣的呢？直接刪除Vector中相應的項么？源碼告訴我們，不是的。
實際是查找到相應的項，清空該項的內容。
for (int v = 0; v < ct->count(); ++v)
{
if (ct->at(v).typeName == typeName)
{
QCustomTypeInfo &inf = (*ct)[v];
inf.typeName.clear();
inf.constr = 0;
inf.destr = 0;
inf.alias = -1;
}
}
=============== End