01: /*
02: * Copyright 2000,2005 wingS development team.
03: *
04: * This file is part of wingS (http://wingsframework.org).
05: *
06: * wingS is free software; you can redistribute it and/or modify
07: * it under the terms of the GNU Lesser General Public License
08: * as published by the Free Software Foundation; either version 2.1
09: * of the License, or (at your option) any later version.
10: *
11: * Please see COPYING for the complete licence.
12: */
13: package org.wings.event;
14:
15: /**
16: * The listener interface for receiving component events.
17: * The class that is interested in processing a component event
18: * either implements this interface (and all the methods it
19: * contains) or extends the abstract ComponentAdapter class
20: * (overriding only the methods of interest).
21: * The listener object created from that class is then registered with a
22: * component using the component's addComponentListener method. When the
23: * component's size, location, or visibility
24: * changes, the relevant method in the listener object is invoked,
25: * and the ComponentEvent is passed to it.
26: * <p/>
27: * Component events are provided for notification purposes ONLY;
28: * WingS will automatically handle component moves and resizes
29: * internally so that GUI layout works properly regardless of
30: * whether a program registers a ComponentListener or not.
31: *
32: * @author <a href="mailto:andre@lison.de">Andre Lison</a>
33: * @see org.wings.event.SComponentAdapter
34: * @see org.wings.event.SComponentEvent
35: */
36: public interface SComponentListener extends java.util.EventListener {
37: /**
38: * Invoked when the component has been made invisible.
39: */
40: void componentHidden(SComponentEvent e);
41:
42: /**
43: * Invoked when the component's position changes.
44: */
45: void componentMoved(SComponentEvent e);
46:
47: /**
48: * Invoked when the component's size changes.
49: */
50: void componentResized(SComponentEvent e);
51:
52: /**
53: * Invoked when the component has been made visible.
54: */
55: void componentShown(SComponentEvent e);
56: }
|