BALL  1.4.79
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
Public Member Functions | Protected Slots | List of all members
BALL::VIEW::PluginDialog Class Reference

#include <BALL/VIEW/DIALOGS/pluginDialog.h>

Inheritance diagram for BALL::VIEW::PluginDialog:
QWidget BALL::VIEW::ModularWidget BALL::VIEW::PreferencesEntry BALL::PluginHandler BALL::Embeddable BALL::VIEW::ConnectionObject

Public Member Functions

 PluginDialog (Preferences *preferences, QWidget *parent, const char *name="PluginDialog")
 
virtual ~PluginDialog ()
 
virtual void initializeWidget (MainControl &main_control)
 
virtual void finalizeWidget (MainControl &main_control)
 
virtual void writePreferenceEntries (INIFile &inifile)
 Store the settings of all registered objects. More...
 
virtual void readPreferenceEntries (const INIFile &inifile)
 Restore the settings of all registered objects. More...
 
virtual void registerChildEntry (PreferencesEntry *child)
 
virtual void unregisterChildEntry (PreferencesEntry *child)
 
bool canHandle (BALLPlugin *plugin) const
 
bool specificSetup_ (BALLPlugin *plugin)
 
bool specificShutdown_ (BALLPlugin *plugin)
 
- Public Member Functions inherited from BALL::VIEW::ModularWidget
void setWorkingDirFromFilename_ (String filename)
 
virtual void showHelp (const String &url)
 
 ModularWidget (const char *name="<ModularWidget>")
 
 ModularWidget (const ModularWidget &widget)
 
virtual ~ModularWidget ()
 
virtual void destroy ()
 
virtual void clear ()
 
virtual void checkMenu (MainControl &main_control)
 
QAction * insertMenuEntry (Position parent_id, const QString &name, const QObject *receiver=0, const char *slot=0, const String &description="", QKeySequence accel=QKeySequence(), const QString &menu_hint=QString(""), UIOperationMode::OperationMode minimal_mode=UIOperationMode::MODE_ALL)
 
void setMenuHelp (QAction *action, const String &url)
 
virtual void registerForHelpSystem (const QObject *object, const String &url)
 
virtual void addToolBarEntries (QToolBar *main_tb)
 
void setIcon (QAction *action, const String &filename, bool add_to_main_toolbar=true)
 
virtual void initializePreferencesTab (Preferences &preferences)
 
virtual void finalizePreferencesTab (Preferences &preferences)
 
virtual void applyPreferences ()
 
virtual void fetchPreferences (INIFile &inifile)
 
virtual void writePreferences (INIFile &inifile)
 
bool lockComposites ()
 
bool unlockComposites ()
 Unlock the Composites. More...
 
MainControlgetMainControl () const
 
virtual void setStatusbarText (const String &text, bool important=false)
 
virtual void setStatusbarText (const QString &text, bool important=false)
 
String getWorkingDir ()
 Implemented for convenience. More...
 
void setWorkingDir (const String &dir)
 Implemented for convenience. More...
 
FragmentDBgetFragmentDB () const
 
virtual void dump (std::ostream &s=std::cout, Size depth=0) const
 
virtual bool canHandle (const String &) const
 
virtual bool openFile (const String &)
 
- Public Member Functions inherited from BALL::Embeddable
 Embeddable (const String &identifier="<Embeddable>")
 
 Embeddable (const Embeddable &embeddable)
 
virtual ~Embeddable ()
 
void setIdentifier (const String &identifier)
 
const StringgetIdentifier () const
 
void unregisterThis ()
 
virtual void registerThis ()
 
- Public Member Functions inherited from BALL::VIEW::ConnectionObject
 ConnectionObject ()
 
virtual ~ConnectionObject ()
 
void registerConnectionObject (ConnectionObject &object)
 
void unregisterConnectionObject (ConnectionObject &object)
 
bool isConnectionObjectRegistered (const ConnectionObject &object)
 
ConnectionObjectgetParent () const
 
ConnectionObjectgetRoot ()
 
virtual void onNotify (Message *message)
 
virtual bool isValid () const
 
- Public Member Functions inherited from BALL::VIEW::PreferencesEntry
 PreferencesEntry ()
 
virtual ~PreferencesEntry ()
 
void setINIFileSectionName (const String &name)
 Set the name for the section in the INIFile. More...
 
const StringgetINIFileSectionName () const
 Get the name for the section in the INIFile. More...
 
void setWidgetStackName (const String &name)
 
StackPagesgetStackPages ()
 Return all pages, that are to be shown in a parent QStackedWidget. More...
 
void setWidgetStack (QStackedWidget *stack)
 
virtual void showStackPage (Position nr)
 Show the specified page in the QStackedWidget. More...
 
virtual void showStackPage (QWidget *widget)
 Show the specified page in the QStackedWidget. More...
 
virtual Position currentStackPage () const
 Get the currently shown page in the QStackedWidget. More...
 
virtual void restoreDefaultValues (bool all=false)
 Set all registered objects to their default values. More...
 
virtual void storeValues ()
 
virtual void restoreValues (bool all=false)
 
virtual void dump (std::ostream &s=std::cout, Size depth=0) const
 
virtual bool setValueAllowed (QObject *)
 Allows to prevent restoring of widgets. More...
 
- Public Member Functions inherited from BALL::PluginHandler
virtual ~PluginHandler ()
 
bool startPlugin (BALLPlugin *plugin)
 
bool stopPlugin (BALLPlugin *plugin)
 
virtual bool isRunning (BALLPlugin *plugin) const
 

Protected Slots

virtual void addPluginDirectory ()
 
virtual void removePluginDirectory ()
 
virtual void directorySelectionChanged (const QModelIndex &)
 
virtual void pluginChanged (QModelIndex i)
 
virtual void togglePluginState ()
 

Additional Inherited Members

- Public Types inherited from BALL::Embeddable
typedef std::vector< Embeddable * > EmbeddableVector
 
- Public Types inherited from BALL::VIEW::PreferencesEntry
typedef std::list< std::pair
< QWidget *, String > > 
StackPages
 
- Static Public Member Functions inherited from BALL::VIEW::ModularWidget
static void registerWidget (ModularWidget *mwidget) throw (Exception::NullPointer)
 
- Protected Types inherited from BALL::VIEW::PreferencesEntry
typedef HashMap< const QObject
*, String
ValueMap
 
- Protected Member Functions inherited from BALL::VIEW::ConnectionObject
void onNotify_ (Message *message)
 
void notify_ (Message *message)
 
void notify_ (Message &message)
 
- Protected Member Functions inherited from BALL::VIEW::PreferencesEntry
void registerWidgets_ ()
 
void registerObject_ (QObject *widget)
 
void unregisterObject_ (QObject *widget)
 
void registerWidgetForHelpSystem_ (const QWidget *widget, const String &url)
 
void restoreValues_ (bool all, const ValueMap &map)
 
void insertStackEntry_ (QWidget *, const String &name)
 
bool isSupported_ (QObject &widget)
 
bool getValue_ (const QObject *widget, String &value)
 
bool setValue_ (QObject *widget, const String &value)
 
- Static Protected Member Functions inherited from BALL::Embeddable
static void registerInstance_ (const std::type_info &type, const Embeddable *instance)
 
static void unregisterInstance_ (const Embeddable *instance)
 
static Size countInstances_ (const std::type_info &type)
 
static EmbeddablegetInstance_ (const std::type_info &type, Position index)
 
static EmbeddablegetInstance_ (const std::type_info &type, const String &identifier)
 
- Protected Attributes inherited from BALL::VIEW::ModularWidget
QAction * window_menu_entry_
 
bool show_window_enty_
 
bool default_visible_
 
QList< QAction * > main_toolbar_actions_
 
- Protected Attributes inherited from BALL::VIEW::PreferencesEntry
String inifile_section_name_
 
HashSet< QObject * > registered_objects_
 
ValueMap default_values_
 
ValueMap last_values_
 
QStackedWidget * widget_stack_
 
StackPages stack_pages_
 
- Protected Attributes inherited from BALL::PluginHandler
std::list< BALLPlugin * > running_plugins_
 

Detailed Description

Dialog for handling the BALL plugins

This dialog shows all available plugins in a QListView. The user can opt to activate or deactivate any plugin and manipulate the plugin search path. Also this dialog acts as a plugin handler for VIEWPlugins. It is responsible for registering the ConfigDialog of a VIEWPlugin with the preferences system.

Definition at line 85 of file pluginDialog.h.

Constructor & Destructor Documentation

BALL::VIEW::PluginDialog::PluginDialog ( Preferences preferences,
QWidget parent,
const char *  name = "PluginDialog" 
)
virtual BALL::VIEW::PluginDialog::~PluginDialog ( )
virtual

Member Function Documentation

virtual void BALL::VIEW::PluginDialog::addPluginDirectory ( )
protectedvirtualslot
bool BALL::VIEW::PluginDialog::canHandle ( BALLPlugin plugin) const
virtual

This function is used to check whether this PluginHandler can initialize the passed plugin. A usual implementation would be something like:

return qobject_cast<MyPlugin*>(plugin) != 0;

Returns
true if the handler can make use of the plugin, false otherwise

Implements BALL::PluginHandler.

virtual void BALL::VIEW::PluginDialog::directorySelectionChanged ( const QModelIndex &  )
protectedvirtualslot
virtual void BALL::VIEW::PluginDialog::finalizeWidget ( MainControl main_control)
virtual

Finalization This method is called automatically before the main application is closed.

Reimplemented from BALL::VIEW::ModularWidget.

virtual void BALL::VIEW::PluginDialog::initializeWidget ( MainControl main_control)
virtual

Initialization. This method is called automatically before the main application is started. It adds the dialog's menu entries and connections.

Reimplemented from BALL::VIEW::ModularWidget.

virtual void BALL::VIEW::PluginDialog::pluginChanged ( QModelIndex  i)
protectedvirtualslot
virtual void BALL::VIEW::PluginDialog::readPreferenceEntries ( const INIFile inifile)
virtual

Restore the settings of all registered objects.

Reimplemented from BALL::VIEW::PreferencesEntry.

virtual void BALL::VIEW::PluginDialog::registerChildEntry ( PreferencesEntry child)
virtual
virtual void BALL::VIEW::PluginDialog::removePluginDirectory ( )
protectedvirtualslot
bool BALL::VIEW::PluginDialog::specificSetup_ ( BALLPlugin plugin)
virtual

A purely virtual function which is responsible for properly initialising the passed plugin instance.

The passed plugin may be assumed to be of a type that can be handled by this PluginHandler.

Returns
true if the setup succeeded, false otherwise

Implements BALL::PluginHandler.

bool BALL::VIEW::PluginDialog::specificShutdown_ ( BALLPlugin plugin)
virtual

A purely virtual function which is responsible for properly deinitialising the passed plugin instance.

The passed plugin may be assumed to be of a type that can be handled by this PluginHandler.

Returns
true if the deinitialization succeeded, false otherwise

Implements BALL::PluginHandler.

virtual void BALL::VIEW::PluginDialog::togglePluginState ( )
protectedvirtualslot
virtual void BALL::VIEW::PluginDialog::unregisterChildEntry ( PreferencesEntry child)
virtual
virtual void BALL::VIEW::PluginDialog::writePreferenceEntries ( INIFile inifile)
virtual

Store the settings of all registered objects.

Reimplemented from BALL::VIEW::PreferencesEntry.