]> git.lyx.org Git - lyx.git/blob - src/frontends/qt4/Menus.cpp
Move Tocs to the "Other lists" submenu based on a blacklist
[lyx.git] / src / frontends / qt4 / Menus.cpp
1 /**
2  * \file qt4/Menus.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 Asger Alstrup
8  * \author Lars Gullik Bjønnes
9  * \author Jean-Marc Lasgouttes
10  * \author André Pönitz
11  * \author Dekel Tsur
12  * \author Martin Vermeer
13  *
14  * Full author contact details are available in file CREDITS.
15  */
16
17 #include <config.h>
18
19 #include "Menus.h"
20
21 #include "Action.h"
22 #include "GuiApplication.h"
23 #include "GuiView.h"
24 #include "GuiWorkArea.h"
25 #include "qt_helpers.h"
26
27 #include "BiblioInfo.h"
28 #include "BranchList.h"
29 #include "Buffer.h"
30 #include "BufferList.h"
31 #include "BufferParams.h"
32 #include "BufferView.h"
33 #include "Converter.h"
34 #include "CutAndPaste.h"
35 #include "Floating.h"
36 #include "FloatList.h"
37 #include "Format.h"
38 #include "FuncRequest.h"
39 #include "FuncStatus.h"
40 #include "IndicesList.h"
41 #include "KeyMap.h"
42 #include "Language.h"
43 #include "Layout.h"
44 #include "Lexer.h"
45 #include "LyXAction.h"
46 #include "LyX.h"
47 #include "LyXRC.h"
48 #include "lyxfind.h"
49 #include "Paragraph.h"
50 #include "ParagraphParameters.h"
51 #include "ParIterator.h"
52 #include "Session.h"
53 #include "SpellChecker.h"
54 #include "TextClass.h"
55 #include "Text.h"
56 #include "TocBackend.h"
57 #include "Toolbars.h"
58 #include "WordLangTuple.h"
59
60 #include "insets/Inset.h"
61 #include "insets/InsetCitation.h"
62 #include "insets/InsetGraphics.h"
63 #include "insets/InsetQuotes.h"
64
65 #include "support/lassert.h"
66 #include "support/convert.h"
67 #include "support/debug.h"
68 #include "support/docstring_list.h"
69 #include "support/filetools.h"
70 #include "support/gettext.h"
71 #include "support/lstrings.h"
72
73 #include <QCursor>
74 #include <QHash>
75 #include <QList>
76 #include <QMenuBar>
77 #include <QString>
78 #if QT_VERSION >= 0x040600
79 #include <QProxyStyle>
80 #endif
81
82 #include <algorithm>
83 #include <memory>
84 #include <vector>
85
86 using namespace std;
87 using namespace lyx::support;
88
89
90 namespace lyx {
91 namespace frontend {
92
93 namespace {
94
95 // MacOSX specific stuff is at the end.
96
97 class MenuDefinition;
98
99 ///
100 class MenuItem {
101 public:
102         /// The type of elements that can be in a menu
103         enum Kind {
104                 ///
105                 Command,
106                 ///
107                 Submenu,
108                 ///
109                 Separator,
110                 /** This type of item explains why something is unavailable. If this
111                     menuitem is in a submenu, the submenu is enabled to make sure the
112                     user sees the information. */
113                 Help,
114                 /** This type of item merely shows that there might be a list or
115                     something alike at this position, but the list is still empty.
116                     If this item is in a submenu, the submenu will not always be
117                     enabled. */
118                 Info,
119                 /** This is the list of last opened file,
120                     typically for the File menu. */
121                 Lastfiles,
122                 /** This is the list of opened Documents,
123                     typically for the Documents menu. */
124                 Documents,
125                 /** This is the bookmarks */
126                 Bookmarks,
127                 ///
128                 Toc,
129                 /** This is a list of viewable formats
130                     typically for the File->View menu. */
131                 ViewFormats,
132                 /** This is a list of updatable formats
133                     typically for the File->Update menu. */
134                 UpdateFormats,
135                 /** This is a list of exportable formats
136                     typically for the File->Export menu. */
137                 ExportFormats,
138                 /** This is a list of importable formats
139                     typically for the File->Import menu. */
140                 ImportFormats,
141                 /** This is the list of elements available
142                  * for insertion into document. */
143                 CharStyles,
144                 /** This is the list of user-configurable
145                 insets to insert into document */
146                 Custom,
147                 /** This is the list of XML elements to
148                 insert into the document */
149                 Elements,
150                 /** This is the list of floats that we can
151                     insert a list for. */
152                 FloatListInsert,
153                 /** This is the list of floats that we can
154                     insert. */
155                 FloatInsert,
156                 /** This is the list of selections that can
157                     be pasted. */
158                 PasteRecent,
159                 /** toolbars */
160                 Toolbars,
161                 /** Available branches in document */
162                 Branches,
163                 /** Available indices in document */
164                 Indices,
165                 /** Context menu for indices in document */
166                 IndicesContext,
167                 /** Available index lists in document */
168                 IndicesLists,
169                 /** Context menu for available indices lists in document */
170                 IndicesListsContext,
171                 /** Available citation styles for a given citation */
172                 CiteStyles,
173                 /** Available graphics groups */
174                 GraphicsGroups,
175                 /// Words suggested by the spellchecker.
176                 SpellingSuggestions,
177                 /** Used Languages */
178                 LanguageSelector,
179                 /** This is the list of arguments available
180                     for insertion into the current layout. */
181                 Arguments,
182                 /** This is the list of arguments available
183                     in the InsetArgument context menu. */
184                 SwitchArguments,
185                 /** This is the list of captions available
186                 in the current layout. */
187                 Captions,
188                 /** This is the list of captions available
189                 in the InsetCaption context menu. */
190                 SwitchCaptions,
191                 /** Commands to separate environments. */
192                 EnvironmentSeparators,
193                 /** This is the list of quotation marks available */
194                 SwitchQuotes
195         };
196
197         explicit MenuItem(Kind kind) : kind_(kind), optional_(false) {}
198
199         MenuItem(Kind kind,
200                  QString const & label,
201                  QString const & submenu = QString(),
202                  QString const & tooltip = QString(),
203                  bool optional = false)
204                 : kind_(kind), label_(label), func_(make_shared<FuncRequest>()),
205                   submenuname_(submenu), tooltip_(tooltip), optional_(optional)
206         {
207                 LATTEST(kind == Submenu || kind == Help || kind == Info);
208         }
209
210         MenuItem(Kind kind,
211                  QString const & label,
212                  FuncRequest const & func,
213                  QString const & tooltip = QString(),
214                  bool optional = false,
215                  FuncRequest::Origin origin = FuncRequest::MENU)
216                 : kind_(kind), label_(label), func_(make_shared<FuncRequest>(func)),
217                   tooltip_(tooltip), optional_(optional)
218         {
219                 func_->setOrigin(origin);
220         }
221
222         /// The label of a given menuitem
223         QString label() const
224         {
225                 int const index = label_.lastIndexOf('|');
226                 return index == -1 ? label_ : label_.left(index);
227         }
228
229         /// The keyboard shortcut (usually underlined in the entry)
230         QString shortcut() const
231         {
232                 int const index = label_.lastIndexOf('|');
233                 return index == -1 ? QString() : label_.mid(index + 1);
234         }
235         /// The complete label, with label and shortcut separated by a '|'
236         QString fulllabel() const { return label_; }
237         /// The kind of entry
238         Kind kind() const { return kind_; }
239         /// the action (if relevant)
240         shared_ptr<FuncRequest const> func() const { return func_; }
241         /// the tooltip
242         QString const & tooltip() const { return tooltip_; }
243         /// returns true if the entry should be omitted when disabled
244         bool optional() const { return optional_; }
245         /// returns the status of the lfun associated with this entry
246         FuncStatus const & status() const { return status_; }
247         /// returns the status of the lfun associated with this entry
248         FuncStatus & status() { return status_; }
249         /// returns the status of the lfun associated with this entry
250         void status(FuncStatus const & status) { status_ = status; }
251
252         ///returns the binding associated to this action.
253         QString binding() const
254         {
255                 if (kind_ != Command)
256                         return QString();
257                 // Get the keys bound to this action, but keep only the
258                 // first one later
259                 KeyMap::Bindings bindings = theTopLevelKeymap().findBindings(*func_);
260                 if (!bindings.empty())
261                         return toqstr(bindings.begin()->print(KeySequence::ForGui));
262
263                 LYXERR(Debug::KBMAP, "No binding for "
264                         << lyxaction.getActionName(func_->action())
265                         << '(' << func_->argument() << ')');
266                 return QString();
267         }
268
269         /// the description of the  submenu (if relevant)
270         QString const & submenuname() const { return submenuname_; }
271         /// set the description of the  submenu
272         void submenuname(QString const & name) { submenuname_ = name; }
273         ///
274         bool hasSubmenu() const { return !submenu_.isEmpty(); }
275         ///
276         MenuDefinition const & submenu() const { return submenu_.at(0); }
277         MenuDefinition & submenu() { return submenu_[0]; }
278         ///
279         void setSubmenu(MenuDefinition const & menu)
280         {
281                 submenu_.clear();
282                 submenu_.append(menu);
283         }
284
285 private:
286         ///
287         Kind kind_;
288         ///
289         QString label_;
290         ///
291         shared_ptr<FuncRequest> func_;// non-null
292         ///
293         QString submenuname_;
294         ///
295         QString tooltip_;
296         ///
297         bool optional_;
298         ///
299         FuncStatus status_;
300         /// contains 0 or 1 item.
301         QList<MenuDefinition> submenu_;
302 };
303
304 ///
305 class MenuDefinition {
306 public:
307         ///
308         typedef std::vector<MenuItem> ItemList;
309         ///
310         typedef ItemList::const_iterator const_iterator;
311         ///
312         explicit MenuDefinition(QString const & name = QString()) : name_(name) {}
313
314         ///
315         void read(Lexer &);
316         ///
317         QString const & name() const { return name_; }
318         ///
319         bool empty() const { return items_.empty(); }
320         /// Clear the menu content.
321         void clear() { items_.clear(); }
322         ///
323         size_t size() const { return items_.size(); }
324         ///
325         const_iterator begin() const { return items_.begin(); }
326         ///
327         const_iterator end() const { return items_.end(); }
328         ///
329         void cat(MenuDefinition const & other);
330         ///
331         void catSub(docstring const & name);
332
333         // search for func in this menu iteratively, and put menu
334         // names in a stack.
335         bool searchMenu(FuncRequest const & func, docstring_list & names)
336                 const;
337         ///
338         bool hasFunc(FuncRequest const &) const;
339         /// Add the menu item unconditionally
340         void add(MenuItem const & item) { items_.push_back(item); }
341         /// Checks the associated FuncRequest status before adding the
342         /// menu item.
343         void addWithStatusCheck(MenuItem const &);
344         // Check whether the menu shortcuts are unique
345         void checkShortcuts() const;
346         ///
347         void expandLastfiles();
348         void expandDocuments();
349         void expandBookmarks();
350         void expandFormats(MenuItem::Kind const kind, Buffer const * buf);
351         void expandFloatListInsert(Buffer const * buf);
352         void expandFloatInsert(Buffer const * buf);
353         void expandFlexInsert(Buffer const * buf, InsetLayout::InsetLyXType type);
354         void expandToc2(Toc const & toc_list, size_t from, size_t to, int depth, string toc_type);
355         void expandToc(Buffer const * buf);
356         void expandPasteRecent(Buffer const * buf);
357         void expandToolbars();
358         void expandBranches(Buffer const * buf);
359         void expandIndices(Buffer const * buf, bool listof = false);
360         void expandIndicesContext(Buffer const * buf, bool listof = false);
361         void expandCiteStyles(BufferView const *);
362         void expandGraphicsGroups(BufferView const *);
363         void expandSpellingSuggestions(BufferView const *);
364         void expandLanguageSelector(Buffer const * buf);
365         void expandArguments(BufferView const *, bool switcharg = false);
366         void expandCaptions(Buffer const * buf, bool switchcap = false);
367         void expandEnvironmentSeparators(BufferView const *);
368         void expandQuotes(BufferView const *);
369         ///
370         ItemList items_;
371         ///
372         QString name_;
373 };
374
375
376 /// Helper for std::find_if
377 class MenuNamesEqual
378 {
379 public:
380         MenuNamesEqual(QString const & name) : name_(name) {}
381         bool operator()(MenuDefinition const & menu) const { return menu.name() == name_; }
382 private:
383         QString name_;
384 };
385
386
387 ///
388 typedef std::vector<MenuDefinition> MenuList;
389 ///
390 typedef MenuList::const_iterator const_iterator;
391 ///
392 typedef MenuList::iterator iterator;
393
394 /////////////////////////////////////////////////////////////////////
395 // MenuDefinition implementation
396 /////////////////////////////////////////////////////////////////////
397
398 void MenuDefinition::addWithStatusCheck(MenuItem const & i)
399 {
400         switch (i.kind()) {
401
402         case MenuItem::Command: {
403                 FuncStatus status = lyx::getStatus(*i.func());
404                 if (status.unknown() || (!status.enabled() && i.optional()))
405                         break;
406                 items_.push_back(i);
407                 items_.back().status(status);
408                 break;
409         }
410
411         case MenuItem::Submenu: {
412                 bool enabled = false;
413                 if (i.hasSubmenu()) {
414                         for (const_iterator cit = i.submenu().begin();
415                                   cit != i.submenu().end(); ++cit) {
416                                 // Only these kind of items affect the status of the submenu
417                                 if ((cit->kind() == MenuItem::Command
418                                      || cit->kind() == MenuItem::Submenu
419                                      || cit->kind() == MenuItem::Help)
420                                     && cit->status().enabled()) {
421                                         enabled = true;
422                                         break;
423                                 }
424                         }
425                 }
426                 if (enabled || !i.optional()) {
427                         items_.push_back(i);
428                         items_.back().status().setEnabled(enabled);
429                 }
430                 break;
431         }
432
433         case MenuItem::Separator:
434                 if (!items_.empty() && items_.back().kind() != MenuItem::Separator)
435                         items_.push_back(i);
436                 break;
437
438         default:
439                 items_.push_back(i);
440         }
441 }
442
443
444 void MenuDefinition::read(Lexer & lex)
445 {
446         enum {
447                 md_item = 1,
448                 md_branches,
449                 md_citestyles,
450                 md_documents,
451                 md_bookmarks,
452                 md_charstyles,
453                 md_custom,
454                 md_elements,
455                 md_endmenu,
456                 md_exportformats,
457                 md_importformats,
458                 md_indices,
459                 md_indicescontext,
460                 md_indiceslists,
461                 md_indiceslistscontext,
462                 md_lastfiles,
463                 md_optitem,
464                 md_optsubmenu,
465                 md_separator,
466                 md_submenu,
467                 md_toc,
468                 md_updateformats,
469                 md_viewformats,
470                 md_floatlistinsert,
471                 md_floatinsert,
472                 md_pasterecent,
473                 md_toolbars,
474                 md_graphicsgroups,
475                 md_spellingsuggestions,
476                 md_languageselector,
477                 md_arguments,
478                 md_switcharguments,
479                 md_captions,
480                 md_switchcaptions,
481                 md_env_separators,
482                 md_switchquotes
483         };
484
485         LexerKeyword menutags[] = {
486                 { "arguments", md_arguments },
487                 { "bookmarks", md_bookmarks },
488                 { "branches", md_branches },
489                 { "captions", md_captions },
490                 { "charstyles", md_charstyles },
491                 { "citestyles", md_citestyles },
492                 { "custom", md_custom },
493                 { "documents", md_documents },
494                 { "elements", md_elements },
495                 { "end", md_endmenu },
496                 { "environmentseparators", md_env_separators },
497                 { "exportformats", md_exportformats },
498                 { "floatinsert", md_floatinsert },
499                 { "floatlistinsert", md_floatlistinsert },
500                 { "graphicsgroups", md_graphicsgroups },
501                 { "importformats", md_importformats },
502                 { "indices", md_indices },
503                 { "indicescontext", md_indicescontext },
504                 { "indiceslists", md_indiceslists },
505                 { "indiceslistscontext", md_indiceslistscontext },
506                 { "item", md_item },
507                 { "languageselector", md_languageselector },
508                 { "lastfiles", md_lastfiles },
509                 { "optitem", md_optitem },
510                 { "optsubmenu", md_optsubmenu },
511                 { "pasterecent", md_pasterecent },
512                 { "separator", md_separator },
513                 { "spellingsuggestions", md_spellingsuggestions },
514                 { "submenu", md_submenu },
515                 { "switcharguments", md_switcharguments },
516                 { "switchcaptions", md_switchcaptions },
517                 { "switchquotes", md_switchquotes },
518                 { "toc", md_toc },
519                 { "toolbars", md_toolbars },
520                 { "updateformats", md_updateformats },
521                 { "viewformats", md_viewformats }
522         };
523
524         lex.pushTable(menutags);
525         lex.setContext("MenuDefinition::read: ");
526
527         int md_type = 0;
528         while (lex.isOK() && md_type != md_endmenu) {
529                 switch (md_type = lex.lex()) {
530                 case md_optitem:
531                 case md_item: {
532                         lex.next(true);
533                         docstring const name = translateIfPossible(lex.getDocString());
534                         lex.next(true);
535                         string const command = lex.getString();
536                         FuncRequest func = lyxaction.lookupFunc(command);
537                         FuncRequest::Origin origin = FuncRequest::MENU;
538                         if (name_.startsWith("context-toc-"))
539                                 origin = FuncRequest::TOC;
540                         bool const optional = (md_type == md_optitem);
541                         add(MenuItem(MenuItem::Command, toqstr(name), func, QString(), optional, origin));
542                         break;
543                 }
544
545                 case md_separator:
546                         add(MenuItem(MenuItem::Separator));
547                         break;
548
549                 case md_lastfiles:
550                         add(MenuItem(MenuItem::Lastfiles));
551                         break;
552
553                 case md_charstyles:
554                         add(MenuItem(MenuItem::CharStyles));
555                         break;
556
557                 case md_custom:
558                         add(MenuItem(MenuItem::Custom));
559                         break;
560
561                 case md_elements:
562                         add(MenuItem(MenuItem::Elements));
563                         break;
564
565                 case md_documents:
566                         add(MenuItem(MenuItem::Documents));
567                         break;
568
569                 case md_bookmarks:
570                         add(MenuItem(MenuItem::Bookmarks));
571                         break;
572
573                 case md_toc:
574                         add(MenuItem(MenuItem::Toc));
575                         break;
576
577                 case md_viewformats:
578                         add(MenuItem(MenuItem::ViewFormats));
579                         break;
580
581                 case md_updateformats:
582                         add(MenuItem(MenuItem::UpdateFormats));
583                         break;
584
585                 case md_exportformats:
586                         add(MenuItem(MenuItem::ExportFormats));
587                         break;
588
589                 case md_importformats:
590                         add(MenuItem(MenuItem::ImportFormats));
591                         break;
592
593                 case md_floatlistinsert:
594                         add(MenuItem(MenuItem::FloatListInsert));
595                         break;
596
597                 case md_floatinsert:
598                         add(MenuItem(MenuItem::FloatInsert));
599                         break;
600
601                 case md_pasterecent:
602                         add(MenuItem(MenuItem::PasteRecent));
603                         break;
604
605                 case md_toolbars:
606                         add(MenuItem(MenuItem::Toolbars));
607                         break;
608
609                 case md_branches:
610                         add(MenuItem(MenuItem::Branches));
611                         break;
612
613                 case md_citestyles:
614                         add(MenuItem(MenuItem::CiteStyles));
615                         break;
616
617                 case md_graphicsgroups:
618                         add(MenuItem(MenuItem::GraphicsGroups));
619                         break;
620
621                 case md_spellingsuggestions:
622                         add(MenuItem(MenuItem::SpellingSuggestions));
623                         break;
624
625                 case md_languageselector:
626                         add(MenuItem(MenuItem::LanguageSelector));
627                         break;
628
629                 case md_indices:
630                         add(MenuItem(MenuItem::Indices));
631                         break;
632
633                 case md_indicescontext:
634                         add(MenuItem(MenuItem::IndicesContext));
635                         break;
636
637                 case md_indiceslists:
638                         add(MenuItem(MenuItem::IndicesLists));
639                         break;
640
641                 case md_indiceslistscontext:
642                         add(MenuItem(MenuItem::IndicesListsContext));
643                         break;
644
645                 case md_arguments:
646                         add(MenuItem(MenuItem::Arguments));
647                         break;
648
649                 case md_switcharguments:
650                         add(MenuItem(MenuItem::SwitchArguments));
651                         break;
652
653                 case md_captions:
654                         add(MenuItem(MenuItem::Captions));
655                         break;
656
657                 case md_switchcaptions:
658                         add(MenuItem(MenuItem::SwitchCaptions));
659                         break;
660
661                 case md_env_separators:
662                         add(MenuItem(MenuItem::EnvironmentSeparators));
663                         break;
664
665                 case md_switchquotes:
666                         add(MenuItem(MenuItem::SwitchQuotes));
667                         break;
668
669                 case md_optsubmenu:
670                 case md_submenu: {
671                         lex.next(true);
672                         docstring const mlabel = translateIfPossible(lex.getDocString());
673                         lex.next(true);
674                         docstring const mname = lex.getDocString();
675                         bool const optional = (md_type == md_optsubmenu);
676                         add(MenuItem(MenuItem::Submenu,
677                                 toqstr(mlabel), toqstr(mname), QString(), optional));
678                         break;
679                 }
680
681                 case md_endmenu:
682                         break;
683
684                 default:
685                         lex.printError("Unknown menu tag");
686                         break;
687                 }
688         }
689         lex.popTable();
690 }
691
692
693 bool MenuDefinition::hasFunc(FuncRequest const & func) const
694 {
695         for (const_iterator it = begin(), et = end(); it != et; ++it)
696                 if (*it->func() == func)
697                         return true;
698         return false;
699 }
700
701
702 void MenuDefinition::catSub(docstring const & name)
703 {
704         add(MenuItem(MenuItem::Submenu,
705                      qt_("More...|M"), toqstr(name), QString(), false));
706 }
707
708 void MenuDefinition::cat(MenuDefinition const & other)
709 {
710         const_iterator et = other.end();
711         for (const_iterator it = other.begin(); it != et; ++it)
712                 add(*it);
713 }
714
715
716 void MenuDefinition::checkShortcuts() const
717 {
718         // This is a quadratic algorithm, but we do not care because
719         // menus are short enough
720         for (const_iterator it1 = begin(); it1 != end(); ++it1) {
721                 QString shortcut = it1->shortcut();
722                 if (shortcut.isEmpty())
723                         continue;
724                 if (!it1->label().contains(shortcut))
725                         LYXERR0("Menu warning: menu entry \""
726                                << it1->label()
727                                << "\" does not contain shortcut `"
728                                << shortcut << "'.");
729                 for (const_iterator it2 = begin(); it2 != it1 ; ++it2) {
730                         if (!it2->shortcut().compare(shortcut, Qt::CaseInsensitive)) {
731                                 LYXERR0("Menu warning: menu entries "
732                                        << '"' << it1->fulllabel()
733                                        << "\" and \"" << it2->fulllabel()
734                                        << "\" share the same shortcut.");
735                         }
736                 }
737         }
738 }
739
740
741 bool MenuDefinition::searchMenu(FuncRequest const & func, docstring_list & names) const
742 {
743         const_iterator m = begin();
744         const_iterator m_end = end();
745         for (; m != m_end; ++m) {
746                 if (m->kind() == MenuItem::Command && *m->func() == func) {
747                         names.push_back(qstring_to_ucs4(m->label()));
748                         return true;
749                 }
750                 if (m->kind() == MenuItem::Submenu) {
751                         names.push_back(qstring_to_ucs4(m->label()));
752                         if (!m->hasSubmenu()) {
753                                 LYXERR(Debug::GUI, "Warning: non existing sub menu label="
754                                         << m->label() << " name=" << m->submenuname());
755                                 names.pop_back();
756                                 continue;
757                         }
758                         if (m->submenu().searchMenu(func, names))
759                                 return true;
760                         names.pop_back();
761                 }
762         }
763         return false;
764 }
765
766
767 QString limitStringLength(docstring const & str)
768 {
769         size_t const max_item_length = 45;
770         docstring ret = str.substr(0, max_item_length + 1);
771         support::truncateWithEllipsis(ret, max_item_length);
772         return toqstr(ret);
773 }
774
775
776 void MenuDefinition::expandGraphicsGroups(BufferView const * bv)
777 {
778         if (!bv)
779                 return;
780         set<string> grp;
781         graphics::getGraphicsGroups(bv->buffer(), grp);
782         if (grp.empty())
783                 return;
784
785         set<string>::const_iterator it = grp.begin();
786         set<string>::const_iterator end = grp.end();
787         add(MenuItem(MenuItem::Command, qt_("No Group"),
788                      FuncRequest(LFUN_SET_GRAPHICS_GROUP)));
789         for (; it != end; ++it) {
790                 addWithStatusCheck(MenuItem(MenuItem::Command, toqstr(*it) + '|',
791                                 FuncRequest(LFUN_SET_GRAPHICS_GROUP, *it)));
792         }
793 }
794
795
796 void MenuDefinition::expandSpellingSuggestions(BufferView const * bv)
797 {
798         if (!bv)
799                 return;
800         Cursor const & cur = bv->cursor();
801         if (!cur.inTexted())
802                 return;
803         WordLangTuple wl;
804         docstring_list suggestions;
805         Paragraph const & par = cur.paragraph();
806         pos_type from = cur.pos();
807         pos_type to = from;
808         SpellChecker::Result res = par.spellCheck(from, to, wl, suggestions, true, true);
809         switch (res) {
810         case SpellChecker::UNKNOWN_WORD:
811                 if (lyxrc.spellcheck_continuously) {
812                         LYXERR(Debug::GUI, "Misspelled Word! Suggested Words = ");
813                         docstring const & selection = cur.selectionAsString(false);
814                         if (!cur.selection() || selection == wl.word()) {
815                                 size_t i = 0;
816                                 size_t m = 10; // first submenu index
817                                 MenuItem item(MenuItem::Submenu, qt_("More Spelling Suggestions"));
818                                 item.setSubmenu(MenuDefinition(qt_("More Spelling Suggestions")));
819                                 for (; i != suggestions.size(); ++i) {
820                                         docstring const & suggestion = suggestions[i];
821                                         LYXERR(Debug::GUI, suggestion);
822                                         MenuItem w(MenuItem::Command, toqstr(suggestion),
823                                                 FuncRequest(LFUN_WORD_REPLACE,
824                                                         replace2string(suggestion, selection,
825                                                                 true,     // case sensitive
826                                                                 true,     // match word
827                                                                 false,    // all words
828                                                                 true,     // forward
829                                                                 false))); // find next
830                                         if (i < m)
831                                                 add(w);
832                                         else
833                                                 item.submenu().add(w);
834                                 }
835                                 if (i > m)
836                                         add(item);
837                                 if (i > 0)
838                                         add(MenuItem(MenuItem::Separator));
839                                 docstring const arg = wl.word() + " " + from_ascii(wl.lang()->lang());
840                                 add(MenuItem(MenuItem::Command, qt_("Add to personal dictionary|n"),
841                                                 FuncRequest(LFUN_SPELLING_ADD, arg)));
842                                 add(MenuItem(MenuItem::Command, qt_("Ignore all|I"),
843                                                 FuncRequest(LFUN_SPELLING_IGNORE, arg)));
844                         }
845                 }
846                 break;
847         case SpellChecker::LEARNED_WORD: {
848                         LYXERR(Debug::GUI, "Learned Word.");
849                         docstring const arg = wl.word() + " " + from_ascii(wl.lang()->lang());
850                         add(MenuItem(MenuItem::Command, qt_("Remove from personal dictionary|r"),
851                                         FuncRequest(LFUN_SPELLING_REMOVE, arg)));
852                 }
853                 break;
854         case SpellChecker::NO_DICTIONARY:
855                 LYXERR(Debug::GUI, "No dictionary for language " + from_ascii(wl.lang()->lang()));
856                 // FALLTHROUGH
857         case SpellChecker::WORD_OK:
858         case SpellChecker::COMPOUND_WORD:
859         case SpellChecker::ROOT_FOUND:
860         case SpellChecker::IGNORED_WORD:
861                 break;
862         }
863 }
864
865 struct sortLanguageByName {
866         bool operator()(const Language * a, const Language * b) const {
867                 return qt_(a->display()).localeAwareCompare(qt_(b->display())) < 0;
868         }
869 };
870
871 void MenuDefinition::expandLanguageSelector(Buffer const * buf)
872 {
873         if (!buf)
874                 return;
875
876         std::set<Language const *> languages_buffer =
877                 buf->masterBuffer()->getLanguages();
878
879         if (languages_buffer.size() < 2)
880                 return;
881
882         std::set<Language const *, sortLanguageByName> languages;
883
884         std::set<Language const *>::const_iterator const beg =
885                 languages_buffer.begin();
886         for (std::set<Language const *>::const_iterator cit = beg;
887              cit != languages_buffer.end(); ++cit) {
888                 languages.insert(*cit);
889         }
890
891         MenuItem item(MenuItem::Submenu, qt_("Language|L"));
892         item.setSubmenu(MenuDefinition(qt_("Language")));
893         QString morelangs = qt_("More Languages ...|M");
894         QStringList accelerators;
895         if (morelangs.contains('|'))
896                 accelerators.append(morelangs.section('|', -1));
897         std::set<Language const *, sortLanguageByName>::const_iterator const begin = languages.begin();
898         for (std::set<Language const *, sortLanguageByName>::const_iterator cit = begin;
899              cit != languages.end(); ++cit) {
900                 QString label = qt_((*cit)->display());
901                 // try to add an accelerator
902                 bool success = false;
903                 // try capitals first
904                 for (int i = 0; i < label.size(); ++i) {
905                         QChar const ch = label[i];
906                         if (!ch.isUpper())
907                                 continue;
908                         if (!accelerators.contains(ch, Qt::CaseInsensitive)) {
909                                 label = label + toqstr("|") + ch;
910                                 accelerators.append(ch);
911                                 success = true;
912                                 break;
913                         }
914                 }
915                 // if all capitals are taken, try the rest
916                 if (!success) {
917                         for (int i = 0; i < label.size(); ++i) {
918                                 if (label[i].isSpace())
919                                         continue;
920                                 QString const ch = QString(label[i]);
921                                 if (!accelerators.contains(ch, Qt::CaseInsensitive)) {
922                                         label = label + toqstr("|") + ch;
923                                         accelerators.append(ch);
924                                         break;
925                                 }
926                         }
927                 }
928                 MenuItem w(MenuItem::Command, label,
929                         FuncRequest(LFUN_LANGUAGE, (*cit)->lang() + " set"));
930                 item.submenu().addWithStatusCheck(w);
931         }
932         item.submenu().add(MenuItem(MenuItem::Separator));
933         item.submenu().add(MenuItem(MenuItem::Command, morelangs,
934                         FuncRequest(LFUN_DIALOG_SHOW, "character")));
935         add(item);
936 }
937
938
939 void MenuDefinition::expandLastfiles()
940 {
941         LastFilesSection::LastFiles const & lf = theSession().lastFiles().lastFiles();
942         LastFilesSection::LastFiles::const_iterator lfit = lf.begin();
943
944         unsigned int ii = 1;
945
946         for (; lfit != lf.end() && ii <= lyxrc.num_lastfiles; ++lfit, ++ii) {
947                 string const file = lfit->absFileName();
948                 QString const short_path = toqstr(makeDisplayPath(file, 30));
949                 QString const long_path = toqstr(makeDisplayPath(file));
950                 QString label;
951                 if (ii < 10)
952                         label = QString("%1. %2|%3").arg(ii).arg(short_path).arg(ii);
953                 else
954                         label = QString("%1. %2").arg(ii).arg(short_path);
955                 add(MenuItem(MenuItem::Command, label,
956                         FuncRequest(LFUN_FILE_OPEN, file), long_path));
957         }
958 }
959
960
961 void MenuDefinition::expandDocuments()
962 {
963         MenuItem item(MenuItem::Submenu, qt_("Hidden|H"));
964         item.setSubmenu(MenuDefinition(qt_("Hidden|H")));
965
966         Buffer * first = theBufferList().first();
967         if (!first) {
968                 add(MenuItem(MenuItem::Info, qt_("<No Documents Open>")));
969                 return;
970         }
971
972         int i = 0;
973         while (true) {
974                 if (!guiApp->currentView())
975                         break;
976                 GuiWorkArea * wa = guiApp->currentView()->workArea(i);
977                 if (!wa)
978                         break;
979                 Buffer const & b = wa->bufferView().buffer();
980                 QString label = toqstr(b.fileName().displayName(20));
981                 if (!b.isClean())
982                         label += "*";
983                 if (i < 10)
984                         label = QString::number(i) + ". " + label + '|' + QString::number(i);
985                 add(MenuItem(MenuItem::Command, label,
986                         FuncRequest(LFUN_BUFFER_SWITCH, b.absFileName())));
987                 ++i;
988         }
989
990
991         i = 0;
992         Buffer * b = first;
993         // We cannot use a for loop as the buffer list cycles.
994         do {
995                 if (!(guiApp->currentView()
996                     && guiApp->currentView()->workArea(*b))) {
997                         QString label = toqstr(b->fileName().displayName(20));
998                         if (!b->isClean())
999                                 label += "*";
1000                         if (i < 10)
1001                                 label = QString::number(i) + ". " + label + '|' + QString::number(i);
1002                         item.submenu().add(MenuItem(MenuItem::Command, label,
1003                                 FuncRequest(LFUN_BUFFER_SWITCH, b->absFileName())));
1004                         ++i;
1005                 }
1006                 b = theBufferList().next(b);
1007         } while (b != first);
1008
1009         if (!item.submenu().empty())
1010                 add(item);
1011 }
1012
1013
1014 void MenuDefinition::expandBookmarks()
1015 {
1016         lyx::BookmarksSection const & bm = theSession().bookmarks();
1017
1018         bool empty = true;
1019         for (size_t i = 1; i <= bm.size(); ++i) {
1020                 if (bm.isValid(i)) {
1021                         string const file = bm.bookmark(i).filename.absFileName();
1022                         QString const label = QString("%1. %2|%3").arg(i)
1023                                 .arg(toqstr(makeDisplayPath(file, 20))).arg(i);
1024                         add(MenuItem(MenuItem::Command, label,
1025                                 FuncRequest(LFUN_BOOKMARK_GOTO, convert<docstring>(i))));
1026                         empty = false;
1027                 }
1028         }
1029         if (empty)
1030                 add(MenuItem(MenuItem::Info, qt_("<No Bookmarks Saved Yet>")));
1031 }
1032
1033
1034 void MenuDefinition::expandFormats(MenuItem::Kind const kind, Buffer const * buf)
1035 {
1036         if (!buf && kind != MenuItem::ImportFormats)
1037                 return;
1038
1039         FormatList formats;
1040         FuncCode action = LFUN_NOACTION;
1041
1042         switch (kind) {
1043         case MenuItem::ImportFormats:
1044                 formats = theConverters().importableFormats();
1045                 action = LFUN_BUFFER_IMPORT;
1046                 break;
1047         case MenuItem::ViewFormats:
1048                 formats = buf->params().exportableFormats(true);
1049                 action = LFUN_BUFFER_VIEW;
1050                 break;
1051         case MenuItem::UpdateFormats:
1052                 formats = buf->params().exportableFormats(true);
1053                 action = LFUN_BUFFER_UPDATE;
1054                 break;
1055         case MenuItem::ExportFormats:
1056                 formats = buf->params().exportableFormats(false);
1057                 action = LFUN_BUFFER_EXPORT;
1058                 break;
1059         default:
1060                 LATTEST(false);
1061                 return;
1062         }
1063
1064         bool const view_update = (kind == MenuItem::ViewFormats
1065                         || kind == MenuItem::UpdateFormats);
1066
1067         QString smenue;
1068         if (view_update)
1069                 smenue = (kind == MenuItem::ViewFormats
1070                         ? qt_("View (Other Formats)|F")
1071                         : qt_("Update (Other Formats)|p"));
1072         MenuItem item(MenuItem::Submenu, smenue);
1073         item.setSubmenu(MenuDefinition(smenue));
1074
1075         for (Format const * f : formats) {
1076                 if (f->dummy())
1077                         continue;
1078
1079                 docstring lab = f->prettyname();
1080                 docstring const scut = from_utf8(f->shortcut());
1081                 docstring const tmplab = lab;
1082
1083                 if (!scut.empty())
1084                         lab += char_type('|') + scut;
1085                 docstring const lab_i18n = translateIfPossible(lab);
1086                 docstring const shortcut = split(lab_i18n, lab, '|');
1087
1088                 bool const untranslated = (lab == lab_i18n);
1089                 docstring label = untranslated ? translateIfPossible(tmplab) : lab;
1090
1091                 switch (kind) {
1092                 case MenuItem::ImportFormats:
1093                         label += from_ascii("...");
1094                         break;
1095                 case MenuItem::ViewFormats:
1096                 case MenuItem::UpdateFormats:
1097                         if (f->name() == buf->params().getDefaultOutputFormat()) {
1098                                 docstring lbl = (kind == MenuItem::ViewFormats
1099                                         ? bformat(_("View [%1$s]|V"), label)
1100                                         : bformat(_("Update [%1$s]|U"), label));
1101                                 add(MenuItem(MenuItem::Command, toqstr(lbl), FuncRequest(action)));
1102                                 continue;
1103                         }
1104                 // fall through
1105                 case MenuItem::ExportFormats:
1106                         if (!f->inExportMenu())
1107                                 continue;
1108                         break;
1109                 default:
1110                         // we already asserted earlier in this case
1111                         // LATTEST(false);
1112                         continue;
1113                 }
1114                 if (!shortcut.empty())
1115                         label += '|' + shortcut;
1116
1117                 if (view_update) {
1118                         // note that at this point, we know that buf is not null
1119                         LATTEST(buf);
1120                         item.submenu().addWithStatusCheck(MenuItem(MenuItem::Command,
1121                                 toqstr(label), FuncRequest(action, f->name())));
1122                 } else {
1123                         if (buf)
1124                                 addWithStatusCheck(MenuItem(MenuItem::Command, toqstr(label),
1125                                         FuncRequest(action, f->name())));
1126                         else
1127                                 add(MenuItem(MenuItem::Command, toqstr(label),
1128                                         FuncRequest(action, f->name())));
1129                 }
1130         }
1131         if (view_update)
1132                 add(item);
1133 }
1134
1135
1136 void MenuDefinition::expandFloatListInsert(Buffer const * buf)
1137 {
1138         if (!buf)
1139                 return;
1140
1141         FloatList const & floats = buf->params().documentClass().floats();
1142         FloatList::const_iterator cit = floats.begin();
1143         FloatList::const_iterator end = floats.end();
1144         set<string> seen;
1145         for (; cit != end; ++cit) {
1146                 if (!cit->second.usesFloatPkg()) {
1147                         // Different floats could declare the same ListCommand. We only
1148                         // want it on the list once, though.
1149                         string const & list_cmd = cit->second.listCommand();
1150                         if (list_cmd.empty())
1151                                 // we do not know how to generate such a list
1152                                 continue;
1153                         // This form of insert returns an iterator pointing to the newly
1154                         // inserted element OR the existing element with that value, and
1155                         // a bool indicating whether we inserted a new element. So we can
1156                         // see if one is there and insert it if not all at once.
1157                         pair<set<string>::iterator, bool> ret = seen.insert(list_cmd);
1158                         if (!ret.second)
1159                                 continue;
1160                 }
1161                 string const & list_name = cit->second.listName();
1162                 addWithStatusCheck(MenuItem(MenuItem::Command, qt_(list_name),
1163                         FuncRequest(LFUN_FLOAT_LIST_INSERT, cit->second.floattype())));
1164         }
1165 }
1166
1167
1168 void MenuDefinition::expandFloatInsert(Buffer const * buf)
1169 {
1170         if (!buf)
1171                 return;
1172
1173         FloatList const & floats = buf->params().documentClass().floats();
1174         FloatList::const_iterator cit = floats.begin();
1175         FloatList::const_iterator end = floats.end();
1176         for (; cit != end; ++cit) {
1177                 // normal float
1178                 QString const label = qt_(cit->second.name());
1179                 addWithStatusCheck(MenuItem(MenuItem::Command, label,
1180                                     FuncRequest(LFUN_FLOAT_INSERT,
1181                                                 cit->second.floattype())));
1182         }
1183 }
1184
1185
1186 void MenuDefinition::expandFlexInsert(
1187                 Buffer const * buf, InsetLayout::InsetLyXType type)
1188 {
1189         if (!buf)
1190                 return;
1191
1192         TextClass::InsetLayouts const & insetLayouts =
1193                 buf->params().documentClass().insetLayouts();
1194         TextClass::InsetLayouts::const_iterator cit = insetLayouts.begin();
1195         TextClass::InsetLayouts::const_iterator end = insetLayouts.end();
1196         for (; cit != end; ++cit) {
1197                 if (cit->second.lyxtype() == type) {
1198                         if (!cit->second.obsoleted_by().empty())
1199                                 continue;
1200                         docstring label = cit->first;
1201                         // we remove the "Flex:" prefix, if it is present
1202                         if (prefixIs(label, from_ascii("Flex:")))
1203                                 label = label.substr(5);
1204                         addWithStatusCheck(MenuItem(MenuItem::Command,
1205                                 toqstr(translateIfPossible(label)),
1206                                 FuncRequest(LFUN_FLEX_INSERT, Lexer::quoteString(label))));
1207                 }
1208         }
1209         // FIXME This is a little clunky.
1210         if (items_.empty() && type == InsetLayout::CUSTOM && !buf->isReadonly())
1211                 add(MenuItem(MenuItem::Help, qt_("No Custom Insets Defined!")));
1212 }
1213
1214
1215 // Threshold before we stop displaying sub-items alongside items
1216 // (for display purposes). Ideally this should fit on a screen.
1217 size_t const max_number_of_items = 30;
1218 // Size limit for the menu. This is for performance purposes,
1219 // because qt already displays a scrollable menu when necessary.
1220 // Ideally this should be the menu size from which scrollable
1221 // menus become unpractical.
1222 size_t const menu_size_limit = 80;
1223
1224 void MenuDefinition::expandToc2(Toc const & toc_list,
1225                                 size_t from, size_t to, int depth,
1226                                 string toc_type)
1227 {
1228         int shortcut_count = 0;
1229
1230         // check whether depth is smaller than the smallest depth in toc.
1231         int min_depth = 1000;
1232         for (size_t i = from; i < to; ++i)
1233                 min_depth = min(min_depth, toc_list[i].depth());
1234         if (min_depth > depth)
1235                 depth = min_depth;
1236
1237         if (to - from <= max_number_of_items) {
1238                 for (size_t i = from; i < to; ++i) {
1239                         QString label(4 * max(0, toc_list[i].depth() - depth), ' ');
1240                         label += limitStringLength(toc_list[i].asString());
1241                         if (toc_list[i].depth() == depth) {
1242                                 label += '|';
1243                             if (shortcut_count < 9) {
1244                                         if (label.contains(QString::number(shortcut_count + 1)))
1245                                                 label += QString::number(++shortcut_count);
1246                                 }
1247                         }
1248                         add(MenuItem(MenuItem::Command, label,
1249                                             FuncRequest(toc_list[i].action())));
1250                         // separator after the menu heading
1251                         if (toc_list[i].depth() < depth)
1252                                 add(MenuItem(MenuItem::Separator));
1253                 }
1254         } else {
1255                 size_t pos = from;
1256                 size_t size = 1;
1257                 while (pos < to) {
1258                         size_t new_pos = pos + 1;
1259                         while (new_pos < to && toc_list[new_pos].depth() > depth)
1260                                 ++new_pos;
1261
1262                         QString label(4 * max(0, toc_list[pos].depth() - depth), ' ');
1263                         label += limitStringLength(toc_list[pos].asString());
1264                         if (toc_list[pos].depth() == depth) {
1265                                 label += '|';
1266                             if (shortcut_count < 9) {
1267                                         if (label.contains(QString::number(shortcut_count + 1)))
1268                                                 label += QString::number(++shortcut_count);
1269                                 }
1270                         }
1271                         if (size >= menu_size_limit) {
1272                                 FuncRequest f(LFUN_DIALOG_SHOW, "toc " + toc_type);
1273                                 add(MenuItem(MenuItem::Command, "...", f));
1274                                 break;
1275                         }
1276                         if (new_pos == pos + 1) {
1277                                 add(MenuItem(MenuItem::Command,
1278                                                     label, FuncRequest(toc_list[pos].action())));
1279                         } else {
1280                                 MenuDefinition sub;
1281                                 sub.expandToc2(toc_list, pos, new_pos, depth + 1, toc_type);
1282                                 MenuItem item(MenuItem::Submenu, label);
1283                                 item.setSubmenu(sub);
1284                                 add(item);
1285                         }
1286                         ++size;
1287                         pos = new_pos;
1288                 }
1289         }
1290 }
1291
1292
1293 void MenuDefinition::expandToc(Buffer const * buf)
1294 {
1295         // To make things very cleanly, we would have to pass buf to
1296         // all MenuItem constructors and to expandToc2. However, we
1297         // know that all the entries in a TOC will be have status_ ==
1298         // OK, so we avoid this unnecessary overhead (JMarc)
1299         if (!buf) {
1300                 add(MenuItem(MenuItem::Info, qt_("(No Document Open)")));
1301                 return;
1302         }
1303         // Add an entry for the master doc if this is a child doc
1304         Buffer const * const master = buf->masterBuffer();
1305         if (buf != master) {
1306                 ParIterator const pit = par_iterator_begin(master->inset());
1307                 string const arg = convert<string>(pit->id());
1308                 FuncRequest f(LFUN_PARAGRAPH_GOTO, arg);
1309                 add(MenuItem(MenuItem::Command, qt_("Master Document"), f));
1310         }
1311
1312         MenuDefinition other_lists;
1313         TocList const & toc_list = buf->tocBackend().tocs();
1314         TocList::const_iterator cit = toc_list.begin();
1315         TocList::const_iterator end = toc_list.end();
1316         for (; cit != end; ++cit) {
1317                 // Handle table of contents later
1318                 if (cit->first == "tableofcontents" || cit->second->empty())
1319                         continue;
1320                 MenuDefinition submenu;
1321                 // "Open outliner..." entry
1322                 FuncRequest f(LFUN_DIALOG_SHOW, "toc " + cit->first);
1323                 submenu.add(MenuItem(MenuItem::Command, qt_("Open Outliner..."), f));
1324                 submenu.add(MenuItem(MenuItem::Separator));
1325                 // add entries
1326                 submenu.expandToc2(*cit->second, 0, cit->second->size(), 0, cit->first);
1327                 MenuItem item(MenuItem::Submenu, guiName(cit->first, buf->params()));
1328                 item.setSubmenu(submenu);
1329                 // deserves to be in the main menu?
1330                 if (!TocBackend::isOther(cit->first))
1331                         add(item);
1332                 else
1333                         other_lists.add(item);
1334         }
1335         if (!other_lists.empty()) {
1336                 MenuItem item(MenuItem::Submenu, qt_("Other Lists"));
1337                 item.setSubmenu(other_lists);
1338                 add(item);
1339         }
1340         // Handle normal TOC
1341         add(MenuItem(MenuItem::Separator));
1342         cit = toc_list.find("tableofcontents");
1343         if (cit == end)
1344                 LYXERR(Debug::GUI, "No table of contents.");
1345         else {
1346                 if (!cit->second->empty())
1347                         expandToc2(*cit->second, 0, cit->second->size(), 0,
1348                                    "tableofcontents");
1349                 else
1350                         add(MenuItem(MenuItem::Info, qt_("(Empty Table of Contents)")));
1351         }
1352 }
1353
1354
1355 void MenuDefinition::expandPasteRecent(Buffer const * buf)
1356 {
1357         docstring_list const sel = cap::availableSelections(buf);
1358
1359         docstring_list::const_iterator cit = sel.begin();
1360         docstring_list::const_iterator end = sel.end();
1361
1362         for (unsigned int index = 0; cit != end; ++cit, ++index) {
1363                 add(MenuItem(MenuItem::Command, toqstr(*cit) + '|',
1364                                     FuncRequest(LFUN_PASTE, convert<string>(index))));
1365         }
1366 }
1367
1368
1369 void MenuDefinition::expandToolbars()
1370 {
1371         MenuDefinition other_lists;
1372         // extracts the toolbars from the backend
1373         Toolbars::Infos::const_iterator cit = guiApp->toolbars().begin();
1374         Toolbars::Infos::const_iterator end = guiApp->toolbars().end();
1375         for (; cit != end; ++cit) {
1376                 MenuItem const item(MenuItem::Command, toqstr(cit->gui_name),
1377                                 FuncRequest(LFUN_TOOLBAR_TOGGLE, cit->name));
1378                 if (guiApp->toolbars().isMainToolbar(cit->name))
1379                         add(item);
1380                 else
1381                         other_lists.add(item);
1382         }
1383
1384         if (!other_lists.empty()) {
1385                 MenuItem item(MenuItem::Submenu, qt_("Other Toolbars"));
1386                 item.setSubmenu(other_lists);
1387                 add(item);
1388         }
1389 }
1390
1391
1392 void MenuDefinition::expandBranches(Buffer const * buf)
1393 {
1394         if (!buf || buf->isReadonly())
1395                 return;
1396
1397         BufferParams const & master_params = buf->masterBuffer()->params();
1398         BufferParams const & params = buf->params();
1399         if (params.branchlist().empty() && master_params.branchlist().empty() ) {
1400                 add(MenuItem(MenuItem::Help, qt_("No Branches Set for Document!")));
1401                 return;
1402         }
1403
1404         BranchList::const_iterator cit = master_params.branchlist().begin();
1405         BranchList::const_iterator end = master_params.branchlist().end();
1406
1407         for (int ii = 1; cit != end; ++cit, ++ii) {
1408                 docstring label = cit->branch();
1409                 if (ii < 10) {
1410                         label = convert<docstring>(ii) + ". " + label
1411                                 + char_type('|') + convert<docstring>(ii);
1412                 }
1413                 addWithStatusCheck(MenuItem(MenuItem::Command, toqstr(label),
1414                                     FuncRequest(LFUN_BRANCH_INSERT,
1415                                                 cit->branch())));
1416         }
1417
1418         if (buf == buf->masterBuffer())
1419                 return;
1420
1421         MenuDefinition child_branches;
1422
1423         BranchList::const_iterator ccit = params.branchlist().begin();
1424         BranchList::const_iterator cend = params.branchlist().end();
1425
1426         for (int ii = 1; ccit != cend; ++ccit, ++ii) {
1427                 docstring label = ccit->branch();
1428                 if (ii < 10) {
1429                         label = convert<docstring>(ii) + ". " + label
1430                                 + char_type('|') + convert<docstring>(ii);
1431                 } else
1432                         label += char_type('|');
1433                 child_branches.addWithStatusCheck(MenuItem(MenuItem::Command,
1434                                     toqstr(label),
1435                                     FuncRequest(LFUN_BRANCH_INSERT,
1436                                                 ccit->branch())));
1437         }
1438
1439         if (!child_branches.empty()) {
1440                 MenuItem item(MenuItem::Submenu, qt_("Child Document"));
1441                 item.setSubmenu(child_branches);
1442                 add(item);
1443         }
1444 }
1445
1446
1447 void MenuDefinition::expandIndices(Buffer const * buf, bool listof)
1448 {
1449         if (!buf)
1450                 return;
1451
1452         BufferParams const & params = buf->masterBuffer()->params();
1453         if (!params.use_indices) {
1454                 if (listof)
1455                         addWithStatusCheck(MenuItem(MenuItem::Command,
1456                                            qt_("Index List|I"),
1457                                            FuncRequest(LFUN_INDEX_PRINT,
1458                                                   from_ascii("idx"))));
1459                 else
1460                         addWithStatusCheck(MenuItem(MenuItem::Command,
1461                                            qt_("Index Entry|d"),
1462                                            FuncRequest(LFUN_INDEX_INSERT,
1463                                                   from_ascii("idx"))));
1464                 return;
1465         }
1466
1467         if (params.indiceslist().empty())
1468                 return;
1469
1470         IndicesList::const_iterator cit = params.indiceslist().begin();
1471         IndicesList::const_iterator end = params.indiceslist().end();
1472
1473         for (int ii = 1; cit != end; ++cit, ++ii) {
1474                 if (listof) {
1475                         docstring const label =
1476                                 bformat(_("Index: %1$s"), cit->index());
1477                         addWithStatusCheck(MenuItem(MenuItem::Command, toqstr(label),
1478                                            FuncRequest(LFUN_INDEX_PRINT, cit->shortcut())));
1479                 } else {
1480                         docstring const label =
1481                                 bformat(_("Index Entry (%1$s)"), cit->index());
1482                         addWithStatusCheck(MenuItem(MenuItem::Command, toqstr(label),
1483                                            FuncRequest(LFUN_INDEX_INSERT, cit->shortcut())));
1484                 }
1485         }
1486 }
1487
1488
1489 void MenuDefinition::expandIndicesContext(Buffer const * buf, bool listof)
1490 {
1491         if (!buf)
1492                 return;
1493
1494         BufferParams const & params = buf->masterBuffer()->params();
1495         if (!params.use_indices || params.indiceslist().empty())
1496                 return;
1497
1498         IndicesList::const_iterator cit = params.indiceslist().begin();
1499         IndicesList::const_iterator end = params.indiceslist().end();
1500
1501         for (int ii = 1; cit != end; ++cit, ++ii) {
1502                 if (listof) {
1503                         InsetCommandParams p(INDEX_PRINT_CODE);
1504                         p["type"] = cit->shortcut();
1505                         string const data = InsetCommand::params2string(p);
1506                         addWithStatusCheck(MenuItem(MenuItem::Command, toqstr(cit->index()),
1507                                            FuncRequest(LFUN_INSET_MODIFY, data)));
1508                 } else {
1509                         docstring const label =
1510                                         bformat(_("Index Entry (%1$s)"), cit->index());
1511                         addWithStatusCheck(MenuItem(MenuItem::Command, toqstr(label),
1512                                            FuncRequest(LFUN_INSET_MODIFY,
1513                                                   from_ascii("changetype ") + cit->shortcut())));
1514                 }
1515         }
1516 }
1517
1518
1519 void MenuDefinition::expandCiteStyles(BufferView const * bv)
1520 {
1521         if (!bv)
1522                 return;
1523
1524         Inset const * inset = bv->cursor().nextInset();
1525         if (!inset || inset->lyxCode() != CITE_CODE) {
1526                 add(MenuItem(MenuItem::Command,
1527                                     qt_("No Citation in Scope!"),
1528                                     FuncRequest(LFUN_NOACTION)));
1529                 return;
1530         }
1531         InsetCommand const * citinset =
1532                                 static_cast<InsetCommand const *>(inset);
1533
1534         Buffer const * buf = &bv->buffer();
1535         string const cmd = citinset->params().getCmdName();
1536
1537         docstring const & key = citinset->getParam("key");
1538         if (key.empty()) {
1539                 add(MenuItem(MenuItem::Command,
1540                                     qt_("No citations selected!"),
1541                                     FuncRequest(LFUN_NOACTION)));
1542                 return;
1543         }
1544
1545         docstring const & before = citinset->getParam("before");
1546         docstring const & after = citinset->getParam("after");
1547
1548         size_t const n = cmd.size();
1549         bool const force = cmd[0] == 'C';
1550         bool const full = cmd[n] == '*';
1551
1552         vector<docstring> const keys = getVectorFromString(key);
1553
1554         vector<CitationStyle> const citeStyleList = buf->params().citeStyles();
1555         static const size_t max_length = 40;
1556         vector<docstring> citeStrings =
1557                 buf->masterBibInfo().getCiteStrings(keys, citeStyleList, bv->buffer(),
1558                 before, after, from_utf8("dialog"), max_length);
1559
1560         vector<docstring>::const_iterator cit = citeStrings.begin();
1561         vector<docstring>::const_iterator end = citeStrings.end();
1562
1563         for (int ii = 1; cit != end; ++cit, ++ii) {
1564                 docstring label = *cit;
1565                 CitationStyle cs = citeStyleList[ii - 1];
1566                 cs.forceUpperCase &= force;
1567                 cs.fullAuthorList &= full;
1568                 addWithStatusCheck(MenuItem(MenuItem::Command, toqstr(label),
1569                                     FuncRequest(LFUN_INSET_MODIFY,
1570                                                 "changetype " + from_utf8(citationStyleToString(cs)))));
1571         }
1572 }
1573
1574
1575 void MenuDefinition::expandArguments(BufferView const * bv, bool switcharg)
1576 {
1577         if (!bv)
1578                 return;
1579
1580         if (!bv->cursor().inTexted())
1581                 return;
1582
1583         Inset const * inset = &bv->cursor().inset();
1584         Layout::LaTeXArgMap args = bv->cursor().paragraph().layout().args();
1585         if (inset && args.empty())
1586                 args = inset->getLayout().args();
1587         if (args.empty() || (switcharg && args.size() == 1))
1588                 return;
1589         Layout::LaTeXArgMap::const_iterator lait = args.begin();
1590         Layout::LaTeXArgMap::const_iterator const laend = args.end();
1591         for (; lait != laend; ++lait) {
1592                 Layout::latexarg arg = (*lait).second;
1593                 docstring str = arg.menustring.empty()? arg.labelstring : arg.menustring;
1594                 QString item = toqstr(translateIfPossible(str));
1595                 if (switcharg)
1596                         add(MenuItem(MenuItem::Command, item,
1597                                      FuncRequest(LFUN_INSET_MODIFY,
1598                                                  from_ascii("changetype ")
1599                                                  + from_ascii((*lait).first))));
1600                 else
1601                         add(MenuItem(MenuItem::Command, item,
1602                                      FuncRequest(LFUN_ARGUMENT_INSERT,
1603                                                  from_ascii((*lait).first))));
1604         }
1605 }
1606
1607
1608 void MenuDefinition::expandCaptions(Buffer const * buf, bool switchcap)
1609 {
1610         if (!buf)
1611                 return;
1612
1613         DocumentClass const & dc = buf->params().documentClass();
1614         vector< pair<docstring, FuncRequest> > caps;
1615         for (pair<docstring, InsetLayout> const & il : dc.insetLayouts()) {
1616                 docstring instype;
1617                 docstring const type = split(il.first, instype, ':');
1618                 if (instype == "Caption") {
1619                         // skip forbidden caption types
1620                         FuncRequest const cmd = switchcap
1621                                 ? FuncRequest(LFUN_INSET_MODIFY, from_ascii("changetype ") + type)
1622                                 : FuncRequest(LFUN_CAPTION_INSERT, type);
1623                         if (getStatus(cmd).enabled())
1624                                 caps.push_back(make_pair(type, cmd));
1625                 }
1626         }
1627
1628         if (caps.empty() || (switchcap && caps.size() == 1))
1629                 return;
1630         if (caps.size() == 1) {
1631                 add(MenuItem(MenuItem::Command, qt_("Caption"), caps.front().second));
1632                 return;
1633         }
1634
1635         MenuDefinition captions;
1636         for (pair<docstring, FuncRequest> const & cap : caps) {
1637                 docstring const type = cap.first;
1638                 docstring const trtype = translateIfPossible(type);
1639                 docstring const cmitem = bformat(_("Caption (%1$s)"), trtype);
1640                 if (switchcap)
1641                         add(MenuItem(MenuItem::Command, toqstr(cmitem), cap.second));
1642                 else
1643                         captions.add(MenuItem(MenuItem::Command, toqstr(trtype), cap.second));
1644         }
1645         if (!captions.empty()) {
1646                 MenuItem item(MenuItem::Submenu, qt_("Caption"));
1647                 item.setSubmenu(captions);
1648                 add(item);
1649         }
1650 }
1651
1652
1653 void MenuDefinition::expandQuotes(BufferView const * bv)
1654 {
1655         if (!bv)
1656                 return;
1657     
1658         if (!bv->cursor().inTexted())
1659                 return;
1660
1661         Inset const * inset = bv->cursor().nextInset();
1662         if (!inset || inset->lyxCode() != QUOTE_CODE) {
1663                 add(MenuItem(MenuItem::Command,
1664                                     qt_("No Quote in Scope!"),
1665                                     FuncRequest(LFUN_NOACTION)));
1666                 return;
1667         }
1668         InsetQuotes const * qinset =
1669                 static_cast<InsetQuotes const *>(inset);
1670
1671         map<string, docstring> styles = quoteparams.getTypes();
1672         string const qtype = qinset->getType();
1673         
1674         map<string, docstring>::const_iterator qq = styles.begin();
1675         map<string, docstring>::const_iterator end = styles.end();
1676
1677         MenuDefinition aqs;
1678
1679         BufferParams const & bp = bv->buffer().masterBuffer()->params();
1680
1681         // The global setting
1682         InsetQuotesParams::QuoteStyle globalqs = bp.quotes_style;
1683         char const globalqsc = quoteparams.getStyleChar(globalqs);
1684
1685         // The current language's default
1686         InsetQuotesParams::QuoteStyle langdefqs =
1687                 bp.getQuoteStyle(bv->cursor().current_font.language()->quoteStyle());
1688         char const langqs = quoteparams.getStyleChar(langdefqs);
1689
1690         bool main_global_qs = false;
1691         bool main_langdef_qs = false;
1692         bool main_dynamic_qs = false;
1693         docstring const subcmd = from_ascii("changetype ");
1694         docstring const wildcards = from_ascii("..");
1695         // Add the items
1696         // First the top level menu (all glyphs of the current style) ...
1697         // Begin with dynamic (if they are current style),
1698         if (qtype[0] == 'x') {
1699                 FuncRequest cmd = FuncRequest(LFUN_INSET_MODIFY, subcmd + from_ascii("xld"));
1700                 docstring desc = bformat(_("%1$s (dynamic)"),
1701                         quoteparams.getShortGuiLabel(globalqsc + from_ascii("ld")));
1702                 add(MenuItem(MenuItem::Command, toqstr(desc), cmd));
1703                 cmd = FuncRequest(LFUN_INSET_MODIFY, subcmd + from_ascii("xls"));
1704                 desc = bformat(_("%1$s (dynamic)"),
1705                         quoteparams.getShortGuiLabel(globalqsc + from_ascii("ls")));
1706                 add(MenuItem(MenuItem::Command, toqstr(desc), cmd));
1707                 cmd = FuncRequest(LFUN_INSET_MODIFY, subcmd + from_ascii("xrd"));
1708                 desc = bformat(_("%1$s (dynamic)"),
1709                         quoteparams.getShortGuiLabel(globalqsc + from_ascii("rd")));
1710                 add(MenuItem(MenuItem::Command, toqstr(desc), cmd));
1711                 cmd = FuncRequest(LFUN_INSET_MODIFY, subcmd + from_ascii("xrs"));
1712                 desc = bformat(_("%1$s (dynamic)"),
1713                         quoteparams.getShortGuiLabel(globalqsc + from_ascii("rs")));
1714                 add(MenuItem(MenuItem::Command, toqstr(desc), cmd));
1715                 main_dynamic_qs = true;
1716         }
1717         // now traverse through the static styles ...
1718         for (; qq != end; ++qq) {
1719                 docstring const style = from_ascii(qq->first);
1720                 bool langdef = (style[0] == langqs);
1721                 bool globaldef = (style[0] == globalqsc);
1722                 
1723                 if (prefixIs(style, qtype[0])) {
1724                         FuncRequest cmd = FuncRequest(LFUN_INSET_MODIFY, subcmd + style);
1725                         docstring const desc = quoteparams.getShortGuiLabel(style);
1726                         add(MenuItem(MenuItem::Command, toqstr(desc), cmd));
1727                         main_global_qs = globaldef;
1728                         main_langdef_qs = langdef;
1729                 }
1730                 else if (!langdef && !globaldef && suffixIs(style, from_ascii("ld"))) {
1731                         docstring const desc =
1732                                 quoteparams.getGuiLabel(quoteparams.getQuoteStyle(to_ascii(style)));
1733                         FuncRequest cmd = FuncRequest(LFUN_INSET_MODIFY, subcmd + style[0] + "..");
1734                         aqs.add(MenuItem(MenuItem::Command, toqstr(desc), cmd));
1735                 }
1736         }
1737
1738         add(MenuItem(MenuItem::Separator));
1739
1740         bool have_section = false;
1741         bool display_static = false;
1742         // ... then potentially items to reset to the defaults and to dynamic style ...
1743         if (!main_dynamic_qs && globalqsc != 'x') {
1744                 FuncRequest cmd = FuncRequest(LFUN_INSET_MODIFY, subcmd + 'x' + wildcards);
1745                 docstring const desc = bformat(_("Use dynamic quotes (%1$s)|d"),
1746                                                 quoteparams.getGuiLabel(globalqs));
1747                 add(MenuItem(MenuItem::Command, toqstr(desc), cmd));
1748                 have_section = true;
1749                 display_static = true;
1750         }
1751         if (!main_global_qs && langdefqs != globalqs) {
1752                 docstring const variant = main_dynamic_qs ? _("dynamic[[Quotes]]") : _("static[[Quotes]]");
1753                 FuncRequest cmd = FuncRequest(LFUN_INSET_MODIFY, subcmd + globalqsc + wildcards);
1754                 docstring const desc = bformat(_("Reset to document default (%1$s, %2$s)|o"),
1755                                                 quoteparams.getGuiLabel(globalqs), variant);
1756                 add(MenuItem(MenuItem::Command, toqstr(desc), cmd));
1757                 have_section = true;
1758         }
1759         if (!main_langdef_qs) {
1760                 FuncRequest cmd = FuncRequest(LFUN_INSET_MODIFY, subcmd + globalqsc + wildcards);
1761                 docstring const desc = (main_dynamic_qs || display_static) 
1762                                         ? bformat(_("Reset to language default (%1$s, %2$s)|l"),
1763                                                   quoteparams.getGuiLabel(langdefqs), _("static[[Quotes]]"))
1764                                         : bformat(_("Reset to language default (%1$s)|l"),
1765                                                   quoteparams.getGuiLabel(langdefqs));
1766                 add(MenuItem(MenuItem::Command, toqstr(desc), cmd));
1767                 have_section = true;
1768         }
1769
1770         if (have_section)
1771                 add(MenuItem(MenuItem::Separator));
1772
1773         // ... and a subitem with the rest
1774         MenuItem item(MenuItem::Submenu, qt_("Change Style|y"));
1775         item.setSubmenu(aqs);
1776         add(item);
1777 }
1778
1779
1780 void MenuDefinition::expandEnvironmentSeparators(BufferView const * bv)
1781 {
1782         if (!bv)
1783                 return;
1784         Text const * text = bv->cursor().text();
1785         // no paragraphs and no separators exist in math
1786         if (!text)
1787                 return;
1788
1789         pit_type pit = bv->cursor().selBegin().pit();
1790         Paragraph const & par = text->getPar(pit);
1791         docstring const curlayout = par.layout().name();
1792         docstring outerlayout;
1793         depth_type current_depth = par.params().depth();
1794         // check if we have an environment in our nesting hierarchy
1795         Paragraph cpar = par;
1796         while (true) {
1797                 if (pit == 0 || cpar.params().depth() == 0)
1798                         break;
1799                 --pit;
1800                 cpar = text->getPar(pit);
1801                 if (cpar.params().depth() < current_depth
1802                     && cpar.layout().isEnvironment()) {
1803                                 outerlayout = cpar.layout().name();
1804                                 current_depth = cpar.params().depth();
1805                 }
1806         }
1807         if (par.layout().isEnvironment()) {
1808                 docstring const label =
1809                         bformat(_("Start New Environment (%1$s)"),
1810                                 translateIfPossible(curlayout));
1811                 add(MenuItem(MenuItem::Command, toqstr(label),
1812                              FuncRequest(LFUN_ENVIRONMENT_SPLIT)));
1813         }
1814         if (!outerlayout.empty()) {
1815                 docstring const label =
1816                         bformat(_("Start New Parent Environment (%1$s)"),
1817                                 translateIfPossible(outerlayout));
1818                 add(MenuItem(MenuItem::Command, toqstr(label),
1819                              FuncRequest(LFUN_ENVIRONMENT_SPLIT,
1820                                          from_ascii("outer"))));
1821         }
1822 }
1823
1824 } // namespace anon
1825
1826
1827 /////////////////////////////////////////////////////////////////////
1828 // Menu::Impl definition and implementation
1829 /////////////////////////////////////////////////////////////////////
1830
1831 struct Menu::Impl
1832 {
1833         /// populates the menu or one of its submenu
1834         /// This is used as a recursive function
1835         void populate(QMenu * qMenu, MenuDefinition const & menu);
1836
1837         /// Only needed for top level menus.
1838         MenuDefinition * top_level_menu;
1839         /// our owning view
1840         GuiView * view;
1841         /// the name of this menu
1842         QString name;
1843 };
1844
1845
1846
1847 /// Get a MenuDefinition item label from the menu backend
1848 static QString label(MenuItem const & mi)
1849 {
1850         QString label = mi.label();
1851         label.replace("&", "&&");
1852
1853         QString shortcut = mi.shortcut();
1854         if (!shortcut.isEmpty()) {
1855                 int pos = label.indexOf(shortcut);
1856                 if (pos != -1)
1857                         //label.insert(pos, 1, char_type('&'));
1858                         label.replace(pos, 0, "&");
1859         }
1860
1861         QString const binding = mi.binding();
1862         if (!binding.isEmpty())
1863                 label += '\t' + binding;
1864
1865         return label;
1866 }
1867
1868 void Menu::Impl::populate(QMenu * qMenu, MenuDefinition const & menu)
1869 {
1870         LYXERR(Debug::GUI, "populating menu " << menu.name());
1871         if (menu.empty()) {
1872                 LYXERR(Debug::GUI, "\tERROR: empty menu " << menu.name());
1873                 return;
1874         }
1875         LYXERR(Debug::GUI, " *****  menu entries " << menu.size());
1876         for (MenuItem const & m : menu)
1877                 switch (m.kind()) {
1878                 case MenuItem::Separator:
1879                         qMenu->addSeparator();
1880                         break;
1881                 case MenuItem::Submenu: {
1882                         QMenu * subMenu = qMenu->addMenu(label(m));
1883                         populate(subMenu, m.submenu());
1884                         subMenu->setEnabled(!subMenu->isEmpty());
1885                         break;
1886                 }
1887                 case MenuItem::Command:
1888                 default:
1889                         // FIXME: A previous comment assured that MenuItem::Command was the
1890                         // only possible case in practice, but this is wrong.  It would be
1891                         // good to document which cases are actually treated here.
1892                         qMenu->addAction(new Action(m.func(), QIcon(), label(m),
1893                                                     m.tooltip(), qMenu));
1894                         break;
1895                 }
1896 }
1897
1898 #if (defined(Q_OS_WIN) || defined(Q_CYGWIN_WIN)) && (QT_VERSION >= 0x040600)
1899 class AlwaysMnemonicStyle : public QProxyStyle {
1900 public:
1901         int styleHint(StyleHint hint, const QStyleOption *opt = 0, const QWidget *widget = 0,
1902                 QStyleHintReturn *returnData = 0) const
1903         {
1904                 if (hint == QStyle::SH_UnderlineShortcut)
1905                         return 1;
1906                 return QProxyStyle::styleHint(hint, opt, widget, returnData);
1907         }
1908 };
1909 #endif
1910
1911 /////////////////////////////////////////////////////////////////////
1912 // Menu implementation
1913 /////////////////////////////////////////////////////////////////////
1914
1915 Menu::Menu(GuiView * gv, QString const & name, bool top_level, bool keyboard)
1916 : QMenu(gv), d(new Menu::Impl)
1917 {
1918 #if (defined(Q_OS_WIN) || defined(Q_CYGWIN_WIN)) && (QT_VERSION >= 0x040600)
1919         if (keyboard)
1920                 setStyle(new AlwaysMnemonicStyle);
1921 #else
1922         (void) keyboard;
1923 #endif
1924         d->top_level_menu = top_level? new MenuDefinition : 0;
1925         d->view = gv;
1926         d->name = name;
1927         setTitle(name);
1928         if (d->top_level_menu)
1929                 connect(this, SIGNAL(aboutToShow()), this, SLOT(updateView()));
1930 }
1931
1932
1933 Menu::~Menu()
1934 {
1935         delete d->top_level_menu;
1936         delete d;
1937 }
1938
1939
1940 void Menu::updateView()
1941 {
1942         guiApp->menus().updateMenu(this);
1943 }
1944
1945
1946 void Menu::clear()
1947 {
1948         QList<QAction *> items = actions();
1949         for (int i = 0; i != items.size(); ++i) {
1950                 // QAction::menu() returns 0 if there's no submenu.
1951                 delete items.at(i)->menu();
1952         }
1953         QMenu::clear();
1954 }
1955
1956
1957 /////////////////////////////////////////////////////////////////////
1958 // Menus::Impl definition and implementation
1959 /////////////////////////////////////////////////////////////////////
1960
1961 struct Menus::Impl {
1962         ///
1963         bool hasMenu(QString const &) const;
1964         ///
1965         MenuDefinition & getMenu(QString const &);
1966         ///
1967         MenuDefinition const & getMenu(QString const &) const;
1968
1969         /// Expands some special entries of the menu
1970         /** The entries with the following kind are expanded to a
1971             sequence of Command MenuItems: Lastfiles, Documents,
1972             ViewFormats, ExportFormats, UpdateFormats, Branches,
1973             Indices, Arguments, SwitchArguments, Captions, SwitchCaptions,
1974             EnvironmentSeparators
1975         */
1976         void expand(MenuDefinition const & frommenu, MenuDefinition & tomenu,
1977                 BufferView const *) const;
1978
1979         /// Initialize specific MACOS X menubar
1980         void macxMenuBarInit(QMenuBar * qmb);
1981
1982         /// Mac special menu.
1983         /** This defines a menu whose entries list the FuncRequests
1984             that will be removed by expand() in other menus. This is
1985             used by the Qt/Mac code.
1986
1987             NOTE: Qt does not remove the menu items when clearing a QMenuBar,
1988             such that the items will keep accessing the FuncRequests in
1989             the MenuDefinition. While Menus::Impl might be recreated,
1990             we keep mac_special_menu_ in memory by making it static.
1991         */
1992         static MenuDefinition mac_special_menu_;
1993
1994         ///
1995         MenuList menulist_;
1996         ///
1997         MenuDefinition menubar_;
1998
1999         typedef QMap<GuiView *, QHash<QString, Menu*> > NameMap;
2000
2001         /// name to menu for \c menu() method.
2002         NameMap name_map_;
2003 };
2004
2005
2006 MenuDefinition Menus::Impl::mac_special_menu_;
2007
2008
2009 /*
2010   Here is what the Qt documentation says about how a menubar is chosen:
2011
2012      1) If the window has a QMenuBar then it is used. 2) If the window
2013      is a modal then its menubar is used. If no menubar is specified
2014      then a default menubar is used (as documented below) 3) If the
2015      window has no parent then the default menubar is used (as
2016      documented below).
2017
2018      The above 3 steps are applied all the way up the parent window
2019      chain until one of the above are satisifed. If all else fails a
2020      default menubar will be created, the default menubar on Qt/Mac is
2021      an empty menubar, however you can create a different default
2022      menubar by creating a parentless QMenuBar, the first one created
2023      will thus be designated the default menubar, and will be used
2024      whenever a default menubar is needed.
2025
2026   Thus, for Qt/Mac, we add the menus to a free standing menubar, so
2027   that this menubar will be used also when one of LyX' dialogs has
2028   focus. (JMarc)
2029 */
2030 void Menus::Impl::macxMenuBarInit(QMenuBar * qmb)
2031 {
2032         /* Since Qt 4.2, the qt/mac menu code has special code for
2033            specifying the role of a menu entry. However, it does not
2034            work very well with our scheme of creating menus on demand,
2035            and therefore we need to put these entries in a special
2036            invisible menu. (JMarc)
2037         */
2038
2039         /* The entries of our special mac menu. If we add support for
2040          * special entries in Menus, we could imagine something
2041          * like
2042          *    SpecialItem About " "About LyX" "dialog-show aboutlyx"
2043          * and therefore avoid hardcoding. I am not sure it is worth
2044          * the hassle, though. (JMarc)
2045          */
2046         struct MacMenuEntry {
2047                 FuncCode action;
2048                 char const * arg;
2049                 char const * label;
2050                 QAction::MenuRole role;
2051         };
2052
2053         static const MacMenuEntry entries[] = {
2054                 {LFUN_DIALOG_SHOW, "aboutlyx", "About LyX",
2055                  QAction::AboutRole},
2056                 {LFUN_DIALOG_SHOW, "prefs", "Preferences",
2057                  QAction::PreferencesRole},
2058 #if !(defined(QT_MAC_USE_COCOA) || (QT_VERSION >= 0x050000))
2059                 /* This doesn't work with Cocoa. */
2060                 {LFUN_RECONFIGURE, "", "Reconfigure",
2061                  QAction::ApplicationSpecificRole},
2062 #endif
2063                 {LFUN_LYX_QUIT, "", "Quit LyX", QAction::QuitRole}
2064         };
2065         const size_t num_entries = sizeof(entries) / sizeof(entries[0]);
2066         const bool first_call = mac_special_menu_.empty();
2067
2068         LYXERR(Debug::GUI, "Creating Mac OS X special menu bar");
2069         // the special menu for Menus. Fill it up only once.
2070         if (first_call) {
2071                 for (size_t i = 0 ; i < num_entries ; ++i) {
2072                         FuncRequest const func(entries[i].action,
2073                                 from_utf8(entries[i].arg));
2074                         mac_special_menu_.add(MenuItem(MenuItem::Command,
2075                                 entries[i].label, func));
2076                 }
2077         }
2078
2079         // add the entries to a QMenu that will eventually be empty
2080         // and therefore invisible.
2081         QMenu * qMenu = qmb->addMenu("special");
2082         size_t i = 0;
2083         for (MenuItem const & m : mac_special_menu_) {
2084                 Action * action = new Action(m.func(), QIcon(), m.label(),
2085                                              QString(), qMenu);
2086                 action->setMenuRole(entries[i].role);
2087                 qMenu->addAction(action);
2088                 ++i;
2089         }
2090 }
2091
2092
2093 void Menus::Impl::expand(MenuDefinition const & frommenu,
2094         MenuDefinition & tomenu, BufferView const * bv) const
2095 {
2096         if (!tomenu.empty())
2097                 tomenu.clear();
2098
2099         for (MenuDefinition::const_iterator cit = frommenu.begin();
2100              cit != frommenu.end() ; ++cit) {
2101                 Buffer const * buf = bv ? &bv->buffer() : 0;
2102                 switch (cit->kind()) {
2103                 case MenuItem::Lastfiles:
2104                         tomenu.expandLastfiles();
2105                         break;
2106
2107                 case MenuItem::Documents:
2108                         tomenu.expandDocuments();
2109                         break;
2110
2111                 case MenuItem::Bookmarks:
2112                         tomenu.expandBookmarks();
2113                         break;
2114
2115                 case MenuItem::ImportFormats:
2116                 case MenuItem::ViewFormats:
2117                 case MenuItem::UpdateFormats:
2118                 case MenuItem::ExportFormats:
2119                         tomenu.expandFormats(cit->kind(), buf);
2120                         break;
2121
2122                 case MenuItem::CharStyles:
2123                         tomenu.expandFlexInsert(buf, InsetLayout::CHARSTYLE);
2124                         break;
2125
2126                 case MenuItem::Custom:
2127                         tomenu.expandFlexInsert(buf, InsetLayout::CUSTOM);
2128                         break;
2129
2130                 case MenuItem::Elements:
2131                         tomenu.expandFlexInsert(buf, InsetLayout::ELEMENT);
2132                         break;
2133
2134                 case MenuItem::FloatListInsert:
2135                         tomenu.expandFloatListInsert(buf);
2136                         break;
2137
2138                 case MenuItem::FloatInsert:
2139                         tomenu.expandFloatInsert(buf);
2140                         break;
2141
2142                 case MenuItem::PasteRecent:
2143                         tomenu.expandPasteRecent(buf);
2144                         break;
2145
2146                 case MenuItem::Toolbars:
2147                         tomenu.expandToolbars();
2148                         break;
2149
2150                 case MenuItem::Branches:
2151                         tomenu.expandBranches(buf);
2152                         break;
2153
2154                 case MenuItem::Indices:
2155                         tomenu.expandIndices(buf);
2156                         break;
2157
2158                 case MenuItem::IndicesContext:
2159                         tomenu.expandIndicesContext(buf);
2160                         break;
2161
2162                 case MenuItem::IndicesLists:
2163                         tomenu.expandIndices(buf, true);
2164                         break;
2165
2166                 case MenuItem::IndicesListsContext:
2167                         tomenu.expandIndicesContext(buf, true);
2168                         break;
2169
2170                 case MenuItem::CiteStyles:
2171                         tomenu.expandCiteStyles(bv);
2172                         break;
2173
2174                 case MenuItem::Toc:
2175                         tomenu.expandToc(buf);
2176                         break;
2177
2178                 case MenuItem::GraphicsGroups:
2179                         tomenu.expandGraphicsGroups(bv);
2180                         break;
2181
2182                 case MenuItem::SpellingSuggestions:
2183                         tomenu.expandSpellingSuggestions(bv);
2184                         break;
2185
2186                 case MenuItem::LanguageSelector:
2187                         tomenu.expandLanguageSelector(buf);
2188                         break;
2189
2190                 case MenuItem::Arguments:
2191                         tomenu.expandArguments(bv, false);
2192                         break;
2193
2194                 case MenuItem::SwitchArguments:
2195                         tomenu.expandArguments(bv, true);
2196                         break;
2197
2198                 case MenuItem::Captions:
2199                         tomenu.expandCaptions(buf, false);
2200                         break;
2201
2202                 case MenuItem::SwitchCaptions:
2203                         tomenu.expandCaptions(buf, true);
2204                         break;
2205
2206                 case MenuItem::EnvironmentSeparators:
2207                         tomenu.expandEnvironmentSeparators(bv);
2208                         break;
2209
2210                 case MenuItem::SwitchQuotes:
2211                         tomenu.expandQuotes(bv);
2212                         break;
2213
2214                 case MenuItem::Submenu: {
2215                         MenuItem item(*cit);
2216                         item.setSubmenu(MenuDefinition(cit->submenuname()));
2217                         expand(getMenu(cit->submenuname()), item.submenu(), bv);
2218                         tomenu.addWithStatusCheck(item);
2219                 }
2220                 break;
2221
2222                 case MenuItem::Info:
2223                 case MenuItem::Help:
2224                 case MenuItem::Separator:
2225                         tomenu.addWithStatusCheck(*cit);
2226                         break;
2227
2228                 case MenuItem::Command:
2229                         if (!mac_special_menu_.hasFunc(*cit->func()))
2230                                 tomenu.addWithStatusCheck(*cit);
2231                 }
2232         }
2233
2234         // we do not want the menu to end with a separator
2235         if (!tomenu.empty() && tomenu.items_.back().kind() == MenuItem::Separator)
2236                 tomenu.items_.pop_back();
2237
2238         // Check whether the shortcuts are unique
2239         tomenu.checkShortcuts();
2240 }
2241
2242
2243 bool Menus::Impl::hasMenu(QString const & name) const
2244 {
2245         return find_if(menulist_.begin(), menulist_.end(),
2246                 MenuNamesEqual(name)) != menulist_.end();
2247 }
2248
2249
2250 MenuDefinition const & Menus::Impl::getMenu(QString const & name) const
2251 {
2252         const_iterator cit = find_if(menulist_.begin(), menulist_.end(),
2253                 MenuNamesEqual(name));
2254         if (cit == menulist_.end()) {
2255                 LYXERR0("No submenu named " << name);
2256                 LASSERT(false, { static const MenuDefinition m; return m; });
2257         }
2258         return (*cit);
2259 }
2260
2261
2262 MenuDefinition & Menus::Impl::getMenu(QString const & name)
2263 {
2264         iterator it = find_if(menulist_.begin(), menulist_.end(),
2265                 MenuNamesEqual(name));
2266         if (it == menulist_.end()) {
2267                 LYXERR0("No submenu named " << name);
2268                 LASSERT(false, { static MenuDefinition m; return m; });
2269         }
2270         return (*it);
2271 }
2272
2273
2274 /////////////////////////////////////////////////////////////////////
2275 //
2276 // Menus
2277 //
2278 /////////////////////////////////////////////////////////////////////
2279
2280 Menus::Menus() : d(new Impl) {}
2281
2282
2283 Menus::~Menus()
2284 {
2285         delete d;
2286 }
2287
2288
2289 void Menus::reset()
2290 {
2291         delete d;
2292         d = new Impl;
2293 }
2294
2295
2296 void Menus::read(Lexer & lex)
2297 {
2298         enum {
2299                 md_menu,
2300                 md_menubar,
2301                 md_endmenuset
2302         };
2303
2304         LexerKeyword menutags[] = {
2305                 { "end", md_endmenuset },
2306                 { "menu", md_menu },
2307                 { "menubar", md_menubar }
2308         };
2309
2310         // consistency check
2311         if (compare_ascii_no_case(lex.getString(), "menuset"))
2312                 LYXERR0("Menus::read: ERROR wrong token: `" << lex.getString() << '\'');
2313
2314         lex.pushTable(menutags);
2315         lex.setContext("Menus::read");
2316
2317         bool quit = false;
2318
2319         while (lex.isOK() && !quit) {
2320                 switch (lex.lex()) {
2321                 case md_menubar:
2322                         d->menubar_.read(lex);
2323                         break;
2324                 case md_menu: {
2325                         lex.next(true);
2326                         QString const name = toqstr(lex.getDocString());
2327                         if (d->hasMenu(name))
2328                                 d->getMenu(name).read(lex);
2329                         else {
2330                                 MenuDefinition menu(name);
2331                                 menu.read(lex);
2332                                 d->menulist_.push_back(menu);
2333                         }
2334                         break;
2335                 }
2336                 case md_endmenuset:
2337                         quit = true;
2338                         break;
2339                 default:
2340                         lex.printError("Unknown menu tag");
2341                         break;
2342                 }
2343         }
2344         lex.popTable();
2345 }
2346
2347
2348 bool Menus::searchMenu(FuncRequest const & func,
2349         docstring_list & names) const
2350 {
2351         MenuDefinition menu;
2352         d->expand(d->menubar_, menu, 0);
2353         return menu.searchMenu(func, names);
2354 }
2355
2356
2357 void Menus::fillMenuBar(QMenuBar * qmb, GuiView * view, bool initial)
2358 {
2359         if (initial) {
2360 #ifdef Q_OS_MAC
2361                 // setup special mac specific menu items, but only do this
2362                 // the first time a QMenuBar is created. Otherwise Qt will
2363                 // create duplicate items in the application menu. It seems
2364                 // that Qt does not remove them when the QMenubar is cleared.
2365                 d->macxMenuBarInit(qmb);
2366 #endif
2367         } else {
2368                 // Clear all menubar contents before filling it.
2369                 qmb->clear();
2370 #if (QT_VERSION >= 0x050000 && defined(Q_OS_MAC))
2371                 d->macxMenuBarInit(qmb);
2372 #endif
2373         }
2374
2375         LYXERR(Debug::GUI, "populating menu bar" << d->menubar_.name());
2376
2377         if (d->menubar_.empty()) {
2378                 LYXERR(Debug::GUI, "\tERROR: empty menu bar"
2379                         << d->menubar_.name());
2380                 return;
2381         }
2382         LYXERR(Debug::GUI, "menu bar entries " << d->menubar_.size());
2383
2384         MenuDefinition menu;
2385         BufferView * bv = 0;
2386         if (view)
2387                 bv = view->currentBufferView();
2388         d->expand(d->menubar_, menu, bv);
2389
2390         MenuDefinition::const_iterator m = menu.begin();
2391         MenuDefinition::const_iterator end = menu.end();
2392
2393         for (; m != end; ++m) {
2394
2395                 if (m->kind() != MenuItem::Submenu) {
2396                         LYXERR(Debug::GUI, "\tERROR: not a submenu " << m->label());
2397                         continue;
2398                 }
2399
2400                 LYXERR(Debug::GUI, "menu bar item " << m->label()
2401                         << " is a submenu named " << m->submenuname());
2402
2403                 QString name = m->submenuname();
2404                 if (!d->hasMenu(name)) {
2405                         LYXERR(Debug::GUI, "\tERROR: " << name
2406                                 << " submenu has no menu!");
2407                         continue;
2408                 }
2409
2410                 Menu * menu = new Menu(view, m->submenuname(), true);
2411                 menu->setTitle(label(*m));
2412
2413 #if defined(Q_OS_MAC) && (defined(QT_MAC_USE_COCOA) || (QT_VERSION >= 0x050000))
2414                 // On Mac OS with QT/cocoa, the menu is not displayed if there is no action
2415                 // so we create a temporary one here
2416                 QAction * action = new QAction(menu);
2417                 menu->addAction(action);
2418 #endif
2419
2420                 qmb->addMenu(menu);
2421
2422                 d->name_map_[view][name] = menu;
2423         }
2424 }
2425
2426
2427 void Menus::updateMenu(Menu * qmenu)
2428 {
2429         LYXERR(Debug::GUI, "Triggered menu: " << qmenu->d->name);
2430         qmenu->clear();
2431
2432         if (qmenu->d->name.isEmpty())
2433                 return;
2434
2435         docstring identifier = qstring_to_ucs4(qmenu->d->name);
2436         MenuDefinition fromLyxMenu(qmenu->d->name);
2437         while (!identifier.empty()) {
2438                 docstring menu_name;
2439                 identifier = split(identifier, menu_name, ';');
2440
2441                 if (!d->hasMenu(toqstr(menu_name))) {
2442                         LYXERR(Debug::GUI, "\tWARNING: non existing menu: "
2443                                 << menu_name);
2444                         continue;
2445                 }
2446
2447                 MenuDefinition cat_menu = d->getMenu(toqstr(menu_name));
2448                 //FIXME: 50 is a wild guess. We should take into account here
2449                 //the expansion of menu items, disabled optional items etc.
2450                 bool const in_sub_menu = !fromLyxMenu.empty()
2451                         && fromLyxMenu.size() + cat_menu.size() > 50 ;
2452                 if (in_sub_menu)
2453                         fromLyxMenu.catSub(menu_name);
2454                 else
2455                         fromLyxMenu.cat(cat_menu);
2456                 fromLyxMenu.add(MenuItem(MenuItem::Separator));
2457         }
2458
2459         if (fromLyxMenu.empty()) {
2460                 qmenu->addAction(qt_("No Action Defined!"));
2461                 return;
2462         }
2463
2464         BufferView * bv = 0;
2465         if (qmenu->d->view)
2466                 bv = qmenu->d->view->currentBufferView();
2467         d->expand(fromLyxMenu, *qmenu->d->top_level_menu, bv);
2468         qmenu->d->populate(qmenu, *qmenu->d->top_level_menu);
2469 }
2470
2471
2472 Menu * Menus::menu(QString const & name, GuiView & view, bool keyboard)
2473 {
2474         LYXERR(Debug::GUI, "Context menu requested: " << name);
2475         Menu * menu = d->name_map_[&view].value(name, 0);
2476         if (!menu && !name.startsWith("context-")) {
2477                 LYXERR0("requested context menu not found: " << name);
2478                 return 0;
2479         }
2480
2481         menu = new Menu(&view, name, true, keyboard);
2482         d->name_map_[&view][name] = menu;
2483         return menu;
2484 }
2485
2486 } // namespace frontend
2487 } // namespace lyx
2488
2489 #include "moc_Menus.cpp"