javax.swing

Класс DefaultRowSorter <М., I>

java.lang. Объект

javax.swing. RowSorter<M>

javax.swing. DefaultRowSorter <М., I>

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

M - тип модели

I - тип идентификатора, который передают к RowFilter

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

TableRowSorter

public abstract class DefaultRowSorter<M,I>
extends RowSorter<M>

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

Сортировка делается основанная на токе SortKeys, в порядке. Если два объекта равны ( Comparator поскольку столбец возвращает 0) следующее SortKey используется. Если нет SortKeys остаются, или порядок UNSORTED, тогда порядок строк в модели используется.

Сортировка каждого столбца делается посредством a Comparator то, что можно определить использование setComparator метод. Если a Comparator не был определен, Comparator возвращенный Collator.getInstance() используется на результатах вызова toString на базовых объектах. Comparator никогда не передается null. A null значение обрабатывается как происходящий перед не -null значение, и два null значения считают равными.

Если Вы определяете a Comparator это бросает его параметр типу кроме обеспеченного моделью, a ClassCastException будет брошен, когда данные сортируются.

В дополнение к сортировке, DefaultRowSorter обеспечивает возможность фильтровать строки. Фильтрация делается посредством a RowFilter это определяется, используя setRowFilter метод. Если никакой фильтр не был определен, все строки включаются.

По умолчанию строки находятся в несортированном порядке (то же самое как модель), и каждый столбец является поддающимся сортировке. Значение по умолчанию Comparators документируются в подклассы (например, TableRowSorter).

Если базовая структура модели изменяется ( modelStructureChanged метод вызывается), следующее сбрасывается к их значениям по умолчанию: Comparators столбцом, текущим порядком сортировки, и является ли каждый столбец поддающимся сортировке. Найти значение по умолчанию Comparators, см. конкретную реализацию (например, TableRowSorter). Порядок сортировки по умолчанию несортируется (то же самое как модель), и столбцы являются поддающимися сортировке по умолчанию.

Если базовая структура модели изменяется ( modelStructureChanged метод вызывается), следующее сбрасывается к их значениям по умолчанию: Comparators столбцом, текущим порядком сортировки и является ли столбец поддающимся сортировке.

DefaultRowSorter абстрактный class. Конкретные подклассы должны обеспечить доступ к базовым данным, вызывая setModelWrapper. setModelWrapper метод должен быть вызван вскоре после того, как конструктора вызывают, идеально изнутри конструктора подкласса. Неопределенное поведение закончится, если Вы будете использовать a DefaultRowSorter не определяя a ModelWrapper.

DefaultRowSorter имеет два формальных параметра типа. Первый параметр типа соответствует class модели, например DefaultTableModel. Второй параметр типа соответствует class идентификатора, который передают к RowFilter. Обратитесь к TableRowSorter и RowFilter для большего количества деталей о параметрах типа.

С тех пор:

1.6

См. Также:

TableRowSorter, DefaultTableModel, Collator

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

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

Модификатор и Тип	Класс и Описание
protected static class	DefaultRowSorter.ModelWrapper<M,I> DefaultRowSorter.ModelWrapper ответственно за обеспечение данных, которые сортируются DefaultRowSorter.

Вложенные классы/интерфейсы, наследованные от class javax.swing. RowSorter

RowSorter. SortKey

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

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

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

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

Модификатор и Тип	Метод и Описание
void	allRowsChanged() Вызванный, когда содержание базовой модели полностью изменилось.
int	convertRowIndexToModel(int index) Возвращает расположение index с точки зрения базовой модели.
int	convertRowIndexToView(int index) Возвращает расположение index с точки зрения представления.
Comparator<?>	getComparator(int column) Возвраты Comparator для указанного столбца.
int	getMaxSortKeys() Возвращает максимальное количество ключей сортировки.
М.	getModel() Возвращает базовую модель.
int	getModelRowCount() Возвращает число строк в базовой модели.
protected DefaultRowSorter.ModelWrapper<M,I>	getModelWrapper() Возвращает обертку модели, обеспечивающую данные, которые сортируются и фильтруются.
RowFilter<? super M,? super I>	getRowFilter() Возвращает фильтр, который определяет, какие строки, если таковые вообще имеются, должны быть скрыты от представления.
List<? extends RowSorter.SortKey>	getSortKeys() Возвращает текущие ключи сортировки.
boolean	getSortsOnUpdates() Возвращает true, если вид должен произойти, когда базовая модель обновляется; иначе, возвращает false.
int	getViewRowCount() Возвращает число строк в представлении.
boolean	isSortable(int column) Возвращает true, если указанный столбец является поддающимся сортировке; иначе, ложь.
void	modelStructureChanged() Вызванный, когда базовая структура модели полностью изменилась.
void	rowsDeleted(int firstRow, int endRow) Вызванный, когда строки были удалены из базовой модели в указанном диапазоне (включительно).
void	rowsInserted(int firstRow, int endRow) Вызванный, когда строки были вставлены в базовую модель в указанном диапазоне (включительно).
void	rowsUpdated(int firstRow, int endRow) Вызванный, когда строки были изменены в базовой модели между указанным диапазоном (включительно).
void	rowsUpdated(int firstRow, int endRow, int column) Вызванный, когда столбец в строках были обновлены в базовой модели между указанным диапазоном.
void	setComparator(int column, Comparator<?> comparator) Наборы Comparator использовать, сортируя указанный столбец.
void	setMaxSortKeys(int max) Устанавливает максимальное количество ключей сортировки.
protected void	setModelWrapper(DefaultRowSorter.ModelWrapper<M,I> modelWrapper) Устанавливает обертку модели, обеспечивающую данные, которые сортируются и фильтруются.
void	setRowFilter(RowFilter<? super M,? super I> filter) Устанавливает фильтр, который определяет, какие строки, если таковые вообще имеются, должны быть скрыты от представления.
void	setSortable(int column, boolean sortable) Наборы, является ли указанный столбец поддающимся сортировке.
void	setSortKeys(List<? extends RowSorter.SortKey> sortKeys) Устанавливает ключи сортировки.
void	setSortsOnUpdates(boolean sortsOnUpdates) Если это правда, определяет, что вид должен произойти, когда базовая модель обновляется (rowsUpdated вызывается).
void	sort() Виды и фильтры строки в представлении, основанном на ключах сортировки столбцов, в настоящий момент сортируемых и фильтра, если таковые вообще имеются, связались с этим сортировщиком.
void	toggleSortOrder(int column) Инвертирует порядок сортировки от возрастания до убывания (или убывание к возрастанию), если указанный столбец уже является основным сортированным столбцом; иначе, делает указанный столбец основным сортированным столбцом, с сортировкой по возрастанию.
protected boolean	useToString(int column) Возвраты, преобразовать ли значение в строку прежде, чем сделать сравнения, сортируя.

Методы, наследованные от class javax.swing. RowSorter

addRowSorterListener, fireRowSorterChanged, fireSortOrderChanged, removeRowSorterListener

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

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

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

DefaultRowSorter

public DefaultRowSorter()

Создает пустое DefaultRowSorter.

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

setModelWrapper

protected final void setModelWrapper(DefaultRowSorter.ModelWrapper<M,I> modelWrapper)

Устанавливает обертку модели, обеспечивающую данные, которые сортируются и фильтруются.

Параметры:

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

Броски:

IllegalArgumentException - если modelWrapper null

getModelWrapper

protected final DefaultRowSorter.ModelWrapper<M,I> getModelWrapper()

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

Возвраты:

обертка модели, ответственная за обеспечение данных, которые сортируются и фильтровали

getModel

public final M getModel()

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

Определенный:

getModel в class RowSorter<M>

Возвраты:

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

setSortable

public void setSortable(int column,
                        boolean sortable)

Наборы, является ли указанный столбец поддающимся сортировке. Указанное значение только проверяется когда toggleSortOrder вызывается. Это все еще возможно к виду на столбце, который был отмечен как неподдающийся сортировке, непосредственно устанавливая ключи сортировки. Значение по умолчанию является истиной.

Параметры:

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

sortable - является ли указанный столбец поддающимся сортировке

Броски:

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

См. Также:

toggleSortOrder(int), setSortKeys(java.util.List<? extends javax.swing.RowSorter.SortKey>)

isSortable

public boolean isSortable(int column)

Возвращает true, если указанный столбец является поддающимся сортировке; иначе, ложь.

Параметры:

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

Возвраты:

истина, если столбец является поддающимся сортировке

Броски:

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

setSortKeys

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

Устанавливает ключи сортировки. Это создает копию предоставленного List; последующие изменения к предоставленному List не производите это DefaultRowSorter. Если ключи сортировки изменились, это инициировало вид.

Определенный:

setSortKeys в class RowSorter<M>

Параметры:

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

Броски:

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

getSortKeys

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

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

Определенный:

getSortKeys в class RowSorter<M>

Возвраты:

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

setMaxSortKeys

public void setMaxSortKeys(int max)

Устанавливает максимальное количество ключей сортировки. Число ключей сортировки определяет, как равные значения разрешаются, сортируя. Например, предположите, что сортировщик строки таблицы создается и setMaxSortKeys(2) вызывается на это. Пользователь щелкает по заголовку для столбца 1, заставляя строки таблицы быть сортированным основанный на элементах в столбце 1. Затем, пользователь щелкает по заголовку для столбца 2, заставляя таблицу быть сортированным основанный на элементах в столбце 2; если какие-либо элементы в столбце 2 равны, то те определенные строки упорядочиваются основанные на элементах в столбце 1. В этом случае мы говорим, что строки прежде всего сортируются на столбце 2, и во вторую очередь на столбце 1. Если пользователь тогда щелкает по заголовку для столбца 3, то элементы прежде всего сортируются на столбце 3 и во вторую очередь сортируются на столбце 2. Поскольку максимальное количество ключей сортировки было установлено в 2 с setMaxSortKeys, столбец 1 больше не имеет эффект на порядок.

Максимальное количество ключей сортировки осуществляется toggleSortOrder. Можно определить больше ключей сортировки, вызывая setSortKeys непосредственно и их будут все соблюдать. Однако, если toggleSortOrder впоследствии вызывается максимальное количество ключей сортировки будет осуществлено. Значение по умолчанию 3.

Параметры:

max - максимальное количество ключей сортировки

Броски:

IllegalArgumentException - если max < 1

getMaxSortKeys

public int getMaxSortKeys()

Возвращает максимальное количество ключей сортировки.

Возвраты:

максимальное количество ключей сортировки

setSortsOnUpdates

public void setSortsOnUpdates(boolean sortsOnUpdates)

Если это правда, определяет, что вид должен произойти, когда базовая модель обновляется (rowsUpdated вызывается). Например, если это - истина, и пользователь редактирует запись, которую может изменить расположение того элемента в представлении. Значение по умолчанию является ложью.

Параметры:

sortsOnUpdates - действительно ли к виду на событиях обновления

getSortsOnUpdates

public boolean getSortsOnUpdates()

Возвращает true, если вид должен произойти, когда базовая модель обновляется; иначе, возвращает false.

Возвраты:

действительно ли к виду, когда модель обновляется

setRowFilter

public void setRowFilter(RowFilter<? super M,? super I> filter)

Устанавливает фильтр, который определяет, какие строки, если таковые вообще имеются, должны быть скрыты от представления. Фильтр применяется перед сортировкой. Значение null указывает, что все значения от модели должны быть включены.

RowFilter's include метод передают Entry это обертывает базовую модель. Число столбцов в Entry соответствует числу столбцов в ModelWrapper. Идентификатор прибывает из ModelWrapper также.

Этот метод инициировал вид.

Параметры:

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

getRowFilter

public RowFilter<? super M,? super I> getRowFilter()

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

Возвраты:

фильтр

toggleSortOrder

public void toggleSortOrder(int column)

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

Определенный:

toggleSortOrder в class RowSorter<M>

Параметры:

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

Броски:

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

См. Также:

setSortable(int,boolean), setMaxSortKeys(int)

convertRowIndexToView

public int convertRowIndexToView(int index)

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

Определенный:

convertRowIndexToView в class RowSorter<M>

Параметры:

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

Возвраты:

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

Броски:

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

convertRowIndexToModel

public int convertRowIndexToModel(int index)

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

Определенный:

convertRowIndexToModel в class RowSorter<M>

Параметры:

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

Возвраты:

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

Броски:

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

вид

public void sort()

Виды и фильтры строки в представлении, основанном на ключах сортировки столбцов, в настоящий момент сортируемых и фильтра, если таковые вообще имеются, связались с этим сортировщиком. Пустое sortKeys список указывает, что представление должно несортированный, то же самое как модель.

См. Также:

setRowFilter(javax.swing.RowFilter<? super M, ? super I>), setSortKeys(java.util.List<? extends javax.swing.RowSorter.SortKey>)

useToString

protected boolean useToString(int column)

Возвраты, преобразовать ли значение в строку прежде, чем сделать сравнения, сортируя. Если истина ModelWrapper.getStringValueAt будет использоваться, иначе ModelWrapper.getValueAt будет использоваться. Это до подклассов, такой как TableRowSorter, соблюдать это значение в их ModelWrapper реализация.

Параметры:

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

Броски:

IndexOutOfBoundsException - если column не допустимо

setComparator

public void setComparator(int column,
                          Comparator<?> comparator)

Наборы Comparator использовать, сортируя указанный столбец. Это не инициировало вид. Если Вы хотите сортировать после установки компаратора, Вы должны явно вызвать sort.

Параметры:

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

comparator - Comparator использовать

Броски:

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

getComparator

public Comparator<?> getComparator(int column)

Возвраты Comparator для указанного столбца. Это возвратится null если a Comparator не был определен для столбца.

Параметры:

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

Возвраты:

Comparator для указанного столбца

Броски:

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

getViewRowCount

public int getViewRowCount()

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

Определенный:

getViewRowCount в class RowSorter<M>

Возвраты:

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

См. Также:

RowSorter.getModelRowCount()

getModelRowCount

public int getModelRowCount()

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

Определенный:

getModelRowCount в class RowSorter<M>

Возвраты:

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

См. Также:

RowSorter.getViewRowCount()

modelStructureChanged

public void modelStructureChanged()

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

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

Определенный:

modelStructureChanged в class RowSorter<M>

allRowsChanged

public void allRowsChanged()

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

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

Определенный:

allRowsChanged в class RowSorter<M>

rowsInserted

public void rowsInserted(int firstRow,
                         int endRow)

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

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

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

Определенный:

rowsInserted в class RowSorter<M>

Параметры:

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

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

Броски:

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

rowsDeleted

public void rowsDeleted(int firstRow,
                        int endRow)

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

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

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

Определенный:

rowsDeleted в class RowSorter<M>

Параметры:

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

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

Броски:

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

rowsUpdated

public void rowsUpdated(int firstRow,
                        int endRow)

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

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

Определенный:

rowsUpdated в class RowSorter<M>

Параметры:

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

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

Броски:

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

rowsUpdated

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

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

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

Определенный:

rowsUpdated в class RowSorter<M>

Параметры:

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

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

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

Броски:

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