src/frontends/qt4/GuiApplication.h

   1 /**
   2  * \file GuiApplication.h
   3  * This file is part of LyX, the document processor.
   4  * Licence details can be found in the file COPYING.
   5  *
   6  * \author unknown
   7  * \author John Levon
   8  * \author Abdelrazak Younes
   9  *
  10  * Full author contact details are available in file CREDITS.
  11  */
  12
  13 #ifndef GUIAPPLICATION_H
  14 #define GUIAPPLICATION_H
  15
  16 #include "frontends/Application.h"
  17
  18 #include <QApplication>
  19 #include <QList>
  20
  21 class QAbstractItemModel;
  22 class QIcon;
  23 class QObject;
  24 class QSessionManager;
  25 class QSortFilterProxyModel;
  26
  27 namespace lyx {
  28
  29 class BufferView;
  30 class ColorCache;
  31 class KeySymbol;
  32
  33 namespace frontend {
  34
  35 class GuiView;
  36 class LyXView;
  37 class GlobalMenuBar;
  38 class GuiWorkArea;
  39 class Menus;
  40 class SocketNotifier;
  41 class Toolbars;
  42
  43 /// The Qt main application class
  44 /**
  45 There should be only one instance of this class. No Qt object
  46 initialisation should be done before the instanciation of this class.
  47 */
  48 class GuiApplication : public QApplication, public Application
  49 {
  50         Q_OBJECT
  51
  52 public:
  53         GuiApplication(int & argc, char ** argv);
  54         ~GuiApplication();
  55
  56         /// Clear all session information.
  57         void clearSession();
  58
  59         /// \name Methods inherited from Application class
  60         //@{
  61         LyXView * currentWindow();
  62         bool getStatus(FuncRequest const & cmd, FuncStatus & flag) const;
  63         void dispatch(FuncRequest const &, DispatchResult & dr);
  64         void dispatchDelayed(FuncRequest const &);
  65         void resetGui();
  66         void restoreGuiSession();
  67         Clipboard & clipboard();
  68         Selection & selection();
  69         FontLoader & fontLoader();
  70         int exec();
  71         void exit(int status);
  72         bool event(QEvent * e);
  73         bool getRgbColor(ColorCode col, RGBColor & rgbcol);
  74         std::string const hexName(ColorCode col);
  75         void registerSocketCallback(int fd, SocketCallback func);
  76         void unregisterSocketCallback(int fd);
  77         bool searchMenu(FuncRequest const & func, docstring_list & names) const;
  78         docstring iconName(FuncRequest const & f, bool unknown);
  79         void hideDialogs(std::string const & name, Inset * inset) const;
  80         Buffer const * updateInset(Inset const * inset) const;
  81         void handleKeyFunc(FuncCode action);
  82         //@}
  83
  84         Toolbars const & toolbars() const;
  85         Toolbars & toolbars();
  86         Menus const & menus() const;
  87         Menus & menus();
  88
  89         /// \name Methods inherited from QApplication class
  90         //@{
  91         bool notify(QObject * receiver, QEvent * event);
  92         void commitData(QSessionManager & sm);
  93 #ifdef Q_WS_X11
  94         bool x11EventFilter(XEvent * ev);
  95 #endif
  96         //@}
  97
  98         /// Create the main window with given geometry settings.
  99         /// \param geometry_arg: only for Windows platform.
 100         /// \param optional id identifier.
 101         void createView(QString const & geometry_arg = QString(),
 102                 bool autoShow = true, int id = 0);
 103         /// FIXME: this method and the one above are quite ugly.
 104         void createView(int id);
 105         ///
 106         GuiView const * currentView() const { return current_view_; }
 107         ///
 108         GuiView * currentView() { return current_view_; }
 109         ///
 110         void setCurrentView(GuiView * view) { current_view_ = view; }
 111         ///
 112         QList<int> viewIds() const;
 113
 114         ///
 115         ColorCache & colorCache();
 116
 117         QAbstractItemModel * languageModel();
 118
 119         /// return a suitable serif font name.
 120         QString const romanFontName();
 121
 122         /// return a suitable sans serif font name.
 123         QString const sansFontName();
 124
 125         /// return a suitable monospaced font name.
 126         QString const typewriterFontName();
 127         ///
 128         void unregisterView(GuiView * gv);
 129         ///
 130         GuiView & view(int id) const;
 131         ///
 132         void processKeySym(KeySymbol const & key, KeyModifier state);
 133         /// return the status bar state string
 134         docstring viewStatusMessage();
 135
 136 private Q_SLOTS:
 137         ///
 138         void execBatchCommands();
 139         ///
 140         void socketDataReceived(int fd);
 141         /// events to be triggered by general_timer_ should go here
 142         void handleRegularEvents();
 143         ///
 144         void onLastWindowClosed();
 145
 146         ///
 147         void processFuncRequestQueue();
 148
 149 private:
 150         ///
 151         bool closeAllViews();
 152         /// read the given ui (menu/toolbar) file
 153         bool readUIFile(QString const & name, bool include = false);
 154         ///
 155         void setGuiLanguage();
 156
 157         /// This LyXView is the one receiving Clipboard and Selection
 158         /// events
 159         GuiView * current_view_;
 160         ///
 161         struct Private;
 162         Private * const d;
 163 }; // GuiApplication
 164
 165 extern GuiApplication * guiApp;
 166
 167 /// \return the icon file name for the given action.
 168 QString iconName(FuncRequest const & f, bool unknown);
 169
 170
 171 /// \return the pixmap for the given path, name and extension.
 172 QPixmap getPixmap(QString const & path, QString const & name, QString const & ext);
 173
 174 /// \return an icon for the given action.
 175 QIcon getIcon(FuncRequest const & f, bool unknown);
 176
 177 GuiApplication * theGuiApp();
 178
 179 } // namespace frontend
 180 } // namespace lyx
 181
 182 #endif // GUIAPPLICATION_H