/usr/include/qxrunner/runneritem.h is in libqxrunner-dev 0.9.2-0ubuntu3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 | /*!
* \file runneritem.h
*
* \brief Declares class RunnerItem.
*/
#ifndef RUNNERITEM_H
#define RUNNERITEM_H
#include "qxrunner_global.h"
#include <QVariant>
namespace QxRunner {
/*!
* \brief The RunnerItem class represents an executable item in a tree
* view and contains several columns of data.
*
* This class holds information about its position in the RunnerModel
* tree structure, column data and the code that gets executed in a
* QxRunner run.
*
* The class is a basic C++ class. It is not intended to be used directly,
* but must be subclassed. It does not inherit from QObject or provide
* signals and slots. Subclasses nevertheless can be a QObject, for
* example to support localization with \c tr().
*
* Subclasses must reimplement the abstract run() method to do useful
* application specific work.
*
* \sa \ref runner_model_item and \ref runner_item_index
*/
class QXRUNNER_EXPORT RunnerItem
{
public: // Operations
/*!
* Constructs a runner item with the given \a parent and the
* \a data associated with each column. Ensures that number of
* columns equals number of columns in \a parent. Initial result
* is set to QxRunner::NoResult.
*/
RunnerItem(const QList<QVariant>& data, RunnerItem* parent = 0);
/*!
* Destroys this runner item and all its children.
*/
virtual ~RunnerItem();
/*!
* Returns the item's parent.
*/
RunnerItem* parent() const;
/*!
* Returns the child that corresponds to the specified \a row
* number in the item's list of child items.
*/
RunnerItem* child(int row) const;
/*!
* Adds \a child to the item's list of child items.
*/
void appendChild(RunnerItem* child);
/*!
* Returns the number of child items held.
*/
int childCount() const;
/*!
* Reports the item's location within its parent's list of items.
*/
int row() const;
/*!
* Returns the number of columns of data in the item.
*/
int columnCount() const;
/*!
* Returns the data of \a column.
*/
QVariant data(int column) const;
/*!
* Sets the data for the \a column to \a value.
*/
void setData(int column, const QVariant& value);
/*!
* Returns true if the item is selected for execution, otherwise
* false.
*/
bool isSelected() const;
/*!
* If \a select is true the item can be executed by QxRunner,
* otherwise not.
*/
void setSelected(bool select);
/*!
* Returns the result of the last execution. The returned value
* is of type QxRunner::RunnerResult.
*/
int result() const;
/*!
* Sets the \a result for this item. The given value must be of
* type QxRunner::RunnerResult.
*/
void setResult(int result);
/*!
* Except for column 0 the data is set to an empty string. The
* item's result is set to QxRunner::NoResult.
*/
void clear();
/*!
* The custom code to be executed when an item is run by QxRunner
* must be placed in the run method of subclasses.
*/
virtual int run() = 0;
private: // Operations
// Copy and assignment not supported.
RunnerItem(const RunnerItem&);
RunnerItem& operator=(const RunnerItem&);
private: // Attributes
RunnerItem* m_parentItem;
QList<QVariant> m_itemData;
QList<RunnerItem*> m_childItems;
bool m_selected;
int m_result;
};
} // namespace
#endif // RUNNERITEM_H
|