Q_DECLARE_METATYPE與qRegisterMetaType學習

Q_DECLARE_METATYPE與qRegisterMetaType學習

http://hi.baidu.com/cyclone/blog/item/01108bd40599b00fa18bb793.html

2010-09-07 18:20

基本理解

• 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;
 }
}