diff options
Diffstat (limited to 'kexi/core/kexi.h')
| -rw-r--r-- | kexi/core/kexi.h | 147 |
1 files changed, 147 insertions, 0 deletions
diff --git a/kexi/core/kexi.h b/kexi/core/kexi.h new file mode 100644 index 00000000..8490ca29 --- /dev/null +++ b/kexi/core/kexi.h @@ -0,0 +1,147 @@ +/* This file is part of the KDE project + Copyright (C) 2003-2005 Jaroslaw Staniek <[email protected]> + + This program 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 program 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 program; see the file COPYING. If not, write to + the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, + * Boston, MA 02110-1301, USA. +*/ + +#ifndef KEXI_H +#define KEXI_H + +#include <qguardedptr.h> +#include <qfont.h> + +#include <kexi_version.h> +#include "kexiprojectdata.h" +#include "kexipartmanager.h" +#include "kexidbconnectionset.h" +#include "kexiprojectset.h" +#include <kexidb/drivermanager.h> +#include <kexidb/driver.h> + +#include <klocale.h> +#include <kmessagebox.h> + +namespace Kexi +{ + KEXICORE_EXPORT void initCmdLineArgs(int argc, char *argv[], KAboutData* aboutData = 0); + + /*! Modes of view for the dialogs. Used mostly for parts and KexiDialogBase. */ + enum ViewMode { + AllViewModes = 0, //!< Usable primarily in KexiPart::initInstanceActions() + NoViewMode = 0, //!< In KexiViewBase::afterSwitchFrom() and KexiViewBase::beforeSwitchTo() + //!< means that parent dialog of the view has not yet view defined. + DataViewMode = 1, + DesignViewMode = 2, + TextViewMode = 4 //!< Also known as SQL View Mode + }; + //! i18n'ed name of view mode \a m + KEXICORE_EXPORT QString nameForViewMode(int m); + + //! A set of known connections + KEXICORE_EXPORT KexiDBConnectionSet& connset(); + + //! A set avaiulable of project infos + KEXICORE_EXPORT KexiProjectSet& recentProjects(); + + //! shared driver manager + KEXICORE_EXPORT KexiDB::DriverManager& driverManager(); + + //! shared part manager + KEXICORE_EXPORT KexiPart::Manager& partManager(); + + //! can be called to delete global objects like driverManager and partManager + //! (and thus, all loaded factories/plugins) + //! before KLibrary::~KLibrary() do this for us + KEXICORE_EXPORT void deleteGlobalObjects(); + + //some temporary flags + + //! false by default, flag loaded on main window startup + KEXICORE_EXPORT bool& tempShowForms(); + + //! false by default, flag loaded on main window startup + KEXICORE_EXPORT bool& tempShowReports(); + + //! false by default, flag loaded on main window startup + KEXICORE_EXPORT bool& tempShowMacros(); + + //! false by default, flag loaded on main window startup + KEXICORE_EXPORT bool& tempShowScripts(); + + /*! A global setting for minimal readable font. + Note: this is defined because KDE has no such setting yet. + \a init is a widget that should be passed if no qApp->mainWidget() is available yet. */ + KEXICORE_EXPORT QFont smallFont(QWidget *init = 0); + + /*! Helper class for storing object status. */ + class KEXICORE_EXPORT ObjectStatus + { + public: + ObjectStatus(); + + ObjectStatus(const QString& message, const QString& description); + + ObjectStatus(KexiDB::Object* dbObject, const QString& message, const QString& description); + + ~ObjectStatus(); + + const ObjectStatus& status() const; + + bool error() const; + + void setStatus(const QString& message, const QString& description); + + //! Note: for safety, \a dbObject needs to be derived from QObject, + //! otherwise it won't be assigned + void setStatus(KexiDB::Object* dbObject, + const QString& message = QString::null, const QString& description = QString::null); + + void setStatus(KexiDB::ResultInfo* result, + const QString& message = QString::null, const QString& description = QString::null); + + void setStatus(KexiDB::Object* dbObject, KexiDB::ResultInfo* result, + const QString& message = QString::null, const QString& description = QString::null); + + void clearStatus(); + + QString singleStatusString() const; + + void append( const ObjectStatus& otherStatus ); + + KexiDB::Object *dbObject() const { return dynamic_cast<KexiDB::Object*>((QObject*)dbObj); } + + //! Helper returning pseudo handler that just updates this ObjectStatus object + //! by receiving a message + operator KexiDB::MessageHandler*(); + + QString message, description; + protected: + QGuardedPtr<QObject> dbObj; //! This is in fact KexiDB::Object + KexiDB::MessageHandler* msgHandler; + }; + + KEXICORE_EXPORT QString msgYouCanImproveData(); + +}//namespace Kexi + +//! Displays information that feature "feature_name" is not availabe in the current application version +KEXICORE_EXPORT void KEXI_UNFINISHED(const QString& feature_name, const QString& extra_text = QString::null); + +//! Like above - for use inside KexiActionProxy subclass - reuses feature name from shared action's text +#define KEXI_UNFINISHED_SHARED_ACTION(action_name) \ + KEXI_UNFINISHED(sharedAction(action_name) ? sharedAction(action_name)->text() : QString::null) + +#endif |