API Documentation

Documentation for developing SailfishOS applications

CoverActionList QML Type

A list of cover actions More...

Import Statement: import Sailfish.Silica 1.0


Detailed Description

A CoverActionList adds cover actions to a Cover.

A CoverActionList is added to a Cover by declaring it as a child of the cover, and adding the actions to the list. The action icons are automatically displayed on top of the cover, and they are triggered when the icons are tapped.

 import QtQuick 2.2
 import Sailfish.Silica 1.0

 ApplicationWindow {
     cover: Component {
         Cover {
             CoverActionList {
                 enabled: mode == "music"

                 CoverAction {
                     iconSource: player.playing ? "image://theme/icon-cover-pause" : "image://theme/icon-cover-play"
                     onTriggered: player.togglePlaying()

Note: While it is possible to have two cover actions on a cover, it is recommended to follow the style of the majority of Sailfish platform apps and only show one cover action.

See also CoverAction and Sailfish Application Features.

Property Documentation

enabled : bool

This property holds whether this CoverActionList is active. Only one CoverActionList should be enabled at a time.

iconBackground : bool

This property holds whether this CoverActionList has background. This should be enabled when cover actions are not visible from cover content.

window : QWindow

In applications with multiple windows this property can be set to explicitly define the window on which the cover actions will be shown. Expects a QWindow-derived type.

We use cookies to improve your user experience and to help us to develop our services. By continuing to browse the site, you approve of our use of cookies.