3 * This file is part of LyX, the document processor.
4 * Licence details can be found in the file COPYING.
7 * \author Asger Alstrup
8 * \author Lars Gullik Bjønnes
9 * \author Jean-Marc Lasgouttes
10 * \author André Pönitz
12 * \author Martin Vermeer
14 * Full author contact details are available in file CREDITS.
22 #include "GuiApplication.h"
24 #include "qt_helpers.h"
26 #include "BranchList.h"
28 #include "BufferList.h"
29 #include "BufferParams.h"
30 #include "Converter.h"
31 #include "CutAndPaste.h"
33 #include "FloatList.h"
35 #include "FuncRequest.h"
36 #include "FuncStatus.h"
39 #include "LyXAction.h"
40 #include "LyX.h" // for lastfiles
42 #include "Paragraph.h"
44 #include "TextClass.h"
45 #include "TocBackend.h"
46 #include "ToolbarBackend.h"
48 #include "support/assert.h"
49 #include "support/convert.h"
50 #include "support/debug.h"
51 #include "support/filetools.h"
52 #include "support/gettext.h"
53 #include "support/lstrings.h"
66 using namespace lyx::support;
74 // MacOSX specific stuff is at the end.
81 /// The type of elements that can be in a menu
89 /** This is the list of last opened file,
90 typically for the File menu. */
92 /** This is the list of opened Documents,
93 typically for the Documents menu. */
95 /** This is the bookmarks */
99 /** This is a list of viewable formats
100 typically for the File->View menu. */
102 /** This is a list of updatable formats
103 typically for the File->Update menu. */
105 /** This is a list of exportable formats
106 typically for the File->Export menu. */
108 /** This is a list of importable formats
109 typically for the File->Export menu. */
111 /** This is the list of elements available
112 * for insertion into document. */
114 /** This is the list of user-configurable
115 insets to insert into document */
117 /** This is the list of XML elements to
118 insert into the document */
120 /** This is the list of floats that we can
121 insert a list for. */
123 /** This is the list of floats that we can
126 /** This is the list of selections that can
131 /** Available branches in document */
135 explicit MenuItem(Kind kind) : kind_(kind), optional_(false) {}
138 QString const & label,
139 QString const & submenu = QString(),
140 bool optional = false)
141 : kind_(kind), label_(label), submenuname_(submenu), optional_(optional)
143 LASSERT(kind == Submenu, /**/);
147 QString const & label,
148 FuncRequest const & func,
149 bool optional = false)
150 : kind_(kind), label_(label), func_(func), optional_(optional)
152 func_.origin = FuncRequest::MENU;
155 // boost::shared_ptr<MenuDefinition> needs this apprently...
158 /// The label of a given menuitem
159 QString label() const { return label_.split('|')[0]; }
161 /// The keyboard shortcut (usually underlined in the entry)
162 QString shortcut() const
164 return label_.contains('|') ? label_.split('|')[1] : QString();
166 /// The complete label, with label and shortcut separated by a '|'
167 QString fulllabel() const { return label_;}
168 /// The kind of entry
169 Kind kind() const { return kind_; }
170 /// the action (if relevant)
171 FuncRequest const & func() const { return func_; }
172 /// returns true if the entry should be ommited when disabled
173 bool optional() const { return optional_; }
174 /// returns the status of the lfun associated with this entry
175 FuncStatus const & status() const { return status_; }
176 /// returns the status of the lfun associated with this entry
177 FuncStatus & status() { return status_; }
178 /// returns the status of the lfun associated with this entry
179 void status(FuncStatus const & status) { status_ = status; }
181 ///returns the binding associated to this action.
182 QString binding() const
184 if (kind_ != Command)
186 // Get the keys bound to this action, but keep only the
188 KeyMap::Bindings bindings = theTopLevelKeymap().findBindings(func_);
190 return toqstr(bindings.begin()->print(KeySequence::ForGui));
192 LYXERR(Debug::KBMAP, "No binding for "
193 << lyxaction.getActionName(func_.action)
194 << '(' << func_.argument() << ')');
198 /// the description of the submenu (if relevant)
199 QString const & submenuname() const { return submenuname_; }
200 /// set the description of the submenu
201 void submenuname(QString const & name) { submenuname_ = name; }
203 bool hasSubmenu() const { return submenu_.isEmpty(); }
205 MenuDefinition const & submenu() const { return submenu_.at(0); }
206 MenuDefinition & submenu() { return submenu_[0]; }
208 void setSubmenu(MenuDefinition const & menu)
211 submenu_.append(menu);
222 QString submenuname_;
227 /// contains 0 or 1 item.
228 QList<MenuDefinition> submenu_;
232 class MenuDefinition {
235 typedef std::vector<MenuItem> ItemList;
237 typedef ItemList::const_iterator const_iterator;
239 explicit MenuDefinition(QString const & name = QString()) : name_(name) {}
244 QString const & name() const { return name_; }
246 bool empty() const { return items_.empty(); }
247 /// Clear the menu content.
248 void clear() { items_.clear(); }
250 size_t size() const { return items_.size(); }
252 MenuItem const & operator[](size_t) const;
254 const_iterator begin() const { return items_.begin(); }
256 const_iterator end() const { return items_.end(); }
258 // search for func in this menu iteratively, and put menu
260 bool searchMenu(FuncRequest const & func, std::vector<docstring> & names)
263 bool hasFunc(FuncRequest const &) const;
264 /// Add the menu item unconditionally
265 void add(MenuItem const & item) { items_.push_back(item); }
266 /// Checks the associated FuncRequest status before adding the
268 void addWithStatusCheck(MenuItem const &);
269 // Check whether the menu shortcuts are unique
270 void checkShortcuts() const;
272 void expandLastfiles();
273 void expandDocuments();
274 void expandBookmarks();
275 void expandFormats(MenuItem::Kind kind, Buffer const * buf);
276 void expandFloatListInsert(Buffer const * buf);
277 void expandFloatInsert(Buffer const * buf);
278 void expandFlexInsert(Buffer const * buf, std::string s);
279 void expandToc2(Toc const & toc_list, size_t from, size_t to, int depth);
280 void expandToc(Buffer const * buf);
281 void expandPasteRecent();
282 void expandToolbars();
283 void expandBranches(Buffer const * buf);
291 /// Helper for std::find_if
295 MenuNamesEqual(QString const & name) : name_(name) {}
296 bool operator()(MenuDefinition const & menu) const { return menu.name() == name_; }
303 typedef std::vector<MenuDefinition> MenuList;
305 typedef MenuList::const_iterator const_iterator;
307 typedef MenuList::iterator iterator;
309 /////////////////////////////////////////////////////////////////////
310 // MenuDefinition implementation
311 /////////////////////////////////////////////////////////////////////
313 void MenuDefinition::addWithStatusCheck(MenuItem const & i)
317 case MenuItem::Command: {
318 FuncStatus status = lyx::getStatus(i.func());
319 if (status.unknown() || (!status.enabled() && i.optional()))
322 items_.back().status(status);
326 case MenuItem::Submenu: {
327 if (i.hasSubmenu()) {
328 bool enabled = false;
329 for (const_iterator cit = i.submenu().begin();
330 cit != i.submenu().end(); ++cit) {
331 if ((cit->kind() == MenuItem::Command
332 || cit->kind() == MenuItem::Submenu)
333 && cit->status().enabled()) {
338 if (enabled || !i.optional()) {
340 items_.back().status().enabled(enabled);
348 case MenuItem::Separator:
349 if (!items_.empty() && items_.back().kind() != MenuItem::Separator)
359 void MenuDefinition::read(Lexer & lex)
386 LexerKeyword menutags[] = {
387 { "bookmarks", md_bookmarks },
388 { "branches", md_branches },
389 { "charstyles", md_charstyles },
390 { "custom", md_custom },
391 { "documents", md_documents },
392 { "elements", md_elements },
393 { "end", md_endmenu },
394 { "exportformats", md_exportformats },
395 { "floatinsert", md_floatinsert },
396 { "floatlistinsert", md_floatlistinsert },
397 { "importformats", md_importformats },
399 { "lastfiles", md_lastfiles },
400 { "optitem", md_optitem },
401 { "optsubmenu", md_optsubmenu },
402 { "pasterecent", md_pasterecent },
403 { "separator", md_separator },
404 { "submenu", md_submenu },
406 { "toolbars", md_toolbars },
407 { "updateformats", md_updateformats },
408 { "viewformats", md_viewformats }
411 lex.pushTable(menutags);
412 lex.setContext("MenuDefinition::read: ");
415 bool optional = false;
417 while (lex.isOK() && !quit) {
421 // fallback to md_item
424 docstring const name = translateIfPossible(lex.getDocString());
426 string const command = lex.getString();
427 FuncRequest func = lyxaction.lookupFunc(command);
428 add(MenuItem(MenuItem::Command, toqstr(name), func, optional));
434 add(MenuItem(MenuItem::Separator));
438 add(MenuItem(MenuItem::Lastfiles));
442 add(MenuItem(MenuItem::CharStyles));
446 add(MenuItem(MenuItem::Custom));
450 add(MenuItem(MenuItem::Elements));
454 add(MenuItem(MenuItem::Documents));
458 add(MenuItem(MenuItem::Bookmarks));
462 add(MenuItem(MenuItem::Toc));
466 add(MenuItem(MenuItem::ViewFormats));
469 case md_updateformats:
470 add(MenuItem(MenuItem::UpdateFormats));
473 case md_exportformats:
474 add(MenuItem(MenuItem::ExportFormats));
477 case md_importformats:
478 add(MenuItem(MenuItem::ImportFormats));
481 case md_floatlistinsert:
482 add(MenuItem(MenuItem::FloatListInsert));
486 add(MenuItem(MenuItem::FloatInsert));
490 add(MenuItem(MenuItem::PasteRecent));
494 add(MenuItem(MenuItem::Toolbars));
498 add(MenuItem(MenuItem::Branches));
503 // fallback to md_submenu
506 docstring const mlabel = translateIfPossible(lex.getDocString());
508 docstring const mname = lex.getDocString();
509 add(MenuItem(MenuItem::Submenu,
510 toqstr(mlabel), toqstr(mname), optional));
520 lex.printError("Unknown menu tag");
528 MenuItem const & MenuDefinition::operator[](size_type i) const
534 bool MenuDefinition::hasFunc(FuncRequest const & func) const
536 for (const_iterator it = begin(), et = end(); it != et; ++it)
537 if (it->func() == func)
543 void MenuDefinition::checkShortcuts() const
545 // This is a quadratic algorithm, but we do not care because
546 // menus are short enough
547 for (const_iterator it1 = begin(); it1 != end(); ++it1) {
548 QString shortcut = it1->shortcut();
549 if (shortcut.isEmpty())
551 if (!it1->label().contains(shortcut))
552 lyxerr << "Menu warning: menu entry \""
553 << fromqstr(it1->label())
554 << "\" does not contain shortcut `"
555 << fromqstr(shortcut) << "'." << endl;
556 for (const_iterator it2 = begin(); it2 != it1 ; ++it2) {
557 if (!it2->shortcut().compare(shortcut, Qt::CaseInsensitive)) {
558 lyxerr << "Menu warning: menu entries "
559 << '"' << fromqstr(it1->fulllabel())
560 << "\" and \"" << fromqstr(it2->fulllabel())
561 << "\" share the same shortcut."
569 bool MenuDefinition::searchMenu(FuncRequest const & func, vector<docstring> & names) const
571 const_iterator m = begin();
572 const_iterator m_end = end();
573 for (; m != m_end; ++m) {
574 if (m->kind() == MenuItem::Command && m->func() == func) {
575 names.push_back(qstring_to_ucs4(m->label()));
578 if (m->kind() == MenuItem::Submenu) {
579 names.push_back(qstring_to_ucs4(m->label()));
580 if (!m->hasSubmenu()) {
581 LYXERR(Debug::GUI, "Warning: non existing sub menu label="
582 << fromqstr(m->label())
583 << " name=" << fromqstr(m->submenuname()));
587 if (m->submenu().searchMenu(func, names))
596 bool compareFormat(Format const * p1, Format const * p2)
602 QString limitStringLength(docstring const & str)
604 size_t const max_item_length = 45;
606 if (str.size() > max_item_length)
607 return toqstr(str.substr(0, max_item_length - 3) + "...");
613 void MenuDefinition::expandLastfiles()
615 LastFilesSection::LastFiles const & lf = LyX::cref().session().lastFiles().lastFiles();
616 LastFilesSection::LastFiles::const_iterator lfit = lf.begin();
620 for (; lfit != lf.end() && ii < 10; ++lfit, ++ii) {
621 string const file = lfit->absFilename();
622 QString const label = QString("%1. %2|%3").arg(ii)
623 .arg(toqstr(makeDisplayPath(file, 30))).arg(ii);
624 add(MenuItem(MenuItem::Command, label, FuncRequest(LFUN_FILE_OPEN, file)));
629 void MenuDefinition::expandDocuments()
631 Buffer * first = theBufferList().first();
636 // We cannot use a for loop as the buffer list cycles.
638 QString label = toqstr(b->fileName().displayName(20));
642 label = QString::number(ii) + ". " + label + '|' + QString::number(ii);
643 add(MenuItem(MenuItem::Command, label,
644 FuncRequest(LFUN_BUFFER_SWITCH, b->absFileName())));
646 b = theBufferList().next(b);
648 } while (b != first);
650 add(MenuItem(MenuItem::Command, qt_("No Documents Open!"),
651 FuncRequest(LFUN_NOACTION)));
656 void MenuDefinition::expandBookmarks()
658 lyx::BookmarksSection const & bm = LyX::cref().session().bookmarks();
660 for (size_t i = 1; i <= bm.size(); ++i) {
662 string const file = bm.bookmark(i).filename.absFilename();
663 QString const label = QString("%1. %2|%3").arg(i)
664 .arg(toqstr(makeDisplayPath(file, 20))).arg(i);
665 add(MenuItem(MenuItem::Command, label,
666 FuncRequest(LFUN_BOOKMARK_GOTO, convert<docstring>(i))));
672 void MenuDefinition::expandFormats(MenuItem::Kind kind, Buffer const * buf)
674 if (!buf && kind != MenuItem::ImportFormats) {
675 add(MenuItem(MenuItem::Command,
676 qt_("No Document Open!"),
677 FuncRequest(LFUN_NOACTION)));
681 typedef vector<Format const *> Formats;
686 case MenuItem::ImportFormats:
687 formats = theConverters().importableFormats();
688 action = LFUN_BUFFER_IMPORT;
690 case MenuItem::ViewFormats:
691 formats = buf->exportableFormats(true);
692 action = LFUN_BUFFER_VIEW;
694 case MenuItem::UpdateFormats:
695 formats = buf->exportableFormats(true);
696 action = LFUN_BUFFER_UPDATE;
699 formats = buf->exportableFormats(false);
700 action = LFUN_BUFFER_EXPORT;
702 sort(formats.begin(), formats.end(), &compareFormat);
704 Formats::const_iterator fit = formats.begin();
705 Formats::const_iterator end = formats.end();
706 for (; fit != end ; ++fit) {
709 QString label = toqstr((*fit)->prettyname());
710 QString const shortcut = toqstr((*fit)->shortcut());
713 case MenuItem::ImportFormats:
714 // FIXME: This is a hack, we should rather solve
715 // FIXME: bug 2488 instead.
716 if ((*fit)->name() == "text")
717 label = qt_("Plain Text");
718 else if ((*fit)->name() == "textparagraph")
719 label = qt_("Plain Text, Join Lines");
722 case MenuItem::ViewFormats:
723 case MenuItem::ExportFormats:
724 case MenuItem::UpdateFormats:
725 if (!(*fit)->documentFormat())
729 LASSERT(false, /**/);
732 // FIXME: if we had proper support for translating the
733 // format names defined in configure.py, there would
734 // not be a need to check whether the shortcut is
735 // correct. If we add it uncondiitonally, it would
736 // create useless warnings on bad shortcuts
737 if (!shortcut.isEmpty() && label.contains(shortcut))
738 label += '|' + shortcut;
741 addWithStatusCheck(MenuItem(MenuItem::Command, label,
742 FuncRequest(action, (*fit)->name())));
744 add(MenuItem(MenuItem::Command, label,
745 FuncRequest(action, (*fit)->name())));
750 void MenuDefinition::expandFloatListInsert(Buffer const * buf)
753 add(MenuItem(MenuItem::Command, qt_("No Document Open!"),
754 FuncRequest(LFUN_NOACTION)));
758 FloatList const & floats = buf->params().documentClass().floats();
759 FloatList::const_iterator cit = floats.begin();
760 FloatList::const_iterator end = floats.end();
761 for (; cit != end; ++cit) {
762 addWithStatusCheck(MenuItem(MenuItem::Command,
763 qt_(cit->second.listName()),
764 FuncRequest(LFUN_FLOAT_LIST,
765 cit->second.type())));
770 void MenuDefinition::expandFloatInsert(Buffer const * buf)
773 add(MenuItem(MenuItem::Command, qt_("No Document Open!"),
774 FuncRequest(LFUN_NOACTION)));
778 FloatList const & floats = buf->params().documentClass().floats();
779 FloatList::const_iterator cit = floats.begin();
780 FloatList::const_iterator end = floats.end();
781 for (; cit != end; ++cit) {
783 QString const label = qt_(cit->second.name());
784 addWithStatusCheck(MenuItem(MenuItem::Command, label,
785 FuncRequest(LFUN_FLOAT_INSERT,
786 cit->second.type())));
791 void MenuDefinition::expandFlexInsert(Buffer const * buf, string s)
794 add(MenuItem(MenuItem::Command, qt_("No Document Open!"),
795 FuncRequest(LFUN_NOACTION)));
798 TextClass::InsetLayouts const & insetLayouts =
799 buf->params().documentClass().insetLayouts();
800 TextClass::InsetLayouts::const_iterator cit = insetLayouts.begin();
801 TextClass::InsetLayouts::const_iterator end = insetLayouts.end();
802 for (; cit != end; ++cit) {
803 docstring const label = cit->first;
804 if (cit->second.lyxtype() == s)
805 addWithStatusCheck(MenuItem(MenuItem::Command,
806 toqstr(label), FuncRequest(LFUN_FLEX_INSERT,
812 size_t const max_number_of_items = 25;
814 void MenuDefinition::expandToc2(Toc const & toc_list,
815 size_t from, size_t to, int depth)
817 int shortcut_count = 0;
819 // check whether depth is smaller than the smallest depth in toc.
820 int min_depth = 1000;
821 for (size_t i = from; i < to; ++i)
822 min_depth = min(min_depth, toc_list[i].depth());
823 if (min_depth > depth)
826 if (to - from <= max_number_of_items) {
827 for (size_t i = from; i < to; ++i) {
828 QString label(4 * max(0, toc_list[i].depth() - depth), ' ');
829 label += limitStringLength(toc_list[i].str());
830 if (toc_list[i].depth() == depth
831 && shortcut_count < 9) {
832 if (label.contains(QString::number(shortcut_count + 1)))
833 label += '|' + QString::number(++shortcut_count);
835 add(MenuItem(MenuItem::Command, label,
836 FuncRequest(toc_list[i].action())));
841 size_t new_pos = pos + 1;
842 while (new_pos < to && toc_list[new_pos].depth() > depth)
845 QString label(4 * max(0, toc_list[pos].depth() - depth), ' ');
846 label += limitStringLength(toc_list[pos].str());
847 if (toc_list[pos].depth() == depth &&
848 shortcut_count < 9) {
849 if (label.contains(QString::number(shortcut_count + 1)))
850 label += '|' + QString::number(++shortcut_count);
852 if (new_pos == pos + 1) {
853 add(MenuItem(MenuItem::Command,
854 label, FuncRequest(toc_list[pos].action())));
857 sub.expandToc2(toc_list, pos, new_pos, depth + 1);
858 MenuItem item(MenuItem::Submenu, label);
859 item.setSubmenu(sub);
868 void MenuDefinition::expandToc(Buffer const * buf)
870 // To make things very cleanly, we would have to pass buf to
871 // all MenuItem constructors and to expandToc2. However, we
872 // know that all the entries in a TOC will be have status_ ==
873 // OK, so we avoid this unnecessary overhead (JMarc)
876 add(MenuItem(MenuItem::Command, qt_("No Document Open!"),
877 FuncRequest(LFUN_NOACTION)));
881 Buffer* cbuf = const_cast<Buffer*>(buf);
882 cbuf->tocBackend().update();
883 cbuf->structureChanged();
885 // Add an entry for the master doc if this is a child doc
886 Buffer const * const master = buf->masterBuffer();
888 ParIterator const pit = par_iterator_begin(master->inset());
889 string const arg = convert<string>(pit->id());
890 FuncRequest f(LFUN_PARAGRAPH_GOTO, arg);
891 add(MenuItem(MenuItem::Command, qt_("Master Document"), f));
894 MenuDefinition other_lists;
896 FloatList const & floatlist = buf->params().documentClass().floats();
897 TocList const & toc_list = buf->tocBackend().tocs();
898 TocList::const_iterator cit = toc_list.begin();
899 TocList::const_iterator end = toc_list.end();
900 for (; cit != end; ++cit) {
902 if (cit->first == "tableofcontents")
905 string const & floatName = floatlist.getType(cit->first).listName();
907 bool in_other_list = true;
908 if (!floatName.empty()) {
909 label = qt_(floatName);
910 in_other_list = false;
912 else if (cit->first == "child") {
913 label = qt_("Child Documents");
914 in_other_list = false;
915 } else if (cit->first == "embedded")
916 label = qt_("Embedded Files");
917 else if (cit->first == "graphics")
918 label = qt_("List of Graphics");
919 else if (cit->first == "equation")
920 label = qt_("List of Equations");
921 else if (cit->first == "index")
922 label = qt_("List of Indexes");
923 else if (cit->first == "listing") {
924 // FIXME: the listing navigate menu causes a crash for unknown
925 // reason. See http://bugzilla.lyx.org/show_bug.cgi?id=4613
926 // This is a temporary fix:
927 //label = qt_("List of Listings");
930 else if (cit->first == "marginalnote")
931 label = qt_("List of Marginal notes");
932 else if (cit->first == "note")
933 label = qt_("List of Notes");
934 else if (cit->first == "footnote")
935 label = qt_("List of Foot notes");
936 else if (cit->first == "label")
937 label = qt_("Labels and References");
938 else if (cit->first == "citation")
939 label = qt_("List of Citations");
941 // This should not happen unless the entry is missing above.
942 label = qt_("Other floats: ") + toqstr(cit->first);
944 MenuDefinition submenu;
946 if (cit->second.size() >= 30) {
947 FuncRequest f(LFUN_DIALOG_SHOW, "toc " + cit->first);
948 submenu.add(MenuItem(MenuItem::Command, qt_("Open Navigator..."), f));
950 TocIterator ccit = cit->second.begin();
951 TocIterator eend = cit->second.end();
952 for (; ccit != eend; ++ccit) {
953 QString const label = limitStringLength(ccit->str());
954 submenu.add(MenuItem(MenuItem::Command, label,
955 FuncRequest(ccit->action())));
959 MenuItem item(MenuItem::Submenu, label);
960 item.setSubmenu(submenu);
962 other_lists.add(item);
964 item.setSubmenu(submenu);
968 if (!other_lists.empty()) {
969 MenuItem item(MenuItem::Submenu, qt_("Other Lists"));
970 item.setSubmenu(other_lists);
976 cit = toc_list.find("tableofcontents");
978 addWithStatusCheck(MenuItem(MenuItem::Command,
979 qt_("No Table of contents"),
982 expandToc2(cit->second, 0, cit->second.size(), 0);
987 void MenuDefinition::expandPasteRecent()
989 vector<docstring> const sel = cap::availableSelections();
991 vector<docstring>::const_iterator cit = sel.begin();
992 vector<docstring>::const_iterator end = sel.end();
994 for (unsigned int index = 0; cit != end; ++cit, ++index) {
995 add(MenuItem(MenuItem::Command, toqstr(*cit),
996 FuncRequest(LFUN_PASTE, convert<string>(index))));
1001 void MenuDefinition::expandToolbars()
1004 // extracts the toolbars from the backend
1005 ToolbarBackend::Toolbars::const_iterator cit = toolbarbackend.begin();
1006 ToolbarBackend::Toolbars::const_iterator end = toolbarbackend.end();
1008 for (; cit != end; ++cit) {
1009 QString label = qt_(cit->gui_name);
1010 // frontends are not supposed to turn on/off toolbars,
1011 // if they cannot update ToolbarBackend::flags. That
1012 // is to say, ToolbarsBackend::flags should reflect
1013 // the true state of toolbars.
1015 // menu is displayed as
1019 // in the case of auto.
1020 if (cit->flags & ToolbarInfo::AUTO)
1021 label += qt_(" (auto)");
1022 add(MenuItem(MenuItem::Command, label,
1023 FuncRequest(LFUN_TOOLBAR_TOGGLE, cit->name + " allowauto")));
1028 void MenuDefinition::expandBranches(Buffer const * buf)
1031 add(MenuItem(MenuItem::Command,
1032 qt_("No Document Open!"),
1033 FuncRequest(LFUN_NOACTION)));
1037 BufferParams const & params = buf->masterBuffer()->params();
1038 if (params.branchlist().empty()) {
1039 add(MenuItem(MenuItem::Command,
1040 qt_("No Branch in Document!"),
1041 FuncRequest(LFUN_NOACTION)));
1045 BranchList::const_iterator cit = params.branchlist().begin();
1046 BranchList::const_iterator end = params.branchlist().end();
1048 for (int ii = 1; cit != end; ++cit, ++ii) {
1049 docstring label = cit->getBranch();
1051 label = convert<docstring>(ii) + ". " + label + char_type('|') + convert<docstring>(ii);
1052 addWithStatusCheck(MenuItem(MenuItem::Command, toqstr(label),
1053 FuncRequest(LFUN_BRANCH_INSERT,
1054 cit->getBranch())));
1061 /////////////////////////////////////////////////////////////////////
1062 // Menu::Impl definition and implementation
1063 /////////////////////////////////////////////////////////////////////
1067 /// populates the menu or one of its submenu
1068 /// This is used as a recursive function
1069 void populate(QMenu & qMenu, MenuDefinition const & menu);
1071 /// Only needed for top level menus.
1072 MenuDefinition * top_level_menu;
1075 /// the name of this menu
1081 /// Get a MenuDefinition item label from the menu backend
1082 static QString label(MenuItem const & mi)
1084 QString label = mi.label();
1085 label.replace("&", "&&");
1087 QString shortcut = mi.shortcut();
1088 if (!shortcut.isEmpty()) {
1089 int pos = label.indexOf(shortcut);
1091 //label.insert(pos, 1, char_type('&'));
1092 label.replace(pos, 0, "&");
1095 QString const binding = mi.binding();
1096 if (!binding.isEmpty())
1097 label += '\t' + binding;
1102 void Menu::Impl::populate(QMenu & qMenu, MenuDefinition const & menu)
1104 LYXERR(Debug::GUI, "populating menu " << fromqstr(menu.name()));
1105 if (menu.size() == 0) {
1106 LYXERR(Debug::GUI, "\tERROR: empty menu " << fromqstr(menu.name()));
1109 LYXERR(Debug::GUI, " ***** menu entries " << menu.size());
1110 MenuDefinition::const_iterator m = menu.begin();
1111 MenuDefinition::const_iterator end = menu.end();
1112 for (; m != end; ++m) {
1113 if (m->kind() == MenuItem::Separator)
1114 qMenu.addSeparator();
1115 else if (m->kind() == MenuItem::Submenu) {
1116 QMenu * subMenu = qMenu.addMenu(label(*m));
1117 populate(*subMenu, m->submenu());
1119 // we have a MenuItem::Command
1120 qMenu.addAction(new Action(view, QIcon(), label(*m),
1121 m->func(), QString(), &qMenu));
1126 /////////////////////////////////////////////////////////////////////
1127 // Menu implementation
1128 /////////////////////////////////////////////////////////////////////
1130 Menu::Menu(GuiView * gv, QString const & name, bool top_level)
1133 d->top_level_menu = top_level? new MenuDefinition : 0;
1137 if (d->top_level_menu)
1138 connect(this, SIGNAL(aboutToShow()), this, SLOT(updateView()));
1144 delete d->top_level_menu;
1149 void Menu::updateView()
1151 guiApp->menus().updateMenu(this);
1155 /////////////////////////////////////////////////////////////////////
1156 // Menus::Impl definition and implementation
1157 /////////////////////////////////////////////////////////////////////
1159 struct Menus::Impl {
1161 bool hasMenu(QString const &) const;
1163 MenuDefinition & getMenu(QString const &);
1165 MenuDefinition const & getMenu(QString const &) const;
1167 /// Expands some special entries of the menu
1168 /** The entries with the following kind are expanded to a
1169 sequence of Command MenuItems: Lastfiles, Documents,
1170 ViewFormats, ExportFormats, UpdateFormats, Branches
1172 void expand(MenuDefinition const & frommenu, MenuDefinition & tomenu,
1173 Buffer const *) const;
1175 /// Initialize specific MACOS X menubar
1176 void macxMenuBarInit(GuiView * view, QMenuBar * qmb);
1178 /// Mac special menu.
1179 /** This defines a menu whose entries list the FuncRequests
1180 that will be removed by expand() in other menus. This is
1181 used by the Qt/Mac code
1183 MenuDefinition specialmenu_;
1188 MenuDefinition menubar_;
1190 typedef QMap<GuiView *, QHash<QString, Menu *> > NameMap;
1192 /// name to menu for \c menu() method.
1197 Here is what the Qt documentation says about how a menubar is chosen:
1199 1) If the window has a QMenuBar then it is used. 2) If the window
1200 is a modal then its menubar is used. If no menubar is specified
1201 then a default menubar is used (as documented below) 3) If the
1202 window has no parent then the default menubar is used (as
1205 The above 3 steps are applied all the way up the parent window
1206 chain until one of the above are satisifed. If all else fails a
1207 default menubar will be created, the default menubar on Qt/Mac is
1208 an empty menubar, however you can create a different default
1209 menubar by creating a parentless QMenuBar, the first one created
1210 will thus be designated the default menubar, and will be used
1211 whenever a default menubar is needed.
1213 Thus, for Qt/Mac, we add the menus to a free standing menubar, so
1214 that this menubar will be used also when one of LyX' dialogs has
1217 void Menus::Impl::macxMenuBarInit(GuiView * view, QMenuBar * qmb)
1219 /* Since Qt 4.2, the qt/mac menu code has special code for
1220 specifying the role of a menu entry. However, it does not
1221 work very well with our scheme of creating menus on demand,
1222 and therefore we need to put these entries in a special
1223 invisible menu. (JMarc)
1226 /* The entries of our special mac menu. If we add support for
1227 * special entries in Menus, we could imagine something
1229 * SpecialItem About " "About LyX" "dialog-show aboutlyx"
1230 * and therefore avoid hardcoding. I am not sure it is worth
1231 * the hassle, though. (JMarc)
1233 struct MacMenuEntry {
1237 QAction::MenuRole role;
1240 MacMenuEntry entries[] = {
1241 {LFUN_DIALOG_SHOW, "aboutlyx", "About LyX",
1242 QAction::AboutRole},
1243 {LFUN_DIALOG_SHOW, "prefs", "Preferences",
1244 QAction::PreferencesRole},
1245 {LFUN_RECONFIGURE, "", "Reconfigure",
1246 QAction::ApplicationSpecificRole},
1247 {LFUN_LYX_QUIT, "", "Quit LyX", QAction::QuitRole}
1249 const size_t num_entries = sizeof(entries) / sizeof(entries[0]);
1251 // the special menu for Menus. Fill it up only once.
1252 if (specialmenu_.size() == 0) {
1253 for (size_t i = 0 ; i < num_entries ; ++i) {
1254 FuncRequest const func(entries[i].action,
1255 from_utf8(entries[i].arg));
1256 specialmenu_.add(MenuItem(MenuItem::Command,
1257 entries[i].label, func));
1261 // add the entries to a QMenu that will eventually be empty
1262 // and therefore invisible.
1263 QMenu * qMenu = qmb->addMenu("special");
1264 MenuDefinition::const_iterator cit = specialmenu_.begin();
1265 MenuDefinition::const_iterator end = specialmenu_.end();
1266 for (size_t i = 0 ; cit != end ; ++cit, ++i) {
1267 Action * action = new Action(view, QIcon(), cit->label(),
1268 cit->func(), QString(), qMenu);
1269 action->setMenuRole(entries[i].role);
1270 qMenu->addAction(action);
1275 void Menus::Impl::expand(MenuDefinition const & frommenu,
1276 MenuDefinition & tomenu, Buffer const * buf) const
1278 if (!tomenu.empty())
1281 for (MenuDefinition::const_iterator cit = frommenu.begin();
1282 cit != frommenu.end() ; ++cit) {
1283 switch (cit->kind()) {
1284 case MenuItem::Lastfiles:
1285 tomenu.expandLastfiles();
1288 case MenuItem::Documents:
1289 tomenu.expandDocuments();
1292 case MenuItem::Bookmarks:
1293 tomenu.expandBookmarks();
1296 case MenuItem::ImportFormats:
1297 case MenuItem::ViewFormats:
1298 case MenuItem::UpdateFormats:
1299 case MenuItem::ExportFormats:
1300 tomenu.expandFormats(cit->kind(), buf);
1303 case MenuItem::CharStyles:
1304 tomenu.expandFlexInsert(buf, "charstyle");
1307 case MenuItem::Custom:
1308 tomenu.expandFlexInsert(buf, "custom");
1311 case MenuItem::Elements:
1312 tomenu.expandFlexInsert(buf, "element");
1315 case MenuItem::FloatListInsert:
1316 tomenu.expandFloatListInsert(buf);
1319 case MenuItem::FloatInsert:
1320 tomenu.expandFloatInsert(buf);
1323 case MenuItem::PasteRecent:
1324 tomenu.expandPasteRecent();
1327 case MenuItem::Toolbars:
1328 tomenu.expandToolbars();
1331 case MenuItem::Branches:
1332 tomenu.expandBranches(buf);
1336 tomenu.expandToc(buf);
1339 case MenuItem::Submenu: {
1340 MenuItem item(*cit);
1341 item.setSubmenu(MenuDefinition(cit->submenuname()));
1342 expand(getMenu(cit->submenuname()), item.submenu(), buf);
1343 tomenu.addWithStatusCheck(item);
1347 case MenuItem::Separator:
1348 tomenu.addWithStatusCheck(*cit);
1351 case MenuItem::Command:
1352 if (!specialmenu_.hasFunc(cit->func()))
1353 tomenu.addWithStatusCheck(*cit);
1357 // we do not want the menu to end with a separator
1358 if (!tomenu.empty() && tomenu.items_.back().kind() == MenuItem::Separator)
1359 tomenu.items_.pop_back();
1361 // Check whether the shortcuts are unique
1362 tomenu.checkShortcuts();
1366 bool Menus::Impl::hasMenu(QString const & name) const
1368 return find_if(menulist_.begin(), menulist_.end(),
1369 MenuNamesEqual(name)) != menulist_.end();
1373 MenuDefinition const & Menus::Impl::getMenu(QString const & name) const
1375 const_iterator cit = find_if(menulist_.begin(), menulist_.end(),
1376 MenuNamesEqual(name));
1377 if (cit == menulist_.end())
1378 lyxerr << "No submenu named " << fromqstr(name) << endl;
1379 LASSERT(cit != menulist_.end(), /**/);
1384 MenuDefinition & Menus::Impl::getMenu(QString const & name)
1386 iterator it = find_if(menulist_.begin(), menulist_.end(),
1387 MenuNamesEqual(name));
1388 if (it == menulist_.end())
1389 lyxerr << "No submenu named " << fromqstr(name) << endl;
1390 LASSERT(it != menulist_.end(), /**/);
1395 /////////////////////////////////////////////////////////////////////
1399 /////////////////////////////////////////////////////////////////////
1401 Menus::Menus() : d(new Impl) {}
1404 void Menus::read(Lexer & lex)
1412 LexerKeyword menutags[] = {
1413 { "end", md_endmenuset },
1414 { "menu", md_menu },
1415 { "menubar", md_menubar }
1418 // consistency check
1419 if (compare_ascii_no_case(lex.getString(), "menuset"))
1420 LYXERR0("Menus::read: ERROR wrong token: `" << lex.getString() << '\'');
1422 lex.pushTable(menutags);
1423 lex.setContext("Menus::read");
1427 while (lex.isOK() && !quit) {
1428 switch (lex.lex()) {
1430 d->menubar_.read(lex);
1434 QString const name = toqstr(lex.getDocString());
1435 if (d->hasMenu(name))
1436 d->getMenu(name).read(lex);
1438 MenuDefinition menu(name);
1440 d->menulist_.push_back(menu);
1448 lex.printError("Unknown menu tag");
1456 bool Menus::searchMenu(FuncRequest const & func,
1457 vector<docstring> & names) const
1459 MenuDefinition menu;
1460 d->expand(d->menubar_, menu, 0);
1461 return menu.searchMenu(func, names);
1465 void Menus::fillMenuBar(QMenuBar * qmb, GuiView * view, bool initial)
1469 // setup special mac specific menu item
1470 d->macxMenuBarInit(view, qmb);
1473 // Clear all menubar contents before filling it.
1477 LYXERR(Debug::GUI, "populating menu bar" << fromqstr(d->menubar_.name()));
1479 if (d->menubar_.size() == 0) {
1480 LYXERR(Debug::GUI, "\tERROR: empty menu bar"
1481 << fromqstr(d->menubar_.name()));
1484 LYXERR(Debug::GUI, "menu bar entries " << d->menubar_.size());
1486 MenuDefinition menu;
1489 buf = view->buffer();
1490 d->expand(d->menubar_, menu, buf);
1492 MenuDefinition::const_iterator m = menu.begin();
1493 MenuDefinition::const_iterator end = menu.end();
1495 for (; m != end; ++m) {
1497 if (m->kind() != MenuItem::Submenu) {
1498 LYXERR(Debug::GUI, "\tERROR: not a submenu " << fromqstr(m->label()));
1502 LYXERR(Debug::GUI, "menu bar item " << fromqstr(m->label())
1503 << " is a submenu named " << fromqstr(m->submenuname()));
1505 QString name = m->submenuname();
1506 if (!d->hasMenu(name)) {
1507 LYXERR(Debug::GUI, "\tERROR: " << fromqstr(name)
1508 << " submenu has no menu!");
1512 Menu * menu = new Menu(view, m->submenuname(), true);
1513 menu->setTitle(label(*m));
1516 d->name_map_[view][name] = menu;
1521 void Menus::updateMenu(Menu * qmenu)
1523 LYXERR(Debug::GUI, "Triggered menu: " << fromqstr(qmenu->d->name));
1526 if (qmenu->d->name.isEmpty())
1529 // Here, We make sure that theLyXFunc points to the correct LyXView.
1530 theLyXFunc().setLyXView(qmenu->d->view);
1532 if (!d->hasMenu(qmenu->d->name)) {
1533 qmenu->addAction(qt_("No action defined!"));
1534 LYXERR(Debug::GUI, "\tWARNING: non existing menu: "
1535 << fromqstr(qmenu->d->name));
1539 MenuDefinition const & fromLyxMenu = d->getMenu(qmenu->d->name);
1542 buf = qmenu->d->view->buffer();
1543 d->expand(fromLyxMenu, *qmenu->d->top_level_menu, buf);
1544 qmenu->d->populate(*qmenu, *qmenu->d->top_level_menu);
1548 Menu * Menus::menu(QString const & name, GuiView & view)
1550 LYXERR(Debug::GUI, "Context menu requested: " << fromqstr(name));
1551 Menu * menu = d->name_map_[&view].value(name, 0);
1552 if (!menu && !name.startsWith("context-")) {
1553 LYXERR0("requested context menu not found: " << fromqstr(name));
1557 menu = new Menu(&view, name, true);
1558 d->name_map_[&view][name] = menu;
1562 } // namespace frontend
1565 #include "Menus_moc.cpp"