diff options
Diffstat (limited to 'kexi/main/keximainwindowimpl.h')
| -rw-r--r-- | kexi/main/keximainwindowimpl.h | 538 |
1 files changed, 538 insertions, 0 deletions
diff --git a/kexi/main/keximainwindowimpl.h b/kexi/main/keximainwindowimpl.h new file mode 100644 index 00000000..93545439 --- /dev/null +++ b/kexi/main/keximainwindowimpl.h @@ -0,0 +1,538 @@ +/* This file is part of the KDE project + Copyright (C) 2003 Lucijan Busch <lucijan@kde.org> + Copyright (C) 2003-2007 Jaroslaw Staniek <js@iidea.pl> + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public License + along with this library; see the file COPYING.LIB. If not, write to + the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, + * Boston, MA 02110-1301, USA. +*/ + +#ifndef KEXIMAINWINDOWIMPL_H +#define KEXIMAINWINDOWIMPL_H + +#include <kmessagebox.h> +#include "core/keximainwindow.h" +#include "core/kexiguimsghandler.h" + +class KexiProjectData; +class KexiActionProxy; +class KMdiChildView; +class KexiSimplePrintingSettings; + +namespace KexiDB { + class Object; + class ConnectionData; +} +namespace KexiPart { + class Info; + class Part; +} + +/** + * @short Kexi's main window implementation + */ +class KEXIMAIN_EXPORT KexiMainWindowImpl : public KexiMainWindow, public KexiGUIMessageHandler +{ + Q_OBJECT + + public: + /*! Creates an empty mainwindow. */ + KexiMainWindowImpl(); + virtual ~KexiMainWindowImpl(); + + /*! Used by the main kexi routine. Creates a new Kexi main window and a new KApplication object. + kdemain() has to destroy the latter on exit. + \return result 1 on error and 0 on success (the result can be used as a result of kdemain()) */ + static int create(int argc, char *argv[], KAboutData* aboutdata = 0); + + //! \return KexiMainWindowImpl singleton (if it is instantiated) + static KexiMainWindowImpl* self() { return dynamic_cast<KexiMainWindowImpl*>(qApp->mainWidget()); } + + //! Project data of currently opened project or NULL if no project here yet. + virtual KexiProject *project(); + + /*! Registers dialog \a dlg for watching and adds it to the main window's stack. */ + virtual void registerChild(KexiDialogBase *dlg); + + /*! Activates a window by it's document identifier. + \return false if doc couldn't be raised or isn't opened. */ + bool activateWindow(int id); + + /*! Like above, using \a dlg passed explicitly. Above method just calls this one. */ + bool activateWindow(KexiDialogBase *dlg); + + /*! Performs startup actions. \return false if application should exit immediately + with an error status. */ + tristate startup(); + + /*! \return true if the application window is in the User Mode. */ + virtual bool userMode() const; + + /*! \return true if opening of item \a item in \a viewMode mode is allowed. + userMode() is taken into account as well + as KexiPart::Part::supportedUserViewModes() for \a item. */ + bool openingAllowed(KexiPart::Item* item, int viewMode); + + virtual bool eventFilter( QObject *obj, QEvent * e ); + + //! \return popup menu for \a popupName name. + virtual QPopupMenu* findPopupMenu(const char *popupName); + + /*! Implemented for KexiMainWindow. */ + virtual KActionPtrList allActions() const; + + /*! \return currently active dialog (window) od 0 if there is no active dialog. + Implemented for KexiMainWindow. */ + virtual KexiDialogBase* currentDialog() const; + +//! @todo move to kexiproject + /*! Generates ID for private "document" like Relations window. + Private IDs are negative numbers (while ID regular part instance's IDs are >0) + Private means that the object is not stored as-is in the project but is somewhat + generated and in most cases there is at most one unique instance document of such type (part). + To generate this ID, just app-wide internal counter is used. */ + virtual int generatePrivateID(); + + /*! Reimplemented */ + virtual void readProperties(KConfig *config); + virtual void saveProperties(KConfig *config); + virtual void saveGlobalProperties( KConfig* sessionConfig ); + + public slots: + /*! Inherited from KMdiMainFrm: we need to do some tasks before child is closed. + Just calls closeDialog(). Use closeDialog() if you need, not this one. */ + virtual void closeWindow(KMdiChildView *pWnd, bool layoutTaskBar = true); + + /*! Reimplemented for internal reasons. */ + virtual void addWindow( KMdiChildView* pView, int flags = KMdi::StandardAdd ); + + /*! Implemented for KexiMainWindow */ + virtual tristate closeDialog(KexiDialogBase *dlg); + + /*! Internal implementation. If \a doNotSaveChanges is true, + messages asking for saving the will be skipped and the changes will be dropped. + This should not be usually used, maybe except for test suites + (see kexi/tests/altertable/ directory). */ + tristate closeDialog(KexiDialogBase *dlg, bool layoutTaskBar, bool doNotSaveChanges = false); + + virtual void detachWindow(KMdiChildView *pWnd,bool bShow=true); + virtual void attachWindow(KMdiChildView *pWnd,bool bShow=true,bool bAutomaticResize=false); + +//! @todo move part of this to KexiProject, because currently KexiProject::openObject() allows multiple opens! + /*! Opens object pointed by \a item in a view \a viewMode. + \a staticObjectArgs can be passed for static object + (only works when part for this item is of type KexiPart::StaticPart). + \a openingCancelled is set to true is opening has been cancelled. + \a errorMessage, if not 0, points to a string that can be set to error message + if one encountered. */ + virtual KexiDialogBase* openObject(KexiPart::Item *item, int viewMode, + bool &openingCancelled, QMap<QString,QString>* staticObjectArgs = 0, + QString* errorMessage = 0); + + //! For convenience + virtual KexiDialogBase* openObject(const QCString& mime, const QString& name, + int viewMode, bool &openingCancelled, QMap<QString,QString>* staticObjectArgs = 0); + + /*! Closes the object for \a item. + \return true on success (closing can be dealyed though), false on failure and cancelled + if the object has "opening" job assigned. */ + virtual tristate closeObject(KexiPart::Item* item); + + /*! Implemented for KexiMainWindow */ + virtual tristate saveObject( KexiDialogBase *dlg, + const QString& messageWhenAskingForName = QString::null, bool dontAsk = false ); + + /*! Implemented for KexiMainWindow */ + virtual tristate getNewObjectInfo( KexiPart::Item *partItem, KexiPart::Part *part, + bool& allowOverwriting, const QString& messageWhenAskingForName = QString::null ); + + /*! Implemented for KexiMainWindow */ + virtual void highlightObject(const QCString& mime, const QCString& name); + + /*! Opens project pointed by \a projectData. + Application state (e.g. actions) is updated. + \a projectData is copied into a project structures. + \return true on success */ + tristate openProject(const KexiProjectData& projectData); + + /*! Helper. Opens project pointed by \a aFileName. + If \a aFileName is empty, a connection shortcut (.kexic file name) is obtained from + global connection set using \a cdata (if present). + In this case: + * If connection shortcut has been found and \a dbName (a server database name) is provided + 'kexi --skip-dialog --connection file.kexic dbName' is executed (or the project + is opened directly if there's no project opened in the current Kexi main window. + * If connection shortcut has been found and \a dbName is not provided, + 'kexi --skip-dialog file.kexic' is executed (or the connection is opened + directly if there's no porject opened in the current Kexi main window. */ + tristate openProject(const QString& aFileName, KexiDB::ConnectionData *cdata, + const QString& dbName = QString::null, + const QValueList<KexiProjectData::ObjectInfo>& autoopenObjects = QValueList<KexiProjectData::ObjectInfo>()); + + /*! Helper. Opens project pointed by \a aFileName. + Like above but \a fileNameForConnectionData can be passed instead of + a pointer to connection data itself. + \return false if \a fileNameForConnectionData is not empty but there is no such + connection in Kexi::connset() for this filename. + \a fileNameForConnectionData can be empty. */ + tristate openProject(const QString& aFileName, + const QString& fileNameForConnectionData, const QString& dbName = QString::null); + + /*! Creates a new project usign template pointed by \a projectData. + Application state (e.g. actions) is updated. + New project data is copied into a project structures. + \return true on success */ + tristate createProjectFromTemplate(const KexiProjectData& projectData); + + /*! Closes current project, \return true on success. + Application state (e.g. actions) is updated. + \return true on success. + If closing was cancelled by user, cancelled is returned. */ + tristate closeProject(); + + //! Shows "print" dialog for \a item. + //! \return true on success. + virtual tristate printItem(KexiPart::Item* item); + + //! Shows "print preview" dialog. + //! \return true on success. + virtual tristate printPreviewForItem(KexiPart::Item* item); + + //! Shows "page setup" dialog for \a item. + //! \return true on success and cancelled when the action was cancelled. + virtual tristate showPageSetupForItem(KexiPart::Item* item); + + /*! Executes custom action for the main window, usually provided by a plugin. + Also used by KexiFormEventAction. */ + virtual tristate executeCustomActionForObject(KexiPart::Item* item, const QString& actionName); + + signals: + //! Emitted after opening a project, even after slotAutoOpenObjectsLater(). + void projectOpened(); + + protected: + /*! Initialises the User Mode: constructs window according to kexi__final database + and loads the specified part. + \return true on success or false if e.g. kexi__final does not exist + or a fatal exception happened */ + bool initUserMode(KexiProjectData *projectData); + + /*! + Creates navigator (if it's not yet created), + lookups items for current project and fills the nav. with not-opened items + */ + void initNavigator(); + + void initContextHelp(); + + void initPropertyEditor(); + + //! reimplementation of events +// virtual void closeEvent(QCloseEvent *); + + /*! Creates standard actions like new, open, save ... */ + void initActions(); + + /*! Creates user project-wide actions */ + void initUserActions(); + + /*! Sets up the window from user settings (e.g. mdi mode). */ + void restoreSettings(); + + /*! Writes user settings back. */ + void storeSettings(); + + /*! Invalidates availability of all actions for current application state. */ + void invalidateActions(); + + /*! Invalidates action availability for current application state. + These actions are dependent on curently selected dialog. */ + virtual void invalidateSharedActions(QObject *o); + + /*! Invalidates action availability for current application state. + These actions only depend on project availability, not on curently selected dialog. */ + void invalidateProjectWideActions(); + + /*! Invalidates action availability for current application state. + These actions only depend on curently selected dialog and currently selected view + (KexiViewBase derived object) within this dialog. */ + void invalidateViewModeActions(); + + /*! Shows dialog for creating new blank project, + and creates one. Dialog is not shown if option for automatic creation + is checked or Kexi::startupHandler().projectData() was provided from command line. + \a cancelled is set to true if creation has been cancelled (e.g. user answered + no when asked for database overwriting, etc. + \return true if database was created, false on error or when cancel was pressed */ + tristate createBlankProject(); + + /*! Shows dialog for creating new blank project, + and return a data describing it. It the dialog was cancelled, + \a cancelled will be set to true (false otherwise). + \a shortcutFileName, if not 0, will be set to a shortcut filename + (in case when server database project was selected). */ + KexiProjectData* createBlankProjectData(bool &cancelled, bool confirmOverwrites = true, + QString *shortcutFileName = 0); + + void setWindowMenu(QPopupMenu *menu); + + /*! \return focused kexi window (KexiDialogBase or KexiDockBase subclass) */ +// QWidget* focusWindow() const; + + /*! Reimplemented from KexiSharedActionHost: + accepts only KexiDockBase and KexiDialogBase subclasses. */ + virtual bool acceptsSharedActions(QObject *w); + + /*! Performs lookup like in KexiSharedActionHost::focusWindow() + but starting from \a w instead of a widget returned by QWidget::focusWidget(). + \return NULL if no widget matches acceptsSharedActions() or if \a w is NULL. */ + QWidget* findWindow(QWidget *w); + + /*! Updates application's caption - also shows project's name. */ + void updateAppCaption(); + + void restoreWindowConfiguration(KConfig *config); + void storeWindowConfiguration(KConfig *config); + + virtual bool queryClose(); + virtual bool queryExit(); + + /*! Helper: switches to view \a mode. */ + bool switchToViewMode(int viewMode); + + /*! Helper. Removes and/or adds GUI client for current dialog's view; + on switching to other dialog (activeWindowChanged()) + or on switching to other view within the same dialog (switchToViewMode()). */ + void updateDialogViewGUIClient(KXMLGUIClient *viewClient); + + /*! Helper. Updates setup of property panel's tabs. Used when switching + from \a prevDialog dialog to a current dialog. */ + void updateCustomPropertyPanelTabs(KexiDialogBase *prevDialog, int prevViewMode); + + /*! @overload void updateCustomPropertyPanelTabs(KexiDialogBase *prevDialog, int prevViewMode) */ + void updateCustomPropertyPanelTabs( + KexiPart::Part *prevDialogPart, int prevViewMode, KexiPart::Part *curDialogPart, int curViewMode ); + + /*! Used in openProject when running another Kexi process is required. */ + tristate openProjectInExternalKexiInstance(const QString& aFileName, + KexiDB::ConnectionData *cdata, const QString& dbName); + + /*! Used in openProject when running another Kexi process is required. */ + tristate openProjectInExternalKexiInstance(const QString& aFileName, + const QString& fileNameForConnectionData, const QString& dbName); + + protected slots: + + /*! Called once after timeout (after ctors are executed). */ + void slotAutoOpenObjectsLater(); + + /*! This slot is called if a window changes */ + void activeWindowChanged(KMdiChildView *dlg); + + /*! Tthis slot is called if a window gets colsed and will unregister stuff */ + void childClosed(KMdiChildView *dlg); + + void slotPartLoaded(KexiPart::Part* p); + + void slotCaptionForCurrentMDIChild(bool childrenMaximized); + void slotNoMaximizedChildFrmLeft(KMdiChildFrm*); + void slotLastChildViewClosed(); + void slotChildViewIsDetachedNow(QWidget*); + + //! internal - creates and initializes kexi project + void createKexiProject(KexiProjectData* new_data); + + /*! Handles event when user double clicked (or single -depending on settings) + or pressed Return key on the part item in the navigator. + This differs from openObject() signal in that if the object is already opened + in view mode other than \a viewMode, the mode is not changed. + \sa KexiBrowser::openOrActivateItem() */ + KexiDialogBase* openObjectFromNavigator(KexiPart::Item* item, int viewMode, + bool &openingCancelled); + + //! For convenience + KexiDialogBase* openObjectFromNavigator(KexiPart::Item* item, int viewMode); + + /*! Creates new object of type defined by \a info part info. + \a openingCancelled is set to true is opening has been cancelled. + \return true on success. */ + virtual bool newObject( KexiPart::Info *info, bool& openingCancelled ); + + //! For convenience + bool newObject( KexiPart::Info *info ) { + bool openingCancelled; + return newObject(info, openingCancelled); + } + + //! For convenience + KexiDialogBase* openObject(KexiPart::Item *item, int viewMode, + QMap<QString,QString>* staticObjectArgs = 0) + { + bool openingCancelled; + return openObject(item, viewMode, openingCancelled, staticObjectArgs); + } + + /*! Removes object pointed by \a item from current project. + Asks for confirmation. \return true on success + or cancelled if removing was cancelled (only possible if \a dontAsk is false). */ + tristate removeObject( KexiPart::Item *item, bool dontAsk = false ); + + /*! Renames object pointed by \a item to a new name \a _newName. + Sets \a success to false on failure. Used as a slot connected + to KexiBrowser::renameItem() signal. */ + void renameObject( KexiPart::Item *item, const QString& _newName, bool &succes ); + + /*! Reaction for object rename (signalled by KexiProject). + If this item has opened dialog, it's caption is updated, + and also optionally application's caption. */ + virtual void slotObjectRenamed(const KexiPart::Item &item, const QCString& oldName); + + virtual void fillWindowMenu(); + + void invalidateSharedActions(); + void invalidateSharedActionsLater(); + + //! Updates the statusbar, navigator and "Insert->....." actions, dependent on read-only state. + //! Only called on project opening and closing. + void updateReadOnlyState(); + + void slotProjectNew(); + void slotProjectOpen(); + void slotProjectOpenRecentAboutToShow(); + void slotProjectOpenRecent(int id); + void slotProjectOpenRecentMore(); + void slotProjectSave(); + void slotProjectSaveAs(); + void slotProjectPrint(); + void slotProjectPrintPreview(); + void slotProjectPageSetup(); + void slotProjectProperties(); + void slotProjectClose(); + void slotProjectRelations(); + void slotProjectImportDataTable(); + void slotProjectExportDataTable(); + void slotProjectQuit(); + void slotEditPasteSpecialDataTable(); + void slotEditCopySpecialDataTable(); + void slotEditFind(); + void slotEditFind(bool next); //!< helper + void slotEditFindNext(); + void slotEditFindPrevious(); + void slotEditReplace(bool all); //!< helper + void slotEditReplace(); + void slotEditReplaceNext(); + void slotEditReplaceAll(); + void slotViewNavigator(); + void slotViewMainArea(); + void slotViewPropertyEditor(); + void slotViewDataMode(); + void slotViewDesignMode(); + void slotViewTextMode(); //!< sometimes called "SQL View" + void slotShowSettings(); + void slotConfigureKeys(); + void slotConfigureToolbars(); + void slotToolsProjectMigration(); + void slotToolsCompactDatabase(); + + /// TMP: Display a dialog to download db examples from internet + void slotGetNewStuff(); + + void slotTipOfTheDay(); + + //! Shows 'important info' dialog, is \a onStartup is false, it's always shown + void importantInfo(bool onStartup); + void slotImportantInfo(); //!< just importantInfo(false); + void slotStartFeedbackAgent(); + + void slotOptionsEnableForms(bool show, bool noMessage = false); //temp. + + void slotImportFile(); + void slotImportServer(); + + //! There are performed all actions that need to be done immediately after ctro (using timer) + void slotLastActions(); + + virtual void acceptPropertySetEditing(); + + virtual void propertySetSwitched(KexiDialogBase *dlg, bool force=false, + bool preservePrevSelection = true, const QCString& propertyToSelect = QCString()); + + /*! Handles changes in 'dirty' flag for dialogs. */ + void slotDirtyFlagChanged(KexiDialogBase*); + + void slotMdiModeHasBeenChangedTo(KMdi::MdiMode); + + //! reimplemented to add "restart is required" message box + virtual void switchToIDEAlMode(); + void switchToIDEAlMode(bool showMessage); + virtual void switchToChildframeMode(); + void switchToChildframeMode(bool showMessage); + + /*! Shows Project Migration Wizard. \return true on successful migration, + cancelled on cancellation, and false on failure. + If \a mimeType and \a databaseName are not empty, the wizard will only ask about + parameters of destination project and skip pages related to source project. + \a cdata connection data can be also provided to preselect server-based connections. */ + tristate showProjectMigrationWizard(const QString& mimeType, const QString& databaseName, + const KexiDB::ConnectionData *cdata = 0); + + //! Receives "selectionChanged()" signal from navigator to update some actions. + void slotPartItemSelectedInNavigator(KexiPart::Item* item); + + /*! Receives the "executeItem" signal from navigator to perform "execute" action + on \a item. \return true on success */ + tristate executeItem(KexiPart::Item* item); + + //! Shows "exports as data table" dialog for \a item. + tristate exportItemAsDataTable(KexiPart::Item* item); + + //! Shows "copy special as data table" dialog for \a item. + tristate copyItemToClipboardAsDataTable(KexiPart::Item* item); + + //! Shows "print" dialog for \a item. + //! \return true on success. + bool printItem(KexiPart::Item* item, const QString& titleText); + + //! Shows "print" dialog for \a item and \a settings. + //! \return true on success. + bool printItem(KexiPart::Item* item, const KexiSimplePrintingSettings& settings, + const QString& titleText = QString::null); + + /*! Shows "print preview" dialog for \a item. + The preview dialog is cached, so \a reload == true is sometimes needed + if data or print settings have changed in the meantime. + \return true on success. */ + bool printPreviewForItem(KexiPart::Item* item, const QString& titleText, + bool reload); + + //! Shows "print preview" dialog. + //! \return true on success. + bool printPreviewForItem(KexiPart::Item* item, const KexiSimplePrintingSettings& settings, + const QString& titleText = QString::null, bool reload = false); + + /*! Implemented for KexiMainWindow. Helper for printItem() and printPreviewForItem(). + Also used by KexiFormEventAction. + \return true on success and cancelled when the action was cancelled. */ + tristate printActionForItem(KexiPart::Item* item, PrintActionType action); + + private: + class MessageHandler; + class Private; + Private *d; + + friend class KexiDialogBase; +}; + +#endif + |