Merge branch 'subtree'
[fanfix.git] / src / jexer / TAction.java
index cc93819d538f708267bf179e8c5327f537c23de0..5343143cc223ebfd3fa8702c7ddb3959d1c7b362 100644 (file)
@@ -34,9 +34,42 @@ package jexer;
  * @see TButton
  */
 public abstract class TAction {
+
+    /**
+     * The widget that called this action's DO() method.  Note that this
+     * field could be null, for example if executed as a timer action.
+     */
+    public TWidget source;
+
+    /**
+     * An optional bit of data associated with this action.
+     */
+    public Object data;
+
+    /**
+     * Call DO() with source widget set.
+     *
+     * @param source the source widget
+     */
+    public final void DO(final TWidget source) {
+        this.source = source;
+        DO();
+    }
+
+    /**
+     * Call DO() with source widget and data set.
+     *
+     * @param source the source widget
+     * @param data the data
+     */
+    public final void DO(final TWidget source, final Object data) {
+        this.source = source;
+        this.data = data;
+        DO();
+    }
+
     /**
      * Various classes will call DO() when they are clicked/selected.
      */
     public abstract void DO();
 }
-