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