You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
koffice/kexi/main/keximainwindowimpl.h

539 lines
21 KiB

/* 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