API Documentation

Documentation for developing SailfishOS applications

SilicaGridView QML Type

A Sailfish-styled grid view More...

Import Statement: import Sailfish.Silica 1.0

Properties

pullDownMenu : Item
pushUpMenu : Item
quickScroll : bool
quickScrollAnimating : bool

Methods

scrollToBottom()
scrollToTop()

Detailed Description

The SilicaGridView type provides a GridView with Sailfish-specific behaviors and additional properties.

Below is a simple Sailfish-style grid view:

 import QtQuick 2.2
 import Sailfish.Silica 1.0

 SilicaGridView {
     width: 480; height: 800
     model: ListModel {
         ListElement { fruit: "jackfruit" }
         ListElement { fruit: "orange" }
         ListElement { fruit: "lemon" }
         ListElement { fruit: "lychee" }
         ListElement { fruit: "apricots" }
     }
     delegate: Item {
         width: GridView.view.width
         height: Theme.itemSizeSmall

         Label { text: fruit }
     }
 }

SilicaGridView inherits the QtQuick GridView type, so any properties, signals and methods of GridView (such as the model and delegate properties in the example above) are also available to SilicaGridView objects. See the GridView documentation for its full list of available properties, signals and methods.

Property Documentation

pullDownMenu : Item

The PullDownMenu item assigned to this view, or null if no pull-down menu has been assigned.

pushUpMenu : Item

The PushUpMenu item assigned to this view, or null if no push-up menu has been assigned.

quickScroll : bool

Controls whether a vertical quick scroll area is enabled for the view. If enabled, it is shown when the view's contentHeight is at least three times that of its height. It allows the user to quickly jump to the beginning or the end of the flickable.

By default the quick scroll area is enabled if the view can be scrolled vertically.

quickScrollAnimating : bool

This property is true when the quick scroll functionality has been triggered and the view is quickly animating to the beginning or end of its content area.

Method Documentation

scrollToBottom()

Starts an animation which quickly scrolls the view to its last row.

This does nothing if the view cannot be scrolled vertically.

scrollToTop()

Starts an animation which quickly scrolls the view to its first row.