kdeui Library API Documentation

kconfigdialog.h

00001 /*
00002  *  This file is part of the KDE libraries
00003  *  Copyright (C) 2003 Benjamin C Meyer (ben+kdelibs at meyerhome dot net)
00004  *  Copyright (C) 2003 Waldo Bastian <bastian@kde.org>
00005  *
00006  *  This library is free software; you can redistribute it and/or
00007  *  modify it under the terms of the GNU Library General Public
00008  *  License as published by the Free Software Foundation; either
00009  *  version 2 of the License, or (at your option) any later version.
00010  *
00011  *  This library is distributed in the hope that it will be useful,
00012  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
00013  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00014  *  Library General Public License for more details.
00015  *
00016  *  You should have received a copy of the GNU Library General Public License
00017  *  along with this library; see the file COPYING.LIB.  If not, write to
00018  *  the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
00019  *  Boston, MA 02111-1307, USA.
00020  */
00021 #ifndef KCONFIGDIALOG_H
00022 #define KCONFIGDIALOG_H
00023 
00024 class KConfig;
00025 class KConfigSkeleton;
00026 #include <kdialogbase.h>
00027 #include <qasciidict.h>
00028 
00070 class KConfigDialog : public KDialogBase {
00071 Q_OBJECT
00072 
00073 signals:
00077   void widgetModified();
00078 
00083   void settingsChanged();
00084 
00093   void settingsChanged(const char *dialogName);
00094 
00095 public:
00117   KConfigDialog( QWidget *parent, const char *name,
00118                  KConfigSkeleton *config,
00119          KDialogBase::DialogType dialogType = KDialogBase::IconList,
00120          int dialogButtons = KDialogBase::Default | KDialogBase::Ok | KDialogBase::Apply | KDialogBase::Cancel | KDialogBase::Help,
00121          KDialogBase::ButtonCode defaultButton = Ok,
00122          bool modal=false );
00123 
00129   ~KConfigDialog();
00130 
00145   void addPage( QWidget *page, const QString &itemName,
00146                           const QString &pixmapName,
00147                   const QString &header=QString::null,
00148                   bool manage=true);
00149 
00156   static KConfigDialog* exists( const char* name );
00157 
00164   static bool showDialog( const char* name );
00165 
00169   virtual void show();
00170 
00171 protected slots:
00178   virtual void updateSettings();
00179 
00187   virtual void updateWidgets();
00188 
00195   virtual void updateWidgetsDefault();
00196 
00197 protected:
00198 
00204   virtual bool hasChanged() { return false; }
00205 
00210   virtual bool isDefault() { return true; }
00211   
00212 
00213 protected slots:
00217   void updateButtons();
00218 
00222   void settingsChangedSlot();
00223 
00224 private:
00228   static QAsciiDict<KConfigDialog> openDialogs;
00229 
00230   class KConfigDialogPrivate;
00234   KConfigDialogPrivate *d;
00235 };
00236 
00237 #endif //KCONFIGDIALOG_H
00238 
KDE Logo
This file is part of the documentation for kdeui Library Version 3.2.1.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Wed Mar 31 20:37:38 2004 by doxygen 1.3.5 written by Dimitri van Heesch, © 1997-2003