1 |
/* ItemSelectable.java -- Items that can be selected |
/* ItemSelectable.java -- items that can be selected |
2 |
Copyright (C) 1999 Free Software Foundation, Inc. |
Copyright (C) 1999, 2002 Free Software Foundation, Inc. |
3 |
|
|
4 |
This file is part of GNU Classpath. |
This file is part of GNU Classpath. |
5 |
|
|
41 |
import java.awt.event.ItemListener; |
import java.awt.event.ItemListener; |
42 |
|
|
43 |
/** |
/** |
44 |
* This interface is for objects that can have one or more items |
* This interface is for objects that can have one or more items selected. |
45 |
* selected. For example, radio buttons. |
* For example, radio buttons. |
46 |
* |
* |
47 |
* @author Aaron M. Renn (arenn@urbanophile.com) |
* @author Aaron M. Renn <arenn@urbanophile.com> |
48 |
*/ |
* @since 1.0 |
49 |
|
* @status updated to 1.4 |
50 |
|
*/ |
51 |
public interface ItemSelectable |
public interface ItemSelectable |
52 |
{ |
{ |
53 |
|
/** |
54 |
/** |
* Returns the list of objects that are selected in this component. |
55 |
* Returns the list of objects that are selected in this component. |
* |
56 |
* |
* @return the list of selected objects, or null |
57 |
* @return The list of objects that are selected, or <code>null</code> if |
*/ |
58 |
* no objects are selected. |
Object[] getSelectedObjects(); |
59 |
*/ |
|
60 |
public abstract Object[] |
/** |
61 |
getSelectedObjects(); |
* Adds an item listener to this object. It will receive selection events |
62 |
|
* for this object by the user (but not programatically). If listener is |
63 |
/*************************************************************************/ |
* null, it is ignored. |
64 |
|
* |
65 |
/** |
* @param listener the item listener to add |
66 |
* Adds an item listener to this object. It will receive |
*/ |
67 |
* selection events for this object. |
void addItemListener(ItemListener listener); |
68 |
* |
|
69 |
* @param listener The item listener to add. |
/** |
70 |
*/ |
* Removes an item listener from this object. |
71 |
public abstract void |
* |
72 |
addItemListener(ItemListener listener); |
* @param listener the item listener to remove |
73 |
|
*/ |
74 |
/*************************************************************************/ |
void removeItemListener(ItemListener listener); |
|
|
|
|
/** |
|
|
* Removes an item listener from this object. It will no longer receive |
|
|
* selection change events. |
|
|
* |
|
|
* @param listener The item listener to remove. |
|
|
*/ |
|
|
public abstract void |
|
|
removeItemListener(ItemListener listener); |
|
|
|
|
75 |
} // interface ItemSelectable |
} // interface ItemSelectable |
|
|
|