2 * SPDX-FileCopyrightText: 2011 Peter Penz <peter.penz19@gmail.com>
3 * SPDX-FileCopyrightText: 2013 Frank Reininghaus <frank78ac@googlemail.com>
4 * SPDX-FileCopyrightText: 2013 Emmanuel Pescosta <emmanuelpescosta099@gmail.com>
6 * SPDX-License-Identifier: GPL-2.0-or-later
9 #include "kfileitemmodel.h"
11 #include "dolphin_generalsettings.h"
12 #include "dolphin_detailsmodesettings.h"
13 #include "dolphindebug.h"
14 #include "private/kfileitemmodeldirlister.h"
15 #include "private/kfileitemmodelsortalgorithm.h"
17 #include <KLocalizedString>
18 #include <KUrlMimeData>
20 #include <QElapsedTimer>
26 Q_GLOBAL_STATIC_WITH_ARGS(QMutex
, s_collatorMutex
, (QMutex::Recursive
))
28 // #define KFILEITEMMODEL_DEBUG
30 KFileItemModel::KFileItemModel(QObject
* parent
) :
31 KItemModelBase("text", parent
),
33 m_sortDirsFirst(true),
35 m_sortingProgressPercent(-1),
42 m_maximumUpdateIntervalTimer(nullptr),
43 m_resortAllItemsTimer(nullptr),
44 m_pendingItemsToInsert(),
49 m_collator
.setNumericMode(true);
51 loadSortingSettings();
53 m_dirLister
= new KFileItemModelDirLister(this);
54 m_dirLister
->setDelayedMimeTypes(true);
56 const QWidget
* parentWidget
= qobject_cast
<QWidget
*>(parent
);
58 m_dirLister
->setMainWindow(parentWidget
->window());
61 connect(m_dirLister
, &KFileItemModelDirLister::started
, this, &KFileItemModel::directoryLoadingStarted
);
62 connect(m_dirLister
, QOverload
<>::of(&KCoreDirLister::canceled
), this, &KFileItemModel::slotCanceled
);
63 connect(m_dirLister
, QOverload
<const QUrl
&>::of(&KCoreDirLister::completed
), this, &KFileItemModel::slotCompleted
);
64 connect(m_dirLister
, &KFileItemModelDirLister::itemsAdded
, this, &KFileItemModel::slotItemsAdded
);
65 connect(m_dirLister
, &KFileItemModelDirLister::itemsDeleted
, this, &KFileItemModel::slotItemsDeleted
);
66 connect(m_dirLister
, &KFileItemModelDirLister::refreshItems
, this, &KFileItemModel::slotRefreshItems
);
67 connect(m_dirLister
, QOverload
<>::of(&KCoreDirLister::clear
), this, &KFileItemModel::slotClear
);
68 connect(m_dirLister
, &KFileItemModelDirLister::infoMessage
, this, &KFileItemModel::infoMessage
);
69 connect(m_dirLister
, &KFileItemModelDirLister::errorMessage
, this, &KFileItemModel::errorMessage
);
70 connect(m_dirLister
, &KFileItemModelDirLister::percent
, this, &KFileItemModel::directoryLoadingProgress
);
71 connect(m_dirLister
, QOverload
<const QUrl
&, const QUrl
&>::of(&KCoreDirLister::redirection
), this, &KFileItemModel::directoryRedirection
);
72 connect(m_dirLister
, &KFileItemModelDirLister::urlIsFileError
, this, &KFileItemModel::urlIsFileError
);
74 // Apply default roles that should be determined
76 m_requestRole
[NameRole
] = true;
77 m_requestRole
[IsDirRole
] = true;
78 m_requestRole
[IsLinkRole
] = true;
79 m_roles
.insert("text");
80 m_roles
.insert("isDir");
81 m_roles
.insert("isLink");
82 m_roles
.insert("isHidden");
84 // For slow KIO-slaves like used for searching it makes sense to show results periodically even
85 // before the completed() or canceled() signal has been emitted.
86 m_maximumUpdateIntervalTimer
= new QTimer(this);
87 m_maximumUpdateIntervalTimer
->setInterval(2000);
88 m_maximumUpdateIntervalTimer
->setSingleShot(true);
89 connect(m_maximumUpdateIntervalTimer
, &QTimer::timeout
, this, &KFileItemModel::dispatchPendingItemsToInsert
);
91 // When changing the value of an item which represents the sort-role a resorting must be
92 // triggered. Especially in combination with KFileItemModelRolesUpdater this might be done
93 // for a lot of items within a quite small timeslot. To prevent expensive resortings the
94 // resorting is postponed until the timer has been exceeded.
95 m_resortAllItemsTimer
= new QTimer(this);
96 m_resortAllItemsTimer
->setInterval(500);
97 m_resortAllItemsTimer
->setSingleShot(true);
98 connect(m_resortAllItemsTimer
, &QTimer::timeout
, this, &KFileItemModel::resortAllItems
);
100 connect(GeneralSettings::self(), &GeneralSettings::sortingChoiceChanged
, this, &KFileItemModel::slotSortingChoiceChanged
);
103 KFileItemModel::~KFileItemModel()
105 qDeleteAll(m_itemData
);
106 qDeleteAll(m_filteredItems
);
107 qDeleteAll(m_pendingItemsToInsert
);
110 void KFileItemModel::loadDirectory(const QUrl
&url
)
112 m_dirLister
->openUrl(url
);
115 void KFileItemModel::refreshDirectory(const QUrl
&url
)
117 // Refresh all expanded directories first (Bug 295300)
118 QHashIterator
<QUrl
, QUrl
> expandedDirs(m_expandedDirs
);
119 while (expandedDirs
.hasNext()) {
121 m_dirLister
->openUrl(expandedDirs
.value(), KDirLister::Reload
);
124 m_dirLister
->openUrl(url
, KDirLister::Reload
);
127 QUrl
KFileItemModel::directory() const
129 return m_dirLister
->url();
132 void KFileItemModel::cancelDirectoryLoading()
137 int KFileItemModel::count() const
139 return m_itemData
.count();
142 QHash
<QByteArray
, QVariant
> KFileItemModel::data(int index
) const
144 if (index
>= 0 && index
< count()) {
145 ItemData
* data
= m_itemData
.at(index
);
146 if (data
->values
.isEmpty()) {
147 data
->values
= retrieveData(data
->item
, data
->parent
);
152 return QHash
<QByteArray
, QVariant
>();
155 bool KFileItemModel::setData(int index
, const QHash
<QByteArray
, QVariant
>& values
)
157 if (index
< 0 || index
>= count()) {
161 QHash
<QByteArray
, QVariant
> currentValues
= data(index
);
163 // Determine which roles have been changed
164 QSet
<QByteArray
> changedRoles
;
165 QHashIterator
<QByteArray
, QVariant
> it(values
);
166 while (it
.hasNext()) {
168 const QByteArray role
= sharedValue(it
.key());
169 const QVariant value
= it
.value();
171 if (currentValues
[role
] != value
) {
172 currentValues
[role
] = value
;
173 changedRoles
.insert(role
);
177 if (changedRoles
.isEmpty()) {
181 m_itemData
[index
]->values
= currentValues
;
182 if (changedRoles
.contains("text")) {
183 QUrl url
= m_itemData
[index
]->item
.url();
184 url
= url
.adjusted(QUrl::RemoveFilename
);
185 url
.setPath(url
.path() + currentValues
["text"].toString());
186 m_itemData
[index
]->item
.setUrl(url
);
189 emitItemsChangedAndTriggerResorting(KItemRangeList() << KItemRange(index
, 1), changedRoles
);
194 void KFileItemModel::setSortDirectoriesFirst(bool dirsFirst
)
196 if (dirsFirst
!= m_sortDirsFirst
) {
197 m_sortDirsFirst
= dirsFirst
;
202 bool KFileItemModel::sortDirectoriesFirst() const
204 return m_sortDirsFirst
;
207 void KFileItemModel::setShowHiddenFiles(bool show
)
209 m_dirLister
->setShowingDotFiles(show
);
210 m_dirLister
->emitChanges();
212 dispatchPendingItemsToInsert();
216 bool KFileItemModel::showHiddenFiles() const
218 return m_dirLister
->showingDotFiles();
221 void KFileItemModel::setShowDirectoriesOnly(bool enabled
)
223 m_dirLister
->setDirOnlyMode(enabled
);
226 bool KFileItemModel::showDirectoriesOnly() const
228 return m_dirLister
->dirOnlyMode();
231 QMimeData
* KFileItemModel::createMimeData(const KItemSet
& indexes
) const
233 QMimeData
* data
= new QMimeData();
235 // The following code has been taken from KDirModel::mimeData()
236 // (kdelibs/kio/kio/kdirmodel.cpp)
237 // SPDX-FileCopyrightText: 2006 David Faure <faure@kde.org>
239 QList
<QUrl
> mostLocalUrls
;
240 const ItemData
* lastAddedItem
= nullptr;
242 for (int index
: indexes
) {
243 const ItemData
* itemData
= m_itemData
.at(index
);
244 const ItemData
* parent
= itemData
->parent
;
246 while (parent
&& parent
!= lastAddedItem
) {
247 parent
= parent
->parent
;
250 if (parent
&& parent
== lastAddedItem
) {
251 // A parent of 'itemData' has been added already.
255 lastAddedItem
= itemData
;
256 const KFileItem
& item
= itemData
->item
;
257 if (!item
.isNull()) {
261 mostLocalUrls
<< item
.mostLocalUrl(&isLocal
);
265 KUrlMimeData::setUrls(urls
, mostLocalUrls
, data
);
269 int KFileItemModel::indexForKeyboardSearch(const QString
& text
, int startFromIndex
) const
271 startFromIndex
= qMax(0, startFromIndex
);
272 for (int i
= startFromIndex
; i
< count(); ++i
) {
273 if (fileItem(i
).text().startsWith(text
, Qt::CaseInsensitive
)) {
277 for (int i
= 0; i
< startFromIndex
; ++i
) {
278 if (fileItem(i
).text().startsWith(text
, Qt::CaseInsensitive
)) {
285 bool KFileItemModel::supportsDropping(int index
) const
287 const KFileItem item
= fileItem(index
);
288 return !item
.isNull() && (item
.isDir() || item
.isDesktopFile());
291 QString
KFileItemModel::roleDescription(const QByteArray
& role
) const
293 static QHash
<QByteArray
, QString
> description
;
294 if (description
.isEmpty()) {
296 const RoleInfoMap
* map
= rolesInfoMap(count
);
297 for (int i
= 0; i
< count
; ++i
) {
298 if (!map
[i
].roleTranslation
) {
301 description
.insert(map
[i
].role
, i18nc(map
[i
].roleTranslationContext
, map
[i
].roleTranslation
));
305 return description
.value(role
);
308 QList
<QPair
<int, QVariant
> > KFileItemModel::groups() const
310 if (!m_itemData
.isEmpty() && m_groups
.isEmpty()) {
311 #ifdef KFILEITEMMODEL_DEBUG
315 switch (typeForRole(sortRole())) {
316 case NameRole
: m_groups
= nameRoleGroups(); break;
317 case SizeRole
: m_groups
= sizeRoleGroups(); break;
318 case ModificationTimeRole
:
319 m_groups
= timeRoleGroups([](const ItemData
*item
) {
320 return item
->item
.time(KFileItem::ModificationTime
);
323 case CreationTimeRole
:
324 m_groups
= timeRoleGroups([](const ItemData
*item
) {
325 return item
->item
.time(KFileItem::CreationTime
);
329 m_groups
= timeRoleGroups([](const ItemData
*item
) {
330 return item
->item
.time(KFileItem::AccessTime
);
333 case DeletionTimeRole
:
334 m_groups
= timeRoleGroups([](const ItemData
*item
) {
335 return item
->values
.value("deletiontime").toDateTime();
338 case PermissionsRole
: m_groups
= permissionRoleGroups(); break;
339 case RatingRole
: m_groups
= ratingRoleGroups(); break;
340 default: m_groups
= genericStringRoleGroups(sortRole()); break;
343 #ifdef KFILEITEMMODEL_DEBUG
344 qCDebug(DolphinDebug
) << "[TIME] Calculating groups for" << count() << "items:" << timer
.elapsed();
351 KFileItem
KFileItemModel::fileItem(int index
) const
353 if (index
>= 0 && index
< count()) {
354 return m_itemData
.at(index
)->item
;
360 KFileItem
KFileItemModel::fileItem(const QUrl
&url
) const
362 const int indexForUrl
= index(url
);
363 if (indexForUrl
>= 0) {
364 return m_itemData
.at(indexForUrl
)->item
;
369 int KFileItemModel::index(const KFileItem
& item
) const
371 return index(item
.url());
374 int KFileItemModel::index(const QUrl
& url
) const
376 const QUrl urlToFind
= url
.adjusted(QUrl::StripTrailingSlash
);
378 const int itemCount
= m_itemData
.count();
379 int itemsInHash
= m_items
.count();
381 int index
= m_items
.value(urlToFind
, -1);
382 while (index
< 0 && itemsInHash
< itemCount
) {
383 // Not all URLs are stored yet in m_items. We grow m_items until either
384 // urlToFind is found, or all URLs have been stored in m_items.
385 // Note that we do not add the URLs to m_items one by one, but in
386 // larger blocks. After each block, we check if urlToFind is in
387 // m_items. We could in principle compare urlToFind with each URL while
388 // we are going through m_itemData, but comparing two QUrls will,
389 // unlike calling qHash for the URLs, trigger a parsing of the URLs
390 // which costs both CPU cycles and memory.
391 const int blockSize
= 1000;
392 const int currentBlockEnd
= qMin(itemsInHash
+ blockSize
, itemCount
);
393 for (int i
= itemsInHash
; i
< currentBlockEnd
; ++i
) {
394 const QUrl nextUrl
= m_itemData
.at(i
)->item
.url();
395 m_items
.insert(nextUrl
, i
);
398 itemsInHash
= currentBlockEnd
;
399 index
= m_items
.value(urlToFind
, -1);
403 // The item could not be found, even though all items from m_itemData
404 // should be in m_items now. We print some diagnostic information which
405 // might help to find the cause of the problem, but only once. This
406 // prevents that obtaining and printing the debugging information
407 // wastes CPU cycles and floods the shell or .xsession-errors.
408 static bool printDebugInfo
= true;
410 if (m_items
.count() != m_itemData
.count() && printDebugInfo
) {
411 printDebugInfo
= false;
413 qCWarning(DolphinDebug
) << "The model is in an inconsistent state.";
414 qCWarning(DolphinDebug
) << "m_items.count() ==" << m_items
.count();
415 qCWarning(DolphinDebug
) << "m_itemData.count() ==" << m_itemData
.count();
417 // Check if there are multiple items with the same URL.
418 QMultiHash
<QUrl
, int> indexesForUrl
;
419 for (int i
= 0; i
< m_itemData
.count(); ++i
) {
420 indexesForUrl
.insert(m_itemData
.at(i
)->item
.url(), i
);
423 foreach (const QUrl
& url
, indexesForUrl
.uniqueKeys()) {
424 if (indexesForUrl
.count(url
) > 1) {
425 qCWarning(DolphinDebug
) << "Multiple items found with the URL" << url
;
427 auto it
= indexesForUrl
.find(url
);
428 while (it
!= indexesForUrl
.end() && it
.key() == url
) {
429 const ItemData
* data
= m_itemData
.at(it
.value());
430 qCWarning(DolphinDebug
) << "index" << it
.value() << ":" << data
->item
;
432 qCWarning(DolphinDebug
) << "parent" << data
->parent
->item
;
444 KFileItem
KFileItemModel::rootItem() const
446 return m_dirLister
->rootItem();
449 void KFileItemModel::clear()
454 void KFileItemModel::setRoles(const QSet
<QByteArray
>& roles
)
456 if (m_roles
== roles
) {
460 const QSet
<QByteArray
> changedRoles
= (roles
- m_roles
) + (m_roles
- roles
);
464 const bool supportedExpanding
= m_requestRole
[ExpandedParentsCountRole
];
465 const bool willSupportExpanding
= roles
.contains("expandedParentsCount");
466 if (supportedExpanding
&& !willSupportExpanding
) {
467 // No expanding is supported anymore. Take care to delete all items that have an expansion level
468 // that is not 0 (and hence are part of an expanded item).
469 removeExpandedItems();
476 QSetIterator
<QByteArray
> it(roles
);
477 while (it
.hasNext()) {
478 const QByteArray
& role
= it
.next();
479 m_requestRole
[typeForRole(role
)] = true;
483 // Update m_data with the changed requested roles
484 const int maxIndex
= count() - 1;
485 for (int i
= 0; i
<= maxIndex
; ++i
) {
486 m_itemData
[i
]->values
= retrieveData(m_itemData
.at(i
)->item
, m_itemData
.at(i
)->parent
);
489 emit
itemsChanged(KItemRangeList() << KItemRange(0, count()), changedRoles
);
492 // Clear the 'values' of all filtered items. They will be re-populated with the
493 // correct roles the next time 'values' will be accessed via data(int).
494 QHash
<KFileItem
, ItemData
*>::iterator filteredIt
= m_filteredItems
.begin();
495 const QHash
<KFileItem
, ItemData
*>::iterator filteredEnd
= m_filteredItems
.end();
496 while (filteredIt
!= filteredEnd
) {
497 (*filteredIt
)->values
.clear();
502 QSet
<QByteArray
> KFileItemModel::roles() const
507 bool KFileItemModel::setExpanded(int index
, bool expanded
)
509 if (!isExpandable(index
) || isExpanded(index
) == expanded
) {
513 QHash
<QByteArray
, QVariant
> values
;
514 values
.insert(sharedValue("isExpanded"), expanded
);
515 if (!setData(index
, values
)) {
519 const KFileItem item
= m_itemData
.at(index
)->item
;
520 const QUrl url
= item
.url();
521 const QUrl targetUrl
= item
.targetUrl();
523 m_expandedDirs
.insert(targetUrl
, url
);
524 m_dirLister
->openUrl(url
, KDirLister::Keep
);
526 const QVariantList previouslyExpandedChildren
= m_itemData
.at(index
)->values
.value("previouslyExpandedChildren").value
<QVariantList
>();
527 foreach (const QVariant
& var
, previouslyExpandedChildren
) {
528 m_urlsToExpand
.insert(var
.toUrl());
531 // Note that there might be (indirect) children of the folder which is to be collapsed in
532 // m_pendingItemsToInsert. To prevent that they will be inserted into the model later,
533 // possibly without a parent, which might result in a crash, we insert all pending items
534 // right now. All new items which would be without a parent will then be removed.
535 dispatchPendingItemsToInsert();
537 // Check if the index of the collapsed folder has changed. If that is the case, then items
538 // were inserted before the collapsed folder, and its index needs to be updated.
539 if (m_itemData
.at(index
)->item
!= item
) {
540 index
= this->index(item
);
543 m_expandedDirs
.remove(targetUrl
);
544 m_dirLister
->stop(url
);
546 const int parentLevel
= expandedParentsCount(index
);
547 const int itemCount
= m_itemData
.count();
548 const int firstChildIndex
= index
+ 1;
550 QVariantList expandedChildren
;
552 int childIndex
= firstChildIndex
;
553 while (childIndex
< itemCount
&& expandedParentsCount(childIndex
) > parentLevel
) {
554 ItemData
* itemData
= m_itemData
.at(childIndex
);
555 if (itemData
->values
.value("isExpanded").toBool()) {
556 const QUrl targetUrl
= itemData
->item
.targetUrl();
557 const QUrl url
= itemData
->item
.url();
558 m_expandedDirs
.remove(targetUrl
);
559 m_dirLister
->stop(url
); // TODO: try to unit-test this, see https://bugs.kde.org/show_bug.cgi?id=332102#c11
560 expandedChildren
.append(targetUrl
);
564 const int childrenCount
= childIndex
- firstChildIndex
;
566 removeFilteredChildren(KItemRangeList() << KItemRange(index
, 1 + childrenCount
));
567 removeItems(KItemRangeList() << KItemRange(firstChildIndex
, childrenCount
), DeleteItemData
);
569 m_itemData
.at(index
)->values
.insert("previouslyExpandedChildren", expandedChildren
);
575 bool KFileItemModel::isExpanded(int index
) const
577 if (index
>= 0 && index
< count()) {
578 return m_itemData
.at(index
)->values
.value("isExpanded").toBool();
583 bool KFileItemModel::isExpandable(int index
) const
585 if (index
>= 0 && index
< count()) {
586 // Call data (instead of accessing m_itemData directly)
587 // to ensure that the value is initialized.
588 return data(index
).value("isExpandable").toBool();
593 int KFileItemModel::expandedParentsCount(int index
) const
595 if (index
>= 0 && index
< count()) {
596 return expandedParentsCount(m_itemData
.at(index
));
601 QSet
<QUrl
> KFileItemModel::expandedDirectories() const
604 const auto dirs
= m_expandedDirs
;
605 for (const auto &dir
: dirs
) {
611 void KFileItemModel::restoreExpandedDirectories(const QSet
<QUrl
> &urls
)
613 m_urlsToExpand
= urls
;
616 void KFileItemModel::expandParentDirectories(const QUrl
&url
)
619 // Assure that each sub-path of the URL that should be
620 // expanded is added to m_urlsToExpand. KDirLister
621 // does not care whether the parent-URL has already been
623 QUrl urlToExpand
= m_dirLister
->url();
624 const int pos
= urlToExpand
.path().length();
626 // first subdir can be empty, if m_dirLister->url().path() does not end with '/'
627 // this happens if baseUrl is not root but a home directory, see FoldersPanel,
628 // so using QString::SkipEmptyParts
629 const QStringList subDirs
= url
.path().mid(pos
).split(QDir::separator(), Qt::SkipEmptyParts
);
630 for (int i
= 0; i
< subDirs
.count() - 1; ++i
) {
631 QString path
= urlToExpand
.path();
632 if (!path
.endsWith(QLatin1Char('/'))) {
633 path
.append(QLatin1Char('/'));
635 urlToExpand
.setPath(path
+ subDirs
.at(i
));
636 m_urlsToExpand
.insert(urlToExpand
);
639 // KDirLister::open() must called at least once to trigger an initial
640 // loading. The pending URLs that must be restored are handled
641 // in slotCompleted().
642 QSetIterator
<QUrl
> it2(m_urlsToExpand
);
643 while (it2
.hasNext()) {
644 const int idx
= index(it2
.next());
645 if (idx
>= 0 && !isExpanded(idx
)) {
646 setExpanded(idx
, true);
652 void KFileItemModel::setNameFilter(const QString
& nameFilter
)
654 if (m_filter
.pattern() != nameFilter
) {
655 dispatchPendingItemsToInsert();
656 m_filter
.setPattern(nameFilter
);
661 QString
KFileItemModel::nameFilter() const
663 return m_filter
.pattern();
666 void KFileItemModel::setMimeTypeFilters(const QStringList
& filters
)
668 if (m_filter
.mimeTypes() != filters
) {
669 dispatchPendingItemsToInsert();
670 m_filter
.setMimeTypes(filters
);
675 QStringList
KFileItemModel::mimeTypeFilters() const
677 return m_filter
.mimeTypes();
681 void KFileItemModel::applyFilters()
683 // Check which shown items from m_itemData must get
684 // hidden and hence moved to m_filteredItems.
685 QVector
<int> newFilteredIndexes
;
687 const int itemCount
= m_itemData
.count();
688 for (int index
= 0; index
< itemCount
; ++index
) {
689 ItemData
* itemData
= m_itemData
.at(index
);
691 // Only filter non-expanded items as child items may never
692 // exist without a parent item
693 if (!itemData
->values
.value("isExpanded").toBool()) {
694 const KFileItem item
= itemData
->item
;
695 if (!m_filter
.matches(item
)) {
696 newFilteredIndexes
.append(index
);
697 m_filteredItems
.insert(item
, itemData
);
702 const KItemRangeList removedRanges
= KItemRangeList::fromSortedContainer(newFilteredIndexes
);
703 removeItems(removedRanges
, KeepItemData
);
705 // Check which hidden items from m_filteredItems should
706 // get visible again and hence removed from m_filteredItems.
707 QList
<ItemData
*> newVisibleItems
;
709 QHash
<KFileItem
, ItemData
*>::iterator it
= m_filteredItems
.begin();
710 while (it
!= m_filteredItems
.end()) {
711 if (m_filter
.matches(it
.key())) {
712 newVisibleItems
.append(it
.value());
713 it
= m_filteredItems
.erase(it
);
719 insertItems(newVisibleItems
);
722 void KFileItemModel::removeFilteredChildren(const KItemRangeList
& itemRanges
)
724 if (m_filteredItems
.isEmpty() || !m_requestRole
[ExpandedParentsCountRole
]) {
725 // There are either no filtered items, or it is not possible to expand
726 // folders -> there cannot be any filtered children.
730 QSet
<ItemData
*> parents
;
731 foreach (const KItemRange
& range
, itemRanges
) {
732 for (int index
= range
.index
; index
< range
.index
+ range
.count
; ++index
) {
733 parents
.insert(m_itemData
.at(index
));
737 QHash
<KFileItem
, ItemData
*>::iterator it
= m_filteredItems
.begin();
738 while (it
!= m_filteredItems
.end()) {
739 if (parents
.contains(it
.value()->parent
)) {
741 it
= m_filteredItems
.erase(it
);
748 QList
<KFileItemModel::RoleInfo
> KFileItemModel::rolesInformation()
750 static QList
<RoleInfo
> rolesInfo
;
751 if (rolesInfo
.isEmpty()) {
753 const RoleInfoMap
* map
= rolesInfoMap(count
);
754 for (int i
= 0; i
< count
; ++i
) {
755 if (map
[i
].roleType
!= NoRole
) {
757 info
.role
= map
[i
].role
;
758 info
.translation
= i18nc(map
[i
].roleTranslationContext
, map
[i
].roleTranslation
);
759 if (map
[i
].groupTranslation
) {
760 info
.group
= i18nc(map
[i
].groupTranslationContext
, map
[i
].groupTranslation
);
762 // For top level roles, groupTranslation is 0. We must make sure that
763 // info.group is an empty string then because the code that generates
764 // menus tries to put the actions into sub menus otherwise.
765 info
.group
= QString();
767 info
.requiresBaloo
= map
[i
].requiresBaloo
;
768 info
.requiresIndexer
= map
[i
].requiresIndexer
;
769 rolesInfo
.append(info
);
777 void KFileItemModel::onGroupedSortingChanged(bool current
)
783 void KFileItemModel::onSortRoleChanged(const QByteArray
& current
, const QByteArray
& previous
, bool resortItems
)
786 m_sortRole
= typeForRole(current
);
788 if (!m_requestRole
[m_sortRole
]) {
789 QSet
<QByteArray
> newRoles
= m_roles
;
799 void KFileItemModel::onSortOrderChanged(Qt::SortOrder current
, Qt::SortOrder previous
)
806 void KFileItemModel::loadSortingSettings()
808 using Choice
= GeneralSettings::EnumSortingChoice
;
809 switch (GeneralSettings::sortingChoice()) {
810 case Choice::NaturalSorting
:
811 m_naturalSorting
= true;
812 m_collator
.setCaseSensitivity(Qt::CaseInsensitive
);
814 case Choice::CaseSensitiveSorting
:
815 m_naturalSorting
= false;
816 m_collator
.setCaseSensitivity(Qt::CaseSensitive
);
818 case Choice::CaseInsensitiveSorting
:
819 m_naturalSorting
= false;
820 m_collator
.setCaseSensitivity(Qt::CaseInsensitive
);
825 // Workaround for bug https://bugreports.qt.io/browse/QTBUG-69361
826 // Force the clean state of QCollator in single thread to avoid thread safety problems in sort
827 m_collator
.compare(QString(), QString());
830 void KFileItemModel::resortAllItems()
832 m_resortAllItemsTimer
->stop();
834 const int itemCount
= count();
835 if (itemCount
<= 0) {
839 #ifdef KFILEITEMMODEL_DEBUG
842 qCDebug(DolphinDebug
) << "===========================================================";
843 qCDebug(DolphinDebug
) << "Resorting" << itemCount
<< "items";
846 // Remember the order of the current URLs so
847 // that it can be determined which indexes have
848 // been moved because of the resorting.
850 oldUrls
.reserve(itemCount
);
851 foreach (const ItemData
* itemData
, m_itemData
) {
852 oldUrls
.append(itemData
->item
.url());
856 m_items
.reserve(itemCount
);
859 sort(m_itemData
.begin(), m_itemData
.end());
860 for (int i
= 0; i
< itemCount
; ++i
) {
861 m_items
.insert(m_itemData
.at(i
)->item
.url(), i
);
864 // Determine the first index that has been moved.
865 int firstMovedIndex
= 0;
866 while (firstMovedIndex
< itemCount
867 && firstMovedIndex
== m_items
.value(oldUrls
.at(firstMovedIndex
))) {
871 const bool itemsHaveMoved
= firstMovedIndex
< itemCount
;
872 if (itemsHaveMoved
) {
875 int lastMovedIndex
= itemCount
- 1;
876 while (lastMovedIndex
> firstMovedIndex
877 && lastMovedIndex
== m_items
.value(oldUrls
.at(lastMovedIndex
))) {
881 Q_ASSERT(firstMovedIndex
<= lastMovedIndex
);
883 // Create a list movedToIndexes, which has the property that
884 // movedToIndexes[i] is the new index of the item with the old index
885 // firstMovedIndex + i.
886 const int movedItemsCount
= lastMovedIndex
- firstMovedIndex
+ 1;
887 QList
<int> movedToIndexes
;
888 movedToIndexes
.reserve(movedItemsCount
);
889 for (int i
= firstMovedIndex
; i
<= lastMovedIndex
; ++i
) {
890 const int newIndex
= m_items
.value(oldUrls
.at(i
));
891 movedToIndexes
.append(newIndex
);
894 emit
itemsMoved(KItemRange(firstMovedIndex
, movedItemsCount
), movedToIndexes
);
895 } else if (groupedSorting()) {
896 // The groups might have changed even if the order of the items has not.
897 const QList
<QPair
<int, QVariant
> > oldGroups
= m_groups
;
899 if (groups() != oldGroups
) {
900 emit
groupsChanged();
904 #ifdef KFILEITEMMODEL_DEBUG
905 qCDebug(DolphinDebug
) << "[TIME] Resorting of" << itemCount
<< "items:" << timer
.elapsed();
909 void KFileItemModel::slotCompleted()
911 m_maximumUpdateIntervalTimer
->stop();
912 dispatchPendingItemsToInsert();
914 if (!m_urlsToExpand
.isEmpty()) {
915 // Try to find a URL that can be expanded.
916 // Note that the parent folder must be expanded before any of its subfolders become visible.
917 // Therefore, some URLs in m_restoredExpandedUrls might not be visible yet
918 // -> we expand the first visible URL we find in m_restoredExpandedUrls.
919 foreach (const QUrl
& url
, m_urlsToExpand
) {
920 const int indexForUrl
= index(url
);
921 if (indexForUrl
>= 0) {
922 m_urlsToExpand
.remove(url
);
923 if (setExpanded(indexForUrl
, true)) {
924 // The dir lister has been triggered. This slot will be called
925 // again after the directory has been expanded.
931 // None of the URLs in m_restoredExpandedUrls could be found in the model. This can happen
932 // if these URLs have been deleted in the meantime.
933 m_urlsToExpand
.clear();
936 emit
directoryLoadingCompleted();
939 void KFileItemModel::slotCanceled()
941 m_maximumUpdateIntervalTimer
->stop();
942 dispatchPendingItemsToInsert();
944 emit
directoryLoadingCanceled();
947 void KFileItemModel::slotItemsAdded(const QUrl
&directoryUrl
, const KFileItemList
& items
)
949 Q_ASSERT(!items
.isEmpty());
952 if (m_expandedDirs
.contains(directoryUrl
)) {
953 parentUrl
= m_expandedDirs
.value(directoryUrl
);
955 parentUrl
= directoryUrl
.adjusted(QUrl::StripTrailingSlash
);
958 if (m_requestRole
[ExpandedParentsCountRole
]) {
959 // If the expanding of items is enabled, the call
960 // dirLister->openUrl(url, KDirLister::Keep) in KFileItemModel::setExpanded()
961 // might result in emitting the same items twice due to the Keep-parameter.
962 // This case happens if an item gets expanded, collapsed and expanded again
963 // before the items could be loaded for the first expansion.
964 if (index(items
.first().url()) >= 0) {
965 // The items are already part of the model.
969 if (directoryUrl
!= directory()) {
970 // To be able to compare whether the new items may be inserted as children
971 // of a parent item the pending items must be added to the model first.
972 dispatchPendingItemsToInsert();
975 // KDirLister keeps the children of items that got expanded once even if
976 // they got collapsed again with KFileItemModel::setExpanded(false). So it must be
977 // checked whether the parent for new items is still expanded.
978 const int parentIndex
= index(parentUrl
);
979 if (parentIndex
>= 0 && !m_itemData
[parentIndex
]->values
.value("isExpanded").toBool()) {
980 // The parent is not expanded.
985 QList
<ItemData
*> itemDataList
= createItemDataList(parentUrl
, items
);
987 if (!m_filter
.hasSetFilters()) {
988 m_pendingItemsToInsert
.append(itemDataList
);
990 // The name or type filter is active. Hide filtered items
991 // before inserting them into the model and remember
992 // the filtered items in m_filteredItems.
993 foreach (ItemData
* itemData
, itemDataList
) {
994 if (m_filter
.matches(itemData
->item
)) {
995 m_pendingItemsToInsert
.append(itemData
);
997 m_filteredItems
.insert(itemData
->item
, itemData
);
1002 if (!m_maximumUpdateIntervalTimer
->isActive()) {
1003 // Assure that items get dispatched if no completed() or canceled() signal is
1004 // emitted during the maximum update interval.
1005 m_maximumUpdateIntervalTimer
->start();
1009 void KFileItemModel::slotItemsDeleted(const KFileItemList
& items
)
1011 dispatchPendingItemsToInsert();
1013 QVector
<int> indexesToRemove
;
1014 indexesToRemove
.reserve(items
.count());
1016 foreach (const KFileItem
& item
, items
) {
1017 const int indexForItem
= index(item
);
1018 if (indexForItem
>= 0) {
1019 indexesToRemove
.append(indexForItem
);
1021 // Probably the item has been filtered.
1022 QHash
<KFileItem
, ItemData
*>::iterator it
= m_filteredItems
.find(item
);
1023 if (it
!= m_filteredItems
.end()) {
1025 m_filteredItems
.erase(it
);
1030 std::sort(indexesToRemove
.begin(), indexesToRemove
.end());
1032 if (m_requestRole
[ExpandedParentsCountRole
] && !m_expandedDirs
.isEmpty()) {
1033 // Assure that removing a parent item also results in removing all children
1034 QVector
<int> indexesToRemoveWithChildren
;
1035 indexesToRemoveWithChildren
.reserve(m_itemData
.count());
1037 const int itemCount
= m_itemData
.count();
1038 foreach (int index
, indexesToRemove
) {
1039 indexesToRemoveWithChildren
.append(index
);
1041 const int parentLevel
= expandedParentsCount(index
);
1042 int childIndex
= index
+ 1;
1043 while (childIndex
< itemCount
&& expandedParentsCount(childIndex
) > parentLevel
) {
1044 indexesToRemoveWithChildren
.append(childIndex
);
1049 indexesToRemove
= indexesToRemoveWithChildren
;
1052 const KItemRangeList itemRanges
= KItemRangeList::fromSortedContainer(indexesToRemove
);
1053 removeFilteredChildren(itemRanges
);
1054 removeItems(itemRanges
, DeleteItemData
);
1057 void KFileItemModel::slotRefreshItems(const QList
<QPair
<KFileItem
, KFileItem
> >& items
)
1059 Q_ASSERT(!items
.isEmpty());
1060 #ifdef KFILEITEMMODEL_DEBUG
1061 qCDebug(DolphinDebug
) << "Refreshing" << items
.count() << "items";
1064 // Get the indexes of all items that have been refreshed
1066 indexes
.reserve(items
.count());
1068 QSet
<QByteArray
> changedRoles
;
1070 QListIterator
<QPair
<KFileItem
, KFileItem
> > it(items
);
1071 while (it
.hasNext()) {
1072 const QPair
<KFileItem
, KFileItem
>& itemPair
= it
.next();
1073 const KFileItem
& oldItem
= itemPair
.first
;
1074 const KFileItem
& newItem
= itemPair
.second
;
1075 const int indexForItem
= index(oldItem
);
1076 if (indexForItem
>= 0) {
1077 m_itemData
[indexForItem
]->item
= newItem
;
1079 // Keep old values as long as possible if they could not retrieved synchronously yet.
1080 // The update of the values will be done asynchronously by KFileItemModelRolesUpdater.
1081 QHashIterator
<QByteArray
, QVariant
> it(retrieveData(newItem
, m_itemData
.at(indexForItem
)->parent
));
1082 QHash
<QByteArray
, QVariant
>& values
= m_itemData
[indexForItem
]->values
;
1083 while (it
.hasNext()) {
1085 const QByteArray
& role
= it
.key();
1086 if (values
.value(role
) != it
.value()) {
1087 values
.insert(role
, it
.value());
1088 changedRoles
.insert(role
);
1092 m_items
.remove(oldItem
.url());
1093 m_items
.insert(newItem
.url(), indexForItem
);
1094 indexes
.append(indexForItem
);
1096 // Check if 'oldItem' is one of the filtered items.
1097 QHash
<KFileItem
, ItemData
*>::iterator it
= m_filteredItems
.find(oldItem
);
1098 if (it
!= m_filteredItems
.end()) {
1099 ItemData
* itemData
= it
.value();
1100 itemData
->item
= newItem
;
1102 // The data stored in 'values' might have changed. Therefore, we clear
1103 // 'values' and re-populate it the next time it is requested via data(int).
1104 itemData
->values
.clear();
1106 m_filteredItems
.erase(it
);
1107 m_filteredItems
.insert(newItem
, itemData
);
1112 // If the changed items have been created recently, they might not be in m_items yet.
1113 // In that case, the list 'indexes' might be empty.
1114 if (indexes
.isEmpty()) {
1118 // Extract the item-ranges out of the changed indexes
1119 std::sort(indexes
.begin(), indexes
.end());
1120 const KItemRangeList itemRangeList
= KItemRangeList::fromSortedContainer(indexes
);
1121 emitItemsChangedAndTriggerResorting(itemRangeList
, changedRoles
);
1124 void KFileItemModel::slotClear()
1126 #ifdef KFILEITEMMODEL_DEBUG
1127 qCDebug(DolphinDebug
) << "Clearing all items";
1130 qDeleteAll(m_filteredItems
);
1131 m_filteredItems
.clear();
1134 m_maximumUpdateIntervalTimer
->stop();
1135 m_resortAllItemsTimer
->stop();
1137 qDeleteAll(m_pendingItemsToInsert
);
1138 m_pendingItemsToInsert
.clear();
1140 const int removedCount
= m_itemData
.count();
1141 if (removedCount
> 0) {
1142 qDeleteAll(m_itemData
);
1145 emit
itemsRemoved(KItemRangeList() << KItemRange(0, removedCount
));
1148 m_expandedDirs
.clear();
1151 void KFileItemModel::slotSortingChoiceChanged()
1153 loadSortingSettings();
1157 void KFileItemModel::dispatchPendingItemsToInsert()
1159 if (!m_pendingItemsToInsert
.isEmpty()) {
1160 insertItems(m_pendingItemsToInsert
);
1161 m_pendingItemsToInsert
.clear();
1165 void KFileItemModel::insertItems(QList
<ItemData
*>& newItems
)
1167 if (newItems
.isEmpty()) {
1171 #ifdef KFILEITEMMODEL_DEBUG
1172 QElapsedTimer timer
;
1174 qCDebug(DolphinDebug
) << "===========================================================";
1175 qCDebug(DolphinDebug
) << "Inserting" << newItems
.count() << "items";
1179 prepareItemsForSorting(newItems
);
1181 // Natural sorting of items can be very slow. However, it becomes much faster
1182 // if the input sequence is already mostly sorted. Therefore, we first sort
1183 // 'newItems' according to the QStrings using QString::operator<(), which is quite fast.
1184 if (m_naturalSorting
) {
1185 if (m_sortRole
== NameRole
) {
1186 parallelMergeSort(newItems
.begin(), newItems
.end(), nameLessThan
, QThread::idealThreadCount());
1187 } else if (isRoleValueNatural(m_sortRole
)) {
1188 auto lambdaLessThan
= [&] (const KFileItemModel::ItemData
* a
, const KFileItemModel::ItemData
* b
)
1190 const QByteArray role
= roleForType(m_sortRole
);
1191 return a
->values
.value(role
).toString() < b
->values
.value(role
).toString();
1193 parallelMergeSort(newItems
.begin(), newItems
.end(), lambdaLessThan
, QThread::idealThreadCount());
1197 sort(newItems
.begin(), newItems
.end());
1199 #ifdef KFILEITEMMODEL_DEBUG
1200 qCDebug(DolphinDebug
) << "[TIME] Sorting:" << timer
.elapsed();
1203 KItemRangeList itemRanges
;
1204 const int existingItemCount
= m_itemData
.count();
1205 const int newItemCount
= newItems
.count();
1206 const int totalItemCount
= existingItemCount
+ newItemCount
;
1208 if (existingItemCount
== 0) {
1209 // Optimization for the common special case that there are no
1210 // items in the model yet. Happens, e.g., when entering a folder.
1211 m_itemData
= newItems
;
1212 itemRanges
<< KItemRange(0, newItemCount
);
1214 m_itemData
.reserve(totalItemCount
);
1215 for (int i
= existingItemCount
; i
< totalItemCount
; ++i
) {
1216 m_itemData
.append(nullptr);
1219 // We build the new list m_itemData in reverse order to minimize
1220 // the number of moves and guarantee O(N) complexity.
1221 int targetIndex
= totalItemCount
- 1;
1222 int sourceIndexExistingItems
= existingItemCount
- 1;
1223 int sourceIndexNewItems
= newItemCount
- 1;
1227 while (sourceIndexNewItems
>= 0) {
1228 ItemData
* newItem
= newItems
.at(sourceIndexNewItems
);
1229 if (sourceIndexExistingItems
>= 0 && lessThan(newItem
, m_itemData
.at(sourceIndexExistingItems
), m_collator
)) {
1230 // Move an existing item to its new position. If any new items
1231 // are behind it, push the item range to itemRanges.
1232 if (rangeCount
> 0) {
1233 itemRanges
<< KItemRange(sourceIndexExistingItems
+ 1, rangeCount
);
1237 m_itemData
[targetIndex
] = m_itemData
.at(sourceIndexExistingItems
);
1238 --sourceIndexExistingItems
;
1240 // Insert a new item into the list.
1242 m_itemData
[targetIndex
] = newItem
;
1243 --sourceIndexNewItems
;
1248 // Push the final item range to itemRanges.
1249 if (rangeCount
> 0) {
1250 itemRanges
<< KItemRange(sourceIndexExistingItems
+ 1, rangeCount
);
1253 // Note that itemRanges is still sorted in reverse order.
1254 std::reverse(itemRanges
.begin(), itemRanges
.end());
1257 // The indexes in m_items are not correct anymore. Therefore, we clear m_items.
1258 // It will be re-populated with the updated indices if index(const QUrl&) is called.
1261 emit
itemsInserted(itemRanges
);
1263 #ifdef KFILEITEMMODEL_DEBUG
1264 qCDebug(DolphinDebug
) << "[TIME] Inserting of" << newItems
.count() << "items:" << timer
.elapsed();
1268 void KFileItemModel::removeItems(const KItemRangeList
& itemRanges
, RemoveItemsBehavior behavior
)
1270 if (itemRanges
.isEmpty()) {
1276 // Step 1: Remove the items from m_itemData, and free the ItemData.
1277 int removedItemsCount
= 0;
1278 foreach (const KItemRange
& range
, itemRanges
) {
1279 removedItemsCount
+= range
.count
;
1281 for (int index
= range
.index
; index
< range
.index
+ range
.count
; ++index
) {
1282 if (behavior
== DeleteItemData
) {
1283 delete m_itemData
.at(index
);
1286 m_itemData
[index
] = nullptr;
1290 // Step 2: Remove the ItemData pointers from the list m_itemData.
1291 int target
= itemRanges
.at(0).index
;
1292 int source
= itemRanges
.at(0).index
+ itemRanges
.at(0).count
;
1295 const int oldItemDataCount
= m_itemData
.count();
1296 while (source
< oldItemDataCount
) {
1297 m_itemData
[target
] = m_itemData
[source
];
1301 if (nextRange
< itemRanges
.count() && source
== itemRanges
.at(nextRange
).index
) {
1302 // Skip the items in the next removed range.
1303 source
+= itemRanges
.at(nextRange
).count
;
1308 m_itemData
.erase(m_itemData
.end() - removedItemsCount
, m_itemData
.end());
1310 // The indexes in m_items are not correct anymore. Therefore, we clear m_items.
1311 // It will be re-populated with the updated indices if index(const QUrl&) is called.
1314 emit
itemsRemoved(itemRanges
);
1317 QList
<KFileItemModel::ItemData
*> KFileItemModel::createItemDataList(const QUrl
& parentUrl
, const KFileItemList
& items
) const
1319 if (m_sortRole
== TypeRole
) {
1320 // Try to resolve the MIME-types synchronously to prevent a reordering of
1321 // the items when sorting by type (per default MIME-types are resolved
1322 // asynchronously by KFileItemModelRolesUpdater).
1323 determineMimeTypes(items
, 200);
1326 const int parentIndex
= index(parentUrl
);
1327 ItemData
* parentItem
= parentIndex
< 0 ? nullptr : m_itemData
.at(parentIndex
);
1329 QList
<ItemData
*> itemDataList
;
1330 itemDataList
.reserve(items
.count());
1332 foreach (const KFileItem
& item
, items
) {
1333 ItemData
* itemData
= new ItemData();
1334 itemData
->item
= item
;
1335 itemData
->parent
= parentItem
;
1336 itemDataList
.append(itemData
);
1339 return itemDataList
;
1342 void KFileItemModel::prepareItemsForSorting(QList
<ItemData
*>& itemDataList
)
1344 switch (m_sortRole
) {
1345 case PermissionsRole
:
1348 case DestinationRole
:
1350 case DeletionTimeRole
:
1351 // These roles can be determined with retrieveData, and they have to be stored
1352 // in the QHash "values" for the sorting.
1353 foreach (ItemData
* itemData
, itemDataList
) {
1354 if (itemData
->values
.isEmpty()) {
1355 itemData
->values
= retrieveData(itemData
->item
, itemData
->parent
);
1361 // At least store the data including the file type for items with known MIME type.
1362 foreach (ItemData
* itemData
, itemDataList
) {
1363 if (itemData
->values
.isEmpty()) {
1364 const KFileItem item
= itemData
->item
;
1365 if (item
.isDir() || item
.isMimeTypeKnown()) {
1366 itemData
->values
= retrieveData(itemData
->item
, itemData
->parent
);
1373 // The other roles are either resolved by KFileItemModelRolesUpdater
1374 // (this includes the SizeRole for directories), or they do not need
1375 // to be stored in the QHash "values" for sorting because the data can
1376 // be retrieved directly from the KFileItem (NameRole, SizeRole for files,
1382 int KFileItemModel::expandedParentsCount(const ItemData
* data
)
1384 // The hash 'values' is only guaranteed to contain the key "expandedParentsCount"
1385 // if the corresponding item is expanded, and it is not a top-level item.
1386 const ItemData
* parent
= data
->parent
;
1388 if (parent
->parent
) {
1389 Q_ASSERT(parent
->values
.contains("expandedParentsCount"));
1390 return parent
->values
.value("expandedParentsCount").toInt() + 1;
1399 void KFileItemModel::removeExpandedItems()
1401 QVector
<int> indexesToRemove
;
1403 const int maxIndex
= m_itemData
.count() - 1;
1404 for (int i
= 0; i
<= maxIndex
; ++i
) {
1405 const ItemData
* itemData
= m_itemData
.at(i
);
1406 if (itemData
->parent
) {
1407 indexesToRemove
.append(i
);
1411 removeItems(KItemRangeList::fromSortedContainer(indexesToRemove
), DeleteItemData
);
1412 m_expandedDirs
.clear();
1414 // Also remove all filtered items which have a parent.
1415 QHash
<KFileItem
, ItemData
*>::iterator it
= m_filteredItems
.begin();
1416 const QHash
<KFileItem
, ItemData
*>::iterator end
= m_filteredItems
.end();
1419 if (it
.value()->parent
) {
1421 it
= m_filteredItems
.erase(it
);
1428 void KFileItemModel::emitItemsChangedAndTriggerResorting(const KItemRangeList
& itemRanges
, const QSet
<QByteArray
>& changedRoles
)
1430 emit
itemsChanged(itemRanges
, changedRoles
);
1432 // Trigger a resorting if necessary. Note that this can happen even if the sort
1433 // role has not changed at all because the file name can be used as a fallback.
1434 if (changedRoles
.contains(sortRole()) || changedRoles
.contains(roleForType(NameRole
))) {
1435 foreach (const KItemRange
& range
, itemRanges
) {
1436 bool needsResorting
= false;
1438 const int first
= range
.index
;
1439 const int last
= range
.index
+ range
.count
- 1;
1441 // Resorting the model is necessary if
1442 // (a) The first item in the range is "lessThan" its predecessor,
1443 // (b) the successor of the last item is "lessThan" the last item, or
1444 // (c) the internal order of the items in the range is incorrect.
1446 && lessThan(m_itemData
.at(first
), m_itemData
.at(first
- 1), m_collator
)) {
1447 needsResorting
= true;
1448 } else if (last
< count() - 1
1449 && lessThan(m_itemData
.at(last
+ 1), m_itemData
.at(last
), m_collator
)) {
1450 needsResorting
= true;
1452 for (int index
= first
; index
< last
; ++index
) {
1453 if (lessThan(m_itemData
.at(index
+ 1), m_itemData
.at(index
), m_collator
)) {
1454 needsResorting
= true;
1460 if (needsResorting
) {
1461 m_resortAllItemsTimer
->start();
1467 if (groupedSorting() && changedRoles
.contains(sortRole())) {
1468 // The position is still correct, but the groups might have changed
1469 // if the changed item is either the first or the last item in a
1471 // In principle, we could try to find out if the item really is the
1472 // first or last one in its group and then update the groups
1473 // (possibly with a delayed timer to make sure that we don't
1474 // re-calculate the groups very often if items are updated one by
1475 // one), but starting m_resortAllItemsTimer is easier.
1476 m_resortAllItemsTimer
->start();
1480 void KFileItemModel::resetRoles()
1482 for (int i
= 0; i
< RolesCount
; ++i
) {
1483 m_requestRole
[i
] = false;
1487 KFileItemModel::RoleType
KFileItemModel::typeForRole(const QByteArray
& role
) const
1489 static QHash
<QByteArray
, RoleType
> roles
;
1490 if (roles
.isEmpty()) {
1491 // Insert user visible roles that can be accessed with
1492 // KFileItemModel::roleInformation()
1494 const RoleInfoMap
* map
= rolesInfoMap(count
);
1495 for (int i
= 0; i
< count
; ++i
) {
1496 roles
.insert(map
[i
].role
, map
[i
].roleType
);
1499 // Insert internal roles (take care to synchronize the implementation
1500 // with KFileItemModel::roleForType() in case if a change is done).
1501 roles
.insert("isDir", IsDirRole
);
1502 roles
.insert("isLink", IsLinkRole
);
1503 roles
.insert("isHidden", IsHiddenRole
);
1504 roles
.insert("isExpanded", IsExpandedRole
);
1505 roles
.insert("isExpandable", IsExpandableRole
);
1506 roles
.insert("expandedParentsCount", ExpandedParentsCountRole
);
1508 Q_ASSERT(roles
.count() == RolesCount
);
1511 return roles
.value(role
, NoRole
);
1514 QByteArray
KFileItemModel::roleForType(RoleType roleType
) const
1516 static QHash
<RoleType
, QByteArray
> roles
;
1517 if (roles
.isEmpty()) {
1518 // Insert user visible roles that can be accessed with
1519 // KFileItemModel::roleInformation()
1521 const RoleInfoMap
* map
= rolesInfoMap(count
);
1522 for (int i
= 0; i
< count
; ++i
) {
1523 roles
.insert(map
[i
].roleType
, map
[i
].role
);
1526 // Insert internal roles (take care to synchronize the implementation
1527 // with KFileItemModel::typeForRole() in case if a change is done).
1528 roles
.insert(IsDirRole
, "isDir");
1529 roles
.insert(IsLinkRole
, "isLink");
1530 roles
.insert(IsHiddenRole
, "isHidden");
1531 roles
.insert(IsExpandedRole
, "isExpanded");
1532 roles
.insert(IsExpandableRole
, "isExpandable");
1533 roles
.insert(ExpandedParentsCountRole
, "expandedParentsCount");
1535 Q_ASSERT(roles
.count() == RolesCount
);
1538 return roles
.value(roleType
);
1541 QHash
<QByteArray
, QVariant
> KFileItemModel::retrieveData(const KFileItem
& item
, const ItemData
* parent
) const
1543 // It is important to insert only roles that are fast to retrieve. E.g.
1544 // KFileItem::iconName() can be very expensive if the MIME-type is unknown
1545 // and hence will be retrieved asynchronously by KFileItemModelRolesUpdater.
1546 QHash
<QByteArray
, QVariant
> data
;
1547 data
.insert(sharedValue("url"), item
.url());
1549 const bool isDir
= item
.isDir();
1550 if (m_requestRole
[IsDirRole
] && isDir
) {
1551 data
.insert(sharedValue("isDir"), true);
1554 if (m_requestRole
[IsLinkRole
] && item
.isLink()) {
1555 data
.insert(sharedValue("isLink"), true);
1558 if (m_requestRole
[IsHiddenRole
]) {
1559 data
.insert(sharedValue("isHidden"), item
.isHidden());
1562 if (m_requestRole
[NameRole
]) {
1563 data
.insert(sharedValue("text"), item
.text());
1566 if (m_requestRole
[SizeRole
] && !isDir
) {
1567 data
.insert(sharedValue("size"), item
.size());
1570 if (m_requestRole
[ModificationTimeRole
]) {
1571 // Don't use KFileItem::timeString() or KFileItem::time() as this is too expensive when
1572 // having several thousands of items. Instead read the raw number from UDSEntry directly
1573 // and the formatting of the date-time will be done on-demand by the view when the date will be shown.
1574 const long long dateTime
= item
.entry().numberValue(KIO::UDSEntry::UDS_MODIFICATION_TIME
, -1);
1575 data
.insert(sharedValue("modificationtime"), dateTime
);
1578 if (m_requestRole
[CreationTimeRole
]) {
1579 // Don't use KFileItem::timeString() or KFileItem::time() as this is too expensive when
1580 // having several thousands of items. Instead read the raw number from UDSEntry directly
1581 // and the formatting of the date-time will be done on-demand by the view when the date will be shown.
1582 const long long dateTime
= item
.entry().numberValue(KIO::UDSEntry::UDS_CREATION_TIME
, -1);
1583 data
.insert(sharedValue("creationtime"), dateTime
);
1586 if (m_requestRole
[AccessTimeRole
]) {
1587 // Don't use KFileItem::timeString() or KFileItem::time() as this is too expensive when
1588 // having several thousands of items. Instead read the raw number from UDSEntry directly
1589 // and the formatting of the date-time will be done on-demand by the view when the date will be shown.
1590 const long long dateTime
= item
.entry().numberValue(KIO::UDSEntry::UDS_ACCESS_TIME
, -1);
1591 data
.insert(sharedValue("accesstime"), dateTime
);
1594 if (m_requestRole
[PermissionsRole
]) {
1595 data
.insert(sharedValue("permissions"), item
.permissionsString());
1598 if (m_requestRole
[OwnerRole
]) {
1599 data
.insert(sharedValue("owner"), item
.user());
1602 if (m_requestRole
[GroupRole
]) {
1603 data
.insert(sharedValue("group"), item
.group());
1606 if (m_requestRole
[DestinationRole
]) {
1607 QString destination
= item
.linkDest();
1608 if (destination
.isEmpty()) {
1609 destination
= QLatin1Char('-');
1611 data
.insert(sharedValue("destination"), destination
);
1614 if (m_requestRole
[PathRole
]) {
1616 if (item
.url().scheme() == QLatin1String("trash")) {
1617 path
= item
.entry().stringValue(KIO::UDSEntry::UDS_EXTRA
);
1619 // For performance reasons cache the home-path in a static QString
1620 // (see QDir::homePath() for more details)
1621 static QString homePath
;
1622 if (homePath
.isEmpty()) {
1623 homePath
= QDir::homePath();
1626 path
= item
.localPath();
1627 if (path
.startsWith(homePath
)) {
1628 path
.replace(0, homePath
.length(), QLatin1Char('~'));
1632 const int index
= path
.lastIndexOf(item
.text());
1633 path
= path
.mid(0, index
- 1);
1634 data
.insert(sharedValue("path"), path
);
1637 if (m_requestRole
[DeletionTimeRole
]) {
1638 QDateTime deletionTime
;
1639 if (item
.url().scheme() == QLatin1String("trash")) {
1640 deletionTime
= QDateTime::fromString(item
.entry().stringValue(KIO::UDSEntry::UDS_EXTRA
+ 1), Qt::ISODate
);
1642 data
.insert(sharedValue("deletiontime"), deletionTime
);
1645 if (m_requestRole
[IsExpandableRole
] && isDir
) {
1646 data
.insert(sharedValue("isExpandable"), true);
1649 if (m_requestRole
[ExpandedParentsCountRole
]) {
1651 const int level
= expandedParentsCount(parent
) + 1;
1652 data
.insert(sharedValue("expandedParentsCount"), level
);
1656 if (item
.isMimeTypeKnown()) {
1657 data
.insert(sharedValue("iconName"), item
.iconName());
1659 if (m_requestRole
[TypeRole
]) {
1660 data
.insert(sharedValue("type"), item
.mimeComment());
1662 } else if (m_requestRole
[TypeRole
] && isDir
) {
1663 static const QString folderMimeType
= item
.mimeComment();
1664 data
.insert(sharedValue("type"), folderMimeType
);
1670 bool KFileItemModel::lessThan(const ItemData
* a
, const ItemData
* b
, const QCollator
& collator
) const
1674 if (a
->parent
!= b
->parent
) {
1675 const int expansionLevelA
= expandedParentsCount(a
);
1676 const int expansionLevelB
= expandedParentsCount(b
);
1678 // If b has a higher expansion level than a, check if a is a parent
1679 // of b, and make sure that both expansion levels are equal otherwise.
1680 for (int i
= expansionLevelB
; i
> expansionLevelA
; --i
) {
1681 if (b
->parent
== a
) {
1687 // If a has a higher expansion level than a, check if b is a parent
1688 // of a, and make sure that both expansion levels are equal otherwise.
1689 for (int i
= expansionLevelA
; i
> expansionLevelB
; --i
) {
1690 if (a
->parent
== b
) {
1696 Q_ASSERT(expandedParentsCount(a
) == expandedParentsCount(b
));
1698 // Compare the last parents of a and b which are different.
1699 while (a
->parent
!= b
->parent
) {
1705 if (m_sortDirsFirst
|| m_sortRole
== SizeRole
) {
1706 const bool isDirA
= a
->item
.isDir();
1707 const bool isDirB
= b
->item
.isDir();
1708 if (isDirA
&& !isDirB
) {
1710 } else if (!isDirA
&& isDirB
) {
1715 result
= sortRoleCompare(a
, b
, collator
);
1717 return (sortOrder() == Qt::AscendingOrder
) ? result
< 0 : result
> 0;
1720 void KFileItemModel::sort(const QList
<KFileItemModel::ItemData
*>::iterator
&begin
,
1721 const QList
<KFileItemModel::ItemData
*>::iterator
&end
) const
1723 auto lambdaLessThan
= [&] (const KFileItemModel::ItemData
* a
, const KFileItemModel::ItemData
* b
)
1725 return lessThan(a
, b
, m_collator
);
1728 if (m_sortRole
== NameRole
|| isRoleValueNatural(m_sortRole
)) {
1729 // Sorting by string can be expensive, in particular if natural sorting is
1730 // enabled. Use all CPU cores to speed up the sorting process.
1731 static const int numberOfThreads
= QThread::idealThreadCount();
1732 parallelMergeSort(begin
, end
, lambdaLessThan
, numberOfThreads
);
1734 // Sorting by other roles is quite fast. Use only one thread to prevent
1735 // problems caused by non-reentrant comparison functions, see
1736 // https://bugs.kde.org/show_bug.cgi?id=312679
1737 mergeSort(begin
, end
, lambdaLessThan
);
1741 int KFileItemModel::sortRoleCompare(const ItemData
* a
, const ItemData
* b
, const QCollator
& collator
) const
1743 const KFileItem
& itemA
= a
->item
;
1744 const KFileItem
& itemB
= b
->item
;
1748 switch (m_sortRole
) {
1750 // The name role is handled as default fallback after the switch
1754 if (itemA
.isDir()) {
1755 // See "if (m_sortFoldersFirst || m_sortRole == SizeRole)" in KFileItemModel::lessThan():
1756 Q_ASSERT(itemB
.isDir());
1758 QVariant valueA
, valueB
;
1759 if (DetailsModeSettings::directorySizeCount()) {
1760 valueA
= a
->values
.value("count");
1761 valueB
= b
->values
.value("count");
1763 // use dir size then
1764 valueA
= a
->values
.value("size");
1765 valueB
= b
->values
.value("size");
1767 if (valueA
.isNull() && valueB
.isNull()) {
1769 } else if (valueA
.isNull()) {
1771 } else if (valueB
.isNull()) {
1774 if (valueA
.toLongLong() < valueB
.toLongLong()) {
1781 // See "if (m_sortFoldersFirst || m_sortRole == SizeRole)" in KFileItemModel::lessThan():
1782 Q_ASSERT(!itemB
.isDir());
1783 const KIO::filesize_t sizeA
= itemA
.size();
1784 const KIO::filesize_t sizeB
= itemB
.size();
1785 if (sizeA
> sizeB
) {
1787 } else if (sizeA
< sizeB
) {
1796 case ModificationTimeRole
: {
1797 const long long dateTimeA
= itemA
.entry().numberValue(KIO::UDSEntry::UDS_MODIFICATION_TIME
, -1);
1798 const long long dateTimeB
= itemB
.entry().numberValue(KIO::UDSEntry::UDS_MODIFICATION_TIME
, -1);
1799 if (dateTimeA
< dateTimeB
) {
1801 } else if (dateTimeA
> dateTimeB
) {
1807 case CreationTimeRole
: {
1808 const long long dateTimeA
= itemA
.entry().numberValue(KIO::UDSEntry::UDS_CREATION_TIME
, -1);
1809 const long long dateTimeB
= itemB
.entry().numberValue(KIO::UDSEntry::UDS_CREATION_TIME
, -1);
1810 if (dateTimeA
< dateTimeB
) {
1812 } else if (dateTimeA
> dateTimeB
) {
1818 case DeletionTimeRole
: {
1819 const QDateTime dateTimeA
= a
->values
.value("deletiontime").toDateTime();
1820 const QDateTime dateTimeB
= b
->values
.value("deletiontime").toDateTime();
1821 if (dateTimeA
< dateTimeB
) {
1823 } else if (dateTimeA
> dateTimeB
) {
1835 case ReleaseYearRole
: {
1836 result
= a
->values
.value(roleForType(m_sortRole
)).toInt() - b
->values
.value(roleForType(m_sortRole
)).toInt();
1841 const QByteArray role
= roleForType(m_sortRole
);
1842 const QString roleValueA
= a
->values
.value(role
).toString();
1843 const QString roleValueB
= b
->values
.value(role
).toString();
1844 if (!roleValueA
.isEmpty() && roleValueB
.isEmpty()) {
1846 } else if (roleValueA
.isEmpty() && !roleValueB
.isEmpty()) {
1848 } else if (isRoleValueNatural(m_sortRole
)) {
1849 result
= stringCompare(roleValueA
, roleValueB
, collator
);
1851 result
= QString::compare(roleValueA
, roleValueB
);
1859 // The current sort role was sufficient to define an order
1863 // Fallback #1: Compare the text of the items
1864 result
= stringCompare(itemA
.text(), itemB
.text(), collator
);
1869 // Fallback #2: KFileItem::text() may not be unique in case UDS_DISPLAY_NAME is used
1870 result
= stringCompare(itemA
.name(), itemB
.name(), collator
);
1875 // Fallback #3: It must be assured that the sort order is always unique even if two values have been
1876 // equal. In this case a comparison of the URL is done which is unique in all cases
1877 // within KDirLister.
1878 return QString::compare(itemA
.url().url(), itemB
.url().url(), Qt::CaseSensitive
);
1881 int KFileItemModel::stringCompare(const QString
& a
, const QString
& b
, const QCollator
& collator
) const
1883 QMutexLocker
collatorLock(s_collatorMutex());
1885 if (m_naturalSorting
) {
1886 return collator
.compare(a
, b
);
1889 const int result
= QString::compare(a
, b
, collator
.caseSensitivity());
1890 if (result
!= 0 || collator
.caseSensitivity() == Qt::CaseSensitive
) {
1891 // Only return the result, if the strings are not equal. If they are equal by a case insensitive
1892 // comparison, still a deterministic sort order is required. A case sensitive
1893 // comparison is done as fallback.
1897 return QString::compare(a
, b
, Qt::CaseSensitive
);
1900 QList
<QPair
<int, QVariant
> > KFileItemModel::nameRoleGroups() const
1902 Q_ASSERT(!m_itemData
.isEmpty());
1904 const int maxIndex
= count() - 1;
1905 QList
<QPair
<int, QVariant
> > groups
;
1909 for (int i
= 0; i
<= maxIndex
; ++i
) {
1910 if (isChildItem(i
)) {
1914 const QString name
= m_itemData
.at(i
)->item
.text();
1916 // Use the first character of the name as group indication
1917 QChar newFirstChar
= name
.at(0).toUpper();
1918 if (newFirstChar
== QLatin1Char('~') && name
.length() > 1) {
1919 newFirstChar
= name
.at(1).toUpper();
1922 if (firstChar
!= newFirstChar
) {
1923 QString newGroupValue
;
1924 if (newFirstChar
.isLetter()) {
1926 if (m_collator
.compare(newFirstChar
, QChar(QLatin1Char('A'))) >= 0 && m_collator
.compare(newFirstChar
, QChar(QLatin1Char('Z'))) <= 0) {
1927 // WARNING! Symbols based on latin 'Z' like 'Z' with acute are treated wrong as non Latin and put in a new group.
1929 // Try to find a matching group in the range 'A' to 'Z'.
1930 static std::vector
<QChar
> lettersAtoZ
;
1931 lettersAtoZ
.reserve('Z' - 'A' + 1);
1932 if (lettersAtoZ
.empty()) {
1933 for (char c
= 'A'; c
<= 'Z'; ++c
) {
1934 lettersAtoZ
.push_back(QLatin1Char(c
));
1938 auto localeAwareLessThan
= [this](QChar c1
, QChar c2
) -> bool {
1939 return m_collator
.compare(c1
, c2
) < 0;
1942 std::vector
<QChar
>::iterator it
= std::lower_bound(lettersAtoZ
.begin(), lettersAtoZ
.end(), newFirstChar
, localeAwareLessThan
);
1943 if (it
!= lettersAtoZ
.end()) {
1944 if (localeAwareLessThan(newFirstChar
, *it
)) {
1945 // newFirstChar belongs to the group preceding *it.
1946 // Example: for an umlaut 'A' in the German locale, *it would be 'B' now.
1949 newGroupValue
= *it
;
1953 // Symbols from non Latin-based scripts
1954 newGroupValue
= newFirstChar
;
1956 } else if (newFirstChar
>= QLatin1Char('0') && newFirstChar
<= QLatin1Char('9')) {
1957 // Apply group '0 - 9' for any name that starts with a digit
1958 newGroupValue
= i18nc("@title:group Groups that start with a digit", "0 - 9");
1960 newGroupValue
= i18nc("@title:group", "Others");
1963 if (newGroupValue
!= groupValue
) {
1964 groupValue
= newGroupValue
;
1965 groups
.append(QPair
<int, QVariant
>(i
, newGroupValue
));
1968 firstChar
= newFirstChar
;
1974 QList
<QPair
<int, QVariant
> > KFileItemModel::sizeRoleGroups() const
1976 Q_ASSERT(!m_itemData
.isEmpty());
1978 const int maxIndex
= count() - 1;
1979 QList
<QPair
<int, QVariant
> > groups
;
1982 for (int i
= 0; i
<= maxIndex
; ++i
) {
1983 if (isChildItem(i
)) {
1987 const KFileItem
& item
= m_itemData
.at(i
)->item
;
1988 const KIO::filesize_t fileSize
= !item
.isNull() ? item
.size() : ~0U;
1989 QString newGroupValue
;
1990 if (!item
.isNull() && item
.isDir()) {
1991 newGroupValue
= i18nc("@title:group Size", "Folders");
1992 } else if (fileSize
< 5 * 1024 * 1024) {
1993 newGroupValue
= i18nc("@title:group Size", "Small");
1994 } else if (fileSize
< 10 * 1024 * 1024) {
1995 newGroupValue
= i18nc("@title:group Size", "Medium");
1997 newGroupValue
= i18nc("@title:group Size", "Big");
2000 if (newGroupValue
!= groupValue
) {
2001 groupValue
= newGroupValue
;
2002 groups
.append(QPair
<int, QVariant
>(i
, newGroupValue
));
2009 QList
<QPair
<int, QVariant
> > KFileItemModel::timeRoleGroups(const std::function
<QDateTime(const ItemData
*)> &fileTimeCb
) const
2011 Q_ASSERT(!m_itemData
.isEmpty());
2013 const int maxIndex
= count() - 1;
2014 QList
<QPair
<int, QVariant
> > groups
;
2016 const QDate currentDate
= QDate::currentDate();
2018 QDate previousFileDate
;
2020 for (int i
= 0; i
<= maxIndex
; ++i
) {
2021 if (isChildItem(i
)) {
2025 const QDateTime fileTime
= fileTimeCb(m_itemData
.at(i
));
2026 const QDate fileDate
= fileTime
.date();
2027 if (fileDate
== previousFileDate
) {
2028 // The current item is in the same group as the previous item
2031 previousFileDate
= fileDate
;
2033 const int daysDistance
= fileDate
.daysTo(currentDate
);
2035 QString newGroupValue
;
2036 if (currentDate
.year() == fileDate
.year() &&
2037 currentDate
.month() == fileDate
.month()) {
2039 switch (daysDistance
/ 7) {
2041 switch (daysDistance
) {
2042 case 0: newGroupValue
= i18nc("@title:group Date", "Today"); break;
2043 case 1: newGroupValue
= i18nc("@title:group Date", "Yesterday"); break;
2045 newGroupValue
= fileTime
.toString(
2046 i18nc("@title:group Date: The week day name: dddd", "dddd"));
2047 newGroupValue
= i18nc("Can be used to script translation of \"dddd\""
2048 "with context @title:group Date", "%1", newGroupValue
);
2052 newGroupValue
= i18nc("@title:group Date", "One Week Ago");
2055 newGroupValue
= i18nc("@title:group Date", "Two Weeks Ago");
2058 newGroupValue
= i18nc("@title:group Date", "Three Weeks Ago");
2062 newGroupValue
= i18nc("@title:group Date", "Earlier this Month");
2068 const QDate lastMonthDate
= currentDate
.addMonths(-1);
2069 if (lastMonthDate
.year() == fileDate
.year() &&
2070 lastMonthDate
.month() == fileDate
.month()) {
2072 if (daysDistance
== 1) {
2073 const KLocalizedString format
= ki18nc("@title:group Date: "
2074 "MMMM is full month name in current locale, and yyyy is "
2075 "full year number", "'Yesterday' (MMMM, yyyy)");
2076 const QString translatedFormat
= format
.toString();
2077 if (translatedFormat
.count(QLatin1Char('\'')) == 2) {
2078 newGroupValue
= fileTime
.toString(translatedFormat
);
2079 newGroupValue
= i18nc("Can be used to script translation of "
2080 "\"'Yesterday' (MMMM, yyyy)\" with context @title:group Date",
2081 "%1", newGroupValue
);
2083 qCWarning(DolphinDebug
).nospace() << "A wrong translation was found: " << translatedFormat
<< ". Please file a bug report at bugs.kde.org";
2084 const QString untranslatedFormat
= format
.toString({ QLatin1String("en_US") });
2085 newGroupValue
= fileTime
.toString(untranslatedFormat
);
2087 } else if (daysDistance
<= 7) {
2088 newGroupValue
= fileTime
.toString(i18nc("@title:group Date: "
2089 "The week day name: dddd, MMMM is full month name "
2090 "in current locale, and yyyy is full year number",
2091 "dddd (MMMM, yyyy)"));
2092 newGroupValue
= i18nc("Can be used to script translation of "
2093 "\"dddd (MMMM, yyyy)\" with context @title:group Date",
2094 "%1", newGroupValue
);
2095 } else if (daysDistance
<= 7 * 2) {
2096 const KLocalizedString format
= ki18nc("@title:group Date: "
2097 "MMMM is full month name in current locale, and yyyy is "
2098 "full year number", "'One Week Ago' (MMMM, yyyy)");
2099 const QString translatedFormat
= format
.toString();
2100 if (translatedFormat
.count(QLatin1Char('\'')) == 2) {
2101 newGroupValue
= fileTime
.toString(translatedFormat
);
2102 newGroupValue
= i18nc("Can be used to script translation of "
2103 "\"'One Week Ago' (MMMM, yyyy)\" with context @title:group Date",
2104 "%1", newGroupValue
);
2106 qCWarning(DolphinDebug
).nospace() << "A wrong translation was found: " << translatedFormat
<< ". Please file a bug report at bugs.kde.org";
2107 const QString untranslatedFormat
= format
.toString({ QLatin1String("en_US") });
2108 newGroupValue
= fileTime
.toString(untranslatedFormat
);
2110 } else if (daysDistance
<= 7 * 3) {
2111 const KLocalizedString format
= ki18nc("@title:group Date: "
2112 "MMMM is full month name in current locale, and yyyy is "
2113 "full year number", "'Two Weeks Ago' (MMMM, yyyy)");
2114 const QString translatedFormat
= format
.toString();
2115 if (translatedFormat
.count(QLatin1Char('\'')) == 2) {
2116 newGroupValue
= fileTime
.toString(translatedFormat
);
2117 newGroupValue
= i18nc("Can be used to script translation of "
2118 "\"'Two Weeks Ago' (MMMM, yyyy)\" with context @title:group Date",
2119 "%1", newGroupValue
);
2121 qCWarning(DolphinDebug
).nospace() << "A wrong translation was found: " << translatedFormat
<< ". Please file a bug report at bugs.kde.org";
2122 const QString untranslatedFormat
= format
.toString({ QLatin1String("en_US") });
2123 newGroupValue
= fileTime
.toString(untranslatedFormat
);
2125 } else if (daysDistance
<= 7 * 4) {
2126 const KLocalizedString format
= ki18nc("@title:group Date: "
2127 "MMMM is full month name in current locale, and yyyy is "
2128 "full year number", "'Three Weeks Ago' (MMMM, yyyy)");
2129 const QString translatedFormat
= format
.toString();
2130 if (translatedFormat
.count(QLatin1Char('\'')) == 2) {
2131 newGroupValue
= fileTime
.toString(translatedFormat
);
2132 newGroupValue
= i18nc("Can be used to script translation of "
2133 "\"'Three Weeks Ago' (MMMM, yyyy)\" with context @title:group Date",
2134 "%1", newGroupValue
);
2136 qCWarning(DolphinDebug
).nospace() << "A wrong translation was found: " << translatedFormat
<< ". Please file a bug report at bugs.kde.org";
2137 const QString untranslatedFormat
= format
.toString({ QLatin1String("en_US") });
2138 newGroupValue
= fileTime
.toString(untranslatedFormat
);
2141 const KLocalizedString format
= ki18nc("@title:group Date: "
2142 "MMMM is full month name in current locale, and yyyy is "
2143 "full year number", "'Earlier on' MMMM, yyyy");
2144 const QString translatedFormat
= format
.toString();
2145 if (translatedFormat
.count(QLatin1Char('\'')) == 2) {
2146 newGroupValue
= fileTime
.toString(translatedFormat
);
2147 newGroupValue
= i18nc("Can be used to script translation of "
2148 "\"'Earlier on' MMMM, yyyy\" with context @title:group Date",
2149 "%1", newGroupValue
);
2151 qCWarning(DolphinDebug
).nospace() << "A wrong translation was found: " << translatedFormat
<< ". Please file a bug report at bugs.kde.org";
2152 const QString untranslatedFormat
= format
.toString({ QLatin1String("en_US") });
2153 newGroupValue
= fileTime
.toString(untranslatedFormat
);
2157 newGroupValue
= fileTime
.toString(i18nc("@title:group "
2158 "The month and year: MMMM is full month name in current locale, "
2159 "and yyyy is full year number", "MMMM, yyyy"));
2160 newGroupValue
= i18nc("Can be used to script translation of "
2161 "\"MMMM, yyyy\" with context @title:group Date",
2162 "%1", newGroupValue
);
2166 if (newGroupValue
!= groupValue
) {
2167 groupValue
= newGroupValue
;
2168 groups
.append(QPair
<int, QVariant
>(i
, newGroupValue
));
2175 QList
<QPair
<int, QVariant
> > KFileItemModel::permissionRoleGroups() const
2177 Q_ASSERT(!m_itemData
.isEmpty());
2179 const int maxIndex
= count() - 1;
2180 QList
<QPair
<int, QVariant
> > groups
;
2182 QString permissionsString
;
2184 for (int i
= 0; i
<= maxIndex
; ++i
) {
2185 if (isChildItem(i
)) {
2189 const ItemData
* itemData
= m_itemData
.at(i
);
2190 const QString newPermissionsString
= itemData
->values
.value("permissions").toString();
2191 if (newPermissionsString
== permissionsString
) {
2194 permissionsString
= newPermissionsString
;
2196 const QFileInfo
info(itemData
->item
.url().toLocalFile());
2200 if (info
.permission(QFile::ReadUser
)) {
2201 user
= i18nc("@item:intext Access permission, concatenated", "Read, ");
2203 if (info
.permission(QFile::WriteUser
)) {
2204 user
+= i18nc("@item:intext Access permission, concatenated", "Write, ");
2206 if (info
.permission(QFile::ExeUser
)) {
2207 user
+= i18nc("@item:intext Access permission, concatenated", "Execute, ");
2209 user
= user
.isEmpty() ? i18nc("@item:intext Access permission, concatenated", "Forbidden") : user
.mid(0, user
.count() - 2);
2213 if (info
.permission(QFile::ReadGroup
)) {
2214 group
= i18nc("@item:intext Access permission, concatenated", "Read, ");
2216 if (info
.permission(QFile::WriteGroup
)) {
2217 group
+= i18nc("@item:intext Access permission, concatenated", "Write, ");
2219 if (info
.permission(QFile::ExeGroup
)) {
2220 group
+= i18nc("@item:intext Access permission, concatenated", "Execute, ");
2222 group
= group
.isEmpty() ? i18nc("@item:intext Access permission, concatenated", "Forbidden") : group
.mid(0, group
.count() - 2);
2224 // Set others string
2226 if (info
.permission(QFile::ReadOther
)) {
2227 others
= i18nc("@item:intext Access permission, concatenated", "Read, ");
2229 if (info
.permission(QFile::WriteOther
)) {
2230 others
+= i18nc("@item:intext Access permission, concatenated", "Write, ");
2232 if (info
.permission(QFile::ExeOther
)) {
2233 others
+= i18nc("@item:intext Access permission, concatenated", "Execute, ");
2235 others
= others
.isEmpty() ? i18nc("@item:intext Access permission, concatenated", "Forbidden") : others
.mid(0, others
.count() - 2);
2237 const QString newGroupValue
= i18nc("@title:group Files and folders by permissions", "User: %1 | Group: %2 | Others: %3", user
, group
, others
);
2238 if (newGroupValue
!= groupValue
) {
2239 groupValue
= newGroupValue
;
2240 groups
.append(QPair
<int, QVariant
>(i
, newGroupValue
));
2247 QList
<QPair
<int, QVariant
> > KFileItemModel::ratingRoleGroups() const
2249 Q_ASSERT(!m_itemData
.isEmpty());
2251 const int maxIndex
= count() - 1;
2252 QList
<QPair
<int, QVariant
> > groups
;
2254 int groupValue
= -1;
2255 for (int i
= 0; i
<= maxIndex
; ++i
) {
2256 if (isChildItem(i
)) {
2259 const int newGroupValue
= m_itemData
.at(i
)->values
.value("rating", 0).toInt();
2260 if (newGroupValue
!= groupValue
) {
2261 groupValue
= newGroupValue
;
2262 groups
.append(QPair
<int, QVariant
>(i
, newGroupValue
));
2269 QList
<QPair
<int, QVariant
> > KFileItemModel::genericStringRoleGroups(const QByteArray
& role
) const
2271 Q_ASSERT(!m_itemData
.isEmpty());
2273 const int maxIndex
= count() - 1;
2274 QList
<QPair
<int, QVariant
> > groups
;
2276 bool isFirstGroupValue
= true;
2278 for (int i
= 0; i
<= maxIndex
; ++i
) {
2279 if (isChildItem(i
)) {
2282 const QString newGroupValue
= m_itemData
.at(i
)->values
.value(role
).toString();
2283 if (newGroupValue
!= groupValue
|| isFirstGroupValue
) {
2284 groupValue
= newGroupValue
;
2285 groups
.append(QPair
<int, QVariant
>(i
, newGroupValue
));
2286 isFirstGroupValue
= false;
2293 void KFileItemModel::emitSortProgress(int resolvedCount
)
2295 // Be tolerant against a resolvedCount with a wrong range.
2296 // Although there should not be a case where KFileItemModelRolesUpdater
2297 // (= caller) provides a wrong range, it is important to emit
2298 // a useful progress information even if there is an unexpected
2299 // implementation issue.
2301 const int itemCount
= count();
2302 if (resolvedCount
>= itemCount
) {
2303 m_sortingProgressPercent
= -1;
2304 if (m_resortAllItemsTimer
->isActive()) {
2305 m_resortAllItemsTimer
->stop();
2309 emit
directorySortingProgress(100);
2310 } else if (itemCount
> 0) {
2311 resolvedCount
= qBound(0, resolvedCount
, itemCount
);
2313 const int progress
= resolvedCount
* 100 / itemCount
;
2314 if (m_sortingProgressPercent
!= progress
) {
2315 m_sortingProgressPercent
= progress
;
2316 emit
directorySortingProgress(progress
);
2321 const KFileItemModel::RoleInfoMap
* KFileItemModel::rolesInfoMap(int& count
)
2323 static const RoleInfoMap rolesInfoMap
[] = {
2324 // | role | roleType | role translation | group translation | requires Baloo | requires indexer
2325 { nullptr, NoRole
, nullptr, nullptr, nullptr, nullptr, false, false },
2326 { "text", NameRole
, I18NC_NOOP("@label", "Name"), nullptr, nullptr, false, false },
2327 { "size", SizeRole
, I18NC_NOOP("@label", "Size"), nullptr, nullptr, false, false },
2328 { "modificationtime", ModificationTimeRole
, I18NC_NOOP("@label", "Modified"), nullptr, nullptr, false, false },
2329 { "creationtime", CreationTimeRole
, I18NC_NOOP("@label", "Created"), nullptr, nullptr, false, false },
2330 { "accesstime", AccessTimeRole
, I18NC_NOOP("@label", "Accessed"), nullptr, nullptr, false, false },
2331 { "type", TypeRole
, I18NC_NOOP("@label", "Type"), nullptr, nullptr, false, false },
2332 { "rating", RatingRole
, I18NC_NOOP("@label", "Rating"), nullptr, nullptr, true, false },
2333 { "tags", TagsRole
, I18NC_NOOP("@label", "Tags"), nullptr, nullptr, true, false },
2334 { "comment", CommentRole
, I18NC_NOOP("@label", "Comment"), nullptr, nullptr, true, false },
2335 { "title", TitleRole
, I18NC_NOOP("@label", "Title"), I18NC_NOOP("@label", "Document"), true, true },
2336 { "wordCount", WordCountRole
, I18NC_NOOP("@label", "Word Count"), I18NC_NOOP("@label", "Document"), true, true },
2337 { "lineCount", LineCountRole
, I18NC_NOOP("@label", "Line Count"), I18NC_NOOP("@label", "Document"), true, true },
2338 { "imageDateTime", ImageDateTimeRole
, I18NC_NOOP("@label", "Date Photographed"), I18NC_NOOP("@label", "Image"), true, true },
2339 { "width", WidthRole
, I18NC_NOOP("@label", "Width"), I18NC_NOOP("@label", "Image"), true, true },
2340 { "height", HeightRole
, I18NC_NOOP("@label", "Height"), I18NC_NOOP("@label", "Image"), true, true },
2341 { "orientation", OrientationRole
, I18NC_NOOP("@label", "Orientation"), I18NC_NOOP("@label", "Image"), true, true },
2342 { "artist", ArtistRole
, I18NC_NOOP("@label", "Artist"), I18NC_NOOP("@label", "Audio"), true, true },
2343 { "genre", GenreRole
, I18NC_NOOP("@label", "Genre"), I18NC_NOOP("@label", "Audio"), true, true },
2344 { "album", AlbumRole
, I18NC_NOOP("@label", "Album"), I18NC_NOOP("@label", "Audio"), true, true },
2345 { "duration", DurationRole
, I18NC_NOOP("@label", "Duration"), I18NC_NOOP("@label", "Audio"), true, true },
2346 { "bitrate", BitrateRole
, I18NC_NOOP("@label", "Bitrate"), I18NC_NOOP("@label", "Audio"), true, true },
2347 { "track", TrackRole
, I18NC_NOOP("@label", "Track"), I18NC_NOOP("@label", "Audio"), true, true },
2348 { "releaseYear", ReleaseYearRole
, I18NC_NOOP("@label", "Release Year"), I18NC_NOOP("@label", "Audio"), true, true },
2349 { "aspectRatio", AspectRatioRole
, I18NC_NOOP("@label", "Aspect Ratio"), I18NC_NOOP("@label", "Video"), true, true },
2350 { "frameRate", FrameRateRole
, I18NC_NOOP("@label", "Frame Rate"), I18NC_NOOP("@label", "Video"), true, true },
2351 { "path", PathRole
, I18NC_NOOP("@label", "Path"), I18NC_NOOP("@label", "Other"), false, false },
2352 { "deletiontime", DeletionTimeRole
, I18NC_NOOP("@label", "Deletion Time"), I18NC_NOOP("@label", "Other"), false, false },
2353 { "destination", DestinationRole
, I18NC_NOOP("@label", "Link Destination"), I18NC_NOOP("@label", "Other"), false, false },
2354 { "originUrl", OriginUrlRole
, I18NC_NOOP("@label", "Downloaded From"), I18NC_NOOP("@label", "Other"), true, false },
2355 { "permissions", PermissionsRole
, I18NC_NOOP("@label", "Permissions"), I18NC_NOOP("@label", "Other"), false, false },
2356 { "owner", OwnerRole
, I18NC_NOOP("@label", "Owner"), I18NC_NOOP("@label", "Other"), false, false },
2357 { "group", GroupRole
, I18NC_NOOP("@label", "User Group"), I18NC_NOOP("@label", "Other"), false, false },
2360 count
= sizeof(rolesInfoMap
) / sizeof(RoleInfoMap
);
2361 return rolesInfoMap
;
2364 void KFileItemModel::determineMimeTypes(const KFileItemList
& items
, int timeout
)
2366 QElapsedTimer timer
;
2368 foreach (const KFileItem
& item
, items
) { // krazy:exclude=foreach
2369 // Only determine mime types for files here. For directories,
2370 // KFileItem::determineMimeType() reads the .directory file inside to
2371 // load the icon, but this is not necessary at all if we just need the
2372 // type. Some special code for setting the correct mime type for
2373 // directories is in retrieveData().
2374 if (!item
.isDir()) {
2375 item
.determineMimeType();
2378 if (timer
.elapsed() > timeout
) {
2379 // Don't block the user interface, let the remaining items
2380 // be resolved asynchronously.
2386 QByteArray
KFileItemModel::sharedValue(const QByteArray
& value
)
2388 static QSet
<QByteArray
> pool
;
2389 const QSet
<QByteArray
>::const_iterator it
= pool
.constFind(value
);
2391 if (it
!= pool
.constEnd()) {
2399 bool KFileItemModel::isConsistent() const
2401 // m_items may contain less items than m_itemData because m_items
2402 // is populated lazily, see KFileItemModel::index(const QUrl& url).
2403 if (m_items
.count() > m_itemData
.count()) {
2407 for (int i
= 0, iMax
= count(); i
< iMax
; ++i
) {
2408 // Check if m_items and m_itemData are consistent.
2409 const KFileItem item
= fileItem(i
);
2410 if (item
.isNull()) {
2411 qCWarning(DolphinDebug
) << "Item" << i
<< "is null";
2415 const int itemIndex
= index(item
);
2416 if (itemIndex
!= i
) {
2417 qCWarning(DolphinDebug
) << "Item" << i
<< "has a wrong index:" << itemIndex
;
2421 // Check if the items are sorted correctly.
2422 if (i
> 0 && !lessThan(m_itemData
.at(i
- 1), m_itemData
.at(i
), m_collator
)) {
2423 qCWarning(DolphinDebug
) << "The order of items" << i
- 1 << "and" << i
<< "is wrong:"
2424 << fileItem(i
- 1) << fileItem(i
);
2428 // Check if all parent-child relationships are consistent.
2429 const ItemData
* data
= m_itemData
.at(i
);
2430 const ItemData
* parent
= data
->parent
;
2432 if (expandedParentsCount(data
) != expandedParentsCount(parent
) + 1) {
2433 qCWarning(DolphinDebug
) << "expandedParentsCount is inconsistent for parent" << parent
->item
<< "and child" << data
->item
;
2437 const int parentIndex
= index(parent
->item
);
2438 if (parentIndex
>= i
) {
2439 qCWarning(DolphinDebug
) << "Index" << parentIndex
<< "of parent" << parent
->item
<< "is not smaller than index" << i
<< "of child" << data
->item
;