pqUndoStack.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: Copyright (c) Kitware Inc.
// SPDX-FileCopyrightText: Copyright (c) Sandia Corporation
// SPDX-License-Identifier: BSD-3-Clause
#ifndef pqUndoStack_h
#define pqUndoStack_h
 
#include "pqCoreModule.h"
#include <QObject>
 
class pqServer;
class vtkSMUndoElement;
class vtkSMUndoStack;
class vtkSMUndoStackBuilder;
class vtkUndoElement;
class vtkUndoSet;      // vistrails
class vtkPVXMLElement; // vistrails
 
class PQCORE_EXPORT pqUndoStack : public QObject
{
  Q_OBJECT
public:
  pqUndoStack(vtkSMUndoStackBuilder* builder = nullptr, QObject* parent = nullptr);
  ~pqUndoStack() override;
 
  bool canUndo();
 
  bool canRedo();
 
  QString undoLabel();
 
  QString redoLabel();
 
  bool ignoreAllChanges() const;
 
  void registerElementForLoader(vtkSMUndoElement*);
 
  bool getInUndo() const;
  bool getInRedo() const;
 
  void Push(const char* label, vtkUndoSet* set);
  vtkUndoSet* getLastUndoSet();                         // vistrails
  vtkUndoSet* getUndoSetFromXML(vtkPVXMLElement* root); // vistrails
 
  vtkSMUndoStackBuilder* GetUndoStackBuilder();
 
  void updateAllModifiedProxies();
 
public Q_SLOTS: // NOLINT(readability-redundant-access-specifiers)
  void beginUndoSet(QString label);
  void endUndoSet();
 
  void undo();
 
  void redo();
 
  void clear();
 
  void beginNonUndoableChanges();
  void endNonUndoableChanges();
 
  void addToActiveUndoSet(vtkUndoElement* element);
 
Q_SIGNALS:
  void stackChanged(bool canUndo, QString undoLabel, bool canRedo, QString redoLabel);
 
  void canUndoChanged(bool);
  void canRedoChanged(bool);
  void undoLabelChanged(const QString&);
  void redoLabelChanged(const QString&);
 
  // Fired after undo.
  void undone();
  // Fired after redo.
  void redone();
 
private Q_SLOTS:
  void onStackChanged();
 
private: // NOLINT(readability-redundant-access-specifiers)
  class pqImplementation;
  pqImplementation* Implementation;
};
 
#include "pqApplicationCore.h"
 
inline void BEGIN_UNDO_SET(const QString& name)
{
  pqUndoStack* usStack = pqApplicationCore::instance()->getUndoStack();
  if (usStack)
  {
    usStack->beginUndoSet(name);
  }
}
 
inline void END_UNDO_SET()
{
  pqUndoStack* usStack = pqApplicationCore::instance()->getUndoStack();
  if (usStack)
  {
    usStack->endUndoSet();
  }
}
 
inline void CLEAR_UNDO_STACK()
{
  pqUndoStack* usStack = pqApplicationCore::instance()->getUndoStack();
  if (usStack)
  {
    usStack->clear();
  }
}
 
inline void ADD_UNDO_ELEM(vtkUndoElement* elem)
{
  pqUndoStack* usStack = pqApplicationCore::instance()->getUndoStack();
  if (usStack)
  {
    usStack->addToActiveUndoSet(elem);
  }
}
 
inline void BEGIN_UNDO_EXCLUDE()
{
  pqUndoStack* usStack = pqApplicationCore::instance()->getUndoStack();
  if (usStack)
  {
    usStack->beginNonUndoableChanges();
  }
}
 
inline void END_UNDO_EXCLUDE()
{
  pqUndoStack* usStack = pqApplicationCore::instance()->getUndoStack();
  if (usStack)
  {
    usStack->endNonUndoableChanges();
  }
}
 
class PQCORE_EXPORT pqScopedUndoExclude
{
public:
  pqScopedUndoExclude() { BEGIN_UNDO_EXCLUDE(); }
  ~pqScopedUndoExclude() { END_UNDO_EXCLUDE(); }
 
private:
  Q_DISABLE_COPY(pqScopedUndoExclude);
};
 
class PQCORE_EXPORT pqScopedUndoSet
{
public:
  pqScopedUndoSet(const QString& label) { BEGIN_UNDO_SET(label); }
  ~pqScopedUndoSet() { END_UNDO_SET(); }
 
private:
  Q_DISABLE_COPY(pqScopedUndoSet);
};
 
#define SCOPED_UNDO_EXCLUDE() SCOPED_UNDO_EXCLUDE__0(__LINE__)
#define SCOPED_UNDO_EXCLUDE__0(line) pqScopedUndoExclude val##line
 
#define SCOPED_UNDO_SET(txt) SCOPED_UNDO_SET__0(__LINE__, txt)
#define SCOPED_UNDO_SET__0(line, txt) pqScopedUndoSet val##line(txt)
 
#endif