HighlightDelegate.h

Go to the documentation of this file.

/*  Copyright (C) 2011-2012 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