]> git.lyx.org Git - lyx.git/blobdiff - src/frontends/Dialogs.h
* src/frontends/qt4/ui/TextLayoutUi.ui:
[lyx.git] / src / frontends / Dialogs.h
index e586f536645dfe3ad2c464497bbbfc42314dca6e..a81b7536a7a51249f351db110d5ffd5095bb48e9 100644 (file)
 // -*- C++ -*-
 /**
  * \file Dialogs.h
- * See the file COPYING.
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
+ *
  * \author Allan Rae
+ * \author Angus Leeming
  *
- * Full author contact details are available in file CREDITS
+ * Full author contact details are available in file CREDITS.
  */
 
 #ifndef DIALOGS_H
 #define DIALOGS_H
 
-#ifdef __GNUG__
-#pragma interface
-#endif
+#include <boost/signal.hpp>
+#include <boost/utility.hpp>
 
-#include "LString.h"
+#include <map>
 
-#include <boost/utility.hpp>
-#include <boost/scoped_ptr.hpp>
-#include <boost/signals/signal0.hpp>
-#include <boost/signals/signal1.hpp>
+namespace lyx {
 
+class Inset;
 class LyXView;
-class InsetBibKey;
-class InsetBibtex;
-class InsetCommand;
-class InsetError;
-class InsetERT;
-class InsetExternal;
-class InsetFloat;
-class InsetGraphics;
-class InsetInclude;
-class InsetInfo;
-class InsetMinipage;
-class Paragraph;
-class InsetTabular;
-
-/** 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:
        ///
        Dialogs(LyXView &);
-       /// Define an empty d-tor out-of-line to keep boost::scoped_ptr happy.
+       ///
        ~Dialogs();
 
-       /** Redraw all visible dialogs because, for example, the GUI colours
-        *  have been re-mapped.
+       /** Check the status of all visible dialogs and disable or reenable
+        *  them as appropriate.
         *
-        *  Note that static boost signals break some compilers, so we return a
-        *  reference to some hidden magic ;-)
+        *  Disabling is needed for example when a dialog is open and the
+        *  cursor moves to a position where the corresponding inset is not
+        *  allowed.
         */
-       static boost::signal0<void> & redrawGUI();
-
-       /// Toggle tooltips on/off in all dialogs.
-       static void toggleTooltips();
+       void checkStatus();
 
        /// Are the tooltips on or off?
        static bool tooltipsEnabled();
 
-       /**@name Global Hide and Update Signals */
-       //@{
        /// Hide all visible dialogs
-       boost::signal0<void> hideAll;
-
+       void hideAll() const;
        /// Hide any dialogs that require a buffer for them to operate
-       boost::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.
         */
-       boost::signal1<void, bool> updateBufferDependent;
-       //@}
+       void updateBufferDependent(bool) const ;
 
-       /**@name Dialog Access Signals.
-          Put into some sort of alphabetical order */
-       //@{
-       ///
-       void showAboutlyx();
-       /// show the key and label of a bibliography entry
-       void showBibitem(InsetCommand * ic);
-       /// show the bibtex dialog
-       void showBibtex(InsetCommand * ic);
-       ///
-       void showCharacter();
-       /// connected to the character dialog also
-       void setUserFreeFont();
-       ///
-       void showCitation(InsetCommand *);
-       ///
-       void createCitation(string const &);
-       ///
-       void showDocument();
-       ///
-       void showError(InsetError *);
-       ///
-       void showERT(InsetERT *);
-       ///
-       void updateERT(InsetERT *);
-       /// show the external inset dialog
-       void showExternal(InsetExternal *);
-       /// show the contents of a file.
-       void showFile(string const &);
-       ///
-       void showFloat(InsetFloat *);
-       /// show all forked child processes
-       void showForks();
-       ///
-       void showGraphics(InsetGraphics *);
-       /// show the details of a LyX file include inset
-       void showInclude(InsetInclude *);
-       ///
-       void showIndex(InsetCommand *);
-       ///
-       void createIndex();
-       /// show the LaTeX log or build file
-       void showLogFile();
-       /// display the top-level maths panel
-       void showMathPanel();
-       ///
-       void showMinipage(InsetMinipage *);
-       ///
-       void updateMinipage(InsetMinipage *);
-       ///
-       void showParagraph();
-       ///
-       void updateParagraph();
-       ///
-       void showPreamble();
-       ///
-       void showPreferences();
-       ///
-       void showPrint();
+       /** \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);
        ///
-       void showRef(InsetCommand *);
+       void disconnect(std::string const & name);
        ///
-       void createRef(string const &);
+       Inset * getOpenInset(std::string const & name) const;
+private:
        ///
-       void showSearch();
+       void hideSlot(std::string const & name, Inset * inset);
        ///
-       void showSendto();
-       /// bring up the spellchecker
-       void showSpellchecker();
+       void redraw() const;
        ///
-       void showTabular(InsetTabular *);
+       bool isValidName(std::string const & name) const;
        ///
-       void updateTabular(InsetTabular *);
+       frontend::Dialog * find_or_build(std::string const & name);
        ///
-       void showTabularCreate();
-       /// show the TexInfo
-       void showTexinfo();
-       /// show the thesaurus dialog
-       void showThesaurus(string const &);
+       typedef boost::shared_ptr<frontend::Dialog> DialogPtr;
        ///
-       void showTOC(InsetCommand *);
+       DialogPtr build(std::string const & name);
+
        ///
-       void createTOC(string const &);
+       LyXView & lyxview_;
        ///
-       void showUrl(InsetCommand *);
+       std::map<std::string, Inset *> open_insets_;
+
        ///
-       void createUrl(string const &);
-       /// show the version control log
-       void showVCLogFile();
-       //@}
+       std::map<std::string, DialogPtr> dialogs_;
 
-private:
-       /// Use the Pimpl idiom to hide the internals.
-       class Impl;
-       /// The pointer never changes although *pimpl_'s contents may.
-       boost::scoped_ptr<Impl> const pimpl_;
+       /// flag against a race condition due to multiclicks in Qt frontend, see bug #1119
+       bool in_show_;
+
+       ///
+       boost::signals::connection connection_;
 };
 
+} // namespace lyx
+
 #endif