The QDocumentGallery class provides access to a gallery of documents and media present on a device. More...
#include <QDocumentGallery>
Inherits: QAbstractGallery.
This class was introduced in Qt Mobility 1.1.
enum | Error { NoError, NoGallery, NotSupported, ConnectionError, ..., FilterError } |
QDocumentGallery ( QObject * parent = 0 ) | |
~QDocumentGallery () | |
QStringList | itemTypePropertyNames ( const QString & itemType ) const |
QGalleryProperty::Attributes | propertyAttributes ( const QString & propertyName, const QString & itemType ) const |
virtual bool | isRequestSupported ( QGalleryAbstractRequest::RequestType type ) const |
const QGalleryType | Album |
const QGalleryType | AlbumArtist |
const QGalleryType | Artist |
const QGalleryType | Audio |
const QGalleryType | AudioGenre |
const QGalleryType | Document |
const QGalleryType | File |
const QGalleryType | Folder |
const QGalleryType | Image |
const QGalleryType | PhotoAlbum |
const QGalleryType | Playlist |
const QGalleryType | Text |
const QGalleryType | Video |
const QGalleryProperty | albumArtist |
const QGalleryProperty | albumTitle |
const QGalleryProperty | artist |
const QGalleryProperty | audioBitRate |
const QGalleryProperty | audioCodec |
const QGalleryProperty | author |
const QGalleryProperty | cameraManufacturer |
const QGalleryProperty | cameraModel |
const QGalleryProperty | channelCount |
const QGalleryProperty | comments |
const QGalleryProperty | composer |
const QGalleryProperty | copyright |
const QGalleryProperty | count |
const QGalleryProperty | created |
const QGalleryProperty | dateTaken |
const QGalleryProperty | description |
const QGalleryProperty | director |
const QGalleryProperty | discNumber |
const QGalleryProperty | duration |
const QGalleryProperty | exposureProgram |
const QGalleryProperty | exposureTime |
const QGalleryProperty | fNumber |
const QGalleryProperty | fileExtension |
const QGalleryProperty | fileName |
const QGalleryProperty | filePath |
const QGalleryProperty | fileSize |
const QGalleryProperty | flashEnabled |
const QGalleryProperty | focalLength |
const QGalleryProperty | frameRate |
const QGalleryProperty | genre |
const QGalleryProperty | height |
const QGalleryProperty | keywords |
const QGalleryProperty | language |
const QGalleryProperty | lastAccessed |
const QGalleryProperty | lastModified |
const QGalleryProperty | lastPlayed |
const QGalleryProperty | lyrics |
const QGalleryProperty | meteringMode |
const QGalleryProperty | mimeType |
const QGalleryProperty | orientation |
const QGalleryProperty | pageCount |
const QGalleryProperty | path |
const QGalleryProperty | performer |
const QGalleryProperty | playCount |
const QGalleryProperty | producer |
const QGalleryProperty | rating |
const QGalleryProperty | resumePosition |
const QGalleryProperty | sampleRate |
const QGalleryProperty | subject |
const QGalleryProperty | title |
const QGalleryProperty | trackCount |
const QGalleryProperty | trackNumber |
const QGalleryProperty | url |
const QGalleryProperty | videoBitRate |
const QGalleryProperty | videoCodec |
const QGalleryProperty | whiteBalance |
const QGalleryProperty | width |
const QGalleryProperty | wordCount |
virtual QGalleryAbstractResponse * | createResponse ( QGalleryAbstractRequest * request ) |
The QDocumentGallery class provides access to a gallery of documents and media present on a device.
Requests are the interface through which queries and actions are executed against a QDocumentGallery.
The items present in a QDocumentGallery can be of both file type such as documents and media, or categorical type such as genres or albums.
Currently on Symbian, Folder, Document, Text, and Playlist are not supported.
The item meta-data stored in a QDocumentGallery is addressed through properties.
The set of properties addressable differs between item type but some properties are shared by most types.
Currently on Maemo, only the title property is available for the categorical types.
For Maemo 5, comments is only supported for Document. The property of description is not supported by Document, Video, and Playlist. Also, rating is not supported for Document.
On Symbian, for file types, keywords and subject are not supported, and language is only supported for Video; for categorical types, only title is supported, and url is only supported for PhotoAlbum.
This enum defines errors in a Gallery.
Constant | Value | Description |
---|---|---|
QDocumentGallery::NoError | QGalleryAbstractRequest::NoError | No error. |
QDocumentGallery::NoGallery | QGalleryAbstractRequest::NoGallery | No Gallery defined or found. |
QDocumentGallery::NotSupported | QGalleryAbstractRequest::NotSupported | Gallery is not supported. |
QDocumentGallery::ConnectionError | QGalleryAbstractRequest::GalleryError | Connection to gallery is broken. |
QDocumentGallery::ItemIdError | ? | Id of a item is wrong. |
QDocumentGallery::ItemTypeError | ? | Type of an item is wrong. |
QDocumentGallery::FilterError | ? | Error in filter found. |
Constructs a new document gallery.
The parent is passed to QAbstractGallery.
Destroys a document gallery.
Reimplemented from QAbstractGallery::createResponse().
This function was introduced in Qt Mobility 1.1.
Reimplemented from QAbstractGallery::isRequestSupported().
This function was introduced in Qt Mobility 1.1.
Returns a list of names of properties that are valid for an itemType.
This function was introduced in Qt Mobility 1.1.
Returns the attributes of a property of itemType identified by propertyName
This function was introduced in Qt Mobility 1.1.
This type matches all albums in the document gallery.
Properties typically available from albums include:
Note that only albumTitle is supported on Symbian.
This type matches all album artists in the document gallery.
Properties typically available from album artists include:
Note that only albumArtist and artist are supported on Symbian.
This type matches all artists in the document gallery.
Properties typically available from artists include:
Note that only artist is supported on Symbian.
This type matches all audio files in the document gallery.
In addition to the properties derived from the File type audio files may also provide:
This type matches all audio genres in the document gallery.
Properties typically available from genres include:
Note that only genre is supported on Symbian.
This type matches all document files in the document gallery.
In addition to the properties derived from the File type documents may also provide:
This type matches all files in the document gallery.
Properties typically available from files include:
This type matches all file-system folders in the document gallery.
In addition to the properties derived from the File type folders may also provide:
This type matches all image files in the document gallery.
In addition to the properties derived from the File type image files may also provide:
This type matches all photo albums in the document gallery.
This type matches all playlist files in the document gallery.
In addition to the properties derived from the File type playlist files may also provide:
This type matches all plain text files, e.g. HTML files, in the document gallery.
In addition to the properties derived from the File type text files may also provide:
This type matches all video files in the document gallery.
In addition to the properties derived from the File type video files may also provide:
This property contains the name of the title artist of a music album.
This property contains the title of the album a music track belongs to.
This property contains the names of artists contributing to a music track.
This property contains the bit rate of the audio in a media file.
Note that this property for Video is not supported on Symbian and Maemo 5.
This property contains the name of the codec used to encode audio in a media file.
Note that this property for Video is not supported on Symbian and Maemo 5.
This property contains the name of the author of an item in the document gallery.
This property contains the manufacturer name of the camera used to take a photo.
This property contains the model name of the camera used to take a photo.
This property contains the number of audio channels in a media file.
Note that this property is not supported on Symbian.
This property for Video is not supported on Maemo 5.
This property contains a user comment about an item in the document gallery.
This property contains the name of the composer of a music track.
This property is not supported on Maemo 5.
This property contains a copyright statement for an item in the document gallery.
This property contains the number of items within the scope of a parent item or an item type.
This property contains the date and time a document was created.
This property is not supported on Maemo 5.
This property contains the date and time a photo was taken.
This property contains a description of an item in the document gallery.
This property contains the name of the director of a video.
Note that this property is not supported on Symbian and Maemo 5.
This property contains the disc number of an album in a set.
Note that this property is not supported on Symbian.
This property contains the duration of an audio or video file.
This property contains the name of the exposure program used when taking a photo.
Note that this property is not supported on Maemo.
This property contains the exposure time of a photo in seconds.
This property contains the F-number of a photo.
This property contains the file extension of a file.
Note that this property is not supported on Symbian and Maemo 5.
This property contains the file name excluding the path of a file in the document gallery.
This property contains the absolute path including the file name of a file in the document gallery.
This property contains the size in bytes of a file.
This property contains whether a flash was used when taking a photo.
This property contains the focal length used when taking a photo.
This property contains the frame rate of a video.
This property contains the genre of a media file.
This property contains the height in pixels of an image or video file.
This property contains keywords relevant to an item in the document gallery.
This property contains the language of the content of an item in the document gallery.
This property contains the date and time a file was last accessed.
Note that this property is not supported on Symbian.
This property contains the date and time a file was last modified.
This property contains the date and time an audio or video file was last played.
Note that this property is not supported on Symbian.
This property for Video is not supported on Maemo 5.
This property contains the lyrics to a music track.
Note that this property is not supported on Symbian.
This property contains the metering mode used when taking a photo.
This property contains the MIME type of a file.
This property contains the orientation of an image.
This property contains the number of pages in a document.
This property contains the absolute path excluding the file name of a file in the document gallery.
This property contains the names of performers in a media file.
Note that this property for Video is not supported on Maemo 5.
This property contains the number of times an audio or video file has been played.
This property contains the name of the producer of a media file.
Note that this property for Audio is not supported on Maemo, for Video is not supported on Maemo 5.
This property is not supported on Symbian for neither Audio nor Video.
This property contains a rating for an item in the document gallery.
This property contains the position in a video where playback was interrupted.
This property contains the sample rate of the audio in a media file.
Note that this property for Video is not supported on Symbian and Maemo 5.
This property contains the subject of item in the document gallery.
This property contains the title of an item in the document gallery.
This property contains the number of music tracks in an album.
This property contains the track number of a music track in an album.
This property contains canonical url of an item in the document gallery.
This property contains the bit rate of the video in a media file.
This property contains the codec used to encode the video in a media file.
Note that this property is not supported on Symbian.
This property contains the white balance setting used when taking a photo.
This property contains the width in pixels of an image or video file.
This property contains the number of words in document.
This property for Text is not supported on Maemo 5.
© 2008-2011 Nokia Corporation and/or its subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide.
All other trademarks are property of their respective owners. Privacy Policy
Licensees holding valid Qt Commercial licenses may use this document in accordance with the Qt Commercial License Agreement provided with the Software or, alternatively, in accordance with the terms contained in a written agreement between you and Nokia.
Alternatively, this document may be used under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.