javax.swing.table

Класс TableRowSorter <М. расширяет TableModel>

java.lang. Объект

javax.swing. RowSorter<M>

javax.swing. DefaultRowSorter <М., Целое число>

javax.swing.table. TableRowSorter <M>

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

M - тип модели, которая должна быть реализацией TableModel

public class TableRowSorter<M extends TableModel>
extends DefaultRowSorter<M,Integer>

Реализация RowSorter это обеспечивает сортировку и фильтрацию использования a TableModel. Следующая выставочная сортировка добавления в качестве примера к a JTable:

   TableModel myModel = createMyTableModel();
   JTable table = new JTable(myModel);
   table.setRowSorter(new TableRowSorter(myModel));
 

Это сделает все проводное соединение так, что, когда пользователь сделает соответствующий жест, такой как щелчок по заголовку столбца, таблица визуально сортирует.

JTable's основанные на строке методы и JTable's модель выбора обращаются к представлению а не базовой модели. Поэтому, необходимо преобразовать между двумя. Например, чтобы получить выбор с точки зрения myModel Вы должны преобразовать индексы:

   int[] selection = table.getSelectedRows();
   for (int i = 0; i < selection.length; i++) {
     selection[i] = table.convertRowIndexToModel(selection[i]);
   }
 

Так же выбрать строку в JTable основанный на координате от базовой модели делают инверсию:

   table.setRowSelectionInterval(table.convertRowIndexToView(row),
                                 table.convertRowIndexToView(row));
 

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

TableRowSorter использование Comparators для того, чтобы сделать сравнения. Следующее определяет как a Comparator выбирается для столбца:

1. Если a Comparator был определен для столбца setComparator метод, используйте это.
2. Если класс столбца как возвращено getColumnClass String, используйте Comparator возвращенный Collator.getInstance().
3. Если класс столбца реализует Comparable, используйте a Comparator это вызывает compareTo метод.
4. Если a TableStringConverter был определен, используйте это, чтобы преобразовать значения в Strings и затем используют Comparator возвращенный Collator.getInstance().
5. Иначе используйте Comparator возвращенный Collator.getInstance() на следствиях вызова toString на объектах.

В дополнение к сортировке TableRowSorter обеспечивает возможность фильтровать. Фильтр определяется, используя setFilter метод. Следующий пример только покажет строки, содержащие строку "foo":

   TableModel myModel = createMyTableModel();
   TableRowSorter sorter = new TableRowSorter(myModel);
   sorter.setRowFilter(RowFilter.regexFilter(".*foo.*"));
   JTable table = new JTable(myModel);
   table.setRowSorter(sorter);
 

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

TableRowSorter имеет один формальный параметр типа: тип модели. Передача в типе, который соответствует точно Вашей модели, позволяет Вам фильтровать основанный на Вашей модели без кастинга. Сошлитесь на документацию RowFilter для примера этого.

ПРЕДУПРЕЖДЕНИЕ: DefaultTableModel возвращает класс столбца Object. Как таковой все сравнения будут сделаны, используя toString. Это может быть излишне дорого. Если столбец только содержит один тип имеющий значение, такой как Integer, следует переопределить getColumnClass и возвратите соответствующее Class. Это существенно увеличит производительность этого класса.

С тех пор:

1.6

См. Также:

JTable, RowFilter, DefaultTableModel, Collator, Comparator

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

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

DefaultRowSorter.ModelWrapper<M,I>

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

RowSorter. SortKey

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

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

Конструктор и Описание
TableRowSorter() Создает a TableRowSorter с пустой моделью.
TableRowSorter(M model) Создает a TableRowSorter использование model как базовое TableModel.

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

Методы

Модификатор и Тип	Метод и Описание
Comparator<?>	getComparator(int column) Возвраты Comparator для указанного столбца.
TableStringConverter	getStringConverter() Возвращает объект, ответственный за преобразование значений от модели до строк.
void	setModel(M model) Наборы TableModel использовать в качестве базовой модели для этого TableRowSorter.
void	setStringConverter(TableStringConverter stringConverter) Устанавливает объект, ответственный за преобразование значений от модели до строк.
protected boolean	useToString(int column) Возвраты, преобразовать ли значение в строку прежде, чем сделать сравнения, сортируя.

Методы javax.swing унаследованный от класса. DefaultRowSorter

allRowsChanged, convertRowIndexToModel, convertRowIndexToView, getMaxSortKeys, getModel, getModelRowCount, getModelWrapper, getRowFilter, getSortKeys, getSortsOnUpdates, getViewRowCount, isSortable, modelStructureChanged, rowsDeleted, rowsInserted, rowsUpdated, rowsUpdated, setComparator, setMaxSortKeys, setModelWrapper, setRowFilter, setSortable, setSortKeys, setSortsOnUpdates, sort, toggleSortOrder

Методы javax.swing унаследованный от класса. RowSorter

addRowSorterListener, fireRowSorterChanged, fireSortOrderChanged, removeRowSorterListener

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

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

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

TableRowSorter

public TableRowSorter()

Создает a TableRowSorter с пустой моделью.

TableRowSorter

public TableRowSorter(M model)

Создает a TableRowSorter использование model как базовое TableModel.

Параметры:

model - базовое TableModel использовать, null обрабатывается как пустая модель

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

setModel

public void setModel(M model)

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

Параметры:

model - базовая модель, чтобы использовать, или null

setStringConverter

public void setStringConverter(TableStringConverter stringConverter)

Устанавливает объект, ответственный за преобразование значений от модели до строк. Если не -null это используется, чтобы преобразовать любые объектные значения, у которых нет зарегистрированного Comparator, к строкам.

Параметры:

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

getStringConverter

public TableStringConverter getStringConverter()

Возвращает объект, ответственный за преобразование значений от модели до строк.

Возвраты:

объект, ответственный за преобразование значений в строки.

getComparator

public Comparator<?> getComparator(int column)

Возвраты Comparator для указанного столбца. Если a Comparator не был определен, используя setComparator метод a Comparator будет возвращен основанный на классе столбца (TableModel.getColumnClass) из указанного столбца. Если класс столбца String, Collator.getInstance возвращается. Если класс столбца реализует Comparable частное Comparator возвращается, который вызывает compareTo метод. Иначе Collator.getInstance возвращается.

Переопределения:

getComparator в классе DefaultRowSorter<M extends TableModel,Integer>

Параметры:

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

Возвраты:

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

Броски:

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

useToString

protected boolean useToString(int column)

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

Переопределения:

useToString в классе DefaultRowSorter<M extends TableModel,Integer>

Параметры:

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

Броски:

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