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 "Buffer.h"
  18 #include "BufferParams.h"
  19 #include "BufferView.h"
  20 #include "Cursor.h"
  21 #include "support/debug.h"
  22 #include "FuncRequest.h"
  23 #include "FuncStatus.h"
  24 #include "support/gettext.h"
  25 #include "IconPalette.h"
  26 #include "Layout.h"
  27 #include "LyXFunc.h"
  28 #include "Paragraph.h"
  29 #include "TextClass.h"
  30 #include "ToolbarBackend.h"
  31
  32 #include "GuiView.h"
  33 #include "GuiCommandBuffer.h"
  34 #include "GuiToolbar.h"
  35 #include "LyXAction.h"
  36 #include "Action.h"
  37 #include "qt_helpers.h"
  38 #include "InsertTableWidget.h"
  39 #include "LyXRC.h"
  40
  41 #include "support/filetools.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 via QComboBox::setItemData(). It may be that this can
 278         //even be done by passing: addItem(item, untransName).
 279         int const end = count();
 280         if (!sorted || end < 2 || item[0].category() != QChar::Letter_Uppercase) {
 281                 addItem(item);
 282                 return;
 283         }
 284
 285         // Let the default one be at the beginning
 286         int i = 1;
 287         for (setCurrentIndex(i); currentText().localeAwareCompare(item) < 0; ) {
 288                 // e.g. --Separator--
 289                 if (currentText()[0].category() != QChar::Letter_Uppercase)
 290                         break;
 291                 if (++i == end)
 292                         break;
 293                 setCurrentIndex(i);
 294         }
 295
 296         insertItem(i, item);
 297 }
 298
 299
 300 void GuiLayoutBox::updateContents(bool reset)
 301 {
 302         Buffer const * buffer = owner_.buffer();
 303         if (!buffer) {
 304                 clear();
 305                 setEnabled(false);
 306                 text_class_ = 0;
 307                 return;
 308         }
 309
 310         TextClass const * text_class = &buffer->params().getTextClass();
 311         if (!reset && text_class_ == text_class) {
 312                 set(owner_.view()->cursor().innerParagraph().layout()->name());
 313                 return;
 314         }
 315
 316         text_class_ = text_class;
 317
 318         clear();
 319         TextClass::const_iterator it = text_class_->begin();
 320         TextClass::const_iterator const end = text_class_->end();
 321         for (; it != end; ++it)
 322                 addItemSort(toqstr(translateIfPossible((*it)->name())), lyxrc.sort_layouts);
 323
 324         set(owner_.view()->cursor().innerParagraph().layout()->name());
 325
 326         // needed to recalculate size hint
 327         hide();
 328         setMinimumWidth(sizeHint().width());
 329
 330         setEnabled(!buffer->isReadonly());
 331         show();
 332 }
 333
 334
 335 void GuiLayoutBox::selected(const QString & str)
 336 {
 337         owner_.setFocus();
 338         updateContents(false);
 339         if (!text_class_)
 340                 return;
 341
 342         docstring const name = qstring_to_ucs4(str);
 343         TextClass::const_iterator it  = text_class_->begin();
 344         TextClass::const_iterator const end = text_class_->end();
 345         for (; it != end; ++it) {
 346                 docstring const & itname = (*it)->name();
 347                 //FIXME Comparing translated strings is not ideal.
 348                 //This should be done the way module names are handled
 349                 //in GuiDocument: viz, the untranslated name should be
 350                 //associated with the item via QComboBox::setItemData().
 351                 if (translateIfPossible(itname) == name) {
 352                         FuncRequest const func(LFUN_LAYOUT, itname,
 353                                                FuncRequest::TOOLBAR);
 354                         theLyXFunc().setLyXView(&owner_);
 355                         lyx::dispatch(func);
 356                         updateContents(false);
 357                         return;
 358                 }
 359         }
 360         lyxerr << "ERROR (layoutSelected): layout not found!" << endl;
 361 }
 362
 363
 364
 365 /////////////////////////////////////////////////////////////////////
 366 //
 367 // GuiToolbar
 368 //
 369 /////////////////////////////////////////////////////////////////////
 370
 371
 372 GuiToolbar::GuiToolbar(ToolbarInfo const & tbinfo, GuiView & owner)
 373         : QToolBar(qt_(tbinfo.gui_name), &owner), owner_(owner),
 374           layout_(0), command_buffer_(0)
 375 {
 376         // give visual separation between adjacent toolbars
 377         addSeparator();
 378
 379         // TODO: save toolbar position
 380         setMovable(true);
 381
 382         ToolbarInfo::item_iterator it = tbinfo.items.begin();
 383         ToolbarInfo::item_iterator end = tbinfo.items.end();
 384         for (; it != end; ++it)
 385                 add(*it);
 386 }
 387
 388
 389 Action * GuiToolbar::addItem(ToolbarItem const & item)
 390 {
 391         Action * act = new Action(owner_,
 392                 getIcon(item.func_, false),
 393           toqstr(item.label_), item.func_, toqstr(item.label_));
 394         actions_.append(act);
 395         return act;
 396 }
 397
 398 namespace {
 399
 400 class PaletteButton : public QToolButton
 401 {
 402 private:
 403         GuiToolbar * bar_;
 404         ToolbarItem const & tbitem_;
 405         bool initialized_;
 406 public:
 407         PaletteButton(GuiToolbar * bar, ToolbarItem const & item)
 408                 : QToolButton(bar), bar_(bar), tbitem_(item), initialized_(false)
 409         {
 410                 QString const label = qt_(to_ascii(tbitem_.label_));
 411                 setToolTip(label);
 412                 setStatusTip(label);
 413                 setText(label);
 414                 connect(bar_, SIGNAL(iconSizeChanged(QSize)),
 415                         this, SLOT(setIconSize(QSize)));
 416                 setCheckable(true);
 417                 ToolbarInfo const * tbinfo =
 418                         toolbarbackend.getDefinedToolbarInfo(tbitem_.name_);
 419                 if (tbinfo)
 420                         // use the icon of first action for the toolbar button
 421                         setIcon(getIcon(tbinfo->items.begin()->func_, true));
 422         }
 423
 424         void mousePressEvent(QMouseEvent * e)
 425         {
 426                 if (initialized_) {
 427                         QToolButton::mousePressEvent(e);
 428                         return;
 429                 }
 430
 431                 initialized_ = true;
 432
 433                 ToolbarInfo const * tbinfo =
 434                         toolbarbackend.getDefinedToolbarInfo(tbitem_.name_);
 435                 if (!tbinfo) {
 436                         lyxerr << "Unknown toolbar " << tbitem_.name_ << endl;
 437                         return;
 438                 }
 439                 IconPalette * panel = new IconPalette(this);
 440                 QString const label = qt_(to_ascii(tbitem_.label_));
 441                 panel->setWindowTitle(label);
 442                 connect(this, SIGNAL(clicked(bool)), panel, SLOT(setVisible(bool)));
 443                 connect(panel, SIGNAL(visible(bool)), this, SLOT(setChecked(bool)));
 444                 ToolbarInfo::item_iterator it = tbinfo->items.begin();
 445                 ToolbarInfo::item_iterator const end = tbinfo->items.end();
 446                 for (; it != end; ++it)
 447                         if (!getStatus(it->func_).unknown())
 448                                 panel->addButton(bar_->addItem(*it));
 449
 450                 QToolButton::mousePressEvent(e);
 451         }
 452 };
 453
 454 class MenuButton : public QToolButton
 455 {
 456 private:
 457         GuiToolbar * bar_;
 458         ToolbarItem const & tbitem_;
 459         bool initialized_;
 460 public:
 461         MenuButton(GuiToolbar * bar, ToolbarItem const & item)
 462                 : QToolButton(bar), bar_(bar), tbitem_(item), initialized_(false)
 463         {
 464                 setPopupMode(QToolButton::InstantPopup);
 465                 QString const label = qt_(to_ascii(tbitem_.label_));
 466                 setToolTip(label);
 467                 setStatusTip(label);
 468                 setText(label);
 469                 setIcon(QPixmap(":images/math/" + toqstr(tbitem_.name_) + ".png"));
 470                 connect(bar, SIGNAL(iconSizeChanged(QSize)),
 471                         this, SLOT(setIconSize(QSize)));
 472         }
 473
 474         void mousePressEvent(QMouseEvent * e)
 475         {
 476                 if (initialized_) {
 477                         QToolButton::mousePressEvent(e);
 478                         return;
 479                 }
 480
 481                 initialized_ = true;
 482
 483                 QString const label = qt_(to_ascii(tbitem_.label_));
 484                 ButtonMenu * m = new ButtonMenu(label, this);
 485                 m->setWindowTitle(label);
 486                 m->setTearOffEnabled(true);
 487                 connect(bar_, SIGNAL(updated()), m, SLOT(updateParent()));
 488                 ToolbarInfo const * tbinfo =
 489                         toolbarbackend.getDefinedToolbarInfo(tbitem_.name_);
 490                 if (!tbinfo) {
 491                         lyxerr << "Unknown toolbar " << tbitem_.name_ << endl;
 492                         return;
 493                 }
 494                 ToolbarInfo::item_iterator it = tbinfo->items.begin();
 495                 ToolbarInfo::item_iterator const end = tbinfo->items.end();
 496                 for (; it != end; ++it)
 497                         if (!getStatus(it->func_).unknown())
 498                                 m->add(bar_->addItem(*it));
 499                 setMenu(m);
 500
 501                 QToolButton::mousePressEvent(e);
 502         }
 503 };
 504
 505 }
 506
 507
 508 void GuiToolbar::add(ToolbarItem const & item)
 509 {
 510         switch (item.type_) {
 511         case ToolbarItem::SEPARATOR:
 512                 addSeparator();
 513                 break;
 514         case ToolbarItem::LAYOUTS:
 515                 layout_ = new GuiLayoutBox(owner_);
 516                 addWidget(layout_);
 517                 break;
 518         case ToolbarItem::MINIBUFFER:
 519                 command_buffer_ = new GuiCommandBuffer(&owner_);
 520                 addWidget(command_buffer_);
 521                 /// \todo find a Qt4 equivalent to setHorizontalStretchable(true);
 522                 //setHorizontalStretchable(true);
 523                 break;
 524         case ToolbarItem::TABLEINSERT: {
 525                 QToolButton * tb = new QToolButton;
 526                 tb->setCheckable(true);
 527                 tb->setIcon(getIcon(FuncRequest(LFUN_TABULAR_INSERT), true));
 528                 QString const label = qt_(to_ascii(item.label_));
 529                 tb->setToolTip(label);
 530                 tb->setStatusTip(label);
 531                 tb->setText(label);
 532                 InsertTableWidget * iv = new InsertTableWidget(owner_, tb);
 533                 connect(tb, SIGNAL(clicked(bool)), iv, SLOT(show(bool)));
 534                 connect(iv, SIGNAL(visible(bool)), tb, SLOT(setChecked(bool)));
 535                 connect(this, SIGNAL(updated()), iv, SLOT(updateParent()));
 536                 addWidget(tb);
 537                 break;
 538                 }
 539         case ToolbarItem::ICONPALETTE:
 540                 addWidget(new PaletteButton(this, item));
 541                 break;
 542
 543         case ToolbarItem::POPUPMENU: {
 544                 addWidget(new MenuButton(this, item));
 545                 break;
 546                 }
 547         case ToolbarItem::COMMAND: {
 548                 if (!getStatus(item.func_).unknown())
 549                         addAction(addItem(item));
 550                 break;
 551                 }
 552         default:
 553                 break;
 554         }
 555 }
 556
 557
 558 void GuiToolbar::saveInfo(ToolbarSection::ToolbarInfo & tbinfo)
 559 {
 560         // if tbinfo.state == auto *do not* set on/off
 561         if (tbinfo.state != ToolbarSection::ToolbarInfo::AUTO) {
 562                 if (GuiToolbar::isVisible())
 563                         tbinfo.state = ToolbarSection::ToolbarInfo::ON;
 564                 else
 565                         tbinfo.state = ToolbarSection::ToolbarInfo::OFF;
 566         }
 567         //
 568         // no need to save it here.
 569         Qt::ToolBarArea loc = owner_.toolBarArea(this);
 570
 571         if (loc == Qt::TopToolBarArea)
 572                 tbinfo.location = ToolbarSection::ToolbarInfo::TOP;
 573         else if (loc == Qt::BottomToolBarArea)
 574                 tbinfo.location = ToolbarSection::ToolbarInfo::BOTTOM;
 575         else if (loc == Qt::RightToolBarArea)
 576                 tbinfo.location = ToolbarSection::ToolbarInfo::RIGHT;
 577         else if (loc == Qt::LeftToolBarArea)
 578                 tbinfo.location = ToolbarSection::ToolbarInfo::LEFT;
 579         else
 580                 tbinfo.location = ToolbarSection::ToolbarInfo::NOTSET;
 581
 582         // save toolbar position. They are not used to restore toolbar position
 583         // now because move(x,y) does not work for toolbar.
 584         tbinfo.posx = pos().x();
 585         tbinfo.posy = pos().y();
 586 }
 587
 588
 589 void GuiToolbar::updateContents()
 590 {
 591         // update visible toolbars only
 592         if (!isVisible())
 593                 return;
 594         // This is a speed bottleneck because this is called on every keypress
 595         // and update calls getStatus, which copies the cursor at least two times
 596         for (int i = 0; i < actions_.size(); ++i)
 597                 actions_[i]->update();
 598
 599         if (layout_)
 600                 layout_->setEnabled(lyx::getStatus(FuncRequest(LFUN_LAYOUT)).enabled());
 601
 602         // emit signal
 603         updated();
 604 }
 605
 606
 607 } // namespace frontend
 608 } // namespace lyx
 609
 610 #include "GuiToolbar_moc.cpp"