object.h

/* This file is part of the KDE project
   Copyright (C) 2003-2005 Jaroslaw Staniek <js@iidea.pl>
 
   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 KEXIDB_OBJECT_H
#define KEXIDB_OBJECT_H
 
#include <kexidb/error.h>
#include <tdemessagebox.h>
#include <kstdguiitem.h>
#include <tqstring.h>
 
namespace KexiDB {
 
class MessageHandler;

class KEXI_DB_EXPORT Object
{
    public:
        bool error() const { return m_hasError; }

        const TQString& errorMsg() const { return m_errMsg; }

        int errorNum() const { return m_errno; }

        int previousServerResult() const { return m_previousServerResultNum; }
 
        TQString previousServerResultName() const { return m_previousServerResultName; }

        void debugError();

        virtual void clearError();

        virtual TQString serverErrorMsg();

        virtual int serverResult();

        virtual TQString serverResultName();
        
        TQString msgTitle() const { return m_msgTitle; }

        const TQString recentSQLString() const { return m_errorSql.isEmpty() ? m_sql : m_errorSql; }
 
    protected:
        /* Constructs a new object. 
         \a handler can be provided to receive error messages. */
        Object(MessageHandler* handler = 0);
        
        virtual ~Object();
        
        virtual void setError(int code = ERR_OTHER, const TQString &msg = TQString() );

        virtual void setError( const TQString &msg );

        virtual void setError( const TQString &title, const TQString &msg );
        
        void setError( KexiDB::Object *obj, const TQString& prependMessage = TQString() );

        virtual void setError( KexiDB::Object *obj, int code, 
            const TQString& prependMessage = TQString() );

        virtual int askQuestion( const TQString& message, 
            KMessageBox::DialogType dlgType, KMessageBox::ButtonCode defaultResult,
            const KGuiItem &buttonYes=KStdGuiItem::yes(), 
            const KGuiItem &buttonNo=KStdGuiItem::no(),
            const TQString &dontShowAskAgainName = TQString(),
            int options = KMessageBox::Notify,
            MessageHandler* msgHandler = 0 );

        virtual void drv_clearServerResult() {};

        TQString m_sql, m_errorSql;
        int m_serverResult;
        TQString m_serverResultName, m_serverErrorMsg;
        TQString m_errMsg;
 
    private:
        int m_errno;
        bool m_hasError;

        int m_previousServerResultNum, m_previousServerResultNum2;
        TQString m_previousServerResultName, m_previousServerResultName2;
 
        TQString m_msgTitle;
        MessageHandler *m_msgHandler;
 
        class Private;
        Private *d; 
 
        friend class MessageTitle;
};
 
} //namespace KexiDB
 
#endif