01 
02 /*
03  *  JScripter Standard 1.0 - To Script In Java
04  *  Copyright (C) 2008-2011  J.J.Liu<jianjunliu@126.com> <http://www.jscripter.org>
05  *  
06  *  This program is free software: you can redistribute it and/or modify
07  *  it under the terms of the GNU Affero General Public License as published by
08  *  the Free Software Foundation, either version 3 of the License, or
09  *  (at your option) any later version.
10  *  
11  *  This program is distributed in the hope that it will be useful,
12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  *  GNU Affero General Public License for more details.
15  *  
16  *  You should have received a copy of the GNU Affero General Public License
17  *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
18  */
19 
20 package jsx.ui.dd.event;
21 
22 import jsx.ui.Component;
23 import jsx.ui.event.Position;
24 
25 /**
26  * <p>A type of high level events that may be fired from a dragged widget when 
27  * the mouse is released.</p>
28  * 
29  * @author <a href="mailto:jianjunliu@126.com">J.J.Liu (Jianjun Liu)</a> at <a href="http://www.jscripter.org" target="_blank">http://www.jscripter.org</a>
30  */
31 public final class DragStop extends Position<OnDragStop>
32 {
33     /**
34      * <p>Constructs an event of this type.</p>
35      * <p>This constructor invokes the constructor of the superclass, which asks for the 
36      * same number of arguments as this one, passing all the arguments.</p>
37      * <p>Note that, this constructor does not change the configurable properties 
38      * {@link jsx.Source.Event#BUBBLE} and {@link jsx.Source.Event#UPDATE} of this event object.</p>
39      * @param target The component where the mouse has just been released from pressing. 
40      * It may be different from the source widget which is firing the event.
41      * @param x The X coordinate, in pixels,  of the mouse position.
42      * @param y The y coordinate, in pixels,  of the mouse position.
43      * @since 1.0
44      */
45     public DragStop(Component target, Number x, Number y) {
46         super(target, x, y);
47     }
48 
49     /**
50      * <p>Dispatches this event to the specified event listener to handle, by invoking the 
51      * handler method of the listener interface passing the event itself as the argument.</p>
52      * @param on The event listener that handles this event.
53      * @since 1.0
54      */
55     @Override
56     protected final void execute(OnDragStop on) {
57         on.onEvent(this);
58     }
59 }