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/convert.h"
49 #include "support/debug.h"
50 #include "support/filetools.h"
51 #include "support/gettext.h"
52 #include "support/lstrings.h"
65 using namespace lyx::support;
73 // MacOSX specific stuff is at the end.
80 /// The type of elements that can be in a menu
88 /** This is the list of last opened file,
89 typically for the File menu. */
91 /** This is the list of opened Documents,
92 typically for the Documents menu. */
94 /** This is the bookmarks */
98 /** This is a list of viewable formats
99 typically for the File->View menu. */
101 /** This is a list of updatable formats
102 typically for the File->Update menu. */
104 /** This is a list of exportable formats
105 typically for the File->Export menu. */
107 /** This is a list of importable formats
108 typically for the File->Export menu. */
110 /** This is the list of elements available
111 * for insertion into document. */
113 /** This is the list of user-configurable
114 insets to insert into document */
116 /** This is the list of XML elements to
117 insert into the document */
119 /** This is the list of floats that we can
120 insert a list for. */
122 /** This is the list of floats that we can
125 /** This is the list of selections that can
130 /** Available branches in document */
134 explicit MenuItem(Kind kind) : kind_(kind), optional_(false) {}
137 QString const & label,
138 QString const & submenu = QString(),
139 bool optional = false)
140 : kind_(kind), label_(label), submenuname_(submenu), optional_(optional)
142 BOOST_ASSERT(kind == Submenu);
146 QString const & label,
147 FuncRequest const & func,
148 bool optional = false)
149 : kind_(kind), label_(label), func_(func), optional_(optional)
151 func_.origin = FuncRequest::MENU;
154 // boost::shared_ptr<MenuDefinition> needs this apprently...
157 /// The label of a given menuitem
158 QString label() const { return label_.split('|')[0]; }
160 /// The keyboard shortcut (usually underlined in the entry)
161 QString shortcut() const
163 return label_.contains('|') ? label_.split('|')[1] : QString();
165 /// The complete label, with label and shortcut separated by a '|'
166 QString fulllabel() const { return label_;}
167 /// The kind of entry
168 Kind kind() const { return kind_; }
169 /// the action (if relevant)
170 FuncRequest const & func() const { return func_; }
171 /// returns true if the entry should be ommited when disabled
172 bool optional() const { return optional_; }
173 /// returns the status of the lfun associated with this entry
174 FuncStatus const & status() const { return status_; }
175 /// returns the status of the lfun associated with this entry
176 FuncStatus & status() { return status_; }
177 /// returns the status of the lfun associated with this entry
178 void status(FuncStatus const & status) { status_ = status; }
180 ///returns the binding associated to this action.
181 QString binding() const
183 if (kind_ != Command)
185 // Get the keys bound to this action, but keep only the
187 KeyMap::Bindings bindings = theTopLevelKeymap().findBindings(func_);
189 return toqstr(bindings.begin()->print(KeySequence::ForGui));
191 LYXERR(Debug::KBMAP, "No binding for "
192 << lyxaction.getActionName(func_.action)
193 << '(' << func_.argument() << ')');
197 /// the description of the submenu (if relevant)
198 QString const & submenuname() const { return submenuname_; }
199 /// set the description of the submenu
200 void submenuname(QString const & name) { submenuname_ = name; }
202 bool hasSubmenu() const { return submenu_.isEmpty(); }
204 MenuDefinition const & submenu() const { return submenu_.at(0); }
205 MenuDefinition & submenu() { return submenu_[0]; }
207 void setSubmenu(MenuDefinition const & menu)
210 submenu_.append(menu);
221 QString submenuname_;
226 /// contains 0 or 1 item.
227 QList<MenuDefinition> submenu_;
231 class MenuDefinition {
234 typedef std::vector<MenuItem> ItemList;
236 typedef ItemList::const_iterator const_iterator;
238 explicit MenuDefinition(QString const & name = QString()) : name_(name) {}
243 QString const & name() const { return name_; }
245 bool empty() const { return items_.empty(); }
246 /// Clear the menu content.
247 void clear() { items_.clear(); }
249 size_t size() const { return items_.size(); }
251 MenuItem const & operator[](size_t) const;
253 const_iterator begin() const { return items_.begin(); }
255 const_iterator end() const { return items_.end(); }
257 // search for func in this menu iteratively, and put menu
259 bool searchMenu(FuncRequest const & func, std::vector<docstring> & names)
262 bool hasFunc(FuncRequest const &) const;
263 /// Add the menu item unconditionally
264 void add(MenuItem const & item) { items_.push_back(item); }
265 /// Checks the associated FuncRequest status before adding the
267 void addWithStatusCheck(MenuItem const &);
268 // Check whether the menu shortcuts are unique
269 void checkShortcuts() const;
271 void expandLastfiles();
272 void expandDocuments();
273 void expandBookmarks();
274 void expandFormats(MenuItem::Kind kind, Buffer const * buf);
275 void expandFloatListInsert(Buffer const * buf);
276 void expandFloatInsert(Buffer const * buf);
277 void expandFlexInsert(Buffer const * buf, std::string s);
278 void expandToc2(Toc const & toc_list, size_t from, size_t to, int depth);
279 void expandToc(Buffer const * buf);
280 void expandPasteRecent();
281 void expandToolbars();
282 void expandBranches(Buffer const * buf);
290 /// Helper for std::find_if
294 MenuNamesEqual(QString const & name) : name_(name) {}
295 bool operator()(MenuDefinition const & menu) const { return menu.name() == name_; }
302 typedef std::vector<MenuDefinition> MenuList;
304 typedef MenuList::const_iterator const_iterator;
306 typedef MenuList::iterator iterator;
308 /////////////////////////////////////////////////////////////////////
309 // MenuDefinition implementation
310 /////////////////////////////////////////////////////////////////////
312 void MenuDefinition::addWithStatusCheck(MenuItem const & i)
316 case MenuItem::Command: {
317 FuncStatus status = lyx::getStatus(i.func());
318 if (status.unknown() || (!status.enabled() && i.optional()))
321 items_.back().status(status);
325 case MenuItem::Submenu: {
326 if (i.hasSubmenu()) {
327 bool enabled = false;
328 for (const_iterator cit = i.submenu().begin();
329 cit != i.submenu().end(); ++cit) {
330 if ((cit->kind() == MenuItem::Command
331 || cit->kind() == MenuItem::Submenu)
332 && cit->status().enabled()) {
337 if (enabled || !i.optional()) {
339 items_.back().status().enabled(enabled);
347 case MenuItem::Separator:
348 if (!items_.empty() && items_.back().kind() != MenuItem::Separator)
358 void MenuDefinition::read(Lexer & lex)
386 struct keyword_item menutags[md_last - 1] = {
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, md_last - 1);
412 if (lyxerr.debugging(Debug::PARSER))
413 lex.printTable(lyxerr);
416 bool optional = false;
418 while (lex.isOK() && !quit) {
422 // fallback to md_item
425 docstring const name = translateIfPossible(lex.getDocString());
427 string const command = lex.getString();
428 FuncRequest func = lyxaction.lookupFunc(command);
429 add(MenuItem(MenuItem::Command, toqstr(name), func, optional));
435 add(MenuItem(MenuItem::Separator));
439 add(MenuItem(MenuItem::Lastfiles));
443 add(MenuItem(MenuItem::CharStyles));
447 add(MenuItem(MenuItem::Custom));
451 add(MenuItem(MenuItem::Elements));
455 add(MenuItem(MenuItem::Documents));
459 add(MenuItem(MenuItem::Bookmarks));
463 add(MenuItem(MenuItem::Toc));
467 add(MenuItem(MenuItem::ViewFormats));
470 case md_updateformats:
471 add(MenuItem(MenuItem::UpdateFormats));
474 case md_exportformats:
475 add(MenuItem(MenuItem::ExportFormats));
478 case md_importformats:
479 add(MenuItem(MenuItem::ImportFormats));
482 case md_floatlistinsert:
483 add(MenuItem(MenuItem::FloatListInsert));
487 add(MenuItem(MenuItem::FloatInsert));
491 add(MenuItem(MenuItem::PasteRecent));
495 add(MenuItem(MenuItem::Toolbars));
499 add(MenuItem(MenuItem::Branches));
504 // fallback to md_submenu
507 docstring const mlabel = translateIfPossible(lex.getDocString());
509 docstring const mname = lex.getDocString();
510 add(MenuItem(MenuItem::Submenu,
511 toqstr(mlabel), toqstr(mname), optional));
521 lex.printError("MenuDefinition::read: "
522 "Unknown menu tag: `$$Token'");
530 MenuItem const & MenuDefinition::operator[](size_type i) const
536 bool MenuDefinition::hasFunc(FuncRequest const & func) const
538 for (const_iterator it = begin(), et = end(); it != et; ++it)
539 if (it->func() == func)
545 void MenuDefinition::checkShortcuts() const
547 // This is a quadratic algorithm, but we do not care because
548 // menus are short enough
549 for (const_iterator it1 = begin(); it1 != end(); ++it1) {
550 QString shortcut = it1->shortcut();
551 if (shortcut.isEmpty())
553 if (!it1->label().contains(shortcut))
554 lyxerr << "Menu warning: menu entry \""
555 << fromqstr(it1->label())
556 << "\" does not contain shortcut `"
557 << fromqstr(shortcut) << "'." << endl;
558 for (const_iterator it2 = begin(); it2 != it1 ; ++it2) {
559 if (!it2->shortcut().compare(shortcut, Qt::CaseInsensitive)) {
560 lyxerr << "Menu warning: menu entries "
561 << '"' << fromqstr(it1->fulllabel())
562 << "\" and \"" << fromqstr(it2->fulllabel())
563 << "\" share the same shortcut."
571 bool MenuDefinition::searchMenu(FuncRequest const & func, vector<docstring> & names) const
573 const_iterator m = begin();
574 const_iterator m_end = end();
575 for (; m != m_end; ++m) {
576 if (m->kind() == MenuItem::Command && m->func() == func) {
577 names.push_back(qstring_to_ucs4(m->label()));
580 if (m->kind() == MenuItem::Submenu) {
581 names.push_back(qstring_to_ucs4(m->label()));
582 if (!m->hasSubmenu()) {
583 LYXERR(Debug::GUI, "Warning: non existing sub menu label="
584 << fromqstr(m->label())
585 << " name=" << fromqstr(m->submenuname()));
589 if (m->submenu().searchMenu(func, names))
598 bool compareFormat(Format const * p1, Format const * p2)
604 QString limitStringLength(docstring const & str)
606 size_t const max_item_length = 45;
608 if (str.size() > max_item_length)
609 return toqstr(str.substr(0, max_item_length - 3) + "...");
615 void MenuDefinition::expandLastfiles()
617 LastFilesSection::LastFiles const & lf = LyX::cref().session().lastFiles().lastFiles();
618 LastFilesSection::LastFiles::const_iterator lfit = lf.begin();
622 for (; lfit != lf.end() && ii < 10; ++lfit, ++ii) {
623 string const file = lfit->absFilename();
624 QString const label = QString("%1. %2|%3").arg(ii)
625 .arg(toqstr(makeDisplayPath(file, 30))).arg(ii);
626 add(MenuItem(MenuItem::Command, label, FuncRequest(LFUN_FILE_OPEN, file)));
631 void MenuDefinition::expandDocuments()
633 Buffer * first = theBufferList().first();
638 // We cannot use a for loop as the buffer list cycles.
640 QString label = toqstr(b->fileName().displayName(20));
644 label = QString::number(ii) + ". " + label + '|' + QString::number(ii);
645 add(MenuItem(MenuItem::Command, label,
646 FuncRequest(LFUN_BUFFER_SWITCH, b->absFileName())));
648 b = theBufferList().next(b);
650 } while (b != first);
652 add(MenuItem(MenuItem::Command, qt_("No Documents Open!"),
653 FuncRequest(LFUN_NOACTION)));
658 void MenuDefinition::expandBookmarks()
660 lyx::BookmarksSection const & bm = LyX::cref().session().bookmarks();
662 for (size_t i = 1; i <= bm.size(); ++i) {
664 string const file = bm.bookmark(i).filename.absFilename();
665 QString const label = QString("%1. %2|%3").arg(i)
666 .arg(toqstr(makeDisplayPath(file, 20))).arg(i);
667 add(MenuItem(MenuItem::Command, label,
668 FuncRequest(LFUN_BOOKMARK_GOTO, convert<docstring>(i))));
674 void MenuDefinition::expandFormats(MenuItem::Kind kind, Buffer const * buf)
676 if (!buf && kind != MenuItem::ImportFormats) {
677 add(MenuItem(MenuItem::Command,
678 qt_("No Document Open!"),
679 FuncRequest(LFUN_NOACTION)));
683 typedef vector<Format const *> Formats;
688 case MenuItem::ImportFormats:
689 formats = theConverters().importableFormats();
690 action = LFUN_BUFFER_IMPORT;
692 case MenuItem::ViewFormats:
693 formats = buf->exportableFormats(true);
694 action = LFUN_BUFFER_VIEW;
696 case MenuItem::UpdateFormats:
697 formats = buf->exportableFormats(true);
698 action = LFUN_BUFFER_UPDATE;
701 formats = buf->exportableFormats(false);
702 action = LFUN_BUFFER_EXPORT;
704 sort(formats.begin(), formats.end(), &compareFormat);
706 Formats::const_iterator fit = formats.begin();
707 Formats::const_iterator end = formats.end();
708 for (; fit != end ; ++fit) {
711 QString label = toqstr((*fit)->prettyname());
712 QString const shortcut = toqstr((*fit)->shortcut());
715 case MenuItem::ImportFormats:
716 // FIXME: This is a hack, we should rather solve
717 // FIXME: bug 2488 instead.
718 if ((*fit)->name() == "text")
719 label = qt_("Plain Text");
720 else if ((*fit)->name() == "textparagraph")
721 label = qt_("Plain Text, Join Lines");
724 case MenuItem::ViewFormats:
725 case MenuItem::ExportFormats:
726 case MenuItem::UpdateFormats:
727 if (!(*fit)->documentFormat())
734 // FIXME: if we had proper support for translating the
735 // format names defined in configure.py, there would
736 // not be a need to check whether the shortcut is
737 // correct. If we add it uncondiitonally, it would
738 // create useless warnings on bad shortcuts
739 if (!shortcut.isEmpty() && label.contains(shortcut))
740 label += '|' + shortcut;
743 addWithStatusCheck(MenuItem(MenuItem::Command, label,
744 FuncRequest(action, (*fit)->name())));
746 add(MenuItem(MenuItem::Command, label,
747 FuncRequest(action, (*fit)->name())));
752 void MenuDefinition::expandFloatListInsert(Buffer const * buf)
755 add(MenuItem(MenuItem::Command, qt_("No Document Open!"),
756 FuncRequest(LFUN_NOACTION)));
760 FloatList const & floats = buf->params().documentClass().floats();
761 FloatList::const_iterator cit = floats.begin();
762 FloatList::const_iterator end = floats.end();
763 for (; cit != end; ++cit) {
764 addWithStatusCheck(MenuItem(MenuItem::Command,
765 qt_(cit->second.listName()),
766 FuncRequest(LFUN_FLOAT_LIST,
767 cit->second.type())));
772 void MenuDefinition::expandFloatInsert(Buffer const * buf)
775 add(MenuItem(MenuItem::Command, qt_("No Document Open!"),
776 FuncRequest(LFUN_NOACTION)));
780 FloatList const & floats = buf->params().documentClass().floats();
781 FloatList::const_iterator cit = floats.begin();
782 FloatList::const_iterator end = floats.end();
783 for (; cit != end; ++cit) {
785 QString const label = qt_(cit->second.name());
786 addWithStatusCheck(MenuItem(MenuItem::Command, label,
787 FuncRequest(LFUN_FLOAT_INSERT,
788 cit->second.type())));
793 void MenuDefinition::expandFlexInsert(Buffer const * buf, string s)
796 add(MenuItem(MenuItem::Command, qt_("No Document Open!"),
797 FuncRequest(LFUN_NOACTION)));
800 TextClass::InsetLayouts const & insetLayouts =
801 buf->params().documentClass().insetLayouts();
802 TextClass::InsetLayouts::const_iterator cit = insetLayouts.begin();
803 TextClass::InsetLayouts::const_iterator end = insetLayouts.end();
804 for (; cit != end; ++cit) {
805 docstring const label = cit->first;
806 if (cit->second.lyxtype() == s)
807 addWithStatusCheck(MenuItem(MenuItem::Command,
808 toqstr(label), FuncRequest(LFUN_FLEX_INSERT,
814 size_t const max_number_of_items = 25;
816 void MenuDefinition::expandToc2(Toc const & toc_list,
817 size_t from, size_t to, int depth)
819 int shortcut_count = 0;
821 // check whether depth is smaller than the smallest depth in toc.
822 int min_depth = 1000;
823 for (size_t i = from; i < to; ++i)
824 min_depth = min(min_depth, toc_list[i].depth());
825 if (min_depth > depth)
828 if (to - from <= max_number_of_items) {
829 for (size_t i = from; i < to; ++i) {
830 QString label(4 * max(0, toc_list[i].depth() - depth), ' ');
831 label += limitStringLength(toc_list[i].str());
832 if (toc_list[i].depth() == depth
833 && shortcut_count < 9) {
834 if (label.contains(QString::number(shortcut_count + 1)))
835 label += '|' + QString::number(++shortcut_count);
837 add(MenuItem(MenuItem::Command, label,
838 FuncRequest(toc_list[i].action())));
843 size_t new_pos = pos + 1;
844 while (new_pos < to && toc_list[new_pos].depth() > depth)
847 QString label(4 * max(0, toc_list[pos].depth() - depth), ' ');
848 label += limitStringLength(toc_list[pos].str());
849 if (toc_list[pos].depth() == depth &&
850 shortcut_count < 9) {
851 if (label.contains(QString::number(shortcut_count + 1)))
852 label += '|' + QString::number(++shortcut_count);
854 if (new_pos == pos + 1) {
855 add(MenuItem(MenuItem::Command,
856 label, FuncRequest(toc_list[pos].action())));
859 sub.expandToc2(toc_list, pos, new_pos, depth + 1);
860 MenuItem item(MenuItem::Submenu, label);
861 item.setSubmenu(sub);
870 void MenuDefinition::expandToc(Buffer const * buf)
872 // To make things very cleanly, we would have to pass buf to
873 // all MenuItem constructors and to expandToc2. However, we
874 // know that all the entries in a TOC will be have status_ ==
875 // OK, so we avoid this unnecessary overhead (JMarc)
878 add(MenuItem(MenuItem::Command, qt_("No Document Open!"),
879 FuncRequest(LFUN_NOACTION)));
883 Buffer* cbuf = const_cast<Buffer*>(buf);
884 cbuf->tocBackend().update();
885 cbuf->structureChanged();
887 // Add an entry for the master doc if this is a child doc
888 Buffer const * const master = buf->masterBuffer();
890 ParIterator const pit = par_iterator_begin(master->inset());
891 string const arg = convert<string>(pit->id());
892 FuncRequest f(LFUN_PARAGRAPH_GOTO, arg);
893 add(MenuItem(MenuItem::Command, qt_("Master Document"), f));
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 // All the rest is for floats
906 MenuDefinition submenu;
907 TocIterator ccit = cit->second.begin();
908 TocIterator eend = cit->second.end();
909 for (; ccit != eend; ++ccit) {
910 QString const label = limitStringLength(ccit->str());
911 submenu.add(MenuItem(MenuItem::Command, label,
912 FuncRequest(ccit->action())));
914 string const & floatName = floatlist.getType(cit->first).listName();
916 if (!floatName.empty())
917 label = qt_(floatName);
918 // BUG3633: listings is not a proper float so its name
919 // is not shown in floatlist.
920 else if (cit->first == "equation")
921 label = qt_("List of Equations");
922 else if (cit->first == "index")
923 label = qt_("List of Indexes");
924 else if (cit->first == "listing")
925 label = qt_("List of Listings");
926 else if (cit->first == "marginalnote")
927 label = qt_("List of Marginal notes");
928 else if (cit->first == "note")
929 label = qt_("List of Notes");
930 else if (cit->first == "footnote")
931 label = qt_("List of Foot notes");
932 else if (cit->first == "label")
933 label = qt_("Labels and References");
934 else if (cit->first == "citation")
935 label = qt_("List of Citations");
936 // this should not happen now, but if something else like
937 // listings is added later, this can avoid an empty menu name.
939 label = qt_("Other floats");
940 MenuItem item(MenuItem::Submenu, label);
941 item.setSubmenu(submenu);
946 cit = toc_list.find("tableofcontents");
948 addWithStatusCheck(MenuItem(MenuItem::Command,
949 qt_("No Table of contents"),
952 expandToc2(cit->second, 0, cit->second.size(), 0);
957 void MenuDefinition::expandPasteRecent()
959 vector<docstring> const sel = cap::availableSelections();
961 vector<docstring>::const_iterator cit = sel.begin();
962 vector<docstring>::const_iterator end = sel.end();
964 for (unsigned int index = 0; cit != end; ++cit, ++index) {
965 add(MenuItem(MenuItem::Command, toqstr(*cit),
966 FuncRequest(LFUN_PASTE, convert<string>(index))));
971 void MenuDefinition::expandToolbars()
974 // extracts the toolbars from the backend
975 ToolbarBackend::Toolbars::const_iterator cit = toolbarbackend.begin();
976 ToolbarBackend::Toolbars::const_iterator end = toolbarbackend.end();
978 for (; cit != end; ++cit) {
979 QString label = qt_(cit->gui_name);
980 // frontends are not supposed to turn on/off toolbars,
981 // if they cannot update ToolbarBackend::flags. That
982 // is to say, ToolbarsBackend::flags should reflect
983 // the true state of toolbars.
985 // menu is displayed as
989 // in the case of auto.
990 if (cit->flags & ToolbarInfo::AUTO)
991 label += qt_(" (auto)");
992 add(MenuItem(MenuItem::Command, label,
993 FuncRequest(LFUN_TOOLBAR_TOGGLE, cit->name + " allowauto")));
998 void MenuDefinition::expandBranches(Buffer const * buf)
1001 add(MenuItem(MenuItem::Command,
1002 qt_("No Document Open!"),
1003 FuncRequest(LFUN_NOACTION)));
1007 BufferParams const & params = buf->masterBuffer()->params();
1008 if (params.branchlist().empty()) {
1009 add(MenuItem(MenuItem::Command,
1010 qt_("No Branch in Document!"),
1011 FuncRequest(LFUN_NOACTION)));
1015 BranchList::const_iterator cit = params.branchlist().begin();
1016 BranchList::const_iterator end = params.branchlist().end();
1018 for (int ii = 1; cit != end; ++cit, ++ii) {
1019 docstring label = cit->getBranch();
1021 label = convert<docstring>(ii) + ". " + label + char_type('|') + convert<docstring>(ii);
1022 addWithStatusCheck(MenuItem(MenuItem::Command, toqstr(label),
1023 FuncRequest(LFUN_BRANCH_INSERT,
1024 cit->getBranch())));
1031 /////////////////////////////////////////////////////////////////////
1032 // Menu::Impl definition and implementation
1033 /////////////////////////////////////////////////////////////////////
1037 /// populates the menu or one of its submenu
1038 /// This is used as a recursive function
1039 void populate(QMenu & qMenu, MenuDefinition const & menu);
1041 /// Only needed for top level menus.
1042 MenuDefinition * top_level_menu;
1045 /// the name of this menu
1051 /// Get a MenuDefinition item label from the menu backend
1052 static QString label(MenuItem const & mi)
1054 QString label = mi.label();
1055 label.replace("&", "&&");
1057 QString shortcut = mi.shortcut();
1058 if (!shortcut.isEmpty()) {
1059 int pos = label.indexOf(shortcut);
1061 //label.insert(pos, 1, char_type('&'));
1062 label.replace(pos, 0, "&");
1065 QString const binding = mi.binding();
1066 if (!binding.isEmpty())
1067 label += '\t' + binding;
1072 void Menu::Impl::populate(QMenu & qMenu, MenuDefinition const & menu)
1074 LYXERR(Debug::GUI, "populating menu " << fromqstr(menu.name()));
1075 if (menu.size() == 0) {
1076 LYXERR(Debug::GUI, "\tERROR: empty menu " << fromqstr(menu.name()));
1079 LYXERR(Debug::GUI, " ***** menu entries " << menu.size());
1080 MenuDefinition::const_iterator m = menu.begin();
1081 MenuDefinition::const_iterator end = menu.end();
1082 for (; m != end; ++m) {
1083 if (m->kind() == MenuItem::Separator)
1084 qMenu.addSeparator();
1085 else if (m->kind() == MenuItem::Submenu) {
1086 QMenu * subMenu = qMenu.addMenu(label(*m));
1087 populate(*subMenu, m->submenu());
1089 // we have a MenuItem::Command
1090 qMenu.addAction(new Action(*view, QIcon(), label(*m), m->func(),
1096 /////////////////////////////////////////////////////////////////////
1097 // Menu implementation
1098 /////////////////////////////////////////////////////////////////////
1100 Menu::Menu(GuiView * gv, QString const & name, bool top_level)
1103 d->top_level_menu = top_level? new MenuDefinition : 0;
1107 if (d->top_level_menu)
1108 connect(this, SIGNAL(aboutToShow()), this, SLOT(updateView()));
1114 delete d->top_level_menu;
1119 void Menu::updateView()
1121 guiApp->menus().updateMenu(d->name);
1124 /////////////////////////////////////////////////////////////////////
1125 // Menus::Impl definition and implementation
1126 /////////////////////////////////////////////////////////////////////
1128 struct Menus::Impl {
1130 bool hasMenu(QString const &) const;
1132 MenuDefinition & getMenu(QString const &);
1134 MenuDefinition const & getMenu(QString const &) const;
1136 /// Expands some special entries of the menu
1137 /** The entries with the following kind are expanded to a
1138 sequence of Command MenuItems: Lastfiles, Documents,
1139 ViewFormats, ExportFormats, UpdateFormats, Branches
1141 void expand(MenuDefinition const & frommenu, MenuDefinition & tomenu,
1142 Buffer const *) const;
1144 /// Initialize specific MACOS X menubar
1145 void macxMenuBarInit(GuiView * view);
1147 /// Mac special menu.
1148 /** This defines a menu whose entries list the FuncRequests
1149 that will be removed by expand() in other menus. This is
1150 used by the Qt/Mac code
1152 MenuDefinition specialmenu_;
1157 MenuDefinition menubar_;
1159 typedef QHash<QString, Menu *> NameMap;
1161 /// name to menu for \c menu() method.
1166 Here is what the Qt documentation says about how a menubar is chosen:
1168 1) If the window has a QMenuBar then it is used. 2) If the window
1169 is a modal then its menubar is used. If no menubar is specified
1170 then a default menubar is used (as documented below) 3) If the
1171 window has no parent then the default menubar is used (as
1174 The above 3 steps are applied all the way up the parent window
1175 chain until one of the above are satisifed. If all else fails a
1176 default menubar will be created, the default menubar on Qt/Mac is
1177 an empty menubar, however you can create a different default
1178 menubar by creating a parentless QMenuBar, the first one created
1179 will thus be designated the default menubar, and will be used
1180 whenever a default menubar is needed.
1182 Thus, for Qt/Mac, we add the menus to a free standing menubar, so
1183 that this menubar will be used also when one of LyX' dialogs has
1186 void Menus::Impl::macxMenuBarInit(GuiView * view)
1188 // The Mac menubar initialisation must be done only once!
1189 static bool done = false;
1194 /* Since Qt 4.2, the qt/mac menu code has special code for
1195 specifying the role of a menu entry. However, it does not
1196 work very well with our scheme of creating menus on demand,
1197 and therefore we need to put these entries in a special
1198 invisible menu. (JMarc)
1201 /* The entries of our special mac menu. If we add support for
1202 * special entries in Menus, we could imagine something
1204 * SpecialItem About " "About LyX" "dialog-show aboutlyx"
1205 * and therefore avoid hardcoding. I am not sure it is worth
1206 * the hassle, though. (JMarc)
1208 struct MacMenuEntry {
1212 QAction::MenuRole role;
1215 MacMenuEntry entries[] = {
1216 {LFUN_DIALOG_SHOW, "aboutlyx", "About LyX",
1217 QAction::AboutRole},
1218 {LFUN_DIALOG_SHOW, "prefs", "Preferences",
1219 QAction::PreferencesRole},
1220 {LFUN_RECONFIGURE, "", "Reconfigure",
1221 QAction::ApplicationSpecificRole},
1222 {LFUN_LYX_QUIT, "", "Quit LyX", QAction::QuitRole}
1224 const size_t num_entries = sizeof(entries) / sizeof(entries[0]);
1226 // the special menu for Menus.
1227 for (size_t i = 0 ; i < num_entries ; ++i) {
1228 FuncRequest const func(entries[i].action,
1229 from_utf8(entries[i].arg));
1230 specialmenu_.add(MenuItem(MenuItem::Command, entries[i].label, func));
1233 // add the entries to a QMenu that will eventually be empty
1234 // and therefore invisible.
1235 QMenu * qMenu = view->menuBar()->addMenu("special");
1236 MenuDefinition::const_iterator cit = specialmenu_.begin();
1237 MenuDefinition::const_iterator end = specialmenu_.end();
1238 for (size_t i = 0 ; cit != end ; ++cit, ++i) {
1239 Action * action = new Action(*view, QIcon(), cit->label(),
1240 cit->func(), QString());
1241 action->setMenuRole(entries[i].role);
1242 qMenu->addAction(action);
1247 void Menus::Impl::expand(MenuDefinition const & frommenu, MenuDefinition & tomenu,
1248 Buffer const * buf) const
1250 if (!tomenu.empty())
1253 for (MenuDefinition::const_iterator cit = frommenu.begin();
1254 cit != frommenu.end() ; ++cit) {
1255 switch (cit->kind()) {
1256 case MenuItem::Lastfiles:
1257 tomenu.expandLastfiles();
1260 case MenuItem::Documents:
1261 tomenu.expandDocuments();
1264 case MenuItem::Bookmarks:
1265 tomenu.expandBookmarks();
1268 case MenuItem::ImportFormats:
1269 case MenuItem::ViewFormats:
1270 case MenuItem::UpdateFormats:
1271 case MenuItem::ExportFormats:
1272 tomenu.expandFormats(cit->kind(), buf);
1275 case MenuItem::CharStyles:
1276 tomenu.expandFlexInsert(buf, "charstyle");
1279 case MenuItem::Custom:
1280 tomenu.expandFlexInsert(buf, "custom");
1283 case MenuItem::Elements:
1284 tomenu.expandFlexInsert(buf, "element");
1287 case MenuItem::FloatListInsert:
1288 tomenu.expandFloatListInsert(buf);
1291 case MenuItem::FloatInsert:
1292 tomenu.expandFloatInsert(buf);
1295 case MenuItem::PasteRecent:
1296 tomenu.expandPasteRecent();
1299 case MenuItem::Toolbars:
1300 tomenu.expandToolbars();
1303 case MenuItem::Branches:
1304 tomenu.expandBranches(buf);
1308 tomenu.expandToc(buf);
1311 case MenuItem::Submenu: {
1312 MenuItem item(*cit);
1313 item.setSubmenu(MenuDefinition(cit->submenuname()));
1314 expand(getMenu(cit->submenuname()), item.submenu(), buf);
1315 tomenu.addWithStatusCheck(item);
1319 case MenuItem::Separator:
1320 tomenu.addWithStatusCheck(*cit);
1323 case MenuItem::Command:
1324 if (!specialmenu_.hasFunc(cit->func()))
1325 tomenu.addWithStatusCheck(*cit);
1329 // we do not want the menu to end with a separator
1330 if (!tomenu.empty() && tomenu.items_.back().kind() == MenuItem::Separator)
1331 tomenu.items_.pop_back();
1333 // Check whether the shortcuts are unique
1334 tomenu.checkShortcuts();
1338 bool Menus::Impl::hasMenu(QString const & name) const
1340 return find_if(menulist_.begin(), menulist_.end(),
1341 MenuNamesEqual(name)) != menulist_.end();
1345 MenuDefinition const & Menus::Impl::getMenu(QString const & name) const
1347 const_iterator cit = find_if(menulist_.begin(), menulist_.end(),
1348 MenuNamesEqual(name));
1349 if (cit == menulist_.end())
1350 lyxerr << "No submenu named " << fromqstr(name) << endl;
1351 BOOST_ASSERT(cit != menulist_.end());
1356 MenuDefinition & Menus::Impl::getMenu(QString const & name)
1358 iterator it = find_if(menulist_.begin(), menulist_.end(),
1359 MenuNamesEqual(name));
1360 if (it == menulist_.end())
1361 lyxerr << "No submenu named " << fromqstr(name) << endl;
1362 BOOST_ASSERT(it != menulist_.end());
1366 /////////////////////////////////////////////////////////////////////
1367 // Menus implementation
1368 /////////////////////////////////////////////////////////////////////
1370 Menus::Menus(): d(new Impl) {}
1373 void Menus::read(Lexer & lex)
1382 struct keyword_item menutags[md_last - 1] = {
1383 { "end", md_endmenuset },
1384 { "menu", md_menu },
1385 { "menubar", md_menubar }
1389 if (compare_ascii_no_case(lex.getString(), "menuset")) {
1390 lyxerr << "Menubackend::read: ERROR wrong token:`"
1391 << lex.getString() << '\'' << endl;
1394 lex.pushTable(menutags, md_last - 1);
1395 if (lyxerr.debugging(Debug::PARSER))
1396 lex.printTable(lyxerr);
1400 while (lex.isOK() && !quit) {
1401 switch (lex.lex()) {
1403 d->menubar_.read(lex);
1407 QString const name = toqstr(lex.getDocString());
1408 if (d->hasMenu(name))
1409 d->getMenu(name).read(lex);
1411 MenuDefinition menu(name);
1413 d->menulist_.push_back(menu);
1421 lex.printError("menubackend::read: "
1422 "Unknown menu tag: `$$Token'");
1430 bool Menus::searchMenu(FuncRequest const & func,
1431 vector<docstring> & names) const
1433 MenuDefinition menu;
1434 d->expand(d->menubar_, menu, 0);
1435 return menu.searchMenu(func, names);
1439 void Menus::fillMenuBar(GuiView * view)
1441 // Clear all menubar contents before filling it.
1442 view->menuBar()->clear();
1445 // setup special mac specific menu item
1446 d->macxMenuBarInit(view);
1449 LYXERR(Debug::GUI, "populating menu bar" << fromqstr(d->menubar_.name()));
1451 if (d->menubar_.size() == 0) {
1452 LYXERR(Debug::GUI, "\tERROR: empty menu bar"
1453 << fromqstr(d->menubar_.name()));
1457 LYXERR(Debug::GUI, "menu bar entries "
1458 << d->menubar_.size());
1461 MenuDefinition menu;
1462 d->expand(d->menubar_, menu, view->buffer());
1464 MenuDefinition::const_iterator m = menu.begin();
1465 MenuDefinition::const_iterator end = menu.end();
1467 for (; m != end; ++m) {
1469 if (m->kind() != MenuItem::Submenu) {
1470 LYXERR(Debug::GUI, "\tERROR: not a submenu " << fromqstr(m->label()));
1474 LYXERR(Debug::GUI, "menu bar item " << fromqstr(m->label())
1475 << " is a submenu named " << fromqstr(m->submenuname()));
1477 QString name = m->submenuname();
1478 if (!d->hasMenu(name)) {
1479 LYXERR(Debug::GUI, "\tERROR: " << fromqstr(name)
1480 << " submenu has no menu!");
1484 Menu * menu = new Menu(view, m->submenuname(), true);
1485 menu->setTitle(label(*m));
1486 view->menuBar()->addMenu(menu);
1488 d->name_map_[name] = menu;
1493 void Menus::updateMenu(QString const & name)
1495 Menu * qmenu = d->name_map_[name];
1496 LYXERR(Debug::GUI, "Triggered menu: " << fromqstr(name));
1499 if (qmenu->d->name.isEmpty())
1502 // Here, We make sure that theLyXFunc points to the correct LyXView.
1503 theLyXFunc().setLyXView(qmenu->d->view);
1505 if (!d->hasMenu(name)) {
1506 qmenu->addAction(qt_("No action defined!"));
1507 LYXERR(Debug::GUI, "\tWARNING: non existing menu: "
1508 << fromqstr(qmenu->d->name));
1512 MenuDefinition const & fromLyxMenu = d->getMenu(name);
1513 d->expand(fromLyxMenu, *qmenu->d->top_level_menu, qmenu->d->view->buffer());
1514 qmenu->d->populate(*qmenu, *qmenu->d->top_level_menu);
1518 Menu * Menus::menu(QString const & name, GuiView & view)
1520 LYXERR(Debug::GUI, "Context menu requested: " << fromqstr(name));
1521 Menu * menu = d->name_map_.value(name, 0);
1522 if (!menu && !name.startsWith("context-")) {
1523 LYXERR0("requested context menu not found: " << fromqstr(name));
1527 menu = new Menu(&view, name, true);
1528 d->name_map_[name] = menu;
1532 } // namespace frontend
1535 #include "Menus_moc.cpp"