Java tutorial
/* * Copyright (c) Ian F. Darwin, http://www.darwinsys.com/, 1996-2002. * All rights reserved. Software written by Ian F. Darwin and others. * $Id: LICENSE,v 1.8 2004/02/09 03:33:38 ian Exp $ * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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. * * Java, the Duke mascot, and all variants of Sun's Java "steaming coffee * cup" logo are trademarks of Sun Microsystems. Sun's, and James Gosling's, * pioneering role in inventing and promulgating (and standardizing) the Java * language and environment is gratefully acknowledged. * * The pioneering role of Dennis Ritchie and Bjarne Stroustrup, of AT&T, for * inventing predecessor languages C and C++ is also gratefully acknowledged. */ import java.awt.BorderLayout; import java.awt.Container; import java.awt.Cursor; import java.awt.event.WindowAdapter; import java.awt.event.WindowEvent; import java.io.File; import java.io.IOException; import java.net.MalformedURLException; import java.net.URL; import javax.swing.BorderFactory; import javax.swing.JEditorPane; import javax.swing.JFrame; import javax.swing.JScrollPane; import javax.swing.SwingUtilities; import javax.swing.event.HyperlinkEvent; import javax.swing.event.HyperlinkListener; import javax.swing.text.Document; /** * Simple Help Frame based on JFC JEditorPane. * <p> * May someday rewrite using JavaHelp API. * * @version $Id: SimpleHelp.java,v 1.10 2003/05/30 13:16:07 ian Exp $ */ public class SimpleHelp extends JFrame implements HyperlinkListener { /** The contentpane */ protected Container cp; /** The editorpane */ JEditorPane help; /* * Construct a Help object. Just construct a JEditorPane with a URL, and it * does all the help from there. */ public SimpleHelp(String windowName, String helpIndexFileName) { super(windowName + " Help Window"); cp = getContentPane(); getAccessibleContext().setAccessibleName(windowName + " Help Window"); getAccessibleContext().setAccessibleDescription( "A window for viewing the help for " + windowName + ", which is somewhat hyperlinked."); try { URL url = new File(helpIndexFileName).toURL(); // Only create the window once. if (help == null) { // System.out.println("Creat-ing help window for " + url); help = new JEditorPane(url); // System.out.println("Done!"); help.setEditable(false); help.addHyperlinkListener(this); JScrollPane scroller = new JScrollPane(); scroller.setBorder(BorderFactory.createTitledBorder(windowName + " Help")); scroller.getViewport().add(help); cp.add(BorderLayout.CENTER, scroller); addWindowListener(new WindowAdapter() { public void windowClosing(WindowEvent e) { SimpleHelp.this.setVisible(false); SimpleHelp.this.dispose(); } }); setSize(500, 400); } else { System.out.println("Re-using help window!"); } } catch (MalformedURLException e) { System.out.println("Malformed URL: " + e); } catch (IOException e) { System.out.println("IOException: " + e); } } /** * Notification of a change relative to a hyperlink. From: * java.swing.event.HyperlinkListener */ public void hyperlinkUpdate(HyperlinkEvent e) { if (e.getEventType() == HyperlinkEvent.EventType.ACTIVATED) { URL target = e.getURL(); // System.out.println("linkto: " + target); // Get the help panel's cursor and the wait cursor Cursor oldCursor = help.getCursor(); Cursor waitCursor = Cursor.getPredefinedCursor(Cursor.WAIT_CURSOR); help.setCursor(waitCursor); // Now arrange for the page to get loaded asynchronously, // and the cursor to be set back to what it was. SwingUtilities.invokeLater(new PageLoader(target, oldCursor)); } } /** * Inner class that loads a URL synchronously into the help panel. Loads it * later than the request so that a cursor change can be done at the very * end. * * @author BORROWED FROM SUN'S SWING DEMO, UNTIL JAVAHELP AVAILABLE */ class PageLoader implements Runnable { URL url; Cursor cursor; PageLoader(URL u, Cursor c) { url = u; cursor = c; } public void run() { // System.out.println("PageLoader: u=" + url); if (url == null) { // restore the original cursor help.setCursor(cursor); // PENDING(prinz) remove this hack when // automatic validation is activated. Container parent = help.getParent(); parent.repaint(); } else { Document doc = help.getDocument(); try { help.setPage(url); } catch (Exception ioe) { help.setDocument(doc); getToolkit().beep(); } finally { // schedule the cursor to revert after // the paint has happended. url = null; SwingUtilities.invokeLater(this); } } } } }