QDeclarativeNdefRecord Class Reference

Detailed Description

The QDeclarativeNdefRecord class implements the NdefRecord element in QML.

The QDeclarativeNdefRecord class is the base class for all NdefRecord elements in QML. To support a new NDEF record type in QML subclass this class and expose new properties, member functions and signals appropriate for the new record type. The following must be done to create a new NDEF record type in QML:

• The subclass must have a Q_OBJECT macro in its declaration.
• The subclass must have an invokable constructor that takes a QNdefRecord and a QObject pointer.
• The subclass must be declared as an NDEF record by expanding the Q_DECLARE_NDEFRECORD() macro in the implementation file of the subclass.
• The subclass must be registered with QML.

For example the declaration of such a class may look like the following.

 class QDeclarativeNdefFooRecord : public QDeclarativeNdefRecord
 {
     Q_OBJECT

     Q_PROPERTY(int foo READ foo WRITE setFoo NOTIFY fooChanged)

 public:
     explicit QDeclarativeNdefFooRecord(QObject *parent = 0);
     Q_INVOKABLE QDeclarativeNdefFooRecord(const QNdefRecord &record, QObject *parent = 0);
     ~QDeclarativeNdefFooRecord();

     int foo() const;
     void setFoo(int value);

 signals:
     void fooChanged();
 };

Within the implementation file the Q_DECLARE_NDEFRECORD() macro is expanded:

 Q_DECLARE_NDEFRECORD(QDeclarativeNdefFooRecord, QNdefRecord::ExternalRtd, "com.example:f")

Finially the application or plugin code calls qmlRegisterType():

 qmlRegisterType<QDeclarativeNdefFooRecord>(uri, 1, 0, "NdefFooRecord");