| 1 | /**************************************************************************** |
| 2 | ** |
| 3 | ** Copyright (C) 2016 The Qt Company Ltd. |
| 4 | ** Contact: https://www.qt.io/licensing/ |
| 5 | ** |
| 6 | ** This file is part of the test suite of the Qt Toolkit. |
| 7 | ** |
| 8 | ** $QT_BEGIN_LICENSE:GPL-EXCEPT$ |
| 9 | ** Commercial License Usage |
| 10 | ** Licensees holding valid commercial Qt licenses may use this file in |
| 11 | ** accordance with the commercial license agreement provided with the |
| 12 | ** Software or, alternatively, in accordance with the terms contained in |
| 13 | ** a written agreement between you and The Qt Company. For licensing terms |
| 14 | ** and conditions see https://www.qt.io/terms-conditions. For further |
| 15 | ** information use the contact form at https://www.qt.io/contact-us. |
| 16 | ** |
| 17 | ** GNU General Public License Usage |
| 18 | ** Alternatively, this file may be used under the terms of the GNU |
| 19 | ** General Public License version 3 as published by the Free Software |
| 20 | ** Foundation with exceptions as appearing in the file LICENSE.GPL3-EXCEPT |
| 21 | ** included in the packaging of this file. Please review the following |
| 22 | ** information to ensure the GNU General Public License requirements will |
| 23 | ** be met: https://www.gnu.org/licenses/gpl-3.0.html. |
| 24 | ** |
| 25 | ** $QT_END_LICENSE$ |
| 26 | ** |
| 27 | ****************************************************************************/ |
| 28 | |
| 29 | #ifndef PatternistSDK_TestContainer_H |
| 30 | #define PatternistSDK_TestContainer_H |
| 31 | |
| 32 | #include "Global.h" |
| 33 | #include "TestItem.h" |
| 34 | |
| 35 | QT_BEGIN_NAMESPACE |
| 36 | |
| 37 | namespace QPatternistSDK |
| 38 | { |
| 39 | /** |
| 40 | * @short an abstract base class, containing |
| 41 | * an appropriate implementation of TestItem for sub-classes |
| 42 | * which can contain other TestItem instances. |
| 43 | * |
| 44 | * @ingroup PatternistSDK |
| 45 | * @author Frans Englich <frans.englich@nokia.com> |
| 46 | */ |
| 47 | class TestContainer : public TestItem |
| 48 | { |
| 49 | public: |
| 50 | virtual ~TestContainer(); |
| 51 | virtual void appendChild(TreeItem *item); |
| 52 | virtual TreeItem *child(const unsigned int row) const; |
| 53 | virtual unsigned int childCount() const; |
| 54 | |
| 55 | /** |
| 56 | * @returns the TestResults of this TestContainer's children. |
| 57 | */ |
| 58 | virtual TestResult::List execute(const ExecutionStage stage, |
| 59 | TestSuite *ts); |
| 60 | |
| 61 | QString title() const; |
| 62 | void setTitle(const QString &title); |
| 63 | |
| 64 | virtual TreeItem::List children() const; |
| 65 | |
| 66 | /** |
| 67 | * @return always 2 |
| 68 | */ |
| 69 | virtual int columnCount() const; |
| 70 | |
| 71 | virtual bool isFinalNode() const; |
| 72 | |
| 73 | virtual ResultSummary resultSummary() const; |
| 74 | virtual QString description() const; |
| 75 | virtual void setDescription(const QString &desc); |
| 76 | |
| 77 | /** |
| 78 | * Determines whether TestContainer will delete its children upon |
| 79 | * destruction. By default, it will. |
| 80 | */ |
| 81 | void setDeleteChildren(const bool val); |
| 82 | |
| 83 | /** |
| 84 | * Removes the last appended child. |
| 85 | */ |
| 86 | void removeLast(); |
| 87 | |
| 88 | protected: |
| 89 | /** |
| 90 | * Constructor, protected. TestContainer is an abstract class, |
| 91 | * and is not ment to be instantiated, but sub classed. |
| 92 | */ |
| 93 | TestContainer(); |
| 94 | |
| 95 | private: |
| 96 | TreeItem::List m_children; |
| 97 | QString m_title; |
| 98 | QString m_description; |
| 99 | bool m_deleteChildren; |
| 100 | }; |
| 101 | } |
| 102 | |
| 103 | QT_END_NAMESPACE |
| 104 | |
| 105 | #endif |
| 106 | // vim: et:ts=4:sw=4:sts=4 |
| 107 | |