btbookshelfwidget.cpp

Go to the documentation of this file.

/*********
*
* In the name of the Father, and of the Son, and of the Holy Spirit.
*
* This file is part of BibleTime's source code, https://bibletime.info/
*
* Copyright 1999-2025 by the BibleTime developers.
* The BibleTime source code is licensed under the GNU General Public License
* version 2.0.
*
**********/
 
#include "btbookshelfwidget.h"
 
#include <QAction>
#include <QApplication>
#include <QHBoxLayout>
#include <QEvent>
#include <QKeyEvent>
#include <QLabel>
#include <QLineEdit>
#include <QMenu>
#include <QModelIndex>
#include <QToolButton>
#include <QVariant>
#include <QVBoxLayout>
#include <utility>
#include "../backend/bookshelfmodel/btbookshelffiltermodel.h"
#include "../backend/bookshelfmodel/btbookshelftreemodel.h"
#include "../backend/config/btconfig.h"
#include "../util/btassert.h"
#include "../util/btconnect.h"
#include "../util/cresmgr.h"
#include "btbookshelfgroupingmenu.h"
#include "btbookshelfview.h"
 
 
class CSwordModuleInfo;
class QPoint;
 
BtBookshelfWidget::BtBookshelfWidget(QWidget *parent, Qt::WindowFlags flags)
    : QWidget(parent, flags)
    , m_treeModel(nullptr)
    , m_leftCornerWidget(nullptr)
    , m_rightCornerWidget(nullptr)
{
    // Setup post-filter:
    m_postFilterModel = new BtBookshelfFilterModel(this);
 
    // Init widgets and such:
    initActions();
    initMenus();
    initWidgets();
 
    // Connect treeview to model:
    m_treeView->setModel(m_postFilterModel);
 
    retranslateUi();
 
    BT_CONNECT(m_nameFilterEdit,  &QLineEdit::textEdited,
               m_postFilterModel,
               &BtBookshelfFilterModel::setNameFilterFixedString);
    BT_CONNECT(m_treeView, &BtBookshelfView::contextMenuActivated,
               [this](QPoint const & pos){ m_contextMenu->popup(pos); });
    BT_CONNECT(m_treeView, &BtBookshelfView::moduleContextMenuActivated,
               [this](CSwordModuleInfo * const module, QPoint const & pos) {
                   if (!m_itemContextMenu)
                       m_itemContextMenu = m_contextMenu;
                   m_itemContextMenu->setProperty(
                               "BtModule",
                               QVariant::fromValue(
                                   static_cast<void *>(module)));
                   m_itemContextMenu->popup(pos);
               });
}
BtBookshelfWidget::BtBookshelfWidget(QWidget *parent, Qt::WindowFlags flags) {…}
 
void
BtBookshelfWidget::setSourceModel(std::shared_ptr<QAbstractItemModel> model) {
    BT_ASSERT(model);
    if (m_treeModel) {
        m_sourceModel = model;
        m_treeModel->setSourceModel(std::move(model));
    } else {
        m_sourceModel = std::move(model);
    }
}
BtBookshelfWidget::setSourceModel(std::shared_ptr<QAbstractItemModel> model) {…}
 
void BtBookshelfWidget::setTreeModel(BtBookshelfTreeModel *model) {
    BT_ASSERT(model);
    BT_ASSERT(!m_treeModel);
    m_treeModel = model;
    m_groupingMenu->setGrouping(m_treeModel->groupingOrder());
    BT_CONNECT(m_treeModel, &BtBookshelfTreeModel::groupingOrderChanged,
               m_groupingMenu, &BtBookshelfGroupingMenu::setGrouping);
    if (m_sourceModel != nullptr) {
        model->setSourceModel(m_sourceModel);
    }
    m_postFilterModel->setSourceModel(model);
}
void BtBookshelfWidget::setTreeModel(BtBookshelfTreeModel *model) {…}
 
void BtBookshelfWidget::setLeftCornerWidget(QWidget *w) {
    delete m_leftCornerWidget;
    w->setParent(this);
    m_toolBar->insertWidget(0, w, 0);
}
void BtBookshelfWidget::setLeftCornerWidget(QWidget *w) {…}
 
void BtBookshelfWidget::setRightCornerWidget(QWidget *w) {
    delete m_rightCornerWidget;
    w->setParent(this);
    m_toolBar->insertWidget(m_toolBar->count(), w, 0);
}
void BtBookshelfWidget::setRightCornerWidget(QWidget *w) {…}
 
void BtBookshelfWidget::initActions() {
    m_showHideAction = new QAction(this);
    m_showHideAction->setIcon(CResMgr::mainIndex::showHide::icon());
    m_showHideAction->setCheckable(true);
    BT_CONNECT(m_showHideAction,  &QAction::toggled,
               m_postFilterModel, &BtBookshelfFilterModel::setShowHidden);
}
void BtBookshelfWidget::initActions() {…}
 
void BtBookshelfWidget::initMenus() {
    // Grouping menu:
    m_groupingMenu = new BtBookshelfGroupingMenu(this);
    BT_CONNECT(m_groupingMenu,
               &BtBookshelfGroupingMenu::signalGroupingOrderChanged,
               [this](BtBookshelfTreeModel::Grouping const & grouping) {
                   m_treeModel->setGroupingOrder(grouping);
                   m_treeView->setRootIsDecorated(!grouping.list().isEmpty());
               });
 
    // Context menu
    m_contextMenu = new QMenu(this);
    m_contextMenu->addMenu(m_groupingMenu);
    m_contextMenu->addAction(m_showHideAction);
 
    // Item context menu
    m_itemContextMenu = m_contextMenu;
}
void BtBookshelfWidget::initMenus() {…}
 
void BtBookshelfWidget::initWidgets() {
    QVBoxLayout *layout(new QVBoxLayout);
    layout->setContentsMargins(0, 8, 0, 0);
    m_toolBar = new QHBoxLayout;
    // Add a small margin between the edge of the window and the label (looks better)
    m_toolBar->setContentsMargins(3, 0, 0, 0);
    m_nameFilterLabel = new QLabel(this);
    m_toolBar->addWidget(m_nameFilterLabel);
 
    m_nameFilterEdit = new QLineEdit(this);
    m_nameFilterEdit->installEventFilter(this);
    m_nameFilterLabel->setBuddy(m_nameFilterEdit);
    m_toolBar->addWidget(m_nameFilterEdit);
 
    m_groupingButton = new QToolButton(this);
    m_groupingButton->setPopupMode(QToolButton::InstantPopup);
    m_groupingButton->setMenu(m_groupingMenu);
    m_groupingButton->setIcon(m_groupingMenu->icon());
    m_groupingButton->setAutoRaise(true);
    m_toolBar->addWidget(m_groupingButton);
 
    m_showHideButton = new QToolButton(this);
    m_showHideButton->setDefaultAction(m_showHideAction);
    m_showHideButton->setAutoRaise(true);
    m_toolBar->addWidget(m_showHideButton);
    layout->addLayout(m_toolBar);
 
    m_treeView = new BtBookshelfView(this);
    layout->addWidget(m_treeView);
    setLayout(layout);
}
void BtBookshelfWidget::initWidgets() {…}
 
void BtBookshelfWidget::retranslateUi() {
    m_nameFilterLabel->setText(tr("Fi&lter:"));
    m_groupingButton->setText(tr("Grouping"));
    m_groupingButton->setToolTip(tr("Change the grouping of items in the bookshelf."));
    m_groupingMenu->setTitle(tr("Grouping"));
    m_showHideAction->setText(tr("Show/hide works"));
}
void BtBookshelfWidget::retranslateUi() {…}
 
bool BtBookshelfWidget::eventFilter(QObject *object, QEvent *event) {
    BT_ASSERT(object == m_nameFilterEdit);
    if (event->type() == QEvent::KeyPress) {
        QKeyEvent *e = static_cast<QKeyEvent*>(event);
        switch (e->key()) {
        case Qt::Key_Up:
        case Qt::Key_Down:
        case Qt::Key_Enter:
        case Qt::Key_Return:
            QApplication::sendEvent(m_treeView, event);
            return true;
        default:
            break;
        }
    }
    return false;
}
bool BtBookshelfWidget::eventFilter(QObject *object, QEvent *event) {…}
 
void BtBookshelfWidget::findExpanded(
        const QModelIndex& index,
        QString prefix,
        QStringList * expandedPaths) {
    QString path = index.data(Qt::DisplayRole).toString();
    if (m_treeView->isExpanded(index)) {
        if (! prefix.isEmpty())
            path = QStringLiteral("%1/%2").arg(prefix, path);
        expandedPaths->append(path);
    }
    int rows = m_postFilterModel->rowCount(index);
    for (int row = 0; row < rows; ++row) {
        auto childIndex = m_postFilterModel->index(row, 0, index);
        findExpanded(childIndex, path, expandedPaths);
    }
}
void BtBookshelfWidget::findExpanded( {…}
 
void BtBookshelfWidget::restoreExpanded(const QModelIndex& index, const QStringList& nodeList) {
    if (nodeList.isEmpty())
        return;
    QString firstNode = nodeList.first();
    QStringList remainingNodes = nodeList;
    remainingNodes.removeFirst();
    int rows = m_postFilterModel->rowCount(index);
    for (int row = 0; row < rows; ++row) {
        auto childIndex = m_postFilterModel->index(row, 0, index);
        QString text = childIndex.data(Qt::DisplayRole).toString();
        if (firstNode == text) {
            m_treeView->expand(childIndex);
            restoreExpanded(childIndex, remainingNodes);
            break;
        }
    }
}
void BtBookshelfWidget::restoreExpanded(const QModelIndex& index, const QStringList& nodeList) {…}
 
void BtBookshelfWidget::loadBookshelfState() {
    auto const paths =
            btConfig().value<QStringList>(
                QStringLiteral("GUI/MainWindow/Docks/Bookshelf/expandPaths"));
    auto rootIndex = m_treeView->rootIndex();
    for (auto const & path : paths) {
        QStringList nodeList = path.split('/');
        restoreExpanded(rootIndex, nodeList);
    }
}
void BtBookshelfWidget::loadBookshelfState() {…}
 
void BtBookshelfWidget::saveBookshelfState() {
    QStringList paths;
    QString prefix;
    auto rootIndex = m_treeView->rootIndex();
    findExpanded(rootIndex, prefix, &paths);
    btConfig().setValue(
                QStringLiteral("GUI/MainWindow/Docks/Bookshelf/expandPaths"),
                paths);
}
void BtBookshelfWidget::saveBookshelfState() {…}