/* * Copyright (c) 1997, 2014, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ package javax.swing; import javax.swing.event.*; import java.io.Serializable; import java.util.EventListener; /** * A generic implementation of SingleSelectionModel. *
* Warning:
* Serialized objects of this class will not be compatible with
* future Swing releases. The current serialization support is
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
* has been added to the java.beans
package.
* Please see {@link java.beans.XMLEncoder}.
*
* @author Dave Moore
* @since 1.2
*/
@SuppressWarnings("serial") // Same-version serialization only
public class DefaultSingleSelectionModel implements SingleSelectionModel,
Serializable {
/* Only one ModelChangeEvent is needed per model instance since the
* event's only (read-only) state is the source property. The source
* of events generated here is always "this".
*/
protected transient ChangeEvent changeEvent = null;
/** The collection of registered listeners */
protected EventListenerList listenerList = new EventListenerList();
private int index = -1;
// implements javax.swing.SingleSelectionModel
public int getSelectedIndex() {
return index;
}
// implements javax.swing.SingleSelectionModel
public void setSelectedIndex(int index) {
if (this.index != index) {
this.index = index;
fireStateChanged();
}
}
// implements javax.swing.SingleSelectionModel
public void clearSelection() {
setSelectedIndex(-1);
}
// implements javax.swing.SingleSelectionModel
public boolean isSelected() {
boolean ret = false;
if (getSelectedIndex() != -1) {
ret = true;
}
return ret;
}
/**
* Adds a ChangeListener
to the button.
*/
public void addChangeListener(ChangeListener l) {
listenerList.add(ChangeListener.class, l);
}
/**
* Removes a ChangeListener
from the button.
*/
public void removeChangeListener(ChangeListener l) {
listenerList.remove(ChangeListener.class, l);
}
/**
* Returns an array of all the change listeners
* registered on this DefaultSingleSelectionModel
.
*
* @return all of this model's ChangeListener
s
* or an empty
* array if no change listeners are currently registered
*
* @see #addChangeListener
* @see #removeChangeListener
*
* @since 1.4
*/
public ChangeListener[] getChangeListeners() {
return listenerList.getListeners(ChangeListener.class);
}
/**
* Notifies all listeners that have registered interest for
* notification on this event type. The event instance
* is created lazily.
* @see EventListenerList
*/
protected void fireStateChanged() {
// Guaranteed to return a non-null array
Object[] listeners = listenerList.getListenerList();
// Process the listeners last to first, notifying
// those that are interested in this event
for (int i = listeners.length-2; i>=0; i-=2) {
if (listeners[i]==ChangeListener.class) {
// Lazily create the event:
if (changeEvent == null)
changeEvent = new ChangeEvent(this);
((ChangeListener)listeners[i+1]).stateChanged(changeEvent);
}
}
}
/**
* Returns an array of all the objects currently registered as
* FooListener
s
* upon this model.
* FooListener
s
* are registered using the addFooListener
method.
*
* You can specify the listenerType
argument
* with a class literal, such as FooListener.class
.
* For example, you can query a DefaultSingleSelectionModel
* instance m
* for its change listeners
* with the following code:
*
*
ChangeListener[] cls = (ChangeListener[])(m.getListeners(ChangeListener.class));* * If no such listeners exist, * this method returns an empty array. * * @param listenerType the type of listeners requested; * this parameter should specify an interface * that descends from
java.util.EventListener
* @return an array of all objects registered as
* FooListener
s
* on this model,
* or an empty array if no such
* listeners have been added
* @exception ClassCastException if listenerType
doesn't
* specify a class or interface that implements
* java.util.EventListener
*
* @see #getChangeListeners
*
* @since 1.3
*/
public