KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > java > awt > datatransfer > FlavorListener


1 /*
2  * @(#)FlavorListener.java 1.3 03/12/19
3  *
4  * Copyright 2004 Sun Microsystems, Inc. All rights reserved.
5  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
6  */
7 package java.awt.datatransfer;
8
9 import java.util.EventListener JavaDoc;
10
11
12 /**
13  * Defines an object which listens for {@link FlavorEvent}s.
14  *
15  * @version 1.3 12/19/03
16  * @author Alexander Gerasimov
17  * @since 1.5
18  */
19 public interface FlavorListener extends EventListener JavaDoc {
20     /**
21      * Invoked when the target {@link Clipboard} of the listener
22      * has changed its available {@link DataFlavor}s.
23      * <p>
24      * Some notifications may be redundant &#151; they are not
25      * caused by a change of the set of DataFlavors available
26      * on the clipboard.
27      * For example, if the clipboard subsystem supposes that
28      * the system clipboard's contents has been changed but it
29      * can't ascertain whether its DataFlavors have been changed
30      * because of some exceptional condition when accessing the
31      * clipboard, the notification is sent to ensure from omitting
32      * a significant notification. Ordinarily, those redundant
33      * notifications should be occasional.
34      *
35      * @param e a <code>FlavorEvent</code> object
36      */
37     void flavorsChanged(FlavorEvent JavaDoc e);
38 }
39
Popular Tags