3 * This file is part of LyX, the document processor.
4 * Licence details can be found in the file COPYING.
7 * \author Abdelrazak Younes
9 * Full author contact details are available in file CREDITS.
14 #include "TocWidget.h"
16 #include "GuiApplication.h"
18 #include "qt_helpers.h"
20 #include "FancyLineEdit.h"
23 #include "BufferView.h"
25 #include "CutAndPaste.h"
26 #include "FuncRequest.h"
27 #include "FuncStatus.h"
30 #include "TocBackend.h"
32 #include "insets/InsetCommand.h"
33 #include "insets/InsetRef.h"
35 #include "support/debug.h"
36 #include "support/lassert.h"
38 #include <QHeaderView>
49 TocWidget::TocWidget(GuiView & gui_view, QWidget * parent)
50 : QWidget(parent), depth_(0), persistent_(false), gui_view_(gui_view),
51 timer_(new QTimer(this))
55 moveOutTB->setIcon(QIcon(getPixmap("images/", "outline-out", "svgz,png")));
56 moveInTB->setIcon(QIcon(getPixmap("images/", "outline-in", "svgz,png")));
57 moveUpTB->setIcon(QIcon(getPixmap("images/", "outline-up", "svgz,png")));
58 moveDownTB->setIcon(QIcon(getPixmap("images/", "outline-down", "svgz,png")));
59 updateTB->setIcon(QIcon(getPixmap("images/", "reload", "svgz,png")));
61 QSize icon_size = gui_view.iconSize();
62 moveOutTB->setIconSize(icon_size);
63 moveInTB->setIconSize(icon_size);
64 moveUpTB->setIconSize(icon_size);
65 moveDownTB->setIconSize(icon_size);
66 updateTB->setIconSize(icon_size);
69 tocTV->setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOn);
73 // hide the pointless QHeader for now
74 // in the future, new columns may appear
75 // like labels, bookmarks, etc...
76 // tocTV->header()->hide();
77 tocTV->header()->setVisible(false);
79 // Only one item selected at a time.
80 tocTV->setSelectionMode(QAbstractItemView::SingleSelection);
82 // The toc types combo won't change its model.
83 typeCO->setModel(gui_view_.tocModels().nameModel());
86 filter_ = new FancyLineEdit(this);
87 filter_->setClearButton(true);
88 filter_->setPlaceholderText(qt_("All items"));
89 filterBarL->addWidget(filter_, 0);
90 filterLA->setBuddy(filter_);
91 setFocusProxy(filter_);
93 // Make sure the buttons are disabled when first shown without a loaded
95 enableControls(false);
97 // make us responsible for the context menu of the tabbar
98 setContextMenuPolicy(Qt::CustomContextMenu);
99 connect(this, SIGNAL(customContextMenuRequested(const QPoint &)),
100 this, SLOT(showContextMenu(const QPoint &)));
101 connect(tocTV, SIGNAL(customContextMenuRequested(const QPoint &)),
102 this, SLOT(showContextMenu(const QPoint &)));
103 connect(filter_, SIGNAL(textEdited(QString)),
104 this, SLOT(filterContents()));
105 #if (QT_VERSION < 0x050000)
106 connect(filter_, SIGNAL(downPressed()),
107 tocTV, SLOT(setFocus()));
109 connect(filter_, &FancyLineEdit::downPressed,
110 tocTV, [this](){ focusAndHighlight(tocTV); });
112 connect(activeFilterCO, SIGNAL(activated(int)),
113 this, SLOT(filterContents()));
115 // setting the update timer
116 timer_->setSingleShot(true);
117 connect(timer_, SIGNAL(timeout()), this, SLOT(finishUpdateView()));
123 void TocWidget::showContextMenu(const QPoint & pos)
125 std::string name = "context-toc-" + fromqstr(current_type_);
126 QMenu * menu = guiApp->menus().menu(toqstr(name), gui_view_);
129 menu->exec(mapToGlobal(pos));
133 Inset * TocWidget::itemInset() const
135 QModelIndex const & index = tocTV->currentIndex();
136 TocItem const & item =
137 gui_view_.tocModels().currentItem(current_type_, index);
138 DocIterator const & dit = item.dit();
140 Inset * inset = nullptr;
141 if (current_type_ == "label"
142 || current_type_ == "graphics"
143 || current_type_ == "citation"
144 || current_type_ == "child")
145 inset = dit.nextInset();
147 else if (current_type_ == "branch"
148 || current_type_ == "index"
149 || current_type_ == "change"
150 || current_type_ == "table"
151 || current_type_ == "listing"
152 || current_type_ == "figure")
153 inset = &dit.inset();
159 bool TocWidget::getStatus(Cursor & cur, FuncRequest const & cmd,
160 FuncStatus & status) const
162 Inset * inset = itemInset();
163 FuncRequest tmpcmd(cmd);
165 QModelIndex const & index = tocTV->currentIndex();
166 TocItem const & item =
167 gui_view_.tocModels().currentItem(current_type_, index);
169 switch (cmd.action())
171 case LFUN_CHANGE_ACCEPT:
172 case LFUN_CHANGE_REJECT:
173 case LFUN_OUTLINE_UP:
174 case LFUN_OUTLINE_DOWN:
175 case LFUN_OUTLINE_IN:
176 case LFUN_OUTLINE_OUT:
177 case LFUN_SECTION_SELECT:
178 status.setEnabled((bool)item.dit());
181 case LFUN_LABEL_COPY_AS_REFERENCE: {
182 // For labels in math, we need to supply the label as a string
183 FuncRequest label_copy(LFUN_LABEL_COPY_AS_REFERENCE, item.str());
185 return inset->getStatus(cur, label_copy, status);
191 return inset->getStatus(cur, tmpcmd, status);
198 void TocWidget::doDispatch(Cursor & cur, FuncRequest const & cmd,
202 Inset * inset = itemInset();
204 QModelIndex const & index = tocTV->currentIndex();
205 TocItem const & item =
206 gui_view_.tocModels().currentItem(current_type_, index);
208 // Start an undo group.
209 cur.beginUndoGroup();
211 switch (cmd.action())
213 case LFUN_CHANGE_ACCEPT:
214 case LFUN_CHANGE_REJECT: {
215 // The action is almost always LYX_UNKNOWN_ACTION, which will
216 // have the effect of moving the cursor to the location of
217 // the change. (See TocItem::action.)
218 dispatch(item.action());
219 // If we do not reset the origin, then the request will be sent back
220 // here, and we are in an infinite loop. But we need the dispatch
221 // machinery to clean up for us, if the cursor is in an inset that
222 // will be deleted. See bug #10316.
223 FuncRequest tmpcmd(cmd);
224 tmpcmd.setOrigin(FuncRequest::INTERNAL);
226 dr.forceBufferUpdate();
230 case LFUN_SECTION_SELECT:
231 dispatch(item.action());
233 // necessary to get the selection drawn.
234 cur.buffer()->changed(true);
235 gui_view_.setFocus();
238 case LFUN_LABEL_COPY_AS_REFERENCE: {
239 // For labels in math, we need to supply the label as a string
240 FuncRequest label_copy(LFUN_LABEL_COPY_AS_REFERENCE, item.str());
242 inset->dispatch(cur, label_copy);
246 case LFUN_OUTLINE_UP:
247 case LFUN_OUTLINE_DOWN:
248 case LFUN_OUTLINE_IN:
249 case LFUN_OUTLINE_OUT:
250 outline(cmd.action());
254 FuncRequest tmpcmd(cmd);
256 inset->dispatch(cur, tmpcmd);
263 void TocWidget::on_tocTV_activated(QModelIndex const & index)
269 void TocWidget::on_tocTV_pressed(QModelIndex const & index)
272 Qt::MouseButtons const button = QApplication::mouseButtons();
273 if (button & Qt::LeftButton) {
275 gui_view_.setFocus();
276 gui_view_.activateWindow();
281 void TocWidget::goTo(QModelIndex const & index)
283 LYXERR(Debug::GUI, "goto " << index.row()
284 << ", " << index.column());
286 sendDispatch(gui_view_.tocModels().goTo(current_type_, index));
290 void TocWidget::on_updateTB_clicked()
292 // The backend update can take some time so we disable
293 // the controls while waiting.
294 enableControls(false);
295 gui_view_.currentBufferView()->buffer().updateBuffer();
299 void TocWidget::on_sortCB_stateChanged(int state)
301 gui_view_.tocModels().sort(current_type_, state == Qt::Checked);
306 void TocWidget::on_persistentCB_stateChanged(int state)
308 persistent_ = state == Qt::Checked;
313 /* FIXME (Ugras 17/11/06):
314 I have implemented a indexDepth function to get the model indices. In my
315 opinion, somebody should derive a new qvariant class for tocModelItem
316 which saves the string data and depth information. That will save the
317 depth calculation. */
319 static int indexDepth(QModelIndex const & index, int depth = -1)
322 return index.parent() == QModelIndex()
323 ? depth : indexDepth(index.parent(), depth);
327 void TocWidget::on_depthSL_valueChanged(int depth)
332 gui_view_.setFocus();
336 void TocWidget::setTreeDepth(int depth)
343 tocTV->collapseAll();
345 tocTV->expandToDepth(depth - 1);
349 void TocWidget::on_typeCO_activated(int index)
353 current_type_ = typeCO->itemData(index).toString();
355 if (typeCO->hasFocus())
356 gui_view_.setFocus();
360 void TocWidget::outline(FuncCode func_code)
362 QModelIndexList const & list = tocTV->selectionModel()->selectedIndexes();
366 //if another window is active, this attempt will fail,
367 //but it will work at least for the second attempt
368 gui_view_.activateWindow();
370 enableControls(false);
372 sendDispatch(FuncRequest(func_code));
373 enableControls(true);
374 gui_view_.setFocus();
378 void TocWidget::sendDispatch(FuncRequest fr)
381 fr.setViewOrigin(&gui_view_);
382 GuiWorkArea * old_wa = gui_view_.currentWorkArea();
383 GuiWorkArea * doc_wa = gui_view_.currentMainWorkArea();
384 /* The ToC command should be dispatched to the document work area,
385 * not the Adv. Find&Replace (which is the only other know
388 if (doc_wa != nullptr && doc_wa != old_wa)
389 gui_view_.setCurrentWorkArea(doc_wa);
390 DispatchResult const & dr = dispatch(fr);
391 /* If the current workarea has not explicitely changed, and the
392 * original one is still visible, let's reset it.
394 if (gui_view_.currentWorkArea() == doc_wa
395 && gui_view_.hasVisibleWorkArea(old_wa)
397 gui_view_.setCurrentWorkArea(old_wa);
399 gui_view_.message(dr.message());
403 void TocWidget::on_moveUpTB_clicked()
405 outline(LFUN_OUTLINE_UP);
409 void TocWidget::on_moveDownTB_clicked()
411 outline(LFUN_OUTLINE_DOWN);
415 void TocWidget::on_moveInTB_clicked()
417 outline(LFUN_OUTLINE_IN);
421 void TocWidget::on_moveOutTB_clicked()
423 outline(LFUN_OUTLINE_OUT);
427 void TocWidget::select(QModelIndex const & index)
429 if (!index.isValid()) {
430 LYXERR(Debug::GUI, "TocWidget::select(): QModelIndex is invalid!");
434 tocTV->scrollTo(index);
435 tocTV->clearSelection();
436 tocTV->setCurrentIndex(index);
440 void TocWidget::enableControls(bool enable)
442 updateTB->setEnabled(enable);
447 moveUpTB->setEnabled(enable);
448 moveDownTB->setEnabled(enable);
449 moveInTB->setEnabled(enable);
450 moveOutTB->setEnabled(enable);
454 void TocWidget::updateView()
456 if (!gui_view_.documentBufferView()) {
457 tocTV->setModel(nullptr);
458 depthSL->setMaximum(0);
459 depthSL->setValue(0);
464 bool const is_sortable = isSortable();
465 sortCB->setEnabled(is_sortable);
466 bool focus = tocTV->hasFocus();
467 tocTV->setEnabled(false);
468 tocTV->setUpdatesEnabled(false);
470 QAbstractItemModel * toc_model =
471 gui_view_.tocModels().model(current_type_);
472 if (tocTV->model() != toc_model) {
473 tocTV->setModel(toc_model);
474 tocTV->setEditTriggers(QAbstractItemView::NoEditTriggers);
476 setTreeDepth(depth_);
479 sortCB->blockSignals(true);
480 sortCB->setChecked(is_sortable
481 && gui_view_.tocModels().isSorted(current_type_));
482 sortCB->blockSignals(false);
484 persistentCB->setEnabled(canNavigate());
486 bool controls_enabled = toc_model && toc_model->rowCount() > 0
487 && !gui_view_.documentBufferView()->buffer().isReadonly();
488 enableControls(controls_enabled);
490 depthSL->setMaximum(gui_view_.tocModels().depth(current_type_));
491 depthSL->setValue(depth_);
492 tocTV->setEnabled(true);
493 tocTV->setUpdatesEnabled(true);
497 // Expensive operations are on a timer. We finish the update immediately
498 // for sparse edition actions, i.e. there was no edition/cursor movement
499 // recently, then every 300ms.
500 if (!timer_->isActive()) {
507 void TocWidget::updateViewNow()
514 void TocWidget::finishUpdateView()
516 // Profiling shows that this is the expensive stuff in the context of typing
517 // text and moving with arrows. For bigger operations, this is negligible,
518 // and outweighted by TocModels::reset() anyway.
521 setTreeDepth(depth_);
522 persistentCB->setChecked(persistent_);
523 // select the item at current cursor location
524 if (gui_view_.documentBufferView()) {
525 DocIterator const & dit = gui_view_.documentBufferView()->cursor();
526 select(gui_view_.tocModels().currentIndex(current_type_, dit));
533 void TocWidget::filterContents()
538 QModelIndexList indices = tocTV->model()->match(
539 tocTV->model()->index(0, 0),
540 Qt::DisplayRole, ".*", -1,
541 #if QT_VERSION >= QT_VERSION_CHECK(5, 15, 0)
542 Qt::MatchFlags(Qt::MatchRegularExpression|Qt::MatchRecursive));
544 // deprecated in Qt 5.15.
545 Qt::MatchFlags(Qt::MatchRegExp|Qt::MatchRecursive));
548 bool const show_active =
549 activeFilterCO->currentIndex() != 2;
550 bool const show_inactive =
551 activeFilterCO->currentIndex() != 1;
553 int size = indices.size();
554 QString const matchstring = filter_ ? filter_->text() : QString();
555 for (int i = 0; i < size; i++) {
556 QModelIndex index = indices[i];
557 bool matches = index.data().toString().contains(
558 matchstring, Qt::CaseInsensitive);
559 TocItem const & item =
560 gui_view_.tocModels().currentItem(current_type_, index);
561 matches &= (show_active && item.isOutput()) || (show_inactive && !item.isOutput());
562 tocTV->setRowHidden(index.row(), index.parent(), !matches);
564 // recursively unhide parents of unhidden children
565 for (int i = size - 1; i >= 0; i--) {
566 QModelIndex index = indices[i];
567 if (!tocTV->isRowHidden(index.row(), index.parent())
568 && index.parent() != QModelIndex())
569 tocTV->setRowHidden(index.parent().row(),
570 index.parent().parent(), false);
575 static QString decodeType(QString const & str)
578 if (type.contains("tableofcontents"))
579 type = "tableofcontents";
580 else if (type.contains("lstlistoflistings"))
582 else if (type.contains("floatlist")) {
583 if (type.contains("\"figure"))
585 else if (type.contains("\"table"))
587 else if (type.contains("\"algorithm"))
594 void TocWidget::init(QString const & str)
598 new_index = typeCO->findData(current_type_);
600 new_index = typeCO->findData(decodeType(str));
602 // If everything else fails, settle on the table of contents which is
603 // guaranteed to exist.
604 if (new_index == -1) {
605 current_type_ = "tableofcontents";
606 new_index = typeCO->findData(current_type_);
608 current_type_ = typeCO->itemData(new_index).toString();
611 typeCO->blockSignals(true);
612 typeCO->setCurrentIndex(new_index);
613 typeCO->blockSignals(false);
617 } // namespace frontend
620 #include "moc_TocWidget.cpp"