kopete/libkopete/ui/kopeteinfodialog.h

   1 /*
   2     kopeteinfodialog.h - A dialog to display and configure information
   3
   4     Copyright (c) 2007      by Gustavo Pichorim Boiko <gustavo.boiko@kdemail.net>
   5
   6     Kopete    (c) 2002-2007 by the Kopete developers  <kopete-devel@kde.org>
   7
   8     *************************************************************************
   9     *                                                                       *
  10     * This library is free software; you can redistribute it and/or         *
  11     * modify it under the terms of the GNU Lesser General Public            *
  12     * License as published by the Free Software Foundation; either          *
  13     * version 2 of the License, or (at your option) any later version.      *
  14     *                                                                       *
  15     *************************************************************************
  16 */
  17
  18 #ifndef KOPETEINFODIALOG_H
  19 #define KOPETEINFODIALOG_H
  20
  21 #include <KDE/KDialog>
  22 #include "kopete_export.h"
  23
  24 namespace Kopete
  25 {
  26
  27 namespace UI
  28 {
  29
  30 /**
  31  * \brief a dialog for displaying and configuring information
  32  *
  33  * @author Gustavo Pichorim Boiko <gustavo.boiko AT kdemail.net>
  34  */
  35 class KOPETE_EXPORT InfoDialog : public KDialog
  36 {
  37 Q_OBJECT
  38
  39 public:
  40         /**
  41          * Constructor.
  42          *
  43          * @param parent the parent of this widget
  44          * @param title the title to be shown in the dialog
  45          * @param icon the name of the icon to be used
  46          */
  47         InfoDialog(QWidget *parent,
  48                            const QString &title = QString(), const QString &icon = QString());
  49         /**
  50          * Constructor.
  51          *
  52          * @param parent the parent of this widget
  53          * @param title the title to be shown in the dialog
  54          * @param icon the icon to be used
  55          */
  56         InfoDialog(QWidget *parent,
  57                            const QString &title, const KIcon &icon);
  58
  59         /**
  60          * Destructor.
  61          */
  62         ~InfoDialog();
  63
  64         void setTitle(const QString &title);
  65         void setIcon(const QString &icon);
  66         void setIcon(const KIcon &icon);
  67
  68         void addWidget(QWidget *w, const QString &caption);
  69
  70 protected slots:
  71         /**
  72          * This should be reimplemented in derived dialogs to enable saving info
  73          */
  74         virtual void slotSave();
  75
  76 private:
  77         class Private;
  78         Private * const d;
  79
  80         void initialize();
  81
  82 };
  83
  84 } // namespace UI
  85 } // namespace Kopete
  86 #endif
  87 // vim: set noet ts=4 sts=4 sw=4: