// Copyright (C) 2021 The Qt Company Ltd. // Copyright (C) 2019 Luxoft Sweden AB // Copyright (C) 2018 Pelagicore AG // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only #include #include #include #include #include "global.h" #include "logging.h" #include "applicationmanager.h" #include "applicationmodel.h" #include "application.h" #include "qml-utilities.h" #include "utilities.h" /*! \qmltype ApplicationModel \inherits QSortFilterProxyModel \ingroup system-ui-instantiable \inqmlmodule QtApplicationManager.SystemUI \brief A proxy model for the ApplicationManager singleton. The ApplicationModel type provides a customizable model that can be used to tailor the ApplicationManager model to your needs. The ApplicationManager singleton is a model itself, that includes all available applications. In contrast, the ApplicationModel supports filtering and sorting. Since the ApplicationModel is based on the ApplicationManager model, the latter is referred to as the \e source model. The ApplicationModel includes the same \l {ApplicationManager Roles} {roles} as the ApplicationManager model. \note If you require a model with all applications, with no filtering whatsoever, you should use the ApplicationManager directly, as it has better performance. The following code snippet displays all the icons of non-aliased applications in a list: \qml import QtQuick import QtApplicationManager.SystemUI ListView { model: ApplicationModel { filterFunction: function(application) { return !application.alias; } } delegate: Image { required property string icon source: icon } } \endqml */ /*! \qmlproperty int ApplicationModel::count \readonly Holds the number of applications included in this model. */ /*! \qmlproperty var ApplicationModel::filterFunction A JavaScript function callback that is invoked for each application in the ApplicationManager source model. This function gets one ApplicationObject parameter and must return a Boolean. If the application passed should be included in this model, then the function must return \c true; \c false otherwise. If you need no filtering at all, you should set this property to an undefined (the default) or null value. \note Whenever this function is changed, the filter is reevaluated. However, dynamic properties used in this function, like \c isRunning, don't trigger a reevaluation when those properties change. Changes in the source model are reflected. To force a complete reevaluation, call \l {ApplicationModel::invalidate()}{invalidate()}. */ /*! \qmlproperty var ApplicationModel::sortFunction A JavaScript function callback that is invoked to sort the applications in this model. This function gets two ApplicationObject parameters and must return a Boolean. If the first application should have a smaller index in this model than the second, the function must return \c true; \c false otherwise. If you need no sorting at all, you should set this property to an undefined (the default) or null value. \note Whenever this function is changed, the model is sorted. However, dynamic properties used in this function, like \c isRunning, don't trigge a sort when when those properties change. Changes in the source model are reflected. To force a complete reevaluation, call \l {ApplicationModel::invalidate()}{invalidate()}. */ QT_BEGIN_NAMESPACE_AM class ApplicationModelPrivate { public: QJSEngine *m_engine = nullptr; QJSValue m_filterFunction; QJSValue m_sortFunction; }; ApplicationModel::ApplicationModel(QObject *parent) : QSortFilterProxyModel(parent) , d(new ApplicationModelPrivate()) { setSourceModel(ApplicationManager::instance()); connect(this, &QAbstractItemModel::rowsInserted, this, &ApplicationModel::countChanged); connect(this, &QAbstractItemModel::rowsRemoved, this, &ApplicationModel::countChanged); connect(this, &QAbstractItemModel::layoutChanged, this, &ApplicationModel::countChanged); connect(this, &QAbstractItemModel::modelReset, this, &ApplicationModel::countChanged); } ApplicationModel::~ApplicationModel() { delete d; } int ApplicationModel::count() const { return rowCount(); } bool ApplicationModel::filterAcceptsRow(int source_row, const QModelIndex &source_parent) const { Q_UNUSED(source_parent) if (!d->m_engine) { d->m_engine = qjsEngine(this); if (!d->m_engine) qCWarning(LogSystem) << "ApplicationModel can't filter without a JavaScript engine"; } if (d->m_engine && d->m_filterFunction.isCallable()) { const QObject *app = ApplicationManager::instance()->application(source_row); QJSValueList args = { d->m_engine->newQObject(const_cast(app)) }; return d->m_filterFunction.call(args).toBool(); } return true; } bool ApplicationModel::lessThan(const QModelIndex &source_left, const QModelIndex &source_right) const { if (!d->m_engine) { d->m_engine = qjsEngine(this); if (!d->m_engine) qCWarning(LogSystem) << "ApplicationModel can't sort without a JavaScript engine"; } if (d->m_engine && d->m_sortFunction.isCallable()) { const QObject *app1 = ApplicationManager::instance()->application(source_left.row()); const QObject *app2 = ApplicationManager::instance()->application(source_right.row()); QJSValueList args = { d->m_engine->newQObject(const_cast(app1)), d->m_engine->newQObject(const_cast(app2)) }; return d->m_sortFunction.call(args).toBool(); } return QSortFilterProxyModel::lessThan(source_left, source_right); } QJSValue ApplicationModel::filterFunction() const { return d->m_filterFunction; } void ApplicationModel::setFilterFunction(const QJSValue &callback) { if (!callback.isCallable() && !callback.isNull() && !callback.isUndefined()) { qmlWarning(this) << "The filterFunction property of ApplicationModel needs to be either " "callable, or undefined/null to clear it."; } if (!callback.equals(d->m_filterFunction)) { #if (QT_VERSION >= QT_VERSION_CHECK(6, 10, 0)) beginFilterChange(); #endif d->m_filterFunction = callback; emit filterFunctionChanged(); #if (QT_VERSION >= QT_VERSION_CHECK(6, 10, 0)) endFilterChange(); #else invalidateFilter(); #endif } } QJSValue ApplicationModel::sortFunction() const { return d->m_sortFunction; } void ApplicationModel::setSortFunction(const QJSValue &callback) { if (!callback.isCallable() && !callback.isNull() && !callback.isUndefined()) { qmlWarning(this) << "The sortFunction property of ApplicationModel needs to be either " "callable, or undefined/null to clear it."; } if (!callback.equals(d->m_sortFunction)) { d->m_sortFunction = callback; emit sortFunctionChanged(); invalidate(); sort(0); } } /*! \qmlmethod int ApplicationModel::indexOfApplication(string id) Maps the application corresponding to the given \a id to its position within this model. Returns \c -1 if the specified application is invalid, or not part of this model. */ int ApplicationModel::indexOfApplication(const QString &id) const { int idx = ApplicationManager::instance()->indexOfApplication(id); return idx != -1 ? mapFromSource(idx) : idx; } /*! \qmlmethod int ApplicationModel::indexOfApplication(ApplicationObject application) Maps the \a application to its position within this model. Returns \c -1 if the specified application is invalid, or not part of this model. */ int ApplicationModel::indexOfApplication(Application *application) const { int idx = ApplicationManager::instance()->indexOfApplication(application); return idx != -1 ? mapFromSource(idx) : idx; } /*! \qmlmethod int ApplicationModel::mapToSource(int index) Maps an application's \a index in this model to the corresponding index in the ApplicationManager model. Returns \c -1 if the specified \a index is invalid. */ int ApplicationModel::mapToSource(int ourIndex) const { return QSortFilterProxyModel::mapToSource(index(ourIndex, 0)).row(); } /*! \qmlmethod int ApplicationModel::mapFromSource(int index) Maps an application's \a index from the ApplicationManager model to the corresponding index in this model. Returns \c -1 if the specified \a index is invalid. */ int ApplicationModel::mapFromSource(int sourceIndex) const { return QSortFilterProxyModel::mapFromSource(sourceModel()->index(sourceIndex, 0)).row(); } /*! \qmlmethod ApplicationModel::invalidate() Forces a reevaluation of the model. */ void ApplicationModel::invalidate() { QSortFilterProxyModel::invalidate(); } void ApplicationModel::classBegin() { } void ApplicationModel::componentComplete() { ensureCurrentContextIsSystemUI(this); } QT_END_NAMESPACE_AM #include "moc_applicationmodel.cpp"