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 "BiblioInfo.h"
27 #include "BranchList.h"
29 #include "BufferList.h"
30 #include "BufferParams.h"
31 #include "BufferView.h"
32 #include "Converter.h"
33 #include "CutAndPaste.h"
35 #include "FloatList.h"
37 #include "FuncRequest.h"
38 #include "FuncStatus.h"
41 #include "LyXAction.h"
42 #include "LyX.h" // for lastfiles
44 #include "Paragraph.h"
45 #include "ParIterator.h"
47 #include "TextClass.h"
48 #include "TocBackend.h"
51 #include "insets/Inset.h"
52 #include "insets/InsetCitation.h"
53 #include "insets/InsetGraphics.h"
55 #include "support/lassert.h"
56 #include "support/convert.h"
57 #include "support/debug.h"
58 #include "support/docstring_list.h"
59 #include "support/filetools.h"
60 #include "support/gettext.h"
61 #include "support/lstrings.h"
69 #include <boost/shared_ptr.hpp>
75 using namespace lyx::support;
83 // MacOSX specific stuff is at the end.
90 /// The type of elements that can be in a menu
98 /** This is the list of last opened file,
99 typically for the File menu. */
101 /** This is the list of opened Documents,
102 typically for the Documents menu. */
104 /** This is the bookmarks */
108 /** This is a list of viewable formats
109 typically for the File->View menu. */
111 /** This is a list of updatable formats
112 typically for the File->Update menu. */
114 /** This is a list of exportable formats
115 typically for the File->Export menu. */
117 /** This is a list of importable formats
118 typically for the File->Export menu. */
120 /** This is the list of elements available
121 * for insertion into document. */
123 /** This is the list of user-configurable
124 insets to insert into document */
126 /** This is the list of XML elements to
127 insert into the document */
129 /** This is the list of floats that we can
130 insert a list for. */
132 /** This is the list of floats that we can
135 /** This is the list of selections that can
140 /** Available branches in document */
142 /** Available citation styles for a given citation */
144 /** Available graphics groups */
148 explicit MenuItem(Kind kind) : kind_(kind), optional_(false) {}
151 QString const & label,
152 QString const & submenu = QString(),
153 bool optional = false)
154 : kind_(kind), label_(label), submenuname_(submenu), optional_(optional)
156 LASSERT(kind == Submenu, /**/);
160 QString const & label,
161 FuncRequest const & func,
162 bool optional = false)
163 : kind_(kind), label_(label), func_(func), optional_(optional)
165 func_.origin = FuncRequest::MENU;
168 // boost::shared_ptr<MenuDefinition> needs this apprently...
171 /// The label of a given menuitem
172 QString label() const { return label_.split('|')[0]; }
174 /// The keyboard shortcut (usually underlined in the entry)
175 QString shortcut() const
177 return label_.contains('|') ? label_.split('|')[1] : QString();
179 /// The complete label, with label and shortcut separated by a '|'
180 QString fulllabel() const { return label_;}
181 /// The kind of entry
182 Kind kind() const { return kind_; }
183 /// the action (if relevant)
184 FuncRequest const & func() const { return func_; }
185 /// returns true if the entry should be ommited when disabled
186 bool optional() const { return optional_; }
187 /// returns the status of the lfun associated with this entry
188 FuncStatus const & status() const { return status_; }
189 /// returns the status of the lfun associated with this entry
190 FuncStatus & status() { return status_; }
191 /// returns the status of the lfun associated with this entry
192 void status(FuncStatus const & status) { status_ = status; }
194 ///returns the binding associated to this action.
195 QString binding() const
197 if (kind_ != Command)
199 // Get the keys bound to this action, but keep only the
201 KeyMap::Bindings bindings = theTopLevelKeymap().findBindings(func_);
203 return toqstr(bindings.begin()->print(KeySequence::ForGui));
205 LYXERR(Debug::KBMAP, "No binding for "
206 << lyxaction.getActionName(func_.action)
207 << '(' << func_.argument() << ')');
211 /// the description of the submenu (if relevant)
212 QString const & submenuname() const { return submenuname_; }
213 /// set the description of the submenu
214 void submenuname(QString const & name) { submenuname_ = name; }
216 bool hasSubmenu() const { return !submenu_.isEmpty(); }
218 MenuDefinition const & submenu() const { return submenu_.at(0); }
219 MenuDefinition & submenu() { return submenu_[0]; }
221 void setSubmenu(MenuDefinition const & menu)
224 submenu_.append(menu);
235 QString submenuname_;
240 /// contains 0 or 1 item.
241 QList<MenuDefinition> submenu_;
245 class MenuDefinition {
248 typedef std::vector<MenuItem> ItemList;
250 typedef ItemList::const_iterator const_iterator;
252 explicit MenuDefinition(QString const & name = QString()) : name_(name) {}
257 QString const & name() const { return name_; }
259 bool empty() const { return items_.empty(); }
260 /// Clear the menu content.
261 void clear() { items_.clear(); }
263 size_t size() const { return items_.size(); }
265 MenuItem const & operator[](size_t) const;
267 const_iterator begin() const { return items_.begin(); }
269 const_iterator end() const { return items_.end(); }
271 // search for func in this menu iteratively, and put menu
273 bool searchMenu(FuncRequest const & func, docstring_list & names)
276 bool hasFunc(FuncRequest const &) const;
277 /// Add the menu item unconditionally
278 void add(MenuItem const & item) { items_.push_back(item); }
279 /// Checks the associated FuncRequest status before adding the
281 void addWithStatusCheck(MenuItem const &);
282 // Check whether the menu shortcuts are unique
283 void checkShortcuts() const;
285 void expandLastfiles();
286 void expandDocuments();
287 void expandBookmarks();
288 void expandFormats(MenuItem::Kind kind, Buffer const * buf);
289 void expandFloatListInsert(Buffer const * buf);
290 void expandFloatInsert(Buffer const * buf);
291 void expandFlexInset(Buffer const * buf, std::string s);
292 void expandToc2(Toc const & toc_list, size_t from, size_t to, int depth);
293 void expandToc(Buffer const * buf);
294 void expandPasteRecent(Buffer const * buf);
295 void expandToolbars();
296 void expandBranches(Buffer const * buf);
297 void expandCiteStyles(BufferView const *);
298 void expandGraphicsGroups(BufferView const *);
306 /// Helper for std::find_if
310 MenuNamesEqual(QString const & name) : name_(name) {}
311 bool operator()(MenuDefinition const & menu) const { return menu.name() == name_; }
318 typedef std::vector<MenuDefinition> MenuList;
320 typedef MenuList::const_iterator const_iterator;
322 typedef MenuList::iterator iterator;
324 /////////////////////////////////////////////////////////////////////
325 // MenuDefinition implementation
326 /////////////////////////////////////////////////////////////////////
328 void MenuDefinition::addWithStatusCheck(MenuItem const & i)
332 case MenuItem::Command: {
333 FuncStatus status = lyx::getStatus(i.func());
334 if (status.unknown() || (!status.enabled() && i.optional()))
337 items_.back().status(status);
341 case MenuItem::Submenu: {
342 if (i.hasSubmenu()) {
343 bool enabled = false;
344 for (const_iterator cit = i.submenu().begin();
345 cit != i.submenu().end(); ++cit) {
346 if ((cit->kind() == MenuItem::Command
347 || cit->kind() == MenuItem::Submenu)
348 && cit->status().enabled()) {
353 if (enabled || !i.optional()) {
355 items_.back().status().setEnabled(enabled);
363 case MenuItem::Separator:
364 if (!items_.empty() && items_.back().kind() != MenuItem::Separator)
374 void MenuDefinition::read(Lexer & lex)
403 LexerKeyword menutags[] = {
404 { "bookmarks", md_bookmarks },
405 { "branches", md_branches },
406 { "charstyles", md_charstyles },
407 { "citestyles", md_citestyles },
408 { "custom", md_custom },
409 { "documents", md_documents },
410 { "elements", md_elements },
411 { "end", md_endmenu },
412 { "exportformats", md_exportformats },
413 { "floatinsert", md_floatinsert },
414 { "floatlistinsert", md_floatlistinsert },
415 { "graphicsgroups", md_graphicsgroups },
416 { "importformats", md_importformats },
418 { "lastfiles", md_lastfiles },
419 { "optitem", md_optitem },
420 { "optsubmenu", md_optsubmenu },
421 { "pasterecent", md_pasterecent },
422 { "separator", md_separator },
423 { "submenu", md_submenu },
425 { "toolbars", md_toolbars },
426 { "updateformats", md_updateformats },
427 { "viewformats", md_viewformats }
430 lex.pushTable(menutags);
431 lex.setContext("MenuDefinition::read: ");
434 bool optional = false;
436 while (lex.isOK() && !quit) {
440 // fallback to md_item
443 docstring const name = translateIfPossible(lex.getDocString());
445 string const command = lex.getString();
446 FuncRequest func = lyxaction.lookupFunc(command);
447 add(MenuItem(MenuItem::Command, toqstr(name), func, optional));
453 add(MenuItem(MenuItem::Separator));
457 add(MenuItem(MenuItem::Lastfiles));
461 add(MenuItem(MenuItem::CharStyles));
465 add(MenuItem(MenuItem::Custom));
469 add(MenuItem(MenuItem::Elements));
473 add(MenuItem(MenuItem::Documents));
477 add(MenuItem(MenuItem::Bookmarks));
481 add(MenuItem(MenuItem::Toc));
485 add(MenuItem(MenuItem::ViewFormats));
488 case md_updateformats:
489 add(MenuItem(MenuItem::UpdateFormats));
492 case md_exportformats:
493 add(MenuItem(MenuItem::ExportFormats));
496 case md_importformats:
497 add(MenuItem(MenuItem::ImportFormats));
500 case md_floatlistinsert:
501 add(MenuItem(MenuItem::FloatListInsert));
505 add(MenuItem(MenuItem::FloatInsert));
509 add(MenuItem(MenuItem::PasteRecent));
513 add(MenuItem(MenuItem::Toolbars));
517 add(MenuItem(MenuItem::Branches));
521 add(MenuItem(MenuItem::CiteStyles));
524 case md_graphicsgroups:
525 add(MenuItem(MenuItem::GraphicsGroups));
530 // fallback to md_submenu
533 docstring const mlabel = translateIfPossible(lex.getDocString());
535 docstring const mname = lex.getDocString();
536 add(MenuItem(MenuItem::Submenu,
537 toqstr(mlabel), toqstr(mname), optional));
547 lex.printError("Unknown menu tag");
555 MenuItem const & MenuDefinition::operator[](size_type i) const
561 bool MenuDefinition::hasFunc(FuncRequest const & func) const
563 for (const_iterator it = begin(), et = end(); it != et; ++it)
564 if (it->func() == func)
570 void MenuDefinition::checkShortcuts() const
572 // This is a quadratic algorithm, but we do not care because
573 // menus are short enough
574 for (const_iterator it1 = begin(); it1 != end(); ++it1) {
575 QString shortcut = it1->shortcut();
576 if (shortcut.isEmpty())
578 if (!it1->label().contains(shortcut))
579 LYXERR0("Menu warning: menu entry \""
581 << "\" does not contain shortcut `"
582 << shortcut << "'.");
583 for (const_iterator it2 = begin(); it2 != it1 ; ++it2) {
584 if (!it2->shortcut().compare(shortcut, Qt::CaseInsensitive)) {
585 LYXERR0("Menu warning: menu entries "
586 << '"' << it1->fulllabel()
587 << "\" and \"" << it2->fulllabel()
588 << "\" share the same shortcut.");
595 bool MenuDefinition::searchMenu(FuncRequest const & func, docstring_list & names) const
597 const_iterator m = begin();
598 const_iterator m_end = end();
599 for (; m != m_end; ++m) {
600 if (m->kind() == MenuItem::Command && m->func() == func) {
601 names.push_back(qstring_to_ucs4(m->label()));
604 if (m->kind() == MenuItem::Submenu) {
605 names.push_back(qstring_to_ucs4(m->label()));
606 if (!m->hasSubmenu()) {
607 LYXERR(Debug::GUI, "Warning: non existing sub menu label="
608 << m->label() << " name=" << m->submenuname());
612 if (m->submenu().searchMenu(func, names))
621 bool compareFormat(Format const * p1, Format const * p2)
627 QString limitStringLength(docstring const & str)
629 size_t const max_item_length = 45;
631 if (str.size() > max_item_length)
632 return toqstr(str.substr(0, max_item_length - 3) + "...");
638 void MenuDefinition::expandGraphicsGroups(BufferView const * bv)
643 graphics::getGraphicsGroups(bv->buffer(), grp);
647 set<string>::const_iterator it = grp.begin();
648 set<string>::const_iterator end = grp.end();
649 add(MenuItem(MenuItem::Command, qt_("No Group"),
650 FuncRequest(LFUN_SET_GRAPHICS_GROUP)));
651 for (; it != end; it++) {
652 addWithStatusCheck(MenuItem(MenuItem::Command, toqstr(*it),
653 FuncRequest(LFUN_SET_GRAPHICS_GROUP, *it)));
657 void MenuDefinition::expandLastfiles()
659 LastFilesSection::LastFiles const & lf = theSession().lastFiles().lastFiles();
660 LastFilesSection::LastFiles::const_iterator lfit = lf.begin();
664 for (; lfit != lf.end() && ii < 10; ++lfit, ++ii) {
665 string const file = lfit->absFilename();
666 QString const label = QString("%1. %2|%3").arg(ii)
667 .arg(toqstr(makeDisplayPath(file, 30))).arg(ii);
668 add(MenuItem(MenuItem::Command, label, FuncRequest(LFUN_FILE_OPEN, file)));
673 void MenuDefinition::expandDocuments()
675 Buffer * first = theBufferList().first();
680 // We cannot use a for loop as the buffer list cycles.
682 QString label = toqstr(b->fileName().displayName(20));
683 if (b->isUnnamed() && label.endsWith(".internal")) {
684 // This is an internal Buffer (eg. for clipboard operations)
685 b = theBufferList().next(b);
691 label = QString::number(ii) + ". " + label + '|' + QString::number(ii);
692 add(MenuItem(MenuItem::Command, label,
693 FuncRequest(LFUN_BUFFER_SWITCH, b->absFileName())));
695 b = theBufferList().next(b);
697 } while (b != first);
699 add(MenuItem(MenuItem::Command, qt_("No Documents Open!"),
700 FuncRequest(LFUN_NOACTION)));
705 void MenuDefinition::expandBookmarks()
707 lyx::BookmarksSection const & bm = theSession().bookmarks();
709 for (size_t i = 1; i <= bm.size(); ++i) {
711 string const file = bm.bookmark(i).filename.absFilename();
712 QString const label = QString("%1. %2|%3").arg(i)
713 .arg(toqstr(makeDisplayPath(file, 20))).arg(i);
714 add(MenuItem(MenuItem::Command, label,
715 FuncRequest(LFUN_BOOKMARK_GOTO, convert<docstring>(i))));
721 void MenuDefinition::expandFormats(MenuItem::Kind kind, Buffer const * buf)
723 if (!buf && kind != MenuItem::ImportFormats) {
724 add(MenuItem(MenuItem::Command,
725 qt_("No Document Open!"),
726 FuncRequest(LFUN_NOACTION)));
730 typedef vector<Format const *> Formats;
735 case MenuItem::ImportFormats:
736 formats = theConverters().importableFormats();
737 action = LFUN_BUFFER_IMPORT;
739 case MenuItem::ViewFormats:
740 formats = buf->exportableFormats(true);
741 action = LFUN_BUFFER_VIEW;
743 case MenuItem::UpdateFormats:
744 formats = buf->exportableFormats(true);
745 action = LFUN_BUFFER_UPDATE;
748 formats = buf->exportableFormats(false);
749 action = LFUN_BUFFER_EXPORT;
751 sort(formats.begin(), formats.end(), &compareFormat);
753 Formats::const_iterator fit = formats.begin();
754 Formats::const_iterator end = formats.end();
755 for (; fit != end ; ++fit) {
759 docstring lab = from_utf8((*fit)->prettyname());
760 docstring scut = from_utf8((*fit)->shortcut());
761 docstring const tmplab = lab;
764 lab += char_type('|') + scut;
765 docstring lab_i18n = translateIfPossible(lab);
766 bool const untranslated = (lab == lab_i18n);
767 QString const shortcut = toqstr(split(lab_i18n, lab, '|'));
768 QString label = toqstr(lab);
770 // this might happen if the shortcut
771 // has been redefined
772 label = toqstr(translateIfPossible(tmplab));
775 case MenuItem::ImportFormats:
778 case MenuItem::ViewFormats:
779 case MenuItem::ExportFormats:
780 case MenuItem::UpdateFormats:
781 if (!(*fit)->documentFormat())
785 LASSERT(false, /**/);
788 if (!shortcut.isEmpty())
789 label += '|' + shortcut;
792 addWithStatusCheck(MenuItem(MenuItem::Command, label,
793 FuncRequest(action, (*fit)->name())));
795 add(MenuItem(MenuItem::Command, label,
796 FuncRequest(action, (*fit)->name())));
801 void MenuDefinition::expandFloatListInsert(Buffer const * buf)
804 add(MenuItem(MenuItem::Command, qt_("No Document Open!"),
805 FuncRequest(LFUN_NOACTION)));
809 FloatList const & floats = buf->params().documentClass().floats();
810 FloatList::const_iterator cit = floats.begin();
811 FloatList::const_iterator end = floats.end();
812 for (; cit != end; ++cit) {
813 addWithStatusCheck(MenuItem(MenuItem::Command,
814 qt_(cit->second.listName()),
815 FuncRequest(LFUN_FLOAT_LIST_INSERT,
816 cit->second.type())));
821 void MenuDefinition::expandFloatInsert(Buffer const * buf)
824 add(MenuItem(MenuItem::Command, qt_("No Document Open!"),
825 FuncRequest(LFUN_NOACTION)));
829 FloatList const & floats = buf->params().documentClass().floats();
830 FloatList::const_iterator cit = floats.begin();
831 FloatList::const_iterator end = floats.end();
832 for (; cit != end; ++cit) {
834 QString const label = qt_(cit->second.name());
835 addWithStatusCheck(MenuItem(MenuItem::Command, label,
836 FuncRequest(LFUN_FLOAT_INSERT,
837 cit->second.type())));
842 void MenuDefinition::expandFlexInset(Buffer const * buf, string s)
845 add(MenuItem(MenuItem::Command, qt_("No Document Open!"),
846 FuncRequest(LFUN_NOACTION)));
849 TextClass::InsetLayouts const & insetLayouts =
850 buf->params().documentClass().insetLayouts();
851 TextClass::InsetLayouts::const_iterator cit = insetLayouts.begin();
852 TextClass::InsetLayouts::const_iterator end = insetLayouts.end();
853 for (; cit != end; ++cit) {
854 docstring const label = cit->first;
855 if (cit->second.lyxtype() == s)
856 addWithStatusCheck(MenuItem(MenuItem::Command,
857 toqstr(translateIfPossible(label)),
858 FuncRequest(LFUN_FLEX_INSERT, label)));
863 size_t const max_number_of_items = 25;
865 void MenuDefinition::expandToc2(Toc const & toc_list,
866 size_t from, size_t to, int depth)
868 int shortcut_count = 0;
870 // check whether depth is smaller than the smallest depth in toc.
871 int min_depth = 1000;
872 for (size_t i = from; i < to; ++i)
873 min_depth = min(min_depth, toc_list[i].depth());
874 if (min_depth > depth)
877 if (to - from <= max_number_of_items) {
878 for (size_t i = from; i < to; ++i) {
879 QString label(4 * max(0, toc_list[i].depth() - depth), ' ');
880 label += limitStringLength(toc_list[i].str());
881 if (toc_list[i].depth() == depth
882 && shortcut_count < 9) {
883 if (label.contains(QString::number(shortcut_count + 1)))
884 label += '|' + QString::number(++shortcut_count);
886 add(MenuItem(MenuItem::Command, label,
887 FuncRequest(toc_list[i].action())));
892 size_t new_pos = pos + 1;
893 while (new_pos < to && toc_list[new_pos].depth() > depth)
896 QString label(4 * max(0, toc_list[pos].depth() - depth), ' ');
897 label += limitStringLength(toc_list[pos].str());
898 if (toc_list[pos].depth() == depth &&
899 shortcut_count < 9) {
900 if (label.contains(QString::number(shortcut_count + 1)))
901 label += '|' + QString::number(++shortcut_count);
903 if (new_pos == pos + 1) {
904 add(MenuItem(MenuItem::Command,
905 label, FuncRequest(toc_list[pos].action())));
908 sub.expandToc2(toc_list, pos, new_pos, depth + 1);
909 MenuItem item(MenuItem::Submenu, label);
910 item.setSubmenu(sub);
919 void MenuDefinition::expandToc(Buffer const * buf)
921 // To make things very cleanly, we would have to pass buf to
922 // all MenuItem constructors and to expandToc2. However, we
923 // know that all the entries in a TOC will be have status_ ==
924 // OK, so we avoid this unnecessary overhead (JMarc)
927 add(MenuItem(MenuItem::Command, qt_("No Document Open!"),
928 FuncRequest(LFUN_NOACTION)));
932 // Add an entry for the master doc if this is a child doc
933 Buffer const * const master = buf->masterBuffer();
935 ParIterator const pit = par_iterator_begin(master->inset());
936 string const arg = convert<string>(pit->id());
937 FuncRequest f(LFUN_PARAGRAPH_GOTO, arg);
938 add(MenuItem(MenuItem::Command, qt_("Master Document"), f));
941 MenuDefinition other_lists;
943 FloatList const & floatlist = buf->params().documentClass().floats();
944 TocList const & toc_list = buf->tocBackend().tocs();
945 TocList::const_iterator cit = toc_list.begin();
946 TocList::const_iterator end = toc_list.end();
947 for (; cit != end; ++cit) {
949 if (cit->first == "tableofcontents")
952 MenuDefinition submenu;
953 if (cit->second.size() >= 30) {
954 FuncRequest f(LFUN_DIALOG_SHOW, "toc " + cit->first);
955 submenu.add(MenuItem(MenuItem::Command, qt_("Open Navigator..."), f));
957 TocIterator ccit = cit->second.begin();
958 TocIterator eend = cit->second.end();
959 for (; ccit != eend; ++ccit) {
960 submenu.add(MenuItem(MenuItem::Command,
961 limitStringLength(ccit->str()),
962 FuncRequest(ccit->action())));
966 MenuItem item(MenuItem::Submenu, guiName(cit->first, buf->params()));
967 item.setSubmenu(submenu);
968 if (floatlist.typeExist(cit->first) || cit->first == "child") {
969 // Those two types deserve to be in the main menu.
970 item.setSubmenu(submenu);
973 other_lists.add(item);
975 if (!other_lists.empty()) {
976 MenuItem item(MenuItem::Submenu, qt_("Other Lists"));
977 item.setSubmenu(other_lists);
982 cit = toc_list.find("tableofcontents");
984 addWithStatusCheck(MenuItem(MenuItem::Command,
985 qt_("No Table of contents"),
988 expandToc2(cit->second, 0, cit->second.size(), 0);
992 void MenuDefinition::expandPasteRecent(Buffer const * buf)
994 docstring_list const sel = cap::availableSelections(buf);
996 docstring_list::const_iterator cit = sel.begin();
997 docstring_list::const_iterator end = sel.end();
999 for (unsigned int index = 0; cit != end; ++cit, ++index) {
1000 add(MenuItem(MenuItem::Command, toqstr(*cit),
1001 FuncRequest(LFUN_PASTE, convert<string>(index))));
1006 void MenuDefinition::expandToolbars()
1008 MenuDefinition other_lists;
1009 // extracts the toolbars from the backend
1010 Toolbars::Infos::const_iterator cit = guiApp->toolbars().begin();
1011 Toolbars::Infos::const_iterator end = guiApp->toolbars().end();
1012 for (; cit != end; ++cit) {
1013 MenuItem const item(MenuItem::Command, toqstr(cit->gui_name),
1014 FuncRequest(LFUN_TOOLBAR_TOGGLE, cit->name));
1015 if (guiApp->toolbars().isMainToolbar(cit->name))
1018 other_lists.add(item);
1021 if (!other_lists.empty()) {
1022 MenuItem item(MenuItem::Submenu, qt_("Other Toolbars"));
1023 item.setSubmenu(other_lists);
1029 void MenuDefinition::expandBranches(Buffer const * buf)
1032 add(MenuItem(MenuItem::Command,
1033 qt_("No Document Open!"),
1034 FuncRequest(LFUN_NOACTION)));
1038 BufferParams const & params = buf->masterBuffer()->params();
1039 if (params.branchlist().empty()) {
1040 add(MenuItem(MenuItem::Command,
1041 qt_("No Branch in Document!"),
1042 FuncRequest(LFUN_NOACTION)));
1046 BranchList::const_iterator cit = params.branchlist().begin();
1047 BranchList::const_iterator end = params.branchlist().end();
1049 for (int ii = 1; cit != end; ++cit, ++ii) {
1050 docstring label = cit->branch();
1052 label = convert<docstring>(ii) + ". " + label
1053 + char_type('|') + convert<docstring>(ii);
1055 addWithStatusCheck(MenuItem(MenuItem::Command, toqstr(label),
1056 FuncRequest(LFUN_BRANCH_INSERT,
1062 void MenuDefinition::expandCiteStyles(BufferView const * bv)
1065 add(MenuItem(MenuItem::Command,
1066 qt_("No Document Open!"),
1067 FuncRequest(LFUN_NOACTION)));
1071 Inset const * inset = bv->cursor().nextInset();
1072 if (!inset || inset->lyxCode() != CITE_CODE) {
1073 add(MenuItem(MenuItem::Command,
1074 qt_("No Citation in Scope!"),
1075 FuncRequest(LFUN_NOACTION)));
1078 InsetCommand const * citinset =
1079 static_cast<InsetCommand const *>(inset);
1081 Buffer const * buf = &bv->buffer();
1082 docstring key = citinset->getParam("key");
1083 // we can only handle one key currently
1084 if (contains(key, ','))
1085 key = qstring_to_ucs4(toqstr(key).split(',')[0]);
1087 vector<CiteStyle> citeStyleList = citeStyles(buf->params().citeEngine());
1088 docstring_list citeStrings =
1089 buf->masterBibInfo().getCiteStrings(key, bv->buffer());
1091 docstring_list::const_iterator cit = citeStrings.begin();
1092 docstring_list::const_iterator end = citeStrings.end();
1094 for (int ii = 1; cit != end; ++cit, ++ii) {
1095 docstring label = *cit;
1097 CiteStyle cst = citeStyleList[ii - 1];
1099 addWithStatusCheck(MenuItem(MenuItem::Command, toqstr(label),
1100 FuncRequest(LFUN_NEXT_INSET_MODIFY,
1101 "changetype " + from_utf8(citationStyleToString(cs)))));
1108 /////////////////////////////////////////////////////////////////////
1109 // Menu::Impl definition and implementation
1110 /////////////////////////////////////////////////////////////////////
1114 /// populates the menu or one of its submenu
1115 /// This is used as a recursive function
1116 void populate(QMenu & qMenu, MenuDefinition const & menu);
1118 /// Only needed for top level menus.
1119 MenuDefinition * top_level_menu;
1122 /// the name of this menu
1128 /// Get a MenuDefinition item label from the menu backend
1129 static QString label(MenuItem const & mi)
1131 QString label = mi.label();
1132 label.replace("&", "&&");
1134 QString shortcut = mi.shortcut();
1135 if (!shortcut.isEmpty()) {
1136 int pos = label.indexOf(shortcut);
1138 //label.insert(pos, 1, char_type('&'));
1139 label.replace(pos, 0, "&");
1142 QString const binding = mi.binding();
1143 if (!binding.isEmpty())
1144 label += '\t' + binding;
1149 void Menu::Impl::populate(QMenu & qMenu, MenuDefinition const & menu)
1151 LYXERR(Debug::GUI, "populating menu " << menu.name());
1152 if (menu.size() == 0) {
1153 LYXERR(Debug::GUI, "\tERROR: empty menu " << menu.name());
1156 LYXERR(Debug::GUI, " ***** menu entries " << menu.size());
1157 MenuDefinition::const_iterator m = menu.begin();
1158 MenuDefinition::const_iterator end = menu.end();
1159 for (; m != end; ++m) {
1160 if (m->kind() == MenuItem::Separator)
1161 qMenu.addSeparator();
1162 else if (m->kind() == MenuItem::Submenu) {
1163 QMenu * subMenu = qMenu.addMenu(label(*m));
1164 populate(*subMenu, m->submenu());
1166 // we have a MenuItem::Command
1167 qMenu.addAction(new Action(view, QIcon(), label(*m),
1168 m->func(), QString(), &qMenu));
1173 /////////////////////////////////////////////////////////////////////
1174 // Menu implementation
1175 /////////////////////////////////////////////////////////////////////
1177 Menu::Menu(GuiView * gv, QString const & name, bool top_level)
1178 : QMenu(gv), d(new Menu::Impl)
1180 d->top_level_menu = top_level? new MenuDefinition : 0;
1184 if (d->top_level_menu)
1185 connect(this, SIGNAL(aboutToShow()), this, SLOT(updateView()));
1191 delete d->top_level_menu;
1196 void Menu::updateView()
1198 guiApp->menus().updateMenu(this);
1202 /////////////////////////////////////////////////////////////////////
1203 // Menus::Impl definition and implementation
1204 /////////////////////////////////////////////////////////////////////
1206 struct Menus::Impl {
1208 bool hasMenu(QString const &) const;
1210 MenuDefinition & getMenu(QString const &);
1212 MenuDefinition const & getMenu(QString const &) const;
1214 /// Expands some special entries of the menu
1215 /** The entries with the following kind are expanded to a
1216 sequence of Command MenuItems: Lastfiles, Documents,
1217 ViewFormats, ExportFormats, UpdateFormats, Branches
1219 void expand(MenuDefinition const & frommenu, MenuDefinition & tomenu,
1220 BufferView const *) const;
1222 /// Initialize specific MACOS X menubar
1223 void macxMenuBarInit(GuiView * view, QMenuBar * qmb);
1225 /// Mac special menu.
1226 /** This defines a menu whose entries list the FuncRequests
1227 that will be removed by expand() in other menus. This is
1228 used by the Qt/Mac code
1230 MenuDefinition specialmenu_;
1235 MenuDefinition menubar_;
1237 typedef QMap<GuiView *, QHash<QString, Menu*> > NameMap;
1239 /// name to menu for \c menu() method.
1244 Here is what the Qt documentation says about how a menubar is chosen:
1246 1) If the window has a QMenuBar then it is used. 2) If the window
1247 is a modal then its menubar is used. If no menubar is specified
1248 then a default menubar is used (as documented below) 3) If the
1249 window has no parent then the default menubar is used (as
1252 The above 3 steps are applied all the way up the parent window
1253 chain until one of the above are satisifed. If all else fails a
1254 default menubar will be created, the default menubar on Qt/Mac is
1255 an empty menubar, however you can create a different default
1256 menubar by creating a parentless QMenuBar, the first one created
1257 will thus be designated the default menubar, and will be used
1258 whenever a default menubar is needed.
1260 Thus, for Qt/Mac, we add the menus to a free standing menubar, so
1261 that this menubar will be used also when one of LyX' dialogs has
1264 void Menus::Impl::macxMenuBarInit(GuiView * view, QMenuBar * qmb)
1266 /* Since Qt 4.2, the qt/mac menu code has special code for
1267 specifying the role of a menu entry. However, it does not
1268 work very well with our scheme of creating menus on demand,
1269 and therefore we need to put these entries in a special
1270 invisible menu. (JMarc)
1273 /* The entries of our special mac menu. If we add support for
1274 * special entries in Menus, we could imagine something
1276 * SpecialItem About " "About LyX" "dialog-show aboutlyx"
1277 * and therefore avoid hardcoding. I am not sure it is worth
1278 * the hassle, though. (JMarc)
1280 struct MacMenuEntry {
1284 QAction::MenuRole role;
1287 MacMenuEntry entries[] = {
1288 {LFUN_DIALOG_SHOW, "aboutlyx", "About LyX",
1289 QAction::AboutRole},
1290 {LFUN_DIALOG_SHOW, "prefs", "Preferences",
1291 QAction::PreferencesRole},
1292 {LFUN_RECONFIGURE, "", "Reconfigure",
1293 QAction::ApplicationSpecificRole},
1294 {LFUN_LYX_QUIT, "", "Quit LyX", QAction::QuitRole}
1296 const size_t num_entries = sizeof(entries) / sizeof(entries[0]);
1298 // the special menu for Menus. Fill it up only once.
1299 if (specialmenu_.size() == 0) {
1300 for (size_t i = 0 ; i < num_entries ; ++i) {
1301 FuncRequest const func(entries[i].action,
1302 from_utf8(entries[i].arg));
1303 specialmenu_.add(MenuItem(MenuItem::Command,
1304 entries[i].label, func));
1308 // add the entries to a QMenu that will eventually be empty
1309 // and therefore invisible.
1310 QMenu * qMenu = qmb->addMenu("special");
1311 MenuDefinition::const_iterator cit = specialmenu_.begin();
1312 MenuDefinition::const_iterator end = specialmenu_.end();
1313 for (size_t i = 0 ; cit != end ; ++cit, ++i) {
1314 Action * action = new Action(view, QIcon(), cit->label(),
1315 cit->func(), QString(), qMenu);
1316 action->setMenuRole(entries[i].role);
1317 qMenu->addAction(action);
1322 void Menus::Impl::expand(MenuDefinition const & frommenu,
1323 MenuDefinition & tomenu, BufferView const * bv) const
1325 if (!tomenu.empty())
1328 for (MenuDefinition::const_iterator cit = frommenu.begin();
1329 cit != frommenu.end() ; ++cit) {
1330 Buffer const * buf = bv ? &bv->buffer() : 0;
1331 switch (cit->kind()) {
1332 case MenuItem::Lastfiles:
1333 tomenu.expandLastfiles();
1336 case MenuItem::Documents:
1337 tomenu.expandDocuments();
1340 case MenuItem::Bookmarks:
1341 tomenu.expandBookmarks();
1344 case MenuItem::ImportFormats:
1345 case MenuItem::ViewFormats:
1346 case MenuItem::UpdateFormats:
1347 case MenuItem::ExportFormats:
1348 tomenu.expandFormats(cit->kind(), buf);
1351 case MenuItem::CharStyles:
1352 tomenu.expandFlexInset(buf, "charstyle");
1355 case MenuItem::Custom:
1356 tomenu.expandFlexInset(buf, "custom");
1359 case MenuItem::Elements:
1360 tomenu.expandFlexInset(buf, "element");
1363 case MenuItem::FloatListInsert:
1364 tomenu.expandFloatListInsert(buf);
1367 case MenuItem::FloatInsert:
1368 tomenu.expandFloatInsert(buf);
1371 case MenuItem::PasteRecent:
1372 tomenu.expandPasteRecent(buf);
1375 case MenuItem::Toolbars:
1376 tomenu.expandToolbars();
1379 case MenuItem::Branches:
1380 tomenu.expandBranches(buf);
1383 case MenuItem::CiteStyles:
1384 tomenu.expandCiteStyles(bv);
1388 tomenu.expandToc(buf);
1391 case MenuItem::GraphicsGroups:
1392 tomenu.expandGraphicsGroups(bv);
1395 case MenuItem::Submenu: {
1396 MenuItem item(*cit);
1397 item.setSubmenu(MenuDefinition(cit->submenuname()));
1398 expand(getMenu(cit->submenuname()), item.submenu(), bv);
1399 tomenu.addWithStatusCheck(item);
1403 case MenuItem::Separator:
1404 tomenu.addWithStatusCheck(*cit);
1407 case MenuItem::Command:
1408 if (!specialmenu_.hasFunc(cit->func()))
1409 tomenu.addWithStatusCheck(*cit);
1413 // we do not want the menu to end with a separator
1414 if (!tomenu.empty() && tomenu.items_.back().kind() == MenuItem::Separator)
1415 tomenu.items_.pop_back();
1417 // Check whether the shortcuts are unique
1418 tomenu.checkShortcuts();
1422 bool Menus::Impl::hasMenu(QString const & name) const
1424 return find_if(menulist_.begin(), menulist_.end(),
1425 MenuNamesEqual(name)) != menulist_.end();
1429 MenuDefinition const & Menus::Impl::getMenu(QString const & name) const
1431 const_iterator cit = find_if(menulist_.begin(), menulist_.end(),
1432 MenuNamesEqual(name));
1433 if (cit == menulist_.end())
1434 LYXERR0("No submenu named " << name);
1435 LASSERT(cit != menulist_.end(), /**/);
1440 MenuDefinition & Menus::Impl::getMenu(QString const & name)
1442 iterator it = find_if(menulist_.begin(), menulist_.end(),
1443 MenuNamesEqual(name));
1444 if (it == menulist_.end())
1445 LYXERR0("No submenu named " << name);
1446 LASSERT(it != menulist_.end(), /**/);
1451 /////////////////////////////////////////////////////////////////////
1455 /////////////////////////////////////////////////////////////////////
1457 Menus::Menus() : d(new Impl) {}
1473 void Menus::read(Lexer & lex)
1481 LexerKeyword menutags[] = {
1482 { "end", md_endmenuset },
1483 { "menu", md_menu },
1484 { "menubar", md_menubar }
1487 // consistency check
1488 if (compare_ascii_no_case(lex.getString(), "menuset"))
1489 LYXERR0("Menus::read: ERROR wrong token: `" << lex.getString() << '\'');
1491 lex.pushTable(menutags);
1492 lex.setContext("Menus::read");
1496 while (lex.isOK() && !quit) {
1497 switch (lex.lex()) {
1499 d->menubar_.read(lex);
1503 QString const name = toqstr(lex.getDocString());
1504 if (d->hasMenu(name))
1505 d->getMenu(name).read(lex);
1507 MenuDefinition menu(name);
1509 d->menulist_.push_back(menu);
1517 lex.printError("Unknown menu tag");
1525 bool Menus::searchMenu(FuncRequest const & func,
1526 docstring_list & names) const
1528 MenuDefinition menu;
1529 d->expand(d->menubar_, menu, 0);
1530 return menu.searchMenu(func, names);
1534 void Menus::fillMenuBar(QMenuBar * qmb, GuiView * view, bool initial)
1538 // setup special mac specific menu item
1539 d->macxMenuBarInit(view, qmb);
1542 // Clear all menubar contents before filling it.
1546 LYXERR(Debug::GUI, "populating menu bar" << d->menubar_.name());
1548 if (d->menubar_.size() == 0) {
1549 LYXERR(Debug::GUI, "\tERROR: empty menu bar"
1550 << d->menubar_.name());
1553 LYXERR(Debug::GUI, "menu bar entries " << d->menubar_.size());
1555 MenuDefinition menu;
1556 BufferView * bv = 0;
1559 d->expand(d->menubar_, menu, bv);
1561 MenuDefinition::const_iterator m = menu.begin();
1562 MenuDefinition::const_iterator end = menu.end();
1564 for (; m != end; ++m) {
1566 if (m->kind() != MenuItem::Submenu) {
1567 LYXERR(Debug::GUI, "\tERROR: not a submenu " << m->label());
1571 LYXERR(Debug::GUI, "menu bar item " << m->label()
1572 << " is a submenu named " << m->submenuname());
1574 QString name = m->submenuname();
1575 if (!d->hasMenu(name)) {
1576 LYXERR(Debug::GUI, "\tERROR: " << name
1577 << " submenu has no menu!");
1581 Menu * menu = new Menu(view, m->submenuname(), true);
1582 menu->setTitle(label(*m));
1585 d->name_map_[view][name] = menu;
1590 void Menus::updateMenu(Menu * qmenu)
1592 LYXERR(Debug::GUI, "Triggered menu: " << qmenu->d->name);
1595 if (qmenu->d->name.isEmpty())
1598 // Here, We make sure that theLyXFunc points to the correct LyXView.
1599 theLyXFunc().setLyXView(qmenu->d->view);
1601 if (!d->hasMenu(qmenu->d->name)) {
1602 qmenu->addAction(qt_("No action defined!"));
1603 LYXERR(Debug::GUI, "\tWARNING: non existing menu: "
1608 MenuDefinition const & fromLyxMenu = d->getMenu(qmenu->d->name);
1609 BufferView * bv = 0;
1611 bv = qmenu->d->view->view();
1612 d->expand(fromLyxMenu, *qmenu->d->top_level_menu, bv);
1613 qmenu->d->populate(*qmenu, *qmenu->d->top_level_menu);
1617 Menu * Menus::menu(QString const & name, GuiView & view)
1619 LYXERR(Debug::GUI, "Context menu requested: " << name);
1620 Menu * menu = d->name_map_[&view].value(name, 0);
1621 if (!menu && !name.startsWith("context-")) {
1622 LYXERR0("requested context menu not found: " << name);
1626 menu = new Menu(&view, name, true);
1627 d->name_map_[&view][name] = menu;
1631 } // namespace frontend
1634 #include "Menus_moc.cpp"