View Javadoc
1   /*
2    * Copyright (c) 1997, 1998, Oracle and/or its affiliates. All rights reserved.
3    * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4    *
5    * This code is free software; you can redistribute it and/or modify it
6    * under the terms of the GNU General Public License version 2 only, as
7    * published by the Free Software Foundation.  Oracle designates this
8    * particular file as subject to the "Classpath" exception as provided
9    * by Oracle in the LICENSE file that accompanied this code.
10   *
11   * This code is distributed in the hope that it will be useful, but WITHOUT
12   * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13   * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
14   * version 2 for more details (a copy is included in the LICENSE file that
15   * accompanied this code).
16   *
17   * You should have received a copy of the GNU General Public License version
18   * 2 along with this work; if not, write to the Free Software Foundation,
19   * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20   *
21   * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22   * or visit www.oracle.com if you need additional information or have any
23   * questions.
24   */
25  package javax.swing.event;
26  
27  import java.awt.event.*;
28  import java.awt.*;
29  import java.util.*;
30  
31  import javax.swing.*;
32  
33  /**
34   * AncestorListener
35   *
36   * Interface to support notification when changes occur to a JComponent or one
37   * of its ancestors.  These include movement and when the component becomes
38   * visible or invisible, either by the setVisible() method or by being added
39   * or removed from the component hierarchy.
40   *
41   * @author Dave Moore
42   */
43  public interface AncestorListener extends EventListener {
44      /**
45       * Called when the source or one of its ancestors is made visible
46       * either by setVisible(true) being called or by its being
47       * added to the component hierarchy.  The method is only called
48       * if the source has actually become visible.  For this to be true
49       * all its parents must be visible and it must be in a hierarchy
50       * rooted at a Window
51       */
52      public void ancestorAdded(AncestorEvent event);
53  
54      /**
55       * Called when the source or one of its ancestors is made invisible
56       * either by setVisible(false) being called or by its being
57       * remove from the component hierarchy.  The method is only called
58       * if the source has actually become invisible.  For this to be true
59       * at least one of its parents must by invisible or it is not in
60       * a hierarchy rooted at a Window
61       */
62      public void ancestorRemoved(AncestorEvent event);
63  
64      /**
65       * Called when either the source or one of its ancestors is moved.
66       */
67      public void ancestorMoved(AncestorEvent event);
68  
69  }