/*
 * Copyright (c) 1997, 2013, 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.event;

import java.util.EventObject;


Defines an event that encapsulates changes to a list.

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 XMLEncoder.

Author:Hans Muller
/** * Defines an event that encapsulates changes to a list. * <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&trade; * has been added to the <code>java.beans</code> package. * Please see {@link java.beans.XMLEncoder}. * * @author Hans Muller */
@SuppressWarnings("serial") public class ListDataEvent extends EventObject {
Identifies one or more changes in the lists contents.
/** Identifies one or more changes in the lists contents. */
public static final int CONTENTS_CHANGED = 0;
Identifies the addition of one or more contiguous items to the list
/** Identifies the addition of one or more contiguous items to the list */
public static final int INTERVAL_ADDED = 1;
Identifies the removal of one or more contiguous items from the list
/** Identifies the removal of one or more contiguous items from the list */
public static final int INTERVAL_REMOVED = 2; private int type; private int index0; private int index1;
Returns the event type. The possible values are:
Returns:an int representing the type value
/** * Returns the event type. The possible values are: * <ul> * <li> {@link #CONTENTS_CHANGED} * <li> {@link #INTERVAL_ADDED} * <li> {@link #INTERVAL_REMOVED} * </ul> * * @return an int representing the type value */
public int getType() { return type; }
Returns the lower index of the range. For a single element, this value is the same as that returned by getIndex1.
Returns:an int representing the lower index value
/** * Returns the lower index of the range. For a single * element, this value is the same as that returned by {@link #getIndex1}. * * @return an int representing the lower index value */
public int getIndex0() { return index0; }
Returns the upper index of the range. For a single element, this value is the same as that returned by getIndex0.
Returns:an int representing the upper index value
/** * Returns the upper index of the range. For a single * element, this value is the same as that returned by {@link #getIndex0}. * * @return an int representing the upper index value */
public int getIndex1() { return index1; }
Constructs a ListDataEvent object. If index0 is > index1, index0 and index1 will be swapped such that index0 will always be <= index1.
Params:
/** * Constructs a ListDataEvent object. If index0 is &gt; * index1, index0 and index1 will be swapped such that * index0 will always be &lt;= index1. * * @param source the source Object (typically <code>this</code>) * @param type an int specifying {@link #CONTENTS_CHANGED}, * {@link #INTERVAL_ADDED}, or {@link #INTERVAL_REMOVED} * @param index0 one end of the new interval * @param index1 the other end of the new interval */
public ListDataEvent(Object source, int type, int index0, int index1) { super(source); this.type = type; this.index0 = Math.min(index0, index1); this.index1 = Math.max(index0, index1); }
Returns a string representation of this ListDataEvent. This method is intended to be used only for debugging purposes, and the content and format of the returned string may vary between implementations. The returned string may be empty but may not be null.
Since:1.4
Returns: a string representation of this ListDataEvent.
/** * Returns a string representation of this ListDataEvent. This method * is intended to be used only for debugging purposes, and the * content and format of the returned string may vary between * implementations. The returned string may be empty but may not * be <code>null</code>. * * @since 1.4 * @return a string representation of this ListDataEvent. */
public String toString() { return getClass().getName() + "[type=" + type + ",index0=" + index0 + ",index1=" + index1 + "]"; } }