1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
/*
Copyright (c) 2018 Michael Bohlender <michael.bohlender@kdemail.net>
Copyright (c) 2018 Christian Mollekopf <mollekopf@kolabsys.com>
Copyright (c) 2018 Rémi Nicole <minijackson@riseup.net>
This library is free software; you can redistribute it and/or modify it
under the terms of the GNU Library General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
This library 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 Library General Public
License for more details.
You should have received a copy of the GNU Library General Public License
along with this library; see the file COPYING.LIB. If not, write to the
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301, USA.
*/
#pragma once
#include <sink/applicationdomaintype.h>
#include <QAbstractItemModel>
#include <QList>
#include <QSharedPointer>
#include <QVector>
#include <limits>
// Facility used to get a restricted period into a Sink model comprised of
// events, partitioned according to the day the events take place.
//
// Model Format
// ============
//
// Day 0
// |--- Event 0 starting at `periodStart + 0d`
// |--- Event 1 starting at `periodStart + 0d`
// '--- Event 2 starting at `periodStart + 0d`
// Day 1
// '--- Event 0 starting at `periodStart + 1d`
// Day 2
// Day 3
// |--- Event 0 starting at `periodStart + 3d`
// '--- Event 1 starting at `periodStart + 3d`
// Day 4
// ⋮
//
// Implementation notes
// ====================
//
// On the model side
// -----------------
//
// Columns are never used.
//
// Top-level items just contains the ".events" attribute, and their rows
// correspond to their offset compared to the start of the period (in number of
// days). In that case the internalId contains DAY_ID.
//
// Direct children are events, and their rows corresponds to their index in
// their partition. In that case no internalId / internalPointer is used.
//
// Internally:
// -----------
//
// On construction and on dataChanged, all events are processed and partitioned
// in partitionedEvents:
//
// QVector< QList<QSharedPointer<Event> >
// ~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~
// | |
// | '--- List of event pointers for that day
// '--- Partition / day
//
class PeriodDayEventModel : public QAbstractItemModel
{
Q_OBJECT
Q_PROPERTY(QVariant start READ periodStart WRITE setPeriodStart)
Q_PROPERTY(int length READ periodLength WRITE setPeriodLength)
public:
using Event = Sink::ApplicationDomain::Event;
enum Roles
{
Events = Qt::UserRole + 1,
Summary,
Description,
StartTime,
Duration,
};
Q_ENUM(Roles);
PeriodDayEventModel(QObject *parent = nullptr);
~PeriodDayEventModel() = default;
QModelIndex index(int row, int column, const QModelIndex &parent = {}) const override;
QModelIndex parent(const QModelIndex &index) const override;
int rowCount(const QModelIndex &parent) const override;
int columnCount(const QModelIndex &parent) const override;
QVariant data(const QModelIndex &index, int role) const override;
QHash<int, QByteArray> roleNames() const override;
QDate periodStart() const;
void setPeriodStart(const QDate &);
void setPeriodStart(const QVariant &);
int periodLength() const;
void setPeriodLength(int);
private:
void partitionData();
int bucketOf(const QDate &candidate) const;
QDate mPeriodStart;
int mPeriodLength = 7;
QSharedPointer<QAbstractItemModel> eventModel;
QVector<QList<QSharedPointer<Event>>> partitionedEvents;
static const constexpr quintptr DAY_ID = std::numeric_limits<quintptr>::max();
};
|
