VIEW::ConnectionObject Class Reference
[Widget connectivity and message queuing]
Base class for all widgets and dialogs that handles communication through message posting.
More...
#include <connectionObject.h>
Inheritance diagram for VIEW::ConnectionObject:
Public Member Functions | |
Constructors | |
| ConnectionObject () throw () | |
| Default Constructor. | |
Destructors | |
| virtual | ~ConnectionObject () throw () |
| Destructor. | |
| virtual void | clear () throw () |
| Explicit default initialization. | |
| virtual void | destroy () throw () |
| Explicit destructor. | |
Accessors: inspectors and mutators | |
| void | registerConnectionObject (ConnectionObject &object) throw () |
| Register connectionObject. | |
| void | unregisterConnectionObject (ConnectionObject &object) throw () |
| Unregister connectionObject. | |
| bool | isConnectionObjectRegistered (const ConnectionObject &object) throw () |
| Test if connectionObject is registered. | |
| ConnectionObject * | getParent () const throw () |
| Access the parent connectionObject of this connectionObject. | |
| ConnectionObject * | getRoot () throw () |
| Access the root of this ConnectionObject. | |
| virtual void | onNotify (Message *message) throw () |
| Message handling method. | |
debuggers and diagnostics | |
| virtual bool | isValid () const throw () |
| Internal state and consistency self-validation. | |
| virtual void | dump (std::ostream &s=std::cout, Size depth=0) const throw () |
| Internal value dump. | |
Protected Member Functions | |
| void | onNotify_ (Message *message) throw () |
Protected notification methods | |
| void | notify_ (Message *message) throw () |
| Notification method with pointer. | |
| void | notify_ (Message &message) throw () |
| Notification method with reference. | |
Detailed Description
Base class for all widgets and dialogs that handles communication through message posting.There are methods that handle the registering process between the classes that should be connected as well as notifying methods that are responsible for posting messages. The registering process will be handled by the interface of every dialog and widget. In this process a tree will be created that connects all connectionObject objects. See ModularWidget for further information concerning widget and dialog interface definition. The widgets communicate with the help of the method notify_. With this method a message can be sent through the connectionObject tree. One connectionObject will be the root of this tree and therefore responsible for handling and sending all incoming messages. A Message will first be sent to the root of the connectionObject tree and then will travers its way down to every leaf excluding the one that had sent the original message. If an incoming message triggers a reply message (in the onNotify method) that new message will be stored in a message queue in the root of the tree and executed if the first message has traversed all leafs of the tree. Therefore a message should always be created with the new command and the flag deletable must be set to true. If a message if statically created in the onNotify method there is the possibility that the message is already destroyed when it should be processed.
Constructor & Destructor Documentation
|
|
Default Constructor. Initialize the message queue and resets all connection to zero. |
|
|
Destructor. Calls destroy.
|
Member Function Documentation
|
|
Explicit default initialization. Clears the message queue and deletes all deletable messages in it. Further all connections to the children and the parent will be cut. Reimplemented in VIEW::MainControl, VIEW::ModularWidget, VIEW::Server, VIEW::GeometricControl, VIEW::PyWidget, and VIEW::Scene. |
|
|
Explicit destructor. Calls clear
Reimplemented in VIEW::ModularWidget. |
|
||||||||||||
|
Internal value dump. Dump the current state to the output ostream s with dumping depth depth.
Reimplemented in VIEW::MainControl, VIEW::ModularWidget, VIEW::Server, VIEW::PyWidget, and VIEW::Scene. |
|
|
Access the parent connectionObject of this connectionObject.
If this connectionObject is root
|
|
|
Access the root of this ConnectionObject.
Returns the ConnectionObject that parent is |
|
|
Test if connectionObject is registered.
|
|
|
Internal state and consistency self-validation.
Initiate self-validation of the data structure consistencies of this connectionObject. If the internal data structure of this connectionObject is correct (self-validated) and consistent
Reimplemented in VIEW::Server, VIEW::PyWidget, and VIEW::Scene. |
|
|
Notification method with reference. See notify_ for detailed information on the notification process. Only use this method if you are absolutely sure what you are doing!
|
|
|
Notification method with pointer.
Call this method if a message should be sent through the connectionObject tree. If this method is not called inside the onNotify method the message will immediately begin traversing the tree and trigger reactions in the other connectionObjects. After all connectionObjects have reacted to this message the method will return. If this method is called inside the onNotify method the message will be stored in the message queue of the root connectionObject and the method will immediately return. This new message will be executed after the previously message is completely executed. An often made error is to statically create a message in an onNotify method. In that case the message queue of the root connectionObject stores a pointer to the statically created message for later processing but if the message is processed later the onNotify method that has created that message is already finished. Therefore the message is no longer available what leads to a segmentation fault. To prevent that error always create messages with the
|
|
|
Message handling method. This method handles messages sent to this connectionObject. If a certain message should be processed for this connectionObject this method must be overridden. With the help of the RTTI methods one can easily determine if an incoming message is relevant for this connectionObject. See Message for further information concerning messages.
Reimplemented in VIEW::DisplayProperties, VIEW::LabelDialog, VIEW::ModifyRepresentationDialog, VIEW::MolecularFileDialog, VIEW::MainControl, VIEW::DatasetControl, VIEW::DockingController, VIEW::EditableScene, VIEW::GenericControl, VIEW::GeometricControl, VIEW::HelpViewer, VIEW::MolecularControl, VIEW::MolecularStructure, VIEW::RegularData1DWidget, VIEW::RegularData2DWidget, and VIEW::Scene. |
|
|
Register connectionObject. The connectionObject this will be the new parent of object connectionObject. Each connectionObject can only be inserted once to a parent.
|
|
|
Unregister connectionObject. The connectionObject this deletes the object connectionObject from its children list and the parent of object connectionObject will be set to 0.
|