javax.swing

Класс RowSorter <M>

java.lang. Объект

javax.swing. RowSorter <M>

Введите Параметры:

M - тип базовой модели

Прямые Известные Подклассы:

DefaultRowSorter

public abstract class RowSorter<M>
extends Object

RowSorter обеспечивает основание для сортировки и фильтрации. Вне создания и установки a RowSorter, Вы очень редко должны взаимодействовать с тем непосредственно. Обратитесь к TableRowSorter для конкретной реализации RowSorter для JTable.

RowSorter's основная роль должен обеспечить отображение между двумя системами координат: это представления (например a JTable) и тот из базового источника данных, обычно модель.

Представление вызывает следующие методы на RowSorter:

• toggleSortOrder — Представление вызывает это, когда соответствующий пользовательский жест произошел, чтобы инициировать вид. Например, пользователь, по которому щелкают заголовок столбца в таблице.
• Один из методов изменения модели — представление вызывает метод изменения модели, когда базовая модель изменилась. Могут быть зависимости от порядка в том, как события поставляются, таким образом, a RowSorter не должен обновить его отображение, пока один из этих методов не вызывается.

Поскольку представление делает широкое применение convertRowIndexToModel, convertRowIndexToView и getViewRowCount методы, эти методы должны быть быстрыми.

RowSorter обеспечивает уведомление об изменениях посредством RowSorterListener. Два типа уведомления отправляются:

• RowSorterEvent.Type.SORT_ORDER_CHANGED — уведомляет слушателей, что порядок сортировки изменился. Это обычно сопровождается уведомлением, что вид изменился.
• RowSorterEvent.Type.SORTED — уведомляет слушателей что отображение, сохраняемое RowSorter изменился в некотором роде.

RowSorter у реализаций обычно нет непосредственного отображения с базовой моделью, но они могут. Например, если база данных делает сортировку, toggleSortOrder мог бы вызвать через к базе данных (на фоновом потоке), и переопределить отображающиеся методы, чтобы возвратить параметр, в котором передают.

Конкретные реализации RowSorter потребность сослаться на модель такой как TableModel или ListModel. Классы представления, такой как JTable и JList, будет также иметь ссылку на модель. Избегать упорядочивать зависимости, RowSorter реализации не должны установить слушателя на модели. Вместо этого представление class вызовет в RowSorter когда модель изменяется. Например, если строка обновляется в a TableModel JTable вызывает rowsUpdated. Когда модель изменяется, представление может вызвать в любой из следующих методов: modelStructureChanged, allRowsChanged, rowsInserted, rowsDeleted и rowsUpdated.

С тех пор:

1.6

См. Также:

TableRowSorter

Вложенная Сводка Класса

Вложенные Классы

Модификатор и Тип	Класс и Описание
static class	RowSorter. SortKey SortKey описывает порядок сортировки для определенного столбца.

Сводка конструктора

Конструкторы

Конструктор и Описание
RowSorter() Создает a RowSorter.

Сводка метода

Модификатор и Тип	Метод и Описание
void	addRowSorterListener(RowSorterListener l) Добавляет a RowSorterListener получить уведомление об этом RowSorter.
abstract void	allRowsChanged() Вызванный, когда содержание базовой модели полностью изменилось.
abstract int	convertRowIndexToModel(int index) Возвращает расположение index с точки зрения базовой модели.
abstract int	convertRowIndexToView(int index) Возвращает расположение index с точки зрения представления.
protected void	fireRowSorterChanged(int[] lastRowIndexToModel) Уведомляет слушателя, что отображение изменилось.
protected void	fireSortOrderChanged() Уведомляет слушателя, что порядок сортировки изменился.
abstract M	getModel() Возвращает базовую модель.
abstract int	getModelRowCount() Возвращает число строк в базовой модели.
abstract List<? extends RowSorter.SortKey>	getSortKeys() Возвращает текущие ключи сортировки.
abstract int	getViewRowCount() Возвращает число строк в представлении.
abstract void	modelStructureChanged() Вызванный, когда базовая структура модели полностью изменилась.
void	removeRowSorterListener(RowSorterListener l) Удаляет a RowSorterListener.
abstract void	rowsDeleted(int firstRow, int endRow) Вызванный, когда строки были удалены из базовой модели в указанном диапазоне (включительно).
abstract void	rowsInserted(int firstRow, int endRow) Вызванный, когда строки были вставлены в базовую модель в указанном диапазоне (включительно).
abstract void	rowsUpdated(int firstRow, int endRow) Вызванный, когда строки были изменены в базовой модели между указанным диапазоном (включительно).
abstract void	rowsUpdated(int firstRow, int endRow, int column) Вызванный, когда столбец в строках были обновлены в базовой модели между указанным диапазоном.
abstract void	setSortKeys(List<? extends RowSorter.SortKey> keys) Устанавливает текущие ключи сортировки.
abstract void	toggleSortOrder(int column) Инвертирует порядок сортировки указанного столбца.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

RowSorter

public RowSorter()

Создает a RowSorter.

Деталь метода

getModel

public abstract M getModel()

Возвращает базовую модель.

Возвраты:

базовая модель

toggleSortOrder

public abstract void toggleSortOrder(int column)

Инвертирует порядок сортировки указанного столбца. Это до подклассов, чтобы обеспечить точное поведение когда вызвано. Обычно это инвертирует порядок сортировки от возрастания до убывания (или убывание к возрастанию), если указанный столбец уже будет основным сортированным столбцом; иначе, делает указанный столбец основным сортированным столбцом, с сортировкой по возрастанию. Если указанный столбец не является поддающимся сортировке, этот метод не имеет никакого эффекта.

Если это приводит к изменению порядка сортировки и сортировке, соответствующему RowSorterListener уведомление будет отправлено.

Параметры:

column - столбец, чтобы переключить упорядочивание вида, с точки зрения базовой модели

Броски:

IndexOutOfBoundsException - если столбец вне диапазона базовой модели

convertRowIndexToModel

public abstract int convertRowIndexToModel(int index)

Возвращает расположение index с точки зрения базовой модели. Таким образом, для строки index в координатах представления это возвращается, строка индексируют с точки зрения базовой модели.

Параметры:

index - строка индексирует с точки зрения базового представления

Возвраты:

строка индексирует с точки зрения представления

Броски:

IndexOutOfBoundsException - если index вне диапазона представления

convertRowIndexToView

public abstract int convertRowIndexToView(int index)

Возвращает расположение index с точки зрения представления. Таким образом, для строки index в координатах базовой модели это возвращается, строка индексируют с точки зрения представления.

Параметры:

index - строка индексирует с точки зрения базовой модели

Возвраты:

строка индексирует с точки зрения представления, или-1, если индексируют, фильтровался из представления

Броски:

IndexOutOfBoundsException - если index вне диапазона модели

setSortKeys

public abstract void setSortKeys(List<? extends RowSorter.SortKey> keys)

Устанавливает текущие ключи сортировки.

Параметры:

keys - новое SortKeys; null сокращение для того, чтобы определить пустой список, указывая, что представление должно быть несортировано

getSortKeys

public abstract List<? extends RowSorter.SortKey> getSortKeys()

Возвращает текущие ключи сортировки. Это должно возвратить a non-null List и может возвратить неподдающееся изменению List. Если Вы должны изменить ключи сортировки, сделайте копию возвращенного List, видоизмените копию и вызовите setSortKeys с новым списком.

Возвраты:

текущий порядок сортировки

getViewRowCount

public abstract int getViewRowCount()

Возвращает число строк в представлении. Если содержание фильтровалось, это могло бы отличаться от количества строки базовой модели.

Возвраты:

число строк в представлении

См. Также:

getModelRowCount()

getModelRowCount

public abstract int getModelRowCount()

Возвращает число строк в базовой модели.

Возвраты:

число строк в базовой модели

См. Также:

getViewRowCount()

modelStructureChanged

public abstract void modelStructureChanged()

Вызванный, когда базовая структура модели полностью изменилась. Например, если число столбцов в a TableModel измененный, этот метод был бы вызван.

Вы обычно не вызываете этот метод. Этот метод общедоступен, чтобы позволить классам представления вызывать это.

allRowsChanged

public abstract void allRowsChanged()

Вызванный, когда содержание базовой модели полностью изменилось. Структура таблицы является тем же самым, только содержание изменилось. Это обычно отправляется, когда слишком дорого характеризовать изменение с точки зрения других методов.

Вы обычно не вызываете этот метод. Этот метод общедоступен, чтобы позволить классам представления вызывать это.

rowsInserted

public abstract void rowsInserted(int firstRow,
                                  int endRow)

Вызванный, когда строки были вставлены в базовую модель в указанном диапазоне (включительно).

Параметры дают индексы произведенного диапазона. Первый параметр с точки зрения модели перед изменением, и должен быть меньше чем или равным размеру модели перед изменением. Второй параметр с точки зрения модели после изменения и должен быть меньше чем размер модели после изменения. Например, если Вы имеете модель с 5 строками и добавляете 3 элемента до конца модели, индексы 5, 7.

Вы обычно не вызываете этот метод. Этот метод общедоступен, чтобы позволить классам представления вызывать это.

Параметры:

firstRow - первая строка

endRow - последняя строка

Броски:

IndexOutOfBoundsException - если или параметр недопустим, или firstRow > endRow

rowsDeleted

public abstract void rowsDeleted(int firstRow,
                                 int endRow)

Вызванный, когда строки были удалены из базовой модели в указанном диапазоне (включительно).

Параметры дают индексы произведенного диапазона и с точки зрения модели перед изменением. Например, если Вы имеете модель с 5 строками и удаляете 3 элемента из конца модели, индексы 2, 4.

Вы обычно не вызываете этот метод. Этот метод общедоступен, чтобы позволить классам представления вызывать это.

Параметры:

firstRow - первая строка

endRow - последняя строка

Броски:

IndexOutOfBoundsException - если или параметр вне диапазона модели перед изменением, или firstRow > endRow

rowsUpdated

public abstract void rowsUpdated(int firstRow,
                                 int endRow)

Вызванный, когда строки были изменены в базовой модели между указанным диапазоном (включительно).

Вы обычно не вызываете этот метод. Этот метод общедоступен, чтобы позволить классам представления вызывать это.

Параметры:

firstRow - первая строка, с точки зрения базовой модели

endRow - последняя строка, с точки зрения базовой модели

Броски:

IndexOutOfBoundsException - если или параметр вне диапазона базовой модели, или firstRow > endRow

rowsUpdated

public abstract void rowsUpdated(int firstRow,
                                 int endRow,
                                 int column)

Вызванный, когда столбец в строках были обновлены в базовой модели между указанным диапазоном.

Вы обычно не вызываете этот метод. Этот метод общедоступен, чтобы позволить классам представления вызывать это.

Параметры:

firstRow - первая строка, с точки зрения базовой модели

endRow - последняя строка, с точки зрения базовой модели

column - столбец, который изменился, с точки зрения базовой модели

Броски:

IndexOutOfBoundsException - если любой параметр вне диапазона базовой модели после изменения, firstRow > endRow, или column вне диапазона базовой модели

addRowSorterListener

public void addRowSorterListener(RowSorterListener l)

Добавляет a RowSorterListener получить уведомление об этом RowSorter. Если тот же самый слушатель будет добавлен не раз, то это получит многократные уведомления. Если l null ничто не делается.

Параметры:

l - RowSorterListener

removeRowSorterListener

public void removeRowSorterListener(RowSorterListener l)

Удаляет a RowSorterListener. Если l null ничто не делается.

Параметры:

l - RowSorterListener

fireSortOrderChanged

protected void fireSortOrderChanged()

Уведомляет слушателя, что порядок сортировки изменился.

fireRowSorterChanged

protected void fireRowSorterChanged(int[] lastRowIndexToModel)

Уведомляет слушателя, что отображение изменилось.

Параметры:

lastRowIndexToModel - отображение от индексов модели, чтобы просмотреть индексы до вида, может быть null