KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > ClickArea


1 /*
2  * @(#)ClickArea.java 1.16 06/02/22
3  *
4  * Copyright (c) 2006 Sun Microsystems, Inc. All Rights Reserved.
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions are met:
8  *
9  * -Redistribution of source code must retain the above copyright notice, this
10  * list of conditions and the following disclaimer.
11  *
12  * -Redistribution in binary form must reproduce the above copyright notice,
13  * this list of conditions and the following disclaimer in the documentation
14  * and/or other materials provided with the distribution.
15  *
16  * Neither the name of Sun Microsystems, Inc. or the names of contributors may
17  * be used to endorse or promote products derived from this software without
18  * specific prior written permission.
19  *
20  * This software is provided "AS IS," without a warranty of any kind. ALL
21  * EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING
22  * ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
23  * OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN MICROSYSTEMS, INC. ("SUN")
24  * AND ITS LICENSORS SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE
25  * AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS
26  * DERIVATIVES. IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR ANY LOST
27  * REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL,
28  * INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY
29  * OF LIABILITY, ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE,
30  * EVEN IF SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
31  *
32  * You acknowledge that this software is not designed, licensed or intended
33  * for use in the design, construction, operation or maintenance of any
34  * nuclear facility.
35  */
36
37 /*
38  * @(#)ClickArea.java 1.16 06/02/22
39  */
40
41 import java.awt.Graphics JavaDoc;
42
43 /**
44  * An click feedback ImageArea class.
45  * This class extends the basic ImageArea Class to show the locations
46  * of clicks in the image in the status message area. This utility
47  * ImageArea class is useful when setting up ImageMaps.
48  *
49  * @author Jim Graham
50  * @version 1.16, 02/22/06
51  */
52 class ClickArea extends ImageMapArea {
53     /** The X location of the last mouse press. */
54     int startx;
55     /** The Y location of the last mouse press. */
56     int starty;
57     /** A boolean to indicate whether we are currently being dragged. */
58     boolean dragging;
59
60     static String JavaDoc ptstr(int x, int y) {
61     return "("+x+", "+y+")";
62     }
63
64     /**
65      * When the user presses the mouse button, start showing coordinate
66      * feedback in the status message line.
67      */
68     public boolean press(int x, int y) {
69     showStatus("Clicked at "+ptstr(x, y));
70     startx = x;
71     starty = y;
72     dragging = true;
73     return false;
74     }
75
76     /**
77      * Update the coordinate feedback every time the user moves the mouse
78      * while he has the button pressed.
79      */
80     public boolean drag(int x, int y) {
81     showStatus("Rectangle from "+ptstr(startx, starty)
82            +" to "+ptstr(x, y)
83            +" is "+(x-startx)+"x"+(y-starty));
84     return false;
85     }
86
87     /**
88      * Update the coordinate feedback one last time when the user releases
89      * the mouse button.
90      */
91     public boolean lift(int x, int y) {
92     dragging = false;
93     return drag(x, y);
94     }
95
96     /**
97      * This utility method returns the status string this area wants to
98      * put into the status bar. If this area is currently animating
99      * a message, then that message takes precedence over any other area
100      * that a higher stacked area may want to display, otherwise the
101      * message from the higher stacked area takes precedence.
102      */
103     public String JavaDoc getStatus(String JavaDoc prevmsg) {
104     if (dragging) {
105         return (status != null) ? status : prevmsg;
106     } else {
107         return (prevmsg == null) ? status : prevmsg;
108     }
109     }
110 }
111
112
Popular Tags