+ * panel.setLayout(new ALayout());
+ * panel.add(field11, new ALayoutConstraint(0,0));
+ * panel.add(field12, null);
+ * panel.add(field13, null);
+ * panel.add(field14, null);
+ * panel.add(field21, new ALayoutConstraint(1,0));
+ *
+ *
+ * @author Jorg Janke
+ * @version $Id: ALayout.java,v 1.2 2006/07/30 00:51:27 jjanke Exp $
+ */
+public class ALayout implements LayoutManager2
+{
+ /**
+ * Default Constructor with spacing of 2 and columns filled
+ */
+ public ALayout()
+ {
+ this (2,4, true);
+ } // ALayout
+
+ /**
+ * Detail Contructor
+ * @param spaceH horizontal space (top, between rows, button)
+ * @param spaceV vertical space (left, between columns, right)
+ * @param colFill fields are fully filled (rather then preferred size)
+ */
+ public ALayout(int spaceH, int spaceV, boolean colFill)
+ {
+ setSpaceH(spaceH);
+ setSpaceV(spaceV);
+ m_colFill = colFill;
+ } // ALayout
+
+ /** Data Storage */
+ private ALayoutCollection m_data = new ALayoutCollection();
+ /** Horizontal Space */
+ private int m_spaceH;
+ /** Vertical Space */
+ private int m_spaceV;
+ /** Column Fill */
+ private boolean m_colFill;
+
+ /**
+ * Add To Layout with NULL constraint
+ *
+ * @param name the string to be associated with the component - ignored
+ * @param comp the component to be added
+ */
+ public void addLayoutComponent(String name, Component comp)
+ {
+ addLayoutComponent (comp, null);
+ } // addLayoutComponent
+
+ /**
+ * Adds the specified component to the layout, using the specified
+ * constraint object. If the constraint is not a ALayoutConstraint
+ * the component is added with a NULL constraint.
+ *
+ * Components with a NULL constraint are added as the next column to the last row
+ *
+ * @param component the component to be added
+ * @param constraint where/how the component is added to the layout.
+ * @see ALayoutConstraint
+ */
+ public void addLayoutComponent(Component component, Object constraint)
+ {
+ ALayoutConstraint con = null;
+ if (constraint instanceof ALayoutConstraint)
+ con = (ALayoutConstraint)constraint;
+ //
+ m_data.put(con, component);
+ } // addLayoutComponent
+
+ /**
+ * Removes the specified component from the layout.
+ * @param comp the component to be removed
+ */
+ public void removeLayoutComponent(Component comp)
+ {
+ if (!m_data.containsValue(comp))
+ return;
+ Iterator it = m_data.keySet().iterator();
+ while (it.hasNext())
+ {
+ Object key = it.next();
+ if (m_data.get(key).equals(comp))
+ {
+ m_data.remove(key);
+ return;
+ }
+ }
+ } // removeLayoutComponent
+
+ /**
+ * Calculates the preferred size dimensions for the specified
+ * container, given the components it contains.
+ * @param parent the container to be laid out
+ * @return Size
+ * @see #minimumLayoutSize
+ */
+ public Dimension preferredLayoutSize(Container parent)
+ {
+ return calculateLayoutSize (parent, 'P');
+ } // preferredLayoutSize
+
+ /**
+ * Calculates the minimum size dimensions for the specified
+ * container, given the components it contains.
+ * @param parent the component to be laid out
+ * @return Size
+ * @see #preferredLayoutSize
+ */
+ public Dimension minimumLayoutSize(Container parent)
+ {
+ return calculateLayoutSize (parent, 'm');
+ } // minimumLayoutSize
+
+ /**
+ * Calculates the maximum size dimensions for the specified container,
+ * given the components it contains.
+ * @param parent Parent Container
+ * @return Size
+ * @see java.awt.Component#getMaximumSize
+ * @see LayoutManager
+ */
+ public Dimension maximumLayoutSize(Container parent)
+ {
+ return calculateLayoutSize (parent, 'M');
+ } // maximumLayoutSize
+
+ /**
+ * Calculate Layout Size
+ * @param parent Parent Container
+ * @param how P=Preferred - M=Maximum = m=Mimimum
+ * @return Size
+ */
+ private Dimension calculateLayoutSize(Container parent, char how)
+ {
+ checkComponents(parent);
+ // -- Create 2D Dimension Array
+ int rows = getRowCount();
+ int cols = getColCount();
+ Dimension[][] dim = new Dimension[rows][cols];
+ //
+ Object[] keys = m_data.keySet().toArray();
+ Arrays.sort(keys);
+ for (int i = 0; i < keys.length; i++)
+ {
+ ALayoutConstraint constraint = (ALayoutConstraint)keys[i];
+ Component component = (Component)m_data.get(keys[i]);
+ Dimension d = null;
+ if (how == 'P')
+ d = component.getPreferredSize();
+ else if (how == 'M')
+ d = component.getMaximumSize();
+ else
+ d = component.getMinimumSize();
+ if (component.isVisible())
+ dim [constraint.getRow()][constraint.getCol()] = d;
+ else
+ dim [constraint.getRow()][constraint.getCol()] = null;
+ }
+
+ // -- Calculate 2D Dimension Size
+ Insets insets = parent.getInsets();
+ Dimension retValue = new Dimension (insets.left+insets.right, insets.top+insets.bottom);
+ retValue.height += m_spaceH;
+ retValue.width += m_spaceV;
+ int maxWidth = 0;
+ for (int r = 0; r < rows; r++)
+ {
+ int height = 0;
+ int width = 0;
+ for (int c = 0; c < cols; c++)
+ {
+ Dimension d = dim[r][c];
+ if (d != null)
+ {
+ width += d.width;
+ height = Math.max(height, d.height);
+ }
+ width += m_spaceV;
+ } // for all columns
+ retValue.height += height + m_spaceH;
+ maxWidth += Math.max(maxWidth, width);
+ } // for all rows
+ retValue.width += maxWidth;
+ // Log.trace(this,Log.l6_Database, "ALayout.calculateLayoutSize", retValue.toString());
+ return retValue;
+ } // calculateLayoutSize
+
+ /**
+ * Lays out the specified container.
+ * @param parent the container to be laid out
+ */
+ public void layoutContainer(Container parent)
+ {
+ checkComponents(parent);
+ // -- Create 2D Component Array
+ int rows = getRowCount();
+ int cols = getColCount();
+ Component[][] com = new Component[rows][cols];
+ //
+ Object[] keys = m_data.keySet().toArray();
+ Arrays.sort(keys);
+ for (int i = 0; i < keys.length; i++)
+ {
+ ALayoutConstraint constraint = (ALayoutConstraint)keys[i];
+ Component component = (Component)m_data.get(keys[i]);
+ if (component.isVisible())
+ com [constraint.getRow()][constraint.getCol()] = component;
+ else
+ com [constraint.getRow()][constraint.getCol()] = null;
+ }
+
+ // -- Calculate Column Size
+ int[] colWidth = new int[cols];
+ int[] rowHeight = new int[rows];
+ int columnWidth = m_spaceV;
+ for (int c = 0; c < cols; c++)
+ {
+ int width = 0;
+ for (int r = 0; r < rows; r++)
+ {
+ Component component = com[r][c];
+ if (component != null)
+ {
+ width = Math.max (width, component.getPreferredSize().width);
+ rowHeight[r] = Math.max (rowHeight[r], component.getPreferredSize().height);
+ }
+ }
+ colWidth[c] = width;
+ columnWidth += width + m_spaceV;
+ }
+
+ // -- Stretch/Squeeze Columns to fit target width
+ int parentWidth = parent.getSize().width;
+ double multiplier = (double)parentWidth / (double)columnWidth;
+ if (multiplier < .5) // limit sqeezing
+ multiplier = .5;
+ for (int c = 0; c < cols; c++)
+ colWidth[c] = (int) (colWidth[c] * multiplier);
+ int spaceV = (int)(m_spaceV * multiplier);
+ //
+// log.fine( "ALayout.layoutContainer",
+// "ParentWidth=" + parentWidth + ", ColumnWidth=" + columnWidth + ", SpaceV=" + spaceV + ", Multiplier=" + multiplier);
+
+ // -- Lay out components
+ Insets insets = parent.getInsets();
+ int posH = insets.top + m_spaceH;
+ for (int r = 0; r < rows; r++)
+ {
+ int posV = insets.left + spaceV;
+ int height = 0;
+ for (int c = 0; c < cols; c++)
+ {
+ Component component = com[r][c];
+ if (component != null)
+ {
+ Dimension ps = component.getPreferredSize();
+ int w = ps.width;
+ if (m_colFill || w > colWidth[c]) // limit or stretch
+ w = colWidth[c];
+ int h = ps.height;
+ int topSpace = 0;
+ if (h < rowHeight[r]) // push a little bit lower
+ topSpace = (rowHeight[r] - h) / 3;
+ height = Math.max(height, h);
+ component.setBounds(posV, posH+topSpace, w, h);
+// log.fine( "ALayout.layoutContainer",
+// "Row=" + r + ", Col=" + c + ", PosV=" + posV + ", PosH=" + posH + "/" + topSpace + ", width=" + w + ", height=" + h);
+ }
+ posV += colWidth[c] + spaceV;
+ } // for all columns
+ posH += height + m_spaceH;
+ } // for all rows
+ } // layoutContainer
+
+ /**
+ * Returns the alignment along the x axis. This specifies how
+ * the component would like to be aligned relative to other
+ * components. The value should be a number between 0 and 1
+ * where 0 represents alignment along the origin, 1 is aligned
+ * the furthest away from the origin, 0.5 is centered, etc.
+ * @param target target
+ * @return 0f
+ */
+ public float getLayoutAlignmentX(Container target)
+ {
+ return 0f;
+ } // getLayoutAlignmentX
+
+ /**
+ * Returns the alignment along the y axis. This specifies how
+ * the component would like to be aligned relative to other
+ * components. The value should be a number between 0 and 1
+ * where 0 represents alignment along the origin, 1 is aligned
+ * the furthest away from the origin, 0.5 is centered, etc.
+ * @param target target
+ * @return 0f
+ */
+ public float getLayoutAlignmentY(Container target)
+ {
+ return 0f;
+ } // getLayoutAlignmentY
+
+ /**
+ * Invalidates the layout, indicating that if the layout manager
+ * has cached information it should be discarded.
+ * @param target target
+ */
+ public void invalidateLayout(Container target)
+ {
+ } // invalidateLayout
+
+ /*************************************************************************/
+
+ /**
+ * Check target components and add components, which don't have no constraints
+ * @param target target
+ */
+ private void checkComponents (Container target)
+ {
+ int size = target.getComponentCount();
+ for (int i = 0; i < size; i++)
+ {
+ Component comp = target.getComponent(i);
+ if (!m_data.containsValue(comp))
+ m_data.put(null, comp);
+ }
+ } // checkComponents
+
+ /**
+ * Get Number of Rows
+ * @return no pf rows
+ */
+ public int getRowCount()
+ {
+ return m_data.getMaxRow()+1;
+ } // getRowCount
+
+ /**
+ * Get Number of Columns
+ * @return no of cols
+ */
+ public int getColCount()
+ {
+ return m_data.getMaxCol()+1;
+ } // getColCount
+
+ /**
+ * Set Horizontal Space (top, between rows, button)
+ * @param spaceH horizontal space (top, between rows, button)
+ */
+ public void setSpaceH (int spaceH)
+ {
+ m_spaceH = spaceH;
+ } // setSpaceH
+
+ /**
+ * Get Horizontal Space (top, between rows, button)
+ * @return spaceH horizontal space (top, between rows, button)
+ */
+ public int getSpaceH()
+ {
+ return m_spaceH;
+ } // getSpaceH
+
+ /**
+ * Set Vertical Space (left, between columns, right)
+ * @param spaceV vertical space (left, between columns, right)
+ */
+ public void setSpaceV(int spaceV)
+ {
+ m_spaceV = spaceV;
+ } // setSpaceV
+
+ /**
+ * Get Vertical Space (left, between columns, right)
+ * @return spaceV vertical space (left, between columns, right)
+ */
+ public int getSpaceV()
+ {
+ return m_spaceV;
+ } // getSpaceV
+
+} // ALayout
diff --git a/org.adempiere.install/src/org/compiere/install/util/ALayoutCollection.java b/org.adempiere.install/src/org/compiere/install/util/ALayoutCollection.java
new file mode 100644
index 0000000000..878c99ee27
--- /dev/null
+++ b/org.adempiere.install/src/org/compiere/install/util/ALayoutCollection.java
@@ -0,0 +1,135 @@
+/******************************************************************************
+ * Product: Adempiere ERP & CRM Smart Business Solution *
+ * Copyright (C) 1999-2006 ComPiere, Inc. All Rights Reserved. *
+ * This program is free software; you can redistribute it and/or modify it *
+ * under the terms version 2 of the GNU General Public License as published *
+ * by the Free Software Foundation. This program is distributed in the hope *
+ * that it will be useful, but WITHOUT ANY WARRANTY; without even the implied *
+ * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. *
+ * See the GNU General Public License for more details. *
+ * You should have received a copy of the GNU General Public License along *
+ * with this program; if not, write to the Free Software Foundation, Inc., *
+ * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. *
+ * For the text or an alternative of this public license, you may reach us *
+ * ComPiere, Inc., 2620 Augustine Dr. #245, Santa Clara, CA 95054, USA *
+ * or via info@compiere.org or http://www.compiere.org/license.html *
+ *****************************************************************************/
+package org.compiere.install.util;
+
+import java.awt.Component;
+import java.util.HashMap;
+import java.util.Iterator;
+
+/**
+ * Collection of Components ordered based on ALayoutConstraint
+ *
+ * @author Jorg Janke
+ * @version $Id: ALayoutCollection.java,v 1.2 2006/07/30 00:51:27 jjanke Exp $
+ */
+class ALayoutCollection extends HashMap
+ *
+ * @param o the Object to be compared.
+ * @return a negative integer if this object is less than the specified object,
+ * zero if equal,
+ * or a positive integer if this object is greater than the specified object.
+ */
+ public int compareTo(Object o)
+ {
+ ALayoutConstraint comp = null;
+ if (o instanceof ALayoutConstraint)
+ comp = (ALayoutConstraint)o;
+ if (comp == null)
+ return +111;
+
+ // Row compare
+ int rowComp = m_row - comp.getRow();
+ if (rowComp != 0)
+ return rowComp;
+ // Column compare
+ return m_col - comp.getCol();
+ } // compareTo
+
+ /**
+ * Is Object Equal
+ * @param o
+ * @return true if equal
+ */
+ public boolean equals(Object o)
+ {
+ if (o instanceof ALayoutConstraint)
+ return compareTo(o) == 0;
+ return false;
+ } // equal
+
+ /**
+ * To String
+ * @return info
+ */
+ public String toString()
+ {
+ return "ALayoutConstraint [Row=" + m_row + ", Col=" + m_col + "]";
+ } // toString
+
+} // ALayoutConstraint
diff --git a/org.adempiere.install/src/org/compiere/install/util/AppsAction.java b/org.adempiere.install/src/org/compiere/install/util/AppsAction.java
new file mode 100644
index 0000000000..1649a34412
--- /dev/null
+++ b/org.adempiere.install/src/org/compiere/install/util/AppsAction.java
@@ -0,0 +1,315 @@
+/******************************************************************************
+ * Product: Adempiere ERP & CRM Smart Business Solution *
+ * Copyright (C) 1999-2006 ComPiere, Inc. All Rights Reserved. *
+ * This program is free software; you can redistribute it and/or modify it *
+ * under the terms version 2 of the GNU General Public License as published *
+ * by the Free Software Foundation. This program is distributed in the hope *
+ * that it will be useful, but WITHOUT ANY WARRANTY; without even the implied *
+ * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. *
+ * See the GNU General Public License for more details. *
+ * You should have received a copy of the GNU General Public License along *
+ * with this program; if not, write to the Free Software Foundation, Inc., *
+ * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. *
+ * For the text or an alternative of this public license, you may reach us *
+ * ComPiere, Inc., 2620 Augustine Dr. #245, Santa Clara, CA 95054, USA *
+ * or via info@compiere.org or http://www.compiere.org/license.html *
+ *****************************************************************************/
+package org.compiere.install.util;
+
+import java.awt.Dimension;
+import java.awt.Insets;
+import java.awt.event.ActionEvent;
+import java.awt.event.ActionListener;
+
+import javax.swing.AbstractAction;
+import javax.swing.AbstractButton;
+import javax.swing.Action;
+import javax.swing.Icon;
+import javax.swing.ImageIcon;
+import javax.swing.JButton;
+import javax.swing.JCheckBoxMenuItem;
+import javax.swing.JComponent;
+import javax.swing.JMenuItem;
+import javax.swing.JToggleButton;
+import javax.swing.KeyStroke;
+
+import org.compiere.util.Env;
+import org.compiere.util.Msg;
+
+/**
+ * Application Action.
+ * Creates Action with MenuItem and Button, delegate execution of action to an attached ActionListener instance
+ * The ActionCommand is translated for display
+ * If translated text contains &, the next character is the Mnemonic
+ *
+ * @author Jorg Janke
+ * @version $Id: AppsAction.java,v 1.2 2006/07/30 00:51:27 jjanke Exp $
+ */
+public final class AppsAction extends AbstractAction
+{
+ /**
+ *
+ */
+ private static final long serialVersionUID = 8522301377339185496L;
+
+ /**
+ * Application Action
+ *
+ * @param action base action command - used as AD_Message for Text and Icon name
+ * @param accelerator optional keystroke for accelerator
+ * @param toggle is toggle action (maintains state)
+ */
+ public AppsAction (String action, KeyStroke accelerator, boolean toggle)
+ {
+ this (action, accelerator, null, toggle);
+ }
+ /**
+ * Application Action
+ *
+ * @param action base action command - used as AD_Message for Text and Icon name
+ * @param accelerator optional keystroke for accelerator
+ * @param text text, if null defered from action
+ */
+ public AppsAction (String action, KeyStroke accelerator, String text)
+ {
+ this (action, accelerator, text, false);
+ } // AppsAction
+
+ /**
+ * Application Action
+ *
+ * @param action base action command - used as AD_Message for Text and Icon name
+ * @param accelerator optional keystroke for accelerator
+ * @param toolTipText text, if null defered from action
+ * @param toggle is toggle action (maintains state)
+ */
+ public AppsAction (String action, KeyStroke accelerator, String toolTipText, boolean toggle)
+ {
+ super();
+ m_action = action;
+ m_accelerator = accelerator;
+ m_toggle = toggle;
+
+ // Data
+ if (toolTipText == null)
+ toolTipText = Msg.getMsg(Env.getCtx(), action);
+ int pos = toolTipText.indexOf('&');
+ if (pos != -1 && toolTipText.length() > pos) // We have a nemonic - creates ALT-_
+ {
+ Character ch = new Character(toolTipText.toUpperCase().charAt(pos+1));
+ if (ch != ' ')
+ {
+ toolTipText = toolTipText.substring(0, pos) + toolTipText.substring(pos+1);
+ putValue(Action.MNEMONIC_KEY, new Integer(ch.hashCode()));
+ }
+ }
+ //
+ Icon small = getIcon(action, true);
+ Icon large = getIcon(action, false);
+ Icon largePressed = null;
+
+ // ToggleIcons have the pressed name with X
+ if (m_toggle)
+ {
+ m_smallPressed = getIcon(action+"X", true);
+ if (m_smallPressed == null)
+ m_smallPressed = small;
+ largePressed = getIcon(action+"X", false);
+ if (largePressed == null)
+ largePressed = large;
+ }
+
+ // Attributes
+ putValue(Action.NAME, toolTipText); // Display
+ putValue(Action.SMALL_ICON, small); // Icon
+ putValue(Action.SHORT_DESCRIPTION, toolTipText); // Tooltip
+ putValue(Action.ACTION_COMMAND_KEY, m_action); // ActionCammand
+ putValue(Action.ACCELERATOR_KEY, accelerator); // KeyStroke
+ // putValue(Action.MNEMONIC_KEY, new Integer(0)); // Mnemonic
+ // putValue(Action.DEFAULT, text); // Not Used
+
+ // Create Button
+ if (toggle)
+ {
+ m_button = new JToggleButton(this);
+ m_button.setSelectedIcon(largePressed);
+ }
+ else
+ m_button = new JButton(this);
+ m_button.setName(action);
+ // Correcting Action items
+ if (large != null)
+ {
+ m_button.setIcon(large);
+ m_button.setText(null);
+ }
+ m_button.setActionCommand(m_action);
+ m_button.setMargin(BUTTON_INSETS);
+ m_button.setSize(BUTTON_SIZE);
+ //
+ if (accelerator != null)
+ {
+ m_button.getInputMap(JComponent.WHEN_IN_FOCUSED_WINDOW).put(accelerator, action);
+ m_button.getActionMap().put(action, this);
+ }
+ } // Action
+
+ /** Button Size */
+ public static final Dimension BUTTON_SIZE = new Dimension(28,28);
+ /** Button Insets */
+ public static final Insets BUTTON_INSETS = new Insets(0, 0, 0, 0);
+ /** CButton or CToggelButton */
+ private AbstractButton m_button;
+ /** Menu */
+ private JMenuItem m_menu;
+
+ private String m_action = null;
+ private KeyStroke m_accelerator = null;
+ private Icon m_smallPressed = null;
+ private ActionListener m_delegate = null;
+ private boolean m_toggle = false;
+ private boolean m_pressed = false;
+
+ /**
+ * Get Icon with name action
+ * @param name name
+ * @param small small
+ * @return Icon
+ */
+ private ImageIcon getIcon(String name, boolean small)
+ {
+ String fullName = name + (small ? "16" : "24");
+ return Env.getImageIcon2(fullName);
+ } // getIcon
+
+ /**
+ * Get Name/ActionCommand
+ * @return ActionName
+ */
+ public String getName()
+ {
+ return m_action;
+ } // getName
+
+ /**
+ * Return Button
+ * @return Button
+ */
+ public AbstractButton getButton()
+ {
+ return m_button;
+ } // getButton
+
+ /**
+ * Return MenuItem
+ * @return MenuItem
+ */
+ public JMenuItem getMenuItem()
+ {
+ if (m_menu == null)
+ {
+ if (m_toggle)
+ {
+ m_menu = new JCheckBoxMenuItem(this);
+ m_menu.setSelectedIcon(m_smallPressed);
+ }
+ else
+ m_menu = new JMenuItem(this);
+ m_menu.setAccelerator(m_accelerator);
+ m_menu.setActionCommand(m_action);
+ }
+ return m_menu;
+ } // getMenuItem
+
+ /**
+ * Set Delegate to receive the actionPerformed calls
+ * @param al listener
+ */
+ public void setDelegate(ActionListener al)
+ {
+ m_delegate = al;
+ } // setDelegate
+
+ /**
+ * Toggle
+ * @param pressed pressed
+ */
+ public void setPressed (boolean pressed)
+ {
+ if (!m_toggle)
+ return;
+ m_pressed = pressed;
+
+ // Set Button
+ if (m_button != null)
+ m_button.setSelected(pressed);
+
+ // Set Menu
+ if (m_menu != null)
+ m_menu.setSelected(pressed);
+ } // setPressed
+
+ /**
+ * IsPressed
+ * @return true if pressed
+ */
+ public boolean isPressed()
+ {
+ return m_pressed;
+ } // isPressed
+
+ /**
+ * Get Mnemonic character
+ * @return character
+ */
+ public Character getMnemonic()
+ {
+ Object oo = getValue(Action.MNEMONIC_KEY);
+ if (oo instanceof Integer)
+ return (char)((Integer)oo).intValue();
+ return null;
+ } // getMnemonic
+
+ /**
+ * ActionListener
+ * @param e Event
+ */
+ public void actionPerformed(ActionEvent e)
+ {
+ // log.info( "AppsAction.actionPerformed", e.getActionCommand());
+ // Toggle Items
+ if (m_toggle)
+ setPressed(!m_pressed);
+ // Inform
+ if (m_delegate != null)
+ m_delegate.actionPerformed(e);
+ } // actionPerformed
+
+ /**
+ * Dispose
+ */
+ public void dispose()
+ {
+ m_button = null;
+ m_menu = null;
+ } // dispose
+
+ /**
+ * String Info
+ * @return String Representation
+ */
+ public String toString()
+ {
+ StringBuffer sb = new StringBuffer("AppsAction[");
+ sb.append(m_action);
+ Object oo = getValue(Action.ACCELERATOR_KEY);
+ if (oo != null)
+ sb.append(",Accelerator=").append(oo);
+ oo = getMnemonic();
+ if (oo != null)
+ sb.append(",MnemonicKey=").append(oo);
+ sb.append("]");
+ return sb.toString();
+ } // toString
+
+} // AppsAction
diff --git a/org.adempiere.install/src/org/compiere/install/util/ConfirmPanel.java b/org.adempiere.install/src/org/compiere/install/util/ConfirmPanel.java
new file mode 100644
index 0000000000..235c0fc327
--- /dev/null
+++ b/org.adempiere.install/src/org/compiere/install/util/ConfirmPanel.java
@@ -0,0 +1,739 @@
+/******************************************************************************
+ * Product: Adempiere ERP & CRM Smart Business Solution *
+ * Copyright (C) 1999-2006 ComPiere, Inc. All Rights Reserved. *
+ * This program is free software; you can redistribute it and/or modify it *
+ * under the terms version 2 of the GNU General Public License as published *
+ * by the Free Software Foundation. This program is distributed in the hope *
+ * that it will be useful, but WITHOUT ANY WARRANTY; without even the implied *
+ * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. *
+ * See the GNU General Public License for more details. *
+ * You should have received a copy of the GNU General Public License along *
+ * with this program; if not, write to the Free Software Foundation, Inc., *
+ * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. *
+ * For the text or an alternative of this public license, you may reach us *
+ * ComPiere, Inc., 2620 Augustine Dr. #245, Santa Clara, CA 95054, USA *
+ * or via info@compiere.org or http://www.compiere.org/license.html *
+ *****************************************************************************/
+package org.compiere.install.util;
+
+import java.awt.BorderLayout;
+import java.awt.Component;
+import java.awt.FlowLayout;
+import java.awt.Insets;
+import java.awt.event.ActionListener;
+import java.awt.event.KeyEvent;
+
+import javax.swing.Icon;
+import javax.swing.JButton;
+import javax.swing.JDialog;
+import javax.swing.JFrame;
+import javax.swing.JPanel;
+import javax.swing.JRootPane;
+import javax.swing.KeyStroke;
+
+import org.compiere.util.Env;
+import org.compiere.util.Msg;
+
+/**
+ * Application Confirm Panel.
+ * © Adempiere ")
+ .append("Online Help
+ * if (e.getActionCommand().equals(ConfirmPanel.A_OK))
+ *
+ * @author Jorg Janke
+ * @version $Id: ConfirmPanel.java,v 1.2 2006/07/30 00:51:27 jjanke Exp $
+ */
+public final class ConfirmPanel extends JPanel
+{
+ /**
+ *
+ */
+ private static final long serialVersionUID = 6041019802043360966L;
+
+
+ /**
+ * Create OK Button with label text and F4 Shortcut
+ * @param text text
+ * @return OK Button
+ */
+ public static final JButton createOKButton (String text)
+ {
+ AppsAction aa = new AppsAction (A_OK, KeyStroke.getKeyStroke(KeyEvent.VK_F4, 0), text);
+ JButton button = (JButton)aa.getButton();
+ button.setMargin(s_insets);
+ button.setDefaultCapable(true);
+ return button;
+ } // createOKButton
+
+ /**
+ * Create OK Button with Standard text
+ * @param withText with text
+ * @return OK Button
+ */
+ public static final JButton createOKButton (boolean withText)
+ {
+ if (withText)
+ return createOKButton(Msg.getMsg(Env.getCtx(), A_OK));
+ return createOKButton("");
+ } // createOKButton
+
+ /**
+ * Create Cancel Button wlth label text and register ESC as KeyStroke
+ * @param text text
+ * @return Cancel Button
+ */
+ public static final JButton createCancelButton (String text)
+ {
+ AppsAction aa = new AppsAction (A_CANCEL, KeyStroke.getKeyStroke(KeyEvent.VK_ESCAPE, 0), text);
+ JButton button = (JButton)aa.getButton();
+ button.setMargin(s_insets);
+ return button;
+ } // createCancelButton
+
+ /**
+ * Create Cancel Button wlth Standard text
+ * @param withText with text
+ * @return Button
+ */
+ public static final JButton createCancelButton(boolean withText)
+ {
+ if (withText)
+ return createCancelButton(Msg.getMsg(Env.getCtx(), A_CANCEL));
+ return createCancelButton("");
+ } // createCancelButton
+
+
+ /************************
+ * Create Refresh Button wlth label text and F5
+ * @param text text
+ * @return button
+ */
+ public static final JButton createRefreshButton (String text)
+ {
+ AppsAction aa = new AppsAction (A_REFRESH, KeyStroke.getKeyStroke(KeyEvent.VK_F5, 0), text);
+ JButton button = (JButton)aa.getButton();
+ button.setMargin(s_insets);
+ return button;
+ } // createRefreshButton
+
+ /**
+ * Create Refresh Button wlth Standard text
+ * @param withText with text
+ * @return Button
+ */
+ public static final JButton createRefreshButton (boolean withText)
+ {
+ if (withText)
+ return createRefreshButton(Msg.getMsg(Env.getCtx(), A_REFRESH));
+ return createRefreshButton("");
+ } // createRefreshButton
+
+
+ /************************
+ * Create Reset Button wlth label text
+ * @param text text
+ * @return button
+ */
+ public static final JButton createResetButton (String text)
+ {
+ AppsAction aa = new AppsAction (A_RESET, null, text);
+ JButton button = (JButton)aa.getButton();
+ button.setMargin(s_insets);
+ return button;
+ } // createResetButton
+
+ /**
+ * Create Reset Button wlth Standard text
+ * @param withText with text
+ * @return Button
+ */
+ public static final JButton createResetButton (boolean withText)
+ {
+ if (withText)
+ return createResetButton(Msg.getMsg(Env.getCtx(), A_RESET));
+ return createResetButton(null);
+ } // createRefreshButton
+
+ /************************
+ * Create Customize Button wlth label text
+ * @param text text
+ * @return button
+ */
+ public static final JButton createCustomizeButton (String text)
+ {
+ AppsAction aa = new AppsAction (A_CUSTOMIZE, null, text);
+ JButton button = (JButton)aa.getButton();
+ button.setMargin(s_insets);
+ return button;
+ // Env.getImageIcon("Preference24.gif"));
+ } // createCustomizeButton
+
+ /**
+ * Create Customize Button wlth Standard text
+ * @param withText with text
+ * @return Button
+ */
+ public static final JButton createCustomizeButton (boolean withText)
+ {
+ if (withText)
+ return createCustomizeButton(Msg.getMsg(Env.getCtx(), A_CUSTOMIZE));
+ return createCustomizeButton(null);
+ } // createCustomizeButton
+
+
+ /************************
+ * Create History Button wlth label text
+ * @param text text
+ * @return button
+ */
+ public static final JButton createHistoryButton (String text)
+ {
+ AppsAction aa = new AppsAction (A_HISTORY, KeyStroke.getKeyStroke(KeyEvent.VK_F9, 0), text);
+ JButton button = (JButton)aa.getButton();
+ button.setMargin(s_insets);
+ return button;
+ // Env.getImageIcon("HistoryX24.gif"));
+ } // createHistoryButton
+
+ /**
+ * Create History Button wlth Standard text
+ * @param withText with text
+ * @return Button
+ */
+ public static final JButton createHistoryButton (boolean withText)
+ {
+ if (withText)
+ return createHistoryButton(Msg.getMsg(Env.getCtx(), A_HISTORY));
+ return createHistoryButton(null);
+ } // createHistoryButton
+
+
+ /************************
+ * Create Zoom Button wlth label text
+ * @param text text
+ * @return button
+ */
+ public static final JButton createZoomButton (String text)
+ {
+ AppsAction aa = new AppsAction (A_ZOOM, null, text);
+ JButton button = (JButton)aa.getButton();
+ button.setMargin(s_insets);
+ return button;
+ } // createZoomButton
+
+ /**
+ * Create Zoom Button wlth Standard text
+ * @param withText with text
+ * @return Button
+ */
+ public static final JButton createZoomButton (boolean withText)
+ {
+ if (withText)
+ return createZoomButton(Msg.getMsg(Env.getCtx(), A_ZOOM));
+ return createZoomButton(null);
+ } // createZoomButton
+
+
+ /************************
+ * Create Process Button wlth label text Shift-F4
+ * @param text text
+ * @return button
+ */
+ public static final JButton createProcessButton (String text)
+ {
+ AppsAction aa = new AppsAction (A_PROCESS,
+ KeyStroke.getKeyStroke(KeyEvent.VK_F4, KeyEvent.SHIFT_MASK), text);
+ JButton button = (JButton)aa.getButton();
+ button.setMargin(s_insets);
+ return button;
+ } // createProcessButton
+
+ /**
+ * Create Process Button wlth Standard text
+ * @param withText with text
+ * @return Button
+ */
+ public static final JButton createProcessButton (boolean withText)
+ {
+ if (withText)
+ return createProcessButton(Msg.getMsg(Env.getCtx(), A_PROCESS));
+ return createProcessButton(null);
+ } // createProcessButton
+
+
+ /************************
+ * Create Print Button wlth label text
+ * @param text text
+ * @return button
+ */
+ public static final JButton createPrintButton (String text)
+ {
+ AppsAction aa = new AppsAction (A_PRINT, KeyStroke.getKeyStroke(KeyEvent.VK_F12, 0), text);
+ JButton button = (JButton)aa.getButton();
+ button.setMargin(s_insets);
+ return button;
+ } // createPrintButton
+
+ /**
+ * Create Print Button wlth Standard text
+ * @param withText with text
+ * @return Button
+ */
+ public static final JButton createPrintButton (boolean withText)
+ {
+ if (withText)
+ return createPrintButton(Msg.getMsg(Env.getCtx(), A_PRINT));
+ return createPrintButton(null);
+ } // createPrintButton
+
+
+ /************************
+ * Create Help Button wlth label text
+ * @param text text
+ * @return Button
+ */
+ public static final JButton createHelpButton (String text)
+ {
+ AppsAction aa = new AppsAction (A_HELP, KeyStroke.getKeyStroke(KeyEvent.VK_F1, 0), text);
+ JButton button = (JButton)aa.getButton();
+ button.setMargin(s_insets);
+ return button;
+ } // createHelpButton
+
+ /**
+ * Create Help Button wlth Standard text
+ * @param withText with text
+ * @return Button
+ */
+ public static final JButton createHelpButton (boolean withText)
+ {
+ if (withText)
+ return createHelpButton(Msg.getMsg(Env.getCtx(), A_HELP));
+ return createHelpButton(null);
+ } // createHelpButton
+
+
+ /************************
+ * Create Export Button wlth label text
+ * @param text text
+ * @return Button
+ */
+ public static final JButton createExportButton (String text)
+ {
+ AppsAction aa = new AppsAction (A_EXPORT, null, text);
+ JButton button = (JButton)aa.getButton();
+ button.setMargin(s_insets);
+ return button;
+ } // createExportButton
+
+ /**
+ * Create Export Button wlth Standard text
+ * @param withText with text
+ * @return Button
+ */
+ public static final JButton createExportButton (boolean withText)
+ {
+ if (withText)
+ return createExportButton(Msg.getMsg(Env.getCtx(), A_EXPORT));
+ return createExportButton(null);
+ } // createExportButton
+
+
+ /************************
+ * Create Delete Button with label text - F3
+ * @param text text
+ * @return Delete Button
+ */
+ public static final JButton createDeleteButton (String text)
+ {
+ AppsAction aa = new AppsAction (A_DELETE, KeyStroke.getKeyStroke(KeyEvent.VK_F3, 0), text);
+ JButton button = (JButton)aa.getButton();
+ button.setMargin(s_insets);
+ return button;
+ } // createDeleteButton
+
+ /**
+ * Create Delete Button with Standard text
+ * @param withText with text
+ * @return Delete Button
+ */
+ public static final JButton createDeleteButton (boolean withText)
+ {
+ if (withText)
+ return createDeleteButton(Msg.getMsg(Env.getCtx(), A_DELETE));
+ return createDeleteButton(null);
+ } // createDeleteButton
+
+
+ /************************
+ * Create Product Attribute Button with Standard text
+ * @param withText with text
+ * @return Product Attribute Button
+ */
+ public static final JButton createPAttributeButton (boolean withText)
+ {
+ if (withText)
+ return createPAttributeButton(Msg.getMsg(Env.getCtx(), A_PATTRIBUTE));
+ return createPAttributeButton(null);
+ } // createPAttributeButton
+
+ /**
+ * Create Product Attribute Button with label text
+ * @param text text
+ * @return Product Attribute Button
+ */
+ public static final JButton createPAttributeButton (String text)
+ {
+ AppsAction aa = new AppsAction (A_PATTRIBUTE, null, text);
+ JButton button = (JButton)aa.getButton();
+ button.setMargin(s_insets);
+ return button;
+ } // createPAttributeButton
+
+
+ /************************
+ * Create New Button with Standard text
+ * @param withText with text
+ * @return New Button
+ */
+ public static final JButton createNewButton (boolean withText)
+ {
+ if (withText)
+ return createNewButton(Msg.getMsg(Env.getCtx(), A_NEW));
+ return createNewButton(null);
+ } // createNewButton
+
+ /**
+ * Create New Button with label text - F2
+ * @param text text
+ * @return Product Attribute Button
+ */
+ public static final JButton createNewButton (String text)
+ {
+ AppsAction aa = new AppsAction (A_NEW, KeyStroke.getKeyStroke(KeyEvent.VK_F2, 0), text);
+ JButton button = (JButton)aa.getButton();
+ button.setMargin(s_insets);
+ return button;
+ } // createNewButton
+
+
+ /*************************************************************************/
+
+ /** Action String OK */
+ public static final String A_OK = "Ok";
+ /** Action String Cancel */
+ public static final String A_CANCEL = "Cancel";
+ /** Action String Refresh */
+ public static final String A_REFRESH = "Refresh";
+ /** Action String Reset */
+ public static final String A_RESET = "Reset";
+ /** Action String Customize */
+ public static final String A_CUSTOMIZE = "Customize";
+ /** Action String History */
+ public static final String A_HISTORY = "History";
+ /** Action String Zoom */
+ public static final String A_ZOOM = "Zoom";
+
+ /** Action String Process */
+ public static final String A_PROCESS = "Process";
+ /** Action String Print */
+ public static final String A_PRINT = "Print";
+ /** Action String Export */
+ public static final String A_EXPORT = "Export";
+ /** Action String Help */
+ public static final String A_HELP = "Help";
+ /** Action String Delete */
+ public static final String A_DELETE = "Delete";
+ /** Action String PAttribute */
+ public static final String A_PATTRIBUTE = "PAttribute";
+ /** Action String New */
+ public static final String A_NEW = "New";
+
+ /** Standard Insets used */
+ public static Insets s_insets = new Insets (0, 10, 0, 10);
+
+
+ /**************************************************************************
+ * Create Confirmation Panel with OK Button
+ */
+ public ConfirmPanel()
+ {
+ this (false, false, false, false, false, false, true);
+ } // ConfirmPanel
+
+ /**
+ * Create Confirmation Panel with OK and Cancel Button
+ * @param withCancelButton with cancel
+ */
+ public ConfirmPanel(boolean withCancelButton)
+ {
+ this (withCancelButton, false, false, false, false, false, true);
+ } // ConfirmPanel
+
+ /**
+ * Create Confirmation Panel with different buttons
+ * @param withCancelButton with cancel
+ * @param withRefreshButton with refresh
+ * @param withResetButton with reset
+ * @param withCustomizeButton with customize
+ * @param withHistoryButton with history
+ * @param withZoomButton with zoom
+ * @param withText with text
+ */
+ public ConfirmPanel(boolean withCancelButton,
+ boolean withRefreshButton,
+ boolean withResetButton,
+ boolean withCustomizeButton,
+ boolean withHistoryButton,
+ boolean withZoomButton,
+ boolean withText)
+ {
+ super();
+ BorderLayout mainLayout = new BorderLayout();
+ this.setLayout(mainLayout);
+ this.setName("confirmPanel");
+ //
+ JPanel okCancel = new JPanel(new FlowLayout(FlowLayout.RIGHT));
+ okCancel.setOpaque(false);
+ bCancel = createCancelButton(withText);
+ okCancel.add(bCancel);
+ bOK = createOKButton(withText);
+ okCancel.add(bOK);
+ setCancelVisible(withCancelButton);
+ this.add(okCancel, BorderLayout.EAST);
+ //
+ if (withRefreshButton)
+ {
+ bRefresh = createRefreshButton(withText);
+ addComponent(bRefresh);
+ }
+ if (withResetButton)
+ {
+ bReset = createResetButton(withText);
+ addComponent(bReset);
+ }
+ if (withCustomizeButton)
+ {
+ bCustomize = createCustomizeButton(withText);
+ addComponent(bCustomize);
+ }
+ if (withHistoryButton)
+ {
+ bHistory = createHistoryButton(withText);
+ addComponent(bHistory);
+ }
+ if (withZoomButton)
+ {
+ bZoom = createZoomButton(withText);
+ addComponent(bZoom);
+ }
+ } // ConfirmPanel
+
+ /** Additional Buttons Panel */
+ private JPanel m_addlButtons = null;
+
+ private JButton bOK;
+ private JButton bCancel;
+ //
+ private JButton bRefresh;
+ private JButton bReset;
+ private JButton bCustomize;
+ private JButton bHistory;
+ private JButton bZoom;
+
+ /**
+ * Add Button to left side of confirmPanel
+ * @param button button
+ */
+ public void addComponent (Component button)
+ {
+ if (m_addlButtons == null)
+ {
+ m_addlButtons = new JPanel(new FlowLayout(FlowLayout.LEFT));
+ this.add(m_addlButtons, BorderLayout.WEST);
+ }
+ m_addlButtons.add(button);
+ } // addButton
+
+ /**
+ * Add Button to left side of confirmPanel
+ * @param action action command
+ * @param toolTipText tool tip text
+ * @param icon icon
+ * @return JButton
+ */
+ public JButton addButton (String action, String toolTipText, Icon icon)
+ {
+ AppsAction aa = new AppsAction(action, null, toolTipText);
+ JButton b = (JButton)aa.getButton();
+// new DialogButton (action, toolTipText, icon);
+ addComponent (b);
+ return b;
+ } // addButton
+
+ /**
+ * Add Button to left side of confirmPanel
+ * @param button button
+ * @return JButton
+ */
+ public JButton addButton (JButton button)
+ {
+ addComponent (button);
+ return button;
+ } // addButton
+
+ /**
+ * Get OK Button
+ * @return OK Button
+ */
+ public JButton getOKButton()
+ {
+ return bOK;
+ } // getOKButton
+
+ /**
+ * Get Cancel Button
+ * @return Cancel Button
+ */
+ public JButton getCancelButton()
+ {
+ return bCancel;
+ } // getCancelButton
+
+ /**
+ * Show OK button
+ * @param value true for visible
+ */
+ public void setOKVisible (boolean value)
+ {
+ bOK.setVisible(value);
+ bOK.setEnabled(value);
+ } // setOKVisible
+
+ /**
+ * Is OK Visible
+ * @return true of OK visisble
+ */
+ public boolean isOKVisible()
+ {
+ return bOK.isVisible();
+ } // isOKVisible
+
+ /**
+ * Show Cancel button
+ * @param value trie for visible
+ */
+ public void setCancelVisible (boolean value)
+ {
+ bCancel.setVisible(value);
+ bCancel.setEnabled(value);
+ } // setCancelVisible
+
+ /**
+ * Is Cancel Visible
+ * @return true if Canvel is visible
+ */
+ public boolean isCancelVisible()
+ {
+ return bCancel.isVisible();
+ } // isCancelVisible
+
+ /**
+ * Get Reset Button
+ * @return Button
+ */
+ public JButton getResetButton()
+ {
+ return bReset;
+ } // getResetButton
+
+ /**
+ * Get Customize Button
+ * @return Button
+ */
+ public JButton getCustomizeButton()
+ {
+ return bCustomize;
+ } // getCustomizeButton
+
+ /**
+ * Get History Button
+ * @return Button
+ */
+ public JButton getHistoryButton()
+ {
+ return bHistory;
+ } // getHistoryButton
+
+ /**
+ * Get Zoom Button
+ * @return Button
+ */
+ public JButton getZoomButton()
+ {
+ return bZoom;
+ } // getZoomyButton
+
+ /**
+ * Get Refresh Button
+ * @return Button
+ */
+ public JButton getRefreshButton()
+ {
+ return bRefresh;
+ } // getRefreshButton
+
+
+ /**************************************************************************
+ * Add Action Listener
+ *
+ * if (e.getActionCommand().equals(ConfirmPanel.A_OK))
+ *
+ * @param al listener
+ */
+ public void addActionListener(ActionListener al)
+ {
+ ((AppsAction)bOK.getAction()).setDelegate(al);
+ ((AppsAction)bCancel.getAction()).setDelegate(al);
+ //
+ if (bRefresh != null)
+ ((AppsAction)bRefresh.getAction()).setDelegate(al);
+ if (bReset != null)
+ ((AppsAction)bReset.getAction()).setDelegate(al);
+ if (bCustomize != null)
+ ((AppsAction)bCustomize.getAction()).setDelegate(al);
+ if (bHistory != null)
+ ((AppsAction)bHistory.getAction()).setDelegate(al);
+ if (bZoom != null)
+ ((AppsAction)bZoom.getAction()).setDelegate(al);
+
+ // Set OK as default Button
+ JRootPane rootpane = null;
+ if (al instanceof JDialog)
+ rootpane = ((JDialog)al).getRootPane();
+ else if (al instanceof JFrame)
+ rootpane = ((JFrame)al).getRootPane();
+ if (rootpane != null)
+ rootpane.setDefaultButton(bOK);
+ } // addActionListener
+
+ /**
+ * Enable all components
+ * @param enabled trie if enabled
+ */
+ public void setEnabled (boolean enabled)
+ {
+ super.setEnabled(enabled);
+ bOK.setEnabled(enabled);
+ bCancel.setEnabled(enabled);
+ //
+ if (bRefresh != null)
+ bRefresh.setEnabled(enabled);
+ if (bCustomize != null)
+ bCustomize.setEnabled(enabled);
+ if (bHistory != null)
+ bHistory.setEnabled(enabled);
+ if (bZoom != null)
+ bZoom.setEnabled(enabled);
+ } // setEnabled
+
+} // ConfirmPanel
diff --git a/org.adempiere.install/src/org/compiere/install/util/OnlineHelp.java b/org.adempiere.install/src/org/compiere/install/util/OnlineHelp.java
new file mode 100644
index 0000000000..da4c9b2339
--- /dev/null
+++ b/org.adempiere.install/src/org/compiere/install/util/OnlineHelp.java
@@ -0,0 +1,338 @@
+/******************************************************************************
+ * Product: Adempiere ERP & CRM Smart Business Solution *
+ * Copyright (C) 1999-2006 ComPiere, Inc. All Rights Reserved. *
+ * This program is free software; you can redistribute it and/or modify it *
+ * under the terms version 2 of the GNU General Public License as published *
+ * by the Free Software Foundation. This program is distributed in the hope *
+ * that it will be useful, but WITHOUT ANY WARRANTY; without even the implied *
+ * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. *
+ * See the GNU General Public License for more details. *
+ * You should have received a copy of the GNU General Public License along *
+ * with this program; if not, write to the Free Software Foundation, Inc., *
+ * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. *
+ * For the text or an alternative of this public license, you may reach us *
+ * ComPiere, Inc., 2620 Augustine Dr. #245, Santa Clara, CA 95054, USA *
+ * or via info@compiere.org or http://www.compiere.org/license.html *
+ * Contributor: Carlos Ruiz - globalqss *
+ *****************************************************************************/
+package org.compiere.install.util;
+
+import java.awt.Color;
+import java.awt.Cursor;
+import java.io.InputStream;
+import java.io.InputStreamReader;
+import java.net.ConnectException;
+import java.net.URL;
+import java.net.URLConnection;
+import java.net.UnknownHostException;
+import java.util.Enumeration;
+import java.util.HashMap;
+
+import javax.swing.JEditorPane;
+import javax.swing.event.HyperlinkEvent;
+import javax.swing.event.HyperlinkListener;
+import javax.swing.text.AttributeSet;
+import javax.swing.text.html.HTML;
+import javax.swing.text.html.HTMLDocument;
+import javax.swing.text.html.HTMLEditorKit;
+import javax.swing.text.html.HTMLFrameHyperlinkEvent;
+
+import org.compiere.util.Env;
+
+/**
+ * Online Help Browser & Link.
+ *
+ * @author Jorg Janke
+ * @version $Id: OnlineHelp.java,v 1.2 2006/07/30 00:51:27 jjanke Exp $
+ *
+ * globalqss: fix error about null pointer in OnlineHelp.Worker.run
+ * change the URL for online help for connection
+ */
+public class OnlineHelp extends JEditorPane implements HyperlinkListener
+{
+ /**
+ *
+ */
+ private static final long serialVersionUID = -7201158578463954623L;
+
+ /**
+ * Default Constructor
+ */
+ public OnlineHelp()
+ {
+ super ();
+ setEditable (false);
+ setContentType ("text/html");
+ addHyperlinkListener (this);
+ } // OnlineHelp
+
+ /**
+ * Constructor
+ * @param url URL to load
+ */
+ public OnlineHelp (String url)
+ {
+ this();
+ try
+ {
+ if (url != null && url.length() > 0)
+ setPage(url);
+ }
+ catch (Exception e)
+ {
+ System.err.println("OnlineHelp URL=" + url + " - " + e);
+ }
+ } // OnlineHelp
+
+ /**
+ * Constructor
+ * @param loadOnline load online URL
+ */
+ public OnlineHelp (boolean loadOnline)
+ {
+ this (loadOnline ? BASE_URL : null);
+ } // OnlineHelp
+
+ /** Base of Online Help System */
+ protected static final String BASE_URL = "http://www.adempiere.com/wiki/index.php/OnlineLoginHelp";
+
+ public static void openInDefaultBrowser()
+ {
+ Env.startBrowser(BASE_URL);
+ }
+
+ /**************************************************************************
+ * Hyperlink Listener
+ * @param e event
+ */
+ public void hyperlinkUpdate (HyperlinkEvent e)
+ {
+ // System.out.println("OnlineHelp.hyperlinkUpdate - " + e.getDescription() + " " + e.getURL());
+ if (e.getEventType() != HyperlinkEvent.EventType.ACTIVATED)
+ return;
+
+ this.setCursor(Cursor.getPredefinedCursor(Cursor.WAIT_CURSOR));
+ //
+ if (e instanceof HTMLFrameHyperlinkEvent)
+ {
+ HTMLFrameHyperlinkEvent evt = (HTMLFrameHyperlinkEvent)e;
+ HTMLDocument doc = (HTMLDocument)getDocument();
+ doc.processHTMLFrameHyperlinkEvent(evt);
+ }
+ else if (e.getURL() == null)
+ // remove # of the reference
+ scrollToReference(e.getDescription().substring(1));
+ else
+ {
+ try
+ {
+ setPage(e.getURL());
+ }
+ catch (Throwable t)
+ {
+ System.err.println("Help.hyperlinkUpdate - " + t.toString());
+ displayError("Error", e.getURL(), t);
+ }
+ }
+ this.setCursor(Cursor.getDefaultCursor());
+ } // hyperlinkUpdate
+
+ /**
+ * Set Text
+ * @param text text
+ */
+ public void setText (String text)
+ {
+ super.setText(text);
+ setCaretPosition(0); // scroll to top
+ } // setText
+
+ /**
+ * Load URL async
+ * @param url url
+ */
+ public void setPage (final URL url)
+ {
+ setBackground (Color.white);
+ Runnable pgm = new Runnable()
+ {
+ public void run()
+ {
+ loadPage(url);
+ }
+ };
+ new Thread(pgm).start();
+ } // setPage
+
+ /**
+ * Load Page Async
+ * @param url url
+ */
+ private void loadPage (URL url)
+ {
+ try
+ {
+ super.setPage(url);
+ }
+ catch (Exception e)
+ {
+ displayError("Error: URL not found", url, e);
+ }
+ } // loadPage
+
+ /**
+ * Display Error message
+ * @param header header
+ * @param url url
+ * @param exception exception
+ */
+ protected void displayError (String header, Object url, Object exception)
+ {
+ StringBuffer msg = new StringBuffer ("").append(header).append("
")
+ .append("URL=").append(url).append("
")
+ .append("Error=").append(exception).append("
")
+ .append("
+ * SwingWorker worker = new SwingWorker()
+ * {
+ * public Object construct()
+ * {
+ * return new expensiveOperation();
+ * }
+ * };
+ * worker.start();
+ * // do something
+ * // when you need the result:
+ * x = worker.get(); // this blocks the UI !!
+ *
+ */
+public abstract class SwingWorker
+{
+ /**
+ * Start a thread that will call the construct method
+ * and then exit.
+ */
+ public SwingWorker()
+ {
+ /** Finish Runnable */
+ final Runnable doFinished = new Runnable()
+ {
+ public void run()
+ {
+ finished();
+ }
+ };
+
+ /** Worker Runnable */
+ Runnable doConstruct = new Runnable()
+ {
+ public void run()
+ {
+ try
+ {
+ setValue(construct());
+ }
+ finally
+ {
+ m_threadVar.clear();
+ }
+ SwingUtilities.invokeLater(doFinished);
+ }
+ };
+
+ Thread t = new Thread (doConstruct);
+ m_threadVar = new ThreadVar(t);
+ } // SwingWorker
+
+ /** Worker Thread */
+ private ThreadVar m_threadVar;
+ /** Return value */
+ private Object m_value; // see getValue(), setValue()
+
+ /**
+ * Compute the value to be returned by the get method.
+ * @return value
+ */
+ public abstract Object construct();
+
+ /**
+ * Called on the event dispatching thread (not on the worker thread)
+ * after the construct method has returned.
+ */
+ public void finished()
+ {
+ } // finished
+
+ /**
+ * Get the value produced by the worker thread,
+ * or null if it hasn't been constructed yet.
+ * @return value of worker
+ */
+ protected synchronized Object getValue()
+ {
+ return m_value;
+ } // getValue
+
+ /**
+ * Set the value produced by worker thread
+ * @param x worker value
+ */
+ private synchronized void setValue(Object x)
+ {
+ m_value = x;
+ } // setValue
+
+
+ /*************************************************************************
+ * Start the worker thread.
+ */
+ public void start()
+ {
+ Thread t = m_threadVar.get();
+ if (t != null)
+ t.start();
+ } // start
+
+ /**
+ * Return the value created by the construct method.
+ * Returns null if either the constructing thread or the current
+ * thread was interrupted before a value was produced.
+ * (Blocks UI)
+ * @return the value created by the construct method
+ */
+ public Object get()
+ {
+ while (true)
+ {
+ Thread t = m_threadVar.get();
+ if (t == null)
+ {
+ return getValue();
+ }
+ try
+ {
+ t.join();
+ }
+ catch (InterruptedException e)
+ {
+ Thread.currentThread().interrupt(); // propagate
+ return null;
+ }
+ }
+ } // get
+
+ /**
+ * A new method that interrupts the worker thread. Call this method
+ * to force the worker to stop what it's doing.
+ */
+ public void interrupt()
+ {
+ Thread t = m_threadVar.get();
+ if (t != null)
+ {
+ t.interrupt();
+ }
+ m_threadVar.clear();
+ } // interrupt
+
+ /**
+ * Is worker Alive
+ * @return true if alive
+ */
+ public boolean isAlive()
+ {
+ Thread t = m_threadVar.get();
+ if (t == null)
+ return false;
+ return t.isAlive();
+ } // isAlive
+
+
+ /**************************************************************************
+ * Class to maintain reference to current worker thread
+ * under separate synchronization control.
+ */
+ private static class ThreadVar
+ {
+ /**
+ * Constructor
+ * @param t sync thread
+ */
+ ThreadVar(Thread t)
+ {
+ thread = t;
+ }
+ /** The Sync Thread */
+ private Thread thread;
+
+ /**
+ * Get Sync Thread
+ * @return thread
+ */
+ synchronized Thread get()
+ {
+ return thread;
+ } // get
+
+ /**
+ * Clear Sync thread
+ */
+ synchronized void clear()
+ {
+ thread = null;
+ } // clear
+ } // ThreadVar
+
+} // SwingWorker