ImageModel QML Type | Qt Location 5.13.2

Qt 5.13 | Qt Location | QML Types | ImageModel QML Type

Qt 5.13.2 Reference Documentation

# ImageModel QML Type

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

Import Statement: | import QtLocation 5.13
Since: | QtLocation 5.5

- 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.5
      import QtLocation 5.6

      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.