File indexing completed on 2024-04-28 03:47:19

 /*
     File                 : ProjectExplorer.cpp
     Project              : LabPlot
     Description          : A tree view for displaying and editing an AspectTreeModel.
     --------------------------------------------------------------------
     SPDX-FileCopyrightText: 2007-2008 Tilman Benkert <thzs@gmx.net>
     SPDX-FileCopyrightText: 2010-2021 Alexander Semke <alexander.semke@web.de>
 
     SPDX-License-Identifier: GPL-2.0-or-later
 */
 
 #include "ProjectExplorer.h"
 #include "backend/core/AbstractPart.h"
 #include "backend/core/AspectTreeModel.h"
 #include "backend/core/Project.h"
 #include "backend/core/Settings.h"
 #include "backend/core/column/Column.h"
 #include "backend/lib/XmlStreamReader.h"
 #include "backend/worksheet/plots/cartesian/CartesianPlot.h"
 #include "commonfrontend/core/ContentDockWidget.h"
 
 #include <KConfig>
 #include <KConfigGroup>
 #include <KLocalizedString>
 #include <KMessageBox>
 #include <KMessageWidget>
 
 #include <kcoreaddons_version.h>
 #if KCOREADDONS_VERSION >= QT_VERSION_CHECK(5, 79, 0)
 #define HAS_FUZZY_MATCHER true
 #include <KFuzzyMatcher>
 #else
 #define HAS_FUZZY_MATCHER false
 #endif
 
 #include <QClipboard>
 #include <QContextMenuEvent>
 #include <QDrag>
 #include <QHeaderView>
 #include <QLabel>
 #include <QLineEdit>
 #include <QMenu>
 #include <QMimeData>
 #include <QPushButton>
 #include <QTreeView>
 #include <QVBoxLayout>
 
 /*!
   \class ProjectExplorer
   \brief A tree view for displaying and editing an AspectTreeModel.
 
   In addition to the functionality of QTreeView, ProjectExplorer allows
   the usage of the context menus provided by AspectTreeModel
   and propagates the item selection in the view to the model.
   Furthermore, features for searching and filtering in the model are provided.
 
   \ingroup commonfrontend
 */
 
 ProjectExplorer::ProjectExplorer(QWidget* parent)
     : m_treeView(new QTreeView(parent))
     , m_frameFilter(new QFrame(this)) {
     auto* layout = new QVBoxLayout(this);
     layout->setSpacing(0);
     layout->setContentsMargins(0, 0, 0, 0);
 
     auto* layoutFilter = new QHBoxLayout(m_frameFilter);
     layoutFilter->setSpacing(0);
     layoutFilter->setContentsMargins(0, 0, 0, 0);
 
     m_leFilter = new QLineEdit(m_frameFilter);
     m_leFilter->setClearButtonEnabled(true);
     m_leFilter->setPlaceholderText(i18n("Search/Filter"));
     layoutFilter->addWidget(m_leFilter);
 
     bFilterOptions = new QPushButton(m_frameFilter);
     bFilterOptions->setIcon(QIcon::fromTheme(QStringLiteral("configure")));
     bFilterOptions->setCheckable(true);
     bFilterOptions->setFlat(true);
     layoutFilter->addWidget(bFilterOptions);
 
     layout->addWidget(m_frameFilter);
 
     m_treeView->setAnimated(true);
     m_treeView->setAlternatingRowColors(true);
     m_treeView->setSelectionBehavior(QAbstractItemView::SelectRows);
     m_treeView->setSelectionMode(QAbstractItemView::ExtendedSelection);
     m_treeView->setUniformRowHeights(true);
     m_treeView->viewport()->installEventFilter(this);
     m_treeView->header()->setStretchLastSection(true);
     m_treeView->header()->installEventFilter(this);
     m_treeView->setDragEnabled(true);
     m_treeView->setAcceptDrops(true);
     m_treeView->setDropIndicatorShown(true);
     m_treeView->setDragDropMode(QAbstractItemView::InternalMove);
 
     layout->addWidget(m_treeView);
 
     connect(m_leFilter, &QLineEdit::textChanged, this, &ProjectExplorer::filterTextChanged);
     connect(bFilterOptions, &QPushButton::toggled, this, &ProjectExplorer::toggleFilterOptionsMenu);
 }
 
 ProjectExplorer::~ProjectExplorer() {
     // save the visible columns
     QString status;
     for (int i = 0; i < list_showColumnActions.size(); ++i) {
         if (list_showColumnActions.at(i)->isChecked()) {
             if (!status.isEmpty())
                 status += QLatin1Char(' ');
             status += QString::number(i);
         }
     }
     KConfigGroup group = Settings::group(QStringLiteral("ProjectExplorer"));
     group.writeEntry("VisibleColumns", status);
 }
 
 void ProjectExplorer::createActions() {
     expandTreeAction = new QAction(QIcon::fromTheme(QLatin1String("expand-all")), i18n("Expand All"), this);
     connect(expandTreeAction, &QAction::triggered, m_treeView, &QTreeView::expandAll);
 
     expandSelectedTreeAction = new QAction(QIcon::fromTheme(QLatin1String("expand-all")), i18n("Expand Selected"), this);
     connect(expandSelectedTreeAction, &QAction::triggered, this, &ProjectExplorer::expandSelected);
 
     collapseTreeAction = new QAction(QIcon::fromTheme(QLatin1String("collapse-all")), i18n("Collapse All"), this);
     connect(collapseTreeAction, &QAction::triggered, m_treeView, &QTreeView::collapseAll);
 
     collapseSelectedTreeAction = new QAction(QIcon::fromTheme(QLatin1String("collapse-all")), i18n("Collapse Selected"), this);
     connect(collapseSelectedTreeAction, &QAction::triggered, this, &ProjectExplorer::collapseSelected);
 
     deleteSelectedTreeAction = new QAction(QIcon::fromTheme(QStringLiteral("edit-delete")), i18n("Delete Selected"), this);
     connect(deleteSelectedTreeAction, &QAction::triggered, this, &ProjectExplorer::deleteSelected);
 
     toggleFilterAction = new QAction(QIcon::fromTheme(QLatin1String("view-filter")), i18n("Search/Filter Options"), this);
     toggleFilterAction->setCheckable(true);
     toggleFilterAction->setChecked(true);
     connect(toggleFilterAction, &QAction::triggered, this, [=]() {
         m_frameFilter->setVisible(!m_frameFilter->isVisible());
     });
 }
 
 /*!
   shows the context menu in the tree. In addition to the context menu of the currently selected aspect,
   treeview specific options are added.
 */
 void ProjectExplorer::contextMenuEvent(QContextMenuEvent* event) {
     if (!m_treeView->model())
         return;
 
     if (!expandTreeAction)
         createActions();
 
     const auto& index = m_treeView->indexAt(m_treeView->viewport()->mapFrom(this, event->pos()));
     if (!index.isValid())
         m_treeView->clearSelection();
 
     const auto& items = m_treeView->selectionModel()->selectedIndexes();
     QMenu* menu = nullptr;
     if (items.size() / 4 == 1) {
         auto* aspect = static_cast<AbstractAspect*>(index.internalPointer());
         menu = aspect->createContextMenu();
 
         if (aspect == m_project) {
             auto* firstAction = menu->actions().at(2);
             menu->insertSeparator(firstAction);
             menu->insertAction(firstAction, expandTreeAction);
             menu->insertAction(firstAction, collapseTreeAction);
         }
     } else {
         menu = new QMenu(this);
 
         if (items.size() / 4 > 1) {
             // add "expand/collapse" entries if the selected indices have children
             bool hasChildren = false;
             for (int i = 0; i < items.size() / 4; ++i) {
                 const auto& index = items.at(i * 4);
                 const auto* aspect = static_cast<AbstractAspect*>(index.internalPointer());
                 if (aspect->childCount<AbstractAspect>()) {
                     hasChildren = true;
                     break;
                 }
             }
             if (hasChildren) {
                 menu->addAction(expandSelectedTreeAction);
                 menu->addAction(collapseSelectedTreeAction);
                 menu->addSeparator();
             }
 
             menu->addAction(deleteSelectedTreeAction);
         } else {
             QMenu* projectMenu = m_project->createContextMenu();
             projectMenu->setTitle(m_project->name());
             menu->addMenu(projectMenu);
 
             menu->addSeparator();
             menu->addAction(expandTreeAction);
             menu->addAction(collapseTreeAction);
             menu->addSeparator();
             menu->addAction(toggleFilterAction);
 
             // Menu for showing/hiding the columns in the tree view
             QMenu* columnsMenu = menu->addMenu(i18n("Columns"));
             columnsMenu->addAction(showAllColumnsAction);
             columnsMenu->addSeparator();
             for (auto* action : qAsConst(list_showColumnActions))
                 columnsMenu->addAction(action);
 
             // TODO
             // Menu for showing/hiding the top-level aspects (Worksheet, Spreadhsheet, etc) in the tree view
             //  QMenu* objectsMenu = menu->addMenu(i18n("Show/Hide objects"));
         }
     }
 
     if (menu)
         menu->exec(event->globalPos());
 
     delete menu;
 }
 
 void ProjectExplorer::setCurrentAspect(const AbstractAspect* aspect) {
     // HACK: when doing redo/undo in MainWin and an object is being deleted,
     // we don't want to jump to another object in the project explorer.
     // we reuse the aspectAddedSignalSuppressed also for the deletion of aspects.
     if (m_project->aspectAddedSignalSuppressed())
         return;
 
     const auto* tree_model = dynamic_cast<AspectTreeModel*>(m_treeView->model());
     if (tree_model) {
         const auto& index = tree_model->modelIndexOfAspect(aspect);
 // TODO: This crashes on Windows in Debug mode
 #if !defined(HAVE_WINDOWS) || defined(NDEBUG)
         m_treeView->setCurrentIndex(index);
 #endif
     }
 }
 
 /*!
   Sets the \c model for the tree view to present.
 */
 void ProjectExplorer::setModel(AspectTreeModel* treeModel) {
     m_treeView->setModel(treeModel);
 
     connect(treeModel, &AspectTreeModel::renameRequested, m_treeView, static_cast<void (QAbstractItemView::*)(const QModelIndex&)>(&QAbstractItemView::edit));
     connect(treeModel, &AspectTreeModel::indexSelected, this, &ProjectExplorer::selectIndex);
     connect(treeModel, &AspectTreeModel::indexDeselected, this, &ProjectExplorer::deselectIndex);
     connect(treeModel, &AspectTreeModel::hiddenAspectSelected, this, &ProjectExplorer::hiddenAspectSelected);
 
     connect(m_treeView->selectionModel(), &QItemSelectionModel::selectionChanged, this, &ProjectExplorer::selectionChanged);
 
     // create action for showing/hiding the columns in the tree.
     // this is done here since the number of columns is  not available in createActions() yet.
     if (list_showColumnActions.isEmpty()) {
         // read the status of the column actions if available
         KConfigGroup group = Settings::group(QStringLiteral("ProjectExplorer"));
         const QString& status = group.readEntry(QLatin1String("VisibleColumns"), QString());
         QVector<int> checkedActions;
         if (!status.isEmpty()) {
             QStringList strList = status.split(QLatin1Char(' '));
             for (int i = 0; i < strList.size(); ++i)
                 checkedActions << strList.at(i).toInt();
         }
 
         if (!showAllColumnsAction) {
             showAllColumnsAction = new QAction(i18n("Show All"), this);
             showAllColumnsAction->setCheckable(true);
             showAllColumnsAction->setChecked(true);
             showAllColumnsAction->setEnabled(false);
             connect(showAllColumnsAction, &QAction::triggered, this, &ProjectExplorer::showAllColumns);
         }
 
         if (checkedActions.size() != m_treeView->model()->columnCount()) {
             showAllColumnsAction->setEnabled(true);
             showAllColumnsAction->setChecked(false);
         } else {
             showAllColumnsAction->setEnabled(false);
             showAllColumnsAction->setChecked(true);
         }
 
         // create an action for every available column in the model
         for (int i = 0; i < m_treeView->model()->columnCount(); i++) {
             QAction* showColumnAction = new QAction(treeModel->headerData(i, Qt::Horizontal).toString(), this);
             showColumnAction->setCheckable(true);
 
             // restore the status, if available
             if (!checkedActions.isEmpty()) {
                 if (checkedActions.indexOf(i) != -1)
                     showColumnAction->setChecked(true);
                 else
                     m_treeView->hideColumn(i);
             } else
                 showColumnAction->setChecked(true);
 
             list_showColumnActions.append(showColumnAction);
 
             connect(showColumnAction, &QAction::triggered, this, [=] {
                 ProjectExplorer::toggleColumn(i);
             });
         }
     } else {
         for (int i = 0; i < list_showColumnActions.size(); ++i) {
             if (!list_showColumnActions.at(i)->isChecked())
                 m_treeView->hideColumn(i);
         }
     }
 }
 
 void ProjectExplorer::setProject(Project* project) {
     connect(project, &Project::childAspectAdded, this, &ProjectExplorer::aspectAdded);
     connect(project, &Project::requestSaveState, this, &ProjectExplorer::save);
     connect(project, &Project::requestLoadState, this, &ProjectExplorer::load);
     connect(project, &Project::requestNavigateTo, this, &ProjectExplorer::navigateTo);
     m_project = project;
 
     // for newly created projects, resize the header to fit the size of the header section names.
     // for projects loaded from a file, this function will be called laterto fit the sizes
     // of the content once the project is loaded
     resizeHeader();
 
     // remove all error messages from the previous project, if any are visible
     if (m_messageWidget && m_messageWidget->isVisible())
         m_messageWidget->close();
 }
 
 QModelIndex ProjectExplorer::currentIndex() const {
     return m_treeView->currentIndex();
 }
 
 AbstractAspect* ProjectExplorer::currentAspect() const {
     if (!currentIndex().isValid())
         return nullptr;
     return static_cast<AbstractAspect*>(currentIndex().internalPointer());
 }
 
 void ProjectExplorer::search() {
     m_leFilter->setFocus();
 }
 
 /*!
     handles the contextmenu-event of the horizontal header in the tree view.
     Provides a menu for selective showing and hiding of columns.
 */
 bool ProjectExplorer::eventFilter(QObject* obj, QEvent* event) {
     if (obj == m_treeView->header() && event->type() == QEvent::ContextMenu) {
         // Menu for showing/hiding the columns in the tree view
         QMenu* columnsMenu = new QMenu(m_treeView->header());
         columnsMenu->addSection(i18n("Columns"));
         columnsMenu->addAction(showAllColumnsAction);
         columnsMenu->addSeparator();
         for (auto* action : qAsConst(list_showColumnActions))
             columnsMenu->addAction(action);
 
         auto* e = static_cast<QContextMenuEvent*>(event);
         columnsMenu->exec(e->globalPos());
         delete columnsMenu;
 
         return true;
     } else if (obj == m_treeView->viewport()) {
         if (event->type() == QEvent::MouseButtonPress) {
             auto* e = static_cast<QMouseEvent*>(event);
 #if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)
             const auto position = e->globalPosition().toPoint();
 #else
             const auto position = e->globalPos();
 #endif
             if (e->button() == Qt::LeftButton) {
                 QModelIndex index = m_treeView->indexAt(e->pos());
                 if (!index.isValid())
                     return false;
 
                 auto* aspect = static_cast<AbstractAspect*>(index.internalPointer());
                 if (aspect->isDraggable()) {
                     m_dragStartPos = position;
                     m_dragStarted = false;
                 }
             }
         } else if (event->type() == QEvent::MouseMove) {
             auto* e = static_cast<QMouseEvent*>(event);
 #if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)
             const auto position = e->globalPosition().toPoint();
 #else
             const auto position = e->globalPos();
 #endif
             if (!m_dragStarted && m_treeView->selectionModel()->selectedIndexes().size() > 0
                 && (position - m_dragStartPos).manhattanLength() >= QApplication::startDragDistance()) {
                 m_dragStarted = true;
                 auto* drag = new QDrag(this);
                 auto* mimeData = new QMimeData;
 
                 // determine the selected objects and serialize the pointers to QMimeData
                 QVector<quintptr> vec;
                 QModelIndexList items = m_treeView->selectionModel()->selectedIndexes();
                 // there are four model indices in each row -> divide by 4 to obtain the number of selected rows (=aspects)
                 const int columnCount = m_treeView->model()->columnCount();
                 for (int i = 0; i < items.size() / columnCount; ++i) {
                     const QModelIndex& index = items.at(i * columnCount);
                     auto* aspect = static_cast<AbstractAspect*>(index.internalPointer());
                     vec << (quintptr)aspect;
                 }
 
                 QByteArray data;
                 QDataStream stream(&data, QIODevice::WriteOnly);
                 stream << (quintptr)m_project; // serialize the project pointer first, will be used as the unique identifier
                 stream << vec;
 
                 mimeData->setData(QStringLiteral("labplot-dnd"), data);
                 drag->setMimeData(mimeData);
                 drag->exec();
             }
         } else if (event->type() == QEvent::DragEnter) {
             // ignore events not related to internal drags of columns etc., e.g. dropping of external files onto LabPlot
             auto* dragEnterEvent = static_cast<QDragEnterEvent*>(event);
             const QMimeData* mimeData = dragEnterEvent->mimeData();
             if (!mimeData) {
                 event->ignore();
                 return false;
             }
 
             if (mimeData->formats().at(0) != QLatin1String("labplot-dnd")) {
                 event->ignore();
                 return false;
             } else {
                 // drad&drop between the different project windows is not supported yet.
                 // check whether we're dragging inside of the same project.
                 QByteArray data = mimeData->data(QLatin1String("labplot-dnd"));
                 QDataStream stream(&data, QIODevice::ReadOnly);
                 quintptr ptr = 0;
                 stream >> ptr;
                 auto* project = reinterpret_cast<Project*>(ptr);
                 if (project != m_project) {
                     event->ignore();
                     return false;
                 }
             }
 
             event->setAccepted(true);
         } else if (event->type() == QEvent::DragMove) {
             auto* dragMoveEvent = static_cast<QDragEnterEvent*>(event);
             const QMimeData* mimeData = dragMoveEvent->mimeData();
             QVector<quintptr> vec = m_project->droppedAspects(mimeData);
 
             AbstractAspect* sourceAspect{nullptr};
             if (!vec.isEmpty())
                 sourceAspect = reinterpret_cast<AbstractAspect*>(vec.at(0));
 
             if (!sourceAspect)
                 return false;
 
                 // determine the aspect under the cursor
 #if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)
             QModelIndex index = m_treeView->indexAt(dragMoveEvent->position().toPoint());
 #else
             QModelIndex index = m_treeView->indexAt(dragMoveEvent->pos());
 #endif
             if (!index.isValid())
                 return false;
 
             // accept only the events when the aspect being dragged is dropable onto the aspect under the cursor
             // and the aspect under the cursor is not already the parent of the dragged aspect
             auto* destinationAspect = static_cast<AbstractAspect*>(index.internalPointer());
             bool accept = sourceAspect->dropableOn().indexOf(destinationAspect->type()) != -1 && sourceAspect->parentAspect() != destinationAspect;
             event->setAccepted(accept);
         } else if (event->type() == QEvent::Drop) {
             auto* dropEvent = static_cast<QDropEvent*>(event);
             const QMimeData* mimeData = dropEvent->mimeData();
             if (!mimeData)
                 return false;
 
             QVector<quintptr> vec = m_project->droppedAspects(mimeData);
             if (vec.isEmpty())
                 return false;
 
 #if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)
             QModelIndex index = m_treeView->indexAt(dropEvent->position().toPoint());
 #else
             QModelIndex index = m_treeView->indexAt(dropEvent->pos());
 #endif
             if (!index.isValid())
                 return false;
 
             // process the dropped objects
             auto* aspect = static_cast<AbstractAspect*>(index.internalPointer());
             aspect->processDropEvent(vec);
 
             // expand the current aspect to see the dropped objects
             const auto* model = static_cast<const AspectTreeModel*>(m_treeView->model());
             m_treeView->setExpanded(model->modelIndexOfAspect(aspect), true);
         }
     }
 
     return QObject::eventFilter(obj, event);
 }
 
 void ProjectExplorer::keyPressEvent(QKeyEvent* event) {
     // current selected aspect
     auto* aspect = static_cast<AbstractAspect*>(m_treeView->currentIndex().internalPointer());
 
     if (event->matches(QKeySequence::Delete))
         deleteSelected();
     else if (event->matches(QKeySequence::Copy)) {
         // copy
         if (aspect != m_project) {
             aspect->copy();
             showErrorMessage(QString());
         }
     } else if (event->matches(QKeySequence::Paste)) {
         // paste
         QString name;
         auto t = AbstractAspect::clipboardAspectType(name);
         if (!name.isEmpty()) {
             if (t != AspectType::AbstractAspect && aspect->pasteTypes().indexOf(t) != -1) {
                 aspect->paste();
                 showErrorMessage(QString());
             } else {
                 QString msg = i18n("'%1' cannot be pasted into '%2'.", name, aspect->name());
                 showErrorMessage(msg);
             }
         } else {
             // no name is available, we are copy&pasting the content of a columm ("the data") and not the column itself
             const auto* mimeData = QApplication::clipboard()->mimeData();
             if (!mimeData->hasFormat(QStringLiteral("text/plain")))
                 return;
 
             // pasting is allowed into spreadsheet columns only
             if (aspect->type() == AspectType::Column && aspect->parentAspect()->type() == AspectType::Spreadsheet) {
                 auto* column = static_cast<Column*>(aspect);
                 column->pasteData();
             } else {
                 QString msg = i18n("Data cannot be pasted into '%1' directly. Select a spreadsheet column for this.", aspect->name());
                 showErrorMessage(msg);
             }
         }
     } else if ((event->modifiers() & Qt::ControlModifier) && (event->key() == Qt::Key_D)) {
         // duplicate
         if (aspect != m_project) {
             aspect->copy();
             aspect->parentAspect()->paste(true);
             showErrorMessage(QString());
         }
     } else if (event->key() == 32) {
         // space key - hide/show the current object
         changeSelectedVisible();
     }
 }
 
 void ProjectExplorer::showErrorMessage(const QString& message) {
     if (message.isEmpty()) {
         if (m_messageWidget && m_messageWidget->isVisible())
             m_messageWidget->close();
     } else {
         if (!m_messageWidget) {
             m_messageWidget = new KMessageWidget(this);
             m_messageWidget->setMessageType(KMessageWidget::Error);
             layout()->addWidget(m_messageWidget);
         }
         m_messageWidget->setText(message);
         m_messageWidget->animatedShow();
     }
 }
 
 // ##############################################################################
 // #################################  SLOTS  ####################################
 // ##############################################################################
 /*!
   expand the aspect \c aspect (the tree index corresponding to it) in the tree view
   and makes it visible and selected. Called when a new aspect is added to the project.
  */
 void ProjectExplorer::aspectAdded(const AbstractAspect* aspect) {
     if (m_project->isLoading() || m_project->aspectAddedSignalSuppressed())
         return;
 
     // don't do anything if hidden aspects were added
     if (aspect->hidden())
         return;
 
     // don't do anything for newly added data spreadsheets of data picker curves
     if (aspect->type() == AspectType::Spreadsheet && aspect->parentAspect()->type() == AspectType::DatapickerCurve)
         return;
 
     const auto* tree_model = qobject_cast<AspectTreeModel*>(m_treeView->model());
     const auto& index = tree_model->modelIndexOfAspect(aspect);
 
     // expand and make the aspect visible
     // no need to expand and to show child columns of a statistics spreadsheet
     if (aspect->type() != AspectType::StatisticsSpreadsheet)
         m_treeView->setExpanded(index, true);
 
     // newly added columns are only expanded but not selected, return here
     if (aspect->type() == AspectType::Column) {
         m_treeView->setExpanded(tree_model->modelIndexOfAspect(aspect->parentAspect()), true);
         return;
     }
 
     m_treeView->scrollTo(index);
     m_treeView->setCurrentIndex(index);
     m_treeView->header()->resizeSections(QHeaderView::ResizeToContents);
     m_treeView->header()->resizeSection(0, m_treeView->header()->sectionSize(0) * 1.2);
 }
 
 void ProjectExplorer::navigateTo(const QString& path) {
     const auto* tree_model = dynamic_cast<AspectTreeModel*>(m_treeView->model());
     if (tree_model) {
         const auto& index = tree_model->modelIndexOfAspect(path);
         if (!index.isValid())
             return;
         m_treeView->scrollTo(index);
         m_treeView->setCurrentIndex(index);
         auto* aspect = static_cast<AbstractAspect*>(index.internalPointer());
         aspect->setSelected(true);
     }
 }
 
 void ProjectExplorer::toggleColumn(int index) {
     // determine the total number of checked column actions
     int checked = 0;
     for (const auto* action : qAsConst(list_showColumnActions)) {
         if (action->isChecked())
             checked++;
     }
 
     if (list_showColumnActions.at(index)->isChecked()) {
         m_treeView->showColumn(index);
         m_treeView->header()->resizeSection(0, 0);
         m_treeView->header()->resizeSections(QHeaderView::ResizeToContents);
 
         for (auto* action : qAsConst(list_showColumnActions))
             action->setEnabled(true);
 
         // deactivate the "show all column"-action, if all actions are checked
         if (checked == list_showColumnActions.size()) {
             showAllColumnsAction->setEnabled(false);
             showAllColumnsAction->setChecked(true);
         }
     } else {
         m_treeView->hideColumn(index);
         showAllColumnsAction->setEnabled(true);
         showAllColumnsAction->setChecked(false);
 
         // if there is only one checked column-action, deactivated it.
         // It should't be possible to hide all columns
         if (checked == 1) {
             int i = 0;
             while (!list_showColumnActions.at(i)->isChecked())
                 i++;
 
             list_showColumnActions.at(i)->setEnabled(false);
         }
     }
 }
 
 void ProjectExplorer::showAllColumns() {
     for (int i = 0; i < m_treeView->model()->columnCount(); i++) {
         m_treeView->showColumn(i);
         m_treeView->header()->resizeSection(0, 0);
         m_treeView->header()->resizeSections(QHeaderView::ResizeToContents);
     }
     showAllColumnsAction->setEnabled(false);
 
     for (auto* action : qAsConst(list_showColumnActions)) {
         action->setEnabled(true);
         action->setChecked(true);
     }
 }
 
 /*!
   toggles the menu for the filter/search options
 */
 void ProjectExplorer::toggleFilterOptionsMenu(bool checked) {
     if (!checked)
         return;
 
     if (!caseSensitiveAction) {
         caseSensitiveAction = new QAction(i18n("Case Sensitive"), this);
         caseSensitiveAction->setCheckable(true);
         caseSensitiveAction->setChecked(false);
         connect(caseSensitiveAction, &QAction::triggered, this, [=]() {
             if (!m_leFilter->text().isEmpty())
                 filterTextChanged(m_leFilter->text());
         });
 
         matchCompleteWordAction = new QAction(i18n("Match Complete Word"), this);
         matchCompleteWordAction->setCheckable(true);
         matchCompleteWordAction->setChecked(false);
         connect(matchCompleteWordAction, &QAction::triggered, this, [=]() {
             if (!m_leFilter->text().isEmpty())
                 filterTextChanged(m_leFilter->text());
         });
 
 #if HAS_FUZZY_MATCHER
         fuzzyMatchingAction = new QAction(i18n("Fuzzy Matching"), this);
         fuzzyMatchingAction->setCheckable(true);
         fuzzyMatchingAction->setChecked(true);
         connect(fuzzyMatchingAction, &QAction::triggered, this, [=]() {
             bool enabled = !fuzzyMatchingAction->isChecked();
             caseSensitiveAction->setEnabled(enabled);
             matchCompleteWordAction->setEnabled(enabled);
             if (!m_leFilter->text().isEmpty())
                 filterTextChanged(m_leFilter->text());
         });
         caseSensitiveAction->setEnabled(false);
         matchCompleteWordAction->setEnabled(false);
 #endif
     }
 
     QMenu menu;
 #if HAS_FUZZY_MATCHER
     menu.addAction(fuzzyMatchingAction);
     menu.addSeparator();
 #endif
     menu.addAction(caseSensitiveAction);
     menu.addAction(matchCompleteWordAction);
     connect(&menu, &QMenu::aboutToHide, bFilterOptions, &QPushButton::toggle);
     menu.exec(bFilterOptions->mapToGlobal(QPoint(0, bFilterOptions->height())));
 }
 
 void ProjectExplorer::resizeHeader() {
     m_treeView->header()->resizeSections(QHeaderView::ResizeToContents);
     m_treeView->header()->resizeSection(0, m_treeView->header()->sectionSize(0) * 1.2); // make the column "Name" somewhat bigger
 }
 
 /*!
   called when the filter/search text was changend.
 */
 void ProjectExplorer::filterTextChanged(const QString& text) {
     QModelIndex root = m_treeView->model()->index(0, 0);
     filter(root, text);
 }
 
 bool ProjectExplorer::filter(const QModelIndex& index, const QString& text) {
     const auto* model = index.model();
     const int rows = model->rowCount(index);
 
     // if the filter string is empty, just traverse the whole model and make every index visible
     if (text.isEmpty()) {
         for (int i = 0; i < rows; ++i) {
             m_treeView->setRowHidden(i, index, false);
             const auto& child = model->index(i, 0, index);
             if (model->hasChildren(child))
                 filter(child, text);
         }
         return true;
     }
 
 #if HAS_FUZZY_MATCHER
     bool fuzzyFiltering = true;
     if (fuzzyMatchingAction && !fuzzyMatchingAction->isChecked())
         fuzzyFiltering = false;
 #endif
 
     bool childVisible = false;
     for (int i = 0; i < rows; i++) {
         const auto& child = model->index(i, 0, index);
         auto* aspect = static_cast<AbstractAspect*>(child.internalPointer());
         bool visible;
 #if HAS_FUZZY_MATCHER
         if (fuzzyFiltering)
             visible = KFuzzyMatcher::matchSimple(text, aspect->name());
         else
 #endif
         {
             bool matchCompleteWord = false;
             if (matchCompleteWordAction && matchCompleteWordAction->isChecked())
                 matchCompleteWord = true;
 
             Qt::CaseSensitivity sensitivity = Qt::CaseInsensitive;
             if (caseSensitiveAction && caseSensitiveAction->isChecked())
                 sensitivity = Qt::CaseSensitive;
 
             if (matchCompleteWord)
                 visible = aspect->name().startsWith(text, sensitivity);
             else
                 visible = aspect->name().contains(text, sensitivity);
         }
 
         if (visible) {
             // current item is visible -> make all its children visible without applying the filter
             for (int j = 0; j < model->rowCount(child); ++j)
                 m_treeView->setRowHidden(j, child, false);
 
             childVisible = true;
         } else {
             // check children items. if one of the children is visible, make the parent (current) item visible too.
             visible = filter(child, text);
             if (visible)
                 childVisible = true;
         }
 
         m_treeView->setRowHidden(i, index, !visible);
     }
 
     return childVisible;
 }
 
 void ProjectExplorer::selectIndex(const QModelIndex& index) {
     if (m_project->isLoading())
         return;
 
     DEBUG(Q_FUNC_INFO)
 
     if (!m_treeView->selectionModel()->isSelected(index)) {
         m_changeSelectionFromView = true;
         m_treeView->selectionModel()->select(index, QItemSelectionModel::Select | QItemSelectionModel::Rows);
         m_treeView->setExpanded(index, true);
         m_treeView->scrollTo(index);
     }
 }
 
 void ProjectExplorer::deselectIndex(const QModelIndex& index) {
     if (m_project->isLoading())
         return;
 
     if (m_treeView->selectionModel()->isSelected(index)) {
         m_changeSelectionFromView = true;
         m_treeView->selectionModel()->select(index, QItemSelectionModel::Deselect | QItemSelectionModel::Rows);
     }
 }
 
 void ProjectExplorer::selectionChanged(const QItemSelection& selected, const QItemSelection& deselected) {
     if (m_project->isLoading())
         return;
 
     // QDEBUG(Q_FUNC_INFO << ", selected/deselected = " << selected << "/" << deselected)
 
     QModelIndex index;
     AbstractAspect* aspect = nullptr;
 
     // there are four model indices in each row
     //-> divide by 4 to obtain the number of selected rows (=aspects)
     const auto& sitems = selected.indexes();
     for (int i = 0; i < sitems.size() / 4; ++i) {
         index = sitems.at(i * 4);
         aspect = static_cast<AbstractAspect*>(index.internalPointer());
         QDEBUG("sitems ASPECT =" << aspect)
         aspect->setSelected(true);
     }
 
     const auto& ditems = deselected.indexes();
     for (int i = 0; i < ditems.size() / 4; ++i) {
         index = ditems.at(i * 4);
         aspect = static_cast<AbstractAspect*>(index.internalPointer());
         QDEBUG("ditems ASPECT =" << aspect)
         aspect->setSelected(false);
     }
 
     const auto& items = m_treeView->selectionModel()->selectedRows();
     QList<AbstractAspect*> selectedAspects;
     for (const auto& index : items) {
         aspect = static_cast<AbstractAspect*>(index.internalPointer());
         QDEBUG("items ASPECT =" << aspect)
         selectedAspects << aspect;
     }
 
     // notify GuiObserver about the new selection
     Q_EMIT selectedAspectsChanged(selectedAspects);
 
     // notify MainWin about the new current aspect (last selected aspect).
     if (!selectedAspects.isEmpty())
         Q_EMIT currentAspectChanged(selectedAspects.last());
 
     // emitting the signal above is done to show the properties widgets for the selected aspect(s).
     // with this the project explorer looses the focus and don't react on the key events like DEL key press, etc.
     // If we explicitly select an item in the project explorer (not via a selection in the view), we want to keep the focus here.
     // TODO: after the focus is set again we react on DEL in the event filter, but navigation with the arrow keys in the table
     // is still not possible. Looks like we need to set the selection again...
     if (!m_changeSelectionFromView)
         setFocus();
     else
         m_changeSelectionFromView = false;
 }
 
 void ProjectExplorer::expandSelected() {
     const auto& items = m_treeView->selectionModel()->selectedIndexes();
     for (const auto& index : items)
         m_treeView->setExpanded(index, true);
 }
 
 void ProjectExplorer::collapseSelected() {
     const auto& items = m_treeView->selectionModel()->selectedIndexes();
     for (const auto& index : items)
         m_treeView->setExpanded(index, false);
 }
 
 void ProjectExplorer::changeSelectedVisible() {
     const auto& items = m_treeView->selectionModel()->selectedIndexes();
 
     // determine all selected aspects
     QVector<WorksheetElement*> elements;
     const auto columnCount = m_treeView->model()->columnCount();
     for (int i = 0; i < items.size() / columnCount; ++i) {
         const QModelIndex& index = items.at(i * columnCount);
         auto* aspect = static_cast<AbstractAspect*>(index.internalPointer());
         auto* element = dynamic_cast<WorksheetElement*>(aspect);
         if (element)
             elements << element;
     }
 
     const int numberElements = elements.size();
     if (numberElements == 0)
         return;
 
     // Use first element as reference
     const auto& firstElement = elements.constFirst();
     const bool newVisible = !firstElement->isVisible();
 
     if (numberElements > 1) {
         firstElement->beginMacro(i18n("%1 elements: set visible: %2").arg(numberElements, newVisible));
         for (auto* e : elements)
             e->setVisible(newVisible);
         firstElement->endMacro();
     } else
         firstElement->setVisible(newVisible);
 }
 
 void ProjectExplorer::deleteSelected() {
     const auto& items = m_treeView->selectionModel()->selectedIndexes();
     if (!items.size())
         return;
 
     // determine all selected aspects
     QVector<AbstractAspect*> aspects;
     const auto columnCount = m_treeView->model()->columnCount();
     for (int i = 0; i < items.size() / columnCount; ++i) {
         const QModelIndex& index = items.at(i * columnCount);
         auto* aspect = static_cast<AbstractAspect*>(index.internalPointer());
         aspects << aspect;
     }
 
     QString msg;
     if (aspects.size() > 1)
         msg = i18n("Do you really want to delete the selected %1 objects?", aspects.size());
     else
         msg = i18n("Do you really want to delete %1?", aspects.constFirst()->name());
 
 #if KCOREADDONS_VERSION >= QT_VERSION_CHECK(5, 100, 0)
     auto status = KMessageBox::warningTwoActions(this,
                                                  msg,
                                                  i18np("Delete selected object", "Delete selected objects", aspects.size()),
                                                  KStandardGuiItem::del(),
                                                  KStandardGuiItem::cancel());
     if (status == KMessageBox::SecondaryAction)
         return;
 #else
     auto status = KMessageBox::warningYesNo(this, msg, i18np("Delete selected object", "Delete selected objects", aspects.size()));
     if (status == KMessageBox::No)
         return;
 #endif
 
     m_project->beginMacro(i18np("Project Explorer: delete %1 selected object", "Project Explorer: delete %1 selected objects", items.size() / 4));
 
     // determine aspects to be deleted:
     // it's enough to delete parent items in the selection only,
     // skip all selected aspects where one of the parents is also in the selection
     // for example selected columns of a selected spreadsheet, etc.
     QVector<AbstractAspect*> aspectsToDelete;
     for (auto* aspect : aspects) {
         auto* parent = aspect->parentAspect();
         int parentSelected = false;
         while (parent) {
             if (aspects.indexOf(parent) != -1) {
                 parentSelected = true;
                 break;
             }
 
             parent = parent->parentAspect();
         }
 
         if (!parentSelected)
             aspectsToDelete << aspect; // parent is not in the selection
     }
 
     for (auto* aspect : aspectsToDelete)
         aspect->remove();
 
     m_project->endMacro();
 }
 
 // ##############################################################################
 // ##################  Serialization/Deserialization  ###########################
 // ##############################################################################
 struct ViewState {
     Qt::WindowStates state;
     QRect geometry;
 };
 
 /**
  * \brief Save the current state of the tree view
  * (expanded items and the currently selected item) as XML
  */
 void ProjectExplorer::save(QXmlStreamWriter* writer) const {
     const auto* model = static_cast<AspectTreeModel*>(m_treeView->model());
     const auto& selectedRows = m_treeView->selectionModel()->selectedRows();
 
     writer->writeStartElement(QStringLiteral("state"));
 
     // check whether the project node itself is expanded or selected or current
     const auto& index = m_treeView->model()->index(0, 0);
     if (m_treeView->isExpanded(index)) {
         writer->writeStartElement(QStringLiteral("expanded"));
         writer->writeAttribute(QStringLiteral("path"), m_project->path());
         writer->writeEndElement();
     }
 
     if (selectedRows.indexOf(index) != -1) {
         writer->writeStartElement(QStringLiteral("selected"));
         writer->writeAttribute(QStringLiteral("path"), m_project->path());
         writer->writeEndElement();
     }
 
     if (index == m_treeView->currentIndex()) {
         writer->writeStartElement(QStringLiteral("current"));
         writer->writeAttribute(QStringLiteral("path"), m_project->path());
         writer->writeEndElement();
     }
 
     // traverse the children nodes
     const auto& children = m_project->children<AbstractAspect>(AbstractAspect::ChildIndexFlag::Recursive);
     for (const auto* aspect : children) {
         const QString& path = aspect->path();
         const auto* part = dynamic_cast<const AbstractPart*>(aspect);
 
         if (part && part->hasMdiSubWindow()) {
             writer->writeStartElement(QStringLiteral("view"));
             const auto& geometry = part->dockWidget()->geometry();
             writer->writeAttribute(QStringLiteral("path"), path);
             writer->writeAttribute(QStringLiteral("state"), QString::number(part->view()->windowState()));
             writer->writeAttribute(QStringLiteral("x"), QString::number(geometry.x()));
             writer->writeAttribute(QStringLiteral("y"), QString::number(geometry.y()));
             writer->writeAttribute(QStringLiteral("width"), QString::number(geometry.width()));
             writer->writeAttribute(QStringLiteral("height"), QString::number(geometry.height()));
             writer->writeEndElement();
         }
 
         const auto& index = model->modelIndexOfAspect(aspect);
         if (model->rowCount(index) > 0 && m_treeView->isExpanded(index)) {
             writer->writeStartElement(QStringLiteral("expanded"));
             writer->writeAttribute(QStringLiteral("path"), path);
             writer->writeEndElement();
         }
 
         if (selectedRows.indexOf(index) != -1) {
             writer->writeStartElement(QStringLiteral("selected"));
             writer->writeAttribute(QStringLiteral("path"), path);
             writer->writeEndElement();
         }
 
         if (index == m_treeView->currentIndex()) {
             writer->writeStartElement(QStringLiteral("current"));
             writer->writeAttribute(QStringLiteral("path"), path);
             writer->writeEndElement();
         }
     }
 
     writer->writeEndElement(); //"state"
 }
 
 /**
  * \brief Load from XML
  */
 bool ProjectExplorer::load(XmlStreamReader* reader) {
     const auto* model = static_cast<AspectTreeModel*>(m_treeView->model());
     QList<QModelIndex> selected;
     QList<QModelIndex> expanded;
     QModelIndex currentIndex;
     QString str;
 
     // xmlVersion < 3: old logic where the "rows" for the selected and expanded items were saved
     // ignoring the sub-folder structure. Remove it later.
     if (Project::xmlVersion() < 3) {
         const auto& aspects = m_project->children<AbstractAspect>(AbstractAspect::ChildIndexFlag::Recursive);
         bool expandedItem = false;
         bool selectedItem = false;
         bool viewItem = false;
         (void)viewItem; // because of a strange g++-warning about unused viewItem
         bool currentItem = false;
         int row;
         QXmlStreamAttributes attribs;
 
         while (!reader->atEnd()) {
             reader->readNext();
             if (reader->isEndElement() && reader->name() == QLatin1String("state"))
                 break;
 
             if (!reader->isStartElement())
                 continue;
 
             if (reader->name() == QLatin1String("expanded")) {
                 expandedItem = true;
                 selectedItem = false;
                 viewItem = false;
                 currentItem = false;
             } else if (reader->name() == QLatin1String("selected")) {
                 expandedItem = false;
                 selectedItem = true;
                 viewItem = false;
                 currentItem = false;
             } else if (reader->name() == QLatin1String("view")) {
                 expandedItem = false;
                 selectedItem = false;
                 viewItem = true;
                 currentItem = false;
             } else if (reader->name() == QLatin1String("current")) {
                 expandedItem = false;
                 selectedItem = false;
                 viewItem = false;
                 currentItem = true;
             } else if (reader->name() == QLatin1String("row")) {
                 // we need to read the attributes first and before readElementText() otherwise they are empty
                 attribs = reader->attributes();
                 row = reader->readElementText().toInt();
 
                 QModelIndex index;
                 if (row == -1)
                     index = model->modelIndexOfAspect(m_project); //-1 corresponds to the project-item (s.a. ProjectExplorer::save())
                 else if (row >= aspects.size() || row < 0) // checking for <0 to protect against wrong values in the XML
                     continue;
                 else
                     index = model->modelIndexOfAspect(aspects.at(row));
 
                 if (expandedItem)
                     expanded.push_back(index);
                 else if (selectedItem)
                     selected.push_back(index);
                 else if (currentItem)
                     currentIndex = index;
                 else if (viewItem) {
                     if (row < 0) // should never happen, but we need to handle the corrupted file
                         continue;
 
                     auto* part = dynamic_cast<AbstractPart*>(aspects.at(row));
                     if (!part)
                         continue; // TODO: add error/warning message here?
 
                     Q_EMIT activateView(part); // request to show the view in MainWin
 
                     str = attribs.value(QStringLiteral("state")).toString();
                     if (str.isEmpty())
                         reader->raiseMissingAttributeWarning(QStringLiteral("state"));
                     else {
                         part->view()->setWindowState(Qt::WindowStates(str.toInt()));
                         part->dockWidget()->setWindowState(Qt::WindowStates(str.toInt()));
                     }
 
                     if (str != QLatin1String("0"))
                         continue; // no geometry settings required for maximized/minimized windows
 
                     QRect geometry;
                     str = attribs.value(QStringLiteral("x")).toString();
                     if (str.isEmpty())
                         reader->raiseMissingAttributeWarning(QStringLiteral("x"));
                     else
                         geometry.setX(str.toInt());
 
                     str = attribs.value(QStringLiteral("y")).toString();
                     if (str.isEmpty())
                         reader->raiseMissingAttributeWarning(QStringLiteral("y"));
                     else
                         geometry.setY(str.toInt());
 
                     str = attribs.value(QStringLiteral("width")).toString();
                     if (str.isEmpty())
                         reader->raiseMissingAttributeWarning(QStringLiteral("width"));
                     else
                         geometry.setWidth(str.toInt());
 
                     str = attribs.value(QStringLiteral("height")).toString();
                     if (str.isEmpty())
                         reader->raiseMissingAttributeWarning(QStringLiteral("height"));
                     else
                         geometry.setHeight(str.toInt());
 
                     part->dockWidget()->setGeometry(geometry);
                 }
             }
         }
 
     } else {
         while (!reader->atEnd()) {
             reader->readNext();
             if (reader->isEndElement() && reader->name() == QLatin1String("state"))
                 break;
 
             if (!reader->isStartElement())
                 continue;
 
             const auto& attribs = reader->attributes();
             const auto& path = attribs.value(QStringLiteral("path")).toString();
             const auto& index = model->modelIndexOfAspect(path);
 
             if (reader->name() == QLatin1String("expanded"))
                 expanded << index;
             else if (reader->name() == QLatin1String("selected"))
                 selected << index;
             else if (reader->name() == QLatin1String("current"))
                 currentIndex = index;
             else if (reader->name() == QLatin1String("view")) {
                 auto* aspect = static_cast<AbstractAspect*>(index.internalPointer());
                 auto* part = dynamic_cast<AbstractPart*>(aspect);
                 if (!part)
                     continue; // TODO: add error/warning message here?
 
                 Q_EMIT activateView(part); // request to show the view in MainWin
 
                 str = attribs.value(QStringLiteral("state")).toString();
                 if (str.isEmpty())
                     reader->raiseMissingAttributeWarning(QStringLiteral("state"));
                 else {
                     part->view()->setWindowState(Qt::WindowStates(str.toInt()));
                     part->dockWidget()->setWindowState(Qt::WindowStates(str.toInt()));
                 }
 
                 if (str != QLatin1String("0"))
                     continue; // no geometry settings required for maximized/minimized windows
 
                 QRect geometry;
                 str = attribs.value(QStringLiteral("x")).toString();
                 if (str.isEmpty())
                     reader->raiseMissingAttributeWarning(QStringLiteral("x"));
                 else
                     geometry.setX(str.toInt());
 
                 str = attribs.value(QStringLiteral("y")).toString();
                 if (str.isEmpty())
                     reader->raiseMissingAttributeWarning(QStringLiteral("y"));
                 else
                     geometry.setY(str.toInt());
 
                 str = attribs.value(QStringLiteral("width")).toString();
                 if (str.isEmpty())
                     reader->raiseMissingAttributeWarning(QStringLiteral("width"));
                 else
                     geometry.setWidth(str.toInt());
 
                 str = attribs.value(QStringLiteral("height")).toString();
                 if (str.isEmpty())
                     reader->raiseMissingAttributeWarning(QStringLiteral("height"));
                 else
                     geometry.setHeight(str.toInt());
 
                 part->dockWidget()->setGeometry(geometry);
             }
         }
     }
 
     for (const auto& index : expanded) {
         m_treeView->setExpanded(index, true);
         collapseParents(index, expanded); // collapse all parent indices if they are not expanded
     }
 
     for (const auto& index : selected)
         m_treeView->selectionModel()->select(index, QItemSelectionModel::Select | QItemSelectionModel::Rows);
 
     m_treeView->setCurrentIndex(currentIndex);
     m_treeView->scrollTo(currentIndex);
     auto* aspect = static_cast<AbstractAspect*>(currentIndex.internalPointer());
     if (aspect)
         aspect->setSelected(true);
     Q_EMIT currentAspectChanged(aspect); // notify MainWin to bring up the proper view
     Q_EMIT selectedAspectsChanged(QList<AbstractAspect*>() << aspect); // notify GuiObserver to bring up the proper dock widget
 
     // when setting the current index above it gets expanded, collapse all parent indices if they were not expanded when saved
     collapseParents(currentIndex, expanded);
 
     // resize the header of the view to adjust to the content
     resizeHeader();
 
     return true;
 }
 
 void ProjectExplorer::collapseParents(const QModelIndex& index, const QList<QModelIndex>& expanded) {
     if (index.column() == 0 && index.row() == 0) { // root/project index, doesn't have any parent
         if (expanded.indexOf(index) == -1)
             m_treeView->collapse(index);
     } else {
         const auto& parent = index.parent();
         if (parent != QModelIndex() && expanded.indexOf(parent) == -1)
             m_treeView->collapse(parent);
     }
 }