// -*- 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.
+ * \author Allan Rae
*
- * LyX, The Document Processor
- *
- * 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>
-
-using std::vector;
-
-#ifdef SIGC_CXX_NAMESPACES
-using SigC::Signal0;
-using SigC::Signal1;
-#endif
#include "LString.h"
-class DialogBase;
+#include <boost/utility.hpp>
+#include <boost/scoped_ptr.hpp>
+#include <boost/signals/signal0.hpp>
+#include <boost/signals/signal1.hpp>
-// Maybe this should be a UIFunc modelled on LyXFunc
-class LyXView;
-class InsetInclude;
-class InsetIndex;
-class InsetBibKey;
-class InsetCitation;
-class InsetBibtex;
-class InsetInfo;
-class InsetTabular;
+class Dialog;
+class InsetBase;
+class LyXView;
/** 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.
*/
-class Dialogs
+class Dialogs : boost::noncopyable
{
public:
- /**@name Constructors and Deconstructors */
- //@{
- ///
- Dialogs(LyXView *);
///
+ Dialogs(LyXView &);
+ /// Define an empty d-tor out-of-line to keep boost::scoped_ptr happy.
~Dialogs();
- //@}
-
- /**@name Global Hide and Update Signals */
+
+ /** Redraw all visible dialogs because, for example, the GUI colours
+ * have been re-mapped.
+ *
+ * Note that static boost signals break some compilers, so we return a
+ * reference to some hidden magic ;-)
+ */
+ static boost::signal0<void> & redrawGUI();
+
+ /// Toggle tooltips on/off in all dialogs.
+ static void toggleTooltips();
+
+ /// Are the tooltips on or off?
+ static bool tooltipsEnabled();
+
+ /// Signals slated to go
//@{
- /// Hide all visible popups
- Signal0<void> hideAll;
-
- /// Hide any popups that require a buffer for them to operate
- Signal0<void> hideBufferDependent;
-
- /// Update visible, buffer-dependent popups
- Signal0<void> updateBufferDependent;
+ boost::signal0<void> hideAllSignal;
+ boost::signal0<void> hideBufferDependentSignal;
+ boost::signal1<void, bool> updateBufferDependentSignal;
//@}
- /**@name Dialog Access Signals */
+ /// Hide all visible dialogs
+ void hideAll() const;
+ /// Hide any dialogs that require a buffer for them to operate
+ 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.
+ */
+ void updateBufferDependent(bool) const ;
+
+ /**@name Dialog Access Signals.
+ Put into some sort of alphabetical order */
//@{
- /// Opens the Preamble Dialog.
- Signal0<void> showPreamble;
- ///
- Signal0<void> showLogFile;
- ///
- Signal1<void, InsetTabular *> showTabular;
- ///
- Signal1<void, InsetTabular *> updateTabular;
///
- Signal1<void, InsetTabular *> hideTabular;
+ void showDocument();
+ /// show all forked child processes
+ void showForks();
///
- Signal0<void> showTabularCreate;
+ void showPreamble();
///
- Signal0<void> showCharacter;
+ void showPreferences();
///
- Signal0<void> updateCharacter; // allow update as cursor moves
+ void showPrint();
///
- Signal0<void> showParagraph;
+ void showSearch();
///
- Signal0<void> showDocument;
- /// Do we really have to push this?
- Signal1<void, vector<string> const &> SetDocumentClassChoice;
- ///
- Signal0<void> showPrint;
+ void showSendto();
+ /// bring up the spellchecker
+ void showSpellchecker();
+ //@}
+
+ /** \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(string const & name, string const & data = 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(string const & name, string const & data, InsetBase * 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(string const & name, string const & data);
+
+ /// is the dialog currently visible?
+ bool visible(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(string const & name, InsetBase * inset);
+ ///
+ void disconnect(string const & name);
+ ///
+ InsetBase * getOpenInset(string const & name) const;
+private:
///
- Signal0<void> showCopyright;
+ void hideSlot(string const & name, InsetBase * inset);
///
- Signal0<void> showCredits;
+ void redraw() const;
///
- Signal0<void> showPreferences;
+ bool isValidName(string const & name) const;
///
- Signal1<void, InsetInclude *> showInclude;
+ Dialog * find(string const & name);
///
- Signal1<void, InsetIndex *> showIndex;
+ Dialog * build(string const & name);
+
///
- Signal1<void, InsetBibKey *> showBibkey;
+ LyXView & lyxview_;
///
- Signal1<void, InsetCitation *> showCitation;
+ std::map<string, InsetBase *> open_insets_;
+
///
- Signal1<void, string const &> createCitation;
+ typedef boost::shared_ptr<Dialog> DialogPtr;
///
- Signal1<void, InsetBibtex *> showBibtex;
+ std::map<string, DialogPtr> dialogs_;
+
+ /// the stuff below is slated to go...
+ void init_pimpl();
///
- Signal1<void, InsetInfo *> showInfo;
- //@}
-private:
- /// Disallow default constructor
- Dialogs() {}
- /// Disallow copy constructor
- Dialogs(Dialogs &) {}
+ class Impl;
///
- vector<DialogBase *> dialogs_;
+ Impl * pimpl_;
};
#endif
-
-
-
-
-
-
-
-