src/frontends/qt4/GuiToolbar.cpp

   1 /**
   2  * \file qt4/GuiToolbar.cpp
   3  * This file is part of LyX, the document processor.
   4  * Licence details can be found in the file COPYING.
   5  *
   6  * \author Lars Gullik Bjønnes
   7  * \author John Levon
   8  * \author Jean-Marc Lasgouttes
   9  * \author Angus Leeming
  10  * \author Abdelrazak Younes
  11  *
  12  * Full author contact details are available in file CREDITS.
  13  */
  14
  15 #include <config.h>
  16
  17 #include "GuiView.h"
  18 #include "GuiCommandBuffer.h"
  19 #include "GuiToolbar.h"
  20 #include "LyXAction.h"
  21 #include "Action.h"
  22 #include "qt_helpers.h"
  23 #include "InsertTableWidget.h"
  24
  25 #include "Buffer.h"
  26 #include "BufferParams.h"
  27 #include "BufferView.h"
  28 #include "Cursor.h"
  29 #include "FuncRequest.h"
  30 #include "FuncStatus.h"
  31 #include "IconPalette.h"
  32 #include "Layout.h"
  33 #include "LyXFunc.h"
  34 #include "LyXRC.h"
  35 #include "Paragraph.h"
  36 #include "TextClass.h"
  37 #include "ToolbarBackend.h"
  38
  39 #include "support/debug.h"
  40 #include "support/filetools.h"
  41 #include "support/gettext.h"
  42 #include "support/lstrings.h"
  43 #include "support/lyxalgo.h" // sorted
  44
  45 #include <QComboBox>
  46 #include <QToolBar>
  47 #include <QToolButton>
  48 #include <QAction>
  49 #include <QPixmap>
  50
  51 #include <boost/assert.hpp>
  52
  53 using namespace std;
  54 using namespace lyx::support;
  55
  56 static void initializeResources()
  57 {
  58         static bool initialized = false;
  59         if (!initialized) {
  60                 Q_INIT_RESOURCE(Resources);
  61                 initialized = true;
  62         }
  63 }
  64
  65
  66 namespace lyx {
  67 namespace frontend {
  68
  69 namespace {
  70
  71 struct PngMap {
  72         char const * key;
  73         char const * value;
  74 };
  75
  76
  77 bool operator<(PngMap const & lhs, PngMap const & rhs)
  78 {
  79                 return strcmp(lhs.key, rhs.key) < 0;
  80 }
  81
  82
  83 class CompareKey {
  84 public:
  85         CompareKey(string const & name) : name_(name) {}
  86         bool operator()(PngMap const & other) const { return other.key == name_; }
  87 private:
  88         string const name_;
  89 };
  90
  91
  92 PngMap sorted_png_map[] = {
  93         { "Bumpeq", "bumpeq2" },
  94         { "Cap", "cap2" },
  95         { "Cup", "cup2" },
  96         { "Delta", "delta2" },
  97         { "Downarrow", "downarrow2" },
  98         { "Gamma", "gamma2" },
  99         { "Lambda", "lambda2" },
 100         { "Leftarrow", "leftarrow2" },
 101         { "Leftrightarrow", "leftrightarrow2" },
 102         { "Longleftarrow", "longleftarrow2" },
 103         { "Longleftrightarrow", "longleftrightarrow2" },
 104         { "Longrightarrow", "longrightarrow2" },
 105         { "Omega", "omega2" },
 106         { "Phi", "phi2" },
 107         { "Pi", "pi2" },
 108         { "Psi", "psi2" },
 109         { "Rightarrow", "rightarrow2" },
 110         { "Sigma", "sigma2" },
 111         { "Subset", "subset2" },
 112         { "Supset", "supset2" },
 113         { "Theta", "theta2" },
 114         { "Uparrow", "uparrow2" },
 115         { "Updownarrow", "updownarrow2" },
 116         { "Upsilon", "upsilon2" },
 117         { "Vdash", "vdash3" },
 118         { "Xi", "xi2" },
 119         { "nLeftarrow", "nleftarrow2" },
 120         { "nLeftrightarrow", "nleftrightarrow2" },
 121         { "nRightarrow", "nrightarrow2" },
 122         { "nVDash", "nvdash3" },
 123         { "nvDash", "nvdash2" },
 124         { "textrm \\AA", "textrm_AA"},
 125         { "textrm \\O", "textrm_O"},
 126         { "vDash", "vdash2" }
 127 };
 128
 129 size_t const nr_sorted_png_map = sizeof(sorted_png_map) / sizeof(PngMap);
 130
 131
 132 string const find_png(string const & name)
 133 {
 134         PngMap const * const begin = sorted_png_map;
 135         PngMap const * const end = begin + nr_sorted_png_map;
 136         BOOST_ASSERT(sorted(begin, end));
 137
 138         PngMap const * const it = find_if(begin, end, CompareKey(name));
 139
 140         string png_name;
 141         if (it != end)
 142                 png_name = it->value;
 143         else {
 144                 png_name = subst(name, "_", "underscore");
 145                 png_name = subst(png_name, ' ', '_');
 146
 147                 // This way we can have "math-delim { }" on the toolbar.
 148                 png_name = subst(png_name, "(", "lparen");
 149                 png_name = subst(png_name, ")", "rparen");
 150                 png_name = subst(png_name, "[", "lbracket");
 151                 png_name = subst(png_name, "]", "rbracket");
 152                 png_name = subst(png_name, "{", "lbrace");
 153                 png_name = subst(png_name, "}", "rbrace");
 154                 png_name = subst(png_name, "|", "bars");
 155                 png_name = subst(png_name, ",", "thinspace");
 156                 png_name = subst(png_name, ":", "mediumspace");
 157                 png_name = subst(png_name, ";", "thickspace");
 158                 png_name = subst(png_name, "!", "negthinspace");
 159         }
 160
 161         LYXERR(Debug::GUI, "find_png(" << name << ")\n"
 162                 << "Looking for math PNG called \"" << png_name << '"');
 163         return png_name;
 164 }
 165
 166 } // namespace anon
 167
 168
 169 /// return a icon for the given action
 170 static QIcon getIcon(FuncRequest const & f, bool unknown)
 171 {
 172         initializeResources();
 173         QPixmap pm;
 174         string name1;
 175         string name2;
 176         string path;
 177         string fullname;
 178
 179         switch (f.action) {
 180         case LFUN_MATH_INSERT:
 181                 if (!f.argument().empty()) {
 182                         path = "math/";
 183                         name1 = find_png(to_utf8(f.argument()).substr(1));
 184                 }
 185                 break;
 186         case LFUN_MATH_DELIM:
 187         case LFUN_MATH_BIGDELIM:
 188                 path = "math/";
 189                 name1 = find_png(to_utf8(f.argument()));
 190                 break;
 191         case LFUN_CALL:
 192                 path = "commands/";
 193                 name1 = to_utf8(f.argument());
 194                 break;
 195         default:
 196                 name2 = lyxaction.getActionName(f.action);
 197                 name1 = name2;
 198
 199                 if (!f.argument().empty())
 200                         name1 = subst(name2 + ' ' + to_utf8(f.argument()), ' ', '_');
 201         }
 202
 203         fullname = libFileSearch("images/" + path, name1, "png").absFilename();
 204         if (pm.load(toqstr(fullname)))
 205                 return pm;
 206
 207         fullname = libFileSearch("images/" + path, name2, "png").absFilename();
 208         if (pm.load(toqstr(fullname)))
 209                 return pm;
 210
 211         if (pm.load(":/images/" + toqstr(path + name1) + ".png"))
 212                 return pm;
 213
 214         if (pm.load(":/images/" + toqstr(path + name2) + ".png"))
 215                 return pm;
 216
 217         LYXERR(Debug::GUI, "Cannot find icon for command \""
 218                            << lyxaction.getActionName(f.action)
 219                            << '(' << to_utf8(f.argument()) << ")\"");
 220         if (unknown)
 221                 pm.load(":/images/unknown.png");
 222
 223         return pm;
 224 }
 225
 226
 227 /////////////////////////////////////////////////////////////////////
 228 //
 229 // GuiLayoutBox
 230 //
 231 /////////////////////////////////////////////////////////////////////
 232
 233 GuiLayoutBox::GuiLayoutBox(GuiView & owner)
 234         : owner_(owner)
 235 {
 236         setSizeAdjustPolicy(QComboBox::AdjustToContents);
 237         setFocusPolicy(Qt::ClickFocus);
 238         setMinimumWidth(sizeHint().width());
 239         setMaxVisibleItems(100);
 240
 241         QObject::connect(this, SIGNAL(activated(QString)),
 242                          this, SLOT(selected(QString)));
 243         owner_.setLayoutDialog(this);
 244         updateContents(true);
 245 }
 246
 247
 248 void GuiLayoutBox::set(docstring const & layout)
 249 {
 250         if (!text_class_)
 251                 return;
 252
 253         QString const & name = toqstr(translateIfPossible(
 254                 (*text_class_)[layout]->name()));
 255
 256         if (name == currentText())
 257                 return;
 258
 259         int i = findText(name);
 260         if (i == -1) {
 261                 lyxerr << "Trying to select non existent layout type "
 262                         << fromqstr(name) << endl;
 263                 return;
 264         }
 265
 266         setCurrentIndex(i);
 267 }
 268
 269
 270 void GuiLayoutBox::addItemSort(QString const & item, bool sorted)
 271 {
 272         //FIXME
 273         //Since we are only storing the text used for display, we have no choice
 274         //below but to compare translated strings to figure out which layout the
 275         //user wants. This is not ideal. A better way is the way module names are
 276         //handled in GuiDocument: viz, the untranslated name can be associated
 277         //with the item by using GuiIdListModel.
 278         int const end = count();
 279         if (!sorted || end < 2 || item[0].category() != QChar::Letter_Uppercase) {
 280                 addItem(item);
 281                 return;
 282         }
 283
 284         // Let the default one be at the beginning
 285         int i = 1;
 286         for (setCurrentIndex(i); currentText().localeAwareCompare(item) < 0; ) {
 287                 // e.g. --Separator--
 288                 if (currentText()[0].category() != QChar::Letter_Uppercase)
 289                         break;
 290                 if (++i == end)
 291                         break;
 292                 setCurrentIndex(i);
 293         }
 294
 295         insertItem(i, item);
 296 }
 297
 298
 299 void GuiLayoutBox::updateContents(bool reset)
 300 {
 301         Buffer const * buffer = owner_.buffer();
 302         if (!buffer) {
 303                 clear();
 304                 setEnabled(false);
 305                 text_class_ = 0;
 306                 inset_ = 0;
 307                 return;
 308         }
 309
 310         TextClass const * text_class = &buffer->params().textClass();
 311         Inset const * inset =
 312                 owner_.view()->cursor().innerParagraph().inInset();
 313
 314         // we'll only update the layout list if the text class has changed
 315         // or we've moved from one inset to another
 316         if (!reset && text_class_ == text_class && inset_ == inset) {
 317                 set(owner_.view()->cursor().innerParagraph().layout()->name());
 318                 return;
 319         }
 320
 321         inset_ = inset;
 322         text_class_ = text_class;
 323
 324         clear();
 325
 326         for (size_t i = 0; i != text_class_->layoutCount(); ++i) {
 327                 Layout const & lt = *text_class_->layout(i);
 328                 docstring const & name = lt.name();
 329                 // if this inset requires the empty layout, we skip the default
 330                 // layout
 331                 if (name == text_class_->defaultLayoutName() && inset &&
 332                     (inset->forceEmptyLayout() || inset->useEmptyLayout()))
 333                         continue;
 334                 // if it doesn't require the empty layout, we skip it
 335                 if (name == text_class_->emptyLayoutName() && inset &&
 336                     !inset->forceEmptyLayout() && !inset->useEmptyLayout())
 337                         continue;
 338                 addItemSort(toqstr(translateIfPossible(name)), lyxrc.sort_layouts);
 339         }
 340
 341         set(owner_.view()->cursor().innerParagraph().layout()->name());
 342
 343         // needed to recalculate size hint
 344         hide();
 345         setMinimumWidth(sizeHint().width());
 346
 347         setEnabled(!buffer->isReadonly());
 348         show();
 349 }
 350
 351
 352 void GuiLayoutBox::selected(const QString & str)
 353 {
 354         owner_.setFocus();
 355         updateContents(false);
 356         if (!text_class_)
 357                 return;
 358
 359         docstring const name = qstring_to_ucs4(str);
 360         for (size_t i = 0; i != text_class_->layoutCount(); ++i) {
 361                 docstring const & itname = text_class_->layout(i)->name();
 362                 // FIXME: Comparing translated strings is not ideal.
 363                 // This should be done the way module names are handled
 364                 // in GuiDocument: viz, the untranslated name should be
 365                 // associated with the item via QComboBox::setItemData().
 366                 if (translateIfPossible(itname) == name) {
 367                         FuncRequest const func(LFUN_LAYOUT, itname,
 368                                                FuncRequest::TOOLBAR);
 369                         theLyXFunc().setLyXView(&owner_);
 370                         lyx::dispatch(func);
 371                         updateContents(false);
 372                         return;
 373                 }
 374         }
 375         lyxerr << "ERROR (layoutSelected): layout not found!" << endl;
 376 }
 377
 378
 379
 380 /////////////////////////////////////////////////////////////////////
 381 //
 382 // GuiToolbar
 383 //
 384 /////////////////////////////////////////////////////////////////////
 385
 386
 387 GuiToolbar::GuiToolbar(ToolbarInfo const & tbinfo, GuiView & owner)
 388         : QToolBar(qt_(tbinfo.gui_name), &owner), owner_(owner),
 389           layout_(0), command_buffer_(0)
 390 {
 391         // give visual separation between adjacent toolbars
 392         addSeparator();
 393
 394         // TODO: save toolbar position
 395         setMovable(true);
 396
 397         ToolbarInfo::item_iterator it = tbinfo.items.begin();
 398         ToolbarInfo::item_iterator end = tbinfo.items.end();
 399         for (; it != end; ++it)
 400                 add(*it);
 401 }
 402
 403
 404 Action * GuiToolbar::addItem(ToolbarItem const & item)
 405 {
 406         Action * act = new Action(owner_,
 407                 getIcon(item.func_, false),
 408           toqstr(item.label_), item.func_, toqstr(item.label_));
 409         actions_.append(act);
 410         return act;
 411 }
 412
 413 namespace {
 414
 415 class PaletteButton : public QToolButton
 416 {
 417 private:
 418         GuiToolbar * bar_;
 419         ToolbarItem const & tbitem_;
 420         bool initialized_;
 421 public:
 422         PaletteButton(GuiToolbar * bar, ToolbarItem const & item)
 423                 : QToolButton(bar), bar_(bar), tbitem_(item), initialized_(false)
 424         {
 425                 QString const label = qt_(to_ascii(tbitem_.label_));
 426                 setToolTip(label);
 427                 setStatusTip(label);
 428                 setText(label);
 429                 connect(bar_, SIGNAL(iconSizeChanged(QSize)),
 430                         this, SLOT(setIconSize(QSize)));
 431                 setCheckable(true);
 432                 ToolbarInfo const * tbinfo =
 433                         toolbarbackend.getDefinedToolbarInfo(tbitem_.name_);
 434                 if (tbinfo)
 435                         // use the icon of first action for the toolbar button
 436                         setIcon(getIcon(tbinfo->items.begin()->func_, true));
 437         }
 438
 439         void mousePressEvent(QMouseEvent * e)
 440         {
 441                 if (initialized_) {
 442                         QToolButton::mousePressEvent(e);
 443                         return;
 444                 }
 445
 446                 initialized_ = true;
 447
 448                 ToolbarInfo const * tbinfo =
 449                         toolbarbackend.getDefinedToolbarInfo(tbitem_.name_);
 450                 if (!tbinfo) {
 451                         lyxerr << "Unknown toolbar " << tbitem_.name_ << endl;
 452                         return;
 453                 }
 454                 IconPalette * panel = new IconPalette(this);
 455                 QString const label = qt_(to_ascii(tbitem_.label_));
 456                 panel->setWindowTitle(label);
 457                 connect(this, SIGNAL(clicked(bool)), panel, SLOT(setVisible(bool)));
 458                 connect(panel, SIGNAL(visible(bool)), this, SLOT(setChecked(bool)));
 459                 ToolbarInfo::item_iterator it = tbinfo->items.begin();
 460                 ToolbarInfo::item_iterator const end = tbinfo->items.end();
 461                 for (; it != end; ++it)
 462                         if (!getStatus(it->func_).unknown())
 463                                 panel->addButton(bar_->addItem(*it));
 464
 465                 QToolButton::mousePressEvent(e);
 466         }
 467 };
 468
 469 class MenuButton : public QToolButton
 470 {
 471 private:
 472         GuiToolbar * bar_;
 473         ToolbarItem const & tbitem_;
 474         bool initialized_;
 475 public:
 476         MenuButton(GuiToolbar * bar, ToolbarItem const & item)
 477                 : QToolButton(bar), bar_(bar), tbitem_(item), initialized_(false)
 478         {
 479                 setPopupMode(QToolButton::InstantPopup);
 480                 QString const label = qt_(to_ascii(tbitem_.label_));
 481                 setToolTip(label);
 482                 setStatusTip(label);
 483                 setText(label);
 484                 setIcon(QPixmap(":images/math/" + toqstr(tbitem_.name_) + ".png"));
 485                 connect(bar, SIGNAL(iconSizeChanged(QSize)),
 486                         this, SLOT(setIconSize(QSize)));
 487         }
 488
 489         void mousePressEvent(QMouseEvent * e)
 490         {
 491                 if (initialized_) {
 492                         QToolButton::mousePressEvent(e);
 493                         return;
 494                 }
 495
 496                 initialized_ = true;
 497
 498                 QString const label = qt_(to_ascii(tbitem_.label_));
 499                 ButtonMenu * m = new ButtonMenu(label, this);
 500                 m->setWindowTitle(label);
 501                 m->setTearOffEnabled(true);
 502                 connect(bar_, SIGNAL(updated()), m, SLOT(updateParent()));
 503                 ToolbarInfo const * tbinfo =
 504                         toolbarbackend.getDefinedToolbarInfo(tbitem_.name_);
 505                 if (!tbinfo) {
 506                         lyxerr << "Unknown toolbar " << tbitem_.name_ << endl;
 507                         return;
 508                 }
 509                 ToolbarInfo::item_iterator it = tbinfo->items.begin();
 510                 ToolbarInfo::item_iterator const end = tbinfo->items.end();
 511                 for (; it != end; ++it)
 512                         if (!getStatus(it->func_).unknown())
 513                                 m->add(bar_->addItem(*it));
 514                 setMenu(m);
 515
 516                 QToolButton::mousePressEvent(e);
 517         }
 518 };
 519
 520 }
 521
 522
 523 void GuiToolbar::add(ToolbarItem const & item)
 524 {
 525         switch (item.type_) {
 526         case ToolbarItem::SEPARATOR:
 527                 addSeparator();
 528                 break;
 529         case ToolbarItem::LAYOUTS:
 530                 layout_ = new GuiLayoutBox(owner_);
 531                 addWidget(layout_);
 532                 break;
 533         case ToolbarItem::MINIBUFFER:
 534                 command_buffer_ = new GuiCommandBuffer(&owner_);
 535                 addWidget(command_buffer_);
 536                 /// \todo find a Qt4 equivalent to setHorizontalStretchable(true);
 537                 //setHorizontalStretchable(true);
 538                 break;
 539         case ToolbarItem::TABLEINSERT: {
 540                 QToolButton * tb = new QToolButton;
 541                 tb->setCheckable(true);
 542                 tb->setIcon(getIcon(FuncRequest(LFUN_TABULAR_INSERT), true));
 543                 QString const label = qt_(to_ascii(item.label_));
 544                 tb->setToolTip(label);
 545                 tb->setStatusTip(label);
 546                 tb->setText(label);
 547                 InsertTableWidget * iv = new InsertTableWidget(owner_, tb);
 548                 connect(tb, SIGNAL(clicked(bool)), iv, SLOT(show(bool)));
 549                 connect(iv, SIGNAL(visible(bool)), tb, SLOT(setChecked(bool)));
 550                 connect(this, SIGNAL(updated()), iv, SLOT(updateParent()));
 551                 addWidget(tb);
 552                 break;
 553                 }
 554         case ToolbarItem::ICONPALETTE:
 555                 addWidget(new PaletteButton(this, item));
 556                 break;
 557
 558         case ToolbarItem::POPUPMENU: {
 559                 addWidget(new MenuButton(this, item));
 560                 break;
 561                 }
 562         case ToolbarItem::COMMAND: {
 563                 if (!getStatus(item.func_).unknown())
 564                         addAction(addItem(item));
 565                 break;
 566                 }
 567         default:
 568                 break;
 569         }
 570 }
 571
 572
 573 void GuiToolbar::saveInfo(ToolbarSection::ToolbarInfo & tbinfo)
 574 {
 575         // if tbinfo.state == auto *do not* set on/off
 576         if (tbinfo.state != ToolbarSection::ToolbarInfo::AUTO) {
 577                 if (GuiToolbar::isVisible())
 578                         tbinfo.state = ToolbarSection::ToolbarInfo::ON;
 579                 else
 580                         tbinfo.state = ToolbarSection::ToolbarInfo::OFF;
 581         }
 582         //
 583         // no need to save it here.
 584         Qt::ToolBarArea loc = owner_.toolBarArea(this);
 585
 586         if (loc == Qt::TopToolBarArea)
 587                 tbinfo.location = ToolbarSection::ToolbarInfo::TOP;
 588         else if (loc == Qt::BottomToolBarArea)
 589                 tbinfo.location = ToolbarSection::ToolbarInfo::BOTTOM;
 590         else if (loc == Qt::RightToolBarArea)
 591                 tbinfo.location = ToolbarSection::ToolbarInfo::RIGHT;
 592         else if (loc == Qt::LeftToolBarArea)
 593                 tbinfo.location = ToolbarSection::ToolbarInfo::LEFT;
 594         else
 595                 tbinfo.location = ToolbarSection::ToolbarInfo::NOTSET;
 596
 597         // save toolbar position. They are not used to restore toolbar position
 598         // now because move(x,y) does not work for toolbar.
 599         tbinfo.posx = pos().x();
 600         tbinfo.posy = pos().y();
 601 }
 602
 603
 604 void GuiToolbar::updateContents()
 605 {
 606         // update visible toolbars only
 607         if (!isVisible())
 608                 return;
 609         // This is a speed bottleneck because this is called on every keypress
 610         // and update calls getStatus, which copies the cursor at least two times
 611         for (int i = 0; i < actions_.size(); ++i)
 612                 actions_[i]->update();
 613
 614         if (layout_)
 615                 layout_->setEnabled(lyx::getStatus(FuncRequest(LFUN_LAYOUT)).enabled());
 616
 617         // emit signal
 618         updated();
 619 }
 620
 621
 622 } // namespace frontend
 623 } // namespace lyx
 624
 625 #include "GuiToolbar_moc.cpp"