summaryrefslogtreecommitdiffstats
path: root/kabc/errorhandler.h
blob: e112ed605f2a0301af1223ef9543ca8d087e24a3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
/*
    This file is part of libkabc.

    Copyright (c) 2002 Tobias Koenig <tokoe@kde.org>
    Copyright (c) 2003 Cornelius Schumacher <schumacher@kde.org>

    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 KABC_ERRORHANDLER_H
#define KABC_ERRORHANDLER_H

#include <qstring.h>

#include <kdelibs_export.h>

class QWidget;

namespace KABC {

/**
  Abstract class that provides displaying of error messages.
  We need this to make libkabc gui independent on the one side
  and provide user friendly error messages on the other side.
  Use @p ConsoleErrorHandler or @p GuiErrorHandler in your
  application or provide your own ErrorHandler.
*/
class KABC_EXPORT ErrorHandler
{
  public:
    /**
      Show error message.
    */
    virtual void error( const QString &msg ) = 0;
};

/**
  This class prints the error messages to stderr via kdError().
*/
class KABC_EXPORT ConsoleErrorHandler : public ErrorHandler
{
  public:
    virtual void error( const QString &msg );
};

/**
  This class shows messages boxes for every
  error message.

  \deprecated Use GuiErrorHandler instead.
*/
class KABC_EXPORT GUIErrorHandler : public ErrorHandler
{
  public:
    virtual void error( const QString &msg );
};

/**
  This class shows messages boxes for every
  error message.
*/
class KABC_EXPORT GuiErrorHandler : public ErrorHandler
{
  public:
    /**
      Create error handler.
      
      \param parent Widget which is used as parent for the error dialogs.
    */      
    GuiErrorHandler( QWidget *parent );
  
    virtual void error( const QString &msg );

  private:
    QWidget *mParent;
    
    class Private;
    Private *d;
};

}

#endif