src/frontends/qt4/TocWidget.cpp

   1 /**
   2  * \file TocWidget.cpp
   3  * This file is part of LyX, the document processor.
   4  * Licence details can be found in the file COPYING.
   5  *
   6  * \author John Levon
   7  * \author Abdelrazak Younes
   8  *
   9  * Full author contact details are available in file CREDITS.
  10  */
  11
  12 #include <config.h>
  13
  14 #include "TocWidget.h"
  15
  16 #include "GuiApplication.h"
  17 #include "GuiView.h"
  18 #include "qt_helpers.h"
  19 #include "TocModel.h"
  20
  21 #include "Buffer.h"
  22 #include "BufferView.h"
  23 #include "CutAndPaste.h"
  24 #include "FuncRequest.h"
  25 #include "FuncStatus.h"
  26 #include "LyX.h"
  27 #include "Menus.h"
  28 #include "TocBackend.h"
  29
  30 #include "insets/InsetCommand.h"
  31 #include "insets/InsetRef.h"
  32
  33 #include "support/debug.h"
  34 #include "support/lassert.h"
  35
  36 #include <QHeaderView>
  37 #include <QMenu>
  38 #include <QTimer>
  39
  40 #include <vector>
  41
  42 #define DELAY_UPDATE_VIEW
  43
  44 using namespace std;
  45
  46 namespace lyx {
  47 namespace frontend {
  48
  49 TocWidget::TocWidget(GuiView & gui_view, QWidget * parent)
  50         : QWidget(parent), depth_(0), persistent_(false), gui_view_(gui_view), update_delay_(0)
  51
  52 {
  53         setupUi(this);
  54
  55         moveOutTB->setIcon(QIcon(getPixmap("images/", "promote", "png")));
  56         moveInTB->setIcon(QIcon(getPixmap("images/", "demote", "png")));
  57         moveUpTB->setIcon(QIcon(getPixmap("images/", "up", "png")));
  58         moveDownTB->setIcon(QIcon(getPixmap("images/", "down", "png")));
  59         updateTB->setIcon(QIcon(getPixmap("images/", "reload", "png")));
  60
  61         // avoid flickering
  62         tocTV->setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOn);
  63
  64         tocTV->showColumn(0);
  65
  66         // hide the pointless QHeader for now
  67         // in the future, new columns may appear
  68         // like labels, bookmarks, etc...
  69         // tocTV->header()->hide();
  70         tocTV->header()->setVisible(false);
  71
  72         // Only one item selected at a time.
  73         tocTV->setSelectionMode(QAbstractItemView::SingleSelection);
  74         setFocusProxy(tocTV);
  75
  76         // The toc types combo won't change its model.
  77         typeCO->setModel(gui_view_.tocModels().nameModel());
  78
  79         // Make sure the buttons are disabled when first shown without a loaded
  80         // Buffer.
  81         enableControls(false);
  82
  83         // make us responsible for the context menu of the tabbar
  84         setContextMenuPolicy(Qt::CustomContextMenu);
  85         connect(this, SIGNAL(customContextMenuRequested(const QPoint &)),
  86                 this, SLOT(showContextMenu(const QPoint &)));
  87         connect(tocTV, SIGNAL(customContextMenuRequested(const QPoint &)),
  88                 this, SLOT(showContextMenu(const QPoint &)));
  89         connect(filterLE, SIGNAL(textEdited(QString)),
  90                 this, SLOT(filterContents()));
  91
  92         init(QString());
  93 }
  94
  95
  96 void TocWidget::showContextMenu(const QPoint & pos)
  97 {
  98         std::string name = "context-toc-" + fromqstr(current_type_);
  99         QMenu * menu = guiApp->menus().menu(toqstr(name), gui_view_);
 100         if (!menu)
 101                 return;
 102         menu->exec(mapToGlobal(pos));
 103 }
 104
 105
 106 Inset * TocWidget::itemInset() const
 107 {
 108         QModelIndex const & index = tocTV->currentIndex();
 109         TocItem const & item =
 110                 gui_view_.tocModels().currentItem(current_type_, index);
 111         DocIterator const & dit = item.dit();
 112
 113         Inset * inset = 0;
 114         if (current_type_ == "label"
 115                   || current_type_ == "graphics"
 116                   || current_type_ == "citation"
 117                   || current_type_ == "child")
 118                 inset = dit.nextInset();
 119
 120         else if (current_type_ == "branch"
 121                          || current_type_ == "index"
 122                          || current_type_ == "change")
 123                 inset = &dit.inset();
 124
 125         else if (current_type_ == "table"
 126                      || current_type_ == "listing"
 127                      || current_type_ == "figure") {
 128                 DocIterator tmp_dit(dit);
 129                 tmp_dit.pop_back();
 130                 inset = &tmp_dit.inset();
 131         }
 132         return inset;
 133 }
 134
 135
 136 bool TocWidget::getStatus(Cursor & cur, FuncRequest const & cmd,
 137         FuncStatus & status) const
 138 {
 139         Inset * inset = itemInset();
 140         FuncRequest tmpcmd(cmd);
 141
 142         QModelIndex const & index = tocTV->currentIndex();
 143         TocItem const & item =
 144                 gui_view_.tocModels().currentItem(current_type_, index);
 145
 146         switch (cmd.action())
 147         {
 148         case LFUN_CHANGE_ACCEPT:
 149         case LFUN_CHANGE_REJECT:
 150         case LFUN_OUTLINE_UP:
 151         case LFUN_OUTLINE_DOWN:
 152         case LFUN_OUTLINE_IN:
 153         case LFUN_OUTLINE_OUT:
 154         case LFUN_SECTION_SELECT:
 155                 status.setEnabled(true);
 156                 return true;
 157
 158         case LFUN_LABEL_COPY_AS_REF: {
 159                 // For labels in math, we need to supply the label as a string
 160                 FuncRequest label_copy(LFUN_LABEL_COPY_AS_REF, item.asString());
 161                 if (inset)
 162                         return inset->getStatus(cur, label_copy, status);
 163         }
 164
 165         default:
 166                 if (inset)
 167                         return inset->getStatus(cur, tmpcmd, status);
 168         }
 169
 170         return false;
 171 }
 172
 173
 174 void TocWidget::doDispatch(Cursor & cur, FuncRequest const & cmd)
 175 {
 176         Inset * inset = itemInset();
 177         FuncRequest tmpcmd(cmd);
 178
 179         QModelIndex const & index = tocTV->currentIndex();
 180         TocItem const & item =
 181                 gui_view_.tocModels().currentItem(current_type_, index);
 182
 183         // Start an undo group.
 184         cur.beginUndoGroup();
 185
 186         switch (cmd.action())
 187         {
 188         case LFUN_CHANGE_ACCEPT:
 189         case LFUN_CHANGE_REJECT:
 190         case LFUN_SECTION_SELECT:
 191                 dispatch(item.action());
 192                 cur.dispatch(tmpcmd);
 193                 break;
 194
 195         case LFUN_LABEL_COPY_AS_REF: {
 196                 // For labels in math, we need to supply the label as a string
 197                 FuncRequest label_copy(LFUN_LABEL_COPY_AS_REF, item.asString());
 198                 if (inset)
 199                         inset->dispatch(cur, label_copy);
 200                 break;
 201         }
 202
 203         case LFUN_OUTLINE_UP:
 204         case LFUN_OUTLINE_DOWN:
 205         case LFUN_OUTLINE_IN:
 206         case LFUN_OUTLINE_OUT:
 207                 outline(cmd.action());
 208                 break;
 209
 210         default:
 211                 if (inset)
 212                         inset->dispatch(cur, tmpcmd);
 213         }
 214         cur.endUndoGroup();
 215 }
 216
 217
 218 void TocWidget::on_tocTV_activated(QModelIndex const & index)
 219 {
 220         goTo(index);
 221 }
 222
 223
 224 void TocWidget::on_tocTV_pressed(QModelIndex const & index)
 225 {
 226         Qt::MouseButtons const button = QApplication::mouseButtons();
 227         if (button & Qt::LeftButton) {
 228                 goTo(index);
 229                 gui_view_.setFocus();
 230         }
 231 }
 232
 233
 234 void TocWidget::goTo(QModelIndex const & index)
 235 {
 236         LYXERR(Debug::GUI, "goto " << index.row()
 237                 << ", " << index.column());
 238
 239         gui_view_.tocModels().goTo(current_type_, index);
 240 }
 241
 242
 243 void TocWidget::on_updateTB_clicked()
 244 {
 245         // The backend update can take some time so we disable
 246         // the controls while waiting.
 247         enableControls(false);
 248         gui_view_.currentBufferView()->buffer().updateBuffer();
 249 }
 250
 251
 252 void TocWidget::on_sortCB_stateChanged(int state)
 253 {
 254         gui_view_.tocModels().sort(current_type_, state == Qt::Checked);
 255         updateViewForce();
 256 }
 257
 258
 259 void TocWidget::on_persistentCB_stateChanged(int state)
 260 {
 261         persistent_ = state == Qt::Checked;
 262 }
 263
 264
 265 #if 0
 266 /* FIXME (Ugras 17/11/06):
 267 I have implemented a indexDepth function to get the model indices. In my
 268 opinion, somebody should derive a new qvariant class for tocModelItem
 269 which saves the string data and depth information. That will save the
 270 depth calculation.  */
 271
 272 static int indexDepth(QModelIndex const & index, int depth = -1)
 273 {
 274         ++depth;
 275         return index.parent() == QModelIndex()
 276                 ? depth : indexDepth(index.parent(), depth);
 277 }
 278 #endif
 279
 280 void TocWidget::on_depthSL_valueChanged(int depth)
 281 {
 282         if (depth == depth_)
 283                 return;
 284         setTreeDepth(depth);
 285         gui_view_.setFocus();
 286 }
 287
 288
 289 void TocWidget::setTreeDepth(int depth)
 290 {
 291         depth_ = depth;
 292         if (!tocTV->model())
 293                 return;
 294
 295         if (depth == 0)
 296                 tocTV->collapseAll();
 297         else
 298                 tocTV->expandToDepth(depth - 1);
 299 }
 300
 301
 302 void TocWidget::on_typeCO_currentIndexChanged(int index)
 303 {
 304         if (index == -1)
 305                 return;
 306         current_type_ = typeCO->itemData(index).toString();
 307         updateViewForce();
 308         if (typeCO->hasFocus())
 309                 gui_view_.setFocus();
 310 }
 311
 312
 313 void TocWidget::outline(FuncCode func_code)
 314 {
 315         QModelIndexList const & list = tocTV->selectionModel()->selectedIndexes();
 316         if (list.isEmpty())
 317                 return;
 318         enableControls(false);
 319         goTo(list[0]);
 320         dispatch(FuncRequest(func_code));
 321         enableControls(true);
 322         gui_view_.setFocus();
 323 }
 324
 325
 326 void TocWidget::on_moveUpTB_clicked()
 327 {
 328         outline(LFUN_OUTLINE_UP);
 329 }
 330
 331
 332 void TocWidget::on_moveDownTB_clicked()
 333 {
 334         outline(LFUN_OUTLINE_DOWN);
 335 }
 336
 337
 338 void TocWidget::on_moveInTB_clicked()
 339 {
 340         outline(LFUN_OUTLINE_IN);
 341 }
 342
 343
 344 void TocWidget::on_moveOutTB_clicked()
 345 {
 346         outline(LFUN_OUTLINE_OUT);
 347 }
 348
 349
 350 void TocWidget::select(QModelIndex const & index)
 351 {
 352         if (!index.isValid()) {
 353                 LYXERR(Debug::GUI, "TocWidget::select(): QModelIndex is invalid!");
 354                 return;
 355         }
 356
 357         tocTV->scrollTo(index);
 358         tocTV->clearSelection();
 359         tocTV->setCurrentIndex(index);
 360 }
 361
 362
 363 void TocWidget::enableControls(bool enable)
 364 {
 365         updateTB->setEnabled(enable);
 366
 367         if (!canOutline())
 368                 enable = false;
 369
 370         moveUpTB->setEnabled(enable);
 371         moveDownTB->setEnabled(enable);
 372         moveInTB->setEnabled(enable);
 373         moveOutTB->setEnabled(enable);
 374 }
 375
 376
 377 void TocWidget::updateView()
 378 {
 379 // Enable if you dont want the delaying business, cf #7138.
 380 #ifndef DELAY_UPDATE_VIEW
 381         updateViewForce();
 382         return;
 383 #endif
 384         // already scheduled?
 385         if (update_delay_ == -1)
 386                 return;
 387         QTimer::singleShot(update_delay_, this, SLOT(updateViewForce()));
 388         // Subtler optimization for having the delay more UI invisible.
 389         // We trigger update immediately for sparse editation actions,
 390         // i.e. there was no editation/cursor movement in last 2 sec.
 391         // At worst there will be +1 redraw after 2s in a such "calm" mode.
 392         if (update_delay_ != 0)
 393                 updateViewForce();
 394         update_delay_ = -1;
 395 }
 396
 397 void TocWidget::updateViewForce()
 398 {
 399         update_delay_ = 2000;
 400         if (!gui_view_.documentBufferView()) {
 401                 tocTV->setModel(0);
 402                 depthSL->setMaximum(0);
 403                 depthSL->setValue(0);
 404                 setEnabled(false);
 405                 return;
 406         }
 407         setEnabled(true);
 408         bool const is_sortable = isSortable();
 409         sortCB->setEnabled(is_sortable);
 410         bool focus_ = tocTV->hasFocus();
 411         tocTV->setEnabled(false);
 412         tocTV->setUpdatesEnabled(false);
 413
 414         QAbstractItemModel * toc_model =
 415                         gui_view_.tocModels().model(current_type_);
 416         if (tocTV->model() != toc_model) {
 417                 tocTV->setModel(toc_model);
 418                 tocTV->setEditTriggers(QAbstractItemView::NoEditTriggers);
 419                 if (persistent_)
 420                         setTreeDepth(depth_);
 421         }
 422
 423         sortCB->blockSignals(true);
 424         sortCB->setChecked(is_sortable
 425                 && gui_view_.tocModels().isSorted(current_type_));
 426         sortCB->blockSignals(false);
 427
 428         bool const can_navigate_ = canNavigate();
 429         persistentCB->setEnabled(can_navigate_);
 430
 431         bool controls_enabled = toc_model && toc_model->rowCount() > 0
 432                 && !gui_view_.documentBufferView()->buffer().isReadonly();
 433         enableControls(controls_enabled);
 434
 435         depthSL->setMaximum(gui_view_.tocModels().depth(current_type_));
 436         depthSL->setValue(depth_);
 437         if (!persistent_ && can_navigate_)
 438                 setTreeDepth(depth_);
 439         if (can_navigate_) {
 440                 persistentCB->setChecked(persistent_);
 441                 select(gui_view_.tocModels().currentIndex(current_type_));
 442         }
 443         filterContents();
 444         tocTV->setEnabled(true);
 445         tocTV->setUpdatesEnabled(true);
 446         if (focus_)
 447                 tocTV->setFocus();
 448 }
 449
 450
 451 void TocWidget::filterContents()
 452 {
 453         if (!tocTV->model())
 454                 return;
 455
 456         QModelIndexList indices = tocTV->model()->match(
 457                 tocTV->model()->index(0, 0),
 458                 Qt::DisplayRole, "*", -1,
 459                 Qt::MatchFlags(Qt::MatchWildcard|Qt::MatchRecursive));
 460
 461         int size = indices.size();
 462         for (int i = 0; i < size; i++) {
 463                 QModelIndex index = indices[i];
 464                 bool const matches =
 465                         index.data().toString().contains(
 466                                 filterLE->text(), Qt::CaseInsensitive);
 467                 tocTV->setRowHidden(index.row(), index.parent(), !matches);
 468         }
 469         // recursively unhide parents of unhidden children
 470         for (int i = size - 1; i >= 0; i--) {
 471                 QModelIndex index = indices[i];
 472                 if (!tocTV->isRowHidden(index.row(), index.parent())
 473                     && index.parent() != QModelIndex())
 474                         tocTV->setRowHidden(index.parent().row(),
 475                                             index.parent().parent(), false);
 476         }
 477 }
 478
 479
 480 static QString decodeType(QString const & str)
 481 {
 482         QString type = str;
 483         if (type.contains("tableofcontents"))
 484                 type = "tableofcontents";
 485         else if (type.contains("lstlistoflistings"))
 486                 type = "listing";
 487         else if (type.contains("floatlist")) {
 488                 if (type.contains("\"figure"))
 489                         type = "figure";
 490                 else if (type.contains("\"table"))
 491                         type = "table";
 492                 else if (type.contains("\"algorithm"))
 493                         type = "algorithm";
 494         }
 495         return type;
 496 }
 497
 498
 499 void TocWidget::init(QString const & str)
 500 {
 501         int new_index;
 502         if (str.isEmpty())
 503                 new_index = typeCO->findData(current_type_);
 504         else
 505                 new_index = typeCO->findData(decodeType(str));
 506
 507         // If everything else fails, settle on the table of contents which is
 508         // guaranteed to exist.
 509         if (new_index == -1) {
 510                 current_type_ = "tableofcontents";
 511                 new_index = typeCO->findData(current_type_);
 512         } else {
 513                 current_type_ = typeCO->itemData(new_index).toString();
 514         }
 515
 516         typeCO->blockSignals(true);
 517         typeCO->setCurrentIndex(new_index);
 518         typeCO->blockSignals(false);
 519
 520         // no delay when the whole outliner is reseted.
 521         update_delay_ = 0;
 522 }
 523
 524 } // namespace frontend
 525 } // namespace lyx
 526
 527 #include "moc_TocWidget.cpp"