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 | |