2011-10-30 14:12:14 +01:00
|
|
|
/****************************************************************************
|
|
|
|
**
|
|
|
|
** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
|
|
|
|
** All rights reserved.
|
|
|
|
** Contact: Nokia Corporation (qt-info@nokia.com)
|
|
|
|
**
|
|
|
|
** This file is part of the Qt Components project.
|
|
|
|
**
|
|
|
|
** $QT_BEGIN_LICENSE:BSD$
|
|
|
|
** You may use this file under the terms of the BSD license as follows:
|
|
|
|
**
|
|
|
|
** "Redistribution and use in source and binary forms, with or without
|
|
|
|
** modification, are permitted provided that the following conditions are
|
|
|
|
** met:
|
|
|
|
** * Redistributions of source code must retain the above copyright
|
|
|
|
** notice, this list of conditions and the following disclaimer.
|
|
|
|
** * Redistributions in binary form must reproduce the above copyright
|
|
|
|
** notice, this list of conditions and the following disclaimer in
|
|
|
|
** the documentation and/or other materials provided with the
|
|
|
|
** distribution.
|
|
|
|
** * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor
|
|
|
|
** the names of its contributors may be used to endorse or promote
|
|
|
|
** products derived from this software without specific prior written
|
|
|
|
** permission.
|
|
|
|
**
|
|
|
|
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
|
|
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
|
|
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
|
|
|
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
|
|
|
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
|
|
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
|
|
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
|
|
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
|
|
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
|
|
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
|
|
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
|
|
|
|
** $QT_END_LICENSE$
|
|
|
|
**
|
|
|
|
****************************************************************************/
|
2011-12-22 11:53:15 +01:00
|
|
|
/**Documented API
|
2011-11-02 02:32:04 +01:00
|
|
|
Inherits:
|
|
|
|
Item
|
|
|
|
|
|
|
|
Imports:
|
|
|
|
QtQuick 1.1
|
|
|
|
org.kde.plasma.core
|
|
|
|
|
|
|
|
Description:
|
|
|
|
It's similar to a ScrollBar or a ScrollDecorator.
|
|
|
|
It's interactive and works on ListViews that have section.property set,
|
|
|
|
so its contents are categorized.
|
|
|
|
An indicator will say to what category the user scrolled to.
|
|
|
|
Useful for things like address books or things sorted by date.
|
|
|
|
Don't use with models too big (thousands of items) because implies
|
|
|
|
loading all the items to memory, as well loses precision.
|
|
|
|
|
|
|
|
Properties:
|
|
|
|
ListView listView:
|
2011-12-22 18:40:15 +01:00
|
|
|
As The ScrollBar, this is the listview the sectionScroller will operate on. This component doesn't work with simple Flickable or GridView.
|
2011-11-02 02:32:04 +01:00
|
|
|
**/
|
2011-10-30 14:12:14 +01:00
|
|
|
|
|
|
|
import QtQuick 1.1
|
2011-12-22 14:16:01 +01:00
|
|
|
import "private/SectionScroller.js" as Sections
|
2011-10-30 14:12:14 +01:00
|
|
|
import org.kde.plasma.core 0.1 as PlasmaCore
|
|
|
|
|
|
|
|
Item {
|
|
|
|
id: root
|
|
|
|
|
2012-01-16 13:58:36 +01:00
|
|
|
/*
|
2011-10-30 14:12:14 +01:00
|
|
|
* The listview this scroll indicator will work on
|
|
|
|
*/
|
|
|
|
property ListView listView
|
|
|
|
|
|
|
|
onListViewChanged: {
|
|
|
|
if (listView && listView.model)
|
|
|
|
internal.initDirtyObserver();
|
|
|
|
}
|
|
|
|
|
|
|
|
Connections {
|
|
|
|
target: listView
|
|
|
|
onModelChanged: {
|
2011-10-30 16:51:41 +01:00
|
|
|
if (listView && listView.model) {
|
|
|
|
internal.initDirtyObserver()
|
|
|
|
}
|
|
|
|
}
|
2011-10-30 14:12:14 +01:00
|
|
|
}
|
|
|
|
|
2011-11-09 16:53:58 +01:00
|
|
|
width: 22
|
2011-10-30 16:51:41 +01:00
|
|
|
Behavior on opacity {
|
|
|
|
NumberAnimation {
|
|
|
|
duration: 250
|
|
|
|
}
|
|
|
|
}
|
2011-10-30 14:12:14 +01:00
|
|
|
|
|
|
|
anchors {
|
|
|
|
right: listView.right
|
|
|
|
top: listView.top
|
|
|
|
bottom: listView.bottom
|
|
|
|
}
|
|
|
|
|
2011-10-30 16:51:41 +01:00
|
|
|
|
2011-10-30 14:12:14 +01:00
|
|
|
RangeModel {
|
|
|
|
id: range
|
|
|
|
|
|
|
|
minimumValue: 0
|
|
|
|
maximumValue: Math.max(0, listView.contentHeight - listView.height)
|
|
|
|
stepSize: 0
|
|
|
|
//inverted: true
|
2011-11-09 16:53:58 +01:00
|
|
|
positionAtMinimum: root.width*2
|
|
|
|
positionAtMaximum: root.height - root.width*2
|
2011-10-30 14:12:14 +01:00
|
|
|
value: listView.contentY
|
2011-11-09 16:53:58 +01:00
|
|
|
onPositionChanged: sectionLabel.text = Sections.closestSection(position/listView.height)
|
2011-10-30 14:12:14 +01:00
|
|
|
|
|
|
|
}
|
|
|
|
|
2011-11-09 16:53:58 +01:00
|
|
|
ScrollBar {
|
|
|
|
id: scrollBar
|
|
|
|
flickableItem: listView
|
|
|
|
anchors.fill: parent
|
|
|
|
interactive: true
|
2011-10-30 14:12:14 +01:00
|
|
|
}
|
|
|
|
PlasmaCore.FrameSvgItem {
|
|
|
|
imagePath: "widgets/tooltip"
|
2011-11-14 18:05:57 +01:00
|
|
|
width: sectionLabel.paintedWidth + margins.left + margins.right
|
|
|
|
height: sectionLabel.paintedHeight + margins.top + margins.bottom
|
2011-10-30 14:12:14 +01:00
|
|
|
Label {
|
|
|
|
id: sectionLabel
|
|
|
|
font.pointSize: theme.defaultFont.pointSize*3
|
|
|
|
x: parent.margins.left
|
|
|
|
y: parent.margins.top
|
|
|
|
}
|
2011-11-09 16:53:58 +01:00
|
|
|
y: Math.min(root.height-height-scrollBar.width, Math.max(scrollBar.width, range.position - height/2))
|
2011-10-30 14:12:14 +01:00
|
|
|
anchors {
|
|
|
|
//verticalCenter: handle.verticalCenter
|
|
|
|
right: parent.left
|
|
|
|
}
|
2011-11-09 16:53:58 +01:00
|
|
|
opacity: sectionLabel.text && scrollBar.pressed?1:0
|
2011-10-30 14:12:14 +01:00
|
|
|
Behavior on opacity {
|
|
|
|
NumberAnimation {
|
|
|
|
duration: 250
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
QtObject {
|
|
|
|
id: internal
|
|
|
|
|
|
|
|
function initDirtyObserver() {
|
|
|
|
Sections.initSectionData(listView);
|
|
|
|
function dirtyObserver() {
|
|
|
|
if (!internal.modelDirty) {
|
|
|
|
internal.modelDirty = true;
|
|
|
|
dirtyTimer.running = true;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if (listView.model.countChanged)
|
|
|
|
listView.model.countChanged.connect(dirtyObserver);
|
|
|
|
|
|
|
|
if (listView.model.itemsChanged)
|
|
|
|
listView.model.itemsChanged.connect(dirtyObserver);
|
|
|
|
|
|
|
|
if (listView.model.itemsInserted)
|
|
|
|
listView.model.itemsInserted.connect(dirtyObserver);
|
|
|
|
|
|
|
|
if (listView.model.itemsMoved)
|
|
|
|
listView.model.itemsMoved.connect(dirtyObserver);
|
|
|
|
|
|
|
|
if (listView.model.itemsRemoved)
|
|
|
|
listView.model.itemsRemoved.connect(dirtyObserver);
|
|
|
|
|
|
|
|
sectionsRepeater.model = Sections._sections.length
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|