Class DefaultListSelectionModel

protected boolean leadAnchorNotificationEnabled

controls the range of indices provided in any ListSelectionEvent fired by the selectionModel. Let [A,L] be the range of indices between anchorSelectionIndex and leadSelectionIndex inclusive, and let [i0,i1] be the range of indices changed in a given call which generates a ListSelectionEvent. Then when this property is true, the ListSelectionEvent contains the range [A,L] union [i0,i1]; when false it will contain only [i0,i1]. The default is true.

See Also:

isLeadAnchorNotificationEnabled(), setLeadAnchorNotificationEnabled(boolean)

protected EventListenerList listenerList

The list of ListSelectionListeners subscribed to this selection model.

public void addListSelectionListener(ListSelectionListener listener)

Adds a listener.

Specified by:

addListSelectionListener in interface ListSelectionModel

Parameters:

listener - The listener to add

See Also:

removeListSelectionListener(ListSelectionListener), getListSelectionListeners()

public void addSelectionInterval(int index0,
                                 int index1)

If the selectionMode property is equal to SINGLE_SELECTION equivalent to calling setSelectionInterval(index1, index2); If the selectionMode property is equal to SINGLE_INTERVAL_SELECTION and the interval being added is not adjacent to an already selected interval, equivalent to setSelectionInterval(index1, index2). Otherwise adds the range [index0, index1] to the selection interval set.

Specified by:

addSelectionInterval in interface ListSelectionModel

Parameters:

index0 - The beginning of the range of indices to select

index1 - The end of the range of indices to select

See Also:

setSelectionInterval(int,int), removeSelectionInterval(int,int)

public void clearSelection()

Removes all intervals in the selection set.

Specified by:

clearSelection in interface ListSelectionModel

public Object clone()
            throws CloneNotSupportedException

Returns a clone of this object. listenerList don't gets duplicated.

Overrides:

clone in interface Object

Returns:

the cloned object

Throws:

CloneNotSupportedException - if an error occurs

public extends EventListener> T[] getListeners(Class listenerType)

Returns an array of all registerers listeners.

Parameters:

listenerType - The type of listener to retrieve

Returns:

The array

Since:

1.3

See Also:

getListSelectionListeners()

protected void fireValueChanged(boolean isAdjusting)

Fires a ListSelectionEvent to all the listeners of type ListSelectionListener registered with this selection model to indicate that a series of adjustment has just ended. The values of getMinSelectionIndex() and getMaxSelectionIndex() are used in the ListSelectionEvent that gets fired.

Parameters:

isAdjusting - true if this is the final change in a series of adjustments, false/code> otherwise

protected void fireValueChanged(int firstIndex,
                                int lastIndex)

Fires a ListSelectionEvent to all the listeners of type ListSelectionListener registered with this selection model.

Parameters:

firstIndex - The low index of the changed range

lastIndex - The high index of the changed range

protected void fireValueChanged(int firstIndex,
                                int lastIndex,
                                boolean isAdjusting)

Fires a ListSelectionEvent to all the listeners of type ListSelectionListener registered with this selection model.

Parameters:

firstIndex - The low index of the changed range

lastIndex - The high index of the changed range

isAdjusting - Whether this change is part of a seqence of adjustments made to the selection, such as during interactive scrolling

public int getAnchorSelectionIndex()

Gets the value of the anchorSelectionIndex property.

Specified by:

getAnchorSelectionIndex in interface ListSelectionModel

Returns:

The current property value

See Also:

setAnchorSelectionIndex(int)

public int getLeadSelectionIndex()

Gets the value of the leadSelectionIndex property.

Specified by:

getLeadSelectionIndex in interface ListSelectionModel

Returns:

The current property value

See Also:

setLeadSelectionIndex(int)

public ListSelectionListener[] getListSelectionListeners()

Returns an array of all registerd list selection listeners.

Returns:

the array

Since:

1.4

See Also:

addListSelectionListener(ListSelectionListener), removeListSelectionListener(ListSelectionListener), DefaultListSelectionModel

public int getMaxSelectionIndex()

Gets the largest index which is currently a member of a selection interval.

Specified by:

getMaxSelectionIndex in interface ListSelectionModel

Returns:

The greatest integer i such that i >= 0 and i is a member of a selected interval, or -1 if there are no selected intervals

See Also:

getMinSelectionIndex()

public int getMinSelectionIndex()

Gets the smallest index which is currently a member of a selection interval.

Specified by:

getMinSelectionIndex in interface ListSelectionModel

Returns:

The least integer i such that i >= 0 and i is a member of a selected interval, or -1 if there are no selected intervals

See Also:

getMaxSelectionIndex()

public int getSelectionMode()

Returns the selection mode, which is one of ListSelectionModel.SINGLE_SELECTION, ListSelectionModel.SINGLE_INTERVAL_SELECTION and ListSelectionModel.MULTIPLE_INTERVAL_SELECTION. The default value is ListSelectionModel.MULTIPLE_INTERVAL_SELECTION.

Specified by:

getSelectionMode in interface ListSelectionModel

Returns:

The selection mode.

See Also:

setSelectionMode(int)

public boolean getValueIsAdjusting()

Gets the value of the valueIsAdjusting property.

Specified by:

getValueIsAdjusting in interface ListSelectionModel

Returns:

The current property value

See Also:

setValueIsAdjusting(boolean)

public void insertIndexInterval(int index,
                                int length,
                                boolean before)

Inserts a number of indices either before or after a particular position in the set of indices. Renumbers all indices after the inserted range. The new indices in the inserted range are not selected. This method is typically called to synchronize the selection model with an inserted range of elements in a ListModel.

Specified by:

insertIndexInterval in interface ListSelectionModel

Parameters:

index - The position to insert indices at

length - The number of indices to insert

before - Indicates whether to insert the indices before the index or after it

public boolean isLeadAnchorNotificationEnabled()

Gets the value of the leadAnchorNotificationEnabled property.

Returns:

The current property value

See Also:

setLeadAnchorNotificationEnabled(boolean)

public boolean isSelectedIndex(int a)

Determines whether a particular index is a member of a selection interval.

Specified by:

isSelectedIndex in interface ListSelectionModel

Parameters:

a - The index to search for

Returns:

true if the index is a member of a selection interval, otherwise false

public boolean isSelectionEmpty()

Determines whether the selection is empty.

Specified by:

isSelectionEmpty in interface ListSelectionModel

Returns:

true if the selection is empty, otherwise false

public void moveLeadSelectionIndex(int leadIndex)

Moves the lead selection index to leadIndex without changing the selection values. If leadAnchorNotificationEnabled is true, send a notification covering the old and new lead cells.

Parameters:

leadIndex - the new lead selection index

Since:

1.5

public void removeIndexInterval(int index0,
                                int index1)

Removes a range from the set of indices. Renumbers all indices after the removed range. This method is typically called to synchronize the selection model with a deleted range of elements in a ListModel.

Specified by:

removeIndexInterval in interface ListSelectionModel

Parameters:

index0 - The first index to remove (inclusive)

index1 - The last index to remove (inclusive)

public void removeListSelectionListener(ListSelectionListener listener)

Removes a registered listener.

Specified by:

removeListSelectionListener in interface ListSelectionModel

Parameters:

listener - The listener to remove

See Also:

addListSelectionListener(ListSelectionListener), getListSelectionListeners()

public void removeSelectionInterval(int index0,
                                    int index1)

Deselects all indices in the inclusive range [index0,index1].

Specified by:

removeSelectionInterval in interface ListSelectionModel

Parameters:

index0 - The beginning of the range of indices to deselect

index1 - The end of the range of indices to deselect

See Also:

addSelectionInterval(int,int), setSelectionInterval(int,int)

public void setAnchorSelectionIndex(int index)

Sets the value of the anchorSelectionIndex property.

Specified by:

setAnchorSelectionIndex in interface ListSelectionModel

Parameters:

index - The new property value

See Also:

getAnchorSelectionIndex()

public void setLeadAnchorNotificationEnabled(boolean l)

Sets the value of the leadAnchorNotificationEnabled property.

Parameters:

l - The new property value

See Also:

isLeadAnchorNotificationEnabled()

public void setLeadSelectionIndex(int leadIndex)

Sets the value of the anchorSelectionIndex property. As a side effect, alters the selection status of two ranges of indices. Let OL be the old lead selection index, NL be the new lead selection index, and A be the anchor selection index. Then if A is a valid selection index, one of two things happens depending on the seleciton status of A:

• isSelectedIndex(A) == true: set [A,OL] to deselected, then set [A,NL] to selected.
• isSelectedIndex(A) == false: set [A,OL] to selected, then set [A,NL] to deselected.

This method generates at most a single ListSelectionEvent despite changing multiple ranges. The range of values provided to the ListSelectionEvent includes only the minimum range of values which changed selection status between the beginning and end of the method.

Specified by:

setLeadSelectionIndex in interface ListSelectionModel

Parameters:

leadIndex - The new property value

See Also:

getAnchorSelectionIndex()

public void setSelectionInterval(int anchor,
                                 int lead)

Clears the current selection and marks a given interval as "selected". If the current selection mode is SINGLE_SELECTION only the index index2 is selected.

Specified by:

setSelectionInterval in interface ListSelectionModel

Parameters:

anchor - the anchor selection index.

lead - the lead selection index.

public void setSelectionMode(int mode)

Sets the value of the selectionMode property.

Specified by:

setSelectionMode in interface ListSelectionModel

Parameters:

mode - The new value of the property

public void setValueIsAdjusting(boolean v)

Sets the value of the valueIsAdjusting property.

Specified by:

setValueIsAdjusting in interface ListSelectionModel

Parameters:

v - The new property value

See Also:

getValueIsAdjusting()