src/jalview/gui/OptsAndParamsPage.java

   1 /*
   2  * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
   3  * Copyright (C) $$Year-Rel$$ The Jalview Authors
   4  *
   5  * This file is part of Jalview.
   6  *
   7  * Jalview is free software: you can redistribute it and/or
   8  * modify it under the terms of the GNU General Public License
   9  * as published by the Free Software Foundation, either version 3
  10  * of the License, or (at your option) any later version.
  11  *
  12  * Jalview is distributed in the hope that it will be useful, but
  13  * WITHOUT ANY WARRANTY; without even the implied warranty
  14  * of MERCHANTABILITY or FITNESS FOR A PARTICULAR
  15  * PURPOSE.  See the GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License
  18  * along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
  19  * The Jalview Authors are detailed in the 'AUTHORS' file.
  20  */
  21 package jalview.gui;
  22
  23 import jalview.util.MessageManager;
  24 import jalview.ws.params.ArgumentI;
  25 import jalview.ws.params.OptionI;
  26 import jalview.ws.params.ParameterI;
  27 import jalview.ws.params.ValueConstrainI;
  28 import jalview.ws.params.ValueConstrainI.ValueType;
  29
  30 import java.awt.BorderLayout;
  31 import java.awt.Component;
  32 import java.awt.Dimension;
  33 import java.awt.Font;
  34 import java.awt.GridLayout;
  35 import java.awt.Rectangle;
  36 import java.awt.event.ActionEvent;
  37 import java.awt.event.ActionListener;
  38 import java.awt.event.KeyEvent;
  39 import java.awt.event.KeyListener;
  40 import java.awt.event.MouseEvent;
  41 import java.awt.event.MouseListener;
  42 import java.net.URL;
  43 import java.util.ArrayList;
  44 import java.util.List;
  45 import java.util.Map;
  46
  47 import javax.swing.JButton;
  48 import javax.swing.JCheckBox;
  49 import javax.swing.JComboBox;
  50 import javax.swing.JComponent;
  51 import javax.swing.JLabel;
  52 import javax.swing.JMenuItem;
  53 import javax.swing.JPanel;
  54 import javax.swing.JPopupMenu;
  55 import javax.swing.JScrollPane;
  56 import javax.swing.JSlider;
  57 import javax.swing.JTextArea;
  58 import javax.swing.JTextField;
  59 import javax.swing.border.TitledBorder;
  60 import javax.swing.event.ChangeEvent;
  61 import javax.swing.event.ChangeListener;
  62
  63 import net.miginfocom.swing.MigLayout;
  64
  65 /**
  66  * GUI generator/manager for options and parameters. Originally abstracted from
  67  * the WsJobParameters dialog box.
  68  *
  69  * @author jprocter
  70  *
  71  */
  72 public class OptsAndParamsPage
  73 {
  74   /**
  75    * compact or verbose style parameters
  76    */
  77   boolean compact = false;
  78
  79   public class OptionBox extends JPanel implements MouseListener,
  80           ActionListener
  81   {
  82     JCheckBox enabled = new JCheckBox();
  83
  84     final URL finfo;
  85
  86     boolean hasLink = false;
  87
  88     boolean initEnabled = false;
  89
  90     String initVal = null;
  91
  92     OptionI option;
  93
  94     JLabel optlabel = new JLabel();
  95
  96     JComboBox val = new JComboBox();
  97
  98     public OptionBox(OptionI opt)
  99     {
 100       option = opt;
 101       setLayout(new BorderLayout());
 102       enabled.setSelected(opt.isRequired()); // TODO: lock required options
 103       enabled.setFont(new Font("Verdana", Font.PLAIN, 11));
 104       enabled.setText("");
 105       enabled.setText(opt.getName());
 106       enabled.addActionListener(this);
 107       finfo = option.getFurtherDetails();
 108       String desc = opt.getDescription();
 109       if (finfo != null)
 110       {
 111         hasLink = true;
 112
 113         enabled.setToolTipText(JvSwingUtils
 114                 .wrapTooltip(
 115                         true,
 116                         ((desc == null || desc.trim().length() == 0) ? MessageManager
 117                                 .getString("label.opt_and_params_further_details")
 118                                 : desc)
 119                                 + "<br><img src=\"" + linkImageURL + "\"/>"));
 120         enabled.addMouseListener(this);
 121       }
 122       else
 123       {
 124         if (desc != null && desc.trim().length() > 0)
 125         {
 126           enabled.setToolTipText(JvSwingUtils.wrapTooltip(true,
 127                   opt.getDescription()));
 128         }
 129       }
 130       add(enabled, BorderLayout.NORTH);
 131       for (Object str : opt.getPossibleValues())
 132       {
 133         val.addItem(str);
 134       }
 135       val.setSelectedItem(opt.getValue());
 136       if (opt.getPossibleValues().size() > 1)
 137       {
 138         setLayout(new GridLayout(1, 2));
 139         val.addActionListener(this);
 140         add(val, BorderLayout.SOUTH);
 141       }
 142       // TODO: add actionListeners for popup (to open further info),
 143       // and to update list of parameters if an option is enabled
 144       // that takes a value. JBPNote: is this TODO still valid ?
 145       setInitialValue();
 146     }
 147
 148     @Override
 149     public void actionPerformed(ActionEvent e)
 150     {
 151       if (e.getSource() != enabled)
 152       {
 153         enabled.setSelected(true);
 154       }
 155       checkIfModified();
 156     }
 157
 158     private void checkIfModified()
 159     {
 160       boolean notmod = (initEnabled == enabled.isSelected());
 161       if (enabled.isSelected())
 162       {
 163         if (initVal != null)
 164         {
 165           notmod &= initVal.equals(val.getSelectedItem());
 166         }
 167         else
 168         {
 169           // compare against default service setting
 170           notmod &= option.getValue() == null
 171                   || option.getValue().equals(val.getSelectedItem());
 172         }
 173       }
 174       else
 175       {
 176         notmod &= (initVal != null) ? initVal.equals(val.getSelectedItem())
 177                 : val.getSelectedItem() != initVal;
 178       }
 179       poparent.argSetModified(this, !notmod);
 180     }
 181
 182     public OptionI getOptionIfEnabled()
 183     {
 184       if (!enabled.isSelected())
 185       {
 186         return null;
 187       }
 188       OptionI opt = option.copy();
 189       if (opt.getPossibleValues() != null
 190               && opt.getPossibleValues().size() == 1)
 191       {
 192         // Hack to make sure the default value for an enabled option with only
 193         // one value is actually returned
 194         opt.setValue(opt.getPossibleValues().get(0));
 195       }
 196       if (val.getSelectedItem() != null)
 197       {
 198         opt.setValue((String) val.getSelectedItem());
 199       }
 200       else
 201       {
 202         if (option.getValue() != null)
 203         {
 204           opt.setValue(option.getValue());
 205         }
 206       }
 207       return opt;
 208     }
 209
 210     @Override
 211     public void mouseClicked(MouseEvent e)
 212     {
 213       if (e.isPopupTrigger()) // for Windows
 214       {
 215         showUrlPopUp(this, finfo.toString(), e.getX(), e.getY());
 216       }
 217     }
 218
 219     @Override
 220     public void mouseEntered(MouseEvent e)
 221     {
 222       // TODO Auto-generated method stub
 223
 224     }
 225
 226     @Override
 227     public void mouseExited(MouseEvent e)
 228     {
 229       // TODO Auto-generated method stub
 230
 231     }
 232
 233     @Override
 234     public void mousePressed(MouseEvent e)
 235     {
 236       if (e.isPopupTrigger()) // Mac
 237       {
 238         showUrlPopUp(this, finfo.toString(), e.getX(), e.getY());
 239       }
 240     }
 241
 242     @Override
 243     public void mouseReleased(MouseEvent e)
 244     {
 245     }
 246
 247     public void resetToDefault(boolean setDefaultParams)
 248     {
 249       enabled.setSelected(false);
 250       if (option.isRequired()
 251               || (setDefaultParams && option.getValue() != null))
 252       {
 253         // Apply default value
 254         selectOption(option, option.getValue());
 255       }
 256     }
 257
 258     public void setInitialValue()
 259     {
 260       initEnabled = enabled.isSelected();
 261       if (option.getPossibleValues() != null
 262               && option.getPossibleValues().size() > 1)
 263       {
 264         initVal = (String) val.getSelectedItem();
 265       }
 266       else
 267       {
 268         initVal = (initEnabled) ? (String) val.getSelectedItem() : null;
 269       }
 270     }
 271
 272   }
 273
 274   public class ParamBox extends JPanel implements ChangeListener,
 275           ActionListener, MouseListener
 276   {
 277     boolean adjusting = false;
 278
 279     boolean choice = false;
 280
 281     JComboBox choicebox;
 282
 283     JPanel controlPanel = new JPanel();
 284
 285     boolean descisvisible = false;
 286
 287     JScrollPane descPanel = new JScrollPane();
 288
 289     final URL finfo;
 290
 291     boolean integ = false;
 292
 293     Object lastVal;
 294
 295     ParameterI parameter;
 296
 297     final OptsParametersContainerI pmdialogbox;
 298
 299     JPanel settingPanel = new JPanel();
 300
 301     JButton showDesc = new JButton();
 302
 303     JSlider slider = null;
 304
 305     JTextArea string = new JTextArea();
 306
 307     ValueConstrainI validator = null;
 308
 309     JTextField valueField = null;
 310
 311     public ParamBox(final OptsParametersContainerI pmlayout, ParameterI parm)
 312     {
 313       pmdialogbox = pmlayout;
 314       finfo = parm.getFurtherDetails();
 315       validator = parm.getValidValue();
 316       parameter = parm;
 317       if (validator != null)
 318       {
 319         integ = validator.getType() == ValueType.Integer;
 320       }
 321       else
 322       {
 323         if (parameter.getPossibleValues() != null)
 324         {
 325           choice = true;
 326         }
 327       }
 328
 329       if (!compact)
 330       {
 331         makeExpanderParam(parm);
 332       }
 333       else
 334       {
 335         makeCompactParam(parm);
 336
 337       }
 338     }
 339
 340     private void makeCompactParam(ParameterI parm)
 341     {
 342       setLayout(new MigLayout("", "[][grow]"));
 343
 344       String ttipText = null;
 345
 346       controlPanel.setLayout(new BorderLayout());
 347
 348       if (parm.getDescription() != null
 349               && parm.getDescription().trim().length() > 0)
 350       {
 351         // Only create description boxes if there actually is a description.
 352         ttipText = (JvSwingUtils
 353                 .wrapTooltip(
 354                         true,
 355                         parm.getDescription()
 356                                 + (finfo != null ? "<br><img src=\""
 357                                         + linkImageURL
 358                                         + "\"/>"
 359                                         + MessageManager
 360                                                 .getString("label.opt_and_params_further_details")
 361                                         : "")));
 362       }
 363
 364       JvSwingUtils.mgAddtoLayout(this, ttipText,
 365               new JLabel(parm.getName()), controlPanel, "");
 366       updateControls(parm);
 367       validate();
 368     }
 369
 370     private void makeExpanderParam(ParameterI parm)
 371     {
 372       setPreferredSize(new Dimension(PARAM_WIDTH, PARAM_CLOSEDHEIGHT));
 373       setBorder(new TitledBorder(parm.getName()));
 374       setLayout(null);
 375       showDesc.setFont(new Font("Verdana", Font.PLAIN, 6));
 376       showDesc.setText("+");
 377       string.setFont(new Font("Verdana", Font.PLAIN, 11));
 378       string.setBackground(getBackground());
 379
 380       string.setEditable(false);
 381       descPanel.getViewport().setView(string);
 382
 383       descPanel.setVisible(false);
 384
 385       JPanel firstrow = new JPanel();
 386       firstrow.setLayout(null);
 387       controlPanel.setLayout(new BorderLayout());
 388       controlPanel.setBounds(new Rectangle(39, 10, PARAM_WIDTH - 70,
 389               PARAM_CLOSEDHEIGHT - 50));
 390       firstrow.add(controlPanel);
 391       firstrow.setBounds(new Rectangle(10, 20, PARAM_WIDTH - 30,
 392               PARAM_CLOSEDHEIGHT - 30));
 393
 394       final ParamBox me = this;
 395
 396       if (parm.getDescription() != null
 397               && parm.getDescription().trim().length() > 0)
 398       {
 399         // Only create description boxes if there actually is a description.
 400         if (finfo != null)
 401         {
 402           showDesc.setToolTipText(JvSwingUtils.wrapTooltip(
 403                   true,
 404                   MessageManager
 405                           .formatMessage(
 406                                   "label.opt_and_params_show_brief_desc_image_link",
 407                                   new String[] { linkImageURL
 408                                           .toExternalForm() })));
 409           showDesc.addMouseListener(this);
 410         }
 411         else
 412         {
 413           showDesc.setToolTipText(JvSwingUtils.wrapTooltip(
 414                   true,
 415                   MessageManager
 416                           .getString("label.opt_and_params_show_brief_desc")));
 417         }
 418         showDesc.addActionListener(new ActionListener()
 419         {
 420
 421           @Override
 422           public void actionPerformed(ActionEvent e)
 423           {
 424             descisvisible = !descisvisible;
 425             descPanel.setVisible(descisvisible);
 426             descPanel.getVerticalScrollBar().setValue(0);
 427             me.setPreferredSize(new Dimension(PARAM_WIDTH,
 428                     (descisvisible) ? PARAM_HEIGHT : PARAM_CLOSEDHEIGHT));
 429             me.validate();
 430             pmdialogbox.refreshParamLayout();
 431           }
 432         });
 433         string.setWrapStyleWord(true);
 434         string.setLineWrap(true);
 435         string.setColumns(32);
 436         string.setText(parm.getDescription());
 437         showDesc.setBounds(new Rectangle(10, 10, 16, 16));
 438         firstrow.add(showDesc);
 439       }
 440       add(firstrow);
 441       validator = parm.getValidValue();
 442       parameter = parm;
 443       if (validator != null)
 444       {
 445         integ = validator.getType() == ValueType.Integer;
 446       }
 447       else
 448       {
 449         if (parameter.getPossibleValues() != null)
 450         {
 451           choice = true;
 452         }
 453       }
 454       updateControls(parm);
 455       descPanel.setBounds(new Rectangle(10, PARAM_CLOSEDHEIGHT,
 456               PARAM_WIDTH - 20, PARAM_HEIGHT - PARAM_CLOSEDHEIGHT - 5));
 457       add(descPanel);
 458       validate();
 459     }
 460
 461     @Override
 462     public void actionPerformed(ActionEvent e)
 463     {
 464       if (adjusting)
 465       {
 466         return;
 467       }
 468       if (!choice)
 469       {
 470         updateSliderFromValueField();
 471       }
 472       checkIfModified();
 473     }
 474
 475     private void checkIfModified()
 476     {
 477       Object cstate = updateSliderFromValueField();
 478       boolean notmod = false;
 479       if (cstate.getClass() == lastVal.getClass())
 480       {
 481         if (cstate instanceof int[])
 482         {
 483           notmod = (((int[]) cstate)[0] == ((int[]) lastVal)[0]);
 484         }
 485         else if (cstate instanceof float[])
 486         {
 487           notmod = (((float[]) cstate)[0] == ((float[]) lastVal)[0]);
 488         }
 489         else if (cstate instanceof String[])
 490         {
 491           notmod = (((String[]) cstate)[0].equals(((String[]) lastVal)[0]));
 492         }
 493       }
 494       pmdialogbox.argSetModified(this, !notmod);
 495     }
 496
 497     @Override
 498     public int getBaseline(int width, int height)
 499     {
 500       return 0;
 501     }
 502
 503     // from
 504     // http://stackoverflow.com/questions/2743177/top-alignment-for-flowlayout
 505     // helpful hint of using the Java 1.6 alignBaseLine property of FlowLayout
 506     @Override
 507     public Component.BaselineResizeBehavior getBaselineResizeBehavior()
 508     {
 509       return Component.BaselineResizeBehavior.CONSTANT_ASCENT;
 510     }
 511
 512     public int getBoxHeight()
 513     {
 514       return (descisvisible ? PARAM_HEIGHT : PARAM_CLOSEDHEIGHT);
 515     }
 516
 517     public ParameterI getParameter()
 518     {
 519       ParameterI prm = parameter.copy();
 520       if (choice)
 521       {
 522         prm.setValue((String) choicebox.getSelectedItem());
 523       }
 524       else
 525       {
 526         prm.setValue(valueField.getText());
 527       }
 528       return prm;
 529     }
 530
 531     public void init()
 532     {
 533       // reset the widget's initial value.
 534       lastVal = null;
 535     }
 536
 537     @Override
 538     public void mouseClicked(MouseEvent e)
 539     {
 540       if (e.isPopupTrigger()) // for Windows
 541       {
 542         showUrlPopUp(this, finfo.toString(), e.getX(), e.getY());
 543       }
 544     }
 545
 546     @Override
 547     public void mouseEntered(MouseEvent e)
 548     {
 549       // TODO Auto-generated method stub
 550
 551     }
 552
 553     @Override
 554     public void mouseExited(MouseEvent e)
 555     {
 556       // TODO Auto-generated method stub
 557
 558     }
 559
 560     @Override
 561     public void mousePressed(MouseEvent e)
 562     {
 563       if (e.isPopupTrigger()) // for Mac
 564       {
 565         showUrlPopUp(this, finfo.toString(), e.getX(), e.getY());
 566       }
 567     }
 568
 569     @Override
 570     public void mouseReleased(MouseEvent e)
 571     {
 572       // TODO Auto-generated method stub
 573
 574     }
 575
 576     @Override
 577     public void stateChanged(ChangeEvent e)
 578     {
 579       if (!adjusting)
 580       {
 581         valueField.setText(""
 582                 + ((integ) ? ("" + slider.getValue())
 583                         : ("" + slider.getValue() / 1000f)));
 584         checkIfModified();
 585       }
 586
 587     }
 588
 589     public void updateControls(ParameterI parm)
 590     {
 591       adjusting = true;
 592       boolean init = (choicebox == null && valueField == null);
 593       if (init)
 594       {
 595         if (choice)
 596         {
 597           choicebox = new JComboBox();
 598           choicebox.addActionListener(this);
 599           controlPanel.add(choicebox, BorderLayout.CENTER);
 600         }
 601         else
 602         {
 603           slider = new JSlider();
 604           slider.addChangeListener(this);
 605           valueField = new JTextField();
 606           valueField.addActionListener(this);
 607           valueField.addKeyListener(new KeyListener()
 608           {
 609
 610             @Override
 611             public void keyTyped(KeyEvent e)
 612             {
 613             }
 614
 615             @Override
 616             public void keyReleased(KeyEvent e)
 617             {
 618               if (e.isActionKey())
 619               {
 620                 if (valueField.getText().trim().length() > 0)
 621                 {
 622                   actionPerformed(null);
 623                 }
 624               }
 625             }
 626
 627             @Override
 628             public void keyPressed(KeyEvent e)
 629             {
 630             }
 631           });
 632           valueField.setPreferredSize(new Dimension(60, 25));
 633           controlPanel.add(slider, BorderLayout.WEST);
 634           controlPanel.add(valueField, BorderLayout.EAST);
 635
 636         }
 637       }
 638
 639       if (parm != null)
 640       {
 641         if (choice)
 642         {
 643           if (init)
 644           {
 645             List vals = parm.getPossibleValues();
 646             for (Object val : vals)
 647             {
 648               choicebox.addItem(val);
 649             }
 650           }
 651
 652           if (parm.getValue() != null)
 653           {
 654             choicebox.setSelectedItem(parm.getValue());
 655           }
 656         }
 657         else
 658         {
 659           valueField.setText(parm.getValue());
 660         }
 661       }
 662       lastVal = updateSliderFromValueField();
 663       adjusting = false;
 664     }
 665
 666     public Object updateSliderFromValueField()
 667     {
 668       int iVal;
 669       float fVal;
 670       if (validator != null)
 671       {
 672         if (integ)
 673         {
 674           iVal = 0;
 675           try
 676           {
 677             valueField.setText(valueField.getText().trim());
 678             iVal = Integer.valueOf(valueField.getText());
 679             if (validator.getMin() != null
 680                     && validator.getMin().intValue() > iVal)
 681             {
 682               iVal = validator.getMin().intValue();
 683               // TODO: provide visual indication that hard limit was reached for
 684               // this parameter
 685             }
 686             if (validator.getMax() != null
 687                     && validator.getMax().intValue() < iVal)
 688             {
 689               iVal = validator.getMax().intValue();
 690               // TODO: provide visual indication that hard limit was reached for
 691               // this parameter
 692             }
 693           } catch (Exception e)
 694           {
 695           }
 696           ;
 697           // update value field to reflect any bound checking we performed.
 698           valueField.setText("" + iVal);
 699           if (validator.getMin() != null && validator.getMax() != null)
 700           {
 701             slider.getModel().setRangeProperties(iVal, 1,
 702                     validator.getMin().intValue(),
 703                     validator.getMax().intValue() + 1, true);
 704           }
 705           else
 706           {
 707             slider.setVisible(false);
 708           }
 709           return new int[] { iVal };
 710         }
 711         else
 712         {
 713           fVal = 0f;
 714           try
 715           {
 716             valueField.setText(valueField.getText().trim());
 717             fVal = Float.valueOf(valueField.getText());
 718             if (validator.getMin() != null
 719                     && validator.getMin().floatValue() > fVal)
 720             {
 721               fVal = validator.getMin().floatValue();
 722               // TODO: provide visual indication that hard limit was reached for
 723               // this parameter
 724               // update value field to reflect any bound checking we performed.
 725               valueField.setText("" + fVal);
 726             }
 727             if (validator.getMax() != null
 728                     && validator.getMax().floatValue() < fVal)
 729             {
 730               fVal = validator.getMax().floatValue();
 731               // TODO: provide visual indication that hard limit was reached for
 732               // this parameter
 733               // update value field to reflect any bound checking we performed.
 734               valueField.setText("" + fVal);
 735             }
 736           } catch (Exception e)
 737           {
 738           }
 739           ;
 740           if (validator.getMin() != null && validator.getMax() != null)
 741           {
 742             slider.getModel().setRangeProperties((int) (fVal * 1000f), 1,
 743                     (int) (validator.getMin().floatValue() * 1000f),
 744                     1 + (int) (validator.getMax().floatValue() * 1000f),
 745                     true);
 746           }
 747           else
 748           {
 749             slider.setVisible(false);
 750           }
 751           return new float[] { fVal };
 752         }
 753       }
 754       else
 755       {
 756         if (!choice)
 757         {
 758           slider.setVisible(false);
 759           return new String[] { valueField.getText().trim() };
 760         }
 761         else
 762         {
 763           return new String[] { (String) choicebox.getSelectedItem() };
 764         }
 765       }
 766
 767     }
 768   }
 769
 770   public static final int PARAM_WIDTH = 340;
 771
 772   public static final int PARAM_HEIGHT = 150;
 773
 774   public static final int PARAM_CLOSEDHEIGHT = 80;
 775
 776   public OptsAndParamsPage(OptsParametersContainerI paramContainer)
 777   {
 778     this(paramContainer, false);
 779   }
 780
 781   public OptsAndParamsPage(OptsParametersContainerI paramContainer,
 782           boolean compact)
 783   {
 784     poparent = paramContainer;
 785     this.compact = compact;
 786   }
 787
 788   public static void showUrlPopUp(JComponent invoker, final String finfo,
 789           int x, int y)
 790   {
 791
 792     JPopupMenu mnu = new JPopupMenu();
 793     JMenuItem mitem = new JMenuItem(MessageManager.formatMessage(
 794             "label.view_params", new String[] { finfo }));
 795     mitem.addActionListener(new ActionListener()
 796     {
 797
 798       @Override
 799       public void actionPerformed(ActionEvent e)
 800       {
 801         Desktop.showUrl(finfo);
 802
 803       }
 804     });
 805     mnu.add(mitem);
 806     mnu.show(invoker, x, y);
 807   }
 808
 809   URL linkImageURL = getClass().getResource("/images/link.gif");
 810
 811   Map<String, OptionBox> optSet = new java.util.LinkedHashMap<String, OptionBox>();
 812
 813   Map<String, ParamBox> paramSet = new java.util.LinkedHashMap<String, ParamBox>();
 814
 815   public Map<String, OptionBox> getOptSet()
 816   {
 817     return optSet;
 818   }
 819
 820   public void setOptSet(Map<String, OptionBox> optSet)
 821   {
 822     this.optSet = optSet;
 823   }
 824
 825   public Map<String, ParamBox> getParamSet()
 826   {
 827     return paramSet;
 828   }
 829
 830   public void setParamSet(Map<String, ParamBox> paramSet)
 831   {
 832     this.paramSet = paramSet;
 833   }
 834
 835   OptsParametersContainerI poparent;
 836
 837   OptionBox addOption(OptionI opt)
 838   {
 839     OptionBox cb = optSet.get(opt.getName());
 840     if (cb == null)
 841     {
 842       cb = new OptionBox(opt);
 843       optSet.put(opt.getName(), cb);
 844       // jobOptions.add(cb, FlowLayout.LEFT);
 845     }
 846     return cb;
 847   }
 848
 849   ParamBox addParameter(ParameterI arg)
 850   {
 851     ParamBox pb = paramSet.get(arg.getName());
 852     if (pb == null)
 853     {
 854       pb = new ParamBox(poparent, arg);
 855       paramSet.put(arg.getName(), pb);
 856       // paramList.add(pb);
 857     }
 858     pb.init();
 859     // take the defaults from the parameter
 860     pb.updateControls(arg);
 861     return pb;
 862   }
 863
 864   void selectOption(OptionI option, String string)
 865   {
 866     OptionBox cb = optSet.get(option.getName());
 867     if (cb == null)
 868     {
 869       cb = addOption(option);
 870     }
 871     cb.enabled.setSelected(string != null); // initial state for an option.
 872     if (string != null)
 873     {
 874       if (option.getPossibleValues().contains(string))
 875       {
 876         cb.val.setSelectedItem(string);
 877       }
 878       else
 879       {
 880         throw new Error(MessageManager.formatMessage(
 881                 "error.invalid_value_for_option", new String[] { string,
 882                     option.getName() }));
 883       }
 884
 885     }
 886     if (option.isRequired() && !cb.enabled.isSelected())
 887     {
 888       // TODO: indicate paramset is not valid.. option needs to be selected!
 889     }
 890     cb.setInitialValue();
 891   }
 892
 893   void setParameter(ParameterI arg)
 894   {
 895     ParamBox pb = paramSet.get(arg.getName());
 896     if (pb == null)
 897     {
 898       addParameter(arg);
 899     }
 900     else
 901     {
 902       pb.updateControls(arg);
 903     }
 904
 905   }
 906
 907   /**
 908    * recover options and parameters from GUI
 909    *
 910    * @return
 911    */
 912   public List<ArgumentI> getCurrentSettings()
 913   {
 914     List<ArgumentI> argSet = new ArrayList<ArgumentI>();
 915     for (OptionBox opts : getOptSet().values())
 916     {
 917       OptionI opt = opts.getOptionIfEnabled();
 918       if (opt != null)
 919       {
 920         argSet.add(opt);
 921       }
 922     }
 923     for (ParamBox parambox : getParamSet().values())
 924     {
 925       ParameterI parm = parambox.getParameter();
 926       if (parm != null)
 927       {
 928         argSet.add(parm);
 929       }
 930     }
 931
 932     return argSet;
 933   }
 934
 935 }