Qt Mobility Reference Documentation

QML GalleryQueryCount Element

The GalleryQueryCount element allows you to fetch the number of items matching a gallery query. More...

Properties

Signals

Methods

Detailed Description

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

See also GalleryQueryModel and GalleryItem.


Property Documentation

count : int

This property holds the number of items matching a query.


currentProgress : int

This property holds the current progress value.


filter : GalleryFilter

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


This property holds the gallery a query should return results from.


itemType : string

This property contains the type of item a query should return.


live : bool

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


maximumProgress : int

This property holds the maximum progress value.


properties : stringlist

This property holds the item properties a query should return values for.


result : enum

The property holds the result of a query. It can be one of:

  • NoResult The query is still executing.
  • Succeeded The query finished successfully.
  • Cancelled The query was cancelled.
  • NoGallery No gallery was set on the query.
  • NotSupported Count queries are not supported by the gallery.
  • ConnectionError The query failed due to a connection error.
  • InvalidItemError The query failed because the value of scopeItemId is not a valid item ID.
  • ItemTypeError The query failed because the value of itemType is not a valid item type.
  • InvalidPropertyError The query failed because the filter refers to an invalid property.
  • PropertyTypeError The query failed because the type of a value in the filter is incompatible with the property.
  • UnsupportedFilterTypeError The query failed because the set filter is not supported by the gallery.
  • UnsupportedFilterOptionError The query failed because an option of a filter is not supported by the gallery.

scope : enum

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


scopeItemId : variant

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


state : enum

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

  • Inactive The query has finished.
  • Active The query is currently executing.
  • Cancelling The query has been cancelled, but has yet reached the Inactive state.
  • Idle The query has finished and is monitoring its result set for changes.

Signal Documentation

GalleryQueryCount::onCancelled ()

Signals that a query was cancelled.


GalleryQueryCount::onFailed ( error )

Signals that a query failed with the given error.


GalleryQueryCount::onFinished ( result )

Signals that a query finished with the given result.


GalleryQueryCount::onSucceeded ()

Signals that a query has finished successfully.


Method Documentation

GalleryQueryCount::cancel ()

Cancels an executing query.


GalleryQueryCount::clear ()

Clears the results of a query.


GalleryQueryCount::reload ()

Re-queries the gallery.



Copyright © 2009-2010 Nokia Corporation and/or its subsidiary(-ies) Trademarks
Qt Mobility Project 1.1.0