Extending QML - Object and List Property Types Example▲
This example builds on:
The Object and List Property Types example shows how to add object and list properties in QML. This example adds a BirthdayParty type that specifies a birthday party, consisting of a celebrant and a list of guests. People are specified using the People QML type built in the previous example.
BirthdayParty {
host
:
Person {
name
:
"Bob Jones"
shoeSize
:
12
}
guests
:
[
Person {
name
:
"Leo Hodges"
}
,
Person {
name
:
"Jack Smith"
}
,
Person {
name
:
"Anne Brown"
}
]
}
Declare the BirthdayParty▲
The BirthdayParty class is declared like this:
class
BirthdayParty : public
QObject
{
Q_OBJECT
Q_PROPERTY(Person *
host READ host WRITE setHost)
Q_PROPERTY(QQmlListProperty&
lt;Person&
gt; guests READ guests)
public
:
BirthdayParty(QObject *
parent =
0
);
Person *
host() const
;
void
setHost(Person *
);
QQmlListProperty&
lt;Person&
gt; guests();
void
appendGuest(Person*
);
int
guestCount() const
;
Person *
guest(int
) const
;
void
clearGuests();
private
:
static
void
appendGuest(QQmlListProperty&
lt;Person&
gt;*
, Person*
);
static
int
guestCount(QQmlListProperty&
lt;Person&
gt;*
);
static
Person*
guest(QQmlListProperty&
lt;Person&
gt;*
, int
);
static
void
clearGuests(QQmlListProperty&
lt;Person&
gt;*
);
Person *
m_host;
QVector&
lt;Person *&
gt; m_guests;
}
;
The class contains a member to store the celebrant object, and also a QList<Person *> member.
In QML, the type of a list properties - and the guests property is a list of people - are all of type QQmlListProperty<T>. QQmlListProperty is simple value type that contains a set of function pointers. QML calls these function pointers whenever it needs to read from, write to or otherwise interact with the list. In addition to concrete lists like the people list used in this example, the use of QQmlListProperty allows for "virtual lists" and other advanced scenarios.
Define the BirthdayParty▲
The implementation of BirthdayParty property accessors is straight forward.
Person *
BirthdayParty::
host() const
{
return
m_host;
}
void
BirthdayParty::
setHost(Person *
c)
{
m_host =
c;
}
QQmlListProperty&
lt;Person&
gt; BirthdayParty::
guests()
{
return
QQmlListProperty&
lt;Person&
gt;(this
, this
,
&
amp;BirthdayParty::
appendGuest,
&
amp;BirthdayParty::
guestCount,
&
amp;BirthdayParty::
guest,
&
amp;BirthdayParty::
clearGuests);
}
void
BirthdayParty::
appendGuest(Person*
p) {
m_guests.append(p);
}
int
BirthdayParty::
guestCount() const
{
return
m_guests.count();
}
Person *
BirthdayParty::
guest(int
index) const
{
return
m_guests.at(index);
}
void
BirthdayParty::
clearGuests() {
m_guests.clear();
}
Running the Example▲
The main.cpp file in the example includes a simple shell application that loads and runs the QML snippet shown at the beginning of this page.