Spec-Zone.ru › OpenJDK 27

Класс JTable

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.JTable
Все реализованные интерфейсы:
ImageObserver, MenuContainer, Serializable, EventListener, Accessible, CellEditorListener, ListSelectionListener, RowSorterListener, TableColumnModelListener, TableModelListener, Scrollable
@JavaBean(defaultProperty="UI", description="A component which displays data in a two dimensional grid.") public class JTable extends JComponent implements TableModelListener, Scrollable, TableColumnModelListener, ListSelectionListener, CellEditorListener, Accessible, RowSorterListener
JTable используется для отображения и редактирования обычных двумерных таблиц ячеек. См. раздел How to Use Tables в The Java Tutorial для получения ориентированной на задачи документации и примеров использования JTable.

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

     TableModel dataModel = new AbstractTableModel() {
         public int getColumnCount() { return 10; }
         public int getRowCount() { return 10;}
         public Object getValueAt(int row, int col) { return Integer.valueOf(row*col); }
     };
     JTable table = new JTable(dataModel);
     JScrollPane scrollpane = new JScrollPane(table);

Обычно JTable помещается внутрь JScrollPane. По умолчанию JTable подгоняет свою ширину так, что горизонтальная полоса прокрутки не требуется. Чтобы разрешить горизонтальную полосу прокрутки, вызовите setAutoResizeMode(int) с AUTO_RESIZE_OFF. Обратите внимание: если вы хотите использовать JTable в отдельном представлении (вне JScrollPane) и хотите, чтобы заголовок отображался, вы можете получить его с помощью getTableHeader() и отобразить отдельно.

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

  • Непосредственно установить RowSorter. Например: table.setRowSorter(new TableRowSorter(model)).
  • Установить свойство autoCreateRowSorter в значение true, чтобы JTable создал RowSorter за вас. Например: setAutoCreateRowSorter(true).

При проектировании приложений, использующих JTable, стоит уделить пристальное внимание структурам данных, которые будут представлять данные таблицы. DefaultTableModel представляет собой реализацию модели, использующую Vector из Vector с элементами Object для хранения значений ячеек. Помимо копирования данных из приложения в DefaultTableModel, также возможно обернуть данные в методы интерфейса TableModel, чтобы данные можно было передавать в JTable напрямую, как в примере выше. Это часто приводит к созданию более эффективных приложений, поскольку модель может свободно выбирать внутреннее представление, наиболее подходящее для данных. Практическое правило при выборе между использованием AbstractTableModel или DefaultTableModel состоит в том, чтобы использовать AbstractTableModel в качестве базового класса для создания подклассов, а DefaultTableModel — когда создание подклассов не требуется.

Каталог "TableExample" в демонстрационной области дистрибутива исходного кода содержит ряд полных примеров использования JTable, показывающих, как JTable может использоваться для предоставления редактируемого представления данных, полученных из базы данных, и как изменять столбцы при отображении для использования специализированных средств визуализации и редакторов.

JTable использует исключительно целые числа для обращения как к строкам, так и к столбцам отображаемой им модели. JTable просто берет табличный диапазон ячеек и использует getValueAt(int, int) для извлечения значений из модели во время отрисовки. Важно помнить, что индексы столбцов и строк, возвращаемые различными методами JTable, задаются в терминах JTable (представления) и не обязательно совпадают с индексами, используемыми моделью.

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

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

Аналогично, при использовании функциональности сортировки и фильтрации, предоставляемой RowSorter, базовая TableModel не обязана знать, как выполнять сортировку — этим занимается RowSorter. Преобразование координат потребуется при использовании строковых методов JTable с базовой TableModel. Все методы JTable, работающие со строками, определены в терминах RowSorter, которая не обязательно совпадает с базовой TableModel. Например, выделение всегда определяется в терминах JTable, поэтому при использовании RowSorter вам потребуется выполнять преобразование с помощью convertRowIndexToView или convertRowIndexToModel. Ниже показано, как преобразовать координаты из JTable в координаты базовой модели:

  int[] selection = table.getSelectedRows();
  for (int i = 0; i < selection.length; i++) {
    selection[i] = table.convertRowIndexToModel(selection[i]);
  }
  // selection is now in terms of the underlying TableModel

По умолчанию, если сортировка включена, JTable сохраняет выделение и переменные высоты строк в терминах модели при сортировке. Например, если строка 0 в терминах базовой модели выбрана в данный момент, то после сортировки будет выбрана строка 0 в терминах базовой модели. Визуально выделение может измениться, но в терминах базовой модели оно останется прежним. Единственное исключение — если индекс модели больше не виден или был удален. Например, если строка 0 в терминах модели была отфильтрована, выделение после сортировки станет пустым.

В J2SE 5 в JTable добавлены методы, обеспечивающие удобный доступ к некоторым распространенным задачам печати. Простые новые методы print() позволяют быстро и легко добавить поддержку печати в ваше приложение. Кроме того, для более сложных требований к печати доступен новый метод getPrintable(JTable.PrintMode, MessageFormat, MessageFormat).

Как и для всех классов JComponent, вы можете использовать InputMap и ActionMap для связывания объекта Action с KeyStroke и выполнения действия при определенных условиях.

Предупреждение: Swing не потокобезопасен. Дополнительные сведения см. в разделе Swing's Threading Policy.

Предупреждение: Сериализованные объекты этого класса будут несовместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, работающими на одной версии Swing. Начиная с версии 1.4, поддержка долговременного хранения всех JavaBeans была добавлена в пакет java.beans. См. XMLEncoder.

Начиная с версии:
1.2
См. также:
  • DefaultTableModel
  • TableRowSorter

Краткое описание вложенных классов

Модификатор и тип Класс Описание
protected class  JTable.AccessibleJTable
Этот класс реализует поддержку доступности для класса JTable.
static final class  JTable.DropLocation
Подкласс TransferHandler.DropLocation, представляющий место сброса для JTable.
static enum  JTable.PrintMode
Режимы печати, используемые при печати JTable.

Вложенные классы/интерфейсы, объявленные в классе JComponent

JComponent.AccessibleJComponent
Модификатор и тип Класс Описание
class  JComponent.AccessibleJComponent
Внутренний класс JComponent, используемый для обеспечения поддержки доступности по умолчанию.

Вложенные классы/интерфейсы, объявленные в классе Container

Container.AccessibleAWTContainer
Модификатор и тип Класс Описание
protected class  Container.AccessibleAWTContainer
Внутренний класс Container, используемый для обеспечения поддержки доступности по умолчанию.

Вложенные классы/интерфейсы, объявленные в классе Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
Модификатор и тип Класс Описание
protected class  Component.AccessibleAWTComponent
Внутренний класс Component, используемый для обеспечения поддержки доступности по умолчанию.
static enum  Component.BaselineResizeBehavior
Перечисление распространенных способов изменения базовой линии компонента при изменении его размера.
protected class  Component.BltBufferStrategy
Внутренний класс для переноса закадровых поверхностей на компонент.
protected class  Component.FlipBufferStrategy
Внутренний класс для переключения буферов на компоненте.

Краткое описание полей

Модификатор и тип Поле Описание
static final int AUTO_RESIZE_ALL_COLUMNS
При любых операциях изменения размера пропорционально изменять размер всех столбцов.
static final int AUTO_RESIZE_LAST_COLUMN
При любых операциях изменения размера применять корректировки только к последнему столбцу.
static final int AUTO_RESIZE_NEXT_COLUMN
При корректировке столбца в пользовательском интерфейсе корректировать следующий столбец в противоположную сторону.
static final int AUTO_RESIZE_OFF
Не подгонять ширину столбцов автоматически; вместо этого использовать горизонтальную полосу прокрутки.
static final int AUTO_RESIZE_SUBSEQUENT_COLUMNS
При корректировке в пользовательском интерфейсе изменять последующие столбцы для сохранения общей ширины; это поведение по умолчанию.
protected boolean autoCreateColumnsFromModel
Если установлено значение true, таблица будет опрашивать TableModel для построения набора столбцов по умолчанию.
protected int autoResizeMode
Определяет, изменяет ли таблица автоматически ширину своих столбцов, чтобы занять всю ширину таблицы, и как именно выполняется это изменение размера.
protected TableCellEditor cellEditor
Активный объект редактора ячейки, который перекрывает экранную область, занимаемую текущей ячейкой, и позволяет пользователю изменять ее содержимое.
protected boolean cellSelectionEnabled
Устарело начиная с платформы Java 2 версии 1.3.
protected TableColumnModel columnModel
TableColumnModel таблицы.
protected TableModel dataModel
TableModel таблицы.
protected Hashtable<Object,Object> defaultEditorsByColumnClass
Таблица объектов, отображающих и редактирующих содержимое ячейки, индексированная по классу, как объявлено в getColumnClass в интерфейсе TableModel.
protected Hashtable<Object,Object> defaultRenderersByColumnClass
Таблица объектов, отображающих содержимое ячейки, индексированная по классу, как объявлено в getColumnClass в интерфейсе TableModel.
protected int editingColumn
Идентифицирует столбец редактируемой ячейки.
protected int editingRow
Идентифицирует строку редактируемой ячейки.
protected Component editorComp
При редактировании — Component, обрабатывающий редактирование.
protected Color gridColor
Цвет сетки.
protected Dimension preferredViewportSize
Используется интерфейсом Scrollable для определения начальной видимой области.
protected int rowHeight
Высота в пикселях каждой строки в таблице.
protected int rowMargin
Высота в пикселях отступа между ячейками в каждой строке.
protected boolean rowSelectionAllowed
Значение true, если в этой таблице разрешено выделение строк.
protected Color selectionBackground
Цвет фона выделенных ячеек.
protected Color selectionForeground
Цвет текста выделенных ячеек.
protected ListSelectionModel selectionModel
ListSelectionModel таблицы, используемая для отслеживания выделения строк.
protected boolean showHorizontalLines
Таблица рисует горизонтальные линии между ячейками, если showHorizontalLines имеет значение true.
protected boolean showVerticalLines
Таблица рисует вертикальные линии между ячейками, если showVerticalLines имеет значение true.
protected JTableHeader tableHeader
TableHeader, работающий с таблицей.

Поля, объявленные в классе JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
Модификатор и тип Поле Описание
protected EventListenerList listenerList
Список слушателей событий для этого компонента.
static final String TOOL_TIP_TEXT_KEY
Комментарий, отображаемый при наведении курсора на компонент, также известный как «всплывающая подсказка» ("value tip", "flyover help" или "flyover label").
protected ComponentUI ui
Делегат внешнего вида и функциональности для этого компонента.
static final int UNDEFINED_CONDITION
Константа, используемая некоторыми API для обозначения того, что условие не определено.
static final int WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
Константа, используемая для registerKeyboardAction, означающая, что команда должна вызываться, когда принимающий компонент является предком сфокусированного компонента или сам находится в фокусе.
static final int WHEN_FOCUSED
Константа, используемая для registerKeyboardAction, означающая, что команда должна вызываться, когда компонент находится в фокусе.
static final int WHEN_IN_FOCUSED_WINDOW
Константа, используемая для registerKeyboardAction, означающая, что команда должна вызываться, когда принимающий компонент находится в окне, имеющем фокус, или сам находится в фокусе.

Поля, объявленные в классе Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
Модификатор и тип Поле Описание
protected AccessibleContext accessibleContext
AccessibleContext, связанный с этим Component.
static final float BOTTOM_ALIGNMENT
Удобная константа для getAlignmentY.
static final float CENTER_ALIGNMENT
Удобная константа для getAlignmentY и getAlignmentX.
static final float LEFT_ALIGNMENT
Удобная константа для getAlignmentX.
static final float RIGHT_ALIGNMENT
Удобная константа для getAlignmentX.
static final float TOP_ALIGNMENT
Удобная константа для getAlignmentY().

Поля, объявленные в интерфейсе ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Модификатор и тип Поле Описание
static final int ABORT
Этот флаг в аргументе infoflags метода imageUpdate указывает, что асинхронно отслеживаемое изображение было прервано до завершения создания.
static final int ALLBITS
Этот флаг в аргументе infoflags метода imageUpdate указывает, что статическое изображение, которое ранее отрисовывалось, теперь завершено и может быть отрисовано снова в окончательном виде.
static final int ERROR
Этот флаг в аргументе infoflags метода imageUpdate указывает, что при асинхронном отслеживании изображения произошла ошибка.
static final int FRAMEBITS
Этот флаг в аргументе infoflags метода imageUpdate указывает, что стал доступен для повторной отрисовки очередной полный кадр ранее отрисованного многокадрового изображения.
static final int HEIGHT
Этот флаг в аргументе infoflags метода imageUpdate указывает, что высота базового изображения теперь доступна и может быть получена из аргумента height метода обратного вызова imageUpdate.
static final int PROPERTIES
Этот флаг в аргументе infoflags метода imageUpdate указывает, что свойства изображения теперь доступны.
static final int SOMEBITS
Этот флаг в аргументе infoflags метода imageUpdate указывает, что доступны дополнительные пиксели, необходимые для отрисовки масштабированного варианта изображения.
static final int WIDTH
Этот флаг в аргументе infoflags метода imageUpdate указывает, что ширина базового изображения теперь доступна и может быть получена из аргумента width метода обратного вызова imageUpdate.

Краткое описание конструкторов

Конструктор Описание
JTable()
Создает JTable по умолчанию, инициализированный моделью данных по умолчанию, моделью столбцов по умолчанию и моделью выделения по умолчанию.
JTable(int numRows, int numColumns)
Создает JTable с numRows и numColumns пустых ячеек с использованием DefaultTableModel.
JTable(Object[][] rowData, Object[] columnNames)
Создает JTable для отображения значений в двумерном массиве rowData с именами столбцов columnNames.
JTable(Vector<? extends Vector> rowData, Vector<?> columnNames)
Создает JTable для отображения значений в Vector из Vectors, rowData, с именами столбцов columnNames.
JTable(TableModel dm)
Создает JTable, инициализированный моделью данных dm, моделью столбцов по умолчанию и моделью выделения по умолчанию.
JTable(TableModel dm, TableColumnModel cm)
Создает JTable, инициализированный моделью данных dm, моделью столбцов cm и моделью выделения по умолчанию.
JTable(TableModel dm, TableColumnModel cm, ListSelectionModel sm)
Создает JTable, инициализированный моделью данных dm, моделью столбцов cm и моделью выделения sm.

Краткое описание методов

Модификатор и тип Метод Описание
void addColumn(TableColumn aColumn)
Добавляет aColumn в конец массива столбцов, удерживаемых моделью столбцов этого JTable.
void addColumnSelectionInterval(int index0, int index1)
Добавляет столбцы от index0 до index1 включительно в текущее выделение.
void addNotify()
Вызывает метод configureEnclosingScrollPane.
void addRowSelectionInterval(int index0, int index1)
Добавляет строки от index0 до index1 включительно в текущее выделение.
void changeSelection(int rowIndex, int columnIndex, boolean toggle, boolean extend)
Обновляет модели выделения таблицы в зависимости от состояния двух флагов: toggle и extend.
void clearSelection()
Снимает выделение со всех выбранных столбцов и строк.
void columnAdded(TableColumnModelEvent e)
Вызывается при добавлении столбца в модель столбцов таблицы.
int columnAtPoint(Point point)
Возвращает индекс столбца, в котором находится point, или -1, если результат не входит в диапазон [0, getColumnCount()-1].
void columnMarginChanged(ChangeEvent e)
Вызывается при перемещении столбца из-за изменения отступа.
void columnMoved(TableColumnModelEvent e)
Вызывается при изменении положения столбца.
void columnRemoved(TableColumnModelEvent e)
Вызывается при удалении столбца из модели столбцов таблицы.
void columnSelectionChanged(ListSelectionEvent e)
Вызывается при изменении модели выделения у TableColumnModel.
protected void configureEnclosingScrollPane()
Если этот JTable является viewportView для объемлющего JScrollPane (обычная ситуация), настраивает этот ScrollPane, помимо прочего, устанавливая tableHeader таблицы в качестве columnHeaderView панели прокрутки.
int convertColumnIndexToModel(int viewColumnIndex)
Сопоставляет индекс столбца в представлении по адресу viewColumnIndex с индексом столбца в модели таблицы.
int convertColumnIndexToView(int modelColumnIndex)
Сопоставляет индекс столбца в модели таблицы по адресу modelColumnIndex с индексом столбца в представлении.
int convertRowIndexToModel(int viewRowIndex)
Сопоставляет индекс строки в представлении с базовой TableModel.
int convertRowIndexToView(int modelRowIndex)
Сопоставляет индекс строки в TableModel со строкой в представлении.
protected TableColumnModel createDefaultColumnModel()
Возвращает объект модели столбцов по умолчанию, представляющий собой DefaultTableColumnModel.
void createDefaultColumnsFromModel()
Создает столбцы по умолчанию для таблицы из модели данных с использованием метода getColumnCount, определенного в интерфейсе TableModel.
protected TableModel createDefaultDataModel()
Возвращает объект модели таблицы по умолчанию, представляющий собой DefaultTableModel.
protected void createDefaultEditors()
Создает редакторы ячеек по умолчанию для объектов, чисел и логических значений.
protected void createDefaultRenderers()
Создает визуализаторы ячеек по умолчанию для объектов, чисел, значений типа double, дат, логических значений и значков.
protected ListSelectionModel createDefaultSelectionModel()
Возвращает объект модели выделения по умолчанию, представляющий собой DefaultListSelectionModel.
protected JTableHeader createDefaultTableHeader()
Возвращает объект заголовка таблицы по умолчанию, представляющий собой JTableHeader.
static JScrollPane createScrollPaneForTable(JTable aTable)
Устарело.
Начиная с версии Swing 1.0.2, заменено на new JScrollPane(aTable).
void doLayout()
Заставляет эту таблицу выполнить компоновку своих строк и столбцов.
boolean editCellAt(int row, int column)
Программно начинает редактирование ячейки в позиции row и column, если эти индексы находятся в допустимом диапазоне, а ячейка с этими индексами доступна для редактирования.
boolean editCellAt(int row, int column, EventObject e)
Программно начинает редактирование ячейки в позиции row и column, если эти индексы находятся в допустимом диапазоне, а ячейка с этими индексами доступна для редактирования.
void editingCanceled(ChangeEvent e)
Вызывается при отмене редактирования.
void editingStopped(ChangeEvent e)
Вызывается по завершении редактирования.
AccessibleContext getAccessibleContext()
Получает AccessibleContext, связанный с этим объектом JTable.
boolean getAutoCreateColumnsFromModel()
Определяет, будет ли таблица создавать столбцы по умолчанию из модели.
boolean getAutoCreateRowSorter()
Возвращает true, если при каждом изменении модели должен создаваться и устанавливаться в качестве сортировщика таблицы новый RowSorter; в противном случае возвращает false.
int getAutoResizeMode()
Возвращает режим автоматического изменения размера таблицы.
TableCellEditor getCellEditor()
Возвращает активный редактор ячеек или null, если в данный момент таблица не редактируется.
TableCellEditor getCellEditor(int row, int column)
Возвращает подходящий редактор для ячейки, заданной через row и column.
Rectangle getCellRect(int row, int column, boolean includeSpacing)
Возвращает прямоугольник для ячейки, находящейся на пересечении строки row и столбца column.
TableCellRenderer getCellRenderer(int row, int column)
Возвращает подходящий визуализатор для ячейки, заданной этой строкой и столбцом.
boolean getCellSelectionEnabled()
Возвращает true, если включены обе модели выделения — строк и столбцов.
TableColumn getColumn(Object identifier)
Возвращает объект TableColumn для столбца таблицы, идентификатор которого равен identifier при сравнении с помощью equals.
Class<?> getColumnClass(int column)
Возвращает тип столбца, отображаемого в представлении в позиции столбца column.
int getColumnCount()
Возвращает количество столбцов в модели столбцов.
TableColumnModel getColumnModel()
Возвращает TableColumnModel, содержащий всю информацию о столбцах этой таблицы.
String getColumnName(int column)
Возвращает имя столбца, отображаемого в представлении в позиции столбца column.
boolean getColumnSelectionAllowed()
Возвращает true, если столбцы можно выбирать.
TableCellEditor getDefaultEditor(Class<?> columnClass)
Возвращает редактор, используемый, когда в TableColumn не задан редактор.
TableCellRenderer getDefaultRenderer(Class<?> columnClass)
Возвращает визуализатор ячеек, используемый, когда в TableColumn не задан визуализатор.
boolean getDragEnabled()
Возвращает значение, определяющее, включена ли автоматическая обработка перетаскивания (drag).
final JTable.DropLocation getDropLocation()
Возвращает местоположение, которое этот компонент должен визуально отображать как место сброса во время операции DnD над компонентом, или null, если в данный момент местоположение отображаться не должно.
final DropMode getDropMode()
Возвращает режим сброса (drop mode) для этого компонента.
int getEditingColumn()
Возвращает индекс столбца, содержащего редактируемую в данный момент ячейку.
int getEditingRow()
Возвращает индекс строки, содержащей редактируемую в данный момент ячейку.
Component getEditorComponent()
Возвращает компонент, обрабатывающий сеанс редактирования.
boolean getFillsViewportHeight()
Возвращает значение, указывающее, делается ли эта таблица всегда достаточно большой, чтобы заполнить высоту объемлющей области просмотра (viewport).
Color getGridColor()
Возвращает цвет, используемый для отрисовки линий сетки.
Dimension getIntercellSpacing()
Возвращает горизонтальный и вертикальный интервал между ячейками.
TableModel getModel()
Возвращает TableModel, предоставляющую данные, отображаемые этим JTable.
Dimension getPreferredScrollableViewportSize()
Возвращает предпочтительный размер области просмотра для этой таблицы.
Printable getPrintable(JTable.PrintMode printMode, MessageFormat headerFormat, MessageFormat footerFormat)
Возвращает Printable для использования при печати этого JTable.
int getRowCount()
Возвращает количество строк, которые могут быть показаны в JTable при неограниченном пространстве.
int getRowHeight()
Возвращает высоту строки таблицы в пикселях.
int getRowHeight(int row)
Возвращает высоту (в пикселях) ячеек в row.
int getRowMargin()
Возвращает размер пустого пространства (в пикселях) между ячейками.
boolean getRowSelectionAllowed()
Возвращает true, если строки можно выбирать.
RowSorter<? extends TableModel> getRowSorter()
Возвращает объект, отвечающий за сортировку.
int getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
Возвращает visibleRect.height или visibleRect.width в зависимости от ориентации этой таблицы.
boolean getScrollableTracksViewportHeight()
Возвращает false, указывая, что высота области просмотра не определяет высоту таблицы, если только getFillsViewportHeight не равно true и предпочтительная высота таблицы не меньше высоты области просмотра.
boolean getScrollableTracksViewportWidth()
Возвращает false, если autoResizeMode установлено в AUTO_RESIZE_OFF, что указывает на то, что ширина области просмотра не определяет ширину таблицы.
int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
Возвращает шаг прокрутки (в пикселях), который полностью отображает одну новую строку или столбец (в зависимости от ориентации).
int getSelectedColumn()
Возвращает индекс первого выбранного столбца, или -1, если ни один столбец не выбран.
int getSelectedColumnCount()
Возвращает количество выбранных столбцов.
int[] getSelectedColumns()
Возвращает индексы всех выбранных столбцов.
int getSelectedRow()
Возвращает индекс первой выбранной строки, или -1, если ни одна строка не выбрана.
int getSelectedRowCount()
Возвращает количество выбранных строк.
int[] getSelectedRows()
Возвращает индексы всех выбранных строк.
Color getSelectionBackground()
Возвращает цвет фона для выбранных ячеек.
Color getSelectionForeground()
Возвращает цвет переднего плана для выбранных ячеек.
ListSelectionModel getSelectionModel()
Возвращает ListSelectionModel, который используется для поддержания состояния выделения строк.
boolean getShowHorizontalLines()
Возвращает true, если таблица отображает горизонтальные линии между ячейками, и false в противном случае.
boolean getShowVerticalLines()
Возвращает true, если таблица отображает вертикальные линии между ячейками, и false в противном случае.
boolean getSurrendersFocusOnKeystroke()
Возвращает true, если редактор должен получать фокус, когда нажатия клавиш приводят к активации редактора.
JTableHeader getTableHeader()
Возвращает tableHeader, используемый этим JTable.
String getToolTipText(MouseEvent event)
Переопределяет метод getToolTipText класса JComponent, чтобы разрешить использование подсказок визуализатора, если для него задан текст.
TableUI getUI()
Возвращает объект L&F, визуализирующий этот компонент.
String getUIClassID()
Возвращает суффикс, используемый для построения имени класса L&F, применяемого для визуализации этого компонента.
boolean getUpdateSelectionOnSort()
Возвращает true, если выделение должно обновляться после сортировки.
Object getValueAt(int row, int column)
Возвращает значение ячейки в позиции row и column.
protected void initializeLocalVars()
Инициализирует свойства таблицы их значениями по умолчанию.
boolean isCellEditable(int row, int column)
Возвращает true, если ячейка в позиции row и column доступна для редактирования.
boolean isCellSelected(int row, int column)
Возвращает true, если указанные индексы находятся в допустимом диапазоне строк и столбцов, а ячейка в указанной позиции выбрана.
boolean isColumnSelected(int column)
Возвращает true, если указанный индекс находится в допустимом диапазоне столбцов, а столбец с этим индексом выбран.
boolean isEditing()
Возвращает true, если ячейка редактируется в данный момент.
boolean isRowSelected(int row)
Возвращает true, если указанный индекс находится в допустимом диапазоне строк, а строка с этим индексом выбрана.
void moveColumn(int column, int targetColumn)
Перемещает столбец column на позицию, которую в представлении в данный момент занимает столбец targetColumn.
protected String paramString()
Возвращает строковое представление этой таблицы.
Component prepareEditor(TableCellEditor editor, int row, int column)
Подготавливает редактор, запрашивая у модели данных значение и состояние выделения ячейки в позиции row, column.
Component prepareRenderer(TableCellRenderer renderer, int row, int column)
Подготавливает визуализатор, запрашивая у модели данных значение и состояние выделения ячейки в позиции row, column.
boolean print()
Удобный метод, который отображает диалоговое окно печати, а затем выводит на печать этот JTable в режиме PrintMode.FIT_WIDTH без верхнего или нижнего колонтитулов.
boolean print(JTable.PrintMode printMode)
Удобный метод, который отображает диалоговое окно печати, а затем выводит на печать этот JTable в указанном режиме печати без верхнего или нижнего колонтитулов.
boolean print(JTable.PrintMode printMode, MessageFormat headerFormat, MessageFormat footerFormat)
Удобный метод, который отображает диалоговое окно печати, а затем выводит на печать этот JTable в указанном режиме печати с заданным текстом верхнего и нижнего колонтитулов.
boolean print(JTable.PrintMode printMode, MessageFormat headerFormat, MessageFormat footerFormat, boolean showPrintDialog, PrintRequestAttributeSet attr, boolean interactive)
Выводит эту таблицу на печать в соответствии с полнофункциональным методом print, при этом принтер по умолчанию задается в качестве службы печати.
boolean print(JTable.PrintMode printMode, MessageFormat headerFormat, MessageFormat footerFormat, boolean showPrintDialog, PrintRequestAttributeSet attr, boolean interactive, PrintService service)
Выводит на печать этот JTable.
void removeColumn(TableColumn aColumn)
Удаляет aColumn из массива столбцов этого JTable.
void removeColumnSelectionInterval(int index0, int index1)
Снимает выделение со столбцов от index0 до index1 включительно.
void removeEditor()
Удаляет объект редактора и освобождает область экрана, которую он использовал для отображения ячейки.
void removeNotify()
Вызывает метод unconfigureEnclosingScrollPane.
void removeRowSelectionInterval(int index0, int index1)
Снимает выделение со строк от index0 до index1 включительно.
protected void resizeAndRepaint()
Эквивалентно revalidate с последующим вызовом repaint.
int rowAtPoint(Point point)
Возвращает индекс строки, в которой находится point, или -1, если результат не входит в диапазон [0, getRowCount()-1].
void selectAll()
Выделяет все строки, столбцы и ячейки в таблице.
void setAutoCreateColumnsFromModel(boolean autoCreateColumnsFromModel)
Устанавливает для этой таблицы флаг autoCreateColumnsFromModel.
void setAutoCreateRowSorter(boolean autoCreateRowSorter)
Указывает, должен ли создаваться RowSorter для таблицы при каждом изменении ее модели.
void setAutoResizeMode(int mode)
Устанавливает режим автоматического изменения размера таблицы при изменении ее размера.
void setCellEditor(TableCellEditor anEditor)
Устанавливает активный редактор ячеек.
void setCellSelectionEnabled(boolean cellSelectionEnabled)
Задает, разрешает ли эта таблица одновременное существование выделения столбцов и выделения строк.
void setColumnModel(TableColumnModel columnModel)
Устанавливает модель столбцов для этой таблицы в columnModel и регистрируется для получения уведомлений слушателя от новой модели столбцов.
void setColumnSelectionAllowed(boolean columnSelectionAllowed)
Задает, могут ли столбцы в этой модели быть выделены.
void setColumnSelectionInterval(int index0, int index1)
Выделяет столбцы от index0 до index1 включительно.
void setDefaultEditor(Class<?> columnClass, TableCellEditor editor)
Устанавливает редактор ячеек по умолчанию, который будет использоваться, если в TableColumn не задан редактор.
void setDefaultRenderer(Class<?> columnClass, TableCellRenderer renderer)
Устанавливает визуализатор ячеек по умолчанию, который будет использоваться, если в TableColumn не задан визуализатор.
void setDragEnabled(boolean b)
Включает или выключает автоматическую обработку перетаскивания (drag).
final void setDropMode(DropMode dropMode)
Устанавливает режим сброса (drop mode) для этого компонента.
void setEditingColumn(int aColumn)
Устанавливает переменную editingColumn.
void setEditingRow(int aRow)
Устанавливает переменную editingRow.
void setFillsViewportHeight(boolean fillsViewportHeight)
Задает, будет ли эта таблица всегда достаточно большой, чтобы заполнить высоту объемлющей области просмотра.
void setGridColor(Color gridColor)
Устанавливает цвет, используемый для отрисовки линий сетки, в gridColor и обновляет отображение.
void setIntercellSpacing(Dimension intercellSpacing)
Устанавливает rowMargin и columnMargin — высоту и ширину промежутка между ячейками — в intercellSpacing.
void setModel(TableModel dataModel)
Устанавливает модель данных для этой таблицы в dataModel и регистрируется в ней для получения уведомлений слушателя от новой модели данных.
void setPreferredScrollableViewportSize(Dimension size)
Устанавливает предпочтительный размер области просмотра для этой таблицы.
void setRowHeight(int rowHeight)
Устанавливает высоту всех ячеек в пикселях в rowHeight, выполняет повторную валидацию и перерисовывает.
void setRowHeight(int row, int rowHeight)
Устанавливает высоту для row в rowHeight, выполняет повторную валидацию и перерисовывает.
void setRowMargin(int rowMargin)
Устанавливает размер пустого пространства между ячейками в соседних строках.
void setRowSelectionAllowed(boolean rowSelectionAllowed)
Задает, могут ли строки в этой модели быть выделены.
void setRowSelectionInterval(int index0, int index1)
Выделяет строки от index0 до index1 включительно.
void setRowSorter(RowSorter<? extends TableModel> sorter)
Устанавливает RowSorter.
void setSelectionBackground(Color selectionBackground)
Устанавливает цвет фона для выбранных ячеек.
void setSelectionForeground(Color selectionForeground)
Устанавливает цвет переднего плана для выбранных ячеек.
void setSelectionMode(int selectionMode)
Устанавливает режим выделения таблицы, разрешая выбор только одного элемента, одного непрерывного интервала или нескольких интервалов.
void setSelectionModel(ListSelectionModel selectionModel)
Устанавливает модель выделения строк для этой таблицы в selectionModel и регистрируется для получения уведомлений слушателя от новой модели выделения.
void setShowGrid(boolean showGrid)
Задает, рисует ли таблица линии сетки вокруг ячеек.
void setShowHorizontalLines(boolean showHorizontalLines)
Задает, рисует ли таблица горизонтальные линии между ячейками.
void setShowVerticalLines(boolean showVerticalLines)
Задает, рисует ли таблица вертикальные линии между ячейками.
void setSurrendersFocusOnKeystroke(boolean surrendersFocusOnKeystroke)
Задает, получают ли редакторы в этом JTable фокус клавиатуры, когда редактор активируется в результате пересылки объектом JTable событий клавиатуры для ячейки.
void setTableHeader(JTableHeader tableHeader)
Устанавливает tableHeader, работающий с этим JTable, в newHeader.
void setUI(TableUI ui)
Устанавливает объект L&F, визуализирующий этот компонент, и выполняет перерисовку.
void setUpdateSelectionOnSort(boolean update)
Указывает, должно ли выделение обновляться после сортировки.
void setValueAt(Object aValue, int row, int column)
Задает значение для ячейки в модели таблицы в позиции row и column.
void sizeColumnsToFit(boolean lastColumnOnly)
Устарело.
Начиная с версии Swing 1.0.3, заменено на doLayout().
void sizeColumnsToFit(int resizingColumn)
Устарело, начиная с платформы Java 2 v1.4.
void sorterChanged(RowSorterEvent e)
RowSorterListener уведомление о том, что RowSorter каким-либо образом изменился.
void tableChanged(TableModelEvent e)
Вызывается, когда TableModel этой таблицы генерирует TableModelEvent.
protected void unconfigureEnclosingScrollPane()
Отменяет действие configureEnclosingScrollPane путем замены columnHeaderView вмещающей панели прокрутки на null.
void updateUI()
Уведомление от UIManager об изменении L&F.
void valueChanged(ListSelectionEvent e)
Вызывается при изменении выбора строки — перерисовывает компонент для отображения нового выделения.

Методы, объявленные в классе JComponent

addAncestorListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
Модификатор и тип Метод Описание
void addAncestorListener(AncestorListener listener)
Регистрирует listener для получения AncestorEvents при перемещении самого компонента или любого из его предков, а также при изменении их видимости.
void addVetoableChangeListener(VetoableChangeListener listener)
Добавляет VetoableChangeListener в список слушателей.
void computeVisibleRect(Rectangle visibleRect)
Возвращает "видимый прямоугольник" компонента Component — пересечение видимых прямоугольников для этого компонента и всех его предков.
boolean contains(int x, int y)
Предоставляет делегату UI возможность определить точную форму этого компонента для обработки событий мыши.
JToolTip createToolTip()
Возвращает экземпляр JToolTip, который должен использоваться для отображения всплывающей подсказки.
void disable()
Устарело.
Начиная с версии JDK 1.1, заменено на java.awt.Component.setEnabled(boolean).
void enable()
Устарело.
Начиная с версии JDK 1.1, заменено на java.awt.Component.setEnabled(boolean).
void firePropertyChange(String propertyName, boolean oldValue, boolean newValue)
Поддержка создания отчетов об изменениях связанных логических (boolean) свойств.
void firePropertyChange(String propertyName, int oldValue, int newValue)
Поддержка создания отчетов об изменениях связанных целочисленных (integer) свойств.
protected void fireVetoableChange(String propertyName, Object oldValue, Object newValue)
Поддержка создания отчетов об изменениях свойств с ограничениями (constrained properties).
ActionListener getActionForKeyStroke(KeyStroke aKeyStroke)
Возвращает объект, который будет выполнять действие, зарегистрированное для заданной комбинации клавиш.
final ActionMap getActionMap()
Возвращает ActionMap, используемый для определения того, какое Action вызывать для конкретной привязки KeyStroke.
float getAlignmentX()
Переопределяет Container.getAlignmentX для возврата выравнивания по горизонтали.
float getAlignmentY()
Переопределяет Container.getAlignmentY для возврата выравнивания по вертикали.
AncestorListener[] getAncestorListeners()
Возвращает массив всех слушателей предков, зарегистрированных на этом компоненте.
boolean getAutoscrolls()
Возвращает свойство autoscrolls.
int getBaseline(int width, int height)
Возвращает базовую линию.
Component.BaselineResizeBehavior getBaselineResizeBehavior()
Возвращает перечисление, указывающее, как базовая линия компонента изменяется при изменении размера.
Border getBorder()
Возвращает границу этого компонента или null, если граница в данный момент не установлена.
Rectangle getBounds(Rectangle rv)
Сохраняет границы этого компонента в "возвращаемое значение" rv и возвращает rv.
final Object getClientProperty(Object key)
Возвращает значение свойства с указанным ключом.
protected Graphics getComponentGraphics(Graphics g)
Возвращает графический объект, используемый для отрисовки этого компонента.
JPopupMenu getComponentPopupMenu()
Возвращает JPopupMenu, назначенный для этого компонента.
int getConditionForKeyStroke(KeyStroke aKeyStroke)
Возвращает условие, определяющее, выполняется ли зарегистрированное действие в ответ на указанное нажатие клавиши.
int getDebugGraphicsOptions()
Возвращает состояние отладки графики.
static Locale getDefaultLocale()
Возвращает локаль по умолчанию, используемую для инициализации свойства locale каждого JComponent при создании.
FontMetrics getFontMetrics(Font font)
Получает FontMetrics для указанного Font.
Graphics getGraphics()
Возвращает графический контекст этого компонента, который позволяет рисовать на нем.
int getHeight()
Возвращает текущую высоту этого компонента.
boolean getInheritsPopupMenu()
Возвращает true, если JPopupMenu должен наследоваться от родительского компонента.
final InputMap getInputMap()
Возвращает InputMap, который используется, когда компонент находится в фокусе.
final InputMap getInputMap(int condition)
Возвращает InputMap, который используется во время condition.
InputVerifier getInputVerifier()
Возвращает верификатор ввода для этого компонента.
Insets getInsets()
Если для этого компонента установлена граница, возвращает отступы границы; в противном случае вызывает super.getInsets.
Insets getInsets(Insets insets)
Возвращает объект Insets, содержащий значения внутренних отступов (insets) этого компонента.
<T extends EventListener>
T[]
getListeners(Class<T> listenerType)
Возвращает массив всех объектов, зарегистрированных в данный момент как FooListener для этого JComponent.
Point getLocation(Point rv)
Сохраняет координаты x,y начала этого компонента в "возвращаемое значение" rv и возвращает rv.
Dimension getMaximumSize()
Если максимальный размер был задан не равным null, просто возвращает его.
Dimension getMinimumSize()
Если минимальный размер был задан не равным null, просто возвращает его.
Component getNextFocusableComponent()
Устарело.
Начиная с версии 1.4, заменено на FocusTraversalPolicy.
Point getPopupLocation(MouseEvent event)
Возвращает предпочтительное местоположение для отображения всплывающего меню в системе координат этого компонента.
Dimension getPreferredSize()
Если свойство preferredSize было установлено в значение, отличное от null, просто возвращает его.
KeyStroke[] getRegisteredKeyStrokes()
Возвращает KeyStrokes, который будет инициировать зарегистрированные действия.
JRootPane getRootPane()
Возвращает предка JRootPane для этого компонента.
Dimension getSize(Dimension rv)
Сохраняет ширину/высоту этого компонента в "возвращаемое значение" rv и возвращает rv.
Point getToolTipLocation(MouseEvent event)
Возвращает местоположение всплывающей подсказки в системе координат этого компонента.
String getToolTipText()
Возвращает строку подсказки, установленную с помощью setToolTipText.
Container getTopLevelAncestor()
Возвращает предка верхнего уровня этого компонента (содержащий Window) или null, если этот компонент не был добавлен ни в один контейнер.
TransferHandler getTransferHandler()
Получает свойство transferHandler.
boolean getVerifyInputWhenFocusTarget()
Возвращает значение, указывающее, будет ли вызываться верификатор ввода для текущего владельца фокуса перед тем, как этот компонент запросит фокус.
VetoableChangeListener[] getVetoableChangeListeners()
Возвращает массив всех слушателей вето-изменений, зарегистрированных на этом компоненте.
Rectangle getVisibleRect()
Возвращает "видимый прямоугольник" компонента Component — пересечение видимого прямоугольника этого компонента, new Rectangle(0, 0, getWidth(), getHeight()), и видимых прямоугольников всех его предков.
int getWidth()
Возвращает текущую ширину этого компонента.
int getX()
Возвращает текущую координату x начала этого компонента.
int getY()
Возвращает текущую координату y начала этого компонента.
void grabFocus()
Запрашивает передачу фокуса ввода этому Component, а также чтобы предок верхнего уровня этого Component стал сфокусированным Window.
void hide()
Устарело.
boolean isDoubleBuffered()
Возвращает, должен ли этот компонент использовать буфер для отрисовки.
static boolean isLightweightComponent(Component c)
Возвращает true, если этот компонент является легковесным, то есть если у него нет нативного аналога в оконной системе.
boolean isManagingFocus()
Устарело.
Начиная с версии 1.4, заменено на Component.setFocusTraversalKeys(int, Set) и Container.setFocusCycleRoot(boolean).
boolean isOpaque()
Возвращает true, если этот компонент полностью непрозрачен.
boolean isOptimizedDrawingEnabled()
Возвращает true, если этот компонент размещает свои дочерние элементы мозаично — то есть гарантирует, что дочерние элементы не будут перекрываться.
final boolean isPaintingForPrint()
Возвращает true, если текущая операция отрисовки на этом компоненте является частью операции print.
protected boolean isPaintingOrigin()
Возвращает true, если отрисовка, вызванная дочерним компонентом, должна начинаться с этого Component или одного из его предков.
boolean isPaintingTile()
Возвращает true, если компонент в данный момент отрисовывает тайл.
boolean isRequestFocusEnabled()
Возвращает true, если этот JComponent должен получить фокус; в противном случае возвращает false.
boolean isValidateRoot()
Если этот метод возвращает true, вызовы revalidate потомками этого компонента приведут к проверке валидности всего дерева, начиная с этого корня.
void paint(Graphics g)
Вызывается Swing для отрисовки компонентов.
protected void paintBorder(Graphics g)
Отрисовывает границу компонента.
protected void paintChildren(Graphics g)
Отрисовывает дочерние элементы этого компонента.
protected void paintComponent(Graphics g)
Вызывает метод paint делегата UI, если делегат UI не равен null.
void paintImmediately(int x, int y, int w, int h)
Немедленно перерисовывает указанную область в этом компоненте и всех его потомках, перекрывающих эту область.
void paintImmediately(Rectangle r)
Перерисовывает указанную область прямо сейчас.
void print(Graphics g)
Вызовите этот метод для вывода компонента на печать в указанный Graphics.
void printAll(Graphics g)
Вызовите этот метод для вывода компонента на печать.
protected void printBorder(Graphics g)
Выводит на печать границу компонента.
protected void printChildren(Graphics g)
Выводит на печать дочерние элементы этого компонента.
protected void printComponent(Graphics g)
Вызывается во время операции печати.
protected void processComponentKeyEvent(KeyEvent e)
Обрабатывает любые события клавиатуры, распознаваемые самим компонентом.
protected boolean processKeyBinding(KeyStroke ks, KeyEvent e, int condition, boolean pressed)
Вызывается для обработки привязок клавиш для ks в результате KeyEvent e.
protected void processKeyEvent(KeyEvent e)
Переопределяет processKeyEvent для обработки событий.
protected void processMouseEvent(MouseEvent e)
Обрабатывает события мыши, происходящие на этом компоненте, путем их диспетчеризации любым зарегистрированным объектам MouseListener; полное описание этого метода см. в Component.processMouseEvent(MouseEvent).
protected void processMouseMotionEvent(MouseEvent e)
Обрабатывает события движения мыши, такие как MouseEvent.MOUSE_DRAGGED.
final void putClientProperty(Object key, Object value)
Добавляет произвольное клиентское свойство типа "ключ/значение" к этому компоненту.
void registerKeyboardAction(ActionListener anAction, String aCommand, KeyStroke aKeyStroke, int aCondition)
Этот метод устарел; используйте комбинацию getActionMap() и getInputMap() для аналогичного поведения.
void registerKeyboardAction(ActionListener anAction, KeyStroke aKeyStroke, int aCondition)
Этот метод устарел; используйте комбинацию getActionMap() и getInputMap() для аналогичного поведения.
void removeAncestorListener(AncestorListener listener)
Отменяет регистрацию listener, чтобы он больше не получал AncestorEvents.
void removeVetoableChangeListener(VetoableChangeListener listener)
Удаляет VetoableChangeListener из списка слушателей.
void repaint(long tm, int x, int y, int width, int height)
Добавляет указанную область в список недействительных (грязных) областей, если компонент отображается.
void repaint(Rectangle r)
Добавляет указанную область в список недействительных (грязных) областей, если компонент отображается.
boolean requestDefaultFocus()
Устарело.
Начиная с версии 1.4, заменено на FocusTraversalPolicy.getDefaultComponent(Container).requestFocus()
void requestFocus()
Запрашивает получение фокуса ввода этим Component.
boolean requestFocus(boolean temporary)
Запрашивает получение фокуса ввода этим Component.
boolean requestFocusInWindow()
Запрашивает получение фокуса ввода этим Component.
protected boolean requestFocusInWindow(boolean temporary)
Запрашивает получение фокуса ввода этим Component.
void resetKeyboardActions()
Отменяет все привязки в первом уровне InputMaps и ActionMap.
void reshape(int x, int y, int w, int h)
Устарело.
Начиная с версии JDK 5, заменено на Component.setBounds(int, int, int, int).
void revalidate()
Поддерживает отложенную автоматическую компоновку.
void scrollRectToVisible(Rectangle aRect)
Пересылает сообщение scrollRectToVisible() родителю JComponent.
final void setActionMap(ActionMap am)
Устанавливает ActionMap в am.
void setAlignmentX(float alignmentX)
Устанавливает выравнивание по горизонтали.
void setAlignmentY(float alignmentY)
Устанавливает выравнивание по вертикали.
void setAutoscrolls(boolean autoscrolls)
Устанавливает свойство autoscrolls.
void setBackground(Color bg)
Устанавливает цвет фона этого компонента.
void setBorder(Border border)
Устанавливает границу этого компонента.
void setComponentPopupMenu(JPopupMenu popup)
Устанавливает JPopupMenu для этого JComponent.
void setDebugGraphicsOptions(int debugOptions)
Включает или отключает диагностическую информацию о каждой графической операции, выполняемой внутри компонента или одного из его дочерних элементов.
static void setDefaultLocale(Locale l)
Устанавливает локаль по умолчанию, используемую для инициализации свойства locale каждого JComponent при создании.
void setDoubleBuffered(boolean aFlag)
Устанавливает, должен ли этот компонент использовать буфер для отрисовки.
void setEnabled(boolean enabled)
Устанавливает, включен ли этот компонент.
void setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)
Устанавливает клавиши перемещения фокуса для заданной операции перемещения для этого Component.
void setFont(Font font)
Устанавливает шрифт для этого компонента.
void setForeground(Color fg)
Устанавливает цвет переднего плана этого компонента.
void setInheritsPopupMenu(boolean value)
Устанавливает, должен ли getComponentPopupMenu делегировать запросы родительскому компоненту, если этому компоненту не назначен JPopupMenu.
final void setInputMap(int condition, InputMap map)
Устанавливает InputMap для использования при условии condition в map.
void setInputVerifier(InputVerifier inputVerifier)
Устанавливает верификатор ввода для этого компонента.
void setMaximumSize(Dimension maximumSize)
Устанавливает максимальный размер этого компонента в константное значение.
void setMinimumSize(Dimension minimumSize)
Устанавливает минимальный размер этого компонента в константное значение.
void setNextFocusableComponent(Component aComponent)
Устарело.
Начиная с версии 1.4, заменено на FocusTraversalPolicy
void setOpaque(boolean isOpaque)
Если true, компонент отрисовывает каждый пиксель в пределах своих границ.
void setPreferredSize(Dimension preferredSize)
Устанавливает предпочтительный размер этого компонента.
void setRequestFocusEnabled(boolean requestFocusEnabled)
Дает подсказку относительно того, должен ли этот JComponent получать фокус.
void setToolTipText(String text)
Регистрирует текст для отображения во всплывающей подсказке.
void setTransferHandler(TransferHandler newHandler)
Устанавливает TransferHandler, который обеспечивает поддержку передачи данных в этот компонент и из него через вырезание/копирование/вставку и перетаскивание (drag and drop).
protected void setUI(ComponentUI newUI)
Устанавливает делегат внешнего вида (look and feel) для этого компонента.
void setVerifyInputWhenFocusTarget(boolean verifyInputWhenFocusTarget)
Устанавливает значение, указывающее, будет ли вызываться верификатор ввода для текущего владельца фокуса перед тем, как этот компонент запросит фокус.
void setVisible(boolean aFlag)
Делает компонент видимым или невидимым.
void unregisterKeyboardAction(KeyStroke aKeyStroke)
Этот метод устарел.
void update(Graphics g)
Вызывает paint.

Методы, объявленные в классе Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree
Модификатор и тип Метод Описание
Component add(Component comp)
Добавляет указанный компонент в конец этого контейнера.
Component add(Component comp, int index)
Добавляет указанный компонент в этот контейнер в заданную позицию.
void add(Component comp, Object constraints)
Добавляет указанный компонент в конец этого контейнера.
void add(Component comp, Object constraints, int index)
Добавляет указанный компонент в этот контейнер с указанными ограничениями по указанному индексу.
Component add(String name, Component comp)
Добавляет указанный компонент в этот контейнер.
void addContainerListener(ContainerListener l)
Добавляет указанный слушатель контейнера для получения событий контейнера от этого контейнера.
protected void addImpl(Component comp, Object constraints, int index)
Добавляет указанный компонент в этот контейнер по указанному индексу.
void addPropertyChangeListener(PropertyChangeListener listener)
Добавляет PropertyChangeListener в список слушателей.
void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
Добавляет PropertyChangeListener в список слушателей для определенного свойства.
void applyComponentOrientation(ComponentOrientation o)
Задает свойство ComponentOrientation этого контейнера и всех содержащихся в нем компонентов.
boolean areFocusTraversalKeysSet(int id)
Возвращает значение, указывающее, был ли явно определен набор клавиш перехода фокуса для заданной операции перехода фокуса для этого Container.
int countComponents()
Устарело.
Начиная с версии JDK 1.1, заменено на getComponentCount().
void deliverEvent(Event e)
Устарело.
Начиная с версии JDK 1.1, заменено на dispatchEvent(AWTEvent e)
Component findComponentAt(int x, int y)
Находит видимый дочерний компонент, содержащий указанную позицию.
Component findComponentAt(Point p)
Находит видимый дочерний компонент, содержащий указанную точку.
Component getComponent(int n)
Возвращает n-й компонент в этом контейнере.
Component getComponentAt(int x, int y)
Находит компонент, содержащий позицию x,y.
Component getComponentAt(Point p)
Возвращает компонент, содержащий указанную точку.
int getComponentCount()
Возвращает количество компонентов в этой панели.
Component[] getComponents()
Возвращает все компоненты в этом контейнере.
int getComponentZOrder(Component comp)
Возвращает индекс z-порядка компонента внутри контейнера.
ContainerListener[] getContainerListeners()
Возвращает массив всех слушателей контейнера, зарегистрированных в этом контейнере.
Set<AWTKeyStroke> getFocusTraversalKeys(int id)
Возвращает набор клавиш перехода фокуса для заданной операции перехода для этого Container.
FocusTraversalPolicy getFocusTraversalPolicy()
Возвращает политику перехода фокуса, которая будет управлять переходом с клавиатуры по дочерним элементам этого Container, или null, если этот Container не является корнем цикла фокуса.
LayoutManager getLayout()
Возвращает диспетчер компоновки для этого контейнера.
Point getMousePosition(boolean allowChildren)
Возвращает положение указателя мыши в пространстве координат этого Container, если Container находится под указателем мыши, в противном случае возвращает null.
Insets insets()
Устарело.
Начиная с версии JDK 1.1, заменено на getInsets().
void invalidate()
Делает контейнер недействительным.
boolean isAncestorOf(Component c)
Проверяет, содержится ли компонент в иерархии компонентов этого контейнера.
boolean isFocusCycleRoot()
Возвращает значение, указывающее, является ли этот Container корнем цикла перехода фокуса.
boolean isFocusCycleRoot(Container container)
Возвращает значение, указывающее, является ли указанный Container корнем цикла перехода фокуса для цикла перехода фокуса этого Container.
final boolean isFocusTraversalPolicyProvider()
Возвращает значение, указывающее, предоставляет ли этот контейнер политику перехода фокуса.
boolean isFocusTraversalPolicySet()
Возвращает значение, указывающее, была ли явно установлена политика перехода фокуса для этого Container.
void layout()
Устарело.
Начиная с версии JDK 1.1, заменено на doLayout().
void list(PrintStream out, int indent)
Выводит список компонентов этого контейнера в указанный выходной поток.
void list(PrintWriter out, int indent)
Выводит список, начиная с указанного отступа, в указанный print writer.
Component locate(int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на getComponentAt(int, int).
Dimension minimumSize()
Устарело.
Начиная с версии JDK 1.1, заменено на getMinimumSize().
void paintComponents(Graphics g)
Отрисовывает каждый из компонентов в этом контейнере.
Dimension preferredSize()
Устарело.
Начиная с версии JDK 1.1, заменено на getPreferredSize().
void printComponents(Graphics g)
Печатает каждый из компонентов в этом контейнере.
protected void processContainerEvent(ContainerEvent e)
Обрабатывает события контейнера, происходящие в этом контейнере, отправляя их всем зарегистрированным объектам ContainerListener.
protected void processEvent(AWTEvent e)
Обрабатывает события в этом контейнере.
void remove(int index)
Удаляет компонент, указанный index, из этого контейнера.
void remove(Component comp)
Удаляет указанный компонент из этого контейнера.
void removeAll()
Удаляет все компоненты из этого контейнера.
void removeContainerListener(ContainerListener l)
Удаляет указанный слушатель контейнера, чтобы он больше не получал события контейнера от этого контейнера.
void setComponentZOrder(Component comp, int index)
Перемещает указанный компонент на указанный индекс z-порядка в контейнере.
void setFocusCycleRoot(boolean focusCycleRoot)
Устанавливает, является ли этот Container корнем цикла перехода фокуса.
void setFocusTraversalPolicy(FocusTraversalPolicy policy)
Задает политику перехода фокуса, которая будет управлять переходом с клавиатуры по дочерним элементам этого Container, если этот Container является корнем цикла фокуса.
final void setFocusTraversalPolicyProvider(boolean provider)
Устанавливает, будет ли этот контейнер использоваться для предоставления политики перехода фокуса.
void setLayout(LayoutManager mgr)
Задает диспетчер компоновки для этого контейнера.
void transferFocusDownCycle()
Передает фокус на один цикл перехода фокуса вниз.
void validate()
Проверяет допустимость этого контейнера и всех его подкомпонентов.
protected void validateTree()
Рекурсивно спускается по дереву контейнеров и повторно вычисляет компоновку для любых поддеревьев, помеченных как нуждающиеся в этом (помеченных как недействительные).

Методы, объявленные в классе Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
Модификатор и тип Метод Описание
boolean action(Event evt, Object what)
Устарело.
Начиная с версии JDK 1.1 следует регистрировать этот компонент как ActionListener на компоненте, генерирующем события действия.
void add(PopupMenu popup)
Добавляет указанное всплывающее меню к компоненту.
void addComponentListener(ComponentListener l)
Добавляет указанный слушатель компонентов для получения событий компонента от этого компонента.
void addFocusListener(FocusListener l)
Добавляет указанный слушатель фокуса для получения событий фокуса от этого компонента при получении им фокуса ввода.
void addHierarchyBoundsListener(HierarchyBoundsListener l)
Добавляет указанный слушатель границ иерархии для получения событий границ иерархии от этого компонента при изменении иерархии, к которой принадлежит этот контейнер.
void addHierarchyListener(HierarchyListener l)
Добавляет указанный слушатель иерархии для получения событий изменения иерархии от этого компонента при изменении иерархии, к которой принадлежит этот контейнер.
void addInputMethodListener(InputMethodListener l)
Добавляет указанный слушатель метода ввода для получения событий метода ввода от этого компонента.
void addKeyListener(KeyListener l)
Добавляет указанный слушатель клавиатуры для получения событий клавиш от этого компонента.
void addMouseListener(MouseListener l)
Добавляет указанный слушатель мыши для получения событий мыши от этого компонента.
void addMouseMotionListener(MouseMotionListener l)
Добавляет указанный слушатель движения мыши для получения событий движения мыши от этого компонента.
void addMouseWheelListener(MouseWheelListener l)
Добавляет указанный слушатель колесика мыши для получения событий колесика мыши от этого компонента.
Rectangle bounds()
Устарело.
Начиная с версии JDK 1.1, заменено на getBounds().
int checkImage(Image image, int width, int height, ImageObserver observer)
Возвращает статус построения экранного представления указанного изображения.
int checkImage(Image image, ImageObserver observer)
Возвращает статус построения экранного представления указанного изображения.
protected AWTEvent coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)
Потенциально объединяет отправляемое событие с существующим событием.
boolean contains(Point p)
Проверяет, "содержит" ли этот компонент указанную точку, где координаты x и y точки определены относительно системы координат этого компонента.
Image createImage(int width, int height)
Создает закадровое отрисовываемое изображение, используемое для двойной буферизации.
Image createImage(ImageProducer producer)
Создает изображение из указанного поставщика изображений.
VolatileImage createVolatileImage(int width, int height)
Создает временное (volatile) закадровое отрисовываемое изображение, используемое для двойной буферизации.
VolatileImage createVolatileImage(int width, int height, ImageCapabilities caps)
Создает временное (volatile) закадровое отрисовываемое изображение с заданными возможностями.
protected final void disableEvents(long eventsToDisable)
Отключает доставку событий, определенных указанным параметром маски событий, в этот компонент.
final void dispatchEvent(AWTEvent e)
Диспетчеризирует событие этому компоненту или одному из его подкомпонентов.
void enable(boolean b)
Устарело.
Начиная с версии JDK 1.1, заменено на setEnabled(boolean).
protected final void enableEvents(long eventsToEnable)
Включает доставку событий, определенных указанным параметром маски событий, в этот компонент.
void enableInputMethods(boolean enable)
Включает или отключает поддержку методов ввода для этого компонента.
void firePropertyChange(String propertyName, byte oldValue, byte newValue)
Сообщает об изменении связанного свойства.
void firePropertyChange(String propertyName, char oldValue, char newValue)
Сообщает об изменении связанного свойства.
void firePropertyChange(String propertyName, double oldValue, double newValue)
Сообщает об изменении связанного свойства.
void firePropertyChange(String propertyName, float oldValue, float newValue)
Сообщает об изменении связанного свойства.
void firePropertyChange(String propertyName, long oldValue, long newValue)
Сообщает об изменении связанного свойства.
void firePropertyChange(String propertyName, short oldValue, short newValue)
Сообщает об изменении связанного свойства.
protected void firePropertyChange(String propertyName, Object oldValue, Object newValue)
Поддержка отправки сообщений об изменениях связанных свойств типа Object.
Color getBackground()
Возвращает цвет фона этого компонента.
Rectangle getBounds()
Возвращает границы этого компонента в виде объекта Rectangle.
ColorModel getColorModel()
Возвращает экземпляр ColorModel, используемый для отображения компонента на устройстве вывода.
ComponentListener[] getComponentListeners()
Возвращает массив всех слушателей компонентов, зарегистрированных для этого компонента.
ComponentOrientation getComponentOrientation()
Возвращает ориентацию с учетом языка, которая должна использоваться для упорядочивания элементов или текста внутри этого компонента.
Cursor getCursor()
Возвращает курсор, установленный в компоненте.
DropTarget getDropTarget()
Возвращает DropTarget, связанный с этим Component.
Container getFocusCycleRootAncestor()
Возвращает Container, который является корнем цикла обхода фокуса для этого Component.
FocusListener[] getFocusListeners()
Возвращает массив всех слушателей фокуса, зарегистрированных для этого компонента.
boolean getFocusTraversalKeysEnabled()
Возвращает значение, указывающее, включены ли клавиши обхода фокуса для этого Component.
Font getFont()
Возвращает шрифт этого компонента.
Color getForeground()
Возвращает цвет переднего плана этого компонента.
GraphicsConfiguration getGraphicsConfiguration()
Возвращает GraphicsConfiguration, связанный с этим Component.
HierarchyBoundsListener[] getHierarchyBoundsListeners()
Возвращает массив всех слушателей границ иерархии, зарегистрированных для этого компонента.
HierarchyListener[] getHierarchyListeners()
Возвращает массив всех слушателей иерархии, зарегистрированных для этого компонента.
boolean getIgnoreRepaint()
Возвращает значение, указывающее, следует ли игнорировать сообщения отрисовки, полученные от операционной системы.
InputContext getInputContext()
Возвращает контекст ввода, используемый этим компонентом для взаимодействия с методами ввода при вводе текста в этот компонент.
InputMethodListener[] getInputMethodListeners()
Возвращает массив всех слушателей методов ввода, зарегистрированных для этого компонента.
InputMethodRequests getInputMethodRequests()
Возвращает обработчик запросов метода ввода, поддерживающий запросы от методов ввода для этого компонента.
KeyListener[] getKeyListeners()
Возвращает массив всех слушателей клавиатуры, зарегистрированных для этого компонента.
Locale getLocale()
Возвращает локаль этого компонента.
Point getLocation()
Возвращает положение этого компонента в виде точки, определяющей верхний левый угол компонента.
Point getLocationOnScreen()
Возвращает положение этого компонента в виде точки, определяющей верхний левый угол компонента в пространстве координат экрана.
MouseListener[] getMouseListeners()
Возвращает массив всех слушателей мыши, зарегистрированных для этого компонента.
MouseMotionListener[] getMouseMotionListeners()
Возвращает массив всех слушателей движения мыши, зарегистрированных для этого компонента.
Point getMousePosition()
Возвращает позицию указателя мыши в пространстве координат этого Component, если Component находится непосредственно под указателем мыши, в противном случае возвращает null.
MouseWheelListener[] getMouseWheelListeners()
Возвращает массив всех слушателей колесика мыши, зарегистрированных для этого компонента.
String getName()
Возвращает имя компонента.
Container getParent()
Возвращает родительский компонент для этого компонента.
PropertyChangeListener[] getPropertyChangeListeners()
Возвращает массив всех слушателей изменения свойств, зарегистрированных для этого компонента.
PropertyChangeListener[] getPropertyChangeListeners(String propertyName)
Возвращает массив всех слушателей, связанных с указанным свойством.
Dimension getSize()
Возвращает размер этого компонента в виде объекта Dimension.
Toolkit getToolkit()
Возвращает инструментарий (toolkit) этого компонента.
final Object getTreeLock()
Возвращает объект блокировки этого компонента (объект, владеющий монитором синхронизации потоков) для операций с деревом компонентов AWT и разметкой.
boolean gotFocus(Event evt, Object what)
Устарело.
Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent).
boolean handleEvent(Event evt)
Устарело.
Начиная с версии JDK 1.1, заменено на processEvent(AWTEvent).
boolean hasFocus()
Возвращает true, если этот Component является владельцем фокуса.
boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
Перерисовывает компонент при изменении изображения.
boolean inside(int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на contains(int, int).
boolean isBackgroundSet()
Возвращает значение, указывающее, был ли цвет фона явно установлен для этого Component.
boolean isCursorSet()
Возвращает значение, указывающее, был ли курсор явно установлен для этого Component.
boolean isDisplayable()
Определяет, является ли этот компонент отображаемым.
boolean isEnabled()
Определяет, включен ли этот компонент.
boolean isFocusable()
Возвращает значение, указывающее, может ли этот Component получать фокус.
boolean isFocusOwner()
Возвращает true, если этот Component является владельцем фокуса.
boolean isFocusTraversable()
Устарело.
Начиная с версии 1.4, заменено на isFocusable().
boolean isFontSet()
Возвращает значение, указывающее, был ли шрифт явно установлен для этого Component.
boolean isForegroundSet()
Возвращает значение, указывающее, был ли цвет переднего плана явно установлен для этого Component.
boolean isLightweight()
Легковесный компонент не имеет собственного платформенного аналога (peer).
boolean isMaximumSizeSet()
Возвращает true, если максимальный размер был установлен в значение, отличное от null, иначе возвращает false.
boolean isMinimumSizeSet()
Возвращает значение, указывающее, вызывался ли метод setMinimumSize со значением, отличным от null.
boolean isPreferredSizeSet()
Возвращает true, если предпочтительный размер был установлен в значение, отличное от null, иначе возвращает false.
boolean isShowing()
Определяет, отображается ли этот компонент на экране.
boolean isValid()
Определяет, является ли этот компонент корректным (valid).
boolean isVisible()
Определяет, должен ли этот компонент быть видимым, когда видим его родительский компонент.
boolean keyDown(Event evt, int key)
Устарело.
Начиная с версии JDK 1.1, заменено на processKeyEvent(KeyEvent).
boolean keyUp(Event evt, int key)
Устарело.
Начиная с версии JDK 1.1, заменено на processKeyEvent(KeyEvent).
void list()
Выводит список данных этого компонента в стандартный системный поток вывода System.out.
void list(PrintStream out)
Выводит список данных этого компонента в указанный поток вывода.
void list(PrintWriter out)
Выводит список данных в указанный модуль записи (print writer).
Point location()
Устарело.
Начиная с версии JDK 1.1, заменено на getLocation().
boolean lostFocus(Event evt, Object what)
Устарело.
Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent).
boolean mouseDown(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
boolean mouseDrag(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent).
boolean mouseEnter(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
boolean mouseExit(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
boolean mouseMove(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent).
boolean mouseUp(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
void move(int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на setLocation(int, int).
void nextFocus()
Устарело.
Начиная с версии JDK 1.1, заменено на transferFocus().
void paintAll(Graphics g)
Отрисовывает этот компонент и все его подкомпоненты.
boolean postEvent(Event e)
Устарело.
Начиная с версии JDK 1.1, заменено на dispatchEvent(AWTEvent).
boolean prepareImage(Image image, int width, int height, ImageObserver observer)
Подготавливает изображение для отрисовки на этом компоненте с указанными шириной и высотой.
boolean prepareImage(Image image, ImageObserver observer)
Подготавливает изображение для отрисовки на этом компоненте.
protected void processComponentEvent(ComponentEvent e)
Обрабатывает события компонента, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам ComponentListener.
protected void processFocusEvent(FocusEvent e)
Обрабатывает события фокуса, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам FocusListener.
protected void processHierarchyBoundsEvent(HierarchyEvent e)
Обрабатывает события границ иерархии, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам HierarchyBoundsListener.
protected void processHierarchyEvent(HierarchyEvent e)
Обрабатывает события иерархии, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам HierarchyListener.
protected void processInputMethodEvent(InputMethodEvent e)
Обрабатывает события метода ввода, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам InputMethodListener.
protected void processMouseWheelEvent(MouseWheelEvent e)
Обрабатывает события колесика мыши, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам MouseWheelListener.
void remove(MenuComponent popup)
Удаляет указанное всплывающее меню из компонента.
void removeComponentListener(ComponentListener l)
Удаляет указанный слушатель компонентов, чтобы он больше не получал события компонента от этого компонента.
void removeFocusListener(FocusListener l)
Удаляет указанный слушатель фокуса, чтобы он больше не получал события фокуса от этого компонента.
void removeHierarchyBoundsListener(HierarchyBoundsListener l)
Удаляет указанный слушатель границ иерархии, чтобы он больше не получал события границ иерархии от этого компонента.
void removeHierarchyListener(HierarchyListener l)
Удаляет указанный слушатель иерархии, чтобы он больше не получал события изменения иерархии от этого компонента.
void removeInputMethodListener(InputMethodListener l)
Удаляет указанный слушатель метода ввода, чтобы он больше не получал события метода ввода от этого компонента.
void removeKeyListener(KeyListener l)
Удаляет указанный слушатель клавиатуры, чтобы он больше не получал события клавиш от этого компонента.
void removeMouseListener(MouseListener l)
Удаляет указанный слушатель мыши, чтобы он больше не получал события мыши от этого компонента.
void removeMouseMotionListener(MouseMotionListener l)
Удаляет указанный слушатель движения мыши, чтобы он больше не получал события движения мыши от этого компонента.
void removeMouseWheelListener(MouseWheelListener l)
Удаляет указанный слушатель колесика мыши, чтобы он больше не получал события колесика мыши от этого компонента.
void removePropertyChangeListener(PropertyChangeListener listener)
Удаляет PropertyChangeListener из списка слушателей.
void removePropertyChangeListener(String propertyName, PropertyChangeListener listener)
Удаляет PropertyChangeListener из списка слушателей для определенного свойства.
void repaint()
Перерисовывает этот компонент.
void repaint(int x, int y, int width, int height)
Перерисовывает указанную прямоугольную область этого компонента.
void repaint(long tm)
Перерисовывает компонент.
protected boolean requestFocus(boolean temporary, FocusEvent.Cause cause)
Запрашивает по причине cause, чтобы этот Component получил фокус ввода, а предок верхнего уровня этого Component стал сфокусированным Window.
void requestFocus(FocusEvent.Cause cause)
Запрашивает по причине cause, чтобы этот Component получил фокус ввода, а предок верхнего уровня этого Component стал сфокусированным Window.
boolean requestFocusInWindow(FocusEvent.Cause cause)
Запрашивает по причине cause, чтобы этот Component получил фокус ввода, если предок верхнего уровня этого Component уже является сфокусированным Window.
void resize(int width, int height)
Устарело.
Начиная с версии JDK 1.1, заменено на setSize(int, int).
void resize(Dimension d)
Устарело.
Начиная с версии JDK 1.1, заменено на setSize(Dimension).
void setBounds(int x, int y, int width, int height)
Перемещает этот компонент и изменяет его размер.
void setBounds(Rectangle r)
Перемещает этот компонент и изменяет его размер в соответствии с новым ограничивающим прямоугольником r.
void setComponentOrientation(ComponentOrientation o)
Устанавливает ориентацию с учетом языка, которая должна использоваться для упорядочивания элементов или текста внутри этого компонента.
void setCursor(Cursor cursor)
Устанавливает изображение курсора в указанный курсор.
void setDropTarget(DropTarget dt)
Связывает DropTarget с этим компонентом.
void setFocusable(boolean focusable)
Устанавливает состояние фокусируемости этого Component в указанное значение.
void setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)
Устанавливает, включены ли клавиши обхода фокуса для этого Component.
void setIgnoreRepaint(boolean ignoreRepaint)
Устанавливает, следует ли игнорировать сообщения отрисовки, полученные от операционной системы.
void setLocale(Locale l)
Устанавливает локаль этого компонента.
void setLocation(int x, int y)
Перемещает этот компонент на новое место.
void setLocation(Point p)
Перемещает этот компонент на новое место.
void setMixingCutoutShape(Shape shape)
Задает форму «mixing-cutout» для этого легковесного компонента.
void setName(String name)
Задает имя компонента равным указанной строке.
void setSize(int width, int height)
Изменяет размер этого компонента так, чтобы он имел ширину width и высоту height.
void setSize(Dimension d)
Изменяет размер этого компонента так, чтобы он имел ширину d.width и высоту d.height.
void show()
Устарело.
Начиная с версии JDK 1.1, заменено на setVisible(boolean).
void show(boolean b)
Устарело.
Начиная с версии JDK 1.1, заменено на setVisible(boolean).
Dimension size()
Устарело.
Начиная с версии JDK 1.1, заменено на getSize().
String toString()
Возвращает строковое представление этого компонента и его значений.
void transferFocus()
Передает фокус следующему компоненту так, как если бы этот Component являлся владельцем фокуса.
void transferFocusBackward()
Передает фокус предыдущему компоненту так, как если бы этот Component являлся владельцем фокуса.
void transferFocusUpCycle()
Передает фокус на один цикл обхода фокуса вверх.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Модификатор и тип Метод Описание
protected Object clone()
Создает и возвращает копию этого объекта.
boolean equals(Object obj)
Указывает, равен ли какой-либо другой объект этому объекту.
protected void finalize()
Устарело, подлежит удалению: этот элемент API подлежит удалению в будущей версии.
Финализация устарела и подлежит удалению в будущем выпуске.
final Class<?> getClass()
Возвращает класс времени выполнения данного Object.
int hashCode()
Возвращает значение хэш-кода для этого объекта.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
final void wait()
Приводит к ожиданию текущего потока до тех пор, пока он не будет разбужен, обычно посредством оповещения или прерывания.
final void wait(long timeoutMillis)
Приводит к ожиданию текущего потока до тех пор, пока он не будет разбужен, обычно посредством оповещения или прерывания, либо пока не истечет определенное количество реального времени.
final void wait(long timeoutMillis, int nanos)
Приводит к ожиданию текущего потока до тех пор, пока он не будет разбужен, обычно посредством оповещения или прерывания, либо пока не истечет определенное количество реального времени.

Подробное описание полей

AUTO_RESIZE_OFF

public static final int AUTO_RESIZE_OFF
Не подгонять ширину столбцов автоматически; вместо этого использовать горизонтальную полосу прокрутки.
См. также:
  • Значения константных полей

AUTO_RESIZE_NEXT_COLUMN

public static final int AUTO_RESIZE_NEXT_COLUMN
При настройке столбца в пользовательском интерфейсе изменять размер следующего столбца в противоположную сторону.
См. также:
  • Значения константных полей

AUTO_RESIZE_SUBSEQUENT_COLUMNS

public static final int AUTO_RESIZE_SUBSEQUENT_COLUMNS
При настройке в пользовательском интерфейсе изменять последующие столбцы для сохранения общей ширины; это поведение по умолчанию.
См. также:
  • Значения константных полей

AUTO_RESIZE_LAST_COLUMN

public static final int AUTO_RESIZE_LAST_COLUMN
Во время всех операций изменения размера применять корректировки только к последнему столбцу.
См. также:
  • Значения константных полей

AUTO_RESIZE_ALL_COLUMNS

public static final int AUTO_RESIZE_ALL_COLUMNS
Во время всех операций изменения размера пропорционально изменять размер всех столбцов.
См. также:
  • Значения константных полей

dataModel

protected TableModel dataModel
TableModel таблицы.

columnModel

protected TableColumnModel columnModel
TableColumnModel таблицы.

selectionModel

protected ListSelectionModel selectionModel
ListSelectionModel таблицы, используемая для отслеживания выделения строк.

tableHeader

protected JTableHeader tableHeader
TableHeader, работающий с таблицей.

rowHeight

protected int rowHeight
Высота в пикселях каждой строки таблицы.

rowMargin

protected int rowMargin
Высота в пикселях отступа между ячейками в каждой строке.

gridColor

protected Color gridColor
Цвет сетки.

showHorizontalLines

protected boolean showHorizontalLines
Таблица рисует горизонтальные линии между ячейками, если showHorizontalLines равно true.

showVerticalLines

protected boolean showVerticalLines
Таблица рисует вертикальные линии между ячейками, если showVerticalLines равно true.

autoResizeMode

protected int autoResizeMode
Определяет, изменяет ли таблица автоматически ширину своих столбцов, чтобы занять всю ширину таблицы, и способ изменения размера.

autoCreateColumnsFromModel

protected boolean autoCreateColumnsFromModel
Таблица будет опрашивать TableModel для построения набора столбцов по умолчанию, если это значение равно true.

preferredViewportSize

protected Dimension preferredViewportSize
Используется интерфейсом Scrollable для определения начальной видимой области.

rowSelectionAllowed

protected boolean rowSelectionAllowed
Значение true, если выделение строк разрешено в этой таблице.

cellSelectionEnabled

protected boolean cellSelectionEnabled
Устарело начиная с Java 2 platform v1.3. Вместо этого используйте свойство rowSelectionAllowed и свойство columnSelectionAllowed объекта columnModel. Или используйте метод getCellSelectionEnabled.

editorComp

protected transient Component editorComp
При редактировании — Component, обрабатывающий редактирование.

cellEditor

protected transient TableCellEditor cellEditor
Активный объект редактора ячейки, который перекрывает экранное пространство, занимаемое текущей ячейкой, и позволяет пользователю изменять её содержимое. null, если таблица в данный момент не редактируется.

editingColumn

protected transient int editingColumn
Определяет столбец редактируемой ячейки.

editingRow

protected transient int editingRow
Определяет строку редактируемой ячейки.

defaultRenderersByColumnClass

protected transient Hashtable<Object,Object> defaultRenderersByColumnClass
Таблица объектов, отображающих содержимое ячейки, индексированная по классу, как объявлено в getColumnClass в интерфейсе TableModel.

defaultEditorsByColumnClass

protected transient Hashtable<Object,Object> defaultEditorsByColumnClass
Таблица объектов, отображающих и редактирующих содержимое ячейки, индексированная по классу, как объявлено в getColumnClass в интерфейсе TableModel.

selectionForeground

protected Color selectionForeground
Цвет переднего плана (текста) выделенных ячеек.

selectionBackground

protected Color selectionBackground
Цвет фона выделенных ячеек.

Подробное описание конструкторов

JTable

public JTable()
Создаёт стандартный объект JTable, инициализированный моделью данных по умолчанию, моделью столбцов по умолчанию и моделью выделения по умолчанию.
См. также:
  • createDefaultDataModel()
  • createDefaultColumnModel()
  • createDefaultSelectionModel()

JTable

public JTable(TableModel dm)
Создаёт объект JTable, инициализированный с dm в качестве модели данных, моделью столбцов по умолчанию и моделью выделения по умолчанию.
Параметры:
dm - модель данных для таблицы
См. также:
  • createDefaultColumnModel()
  • createDefaultSelectionModel()

JTable

public JTable(TableModel dm, TableColumnModel cm)
Создаёт объект JTable, инициализированный с dm в качестве модели данных, cm в качестве модели столбцов и моделью выделения по умолчанию.
Параметры:
dm - модель данных для таблицы
cm - модель столбцов для таблицы
См. также:
  • createDefaultSelectionModel()

JTable

public JTable(TableModel dm, TableColumnModel cm, ListSelectionModel sm)
Создаёт объект JTable, инициализированный с dm в качестве модели данных, cm в качестве модели столбцов и sm в качестве модели выделения. Если какой-либо из параметров равен null, этот метод инициализирует таблицу соответствующей моделью по умолчанию. Флаг autoCreateColumnsFromModel устанавливается в false, если cm не равен null; в противном случае устанавливается значение true, и модель столбцов заполняется подходящими объектами TableColumns для столбцов в dm.
Параметры:
dm - модель данных для таблицы
cm - модель столбцов для таблицы
sm - модель выделения строк для таблицы
См. также:
  • createDefaultDataModel()
  • createDefaultColumnModel()
  • createDefaultSelectionModel()

JTable

public JTable(int numRows, int numColumns)
Создаёт объект JTable с numRows и numColumns пустых ячеек с использованием DefaultTableModel. Столбцы будут иметь имена вида "A", "B", "C" и т. д.
Параметры:
numRows - количество строк, содержащихся в таблице
numColumns - количество столбцов, содержащихся в таблице
См. также:
  • DefaultTableModel

JTable

public JTable(Vector<? extends Vector> rowData, Vector<?> columnNames)
Создаёт объект JTable для отображения значений в Vector объектов Vectors, rowData, с именами столбцов columnNames. Элементы Vectors, содержащиеся в rowData, должны содержать значения для соответствующей строки. Другими словами, значение ячейки в строке 1, столбце 5 может быть получено с помощью следующего кода:
((Vector)rowData.elementAt(1)).elementAt(5);
Параметры:
rowData - данные для новой таблицы
columnNames - имена каждого столбца

JTable

public JTable(Object[][] rowData, Object[] columnNames)
Создаёт объект JTable для отображения значений в двумерном массиве rowData с именами столбцов columnNames. rowData представляет собой массив строк, поэтому значение ячейки в строке 1, столбце 5 может быть получено с помощью следующего кода:
 rowData[1][5]; 

Все строки должны иметь ту же длину, что и columnNames.

Параметры:
rowData - данные для новой таблицы
columnNames - имена каждого столбца

Подробное описание методов

addNotify

public void addNotify()
Вызывает метод configureEnclosingScrollPane.
Переопределяет:
addNotify в классе JComponent
См. также:
  • configureEnclosingScrollPane()

configureEnclosingScrollPane

protected void configureEnclosingScrollPane()
Если этот объект JTable является viewportView объемлющей панели JScrollPane (обычная ситуация), настраивает этот ScrollPane, помимо прочего, устанавливая tableHeader таблицы в качестве columnHeaderView панели прокрутки. Когда JTable добавляется в JScrollPane обычным способом с помощью new JScrollPane(myTable), метод addNotify вызывается в JTable (когда таблица добавляется в область просмотра). Метод addNotify класса JTable в свою очередь вызывает этот метод, объявленный со спецификатором protected, чтобы эту процедуру установки по умолчанию можно было переопределить в подклассе.
См. также:
  • addNotify()

removeNotify

public void removeNotify()
Вызывает метод unconfigureEnclosingScrollPane.
Переопределяет:
removeNotify в классе JComponent
См. также:
  • unconfigureEnclosingScrollPane()

unconfigureEnclosingScrollPane

protected void unconfigureEnclosingScrollPane()
Отменяет действие метода configureEnclosingScrollPane путём замены columnHeaderView объемлющей панели прокрутки на null. Метод removeNotify класса JTable вызывает этот метод, объявленный со спецификатором protected, чтобы эту процедуру удаления по умолчанию можно было переопределить в подклассе.
Начиная с:
1.3
См. также:
  • removeNotify()
  • configureEnclosingScrollPane()

createScrollPaneForTable

@Deprecated public static JScrollPane createScrollPaneForTable(JTable aTable)
Устарело.
Начиная с версии Swing 1.0.2 заменено на new JScrollPane(aTable).
Эквивалентно new JScrollPane(aTable).
Параметры:
aTable - объект JTable, используемый для панели прокрутки
Возвращает:
объект JScrollPane, созданный с использованием aTable

setTableHeader

@BeanProperty(description="The JTableHeader instance which renders the column headers.") public void setTableHeader(JTableHeader tableHeader)
Устанавливает tableHeader, работающий с этим объектом JTable, в значение newHeader. Допустимо указывать значение null tableHeader.
Параметры:
tableHeader - новый заголовок tableHeader
См. также:
  • getTableHeader()

getTableHeader

public JTableHeader getTableHeader()
Возвращает tableHeader, используемый этой таблицей JTable.
Возвращает:
объект tableHeader, используемый этой таблицей
См. также:
  • setTableHeader(JTableHeader)

setRowHeight

@BeanProperty(description="The height of the specified row.") public void setRowHeight(int rowHeight)
Устанавливает высоту (в пикселях) всех ячеек равной rowHeight, выполняет повторную валидацию и перерисовку. Высота ячеек будет равна высоте строки минус отступ строки.
Параметры:
rowHeight - новая высота строки
Исключения:
IllegalArgumentException - если rowHeight меньше 1
См. также:
  • getRowHeight()

getRowHeight

public int getRowHeight()
Возвращает высоту строки таблицы в пикселях.
Возвращает:
высоту строки таблицы в пикселях
См. также:
  • setRowHeight(int)

setRowHeight

@BeanProperty(description="The height in pixels of the cells in <code>row</code>") public void setRowHeight(int row, int rowHeight)
Устанавливает высоту для строки row равной rowHeight, выполняет повторную валидацию и перерисовку. Высота ячеек в этой строке будет равна высоте строки минус отступ строки.
Параметры:
row - строка, высота которой изменяется
rowHeight - новая высота строки в пикселях
Исключения:
IllegalArgumentException - если rowHeight меньше 1
Начиная с:
1.3

getRowHeight

public int getRowHeight(int row)
Возвращает высоту (в пикселях) ячеек в строке row.
Параметры:
row - строка, высота которой должна быть возвращена
Возвращает:
высоту в пикселях ячеек в строке
Начиная с:
1.3

setRowMargin

@BeanProperty(description="The amount of space between cells.") public void setRowMargin(int rowMargin)
Устанавливает размер пустого пространства между ячейками в соседних строках.
Параметры:
rowMargin - количество пикселей между ячейками в строке
См. также:
  • getRowMargin()

getRowMargin

public int getRowMargin()
Возвращает размер пустого пространства (в пикселях) между ячейками. Эквивалентно: getIntercellSpacing().height.
Возвращает:
количество пикселей между ячейками в строке
См. также:
  • setRowMargin(int)

setIntercellSpacing

@BeanProperty(bound=false, description="The spacing between the cells, drawn in the background color of the JTable.") public void setIntercellSpacing(Dimension intercellSpacing)
Устанавливает rowMargin и columnMargin — высоту и ширину пространства между ячейками — равными intercellSpacing.
Параметры:
intercellSpacing - объект Dimension, задающий новую ширину и высоту расстояния между ячейками
См. также:
  • getIntercellSpacing()

getIntercellSpacing

public Dimension getIntercellSpacing()
Возвращает расстояние между ячейками по горизонтали и вертикали. Расстояние по умолчанию зависит от стиля оформления (look and feel).
Возвращает:
расстояние между ячейками по горизонтали и вертикали
См. также:
  • setIntercellSpacing(Dimension)

setGridColor

@BeanProperty(description="The grid color.") public void setGridColor(Color gridColor)
Устанавливает цвет, используемый для отрисовки линий сетки, равным gridColor и перерисовывает таблицу. Цвет по умолчанию зависит от стиля оформления (look and feel).
Параметры:
gridColor - новый цвет линий сетки
Исключения:
IllegalArgumentException - если gridColor равен null
См. также:
  • getGridColor()

getGridColor

public Color getGridColor()
Возвращает цвет, используемый для отрисовки линий сетки. Цвет по умолчанию зависит от стиля оформления (look and feel).
Возвращает:
цвет, используемый для отрисовки линий сетки
См. также:
  • setGridColor(Color)

setShowGrid

@BeanProperty(description="Whether grid lines are drawn around the cells.") public void setShowGrid(boolean showGrid)
Определяет, рисует ли таблица линии сетки вокруг ячеек. Если параметр showGrid равен true, линии рисуются; если false — нет. Метода getShowGrid не существует, поскольку это состояние хранится в двух переменных — showHorizontalLines и showVerticalLines, каждую из которых можно запросить независимо.
Параметры:
showGrid - значение true, если представление таблицы должно рисовать линии сетки
См. также:
  • setShowVerticalLines(boolean)
  • setShowHorizontalLines(boolean)

setShowHorizontalLines

@BeanProperty(description="Whether horizontal lines should be drawn in between the cells.") public void setShowHorizontalLines(boolean showHorizontalLines)
Определяет, рисует ли таблица горизонтальные линии между ячейками. Если параметр showHorizontalLines равен true, линии рисуются; если false — нет.
Параметры:
showHorizontalLines - значение true, если представление таблицы должно рисовать горизонтальные линии
См. также:
  • getShowHorizontalLines()
  • setShowGrid(boolean)
  • setShowVerticalLines(boolean)

setShowVerticalLines

@BeanProperty(description="Whether vertical lines should be drawn in between the cells.") public void setShowVerticalLines(boolean showVerticalLines)
Определяет, рисует ли таблица вертикальные линии между ячейками. Если параметр showVerticalLines равен true, линии рисуются; если false — нет.
Параметры:
showVerticalLines - значение true, если представление таблицы должно рисовать вертикальные линии
См. также:
  • getShowVerticalLines()
  • setShowGrid(boolean)
  • setShowHorizontalLines(boolean)

getShowHorizontalLines

public boolean getShowHorizontalLines()
Возвращает true, если таблица рисует горизонтальные линии между ячейками, и false, если нет. Значение по умолчанию зависит от стиля оформления (look and feel).
Возвращает:
true, если таблица рисует горизонтальные линии между ячейками, и false, если нет
См. также:
  • setShowHorizontalLines(boolean)

getShowVerticalLines

public boolean getShowVerticalLines()
Возвращает true, если таблица рисует вертикальные линии между ячейками, и false, если нет. Значение по умолчанию зависит от стиля оформления (look and feel).
Возвращает:
true, если таблица рисует вертикальные линии между ячейками, и false, если нет
См. также:
  • setShowVerticalLines(boolean)

setAutoResizeMode

@BeanProperty(enumerationValues={"JTable.AUTO_RESIZE_OFF","JTable.AUTO_RESIZE_NEXT_COLUMN","JTable.AUTO_RESIZE_SUBSEQUENT_COLUMNS","JTable.AUTO_RESIZE_LAST_COLUMN","JTable.AUTO_RESIZE_ALL_COLUMNS"}, description="Whether the columns should adjust themselves automatically.") public void setAutoResizeMode(int mode)
Задаёт режим автоматического изменения размера столбцов при изменении размера таблицы. Дополнительные сведения о работе различных режимов изменения размера см. в разделе doLayout().
Параметры:
mode - одно из 5 допустимых значений: AUTO_RESIZE_OFF, AUTO_RESIZE_NEXT_COLUMN, AUTO_RESIZE_SUBSEQUENT_COLUMNS, AUTO_RESIZE_LAST_COLUMN, AUTO_RESIZE_ALL_COLUMNS
См. также:
  • getAutoResizeMode()
  • doLayout()

getAutoResizeMode

public int getAutoResizeMode()
Возвращает режим автоматического изменения размера столбцов таблицы. Режим по умолчанию — AUTO_RESIZE_SUBSEQUENT_COLUMNS.
Возвращает:
режим autoResizeMode таблицы
См. также:
  • setAutoResizeMode(int)
  • doLayout()

setAutoCreateColumnsFromModel

@BeanProperty(description="Automatically populates the columnModel when a new TableModel is submitted.") public void setAutoCreateColumnsFromModel(boolean autoCreateColumnsFromModel)
Устанавливает флаг autoCreateColumnsFromModel этой таблицы. Этот метод вызывает createDefaultColumnsFromModel, если autoCreateColumnsFromModel изменяется с false на true.
Параметры:
autoCreateColumnsFromModel - значение true, если JTable должен автоматически создавать столбцы
См. также:
  • getAutoCreateColumnsFromModel()
  • createDefaultColumnsFromModel()

getAutoCreateColumnsFromModel

public boolean getAutoCreateColumnsFromModel()
Определяет, будет ли таблица создавать столбцы по умолчанию из модели. Если true, setModel очистит все существующие столбцы и создаст новые столбцы из новой модели. Кроме того, если событие в уведомлении tableChanged указывает, что изменилась вся таблица, столбцы будут перестроены. По умолчанию равно true.
Возвращает:
значение autoCreateColumnsFromModel таблицы
См. также:
  • setAutoCreateColumnsFromModel(boolean)
  • createDefaultColumnsFromModel()

createDefaultColumnsFromModel

public void createDefaultColumnsFromModel()
Создаёт столбцы по умолчанию для таблицы из модели данных с использованием метода getColumnCount, определённого в интерфейсе TableModel.

Очищает все существующие столбцы перед созданием новых столбцов на основе информации из модели.

См. также:
  • getAutoCreateColumnsFromModel()

setDefaultRenderer

public void setDefaultRenderer(Class<?> columnClass, TableCellRenderer renderer)
Задает визуализатор ячеек по умолчанию, который будет использоваться, если визуализатор не был задан в TableColumn. Если визуализатор равен null, удаляет визуализатор по умолчанию для этого класса столбца.
Параметры:
columnClass - задает визуализатор ячеек по умолчанию для этого columnClass
renderer - визуализатор ячеек по умолчанию, используемый для этого columnClass
См. также:
  • getDefaultRenderer(Class)
  • setDefaultEditor(Class, TableCellEditor)

getDefaultRenderer

public TableCellRenderer getDefaultRenderer(Class<?> columnClass)
Возвращает визуализатор ячеек, используемый, когда визуализатор не был задан в TableColumn. Во время отрисовки ячеек визуализатор извлекается из Hashtable записей в соответствии с классом ячеек в столбце. Если для этого columnClass запись отсутствует, метод возвращает запись для наиболее специфичного суперкласса. JTable устанавливает записи для Object, Number и Boolean, каждую из которых можно изменить или заменить.
Параметры:
columnClass - возвращает визуализатор ячеек по умолчанию для этого columnClass
Возвращает:
визуализатор для этого columnClass
См. также:
  • setDefaultRenderer(Class, TableCellRenderer)
  • getColumnClass(int)

setDefaultEditor

public void setDefaultEditor(Class<?> columnClass, TableCellEditor editor)
Задает редактор ячеек по умолчанию, который будет использоваться, если редактор не был задан в TableColumn. Если редактирование в таблице или определенном столбце таблицы не требуется, используйте метод isCellEditable в интерфейсе TableModel, чтобы гарантировать, что этот JTable не запустит редактор в этих столбцах. Если редактор равен null, удаляет редактор по умолчанию для этого класса столбца.
Параметры:
columnClass - задает редактор ячеек по умолчанию для этого columnClass
editor - редактор ячеек по умолчанию, используемый для этого columnClass
См. также:
  • TableModel.isCellEditable(int, int)
  • getDefaultEditor(Class)
  • setDefaultRenderer(Class, TableCellRenderer)

getDefaultEditor

public TableCellEditor getDefaultEditor(Class<?> columnClass)
Возвращает редактор, используемый, когда редактор не был задан в TableColumn. Во время редактирования ячеек редактор извлекается из Hashtable записей в соответствии с классом ячеек в столбце. Если для этого columnClass запись отсутствует, метод возвращает запись для наиболее специфичного суперкласса. JTable устанавливает записи для Object, Number и Boolean, каждую из которых можно изменить или заменить.
Параметры:
columnClass - возвращает редактор ячеек по умолчанию для этого columnClass
Возвращает:
редактор ячеек по умолчанию, используемый для этого columnClass
См. также:
  • setDefaultEditor(Class, TableCellEditor)
  • getColumnClass(int)

setDragEnabled

@BeanProperty(bound=false, description="determines whether automatic drag handling is enabled") public void setDragEnabled(boolean b)
Включает или выключает автоматическую обработку перетаскивания. Чтобы включить автоматическую обработку перетаскивания, этому свойству следует присвоить значение true, а свойство таблицы TransferHandler должно быть non-null. Значением по умолчанию свойства dragEnabled является false.

Обязанность учитывать это свойство и распознавать жест перетаскивания пользователем возлагается на реализацию внешнего вида (look and feel) и, в частности, на TableUI таблицы. Когда включена автоматическая обработка перетаскивания, большинство реализаций внешнего вида (включая подклассы BasicLookAndFeel) начинают операцию drag and drop всякий раз, когда пользователь нажимает кнопку мыши над элементом (в режиме одиночного выбора) или выделением (в других режимах выбора) и затем перемещает мышь на несколько пикселей. Установка этого свойства в true может иметь едва заметное влияние на поведение выделений.

Если используется внешний вид, игнорирующий это свойство, вы все равно можете начать операцию drag and drop, вызвав exportAsDrag у TransferHandler таблицы.

Параметры:
b - следует ли включить автоматическую обработку перетаскивания
Исключения:
HeadlessException - если b равно true и GraphicsEnvironment.isHeadless() возвращает true
С версии:
1.4
См. также:
  • GraphicsEnvironment.isHeadless()
  • getDragEnabled()
  • JComponent.setTransferHandler(TransferHandler)
  • TransferHandler

getDragEnabled

public boolean getDragEnabled()
Возвращает значение, указывающее, включена ли автоматическая обработка перетаскивания.
Возвращает:
значение свойства dragEnabled
С версии:
1.4
См. также:
  • setDragEnabled(boolean)

setDropMode

public final void setDropMode(DropMode dropMode)
Устанавливает режим сброса для этого компонента. Для обратной совместимости значением по умолчанию для этого свойства является DropMode.USE_SELECTION. Однако для улучшения пользовательского интерфейса рекомендуется использовать один из других режимов. Например, DropMode.ON предлагает аналогичное поведение с отображением элементов как выбранных, но делает это без изменения фактического выделения в таблице.

JTable поддерживает следующие режимы сброса:

  • DropMode.USE_SELECTION
  • DropMode.ON
  • DropMode.INSERT
  • DropMode.INSERT_ROWS
  • DropMode.INSERT_COLS
  • DropMode.ON_OR_INSERT
  • DropMode.ON_OR_INSERT_ROWS
  • DropMode.ON_OR_INSERT_COLS

Режим сброса имеет смысл только в том случае, если этот компонент имеет TransferHandler, принимающий сбросы.

Параметры:
dropMode - используемый режим сброса
Исключения:
IllegalArgumentException - если режим сброса не поддерживается или равен null
С версии:
1.6
См. также:
  • getDropMode()
  • getDropLocation()
  • JComponent.setTransferHandler(TransferHandler)
  • TransferHandler

getDropMode

public final DropMode getDropMode()
Возвращает режим сброса для этого компонента.
Возвращает:
режим сброса для этого компонента
С версии:
1.6
См. также:
  • setDropMode(DropMode)

getDropLocation

@BeanProperty(bound=false) public final JTable.DropLocation getDropLocation()
Возвращает местоположение, которое этот компонент должен визуально отображать как точку сброса во время операции DnD над компонентом, или null, если в данный момент местоположение не должно отображаться.

Этот метод не предназначен для запроса места сброса из TransferHandler, так как место сброса устанавливается только после того, как метод canImport у TransferHandler вернул значение и разрешил отображение местоположения.

При изменении этого свойства компонент генерирует событие изменения свойства с именем «dropLocation».

Возвращает:
местоположение сброса
С версии:
1.6
См. также:
  • setDropMode(DropMode)
  • TransferHandler.canImport(TransferHandler.TransferSupport)

setAutoCreateRowSorter

@BeanProperty(preferred=true, description="Whether or not to turn on sorting by default.") public void setAutoCreateRowSorter(boolean autoCreateRowSorter)
Указывает, должен ли создаваться RowSorter для таблицы всякий раз, когда изменяется ее модель.

При вызове setAutoCreateRowSorter(true) для таблицы немедленно создается и устанавливается TableRowSorter. Пока свойство autoCreateRowSorter остается равным true, при каждом изменении модели создается новый TableRowSorter и устанавливается в качестве сортировщика строк таблицы. Значением по умолчанию для свойства autoCreateRowSorter является false.

Параметры:
autoCreateRowSorter - должен ли автоматически создаваться RowSorter
С версии:
1.6
См. также:
  • TableRowSorter

getAutoCreateRowSorter

public boolean getAutoCreateRowSorter()
Возвращает true, если при каждом изменении модели должен создаваться новый RowSorter и устанавливаться в качестве сортировщика таблицы; в противном случае возвращает false.
Возвращает:
true, если при изменении модели должен создаваться RowSorter
С версии:
1.6

setUpdateSelectionOnSort

@BeanProperty(expert=true, description="Whether or not to update the selection on sorting") public void setUpdateSelectionOnSort(boolean update)
Указывает, должно ли обновляться выделение после сортировки. Если true, при сортировке выделение сбрасывается таким образом, чтобы выбранными оставались те же строки с точки зрения модели. Значение по умолчанию — true.
Параметры:
update - обновлять ли выделение при сортировке
С версии:
1.6

getUpdateSelectionOnSort

public boolean getUpdateSelectionOnSort()
Возвращает true, если выделение должно обновляться после сортировки.
Возвращает:
следует ли обновлять выделение при сортировке
С версии:
1.6

setRowSorter

@BeanProperty(description="The table's RowSorter") public void setRowSorter(RowSorter<? extends TableModel> sorter)
Устанавливает RowSorter. RowSorter используется для обеспечения сортировки и фильтрации для JTable.

Этот метод очищает выделение и сбрасывает все переменные высоты строк.

Этот метод генерирует PropertyChangeEvent при необходимости с именем свойства "rowSorter". Для обратной совместимости этот метод генерирует дополнительное событие с именем свойства "sorter".

Если базовая модель RowSorter отличается от модели этой JTable, это приведет к неопределенному поведению.

Параметры:
sorter - RowSorter; null отключает сортировку
С версии:
1.6
См. также:
  • TableRowSorter

getRowSorter

public RowSorter<? extends TableModel> getRowSorter()
Возвращает объект, отвечающий за сортировку.
Возвращает:
объект, отвечающий за сортировку
С версии:
1.6

setSelectionMode

@BeanProperty(enumerationValues={"ListSelectionModel.SINGLE_SELECTION","ListSelectionModel.SINGLE_INTERVAL_SELECTION","ListSelectionModel.MULTIPLE_INTERVAL_SELECTION"}, description="The selection mode used by the row and column selection models.") public void setSelectionMode(int selectionMode)
Устанавливает режим выделения таблицы, разрешая только одиночный выбор, один непрерывный интервал или несколько интервалов.

Примечание: JTable предоставляет все методы для обработки выделения строк и столбцов. При установке состояний, таких как setSelectionMode, он не только обновляет режим для модели выделения строк, но также устанавливает аналогичные значения в модели выделения columnModel. Если вы хотите, чтобы модели выделения строк и столбцов работали в разных режимах, задайте их обе напрямую.

Обе модели выделения строк и столбцов для JTable по умолчанию используют DefaultListSelectionModel, поэтому JTable работает так же, как и JList. Подробные сведения о режимах см. в описании метода setSelectionMode в JList.

Параметры:
selectionMode - режим, используемый моделями выделения строк и столбцов
См. также:
  • JList.setSelectionMode(int)

setRowSelectionAllowed

@BeanProperty(visualUpdate=true, description="If true, an entire row is selected for each selected cell.") public void setRowSelectionAllowed(boolean rowSelectionAllowed)
Указывает, могут ли строки в этой модели быть выделены.
Параметры:
rowSelectionAllowed - true, если эта модель разрешает выделение строк
См. также:
  • getRowSelectionAllowed()

getRowSelectionAllowed

public boolean getRowSelectionAllowed()
Возвращает true, если строки могут быть выделены.
Возвращает:
true, если строки могут быть выделены; в противном случае — false
См. также:
  • setRowSelectionAllowed(boolean)

setColumnSelectionAllowed

@BeanProperty(visualUpdate=true, description="If true, an entire column is selected for each selected cell.") public void setColumnSelectionAllowed(boolean columnSelectionAllowed)
Указывает, могут ли столбцы в этой модели быть выделены.
Параметры:
columnSelectionAllowed - true, если эта модель разрешает выделение столбцов
См. также:
  • getColumnSelectionAllowed()

getColumnSelectionAllowed

public boolean getColumnSelectionAllowed()
Возвращает true, если столбцы могут быть выделены.
Возвращает:
true, если столбцы могут быть выделены; в противном случае — false
См. также:
  • setColumnSelectionAllowed(boolean)

setCellSelectionEnabled

@BeanProperty(visualUpdate=true, description="Select a rectangular region of cells rather than rows or columns.") public void setCellSelectionEnabled(boolean cellSelectionEnabled)
Указывает, разрешает ли эта таблица одновременное существование выделения столбцов и строк. При установке таблица рассматривает пересечение моделей выделения строк и столбцов как выделенные ячейки. Переопределите isCellSelected, чтобы изменить это поведение по умолчанию. Этот метод эквивалентен установке для обоих свойств, rowSelectionAllowed и columnSelectionAllowed у columnModel, переданного значения.
Параметры:
cellSelectionEnabled - true, если разрешено одновременное выделение строк и столбцов
См. также:
  • getCellSelectionEnabled()
  • isCellSelected(int, int)

getCellSelectionEnabled

public boolean getCellSelectionEnabled()
Возвращает true, если включены обе модели выделения: строк и столбцов. Эквивалентно getRowSelectionAllowed() && getColumnSelectionAllowed().
Возвращает:
true, если включены обе модели выделения строк и столбцов
См. также:
  • setCellSelectionEnabled(boolean)

selectAll

public void selectAll()
Выделяет все строки, столбцы и ячейки в таблице.

clearSelection

public void clearSelection()
Снимает выделение со всех выбранных столбцов и строк.

setRowSelectionInterval

public void setRowSelectionInterval(int index0, int index1)
Выделяет строки от index0 до index1 включительно.
Параметры:
index0 - один конец интервала
index1 - другой конец интервала
Исключения:
IllegalArgumentException - если index0 или index1 лежат за пределами [0, getRowCount()-1]

setColumnSelectionInterval

public void setColumnSelectionInterval(int index0, int index1)
Выделяет столбцы от index0 до index1 включительно.
Параметры:
index0 - один конец интервала
index1 - другой конец интервала
Исключения:
IllegalArgumentException - если index0 или index1 лежат за пределами [0, getColumnCount()-1]

addRowSelectionInterval

public void addRowSelectionInterval(int index0, int index1)
Добавляет строки от index0 до index1 включительно к текущему выделению.
Параметры:
index0 - один конец интервала
index1 - другой конец интервала
Исключения:
IllegalArgumentException - если index0 или index1 лежат за пределами [0, getRowCount()-1]

addColumnSelectionInterval

public void addColumnSelectionInterval(int index0, int index1)
Добавляет столбцы от index0 до index1 включительно к текущему выделению.
Параметры:
index0 - один конец интервала
index1 - другой конец интервала
Исключения:
IllegalArgumentException - если index0 или index1 лежат за пределами [0, getColumnCount()-1]

removeRowSelectionInterval

public void removeRowSelectionInterval(int index0, int index1)
Снимает выделение со строк от index0 до index1 включительно.
Параметры:
index0 - один конец интервала
index1 - другой конец интервала
Исключения:
IllegalArgumentException - если index0 или index1 лежат за пределами [0, getRowCount()-1]

removeColumnSelectionInterval

public void removeColumnSelectionInterval(int index0, int index1)
Снимает выделение со столбцов от index0 до index1 включительно.
Параметры:
index0 - один конец интервала
index1 - другой конец интервала
Исключения:
IllegalArgumentException - если index0 или index1 лежат за пределами [0, getColumnCount()-1]

getSelectedRow

@BeanProperty(bound=false) public int getSelectedRow()
Возвращает индекс первой выделенной строки, или -1, если ни одна строка не выделена.
Возвращает:
индекс первой выделенной строки

getSelectedColumn

@BeanProperty(bound=false) public int getSelectedColumn()
Возвращает индекс первого выделенного столбца, или -1, если ни один столбец не выделен.
Возвращает:
индекс первого выделенного столбца

getSelectedRows

@BeanProperty(bound=false) public int[] getSelectedRows()
Возвращает индексы всех выделенных строк.
Возвращает:
массив целых чисел, содержащий индексы всех выделенных строк, или пустой массив, если ни одна строка не выделена
См. также:
  • getSelectedRow()

getSelectedColumns

@BeanProperty(bound=false) public int[] getSelectedColumns()
Возвращает индексы всех выделенных столбцов.
Возвращает:
массив целых чисел, содержащий индексы всех выделенных столбцов, или пустой массив, если ни один столбец не выделен
См. также:
  • getSelectedColumn()

getSelectedRowCount

@BeanProperty(bound=false) public int getSelectedRowCount()
Возвращает количество выделенных строк.
Возвращает:
количество выделенных строк, 0, если ни одна строка не выделена

getSelectedColumnCount

@BeanProperty(bound=false) public int getSelectedColumnCount()
Возвращает количество выделенных столбцов.
Возвращает:
количество выделенных столбцов, 0, если ни один столбец не выделен

isRowSelected

public boolean isRowSelected(int row)
Возвращает true, если указанный индекс находится в допустимом диапазоне строк и строка с этим индексом выделена.
Параметры:
row - строка в модели строк
Возвращает:
true, если row является допустимым индексом и строка с этим индексом выделена (где 0 — первая строка)

isColumnSelected

public boolean isColumnSelected(int column)
Возвращает true, если указанный индекс находится в допустимом диапазоне столбцов и столбец с этим индексом выделен.
Параметры:
column - столбец в модели столбцов
Возвращает:
true, если column является допустимым индексом и столбец с этим индексом выделен (где 0 — первый столбец)

isCellSelected

public boolean isCellSelected(int row, int column)
Возвращает true, если указанные индексы находятся в допустимом диапазоне строк и столбцов и ячейка в указанной позиции выделена.
Параметры:
row - запрашиваемая строка
column - запрашиваемый столбец
Возвращает:
true, если row и column являются допустимыми индексами и ячейка с индексом (row, column) выделена, где первая строка и первый столбец имеют индекс 0

changeSelection

public void changeSelection(int rowIndex, int columnIndex, boolean toggle, boolean extend)
Обновляет модели выделения таблицы в зависимости от состояния двух флагов: toggle и extend. Большинство изменений выделения, являющихся результатом событий клавиатуры или мыши, полученных пользовательским интерфейсом, направляются через этот метод, чтобы это поведение можно было переопределить в подклассе. Некоторым UI может потребоваться больше функциональности, чем предоставляет этот метод, например при управлении начальным элементом для прерывистого выделения, и они могут не вызывать этот метод для некоторых изменений выделения.

Данная реализация использует следующие соглашения:

  • toggle: false, extend: false. Очистить предыдущее выделение и убедиться, что новая ячейка выделена.
  • toggle: false, extend: true. Расширить предыдущее выделение от точки привязки до указанной ячейки, очистив все остальные выделения.
  • toggle: true, extend: false. Если указанная ячейка выделена, снять выделение. Если она не выделена, выделить ее.
  • toggle: true, extend: true. Применить состояние выделения точки привязки ко всем ячейкам между ней и указанной ячейкой.
Параметры:
rowIndex - влияет на выделение в row
columnIndex - влияет на выделение в column
toggle - см. описание выше
extend - если true, расширить текущее выделение
С версии:
1.3

getSelectionForeground

public Color getSelectionForeground()
Возвращает цвет переднего плана для выделенных ячеек.
Возвращает:
объект Color для свойства цвета переднего плана
См. также:
  • setSelectionForeground(Color)
  • setSelectionBackground(Color)

setSelectionForeground

@BeanProperty(description="A default foreground color for selected cells.") public void setSelectionForeground(Color selectionForeground)
Устанавливает цвет переднего плана для выделенных ячеек. Визуализаторы ячеек могут использовать этот цвет для отрисовки текста и графики для выделенных ячеек.

Значение по умолчанию для этого свойства определяется реализацией внешнего вида.

Это связанное свойство JavaBeans.

Параметры:
selectionForeground - Color для использования в качестве цвета переднего плана для выделенных элементов списка
См. также:
  • getSelectionForeground()
  • setSelectionBackground(Color)
  • JComponent.setForeground(Color)
  • JComponent.setBackground(Color)
  • JComponent.setFont(Font)

getSelectionBackground

public Color getSelectionBackground()
Возвращает цвет фона для выделенных ячеек.
Возвращает:
Color, используемый для фона выделенных элементов списка
См. также:
  • setSelectionBackground(Color)
  • setSelectionForeground(Color)

setSelectionBackground

@BeanProperty(description="A default background color for selected cells.") public void setSelectionBackground(Color selectionBackground)
Задает цвет фона для выделенных ячеек. Средства визуализации ячеек могут использовать этот цвет для заполнения выделенных ячеек.

Значение этого свойства по умолчанию определяется реализацией внешнего вида и функциональности (look and feel).

Это связанное свойство JavaBeans.

Параметры:
selectionBackground - Color для использования в качестве фона выделенных ячеек
См. также:
  • getSelectionBackground()
  • setSelectionForeground(Color)
  • JComponent.setForeground(Color)
  • JComponent.setBackground(Color)
  • JComponent.setFont(Font)

getColumn

public TableColumn getColumn(Object identifier)
Возвращает объект TableColumn для столбца в таблице, чей идентификатор равен identifier при сравнении с использованием equals.
Параметры:
identifier - объект идентификатора
Возвращает:
объект TableColumn, соответствующий идентификатору
Исключения:
IllegalArgumentException - если identifier равен null или ни один TableColumn не имеет этого идентификатора

convertColumnIndexToModel

public int convertColumnIndexToModel(int viewColumnIndex)
Сопоставляет индекс столбца в представлении в viewColumnIndex с индексом столбца в модели таблицы. Возвращает индекс соответствующего столбца в модели. Если viewColumnIndex меньше нуля, возвращает viewColumnIndex.
Параметры:
viewColumnIndex - индекс столбца в представлении
Возвращает:
индекс соответствующего столбца в модели
См. также:
  • convertColumnIndexToView(int)

convertColumnIndexToView

public int convertColumnIndexToView(int modelColumnIndex)
Сопоставляет индекс столбца в модели таблицы в modelColumnIndex с индексом столбца в представлении. Возвращает индекс соответствующего столбца в представлении; возвращает -1, если этот столбец не отображается. Если modelColumnIndex меньше нуля, возвращает modelColumnIndex.
Параметры:
modelColumnIndex - индекс столбца в модели
Возвращает:
индекс соответствующего столбца в представлении
См. также:
  • convertColumnIndexToModel(int)

convertRowIndexToView

public int convertRowIndexToView(int modelRowIndex)
Сопоставляет индекс строки в терминах TableModel с представлением. Если содержимое модели не отсортировано, индексы модели и представления совпадают.
Параметры:
modelRowIndex - индекс строки в терминах модели
Возвращает:
индекс соответствующей строки в представлении или -1, если строка не видна
Исключения:
IndexOutOfBoundsException - если включена сортировка и передан индекс, выходящий за пределы количества строк TableModel
Начиная с версии:
1.6
См. также:
  • TableRowSorter

convertRowIndexToModel

public int convertRowIndexToModel(int viewRowIndex)
Сопоставляет индекс строки в терминах представления с базовой TableModel. Если содержимое модели не отсортировано, индексы модели и представления совпадают.
Параметры:
viewRowIndex - индекс строки в представлении
Возвращает:
индекс соответствующей строки в модели
Исключения:
IndexOutOfBoundsException - если включена сортировка и передан индекс за пределами диапазона JTable, определенного методом getRowCount
Начиная с версии:
1.6
См. также:
  • TableRowSorter
  • getRowCount()

getRowCount

@BeanProperty(bound=false) public int getRowCount()
Возвращает количество строк, которые могут быть показаны в JTable при неограниченном пространстве. Если был указан RowSorter с фильтром, возвращаемое количество строк может отличаться от количества строк в базовой TableModel.
Возвращает:
количество строк, отображаемых в JTable
См. также:
  • getColumnCount()

getColumnCount

@BeanProperty(bound=false) public int getColumnCount()
Возвращает количество столбцов в модели столбцов. Обратите внимание, что оно может отличаться от количества столбцов в модели таблицы.
Возвращает:
количество столбцов в таблице
См. также:
  • getRowCount()
  • removeColumn(TableColumn)

getColumnName

public String getColumnName(int column)
Возвращает имя столбца, отображаемого в представлении в позиции столбца column.
Параметры:
column - опрашиваемый столбец в представлении
Возвращает:
имя столбца в позиции column в представлении, где первым столбцом является столбец 0

getColumnClass

public Class<?> getColumnClass(int column)
Возвращает тип столбца, отображаемого в представлении в позиции столбца column.
Параметры:
column - опрашиваемый столбец в представлении
Возвращает:
тип столбца в позиции column в представлении, где первым столбцом является столбец 0

getValueAt

public Object getValueAt(int row, int column)
Возвращает значение ячейки в позиции row и column.

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

Параметры:
row - строка, значение которой запрашивается
column - столбец, значение которого запрашивается
Возвращает:
объект Object в указанной ячейке

setValueAt

public void setValueAt(Object aValue, int row, int column)
Задает значение для ячейки в модели таблицы в row и column.

Примечание: столбец указывается в порядке отображения в представлении таблицы, а не в порядке столбцов TableModel. Это важное различие, поскольку по мере того как пользователь переупорядочивает столбцы в таблице, столбец с данным индексом в представлении будет меняться. При этом действия пользователя никогда не влияют на порядок столбцов в модели. aValue — это новое значение.

Параметры:
aValue - новое значение
row - строка изменяемой ячейки
column - столбец изменяемой ячейки
См. также:
  • getValueAt(int, int)

isCellEditable

public boolean isCellEditable(int row, int column)
Возвращает true, если ячейка в row и column доступна для редактирования. В противном случае вызов setValueAt для ячейки не возымеет эффекта.

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

Параметры:
row - строка, значение которой запрашивается
column - столбец, значение которого запрашивается
Возвращает:
true, если ячейка доступна для редактирования
См. также:
  • setValueAt(Object, int, int)

addColumn

public void addColumn(TableColumn aColumn)
Добавляет aColumn в конец массива столбцов, содержащегося в модели столбцов этого JTable. Если имя столбца aColumn равно null, устанавливает имя столбца aColumn в имя, возвращаемое getModel().getColumnName().

Чтобы добавить столбец в этот JTable для отображения modelColumn-го столбца данных в модели с заданными width, cellRenderer и cellEditor, можно использовать:


    addColumn(new TableColumn(modelColumn, width, cellRenderer, cellEditor));

[Вместо этого конструктора можно использовать любой из конструкторов TableColumn.] Номер столбца модели хранится внутри TableColumn и используется во время отрисовки и редактирования для поиска соответствующих значений данных в модели. Номер столбца модели не меняется при изменении порядка столбцов в представлении.
Параметры:
aColumn - добавляемый TableColumn
См. также:
  • removeColumn(TableColumn)

removeColumn

public void removeColumn(TableColumn aColumn)
Удаляет aColumn из массива столбцов этого JTable. Примечание: этот метод не удаляет столбец данных из модели; он лишь удаляет TableColumn, отвечавший за его отображение.
Параметры:
aColumn - удаляемый TableColumn
См. также:
  • addColumn(TableColumn)

moveColumn

public void moveColumn(int column, int targetColumn)
Перемещает столбец column на позицию, которую в данный момент занимает столбец targetColumn в представлении. Старый столбец в позиции targetColumn сдвигается влево или вправо, чтобы освободить место.
Параметры:
column - индекс перемещаемого столбца
targetColumn - новый индекс столбца

columnAtPoint

public int columnAtPoint(Point point)
Возвращает индекс столбца, в котором находится point, или -1, если результат не находится в диапазоне [0, getColumnCount()-1].
Параметры:
point - интересующая точка
Возвращает:
индекс столбца, в котором находится point, или -1, если результат не находится в диапазоне [0, getColumnCount()-1]
См. также:
  • rowAtPoint(Point)

rowAtPoint

public int rowAtPoint(Point point)
Возвращает индекс строки, в которой находится point, или -1, если результат не находится в диапазоне [0, getRowCount()-1].
Параметры:
point - интересующая точка
Возвращает:
индекс строки, в которой находится point, или -1, если результат не находится в диапазоне [0, getRowCount()-1]
См. также:
  • columnAtPoint(Point)

getCellRect

public Rectangle getCellRect(int row, int column, boolean includeSpacing)
Возвращает прямоугольник для ячейки, находящейся на пересечении row и column. Если includeSpacing имеет значение true, возвращаемое значение имеет полную высоту и ширину указанных строки и столбца. Если значение false, возвращаемый прямоугольник уменьшается на величину межъячеечного интервала, возвращая истинные границы компонента отрисовки или редактирования, какими они будут заданы во время отрисовки.

Если индекс столбца допустим, но индекс строки меньше нуля, метод возвращает прямоугольник с соответствующим образом установленными значениями y и height и значениями x и width, установленными в ноль. В общем случае, когда индексы строки или столбца указывают на ячейку вне допустимого диапазона, метод возвращает прямоугольник, отображающий ближайший край ближайшей ячейки, находящейся в диапазоне таблицы. Когда оба индекса строки и столбца выходят за пределы диапазона, возвращаемый прямоугольник покрывает ближайшую точку ближайшей ячейки.

Во всех случаях вычисления, использующие этот метод для вычисления результатов вдоль одной оси, не завершатся ошибкой из-за аномалий в вычислениях вдоль другой оси. Если ячейка недействительна, параметр includeSpacing игнорируется.

Параметры:
row - индекс строки, в которой находится нужная ячейка
column - индекс столбца, в котором находится нужная ячейка на экране; он не обязательно совпадает с индексом столбца в модели данных таблицы; для преобразования индекса столбца модели данных в индекс столбца отображения можно использовать метод convertColumnIndexToView(int)
includeSpacing - если false, возвращает истинные границы ячейки, вычисленные путем вычитания межъячеечного интервала из высоты и ширины моделей столбца и строки
Возвращает:
прямоугольник, содержащий ячейку в позиции row,column
См. также:
  • getIntercellSpacing()

doLayout

public void doLayout()
Выполняет компоновку строк и столбцов этой таблицы. Переопределен для того, чтобы столбцы могли изменять размер для адаптации к изменению размера содержащего родительского компонента. Изменяет размер одного или нескольких столбцов в таблице так, чтобы общая ширина всех столбцов этого JTable была равна ширине таблицы.

Перед началом компоновки метод получает resizingColumn из tableHeader. Когда метод вызывается в результате изменения размера вмещающего окна, resizingColumn равен null. Это означает, что изменение размера произошло «снаружи» JTable и изменение — или «дельта» — должно быть распределено по всем столбцам независимо от режима автоматического изменения размера этого JTable.

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

Доступны следующие режимы:

  • AUTO_RESIZE_OFF: вообще не изменять автоматически ширину столбцов. Используйте горизонтальную полосу прокрутки для размещения столбцов, когда их сумма превышает ширину Viewport. Если JTable не помещен в JScrollPane, это может привести к тому, что части таблицы останутся невидимыми.
  • AUTO_RESIZE_NEXT_COLUMN: использовать только столбец, следующий за изменяемым столбцом. Это позволяет независимо настраивать «границу» или разделитель между соседними ячейками.
  • AUTO_RESIZE_SUBSEQUENT_COLUMNS: использовать все столбцы после настраиваемого для поглощения изменений. Это поведение по умолчанию.
  • AUTO_RESIZE_LAST_COLUMN: автоматически настраивать размер только последнего столбца. Если границы последнего столбца не позволяют выделить желаемый размер, установить ширину последнего столбца на соответствующий предел и не производить дальнейших настроек.
  • AUTO_RESIZE_ALL_COLUMNS: распределить дельту между всеми столбцами в JTable, включая тот, который настраивается.

Примечание: когда JTable вносит изменения в ширину столбцов, он строго учитывает их минимальные и максимальные значения. Поэтому возможно, что даже после вызова этого метода общая ширина столбцов все равно не будет равна ширине таблицы. В этом случае JTable не переходит в режим AUTO_RESIZE_OFF для отображения полосы прокрутки и не нарушает других обязательств текущего режима автоматического изменения размера — вместо этого он позволяет своим границам быть больше (или меньше), чем сумма минимумов или максимумов столбцов, что означает либо недостаточное пространство для отображения всех столбцов, либо то, что столбцы не заполнят границы JTable. Это приводит соответственно либо к обрезке некоторых столбцов, либо к тому, что при отрисовке некоторая область будет закрашена цветом фона JTable.

Механизм распределения дельты между доступными столбцами представлен в приватном методе в классе JTable:

  adjustSizes(long targetSize, final Resizable3 r, boolean inverse)
пояснение к которому приведено в следующем разделе. Resizable3 — это закрытый (private) интерфейс, который позволяет алгоритму манипулировать элементами любой структуры данных, содержащей коллекцию элементов с размером, предпочтительным размером, максимальным и минимальным размерами.

Распределение дельты

Обзор

Назовем "DELTA" разницу между целевым размером и суммой предпочтительных размеров элементов в r. Индивидуальные размеры вычисляются путем взятия исходных предпочтительных размеров и добавления доли DELTA — эта доля зависит от того, насколько каждый предпочтительный размер удален от своего предельного значения (минимума или максимума).

Определение

Обозначим индивидуальные ограничения как min[i], max[i] и pref[i].

Назовем их соответствующие суммы: MIN, MAX и PREF.

Каждый новый размер будет рассчитываться с использованием:

         size[i] = pref[i] + delta[i]
где каждое отдельное delta[i] вычисляется в соответствии с:

Если (DELTA < 0), мы находимся в режиме сжатия, где:

                       DELTA
         delta[i] = ------------ * (pref[i] - min[i])
                    (PREF - MIN)
Если (DELTA > 0), мы находимся в режиме расширения, где:
                       DELTA
         delta[i] = ------------ * (max[i] - pref[i])
                     (MAX - PREF)

Общий эффект заключается в том, что суммарный размер перемещается на тот же процент, k, в сторону общего минимума или максимума, и этот процент гарантирует размещение необходимого пространства, DELTA.

Подробности

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

При достижении границ MAX и MIN

Когда targetSize выходит за пределы диапазона [MIN, MAX], алгоритм устанавливает для всех размеров их соответствующие предельные значения (максимум или минимум).

Переопределяет:
doLayout в классе Container
См. также:
  • LayoutManager.layoutContainer(Container)
  • Container.setLayout(LayoutManager)
  • Container.validate()

sizeColumnsToFit

@Deprecated public void sizeColumnsToFit(boolean lastColumnOnly)
Устарело.
Начиная с версии Swing 1.0.3 заменен на doLayout().
Подгоняет размеры столбцов таблицы под доступное пространство.
Параметры:
lastColumnOnly - определяет, следует ли изменять размер только последнего столбца
См. также:
  • doLayout()

sizeColumnsToFit

public void sizeColumnsToFit(int resizingColumn)
Устарело начиная с платформы Java 2 версии 1.4. Вместо этого используйте метод doLayout().
Параметры:
resizingColumn - столбец, изменение размера которого вызвало необходимость этой корректировки, или -1, если такого столбца нет
См. также:
  • doLayout()

getToolTipText

public String getToolTipText(MouseEvent event)
Переопределяет метод getToolTipText класса JComponent, чтобы разрешить использование подсказок средства визуализации (рендерера), если в нем задан текст.

Примечание: для того чтобы JTable правильно отображал всплывающие подсказки своих рендереров, JTable должен быть зарегистрированным компонентом в ToolTipManager. Это выполняется автоматически в initializeLocalVars, но если позже для JTable будет вызван setToolTipText(null), компонент таблицы будет разрегистрирован, и подсказки от рендереров больше отображаться не будут.

Переопределяет:
getToolTipText в классе JComponent
Параметры:
event - событие MouseEvent, инициировавшее отображение ToolTip
Возвращает:
строка, содержащая всплывающую подсказку
См. также:
  • JComponent.getToolTipText()

setSurrendersFocusOnKeystroke

public void setSurrendersFocusOnKeystroke(boolean surrendersFocusOnKeystroke)
Определяет, получают ли редакторы в этой JTable фокус клавиатуры при активации редактора в результате пересылки JTable событий клавиатуры для ячейки. По умолчанию это свойство равно false, и JTable сохраняет фокус, если по ячейке не был выполнен щелчок мыши.
Параметры:
surrendersFocusOnKeystroke - true, если редактор должен получать фокус, когда нажатия клавиш приводят к активации редактора
Начиная с версии:
1.4
См. также:
  • getSurrendersFocusOnKeystroke()

getSurrendersFocusOnKeystroke

public boolean getSurrendersFocusOnKeystroke()
Возвращает true, если редактор должен получать фокус, когда нажатия клавиш приводят к активации редактора
Возвращает:
true, если редактор должен получать фокус, когда нажатия клавиш приводят к активации редактора
Начиная с версии:
1.4
См. также:
  • setSurrendersFocusOnKeystroke(boolean)

editCellAt

public boolean editCellAt(int row, int column)
Программно запускает редактирование ячейки в row и column, если эти индексы находятся в допустимом диапазоне, а ячейка с этими индексами доступна для редактирования. Обратите внимание, что это удобный метод для editCellAt(int, int, null).
Параметры:
row - строка для редактирования
column - столбец для редактирования
Возвращает:
false, если по какой-либо причине ячейку невозможно отредактировать или если индексы недопустимы

editCellAt

public boolean editCellAt(int row, int column, EventObject e)
Программно запускает редактирование ячейки в row и column, если эти индексы находятся в допустимом диапазоне, а ячейка с этими индексами доступна для редактирования. Чтобы запретить JTable редактирование определенной таблицы, столбца или значения ячейки, верните false из метода isCellEditable в интерфейсе TableModel.
Параметры:
row - строка для редактирования
column - столбец для редактирования
e - событие, передаваемое в shouldSelectCell; обратите внимание, что начиная с платформы Java 2 версии 1.2 вызов shouldSelectCell больше не выполняется
Возвращает:
false, если по какой-либо причине ячейку невозможно отредактировать или если индексы недопустимы

isEditing

@BeanProperty(bound=false) public boolean isEditing()
Возвращает true, если ячейка редактируется.
Возвращает:
true, если таблица редактирует ячейку
См. также:
  • editingColumn
  • editingRow

getEditorComponent

@BeanProperty(bound=false) public Component getEditorComponent()
Возвращает компонент, обрабатывающий сеанс редактирования. Если ничего не редактируется, возвращает null.
Возвращает:
компонент, обрабатывающий сеанс редактирования

getEditingColumn

public int getEditingColumn()
Возвращает индекс столбца, содержащего ячейку, которая в данный момент редактируется. Если ничего не редактируется, возвращает -1.
Возвращает:
индекс столбца, содержащего ячейку, которая в данный момент редактируется; возвращает -1, если ничего не редактируется
См. также:
  • editingRow

getEditingRow

public int getEditingRow()
Возвращает индекс строки, содержащей редактируемую в данный момент ячейку. Если ничего не редактируется, возвращает -1.
Возвращает:
индекс строки, содержащей редактируемую в данный момент ячейку; возвращает -1, если ничего не редактируется
См. также:
  • editingColumn

getUI

public TableUI getUI()
Возвращает объект L&F, отрисовывающий этот компонент.
Переопределяет:
getUI в классе JComponent
Возвращает:
объект TableUI, отрисовывающий этот компонент

setUI

@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the Component's LookAndFeel.") public void setUI(TableUI ui)
Задает объект L&F, отрисовывающий этот компонент, и перерисовывает его.
Параметры:
ui - объект L&F TableUI
См. также:
  • UIDefaults.getUI(JComponent)

updateUI

public void updateUI()
Уведомление от UIManager об изменении L&F. Заменяет текущий объект UI на последнюю версию из UIManager.
Переопределяет:
updateUI в классе JComponent
См. также:
  • JComponent.updateUI()

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()
Возвращает суффикс, используемый для построения имени класса L&F, применяемого для отрисовки этого компонента.
Переопределяет:
getUIClassID в классе JComponent
Возвращает:
строку "TableUI"
См. также:
  • JComponent.getUIClassID()
  • UIDefaults.getUI(JComponent)

setModel

@BeanProperty(description="The model that is the source of the data for this view.") public void setModel(TableModel dataModel)
Задает модель данных для этой таблицы равной dataModel и регистрируется в ней для получения уведомлений слушателей от новой модели данных.
Параметры:
dataModel - новый источник данных для этой таблицы
Выбрасывает:
IllegalArgumentException - если dataModel имеет значение null
См. также:
  • getModel()

getModel

public TableModel getModel()
Возвращает TableModel, предоставляющую данные, отображаемые этим JTable.
Возвращает:
TableModel, предоставляющую данные, отображаемые этим JTable
См. также:
  • setModel(TableModel)

setColumnModel

@BeanProperty(description="The object governing the way columns appear in the view.") public void setColumnModel(TableColumnModel columnModel)
Устанавливает модель столбцов для этой таблицы в columnModel и регистрируется для получения уведомлений слушателей от новой модели столбцов. Также устанавливает модель столбцов JTableHeader в columnModel.
Параметры:
columnModel - новый источник данных для этой таблицы
Выбрасывает:
IllegalArgumentException - если columnModel имеет значение null
См. также:
  • getColumnModel()

getColumnModel

public TableColumnModel getColumnModel()
Возвращает TableColumnModel, содержащую всю информацию о столбцах этой таблицы.
Возвращает:
объект, предоставляющий состояние столбцов таблицы
См. также:
  • setColumnModel(TableColumnModel)

setSelectionModel

@BeanProperty(description="The selection model for rows.") public void setSelectionModel(ListSelectionModel selectionModel)
Задает модель выделения строк для этой таблицы равной selectionModel и регистрируется для получения уведомлений слушателей от новой модели выделения.
Параметры:
selectionModel - новая модель выделения
Выбрасывает:
IllegalArgumentException - если selectionModel имеет значение null
См. также:
  • getSelectionModel()

getSelectionModel

public ListSelectionModel getSelectionModel()
Возвращает ListSelectionModel, используемую для поддержания состояния выделения строк.
Возвращает:
объект, предоставляющий состояние выделения строк; null, если выделение строк не разрешено
См. также:
  • setSelectionModel(ListSelectionModel)

sorterChanged

public void sorterChanged(RowSorterEvent e)
Уведомление RowSorterListener о том, что RowSorter каким-либо образом изменился.
Указано в:
sorterChanged в интерфейсе RowSorterListener
Параметры:
e - RowSorterEvent, описывающее изменение
Выбрасывает:
NullPointerException - если e имеет значение null
С версии:
1.6

tableChanged

public void tableChanged(TableModelEvent e)
Вызывается, когда TableModel этой таблицы генерирует TableModelEvent. Объект TableModelEvent должен быть сконструирован в системе координат модели; соответствующее сопоставление с системой координат представления выполняется этим JTable при получении события.

Код приложения не будет использовать эти методы явно, они используются внутри JTable.

Обратите внимание, что начиная с версии 1.3 этот метод сбрасывает выделение, если оно есть.

Указано в:
tableChanged в интерфейсе TableModelListener
Параметры:
e - TableModelEvent для уведомления слушателя об изменении модели таблицы

columnAdded

public void columnAdded(TableColumnModelEvent e)
Вызывается при добавлении столбца в модель столбцов таблицы.

Код приложения не будет использовать эти методы явно, они используются внутри JTable.

Указано в:
columnAdded в интерфейсе TableColumnModelListener
Параметры:
e - TableColumnModelEvent
См. также:
  • TableColumnModelListener

columnRemoved

public void columnRemoved(TableColumnModelEvent e)
Вызывается при удалении столбца из модели столбцов таблицы.

Код приложения не будет использовать эти методы явно, они используются внутри JTable.

Указано в:
columnRemoved в интерфейсе TableColumnModelListener
Параметры:
e - TableColumnModelEvent
См. также:
  • TableColumnModelListener

columnMoved

public void columnMoved(TableColumnModelEvent e)
Вызывается при перемещении столбца на новую позицию. Если ячейка редактируется, редактирование прекращается и ячейка перерисовывается.

Код приложения не будет использовать эти методы явно, они используются внутри JTable.

Указано в:
columnMoved в интерфейсе TableColumnModelListener
Параметры:
e - полученное событие
См. также:
  • TableColumnModelListener

columnMarginChanged

public void columnMarginChanged(ChangeEvent e)
Вызывается при смещении столбца из-за изменения отступа (margin). Если ячейка редактируется, редактирование прекращается и ячейка перерисовывается.

Код приложения не будет использовать эти методы явно, они используются внутри JTable.

Указано в:
columnMarginChanged в интерфейсе TableColumnModelListener
Параметры:
e - полученное событие
См. также:
  • TableColumnModelListener

columnSelectionChanged

public void columnSelectionChanged(ListSelectionEvent e)
Вызывается при изменении модели выделения TableColumnModel.

Код приложения не будет использовать эти методы явно, они используются внутри JTable.

Указано в:
columnSelectionChanged в интерфейсе TableColumnModelListener
Параметры:
e - полученное событие
См. также:
  • TableColumnModelListener

valueChanged

public void valueChanged(ListSelectionEvent e)
Вызывается при изменении выделения строк — перерисовывает таблицу для отображения нового выделения.

Код приложения не будет использовать эти методы явно, они используются внутри JTable.

Указано в:
valueChanged в интерфейсе ListSelectionListener
Параметры:
e - полученное событие
См. также:
  • ListSelectionListener

editingStopped

public void editingStopped(ChangeEvent e)
Вызывается при завершении редактирования. Изменения сохраняются, а редактор отменяется.

Код приложения не будет использовать эти методы явно, они используются внутри JTable.

Указано в:
editingStopped в интерфейсе CellEditorListener
Параметры:
e - полученное событие
См. также:
  • CellEditorListener

editingCanceled

public void editingCanceled(ChangeEvent e)
Вызывается при отмене редактирования. Объект редактора отменяется, и ячейка отрисовывается снова.

Код приложения не будет использовать эти методы явно, они используются внутри JTable.

Указано в:
editingCanceled в интерфейсе CellEditorListener
Параметры:
e - полученное событие
См. также:
  • CellEditorListener

setPreferredScrollableViewportSize

@BeanProperty(bound=false, description="The preferred size of the viewport.") public void setPreferredScrollableViewportSize(Dimension size)
Задает предпочтительный размер области просмотра (viewport) для этой таблицы.
Параметры:
size - объект Dimension, задающий preferredSize для JViewport, представлением которого является эта таблица
См. также:
  • Scrollable.getPreferredScrollableViewportSize()

getPreferredScrollableViewportSize

public Dimension getPreferredScrollableViewportSize()
Возвращает предпочтительный размер области просмотра (viewport) для этой таблицы.
Указано в:
getPreferredScrollableViewportSize в интерфейсе Scrollable
Возвращает:
объект Dimension, содержащий preferredSize для JViewport, отображающего эту таблицу
См. также:
  • Scrollable.getPreferredScrollableViewportSize()

getScrollableUnitIncrement

public int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
Возвращает шаг прокрутки (в пикселях), который полностью открывает одну новую строку или столбец (в зависимости от ориентации).

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

Указано в:
getScrollableUnitIncrement в интерфейсе Scrollable
Параметры:
visibleRect - видимая область представления в пределах viewport
orientation - либо SwingConstants.VERTICAL, либо SwingConstants.HORIZONTAL
direction - меньше нуля для прокрутки вверх/влево, больше нуля для прокрутки вниз/вправо
Возвращает:
«единичный» шаг для прокрутки в указанном направлении
См. также:
  • Scrollable.getScrollableUnitIncrement(Rectangle, int, int)

getScrollableBlockIncrement

public int getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
Возвращает visibleRect.height или visibleRect.width, в зависимости от ориентации этой таблицы. Обратите внимание, что начиная со Swing 1.1.1 (Java 2 v 1.2.2) возвращаемое значение гарантирует четкое выравнивание области просмотра по границе строки.
Указано в:
getScrollableBlockIncrement в интерфейсе Scrollable
Параметры:
visibleRect - Видимая область представления в пределах viewport
orientation - Либо SwingConstants.VERTICAL, либо SwingConstants.HORIZONTAL.
direction - Меньше нуля для прокрутки вверх/влево, больше нуля для прокрутки вниз/вправо.
Возвращает:
visibleRect.height или visibleRect.width в соответствии с ориентацией
См. также:
  • Scrollable.getScrollableBlockIncrement(Rectangle, int, int)

getScrollableTracksViewportWidth

@BeanProperty(bound=false) public boolean getScrollableTracksViewportWidth()
Возвращает false, если autoResizeMode установлено в AUTO_RESIZE_OFF, что указывает на то, что ширина области просмотра не определяет ширину таблицы. В противном случае возвращает true.
Указано в:
getScrollableTracksViewportWidth в интерфейсе Scrollable
Возвращает:
false, если autoResizeMode установлено в AUTO_RESIZE_OFF, в противном случае возвращает true
См. также:
  • Scrollable.getScrollableTracksViewportWidth()

getScrollableTracksViewportHeight

@BeanProperty(bound=false) public boolean getScrollableTracksViewportHeight()
Возвращает false, указывая, что высота области просмотра не определяет высоту таблицы, если только getFillsViewportHeight не равно true и предпочтительная высота таблицы не меньше высоты области просмотра.
Указано в:
getScrollableTracksViewportHeight в интерфейсе Scrollable
Возвращает:
false, если только getFillsViewportHeight не равно true и таблицу не требуется растянуть для заполнения области просмотра
См. также:
  • Scrollable.getScrollableTracksViewportHeight()
  • setFillsViewportHeight(boolean)
  • getFillsViewportHeight()

setFillsViewportHeight

@BeanProperty(description="Whether or not this table is always made large enough to fill the height of an enclosing viewport") public void setFillsViewportHeight(boolean fillsViewportHeight)
Определяет, должна ли эта таблица всегда делаться достаточно большой, чтобы заполнить высоту объемлющей области просмотра. Если предпочтительная высота таблицы меньше области просмотра, таблица будет растянута, чтобы заполнить область просмотра. Иными словами, это гарантирует, что таблица никогда не будет меньше области просмотра. По умолчанию для этого свойства установлено значение false.
Параметры:
fillsViewportHeight - должна ли эта таблица всегда делаться достаточно большой, чтобы заполнить высоту объемлющей области просмотра
С версии:
1.6
См. также:
  • getFillsViewportHeight()
  • getScrollableTracksViewportHeight()

getFillsViewportHeight

public boolean getFillsViewportHeight()
Возвращает, делается ли эта таблица всегда достаточно большой, чтобы заполнить высоту объемлющей области просмотра.
Возвращает:
делается ли эта таблица всегда достаточно большой, чтобы заполнить высоту объемлющей области просмотра
С версии:
1.6
См. также:
  • setFillsViewportHeight(boolean)

createDefaultRenderers

protected void createDefaultRenderers()
Создает средства визуализации (рендереры) ячеек по умолчанию для объектов, чисел, вещественных чисел (doubles), дат, логических значений (booleans) и значков.
См. также:
  • DefaultTableCellRenderer

createDefaultEditors

protected void createDefaultEditors()
Создает редакторы ячеек по умолчанию для объектов, чисел и логических значений.
См. также:
  • DefaultCellEditor

initializeLocalVars

protected void initializeLocalVars()
Инициализирует свойства таблицы их значениями по умолчанию.

createDefaultDataModel

protected TableModel createDefaultDataModel()
Возвращает объект модели таблицы по умолчанию, представляющий собой DefaultTableModel. Подкласс может переопределить этот метод для возврата другого объекта модели таблицы.
Возвращает:
объект модели таблицы по умолчанию
См. также:
  • DefaultTableModel

createDefaultColumnModel

protected TableColumnModel createDefaultColumnModel()
Возвращает объект модели столбцов по умолчанию, представляющий собой DefaultTableColumnModel. Подкласс может переопределить этот метод для возврата другого объекта модели столбцов.
Возвращает:
объект модели столбцов по умолчанию
См. также:
  • DefaultTableColumnModel

createDefaultSelectionModel

protected ListSelectionModel createDefaultSelectionModel()
Возвращает объект модели выделения по умолчанию, представляющий собой DefaultListSelectionModel. Подкласс может переопределить этот метод для возврата другого объекта модели выделения.
Возвращает:
объект модели выделения по умолчанию
См. также:
  • DefaultListSelectionModel

createDefaultTableHeader

protected JTableHeader createDefaultTableHeader()
Возвращает объект заголовка таблицы по умолчанию, представляющий собой JTableHeader. Подкласс может переопределить этот метод для возврата другого объекта заголовка таблицы.
Возвращает:
объект заголовка таблицы по умолчанию
См. также:
  • JTableHeader

resizeAndRepaint

protected void resizeAndRepaint()
Эквивалентно вызову revalidate, за которым следует repaint.

getCellEditor

public TableCellEditor getCellEditor()
Возвращает активный редактор ячейки, который равен null, если в данный момент таблица не редактируется.
Возвращает:
TableCellEditor, выполняющий редактирование, или null, если в данный момент таблица не редактируется.
См. также:
  • cellEditor
  • getCellEditor(int, int)

setCellEditor

@BeanProperty(description="The table's active cell editor.") public void setCellEditor(TableCellEditor anEditor)
Задает активный редактор ячейки.
Параметры:
anEditor - активный редактор ячейки
См. также:
  • cellEditor

setEditingColumn

public void setEditingColumn(int aColumn)
Устанавливает переменную editingColumn.
Параметры:
aColumn - столбец редактируемой ячейки
См. также:
  • editingColumn

setEditingRow

public void setEditingRow(int aRow)
Устанавливает переменную editingRow.
Параметры:
aRow - строка редактируемой ячейки
См. также:
  • editingRow

getCellRenderer

public TableCellRenderer getCellRenderer(int row, int column)
Возвращает подходящий модуль отрисовки (рендерер) для ячейки, заданной этой строкой и столбцом. Если TableColumn для этого столбца имеет ненулевой рендерер, возвращает его. В противном случае находит класс данных в этом столбце (с помощью getColumnClass) и возвращает рендерер по умолчанию для этого типа данных.

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

Параметры:
row - строка отрисовываемой ячейки, где 0 — первая строка
column - столбец отрисовываемой ячейки, где 0 — первый столбец
Возвращает:
назначенный рендерер; если null, возвращает рендерер по умолчанию для этого типа объекта
См. также:
  • DefaultTableCellRenderer
  • TableColumn.setCellRenderer(TableCellRenderer)
  • setDefaultRenderer(Class, TableCellRenderer)

prepareRenderer

public Component prepareRenderer(TableCellRenderer renderer, int row, int column)
Подготавливает рендерер путем запроса модели данных о значении и состоянии выделения ячейки в позиции row, column. Возвращает компонент (который может быть Component или JComponent) в месте возникновения события.

Во время операции печати этот метод настраивает рендерер без указания выделения или фокуса, чтобы предотвратить их появление на распечатанном выводе. Чтобы выполнить другие настройки в зависимости от того, печатается ли таблица, вы можете проверить значение JComponent.isPaintingForPrint(), здесь или внутри пользовательских рендереров.

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

Параметры:
renderer - TableCellRenderer для подготовки
row - строка отрисовываемой ячейки, где 0 — первая строка
column - столбец отрисовываемой ячейки, где 0 — первый столбец
Возвращает:
Component в месте возникновения события

getCellEditor

public TableCellEditor getCellEditor(int row, int column)
Возвращает подходящий редактор для ячейки, заданной параметрами row и column. Если TableColumn для этого столбца имеет ненулевой редактор, возвращает его. Если нет, определяет класс данных в этом столбце (с использованием getColumnClass) и возвращает редактор по умолчанию для этого типа данных.

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

Параметры:
row - строка редактируемой ячейки, где 0 — первая строка
column - столбец редактируемой ячейки, где 0 — первый столбец
Возвращает:
редактор для этой ячейки; если null, возвращает редактор по умолчанию для этого типа ячейки
См. также:
  • DefaultCellEditor

prepareEditor

public Component prepareEditor(TableCellEditor editor, int row, int column)
Подготавливает редактор, запрашивая у модели данных значение и состояние выбора ячейки в позиции row, column.

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

Параметры:
editor - настраиваемый TableCellEditor
row - строка редактируемой ячейки, где 0 — первая строка
column - столбец редактируемой ячейки, где 0 — первый столбец
Возвращает:
редактируемый Component

removeEditor

public void removeEditor()
Удаляет объект редактора и освобождает экранное пространство, которое он использовал для отрисовки ячейки.

paramString

protected String paramString()
Возвращает строковое представление этой таблицы. Этот метод предназначен только для целей отладки, и содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не может быть null.
Переопределяет:
paramString в классе JComponent
Возвращает:
строковое представление этой таблицы

print

public boolean print() throws PrinterException
Удобный метод, который отображает диалоговое окно печати, а затем печатает этот JTable в режиме PrintMode.FIT_WIDTH, без текста верхнего или нижнего колонтитула. На время печати будет отображаться модальное диалоговое окно хода выполнения с возможностью отмены.

Примечание: В headless-режиме диалоговые окна не отображаются, и печать выполняется на принтере по умолчанию.

Возвращает:
true, если только печать не была отменена пользователем
Исключения:
PrinterException - если ошибка в системе печати приводит к прерыванию задания
С какого года:
1.5
См. также:
  • print(JTable.PrintMode, MessageFormat, MessageFormat, boolean, PrintRequestAttributeSet, boolean, PrintService)
  • getPrintable(JTable.PrintMode, MessageFormat, MessageFormat)

print

public boolean print(JTable.PrintMode printMode) throws PrinterException
Удобный метод, который отображает диалоговое окно печати, а затем печатает этот JTable в заданном режиме печати, без текста верхнего или нижнего колонтитула. На время печати будет отображаться модальное диалоговое окно хода выполнения с возможностью отмены.

Примечание: В headless-режиме диалоговые окна не отображаются, и печать выполняется на принтере по умолчанию.

Параметры:
printMode - режим печати, который должен использовать печатный объект
Возвращает:
true, если только печать не была отменена пользователем
Исключения:
PrinterException - если ошибка в системе печати приводит к прерыванию задания
С какого года:
1.5
См. также:
  • print(JTable.PrintMode, MessageFormat, MessageFormat, boolean, PrintRequestAttributeSet, boolean, PrintService)
  • getPrintable(JTable.PrintMode, MessageFormat, MessageFormat)

print

public boolean print(JTable.PrintMode printMode, MessageFormat headerFormat, MessageFormat footerFormat) throws PrinterException
Удобный метод, который отображает диалоговое окно печати, а затем печатает этот JTable в заданном режиме печати с указанным текстом верхнего и нижнего колонтитулов. На время печати будет отображаться модальное диалоговое окно хода выполнения с возможностью отмены.

Примечание: В headless-режиме диалоговые окна не отображаются, и печать выполняется на принтере по умолчанию.

Параметры:
printMode - режим печати, который должен использовать печатный объект
headerFormat - MessageFormat, указывающий текст для печати верхнего колонтитула, или null, если он отсутствует
footerFormat - MessageFormat, указывающий текст для печати нижнего колонтитула, или null, если он отсутствует
Возвращает:
true, если только печать не была отменена пользователем
Исключения:
PrinterException - если ошибка в системе печати приводит к прерыванию задания
С какого года:
1.5
См. также:
  • print(JTable.PrintMode, MessageFormat, MessageFormat, boolean, PrintRequestAttributeSet, boolean, PrintService)
  • getPrintable(JTable.PrintMode, MessageFormat, MessageFormat)

print

public boolean print(JTable.PrintMode printMode, MessageFormat headerFormat, MessageFormat footerFormat, boolean showPrintDialog, PrintRequestAttributeSet attr, boolean interactive) throws PrinterException, HeadlessException
Печатает эту таблицу в соответствии с полнофункциональным методом print, используя в качестве службы печати принтер по умолчанию.
Параметры:
printMode - режим печати, который должен использовать печатный объект
headerFormat - MessageFormat, указывающий текст для печати верхнего колонтитула, или null, если он отсутствует
footerFormat - MessageFormat, указывающий текст для печати нижнего колонтитула, или null, если он отсутствует
showPrintDialog - следует ли отображать диалоговое окно печати
attr - PrintRequestAttributeSet, указывающий любые атрибуты печати, или null, если они отсутствуют
interactive - следует ли выполнять печать в интерактивном режиме
Возвращает:
true, если только печать не была отменена пользователем
Исключения:
HeadlessException - если метод запрошен отобразить диалоговое окно печати или выполняться интерактивно, а GraphicsEnvironment.isHeadless возвращает true
PrinterException - если ошибка в системе печати приводит к прерыванию задания
С какого года:
1.5
См. также:
  • print(JTable.PrintMode, MessageFormat, MessageFormat, boolean, PrintRequestAttributeSet, boolean, PrintService)
  • getPrintable(JTable.PrintMode, MessageFormat, MessageFormat)

print

public boolean print(JTable.PrintMode printMode, MessageFormat headerFormat, MessageFormat footerFormat, boolean showPrintDialog, PrintRequestAttributeSet attr, boolean interactive, PrintService service) throws PrinterException, HeadlessException
Печатает этот JTable. Выполняет шаги, которые предприняло бы большинство разработчиков для печати JTable. Вкратце, метод подготавливает таблицу, вызывает getPrintable для получения подходящего Printable, а затем отправляет его на принтер.

Параметр boolean позволяет указать, отображается ли пользователю диалоговое окно печати. Если оно отображается, пользователь может использовать диалоговое окно для изменения целевого принтера или атрибутов печати, или даже для отмены печати. Еще два параметра позволяют указать PrintService и атрибуты печати. Эти параметры можно использовать либо для предоставления начальных значений диалоговому окну печати, либо для указания значений, когда диалоговое окно не отображается.

Второй параметр boolean позволяет указать, следует ли выполнять печать в интерактивном режиме. Если true, на время печати отображается модальное диалоговое окно хода выполнения с возможностью отмены. Это диалоговое окно также предотвращает любые действия пользователя, которые могут повлиять на таблицу. Однако оно не может предотвратить изменение таблицы программным кодом (например, другим потоком, который отправляет обновления с помощью SwingUtilities.invokeLater). Поэтому ответственность за то, чтобы никакой другой код не изменял таблицу каким-либо образом во время печати, лежит на разработчике (недопустимые изменения включают изменения размера, рендереров или базовых данных). Поведение печати не определено, если таблица изменяется во время печати.

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

Примечание: Попытка отобразить диалоговое окно печати или запустить интерактивный режим в headless-режиме приведет к HeadlessException.

Перед получением печатного объекта этот метод при необходимости корректно завершит редактирование, чтобы редактор не отображался в напечатанном результате. Кроме того, во время печати JTable подготовит свои рендереры так, чтобы выбор и фокус не отображались. Что касается дальнейшей настройки внешнего вида таблицы при печати, разработчики могут предоставить пользовательские рендереры или код отрисовки, который зависит от значения JComponent.isPaintingForPrint().

Подробнее о том, как печатается таблица, см. в getPrintable(JTable.PrintMode, MessageFormat, MessageFormat).

Параметры:
printMode - режим печати, который должен использовать печатный объект
headerFormat - MessageFormat, указывающий текст для печати верхнего колонтитула, или null, если он отсутствует
footerFormat - MessageFormat, указывающий текст для печати нижнего колонтитула, или null, если он отсутствует
showPrintDialog - следует ли отображать диалоговое окно печати
attr - PrintRequestAttributeSet, указывающий любые атрибуты печати, или null, если они отсутствуют
interactive - следует ли выполнять печать в интерактивном режиме
service - целевая PrintService, или null для использования принтера по умолчанию
Возвращает:
true, если только печать не была отменена пользователем
Исключения:
HeadlessException - если метод запрошен отобразить диалоговое окно печати или выполняться интерактивно, а GraphicsEnvironment.isHeadless возвращает true
PrinterException - если ошибка в системе печати приводит к прерыванию задания
С какого года:
1.6
См. также:
  • getPrintable(JTable.PrintMode, MessageFormat, MessageFormat)
  • GraphicsEnvironment.isHeadless()

getPrintable

public Printable getPrintable(JTable.PrintMode printMode, MessageFormat headerFormat, MessageFormat footerFormat)
Возвращает Printable для использования при печати этой JTable.

Этот метод предназначен для тех, кто хочет настроить стандартную реализацию Printable, используемую методами JTable print. Разработчикам, желающим просто распечатать таблицу, следует напрямую использовать один из этих методов.

Объект Printable можно запросить в одном из двух режимов печати. В обоих режимах он естественным образом распределяет строки таблицы последовательно по нескольким страницам, размещая как можно больше строк на странице. PrintMode.NORMAL указывает, что таблица должна быть напечатана в ее текущем размере. В этом режиме может возникнуть необходимость распределения столбцов по страницам аналогично строкам. При возникновении такой необходимости столбцы распределяются в порядке, соответствующем ComponentOrientation таблицы. PrintMode.FIT_WIDTH указывает, что при необходимости вывод должен быть уменьшен в масштабе, чтобы вся ширина таблицы (и, следовательно, все столбцы) поместилась на каждой странице. Ширина и высота масштабируются одинаково, сохраняя соотношение сторон вывода.

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

Текст верхнего и нижнего колонтитулов можно добавить к выводу, предоставив аргументы MessageFormat. Код печати запрашивает строки из форматов, предоставляя один элемент, который может быть включен в форматированную строку: Integer, представляющий текущий номер страницы.

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

Вот пример создания MessageFormat, который можно использовать для печати "Duke's Table: Page - " и текущего номера страницы:

    // notice the escaping of the single quote
    // notice how the page number is included with "{0}"
    MessageFormat format = new MessageFormat("Duke''s Table: Page - {0}");

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

  • В любом режиме, когда текст верхнего или нижнего колонтитула слишком широк, чтобы полностью поместиться в области печати — печатается как можно большая часть текста, начиная с начала, как определено параметром ComponentOrientation таблицы.
  • В любом режиме, когда строка слишком высока, чтобы поместиться в области печати — печатается самая верхняя часть строки, а нижняя граница таблицы не отрисовывается.
  • В режиме PrintMode.NORMAL, когда столбец слишком широк, чтобы поместиться в области печати — печатается центральная часть столбца, а левая и правая границы таблицы опускаются.

Вполне допустимо обертывать этот Printable внутри другого для создания сложных отчетов и документов. Можно даже запросить отрисовку разных страниц в области печати разного размера. Реализация должна быть готова к этому (возможно, выполняя расчеты компоновки на лету). Однако предоставление разной высоты для каждой страницы, скорее всего, не будет хорошо работать с режимом PrintMode.NORMAL, когда требуется распределять столбцы по страницам.

Что касается настройки внешнего вида таблицы в напечатанном результате, JTable сам позаботится о скрытии выделения и фокуса во время печати. Для дополнительных настроек ваши рендереры или код отрисовки могут изменять внешний вид в зависимости от значения JComponent.isPaintingForPrint()

Кроме того, перед вызовом этого метода вы можете захотеть сначала изменить состояние таблицы, например отменить редактирование ячеек или предложить пользователю задать подходящий размер таблицы. Однако вы не должны изменять состояние таблицы после получения этого Printable (недопустимые изменения включают изменения размера или базовых данных). Поведение возвращаемого Printable не определено после изменения таблицы.

Параметры:
printMode - режим печати, который должен использовать печатный объект
headerFormat - MessageFormat, указывающий текст для печати верхнего колонтитула, или null, если он отсутствует
footerFormat - MessageFormat, указывающий текст для печати нижнего колонтитула, или null, если он отсутствует
Возвращает:
Printable для печати этой JTable
С какого года:
1.5
См. также:
  • print(JTable.PrintMode, MessageFormat, MessageFormat, boolean, PrintRequestAttributeSet, boolean)
  • Printable
  • PrinterJob

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанный с этой JTable. Для таблиц AccessibleContext принимает форму AccessibleJTable. При необходимости создается новый экземпляр AccessibleJTable.
Указано в:
getAccessibleContext в интерфейсе Accessible
Переопределяет:
getAccessibleContext в классе Component
Возвращает:
AccessibleJTable, который служит в качестве AccessibleContext этой JTable

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в разделе Документация по Java SE, где содержатся более подробные описания для разработчиков с концептуальными обзорами, определениями терминов, обходными путями и рабочими примерами кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее дочерних компаний в США и других странах.
Авторские права © 1993, 2026, Oracle и/или ее дочерние компании, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API