# class KCMultiDialog

###

Module | kutils
Namespace |
Class | KCMultiDialog
Inherits | KPageDialog

A class that offers a KPageDialog containing arbitrary KControl Modules.

Author Matthias Elter <elter@kde.org>, Daniel Molkentin <molkentin@kde.org>

### methods

- KCMultiDialog (parent)

  returns ctor

  Argument | Type | Default
  --- | --- | ---
  parent | QWidget | 0

  Constructs a new KCMultiDialog

  parent - The parent widget

- KCMultiDialog (pageWidget, parent, flags)

  returns ctor

  Argument | Type | Default
  --- | --- | ---
  pageWidget | KPageWidget |
  parent | QWidget |
  flags | Qt.WFlags | 0

  This constructor can be used by subclasses to provide a custom KPageWidget.

- KCMultiDialog (dd, pageWidget, parent, flags)

  returns ctor
  Not implemented

  Argument | Type | Default
  --- | --- | ---
  dd | KCMultiDialogPrivate |
  pageWidget | KPageWidget |
  parent | QWidget |
  flags | Qt.WFlags | 0

- addModule (module, args)

  returns KPageWidgetItem

  Argument | Type | Default
  --- | --- | ---
  module | QString |
  args | QStringList | QStringList()

  Add a module.

  The module is added according to its KCModuleInfo.weight(). The weight determines where in the list the module will appear. Lighter modules on top, heavier modules at the bottom.

  module - Specify the name of the module that is to be added to the list of modules the dialog will show.

  args - The arguments that should be given to the KCModule when its created

  Returns The

  See also KPageWidgetItem associated with the new dialog page.

- addModule (moduleinfo, parent, args)

  returns KPageWidgetItem

  Argument | Type | Default
  --- | --- | ---
  moduleinfo | KCModuleInfo |
  parent | KPageWidgetItem | 0
  args | QStringList | QStringList()

  Add a module.

  The module is added according to its KCModuleInfo.weight(). The weight determines where in the list the module will appear. Lighter modules on top, heavier modules at the bottom.

  moduleinfo - Pass a KCModuleInfo object which will be used for creating the module. It will be added to the list of modules the dialog will show.

  parent - The

  See also KPageWidgetItem that should appear as parents in the tree view or a 0 pointer if there is no parent.

  args - The arguments that should be given to the KCModule when its created

- clear ( )

  returns Nothing

  Removes all modules from the dialog.

- configCommitted ( )

  returns Nothing
  SIGNAL ("configCommitted ()")

  Emitted after all KCModules have been told to save their configuration.

  The applyClicked and okClicked signals are emitted before the configuration is saved.

- configCommitted (componentName)

  returns Nothing
  SIGNAL ("configCommitted (const QByteArray&)")

  Argument | Type | Default
  --- | --- | ---
  componentName | QByteArray |

  Emitted after the KCModules 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. componentName tells you the instance that has to reload its configuration.

  The applyClicked and okClicked signals are emitted before the configuration is saved.

  componentName - The name of the instance that needs to reload its configuration.

- slotApplyClicked ( )

  returns Nothing

  This slot is called when the user presses the "Apply" Button. You can reimplement it if needed.

  Make sure you call the original implementation.

- slotDefaultClicked ( )

  returns Nothing

  This slot is called when the user presses the "Default" Button. You can reimplement it if needed.

  Make sure you call the original implementation.

- slotHelpClicked ( )

  returns Nothing

  This slot is called when the user presses the "Help" Button. It reads the X-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.

  Make sure you call the original implementation.

- slotOkClicked ( )

  returns Nothing

  This slot is called when the user presses the "OK" Button. You can reimplement it if needed.

  Make sure you call the original implementation.

- slotUser1Clicked ( )

  returns Nothing

  This slot is called when the user presses the "Reset" Button. You can reimplement it if needed.

  Make sure you call the original implementation.