X-Git-Url: http://git.nikiroo.be/?a=blobdiff_plain;f=src%2Fbe%2Fnikiroo%2Futils%2Fui%2FUIUtils.java;h=ce7bcc1e866ff1ca7ec31ae35a11a0be94924a37;hb=0ff6a0aa1ec0a37d3fa0fbc4f76b9629fb2fd7ef;hp=91a1f61b4b1bb02f7646c8f9910fb6b0140feeb7;hpb=727b9fb39d3386f14f66a33de80de04f1f58734c;p=nikiroo-utils.git

diff --git a/src/be/nikiroo/utils/ui/UIUtils.java b/src/be/nikiroo/utils/ui/UIUtils.java
index 91a1f61..ce7bcc1 100644
--- a/src/be/nikiroo/utils/ui/UIUtils.java
+++ b/src/be/nikiroo/utils/ui/UIUtils.java
@@ -1,15 +1,30 @@
 package be.nikiroo.utils.ui;
 
 import java.awt.Color;
+import java.awt.Component;
+import java.awt.Desktop;
 import java.awt.GradientPaint;
 import java.awt.Graphics;
 import java.awt.Graphics2D;
 import java.awt.Paint;
 import java.awt.RadialGradientPaint;
 import java.awt.RenderingHints;
+import java.io.IOException;
+import java.net.URISyntaxException;
 
+import javax.swing.JButton;
+import javax.swing.JComponent;
+import javax.swing.JEditorPane;
+import javax.swing.JLabel;
+import javax.swing.JOptionPane;
+import javax.swing.JScrollPane;
 import javax.swing.UIManager;
 import javax.swing.UnsupportedLookAndFeelException;
+import javax.swing.event.HyperlinkEvent;
+import javax.swing.event.HyperlinkListener;
+
+import be.nikiroo.utils.Version;
+import be.nikiroo.utils.VersionCheck;
 
 /**
  * Some Java Swing utilities.
@@ -17,27 +32,51 @@ import javax.swing.UnsupportedLookAndFeelException;
  * @author niki
  */
 public class UIUtils {
+	static private Color buttonNormal;
+	static private Color buttonPressed;
+	
 	/**
-	 * Set a fake "native look & feel" for the application if possible
+	 * Set a fake "native Look & Feel" for the application if possible
 	 * (check for the one currently in use, then try GTK).
 	 * <p>
 	 * <b>Must</b> be called prior to any GUI work.
+	 * 
+	 * @return TRUE if it succeeded
 	 */
-	static public void setLookAndFeel() {
+	static public boolean setLookAndFeel() {
 		// native look & feel
+		String noLF = "javax.swing.plaf.metal.MetalLookAndFeel";
+		String lf = UIManager.getSystemLookAndFeelClassName();
+		if (lf.equals(noLF))
+			lf = "com.sun.java.swing.plaf.gtk.GTKLookAndFeel";
+		
+		return setLookAndFeel(lf);
+	}
+
+	/**
+	 * Switch to the given Look &amp; Feel for the application if possible
+	 * (check for the one currently in use, then try GTK).
+	 * <p>
+	 * <b>Must</b> be called prior to any GUI work.
+	 * 
+	 * @param laf
+	 *            the Look &amp; Feel to use
+	 * 
+	 * @return TRUE if it succeeded
+	 */
+	static public boolean setLookAndFeel(String laf) {
 		try {
-			String noLF = "javax.swing.plaf.metal.MetalLookAndFeel";
-			String lf = UIManager.getSystemLookAndFeelClassName();
-			if (lf.equals(noLF))
-				lf = "com.sun.java.swing.plaf.gtk.GTKLookAndFeel";
-			UIManager.setLookAndFeel(lf);
+			UIManager.setLookAndFeel(laf);
+			return true;
 		} catch (InstantiationException e) {
 		} catch (ClassNotFoundException e) {
 		} catch (UnsupportedLookAndFeelException e) {
 		} catch (IllegalAccessException e) {
 		}
+
+		return false;
 	}
-	
+
 	/**
 	 * Draw a 3D-looking ellipse at the given location, if the given
 	 * {@link Graphics} object is compatible (with {@link Graphics2D}); draw a
@@ -56,7 +95,8 @@ public class UIUtils {
 	 * @param height
 	 *            the height radius
 	 */
-	static public void drawEllipse3D(Graphics g, Color color, int x, int y, int width, int height) {
+	static public void drawEllipse3D(Graphics g, Color color, int x, int y,
+			int width, int height) {
 		drawEllipse3D(g, color, x, y, width, height, true);
 	}
 
@@ -70,15 +110,15 @@ public class UIUtils {
 	 * @param color
 	 *            the base colour
 	 * @param x
-	 *            the X coordinate
+	 *            the X coordinate of the upper left corner
 	 * @param y
-	 *            the Y coordinate
+	 *            the Y coordinate of the upper left corner
 	 * @param width
 	 *            the width radius
 	 * @param height
 	 *            the height radius
-     * @param fill
-     * 			  fill the content of the ellipse
+	 * @param fill
+	 *            fill the content of the ellipse
 	 */
 	static public void drawEllipse3D(Graphics g, Color color, int x, int y,
 			int width, int height, boolean fill) {
@@ -97,7 +137,7 @@ public class UIUtils {
 			} else {
 				g2.drawOval(x, y, width, height);
 			}
-			
+
 			// Compute dark/bright colours
 			Paint p = null;
 			Color dark = color.darker().darker();
@@ -125,7 +165,7 @@ public class UIUtils {
 			} else {
 				g2.drawOval(x, y, width, height);
 			}
-			
+
 			// Darken the edges
 			p = new RadialGradientPaint(x + width / 2f, y + height / 2f,
 					Math.min(width / 2f, height / 2f), new float[] { 0f, 1f },
@@ -162,4 +202,170 @@ public class UIUtils {
 			}
 		}
 	}
+
+	/**
+	 * Add a {@link JScrollPane} around the given panel and use a sensible (for
+	 * me) increment for the mouse wheel.
+	 * 
+	 * @param pane
+	 *            the panel to wrap in a {@link JScrollPane}
+	 * @param allowHorizontal
+	 *            allow horizontal scrolling (not always desired)
+	 * 
+	 * @return the {@link JScrollPane}
+	 */
+	static public JScrollPane scroll(JComponent pane, boolean allowHorizontal) {
+		return scroll(pane, allowHorizontal, true);
+	}
+
+	/**
+	 * Add a {@link JScrollPane} around the given panel and use a sensible (for
+	 * me) increment for the mouse wheel.
+	 * 
+	 * @param pane
+	 *            the panel to wrap in a {@link JScrollPane}
+	 * @param allowHorizontal
+	 *            allow horizontal scrolling (not always desired)
+	 * @param allowVertical
+	 *            allow vertical scrolling (usually yes, but sometimes you only
+	 *            want horizontal)
+	 * 
+	 * @return the {@link JScrollPane}
+	 */
+	static public JScrollPane scroll(JComponent pane, boolean allowHorizontal,
+			boolean allowVertical) {
+		JScrollPane scroll = new JScrollPane(pane);
+
+		scroll.getVerticalScrollBar().setUnitIncrement(16);
+		scroll.getHorizontalScrollBar().setUnitIncrement(16);
+
+		if (!allowHorizontal) {
+			scroll.setHorizontalScrollBarPolicy(
+					JScrollPane.HORIZONTAL_SCROLLBAR_NEVER);
+		}
+		if (!allowVertical) {
+			scroll.setVerticalScrollBarPolicy(
+					JScrollPane.VERTICAL_SCROLLBAR_NEVER);
+		}
+
+		return scroll;
+	}
+
+	/**
+	 * Show a confirmation message to the user to show him the changes since
+	 * last version.
+	 * <p>
+	 * HTML 3.2 supported, links included (the user browser will be launched if
+	 * possible).
+	 * <p>
+	 * If this is already the latest version, a message will still be displayed.
+	 * 
+	 * @param parentComponent
+	 *            determines the {@link java.awt.Frame} in which the dialog is
+	 *            displayed; if <code>null</code>, or if the
+	 *            <code>parentComponent</code> has no {@link java.awt.Frame}, a
+	 *            default {@link java.awt.Frame} is used
+	 * @param updates
+	 *            the new version
+	 * @param introText
+	 *            an introduction text before the list of changes
+	 * @param title
+	 *            the title of the dialog
+	 * 
+	 * @return TRUE if the user clicked on OK, false if the dialog was dismissed
+	 */
+	static public boolean showUpdatedDialog(Component parentComponent,
+			VersionCheck updates, String introText, String title) {
+		
+		StringBuilder builder = new StringBuilder();
+		final JEditorPane updateMessage = new JEditorPane("text/html", "");
+		if (introText != null && !introText.isEmpty()) {
+			builder.append(introText);
+			builder.append("<br>");
+			builder.append("<br>");
+		}
+		for (Version v : updates.getNewer()) {
+			builder.append("\t<b>" //
+					+ "Version " + v.toString() //
+					+ "</b>");
+			builder.append("<br>");
+			builder.append("<ul>");
+			for (String item : updates.getChanges().get(v)) {
+				builder.append("<li>" + item + "</li>");
+			}
+			builder.append("</ul>");
+		}
+
+		// html content
+		updateMessage.setText("<html><body>" //
+				+ builder//
+				+ "</body></html>");
+
+		// handle link events
+		updateMessage.addHyperlinkListener(new HyperlinkListener() {
+			@Override
+			public void hyperlinkUpdate(HyperlinkEvent e) {
+				if (e.getEventType().equals(HyperlinkEvent.EventType.ACTIVATED))
+					try {
+						Desktop.getDesktop().browse(e.getURL().toURI());
+					} catch (IOException ee) {
+						ee.printStackTrace();
+					} catch (URISyntaxException ee) {
+						ee.printStackTrace();
+					}
+			}
+		});
+		updateMessage.setEditable(false);
+		updateMessage.setBackground(new JLabel().getBackground());
+		updateMessage.addHyperlinkListener(new HyperlinkListener() {
+			@Override
+			public void hyperlinkUpdate(HyperlinkEvent evn) {
+				if (evn.getEventType() == HyperlinkEvent.EventType.ACTIVATED) {
+					if (Desktop.isDesktopSupported()) {
+						try {
+							Desktop.getDesktop().browse(evn.getURL().toURI());
+						} catch (IOException e) {
+						} catch (URISyntaxException e) {
+						}
+					}
+				}
+			}
+		});
+
+		return JOptionPane.showConfirmDialog(parentComponent, updateMessage,
+				title, JOptionPane.DEFAULT_OPTION) == JOptionPane.OK_OPTION;
+	}
+	
+	/**
+	 * Set the given {@link JButton} as "pressed" (selected, but with more UI
+	 * visibility).
+	 * <p>
+	 * The {@link JButton} will answer {@link JButton#isSelected()} if it is
+	 * pressed.
+	 * 
+	 * @param button
+	 *            the button to select/press
+	 * @param pressed
+	 *            the new "pressed" state
+	 */
+	static public void setButtonPressed(JButton button, boolean pressed) {
+		if (buttonNormal == null) {
+			JButton defButton = new JButton(" ");
+			buttonNormal = defButton.getBackground();
+			if (buttonNormal.getBlue() >= 128) {
+				buttonPressed = new Color( //
+						Math.max(buttonNormal.getRed() - 100, 0), //
+						Math.max(buttonNormal.getGreen() - 100, 0), //
+						Math.max(buttonNormal.getBlue() - 100, 0));
+			} else {
+				buttonPressed = new Color( //
+						Math.min(buttonNormal.getRed() + 100, 255), //
+						Math.min(buttonNormal.getGreen() + 100, 255), //
+						Math.min(buttonNormal.getBlue() + 100, 255));
+			}
+		}
+
+		button.setSelected(pressed);
+		button.setBackground(pressed ? buttonPressed : buttonNormal);
+	}
 }