/********************************************************************************
* *
* (c) Copyright 2010 Verizon Communications USA and The Open University UK *
* *
* This software is freely distributed in accordance with *
* the GNU Lesser General Public (LGPL) license, version 3 or later *
* as published by the Free Software Foundation. *
* For details see LGPL: http://www.fsf.org/licensing/licenses/lgpl.html *
* and GPL: http://www.fsf.org/licensing/licenses/gpl-3.0.html *
* *
* This software is provided by the copyright holders and contributors "as is" *
* and any express or implied warranties, including, but not limited to, the *
* implied warranties of merchantability and fitness for a particular purpose *
* are disclaimed. In no event shall the copyright owner or contributors be *
* liable for any direct, indirect, incidental, special, exemplary, or *
* consequential damages (including, but not limited to, procurement of *
* substitute goods or services; loss of use, data, or profits; or business *
* interruption) however caused and on any theory of liability, whether in *
* contract, strict liability, or tort (including negligence or otherwise) *
* arising in any way out of the use of this software, even if advised of the *
* possibility of such damage. *
* *
********************************************************************************/
package com.compendium.ui.panels;
import java.awt.BorderLayout;
import java.awt.Color;
import java.awt.Component;
import java.awt.Dimension;
import java.awt.Font;
import java.awt.GridBagConstraints;
import java.awt.GridBagLayout;
import java.awt.Insets;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.awt.event.FocusEvent;
import java.awt.event.FocusListener;
import java.awt.event.KeyEvent;
import java.awt.event.MouseAdapter;
import java.awt.event.MouseEvent;
import java.awt.event.MouseListener;
import java.util.Enumeration;
import javax.swing.Icon;
import javax.swing.JLabel;
import javax.swing.JPanel;
import javax.swing.JScrollPane;
import javax.swing.JTextField;
import javax.swing.JTree;
import javax.swing.KeyStroke;
import javax.swing.SwingConstants;
import javax.swing.border.EmptyBorder;
import javax.swing.tree.DefaultMutableTreeNode;
import javax.swing.tree.DefaultTreeCellRenderer;
import javax.swing.tree.DefaultTreeModel;
import javax.swing.tree.TreeCellRenderer;
import javax.swing.tree.TreePath;
import javax.swing.tree.TreeSelectionModel;
import com.compendium.LanguageProperties;
import com.compendium.ProjectCompendium;
import com.compendium.core.datamodel.Link;
import com.compendium.core.datamodel.LinkProperties;
import com.compendium.ui.UIButton;
import com.compendium.ui.UIButtonPanel;
import com.compendium.ui.UILink;
import com.compendium.ui.UITextArea;
import com.compendium.ui.dialogs.UILinkContentDialog;
import com.compendium.ui.linkgroups.UILinkGroup;
import com.compendium.ui.linkgroups.UILinkType;
/**
* This panel holds the fields that allows users to change settings for a link.
*
* @author Michelle Bachler
*/
public class UILinkEditPanel extends JPanel implements ActionListener {
/** Holds all the link groups and their link types.*/
private static DefaultMutableTreeNode oLinkTypeTopTreeNode = null;
/** The UILink reference for the link to change setting for.*/
public UILink oUILink = null;
/** The Link object to change setting for.*/
public Link oLink = null;
/** The LinkProperties object to change setting for.*/
public LinkProperties oLinkProperties = null;
/** The button to cancel this dialog.*/
public UIButton pbCancel = null;
/** The button to update the new settings to the link/s.*/
public UIButton pbUpdate = null;
/** The button to open the relevant help.*/
public UIButton pbHelp = null;
/** The curent link type.*/
private String sLinkType = ""; //$NON-NLS-1$
/** The text area to hold the link label.*/
private UITextArea txtLabel = null;
/** The layout manager used for this dialog.*/
private GridBagLayout gb = null;
/** The constaints used with the layout manager.*/
private GridBagConstraints gc = null;
/** The tree displaying the link groups and types.*/
private JTree oLinkTypeTree = null;
/** The tree model to hold the data for the link groups.*/
private DefaultTreeModel treeModel = null;
/** The currently selected link type.*/
private String sLinkTypeId = ""; //$NON-NLS-1$
/** Displays the link type chosen to assign the the link/links.*/
private JTextField tfLinkType = null;
/** The last UILinkType object selected from the tree.*/
private UILinkType oLinkType = null;
/** The parent dialog of this panel.*/
private UILinkContentDialog oParentDialog = null;
/**
* Constructor.
* @param uilink com.compendium.ui.UILink, the link to assign settings to.
* @param oParent, the parent dialog for this panel.
*/
public UILinkEditPanel(UILink uilink, UILinkContentDialog oParent) {
oUILink = uilink;
oLink = uilink.getLink();
oLinkProperties = uilink.getLinkProperties();
sLinkType = oLink.getType();
this.oParentDialog = oParent;
draw();
}
/**
* Set the top tree node for the link groups and their link types.
*/
public static void setLinkTypeTopTreeNode(DefaultMutableTreeNode node) {
oLinkTypeTopTreeNode = node;
}
/**
* Return the top tree node for the link groups and their link types.
*/
public static DefaultMutableTreeNode getLinkTypeTopTreeNode() {
return oLinkTypeTopTreeNode;
}
/**
* Draw the panel's contents.
*/
public void draw() {
JPanel centerpanel = new JPanel();
centerpanel.setBorder(new EmptyBorder(5,5,5,5));
gb = new GridBagLayout();
gc = new GridBagConstraints();
centerpanel.setLayout(gb);
gc.insets = new Insets(3,3,3,3);
gc.anchor = GridBagConstraints.WEST;
gc.weightx=1;
gc.weighty=1;
int y=0;
txtLabel = new UITextArea(30, 20);
if (oUILink != null) {
txtLabel.setFont(oUILink.getFromNode().getFont());
}
else {
txtLabel.setFont(ProjectCompendium.APP.currentDefaultFont);
}
txtLabel.setAutoscrolls(true);
txtLabel.addFocusListener( new FocusListener() {
public void focusGained(FocusEvent e) {
txtLabel.setCaretPosition(txtLabel.getCaretPosition());
}
public void focusLost(FocusEvent e) {}
});
JScrollPane scrollpane2 = new JScrollPane(txtLabel);
scrollpane2.setPreferredSize(new Dimension(300,50));
gc.gridy = y;
y++;
gc.gridx = 0;
gc.gridwidth=2;
gb.setConstraints(scrollpane2, gc);
centerpanel.add(scrollpane2);
//Link Types
JLabel label = new JLabel(LanguageProperties.getString(LanguageProperties.PANELS_BUNDLE, "UILinkEditPanel.linkTypeSelected"), SwingConstants.LEFT); //$NON-NLS-1$
gc.gridy = y;
gc.gridx = 0;
gc.gridwidth = 1;
gb.setConstraints(label, gc);
centerpanel.add(label);
tfLinkType = new JTextField(""); //$NON-NLS-1$
tfLinkType.setFont(new Font("ARIAL", Font.PLAIN, 12)); //$NON-NLS-1$
tfLinkType.setColumns(17);
tfLinkType.setEditable(false);
gc.gridy = y;
gc.gridx = 1;
gc.gridwidth = 1;
y++;
gb.setConstraints(tfLinkType, gc);
centerpanel.add(tfLinkType);
JPanel oLinkTypeTreePanel = createLinkTypeTreePanel();
gc.gridy = y;
gc.gridx = 0;
gc.gridwidth = 2;
y++;
gb.setConstraints(oLinkTypeTreePanel, gc);
centerpanel.add(oLinkTypeTreePanel);
setLayout(new BorderLayout());
add(centerpanel, BorderLayout.CENTER);
add(createButtonPanel(), BorderLayout.SOUTH);
setLink(oLinkProperties);
}
/**
* Create and return the button panel.
*/
private UIButtonPanel createButtonPanel() {
UIButtonPanel oButtonPanel = new UIButtonPanel();
pbUpdate = new UIButton(LanguageProperties.getString(LanguageProperties.PANELS_BUNDLE, "UILinkEditPanel.updateButton")); //$NON-NLS-1$
pbUpdate.setMnemonic(LanguageProperties.getString(LanguageProperties.PANELS_BUNDLE, "UILinkEditPanel.updateButtonMnemonic").charAt(0));
pbUpdate.addActionListener(this);
pbUpdate.setEnabled(true);
oButtonPanel.addButton(pbUpdate);
pbCancel = new UIButton(LanguageProperties.getString(LanguageProperties.PANELS_BUNDLE, "UILinkEditPanel.cancelButton")); //$NON-NLS-1$
pbCancel.setMnemonic(LanguageProperties.getString(LanguageProperties.PANELS_BUNDLE, "UILinkEditPanel.cancelButtonMnemonic").charAt(0));
pbCancel.addActionListener(this);
oButtonPanel.addButton(pbCancel);
pbHelp = new UIButton(LanguageProperties.getString(LanguageProperties.PANELS_BUNDLE, "UILinkEditPanel.helpButton")); //$NON-NLS-1$
pbHelp.setMnemonic(LanguageProperties.getString(LanguageProperties.PANELS_BUNDLE, "UILinkEditPanel.helpButtonMnemonic").charAt(0));
ProjectCompendium.APP.mainHB.enableHelpOnButton(pbHelp, "node.links-editing", ProjectCompendium.APP.mainHS); //$NON-NLS-1$
oButtonPanel.addHelpButton(pbHelp);
return oButtonPanel;
}
/**
* Set the default button for the parent dialog to be this panel's default button.
*/
public void setDefaultButton() {
oParentDialog.getRootPane().setDefaultButton(pbUpdate);
}
/**
* Create the panel with the link group tree.
*/
private JPanel createLinkTypeTreePanel(){
JPanel panel = new JPanel(new BorderLayout());
oLinkTypeTree = new JTree();
treeModel = new DefaultTreeModel(getLinkTypeTopTreeNode());
//the following line unregister Key event from origianl code - it registers ret key
oLinkTypeTree.unregisterKeyboardAction(KeyStroke.getKeyStroke(KeyEvent.VK_ENTER, 0));
oLinkTypeTree.getSelectionModel().setSelectionMode(TreeSelectionModel.SINGLE_TREE_SELECTION);
oLinkTypeTree.setBorder(new EmptyBorder(2, 2, 0, 0));
oLinkTypeTree.setRootVisible(false);
oLinkTypeTree.setModel(treeModel);
oLinkTypeTree.setCellRenderer(createTreeRenderer());
MouseListener ml = new MouseAdapter() {
public void mousePressed(MouseEvent e) {
TreePath path = oLinkTypeTree.getPathForLocation(e.getX(), e.getY());
if (path != null) {
DefaultMutableTreeNode thenode = (DefaultMutableTreeNode)path.getLastPathComponent();
if (thenode.isLeaf()) {
UILinkType temp = (UILinkType) thenode.getUserObject();
oLinkType = temp;
sLinkTypeId = temp.getID();
tfLinkType.setText(temp.getName());
}
}
}
};
oLinkTypeTree.addMouseListener(ml);
ActionListener selectAction = new ActionListener() {
public void actionPerformed(ActionEvent e) {
TreePath path = oLinkTypeTree.getSelectionPath();
if (path != null) {
DefaultMutableTreeNode thenode = (DefaultMutableTreeNode) path.getLastPathComponent();
if (thenode.isLeaf()) {
UILinkType temp = (UILinkType) thenode.getUserObject();
oLinkType = temp;
sLinkTypeId = temp.getID();
tfLinkType.setText(temp.getName());
if (oUILink != null) {
UILinkType oldType = ProjectCompendium.APP.oLinkGroupManager.getLinkType(oUILink.getLinkType());
if (oldType != null && !(oldType.getLabel()).equals(txtLabel.getText()) )
txtLabel.setText(temp.getLabel());
}
}
}
}
};
oLinkTypeTree.registerKeyboardAction(selectAction,
KeyStroke.getKeyStroke(KeyEvent.VK_ENTER, 0),
oLinkTypeTree.WHEN_FOCUSED );
JScrollPane scrollPane = new JScrollPane(oLinkTypeTree);
scrollPane.setPreferredSize(new Dimension(300, 150));
panel.add(scrollPane, BorderLayout.CENTER);
return panel;
}
// CREATE AND RETURN A TREE RENDERER //
private TreeCellRenderer createTreeRenderer() {
return new LinkTypeTreeRenderer();
}
// RENDERS THE TREE //
private class LinkTypeTreeRenderer extends JLabel implements TreeCellRenderer {
private Icon leafIcon = null;
private Icon openIcon = null;
private Icon closedIcon = null;
//retrive color scheme from list used in tree selection bg/fg colors
private Color oSelectedBG = null;
private Color oSelectedFG = null;
public LinkTypeTreeRenderer() {
setOpaque(true);
// GET ICONS
DefaultTreeCellRenderer check = new DefaultTreeCellRenderer();
oSelectedBG = check.getBackgroundSelectionColor();
oSelectedFG = check.getTextSelectionColor();
leafIcon = check.getLeafIcon();
openIcon = check.getOpenIcon();
closedIcon = check.getClosedIcon();
}
public Component getTreeCellRendererComponent(JTree tree,
Object value,
boolean selected,
boolean expanded,
boolean leaf,
int row,
boolean hasFocus) {
DefaultMutableTreeNode node = (DefaultMutableTreeNode)value;
String text = ""; //$NON-NLS-1$
if(selected) {
setBackground(oSelectedBG);
setForeground(oSelectedFG);
}
else {
setBackground(tree.getBackground());
setForeground(tree.getForeground());
}
Font font = getFont();
if (node.getUserObject() instanceof UILinkGroup) {
UILinkGroup group = (UILinkGroup)node.getUserObject();
text = group.getName();
}
else if (node.getUserObject() instanceof UILinkType) {
UILinkType type = (UILinkType)node.getUserObject();
text = type.getName();
if (!selected)
setForeground(type.getColour());
}
// YOU CAN'T SELECT A GROUP HEADING!
if (!leaf) {
selected = false;
tree.removeSelectionRow(row);
}
Icon icon = null;
if (leaf)
icon = leafIcon;
else if (expanded)
icon = openIcon;
else
icon = closedIcon;
setIcon(icon);
setText(text);
return this;
}
}
/**
* Initalize the dialog based on the given link settings.
* @param linkProps the link whose setting to initialize for.
*/
public void setLink(LinkProperties linkProps) {
if (linkProps != null) {
oLink = linkProps.getLink();
try {
txtLabel.setText(oLink.getLabel());
if (!sLinkType.equals("")) { //$NON-NLS-1$
tfLinkType.setText(UILink.getLinkTypeLabel(sLinkType) );
TreePath path = searchTree(sLinkType);
if (path != null){
DefaultMutableTreeNode thenode = (DefaultMutableTreeNode)path.getLastPathComponent();
oLinkTypeTree.expandPath(path);
oLinkTypeTree.setSelectionPath(path);
}
}
}
catch (Exception e) {
ProjectCompendium.APP.displayError("Exception in 'UILinkEditPanel.setLink'"+e.getMessage()); //$NON-NLS-1$
}
}
}
/**
* Search the link type tree for the link type with the given id
* @param sType, the id of the link type to find.
*/
private TreePath searchTree(String sType) {
TreePath path = null;
for (Enumeration e = oLinkTypeTopTreeNode.preorderEnumeration(); e.hasMoreElements();) {
DefaultMutableTreeNode bob = (DefaultMutableTreeNode)e.nextElement();
if (bob.isLeaf()){
UILinkType type = (UILinkType)bob.getUserObject();
if ((type.getID()).equals(sType)) {
path = new TreePath(bob.getPath());
break;
}
}
}
return path;
}
/**
* Process button pushes.
* @param evt, the associated ActionEvent object.
*/
public void actionPerformed(ActionEvent evt) {
Object source = evt.getSource();
if (source == pbCancel) {
oParentDialog.onCancel();
}
else if (source == pbUpdate) {
onUpdate();
}
}
/**
* Handle the update action.
*/
private void onUpdate() {
// ADD IN CHANGING LINK TYPE
//if (links != null )
// processLinkTypes( sLinkTypeId );
//else if (oUILink != null) {
if (!sLinkTypeId.equals(sLinkType)) {
oUILink.setLinkType( sLinkTypeId );
}
//}
// ADD IN CHANGING LINK LABEL
//if (links != null )
// processLabel( (txtLabel.getText()).trim() );
//else if (oUILink != null) {
if (oLinkType != null && txtLabel.getText().equals("")) { //$NON-NLS-1$
oUILink.setText( oLinkType.getLabel() );
}
else
oUILink.setText( (txtLabel.getText()).trim() );
//}
oParentDialog.onCancel();
}
/**
* Add the new link type setting to all selected links.
* @param type, the new link type setting.
*/
private void processLinkTypes(String type) {
/*while (links != null && links.hasMoreElements()) {
UILink link = (UILink) links.nextElement();
link.setLinkType( type );
}*/
}
/**
* Add the new label to all selected links.
* @param sLabel, the new label text to add.
*/
private void processLabel(String sLabel) {
/*while (links != null && links.hasMoreElements()) {
UILink link = (UILink) links.nextElement();
if (oLinkType != null && sLabel.equals("")) {
link.setText( oLinkType.getLabel() );
}
else
link.setText( sLabel );
}*/
}
}