// -*- C++ -*-
-/* Dialogs.h
- * Container of all dialogs and signals a LyXView needs or uses to access them.
- * Author: Allan Rae <rae@lyx.org>
- * This file is part of
- * ======================================================
+/**
+ * \file Dialogs.h
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
*
- * LyX, The Document Processor
+ * \author Allan Rae
+ * \author Angus Leeming
*
- * Copyright 1995 Matthias Ettrich
- * Copyright 1995-2000 The LyX Team.
- *
- * This file Copyright 2000
- * Allan Rae
- * ======================================================
+ * Full author contact details are available in file CREDITS.
*/
#ifndef DIALOGS_H
#define DIALOGS_H
-#include <vector>
-#include <sigc++/signal_system.h>
-
-#include "LString.h"
+#include <boost/signal.hpp>
#include <boost/utility.hpp>
-#include <boost/smart_ptr.hpp>
-#ifdef __GNUG__
-#pragma interface
-#endif
+#include <map>
-#include "DialogBase.h"
-#include "support/LAssert.h"
+namespace lyx {
-// Maybe this should be a UIFunc modelled on LyXFunc
+class Inset;
class LyXView;
-class InsetGraphics;
-class InsetBibKey;
-class InsetBibtex;
-class InsetError;
-class InsetExternal;
-class InsetInclude;
-class InsetInfo;
-class InsetTabular;
-class InsetCommand;
-class InsetMinipage;
-
-/** Container of all dialogs and signals a LyXView needs or uses to access them
- The list of dialog signals isn't comprehensive but should be a good guide
- for any future additions. Remember don't go overboard -- think minimal.
+namespace frontend { class Dialog; }
+
+/** Container of all dialogs.
*/
-class Dialogs : boost::noncopyable
-{
+class Dialogs : boost::noncopyable {
public:
///
- typedef boost::shared_ptr<DialogBase> db_ptr;
- /**@name Constructor */
- //@{
- ///
- Dialogs(LyXView *);
- //@}
+ Dialogs(LyXView &);
- /** Redraw all visible dialogs because, for example, the GUI colours
- have been re-mapped. */
- static SigC::Signal0<void> redrawGUI;
+ /** Check the status of all visible dialogs and disable or reenable
+ * them as appropriate.
+ *
+ * Disabling is needed for example when a dialog is open and the
+ * cursor moves to a position where the corresponding inset is not
+ * allowed.
+ */
+ void checkStatus();
+
+ /// Are the tooltips on or off?
+ static bool tooltipsEnabled();
- /**@name Global Hide and Update Signals */
- //@{
/// Hide all visible dialogs
- SigC::Signal0<void> hideAll;
-
+ void hideAll() const;
/// Hide any dialogs that require a buffer for them to operate
- SigC::Signal0<void> hideBufferDependent;
-
+ void hideBufferDependent() const;
/** Update visible, buffer-dependent dialogs
If the bool is true then a buffer change has occurred
else its still the same buffer.
*/
- SigC::Signal1<void, bool> updateBufferDependent;
- //@}
-
- /**@name Dialog Access Signals.
- Put into some sort of alphabetical order */
- //@{
- /// Do we really have to push this?
- SigC::Signal1<void, std::vector<string> const &> SetDocumentClassChoice;
- /// show the key and label of a bibliography entry
- SigC::Signal1<void, InsetCommand *> showBibitem;
- /// show the bibtex dialog
- SigC::Signal1<void, InsetCommand *> showBibtex;
- ///
- SigC::Signal0<void> showCharacter;
- ///
- SigC::Signal1<void, InsetCommand *> showCitation;
- ///
- SigC::Signal1<void, string const &> createCitation;
- ///
- SigC::Signal0<void> showCopyright;
- ///
- SigC::Signal0<void> showCredits;
- ///
- SigC::Signal1<void, InsetError *> showError;
- /// show the external inset dialog
- SigC::Signal1<void, InsetExternal *> showExternal;
- ///
- SigC::Signal1<void, InsetGraphics *> showGraphics;
- /// show the details of a LyX file include inset
- SigC::Signal1<void, InsetInclude *> showInclude;
- ///
- SigC::Signal1<void, InsetCommand *> showIndex;
- ///
- SigC::Signal1<void, string const &> createIndex;
- ///
- SigC::Signal1<void, InsetInfo *> showInfo;
- ///
- SigC::Signal0<void> showLayoutDocument;
- ///
- SigC::Signal0<void> showLayoutParagraph;
- ///
- SigC::Signal0<void> showLayoutCharacter;
- ///
- SigC::Signal0<void> setUserFreeFont;
- /// show the version control log
- SigC::Signal0<void> showVCLogFile;
- /// show the LaTeX log or build file
- SigC::Signal0<void> showLogFile;
- /// display the top-level maths panel
- SigC::Signal0<void> showMathPanel;
- ///
- SigC::Signal0<void> showPreamble;
- ///
- SigC::Signal0<void> showPreferences;
- ///
- SigC::Signal0<void> showPrint;
- ///
- SigC::Signal1<void, InsetCommand *> showRef;
- ///
- SigC::Signal1<void, string const &> createRef;
+ void updateBufferDependent(bool) const ;
+
+ /** \param name == "about" etc; an identifier used to
+ launch a particular dialog.
+ \param data is a string encoding of the data used to populate
+ the dialog. Several of these dialogs do not need any data,
+ so it defaults to string().
+ */
+ void show(std::string const & name, std::string const & data = std::string());
+
+ /** \param name == "bibtex", "citation" etc; an identifier used to
+ launch a particular dialog.
+ \param data is a string representation of the Inset contents.
+ It is often little more than the output from Inset::write.
+ It is passed to, and parsed by, the frontend dialog.
+ \param inset is _not_ passed to the frontend dialog.
+ It is stored internally and used by the kernel to ascertain
+ what to do with the FuncRequest dispatched from the frontend
+ dialog on 'Apply'; should it be used to create a new inset at
+ the current cursor position or modify an existing, 'open' inset?
+ */
+ void show(std::string const & name, std::string const & data, Inset * inset);
+
+ /** \param name == "citation", "bibtex" etc; an identifier used
+ to update the contents of a particular dialog with \param data.
+ See the comments to 'show', above.
+ */
+ void update(std::string const & name, std::string const & data);
+
+ /// Is the dialog currently visible?
+ bool visible(std::string const & name) const;
+
+ /** All Dialogs of the given \param name will be closed if they are
+ connected to the given \param inset.
+ */
+ static void hide(std::string const & name, Inset * inset);
///
- SigC::Signal0<void> showSearch;
- /// pop up the splash
- SigC::Signal0<void> showSplash;
- /// destroy the splash dialog
- void destroySplash();
+ void disconnect(std::string const & name);
///
- SigC::Signal1<void, InsetTabular *> showTabular;
+ Inset * getOpenInset(std::string const & name) const;
+private:
///
- SigC::Signal1<void, InsetTabular *> updateTabular;
+ void hideSlot(std::string const & name, Inset * inset);
///
- SigC::Signal0<void> showTabularCreate;
+ void redraw() const;
///
- SigC::Signal1<void, InsetMinipage *> showMinipage;
+ bool isValidName(std::string const & name) const;
///
- SigC::Signal1<void, InsetMinipage *> updateMinipage;
+ frontend::Dialog * find_or_build(std::string const & name);
///
- SigC::Signal1<void, InsetCommand *> showTOC;
+ typedef boost::shared_ptr<frontend::Dialog> DialogPtr;
///
- SigC::Signal1<void, string const &> createTOC;
+ DialogPtr build(std::string const & name);
+
///
- SigC::Signal1<void, InsetCommand *> showUrl;
+ LyXView & lyxview_;
///
- SigC::Signal1<void, string const &> createUrl;
+ std::map<std::string, Inset *> open_insets_;
+
///
- SigC::Signal0<void> updateCharacter; // allow update as cursor moves
- //@}
-private:
- /// Add a dialog to the vector of dialogs.
- void add(DialogBase *);
- /// the dialogs being managed
- std::vector<db_ptr> dialogs_;
- /// the splash dialog
- boost::scoped_ptr<DialogBase> splash_;
-};
+ std::map<std::string, DialogPtr> dialogs_;
-inline void Dialogs::add(DialogBase * ptr)
-{
- Assert(ptr);
- dialogs_.push_back(db_ptr(ptr));
-}
+ /// flag against a race condition due to multiclicks in Qt frontend, see bug #1119
+ bool in_show_;
+};
-inline void Dialogs::destroySplash()
-{
- splash_.reset();
-}
+} // namespace lyx
#endif