QbWidget.h

#ifndef QBWIDGET_H
#define QBWIDGET_H

#include "QbIncludes.h"
#include "QbUtility.h"
#include "QbWidgetController.h"
#include "QbFieldSensorList.h"

#include <cstdarg>

class QbWidget;
typedef void QbCallback(void * data, QbWidget * widget);

class QbWidget : public SoSeparator {
  SO_NODE_ABSTRACT_HEADER(QbWidget);
  typedef SoSeparator inherited;
  friend class QbWidgetController; // for hover, focusing etc.
  friend class QbBox; // for setWidgetController
public:
  static void initClass(void);
  QbWidget(void);
  ~QbWidget(void);

  /* properties and events are fields
    contain current / last value
    can be changed / triggered by user (if makes sense)
    can be connected to engines, sensors and auditors
  */
  SoSFVec3f position; // the upper left coordinate - does not affect size
  SoSFVec3f center; // only affects position

  SoSFVec2f size;
  SoSFFloat width;  // connected with size for convenience
  SoSFFloat height; // connected with size for convenience

  SoSFBool fixedSize; // if true, changing bounds do not affect size

  // changing bounds also affects size (if fixedSize == false), in contrast to changing the position
  SoSFVec3f topLeft; // the 4 corners
  SoSFVec3f topRight;
  SoSFVec3f bottomLeft;
  SoSFVec3f bottomRight;
  SoSFVec3f left; // center of the 4 sides
  SoSFVec3f right;
  SoSFVec3f top;
  SoSFVec3f bottom;

  SoSFBool captureEvents;
  SoSFTrigger click;
  SoSFUInt32 keyDown; // enum as int at now - switch to SoSFEnum later (see QbUtility.h or dynload-example for that)
  SoSFUInt32 keyUp;
  SoSFShort mouseDown;
  SoSFShort mouseUp;
  SoSFBool hover; // includes mouseEnter and -leave // TODO: consider using an EngineOutput for readOnly
  SoSFVec2s mouseMove;  // TODO: coin doc for SoEvent: find out which position to use
  SoSFBool focus;

  QbFieldSensorList sensors;

  /* returns the last QbWidget in the given path
     returns null if not found
  */
  static QbWidget * getLastWidgetInPath(SoPath *path);

  // IDEA: Ereignis-Methoden fuer Annaeherung und Sichtbarsein

  QbWidgetController * getWidgetController();

  virtual void notify(SoNotList * list);

protected:
  // overwrite this to set children's controller too
  virtual void setWidgetController(QbWidgetController * controller);
  const SbViewportRegion getViewportRegion();

  /* virtual event methods
     allow the widget react to events and property changes
     values are stored in fields, these methods are called on field changes
     so don't change field values here to avoid stack overflow
     super should always be called when overwriting
  */
  virtual void doClick();
  virtual void doClickCancel(); // mouseDown here but up elsewhere
  virtual void doKeyDown(const SoKeyboardEvent::Key key);
  virtual void doKeyUp(const SoKeyboardEvent::Key key);
  virtual void doMouseDown(const SoMouseButtonEvent::Button button);
  virtual void doMouseUp(const SoMouseButtonEvent::Button button);
  virtual void doMouseEnter();
  virtual void doMouseExit();
  virtual void doMouseMove(SbVec2s position);
  virtual void doFocus();
  virtual void doUnFocus();
  virtual void doResize(const SbVec2f size);
  virtual void doPositionChange(const SbVec3f position); // position is topLeft

  SoTranslation * positionTranslation;
  SoSeparator * topSeparator; // all parts should be added here

private:
  QbWidgetController * widgetController;
  SoInput input;
  SoNode * modelFocus;
};


inline QbWidgetController * QbWidget::getWidgetController () {
  return this->widgetController;
}

#define IS_QB_WIDGET(_node_) _node_->getTypeId().isDerivedFrom(QbWidget::getClassTypeId())
#define QB_WIDGET(_node_) dynamic_cast<QbWidget*>(_node_)

#endif

---