src/java/isac/useractions/IUIElement.java
author wneuper
Thu, 17 May 2007 14:05:19 +0200
changeset 3880 0b0dc38b1106
parent 3269 c40b17ae555f
child 3928 d38196e9b162
permissions -rw-r--r--
IUIElement deprecated since UIElement is 'enum'
     1 /*
     2  * @author Alan Krempler
     3  * Created on Dec 12, 2003
     4  */
     5 package isac.useractions;
     6 
     7 /**
     8  * @author Alan Krempler
     9  * @deprecated since UIElement became enum
    10  * Constants describing interactions or request from the user
    11  */
    12     public interface IUIElement {
    13 
    14     /** ***************** NOTIFICATIONS: SPECIFYING PHASE ********************** */
    15 
    16     public static final int UI_DUMMY_FIRST_SPECIFY = 1;
    17 
    18     /**
    19      * During the specifying phase, change the view on the CalcHead. WN050804
    20      * how to use ? which view ?
    21      */
    22     public static final int UI_SPECIFY_CHANGE_VIEW = 2;
    23 
    24     /**
    25      * During the specifying phase, have the Model of the problem (or the guard
    26      * of the method) completed by the math engine.
    27      */
    28     public static final int UI_SPECIFY_COMPLETE_MODEL = 3;
    29 
    30     /**
    31      * During the specifying phase, have the CalcHead completed by the math
    32      * engine.
    33      */
    34     public static final int UI_SPECIFY_COMPLETE_CALCHEAD = 4;
    35 
    36     /**
    37      * During the specifying phase, have the Method field of the CalcHead
    38      * completed by the math engine.
    39      */
    40     public static final int UI_SPECIFY_METHOD = 5;
    41 
    42     /**
    43      * During the specifying phase, have the Theory field of the CalcHead
    44      * completed by the math engine.
    45      */
    46     public static final int UI_SPECIFY_THEORY = 6;
    47 
    48     /**
    49      * During the specifying phase, have the Problem field of the CalcHead
    50      * completed by the math engine.
    51      */
    52     public static final int UI_SPECIFY_PROBLEM = 7;
    53 
    54     /**
    55      * During the specifying phase, have the Given field of the CalcHead
    56      * completed by the math engine.
    57      */
    58     public static final int UI_SPECIFY_COMPLETE_GIVEN = 8;
    59 
    60     /**
    61      * During the specifying phase, have the Find field of the CalcHead
    62      * completed by the math engine.
    63      */
    64     public static final int UI_SPECIFY_COMPLETE_FIND = 9;
    65 
    66     /**
    67      * During the specifying phase, have the Relate field of the CalcHead
    68      * completed by the math engine.
    69      */
    70     public static final int UI_SPECIFY_COMPLETE_RELATE = 10;
    71 
    72     /**
    73      * During the specifying phase, have the CalcHead checked for completeness
    74      * and consistency.
    75      */
    76     public static final int UI_SPECIFY_CHECK_CALCHEAD = 11;
    77 
    78     /**
    79      * Leave the specifying phase, enter the solving phase and calculate until a
    80      * final result is reached.
    81      */
    82     public static final int UI_SPECIFY_CALCULATE_ALL = 12;
    83 
    84     /**
    85      * clear the (possibly messed) contents of the CalcHeadPanel such that a
    86      * UI_SPECIFY_COMPLETE_CALCHEAD or a UI_SPECIFY_CALCULATE_ALL can succeed.
    87      */
    88     public static final int UI_SPECIFY_RESET = 13;
    89 
    90     /**
    91      * open the CalcHeadPanel and start the specify-phase, if the CalcHead is
    92      * not 'complete'
    93      */
    94     public static final int UI_SPECIFY_OPEN_CALCHEAD = 14;
    95 
    96     /**
    97      * Leave the specifying phase, enter the solving phase and calculate the
    98      * first step of the method. A UserAction only.
    99      * 
   100      * @see UI_SPECIFY_CLOSE_CALCHEAD the closely related UIAction
   101      */
   102     public static final int UI_SPECIFY_TO_SOLVE = 15;
   103 
   104     /**
   105      * close the CalcHeadPanel (i.e. a UIAction only)
   106      * 
   107      * @see UI_SPECIFY_TO_SOLVE the closely related UserAction
   108      */
   109     public static final int UI_SPECIFY_CLOSE_CALCHEAD = 16;
   110 
   111     /**
   112      * fill calchead elementwise
   113      */
   114     public static final int UI_SPECIFY_COMPLETE_STEPWISE = 17;
   115 
   116     /**
   117      * Show the guard of the method (already specified in the CalcHead). The
   118      * guard of the method has the same structure as the Model of a problem;
   119      * thus the guard is inserted into the CalcHead at the place of the problems
   120      * Model.
   121      * 
   122      * @see UI_SPECIFY_SWITCH_TO_MODEL switch to the other part of a
   123      *      toggle-mode.
   124      */
   125     public static final int UI_SPECIFY_SWITCH_TO_GUARD = 18;
   126 
   127     /**
   128      * Switch back from having the guard of a method to having the Model of the
   129      * problem (already specified in the CalcHead).
   130      * 
   131      * @see UI_SPECIFY_SWITCH_TO_GUARD switch to the other part of a
   132      *      toggle-mode.
   133      */
   134     public static final int UI_SPECIFY_SWITCH_TO_MODEL = 19;
   135 
   136     public static final int UI_SPECIFY_EDIT_ACTIVE_FORMULA_COMPLETE = 20;
   137 
   138     /**
   139      * @deprecated in favour of UI_SPECIFY_SWITCH_TO_MODEL | GUARD WN050830 or
   140      *             is there a problem with actionPerformed on radiobutton ?!? in
   141      *             this case WN will implement ICalcIterator#onModel, #onGuard
   142      */
   143     public static final int UI_SPECIFY_TOGGLE_METHOD_PROBLEM = 21;
   144 
   145     public static final int UI_DUMMY_LAST_SPECIFY = 22;
   146 
   147     /** ***************** NOTIFICATIONS: SOLVING PHASE ********************** */
   148 
   149     public static final int UI_DUMMY_FIRST_SOLVE = 23;
   150 
   151     /**
   152      * During the solving phase, calculate one more step.
   153      */
   154     public static final int UI_SOLVE_CALCULATE_1 = 23;
   155 
   156     /**
   157      * During the solving phase, calculate until a final result is reached.
   158      */
   159     public static final int UI_SOLVE_CALCULATE_ALL = 24;
   160 
   161     /**
   162      * During the solving phase, calculate until the current subproblem is
   163      * solved.
   164      */
   165     public static final int UI_SOLVE_CALCULATE_SUBPROBLEM = 25;
   166 
   167     /**
   168      * During the solving phase, request editing the currently active formula.
   169      * 
   170      * WN0412 If request is conceded, do
   171      * 
   172      * @see UI_SOLVE_EDIT_ACTIVE_FORMULA_COMPLETE
   173      */
   174     public static final int UI_SOLVE_EDIT_ACTIVE_FORMULA = 26;
   175 
   176     /**
   177      * During the solving phase, notify that editing the currently active
   178      * formula is finished. This implies a request for updating the CalcTree.
   179      */
   180     public static final int UI_SOLVE_EDIT_ACTIVE_FORMULA_COMPLETE = 27;
   181 
   182     /**
   183      * During the solving phase, request inserting a new formula _after_ the
   184      * currently active formula, making the new formula the currently active
   185      * formula. At present, this does not imply editing the formula and must be
   186      * requested in a separate step. WN0412: ...??? is this right interpreted by
   187      * ... WN0412 If request is conceded, do
   188      * 
   189      * @see UI_SOLVE_EDIT_ACTIVE_FORMULA_COMPLETE
   190      */
   191     public static final int UI_SOLVE_APPEND_USER_FORMULA = 28;
   192 
   193     /**
   194      * During the solving phase, request making the referened formula the
   195      * currently active formula.
   196      */
   197     public static final int UI_SOLVE_MOVE_ACTIVE_FORMULA = 29;
   198 
   199     /**
   200      * During the solving phase, ask for the tactic the math engine would apply
   201      * to the current formula.
   202      */
   203     public static final int UI_SOLVE_GET_PROPOSED_TACTIC = 30;
   204 
   205     /**
   206      * During the solving phase, ask for a list of tactics to the current
   207      * formula.
   208      */
   209     public static final int UI_SOLVE_GET_APPLICABLE_TACTICS = 31;
   210 
   211     /**
   212      * During the solving phase, set the tactic to be applied to the current
   213      * formula.
   214      */
   215     public static final int UI_SOLVE_SET_NEXT_TACTIC = 32;
   216 
   217     /**
   218      * When entering a formula during the solving phase, request help on
   219      * entering the formula.
   220      */
   221     public static final int UI_SOLVE_HELP_ENTERING_FORMULA = 33;
   222 
   223     /**
   224      * During the solving phase, show which assumptions hold at the current
   225      * point of calculation.
   226      */
   227     public static final int UI_SOLVE_SHOW_ASSUMPTIONS = 34;
   228 
   229     /**
   230      * Show which tactic has been applied to get this formula
   231      */
   232     public static final int UI_SOLVE_TACTIC_APPLIED = 35;
   233 
   234     /**
   235      * Show which tactics are applicable for this formula
   236      */
   237     public static final int UI_SOLVE_SHOW_APPLICABLE_TACTICS = 36;
   238     
   239     /**
   240      * show CalcHeadPanel; if CalcHead "complete" no interactiveElements if not,
   241      * startSpecifying
   242      */
   243     public static final int UI_SOLVE_SHOW_CALCHEAD = 37;
   244 
   245     /**
   246      * During the solving phase, request more detail about the currently
   247      * referenced element.
   248      */
   249     public static final int UI_SOLVE_SHOW_INTERMEDIATE_STEPS = 38;
   250     
   251     public static final int UI_CLOSE_WORKSHEET = 39;
   252 
   253     public static final int UI_DUMMY_LAST_SOLVE = 40;
   254 
   255     /** ***************** ACTIVE REQUESTS TO THE UI ********************** */
   256 
   257     /**
   258      * Request editing the currently active formula. DG distinguishes between
   259      * SPECIFY and SOLVE; thus could drop UI_SOLVE_EDIT_ACTIVE_FORMULA : int
   260      * 
   261      * LK050711 start editing implicit somewhere in tree, thus unused
   262      */
   263     public static final int UI_DO_EDIT_FORMULA = 40;
   264 
   265     /**
   266      * Request appending a new, empty formula.
   267      */
   268     public static final int UI_DO_APPEND_FORMULA = 41;
   269 
   270     /**
   271      * Activate an UI element.
   272      */
   273     public static final int UI_DO_ACTIVATE = 42;
   274 
   275     /**
   276      * Deactivate an UI element.
   277      */
   278     public static final int UI_DO_DEACTIVATE = 43;
   279 
   280     /**
   281      * The Dialog Guide has detached the listener and will not send any more
   282      * control requests. If registered as a Data Change Listener, update
   283      * notifications will still arrive!
   284      */
   285     public static final int UI_DO_DETACH = 44;
   286 
   287     /**
   288      * Transfer the problem from the problem browser to the worksheet
   289      * @deprecated 
   290      */
   291     public static final int UI_PROBLEMBROWSER_TO_WORKSHEET = 45;
   292     
   293     /**
   294      * Transfer the problem from the browser to the worksheet
   295      */
   296     public static final int UI_BROWSER_TO_WORKSHEET = 46;
   297 
   298     /**
   299      * to turn the auto match mode on
   300      * @deprecated
   301      */
   302     public static final int UI_PROBLEMBROWSER_AUTO_MATCH_ON = 47;
   303 
   304     /**
   305      * to turn the match mode on
   306      */
   307     public static final int UI_BROWSER_MATCH_ON = 48;
   308     
   309     /**
   310      * to turn the auto match mode off
   311      * @deprecated
   312      */
   313     public static final int UI_PROBLEMBROWSER_AUTO_MATCH_OFF = 49;
   314 
   315     /**
   316      * to turn the match mode off
   317      */
   318     public static final int UI_BROWSER_MATCH_OFF = 50;
   319     
   320     /**
   321      * to open the problem browser window
   322      * @deprecated
   323      */
   324     public static final int UI_PROBLEMBROWSER_OPEN = 51;
   325 
   326     /**
   327      * to tell the proble browser dialog that the selection in the problem
   328      * browser has changed
   329      * @deprecated
   330      */
   331     public static final int UI_PROBLEMBROWSER_SELECTION_CHANGED = 52;
   332 
   333     /**
   334      * search for a more appropriate problem
   335      * @deprecated
   336      */
   337     public static final int UI_PROBLEMBROWSER_REFINE = 53;
   338 
   339     /**
   340      * no 'UserAction', but but included here for simplicity reasons: to send a
   341      * request fot the selected problem
   342      * @deprecated
   343      */
   344     public static final int UI_PROBLEMBROWSER_SELECTED_ID = 54;
   345 
   346     /**
   347      * no 'UserAction', but but included here for simplicity reasons: to send a
   348      * request fot the active worksheet
   349      * @deprecated
   350      */
   351     public static final int UI_PROBLEMBROWSER_ACTIVE_WORKSHEET = 55;
   352 
   353     /**
   354      * to send a new model panel to the browser
   355      * @deprecated
   356      */
   357     public static final int UI_PROBLEMBROWSER_MODEL_PANEL = 56;
   358 
   359     /**
   360      * To send a request for the hierarchy
   361      * @deprecated
   362      */
   363     public static final int UI_REQUEST_FOR_HIERARCHY = 57;
   364     
   365     /**
   366      * The browser reports a context change
   367      */
   368     public static final int UI_BROWSER_CHANGE_CONTEXT = 58;
   369     
   370     /**
   371      * MiniBrowser reports/gets a link
   372      */
   373     public static final int UI_MINIBROWSER_LINK = 59;
   374 
   375     /**
   376      * to set the focus on the browser window
   377      */
   378     public static final int UI_BROWSER_GET_FOCUS = 60;
   379  
   380     /**
   381      * to focus was set on browser window 
   382      */
   383     public static final int UI_BROWSER_GOT_FOCUS = 61;
   384     
   385     /**
   386      * the focus in the borwser window got lost
   387      */
   388     public static final int UI_BROWSER_LOST_FOCUS = 62;
   389     
   390     /**
   391      * to report that the link was set
   392      * @deprecated
   393      */
   394     public static final int UI_MINIBROWSER_LINK_SET = 63;
   395 
   396     /**
   397      * to tell the proble browser dialog that the selection in the example
   398      * browser has changed
   399      * @deprecated
   400      */
   401     public static final int UI_EXAMPLEBROWSER_SELECTION_CHANGED = 64;
   402     
   403     /**
   404      * @deprecated
   405      */
   406     public static final int UI_EXAMPLEBROWSER_OPEN_NEW_EXAMPLE = 65;
   407 
   408     /** action to send a ke store id
   409      * @deprecated
   410      */
   411     public static final int UI_SEND_KE_STORE_ID = 66;
   412     
   413     /**
   414     * @deprecated
   415     */
   416     public static final int UI_PROBLEMBROWSER_START_REFINE = 67;
   417 
   418     /** TODO.WN060113 can this be replaced by UI_PROBLEMBROWSER_TO_WORKSHEET ?
   419      * @deprecated
   420      */
   421     public static final int UI_REQUEST_FOR_ID = 68;
   422 
   423     }