Changeset 0ec9f5 for src/Actions/UndoAction.def

Timestamp:

Apr 23, 2021, 9:02:12 PM (5 years ago)

Author:

Frederik Heber <frederik.heber@…>

Branches:

Candidate_v1.7.0, stable

Children:

0fbea3

Parents:

5061d9

git-author:

Frederik Heber <frederik.heber@…> (04/06/21 20:09:39)

git-committer:

Frederik Heber <frederik.heber@…> (04/23/21 21:02:12)

Message:

Added UndoMarkAction.

NOTE: This action is necessary as not all actions are actually recorded
in the history. For example, the UndoAction is an action that is not
pushed into the history deque and also must not as further undos would
then become impossible. There are other actions that just do output
or similar things that do not change the state.
This makes it impossible to undo back to a certain state by blindly
counting actions as one cannot know from the outside whether an action
is stateless or not.

• ActionHistory allows to mark a certain HistoryElement.
• marked element is reset when undone in history.
• marked element can be set and unset via UndoMarkAction.
• ActionQueue relays undoTillMark() to ActionHistory.
• extended UndoAction by param "till-mark" to allow step-wise undo and

undoing till the set mark.

• TESTS: added regression test case on undo-mark.

File:

• src/Actions/UndoAction.def (modified) (2 diffs)

src/Actions/UndoAction.def

@@ -13 +13 @@
 // ValueStorage by the token "Z" -> first column: int, Z, "Z"
 // "undefine" if no parameters are required, use (NOPARAM_DEFAULT) for each (undefined) default value
-#undef paramtypes
-#undef paramreferences
-#undef paramtokens
-#undef paramdescriptions
-#undef paramdefaults
+#define paramtypes (bool)
+#define paramtokens ("till-mark")
+#define paramdescriptions ("whether to undo just a single step (false) or until a previously set mark (true)")
+#define paramdefaults (PARAM_DEFAULT(false))
+#define paramreferences (undoTillMark)
+#define paramvalids (DummyValidator<bool>())
 
 // some defines for all the names, you may use ACTION, STATE and PARAMS
@@ -27 +28 @@
 
 // finally the information stored in the ActionTrait specialization
-#define DESCRIPTION "undo last action"
+#define DESCRIPTION "undo last action or until a given mark"
 #undef SHORTFORM