QML LandmarkCategoryModel Element

Detailed Description

This element is part of the QtMobility.location 1.1 module.

LandmarkCategoryModel provides a model of categories from the categories store. The contents of the model can be specified with landmark, and sorted via the LandmarkAbstractModel::sortBy and LandmarkAbstractModel::sortOrder properties. Whether the model is automatically updated when the store or landmark changes, can be controlled with LandmarkAbstractModel::autoUpdate property.

There are two ways of accessing the category data: via model by using views and delegates, or alternatively via categories list property. Of the two, the model access is preferred. Direct list access (i.e. non-model) is not guaranteed to be in order set by sortBy and sortOrder.

At the moment only data role provided by the model is category. Through that one can access any data provided by the LandmarkCategory element.

     LandmarkCategoryModel {
         id: landmarkCategoryModel
         autoUpdate: true
         onModelChanged: console.log("Category model changed, category count: " + count)
     }

     Component {
         id: landmarkCategoryListDelegate
         Item {
             width: 200; height: 50
             Text {
                 color: "white"; font.bold: true; style: Text.Raised; styleColor: "black"
                 id: nameField; text: category.name
             }
         }
     }

See also LandmarkAbstractModel, LandmarkModel, and QLandmarkManager.

Property Documentation

     LandmarkCategoryModel {
         id: categoriesOfGivenLandmark
         autoUpdate: false
         onCategoriesChanged: {
             console.log("log: Categories count is: "+ count);
             for (var index = 0; index < categories.length; index++)  {
                 console.log("Index, name:" + index + " , " + categories[index].name);
             }
         }
     }