class KCModuleProxy |
|
Encapsulates a KCModule for embedding.
KCModuleProxy is a wrapper for KCModule intended for cases where modules are to be displayed. It ensures layout is consistent and in general takes care of the details needed for making a module available in an interface. A KCModuleProxy can be treated as a QWidget, without worrying about the details specific for modules such as library loading. KCModuleProxy is not a sub class of KCModule but its API closely resembles KCModule's.\n Usually, an instance is created by passing one of the constructors a KService.Ptr, KCModuleInfo or simply the name of the module and then added to the layout as any other widget. \n When the user has changed the module, changed(bool) as well as changed(KCModuleProxy *) is emitted. KCModuleProxy does not take care of prompting for saving - if the object is deleted while changes is not saved the changes will be lost. changed() returns true if changes are unsaved. \n \n KCModuleProxy does not take care of authorization of KCModules. \n KCModuleProxy implements lazy loading, meaning the library will not be loaded or any other initialization done before its show() function is called. This means modules will only be loaded when they are actually needed as well as it is possible to load many KCModuleProxy without any speed penalty. KCModuleProxy should be used in all cases where modules are embedded in order to promote code efficiency and usability consistency.
Author Frans Englich |
|
Constructs a KCModuleProxy from a KCModuleInfo class.
info - The KCModuleInfo to construct the module from. parent - the parent QWidget. args - This is used in the implementation and is internal. Use the default. |
|
Constructs a KCModuleProxy from a module's service name, which is
equivalent to the desktop file for the kcm without the ".desktop" part.
Otherwise equal to the one above.
serviceName - The module's service name to construct from. parent - the parent QWidget. args - This is used in the implementation and is internal. Use the default. |
|
Constructs a KCModuleProxy from KService. Otherwise equal to the one above.
service - The KService to construct from. parent - the parent QWidget. args - This is used in the implementation and is internal. Use the default. |
|
|
|
|
Returns the module's aboutData() |
|
Returns what buttons the module needs |
|
Returns true if the module is modified and needs to be saved. |
|
|
This is emitted in the same situations as in the one above. Practical when several KCModuleProxys are loaded. |
|
When a module running with root privileges and exits, returns to normal mode, the childClosed() signal is emitted. |
|
Returns the embedded KCModule's KComponentData. Returns The module's KComponentData. Deprecated |
|
Returns the DBUS Path |
|
Returns the DBUS Service name |
|
Calling it will cause the contained module to load its default values. |
|
Calling this, results in deleting the contained module, and unregistering from DCOP. A similar result is achieved by deleting the KCModuleProxy itself. |
|
Calling it will cause the contained module to run its load() routine. |
|
Returns a KCModuleInfo for the encapsulated module |
|
Returns the module's quickHelp(); |
|
|
Access to the actual module. However, if the module is
running in root mode, see rootMode(), this function returns
a NULL pointer, since the module is in another process. It may also
return NULL if anything goes wrong.
Returns the encapsulated module. |
|
Returns The module's custom root message, if it has one Deprecated |
|
Calling it will cause the contained module to
run its save() routine.
If the module was not modified, it will not be asked to save. |
|
Reimplemented for internal purposes. Makes sure the encapsulated module is loaded before the show event is taken care of. |
|
Returns If the module is a root module. Deprecated |