src/frontends/qt4/Menus.cpp

   1 /**
   2  * \file qt4/Menus.cpp
   3  * This file is part of LyX, the document processor.
   4  * Licence details can be found in the file COPYING.
   5  *
   6  * \author John Levon
   7  * \author Asger Alstrup
   8  * \author Lars Gullik Bjønnes
   9  * \author Jean-Marc Lasgouttes
  10  * \author André Pönitz
  11  * \author Dekel Tsur
  12  * \author Martin Vermeer
  13  *
  14  * Full author contact details are available in file CREDITS.
  15  */
  16
  17 #include <config.h>
  18
  19 #include "Menus.h"
  20
  21 #include "Action.h"
  22 #include "GuiApplication.h"
  23 #include "GuiView.h"
  24 #include "qt_helpers.h"
  25
  26 #include "BiblioInfo.h"
  27 #include "BranchList.h"
  28 #include "Buffer.h"
  29 #include "BufferList.h"
  30 #include "BufferParams.h"
  31 #include "BufferView.h"
  32 #include "Converter.h"
  33 #include "CutAndPaste.h"
  34 #include "Floating.h"
  35 #include "FloatList.h"
  36 #include "Format.h"
  37 #include "FuncRequest.h"
  38 #include "FuncStatus.h"
  39 #include "IndicesList.h"
  40 #include "KeyMap.h"
  41 #include "Lexer.h"
  42 #include "LyXAction.h"
  43 #include "LyX.h" // for lastfiles
  44 #include "LyXFunc.h"
  45 #include "LyXRC.h"
  46 #include "Paragraph.h"
  47 #include "ParIterator.h"
  48 #include "Session.h"
  49 #include "TextClass.h"
  50 #include "TocBackend.h"
  51 #include "Toolbars.h"
  52 #include "WordLangTuple.h"
  53
  54 #include "insets/Inset.h"
  55 #include "insets/InsetCitation.h"
  56 #include "insets/InsetGraphics.h"
  57
  58 #include "support/lassert.h"
  59 #include "support/convert.h"
  60 #include "support/debug.h"
  61 #include "support/docstring_list.h"
  62 #include "support/filetools.h"
  63 #include "support/gettext.h"
  64 #include "support/lstrings.h"
  65
  66 #include <QCursor>
  67 #include <QHash>
  68 #include <QList>
  69 #include <QMenuBar>
  70 #include <QString>
  71
  72 #include <boost/shared_ptr.hpp>
  73
  74 #include <algorithm>
  75 #include <vector>
  76
  77 using namespace std;
  78 using namespace lyx::support;
  79
  80
  81 namespace lyx {
  82 namespace frontend {
  83
  84 namespace {
  85
  86 // MacOSX specific stuff is at the end.
  87
  88 class MenuDefinition;
  89
  90 ///
  91 class MenuItem {
  92 public:
  93         /// The type of elements that can be in a menu
  94         enum Kind {
  95                 ///
  96                 Command,
  97                 ///
  98                 Submenu,
  99                 ///
 100                 Separator,
 101                 /** This type of item explains why something is unavailable. If this
 102                     menuitem is in a submenu, the submenu is enabled to make sure the
 103                     user sees the information. */
 104                 Help,
 105                 /** This type of item merely shows that there might be a list or
 106                     something alike at this position, but the list is still empty.
 107                     If this item is in a submenu, the submenu will not always be
 108                     enabled. */
 109                 Info,
 110                 /** This is the list of last opened file,
 111                     typically for the File menu. */
 112                 Lastfiles,
 113                 /** This is the list of opened Documents,
 114                     typically for the Documents menu. */
 115                 Documents,
 116                 /** This is the bookmarks */
 117                 Bookmarks,
 118                 ///
 119                 Toc,
 120                 /** This is a list of viewable formats
 121                     typically for the File->View menu. */
 122                 ViewFormats,
 123                 /** This is a list of updatable formats
 124                     typically for the File->Update menu. */
 125                 UpdateFormats,
 126                 /** This is a list of exportable formats
 127                     typically for the File->Export menu. */
 128                 ExportFormats,
 129                 /** This is a list of importable formats
 130                     typically for the File->Export menu. */
 131                 ImportFormats,
 132                 /** This is the list of elements available
 133                  * for insertion into document. */
 134                 CharStyles,
 135                 /** This is the list of user-configurable
 136                 insets to insert into document */
 137                 Custom,
 138                 /** This is the list of XML elements to
 139                 insert into the document */
 140                 Elements,
 141                 /** This is the list of floats that we can
 142                     insert a list for. */
 143                 FloatListInsert,
 144                 /** This is the list of floats that we can
 145                     insert. */
 146                 FloatInsert,
 147                 /** This is the list of selections that can
 148                     be pasted. */
 149                 PasteRecent,
 150                 /** toolbars */
 151                 Toolbars,
 152                 /** Available branches in document */
 153                 Branches,
 154                 /** Available indices in document */
 155                 Indices,
 156                 /** Context menu for indices in document */
 157                 IndicesContext,
 158                 /** Available index lists in document */
 159                 IndicesLists,
 160                 /** Context menu for available indices lists in document */
 161                 IndicesListsContext,
 162                 /** Available citation styles for a given citation */
 163                 CiteStyles,
 164                 /** Available graphics groups */
 165                 GraphicsGroups,
 166                 /// Words suggested by the spellchecker.
 167                 SpellingSuggestions
 168         };
 169
 170         explicit MenuItem(Kind kind) : kind_(kind), optional_(false) {}
 171
 172         MenuItem(Kind kind,
 173                  QString const & label,
 174                  QString const & submenu = QString(),
 175                  bool optional = false)
 176                 : kind_(kind), label_(label), submenuname_(submenu), optional_(optional)
 177         {
 178                 LASSERT(kind == Submenu || kind == Help || kind == Info, /**/);
 179         }
 180
 181         MenuItem(Kind kind,
 182                  QString const & label,
 183                  FuncRequest const & func,
 184                  bool optional = false,
 185                  FuncRequest::Origin origin = FuncRequest::MENU)
 186                 : kind_(kind), label_(label), func_(func), optional_(optional)
 187         {
 188                 func_.origin = origin;
 189         }
 190
 191         // boost::shared_ptr<MenuDefinition> needs this apprently...
 192         ~MenuItem() {}
 193
 194         /// The label of a given menuitem
 195         QString label() const { return label_.split('|')[0]; }
 196
 197         /// The keyboard shortcut (usually underlined in the entry)
 198         QString shortcut() const
 199         {
 200                 return label_.contains('|') ? label_.split('|')[1] : QString();
 201         }
 202         /// The complete label, with label and shortcut separated by a '|'
 203         QString fulllabel() const { return label_;}
 204         /// The kind of entry
 205         Kind kind() const { return kind_; }
 206         /// the action (if relevant)
 207         FuncRequest const & func() const { return func_; }
 208         /// returns true if the entry should be ommited when disabled
 209         bool optional() const { return optional_; }
 210         /// returns the status of the lfun associated with this entry
 211         FuncStatus const & status() const { return status_; }
 212         /// returns the status of the lfun associated with this entry
 213         FuncStatus & status() { return status_; }
 214         /// returns the status of the lfun associated with this entry
 215         void status(FuncStatus const & status) { status_ = status; }
 216
 217         ///returns the binding associated to this action.
 218         QString binding() const
 219         {
 220                 if (kind_ != Command)
 221                         return QString();
 222                 // Get the keys bound to this action, but keep only the
 223                 // first one later
 224                 KeyMap::Bindings bindings = theTopLevelKeymap().findBindings(func_);
 225                 if (bindings.size())
 226                         return toqstr(bindings.begin()->print(KeySequence::ForGui));
 227
 228                 LYXERR(Debug::KBMAP, "No binding for "
 229                         << lyxaction.getActionName(func_.action)
 230                         << '(' << func_.argument() << ')');
 231                 return QString();
 232         }
 233
 234         /// the description of the  submenu (if relevant)
 235         QString const & submenuname() const { return submenuname_; }
 236         /// set the description of the  submenu
 237         void submenuname(QString const & name) { submenuname_ = name; }
 238         ///
 239         bool hasSubmenu() const { return !submenu_.isEmpty(); }
 240         ///
 241         MenuDefinition const & submenu() const { return submenu_.at(0); }
 242         MenuDefinition & submenu() { return submenu_[0]; }
 243         ///
 244         void setSubmenu(MenuDefinition const & menu)
 245         {
 246                 submenu_.clear();
 247                 submenu_.append(menu);
 248         }
 249
 250 private:
 251         ///
 252         Kind kind_;
 253         ///
 254         QString label_;
 255         ///
 256         FuncRequest func_;
 257         ///
 258         QString submenuname_;
 259         ///
 260         bool optional_;
 261         ///
 262         FuncStatus status_;
 263         /// contains 0 or 1 item.
 264         QList<MenuDefinition> submenu_;
 265 };
 266
 267 ///
 268 class MenuDefinition {
 269 public:
 270         ///
 271         typedef std::vector<MenuItem> ItemList;
 272         ///
 273         typedef ItemList::const_iterator const_iterator;
 274         ///
 275         explicit MenuDefinition(QString const & name = QString()) : name_(name) {}
 276
 277         ///
 278         void read(Lexer &);
 279         ///
 280         QString const & name() const { return name_; }
 281         ///
 282         bool empty() const { return items_.empty(); }
 283         /// Clear the menu content.
 284         void clear() { items_.clear(); }
 285         ///
 286         size_t size() const { return items_.size(); }
 287         ///
 288         MenuItem const & operator[](size_t) const;
 289         ///
 290         const_iterator begin() const { return items_.begin(); }
 291         ///
 292         const_iterator end() const { return items_.end(); }
 293
 294         // search for func in this menu iteratively, and put menu
 295         // names in a stack.
 296         bool searchMenu(FuncRequest const & func, docstring_list & names)
 297                 const;
 298         ///
 299         bool hasFunc(FuncRequest const &) const;
 300         /// Add the menu item unconditionally
 301         void add(MenuItem const & item) { items_.push_back(item); }
 302         /// Checks the associated FuncRequest status before adding the
 303         /// menu item.
 304         void addWithStatusCheck(MenuItem const &);
 305         // Check whether the menu shortcuts are unique
 306         void checkShortcuts() const;
 307         ///
 308         void expandLastfiles();
 309         void expandDocuments();
 310         void expandBookmarks();
 311         void expandFormats(MenuItem::Kind kind, Buffer const * buf);
 312         void expandFloatListInsert(Buffer const * buf);
 313         void expandFloatInsert(Buffer const * buf);
 314         void expandFlexInsert(Buffer const * buf, InsetLayout::InsetLyXType type);
 315         void expandToc2(Toc const & toc_list, size_t from, size_t to, int depth);
 316         void expandToc(Buffer const * buf);
 317         void expandPasteRecent(Buffer const * buf);
 318         void expandToolbars();
 319         void expandBranches(Buffer const * buf);
 320         void expandIndices(Buffer const * buf, bool listof = false);
 321         void expandIndicesContext(Buffer const * buf, bool listof = false);
 322         void expandCiteStyles(BufferView const *);
 323         void expandGraphicsGroups(BufferView const *);
 324         void expandSpellingSuggestions(BufferView const *);
 325         ///
 326         ItemList items_;
 327         ///
 328         QString name_;
 329 };
 330
 331
 332 /// Helper for std::find_if
 333 class MenuNamesEqual
 334 {
 335 public:
 336         MenuNamesEqual(QString const & name) : name_(name) {}
 337         bool operator()(MenuDefinition const & menu) const { return menu.name() == name_; }
 338 private:
 339         QString name_;
 340 };
 341
 342
 343 ///
 344 typedef std::vector<MenuDefinition> MenuList;
 345 ///
 346 typedef MenuList::const_iterator const_iterator;
 347 ///
 348 typedef MenuList::iterator iterator;
 349
 350 /////////////////////////////////////////////////////////////////////
 351 // MenuDefinition implementation
 352 /////////////////////////////////////////////////////////////////////
 353
 354 void MenuDefinition::addWithStatusCheck(MenuItem const & i)
 355 {
 356         switch (i.kind()) {
 357
 358         case MenuItem::Command: {
 359                 FuncStatus status = lyx::getStatus(i.func());
 360                 if (status.unknown() || (!status.enabled() && i.optional()))
 361                         break;
 362                 items_.push_back(i);
 363                 items_.back().status(status);
 364                 break;
 365         }
 366
 367         case MenuItem::Submenu: {
 368                 bool enabled = false;
 369                 if (i.hasSubmenu()) {
 370                         for (const_iterator cit = i.submenu().begin();
 371                                   cit != i.submenu().end(); ++cit) {
 372                                 // Only these kind of items affect the status of the submenu
 373                                 if ((cit->kind() == MenuItem::Command
 374                                         || cit->kind() == MenuItem::Submenu
 375                                         || cit->kind() == MenuItem::Help)
 376                                     && cit->status().enabled()) {
 377                                         enabled = true;
 378                                         break;
 379                                 }
 380                         }
 381                 }
 382                 if (enabled || !i.optional()) {
 383                         items_.push_back(i);
 384                         items_.back().status().setEnabled(enabled);
 385                 }
 386                 break;
 387         }
 388
 389         case MenuItem::Separator:
 390                 if (!items_.empty() && items_.back().kind() != MenuItem::Separator)
 391                         items_.push_back(i);
 392                 break;
 393
 394         default:
 395                 items_.push_back(i);
 396         }
 397 }
 398
 399
 400 void MenuDefinition::read(Lexer & lex)
 401 {
 402         enum {
 403                 md_item = 1,
 404                 md_branches,
 405                 md_citestyles,
 406                 md_documents,
 407                 md_bookmarks,
 408                 md_charstyles,
 409                 md_custom,
 410                 md_elements,
 411                 md_endmenu,
 412                 md_exportformats,
 413                 md_importformats,
 414                 md_indices,
 415                 md_indicescontext,
 416                 md_indiceslists,
 417                 md_indiceslistscontext,
 418                 md_lastfiles,
 419                 md_optitem,
 420                 md_optsubmenu,
 421                 md_separator,
 422                 md_submenu,
 423                 md_toc,
 424                 md_updateformats,
 425                 md_viewformats,
 426                 md_floatlistinsert,
 427                 md_floatinsert,
 428                 md_pasterecent,
 429                 md_toolbars,
 430                 md_graphicsgroups,
 431                 md_spellingsuggestions
 432         };
 433
 434         LexerKeyword menutags[] = {
 435                 { "bookmarks", md_bookmarks },
 436                 { "branches", md_branches },
 437                 { "charstyles", md_charstyles },
 438                 { "citestyles", md_citestyles },
 439                 { "custom", md_custom },
 440                 { "documents", md_documents },
 441                 { "elements", md_elements },
 442                 { "end", md_endmenu },
 443                 { "exportformats", md_exportformats },
 444                 { "floatinsert", md_floatinsert },
 445                 { "floatlistinsert", md_floatlistinsert },
 446                 { "graphicsgroups", md_graphicsgroups },
 447                 { "importformats", md_importformats },
 448                 { "indices", md_indices },
 449                 { "indicescontext", md_indicescontext },
 450                 { "indiceslists", md_indiceslists },
 451                 { "indiceslistscontext", md_indiceslistscontext },
 452                 { "item", md_item },
 453                 { "lastfiles", md_lastfiles },
 454                 { "optitem", md_optitem },
 455                 { "optsubmenu", md_optsubmenu },
 456                 { "pasterecent", md_pasterecent },
 457                 { "separator", md_separator },
 458                 { "spellingsuggestions", md_spellingsuggestions },
 459                 { "submenu", md_submenu },
 460                 { "toc", md_toc },
 461                 { "toolbars", md_toolbars },
 462                 { "updateformats", md_updateformats },
 463                 { "viewformats", md_viewformats }
 464         };
 465
 466         lex.pushTable(menutags);
 467         lex.setContext("MenuDefinition::read: ");
 468
 469         bool quit = false;
 470         bool optional = false;
 471
 472         while (lex.isOK() && !quit) {
 473                 switch (lex.lex()) {
 474                 case md_optitem:
 475                         optional = true;
 476                         // fallback to md_item
 477                 case md_item: {
 478                         lex.next(true);
 479                         docstring const name = translateIfPossible(lex.getDocString());
 480                         lex.next(true);
 481                         string const command = lex.getString();
 482                         FuncRequest func = lyxaction.lookupFunc(command);
 483                         FuncRequest::Origin origin = FuncRequest::MENU;
 484                         if (name_.startsWith("context-toc-"))
 485                                 origin = FuncRequest::TOC;
 486                         add(MenuItem(MenuItem::Command, toqstr(name), func, optional, origin));
 487                         optional = false;
 488                         break;
 489                 }
 490
 491                 case md_separator:
 492                         add(MenuItem(MenuItem::Separator));
 493                         break;
 494
 495                 case md_lastfiles:
 496                         add(MenuItem(MenuItem::Lastfiles));
 497                         break;
 498
 499                 case md_charstyles:
 500                         add(MenuItem(MenuItem::CharStyles));
 501                         break;
 502
 503                 case md_custom:
 504                         add(MenuItem(MenuItem::Custom));
 505                         break;
 506
 507                 case md_elements:
 508                         add(MenuItem(MenuItem::Elements));
 509                         break;
 510
 511                 case md_documents:
 512                         add(MenuItem(MenuItem::Documents));
 513                         break;
 514
 515                 case md_bookmarks:
 516                         add(MenuItem(MenuItem::Bookmarks));
 517                         break;
 518
 519                 case md_toc:
 520                         add(MenuItem(MenuItem::Toc));
 521                         break;
 522
 523                 case md_viewformats:
 524                         add(MenuItem(MenuItem::ViewFormats));
 525                         break;
 526
 527                 case md_updateformats:
 528                         add(MenuItem(MenuItem::UpdateFormats));
 529                         break;
 530
 531                 case md_exportformats:
 532                         add(MenuItem(MenuItem::ExportFormats));
 533                         break;
 534
 535                 case md_importformats:
 536                         add(MenuItem(MenuItem::ImportFormats));
 537                         break;
 538
 539                 case md_floatlistinsert:
 540                         add(MenuItem(MenuItem::FloatListInsert));
 541                         break;
 542
 543                 case md_floatinsert:
 544                         add(MenuItem(MenuItem::FloatInsert));
 545                         break;
 546
 547                 case md_pasterecent:
 548                         add(MenuItem(MenuItem::PasteRecent));
 549                         break;
 550
 551                 case md_toolbars:
 552                         add(MenuItem(MenuItem::Toolbars));
 553                         break;
 554
 555                 case md_branches:
 556                         add(MenuItem(MenuItem::Branches));
 557                         break;
 558
 559                 case md_citestyles:
 560                         add(MenuItem(MenuItem::CiteStyles));
 561                         break;
 562
 563                 case md_graphicsgroups:
 564                         add(MenuItem(MenuItem::GraphicsGroups));
 565                         break;
 566
 567                 case md_spellingsuggestions:
 568                         add(MenuItem(MenuItem::SpellingSuggestions));
 569                         break;
 570
 571                 case md_indices:
 572                         add(MenuItem(MenuItem::Indices));
 573                         break;
 574
 575                 case md_indicescontext:
 576                         add(MenuItem(MenuItem::IndicesContext));
 577                         break;
 578
 579                 case md_indiceslists:
 580                         add(MenuItem(MenuItem::IndicesLists));
 581                         break;
 582
 583                 case md_indiceslistscontext:
 584                         add(MenuItem(MenuItem::IndicesListsContext));
 585                         break;
 586
 587                 case md_optsubmenu:
 588                         optional = true;
 589                         // fallback to md_submenu
 590                 case md_submenu: {
 591                         lex.next(true);
 592                         docstring const mlabel = translateIfPossible(lex.getDocString());
 593                         lex.next(true);
 594                         docstring const mname = lex.getDocString();
 595                         add(MenuItem(MenuItem::Submenu,
 596                                 toqstr(mlabel), toqstr(mname), optional));
 597                         optional = false;
 598                         break;
 599                 }
 600
 601                 case md_endmenu:
 602                         quit = true;
 603                         break;
 604
 605                 default:
 606                         lex.printError("Unknown menu tag");
 607                         break;
 608                 }
 609         }
 610         lex.popTable();
 611 }
 612
 613
 614 MenuItem const & MenuDefinition::operator[](size_type i) const
 615 {
 616         return items_[i];
 617 }
 618
 619
 620 bool MenuDefinition::hasFunc(FuncRequest const & func) const
 621 {
 622         for (const_iterator it = begin(), et = end(); it != et; ++it)
 623                 if (it->func() == func)
 624                         return true;
 625         return false;
 626 }
 627
 628
 629 void MenuDefinition::checkShortcuts() const
 630 {
 631         // This is a quadratic algorithm, but we do not care because
 632         // menus are short enough
 633         for (const_iterator it1 = begin(); it1 != end(); ++it1) {
 634                 QString shortcut = it1->shortcut();
 635                 if (shortcut.isEmpty())
 636                         continue;
 637                 if (!it1->label().contains(shortcut))
 638                         LYXERR0("Menu warning: menu entry \""
 639                                << it1->label()
 640                                << "\" does not contain shortcut `"
 641                                << shortcut << "'.");
 642                 for (const_iterator it2 = begin(); it2 != it1 ; ++it2) {
 643                         if (!it2->shortcut().compare(shortcut, Qt::CaseInsensitive)) {
 644                                 LYXERR0("Menu warning: menu entries "
 645                                        << '"' << it1->fulllabel()
 646                                        << "\" and \"" << it2->fulllabel()
 647                                        << "\" share the same shortcut.");
 648                         }
 649                 }
 650         }
 651 }
 652
 653
 654 bool MenuDefinition::searchMenu(FuncRequest const & func, docstring_list & names) const
 655 {
 656         const_iterator m = begin();
 657         const_iterator m_end = end();
 658         for (; m != m_end; ++m) {
 659                 if (m->kind() == MenuItem::Command && m->func() == func) {
 660                         names.push_back(qstring_to_ucs4(m->label()));
 661                         return true;
 662                 }
 663                 if (m->kind() == MenuItem::Submenu) {
 664                         names.push_back(qstring_to_ucs4(m->label()));
 665                         if (!m->hasSubmenu()) {
 666                                 LYXERR(Debug::GUI, "Warning: non existing sub menu label="
 667                                         << m->label() << " name=" << m->submenuname());
 668                                 names.pop_back();
 669                                 continue;
 670                         }
 671                         if (m->submenu().searchMenu(func, names))
 672                                 return true;
 673                         names.pop_back();
 674                 }
 675         }
 676         return false;
 677 }
 678
 679
 680 bool compareFormat(Format const * p1, Format const * p2)
 681 {
 682         return *p1 < *p2;
 683 }
 684
 685
 686 QString limitStringLength(docstring const & str)
 687 {
 688         size_t const max_item_length = 45;
 689
 690         if (str.size() > max_item_length)
 691                 return toqstr(str.substr(0, max_item_length - 3) + "...");
 692
 693         return toqstr(str);
 694 }
 695
 696
 697 void MenuDefinition::expandGraphicsGroups(BufferView const * bv)
 698 {
 699         if (!bv)
 700                 return;
 701         set<string> grp;
 702         graphics::getGraphicsGroups(bv->buffer(), grp);
 703         if (grp.empty())
 704                 return;
 705
 706         set<string>::const_iterator it = grp.begin();
 707         set<string>::const_iterator end = grp.end();
 708         add(MenuItem(MenuItem::Command, qt_("No Group"),
 709                      FuncRequest(LFUN_SET_GRAPHICS_GROUP)));
 710         for (; it != end; it++) {
 711                 addWithStatusCheck(MenuItem(MenuItem::Command, toqstr(*it),
 712                                 FuncRequest(LFUN_SET_GRAPHICS_GROUP, *it)));
 713         }
 714 }
 715
 716
 717 void MenuDefinition::expandSpellingSuggestions(BufferView const * bv)
 718 {
 719         if (!bv)
 720                 return;
 721         WordLangTuple wl;
 722         docstring_list suggestions;
 723         pos_type from = bv->cursor().pos();
 724         pos_type to = from;
 725         Paragraph const & par = bv->cursor().paragraph();
 726         if (!par.spellCheck(from, to, wl, suggestions))
 727                 return;
 728         LYXERR(Debug::GUI, "Misspelled Word! Suggested Words = ");
 729         size_t i = 0;
 730         MenuItem item(MenuItem::Submenu, qt_("More Spelling Suggestions"));
 731         item.setSubmenu(MenuDefinition(qt_("More Spelling Suggestions")));
 732         for (; i != suggestions.size(); ++i) {
 733                 docstring const & suggestion = suggestions[i];
 734                 LYXERR(Debug::GUI, suggestion);
 735                 MenuItem w(MenuItem::Command, toqstr(suggestion),
 736                         FuncRequest(LFUN_WORD_REPLACE, suggestion));
 737                 if (i < 10)
 738                         add(w);
 739                 else
 740                         item.submenu().add(w);
 741         }
 742         if (i >= 10)
 743                 add(item);
 744 }
 745
 746
 747 void MenuDefinition::expandLastfiles()
 748 {
 749         LastFilesSection::LastFiles const & lf = theSession().lastFiles().lastFiles();
 750         LastFilesSection::LastFiles::const_iterator lfit = lf.begin();
 751
 752         unsigned int ii = 1;
 753
 754         for (; lfit != lf.end() && ii <= lyxrc.num_lastfiles; ++lfit, ++ii) {
 755                 string const file = lfit->absFilename();
 756                 QString label;
 757                 if (ii < 10)
 758                         label = QString("%1. %2|%3").arg(ii)
 759                                 .arg(toqstr(makeDisplayPath(file, 30))).arg(ii);
 760                 else
 761                         label = QString("%1. %2").arg(ii)
 762                                 .arg(toqstr(makeDisplayPath(file, 30)));
 763                 add(MenuItem(MenuItem::Command, label, FuncRequest(LFUN_FILE_OPEN, file)));
 764         }
 765 }
 766
 767
 768 void MenuDefinition::expandDocuments()
 769 {
 770         MenuItem item(MenuItem::Submenu, qt_("Invisible"));
 771         item.setSubmenu(MenuDefinition(qt_("Invisible")));
 772
 773         Buffer * first = theBufferList().first();
 774         if (first) {
 775                 Buffer * b = first;
 776                 int vis = 1;
 777                 int invis = 1;
 778
 779                 // We cannot use a for loop as the buffer list cycles.
 780                 do {
 781                         QString label = toqstr(b->fileName().displayName(20));
 782                         if (!b->isClean())
 783                                 label += "*";
 784                         bool const shown = guiApp->currentView()
 785                                            ? guiApp->currentView()->workArea(*b) : false;
 786                         int ii = shown ? vis : invis;
 787                         if (ii < 10)
 788                                 label = QString::number(ii) + ". " + label + '|' + QString::number(ii);
 789                         if (shown) {
 790                                 add(MenuItem(MenuItem::Command, label,
 791                                         FuncRequest(LFUN_BUFFER_SWITCH, b->absFileName())));
 792                                 ++vis;
 793                         } else {
 794                                 item.submenu().add(MenuItem(MenuItem::Command, label,
 795                                         FuncRequest(LFUN_BUFFER_SWITCH, b->absFileName())));
 796                                 ++invis;
 797                         }
 798                         b = theBufferList().next(b);
 799                 } while (b != first);
 800                 if (!item.submenu().empty())
 801                         add(item);
 802         } else
 803                 add(MenuItem(MenuItem::Info, qt_("<No Documents Open>")));
 804 }
 805
 806
 807 void MenuDefinition::expandBookmarks()
 808 {
 809         lyx::BookmarksSection const & bm = theSession().bookmarks();
 810
 811         bool empty = true;
 812         for (size_t i = 1; i <= bm.size(); ++i) {
 813                 if (bm.isValid(i)) {
 814                         string const file = bm.bookmark(i).filename.absFilename();
 815                         QString const label = QString("%1. %2|%3").arg(i)
 816                                 .arg(toqstr(makeDisplayPath(file, 20))).arg(i);
 817                         add(MenuItem(MenuItem::Command, label,
 818                                 FuncRequest(LFUN_BOOKMARK_GOTO, convert<docstring>(i))));
 819                         empty = false;
 820                 }
 821         }
 822         if (empty)
 823                 add(MenuItem(MenuItem::Info, qt_("<No Bookmarks Saved Yet>")));
 824 }
 825
 826
 827 void MenuDefinition::expandFormats(MenuItem::Kind kind, Buffer const * buf)
 828 {
 829         if (!buf && kind != MenuItem::ImportFormats)
 830                 return;
 831
 832         typedef vector<Format const *> Formats;
 833         Formats formats;
 834         FuncCode action;
 835
 836         switch (kind) {
 837         case MenuItem::ImportFormats:
 838                 formats = theConverters().importableFormats();
 839                 action = LFUN_BUFFER_IMPORT;
 840                 break;
 841         case MenuItem::ViewFormats:
 842                 formats = buf->exportableFormats(true);
 843                 action = LFUN_BUFFER_VIEW;
 844                 break;
 845         case MenuItem::UpdateFormats:
 846                 formats = buf->exportableFormats(true);
 847                 action = LFUN_BUFFER_UPDATE;
 848                 break;
 849         default:
 850                 formats = buf->exportableFormats(false);
 851                 action = LFUN_BUFFER_EXPORT;
 852         }
 853         sort(formats.begin(), formats.end(), &compareFormat);
 854
 855         bool const view_update = (kind == MenuItem::ViewFormats
 856                         || kind == MenuItem::UpdateFormats);
 857
 858         QString smenue;
 859         if (view_update)
 860                 smenue = (kind == MenuItem::ViewFormats ?
 861                         qt_("View (Other Formats)|F")
 862                         : qt_("Update (Other Formats)|p"));
 863         MenuItem item(MenuItem::Submenu, smenue);
 864         item.setSubmenu(MenuDefinition(smenue));
 865
 866         Formats::const_iterator fit = formats.begin();
 867         Formats::const_iterator end = formats.end();
 868         for (; fit != end ; ++fit) {
 869                 if ((*fit)->dummy())
 870                         continue;
 871
 872                 docstring lab = from_utf8((*fit)->prettyname());
 873                 docstring scut = from_utf8((*fit)->shortcut());
 874                 docstring const tmplab = lab;
 875
 876                 if (!scut.empty())
 877                         lab += char_type('|') + scut;
 878                 docstring lab_i18n = translateIfPossible(lab);
 879                 bool const untranslated = (lab == lab_i18n);
 880                 QString const shortcut = toqstr(split(lab_i18n, lab, '|'));
 881                 QString label = toqstr(lab);
 882                 if (untranslated)
 883                         // this might happen if the shortcut
 884                         // has been redefined
 885                         label = toqstr(translateIfPossible(tmplab));
 886
 887                 switch (kind) {
 888                 case MenuItem::ImportFormats:
 889                         label += "...";
 890                         break;
 891                 case MenuItem::ViewFormats:
 892                 case MenuItem::UpdateFormats:
 893                         if ((*fit)->name() == buf->getDefaultOutputFormat()) {
 894                                 docstring lbl = (kind == MenuItem::ViewFormats ?
 895                                         bformat(_("View [%1$s]|V"), qstring_to_ucs4(label))
 896                                         : bformat(_("Update [%1$s]|U"), qstring_to_ucs4(label)));
 897                                 MenuItem w(MenuItem::Command, toqstr(lbl),
 898                                                 FuncRequest(action, (*fit)->name()));
 899                                 add(w);
 900                                 continue;
 901                         }
 902                 case MenuItem::ExportFormats:
 903                         if (!(*fit)->documentFormat())
 904                                 continue;
 905                         break;
 906                 default:
 907                         LASSERT(false, /**/);
 908                         break;
 909                 }
 910                 if (!shortcut.isEmpty())
 911                         label += '|' + shortcut;
 912
 913                 if (view_update) {
 914                         if (buf)
 915                                 item.submenu().addWithStatusCheck(MenuItem(MenuItem::Command, label,
 916                                         FuncRequest(action, (*fit)->name())));
 917                         else
 918                                 item.submenu().add(MenuItem(MenuItem::Command, label,
 919                                         FuncRequest(action, (*fit)->name())));
 920                 } else {
 921                         if (buf)
 922                                 addWithStatusCheck(MenuItem(MenuItem::Command, label,
 923                                         FuncRequest(action, (*fit)->name())));
 924                         else
 925                                 add(MenuItem(MenuItem::Command, label,
 926                                         FuncRequest(action, (*fit)->name())));
 927                 }
 928         }
 929         if (view_update)
 930                 add(item);
 931 }
 932
 933
 934 void MenuDefinition::expandFloatListInsert(Buffer const * buf)
 935 {
 936         if (!buf)
 937                 return;
 938
 939         FloatList const & floats = buf->params().documentClass().floats();
 940         FloatList::const_iterator cit = floats.begin();
 941         FloatList::const_iterator end = floats.end();
 942         for (; cit != end; ++cit) {
 943                 addWithStatusCheck(MenuItem(MenuItem::Command,
 944                                     qt_(cit->second.listName()),
 945                                     FuncRequest(LFUN_FLOAT_LIST_INSERT,
 946                                                 cit->second.type())));
 947         }
 948 }
 949
 950
 951 void MenuDefinition::expandFloatInsert(Buffer const * buf)
 952 {
 953         if (!buf)
 954                 return;
 955
 956         FloatList const & floats = buf->params().documentClass().floats();
 957         FloatList::const_iterator cit = floats.begin();
 958         FloatList::const_iterator end = floats.end();
 959         for (; cit != end; ++cit) {
 960                 // normal float
 961                 QString const label = qt_(cit->second.name());
 962                 addWithStatusCheck(MenuItem(MenuItem::Command, label,
 963                                     FuncRequest(LFUN_FLOAT_INSERT,
 964                                                 cit->second.type())));
 965         }
 966 }
 967
 968
 969 void MenuDefinition::expandFlexInsert(
 970                 Buffer const * buf, InsetLayout::InsetLyXType type)
 971 {
 972         if (!buf)
 973                 return;
 974
 975         TextClass::InsetLayouts const & insetLayouts =
 976                 buf->params().documentClass().insetLayouts();
 977         TextClass::InsetLayouts::const_iterator cit = insetLayouts.begin();
 978         TextClass::InsetLayouts::const_iterator end = insetLayouts.end();
 979         for (; cit != end; ++cit) {
 980                 if (cit->second.lyxtype() == type) {
 981                         docstring const label = cit->first;
 982                         addWithStatusCheck(MenuItem(MenuItem::Command,
 983                                 toqstr(translateIfPossible(label)),
 984                                 FuncRequest(LFUN_FLEX_INSERT, Lexer::quoteString(label))));
 985                 }
 986         }
 987         // FIXME This is a little clunky.
 988         if (items_.empty() && type == InsetLayout::CUSTOM)
 989                 add(MenuItem(MenuItem::Help, qt_("No Custom Insets Defined!")));
 990 }
 991
 992
 993 size_t const max_number_of_items = 25;
 994
 995 void MenuDefinition::expandToc2(Toc const & toc_list,
 996                 size_t from, size_t to, int depth)
 997 {
 998         int shortcut_count = 0;
 999
1000         // check whether depth is smaller than the smallest depth in toc.
1001         int min_depth = 1000;
1002         for (size_t i = from; i < to; ++i)
1003                 min_depth = min(min_depth, toc_list[i].depth());
1004         if (min_depth > depth)
1005                 depth = min_depth;
1006
1007         if (to - from <= max_number_of_items) {
1008                 for (size_t i = from; i < to; ++i) {
1009                         QString label(4 * max(0, toc_list[i].depth() - depth), ' ');
1010                         label += limitStringLength(toc_list[i].str());
1011                         if (toc_list[i].depth() == depth
1012                             && shortcut_count < 9) {
1013                                 if (label.contains(QString::number(shortcut_count + 1)))
1014                                         label += '|' + QString::number(++shortcut_count);
1015                         }
1016                         add(MenuItem(MenuItem::Command, label,
1017                                             FuncRequest(toc_list[i].action())));
1018                 }
1019         } else {
1020                 size_t pos = from;
1021                 while (pos < to) {
1022                         size_t new_pos = pos + 1;
1023                         while (new_pos < to && toc_list[new_pos].depth() > depth)
1024                                 ++new_pos;
1025
1026                         QString label(4 * max(0, toc_list[pos].depth() - depth), ' ');
1027                         label += limitStringLength(toc_list[pos].str());
1028                         if (toc_list[pos].depth() == depth &&
1029                             shortcut_count < 9) {
1030                                 if (label.contains(QString::number(shortcut_count + 1)))
1031                                         label += '|' + QString::number(++shortcut_count);
1032                         }
1033                         if (new_pos == pos + 1) {
1034                                 add(MenuItem(MenuItem::Command,
1035                                                     label, FuncRequest(toc_list[pos].action())));
1036                         } else {
1037                                 MenuDefinition sub;
1038                                 sub.expandToc2(toc_list, pos, new_pos, depth + 1);
1039                                 MenuItem item(MenuItem::Submenu, label);
1040                                 item.setSubmenu(sub);
1041                                 add(item);
1042                         }
1043                         pos = new_pos;
1044                 }
1045         }
1046 }
1047
1048
1049 void MenuDefinition::expandToc(Buffer const * buf)
1050 {
1051         // To make things very cleanly, we would have to pass buf to
1052         // all MenuItem constructors and to expandToc2. However, we
1053         // know that all the entries in a TOC will be have status_ ==
1054         // OK, so we avoid this unnecessary overhead (JMarc)
1055
1056         if (!buf) {
1057                 add(MenuItem(MenuItem::Info, qt_("<No Document Open>")));
1058                 return;
1059         }
1060
1061         // Add an entry for the master doc if this is a child doc
1062         Buffer const * const master = buf->masterBuffer();
1063         if (buf != master) {
1064                 ParIterator const pit = par_iterator_begin(master->inset());
1065                 string const arg = convert<string>(pit->id());
1066                 FuncRequest f(LFUN_PARAGRAPH_GOTO, arg);
1067                 add(MenuItem(MenuItem::Command, qt_("Master Document"), f));
1068         }
1069
1070         MenuDefinition other_lists;
1071
1072         FloatList const & floatlist = buf->params().documentClass().floats();
1073         TocList const & toc_list = buf->tocBackend().tocs();
1074         TocList::const_iterator cit = toc_list.begin();
1075         TocList::const_iterator end = toc_list.end();
1076         for (; cit != end; ++cit) {
1077                 // Handle this later
1078                 if (cit->first == "tableofcontents")
1079                         continue;
1080
1081                 MenuDefinition submenu;
1082                 if (cit->second.size() >= 30) {
1083                         FuncRequest f(LFUN_DIALOG_SHOW, "toc " + cit->first);
1084                         submenu.add(MenuItem(MenuItem::Command, qt_("Open Navigator..."), f));
1085                 } else {
1086                         TocIterator ccit = cit->second.begin();
1087                         TocIterator eend = cit->second.end();
1088                         for (; ccit != eend; ++ccit) {
1089                                 submenu.add(MenuItem(MenuItem::Command,
1090                                         limitStringLength(ccit->str()),
1091                                         FuncRequest(ccit->action())));
1092                         }
1093                 }
1094
1095                 MenuItem item(MenuItem::Submenu, guiName(cit->first, buf->params()));
1096                 item.setSubmenu(submenu);
1097                 if (floatlist.typeExist(cit->first) || cit->first == "child") {
1098                         // Those two types deserve to be in the main menu.
1099                         item.setSubmenu(submenu);
1100                         add(item);
1101                 } else
1102                         other_lists.add(item);
1103         }
1104         if (!other_lists.empty()) {
1105                 MenuItem item(MenuItem::Submenu, qt_("Other Lists"));
1106                 item.setSubmenu(other_lists);
1107                 add(item);
1108         }
1109
1110         // Handle normal TOC
1111         cit = toc_list.find("tableofcontents");
1112         if (cit == end)
1113                 LYXERR(Debug::GUI, "No table of contents.");
1114         else {
1115                 if (cit->second.size() > 0 )
1116                         expandToc2(cit->second, 0, cit->second.size(), 0);
1117                 else
1118                         add(MenuItem(MenuItem::Info, qt_("<Empty Table of Contents>")));
1119         }
1120 }
1121
1122
1123 void MenuDefinition::expandPasteRecent(Buffer const * buf)
1124 {
1125         docstring_list const sel = cap::availableSelections(buf);
1126
1127         docstring_list::const_iterator cit = sel.begin();
1128         docstring_list::const_iterator end = sel.end();
1129
1130         for (unsigned int index = 0; cit != end; ++cit, ++index) {
1131                 add(MenuItem(MenuItem::Command, toqstr(*cit),
1132                                     FuncRequest(LFUN_PASTE, convert<string>(index))));
1133         }
1134 }
1135
1136
1137 void MenuDefinition::expandToolbars()
1138 {
1139         MenuDefinition other_lists;
1140         // extracts the toolbars from the backend
1141         Toolbars::Infos::const_iterator cit = guiApp->toolbars().begin();
1142         Toolbars::Infos::const_iterator end = guiApp->toolbars().end();
1143         for (; cit != end; ++cit) {
1144                 MenuItem const item(MenuItem::Command, toqstr(cit->gui_name),
1145                                 FuncRequest(LFUN_TOOLBAR_TOGGLE, cit->name));
1146                 if (guiApp->toolbars().isMainToolbar(cit->name))
1147                         add(item);
1148                 else
1149                         other_lists.add(item);
1150         }
1151
1152         if (!other_lists.empty()) {
1153                 MenuItem item(MenuItem::Submenu, qt_("Other Toolbars"));
1154                 item.setSubmenu(other_lists);
1155                 add(item);
1156         }
1157 }
1158
1159
1160 void MenuDefinition::expandBranches(Buffer const * buf)
1161 {
1162         if (!buf)
1163                 return;
1164
1165         BufferParams const & master_params = buf->masterBuffer()->params();
1166         BufferParams const & params = buf->params();
1167         if (params.branchlist().empty() && master_params.branchlist().empty() ) {
1168                 add(MenuItem(MenuItem::Help, qt_("No Branches Set for Document!")));
1169                 return;
1170         }
1171
1172         BranchList::const_iterator cit = master_params.branchlist().begin();
1173         BranchList::const_iterator end = master_params.branchlist().end();
1174
1175         for (int ii = 1; cit != end; ++cit, ++ii) {
1176                 docstring label = cit->branch();
1177                 if (ii < 10) {
1178                         label = convert<docstring>(ii) + ". " + label
1179                                 + char_type('|') + convert<docstring>(ii);
1180                 }
1181                 addWithStatusCheck(MenuItem(MenuItem::Command, toqstr(label),
1182                                     FuncRequest(LFUN_BRANCH_INSERT,
1183                                                 cit->branch())));
1184         }
1185
1186         if (buf == buf->masterBuffer())
1187                 return;
1188
1189         MenuDefinition child_branches;
1190
1191         BranchList::const_iterator ccit = params.branchlist().begin();
1192         BranchList::const_iterator cend = params.branchlist().end();
1193
1194         for (int ii = 1; ccit != cend; ++ccit, ++ii) {
1195                 docstring label = ccit->branch();
1196                 if (ii < 10) {
1197                         label = convert<docstring>(ii) + ". " + label
1198                                 + char_type('|') + convert<docstring>(ii);
1199                 }
1200                 child_branches.addWithStatusCheck(MenuItem(MenuItem::Command,
1201                                     toqstr(label),
1202                                     FuncRequest(LFUN_BRANCH_INSERT,
1203                                                 ccit->branch())));
1204         }
1205
1206         if (!child_branches.empty()) {
1207                 MenuItem item(MenuItem::Submenu, qt_("Child Document"));
1208                 item.setSubmenu(child_branches);
1209                 add(item);
1210         }
1211 }
1212
1213
1214 void MenuDefinition::expandIndices(Buffer const * buf, bool listof)
1215 {
1216         if (!buf)
1217                 return;
1218
1219         BufferParams const & params = buf->masterBuffer()->params();
1220         if (!params.use_indices) {
1221                 if (listof)
1222                         addWithStatusCheck(MenuItem(MenuItem::Command,
1223                                            qt_("Index List|I"),
1224                                            FuncRequest(LFUN_INDEX_PRINT,
1225                                                   from_ascii("idx"))));
1226                 else
1227                         addWithStatusCheck(MenuItem(MenuItem::Command,
1228                                            qt_("Index Entry|d"),
1229                                            FuncRequest(LFUN_INDEX_INSERT,
1230                                                   from_ascii("idx"))));
1231                 return;
1232         }
1233
1234         if (params.indiceslist().empty())
1235                 return;
1236
1237         IndicesList::const_iterator cit = params.indiceslist().begin();
1238         IndicesList::const_iterator end = params.indiceslist().end();
1239
1240         for (int ii = 1; cit != end; ++cit, ++ii) {
1241                 if (listof)
1242                         addWithStatusCheck(MenuItem(MenuItem::Command, toqstr(cit->index()),
1243                                            FuncRequest(LFUN_INDEX_PRINT,
1244                                                   cit->shortcut())));
1245                 else {
1246                         docstring label = _("Index Entry");
1247                         label += " (" + cit->index() + ")";
1248                         addWithStatusCheck(MenuItem(MenuItem::Command, toqstr(label),
1249                                            FuncRequest(LFUN_INDEX_INSERT,
1250                                                   cit->shortcut())));
1251                 }
1252         }
1253 }
1254
1255
1256 void MenuDefinition::expandIndicesContext(Buffer const * buf, bool listof)
1257 {
1258         if (!buf)
1259                 return;
1260
1261         BufferParams const & params = buf->masterBuffer()->params();
1262         if (!params.use_indices || params.indiceslist().empty())
1263                 return;
1264
1265         IndicesList::const_iterator cit = params.indiceslist().begin();
1266         IndicesList::const_iterator end = params.indiceslist().end();
1267
1268         for (int ii = 1; cit != end; ++cit, ++ii) {
1269                 if (listof) {
1270                         InsetCommandParams p(INDEX_PRINT_CODE);
1271                         p["type"] = cit->shortcut();
1272                         string const data = InsetCommand::params2string("index_print", p);
1273                         addWithStatusCheck(MenuItem(MenuItem::Command, toqstr(cit->index()),
1274                                            FuncRequest(LFUN_NEXT_INSET_MODIFY, data)));
1275                 } else {
1276                         docstring label = _("Index Entry");
1277                         label += " (" + cit->index() + ")";
1278                         addWithStatusCheck(MenuItem(MenuItem::Command, toqstr(label),
1279                                            FuncRequest(LFUN_NEXT_INSET_MODIFY,
1280                                                   from_ascii("changetype ") + cit->shortcut())));
1281                 }
1282         }
1283 }
1284
1285
1286 void MenuDefinition::expandCiteStyles(BufferView const * bv)
1287 {
1288         if (!bv)
1289                 return;
1290
1291         Inset const * inset = bv->cursor().nextInset();
1292         if (!inset || inset->lyxCode() != CITE_CODE) {
1293                 add(MenuItem(MenuItem::Command,
1294                                     qt_("No Citation in Scope!"),
1295                                     FuncRequest(LFUN_NOACTION)));
1296                 return;
1297         }
1298         InsetCommand const * citinset =
1299                                 static_cast<InsetCommand const *>(inset);
1300
1301         Buffer const * buf = &bv->buffer();
1302         docstring key = citinset->getParam("key");
1303         // we can only handle one key currently
1304         if (contains(key, ','))
1305                 key = qstring_to_ucs4(toqstr(key).split(',')[0]);
1306
1307         vector<CiteStyle> citeStyleList = citeStyles(buf->params().citeEngine());
1308         docstring_list citeStrings =
1309                 buf->masterBibInfo().getCiteStrings(key, bv->buffer());
1310
1311         docstring_list::const_iterator cit = citeStrings.begin();
1312         docstring_list::const_iterator end = citeStrings.end();
1313
1314         for (int ii = 1; cit != end; ++cit, ++ii) {
1315                 docstring label = *cit;
1316                 CitationStyle cs;
1317                 CiteStyle cst = citeStyleList[ii - 1];
1318                 cs.style = cst;
1319                 addWithStatusCheck(MenuItem(MenuItem::Command, toqstr(label),
1320                                     FuncRequest(LFUN_NEXT_INSET_MODIFY,
1321                                                 "changetype " + from_utf8(citationStyleToString(cs)))));
1322         }
1323 }
1324
1325 } // namespace anon
1326
1327
1328 /////////////////////////////////////////////////////////////////////
1329 // Menu::Impl definition and implementation
1330 /////////////////////////////////////////////////////////////////////
1331
1332 struct Menu::Impl
1333 {
1334         /// populates the menu or one of its submenu
1335         /// This is used as a recursive function
1336         void populate(QMenu & qMenu, MenuDefinition const & menu);
1337
1338         /// Only needed for top level menus.
1339         MenuDefinition * top_level_menu;
1340         /// our owning view
1341         GuiView * view;
1342         /// the name of this menu
1343         QString name;
1344 };
1345
1346
1347
1348 /// Get a MenuDefinition item label from the menu backend
1349 static QString label(MenuItem const & mi)
1350 {
1351         QString label = mi.label();
1352         label.replace("&", "&&");
1353
1354         QString shortcut = mi.shortcut();
1355         if (!shortcut.isEmpty()) {
1356                 int pos = label.indexOf(shortcut);
1357                 if (pos != -1)
1358                         //label.insert(pos, 1, char_type('&'));
1359                         label.replace(pos, 0, "&");
1360         }
1361
1362         QString const binding = mi.binding();
1363         if (!binding.isEmpty())
1364                 label += '\t' + binding;
1365
1366         return label;
1367 }
1368
1369 void Menu::Impl::populate(QMenu & qMenu, MenuDefinition const & menu)
1370 {
1371         LYXERR(Debug::GUI, "populating menu " << menu.name());
1372         if (menu.size() == 0) {
1373                 LYXERR(Debug::GUI, "\tERROR: empty menu " << menu.name());
1374                 return;
1375         }
1376         LYXERR(Debug::GUI, " *****  menu entries " << menu.size());
1377         MenuDefinition::const_iterator m = menu.begin();
1378         MenuDefinition::const_iterator end = menu.end();
1379         for (; m != end; ++m) {
1380                 if (m->kind() == MenuItem::Separator)
1381                         qMenu.addSeparator();
1382                 else if (m->kind() == MenuItem::Submenu) {
1383                         QMenu * subMenu = qMenu.addMenu(label(*m));
1384                         populate(*subMenu, m->submenu());
1385                         subMenu->setEnabled(m->status().enabled());
1386                 } else {
1387                         // we have a MenuItem::Command
1388                         qMenu.addAction(new Action(view, QIcon(), label(*m),
1389                                 m->func(), QString(), &qMenu));
1390                 }
1391         }
1392 }
1393
1394 /////////////////////////////////////////////////////////////////////
1395 // Menu implementation
1396 /////////////////////////////////////////////////////////////////////
1397
1398 Menu::Menu(GuiView * gv, QString const & name, bool top_level)
1399 : QMenu(gv), d(new Menu::Impl)
1400 {
1401         d->top_level_menu = top_level? new MenuDefinition : 0;
1402         d->view = gv;
1403         d->name = name;
1404         setTitle(name);
1405         if (d->top_level_menu)
1406                 connect(this, SIGNAL(aboutToShow()), this, SLOT(updateView()));
1407 }
1408
1409
1410 Menu::~Menu()
1411 {
1412         delete d->top_level_menu;
1413         delete d;
1414 }
1415
1416
1417 void Menu::updateView()
1418 {
1419         guiApp->menus().updateMenu(this);
1420 }
1421
1422
1423 /////////////////////////////////////////////////////////////////////
1424 // Menus::Impl definition and implementation
1425 /////////////////////////////////////////////////////////////////////
1426
1427 struct Menus::Impl {
1428         ///
1429         bool hasMenu(QString const &) const;
1430         ///
1431         MenuDefinition & getMenu(QString const &);
1432         ///
1433         MenuDefinition const & getMenu(QString const &) const;
1434
1435         /// Expands some special entries of the menu
1436         /** The entries with the following kind are expanded to a
1437             sequence of Command MenuItems: Lastfiles, Documents,
1438             ViewFormats, ExportFormats, UpdateFormats, Branches, Indices
1439         */
1440         void expand(MenuDefinition const & frommenu, MenuDefinition & tomenu,
1441                 BufferView const *) const;
1442
1443         /// Initialize specific MACOS X menubar
1444         void macxMenuBarInit(GuiView * view, QMenuBar * qmb);
1445
1446         /// Mac special menu.
1447         /** This defines a menu whose entries list the FuncRequests
1448             that will be removed by expand() in other menus. This is
1449             used by the Qt/Mac code.
1450
1451             NOTE: Qt does not remove the menu items when clearing a QMenuBar,
1452             such that the items will keep accessing the FuncRequests in
1453             the MenuDefinition. While Menus::Impl might be recreated,
1454             we keep mac_special_menu_ in memory by making it static.
1455         */
1456         static MenuDefinition mac_special_menu_;
1457
1458         ///
1459         MenuList menulist_;
1460         ///
1461         MenuDefinition menubar_;
1462
1463         typedef QMap<GuiView *, QHash<QString, Menu*> > NameMap;
1464
1465         /// name to menu for \c menu() method.
1466         NameMap name_map_;
1467 };
1468
1469
1470 MenuDefinition Menus::Impl::mac_special_menu_;
1471
1472
1473 /*
1474   Here is what the Qt documentation says about how a menubar is chosen:
1475
1476      1) If the window has a QMenuBar then it is used. 2) If the window
1477      is a modal then its menubar is used. If no menubar is specified
1478      then a default menubar is used (as documented below) 3) If the
1479      window has no parent then the default menubar is used (as
1480      documented below).
1481
1482      The above 3 steps are applied all the way up the parent window
1483      chain until one of the above are satisifed. If all else fails a
1484      default menubar will be created, the default menubar on Qt/Mac is
1485      an empty menubar, however you can create a different default
1486      menubar by creating a parentless QMenuBar, the first one created
1487      will thus be designated the default menubar, and will be used
1488      whenever a default menubar is needed.
1489
1490   Thus, for Qt/Mac, we add the menus to a free standing menubar, so
1491   that this menubar will be used also when one of LyX' dialogs has
1492   focus. (JMarc)
1493 */
1494 void Menus::Impl::macxMenuBarInit(GuiView * view, QMenuBar * qmb)
1495 {
1496         /* Since Qt 4.2, the qt/mac menu code has special code for
1497            specifying the role of a menu entry. However, it does not
1498            work very well with our scheme of creating menus on demand,
1499            and therefore we need to put these entries in a special
1500            invisible menu. (JMarc)
1501         */
1502
1503         /* The entries of our special mac menu. If we add support for
1504          * special entries in Menus, we could imagine something
1505          * like
1506          *    SpecialItem About " "About LyX" "dialog-show aboutlyx"
1507          * and therefore avoid hardcoding. I am not sure it is worth
1508          * the hassle, though. (JMarc)
1509          */
1510         struct MacMenuEntry {
1511                 FuncCode action;
1512                 char const * arg;
1513                 char const * label;
1514                 QAction::MenuRole role;
1515         };
1516
1517         MacMenuEntry entries[] = {
1518                 {LFUN_DIALOG_SHOW, "aboutlyx", "About LyX",
1519                  QAction::AboutRole},
1520                 {LFUN_DIALOG_SHOW, "prefs", "Preferences",
1521                  QAction::PreferencesRole},
1522                 {LFUN_RECONFIGURE, "", "Reconfigure",
1523                  QAction::ApplicationSpecificRole},
1524                 {LFUN_LYX_QUIT, "", "Quit LyX", QAction::QuitRole}
1525         };
1526         const size_t num_entries = sizeof(entries) / sizeof(entries[0]);
1527
1528         // the special menu for Menus. Fill it up only once.
1529         if (mac_special_menu_.size() == 0) {
1530                 for (size_t i = 0 ; i < num_entries ; ++i) {
1531                         FuncRequest const func(entries[i].action,
1532                                 from_utf8(entries[i].arg));
1533                         mac_special_menu_.add(MenuItem(MenuItem::Command,
1534                                 entries[i].label, func));
1535                 }
1536         }
1537
1538         // add the entries to a QMenu that will eventually be empty
1539         // and therefore invisible.
1540         QMenu * qMenu = qmb->addMenu("special");
1541         MenuDefinition::const_iterator cit = mac_special_menu_.begin();
1542         MenuDefinition::const_iterator end = mac_special_menu_.end();
1543         for (size_t i = 0 ; cit != end ; ++cit, ++i) {
1544                 Action * action = new Action(view, QIcon(), cit->label(),
1545                         cit->func(), QString(), qMenu);
1546                 action->setMenuRole(entries[i].role);
1547                 qMenu->addAction(action);
1548         }
1549 }
1550
1551
1552 void Menus::Impl::expand(MenuDefinition const & frommenu,
1553         MenuDefinition & tomenu, BufferView const * bv) const
1554 {
1555         if (!tomenu.empty())
1556                 tomenu.clear();
1557
1558         for (MenuDefinition::const_iterator cit = frommenu.begin();
1559              cit != frommenu.end() ; ++cit) {
1560                 Buffer const * buf = bv ? &bv->buffer() : 0;
1561                 switch (cit->kind()) {
1562                 case MenuItem::Lastfiles:
1563                         tomenu.expandLastfiles();
1564                         break;
1565
1566                 case MenuItem::Documents:
1567                         tomenu.expandDocuments();
1568                         break;
1569
1570                 case MenuItem::Bookmarks:
1571                         tomenu.expandBookmarks();
1572                         break;
1573
1574                 case MenuItem::ImportFormats:
1575                 case MenuItem::ViewFormats:
1576                 case MenuItem::UpdateFormats:
1577                 case MenuItem::ExportFormats:
1578                         tomenu.expandFormats(cit->kind(), buf);
1579                         break;
1580
1581                 case MenuItem::CharStyles:
1582                         tomenu.expandFlexInsert(buf, InsetLayout::CHARSTYLE);
1583                         break;
1584
1585                 case MenuItem::Custom:
1586                         tomenu.expandFlexInsert(buf, InsetLayout::CUSTOM);
1587                         break;
1588
1589                 case MenuItem::Elements:
1590                         tomenu.expandFlexInsert(buf, InsetLayout::ELEMENT);
1591                         break;
1592
1593                 case MenuItem::FloatListInsert:
1594                         tomenu.expandFloatListInsert(buf);
1595                         break;
1596
1597                 case MenuItem::FloatInsert:
1598                         tomenu.expandFloatInsert(buf);
1599                         break;
1600
1601                 case MenuItem::PasteRecent:
1602                         tomenu.expandPasteRecent(buf);
1603                         break;
1604
1605                 case MenuItem::Toolbars:
1606                         tomenu.expandToolbars();
1607                         break;
1608
1609                 case MenuItem::Branches:
1610                         tomenu.expandBranches(buf);
1611                         break;
1612
1613                 case MenuItem::Indices:
1614                         tomenu.expandIndices(buf);
1615                         break;
1616
1617                 case MenuItem::IndicesContext:
1618                         tomenu.expandIndicesContext(buf);
1619                         break;
1620
1621                 case MenuItem::IndicesLists:
1622                         tomenu.expandIndices(buf, true);
1623                         break;
1624
1625                 case MenuItem::IndicesListsContext:
1626                         tomenu.expandIndicesContext(buf, true);
1627                         break;
1628
1629                 case MenuItem::CiteStyles:
1630                         tomenu.expandCiteStyles(bv);
1631                         break;
1632
1633                 case MenuItem::Toc:
1634                         tomenu.expandToc(buf);
1635                         break;
1636
1637                 case MenuItem::GraphicsGroups:
1638                         tomenu.expandGraphicsGroups(bv);
1639                         break;
1640
1641                 case MenuItem::SpellingSuggestions:
1642                         tomenu.expandSpellingSuggestions(bv);
1643                         break;
1644
1645                 case MenuItem::Submenu: {
1646                         MenuItem item(*cit);
1647                         item.setSubmenu(MenuDefinition(cit->submenuname()));
1648                         expand(getMenu(cit->submenuname()), item.submenu(), bv);
1649                         tomenu.addWithStatusCheck(item);
1650                 }
1651                 break;
1652
1653                 case MenuItem::Info:
1654                 case MenuItem::Help:
1655                 case MenuItem::Separator:
1656                         tomenu.addWithStatusCheck(*cit);
1657                         break;
1658
1659                 case MenuItem::Command:
1660                         if (!mac_special_menu_.hasFunc(cit->func()))
1661                                 tomenu.addWithStatusCheck(*cit);
1662                 }
1663         }
1664
1665         // we do not want the menu to end with a separator
1666         if (!tomenu.empty() && tomenu.items_.back().kind() == MenuItem::Separator)
1667                 tomenu.items_.pop_back();
1668
1669         // Check whether the shortcuts are unique
1670         tomenu.checkShortcuts();
1671 }
1672
1673
1674 bool Menus::Impl::hasMenu(QString const & name) const
1675 {
1676         return find_if(menulist_.begin(), menulist_.end(),
1677                 MenuNamesEqual(name)) != menulist_.end();
1678 }
1679
1680
1681 MenuDefinition const & Menus::Impl::getMenu(QString const & name) const
1682 {
1683         const_iterator cit = find_if(menulist_.begin(), menulist_.end(),
1684                 MenuNamesEqual(name));
1685         if (cit == menulist_.end())
1686                 LYXERR0("No submenu named " << name);
1687         LASSERT(cit != menulist_.end(), /**/);
1688         return (*cit);
1689 }
1690
1691
1692 MenuDefinition & Menus::Impl::getMenu(QString const & name)
1693 {
1694         iterator it = find_if(menulist_.begin(), menulist_.end(),
1695                 MenuNamesEqual(name));
1696         if (it == menulist_.end())
1697                 LYXERR0("No submenu named " << name);
1698         LASSERT(it != menulist_.end(), /**/);
1699         return (*it);
1700 }
1701
1702
1703 /////////////////////////////////////////////////////////////////////
1704 //
1705 // Menus
1706 //
1707 /////////////////////////////////////////////////////////////////////
1708
1709 Menus::Menus() : d(new Impl) {}
1710
1711
1712 Menus::~Menus()
1713 {
1714   delete d;
1715 }
1716
1717
1718 void Menus::reset()
1719 {
1720         delete d;
1721         d = new Impl;
1722 }
1723
1724
1725 void Menus::read(Lexer & lex)
1726 {
1727         enum {
1728                 md_menu,
1729                 md_menubar,
1730                 md_endmenuset,
1731         };
1732
1733         LexerKeyword menutags[] = {
1734                 { "end", md_endmenuset },
1735                 { "menu", md_menu },
1736                 { "menubar", md_menubar }
1737         };
1738
1739         // consistency check
1740         if (compare_ascii_no_case(lex.getString(), "menuset"))
1741                 LYXERR0("Menus::read: ERROR wrong token: `" << lex.getString() << '\'');
1742
1743         lex.pushTable(menutags);
1744         lex.setContext("Menus::read");
1745
1746         bool quit = false;
1747
1748         while (lex.isOK() && !quit) {
1749                 switch (lex.lex()) {
1750                 case md_menubar:
1751                         d->menubar_.read(lex);
1752                         break;
1753                 case md_menu: {
1754                         lex.next(true);
1755                         QString const name = toqstr(lex.getDocString());
1756                         if (d->hasMenu(name))
1757                                 d->getMenu(name).read(lex);
1758                         else {
1759                                 MenuDefinition menu(name);
1760                                 menu.read(lex);
1761                                 d->menulist_.push_back(menu);
1762                         }
1763                         break;
1764                 }
1765                 case md_endmenuset:
1766                         quit = true;
1767                         break;
1768                 default:
1769                         lex.printError("Unknown menu tag");
1770                         break;
1771                 }
1772         }
1773         lex.popTable();
1774 }
1775
1776
1777 bool Menus::searchMenu(FuncRequest const & func,
1778         docstring_list & names) const
1779 {
1780         MenuDefinition menu;
1781         d->expand(d->menubar_, menu, 0);
1782         return menu.searchMenu(func, names);
1783 }
1784
1785
1786 void Menus::fillMenuBar(QMenuBar * qmb, GuiView * view, bool initial)
1787 {
1788         if (initial) {
1789 #ifdef Q_WS_MACX
1790                 // setup special mac specific menu items, but only do this
1791                 // the first time a QMenuBar is created. Otherwise Qt will
1792                 // create duplicate items in the application menu. It seems
1793                 // that Qt does not remove them when the QMenubar is cleared.
1794                 LYXERR(Debug::GUI, "Creating Mac OS X special menu bar");
1795                 d->macxMenuBarInit(view, qmb);
1796 #endif
1797         } else {
1798                 // Clear all menubar contents before filling it.
1799                 qmb->clear();
1800         }
1801
1802         LYXERR(Debug::GUI, "populating menu bar" << d->menubar_.name());
1803
1804         if (d->menubar_.size() == 0) {
1805                 LYXERR(Debug::GUI, "\tERROR: empty menu bar"
1806                         << d->menubar_.name());
1807                 return;
1808         }
1809         LYXERR(Debug::GUI, "menu bar entries " << d->menubar_.size());
1810
1811         MenuDefinition menu;
1812         BufferView * bv = 0;
1813         if (view)
1814                 bv = view->currentBufferView();
1815         d->expand(d->menubar_, menu, bv);
1816
1817         MenuDefinition::const_iterator m = menu.begin();
1818         MenuDefinition::const_iterator end = menu.end();
1819
1820         for (; m != end; ++m) {
1821
1822                 if (m->kind() != MenuItem::Submenu) {
1823                         LYXERR(Debug::GUI, "\tERROR: not a submenu " << m->label());
1824                         continue;
1825                 }
1826
1827                 LYXERR(Debug::GUI, "menu bar item " << m->label()
1828                         << " is a submenu named " << m->submenuname());
1829
1830                 QString name = m->submenuname();
1831                 if (!d->hasMenu(name)) {
1832                         LYXERR(Debug::GUI, "\tERROR: " << name
1833                                 << " submenu has no menu!");
1834                         continue;
1835                 }
1836
1837                 Menu * menu = new Menu(view, m->submenuname(), true);
1838                 menu->setTitle(label(*m));
1839                 qmb->addMenu(menu);
1840
1841                 d->name_map_[view][name] = menu;
1842         }
1843 }
1844
1845
1846 void Menus::updateMenu(Menu * qmenu)
1847 {
1848         LYXERR(Debug::GUI, "Triggered menu: " << qmenu->d->name);
1849         qmenu->clear();
1850
1851         if (qmenu->d->name.isEmpty())
1852                 return;
1853
1854         if (!d->hasMenu(qmenu->d->name)) {
1855                 qmenu->addAction(qt_("No Action Defined!"));
1856                 LYXERR(Debug::GUI, "\tWARNING: non existing menu: "
1857                         << qmenu->d->name);
1858                 return;
1859         }
1860
1861         MenuDefinition const & fromLyxMenu = d->getMenu(qmenu->d->name);
1862         BufferView * bv = 0;
1863         if (qmenu->d->view)
1864                 bv = qmenu->d->view->currentBufferView();
1865         d->expand(fromLyxMenu, *qmenu->d->top_level_menu, bv);
1866         qmenu->d->populate(*qmenu, *qmenu->d->top_level_menu);
1867 }
1868
1869
1870 Menu * Menus::menu(QString const & name, GuiView & view)
1871 {
1872         LYXERR(Debug::GUI, "Context menu requested: " << name);
1873         Menu * menu = d->name_map_[&view].value(name, 0);
1874         if (!menu && !name.startsWith("context-")) {
1875                 LYXERR0("requested context menu not found: " << name);
1876                 return 0;
1877         }
1878
1879         menu = new Menu(&view, name, true);
1880         d->name_map_[&view][name] = menu;
1881         return menu;
1882 }
1883
1884 } // namespace frontend
1885 } // namespace lyx
1886
1887 #include "moc_Menus.cpp"