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

#include <BALL/VIEW/WIDGETS/helpViewer.h>

Inheritance diagram for BALL::VIEW::HelpViewer:
BALL::VIEW::DockWidget QDockWidget BALL::VIEW::ModularWidget BALL::Embeddable BALL::VIEW::ConnectionObject

Public Slots

virtual void showHelp ()
 Show default page. More...
 
void enterWhatsThisMode ()
 
void exitWhatsThisMode ()
 
bool eventFilter (QObject *obj, QEvent *e)
 Event filter for the whats this mode. More...
 
- Public Slots inherited from BALL::VIEW::DockWidget
virtual void dropEvent (QDropEvent *e)
 
virtual void dragEnterEvent (QDragEnterEvent *e)
 
virtual void showGuestContextMenu (const QPoint &)
 

Public Member Functions

 HelpViewer (QWidget *parent, const char *name=0)
 
virtual ~HelpViewer ()
 
virtual void initializeWidget (MainControl &main_control)
 
virtual void onNotify (Message *message)
 
virtual void showHelp (const String &URL)
 
virtual void showHelp (const String &URL, String entry)
 
void setDefaultPage (const String &url)
 
const StringgetDefaultPage () const
 
void setProject (const String &project)
 
String getProject () const
 
void setBaseDirectory (const String &dir)
 
const StringgetBaseDirectory () const
 
virtual void registerForHelpSystem (const QObject *object, const String &docu_entry)
 Register a widget for showing its documentation. More...
 
void unregisterForHelpSystem (const QObject *object)
 Unregister a widget for showing its documentation. More...
 
bool showHelpFor (const QObject *object)
 Show the documentation entry for a given widget. More...
 
bool showDocumentationForObject ()
 Show documentation for object under cursor. More...
 
bool hasHelpFor (const QObject *object) const
 Check wheter we have a documentation entry for a given object. More...
 
String getHelpEntryFor (const QObject *object) const
 Get help entry for widget. More...
 
void setWhatsThisEnabled (bool state)
 
bool isWhatsThisEnabled () const
 
void showDocumentationFor (const String &classname, const String &member)
 
- Public Member Functions inherited from BALL::VIEW::DockWidget
 DockWidget (QWidget *parent, const char *title=0)
 Use this constructor! More...
 
virtual ~DockWidget ()
 
void setGuest (QWidget &guest)
 
virtual void fetchPreferences (INIFile &inifile)
 
virtual void writePreferences (INIFile &inifile)
 
virtual void setWidgetVisible (bool state)
 For usage with Python: More...
 
QGridLayout * getGuestLayout ()
 
- Public Member Functions inherited from BALL::VIEW::ModularWidget
void setWorkingDirFromFilename_ (String filename)
 
 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 String &name, const QObject *receiver=0, const char *slot=0, const String &description="", QKeySequence accel=QKeySequence())
 
void setMenuHint (const String &hint)
 
void setMenuHelp (const String &url)
 
virtual void addToolBarEntries (QToolBar *main_tb)
 
void setIcon (const String &filename, bool add_to_main_toolbar=true)
 
virtual void initializePreferencesTab (Preferences &preferences)
 
virtual void finalizePreferencesTab (Preferences &preferences)
 
virtual void applyPreferences ()
 
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)
  More...
 
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 void finalizeWidget (MainControl &main_control)
 
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 bool isValid () const
 

Protected Member Functions

void collectClasses_ ()
 
- Protected Member Functions inherited from BALL::VIEW::DockWidget
 DockWidget ()
 
 DockWidget (const DockWidget &)
 

Protected Attributes

String project_
 
String default_page_
 
String base_dir_
 
MyTextBrowserbrowser_
 
bool whats_this_mode_
 
bool ignore_event_
 
bool whats_this_
 
QAction * whats_action_
 
HashMap< const QObject *, Stringdocu_entries_
 
StringHashMap< Stringclasses_to_files_
 
- Protected Attributes inherited from BALL::VIEW::DockWidget
QWidgetcontainer_
 
QWidgetguest_
 
QGridLayout * layout_
 
- Protected Attributes inherited from BALL::VIEW::ModularWidget
QAction * window_menu_entry_
 
bool show_window_enty_
 
bool default_visible_
 
QAction * last_action_
 
QList< QAction * > main_toolbar_actions_
 

Additional Inherited Members

- Public Types inherited from BALL::Embeddable
typedef std::vector< Embeddable * > EmbeddableVector
 
- Static Public Member Functions inherited from BALL::VIEW::ModularWidget
static void registerWidget (ModularWidget *mwidget) throw (Exception::NullPointer)
 
- 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)
 

Detailed Description

DockWidget to show online help texts e.g. the BALLView documentation The documentation for BALLView was written in the HTML format, such that it either be used online from the project's website or inside the program itself. To obtain help for individual elements in the graphical user interface a special mode was added. In the "Help" menu the entry "Whats this?" will switch into this mode and transform the mouse cursor into a question mark. While the "Whats this?" mode is active a left mouse click on any widget will open the corresponding help entry in the documentation. (If no help entry for that widget exists nothing will happen.) To leave the "Whats this?" mode just press the right mouse button or press the "Escape" key. As an alternative for this approach the "F1" key will popup the documentation for the current widget under the mouse cursor.

To show a specific help page, just call ModularWidget::showHelp(String) or send a ShowHelpMessage. Per default the HelpViewer looks for index.html in $BALL_DATA_PATH/../doc/BALLView . You can change this behavior by using setDefaultDir() and setDefaultPage(). Links to pages on the WWW wont work! QWidgets and menu entries can be registered with a link into the HTML documentation. See registerWidgetForHelpSystem. The implemention for opening the documentation per "Whats this?" menu entry and the hotkey "F1" is also done here.

Definition at line 66 of file helpViewer.h.

Constructor & Destructor Documentation

BALL::VIEW::HelpViewer::HelpViewer ( QWidget parent,
const char *  name = 0 
)
virtual BALL::VIEW::HelpViewer::~HelpViewer ( )
virtual

Member Function Documentation

void BALL::VIEW::HelpViewer::collectClasses_ ( )
protected
void BALL::VIEW::HelpViewer::enterWhatsThisMode ( )
slot
bool BALL::VIEW::HelpViewer::eventFilter ( QObject obj,
QEvent e 
)
slot

Event filter for the whats this mode.

void BALL::VIEW::HelpViewer::exitWhatsThisMode ( )
slot
const String& BALL::VIEW::HelpViewer::getBaseDirectory ( ) const
const String& BALL::VIEW::HelpViewer::getDefaultPage ( ) const
String BALL::VIEW::HelpViewer::getHelpEntryFor ( const QObject object) const

Get help entry for widget.

String BALL::VIEW::HelpViewer::getProject ( ) const
inline

Definition at line 109 of file helpViewer.h.

bool BALL::VIEW::HelpViewer::hasHelpFor ( const QObject object) const

Check wheter we have a documentation entry for a given object.

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

Setup the menu entry

Reimplemented from BALL::VIEW::DockWidget.

bool BALL::VIEW::HelpViewer::isWhatsThisEnabled ( ) const
inline

Definition at line 139 of file helpViewer.h.

virtual void BALL::VIEW::HelpViewer::onNotify ( Message message)
virtual

Handles messages sent by other registered ConnectionObject objects. Filters for SceneMessage and sets the Camera appropriate or updates the visualization.

Parameters
messagethe pointer to the message that should be processed
See Also
ConnectionObject
Message

Reimplemented from BALL::VIEW::ConnectionObject.

virtual void BALL::VIEW::HelpViewer::registerForHelpSystem ( const QObject object,
const String docu_entry 
)
virtual

Register a widget for showing its documentation.

Reimplemented from BALL::VIEW::DockWidget.

void BALL::VIEW::HelpViewer::setBaseDirectory ( const String dir)
void BALL::VIEW::HelpViewer::setDefaultPage ( const String url)
void BALL::VIEW::HelpViewer::setProject ( const String project)
inline

Definition at line 106 of file helpViewer.h.

void BALL::VIEW::HelpViewer::setWhatsThisEnabled ( bool  state)
inline

Definition at line 136 of file helpViewer.h.

void BALL::VIEW::HelpViewer::showDocumentationFor ( const String classname,
const String member 
)
bool BALL::VIEW::HelpViewer::showDocumentationForObject ( )

Show documentation for object under cursor.

virtual void BALL::VIEW::HelpViewer::showHelp ( const String URL)
virtual

Reimplemented from BALL::VIEW::ModularWidget.

virtual void BALL::VIEW::HelpViewer::showHelp ( const String URL,
String  entry 
)
virtual
virtual void BALL::VIEW::HelpViewer::showHelp ( )
virtualslot

Show default page.

bool BALL::VIEW::HelpViewer::showHelpFor ( const QObject object)

Show the documentation entry for a given widget.

void BALL::VIEW::HelpViewer::unregisterForHelpSystem ( const QObject object)

Unregister a widget for showing its documentation.

Member Data Documentation

String BALL::VIEW::HelpViewer::base_dir_
protected

Definition at line 164 of file helpViewer.h.

MyTextBrowser* BALL::VIEW::HelpViewer::browser_
protected

Definition at line 165 of file helpViewer.h.

StringHashMap<String> BALL::VIEW::HelpViewer::classes_to_files_
protected

Definition at line 172 of file helpViewer.h.

String BALL::VIEW::HelpViewer::default_page_
protected

Definition at line 163 of file helpViewer.h.

HashMap<const QObject*, String> BALL::VIEW::HelpViewer::docu_entries_
protected

Definition at line 171 of file helpViewer.h.

bool BALL::VIEW::HelpViewer::ignore_event_
protected

Definition at line 167 of file helpViewer.h.

String BALL::VIEW::HelpViewer::project_
protected

Definition at line 162 of file helpViewer.h.

QAction* BALL::VIEW::HelpViewer::whats_action_
protected

Definition at line 169 of file helpViewer.h.

bool BALL::VIEW::HelpViewer::whats_this_
protected

Definition at line 168 of file helpViewer.h.

bool BALL::VIEW::HelpViewer::whats_this_mode_
protected

Definition at line 166 of file helpViewer.h.