Isis 3 Programmer Reference
ControlList.h
1 #ifndef ControlList_H
2 #define ControlList_H
3 
10 /* SPDX-License-Identifier: CC0-1.0 */
11 
12 #include <QDebug>
13 #include <QList>
14 #include <QMetaType>
15 #include <QObject>
16 
17 #include "Control.h"
18 #include "ControlDisplayProperties.h"
19 #include "XmlStackedHandler.h"
20 
21 class QStringList;
22 class QXmlStreamWriter;
23 
24 namespace Isis {
25  class FileName;
26  class XmlStackedHandlerReader;
27 
44  class ControlList : public QObject, public QList<Control *> {
45  Q_OBJECT
46 
47  public:
48 
49  ControlList(QString name, QString path, QObject *parent = NULL);
50  explicit ControlList(QObject *parent = NULL);
51  explicit ControlList(QList<Control *>, QObject *parent = NULL);
52  explicit ControlList(Project *project, XmlStackedHandlerReader *xmlReader,
53  QObject *parent = NULL);
54  explicit ControlList(QStringList &);
55  ControlList(const ControlList &);
56  ~ControlList();
57 
58  // These are overridden (-ish) in order to add notifications to the list changing
59  void append(Control * const &value);
60  void append(const QList<Control *> &value);
61 
62  void clear();
63 
64  iterator erase(iterator pos);
65  iterator erase(iterator begin, iterator end);
66 
67  void insert(int i, Control * const &value);
68  iterator insert(iterator before, Control * const &value);
69 
70  void prepend(Control * const &value);
71  void push_back(Control * const &value);
72  void push_front(Control * const &value);
73  int removeAll(Control * const &value);
74  void removeAt(int i);
75  void removeFirst();
76  void removeLast();
77  bool removeOne(Control * const &value);
78  void swap(QList<Control *> &other);
79  Control *takeAt(int i);
80  Control *takeFirst();
81  Control *takeLast();
82 
84  ControlList &operator+=(Control * const &other);
86  ControlList &operator<<(Control * const &other);
88 
89  // This is our own assignment, but it needs to notify just like the operator=(QList)
90  ControlList &operator=(const ControlList &rhs);
91 
92  // Done overriding (-ish)
93 
94 
95  QList<QAction *> supportedActions(Project *project = NULL);
96  bool allSupport(ControlDisplayProperties::Property prop);
97 
98  void setName(QString newName);
99  void setPath(QString newPath);
100 
101  QString name() const;
102  QString path() const;
103 
104  void deleteFromDisk(Project *project);
105  void save(QXmlStreamWriter &stream, const Project *project, FileName newProjectRoot) const;
106 
107 
108  signals:
109  void countChanged(int newCount);
110  void deletingList(ControlList *list);
111 
112  private:
113 
114 
126  class CopyControlDataFunctor : public std::unary_function<Control * const &, void *> {
127  public:
128  CopyControlDataFunctor(const Project *project, FileName newProjectRoot);
131 
132  void *operator()(Control * const &controlToCopy);
133 
135 
136  private:
139  };
140 
152  class XmlHandler : public XmlStackedHandler {
153  public:
154  XmlHandler(ControlList *controlList, Project *project);
155 
156  virtual bool startElement(const QString &namespaceURI, const QString &localName,
157  const QString &qName, const QXmlAttributes &atts);
158  virtual bool endElement(const QString &namespaceURI, const QString &localName,
159  const QString &qName);
160 
161  private:
162  Q_DISABLE_COPY(XmlHandler);
163 
166  };
167 
168 
169  private:
170  QString m_name;
171 
182  QString m_path;
183  };
184 }
185 
187 
188 #endif
Isis::ControlList::setPath
void setPath(QString newPath)
Set the relative path (from the project root) to this control list's folder.
Definition: ControlList.cpp:529
Isis::ControlList::operator<<
ControlList & operator<<(const QList< Control * > &other)
Appends a list of other control pointers to this control list.
Definition: ControlList.cpp:440
Isis::ControlList::operator=
ControlList & operator=(const QList< Control * > &rhs)
Assigns another list of control pointers to this control list.
Definition: ControlList.cpp:476
Isis::ControlList::save
void save(QXmlStreamWriter &stream, const Project *project, FileName newProjectRoot) const
Convert this control list into XML format for saving/restoring capabilities.
Definition: ControlList.cpp:599
Isis::ControlList::setName
void setName(QString newName)
Set the human-readable name of this control list.
Definition: ControlList.cpp:518
QList
This is free and unencumbered software released into the public domain.
Definition: BoxcarCachingAlgorithm.h:13
Isis::ControlList::CopyControlDataFunctor::m_project
const Project * m_project
Project to copy the control list to.
Definition: ControlList.h:137
Isis::FileName
File name manipulation and expansion.
Definition: FileName.h:100
Isis::ControlList
Maintains a list of Controls so that control nets can easily be copied from one Project to another,...
Definition: ControlList.h:44
Isis::ControlList::ControlList
ControlList(QString name, QString path, QObject *parent=NULL)
Create an control list from a control list name and path (does not read Controls).
Definition: ControlList.cpp:37
Isis::ControlList::~ControlList
~ControlList()
Destructor.
Definition: ControlList.cpp:109
Isis::ControlList::erase
iterator erase(iterator pos)
Erases a control pointer from the control list at the specified position.
Definition: ControlList.cpp:163
Isis::Control
This represents an ISIS control net in a project-based GUI interface.
Definition: Control.h:66
Isis::ControlList::removeLast
void removeLast()
Removes the last control pointer from the control list.
Definition: ControlList.cpp:309
Isis::ControlList::m_name
QString m_name
Name of the ControlList.
Definition: ControlList.h:170
Isis::ControlList::swap
void swap(QList< Control * > &other)
Swaps this control list's control pointers with the other list of control pointers.
Definition: ControlList.cpp:342
QStringList
Isis::XmlStackedHandlerReader
Manage a stack of content handlers for reading XML files.
Definition: XmlStackedHandlerReader.h:30
Isis::ControlList::push_front
void push_front(Control *const &value)
Equivalent to prepend(value)
Definition: ControlList.cpp:254
Isis::ControlList::path
QString path() const
Get the path to these controls in the control list (relative to project root).
Definition: ControlList.cpp:550
Isis::ControlList::XmlHandler::endElement
virtual bool endElement(const QString &namespaceURI, const QString &localName, const QString &qName)
Handle an XML end element.
Definition: ControlList.cpp:793
Isis::Project
The main project for ipce.
Definition: Project.h:289
Isis::ControlList::CopyControlDataFunctor::operator=
CopyControlDataFunctor & operator=(const CopyControlDataFunctor &rhs)
CopyControlDataFunctor assignment operator.
Definition: ControlList.cpp:723
Isis::ControlList::XmlHandler::XmlHandler
XmlHandler(ControlList *controlList, Project *project)
Create an XML Handler (reader/writer) that can populate the ControlList class data.
Definition: ControlList.cpp:738
Isis::ControlList::CopyControlDataFunctor::~CopyControlDataFunctor
~CopyControlDataFunctor()
CopyControlDataFunctor destructor.
Definition: ControlList.cpp:701
Isis::ControlList::XmlHandler::m_controlList
ControlList * m_controlList
Control list to be read or written.
Definition: ControlList.h:164
Isis::ControlList::removeOne
bool removeOne(Control *const &value)
Removes the first occurence of the control pointer from the control list.
Definition: ControlList.cpp:324
Isis::ControlList::CopyControlDataFunctor
This functor is used for copying the control nets between two projects quickly.
Definition: ControlList.h:126
Isis::ControlList::XmlHandler::m_project
Project * m_project
Project that contains the control list.
Definition: ControlList.h:165
Isis::ControlList::operator+=
ControlList & operator+=(const QList< Control * > &other)
Appends control pointers from the other list to this control list.
Definition: ControlList.cpp:404
Isis::ControlList::removeAt
void removeAt(int i)
Removes the control pointer at the specified index.
Definition: ControlList.cpp:287
Isis::ControlList::XmlHandler
Nested class used to write the ControlList object information to an XML file for the purposes of savi...
Definition: ControlList.h:152
Isis::ControlList::clear
void clear()
Clears the control list.
Definition: ControlList.cpp:145
Isis::ControlList::takeFirst
Control * takeFirst()
Removes the first control pointer from the control list and returns it.
Definition: ControlList.cpp:374
Isis::ControlList::prepend
void prepend(Control *const &value)
Prepends a control pointer to the control list.
Definition: ControlList.cpp:226
Isis::ControlList::takeAt
Control * takeAt(int i)
Remove the control pointer at the specified index and returns it.
Definition: ControlList.cpp:360
Isis::ControlList::removeAll
int removeAll(Control *const &value)
Removes all occurences of the control pointer in the control list.
Definition: ControlList.cpp:269
Isis::ControlList::name
QString name() const
Get the human-readable name of this control list.
Definition: ControlList.cpp:539
Isis::XmlStackedHandler
XML Handler that parses XMLs in a stack-oriented way.
Definition: XmlStackedHandler.h:118
Isis::ControlList::append
void append(Control *const &value)
Appends a control pointer to the control list.
Definition: ControlList.cpp:121
Isis::ControlList::deleteFromDisk
void deleteFromDisk(Project *project)
Delete all of the contained Controls from disk.
Definition: ControlList.cpp:562
Isis::ControlList::removeFirst
void removeFirst()
Removes the first control pointer from the control list.
Definition: ControlList.cpp:298
Isis::ControlDisplayProperties::Property
Property
This is a list of properties and actions that are possible.
Definition: ControlDisplayProperties.h:65
QObject
Isis::ControlList::CopyControlDataFunctor::CopyControlDataFunctor
CopyControlDataFunctor(const Project *project, FileName newProjectRoot)
CopyControlDataFunctor constructor.
Definition: ControlList.cpp:680
Isis::ControlList::CopyControlDataFunctor::operator()
void * operator()(Control *const &controlToCopy)
Copies the Control from one project to another.
Definition: ControlList.cpp:710
Isis::ControlList::CopyControlDataFunctor::m_newProjectRoot
FileName m_newProjectRoot
The filename of the destination project's root.
Definition: ControlList.h:138
Isis::ControlList::takeLast
Control * takeLast()
Removes the last control pointer from the control list and returns it.
Definition: ControlList.cpp:388
Isis::ControlList::m_path
QString m_path
This stores the directory name that contains the controls in this control list.
Definition: ControlList.h:182
Isis::ControlList::insert
void insert(int i, Control *const &value)
Inserts a control pointer at the specified position in the control list.
Definition: ControlList.cpp:195
Isis::ControlList::push_back
void push_back(Control *const &value)
Equivalent to append(value)
Definition: ControlList.cpp:240
Isis
This is free and unencumbered software released into the public domain.
Definition: Apollo.h:16
Isis::ControlList::XmlHandler::startElement
virtual bool startElement(const QString &namespaceURI, const QString &localName, const QString &qName, const QXmlAttributes &atts)
Handle an XML start element.
Definition: ControlList.cpp:755
Q_DECLARE_METATYPE
Q_DECLARE_METATYPE(Isis::PlotWindow *)
We have plot windows as QVariant data types, so here it's enabled.