ImageModel QML Type | Qt Location 5.4

- Qt 5.4
- Qt Location
- QML Types
- ImageModel QML Type
- Qt 5.4.2 Reference Documentation

# ImageModel QML Type

The ImageModel type provides a model of place images. More...

Import Statement: | import QtLocation 5.3
Since: | Qt Location 5.0

- List of all members, including inherited members

## Properties

- batchSize : int
- place : Place
- totalCount : int

## Detailed Description

The ImageModel is a read-only model used to fetch images related to a Place. Binding a Place via ImageModel::place initiates an initial fetch of images. The model performs fetches incrementally and is intended to be used in conjunction with a View such as a ListView. When the View reaches the last of the images currently in the model, a fetch is performed to retrieve more if they are available. The View is automatically updated as the images are received. The number of images which are fetched at a time is specified by the batchSize property. The total number of images available can be accessed via the totalCount property.

The model returns data for the following roles:

Role | Type | Description
--- | --- | ---
url | url | The URL of the image.
imageId | string | The identifier of the image.
mimeType | string | The MIME type of the image.
supplier | Supplier | The supplier of the image.
user | User | The user who contributed the image.
attribution | string | Attribution text which must be displayed when displaying the image.

## Example

The following example shows how to display images for a place:

    import QtQuick 2.0
    import QtPositioning 5.2
    import QtLocation 5.3

    ImageModel {
        id: imageModel
        batchSize: 3
        place: place
    }

    ListView {
        anchors.top: parent.top
        width: parent.width
        spacing: 10

        model: imageModel
        orientation: ListView.Horizontal
        snapMode: ListView.SnapOneItem

        delegate: Item {
            width: listView.width
            height: listView.height

            Image {
                anchors.fill: parent
                source: url
                fillMode: Image.PreserveAspectFit
            }

            Text {
                text: supplier.name + "\n" + supplier.url
                width: parent.width
                anchors.bottom: parent.bottom
            }
        }
    }

## Property Documentation

batchSize : int

This property holds the batch size to use when fetching more image items.

place : Place

This property holds the Place that the images are for.

totalCount : int

This property holds the total number of image items for the place.