QML DocumentGalleryModel Element

The DocumentGalleryModel element is used to specify a model containing items from the document gallery. More...

This element was introduced in Mobility 1.1.

List of all members, including inherited members

Properties

autoUpdate : bool
count : int
filter : GalleryFilter
limit : int
offset : int
progress : real
properties : QStringList
rootItem : variant
rootType : enum
scope : enum
sortProperties : QStringList
status : enum

Methods

cancel
clear
get
property
reload
set
setProperty

Detailed Description

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

The properties that should be returned for each item by the query are specified in properties. In addition all queries return the following properties:

itemId The ID of an item.
itemType The type of an item.

 import Qt 4.7
 import QtMobility.gallery 1.1

 Rectangle {
     width: 1024
     height: 768

     GridView {
         anchors.fill: parent
         cellWidth: 128
         cellHeight: 128

         model: DocumentGalleryModel {
             rootType: DocumentGallery.Image
             properties: [ "url" ]
             filter: GalleryWildcardFilter {
                 property: "fileName";
                 value: "*.jpg";
             }
         }

         delegate: Image {
             source: url
             width: 128
             height: 128
         }
     }
 }

See also DocumentGalleryItem and DocumentGalleryType.

Property Documentation

autoUpdate : bool

This property holds whether a query should refresh its results automatically.

This property group was introduced in Mobility 1.1.

read-onlycount : int

This property holds the number of results returned by a query.

This property group was introduced in Mobility 1.1.

filter : GalleryFilter

This property contains criteria to used to filter the results of a query.

This property group was introduced in Mobility 1.1.

limit : int

This property contains the maximum number of items returned by a query.

This property group was introduced in Mobility 1.1.

offset : int

This property holds the offset of the first item returned by a query.

This property group was introduced in Mobility 1.1.

read-onlyprogress : real

This property holds the current progress of the request, from 0.0 (started) to 1.0 (finished).

This property group was introduced in Mobility 1.1.

properties : QStringList

This property holds the item properties a query should return values for. All supported properties are listed QDocumentGallery.

This property group was introduced in Mobility 1.1.

rootItem : variant

This property contains the id of an item that a query should return the descendants of.

This property group was introduced in Mobility 1.1.

rootType : enum

This property contains the type of item a query should return. It can be one of:

DocumentGallery.InvalidType
DocumentGallery.File
DocumentGallery.Folder
DocumentGallery.Document
DocumentGallery.Text
DocumentGallery.Audio
DocumentGallery.Image
DocumentGallery.Video
DocumentGallery.Playlist
DocumentGallery.Artist
DocumentGallery.AlbumArtist
DocumentGallery.Album
DocumentGallery.AudioGenre
DocumentGallery.PhotoAlbum

The default value is DocumentGallery.File

Note: On Symbian following rootTypes are not supported: DocumentGallery.Folder, DocumentGallery.Document, DocumentGallery.Text, and DocumentGallery.Playlist.

Note: In some S60 5th Edition (early release) Symbian devices the platform backend requires ReadDeviceData capability to be defined. In addition, in these devices DocumentGallery.Audio rootType is not supported.

This property group was introduced in Mobility 1.1.

scope : enum

The property contains whether a query should count the direct descendants of the rootItem or all descendants.

This property group was introduced in Mobility 1.1.

sortProperties : QStringList

This property holds the properties the results of a query should be sorted on.

Prefixing a property name with the '+' character indicates it should be sorted in ascending order, and a '-' character prefix indicates a descending order. If there is no prefix ascending order is assumed.

This property group was introduced in Mobility 1.1.

read-onlystatus : enum

This property holds the status of a query. It can be one of:

Null No query parameters have been specified.
Active Items matching the query parameters are being fetched from the gallery.
Finished The query has finished
Idle The query is finished and will be automatically updated as new items become available.
Canceling The query was canceled but hasn't yet reached the canceled status.
Canceled The query was canceled.
Error Information about a type could not be retrieved due to an error.

This property group was introduced in Mobility 1.1.

Method Documentation

DocumentGalleryModel::cancel ()

Cancels an executing query.

This documentation was introduced in Mobility 1.1.

DocumentGalleryModel::clear ()

Clears the results of a query.

This documentation was introduced in Mobility 1.1.

DocumentGalleryModel::get ( int index )

Returns the result at index in a query model.

 query.get(0).title

This documentation was introduced in Mobility 1.1.

DocumentGalleryModel::property ( int index, string property )

Returns the value of property from the result at index.

 query.getProperty(0, "title")

This documentation was introduced in Mobility 1.1.

DocumentGalleryModel::reload ()

Re-queries the gallery.

This documentation was introduced in Mobility 1.1.

DocumentGalleryModel::set ( int index, jsobject dict )

Changes the item at index in the list model with the values in dict. Properties not appearing in dict are left unchanged.

This documentation was introduced in Mobility 1.1.

DocumentGalleryModel::setProperty ( int index, string property, variant value )

Changes the property of the result at index in a model to value.

 model.setProperty(0, "rating", 4)

This documentation was introduced in Mobility 1.1.

[+] Documentation Feedback

API Lookup

Qt Topics

Examples

Contents

QML DocumentGalleryModel Element

Properties

Methods

Detailed Description

Property Documentation

Method Documentation