Spec-Zone .ru
спецификации, руководства, описания, API
|
public class DefaultListSelectionModel extends Object implements ListSelectionModel, Cloneable, Serializable
Предупреждение: Сериализированные объекты этого класса не будут совместимыми с будущими выпусками Swing. Текущая поддержка сериализации является подходящей для краткосрочного хранения или RMI между приложениями, выполняющими ту же самую версию Swing. С 1.4, поддержка длительного хранения всего JavaBeansTM была добавлена к java.beans
пакет. Пожалуйста, см. XMLEncoder
.
ListSelectionModel
Модификатор и Тип | Поле и Описание |
---|---|
protected boolean |
leadAnchorNotificationEnabled |
protected EventListenerList |
listenerList |
MULTIPLE_INTERVAL_SELECTION, SINGLE_INTERVAL_SELECTION, SINGLE_SELECTION
Конструктор и Описание |
---|
DefaultListSelectionModel() |
Модификатор и Тип | Метод и Описание |
---|---|
void |
addListSelectionListener(ListSelectionListener l)
Добавьте слушателя списка, это уведомило каждый раз, что изменение к выбору происходит.
|
void |
addSelectionInterval(int index0, int index1)
Изменяет выбор, чтобы быть объединением набора текущего выбора и индексов между
index0 и index1 включительно. |
void |
clearSelection()
Измените выбор на пустое множество.
|
Объект |
clone()
Возвращает клона этой модели выбора с тем же самым выбором.
|
protected void |
fireValueChanged(boolean isAdjusting)
Уведомляет слушателей, что мы закончили ряд корректировок.
|
protected void |
fireValueChanged(int firstIndex, int lastIndex)
Уведомляет
ListSelectionListeners то, что значение выбора, в закрытом интервале firstIndex , lastIndex , изменился. |
protected void |
fireValueChanged(int firstIndex, int lastIndex, boolean isAdjusting) |
int |
getAnchorSelectionIndex()
Возвратите первый индексный параметр от нового звонка setSelectionInterval (), addSelectionInterval () или removeSelectionInterval ().
|
int |
getLeadSelectionIndex()
Возвратите второй индексный параметр от нового звонка setSelectionInterval (), addSelectionInterval () или removeSelectionInterval ().
|
<T extends EventListener> |
getListeners(Class<T> listenerType)
Возвращает массив всех объектов, в настоящий момент зарегистрированных как
FooListener s на эту модель. |
ListSelectionListener[] |
getListSelectionListeners()
Возвращает массив всех слушателей выбора списка, зарегистрированных на этом
DefaultListSelectionModel . |
int |
getMaxSelectionIndex()
Возвращает последний выбранный индекс или-1, если выбор пуст.
|
int |
getMinSelectionIndex()
Возвращает первый выбранный индекс или-1, если выбор пуст.
|
int |
getSelectionMode()
Возвращает текущий режим выбора.
|
boolean |
getValueIsAdjusting()
Возвраты
true если выбор подвергается серии изменений. |
void |
insertIndexInterval(int index, int length, boolean before)
Вставьте индексы длины, начинающиеся перед/после того, как индексом.
|
boolean |
isLeadAnchorNotificationEnabled()
Возвращает значение
leadAnchorNotificationEnabled флаг. |
boolean |
isSelectedIndex(int index)
Возвращает true, если указанный индекс выбирается.
|
boolean |
isSelectionEmpty()
Возвращает true, если никакие индексы не выбираются.
|
void |
moveLeadSelectionIndex(int leadIndex)
Установите ведущий индекс выбора, оставляя все неизменные значения выбора.
|
void |
removeIndexInterval(int index0, int index1)
Удалите индексы в интервале index0, index1 (включительно) от модели выбора.
|
void |
removeListSelectionListener(ListSelectionListener l)
Удалите слушателя из списка, это уведомило каждый раз, что изменение к выбору происходит.
|
void |
removeSelectionInterval(int index0, int index1)
Изменяет выбор, чтобы быть разностью множеств текущего выбора и индексов между
index0 и index1 включительно. |
void |
setAnchorSelectionIndex(int anchorIndex)
Установите индекс выбора привязки, оставляя все неизменные значения выбора.
|
void |
setLeadAnchorNotificationEnabled(boolean flag)
Устанавливает значение флага leadAnchorNotificationEnabled.
|
void |
setLeadSelectionIndex(int leadIndex)
Устанавливает ведущий индекс выбора, гарантируя, что значения между привязкой и новым выводом или все выбираются или все невыбранные.
|
void |
setSelectionInterval(int index0, int index1)
Изменяет выбор, чтобы быть между
index0 и index1 включительно. |
void |
setSelectionMode(int selectionMode)
Устанавливает режим выбора.
|
void |
setValueIsAdjusting(boolean isAdjusting)
Наборы
valueIsAdjusting свойство, которое указывает, нужно ли предстоящие изменения выбора считать частью единственного изменения. |
Строка |
toString()
Возвращает строку, которая выводит на экран и идентифицирует свойства этого объекта.
|
protected EventListenerList listenerList
protected boolean leadAnchorNotificationEnabled
public int getMinSelectionIndex()
getMinSelectionIndex
в интерфейсе ListSelectionModel
public int getMaxSelectionIndex()
getMaxSelectionIndex
в интерфейсе ListSelectionModel
public boolean getValueIsAdjusting()
true
если выбор подвергается серии изменений.getValueIsAdjusting
в интерфейсе ListSelectionModel
ListSelectionModel.setValueIsAdjusting(boolean)
public int getSelectionMode()
getSelectionMode
в интерфейсе ListSelectionModel
ListSelectionModel.setSelectionMode(int)
public void setSelectionMode(int selectionMode)
ListSelectionModel.SINGLE_SELECTION
- Только один индекс списка может быть выбран за один раз. В этом режиме, setSelectionInterval
и addSelectionInterval
эквивалентны, обе замены текущего выбора с индексом, представленным вторым параметром ("вывод"). ListSelectionModel.SINGLE_INTERVAL_SELECTION
- Только один непрерывный интервал может быть выбран за один раз. В этом режиме, addSelectionInterval
ведет себя как setSelectionInterval
(замена текущего выбора), если данный интервал не сразу смежен с или перекрывает существующий выбор, и может поэтому использоваться, чтобы вырастить это. ListSelectionModel.MULTIPLE_INTERVAL_SELECTION
- В этом режиме нет никакого ограничения на то, что может быть выбрано. setSelectionMode
в интерфейсе ListSelectionModel
IllegalArgumentException
- если режим выбора не является одним из позволенныхListSelectionModel.getSelectionMode()
public boolean isSelectedIndex(int index)
isSelectedIndex
в интерфейсе ListSelectionModel
public boolean isSelectionEmpty()
isSelectionEmpty
в интерфейсе ListSelectionModel
public void addListSelectionListener(ListSelectionListener l)
addListSelectionListener
в интерфейсе ListSelectionModel
l
- ListSelectionListenerListSelectionModel.removeListSelectionListener(javax.swing.event.ListSelectionListener)
, ListSelectionModel.setSelectionInterval(int, int)
, ListSelectionModel.addSelectionInterval(int, int)
, ListSelectionModel.removeSelectionInterval(int, int)
, ListSelectionModel.clearSelection()
, ListSelectionModel.insertIndexInterval(int, int, boolean)
, ListSelectionModel.removeIndexInterval(int, int)
public void removeListSelectionListener(ListSelectionListener l)
removeListSelectionListener
в интерфейсе ListSelectionModel
l
- ListSelectionListenerListSelectionModel.addListSelectionListener(javax.swing.event.ListSelectionListener)
public ListSelectionListener[] getListSelectionListeners()
DefaultListSelectionModel
.ListSelectionListener
s или пустой массив, если никакие слушатели выбора списка в настоящий момент не регистрируютсяaddListSelectionListener(javax.swing.event.ListSelectionListener)
, removeListSelectionListener(javax.swing.event.ListSelectionListener)
protected void fireValueChanged(boolean isAdjusting)
protected void fireValueChanged(int firstIndex, int lastIndex)
ListSelectionListeners
то, что значение выбора, в закрытом интервале firstIndex
, lastIndex
, изменился.protected void fireValueChanged(int firstIndex, int lastIndex, boolean isAdjusting)
firstIndex
- первый индекс в интервалеlastIndex
- последний индекс в интервалеisAdjusting
- истина, если это - заключительное изменение в ряде корректировокEventListenerList
public <T extends EventListener> T[] getListeners(Class<T> listenerType)
FooListener
s на эту модель. FooListener
s регистрируются, используя addFooListener
метод. Можно определить listenerType
параметр с литералом класса, такой как FooListener.class
. Например, можно запросить a DefaultListSelectionModel
экземпляр m
для его слушателей выбора списка со следующим кодом:
ListSelectionListener[] lsls = (ListSelectionListener[])(m.getListeners(ListSelectionListener.class));Если никакие такие слушатели не существуют, этот метод возвращает пустой массив.
listenerType
- тип слушателей требуют; этот параметр должен определить интерфейс, который убывает от java.util.EventListener
FooListener
s на этой модели, или пустом массиве, если никакие такие слушатели не были добавленыClassCastException
- если listenerType
не определяет класс или интерфейс, который реализует java.util.EventListener
getListSelectionListeners()
public void setLeadAnchorNotificationEnabled(boolean flag)
isLeadAnchorNotificationEnabled()
public boolean isLeadAnchorNotificationEnabled()
leadAnchorNotificationEnabled
флаг. Когда leadAnchorNotificationEnabled
истина, модель генерирует события уведомления с границами, которые покрывают все изменения к выбору плюс изменения к индексам привязки и выводу. Установка флага ко лжи заставляет сужение границ события включать только элементы, которые были выбраны или невыбранными начиная с последнего изменения. Так или иначе модель продолжает поддерживать вывод и переменные привязки внутренне. Значение по умолчанию является истиной. Отметьте: Для вывода или привязки возможно быть измененным без изменения на выбор. Уведомление об этих изменениях часто важно, такой как тогда, когда новый вывод или привязка должны быть обновлены в представлении. Поэтому, предостережение убеждают, изменяя значение по умолчанию.
leadAnchorNotificationEnabled
флагsetLeadAnchorNotificationEnabled(boolean)
public void clearSelection()
clearSelection
в интерфейсе ListSelectionModel
ListSelectionModel.addListSelectionListener(javax.swing.event.ListSelectionListener)
public void setSelectionInterval(int index0, int index1)
index0
и index1
включительно. index0
не должно быть меньше чем или равным index1
. В SINGLE_SELECTION
режим выбора, только второй индекс используется.
Если это представляет изменение текущему выбору, то каждый ListSelectionListener
уведомляется относительно изменения.
Если любой индекс -1
, этот метод ничего не делает и возвращается без исключения. Иначе, если любой индекс является меньше чем -1
, IndexOutOfBoundsException
бросается.
setSelectionInterval
в интерфейсе ListSelectionModel
index0
- один конец интервала.index1
- другой конец интервалаIndexOutOfBoundsException
- если любой индекс является меньше чем -1
(и никакой индекс не -1
)addListSelectionListener(javax.swing.event.ListSelectionListener)
public void addSelectionInterval(int index0, int index1)
index0
и index1
включительно. В SINGLE_SELECTION
режим выбора, это эквивалентно вызову setSelectionInterval
, и только второй индекс используется. В SINGLE_INTERVAL_SELECTION
режим выбора, этот метод ведет себя как setSelectionInterval
, если данный интервал не сразу смежен с или перекрывает существующий выбор, и может поэтому использоваться, чтобы вырастить его.
Если это представляет изменение текущему выбору, то каждый ListSelectionListener
уведомляется относительно изменения. Отметьте это index0
не должно быть меньше чем или равным index1
.
Если любой индекс -1
, этот метод ничего не делает и возвращается без исключения. Иначе, если любой индекс является меньше чем -1
, IndexOutOfBoundsException
бросается.
addSelectionInterval
в интерфейсе ListSelectionModel
index0
- один конец интервала.index1
- другой конец интервалаIndexOutOfBoundsException
- если любой индекс является меньше чем -1
(и никакой индекс не -1
)addListSelectionListener(javax.swing.event.ListSelectionListener)
, setSelectionInterval(int, int)
public void removeSelectionInterval(int index0, int index1)
index0
и index1
включительно. index0
не должно быть меньше чем или равным index1
. В SINGLE_INTERVAL_SELECTION
режим выбора, если удаление произвело бы два несвязных выделения, удаление, расширяется через больший конец выбора. Например, если выбор 0-10
и Вы предоставляете индексы 5,6
(в любом порядке), получающийся выбор 0-4
.
Если это представляет изменение текущему выбору, то каждый ListSelectionListener
уведомляется относительно изменения.
Если любой индекс -1
, этот метод ничего не делает и возвращается без исключения. Иначе, если любой индекс является меньше чем -1
, IndexOutOfBoundsException
бросается.
removeSelectionInterval
в интерфейсе ListSelectionModel
index0
- один конец интервалаindex1
- другой конец интервалаIndexOutOfBoundsException
- если любой индекс является меньше чем -1
(и никакой индекс не -1
)addListSelectionListener(javax.swing.event.ListSelectionListener)
public void insertIndexInterval(int index, int length, boolean before)
insertIndexInterval
в интерфейсе ListSelectionModel
public void removeIndexInterval(int index0, int index1)
removeIndexInterval
в интерфейсе ListSelectionModel
public void setValueIsAdjusting(boolean isAdjusting)
valueIsAdjusting
свойство, которое указывает, нужно ли предстоящие изменения выбора считать частью единственного изменения. Значение этого свойства используется, чтобы инициализировать valueIsAdjusting
свойство ListSelectionEvent
s, которые сгенерированы. Например, если выбор обновляется в ответ на пользователя, перетаскивают, это свойство может быть установлено в true
когда перетаскивание инициируется и устанавливается в false
когда перетаскивание заканчивается. Во время перетаскивания слушатели получают события с a valueIsAdjusting
набор свойств к true
. В конце перетаскивания, когда изменение завершается, слушатели получают событие с набором значений к false
. Слушатели могут использовать этот образец, если они хотят обновить только, когда изменение было завершено.
Установка этого свойства к true
начинает серию изменений, которую нужно считать частью единственного изменения. Когда свойство возвращается к false
, событие отсылается, характеризуя все изменение выбора (если был один), с событием valueIsAdjusting
набор свойств к false
.
setValueIsAdjusting
в интерфейсе ListSelectionModel
isAdjusting
- новое значение свойстваListSelectionModel.getValueIsAdjusting()
, ListSelectionEvent.getValueIsAdjusting()
public String toString()
public Object clone() throws CloneNotSupportedException
listenerLists
не дублируются.clone
в классе Object
CloneNotSupportedException
- если модель выбора не делает и реализации (a), интерфейс Cloneable и (b) определяют a clone
метод.Cloneable
public int getAnchorSelectionIndex()
public int getLeadSelectionIndex()
public void setAnchorSelectionIndex(int anchorIndex)
setAnchorSelectionIndex
в интерфейсе ListSelectionModel
getAnchorSelectionIndex()
, setLeadSelectionIndex(int)
public void moveLeadSelectionIndex(int leadIndex)
leadIndex
- новый ведущий индекс выбораsetAnchorSelectionIndex(int)
, setLeadSelectionIndex(int)
, getLeadSelectionIndex()
public void setLeadSelectionIndex(int leadIndex)
Если значение по индексу привязки не выбирается, сделайте ту же самую вещь в обратных значениях выбора в старом диапазоне и значениях deslecting в новом.
Генерируйте единственное событие для этого изменения и уведомьте всех слушателей. В целях генерировать минимальные границы в этом случае, сделайте работу в единственной передаче; тем путем первый и последний индекс в ListSelectionEvent, который широковещательно передается, обратится к ячейкам, которые фактически изменили значение из-за этого метода. Если бы, вместо этого, эта работа была сделана в двух шагах, то эффект на состояние выбора был бы тем же самым, но два события будут сгенерированы, и границы вокруг измененных значений были бы более широкими, включая ячейки, которые были сначала очищены только, чтобы позже быть установленными.
Этот метод может использоваться в mouseDragged
метод класса UI, чтобы расширить выбор.
setLeadSelectionIndex
в интерфейсе ListSelectionModel
getLeadSelectionIndex()
, setAnchorSelectionIndex(int)
Для дальнейшей ссылки API и документации разработчика, см.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.