/* * Copyright (C) 2011-2015 Canonical Ltd. * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License version 3 as * published by the Free Software Foundation. * * 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 . * * Authors: * Jim Nelson * Lucas Beeler * Charles Lindsay */ import QtQuick 2.9 import Lomiri.Components 1.3 import "../../js/Gallery.js" as Gallery import "../../js/GalleryUtility.js" as GalleryUtility import "../Utility" /*! */ Page { id: checkerboard /*! */ signal activated(variant object, variant objectModel, variant activatedRect, Item activatingItem) /*! */ signal movementStarted() /*! */ signal movementEnded() /*! */ signal hidden(int currScrollPos) /*! */ property alias model: grid.model /*! */ property alias delegate: grid.delegate /*! */ property alias contentX: grid.contentX /*! */ property alias contentY: grid.contentY /*! */ property alias footer: grid.footer /*! */ property real itemWidth /*! */ property real itemHeight /*! */ property real minGutterWidth /*! */ property real minGutterHeight /*! */ property real topExtraGutter: 0 /*! */ property real bottomExtraGutter: 0 /*! */ property real leftExtraGutter: 0 /*! */ property real rightExtraGutter: 0 /*! */ property SelectionState selection // readonly /*! */ property real delegateWidth: itemWidth + gutterWidth /*! */ property real delegateHeight: itemHeight + gutterHeight // internal /*! */ property real itemAreaWidth: width - leftExtraGutter - rightExtraGutter /*! */ property real minDelegateWidth: itemWidth + minGutterWidth /*! */ property int columns: Math.max(1, Math.floor(itemAreaWidth / minDelegateWidth)) /*! */ property real gutterWidth: Math.floor(itemAreaWidth / columns - itemWidth) /*! */ property real gutterHeight: minGutterHeight /*! */ function ensureIndexVisible(index, centered) { grid.positionViewAtIndex(index, centered ? GridView.Center : GridView.Visible); } /*! */ function setScrollPos(newScrollPos) { contentY = newScrollPos; } /*! */ function scrollToTop() { gridScroller.restart(); } // Ensures the view is inside its normal bounds after you've mucked with // things manually. function returnToBounds() { grid.returnToBounds(); } // Uses black magic to hunt for the delegate instance with the given index. // Returns undefined if there's no currently-instantiated delegate with that // index. function getDelegateInstanceAt(index) { for(var i = 0; i < grid.contentItem.children.length; ++i) { var item = grid.contentItem.children[i]; // We have to check for the specific objectName we gave our delegates in // CheckerboardDelegate, since we also get some items that were not our // delegates here. if (item.objectName == "checkerboardDelegate" && item.index == index) return item; } return undefined; } /*! */ function getRectOfItem(item, relativeTo, adjustForGutter) { var rect = GalleryUtility.getRectRelativeTo(item, relativeTo); if (adjustForGutter) { // Now we have to adjust for the gutter inside the delegate. rect.x += gutterWidth / 2; rect.y += gutterHeight / 2; rect.width -= gutterWidth; rect.height -= gutterHeight; } return rect; } // Uses getDelegateInstanceAt() to get the delegate instance with the given // index, then returns a rect with its coords relative to the given object. function getRectOfItemAt(index, relativeTo) { var item = getDelegateInstanceAt(index); return (item) ? getRectOfItem(item, relativeTo, true) : undefined; } /*! */ function getVisibleDelegates() { return GalleryUtility.getVisibleItems(grid, grid, function(child) { return child.objectName == "checkerboardDelegate" }); } onVisibleChanged: { if(!visible) { // Tell other parts of the application how far we've scrolled; // used in places where the contentY's of two or more checkerboards // must stay in sync. hidden(contentY); } } clip: true GridView { id: grid objectName: "grid" anchors.fill: parent anchors.topMargin: topExtraGutter anchors.bottomMargin: bottomExtraGutter anchors.leftMargin: leftExtraGutter anchors.rightMargin: rightExtraGutter cellWidth: delegateWidth cellHeight: delegateHeight flickDeceleration: 800 onMovementStarted: checkerboard.movementStarted() onMovementEnded: checkerboard.movementEnded() // "Grid-shift" transition displaced: Transition { NumberAnimation { easing.type: Easing.InQuint properties: "x,y" duration: Gallery.FAST_DURATION } } } NumberAnimation { id: gridScroller target: grid property: "contentY" to: 0 easing.type: Easing.OutQuad duration: 200 } }