HighlightDelegate.h

Go to the documentation of this file.

/*  Copyright (C) 2008 National Institute For Space Research (INPE) - Brazil.
 
    This file is part of the TerraLib - a Framework for building GIS enabled applications.
 
    TerraLib is free software: you can redistribute it and/or modify
    it under the terms of the GNU Lesser General Public License as published by
    the Free Software Foundation, either version 3 of the License,
    or (at your option) any later version.
 
    TerraLib is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
    GNU Lesser General Public License for more details.
 
    You should have received a copy of the GNU Lesser General Public License
    along with TerraLib. See COPYING. If not, write to
    TerraLib Team at <terralib-team@terralib.org>.
 */
 
/*!
  \file HighlightDelegate.h
 
  \brief A delegate for highlight the selected object ids.
*/
 
 
#ifndef __TERRALIB_QT_WIDGETS_TABLE_INTERNAL_DATASETTABLEVIEW_H
#define __TERRALIB_QT_WIDGETS_TABLE_INTERNAL_DATASETTABLEVIEW_H
 
#include "../Config.h"
 
// Qt 
#include <QItemDelegate>
 
// STL
#include <set>
 
namespace te
{
  namespace da
  {
    class ObjectIdSet;
    class ObjectId;
    class DataSet;
  }
 
  namespace qt
  {
    namespace widgets
    {
      // Forward declaration
      class Promoter;
 
      /*!
        \class HighlightDelegate
 
        \brief An specialization of QItemDelegate to be used with te::map::AbstractTable objects.
        
        This class is used on QAbstractItemView that has a te::qt::widgets::DatSetModel as model to highlight some objects. 
        Each identifier in the set of ids are rendering with a predefined color.
        
        \sa QItemDelegate, te::qt::widgets::DataSetTableModel
       */
      class TEQTWIDGETSEXPORT HighlightDelegate : public QItemDelegate 
      {
        public:
 
          /*!
            \brief Constructor.
 
            \param parent QObject parent.
          */
          HighlightDelegate(QObject* parent=0);
 
          /*!
            \brief Destructor
          */
          virtual ~HighlightDelegate();
 
 
          virtual void paint(QPainter* painter, const QStyleOptionViewItem& option, const QModelIndex& index) const;
 
          /*!
            \brief Update the color group.
 
            \param c New color of the group.
          */
          virtual void setColor(const QColor& c);
 
          /*!
            \brief Returns the color.
 
            \return Current color.
          */
          QColor getColor();
 
          /*!
            \brief Sets the current data set being used. This method DOES NOT take the ownership of the \a dset.
 
            \param dset The DataSet to be used.
          */
          virtual void setDataSet(te::da::DataSet* dset);
 
          /*!
            \brief Sets the object id set. It WILL NOT TAKE the ownership of the \a objs.
          */
          virtual void setObjectIdSet(const te::da::ObjectIdSet* objs);
 
          /*!
            \brief Returns the identifiers of the rows highlighted.
 
            \return The identifiers of the highlighted rows;
          */
          virtual const te::da::ObjectIdSet* getSelected() const;
 
          /*!
            \brief Sets the promoter being used.
 
            \param promoter Pointer of the promoter.
 
            \note It DOES NOT take the ownership of \a promoter.
          */
          void setPromoter(Promoter* promoter);
 
        protected:
 
          QColor m_color;               //!< Highlight color.
 
          const te::da::ObjectIdSet* m_objs;  //!< Identifiers of the highlight object.
 
          te::da::DataSet* m_dset;      //!< Pointer to the DataSet being used.
 
          Promoter* m_promoter;         //!< Pointer to the promoter being used.
 
          std::set<std::string> m_oids;
      };
    }
  }
}
 
#endif //__TERRALIB_QT_WIDGETS_TABLE_INTERNAL_DATASETTABLEVIEW_H