3 * This file is part of LyX, the document processor.
4 * Licence details can be found in the file COPYING.
6 * \author Asger Alstrup
7 * \author Lars Gullik Bjønnes
8 * \author Jean-Marc Lasgouttes
11 * \author Martin Vermeer
13 * Full author contact details are available in file CREDITS.
18 #include "MenuBackend.h"
20 #include "BranchList.h"
22 #include "bufferlist.h"
23 #include "bufferparams.h"
24 #include "CutAndPaste.h"
28 #include "FloatList.h"
34 #include "LyXAction.h"
35 #include "lyx_main.h" // for lastfiles
39 #include "ToolbarBackend.h"
41 #include "support/filetools.h"
42 #include "support/lstrings.h"
43 #include "support/convert.h"
45 #include <boost/bind.hpp>
52 using support::compare_no_case;
53 using support::compare_ascii_no_case;
54 using support::contains;
55 using support::makeDisplayPath;
72 class MenuNamesEqual : public std::unary_function<Menu, bool> {
74 MenuNamesEqual(docstring const & name)
76 bool operator()(Menu const & menu) const
78 return menu.name() == name_;
87 // This is the global menu definition
88 MenuBackend menubackend;
91 MenuItem::MenuItem(Kind kind)
92 : kind_(kind), optional_(false)
96 MenuItem::MenuItem(Kind kind, docstring const & label,
97 docstring const & submenu, bool optional)
98 : kind_(kind), label_(label),
99 submenuname_(submenu), optional_(optional)
101 BOOST_ASSERT(kind == Submenu);
105 MenuItem::MenuItem(Kind kind, docstring const & label,
106 FuncRequest const & func, bool optional)
107 : kind_(kind), label_(label), func_(func), optional_(optional)
109 func_.origin = FuncRequest::UI;
113 MenuItem::~MenuItem()
117 void MenuItem::submenu(Menu * menu)
119 submenu_.reset(menu);
123 docstring const MenuItem::label() const
125 return token(label_, char_type('|'), 0);
129 docstring const MenuItem::shortcut() const
131 return token(label_, char_type('|'), 1);
135 docstring const MenuItem::binding() const
137 if (kind_ != Command)
140 // Get the keys bound to this action, but keep only the
142 kb_keymap::Bindings bindings = theTopLevelKeymap().findbindings(func_);
144 if (bindings.size()) {
145 return from_utf8(bindings.begin()->print());
149 << lyxaction.getActionName(func_.action)
150 << '(' << to_utf8(func_.argument()) << ')' << endl;
157 Menu & Menu::add(MenuItem const & i)
164 Menu & Menu::addWithStatusCheck(MenuItem const & i)
168 case MenuItem::Command: {
169 FuncStatus status = lyx::getStatus(i.func());
170 if (status.unknown() || (!status.enabled() && i.optional()))
173 items_.back().status(status);
177 case MenuItem::Submenu: {
179 bool enabled = false;
180 for (const_iterator cit = i.submenu()->begin();
181 cit != i.submenu()->end(); ++cit) {
182 if ((cit->kind() == MenuItem::Command
183 || cit->kind() == MenuItem::Submenu)
184 && cit->status().enabled()) {
189 if (enabled || !i.optional()) {
191 items_.back().status().enabled(enabled);
199 case MenuItem::Separator:
201 && items_.back().kind() != MenuItem::Separator)
213 Menu & Menu::read(LyXLex & lex)
239 struct keyword_item menutags[md_last - 1] = {
240 { "branches", md_branches },
241 { "charstyles", md_charstyles },
242 { "documents", md_documents },
243 { "bookmarks", md_bookmarks },
244 { "end", md_endmenu },
245 { "exportformats", md_exportformats },
246 { "floatinsert", md_floatinsert },
247 { "floatlistinsert", md_floatlistinsert },
248 { "importformats", md_importformats },
250 { "lastfiles", md_lastfiles },
251 { "optitem", md_optitem },
252 { "optsubmenu", md_optsubmenu },
253 { "pasterecent", md_pasterecent },
254 { "separator", md_separator },
255 { "submenu", md_submenu },
257 { "updateformats", md_updateformats },
258 { "toolbars", md_toolbars },
259 { "viewformats", md_viewformats }
262 lex.pushTable(menutags, md_last - 1);
263 if (lyxerr.debugging(Debug::PARSER))
264 lex.printTable(lyxerr);
267 bool optional = false;
269 while (lex.isOK() && !quit) {
273 // fallback to md_item
276 docstring const name = _(lex.getString());
278 string const command = lex.getString();
279 FuncRequest func = lyxaction.lookupFunc(command);
280 add(MenuItem(MenuItem::Command, name, func, optional));
286 add(MenuItem(MenuItem::Separator));
290 add(MenuItem(MenuItem::Lastfiles));
294 add(MenuItem(MenuItem::CharStyles));
298 add(MenuItem(MenuItem::Documents));
302 add(MenuItem(MenuItem::Bookmarks));
306 add(MenuItem(MenuItem::Toc));
310 add(MenuItem(MenuItem::ViewFormats));
313 case md_updateformats:
314 add(MenuItem(MenuItem::UpdateFormats));
317 case md_exportformats:
318 add(MenuItem(MenuItem::ExportFormats));
321 case md_importformats:
322 add(MenuItem(MenuItem::ImportFormats));
325 case md_floatlistinsert:
326 add(MenuItem(MenuItem::FloatListInsert));
330 add(MenuItem(MenuItem::FloatInsert));
334 add(MenuItem(MenuItem::PasteRecent));
338 add(MenuItem(MenuItem::Toolbars));
342 add(MenuItem(MenuItem::Branches));
347 // fallback to md_submenu
350 docstring const mlabel = _(lex.getString());
352 docstring const mname = from_utf8(lex.getString());
353 add(MenuItem(MenuItem::Submenu, mlabel, mname,
364 lex.printError("Menu::read: "
365 "Unknown menu tag: `$$Token'");
374 MenuItem const & Menu::operator[](size_type i) const
380 bool Menu::hasFunc(FuncRequest const & func) const
382 return find_if(begin(), end(),
383 bind(std::equal_to<FuncRequest>(),
384 bind(&MenuItem::func, _1),
388 void Menu::checkShortcuts() const
390 // This is a quadratic algorithm, but we do not care because
391 // menus are short enough
392 for (const_iterator it1 = begin(); it1 != end(); ++it1) {
393 docstring shortcut = it1->shortcut();
394 if (shortcut.empty())
396 if (!contains(it1->label(), shortcut))
397 lyxerr << "Menu warning: menu entry \""
398 << to_utf8(it1->label())
399 << "\" does not contain shortcut `"
400 << to_utf8(shortcut) << "'." << endl;
401 for (const_iterator it2 = begin(); it2 != it1 ; ++it2) {
402 if (!compare_no_case(it2->shortcut(), shortcut)) {
403 lyxerr << "Menu warning: menu entries "
404 << '"' << to_utf8(it1->fulllabel())
405 << "\" and \"" << to_utf8(it2->fulllabel())
406 << "\" share the same shortcut."
414 void MenuBackend::specialMenu(docstring const &name)
417 specialmenu_ = &getMenu(name);
423 class compare_format {
425 bool operator()(Format const * p1, Format const * p2) {
430 docstring const limit_string_length(docstring const & str)
432 docstring::size_type const max_item_length = 45;
434 if (str.size() > max_item_length)
435 return str.substr(0, max_item_length - 3) + "...";
441 void expandLastfiles(Menu & tomenu)
443 lyx::LastFilesSection::LastFiles const & lf = LyX::cref().session().lastFiles().lastFiles();
444 lyx::LastFilesSection::LastFiles::const_iterator lfit = lf.begin();
448 for (; lfit != lf.end() && ii < 10; ++lfit, ++ii) {
449 docstring const label = convert<docstring>(ii) + ". "
450 + makeDisplayPath((*lfit), 30)
451 + char_type('|') + convert<docstring>(ii);
452 tomenu.add(MenuItem(MenuItem::Command, label, FuncRequest(LFUN_FILE_OPEN, (*lfit))));
457 void expandDocuments(Menu & tomenu)
459 typedef vector<string> Strings;
460 Strings const names = theBufferList().getFileNames();
463 tomenu.add(MenuItem(MenuItem::Command, _("No Documents Open!"),
464 FuncRequest(LFUN_NOACTION)));
469 Strings::const_iterator docit = names.begin();
470 Strings::const_iterator end = names.end();
471 for (; docit != end; ++docit, ++ii) {
472 docstring label = makeDisplayPath(*docit, 20);
474 label = convert<docstring>(ii) + ". " + label + char_type('|') + convert<docstring>(ii);
475 tomenu.add(MenuItem(MenuItem::Command, label, FuncRequest(LFUN_BUFFER_SWITCH, *docit)));
480 void expandBookmarks(Menu & tomenu)
482 lyx::BookmarksSection const & bm = LyX::cref().session().bookmarks();
484 for (size_t i = 1; i <= bm.size(); ++i) {
486 docstring const label = convert<docstring>(i) + ". "
487 + makeDisplayPath(bm.bookmark(i).filename, 20)
488 + char_type('|') + convert<docstring>(i);
489 tomenu.add(MenuItem(MenuItem::Command, label, FuncRequest(LFUN_BOOKMARK_GOTO,
490 convert<docstring>(i))));
496 void expandFormats(MenuItem::Kind kind, Menu & tomenu, Buffer const * buf)
498 if (!buf && kind != MenuItem::ImportFormats) {
499 tomenu.add(MenuItem(MenuItem::Command,
500 _("No Documents Open!"),
501 FuncRequest(LFUN_NOACTION)));
505 typedef vector<Format const *> Formats;
510 case MenuItem::ImportFormats:
511 formats = Importer::GetImportableFormats();
512 action = LFUN_BUFFER_IMPORT;
514 case MenuItem::ViewFormats:
515 formats = Exporter::getExportableFormats(*buf, true);
516 action = LFUN_BUFFER_VIEW;
518 case MenuItem::UpdateFormats:
519 formats = Exporter::getExportableFormats(*buf, true);
520 action = LFUN_BUFFER_UPDATE;
523 formats = Exporter::getExportableFormats(*buf, false);
524 action = LFUN_BUFFER_EXPORT;
526 sort(formats.begin(), formats.end(), compare_format());
528 Formats::const_iterator fit = formats.begin();
529 Formats::const_iterator end = formats.end();
530 for (; fit != end ; ++fit) {
533 docstring label = from_utf8((*fit)->prettyname());
536 case MenuItem::ImportFormats:
537 if ((*fit)->name() == "text")
538 label = _("Plain Text as Lines");
539 else if ((*fit)->name() == "textparagraph")
540 label = _("Plain Text as Paragraphs");
543 case MenuItem::ViewFormats:
544 case MenuItem::ExportFormats:
545 case MenuItem::UpdateFormats:
546 if (!(*fit)->documentFormat())
553 if (!(*fit)->shortcut().empty())
554 label += char_type('|') + from_utf8((*fit)->shortcut());
557 tomenu.addWithStatusCheck(MenuItem(MenuItem::Command, label,
558 FuncRequest(action, (*fit)->name())));
560 tomenu.add(MenuItem(MenuItem::Command, label,
561 FuncRequest(action, (*fit)->name())));
566 void expandFloatListInsert(Menu & tomenu, Buffer const * buf)
569 tomenu.add(MenuItem(MenuItem::Command,
570 _("No Documents Open!"),
571 FuncRequest(LFUN_NOACTION)));
575 FloatList const & floats =
576 buf->params().getLyXTextClass().floats();
577 FloatList::const_iterator cit = floats.begin();
578 FloatList::const_iterator end = floats.end();
579 for (; cit != end; ++cit) {
580 tomenu.addWithStatusCheck(MenuItem(MenuItem::Command,
581 _(cit->second.listName()),
582 FuncRequest(LFUN_FLOAT_LIST,
583 cit->second.type())));
588 void expandFloatInsert(Menu & tomenu, Buffer const * buf)
591 tomenu.add(MenuItem(MenuItem::Command,
592 _("No Documents Open!"),
593 FuncRequest(LFUN_NOACTION)));
597 FloatList const & floats =
598 buf->params().getLyXTextClass().floats();
599 FloatList::const_iterator cit = floats.begin();
600 FloatList::const_iterator end = floats.end();
601 for (; cit != end; ++cit) {
603 docstring const label = _(cit->second.name());
604 tomenu.addWithStatusCheck(MenuItem(MenuItem::Command, label,
605 FuncRequest(LFUN_FLOAT_INSERT,
606 cit->second.type())));
611 void expandCharStyleInsert(Menu & tomenu, Buffer const * buf)
614 tomenu.add(MenuItem(MenuItem::Command,
615 _("No Documents Open!"),
616 FuncRequest(LFUN_NOACTION)));
619 CharStyles & charstyles =
620 buf->params().getLyXTextClass().charstyles();
621 CharStyles::iterator cit = charstyles.begin();
622 CharStyles::iterator end = charstyles.end();
623 for (; cit != end; ++cit) {
624 docstring const label = from_utf8(cit->name);
625 tomenu.addWithStatusCheck(MenuItem(MenuItem::Command, label,
626 FuncRequest(LFUN_CHARSTYLE_INSERT,
632 Menu::size_type const max_number_of_items = 25;
634 void expandToc2(Menu & tomenu,
635 lyx::toc::Toc const & toc_list,
636 lyx::toc::Toc::size_type from,
637 lyx::toc::Toc::size_type to, int depth)
639 int shortcut_count = 0;
641 // check whether depth is smaller than the smallest depth in toc.
642 int min_depth = 1000;
643 for (lyx::toc::Toc::size_type i = from; i < to; ++i)
644 min_depth = std::min(min_depth, toc_list[i].depth());
645 if (min_depth > depth)
649 if (to - from <= max_number_of_items) {
650 for (lyx::toc::Toc::size_type i = from; i < to; ++i) {
651 docstring label(4 * max(0, toc_list[i].depth() - depth), char_type(' '));
652 label += limit_string_length(toc_list[i].str());
653 if (toc_list[i].depth() == depth
654 && shortcut_count < 9) {
655 if (label.find(convert<docstring>(shortcut_count + 1)) != docstring::npos)
656 label += char_type('|') + convert<docstring>(++shortcut_count);
658 tomenu.add(MenuItem(MenuItem::Command, label,
659 FuncRequest(toc_list[i].action())));
662 lyx::toc::Toc::size_type pos = from;
664 lyx::toc::Toc::size_type new_pos = pos + 1;
665 while (new_pos < to &&
666 toc_list[new_pos].depth() > depth)
669 docstring label(4 * max(0, toc_list[pos].depth() - depth), ' ');
670 label += limit_string_length(toc_list[pos].str());
671 if (toc_list[pos].depth() == depth &&
672 shortcut_count < 9) {
673 if (label.find(convert<docstring>(shortcut_count + 1)) != docstring::npos)
674 label += char_type('|') + convert<docstring>(++shortcut_count);
676 if (new_pos == pos + 1) {
677 tomenu.add(MenuItem(MenuItem::Command,
678 label, FuncRequest(toc_list[pos].action())));
680 MenuItem item(MenuItem::Submenu, label);
681 item.submenu(new Menu);
682 expandToc2(*item.submenu(),
683 toc_list, pos, new_pos, depth + 1);
692 void expandToc(Menu & tomenu, Buffer const * buf)
694 // To make things very cleanly, we would have to pass buf to
695 // all MenuItem constructors and to expandToc2. However, we
696 // know that all the entries in a TOC will be have status_ ==
697 // OK, so we avoid this unnecessary overhead (JMarc)
700 tomenu.add(MenuItem(MenuItem::Command,
701 _("No Documents Open!"),
702 FuncRequest(LFUN_NOACTION)));
706 FloatList const & floatlist = buf->params().getLyXTextClass().floats();
707 lyx::toc::TocList const & toc_list = lyx::toc::getTocList(*buf);
708 lyx::toc::TocList::const_iterator cit = toc_list.begin();
709 lyx::toc::TocList::const_iterator end = toc_list.end();
710 for (; cit != end; ++cit) {
712 if (cit->first == "TOC")
715 // All the rest is for floats
716 auto_ptr<Menu> menu(new Menu);
717 lyx::toc::Toc::const_iterator ccit = cit->second.begin();
718 lyx::toc::Toc::const_iterator eend = cit->second.end();
719 for (; ccit != eend; ++ccit) {
720 docstring const label = limit_string_length(ccit->str());
721 menu->add(MenuItem(MenuItem::Command,
723 FuncRequest(ccit->action())));
725 string const & floatName = floatlist.getType(cit->first).listName();
726 MenuItem item(MenuItem::Submenu, _(floatName));
727 item.submenu(menu.release());
732 cit = toc_list.find("TOC");
734 tomenu.addWithStatusCheck(MenuItem(MenuItem::Command,
735 _("No Table of contents"),
738 expandToc2(tomenu, cit->second, 0, cit->second.size(), 0);
743 void expandPasteRecent(Menu & tomenu, Buffer const * buf)
748 vector<docstring> const sel =
749 cap::availableSelections(*buf);
751 vector<docstring>::const_iterator cit = sel.begin();
752 vector<docstring>::const_iterator end = sel.end();
754 for (unsigned int index = 0; cit != end; ++cit, ++index) {
755 tomenu.add(MenuItem(MenuItem::Command, *cit,
756 FuncRequest(LFUN_PASTE, convert<string>(index))));
761 void expandToolbars(Menu & tomenu, Buffer const * buf)
764 // extracts the toolbars from the backend
765 ToolbarBackend::Toolbars::const_iterator cit = toolbarbackend.begin();
766 ToolbarBackend::Toolbars::const_iterator end = toolbarbackend.end();
769 for (; cit != end; ++cit, ++i) {
770 docstring label = convert<docstring>(i) + ". " + _(cit->name);
771 // frontends are not supposed to turn on/off toolbars, if they can not
772 // update ToolbarBackend::flags. That is to say, ToolbarsBackend::flags
773 // should reflect the true state of toolbars.
775 // menu is displayed as
779 // in the case of auto.
780 if (cit->flags & ToolbarBackend::AUTO)
781 label += _(" (auto)");
782 label += char_type('|') + convert<docstring>(i);
783 tomenu.add(MenuItem(MenuItem::Command, label,
784 FuncRequest(LFUN_TOOLBAR_TOGGLE_STATE, _(cit->name))));
789 void expandBranches(Menu & tomenu, Buffer const * buf)
794 BufferParams const & params = buf->getMasterBuffer()->params();
796 BranchList::const_iterator cit = params.branchlist().begin();
797 BranchList::const_iterator end = params.branchlist().end();
799 for (int ii = 1; cit != end; ++cit, ++ii) {
800 docstring label = from_utf8(cit->getBranch());
802 label = convert<docstring>(ii) + ". " + label + char_type('|') + convert<docstring>(ii);
803 tomenu.addWithStatusCheck(MenuItem(MenuItem::Command, label,
804 FuncRequest(LFUN_BRANCH_INSERT,
813 void MenuBackend::expand(Menu const & frommenu, Menu & tomenu,
814 Buffer const * buf) const
819 for (Menu::const_iterator cit = frommenu.begin();
820 cit != frommenu.end() ; ++cit) {
821 switch (cit->kind()) {
822 case MenuItem::Lastfiles:
823 expandLastfiles(tomenu);
826 case MenuItem::Documents:
827 expandDocuments(tomenu);
830 case MenuItem::Bookmarks:
831 expandBookmarks(tomenu);
834 case MenuItem::ImportFormats:
835 case MenuItem::ViewFormats:
836 case MenuItem::UpdateFormats:
837 case MenuItem::ExportFormats:
838 expandFormats(cit->kind(), tomenu, buf);
841 case MenuItem::CharStyles:
842 expandCharStyleInsert(tomenu, buf);
845 case MenuItem::FloatListInsert:
846 expandFloatListInsert(tomenu, buf);
849 case MenuItem::FloatInsert:
850 expandFloatInsert(tomenu, buf);
853 case MenuItem::PasteRecent:
854 expandPasteRecent(tomenu, buf);
857 case MenuItem::Toolbars:
858 expandToolbars(tomenu, buf);
861 case MenuItem::Branches:
862 expandBranches(tomenu, buf);
866 expandToc(tomenu, buf);
869 case MenuItem::Submenu: {
871 item.submenu(new Menu(cit->submenuname()));
872 expand(getMenu(cit->submenuname()),
873 *item.submenu(), buf);
874 tomenu.addWithStatusCheck(item);
878 case MenuItem::Separator:
879 tomenu.addWithStatusCheck(*cit);
882 case MenuItem::Command:
884 || !specialmenu_->hasFunc(cit->func()))
885 tomenu.addWithStatusCheck(*cit);
889 // we do not want the menu to end with a separator
891 && tomenu.items_.back().kind() == MenuItem::Separator)
892 tomenu.items_.pop_back();
894 // Check whether the shortcuts are unique
895 tomenu.checkShortcuts();
899 void MenuBackend::read(LyXLex & lex)
908 struct keyword_item menutags[md_last - 1] = {
909 { "end", md_endmenuset },
911 { "menubar", md_menubar }
915 if (compare_ascii_no_case(lex.getString(), "menuset")) {
916 lyxerr << "Menubackend::read: ERROR wrong token:`"
917 << lex.getString() << '\'' << endl;
920 lex.pushTable(menutags, md_last - 1);
921 if (lyxerr.debugging(Debug::PARSER))
922 lex.printTable(lyxerr);
926 while (lex.isOK() && !quit) {
933 docstring const name = from_utf8(lex.getString());
935 getMenu(name).read(lex);
947 lex.printError("menubackend::read: "
948 "Unknown menu tag: `$$Token'");
956 void MenuBackend::add(Menu const & menu)
958 menulist_.push_back(menu);
962 bool MenuBackend::hasMenu(docstring const & name) const
964 return find_if(begin(), end(), MenuNamesEqual(name)) != end();
968 Menu const & MenuBackend::getMenu(docstring const & name) const
970 const_iterator cit = find_if(begin(), end(), MenuNamesEqual(name));
972 lyxerr << "No submenu named " << to_utf8(name) << endl;
973 BOOST_ASSERT(cit != end());
978 Menu & MenuBackend::getMenu(docstring const & name)
980 iterator it = find_if(begin(), end(), MenuNamesEqual(name));
982 lyxerr << "No submenu named " << to_utf8(name) << endl;
983 BOOST_ASSERT(it != end());
988 Menu const & MenuBackend::getMenubar() const