Qt Reference Documentation

Extending QML - Default Property Example


This example builds on:

The Default Property Example is a minor modification of the Extending QML - Inheritance and Coercion Example that simplifies the specification of a BirthdayParty through the use of a default property.

 BirthdayParty {
     host: Boy {
         name: "Bob Jones"
         shoeSize: 12

     Boy { name: "Leo Hodges" }
     Boy { name: "Jack Smith" }
     Girl { name: "Anne Brown" }

Declaring the BirthdayParty class

The only difference between this example and the last, is the addition of the DefaultProperty class info annotation.

 class BirthdayParty : public QObject
     Q_PROPERTY(Person *host READ host WRITE setHost)
     Q_PROPERTY(QDeclarativeListProperty<Person> guests READ guests)
     Q_CLASSINFO("DefaultProperty", "guests")
     BirthdayParty(QObject *parent = 0);

     Person *host() const;
     void setHost(Person *);

     QDeclarativeListProperty<Person> guests();
     int guestCount() const;
     Person *guest(int) const;

     Person *m_host;
     QList<Person *> m_guests;

The default property specifies the property to assign to whenever an explicit property is not specified, in the case of the BirthdayParty element the guest property. It is purely a syntactic simplification, the behavior is identical to specifying the property by name, but it can add a more natural feel in many situations. The default property must be either an object or list property.

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.


Thank you for giving your feedback.

Make sure it is related to this specific page. For more general bugs and requests, please use the Qt Bug Tracker.

[0]; s.parentNode.insertBefore(ga, s); })();