/* * Copyright (C) 2013 Canonical, Ltd. * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; version 3. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . */ import QtQuick 2.4 import QtQuick.Window 2.4 import Lomiri.Components 1.3 import Lomiri.Components.Popups 1.3 as Popups /*! \qmltype ContactSimpleListView \inqmlmodule Lomiri.Contacts 0.1 \ingroup ubuntu \brief The MultipleSelectionListView provides a ListView with support to multiple selection The MultipleSelectionListViewprovides a ListView with support to multiple selection which can be used by any application. Example: \qml import Lomiri.Contacts 0.1 MultipleSelectionListView { id: view anchors.fill: paret model: 100 delegate: Rectangle { width: parent.width height: 100 color: view.selectedItems.indexOf(index) == -1 ? "white" : "blue" MouseArea { anchors.fill: parent onClicked: { if (view.isInSelectionModel) { view.selectItem(index) } } onPressAndHold: view.startSelection() } } onSelectionDone: console.debug("Selected items:" + view.selectedItems) } \endqml */ ListView { id: listView /*! \qmlproperty model selectedItems This property holds the list of selected items */ readonly property alias selectedItems: visualModel.selectedItems /*! \qmlproperty bool multipleSelection This property holds if the selection will accept multiple items or single items */ property bool multipleSelection: true /*! \qmlproperty model listModel This property holds the model providing data for the list. */ property alias listModel: visualModel.model /*! \qmlproperty Component listDelegate The delegate provides a template defining each item instantiated by the view. */ property alias listDelegate: visualModel.delegate /*! \qmlproperty bool isInSelectionMode This property holds a list with the index of selected items */ readonly property bool isInSelectionMode: state === "selection" /*! This handler is called when the selection mode is finished without be canceled */ signal selectionDone(var items) /*! This handler is called when the selection mode is canceled */ signal selectionCanceled() /*! Start the selection mode on the list view. */ function startSelection() { state = "selection" } /*! Check if the item is selected Returns true if the item was marked as selected or false if the item is unselected */ function isSelected(item) { if (item && item.VisualDataModel) { return (item.VisualDataModel.inSelected === true) } else { return false } } /*! Mark the item as selected Returns true if the item was marked as selected or false if the item is already selected */ function selectItem(item) { if (item.VisualDataModel.inSelected) { return false } else { if (!multipleSelection) { clearSelection() } item.VisualDataModel.inSelected = true return true } } /*! Remove the index from the selected list */ function deselectItem(item) { var result = false if (item.VisualDataModel.inSelected) { item.VisualDataModel.inSelected = false result = true } return result } /*! Finish the selection mode with sucess */ function endSelection() { selectionDone(listView.selectedItems) clearSelection() state = "" } /*! Cancel the selection */ function cancelSelection() { selectionCanceled() clearSelection() state = "" } /*! Remove any selected item from the selection list */ function clearSelection() { if (selectedItems.count > 0) { selectedItems.remove(0, selectedItems.count) } } /*! Select all items in the list */ function selectAll() { if (multipleSelection) { visualModel.items.addGroups(0, visualModel.items.count, ["selected"] ) } } model: visualModel MultipleSelectionVisualModel { id: visualModel } Component.onCompleted: { // "Screen.devicePixelRatio === 1" means scaling is managed by the OS, in that case tune scroll velocity var defaultGridPixel = 8 if (Screen.devicePixelRatio === 1 && Math.floor(units.gu(1)) != defaultGridPixel ) { var scaleFactor = units.gridUnit / defaultGridPixel; maximumFlickVelocity = maximumFlickVelocity * scaleFactor; flickDeceleration = flickDeceleration * scaleFactor; } } }