lyx_mirror/src/frontends/qt4/Menus.cpp

/**
 * \file qt4/Menus.cpp
 * This file is part of LyX, the document processor.
 * Licence details can be found in the file COPYING.
 *
 * \author John Levon
 *
 * Full author contact details are available in file CREDITS.
 */

#include <config.h>

#include "Menus.h"

#include "Action.h"
#include "GuiApplication.h"
#include "GuiPopupMenu.h"
#include "GuiView.h"

#include "qt_helpers.h"

#include "support/debug.h"

#include <QCursor>
#include <QMenuBar>


namespace lyx {
namespace frontend {

// MacOSX specific stuff is at the end.

void Menus::fillMenuBar(GuiView * view)
{
	// Clear all menubar contents before filling it.
	view->menuBar()->clear();
	
#ifdef Q_WS_MACX
	// setup special mac specific menu item
	macxMenuBarInit(view);
#endif

	LYXERR(Debug::GUI, "populating menu bar" << to_utf8(getMenubar().name()));

	if (getMenubar().size() == 0) {
		LYXERR(Debug::GUI, "\tERROR: empty menu bar"
			<< to_utf8(getMenubar().name()));
		return;
	}
	else {
		LYXERR(Debug::GUI, "menu bar entries "
			<< getMenubar().size());
	}

	Menu menu;
	expand(getMenubar(), menu, view->buffer());

	Menu::const_iterator m = menu.begin();
	Menu::const_iterator end = menu.end();

	for (; m != end; ++m) {

		if (m->kind() != MenuItem::Submenu) {
			LYXERR(Debug::GUI, "\tERROR: not a submenu " << to_utf8(m->label()));
			continue;
		}

		LYXERR(Debug::GUI, "menu bar item " << to_utf8(m->label())
			<< " is a submenu named " << to_utf8(m->submenuname()));

		docstring name = m->submenuname();
		if (!hasMenu(name)) {
			LYXERR(Debug::GUI, "\tERROR: " << to_utf8(name)
				<< " submenu has no menu!");
			continue;
		}

		GuiPopupMenu * qMenu = new GuiPopupMenu(view, *m, true);
		view->menuBar()->addMenu(qMenu);

		name_map_[toqstr(name)] = qMenu;
	}
}


QMenu * Menus::menu(QString const & name)
{
	LYXERR(Debug::GUI, "Context menu requested: "
		<< qstring_to_ucs4(name));
	GuiPopupMenu * menu = name_map_.value(name, 0);
	if (!menu)
		LYXERR0("resquested context menu not found: "
			<< qstring_to_ucs4(name));
	return menu;
}


/// Some special Qt/Mac support hacks

/*
  Here is what the Qt documentation says about how a menubar is chosen:

     1) If the window has a QMenuBar then it is used. 2) If the window
     is a modal then its menubar is used. If no menubar is specified
     then a default menubar is used (as documented below) 3) If the
     window has no parent then the default menubar is used (as
     documented below).

     The above 3 steps are applied all the way up the parent window
     chain until one of the above are satisifed. If all else fails a
     default menubar will be created, the default menubar on Qt/Mac is
     an empty menubar, however you can create a different default
     menubar by creating a parentless QMenuBar, the first one created
     will thus be designated the default menubar, and will be used
     whenever a default menubar is needed.

  Thus, for Qt/Mac, we add the menus to a free standing menubar, so
  that this menubar will be used also when one of LyX' dialogs has
  focus. (JMarc)
*/

void Menus::macxMenuBarInit(GuiView * view)
{
	// The Mac menubar initialisation must be done only once!
	static bool done = false;
	if (done)
		return;
	done = true;

	/* Since Qt 4.2, the qt/mac menu code has special code for
	   specifying the role of a menu entry. However, it does not
	   work very well with our scheme of creating menus on demand,
	   and therefore we need to put these entries in a special
	   invisible menu. (JMarc)
	*/

	/* The entries of our special mac menu. If we add support for
	 * special entries in MenuBackend, we could imagine something
	 * like
	 *    SpecialItem About " "About LyX" "dialog-show aboutlyx"
	 * and therefore avoid hardcoding. I am not sure it is worth
	 * the hassle, though. (JMarc)
	 */
	struct MacMenuEntry {
		kb_action action;
		char const * arg;
		char const * label;
		QAction::MenuRole role;
	};

	MacMenuEntry entries[] = {
		{LFUN_DIALOG_SHOW, "aboutlyx", "About LyX",
		 QAction::AboutRole},
		{LFUN_DIALOG_SHOW, "prefs", "Preferences",
		 QAction::PreferencesRole},
		{LFUN_RECONFIGURE, "", "Reconfigure",
		 QAction::ApplicationSpecificRole},
		{LFUN_LYX_QUIT, "", "Quit LyX", QAction::QuitRole}
	};
	const size_t num_entries = sizeof(entries) / sizeof(MacMenuEntry);

	// the special menu for MenuBackend.
	Menu special;
	for (size_t i = 0 ; i < num_entries ; ++i) {
		FuncRequest const func(entries[i].action,
				       from_utf8(entries[i].arg));
		special.add(MenuItem(MenuItem::Command,
				     from_utf8(entries[i].label),
				     func));
	}
	specialMenu(special);

	// add the entries to a QMenu that will eventually be empty
	// and therefore invisible.
	QMenu * qMenu = view->menuBar()->addMenu("special");

	// we do not use 'special' because it is a temporary variable,
	// whereas MenuBackend::specialMenu points to a persistent
	// copy.
	Menu::const_iterator cit = specialMenu().begin();
	Menu::const_iterator end = specialMenu().end();
	for (size_t i = 0 ; cit != end ; ++cit, ++i) {
		Action * action = new Action(*view, QIcon(), 
					     toqstr(cit->label()),
					     cit->func(), QString());
		action->setMenuRole(entries[i].role);
		qMenu->addAction(action);

	}
}

} // namespace frontend
} // namespace lyx

#include "Menus_moc.cpp"