1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106
/* * @(#)ListSelectionEvent.java 1.23 06/07/11 * * Copyright 2006 Sun Microsystems, Inc. All rights reserved. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. */ package javax.swing.event; import java.util.EventObject; import javax.swing.*; /** * An event that characterizes a change in selection. The change is limited to a * a single inclusive interval. The selection of at least one index within the * range will have changed. A decent {@code ListSelectionModel} implementation * will keep the range as small as possible. {@code ListSelectionListeners} will * generally query the source of the event for the new selected status of each * potentially changed row. * <p> * <strong>Warning:</strong> * 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<sup><font size="-2">TM</font></sup> * has been added to the <code>java.beans</code> package. * Please see {@link java.beans.XMLEncoder}. * * @version 1.23 07/11/06 * @author Hans Muller * @author Ray Ryan * @see ListSelectionModel */ public class ListSelectionEvent extends EventObject { private int firstIndex; private int lastIndex; private boolean isAdjusting; /** * Represents a change in selection status between {@code firstIndex} and * {@code lastIndex}, inclusive. {@code firstIndex} is less than or equal to * {@code lastIndex}. The selection of at least one index within the range will * have changed. * * @param firstIndex the first index in the range, <= lastIndex * @param lastIndex the last index in the range, >= firstIndex * @param isAdjusting whether or not this is one in a series of * multiple events, where changes are still being made */ public ListSelectionEvent(Object source, int firstIndex, int lastIndex, boolean isAdjusting) { super(source); this.firstIndex = firstIndex; this.lastIndex = lastIndex; this.isAdjusting = isAdjusting; } /** * Returns the index of the first row whose selection may have changed. * {@code getFirstIndex() <= getLastIndex()} * * @return the first row whose selection value may have changed, * where zero is the first row */ public int getFirstIndex() { return firstIndex; } /** * Returns the index of the last row whose selection may have changed. * {@code getLastIndex() >= getFirstIndex()} * * @return the last row whose selection value may have changed, * where zero is the first row */ public int getLastIndex() { return lastIndex; } /** * Returns whether or not this is one in a series of multiple events, * where changes are still being made. See the documentation for * {@link javax.swing.ListSelectionModel#setValueIsAdjusting} for * more details on how this is used. * * @return {@code true} if this is one in a series of multiple events, * where changes are still being made */ public boolean getValueIsAdjusting() { return isAdjusting; } /** * Returns a {@code String} that displays and identifies this * object's properties. * * @return a String representation of this object */ public String toString() { String properties = " source=" + getSource() + " firstIndex= " + firstIndex + " lastIndex= " + lastIndex + " isAdjusting= " + isAdjusting + " "; return getClass().getName() + "[" + properties + "]"; } }