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   // KDE4: Add the "separator" parameter as in KDialogBase
00118   //       Make "dialogType" an int
00119   KConfigDialog( QWidget *parent, const char *name,
00120                  KConfigSkeleton *config,
00121          DialogType dialogType = IconList,
00122          int dialogButtons = Default|Ok|Apply|Cancel|Help,
00123          ButtonCode defaultButton = Ok,
00124          bool modal=false );
00125 
00131   ~KConfigDialog();
00132 
00147   // KDE4: Add a default value for itemName & pixmapName
00148   void addPage( QWidget *page, const QString &itemName,
00149                           const QString &pixmapName,
00150                   const QString &header=QString::null,
00151                   bool manage=true);
00152 
00159   static KConfigDialog* exists( const char* name );
00160 
00167   static bool showDialog( const char* name );
00168 
00172   virtual void show();
00173 
00174 protected slots:
00181   virtual void updateSettings();
00182 
00190   virtual void updateWidgets();
00191 
00198   virtual void updateWidgetsDefault();
00199 
00200 protected:
00201 
00207   virtual bool hasChanged() { return false; }
00208 
00213   virtual bool isDefault() { return true; }
00214   
00215 protected slots:
00219   void updateButtons();
00220 
00224   void settingsChangedSlot();
00225 
00226 private:
00230   static QAsciiDict<KConfigDialog> openDialogs;
00231 
00232   class KConfigDialogPrivate;
00236   KConfigDialogPrivate *d;
00237 };
00238 
00239 #endif //KCONFIGDIALOG_H
00240 
KDE Logo
This file is part of the documentation for kdeui Library Version 3.2.2.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Wed May 5 07:20:01 2004 by doxygen 1.3.6 written by Dimitri van Heesch, © 1997-2003