summaryrefslogtreecommitdiffstats
path: root/kutils/kcmultidialog.h
diff options
context:
space:
mode:
Diffstat (limited to 'kutils/kcmultidialog.h')
-rw-r--r--kutils/kcmultidialog.h288
1 files changed, 0 insertions, 288 deletions
diff --git a/kutils/kcmultidialog.h b/kutils/kcmultidialog.h
deleted file mode 100644
index 46dde98fb..000000000
--- a/kutils/kcmultidialog.h
+++ /dev/null
@@ -1,288 +0,0 @@
-/*
- Copyright (c) 2000 Matthias Elter <elter@kde.org>
- Copyright (c) 2003 Daniel Molkentin <molkentin@kde.org>
- Copyright (c) 2003 Matthias Kretz <kretz@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 KCMULTIDIALOG_H
-#define KCMULTIDIALOG_H
-
-#include <tqptrdict.h>
-
-#include <kdialogbase.h>
-#include <klocale.h>
-#include <kservice.h>
-
-class TDECModuleProxy;
-class TDECModuleInfo;
-
-/**
- * @ingroup tdecmodule
- * @short A method that offers a KDialogBase containing arbitrary
- * KControl Modules.
- *
- * @author Matthias Elter <elter@kde.org>, Daniel Molkentin <molkentin@kde.org>
- * @since 3.2
- */
-class KUTILS_EXPORT KCMultiDialog : public KDialogBase
-{
- Q_OBJECT
-
-public:
- /**
- * Constructs a new KCMultiDialog
- *
- * @param parent The parent widget
- * @param name The widget name
- * @param modal If you pass true here, the dialog will be modal
- **/
- KCMultiDialog( TQWidget *parent=0, const char *name=0, bool modal=false );
-
- /**
- * Construct a personalized KCMultiDialog.
- *
- * @param dialogFace You can use TreeList, Tabbed, Plain, Swallow or
- * IconList.
- * @param caption The dialog caption. Do not specify the application name
- * here. The class will take care of that.
- * @param parent Parent of the dialog.
- * @param name Dialog name (for internal use only).
- * @param modal Controls dialog modality. If @p false, the rest of the
- * program interface (example: other dialogs) is accessible while
- * the dialog is open.
- */
- KCMultiDialog( int dialogFace, const TQString & caption, TQWidget * parent = 0,
- const char * name = 0, bool modal = false );
-
-
- /**
- * Constructor for the predefined layout mode where you specify the
- * kind of layout (face) and also add buttons. Note that the User1 button
- * of KDialogBase is already used to provide a "Reset" button so only
- * two more buttons are available to users of KCMultiDialog. When clicked
- * they trigger slotUser2() and slotUser3().
- *
- * @note If any root modules are added to the dialog when this constructor is
- * used, it will not be able to run them with root privileges. Since that will
- * render them useless, it is a good idea to use another constructor. In KDE 4
- * the argument @p user3 will be removed.
- *
- * @param dialogFace You can use TreeList, Tabbed, Plain, Swallow or
- * IconList.
- * @param user2 User button2 text item.
- * @param user3 User button3 text item.
- * @param buttonMask Specifies which buttons will be visible. If zero
- * (0) no extra buttons will be added. You can only use the User2 and
- * User3 buttons. The User1 button is already used internally. See
- * KDialogBase for more information on this.
- * @param caption The dialog caption. Do not specify the application name
- * here. The class will take care of that.
- * @param parent Parent of the dialog.
- * @param name Dialog name (for internal use only).
- * @param modal Controls dialog modality. If @p false, the rest of the
- * program interface (example: other dialogs) is accessible while
- * the dialog is open.
- */
- KCMultiDialog( int dialogFace, const KGuiItem &user2,
- const KGuiItem &user3=KGuiItem(), int buttonMask=User2,
- const TQString &caption=i18n("Configure"), TQWidget *parent=0,
- const char *name=0, bool modal=false ) KDE_DEPRECATED;
- // KDE4 remove the user3 argument, and instead initialize it to KStdGuiItem::adminMode.
-
- /**
- * Destructor
- **/
- virtual ~KCMultiDialog();
-
- /**
- * Add a module.
- *
- * @param module Specify the name of the module that is to be added
- * to the list of modules the dialog will show.
- *
- * @param withfallback Try harder to load the module. Might result
- * in the module appearing outside the dialog.
- *
- * @param args List of arguments to pass to the module.
- **/
- void addModule(const TQString& module, bool withfallback=true, TQStringList args = TQStringList());
-
- /**
- * Add a module.
- *
- * @param moduleinfo Pass a TDECModuleInfo object which will be
- * used for creating the module. It will be added
- * to the list of modules the dialog will show.
- *
- * @param parentmodulenames The names of the modules that should appear as
- * parents in the TreeList. Look at the
- * KDialogBase::addPage documentation for more info
- * on this.
- *
- * @param withfallback Try harder to load the module. Might result
- * in the module appearing outside the dialog.
- *
- * @param args List of arguments to pass to the module.
- **/
- void addModule(const TDECModuleInfo& moduleinfo, TQStringList
- parentmodulenames = TQStringList(), bool withfallback=false, TQStringList args = TQStringList());
-
- /**
- * Remove all modules from the dialog.
- */
- void removeAllModules();
-
- /**
- * @internal
- * Re-implemented for internal reasons.
- */
- void show();
-
-signals:
- /**
- * Emitted after all TDECModules have been told to save their configuration.
- *
- * The applyClicked and okClicked signals are emitted before the
- * configuration is saved.
- */
- void configCommitted();
-
- /**
- * Emitted after the TDECModules have been told to save their configuration.
- * It is emitted once for every instance the KCMs that were changed belong
- * to.
- *
- * You can make use of this if you have more than one component in your
- * application. instanceName tells you the instance that has to reload its
- * configuration.
- *
- * The applyClicked and okClicked signals are emitted before the
- * configuration is saved.
- *
- * @param instanceName The name of the instance that needs to reload its
- * configuration.
- */
- void configCommitted( const TQCString & instanceName );
-
-protected slots:
- /**
- * This slot is called when the user presses the "Default" Button.
- * You can reimplement it if needed.
- *
- * @note Make sure you call the original implementation.
- **/
- virtual void slotDefault();
-
- /**
- * This slot is called when the user presses the "Reset" Button.
- * You can reimplement it if needed.
- *
- * @note Make sure you call the original implementation.
- */
- virtual void slotUser1();
-
- /**
- * This slot is called when the user presses the "Apply" Button.
- * You can reimplement it if needed.
- *
- * @note Make sure you call the original implementation.
- **/
- virtual void slotApply();
-
- /**
- * This slot is called when the user presses the "OK" Button.
- * You can reimplement it if needed.
- *
- * @note Make sure you call the original implementation.
- **/
- virtual void slotOk();
-
- /**
- * This slot is called when the user presses the "Help" Button.
- * It reads the DocPath field of the currently selected KControl
- * module's .desktop file to find the path to the documentation,
- * which it then attempts to load.
- *
- * You can reimplement this slot if needed.
- *
- * @note Make sure you call the original implementation.
- **/
- virtual void slotHelp();
-
-private slots:
-
- void slotAboutToShow(TQWidget *);
-
- void clientChanged(bool state);
-
- /**
- * Called when entering root mode, and disables
- * the Admin Mode button such that the user doesn't do it
- * twice.
- *
- * @since 3.4
- */
- void disableRModeButton();
-
- /**
- * Called when the current module exits from root
- * mode. Enables the Administrator Mode button, again.
- *
- * @since 3.4
- */
- void rootExit();
-
- /**
- *
- * Called when the dialog is hidden. It unregisters the modules,
- * such that they don't hinder the same modules to be opened in
- * another application.
- *
- * @since 3.4
- */
- void dialogClosed();
-
-private:
-
- void init();
- void apply();
-
- struct CreatedModule
- {
- TDECModuleProxy * kcm;
- KService::Ptr service;
- /* KDE 4 Move to Private class */
- };
- typedef TQValueList<CreatedModule> ModuleList;
- ModuleList m_modules;
-
- typedef TQMap<KService::Ptr, TDECModuleProxy*> OrphanMap;
- OrphanMap m_orphanModules;
-
- TQPtrDict<TQStringList> moduleParentComponents;
- TQString _docPath;
- int dialogface;
-
- class KCMultiDialogPrivate;
- KCMultiDialogPrivate *d;
-};
-
-#endif //KCMULTIDIALOG_H
-
-// vim: sw=4 sts=4 et
generated by cgit v1.2.1 (git 2.18.0) at 2024-10-27 19:04:44 +0000