qwObjectBrowser.h

Go to the documentation of this file.

/* This software and supporting documentation are distributed by
 *     Institut Federatif de Recherche 49
 *     CEA/NeuroSpin, Batiment 145,
 *     91191 Gif-sur-Yvette cedex
 *     France
 *
 * This software is governed by the CeCILL-B license under
 * French law and abiding by the rules of distribution of free software.
 * You can  use, modify and/or redistribute the software under the
 * terms of the CeCILL-B license as circulated by CEA, CNRS
 * and INRIA at the following URL "http://www.cecill.info".
 *
 * As a counterpart to the access to the source code and  rights to copy,
 * modify and redistribute granted by the license, users are provided only
 * with a limited warranty  and the software's author,  the holder of the
 * economic rights,  and the successive licensors  have only  limited
 * liability.
 *
 * In this respect, the user's attention is drawn to the risks associated
 * with loading,  using,  modifying and/or developing or reproducing the
 * software by the user in light of its specific status of free software,
 * that may mean  that it is complicated to manipulate,  and  that  also
 * therefore means  that it is reserved for developers  and  experienced
 * professionals having in-depth computer knowledge. Users are therefore
 * encouraged to load and test the software's suitability as regards their
 * requirements in conditions enabling the security of their systems and/or
 * data to be ensured and,  more generally, to use and operate it in the
 * same conditions as regards security.
 *
 * The fact that you are presently reading this means that you have had
 * knowledge of the CeCILL-B license and that you accept its terms.
 */


#ifndef ANAQT_BROWSER_QWOBJECTBROWSER_H
#define ANAQT_BROWSER_QWOBJECTBROWSER_H

#include <anatomist/window/controlledWindow.h>
#include <anatomist/browser/qObjBrowserWid.h>
#include <cartobase/object/attributed.h>
#include <set>

class QStatusBar;
class QLabel;
class QLabelEdit;
class QTreeWidgetItem;

namespace anatomist
{
  class Hierarchy;
  class StaticInitializers;
  class AttDescr;
}


class QObjectBrowser : public ControlledWindow
{
  Q_OBJECT

public:
  enum EditMode
  {
    NORMAL = 0,
    EDIT = 1,
    SENDEDIT = 2 //,
  };

  typedef bool (*EditFunc)( const std::set<carto::GenericObject*> & ao, 
                            const std::string & att, 
                            QObjectBrowserWidget* br,
                            const std::set<QTreeWidgetItem*> & item );

  QObjectBrowser( QWidget * parent=0, const char * name=0, 
                  carto::Object options = carto::none(), 
                  Qt::WindowFlags f = 0 );
  virtual ~QObjectBrowser();

  virtual Type type() const;
  void displayClickPoint();
  void Draw( bool flush = true );
  virtual void update( const anatomist::Observable* observable, void* arg );
  virtual void registerObject( anatomist::AObject* object,
                               bool temporaryObject = false,
                               int position = -1 );
  virtual void unregisterObject( anatomist::AObject* object );
  virtual void updateObject( anatomist::AObject* obj );

  virtual void setMode( unsigned mode );
  unsigned mode() const;
  virtual std::string modeString() const;
  void editCancel();
  void editValidate();

  void setShowDetailsUponRegister( bool );
  bool showDetailsUponRegister() const;

  static int classType();
  static anatomist::AttDescr & attDescr();
  static void registerTypeEditor( const std::string & type, EditFunc func );
  static void registerAttributeEditor( const std::string & syntax, 
                                       const std::string & att, 
                                       EditFunc func );
  static bool stringEditor( const std::set<carto::GenericObject*> & ao,
                            const std::string & att, 
                            QObjectBrowserWidget* br,
                            const std::set<QTreeWidgetItem*> & item );
  static bool intEditor( const std::set<carto::GenericObject*> & ao,
                         const std::string & att,
                         QObjectBrowserWidget* br,
                         const std::set<QTreeWidgetItem*> & item );
  static bool floatEditor( const std::set<carto::GenericObject*> & ao,
                           const std::string & att, 
                           QObjectBrowserWidget* br,
                           const std::set<QTreeWidgetItem*> & item );
  static bool doubleEditor( const std::set<carto::GenericObject*> & ao,
                            const std::string & att, 
                            QObjectBrowserWidget* br,
                            const std::set<QTreeWidgetItem*> & item );
  static bool labelEditor( const std::set<carto::GenericObject*> & ao,
                           const std::string & att, 
                           QObjectBrowserWidget* br,
                           const std::set<QTreeWidgetItem*> & item );
  static bool colorEditor( const std::set<carto::GenericObject*> & ao,
                           const std::string & att, 
                           QObjectBrowserWidget* br,
                           const std::set<QTreeWidgetItem*> & item );

  static anatomist::AWindow* createBrowser( void *, carto::Object );

  virtual const std::set<unsigned> & typeCount() const;
  virtual std::set<unsigned> & typeCount();
  virtual const std::string & baseTitle() const;

  virtual anatomist::View* view();
  virtual const anatomist::View* view() const;

protected:
  void updateRightPanel();
  Tree* buildSpecificMenuTree( QObjectBrowserWidget* br, 
                               QTreeWidgetItem* item, 
                               Tree & tr );
  static void modifyAttributeStatic( void* parent );
  virtual void modifyAttribute();
  static void modifNameStatic( void* parent );
  static void modifLabelStatic( void* parent );
  virtual void modifAttrib( const std::string & attrib );
  static void addAttributeStatic( void* parent );
  virtual void addAttribute();
  static void removePropertyStatic( void* parent );
  virtual void removeProperty();
  virtual carto::GenericObject* 
  attributeCaract( const QObjectBrowserWidget* br, const QTreeWidgetItem* item, 
                   std::string & attrib );
  virtual carto::GenericObject* gObject( const QObjectBrowserWidget* br, 
                                            const QTreeWidgetItem* item, 
                                            int type );
  virtual anatomist::AObject* aObject( const QObjectBrowserWidget* br, 
                                       const QTreeWidgetItem* item );
  bool editAttribute( carto::GenericObject* ao, const std::string & att, 
                      QObjectBrowserWidget* br, QTreeWidgetItem* item, 
                      bool & edited );
  bool editAttribute( const std::set<carto::GenericObject*> & objs,
                      const std::string & att,
                      QObjectBrowserWidget* br,
                      const std::set<QTreeWidgetItem*> & items,
                      bool & edited );
  void normalModeSelectionChanged();
  static void sendModeSelection( void *parent );
  static void setAttributeToAllSelected( void *parent );
  std::string canSend( QObjectBrowserWidget* br, QTreeWidgetItem* item );
  std::string canSendToAny( QObjectBrowserWidget* br, QTreeWidgetItem* item );
  void nomenclatureClick( anatomist::Hierarchy* h, 
                          QObjectBrowserWidget::ItemDescr & descr, 
                          std::set<anatomist::AObject *> & tosel );
  static unsigned countSelected( QTreeWidgetItem* parent, 
                                 QTreeWidgetItem* & current );
  void updateRightSelectionChange( int modifier );
  virtual bool event( QEvent* ev );
  virtual void keyPressEvent( QKeyEvent* ev );

protected slots:
  virtual void leftSelectionChangedSlot();
  virtual void rightButtonClickedSlot( QTreeWidgetItem *, const QPoint & );
  virtual void rightButtonRightPanel( QTreeWidgetItem *, const QPoint & );
  virtual void doubleClickedSlot( QTreeWidgetItem*, int );
  void rightPanelDoubleClicked( QTreeWidgetItem*, int );
  virtual void leftItemRenamed( QTreeWidgetItem * item, int col,
                                const QString & text );
  virtual void rightSelectionChangedSlot();
  virtual void refreshNow();
  void updateRightPanelNow();
  void startDrag( QTreeWidgetItem*, Qt::MouseButtons, Qt::KeyboardModifiers );
  virtual void leftItemStartsRename( QTreeWidgetItem * item, int col );
  virtual void leftItemCancelsRename( QTreeWidgetItem * item, int col );

private:
  struct Private;
  struct Static;
  friend class anatomist::StaticInitializers;

  static int registerClass();
  static Static & staticState();

  Private  *d;
};


#endif