X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=src%2Ffrontends%2Fqt4%2FDialog.h;h=5f958e79d0d835a552354de0cf7a704437b913c6;hb=b7f6b979d0f889f08e735f35378bb20ba3788b4b;hp=64dd73008644fb1b63c3d2fca40d0a92ae26f2d5;hpb=604c1148ea8beedaebbe0bdbe5a0adc76237a697;p=lyx.git diff --git a/src/frontends/qt4/Dialog.h b/src/frontends/qt4/Dialog.h index 64dd730086..5f958e79d0 100644 --- a/src/frontends/qt4/Dialog.h +++ b/src/frontends/qt4/Dialog.h @@ -12,10 +12,15 @@ #ifndef DIALOG_H #define DIALOG_H -#include "lfuns.h" +#include "FuncCode.h" -#include +#include "insets/InsetCode.h" +#include "support/strfwd.h" + +#include + +class QSettings; class QWidget; namespace lyx { @@ -23,6 +28,7 @@ namespace lyx { class Buffer; class BufferView; class FuncRequest; +class Inset; namespace frontend { @@ -39,23 +45,43 @@ enum KernelDocType DOCBOOK }; - /** \c Dialog collects the different parts of a Model-Controller-View * split of a generic dialog together. */ -class Dialog +class Dialog { public: /// \param lv is the access point for the dialog to the LyX kernel. /// \param name is the identifier given to the dialog by its parent /// container. - Dialog(GuiView & lv, std::string const & name); + /// \param title is the window title used for decoration. + Dialog(GuiView & lv, QString const & name, QString const & title); virtual ~Dialog(); virtual QWidget * asQWidget() = 0; virtual QWidget const * asQWidget() const = 0; + /// Session key. + /** + * This key must be used for any session setting. + **/ + QString sessionKey() const; + + /// Save session settings. + /** + * This default implementation saves the geometry state. + * Reimplement to save more settings. + **/ + virtual void saveSession(QSettings & settings) const; + + /// Restore session settings. + /** + * This default implementation restores the geometry state. + * Reimplement to restore more settings. + **/ + virtual void restoreSession(); + /** \name Container Access * These methods are publicly accessible because they are invoked * by the parent container acting on commands from the LyX kernel. @@ -64,9 +90,11 @@ public: /// \param data is a string encoding of the data to be displayed. /// It is passed to the Controller to be translated into a useable form. virtual void showData(std::string const & data); - virtual void updateData(std::string const & data); //@} + /// \return inset at current cursor location. + Inset const * inset(InsetCode code) const; + /** Check whether we may apply our data. * * The buttons are disabled if not and (re-)enabled if yes. @@ -93,9 +121,17 @@ public: /// Hide the dialog from sight void hideView(); - /// Create the dialog if necessary, update it and display it. + /// Prepare dialog and display it. void showView(); + /// Prepare dialog before view. + void prepareView(); + + /// Decide wether the dialog should grab thekeyboard focus when shown. + /// This method defaults to true, override if a different behaviour + /// is wanted. + virtual bool wantInitialFocus() const { return true; } + /// Update the display of the dialog whilst it is still visible. virtual void updateView() = 0; @@ -108,10 +144,7 @@ public: //@} /// Dialog identifier. - /// FIXME for Andre': Now that Dialog is entirely within qt4/ - /// We can use QString instead in order to avoid inclusion - /// or we can pimpl name_. - std::string const & name() const; + QString name() const { return name_; } //@{ /** Enable the controller to initialise its data structures. @@ -126,10 +159,15 @@ public: /// Enable the Controller to dispatch its data back to the LyX kernel. virtual void dispatchParams() = 0; + /** \return true if the dialog should be updated when the + * buffer has changed. + */ + virtual bool isBufferDependent() const = 0; + /** \return true if the dialog should be shown only when * a buffer is open. */ - virtual bool isBufferDependent() const = 0; + virtual bool needBufferOpen() const = 0; /** \return true if the dialog can apply data also * for ReadOnly buffers. @@ -145,7 +183,7 @@ public: * It should be used in dispatchParams(), too for consistency reasons. * \returns the lfun that is sent for applying the data. */ - virtual kb_action getLfun() const { return LFUN_INSET_APPLY; } + virtual FuncCode getLfun() const { return LFUN_INSET_APPLY; } /** Check whether we may apply our data. * @@ -165,11 +203,6 @@ public: */ virtual bool disconnectOnApply() const { return false; } - /** \return true if Dialog::View::show() should not display the dialog - * after running update. Currently, only ControlSpellchecker - * makes use of that. - */ - virtual bool exitEarly() const { return false; } //@} /** \c Kernel part: a wrapper making the LyX kernel available to the dialog. @@ -198,7 +231,6 @@ public: * stored by the dialog are not applied to the inset currently * connected to the dialog. Instead, they will be used to generate * a new inset at the cursor position. - * \param name is used to identify the dialog to the kernel. */ void disconnect() const; @@ -208,7 +240,7 @@ public: //@{ bool isBufferAvailable() const; bool isBufferReadonly() const; - std::string const bufferFilepath() const; + QString bufferFilePath() const; //@} /// The type of the current buffer. @@ -219,31 +251,36 @@ public: * We should aim to reduce/remove these from the interface. */ //@{ - GuiView & lyxview() { return *lyxview_; } - GuiView const & lyxview() const { return *lyxview_; } - - Buffer & buffer(); + GuiView const & lyxview() const { return lyxview_; } + /// Current buffer Buffer const & buffer() const; - - BufferView * bufferview(); + /// Main document buffer + Buffer const & documentBuffer() const; + /// Current BufferView BufferView const * bufferview() const; //@} protected: + /// + void setTitle(QString const & title) { title_ = title; } + /// virtual void apply(); + /// To be called when the buffer view has changed + virtual void onBufferViewChanged() = 0; private: /** The Dialog's name is the means by which a dialog identifies - * itself to the LyXView. + * itself to the GuiView. */ - std::string const name_; + QString const name_; /// - GuiView * lyxview_; + QString title_; + /// + GuiView & lyxview_; /// intentionally unimplemented, therefore uncopiable Dialog(Dialog const &); void operator=(Dialog const &); - };