uiElement.h

Go to the documentation of this file.

/*********************************************************************
** Copyright (c) 2013 MaK Technologies, Inc.
** All rights reserved.
*********************************************************************/


#pragma once

#include "entityEditorImpl/entityEditorImplDefines.h"
#include "entityEditorImpl/unitConversions.h"
#include "vrfutil/readerWriter.h"
#include "vrfutil/rwString.h"
#include "entityEditorImpl/rwVariableBindingsList.h"
#include "vrfutil/rwBoolean.h"
#include "vrfutil/rwInt.h"
#include "vrfutil/noArgumentCallbackList.h"
#include <vrfExtProtocol/objectType.h>

#include <QtCore/QObject>
#include <QtCore/QVariant>
#include <boost/function.hpp>
#include <boost/bind.hpp>

class QWidget;
class DtUiForParameter;
class DtVrfObjectParameters;
class DtReaderWriterRegistryData;
class DtSystemParameterData;
class DtModelSetEntry;
class DtUiElement;
class QWidget;
class QLabel;
class DtComponentSystemDefinition;

typedef boost::function<void (DtUiElement*)> DtElementChangedCallbackFcn;


class DT_DLL_entityeditorimpl DtUiElementEvent
{
public:
   enum DtUiElementEventTypes
   {
      DtUiElementTypeUnknown = 0,
      DtUiElementItemExpand   = 1,
      DtUiElementItemCollapse = 2,
      DtUiElementHierarchySelectionChanged = 3,
      DtUiElementAddedToHierarchy = 5,
      DtUiElementRemovedFromHierarchy = 6,
      DtUiElementMovedInHierarchy = 7,
      DtUiElementReplacedInHierarchy = 8,
      DtUiElementForceChanged = 9,
      DtUiElementPositionModified = 12,
      DtUiElementPositionDestroyed = 13,
      DtUiBoundingVolumeModified = 14,
      DtUiCanvasInitialized = 15,
      DtUiCreateController = 19,
      DtUiCleanup = 20,
      DtUiElementHierarchyChanged = 21,
      DtUiEnterEditMode = 22,
      DtUiLeaveEditMode = 23,
      DtUiSupportPointsModified = 24,
      DtUiPreSaveEvent = 25,
      DtSystemsRemoved = 26
   };

public:
   DtUiElementEvent(DtUiElement* owner= 0, DtUiElementEventTypes type = DtUiElementTypeUnknown) : myOwner(owner), myType(type) {};
   DtUiElementEvent(const DtUiElementEvent& orig) : myOwner(orig.myOwner), myType(orig.myType), myValue(orig.myValue) {};

   DtUiElementEvent& operator=(const DtUiElementEvent& rhs) { myOwner = rhs.myOwner; myValue = rhs.myValue; myType = rhs.myType; return *this; };

   DtUiElement* owner() const { return myOwner; };
   DtUiElementEventTypes type() const { return myType; };
   void setType(DtUiElementEventTypes t) { myType = t; };
   void setValue(const QVariant& val) { myValue = val; };
   const QVariant& value() const { return myValue; };

protected:
   DtUiElement*            myOwner;
   QVariant                myValue;
   DtUiElementEventTypes   myType;
};


class DT_DLL_entityeditorimpl DtUiElement : public QObject
{
   Q_OBJECT

public:
   typedef boost::function<DtUiElement* (makVrv::DtDe&)> CreatorFunction;
   typedef std::map<std::string, CreatorFunction> UiElementFactoryMap;

   DtUiElement
   (
      makVrv::DtDe&
   );

   virtual ~DtUiElement();

   virtual bool blockSignals(bool);

   virtual void init(QWidget* widget, QWidget* label, DtReaderWriter* originalData, DtReaderWriter* backupData,
      DtElementChangedCallbackFcn = boost::bind(&DtUiElement::theNullFunction, _1));

   virtual void init(QWidget* widget, QWidget* label, const std::vector<DtReaderWriter*>& originalData,
      const std::vector<DtReaderWriter*>& backupData,
      DtElementChangedCallbackFcn = boost::bind(&DtUiElement::theNullFunction, _1));

   virtual void init(QWidget* widget, QWidget* label, const DtObjectType&, const DtString& platformType,
      DtElementChangedCallbackFcn = boost::bind(&DtUiElement::theNullFunction, _1));

   virtual DtString displayUnits() const;
   virtual void setDisplayUnits(const DtString& units);

   virtual void setLabelText(const QString&);

   virtual DtString sourceUnits() const;
   virtual void setSourceUnits(const DtString& units);

   virtual void setFromSystemParameterData(const DtSystemParameterData* data, const DtComponentSystemDefinition*);

   virtual void objectParametersModified() {};

   virtual void connectedTo(QObject*);

   virtual void processUiEvent(const DtUiElementEvent&) {};

   virtual void setModelModified(DtModelSetEntry*);

   virtual DtString uniqueName() const;

   virtual bool supportsSystems() const;

   virtual const DtString& platformType() const;

   virtual void setPlatformType(const DtString&);

   virtual void setObjectTypes(const std::vector<DtObjectType>&);

   virtual void aboutToShow();

public:
   static void registerUiTypes();
   static DtUiElement* createUiElement(makVrv::DtDe&, const DtString& type);
   static bool hasCreator(const DtString&);

   static void theNullFunction(DtUiElement*);

public:
   virtual bool isModified() const;

   virtual void decorateElement();

   virtual void setFromParameters(DtReaderWriter* parentRw);

   virtual void setFromParameters(const std::vector<DtReaderWriter*>& parentRw);

   virtual bool restoreFromBackup();

   static UiElementFactoryMap& elementFactory()
   {
      return theFactory;
   }

   const std::vector<DtObjectType>& objectTypes() const
   {
      return myObjectTypes;
   }

   virtual void sendEvent(const DtUiElementEvent&);

   virtual bool allValuesTheSame() const;

   static QString mixedText();
   static void setMixedText(const QString&);

   virtual bool isMixedValue() const;

   virtual void setEnabled(bool);
   virtual bool enabled() const;

public slots:
      virtual void toggleDisplayed(bool display);

protected slots:
   virtual void elementChanged();

   virtual void enableIfChecked();

   virtual void disableIfChecked();

signals:
   void uiEvent(const DtUiElementEvent&);

protected:

   virtual double sourceToDisplayUnits(double) const;
   virtual double displayToSourceUnits(double) const;

   virtual QString units() const;

   virtual void updateLabelTitle();

   virtual QString labelTitle() const;

   virtual void createControls(QWidget* parent);

public:
   QWidget* myWidget;
   QWidget* myLabel;

protected:
   static UiElementFactoryMap theFactory;

   DtString  myDisplayUnits;
   DtString  mySourceUnits;

   std::vector<DtReaderWriter*> myValues;
   std::vector<DtReaderWriter*> myBackupValues;
   bool myIsNew;
   DtElementChangedCallbackFcn myElementChangedCallbackFunction;
   DtUnit mySource;
   DtUnit myDestination;
   makVrv::DtDe& myDe;

   DtString myPlatformType;
   std::vector<DtObjectType> myObjectTypes;

   const DtComponentSystemDefinition* mySystemDefinition;

   bool myEnabled;

   std::vector<QObject*> myConnectedTo;
   int myUniqueId;
};