home *** CD-ROM | disk | FTP | other *** search
/ Java Developer's Companion / Java Developer's Companion.iso / documentation / tutorial / example / LinkArea.java < prev    next >
Encoding:
Java Source  |  1997-07-13  |  3.7 KB  |  111 lines
  1. /*
  2.  * Copyright (c) 1995-1997 Sun Microsystems, Inc. All Rights Reserved.
  3.  *
  4.  * Permission to use, copy, modify, and distribute this software
  5.  * and its documentation for NON-COMMERCIAL purposes and without
  6.  * fee is hereby granted provided that this copyright notice
  7.  * appears in all copies. Please refer to the file "copyright.html"
  8.  * for further important copyright and licensing information.
  9.  *
  10.  * SUN MAKES NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY OF
  11.  * THE SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
  12.  * TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
  13.  * PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SUN SHALL NOT BE LIABLE FOR
  14.  * ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
  15.  * DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES.
  16.  */
  17. /*
  18.  * @(#)LinkArea.java    1.3 95/10/13  
  19.  *
  20.  * Copyright (c) 1994-1995 Sun Microsystems, Inc. All Rights Reserved.
  21.  *
  22.  * Permission to use, copy, modify, and distribute this software
  23.  * and its documentation for NON-COMMERCIAL or COMMERCIAL purposes and
  24.  * without fee is hereby granted. 
  25.  * Please refer to the file http://java.sun.com/copy_trademarks.html
  26.  * for further important copyright and trademark information and to
  27.  * http://java.sun.com/licensing.html for further important licensing
  28.  * information for the Java (tm) Technology.
  29.  * 
  30.  * SUN MAKES NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY OF
  31.  * THE SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
  32.  * TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
  33.  * PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SUN SHALL NOT BE LIABLE FOR
  34.  * ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
  35.  * DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES.
  36.  * 
  37.  * THIS SOFTWARE IS NOT DESIGNED OR INTENDED FOR USE OR RESALE AS ON-LINE
  38.  * CONTROL EQUIPMENT IN HAZARDOUS ENVIRONMENTS REQUIRING FAIL-SAFE
  39.  * PERFORMANCE, SUCH AS IN THE OPERATION OF NUCLEAR FACILITIES, AIRCRAFT
  40.  * NAVIGATION OR COMMUNICATION SYSTEMS, AIR TRAFFIC CONTROL, DIRECT LIFE
  41.  * SUPPORT MACHINES, OR WEAPONS SYSTEMS, IN WHICH THE FAILURE OF THE
  42.  * SOFTWARE COULD LEAD DIRECTLY TO DEATH, PERSONAL INJURY, OR SEVERE
  43.  * PHYSICAL OR ENVIRONMENTAL DAMAGE ("HIGH RISK ACTIVITIES").  SUN
  44.  * SPECIFICALLY DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY OF FITNESS FOR
  45.  * HIGH RISK ACTIVITIES.
  46.  */
  47.  
  48. import java.awt.Graphics;
  49. import java.net.URL;
  50. import java.net.MalformedURLException;
  51.  
  52. /**
  53.  * The classic "Fetch a URL" ImageArea class.
  54.  * This class extends the basic ImageArea Class to fetch a URL when
  55.  * the user clicks in the area.
  56.  *
  57.  * @author     Jim Graham
  58.  * @version     1.3, 13 Oct 1995
  59.  */
  60. class LinkArea extends ImageMapArea {
  61.     /** The URL to be fetched when the user clicks on this area. */
  62.     URL anchor;
  63.  
  64.     /**
  65.      * The argument string is the URL to be fetched.
  66.      */
  67.     public void handleArg(String arg) {
  68.     try {
  69.         anchor = new URL(parent.getDocumentBase(), arg);
  70.     } catch (MalformedURLException e) {
  71.         anchor = null;
  72.     }
  73.     }
  74.  
  75.     /**
  76.      * The isTerminal method indicates whether events should propagate
  77.      * to the areas underlying this one.
  78.      */
  79.     public boolean isTerminal() {
  80.     return true;
  81.     }
  82.  
  83.     /**
  84.      * The status message area is updated to show the destination URL.
  85.      */
  86.     public boolean enter() {
  87.     showStatus((anchor != null)
  88.            ? "Go To " + anchor.toExternalForm()
  89.            : null);
  90.     return true;
  91.     }
  92.  
  93.     /**
  94.      * The status message area is updated to show the destination URL.
  95.      */
  96.     public void exit() {
  97.     showStatus(null);
  98.     }
  99.  
  100.     /**
  101.      * The new URL is fetched when the user releases the mouse button
  102.      * only if they are still in the area.
  103.      */
  104.     public boolean lift(int x, int y) {
  105.     if (inside(x, y) && anchor != null) {
  106.         showDocument(anchor);
  107.     }
  108.     return true;
  109.     }
  110. }
  111.