kdgantt/kdganttglobal.cpp

   1 /****************************************************************************
   2  ** Copyright (C) 2001-2006 Klarälvdalens Datakonsult AB.  All rights reserved.
   3  **
   4  ** This file is part of the KD Gantt library.
   5  **
   6  ** This file may be used under the terms of the GNU General Public
   7  ** License versions 2.0 or 3.0 as published by the Free Software
   8  ** Foundation and appearing in the files LICENSE.GPL2 and LICENSE.GPL3
   9  ** included in the packaging of this file.  Alternatively you may (at
  10  ** your option) use any later version of the GNU General Public
  11  ** License if such license has been publicly approved by
  12  ** Klarälvdalens Datakonsult AB (or its successors, if any).
  13  **
  14  ** This file is provided "AS IS" with NO WARRANTY OF ANY KIND,
  15  ** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
  16  ** A PARTICULAR PURPOSE. Klarälvdalens Datakonsult AB reserves all rights
  17  ** not expressly granted herein.
  18  **
  19  ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
  20  ** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  21  **
  22  **********************************************************************/
  23 #include "kdganttglobal.h"
  24
  25 using namespace KDGantt;
  26
  27 /*!\enum KDGantt::ItemDataRole
  28  *\ingroup KDGantt
  29  * The values of this enum are used for the special data roles
  30  * for gantt items
  31  */
  32
  33 /*!\enum KDGantt::ItemDataRole KDGantt::KDGanttRoleBase
  34  * The base value used for the KDGantt role enum values.
  35  * The actual roles have values base+1, base+2, ...
  36  */
  37
  38 /*!\enum KDGantt::ItemDataRole KDGantt::StartTimeRole
  39  * Start time (or other start value) for a gantt item.
  40  */
  41
  42 /*!\enum KDGantt::ItemDataRole KDGantt::EndTimeRole
  43  * End time (or other end value) for a gantt item.
  44  */
  45
  46 /*!\enum KDGantt::ItemDataRole KDGantt::TaskCompletionRole
  47  * Task completetion percentage used by Task items. Should be an
  48  * integer og a double between 0 and 100.
  49  */
  50
  51 /*!\enum KDGantt::ItemDataRole KDGantt::ItemTypeRole
  52  * The item type. \see KDGantt::ItemType.
  53  */
  54
  55 /*!\enum KDGantt::ItemType
  56  *\ingroup KDGantt
  57  * The values of this enum are used to represent the different
  58  * types of gantt items that KDGantt understands. The itemtype
  59  * is served through the KDGantt::ItemTypeRole role
  60  */
  61
  62 /*!\class KDGantt::Span kdganttglobal.h KDGanttGlobal
  63  *\ingroup KDGantt
  64  * \brief A class representing a start point and a length */
  65
  66 Span::~Span()
  67 {
  68 }
  69
  70 DateTimeSpan::DateTimeSpan()
  71 {
  72 }
  73
  74 DateTimeSpan::DateTimeSpan( const QDateTime& start, const QDateTime& end )
  75     : m_start( start ), m_end( end )
  76 {
  77 }
  78
  79 DateTimeSpan::DateTimeSpan( const DateTimeSpan& other )
  80 {
  81     *this = other;
  82 }
  83
  84 DateTimeSpan::~DateTimeSpan()
  85 {
  86 }
  87
  88 DateTimeSpan& DateTimeSpan::operator=( const DateTimeSpan& other )
  89 {
  90     if ( this != &other ) {
  91         m_start = other.m_start;
  92         m_end = other.m_end;
  93     }
  94     return *this;
  95 }
  96
  97 bool DateTimeSpan::isValid() const
  98 {
  99     return m_start.isValid() && m_end.isValid();
 100 }
 101
 102 bool DateTimeSpan::equals( const DateTimeSpan& other ) const
 103 {
 104     return m_start==other.m_start && m_end==other.m_end;
 105 }
 106
 107 #ifndef QT_NO_DEBUG_STREAM
 108
 109 QDebug operator<<( QDebug dbg, KDGantt::ItemDataRole r)
 110 {
 111   switch(r){
 112   case KDGantt::StartTimeRole:      dbg << "KDGantt::StartTimeRole"; break;
 113   case KDGantt::EndTimeRole:        dbg << "KDGantt::EndTimeRole"; break;
 114   case KDGantt::TaskCompletionRole: dbg << "KDGantt::TaskCompletionRole"; break;
 115   case KDGantt::ItemTypeRole:       dbg << "KDGantt::ItemTypeRole"; break;
 116   case KDGantt::LegendRole:         dbg << "KDGantt::LegendRole"; break;
 117   default: dbg << static_cast<Qt::ItemDataRole>(r);
 118   }
 119   return dbg;
 120 }
 121
 122 QDebug operator<<( QDebug dbg, const KDGantt::Span& s )
 123 {
 124     dbg << "KDGantt::Span[ start="<<s.start()<<" length="<<s.length()<<"]";
 125     return dbg;
 126 }
 127 QDebug operator<<( QDebug dbg, const KDGantt::DateTimeSpan& s )
 128 {
 129     dbg << "KDGantt::DateTimeSpan[ start="<<s.start()<<" end="<<s.end()<<"]";
 130     return dbg;
 131 }
 132
 133 #endif /* QT_NO_DEBUG_STREAM */
 134
 135 #ifndef KDAB_NO_UNIT_TESTS
 136 #include "unittest/test.h"
 137
 138 namespace {
 139     std::ostream& operator<<( std::ostream& os, const Span& span )
 140     {
 141         os << "Span[ start="<<span.start()<<", length="<<span.length()<<"]";
 142         return os;
 143     }
 144     std::ostream& operator<<( std::ostream& os, const DateTimeSpan& span )
 145     {
 146         os << "DateTimeSpan[ start="<<span.start().toString().toStdString()
 147            << ", end="<<span.end().toString().toStdString() << "]";
 148         return os;
 149     }
 150 }
 151
 152 KDAB_SCOPED_UNITTEST_SIMPLE( KDGantt, Span, "test" ) {
 153     Span s1;
 154     assertFalse( s1.isValid() );
 155     s1.setStart( 10. );
 156     s1.setLength( 2. );
 157
 158     Span s2( s1.start(), s1.length() );
 159     assertEqual( s1, s2 );
 160 }
 161
 162 KDAB_SCOPED_UNITTEST_SIMPLE( KDGantt, DateTimeSpan, "test" ) {
 163     DateTimeSpan s1;
 164     assertFalse( s1.isValid() );
 165     QDateTime dt = QDateTime::currentDateTime();
 166     s1.setStart( dt );
 167     assertTrue( dt.isValid() );
 168     s1.setEnd( dt.addDays( 1 ) );
 169
 170     DateTimeSpan s2( dt, dt.addDays( 1 ) );
 171
 172     assertEqual( s1, s2 );
 173
 174     DateTimeSpan s3;
 175
 176     assertNotEqual( s1, s3 );
 177 }
 178 #endif /* KDAB_NO_UNIT_TESTS */